json-renderers-build-table 1.19.1 → 1.22.3

package/src/v21/simple/index.js

@@ -0,0 +1,22 @@
+import fromCollection from "json-transformer-funcs-one-dimension";
+import twoDimensional from "json-transformer-funcs-two-dimensions";
+
+import spec from "../spec.json" with { type: "json" };
+import base from "./base.json" with { type: "json" };
+import singleInstructions from "./instructions/single.json" with { type: "json" };
+import doubleInstructions from "./instructions/double.json" with { type: "json" };
+
+import runSingleInstructions from "../singleInstruction/index.js";
+import runDoubleInstructions from "../doubleInstruction/index.js";
+
+const registry = { data: {}, base, spec };
+const functions = { fromCollection, twoDimensional };
+
+const startFunc = (data, showLog = false, returnLog = []) => {
+    registry.data = data;
+    runSingleInstructions(singleInstructions, registry, functions, spec, showLog, returnLog);
+    runDoubleInstructions(doubleInstructions, registry, functions, spec, showLog, returnLog);
+    return base;
+};
+
+export default startFunc;

package/src/v21/simple/instructions/double.json

@@ -0,0 +1,19 @@
+[
+    {
+        "narration": "Build the table body rows for the table using the configured columns and data.",
+        "destinationPath": {
+            "fileName": "base",
+            "dataRole": "table-body",
+            "filePath": [
+                "children"
+            ]
+        },
+        "sourcePath": {
+            "fileName": "data",
+            "filePath": [
+                "columns"
+            ]
+        },
+        "func": "twoDimensional"
+    }
+]

package/src/v21/simple/instructions/single.json

@@ -0,0 +1,38 @@
+[
+    {
+        "narration": "Build the column widths for the table using the configured columns.",
+        "destinationPath": {
+            "fileName": "base",
+            "dataRole": "table-colgroup",
+            "filePath": [
+                "children"
+            ]
+        },
+        "sourcePath": {
+            "fileName": "data",
+            "filePath": [
+                "columns"
+            ]
+        },
+        "templateKey": "buildColGroup",
+        "func": "fromCollection"
+    },
+    {
+        "narration": "Build the header row for the table using the configured columns.",
+        "destinationPath": {
+            "fileName": "base",
+            "dataRole": "table-header-row",
+            "filePath": [
+                "children"
+            ]
+        },
+        "sourcePath": {
+            "fileName": "data",
+            "filePath": [
+                "columns"
+            ]
+        },
+        "templateKey": "buildHeader",
+        "func": "fromCollection"
+    }
+]

package/src/v21/simple/spec.json

@@ -0,0 +1,86 @@
+{
+    "buildBodyTr": {
+        "tagName": "tr",
+        "attributes": {
+            "class": "align-middle"
+        },
+        "children": []
+    },
+    "buildColGroup": {
+        "tagName": "col",
+        "attributes": {
+            "width": "${width}"
+        }
+    },
+    "buildHeader": {
+        "tagName": "th",
+        "textContent": "${columnName}",
+        "attributes": {
+            "class": "py-3 px-3 fw-semibold text-uppercase small"
+        }
+    },
+    "buildFooter": {
+        "tagName": "td",
+        "children": [
+            {
+                "tagName": "input",
+                "attributes": {
+                    "type": "text",
+                    "placeholder": "enter ${columnName}",
+                    "name": "${columnName}",
+                    "class": "form-control"
+                }
+            }
+        ]
+    },
+    "buildBodyCell": {
+        "tagName": "td",
+        "textContent": "${rowValue}",
+        "attributes": {
+            "class": "py-3 px-3 text-secondary"
+        }
+    },
+    "button": {
+        "tagName": "button",
+        "textContent": "${columnName}",
+        "attributes": {
+            "class": "btn btn-primary btn-sm"
+        }
+    },
+    "buttonCell": {
+        "tagName": "td",
+        "attributes": {
+            "class": "py-2 px-3 text-center"
+        },
+        "children": [
+            {
+                "tagName": "button",
+                "textContent": "${agg:count}",
+                "attributes": {
+                    "class": "btn btn-primary btn-sm"
+                }
+            }
+        ]
+    },
+    "buildOption": {
+        "tagName": "option",
+        "textContent": "${rowValue}",
+        "attributes": {
+            "value": "${rowValue}"
+        }
+    },
+    "buildSelect": {
+        "tagName": "select",
+        "attributes": {
+            "id": "LedgerName"
+        },
+        "children": []
+    },
+    "buildDataList": {
+        "tagName": "datalist",
+        "attributes": {
+            "data-name": "${columnName}"
+        },
+        "children": []
+    }
+}

package/src/v21/singleInstruction/index.js

