json-renderers-build 0.0.0-stage → 1.2.1

package/docs/dist/v2/min.js

@@ -0,0 +1,210 @@
+const F = {
+  version: "v2.0.0",
+  description: "build table from store data and render to DOM uses json-to-spec, json-to-dom under the hood"
+}, O = (t) => {
+  var e;
+  typeof globalThis > "u" || !t || (globalThis.ks ?? (globalThis.ks = {}), (e = globalThis.ks).jsonRenderersBuild ?? (e.jsonRenderersBuild = {
+    meta: F,
+    renderToDom: t
+  }));
+}, w = {
+  version: "v32",
+  description: "JSON-to-DOM engine with centralized traversal and responsibility-focused construction"
+}, R = ({ inFuncDefinition: t } = {}) => {
+  if (typeof globalThis > "u" || !t) return;
+  globalThis.ks ?? (globalThis.ks = {});
+  const e = {
+    meta: w,
+    buildSpecElement: t
+  };
+  globalThis.ks.jsonToSpec = e;
+}, I = (t, e) => n(t, e), f = (t, e) => Array.isArray(t) ? t.map((r) => I(r, e)).flat(1 / 0).filter(Boolean) : [], E = (t, e) => {
+  if ("source" in t && (t == null ? void 0 : t.source) in e) {
+    const r = e[t == null ? void 0 : t.source];
+    if (Array.isArray(r))
+      return r.map((l) => {
+        const o = t == null ? void 0 : t.template;
+        if (o)
+          return n(o, l);
+      });
+  }
+}, H = (t, e) => {
+  let r = [];
+  for (const [a, l] of Object.entries(e)) {
+    const o = t == null ? void 0 : t.template;
+    if (o) {
+      const u = n(o, {
+        key: a,
+        value: l
+      });
+      r.push(u);
+    }
+  }
+  return r;
+}, x = (t, e) => {
+  if ("source" in t && (t == null ? void 0 : t.source) in e) {
+    const r = e[t == null ? void 0 : t.source];
+    if (Array.isArray(r))
+      return r.map((l) => {
+        const o = t == null ? void 0 : t.template;
+        if (o)
+          return n(o, l);
+      });
+  }
+}, L = (t, e) => {
+  if ("operation" in t) {
+    if (t.operation === "loopArray")
+      return E(t, e);
+    if (t.operation === "loopObject")
+      return H(t, e);
+    if (t.operation === "loopCollection")
+      return x(t, e);
+  }
+}, d = (t, e) => {
+  if (typeof e == "string") return e;
+  if (typeof t != "string") return t;
+  if (t === "${value}")
+    return e.value;
+  const r = t.match(/^\$\{(.+?)\}$/);
+  if (r) {
+    const a = r[1];
+    return (e == null ? void 0 : e[a]) ?? "";
+  }
+  return t;
+}, G = (t, e) => {
+  let r = {};
+  for (const [a, l] of Object.entries(t)) {
+    const o = d(l, e);
+    r[a] = o;
+  }
+  return r;
+}, M = (t, e) => {
+  if ("tagName" in t) {
+    if ("textContent" in t) {
+      const r = d(t.textContent, e);
+      t.textContent = r;
+    }
+    if ("attributes" in t) {
+      const r = G(t.attributes, e);
+      t.attributes = r;
+    }
+  }
+}, B = (t, e) => {
+  if (!t || typeof t != "object" || Array.isArray(t)) return null;
+  const r = structuredClone(t);
+  if (!r) return null;
+  if ("tagName" in r && M(r, e), "jsonToSpec" in r) {
+    const a = r == null ? void 0 : r.jsonToSpec, l = L(a, e);
+    Array.isArray(l) ? r.children = l : r.children = [l], delete r.jsonToSpec;
+  }
+  if (Array.isArray(r == null ? void 0 : r.children)) {
+    const a = f(r == null ? void 0 : r.children, e);
+    r.children = a;
+  }
+  return r;
+}, n = (t, e) => {
+  if (t == null) return null;
+  debugger;
+  return typeof Node < "u" && t instanceof Node ? t : Array.isArray(t) ? f(t, e) : typeof t == "object" ? B(t, e) : typeof t == "string" || typeof t == "number" ? document.createTextNode(String(t)) : t;
+}, m = (t, e) => n(t, e);
+R({
+  inFuncDefinition: m
+});
+const z = {
+  default: {
+    tagName: "table",
+    attributes: {
+      class: "table table-hover table-striped mb-0"
+    },
+    children: [
+      {
+        tagName: "thead",
+        children: [
+          {
+            tagName: "tr",
+            jsonToSpec: {
+              operation: "loopCollection",
+              source: "columns",
+              template: {
+                tagName: "th",
+                textContent: "${title}"
+              }
+            },
+            children: []
+          }
+        ]
+      },
+      {
+        tagName: "tbody",
+        jsonToSpec: {
+          operation: "loopCollection",
+          source: "data",
+          template: {
+            tagName: "tr",
+            jsonToSpec: {
+              operation: "loopObject",
+              source: "data",
+              template: {
+                tagName: "td",
+                textContent: "${value}"
+              }
+            },
+            children: []
+          }
+        },
+        children: []
+      }
+    ]
+  }
+}, P = ({
+  targetHtmlId: t,
+  inTargetHtmlId: e,
+  inColumns: r,
+  inData: a
+} = {}) => {
+  const l = a ?? [], o = r;
+  return m(z.default, {
+    columns: o,
+    data: l
+  });
+}, c = {
+  table: P
+}, U = ({
+  type: t = "table",
+  targetHtmlId: e,
+  data: r,
+  classToApply: a,
+  inTargetHtmlId: l,
+  inData: o,
+  columns: u,
+  inColumns: y,
+  colGroup: b,
+  inColGroup: g,
+  footerData: h,
+  inFooterData: v,
+  config: A,
+  inConfig: j,
+  variant: $,
+  skeletonType: p,
+  inSkeletonType: N,
+  showLog: C = !1,
+  inShowLog: k
+} = {}) => {
+  const i = t, D = typeof i == "string" ? i.toLowerCase() : "table", s = c[D];
+  return s ? s({
+    targetHtmlId: l ?? e,
+    inColumns: y ?? u,
+    inData: o ?? r,
+    inColGroup: g ?? b,
+    inFooterData: v ?? h ?? [],
+    inConfig: j ?? A ?? {},
+    inSkeletonType: N ?? p ?? $ ?? "default",
+    inShowLog: k ?? C ?? !1
+  }) : (console.error(
+    `[Renderer] Unknown renderer type "${i}". Available types: ${Object.keys(c).join(", ")}`
+  ), null);
+};
+O(U);
+export {
+  U as default
+};

