pict-section-flow 0.0.16 → 0.0.18

package/docs/card-help/FWRITE.md

@@ -4,10 +4,10 @@ The **File Write** node writes data to a file on the filesystem.
 
 ## Ports
 
-- **Path** (input) — the destination filesystem path
-- **Data** (input) — the content to write
-- **Done** (output) — fires after a successful write
-- **Error** (output) — fires if the write operation fails
+- **Path** (input) -- the destination filesystem path
+- **Data** (input) -- the content to write
+- **Done** (output) -- fires after a successful write
+- **Error** (output) -- fires if the write operation fails
 
 ## Behavior
 
@@ -19,6 +19,6 @@ The properties panel shows a View-based info panel with details about the config
 
 ## Tips
 
-- Directories in the path are not created automatically — ensure they exist before writing
+- Directories in the path are not created automatically -- ensure they exist before writing
 - Combine with a Set Value node to format data before writing
 - Connect the **Error** output to a Log Values node to capture write failures

package/docs/card-help/GET.md

@@ -4,8 +4,8 @@ The **Get Value** node retrieves a named variable from the flow context and emit
 
 ## Ports
 
-- **In** (input) — trigger to read the value
-- **Value** (output) — the retrieved value
+- **In** (input) -- trigger to read the value
+- **Value** (output) -- the retrieved value
 
 ## Behavior
 

package/docs/card-help/ITE.md

@@ -4,9 +4,9 @@ The **If-Then-Else** node evaluates a boolean condition expression and routes th
 
 ## Ports
 
-- **In** (input) — trigger that starts the evaluation
-- **Then** (output) — activated when the condition is **true**
-- **Else** (output) — activated when the condition is **false**
+- **In** (input) -- trigger that starts the evaluation
+- **Then** (output) -- activated when the condition is **true**
+- **Else** (output) -- activated when the condition is **false**
 
 ## Behavior
 

package/docs/card-help/LOG.md

@@ -4,13 +4,13 @@ The **Log Values** node writes incoming data to the console or log output for de
 
 ## Ports
 
-- **Values** (input, multi) — accepts one or more connections carrying values to log
-- **Pass** (output) — passes the last received value through unchanged
+- **Values** (input, multi) -- accepts one or more connections carrying values to log
+- **Pass** (output) -- passes the last received value through unchanged
 
 ## Properties
 
-- **LogLevel** — the severity level for the log entry (e.g. `info`, `warn`, `error`, `trace`)
-- **Format** — an optional format string controlling how values are serialized
+- **LogLevel** -- the severity level for the log entry (e.g. `info`, `warn`, `error`, `trace`)
+- **Format** -- an optional format string controlling how values are serialized
 
 ## Behavior
 

package/docs/card-help/NOTE.md

@@ -8,7 +8,7 @@ Drop a Comment node anywhere on the canvas to add context, explain design decisi
 
 ## Properties
 
-- **NoteText** — the annotation content displayed in the node body
+- **NoteText** -- the annotation content displayed in the node body
 
 ## Tips
 

package/docs/card-help/PREV.md

@@ -4,8 +4,8 @@ The **Data Preview** node displays a tabular summary of the data flowing through
 
 ## Ports
 
-- **Data** (input) — the data object to inspect
-- **Pass** (output) — passes the data through unchanged
+- **Data** (input) -- the data object to inspect
+- **Pass** (output) -- passes the data through unchanged
 
 ## Behavior
 

package/docs/card-help/SET.md

@@ -4,13 +4,13 @@ The **Set Value** node assigns a value to a named variable in the flow context.
 
 ## Ports
 
-- **In** (input) — trigger to perform the assignment
-- **Out** (output) — fires after the value has been set
+- **In** (input) -- trigger to perform the assignment
+- **Out** (output) -- fires after the value has been set
 
 ## Properties
 
-- **Variable Name** — the key under which the value will be stored
-- **Value Expression** — the expression to evaluate and assign
+- **Variable Name** -- the key under which the value will be stored
+- **Value Expression** -- the expression to evaluate and assign
 
 ## Behavior
 
@@ -22,6 +22,6 @@ Open the properties panel to configure the variable name and value expression us
 
 ## Tips
 
-- Variable names are case-sensitive — use consistent naming conventions
+- Variable names are case-sensitive -- use consistent naming conventions
 - Value expressions have access to the current flow context
 - Use Set Value at the beginning of a flow to initialize default variables

package/docs/card-help/SPKL.md

@@ -4,8 +4,8 @@ The **Sparkline** node renders a live sparkline chart visualizing numeric throug
 
 ## Ports
 
-- **Values** (input) — a numeric array or stream of values to plot
-- **Stats** (output) — emits computed statistics (min, max, mean) for the data set
+- **Values** (input) -- a numeric array or stream of values to plot
+- **Stats** (output) -- emits computed statistics (min, max, mean) for the data set
 
 ## Behavior
 

package/docs/card-help/STAT.md

@@ -4,9 +4,9 @@ The **Status Monitor** node monitors the health status of upstream services and
 
 ## Ports
 
-- **Check** (input, multi) — accepts connections from one or more services to monitor
-- **Healthy** (output) — fires when all monitored services report healthy
-- **Degraded** (output) — fires when one or more services report degraded status
+- **Check** (input, multi) -- accepts connections from one or more services to monitor
+- **Healthy** (output) -- fires when all monitored services report healthy
+- **Degraded** (output) -- fires when one or more services report degraded status
 
 ## Behavior
 

package/docs/card-help/SW.md

@@ -4,10 +4,10 @@ The **Switch** node routes execution to one of multiple outputs based on a match
 
 ## Ports
 
