json-renderers-build-table 1.17.3 → 1.22.2

package/src/{v16 → v18/bodyOnly}/spec.json

@@ -1,65 +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"
-                }
-            }
-        ]
-    }
-}
+{
+    "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/{v16/common/writePath.js → v18/bodyOnly/writePath/index.js}

@@ -1,55 +1,47 @@
-import { findByRole } from "json-transformer-funcs";
-
-const toArray = val => (Array.isArray(val) ? val : [val]);
-
-const actions = {
-    set: (parent, key, value) => {
-        parent[key] = value;
-    },
-    push: (parent, key, value) => {
-        parent[key].push(...toArray(value));
-    },
-    unshift: (parent, key, value) => {
-        parent[key].unshift(...toArray(value));
-    },
-    pushToRows: (parent, key, value) => {
-        parent[key].forEach(row => {
-            row.children.push(...structuredClone(toArray(value)));
-        });
-    },
-    unshiftToRows: (parent, key, value) => {
-        parent[key].forEach(row => {
-            row.children.unshift(...structuredClone(toArray(value)));
-        });
-    },
-    unshiftSerialToRows: (parent, key, value) => {
-        parent[key].forEach((row, rowIndex) => {
-            const item = structuredClone(value);
-            item.textContent = rowIndex + 1;
-            row.children.unshift(item);
-        });
-    }
-};
-
-const writePath = ({ inRegistry, inPath, inValue }) => {
-    const localRegistry = inRegistry;
-    const localPath = inPath;
-    const localValue = inValue;
-
-    const root = localPath.dataRole
-        ? findByRole(localRegistry[localPath.fileName], localPath.dataRole)
-        : localRegistry[localPath.fileName];
-
-    if (!root) return;
-
-    const keys = [...(localPath.filePath ?? [])];
-    const lastKey = keys.pop();
-    const parent = keys.reduce((current, key) => current?.[key], root);
-
-    if (!parent) return;
-
-    const actionHandler = actions[localPath.action] || actions.set;
-    actionHandler(parent, lastKey, localValue);
-};
-
-export default writePath;
+import { findByRole } from "json-transformer-funcs";
+
+const toArray = val => (Array.isArray(val) ? val : [val]);
+
+const actions = {
+    set: (parent, key, value) => {
+        parent[key] = value;
+    },
+    push: (parent, key, value) => {
+        parent[key].push(...toArray(value));
+    },
+    unshift: (parent, key, value) => {
+        parent[key].unshift(...toArray(value));
+    },
+    pushToRows: (parent, key, value) => {
+        parent[key].forEach(row => {
+            row.children.push(...structuredClone(toArray(value)));
+        });
+    },
+    unshiftToRows: (parent, key, value) => {
+        parent[key].forEach(row => {
+            row.children.unshift(...structuredClone(toArray(value)));
+        });
+    },
+    unshiftSerialToRows: (parent, key, value) => {
+        parent[key].forEach((row, rowIndex) => {
+            const item = structuredClone(value);
+            item.textContent = rowIndex + 1;
+            row.children.unshift(item);
+        });
+    }
+};
+
+const writePath = (registry, path, value) => {
+    const root = path.dataRole
+        ? findByRole(registry[path.fileName], path.dataRole)
+        : registry[path.fileName];
+
+    const keys = [...(path.filePath ?? [])];
+    const lastKey = keys.pop();
+    const parent = keys.reduce((current, key) => current[key], root);
+
+    const actionHandler = actions[path.action] || actions.set;
+    actionHandler(parent, lastKey, value);
+};
+
+export default writePath;

package/src/v18/headerOnly/index.js

@@ -0,0 +1,42 @@
+import fromCollection from "json-transformer-funcs-one-dimension";
+
+import { resolvePath } from "json-transformer-funcs";
+
+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 writePath from "./writePath/index.js";
+
+// 1. Keep the input, table structure, and templates together as the build context.
+const registry = { data: {}, base, spec };
+const functions = {
+    fromCollection
+};
+
+// 2. Apply each instruction: read source, build result, write destination.
+const runInstructions = instructions => {
+    instructions.forEach(instruction => {
+        const source = resolvePath(registry, instruction.sourcePath);
+
+        if (source) {
+            const result = functions[instruction.func](source, spec[instruction.templateKey]);
+            writePath(registry, instruction.destinationPath, result);
+        } else {
+            console.log("   !instruction : ", instruction);
+            console.log("   !source : ", source);
+        };
+    });
+};
+
+// 3. Complete the table and return its JSON specification.
+const startFunc = data => {
+    registry.data = data;
+
+    runInstructions(singleInstructions);
+
+    return base;
+};
+
+export default startFunc;

package/src/{v15/simpleTable/config/instructions.json → v18/headerOnly/instructions/single.json}

@@ -1,9 +1,9 @@
 [
     {
-        "narration": "Build the table header row from the column metadata.",
+        "narration": "Build the column widths for the table using the configured columns.",
         "destinationPath": {
             "fileName": "base",
-            "dataRole": "table-header-row",
+            "dataRole": "table-colgroup",
             "filePath": [
                 "children"
             ]
@@ -14,14 +14,14 @@
                 "columns"
             ]
         },
-        "templateKey": "buildHeader",
+        "templateKey": "buildColGroup",
         "func": "fromCollection"
     },
     {
-        "narration": "Create one table row for each record and place it into the table body container.",
+        "narration": "Build the header row for the table using the configured columns.",
         "destinationPath": {
             "fileName": "base",
-            "dataRole": "table-body",
+            "dataRole": "table-header-row",
             "filePath": [
                 "children"
             ]
@@ -29,10 +29,10 @@
         "sourcePath": {
             "fileName": "data",
             "filePath": [
-                "data"
+                "columns"
             ]
         },
-        "templateKey": "buildBodyTr",
+        "templateKey": "buildHeader",
         "func": "fromCollection"
     }
-]
+]

