json-renderers-build 1.6.1 → 1.9.1

package/src/v9/common/deriveColumnsFromData.js

@@ -0,0 +1,20 @@
+const deriveColumnsFromData = ({ inData = [] } = {}) => {
+    const localData = inData;
+
+    if (!Array.isArray(localData) || localData.length === 0) {
+        return [];
+    }
+
+    const firstRow = localData[0];
+    if (!firstRow || typeof firstRow !== "object") {
+        return [];
+    }
+
+    return Object.keys(firstRow).map(key => ({
+        key,
+        label: key
+    }));
+};
+
+export { deriveColumnsFromData };
+export default deriveColumnsFromData;

package/src/v9/index.js

@@ -0,0 +1,36 @@
+import registerGlobal from "./registerGlobal.js";
+
+import renderTable from "./table/index.js";
+import renderSelect, { renderSelectOptions } from "./select/index.js";
+
+const RENDERER_MAP = {
+    table: renderTable,
+    select: renderSelect,
+    selectOptionsOnly: renderSelectOptions
+};
+
+const render = ({
+    type = "table",
+    data,
+    columns
+}) => {
+    const rawType = type;
+    const renderer = RENDERER_MAP[rawType];
+
+    const localData = data;
+    const localColumns = columns;
+
+    return renderer({
+        inColumns: localColumns,
+        inData: localData
+    });
+};
+
+registerGlobal(render);
+
+export {
+    renderTable,
+    renderSelect,
+    renderSelectOptions
+};
+export default render;

package/src/v9/meta.js

@@ -0,0 +1,6 @@
+export const meta = {
+    version: "v9.0.0",
+    description: "build table from store data and render to DOM uses json-to-spec, json-to-dom under the hood"
+};
+
+export default meta;

package/src/v9/registerGlobal.js

@@ -0,0 +1,14 @@
+import meta from "./meta.js";
+
+export const registerGlobal = (inFuncDefinition) => {
+    if (typeof globalThis === "undefined" || !inFuncDefinition) return;
+
+    globalThis.ks ??= {};
+
+    globalThis.ks.jsonRenderersBuild ??= {
+        meta,
+        renderToDom: inFuncDefinition
+    };
+};
+
+export default registerGlobal;

package/src/v9/select/index.js

@@ -0,0 +1,21 @@
+import renderSelectOptions from "./options/index.js";
+
+import skeletonJson from './skeleton.json' with { type: 'json' };
+
+const startFunc = ({
+    inData,
+}) => {
+    const localData = inData;
+
+    let localChildren = renderSelectOptions({
+        inData: localData
+    });
+
+    const select = structuredClone(skeletonJson);
+    select.children = localChildren;
+
+    return select;
+};
+
+export { renderSelectOptions };
+export default startFunc;

package/src/v9/select/options/index.js

@@ -0,0 +1,17 @@
+import jsonTransform from "@keshavsoft/json-transformer";
+
+import skeletonJson from './skeleton.json' with { type: 'json' };
+
+const startFunc = ({
+    inData,
+}) => {
+    const localData = inData;
+
+    let specAsJsonToDom = jsonTransform({
+        children: localData
+    }, skeletonJson);
+
+    return specAsJsonToDom?.children;
+};
+
+export default startFunc;

package/src/v9/select/options/skeleton.json

@@ -0,0 +1,17 @@
+{
+    "transform": {
+        "children": ""
+    },
+    "operation": {
+        "children": {
+            "operationType": "loopArray",
+            "template": {
+                "tagName": "option",
+                "attributes": {
+                    "value": "${}"
+                },
+                "textContent": "${}"
+            }
+        }
+    }
+}

package/src/v9/select/skeleton.json

@@ -0,0 +1,7 @@
+{
+    "tagName": "select",
+    "attributes": {
+        "id": "LedgerName"
+    },
+    "children": []
+}

package/src/v9/table/footer/empty/cell/index.js