-- **In** (input) — the value to match against cases
-- **Case A** (output) — fires when the input matches case A
-- **Case B** (output) — fires when the input matches case B
-- **Default** (output) — fires when the input does not match any defined case
+- **In** (input) -- the value to match against cases
+- **Case A** (output) -- fires when the input matches case A
+- **Case B** (output) -- fires when the input matches case B
+- **Default** (output) -- fires when the input does not match any defined case
 
 ## Behavior
 

package/docs/css/docuserve.css

@@ -1,73 +1,327 @@
 /* ============================================================================
-   Pict Docuserve - Base Styles
+   Pict Docuserve - Base Styles & Theme Variables
    ============================================================================ */
 
-/* Reset and base */
-*, *::before, *::after {
+/* ----------------------------------------------------------------------------
+   Theme variables — light defaults on :root.
+   Dark mode applies when either:
+     (a) the user explicitly selected dark via <html data-theme="dark">
+     (b) the user hasn't chosen anything AND the system prefers dark
+   An explicit <html data-theme="light"> pins the light palette regardless.
+   ---------------------------------------------------------------------------- */
+
+:root
+{
+	/* Surfaces */
+	--docuserve-bg: #FDFBF7;
+	--docuserve-bg-elevated: #FFFFFF;
+	--docuserve-border: #DDD6CA;
+	--docuserve-border-soft: #EAE3D8;
+
+	/* Text */
+	--docuserve-text: #2A241E;
+	--docuserve-text-strong: #3D3229;
+	--docuserve-text-muted: #5E5549;
+	--docuserve-text-dim: #8A7F72;
+
+	/* Accent / links */
+	--docuserve-accent: #2E7D74;
+	--docuserve-accent-hover: #236660;
+
+	/* Top bar */
+	--docuserve-topbar-bg: #3D3229;
+	--docuserve-topbar-text: #E8E0D4;
+	--docuserve-topbar-text-muted: #B5AA9A;
+	--docuserve-topbar-text-dim: #8A7F72;
+	--docuserve-topbar-hover-bg: #524438;
+	--docuserve-topbar-version-bg: rgba(255, 255, 255, 0.06);
+	--docuserve-topbar-version-border: rgba(255, 255, 255, 0.08);
+	--docuserve-topbar-version-text: #B5AA9A;
+
+	/* Sidebar */
+	--docuserve-sidebar-bg: #FAF7F1;
+	--docuserve-sidebar-border: #DDD6CA;
+	--docuserve-sidebar-border-soft: #E5DED1;
+	--docuserve-sidebar-text: #423D37;
+	--docuserve-sidebar-group-title: #3D3229;
+	--docuserve-sidebar-module-text: #5E5549;
+	--docuserve-sidebar-hover-bg: #EAE3D8;
+	--docuserve-sidebar-hover-text: #2E7D74;
+	--docuserve-sidebar-active-bg: #E5DED1;
+	--docuserve-sidebar-active-text: #2E7D74;
+	--docuserve-sidebar-search-bg: #FFFFFF;
+	--docuserve-sidebar-search-border: #DDD6CA;
+
+	/* Inline code */
+	--docuserve-inline-code-bg: #F0ECE4;
+	--docuserve-inline-code-text: #9E3A50;
+
+	/* Code block panel */
+	--docuserve-code-bg: #F6F3EE;
+	--docuserve-code-border: #E5DED1;
+	--docuserve-code-gutter-bg: #EFEAE0;
+	--docuserve-code-gutter-border: #DDD6CA;
+	--docuserve-code-gutter-text: #A59986;
+	--docuserve-code-text: #2A241E;
+
+	/* Syntax tokens — low-chroma dark-on-light palette */
+	--docuserve-tok-keyword: #A03472;
+	--docuserve-tok-string: #1A6640;
+	--docuserve-tok-number: #B25A00;
+	--docuserve-tok-comment: #8A7F72;
+	--docuserve-tok-operator: #2E7D74;
+	--docuserve-tok-punctuation: #2A241E;
+	--docuserve-tok-function: #2A5DB0;
+	--docuserve-tok-property: #9E3A50;
+	--docuserve-tok-tag: #9E3A50;
+	--docuserve-tok-attr-name: #B25A00;
+	--docuserve-tok-attr-value: #1A6640;
+
+	/* Tables, blockquotes, mermaid */
+	--docuserve-table-header-bg: #F5F0E8;
+	--docuserve-table-row-alt-bg: #F9F6F0;
+	--docuserve-blockquote-bg: #F7F5F0;
+	--docuserve-blockquote-border: #2E7D74;
+	--docuserve-blockquote-text: #5E5549;
+	--docuserve-mermaid-bg: #FFFFFF;
+
+	/* Scrollbars */
+	--docuserve-scrollbar-track: #F5F0E8;
+	--docuserve-scrollbar-thumb: #D4CCBE;
+	--docuserve-scrollbar-thumb-hover: #B5AA9A;
+}
+
+@media (prefers-color-scheme: dark)
+{
+	:root:not([data-theme="light"])
+	{
+		--docuserve-bg: #15120F;
+		--docuserve-bg-elevated: #1B1814;
+		--docuserve-border: #2F2823;
+		--docuserve-border-soft: #26211C;
+
+		--docuserve-text: #E8E0D4;
+		--docuserve-text-strong: #F2ECE0;
+		--docuserve-text-muted: #B5AA9A;
+		--docuserve-text-dim: #7A6F62;
+
+		--docuserve-accent: #5DB8A8;
+		--docuserve-accent-hover: #7FCCB8;
+
+		--docuserve-topbar-bg: #1A1612;
+		--docuserve-topbar-text: #E8E0D4;
+		--docuserve-topbar-text-muted: #B5AA9A;
+		--docuserve-topbar-text-dim: #7A6F62;
+		--docuserve-topbar-hover-bg: #2A241E;
+		--docuserve-topbar-version-bg: rgba(255, 255, 255, 0.05);
+		--docuserve-topbar-version-border: rgba(255, 255, 255, 0.09);
+		--docuserve-topbar-version-text: #B5AA9A;
+
+		--docuserve-sidebar-bg: #1B1814;
+		--docuserve-sidebar-border: #2F2823;
+		--docuserve-sidebar-border-soft: #26211C;
+		--docuserve-sidebar-text: #C9C0B3;
+		--docuserve-sidebar-group-title: #F2ECE0;
+		--docuserve-sidebar-module-text: #B5AA9A;
+		--docuserve-sidebar-hover-bg: #2A241E;
+		--docuserve-sidebar-hover-text: #7FCCB8;
+		--docuserve-sidebar-active-bg: #2F2823;
+		--docuserve-sidebar-active-text: #7FCCB8;
+		--docuserve-sidebar-search-bg: #26211C;
+		--docuserve-sidebar-search-border: #2F2823;
+
+		--docuserve-inline-code-bg: #2A241E;
+		--docuserve-inline-code-text: #E8B07A;
+
+		--docuserve-code-bg: #1E1A17;
+		--docuserve-code-border: #2F2823;
+		--docuserve-code-gutter-bg: #17130F;
+		--docuserve-code-gutter-border: #2F2823;
+		--docuserve-code-gutter-text: #6A6052;
+		--docuserve-code-text: #E8E0D4;
+
+		--docuserve-tok-keyword: #C678DD;
+		--docuserve-tok-string: #98C379;
+		--docuserve-tok-number: #D19A66;
+		--docuserve-tok-comment: #7F848E;
+		--docuserve-tok-operator: #56B6C2;
+		--docuserve-tok-punctuation: #E8E0D4;
+		--docuserve-tok-function: #61AFEF;
+		--docuserve-tok-property: #E06C75;
+		--docuserve-tok-tag: #E06C75;
+		--docuserve-tok-attr-name: #D19A66;
+		--docuserve-tok-attr-value: #98C379;
+
+		--docuserve-table-header-bg: #26211C;
+		--docuserve-table-row-alt-bg: #1F1B17;
+		--docuserve-blockquote-bg: #1F1B17;
+		--docuserve-blockquote-border: #5DB8A8;
+		--docuserve-blockquote-text: #C9C0B3;
+		--docuserve-mermaid-bg: #E8E0D4;
+
+		--docuserve-scrollbar-track: #1B1814;
+		--docuserve-scrollbar-thumb: #3A322B;
+		--docuserve-scrollbar-thumb-hover: #524438;
+	}
+}
+
+:root[data-theme="dark"]
+{
+	--docuserve-bg: #15120F;
+	--docuserve-bg-elevated: #1B1814;
+	--docuserve-border: #2F2823;
+	--docuserve-border-soft: #26211C;
+
+	--docuserve-text: #E8E0D4;
+	--docuserve-text-strong: #F2ECE0;
+	--docuserve-text-muted: #B5AA9A;
+	--docuserve-text-dim: #7A6F62;
+
+	--docuserve-accent: #5DB8A8;
+	--docuserve-accent-hover: #7FCCB8;
+
+	--docuserve-topbar-bg: #1A1612;
+	--docuserve-topbar-text: #E8E0D4;
+	--docuserve-topbar-text-muted: #B5AA9A;
+	--docuserve-topbar-text-dim: #7A6F62;
+	--docuserve-topbar-hover-bg: #2A241E;
+	--docuserve-topbar-version-bg: rgba(255, 255, 255, 0.05);
+	--docuserve-topbar-version-border: rgba(255, 255, 255, 0.09);
+	--docuserve-topbar-version-text: #B5AA9A;
+
+	--docuserve-sidebar-bg: #1B1814;
+	--docuserve-sidebar-border: #2F2823;
+	--docuserve-sidebar-border-soft: #26211C;
+	--docuserve-sidebar-text: #C9C0B3;
+	--docuserve-sidebar-group-title: #F2ECE0;
+	--docuserve-sidebar-module-text: #B5AA9A;
+	--docuserve-sidebar-hover-bg: #2A241E;
+	--docuserve-sidebar-hover-text: #7FCCB8;
+	--docuserve-sidebar-active-bg: #2F2823;
+	--docuserve-sidebar-active-text: #7FCCB8;
+	--docuserve-sidebar-search-bg: #26211C;
+	--docuserve-sidebar-search-border: #2F2823;
+
+	--docuserve-inline-code-bg: #2A241E;
+	--docuserve-inline-code-text: #E8B07A;
+
+	--docuserve-code-bg: #1E1A17;
+	--docuserve-code-border: #2F2823;
+	--docuserve-code-gutter-bg: #17130F;
+	--docuserve-code-gutter-border: #2F2823;
+	--docuserve-code-gutter-text: #6A6052;
+	--docuserve-code-text: #E8E0D4;
+
+	--docuserve-tok-keyword: #C678DD;
+	--docuserve-tok-string: #98C379;
+	--docuserve-tok-number: #D19A66;
+	--docuserve-tok-comment: #7F848E;
+	--docuserve-tok-operator: #56B6C2;
+	--docuserve-tok-punctuation: #E8E0D4;
+	--docuserve-tok-function: #61AFEF;
+	--docuserve-tok-property: #E06C75;
+	--docuserve-tok-tag: #E06C75;
+	--docuserve-tok-attr-name: #D19A66;
+	--docuserve-tok-attr-value: #98C379;
+
+	--docuserve-table-header-bg: #26211C;
+	--docuserve-table-row-alt-bg: #1F1B17;
+	--docuserve-blockquote-bg: #1F1B17;
+	--docuserve-blockquote-border: #5DB8A8;
+	--docuserve-blockquote-text: #C9C0B3;
+	--docuserve-mermaid-bg: #E8E0D4;
+
+	--docuserve-scrollbar-track: #1B1814;
+	--docuserve-scrollbar-thumb: #3A322B;
+	--docuserve-scrollbar-thumb-hover: #524438;
+}
+
+/* ----------------------------------------------------------------------------
+   Reset and base
+   ---------------------------------------------------------------------------- */
+
+*, *::before, *::after
+{
 	box-sizing: border-box;
 }
 
-html, body {
+html, body
+{
 	margin: 0;
 	padding: 0;
 	font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
 	font-size: 16px;
 	line-height: 1.5;
-	color: #423D37;
-	background-color: #fff;
+	color: var(--docuserve-text);
+	background-color: var(--docuserve-bg);
 	-webkit-font-smoothing: antialiased;
 	-moz-osx-font-smoothing: grayscale;
+	transition: background-color 0.15s ease, color 0.15s ease;
 }
 
 /* Typography */
-h1, h2, h3, h4, h5, h6 {
+h1, h2, h3, h4, h5, h6
+{
 	margin-top: 0;
 	line-height: 1.3;
+	color: var(--docuserve-text-strong);
 }
 
-a {
-	color: #2E7D74;
+a
+{
+	color: var(--docuserve-accent);
 	text-decoration: none;
 }
 
-a:hover {
-	color: #256861;
+a:hover
+{
+	color: var(--docuserve-accent-hover);
 }
 
 /* Application container */
-#Docuserve-Application-Container {
+#Docuserve-Application-Container
+{
 	min-height: 100vh;
 }
 
 /* Utility: scrollbar styling */
-::-webkit-scrollbar {
+::-webkit-scrollbar
+{
 	width: 8px;
+	height: 8px;
 }
 
-::-webkit-scrollbar-track {
-	background: #F5F0E8;
+::-webkit-scrollbar-track
+{
+	background: var(--docuserve-scrollbar-track);
 }
 
-::-webkit-scrollbar-thumb {
-	background: #D4CCBE;
+::-webkit-scrollbar-thumb
+{
+	background: var(--docuserve-scrollbar-thumb);
 	border-radius: 4px;
 }
 
-::-webkit-scrollbar-thumb:hover {
-	background: #B5AA9A;
+::-webkit-scrollbar-thumb:hover
+{
+	background: var(--docuserve-scrollbar-thumb-hover);
 }
 
 /* Responsive adjustments */
-@media (max-width: 768px) {
-	html {
+@media (max-width: 768px)
+{
+	html
+	{
 		font-size: 14px;
 	}
 
-	#Docuserve-Sidebar-Container {
+	#Docuserve-Sidebar-Container
+	{
 		display: none;
 	}
 
-	.docuserve-body {
+	.docuserve-body
+	{
 		flex-direction: column;
 	}
 }

package/docs/index.html

@@ -4,9 +4,9 @@
 		<meta charset="utf-8">
 		<meta http-equiv="X-UA-Compatible" content="IE=edge">
 		<meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
-		<meta name="description" content="Documentation powered by pict-docuserve">
+		<meta name="description" content="Pict-Section-Flow v0.0.17 Documentation — Pict Section Flow Diagram">
 
-		<title>Documentation</title>
+		<title>Pict-Section-Flow v0.0.17 Documentation</title>
 
 		<!-- Application Stylesheet -->
 		<link href="css/docuserve.css" rel="stylesheet">

package/docs/retold-catalog.json

@@ -1,5 +1,5 @@
 {
-	"Generated": "2026-03-17T22:19:31.420Z",
+	"Generated": "2026-04-10T17:25:15.652Z",
 	"GitHubOrg": "stevenvelozo",
 	"DefaultBranch": "master",
 	"Groups": [

package/docs/retold-keyword-index.json

@@ -1,5 +1,5 @@
 {
-	"Generated": "2026-03-17T22:19:31.660Z",
+	"Generated": "2026-04-10T17:25:15.920Z",
 	"DocumentCount": 30,
 	"LunrIndex": {
 		"version": "2.3.9",

package/example_applications/simple_cards/css/flowexample.css

@@ -13,7 +13,7 @@ html, body {
     font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
     font-size: 16px;
     line-height: 1.5;
-    color: #333;
+    color: var(--theme-color-text-primary, #333);
     background-color: #f5f7fa;
     -webkit-font-smoothing: antialiased;
     -moz-osx-font-smoothing: grayscale;
@@ -45,7 +45,7 @@ a:hover {
 }
 
 ::-webkit-scrollbar-track {
-    background: #f1f1f1;
+    background: var(--theme-color-background-tertiary, #f1f1f1);
 }
 
 ::-webkit-scrollbar-thumb {

package/example_applications/simple_cards/source/card-help-content.js

@@ -1,16 +1,16 @@
 // Auto-generated by scripts/generate-card-help.js — do not edit manually.
 // Source markdown files are in docs/card-help/
 module.exports = {
-	"EACH": "<h1>Each (Loop Iterator)</h1><p>The <b>Each</b> node iterates over a collection, executing connected downstream nodes once for each item. When iteration completes, the <b>Done</b> output fires.</p><h2>Ports</h2><ul><li><b>Collection</b> (input) — an array or iterable to loop over</li><li><b>Item</b> (output) — fires once per element with the current item</li><li><b>Done</b> (output) — fires after all items have been processed</li></ul><h2>Behavior</h2><p>When a collection arrives at the input port, the Each node processes items sequentially. For every element in the collection, the <b>Item</b> output is activated with the current element as the payload. After the final element is processed, the <b>Done</b> output fires to signal completion.</p><h2>Tips</h2><ul><li>Connect <b>Item</b> to a processing chain and <b>Done</b> to continuation logic</li><li>Nested loops are supported by chaining multiple Each nodes</li><li>Empty collections skip directly to the <b>Done</b> output</li></ul>",
-	"FREAD": "<h1>File Read</h1><p>The <b>File Read</b> node reads the contents of a file from the filesystem and outputs the data.</p><h2>Ports</h2><ul><li><b>Path</b> (input) — the filesystem path to read</li><li><b>Data</b> (output) — the file contents on success</li><li><b>Error</b> (output) — fires if the read operation fails</li></ul><h2>Properties</h2><ul><li><b>FilePath</b> — the path to the file to read</li><li><b>Encoding</b> — character encoding for text files (e.g. <code>utf8</code>, <code>ascii</code>)</li></ul><h2>Behavior</h2><p>When triggered, the node reads the file at the configured path. On success, the raw file contents are emitted from the <b>Data</b> output. If the file does not exist or cannot be read, the <b>Error</b> output fires with a descriptive error message.</p><h2>Tips</h2><ul><li>Use a Get Value node upstream to dynamically set the file path</li><li>Pair with a Data Preview node to inspect the file contents</li><li>Connect the <b>Error</b> output to logging or notification nodes for robust error handling</li></ul>",
-	"FWRITE": "<h1>File Write</h1><p>The <b>File Write</b> node writes data to a file on the filesystem.</p><h2>Ports</h2><ul><li><b>Path</b> (input) — the destination filesystem path</li><li><b>Data</b> (input) — the content to write</li><li><b>Done</b> (output) — fires after a successful write</li><li><b>Error</b> (output) — fires if the write operation fails</li></ul><h2>Behavior</h2><p>When both inputs are satisfied, the node writes the provided data to the specified file path. On success the <b>Done</b> output fires. If the write fails (for example due to permissions or a missing directory), the <b>Error</b> output fires with a descriptive error message.</p><h2>Properties Panel</h2><p>The properties panel shows a View-based info panel with details about the configured file path and write options.</p><h2>Tips</h2><ul><li>Directories in the path are not created automatically — ensure they exist before writing</li><li>Combine with a Set Value node to format data before writing</li><li>Connect the <b>Error</b> output to a Log Values node to capture write failures</li></ul>",
-	"GET": "<h1>Get Value</h1><p>The <b>Get Value</b> node retrieves a named variable from the flow context and emits its current value.</p><h2>Ports</h2><ul><li><b>In</b> (input) — trigger to read the value</li><li><b>Value</b> (output) — the retrieved value</li></ul><h2>Behavior</h2><p>When triggered, the node looks up a named key in the flow context and emits the stored value from the <b>Value</b> output. If the key does not exist, the output value is <code>undefined</code>.</p><h2>Usage</h2><p>Pair with a <b>Set Value</b> node to establish a read/write variable pattern. The Set Value node stores a value under a named key; the Get Value node retrieves it downstream.</p><h2>Tips</h2><ul><li>Variable names are case-sensitive</li><li>Use descriptive variable names to keep flows readable</li><li>Get Value is especially useful for accessing values set in a different branch of the flow</li></ul>",
-	"ITE": "<h1>If-Then-Else</h1><p>The <b>If-Then-Else</b> node evaluates a boolean condition expression and routes the flow to one of two outputs.</p><h2>Ports</h2><ul><li><b>In</b> (input) — trigger that starts the evaluation</li><li><b>Then</b> (output) — activated when the condition is <b>true</b></li><li><b>Else</b> (output) — activated when the condition is <b>false</b></li></ul><h2>Behavior</h2><p>When the input fires, the node evaluates the configured condition expression against the current flow context. If the expression resolves to a truthy value, the <b>Then</b> output is activated. Otherwise, the <b>Else</b> output is activated. Exactly one output fires per evaluation.</p><h2>Configuration</h2><p>Set the condition expression in the node's data properties. The expression is evaluated in the flow context, giving it access to any variables set by upstream Set Value nodes.</p><h2>Tips</h2><ul><li>Chain multiple If-Then-Else nodes for complex branching logic</li><li>Connect the <b>Else</b> output to another If-Then-Else to build else-if chains</li><li>Use descriptive condition expressions to keep the flow self-documenting</li></ul>",
-	"LOG": "<h1>Log Values</h1><p>The <b>Log Values</b> node writes incoming data to the console or log output for debugging purposes.</p><h2>Ports</h2><ul><li><b>Values</b> (input, multi) — accepts one or more connections carrying values to log</li><li><b>Pass</b> (output) — passes the last received value through unchanged</li></ul><h2>Properties</h2><ul><li><b>LogLevel</b> — the severity level for the log entry (e.g. <code>info</code>, <code>warn</code>, <code>error</code>, <code>trace</code>)</li><li><b>Format</b> — an optional format string controlling how values are serialized</li></ul><h2>Behavior</h2><p>When data arrives at any input connection, the node serializes the value and writes it to the configured log output at the specified log level. The data is then forwarded to the <b>Pass</b> output unchanged, so the Log Values node can be inserted inline without disrupting the flow.</p><h2>Tips</h2><ul><li>Use multiple input connections to aggregate log output from parallel branches</li><li>Set the log level to <code>trace</code> during development and <code>warn</code> in production flows</li><li>Insert between any two nodes for quick inline debugging</li></ul>",
-	"NOTE": "<h1>Comment</h1><p>The <b>Comment</b> node is a floating annotation for documenting flow logic. It has no input or output ports and does not participate in data flow execution.</p><h2>Usage</h2><p>Drop a Comment node anywhere on the canvas to add context, explain design decisions, or leave notes for collaborators. The note text is stored in the node's <code>Data.NoteText</code> property and displayed directly in the node body.</p><h2>Properties</h2><ul><li><b>NoteText</b> — the annotation content displayed in the node body</li></ul><h2>Tips</h2><ul><li>Use comments to explain complex branching logic or non-obvious configuration choices</li><li>Comment nodes can be freely repositioned without affecting connections</li><li>Group related comments near the nodes they describe</li></ul>",
-	"PREV": "<h1>Data Preview</h1><p>The <b>Data Preview</b> node displays a tabular summary of the data flowing through it. Use it as an inline debugger to inspect field names, types, and current values without interrupting the flow.</p><h2>Ports</h2><ul><li><b>Data</b> (input) — the data object to inspect</li><li><b>Pass</b> (output) — passes the data through unchanged</li></ul><h2>Behavior</h2><p>The preview renders a compact table inside the node body showing each field's name, inferred data type, and current value. The node is pass-through: data enters on the left and exits on the right without modification.</p><h2>Tips</h2><ul><li>Insert a Data Preview between two nodes to inspect intermediate state</li><li>The preview updates whenever new data arrives at the input port</li><li>Useful during development for verifying data transformations</li></ul>",
-	"SET": "<h1>Set Value</h1><p>The <b>Set Value</b> node assigns a value to a named variable in the flow context.</p><h2>Ports</h2><ul><li><b>In</b> (input) — trigger to perform the assignment</li><li><b>Out</b> (output) — fires after the value has been set</li></ul><h2>Properties</h2><ul><li><b>Variable Name</b> — the key under which the value will be stored</li><li><b>Value Expression</b> — the expression to evaluate and assign</li></ul><h2>Behavior</h2><p>When triggered, the node evaluates the <b>Value Expression</b> and stores the result under the configured <b>Variable Name</b> in the flow context. Downstream nodes can read this value using a <b>Get Value</b> node with the same variable name.</p><h2>Configuration</h2><p>Open the properties panel to configure the variable name and value expression using the built-in form editor.</p><h2>Tips</h2><ul><li>Variable names are case-sensitive — use consistent naming conventions</li><li>Value expressions have access to the current flow context</li><li>Use Set Value at the beginning of a flow to initialize default variables</li></ul>",
-	"SPKL": "<h1>Sparkline</h1><p>The <b>Sparkline</b> node renders a live sparkline chart visualizing numeric throughput data directly in the node body.</p><h2>Ports</h2><ul><li><b>Values</b> (input) — a numeric array or stream of values to plot</li><li><b>Stats</b> (output) — emits computed statistics (min, max, mean) for the data set</li></ul><h2>Behavior</h2><p>The node draws a compact line chart inside the node body using a canvas renderer. As new numeric data arrives at the input, the chart updates to reflect the latest values. The filled area under the line and an endpoint dot provide visual emphasis on the current value.</p><h2>Appearance</h2><p>The chart uses the node's theme color for the line and fill area. The last data point is highlighted with a dot. The sparkline scales automatically to fit the available body area.</p><h2>Tips</h2><ul><li>Connect to any node that produces a numeric array for instant visualization</li><li>Use alongside a Data Preview node for combined visual and tabular inspection</li><li>The Stats output is useful for feeding threshold values into an If-Then-Else node</li></ul>",
-	"STAT": "<h1>Status Monitor</h1><p>The <b>Status Monitor</b> node monitors the health status of upstream services and reports availability.</p><h2>Ports</h2><ul><li><b>Check</b> (input, multi) — accepts connections from one or more services to monitor</li><li><b>Healthy</b> (output) — fires when all monitored services report healthy</li><li><b>Degraded</b> (output) — fires when one or more services report degraded status</li></ul><h2>Behavior</h2><p>The node body displays a visual health grid showing the status of each monitored service with colored indicators. Green indicates a healthy service; yellow indicates degraded performance. When all services are healthy, the <b>Healthy</b> output is activated. If any service reports degraded status, the <b>Degraded</b> output fires instead.</p><h2>Appearance</h2><p>The node body renders SVG status circles labeled with service names (e.g. API, DB, Cache, Queue). Port labels appear on hover for a cleaner default appearance.</p><h2>Tips</h2><ul><li>Connect multiple services to the <b>Check</b> input to build a comprehensive health dashboard</li><li>Route the <b>Degraded</b> output to notification or alerting nodes</li><li>Combine with an Each node to check a dynamic list of service endpoints</li></ul>",
-	"SW": "<h1>Switch</h1><p>The <b>Switch</b> node routes execution to one of multiple outputs based on a matching value, similar to a switch/case statement in programming.</p><h2>Ports</h2><ul><li><b>In</b> (input) — the value to match against cases</li><li><b>Case A</b> (output) — fires when the input matches case A</li><li><b>Case B</b> (output) — fires when the input matches case B</li><li><b>Default</b> (output) — fires when the input does not match any defined case</li></ul><h2>Behavior</h2><p>When a value arrives at the input, the node compares it against each configured case. The first matching case's output is activated. If no case matches, the <b>Default</b> output fires. Only one output is activated per evaluation.</p><h2>Configuration</h2><p>Define case match values in the node's data properties. Each case corresponds to one of the named outputs.</p><h2>Tips</h2><ul><li>Add more output ports by extending the card definition for additional cases</li><li>Use the <b>Default</b> output as a catch-all for unexpected values</li><li>Chain a Switch after an If-Then-Else for multi-level routing logic</li><li>Case matching is based on strict equality</li></ul>"
+	"EACH": "<h1>Each (Loop Iterator)</h1><p>The <b>Each</b> node iterates over a collection, executing connected downstream nodes once for each item. When iteration completes, the <b>Done</b> output fires.</p><h2>Ports</h2><ul><li><b>Collection</b> (input) -- an array or iterable to loop over</li><li><b>Item</b> (output) -- fires once per element with the current item</li><li><b>Done</b> (output) -- fires after all items have been processed</li></ul><h2>Behavior</h2><p>When a collection arrives at the input port, the Each node processes items sequentially. For every element in the collection, the <b>Item</b> output is activated with the current element as the payload. After the final element is processed, the <b>Done</b> output fires to signal completion.</p><h2>Tips</h2><ul><li>Connect <b>Item</b> to a processing chain and <b>Done</b> to continuation logic</li><li>Nested loops are supported by chaining multiple Each nodes</li><li>Empty collections skip directly to the <b>Done</b> output</li></ul>",
+	"FREAD": "<h1>File Read</h1><p>The <b>File Read</b> node reads the contents of a file from the filesystem and outputs the data.</p><h2>Ports</h2><ul><li><b>Path</b> (input) -- the filesystem path to read</li><li><b>Data</b> (output) -- the file contents on success</li><li><b>Error</b> (output) -- fires if the read operation fails</li></ul><h2>Properties</h2><ul><li><b>FilePath</b> -- the path to the file to read</li><li><b>Encoding</b> -- character encoding for text files (e.g. <code>utf8</code>, <code>ascii</code>)</li></ul><h2>Behavior</h2><p>When triggered, the node reads the file at the configured path. On success, the raw file contents are emitted from the <b>Data</b> output. If the file does not exist or cannot be read, the <b>Error</b> output fires with a descriptive error message.</p><h2>Tips</h2><ul><li>Use a Get Value node upstream to dynamically set the file path</li><li>Pair with a Data Preview node to inspect the file contents</li><li>Connect the <b>Error</b> output to logging or notification nodes for robust error handling</li></ul>",
+	"FWRITE": "<h1>File Write</h1><p>The <b>File Write</b> node writes data to a file on the filesystem.</p><h2>Ports</h2><ul><li><b>Path</b> (input) -- the destination filesystem path</li><li><b>Data</b> (input) -- the content to write</li><li><b>Done</b> (output) -- fires after a successful write</li><li><b>Error</b> (output) -- fires if the write operation fails</li></ul><h2>Behavior</h2><p>When both inputs are satisfied, the node writes the provided data to the specified file path. On success the <b>Done</b> output fires. If the write fails (for example due to permissions or a missing directory), the <b>Error</b> output fires with a descriptive error message.</p><h2>Properties Panel</h2><p>The properties panel shows a View-based info panel with details about the configured file path and write options.</p><h2>Tips</h2><ul><li>Directories in the path are not created automatically -- ensure they exist before writing</li><li>Combine with a Set Value node to format data before writing</li><li>Connect the <b>Error</b> output to a Log Values node to capture write failures</li></ul>",
+	"GET": "<h1>Get Value</h1><p>The <b>Get Value</b> node retrieves a named variable from the flow context and emits its current value.</p><h2>Ports</h2><ul><li><b>In</b> (input) -- trigger to read the value</li><li><b>Value</b> (output) -- the retrieved value</li></ul><h2>Behavior</h2><p>When triggered, the node looks up a named key in the flow context and emits the stored value from the <b>Value</b> output. If the key does not exist, the output value is <code>undefined</code>.</p><h2>Usage</h2><p>Pair with a <b>Set Value</b> node to establish a read/write variable pattern. The Set Value node stores a value under a named key; the Get Value node retrieves it downstream.</p><h2>Tips</h2><ul><li>Variable names are case-sensitive</li><li>Use descriptive variable names to keep flows readable</li><li>Get Value is especially useful for accessing values set in a different branch of the flow</li></ul>",
+	"ITE": "<h1>If-Then-Else</h1><p>The <b>If-Then-Else</b> node evaluates a boolean condition expression and routes the flow to one of two outputs.</p><h2>Ports</h2><ul><li><b>In</b> (input) -- trigger that starts the evaluation</li><li><b>Then</b> (output) -- activated when the condition is <b>true</b></li><li><b>Else</b> (output) -- activated when the condition is <b>false</b></li></ul><h2>Behavior</h2><p>When the input fires, the node evaluates the configured condition expression against the current flow context. If the expression resolves to a truthy value, the <b>Then</b> output is activated. Otherwise, the <b>Else</b> output is activated. Exactly one output fires per evaluation.</p><h2>Configuration</h2><p>Set the condition expression in the node's data properties. The expression is evaluated in the flow context, giving it access to any variables set by upstream Set Value nodes.</p><h2>Tips</h2><ul><li>Chain multiple If-Then-Else nodes for complex branching logic</li><li>Connect the <b>Else</b> output to another If-Then-Else to build else-if chains</li><li>Use descriptive condition expressions to keep the flow self-documenting</li></ul>",
+	"LOG": "<h1>Log Values</h1><p>The <b>Log Values</b> node writes incoming data to the console or log output for debugging purposes.</p><h2>Ports</h2><ul><li><b>Values</b> (input, multi) -- accepts one or more connections carrying values to log</li><li><b>Pass</b> (output) -- passes the last received value through unchanged</li></ul><h2>Properties</h2><ul><li><b>LogLevel</b> -- the severity level for the log entry (e.g. <code>info</code>, <code>warn</code>, <code>error</code>, <code>trace</code>)</li><li><b>Format</b> -- an optional format string controlling how values are serialized</li></ul><h2>Behavior</h2><p>When data arrives at any input connection, the node serializes the value and writes it to the configured log output at the specified log level. The data is then forwarded to the <b>Pass</b> output unchanged, so the Log Values node can be inserted inline without disrupting the flow.</p><h2>Tips</h2><ul><li>Use multiple input connections to aggregate log output from parallel branches</li><li>Set the log level to <code>trace</code> during development and <code>warn</code> in production flows</li><li>Insert between any two nodes for quick inline debugging</li></ul>",
+	"NOTE": "<h1>Comment</h1><p>The <b>Comment</b> node is a floating annotation for documenting flow logic. It has no input or output ports and does not participate in data flow execution.</p><h2>Usage</h2><p>Drop a Comment node anywhere on the canvas to add context, explain design decisions, or leave notes for collaborators. The note text is stored in the node's <code>Data.NoteText</code> property and displayed directly in the node body.</p><h2>Properties</h2><ul><li><b>NoteText</b> -- the annotation content displayed in the node body</li></ul><h2>Tips</h2><ul><li>Use comments to explain complex branching logic or non-obvious configuration choices</li><li>Comment nodes can be freely repositioned without affecting connections</li><li>Group related comments near the nodes they describe</li></ul>",
+	"PREV": "<h1>Data Preview</h1><p>The <b>Data Preview</b> node displays a tabular summary of the data flowing through it. Use it as an inline debugger to inspect field names, types, and current values without interrupting the flow.</p><h2>Ports</h2><ul><li><b>Data</b> (input) -- the data object to inspect</li><li><b>Pass</b> (output) -- passes the data through unchanged</li></ul><h2>Behavior</h2><p>The preview renders a compact table inside the node body showing each field's name, inferred data type, and current value. The node is pass-through: data enters on the left and exits on the right without modification.</p><h2>Tips</h2><ul><li>Insert a Data Preview between two nodes to inspect intermediate state</li><li>The preview updates whenever new data arrives at the input port</li><li>Useful during development for verifying data transformations</li></ul>",
+	"SET": "<h1>Set Value</h1><p>The <b>Set Value</b> node assigns a value to a named variable in the flow context.</p><h2>Ports</h2><ul><li><b>In</b> (input) -- trigger to perform the assignment</li><li><b>Out</b> (output) -- fires after the value has been set</li></ul><h2>Properties</h2><ul><li><b>Variable Name</b> -- the key under which the value will be stored</li><li><b>Value Expression</b> -- the expression to evaluate and assign</li></ul><h2>Behavior</h2><p>When triggered, the node evaluates the <b>Value Expression</b> and stores the result under the configured <b>Variable Name</b> in the flow context. Downstream nodes can read this value using a <b>Get Value</b> node with the same variable name.</p><h2>Configuration</h2><p>Open the properties panel to configure the variable name and value expression using the built-in form editor.</p><h2>Tips</h2><ul><li>Variable names are case-sensitive -- use consistent naming conventions</li><li>Value expressions have access to the current flow context</li><li>Use Set Value at the beginning of a flow to initialize default variables</li></ul>",
+	"SPKL": "<h1>Sparkline</h1><p>The <b>Sparkline</b> node renders a live sparkline chart visualizing numeric throughput data directly in the node body.</p><h2>Ports</h2><ul><li><b>Values</b> (input) -- a numeric array or stream of values to plot</li><li><b>Stats</b> (output) -- emits computed statistics (min, max, mean) for the data set</li></ul><h2>Behavior</h2><p>The node draws a compact line chart inside the node body using a canvas renderer. As new numeric data arrives at the input, the chart updates to reflect the latest values. The filled area under the line and an endpoint dot provide visual emphasis on the current value.</p><h2>Appearance</h2><p>The chart uses the node's theme color for the line and fill area. The last data point is highlighted with a dot. The sparkline scales automatically to fit the available body area.</p><h2>Tips</h2><ul><li>Connect to any node that produces a numeric array for instant visualization</li><li>Use alongside a Data Preview node for combined visual and tabular inspection</li><li>The Stats output is useful for feeding threshold values into an If-Then-Else node</li></ul>",
+	"STAT": "<h1>Status Monitor</h1><p>The <b>Status Monitor</b> node monitors the health status of upstream services and reports availability.</p><h2>Ports</h2><ul><li><b>Check</b> (input, multi) -- accepts connections from one or more services to monitor</li><li><b>Healthy</b> (output) -- fires when all monitored services report healthy</li><li><b>Degraded</b> (output) -- fires when one or more services report degraded status</li></ul><h2>Behavior</h2><p>The node body displays a visual health grid showing the status of each monitored service with colored indicators. Green indicates a healthy service; yellow indicates degraded performance. When all services are healthy, the <b>Healthy</b> output is activated. If any service reports degraded status, the <b>Degraded</b> output fires instead.</p><h2>Appearance</h2><p>The node body renders SVG status circles labeled with service names (e.g. API, DB, Cache, Queue). Port labels appear on hover for a cleaner default appearance.</p><h2>Tips</h2><ul><li>Connect multiple services to the <b>Check</b> input to build a comprehensive health dashboard</li><li>Route the <b>Degraded</b> output to notification or alerting nodes</li><li>Combine with an Each node to check a dynamic list of service endpoints</li></ul>",
+	"SW": "<h1>Switch</h1><p>The <b>Switch</b> node routes execution to one of multiple outputs based on a matching value, similar to a switch/case statement in programming.</p><h2>Ports</h2><ul><li><b>In</b> (input) -- the value to match against cases</li><li><b>Case A</b> (output) -- fires when the input matches case A</li><li><b>Case B</b> (output) -- fires when the input matches case B</li><li><b>Default</b> (output) -- fires when the input does not match any defined case</li></ul><h2>Behavior</h2><p>When a value arrives at the input, the node compares it against each configured case. The first matching case's output is activated. If no case matches, the <b>Default</b> output fires. Only one output is activated per evaluation.</p><h2>Configuration</h2><p>Define case match values in the node's data properties. Each case corresponds to one of the named outputs.</p><h2>Tips</h2><ul><li>Add more output ports by extending the card definition for additional cases</li><li>Use the <b>Default</b> output as a catch-all for unexpected values</li><li>Chain a Switch after an If-Then-Else for multi-level routing logic</li><li>Case matching is based on strict equality</li></ul>"
 };