package/src/{v14 → v18/headerOnly}/spec.json

@@ -61,5 +61,26 @@
                 }
             }
         ]
+    },
+    "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/{v14/buildSpec → v18/headerOnly}/writePath/index.js

@@ -31,25 +31,17 @@ const actions = {
     }
 };
 
-const writePath = ({ inRegistry, inPath, inValue }) => {
-    const localRegistry = inRegistry;
-    const localPath = inPath;
-    const localValue = inValue;
+const writePath = (registry, path, value) => {
+    const root = path.dataRole
+        ? findByRole(registry[path.fileName], path.dataRole)
+        : registry[path.fileName];
 
-    const root = localPath.dataRole
-        ? findByRole(localRegistry[localPath.fileName], localPath.dataRole)
-        : localRegistry[localPath.fileName];
-
-    if (!root) return;
-
-    const keys = [...(localPath.filePath ?? [])];
+    const keys = [...(path.filePath ?? [])];
     const lastKey = keys.pop();
-    const parent = keys.reduce((current, key) => current?.[key], root);
-
-    if (!parent) return;
+    const parent = keys.reduce((current, key) => current[key], root);
 
-    const actionHandler = actions[localPath.action] || actions.set;
-    actionHandler(parent, lastKey, localValue);
+    const actionHandler = actions[path.action] || actions.set;
+    actionHandler(parent, lastKey, value);
 };
 
 export default writePath;

package/src/v18/index.js

@@ -0,0 +1,5 @@
+import simple from "./simple/index.js";
+import headerOnly from "./headerOnly/index.js";
+import bodyOnly from "./bodyOnly/index.js";
+
+export { simple, headerOnly, bodyOnly };

package/src/v18/simple/index.js

@@ -0,0 +1,57 @@
+import fromCollection from "json-transformer-funcs-one-dimension";
+import twoDimensional from "json-transformer-funcs-two-dimensions";
+
+import { resolvePath } from "json-transformer-funcs";
+
+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 twoDimensionalInstructions from "./instructions/double.json" with { type: "json" };
+
+import writePath from "./writePath/index.js";
+
+// 1. Keep the input, table structure, and templates together as the build context.
+const registry = { data: {}, base, spec };
+const functions = {
+    fromCollection, twoDimensional
+};
+
+// 2. Apply each instruction: read source, build result, write destination.
+const runInstructions = instructions => {
+    instructions.forEach(instruction => {
+        const source = resolvePath(registry, instruction.sourcePath);
+
+        if (source) {
+            const result = functions[instruction.func](source, spec[instruction.templateKey]);
+            writePath(registry, instruction.destinationPath, result);
+        } else {
+            console.log("   !instruction : ", instruction);
+            console.log("   !source : ", source);
+        };
+    });
+};
+
+const runInstructions2 = instructions => {
+    instructions.forEach(instruction => {
+        const result = functions[instruction.func](
+            registry.data.columns,
+            registry.data.data,
+            spec
+        );
+        writePath(registry, instruction.destinationPath, result);
+    });
+};
+
+// 3. Complete the table and return its JSON specification.
+const startFunc = data => {
+    registry.data = data;
+    console.log("registry : ", registry);
+
+    runInstructions(singleInstructions);
+    runInstructions2(twoDimensionalInstructions);
+
+    return base;
+};
+
+export default startFunc;

package/src/{v15/buildSpec/config/rowInstructions.json → v18/simple/instructions/double.json}

@@ -1,6 +1,6 @@
 [
     {
-        "narration": "Create one table row for each record and place it into the table body container.",
+        "narration": "Build the table body rows for the table using the configured columns and data.",
         "destinationPath": {
             "fileName": "base",
             "dataRole": "table-body",
@@ -11,10 +11,9 @@
         "sourcePath": {
             "fileName": "data",
             "filePath": [
-                "data"
+                "columns"
             ]
         },
-        "templateKey": "buildBodyTr",
-        "func": "fromCollection"
+        "func": "twoDimensional"
     }
-]
+]

package/src/{v16/simpleTable/config/instructions.json → v18/simple/instructions/single.json}

@@ -1,38 +1,38 @@
-[
-    {
-        "narration": "Build the table header row from the column metadata.",
-        "destinationPath": {
-            "fileName": "base",
-            "dataRole": "table-header-row",
-            "filePath": [
-                "children"
-            ]
-        },
-        "sourcePath": {
-            "fileName": "data",
-            "filePath": [
-                "columns"
-            ]
-        },
-        "templateKey": "buildHeader",
-        "func": "fromCollection"
-    },
-    {
-        "narration": "Create one table row for each record and place it into the table body container.",
-        "destinationPath": {
-            "fileName": "base",
-            "dataRole": "table-body",
-            "filePath": [
-                "children"
-            ]
-        },
-        "sourcePath": {
-            "fileName": "data",
-            "filePath": [
-                "data"
-            ]
-        },
-        "templateKey": "buildBodyTr",
-        "func": "fromCollection"
-    }
-]
+[
+    {
+        "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/{v15 → v18/simple}/spec.json

@@ -61,5 +61,26 @@
                 }
             }
         ]
+    },
+    "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/{v15/buildSpec → v18/simple}/writePath/index.js

@@ -31,25 +31,17 @@ const actions = {
     }
 };
 
-const writePath = ({ inRegistry, inPath, inValue }) => {
-    const localRegistry = inRegistry;
-    const localPath = inPath;
-    const localValue = inValue;
+const writePath = (registry, path, value) => {
+    const root = path.dataRole
+        ? findByRole(registry[path.fileName], path.dataRole)
+        : registry[path.fileName];
 
-    const root = localPath.dataRole
-        ? findByRole(localRegistry[localPath.fileName], localPath.dataRole)
-        : localRegistry[localPath.fileName];
-
-    if (!root) return;
-
-    const keys = [...(localPath.filePath ?? [])];
+    const keys = [...(path.filePath ?? [])];
     const lastKey = keys.pop();
-    const parent = keys.reduce((current, key) => current?.[key], root);
-
-    if (!parent) return;
+    const parent = keys.reduce((current, key) => current[key], root);
 
-    const actionHandler = actions[localPath.action] || actions.set;
-    actionHandler(parent, lastKey, localValue);
+    const actionHandler = actions[path.action] || actions.set;
+    actionHandler(parent, lastKey, value);
 };
 
 export default writePath;