package/package.json

@@ -1,6 +1,34 @@
-{
-  "name": "json-renderers-build",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+{
+  "name": "json-renderers-build",
+  "version": "1.2.1",
+  "description": "Standalone, config-driven Table renderer built on top of json-to-dom",
+  "type": "module",
+  "main": "src/index.js",
+  "files": [
+    "src",
+    "docs",
+    "README.md"
+  ],
+  "exports": {
+    ".": "./src/index.js"
+  },
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build"
+  },
+  "keywords": [
+    "json-to-dom",
+    "table",
+    "renderer",
+    "aggregates",
+    "totals"
+  ],
+  "author": "KeshavSoft",
+  "license": "MIT",
+  "devDependencies": {
+    "vite": "^5.4.2"
+  },
+  "dependencies": {
+    "json-to-spec": "^32.1.2"
+  }
 }

package/src/index.js

@@ -0,0 +1,2 @@
+export * from "./v2/index.js";
+export { default } from "./v2/index.js";

package/src/v1/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/v1/index.js

@@ -0,0 +1,62 @@
+import registerGlobal from "./registerGlobal.js";
+
+import renderTable from "./table/index.js";
+
+const RENDERER_MAP = {
+    table: renderTable
+};
+
+const render = ({
+    type = "table",
+    targetHtmlId,
+    data,
+    classToApply,
+    inTargetHtmlId,
+    inData,
+    columns,
+    inColumns,
+    colGroup,
+    inColGroup,
+    footerData,
+    inFooterData,
+    config,
+    inConfig,
+    variant,
+    skeletonType,
+    inSkeletonType,
+    showLog = false,
+    inShowLog
+} = {}) => {
+    const rawType = type;
+    const resolvedType = typeof rawType === "string" ? rawType.toLowerCase() : "table";
+    const renderer = RENDERER_MAP[resolvedType];
+
+    if (!renderer) {
+        console.error(
+            `[Renderer] Unknown renderer type "${rawType}". Available types: ${Object.keys(RENDERER_MAP).join(", ")}`
+        );
+        return null;
+    }
+
+    const localTargetHtmlId = inTargetHtmlId ?? targetHtmlId;
+    const localData = inData ?? data;
+    const localColumns = inColumns ?? columns;
+    const localSkeletonType = inSkeletonType ?? skeletonType ?? variant ?? "default";
+    const localShowLog = inShowLog ?? showLog ?? false;
+
+    // Default to table renderer
+    return renderer({
+        targetHtmlId: localTargetHtmlId,
+        inColumns: localColumns,
+        inData: localData,
+        inColGroup: inColGroup ?? colGroup,
+        inFooterData: inFooterData ?? footerData ?? [],
+        inConfig: inConfig ?? config ?? {},
+        inSkeletonType: localSkeletonType,
+        inShowLog: localShowLog
+    });
+};
+
+registerGlobal(render);
+
+export default render;