@@ -0,0 +1,19 @@
+import { resolvePath } from "json-transformer-funcs";
+import writePath from "../writePath/index.js";
+import checkInstruction from "../guards/index.js";
+
+const runSingleInstruction = (instruction, registry, functions, spec, showLog, returnLog) => {
+    if (!checkInstruction(instruction, functions, spec, showLog, returnLog)) return;
+    const source = resolvePath(registry, instruction.sourcePath);
+    const result = functions[instruction.func](source, spec[instruction.templateKey]);
+    writePath(registry, instruction.destinationPath, result);
+};
+
+const runSingleInstructions = (instructions, registry, functions, spec, showLog, returnLog) => {
+    instructions.forEach(instruction => {
+        runSingleInstruction(instruction, registry, functions, spec, showLog, returnLog);
+    });
+};
+
+export { runSingleInstruction, runSingleInstructions };
+export default runSingleInstructions;

package/src/v21/spec.json

@@ -0,0 +1,86 @@
+{
+    "buildBodyTr": {
+        "tagName": "tr",
+        "attributes": {
+            "class": "align-middle"
+        },
+        "children": []
+    },
+    "buildColGroup": {
+        "tagName": "col",
+        "attributes": {
+            "width": "${width}"
+        }
+    },
+    "buildHeader": {
+        "tagName": "th",
+        "textContent": "${columnName}",
+        "attributes": {
+            "class": "py-3 px-3 fw-semibold text-uppercase small"
+        }
+    },
+    "buildFooter": {
+        "tagName": "td",
+        "children": [
+            {
+                "tagName": "input",
+                "attributes": {
+                    "type": "text",
+                    "placeholder": "enter ${columnName}",
+                    "name": "${columnName}",
+                    "class": "form-control"
+                }
+            }
+        ]
+    },
+    "buildBodyCell": {
+        "tagName": "td",
+        "textContent": "${rowValue}",
+        "attributes": {
+            "class": "py-3 px-3 text-secondary"
+        }
+    },
+    "button": {
+        "tagName": "button",
+        "textContent": "${columnName}",
+        "attributes": {
+            "class": "btn btn-primary btn-sm"
+        }
+    },
+    "buttonCell": {
+        "tagName": "td",
+        "attributes": {
+            "class": "py-2 px-3 text-center"
+        },
+        "children": [
+            {
+                "tagName": "button",
+                "textContent": "${agg:count}",
+                "attributes": {
+                    "class": "btn btn-primary btn-sm"
+                }
+            }
+        ]
+    },
+    "buildOption": {
+        "tagName": "option",
+        "textContent": "${rowValue}",
+        "attributes": {
+            "value": "${rowValue}"
+        }
+    },
+    "buildSelect": {
+        "tagName": "select",
+        "attributes": {
+            "id": "LedgerName"
+        },
+        "children": []
+    },
+    "buildDataList": {
+        "tagName": "datalist",
+        "attributes": {
+            "data-name": "${columnName}"
+        },
+        "children": []
+    }
+}

package/src/v21/writePath/index.js

@@ -0,0 +1,62 @@
+import { findByRole } from "json-transformer-funcs";
+
+const toArray = value => Array.isArray(value) ? value : [value];
+
+const set = (parent, key, value) => {
+    parent[key] = value;
+};
+
+const push = (parent, key, value) => {
+    parent[key].push(...toArray(value));
+};
+
+const unshift = (parent, key, value) => {
+    parent[key].unshift(...toArray(value));
+};
+
+const pushToRows = (parent, key, value) => {
+    parent[key].forEach(row => {
+        row.children.push(...structuredClone(toArray(value)));
+    });
+};
+
+const unshiftToRows = (parent, key, value) => {
+    parent[key].forEach(row => {
+        row.children.unshift(...structuredClone(toArray(value)));
+    });
+};
+
+const unshiftSerialToRows = (parent, key, value) => {
+    parent[key].forEach((row, rowIndex) => {
+        const item = structuredClone(value);
+        item.textContent = rowIndex + 1;
+        row.children.unshift(item);
+    });
+};
+
+const actions = {
+    set,
+    push,
+    unshift,
+    pushToRows,
+    unshiftToRows,
+    unshiftSerialToRows
+};
+
+const resolveParent = (registry, path) => {
+    const root = path.dataRole
+        ? findByRole(registry[path.fileName], path.dataRole)
+        : registry[path.fileName];
+    const keys = [...(path.filePath ?? [])];
+    const key = keys.pop();
+    const parent = keys.reduce((current, nextKey) => current[nextKey], root);
+    return { parent, key };
+};
+
+const writePath = (registry, path, value) => {
+    const { parent, key } = resolveParent(registry, path);
+    const action = actions[path.action] || set;
+    action(parent, key, value);
+};
+
+export default writePath;

