pict-section-flow 0.0.10 → 0.0.13

package/docs/card-help/FWRITE.md

@@ -0,0 +1,24 @@
+# File Write
+
+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
+
+## Behavior
+
+When both inputs are satisfied, the node writes the provided data to the specified file path. On success the **Done** output fires. If the write fails (for example due to permissions or a missing directory), the **Error** output fires with a descriptive error message.
+
+## Properties Panel
+
+The properties panel shows a View-based info panel with details about the configured file path and write options.
+
+## Tips
+
+- 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

@@ -0,0 +1,22 @@
+# Get Value
+
+The **Get Value** node retrieves a named variable from the flow context and emits its current value.
+
+## Ports
+
+- **In** (input) — trigger to read the value
+- **Value** (output) — the retrieved value
+
+## Behavior
+
+When triggered, the node looks up a named key in the flow context and emits the stored value from the **Value** output. If the key does not exist, the output value is `undefined`.
+
+## Usage
+
+Pair with a **Set Value** 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.
+
+## Tips
+
+- Variable names are case-sensitive
+- Use descriptive variable names to keep flows readable
+- Get Value is especially useful for accessing values set in a different branch of the flow

package/docs/card-help/ITE.md

@@ -0,0 +1,23 @@
+# If-Then-Else
+
+The **If-Then-Else** node evaluates a boolean condition expression and routes the flow to one of two outputs.
+
+## Ports
+
+- **In** (input) — trigger that starts the evaluation
+- **Then** (output) — activated when the condition is **true**
+- **Else** (output) — activated when the condition is **false**
+
+## Behavior
+
+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 **Then** output is activated. Otherwise, the **Else** output is activated. Exactly one output fires per evaluation.
+
+## Configuration
+
+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.
+
+## Tips
+
+- Chain multiple If-Then-Else nodes for complex branching logic
+- Connect the **Else** output to another If-Then-Else to build else-if chains
+- Use descriptive condition expressions to keep the flow self-documenting

package/docs/card-help/LOG.md

@@ -0,0 +1,23 @@
+# Log Values
+
+The **Log Values** node writes incoming data to the console or log output for debugging purposes.
+
+## Ports
+
+- **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
+
+## Behavior
+
+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 **Pass** output unchanged, so the Log Values node can be inserted inline without disrupting the flow.
+
+## Tips
+
+- Use multiple input connections to aggregate log output from parallel branches
+- Set the log level to `trace` during development and `warn` in production flows
+- Insert between any two nodes for quick inline debugging

package/docs/card-help/NOTE.md

@@ -0,0 +1,17 @@
+# Comment
+
+The **Comment** node is a floating annotation for documenting flow logic. It has no input or output ports and does not participate in data flow execution.
+
+## Usage
+
+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 `Data.NoteText` property and displayed directly in the node body.
+
+## Properties
+
+- **NoteText** — the annotation content displayed in the node body
+
+## Tips
+
+- Use comments to explain complex branching logic or non-obvious configuration choices
+- Comment nodes can be freely repositioned without affecting connections
+- Group related comments near the nodes they describe

package/docs/card-help/PREV.md

@@ -0,0 +1,18 @@
+# Data Preview
+
+The **Data Preview** 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.
+
+## Ports
+
+- **Data** (input) — the data object to inspect
+- **Pass** (output) — passes the data through unchanged
+
+## Behavior
+
+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.
+
+## Tips
+
+- Insert a Data Preview between two nodes to inspect intermediate state
+- The preview updates whenever new data arrives at the input port
+- Useful during development for verifying data transformations

package/docs/card-help/SET.md

@@ -0,0 +1,27 @@
+# Set Value
+
+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
+
+## Properties
+
+- **Variable Name** — the key under which the value will be stored
+- **Value Expression** — the expression to evaluate and assign
+
+## Behavior
+
+When triggered, the node evaluates the **Value Expression** and stores the result under the configured **Variable Name** in the flow context. Downstream nodes can read this value using a **Get Value** node with the same variable name.
+
+## Configuration
+
+Open the properties panel to configure the variable name and value expression using the built-in form editor.
+
+## Tips
+
+- 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

@@ -0,0 +1,22 @@
+# Sparkline
+
+The **Sparkline** node renders a live sparkline chart visualizing numeric throughput data directly in the node body.
+
+## Ports
+
+- **Values** (input) — a numeric array or stream of values to plot
+- **Stats** (output) — emits computed statistics (min, max, mean) for the data set
+
+## Behavior
+
+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.
+
+## Appearance
+
+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.
+
+## Tips
+
+- Connect to any node that produces a numeric array for instant visualization
+- Use alongside a Data Preview node for combined visual and tabular inspection
+- The Stats output is useful for feeding threshold values into an If-Then-Else node

