retold 4.0.1 → 4.0.3

package/examples/todo-list/console-client/views/PictView-TUI-TaskList.cjs

@@ -0,0 +1,104 @@
+const libPictView = require('pict-view');
+
+const _ViewConfiguration =
+{
+	ViewIdentifier: 'TUI-TaskList',
+
+	DefaultRenderable: 'TUI-TaskList-Content',
+	DefaultDestinationAddress: '#TUI-Content',
+	DefaultTemplateRecordAddress: 'AppData.TodoList',
+
+	AutoRender: false,
+
+	Templates:
+	[
+		{
+			Hash: 'TUI-TaskList-Template',
+			Template: '{~D:Record.TaskListDisplay~}'
+		}
+	],
+
+	Renderables:
+	[
+		{
+			RenderableHash: 'TUI-TaskList-Content',
+			TemplateHash: 'TUI-TaskList-Template',
+			ContentDestinationAddress: '#TUI-Content',
+			RenderMethod: 'replace'
+		}
+	]
+};
+
+class TUITaskListView extends libPictView
+{
+	constructor(pFable, pOptions, pServiceHash)
+	{
+		super(pFable, pOptions, pServiceHash);
+	}
+
+	onBeforeRender()
+	{
+		// Build a formatted text display of tasks for the blessed widget
+		let tmpTasks = this.pict.AppData.TodoList.Tasks;
+		let tmpSelectedIndex = this.pict.AppData.TodoList.SelectedIndex;
+		let tmpLines = [];
+
+		if (!tmpTasks || tmpTasks.length === 0)
+		{
+			tmpLines.push('');
+			tmpLines.push('  No tasks found. Press [A] to add one.');
+			this.pict.AppData.TodoList.TaskListDisplay = tmpLines.join('\n');
+			return super.onBeforeRender();
+		}
+
+		// Column header
+		let tmpHeader = '  ' + _padRight('#', 4) + _padRight('Name', 30) + _padRight('Due Date', 14) + _padRight('Hours', 8) + _padRight('Status', 14);
+		tmpLines.push('{bold}' + tmpHeader + '{/bold}');
+		tmpLines.push('  ' + '-'.repeat(68));
+
+		for (let i = 0; i < tmpTasks.length; i++)
+		{
+			let tmpTask = tmpTasks[i];
+			let tmpDueDate = tmpTask.DueDate || '-';
+			// Truncate date to just the date part if it has a time component
+			if (tmpDueDate.length > 10)
+			{
+				tmpDueDate = tmpDueDate.substring(0, 10);
+			}
+
+			let tmpLine = '  ' +
+				_padRight(String(tmpTask.IDTask), 4) +
+				_padRight((tmpTask.Name || '').substring(0, 28), 30) +
+				_padRight(tmpDueDate, 14) +
+				_padRight(String(tmpTask.LengthInHours || 0), 8) +
+				_padRight(tmpTask.Status || '-', 14);
+
+			if (i === tmpSelectedIndex)
+			{
+				tmpLine = '{inverse}' + tmpLine + '{/inverse}';
+			}
+
+			tmpLines.push(tmpLine);
+		}
+
+		this.pict.AppData.TodoList.TaskListDisplay = tmpLines.join('\n');
+
+		return super.onBeforeRender();
+	}
+}
+
+/**
+ * Pad a string to a fixed width (right-padded with spaces).
+ */
+function _padRight(pString, pWidth)
+{
+	let tmpStr = String(pString || '');
+	if (tmpStr.length >= pWidth)
+	{
+		return tmpStr.substring(0, pWidth);
+	}
+	return tmpStr + ' '.repeat(pWidth - tmpStr.length);
+}
+
+module.exports = TUITaskListView;
+module.exports.default_configuration = _ViewConfiguration;

package/examples/todo-list/docker-motd.sh

@@ -0,0 +1,36 @@
+#!/bin/sh
+cat <<'BANNER'
+
+  ╔══════════════════════════════════════════════════════════════╗
+  ║              Retold Todo List Example                       ║
+  ╚══════════════════════════════════════════════════════════════╝
+
+  COMMANDS
+  ────────────────────────────────────────────────────────────────
+  Start the API server (also serves the web client):
+    node server/server.cjs
+
+  Once the server is running (in the background or another shell):
+
+  CLI client:
+    cd /app/cli-client && npx todo list              List all tasks
+    cd /app/cli-client && npx todo list --search gym  Search tasks
+    cd /app/cli-client && npx todo add "New task"     Add a task
+    cd /app/cli-client && npx todo complete 42        Complete a task
+    cd /app/cli-client && npx todo remove 42          Remove a task
+    cd /app/cli-client && npx todo --help             Full CLI help
+
+  Console TUI (interactive terminal UI):
+    node console-client/console-client.cjs
+
+  Web client:
+    Open http://localhost:8086 in your browser
+
+  TIPS
+  ────────────────────────────────────────────────────────────────
+  Start the server in the background:
+    node server/server.cjs &
+
+  Then use the CLI or console client from this same shell.
+
+BANNER

package/examples/todo-list/docker-run.sh

@@ -0,0 +1,2 @@
+#!/bin/sh
+docker build -t retold-todo . && docker run --rm -p 8086:8086 --name retold-todo retold-todo

