@nexpress/plugin-block-callout 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 calloutPlugin: _nexpress_plugin_sdk.NpResolvedPlugin<Record<string, unknown>>;
+
+export { calloutPlugin, calloutPlugin as default };

package/dist/index.js

@@ -0,0 +1,147 @@
+// src/index.tsx
+import { definePlugin } from "@nexpress/plugin-sdk";
+import { jsx, jsxs } from "react/jsx-runtime";
+var TONE_PALETTES = {
+  info: { bg: "#eff6ff", border: "#3b82f6", icon: "\u2139\uFE0F", title: "#1e40af" },
+  success: { bg: "#ecfdf5", border: "#10b981", icon: "\u2713", title: "#065f46" },
+  warn: { bg: "#fffbeb", border: "#f59e0b", icon: "\u26A0", title: "#92400e" },
+  danger: { bg: "#fef2f2", border: "#ef4444", icon: "\u2715", title: "#991b1b" }
+};
+function readString(value, fallback) {
+  return typeof value === "string" && value.length > 0 ? value : fallback;
+}
+function readTone(value) {
+  return value === "success" || value === "warn" || value === "danger" ? value : "info";
+}
+function readBool(value, fallback) {
+  return typeof value === "boolean" ? value : fallback;
+}
+function readColor(value) {
+  if (typeof value !== "string") return null;
+  const trimmed = value.trim();
+  if (trimmed.length === 0) return null;
+  return trimmed;
+}
+var calloutBlock = {
+  type: "callout",
+  label: "Callout",
+  description: "Info / warn / danger notice card with a title and body.",
+  icon: "\u{1F4A1}",
+  defaultProps: {
+    tone: "info",
+    title: "Heads up",
+    body: "Use this block to flag something the reader shouldn't miss.",
+    showIcon: true
+  },
+  propsSchema: [
+    {
+      name: "tone",
+      label: "Tone",
+      type: "select",
+      defaultValue: "info",
+      options: [
+        { label: "Info (blue)", value: "info" },
+        { label: "Success (green)", value: "success" },
+        { label: "Warn (amber)", value: "warn" },
+        { label: "Danger (red)", value: "danger" }
+      ]
+    },
+    { name: "title", label: "Title", type: "text", defaultValue: "Heads up" },
+    {
+      name: "body",
+      label: "Body",
+      type: "textarea",
+      defaultValue: "Use this block to flag something the reader shouldn't miss."
+    },
+    {
+      name: "showIcon",
+      label: "Show icon",
+      type: "boolean",
+      defaultValue: true
+    },
+    {
+      name: "accentColor",
+      label: "Accent color (override)",
+      type: "color",
+      description: "Optional. Overrides the tone's default border + icon color."
+    }
+  ],
+  render: (props) => {
+    const tone = readTone(props.tone);
+    const palette = TONE_PALETTES[tone];
+    const title = readString(props.title, "Heads up");
+    const body = readString(props.body, "");
+    const showIcon = readBool(props.showIcon, true);
+    const accent = readColor(props.accentColor) ?? palette.border;
+    const wrapperStyle = {
+      display: "flex",
+      gap: "0.875rem",
+      padding: "1.125rem 1.25rem",
+      borderLeft: `4px solid ${accent}`,
+      borderRadius: "0.5rem",
+      backgroundColor: palette.bg,
+      margin: "1.25rem 0"
+    };
+    const iconStyle = {
+      flexShrink: 0,
+      width: "1.5rem",
+      height: "1.5rem",
+      display: "inline-flex",
+      alignItems: "center",
+      justifyContent: "center",
+      fontSize: "1rem",
+      color: accent,
+      fontWeight: 700
+    };
+    return /* @__PURE__ */ jsxs("aside", { className: `np-block-callout np-block-callout--${tone}`, style: wrapperStyle, children: [
+      showIcon ? /* @__PURE__ */ jsx("span", { "aria-hidden": "true", style: iconStyle, children: palette.icon }) : null,
+      /* @__PURE__ */ jsxs("div", { style: { minWidth: 0 }, children: [
+        title.length > 0 ? /* @__PURE__ */ jsx(
+          "p",
+          {
+            style: {
+              margin: 0,
+              fontWeight: 600,
+              color: palette.title,
+              lineHeight: 1.3
+            },
+            children: title
+          }
+        ) : null,
+        body.length > 0 ? /* @__PURE__ */ jsx(
+          "p",
+          {
+            style: {
+              margin: title.length > 0 ? "0.25rem 0 0" : 0,
+              color: "#1f2937",
+              lineHeight: 1.55,
+              whiteSpace: "pre-wrap"
+            },
+            children: body
+          }
+        ) : null
+      ] })
+    ] });
+  }
+};
+var calloutPlugin = definePlugin({
+  manifest: {
+    id: "block-callout",
+    version: "0.1.0",
+    name: "Callout block",
+    description: "Adds an info / warn / danger callout card to the page-builder block library.",
+    author: { name: "NexPress" },
+    license: "MIT",
+    nexpress: { minVersion: "0.1.0" }
+    // capabilities, allowedHosts, provides, agent, usesTokens, styleSlots
+    // all default sensibly — `definePlugin` derives `provides.blocks` from
+    // the `blocks: [...]` array below, so we don't repeat ourselves.
+  },
+  blocks: [calloutBlock]
+});
+var index_default = calloutPlugin;
+export {
+  calloutPlugin,
+  index_default as default
+};
+//# 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 } from \"@nexpress/blocks\";\nimport { definePlugin } from \"@nexpress/plugin-sdk\";\n\nconst TONE_PALETTES = {\n  info: { bg: \"#eff6ff\", border: \"#3b82f6\", icon: \"ℹ️\", title: \"#1e40af\" },\n  success: { bg: \"#ecfdf5\", border: \"#10b981\", icon: \"✓\", title: \"#065f46\" },\n  warn: { bg: \"#fffbeb\", border: \"#f59e0b\", icon: \"⚠\", title: \"#92400e\" },\n  danger: { bg: \"#fef2f2\", border: \"#ef4444\", icon: \"✕\", title: \"#991b1b\" },\n} as const;\n\ntype Tone = keyof typeof TONE_PALETTES;\n\nfunction readString(value: unknown, fallback: string): string {\n  return typeof value === \"string\" && value.length > 0 ? value : fallback;\n}\n\nfunction readTone(value: unknown): Tone {\n  return value === \"success\" || value === \"warn\" || value === \"danger\" ? value : \"info\";\n}\n\nfunction readBool(value: unknown, fallback: boolean): boolean {\n  return typeof value === \"boolean\" ? value : fallback;\n}\n\nfunction readColor(value: unknown): string | null {\n  if (typeof value !== \"string\") return null;\n  const trimmed = value.trim();\n  if (trimmed.length === 0) return null;\n  return trimmed;\n}\n\nconst calloutBlock: NpBlockDefinition = {\n  type: \"callout\",\n  label: \"Callout\",\n  description: \"Info / warn / danger notice card with a title and body.\",\n  icon: \"💡\",\n  defaultProps: {\n    tone: \"info\",\n    title: \"Heads up\",\n    body: \"Use this block to flag something the reader shouldn't miss.\",\n    showIcon: true,\n  },\n  propsSchema: [\n    {\n      name: \"tone\",\n      label: \"Tone\",\n      type: \"select\",\n      defaultValue: \"info\",\n      options: [\n        { label: \"Info (blue)\", value: \"info\" },\n        { label: \"Success (green)\", value: \"success\" },\n        { label: \"Warn (amber)\", value: \"warn\" },\n        { label: \"Danger (red)\", value: \"danger\" },\n      ],\n    },\n    { name: \"title\", label: \"Title\", type: \"text\", defaultValue: \"Heads up\" },\n    {\n      name: \"body\",\n      label: \"Body\",\n      type: \"textarea\",\n      defaultValue: \"Use this block to flag something the reader shouldn't miss.\",\n    },\n    {\n      name: \"showIcon\",\n      label: \"Show icon\",\n      type: \"boolean\",\n      defaultValue: true,\n    },\n    {\n      name: \"accentColor\",\n      label: \"Accent color (override)\",\n      type: \"color\",\n      description: \"Optional. Overrides the tone's default border + icon color.\",\n    },\n  ],\n  render: (props) => {\n    const tone = readTone(props.tone);\n    const palette = TONE_PALETTES[tone];\n    const title = readString(props.title, \"Heads up\");\n    const body = readString(props.body, \"\");\n    const showIcon = readBool(props.showIcon, true);\n    const accent = readColor(props.accentColor) ?? palette.border;\n\n    const wrapperStyle: CSSProperties = {\n      display: \"flex\",\n      gap: \"0.875rem\",\n      padding: \"1.125rem 1.25rem\",\n      borderLeft: `4px solid ${accent}`,\n      borderRadius: \"0.5rem\",\n      backgroundColor: palette.bg,\n      margin: \"1.25rem 0\",\n    };\n\n    const iconStyle: CSSProperties = {\n      flexShrink: 0,\n      width: \"1.5rem\",\n      height: \"1.5rem\",\n      display: \"inline-flex\",\n      alignItems: \"center\",\n      justifyContent: \"center\",\n      fontSize: \"1rem\",\n      color: accent,\n      fontWeight: 700,\n    };\n\n    return (\n      <aside className={`np-block-callout np-block-callout--${tone}`} style={wrapperStyle}>\n        {showIcon ? (\n          <span aria-hidden=\"true\" style={iconStyle}>\n            {palette.icon}\n          </span>\n        ) : null}\n        <div style={{ minWidth: 0 }}>\n          {title.length > 0 ? (\n            <p\n              style={{\n                margin: 0,\n                fontWeight: 600,\n                color: palette.title,\n                lineHeight: 1.3,\n              }}\n            >\n              {title}\n            </p>\n          ) : null}\n          {body.length > 0 ? (\n            <p\n              style={{\n                margin: title.length > 0 ? \"0.25rem 0 0\" : 0,\n                color: \"#1f2937\",\n                lineHeight: 1.55,\n                whiteSpace: \"pre-wrap\",\n              }}\n            >\n              {body}\n            </p>\n          ) : null}\n        </div>\n      </aside>\n    );\n  },\n};\n\nexport const calloutPlugin = definePlugin({\n  manifest: {\n    id: \"block-callout\",\n    version: \"0.1.0\",\n    name: \"Callout block\",\n    description: \"Adds an info / warn / danger callout card to the page-builder block library.\",\n    author: { name: \"NexPress\" },\n    license: \"MIT\",\n    nexpress: { minVersion: \"0.1.0\" },\n    // capabilities, allowedHosts, provides, agent, usesTokens, styleSlots\n    // all default sensibly — `definePlugin` derives `provides.blocks` from\n    // the `blocks: [...]` array below, so we don't repeat ourselves.\n  },\n  blocks: [calloutBlock],\n});\n\nexport default calloutPlugin;\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@nexpress/plugin-block-callout",
+  "version": "0.1.0",
+  "description": "Callout block — info/warn/danger notice card. Sample plugin showcasing block contribution.",
+  "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/plugin-sdk": "0.1.0",
+    "@nexpress/blocks": "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"
+  }
+}