@@ -0,0 +1,5 @@
+import tagJson from "./tag.json" with { type: "json" };
+
+const renderCell = () => structuredClone(tagJson);
+
+export default renderCell;

package/src/v9/table/footer/empty/cell/tag.json

@@ -0,0 +1,6 @@
+{
+  "tagName": "td",
+  "attributes": {
+    "class": "align-middle py-2"
+  }
+}

package/src/v9/table/footer/empty/index.js

@@ -0,0 +1,6 @@
+import renderRow from "./row/index.js";
+
+const renderEmpty = ({ inColumns = [] } = {}) =>
+    renderRow({ inColumns });
+
+export default renderEmpty;

package/src/v9/table/footer/empty/row/index.js

@@ -0,0 +1,10 @@
+import tagJson from "./tag.json" with { type: "json" };
+import renderCell from "../cell/index.js";
+
+const renderRow = ({ inColumns = [] } = {}) => {
+    const row = structuredClone(tagJson);
+    row.children = inColumns.map(() => renderCell());
+    return row;
+};
+
+export default renderRow;

package/src/v9/table/footer/empty/row/tag.json

@@ -0,0 +1,7 @@
+{
+  "tagName": "tr",
+  "attributes": {
+    "class": "align-middle"
+  },
+  "children": []
+}

package/src/v9/table/footer/index.js

@@ -0,0 +1,28 @@
+import tagJson from "./tag.json" with { type: "json" };
+import renderInputs from "./inputs/index.js";
+import renderInputsWithSave from "./inputsWithSave/index.js";
+import renderTotals from "./totals/index.js";
+import renderEmpty from "./empty/index.js";
+
+const footerBuilders = {
+    inputs: renderInputs,
+    inputsWithSave: renderInputsWithSave,
+    totals: renderTotals,
+    empty: renderEmpty
+};
+
+const renderTableFooter = ({ inFooter = [], inColumns = [], inData = [] } = {}) => {
+    const tfoot = structuredClone(tagJson);
+
+    tfoot.children = inFooter.map(footerName => {
+        if (!Object.hasOwn(footerBuilders, footerName)) {
+            throw new Error(`Unknown footer "${footerName}".`);
+        }
+
+        return footerBuilders[footerName]({ inColumns, inData });
+    });
+
+    return tfoot;
+};
+
+export default renderTableFooter;

package/src/v9/table/footer/inputs/cell/index.js

@@ -0,0 +1,15 @@
+import cellJson from "./tag.json" with { type: "json" };
+import inputJson from "../input/tag.json" with { type: "json" };
+
+const renderCell = ({ inColumn } = {}) => {
+    const cell = structuredClone(cellJson);
+    const input = structuredClone(inputJson);
+
+    input.attributes.name = inColumn;
+    input.attributes.placeholder = inColumn;
+    cell.children.push(input);
+
+    return cell;
+};
+
+export default renderCell;

package/src/v9/table/footer/inputs/cell/tag.json

@@ -0,0 +1,7 @@
+{
+  "tagName": "td",
+  "attributes": {
+    "class": "align-middle py-2"
+  },
+  "children": []
+}

package/src/v9/table/footer/inputs/index.js

@@ -0,0 +1,6 @@
+import renderRow from "./row/index.js";
+
+const renderInputs = ({ inColumns = [] } = {}) =>
+    renderRow({ inColumns });
+
+export default renderInputs;

package/src/v9/table/footer/inputs/input/tag.json

@@ -0,0 +1,9 @@
+{
+  "tagName": "input",
+  "attributes": {
+    "type": "text",
+    "name": "",
+    "placeholder": "",
+    "class": "form-control form-control-sm"
+  }
+}

package/src/v9/table/footer/inputs/row/index.js