package/examples/todo-list/docker-shell.sh

@@ -0,0 +1,2 @@
+#!/bin/sh
+docker build -t retold-todo . && docker run --rm -it -p 8086:8086 --name retold-todo retold-todo /bin/bash --login

package/examples/todo-list/model/MeadowSchema-Task.json

@@ -0,0 +1,152 @@
+{
+	"Scope": "Task",
+	"DefaultIdentifier": "IDTask",
+	"Domain": "Default",
+	"Schema":
+	[
+		{
+			"Column": "IDTask",
+			"Type": "AutoIdentity"
+		},
+		{
+			"Column": "GUIDTask",
+			"Type": "AutoGUID"
+		},
+		{
+			"Column": "CreateDate",
+			"Type": "CreateDate"
+		},
+		{
+			"Column": "CreatingIDUser",
+			"Type": "CreateIDUser"
+		},
+		{
+			"Column": "UpdateDate",
+			"Type": "UpdateDate"
+		},
+		{
+			"Column": "UpdatingIDUser",
+			"Type": "UpdateIDUser"
+		},
+		{
+			"Column": "Deleted",
+			"Type": "Deleted"
+		},
+		{
+			"Column": "DeleteDate",
+			"Type": "DeleteDate"
+		},
+		{
+			"Column": "DeletingIDUser",
+			"Type": "DeleteIDUser"
+		},
+		{
+			"Column": "Name",
+			"Type": "String",
+			"Size": "200"
+		},
+		{
+			"Column": "Description",
+			"Type": "Text"
+		},
+		{
+			"Column": "DueDate",
+			"Type": "DateTime"
+		},
+		{
+			"Column": "LengthInHours",
+			"Type": "Decimal",
+			"Size": "10,2"
+		},
+		{
+			"Column": "Status",
+			"Type": "String",
+			"Size": "32"
+		}
+	],
+	"DefaultObject":
+	{
+		"IDTask": 0,
+		"GUIDTask": "00000000-0000-0000-0000-000000000000",
+		"CreateDate": null,
+		"CreatingIDUser": 0,
+		"UpdateDate": null,
+		"UpdatingIDUser": 0,
+		"Deleted": 0,
+		"DeleteDate": null,
+		"DeletingIDUser": 0,
+		"Name": "",
+		"Description": "",
+		"DueDate": null,
+		"LengthInHours": 0,
+		"Status": "Pending"
+	},
+	"JsonSchema":
+	{
+		"title": "Task",
+		"type": "object",
+		"properties":
+		{
+			"IDTask":
+			{
+				"type": "integer"
+			},
+			"GUIDTask":
+			{
+				"type": "string"
+			},
+			"CreateDate":
+			{
+				"type": "string"
+			},
+			"CreatingIDUser":
+			{
+				"type": "integer"
+			},
+			"UpdateDate":
+			{
+				"type": "string"
+			},
+			"UpdatingIDUser":
+			{
+				"type": "integer"
+			},
+			"Deleted":
+			{
+				"type": "boolean"
+			},
+			"DeleteDate":
+			{
+				"type": "string"
+			},
+			"DeletingIDUser":
+			{
+				"type": "integer"
+			},
+			"Name":
+			{
+				"type": "string"
+			},
+			"Description":
+			{
+				"type": "string"
+			},
+			"DueDate":
+			{
+				"type": "string"
+			},
+			"LengthInHours":
+			{
+				"type": "number"
+			},
+			"Status":
+			{
+				"type": "string"
+			}
+		},
+		"required":
+		[
+			"IDTask"
+		]
+	}
+}

package/examples/todo-list/model/Task-Compiled.json

@@ -0,0 +1,25 @@
+{
+	"Tables":
+	[
+		{
+			"TableName": "Task",
+			"Columns":
+			[
+				{ "Column": "IDTask", "DataType": "ID" },
+				{ "Column": "GUIDTask", "DataType": "GUID" },
+				{ "Column": "Name", "DataType": "String", "Size": "200" },
+				{ "Column": "Description", "DataType": "Text" },
+				{ "Column": "DueDate", "DataType": "DateTime" },
+				{ "Column": "LengthInHours", "DataType": "Decimal", "Size": "10,2" },
+				{ "Column": "Status", "DataType": "String", "Size": "32" },
+				{ "Column": "CreateDate", "DataType": "DateTime" },
+				{ "Column": "CreatingIDUser", "DataType": "ForeignKey" },
+				{ "Column": "UpdateDate", "DataType": "DateTime" },
+				{ "Column": "UpdatingIDUser", "DataType": "ForeignKey" },
+				{ "Column": "Deleted", "DataType": "Boolean" },
+				{ "Column": "DeleteDate", "DataType": "DateTime" },
+				{ "Column": "DeletingIDUser", "DataType": "ForeignKey" }
+			]
+		}
+	]
+}

package/examples/todo-list/model/Task.mddl

@@ -0,0 +1,15 @@
+!Task
+@IDTask
+%GUIDTask
+$Name 200
+*Description
+&DueDate
+.LengthInHours 10,2
+$Status 32
+&CreateDate
+#CreatingIDUser -> IDUser
+&UpdateDate
+#UpdatingIDUser -> IDUser
+^Deleted
+&DeleteDate
+#DeletingIDUser -> IDUser