package/docs/card-help/STAT.md

@@ -0,0 +1,23 @@
+# Status Monitor
+
+The **Status Monitor** node monitors the health status of upstream services and reports availability.
+
+## 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
+
+## Behavior
+
+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 **Healthy** output is activated. If any service reports degraded status, the **Degraded** output fires instead.
+
+## Appearance
+
+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.
+
+## Tips
+
+- Connect multiple services to the **Check** input to build a comprehensive health dashboard
+- Route the **Degraded** output to notification or alerting nodes
+- Combine with an Each node to check a dynamic list of service endpoints

package/docs/card-help/SW.md

@@ -0,0 +1,25 @@
+# Switch
+
+The **Switch** node routes execution to one of multiple outputs based on a matching value, similar to a switch/case statement in programming.
+
+## 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
+
+## Behavior
+
+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 **Default** output fires. Only one output is activated per evaluation.
+
+## Configuration
+
+Define case match values in the node's data properties. Each case corresponds to one of the named outputs.
+
+## Tips
+
+- Add more output ports by extending the card definition for additional cases
+- Use the **Default** output as a catch-all for unexpected values
+- Chain a Switch after an If-Then-Else for multi-level routing logic
+- Case matching is based on strict equality

package/docs/css/docuserve.css

@@ -0,0 +1,73 @@
+/* ============================================================================
+   Pict Docuserve - Base Styles
+   ============================================================================ */
+
+/* Reset and base */
+*, *::before, *::after {
+	box-sizing: border-box;
+}
+
+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;
+	-webkit-font-smoothing: antialiased;
+	-moz-osx-font-smoothing: grayscale;
+}
+
+/* Typography */
+h1, h2, h3, h4, h5, h6 {
+	margin-top: 0;
+	line-height: 1.3;
+}
+
+a {
+	color: #2E7D74;
+	text-decoration: none;
+}
+
+a:hover {
+	color: #256861;
+}
+
+/* Application container */
+#Docuserve-Application-Container {
+	min-height: 100vh;
+}
+
+/* Utility: scrollbar styling */
+::-webkit-scrollbar {
+	width: 8px;
+}
+
+::-webkit-scrollbar-track {
+	background: #F5F0E8;
+}
+
+::-webkit-scrollbar-thumb {
+	background: #D4CCBE;
+	border-radius: 4px;
+}
+
+::-webkit-scrollbar-thumb:hover {
+	background: #B5AA9A;
+}
+
+/* Responsive adjustments */
+@media (max-width: 768px) {
+	html {
+		font-size: 14px;
+	}
+
+	#Docuserve-Sidebar-Container {
+		display: none;
+	}
+
+	.docuserve-body {
+		flex-direction: column;
+	}
+}

package/docs/index.html

@@ -0,0 +1,39 @@
+<!doctype html>
+<html lang="en">
+	<head>
+		<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">
+
+		<title>Documentation</title>
+
+		<!-- Application Stylesheet -->
+		<link href="css/docuserve.css" rel="stylesheet">
+		<!-- KaTeX stylesheet for LaTeX equation rendering -->
+		<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/katex@0.16.21/dist/katex.min.css">
+		<!-- PICT Dynamic View CSS Container -->
+		<style id="PICT-CSS"></style>
+
+		<!-- Load the PICT library from jsDelivr CDN -->
+		<script src="https://cdn.jsdelivr.net/npm/pict@1/dist/pict.min.js" type="text/javascript"></script>
+		<!-- Bootstrap the Application -->
+		<script type="text/javascript">
+//<![CDATA[
+		Pict.safeOnDocumentReady(() => { Pict.safeLoadPictApplication(PictDocuserve, 2)});
+//]]>
+		</script>
+	</head>
+	<body>
+		<!-- The root container for the Pict application -->
+		<div id="Docuserve-Application-Container"></div>
+
+		<!-- Mermaid diagram rendering -->
+		<script src="https://cdn.jsdelivr.net/npm/mermaid@11/dist/mermaid.min.js"></script>
+		<script>mermaid.initialize({ startOnLoad: false, theme: 'default' });</script>
+		<!-- KaTeX for LaTeX equation rendering -->
+		<script defer src="https://cdn.jsdelivr.net/npm/katex@0.16.21/dist/katex.min.js"></script>
+		<!-- Load the Docuserve PICT Application Bundle from jsDelivr CDN -->
+		<script src="https://cdn.jsdelivr.net/npm/pict-docuserve@0/dist/pict-docuserve.min.js" type="text/javascript"></script>
+	</body>
+</html>