@@ -0,0 +1,10 @@
+import tagJson from "./tag.json" with { type: "json" };
+import renderCell from "../cell/index.js";
+
+const renderRow = ({ inColumns = [] } = {}) => {
+    const row = structuredClone(tagJson);
+    row.children = inColumns.map(inColumn => renderCell({ inColumn }));
+    return row;
+};
+
+export default renderRow;

package/src/v9/table/footer/inputs/row/tag.json

@@ -0,0 +1,7 @@
+{
+  "tagName": "tr",
+  "attributes": {
+    "class": "align-middle"
+  },
+  "children": []
+}

package/src/v9/table/footer/inputsWithSave/button/tag.json

@@ -0,0 +1,8 @@
+{
+  "tagName": "button",
+  "attributes": {
+    "type": "button",
+    "class": "btn btn-primary btn-sm ms-2"
+  },
+  "textContent": "Save"
+}

package/src/v9/table/footer/inputsWithSave/cell/index.js

@@ -0,0 +1,20 @@
+import cellJson from "./tag.json" with { type: "json" };
+import inputJson from "../input/tag.json" with { type: "json" };
+import buttonJson from "../button/tag.json" with { type: "json" };
+
+const renderCell = ({ inColumn, inSave = false } = {}) => {
+    const cell = structuredClone(cellJson);
+    const input = structuredClone(inputJson);
+
+    input.attributes.name = inColumn;
+    input.attributes.placeholder = inColumn;
+    cell.children.push(input);
+
+    if (inSave) {
+        cell.children.push(structuredClone(buttonJson));
+    }
+
+    return cell;
+};
+
+export default renderCell;

package/src/v9/table/footer/inputsWithSave/cell/tag.json

@@ -0,0 +1,7 @@
+{
+  "tagName": "td",
+  "attributes": {
+    "class": "align-middle py-2"
+  },
+  "children": []
+}

package/src/v9/table/footer/inputsWithSave/index.js

@@ -0,0 +1,6 @@
+import renderRow from "./row/index.js";
+
+const renderInputsWithSave = ({ inColumns = [] } = {}) =>
+    renderRow({ inColumns });
+
+export default renderInputsWithSave;

package/src/v9/table/footer/inputsWithSave/input/tag.json

@@ -0,0 +1,9 @@
+{
+  "tagName": "input",
+  "attributes": {
+    "type": "text",
+    "name": "",
+    "placeholder": "",
+    "class": "form-control form-control-sm"
+  }
+}

package/src/v9/table/footer/inputsWithSave/row/index.js

@@ -0,0 +1,13 @@
+import tagJson from "./tag.json" with { type: "json" };
+import renderCell from "../cell/index.js";
+
+const renderRow = ({ inColumns = [] } = {}) => {
+    const row = structuredClone(tagJson);
+    row.children = inColumns.map((inColumn, index) => renderCell({
+        inColumn,
+        inSave: index === inColumns.length - 1
+    }));
+    return row;
+};
+
+export default renderRow;

package/src/v9/table/footer/inputsWithSave/row/tag.json

@@ -0,0 +1,7 @@
+{
+  "tagName": "tr",
+  "attributes": {
+    "class": "align-middle"
+  },
+  "children": []
+}

package/src/v9/table/footer/tag.json

@@ -0,0 +1,7 @@
+{
+  "tagName": "tfoot",
+  "attributes": {
+    "class": "table-light"
+  },
+  "children": []
+}

package/src/v9/table/footer/totals/cell/index.js

@@ -0,0 +1,21 @@
+import tagJson from "./tag.json" with { type: "json" };
+
+const getValue = (row, column) =>
+    Array.isArray(row) ? row[column] : row?.[column];
+
+const renderCell = ({ inColumn, inIndex, inData = [] } = {}) => {
+    const cell = structuredClone(tagJson);
+    const values = inData
+        .map(row => getValue(row, inColumn))
+        .filter(value => value !== null && value !== undefined && String(value).trim() !== "")
+        .map(Number)
+        .filter(Number.isFinite);
+
+    cell.textContent = values.length
+        ? String(values.reduce((sum, value) => sum + value, 0))
+        : inIndex === 0 ? "Total" : "";
+
+    return cell;
+};
+
+export default renderCell;