package/src/v1/meta.js

@@ -0,0 +1,6 @@
+export const meta = {
+    version: "v12.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/v1/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.jsonRenderers ??= {
+        meta,
+        renderToDom: inFuncDefinition
+    };
+};
+
+export default registerGlobal;

package/src/v1/select/index.js

@@ -0,0 +1,32 @@
+import jsonToSpec from "json-to-spec";
+import jsonToTag from "@keshavsoft/json-to-tag";
+
+import skeletonJson from './skeleton.json' with { type: 'json' };
+
+// --- Story of Table Render ---
+const startFunc = ({
+    inTargetHtmlId,
+    inData
+} = {}) => {
+    const localTargetHtmlId = inTargetHtmlId ?? targetHtmlId;
+    const localData = inData ?? [];
+    const localColumns = inColumns;
+
+    let specAsJsonToDom = jsonToSpec(skeletonJson, {
+        arrayOfStrings: localData
+    });
+
+    if (!("tagName" in specAsJsonToDom)) {
+        specAsJsonToDom = specAsJsonToDom.children;
+    };
+
+    const container = document.getElementById(localTargetHtmlId);
+
+    if (container) container.innerHTML = "";
+
+    const content = jsonToTag(specAsJsonToDom);
+
+    container.append(content);
+};
+
+export default startFunc;

package/src/v1/select/skeleton.json

@@ -0,0 +1,18 @@
+{
+    "tagName": "select",
+    "attributes": {
+        "id": "arrayOfStrings"
+    },
+    "jsonToSpec": {
+        "operation": "loopArray",
+        "source": "arrayOfStrings",
+        "template": {
+            "tagName": "option",
+            "attributes": {
+                "value": "${}"
+            },
+            "textContent": "${}"
+        }
+    },
+    "children": []
+}

package/src/v1/table/index.js

@@ -0,0 +1,36 @@
+import jsonToSpec from "json-to-spec";
+import jsonToTag from "@keshavsoft/json-to-tag";
+
+import skeletonJson from './skeleton.json' with { type: 'json' };
+
+// --- Story of Table Render ---
+const startFunc = ({
+    targetHtmlId,
+    inTargetHtmlId,
+    inColumns,
+    inData,
+} = {}) => {
+    const localTargetHtmlId = inTargetHtmlId ?? targetHtmlId;
+    const localData = inData ?? [];
+    const localColumns = inColumns;
+
+    let specAsJsonToDom = jsonToSpec(skeletonJson.default, {
+        columns: localColumns, data: localData
+    });
+
+    // console.log("specAsJsonToDom : ", specAsJsonToDom);
+
+    if (!("tagName" in specAsJsonToDom)) {
+        specAsJsonToDom = specAsJsonToDom.children;
+    };
+
+    const container = document.getElementById(localTargetHtmlId);
+
+    if (container) container.innerHTML = "";
+
+    const content = jsonToTag(specAsJsonToDom);
+    
+    container.append(content);
+};
+
+export default startFunc;

package/src/v1/table/skeleton.json

@@ -0,0 +1,47 @@
+{
+    "default": {
+        "tagName": "table",
+        "attributes": {
+            "class": "table table-hover table-striped mb-0"
+        },
+        "children": [
+            {
+                "tagName": "thead",
+                "children": [
+                    {
+                        "tagName": "tr",
+                        "jsonToSpec": {
+                            "operation": "loopCollection",
+                            "source": "columns",
+                            "template": {
+                                "tagName": "th",
+                                "textContent": "${title}"
+                            }
+                        },
+                        "children": []
+                    }
+                ]
+            },
+            {
+                "tagName": "tbody",
+                "jsonToSpec": {
+                    "operation": "loopCollection",
+                    "source": "data",
+                    "template": {
+                        "tagName": "tr",
+                        "jsonToSpec": {
+                            "operation": "loopObject",
+                            "source": "data",
+                            "template": {
+                                "tagName": "td",
+                                "textContent": "${value}"
+                            }
+                        },
+                        "children": []
+                    }
+                },
+                "children": []
+            }
+        ]
+    }
+}

package/src/v2/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/v2/index.js