package/src/v22/builders/bodyOnly/base.json

@@ -0,0 +1 @@
+{ "children": [] }

package/src/v22/builders/bodyOnly/index.js

@@ -0,0 +1,18 @@
+import twoDimensional from "json-transformer-funcs-two-dimensions";
+
+import spec from "../spec.json" with { type: "json" };
+import base from "./base.json" with { type: "json" };
+import doubleInstructions from "./instructions/double.json" with { type: "json" };
+
+import runDoubleInstructions from "../../doubleInstruction/index.js";
+
+const registry = { data: {}, base, spec };
+const functions = { twoDimensional };
+
+const startFunc = (data, showLog = false, returnLog = []) => {
+    registry.data = data;
+    runDoubleInstructions(doubleInstructions, registry, functions, spec, showLog, returnLog);
+    return base.children;
+};
+
+export default startFunc;

package/src/v22/builders/bodyOnly/instructions/double.json

@@ -0,0 +1,18 @@
+[
+    {
+        "narration": "Build the table body rows for the table using the configured columns and data.",
+        "destinationPath": {
+            "fileName": "base",
+            "filePath": [
+                "children"
+            ]
+        },
+        "sourcePath": {
+            "fileName": "data",
+            "filePath": [
+                "columns"
+            ]
+        },
+        "func": "twoDimensional"
+    }
+]

package/src/v22/builders/footerOnly/base.json

@@ -0,0 +1,3 @@
+{
+    "children": []
+}

package/src/v22/builders/footerOnly/index.js

@@ -0,0 +1,21 @@
+import fromCollection from "json-transformer-funcs-one-dimension";
+import twoDimensional from "json-transformer-funcs-two-dimensions";
+
+import spec from "../spec.json" with { type: "json" };
+import base from "./base.json" with { type: "json" };
+import singleInstructions from "./instructions/single.json" with { type: "json" };
+
+import runSingleInstructions from "../../singleInstruction/index.js";
+
+const registry = { data: {}, base, spec };
+const functions = { fromCollection, twoDimensional };
+
+const startFunc = (data, showLog = false, returnLog = []) => {
+    registry.data = data;
+
+    runSingleInstructions(singleInstructions, registry, functions, spec, showLog, returnLog);
+
+    return base?.children;
+};
+
+export default startFunc;

package/src/v22/builders/footerOnly/instructions/single.json

@@ -0,0 +1,19 @@
+[
+    {
+        "narration": "Build the footer row for the table using the configured columns.",
+        "destinationPath": {
+            "fileName": "base",
+            "filePath": [
+                "children"
+            ]
+        },
+        "sourcePath": {
+            "fileName": "data",
+            "filePath": [
+                "columns"
+            ]
+        },
+        "templateKey": "buildFooter",
+        "func": "fromCollection"
+    }
+]

package/src/v22/builders/headerOnly/base.json

@@ -0,0 +1,53 @@
+{
+    "tagName": "table",
+    "attributes": {
+        "class": "table table-hover table-striped align-middle border mb-0"
+    },
+    "children": [
+        {
+            "tagName": "colgroup",
+            "attributes": {
+                "data-role": "table-colgroup"
+            },
+            "children": []
+        },
+        {
+            "tagName": "thead",
+            "attributes": {
+                "class": "table-dark",
+                "data-role": "table-header"
+            },
+            "children": [
+                {
+                    "tagName": "tr",
+                    "attributes": {
+                        "data-role": "table-header-row"
+                    },
+                    "children": []
+                }
+            ]
+        },
+        {
+            "tagName": "tbody",
+            "attributes": {
+                "data-role": "table-body"
+            },
+            "children": []
+        },
+        {
+            "tagName": "tfoot",
+            "attributes": {
+                "data-role": "table-footer"
+            },
+            "children": [
+                {
+                    "tagName": "tr",
+                    "attributes": {
+                        "data-role": "table-footer-row"
+                    },
+                    "children": []
+                }
+            ]
+        }
+    ]
+}

package/src/v22/builders/headerOnly/index.js

@@ -0,0 +1,18 @@
+import fromCollection from "json-transformer-funcs-one-dimension";
+
+import spec from "../spec.json" with { type: "json" };
+import base from "./base.json" with { type: "json" };
+import singleInstructions from "./instructions/single.json" with { type: "json" };
+
+import runSingleInstructions from "../../singleInstruction/index.js";
+
+const registry = { data: {}, base, spec };
+const functions = { fromCollection };
+
+const startFunc = (data, showLog = false, returnLog = []) => {
+    registry.data = data;
+    runSingleInstructions(singleInstructions, registry, functions, spec, showLog, returnLog);
+    return base;
+};
+
+export default startFunc;

