@record-evolution/widget-markdown 1.0.7 → 1.0.9

package/package.json

@@ -3,7 +3,7 @@
     "description": "Webcomponent widget-markdown following open-wc recommendations",
     "license": "MIT",
     "author": "widget-markdown",
-    "version": "1.0.7",
+    "version": "1.0.9",
     "engines": {
         "node": ">=24.9.0",
         "npm": ">=10.0.2"
@@ -25,7 +25,11 @@
         "link": "npm run build && npm link && cd ../RESWARM/frontend && npm link @record-evolution/widget-markdown",
         "unlink": "npm unlink --global && cd ../RESWARM/frontend && npm unlink @record-evolution/widget-markdown && npm i @record-evolution/widget-markdown",
         "types": "cat src/definition-schema.json | json2ts > src/definition-schema.d.ts",
-        "release": "npm run build && npm run types && npm version patch --tag-version-prefix='' && git push && git push --tag && npm run build"
+        "preversion": "sh scripts/release-preflight.sh",
+        "postversion": "git push --follow-tags && sh scripts/release-verify.sh",
+        "release": "npm version patch",
+        "release:minor": "npm version minor",
+        "release:major": "npm version major"
     },
     "dependencies": {
         "github-markdown-css": "^5.8.1",

package/src/definition-schema.d.ts

@@ -25,7 +25,7 @@ export type Variables = {
 /**
  * A markdown rendering widget for displaying formatted text with dynamic variable substitution. Use this widget for documentation, instructions, dynamic reports, or any rich text content on dashboards. Supports full Markdown syntax including headers, lists, tables, links, and code blocks. Variables can be embedded using {{variableName}} notation and bound to data sources for real-time updates. Ideal for creating contextual help, status summaries, or narrative text that incorporates live data values.
  */
-export interface InputData {
+export interface MarkdownConfiguration {
   markdown?: Markdown;
   data?: Variables;
   [k: string]: unknown;

package/src/definition-schema.json

@@ -1,6 +1,20 @@
 {
-    "title": "InputData",
+    "title": "Markdown Configuration",
     "description": "A markdown rendering widget for displaying formatted text with dynamic variable substitution. Use this widget for documentation, instructions, dynamic reports, or any rich text content on dashboards. Supports full Markdown syntax including headers, lists, tables, links, and code blocks. Variables can be embedded using {{variableName}} notation and bound to data sources for real-time updates. Ideal for creating contextual help, status summaries, or narrative text that incorporates live data values.",
+    "aiSelection": {
+        "dataShape": "A Markdown document, with {{variableName}} placeholders substituted from data[] entries that each bind a label to a live value.",
+        "useWhen": [
+            "Prose, documentation, instructions or a written summary belongs on the dashboard.",
+            "The text needs structure or markup — headings, lists, links, tables, code blocks.",
+            "A narrative should incorporate live numbers, e.g. 'Line 3 produced {{units}} units today'."
+        ],
+        "notFor": [
+            "A single styled string with no markup — use widget-label; a Markdown renderer is overkill.",
+            "Fixed title / subtitle / body sections with per-section typography — use widget-textbox.",
+            "Tabular data coming from a query rather than written by hand — use widget-table.",
+            "Numbers that should be read as figures rather than embedded in a sentence — use widget-value."
+        ]
+    },
     "type": "object",
     "properties": {
         "markdown": {

package/src/widget-markdown.ts

@@ -16,7 +16,7 @@ import cssLang from 'highlight.js/lib/languages/css'
 import highlightCSS from 'highlight.js/styles/github.css?inline'
 import githubCss from 'github-markdown-css/github-markdown.css?inline'
 import { customElement, property, state } from 'lit/decorators.js'
-import { InputData } from './definition-schema'
+import { MarkdownConfiguration } from './definition-schema'
 
 hljs.registerLanguage('shell', shell)
 hljs.registerLanguage('bash', shell)
@@ -37,7 +37,7 @@ type Theme = {
 @customElement('widget-markdown-versionplaceholder')
 export class WidgetMarkdown extends LitElement {
     @property({ type: Object })
-    inputData?: InputData
+    inputData?: MarkdownConfiguration
 
     @property({ type: Object })
     theme?: Theme
@@ -119,13 +119,15 @@ export class WidgetMarkdown extends LitElement {
                     const dataItem = this.inputData?.data?.find((item) => item.label === varName)
                     const value = dataItem?.value
 
+                    // An unbound variable, or one whose bound value is empty, renders as
+                    // nothing — never as the raw {{placeholder}}.
                     if (value === null || value === undefined) {
-                        span.textContent = `{{${varName}}}`
+                        span.textContent = ''
                     } else if (typeof value === 'object') {
                         try {
                             span.textContent = JSON.stringify(value)
                         } catch {
-                            span.textContent = `{{${varName}}}`
+                            span.textContent = ''
                         }
                     } else {
                         span.textContent = String(value)