@@ -0,0 +1,62 @@
+import registerGlobal from "./registerGlobal.js";
+
+import renderTable from "./table/index.js";
+
+const RENDERER_MAP = {
+    table: renderTable
+};
+
+const render = ({
+    type = "table",
+    targetHtmlId,
+    data,
+    classToApply,
+    inTargetHtmlId,
+    inData,
+    columns,
+    inColumns,
+    colGroup,
+    inColGroup,
+    footerData,
+    inFooterData,
+    config,
+    inConfig,
+    variant,
+    skeletonType,
+    inSkeletonType,
+    showLog = false,
+    inShowLog
+} = {}) => {
+    const rawType = type;
+    const resolvedType = typeof rawType === "string" ? rawType.toLowerCase() : "table";
+    const renderer = RENDERER_MAP[resolvedType];
+
+    if (!renderer) {
+        console.error(
+            `[Renderer] Unknown renderer type "${rawType}". Available types: ${Object.keys(RENDERER_MAP).join(", ")}`
+        );
+        return null;
+    }
+
+    const localTargetHtmlId = inTargetHtmlId ?? targetHtmlId;
+    const localData = inData ?? data;
+    const localColumns = inColumns ?? columns;
+    const localSkeletonType = inSkeletonType ?? skeletonType ?? variant ?? "default";
+    const localShowLog = inShowLog ?? showLog ?? false;
+
+    // Default to table renderer
+    return renderer({
+        targetHtmlId: localTargetHtmlId,
+        inColumns: localColumns,
+        inData: localData,
+        inColGroup: inColGroup ?? colGroup,
+        inFooterData: inFooterData ?? footerData ?? [],
+        inConfig: inConfig ?? config ?? {},
+        inSkeletonType: localSkeletonType,
+        inShowLog: localShowLog
+    });
+};
+
+registerGlobal(render);
+
+export default render;

package/src/v2/meta.js

@@ -0,0 +1,6 @@
+export const meta = {
+    version: "v2.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/v2/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/v2/select/index.js

@@ -0,0 +1,32 @@
+import jsonToSpec from "json-to-spec";
+import jsonToTag from "@keshavsoft/json-to-tag";
+
+import skeletonJson from './skeleton.json' with { type: 'json' };
+
+// --- Story of Table Render ---
+const startFunc = ({
+    inTargetHtmlId,
+    inData
+} = {}) => {
+    const localTargetHtmlId = inTargetHtmlId ?? targetHtmlId;
+    const localData = inData ?? [];
+    const localColumns = inColumns;
+
+    let specAsJsonToDom = jsonToSpec(skeletonJson, {
+        arrayOfStrings: localData
+    });
+
+    if (!("tagName" in specAsJsonToDom)) {
+        specAsJsonToDom = specAsJsonToDom.children;
+    };
+
+    const container = document.getElementById(localTargetHtmlId);
+
+    if (container) container.innerHTML = "";
+
+    const content = jsonToTag(specAsJsonToDom);
+
+    container.append(content);
+};
+
+export default startFunc;

package/src/v2/select/skeleton.json

@@ -0,0 +1,18 @@
+{
+    "tagName": "select",
+    "attributes": {
+        "id": "arrayOfStrings"
+    },
+    "jsonToSpec": {
+        "operation": "loopArray",
+        "source": "arrayOfStrings",
+        "template": {
+            "tagName": "option",
+            "attributes": {
+                "value": "${}"
+            },
+            "textContent": "${}"
+        }
+    },
+    "children": []
+}

package/src/v2/table/index.js

@@ -0,0 +1,23 @@
+import jsonToSpec from "json-to-spec";
+
+import skeletonJson from './skeleton.json' with { type: 'json' };
+
+// --- Story of Table Render ---
+const startFunc = ({
+    targetHtmlId,
+    inTargetHtmlId,
+    inColumns,
+    inData,
+} = {}) => {
+    const localTargetHtmlId = inTargetHtmlId ?? targetHtmlId;
+    const localData = inData ?? [];
+    const localColumns = inColumns;
+
+    let specAsJsonToDom = jsonToSpec(skeletonJson.default, {
+        columns: localColumns, data: localData
+    });
+
+    return specAsJsonToDom;
+};
+
+export default startFunc;

package/src/v2/table/skeleton.json

@@ -0,0 +1,47 @@
+{
+    "default": {
+        "tagName": "table",
+        "attributes": {
+            "class": "table table-hover table-striped mb-0"
+        },
+        "children": [
+            {
+                "tagName": "thead",
+                "children": [
+                    {
+                        "tagName": "tr",
+                        "jsonToSpec": {
+                            "operation": "loopCollection",
+                            "source": "columns",
+                            "template": {
+                                "tagName": "th",
+                                "textContent": "${title}"
+                            }
+                        },
+                        "children": []
+                    }
+                ]
+            },
+            {
+                "tagName": "tbody",
+                "jsonToSpec": {
+                    "operation": "loopCollection",
+                    "source": "data",
+                    "template": {
+                        "tagName": "tr",
+                        "jsonToSpec": {
+                            "operation": "loopObject",
+                            "source": "data",
+                            "template": {
+                                "tagName": "td",
+                                "textContent": "${value}"
+                            }
+                        },
+                        "children": []
+                    }
+                },
+                "children": []
+            }
+        ]
+    }
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.