package/docs/retold-catalog.json

@@ -0,0 +1,169 @@
+{
+	"Generated": "2026-03-17T22:19:31.420Z",
+	"GitHubOrg": "stevenvelozo",
+	"DefaultBranch": "master",
+	"Groups": [
+		{
+			"Name": "Dist",
+			"Key": "dist",
+			"Description": "",
+			"Modules": [
+				{
+					"Name": "indoctrinate_content_staging",
+					"Repo": "indoctrinate_content_staging",
+					"Group": "dist",
+					"Branch": "master",
+					"HasDocs": false,
+					"HasCover": false,
+					"Sidebar": [],
+					"DocFiles": []
+				}
+			]
+		},
+		{
+			"Name": "Docs",
+			"Key": "docs",
+			"Description": "",
+			"Modules": [
+				{
+					"Name": "api",
+					"Repo": "api",
+					"Group": "docs",
+					"Branch": "master",
+					"HasDocs": true,
+					"HasCover": false,
+					"Sidebar": [],
+					"DocFiles": [
+						"api/PictFlowCard.md",
+						"api/PictFlowCardPropertiesPanel.md",
+						"api/addConnection.md",
+						"api/addNode.md",
+						"api/autoLayout.md",
+						"api/getFlowData.md",
+						"api/marshalToView.md",
+						"api/openPanel.md",
+						"api/registerHandler.md",
+						"api/registerNodeType.md",
+						"api/removeConnection.md",
+						"api/removeNode.md",
+						"api/saveLayout.md",
+						"api/screenToSVGCoords.md",
+						"api/selectNode.md",
+						"api/setTheme.md",
+						"api/setZoom.md",
+						"api/toggleFullscreen.md"
+					]
+				},
+				{
+					"Name": "card-help",
+					"Repo": "card-help",
+					"Group": "docs",
+					"Branch": "master",
+					"HasDocs": true,
+					"HasCover": false,
+					"Sidebar": [],
+					"DocFiles": [
+						"card-help/EACH.md",
+						"card-help/FREAD.md",
+						"card-help/FWRITE.md",
+						"card-help/GET.md",
+						"card-help/ITE.md",
+						"card-help/LOG.md",
+						"card-help/NOTE.md",
+						"card-help/PREV.md",
+						"card-help/SET.md",
+						"card-help/SPKL.md",
+						"card-help/STAT.md",
+						"card-help/SW.md"
+					]
+				},
+				{
+					"Name": "css",
+					"Repo": "css",
+					"Group": "docs",
+					"Branch": "master",
+					"HasDocs": true,
+					"HasCover": false,
+					"Sidebar": [],
+					"DocFiles": [
+						"css/docuserve.css"
+					]
+				}
+			]
+		},
+		{
+			"Name": "Example_applications",
+			"Key": "example_applications",
+			"Description": "",
+			"Modules": [
+				{
+					"Name": ".data",
+					"Repo": ".data",
+					"Group": "example_applications",
+					"Branch": "master",
+					"HasDocs": false,
+					"HasCover": false,
+					"Sidebar": [],
+					"DocFiles": []
+				},
+				{
+					"Name": "simple_cards",
+					"Repo": "simple_cards",
+					"Group": "example_applications",
+					"Branch": "master",
+					"HasDocs": false,
+					"HasCover": false,
+					"Sidebar": [],
+					"DocFiles": []
+				}
+			]
+		},
+		{
+			"Name": "Source",
+			"Key": "source",
+			"Description": "",
+			"Modules": [
+				{
+					"Name": "panels",
+					"Repo": "panels",
+					"Group": "source",
+					"Branch": "master",
+					"HasDocs": false,
+					"HasCover": false,
+					"Sidebar": [],
+					"DocFiles": []
+				},
+				{
+					"Name": "providers",
+					"Repo": "providers",
+					"Group": "source",
+					"Branch": "master",
+					"HasDocs": false,
+					"HasCover": false,
+					"Sidebar": [],
+					"DocFiles": []
+				},
+				{
+					"Name": "services",
+					"Repo": "services",
+					"Group": "source",
+					"Branch": "master",
+					"HasDocs": false,
+					"HasCover": false,
+					"Sidebar": [],
+					"DocFiles": []
+				},
+				{
+					"Name": "views",
+					"Repo": "views",
+					"Group": "source",
+					"Branch": "master",
+					"HasDocs": false,
+					"HasCover": false,
+					"Sidebar": [],
+					"DocFiles": []
+				}
+			]
+		}
+	]
+}