package/src/v9/table/footer/totals/cell/tag.json

@@ -0,0 +1,7 @@
+{
+  "tagName": "td",
+  "attributes": {
+    "class": "align-middle py-2"
+  },
+  "textContent": ""
+}

package/src/v9/table/footer/totals/index.js

@@ -0,0 +1,6 @@
+import renderRow from "./row/index.js";
+
+const renderTotals = ({ inColumns = [], inData = [] } = {}) =>
+    renderRow({ inColumns, inData });
+
+export default renderTotals;

package/src/v9/table/footer/totals/row/index.js

@@ -0,0 +1,12 @@
+import tagJson from "./tag.json" with { type: "json" };
+import renderCell from "../cell/index.js";
+
+const renderRow = ({ inColumns = [], inData = [] } = {}) => {
+    const row = structuredClone(tagJson);
+    row.children = inColumns.map((inColumn, inIndex) =>
+        renderCell({ inColumn, inIndex, inData })
+    );
+    return row;
+};
+
+export default renderRow;

package/src/v9/table/footer/totals/row/tag.json

@@ -0,0 +1,7 @@
+{
+  "tagName": "tr",
+  "attributes": {
+    "class": "fw-semibold align-middle"
+  },
+  "children": []
+}

package/src/v9/table/index.js

@@ -0,0 +1,33 @@
+import renderTable from "./table/index.js";
+
+import applyOptions from "./options/index.js";
+import renderRequests from "./render-requests.json" with { type: "json" };
+
+const render = ({
+    type = "table",
+    inData,
+    inColumns,
+    footer = [],
+    options = {}
+} = {}) => {
+    if (type === "table") {
+        const spec = renderTable({
+            inColumns,
+            inData,
+            inFooter: footer
+        });
+
+        return applyOptions(spec, options);
+    };
+
+    throw new Error(`Unknown table renderer type "${type}".`);
+};
+
+render.requests = renderRequests;
+
+export {
+    render,
+    renderRequests
+};
+
+export default render;

package/src/v9/table/options/index.js

@@ -0,0 +1,18 @@
+import applyShowSerial from "./showSerial/index.js";
+import applyShowOptions from "./showOptions/index.js";
+
+const applyOptions = (inSpec, inOptions = {}) => {
+    // console.log("inOptions : ", inOptions);
+
+    if (inOptions.showSerial) {
+        applyShowSerial(inSpec);
+    }
+
+    if (inOptions.showOptions) {
+        applyShowOptions(inSpec, inOptions.showOptions);
+    }
+
+    return inSpec;
+};
+
+export default applyOptions;

package/src/v9/table/options/showOptions/index.js

@@ -0,0 +1,39 @@
+const resolveButtons = (inShowOptions) => {
+    if (inShowOptions === true) {
+        return [{ label: "Apply", type: "button" }];
+    }
+
+    if (Array.isArray(inShowOptions)) {
+        return inShowOptions;
+    }
+
+    return [];
+};
+
+const applyShowOptions = (inSpec, inShowOptions) => {
+    const buttons = resolveButtons(inShowOptions);
+
+    if (buttons.length === 0) return;
+
+    const [thead, tbody] = inSpec.children;
+
+    // append <th>Actions</th> to head row
+    thead.children[0].children.push({
+        tagName: "th",
+        textContent: "Actions"
+    });
+
+    // append <td> with buttons to each body row
+    tbody.children.forEach(tr => {
+        tr.children.push({
+            tagName: "td",
+            children: buttons.map(btn => ({
+                tagName: "button",
+                attributes: { type: btn.type || "button" },
+                textContent: btn.label
+            }))
+        });
+    });
+};
+
+export default applyShowOptions;

package/src/v9/table/options/showSerial/index.js