package/src/v22/builders/headerOnly/instructions/single.json

@@ -0,0 +1,38 @@
+[
+    {
+        "narration": "Build the column widths for the table using the configured columns.",
+        "destinationPath": {
+            "fileName": "base",
+            "dataRole": "table-colgroup",
+            "filePath": [
+                "children"
+            ]
+        },
+        "sourcePath": {
+            "fileName": "data",
+            "filePath": [
+                "columns"
+            ]
+        },
+        "templateKey": "buildColGroup",
+        "func": "fromCollection"
+    },
+    {
+        "narration": "Build the header row for the table using the configured columns.",
+        "destinationPath": {
+            "fileName": "base",
+            "dataRole": "table-header-row",
+            "filePath": [
+                "children"
+            ]
+        },
+        "sourcePath": {
+            "fileName": "data",
+            "filePath": [
+                "columns"
+            ]
+        },
+        "templateKey": "buildHeader",
+        "func": "fromCollection"
+    }
+]

package/src/v22/builders/simple/base.json

@@ -0,0 +1,53 @@
+{
+    "tagName": "table",
+    "attributes": {
+        "class": "table table-hover table-striped align-middle border mb-0"
+    },
+    "children": [
+        {
+            "tagName": "colgroup",
+            "attributes": {
+                "data-role": "table-colgroup"
+            },
+            "children": []
+        },
+        {
+            "tagName": "thead",
+            "attributes": {
+                "class": "table-dark",
+                "data-role": "table-header"
+            },
+            "children": [
+                {
+                    "tagName": "tr",
+                    "attributes": {
+                        "data-role": "table-header-row"
+                    },
+                    "children": []
+                }
+            ]
+        },
+        {
+            "tagName": "tbody",
+            "attributes": {
+                "data-role": "table-body"
+            },
+            "children": []
+        },
+        {
+            "tagName": "tfoot",
+            "attributes": {
+                "data-role": "table-footer"
+            },
+            "children": [
+                {
+                    "tagName": "tr",
+                    "attributes": {
+                        "data-role": "table-footer-row"
+                    },
+                    "children": []
+                }
+            ]
+        }
+    ]
+}

package/src/v22/builders/simple/index.js

@@ -0,0 +1,22 @@
+import fromCollection from "json-transformer-funcs-one-dimension";
+import twoDimensional from "json-transformer-funcs-two-dimensions";
+
+import spec from "../spec.json" with { type: "json" };
+import base from "./base.json" with { type: "json" };
+import singleInstructions from "./instructions/single.json" with { type: "json" };
+import doubleInstructions from "./instructions/double.json" with { type: "json" };
+
+import runSingleInstructions from "../../singleInstruction/index.js";
+import runDoubleInstructions from "../../doubleInstruction/index.js";
+
+const registry = { data: {}, base, spec };
+const functions = { fromCollection, twoDimensional };
+
+const startFunc = (data, showLog = false, returnLog = []) => {
+    registry.data = data;
+    runSingleInstructions(singleInstructions, registry, functions, spec, showLog, returnLog);
+    runDoubleInstructions(doubleInstructions, registry, functions, spec, showLog, returnLog);
+    return base;
+};
+
+export default startFunc;

package/src/v22/builders/simple/instructions/double.json

@@ -0,0 +1,19 @@
+[
+    {
+        "narration": "Build the table body rows for the table using the configured columns and data.",
+        "destinationPath": {
+            "fileName": "base",
+            "dataRole": "table-body",
+            "filePath": [
+                "children"
+            ]
+        },
+        "sourcePath": {
+            "fileName": "data",
+            "filePath": [
+                "columns"
+            ]
+        },
+        "func": "twoDimensional"
+    }
+]

package/src/v22/builders/simple/instructions/single.json

@@ -0,0 +1,38 @@
+[
+    {
+        "narration": "Build the column widths for the table using the configured columns.",
+        "destinationPath": {
+            "fileName": "base",
+            "dataRole": "table-colgroup",
+            "filePath": [
+                "children"
+            ]
+        },
+        "sourcePath": {
+            "fileName": "data",
+            "filePath": [
+                "columns"
+            ]
+        },
+        "templateKey": "buildColGroup",
+        "func": "fromCollection"
+    },
+    {
+        "narration": "Build the header row for the table using the configured columns.",
+        "destinationPath": {
+            "fileName": "base",
+            "dataRole": "table-header-row",
+            "filePath": [
+                "children"
+            ]
+        },
+        "sourcePath": {
+            "fileName": "data",
+            "filePath": [
+                "columns"
+            ]
+        },
+        "templateKey": "buildHeader",
+        "func": "fromCollection"
+    }
+]