@@ -0,0 +1,19 @@
+const applyShowSerial = (inSpec) => {
+    const [thead, tbody] = inSpec.children;
+
+    // prepend <th>#</th> to head row
+    thead.children[0].children.unshift({
+        tagName: "th",
+        textContent: "#"
+    });
+
+    // prepend <td>{rowIndex}</td> to each body row
+    tbody.children.forEach((tr, index) => {
+        tr.children.unshift({
+            tagName: "td",
+            textContent: String(index + 1)
+        });
+    });
+};
+
+export default applyShowSerial;

package/src/v9/table/render-requests.json

@@ -0,0 +1,107 @@
+{
+  "table": {
+    "type": "table",
+    "data": [
+      { "itemName": "0.09/30mm", "baseUnit": "kgs" }
+    ],
+    "columns": ["itemName", "baseUnit"],
+    "options": {}
+  },
+  "tableWithSerial": {
+    "type": "table",
+    "data": [
+      { "itemName": "0.09/30mm", "baseUnit": "kgs" }
+    ],
+    "columns": ["itemName", "baseUnit"],
+    "options": {
+      "showSerial": true
+    }
+  },
+  "tableWithDefaultAction": {
+    "type": "table",
+    "data": [
+      { "itemName": "0.09/30mm", "baseUnit": "kgs" }
+    ],
+    "columns": ["itemName", "baseUnit"],
+    "options": {
+      "showOptions": true
+    }
+  },
+  "tableWithCustomActions": {
+    "type": "table",
+    "data": [
+      { "itemName": "0.09/30mm", "baseUnit": "kgs" }
+    ],
+    "columns": ["itemName", "baseUnit"],
+    "options": {
+      "showOptions": [
+        { "label": "Show", "type": "button" },
+        { "label": "Edit", "type": "button" }
+      ]
+    }
+  },
+  "tableWithSerialAndActions": {
+    "type": "table",
+    "data": [
+      { "itemName": "0.09/30mm", "baseUnit": "kgs" }
+    ],
+    "columns": ["itemName", "baseUnit"],
+    "options": {
+      "showSerial": true,
+      "showOptions": [
+        { "label": "Show", "type": "button" }
+      ]
+    }
+  },
+  "tableWithFooter": {
+    "type": "table",
+    "data": [
+      { "itemName": "0.09/30mm", "baseUnit": "kgs" }
+    ],
+    "columns": ["itemName", "baseUnit"],
+    "footer": ["inputs"],
+    "options": {}
+  },
+  "tableWithFooterSave": {
+    "type": "table",
+    "data": [
+      { "itemName": "0.09/30mm", "baseUnit": "kgs" }
+    ],
+    "columns": ["itemName", "baseUnit"],
+    "footer": ["inputsWithSave"],
+    "options": {}
+  },
+  "tableWithTotals": {
+    "type": "table",
+    "data": [
+      { "itemName": "0.09/30mm", "baseUnit": "2" },
+      { "itemName": "0.11-25", "baseUnit": "3" }
+    ],
+    "columns": ["itemName", "baseUnit"],
+    "footer": ["totals"],
+    "options": {}
+  },
+  "tableWithMultipleFooters": {
+    "type": "table",
+    "data": [
+      { "itemName": "0.09/30mm", "baseUnit": "2" }
+    ],
+    "columns": ["itemName", "baseUnit"],
+    "footer": ["inputs", "totals", "inputsWithSave", "empty"],
+    "options": {}
+  },
+  "tableHead": {
+    "type": "tableHead",
+    "data": [],
+    "columns": ["itemName", "baseUnit"],
+    "options": {}
+  },
+  "tableBody": {
+    "type": "tableBody",
+    "data": [
+      { "itemName": "0.09/30mm", "baseUnit": "kgs" }
+    ],
+    "columns": ["itemName", "baseUnit"],
+    "options": {}
+  }
+}