json-renderers 1.18.8 → 1.19.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "json-renderers",
-  "version": "1.18.8",
+  "version": "1.19.1",
   "description": "Browser DOM component renderer built on top of json-renderers-build and @keshavsoft/json-to-tag",
   "type": "module",
   "main": "src/index.js",

package/src/index.js

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

package/src/v19/buildSpec/index.js

@@ -0,0 +1,28 @@
+import jsonRenderBuild from "json-renderers-build";
+
+// --- Story of Spec Build ---
+const startFunc = ({
+    inColumns,
+    inType = "table",
+    inData,
+    inShowLog = false,
+    inOptions
+} = {}) => {
+    const localData = inData ?? [];
+    const localColumns = inColumns;
+    const localType = inType;
+    const localShowLog = inShowLog;
+    const localOptions = inOptions;
+
+    const specAsJsonToDom = jsonRenderBuild({
+        type: localType,
+        data: localData,
+        columns: localColumns,
+        showLog: localShowLog,
+        options: localOptions
+    });
+
+    return specAsJsonToDom;
+};
+
+export default startFunc;

package/src/v19/index.js

@@ -0,0 +1,35 @@
+import registerGlobal from "./registerGlobal.js";
+
+import guardFunc from "json-renderers-guard";
+
+import buildSpec from "./buildSpec/index.js";
+import renderToDom from "./renderToDom/index.js";
+
+// Main orchestrator: coordinates validation, spec building, and DOM rendering
+const render = (config = {}) => {
+    guardFunc(config);
+    const showLog = config?.showLog;
+    const localOptions = config?.options;
+
+    if (showLog) console.log("first : ", config?.options, config?.columns, config?.data, config?.appendPosition);
+
+    const spec = buildSpec({
+        inColumns: config.columns,
+        inData: config.data,
+        inType: config.type,
+        inShowLog: config.showLog,
+        inOptions: localOptions
+    });
+
+    return renderToDom({
+        inSpec: spec,
+        inTargetHtmlId: config.targetHtmlId,
+        inAppendPosition: config.appendPosition,
+        inShowLog: config.showLog
+    });
+};
+
+registerGlobal(render);
+
+export { render };
+export default render;

package/src/{v16 → v19}/meta.js

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

package/src/v19/registerGlobal.js

@@ -0,0 +1,16 @@
+import meta from "./meta.js";
+
+export const registerGlobal = (inDefinition) => {
+    const localDefinition = inDefinition;
+
+    if (typeof globalThis === "undefined" || !localDefinition) return;
+
+    globalThis.ks ??= {};
+
+    globalThis.ks.jsonRenderers = {
+        meta,
+        render: localDefinition
+    };
+};
+
+export default registerGlobal;

package/src/v19/renderToDom/index.js

@@ -0,0 +1,47 @@
+import jsonToTag from "@keshavsoft/json-to-tag";
+
+// --- Story of DOM Rendering and Mounting ---
+const renderToDom = ({
+    inSpec,
+    inTargetHtmlId,
+    inAppendPosition,
+    inShowLog = false
+} = {}) => {
+    const localSpec = inSpec;
+    const localTargetHtmlId = inTargetHtmlId;
+    const localAppendPosition = inAppendPosition;
+    const localShowLog = inShowLog;
+
+    const content = jsonToTag(localSpec);
+
+    if (localShowLog) console.log("renderToDom 1 (content):", content);
+
+    const container = document.getElementById(localTargetHtmlId);
+    if (!container) return null;
+
+    const isCollection = Array.isArray(content) ||
+        content instanceof NodeList ||
+        content instanceof HTMLCollection;
+
+    if (isCollection) {
+        if (localAppendPosition === "prepend") {
+            container.prepend(...content);
+        } else {
+            container.append(...content);
+        }
+    } else {
+        if (localAppendPosition === "prepend") {
+            container.prepend(content);
+        } else {
+            container.innerHTML = "";
+            container.append(content);
+        }
+    }
+
+    if (localShowLog) console.log("renderToDom 2 (mounted):", container);
+
+    return container;
+};
+
+export { renderToDom };
+export default renderToDom;

package/src/v14/buildSpec/index.js

@@ -1,39 +0,0 @@
-import jsonRenderBuild from "json-renderers-build";
-import jsonToTag from "@keshavsoft/json-to-tag";
-
-// --- Story of Table Render ---
-const startFunc = ({
-    inTargetHtmlId,
-    inColumns, type,
-    inData, showLog
-} = {}) => {
-    // debugger
-    const localTargetHtmlId = inTargetHtmlId;
-    const localData = inData ?? [];
-    const localColumns = inColumns;
-
-    if (showLog) console.log("buildSpec 1 :", localTargetHtmlId, localData.localColumns);
-
-    let specAsJsonToDom = jsonRenderBuild({
-        type,
-        targetHtmlId: localTargetHtmlId,
-        data: localData,
-        columns: localColumns
-    });
-
-    let jsonToSend = specAsJsonToDom;
-
-
-    // if (!("tagName" in specAsJsonToDom) && "children" in specAsJsonToDom) {
-    //     jsonToSend = specAsJsonToDom.children;
-    // };
-
-    const content = jsonToTag(jsonToSend);
-    console.log("buildSpec 2 :", jsonToSend, content);
-
-    if (showLog) console.log("buildSpec 3 :", content);
-
-    return content;
-};
-
-export default startFunc;

package/src/v14/index.js

@@ -1,81 +0,0 @@
-import registerGlobal from "./registerGlobal.js";
-
-import buildSpec from "./buildSpec/index.js";
-
-const render = ({
-    type = "table",
-    targetHtmlId,
-    data,
-    classToApply,
-    columns,
-    appendPosition,
-    showLog = false
-} = {}) => {
-    const rawType = type;
-
-    const localTargetHtmlId = targetHtmlId;
-    const localData = data;
-    const localColumns = columns;
-
-    if (showLog) console.log("showLog 1 :", rawType, targetHtmlId, data, classToApply, columns, appendPosition);
-
-    // Default to table renderer
-    const content = buildSpec({
-        inTargetHtmlId: localTargetHtmlId,
-        inColumns: localColumns, showLog,
-        inData: localData, type: rawType
-    });
-    if (showLog) console.log("showLog 2 :", content);
-
-    const container = document.getElementById(localTargetHtmlId);
-
-    if (showLog) console.log("showLog 3 :", container);
-
-    const isCollection = Array.isArray(content) ||
-        content instanceof NodeList ||
-        content instanceof HTMLCollection;
-
-    // console.log("prepend ---------:", rawType, isCollection, container, content, localData);
-
-
-    if (isCollection) {
-        if (appendPosition === "prepend") {
-            container.prepend(...content);
-        } else {
-            container.append(...content);
-        };
-    } else {
-        if (appendPosition === "prepend") {
-            container.prepend(content);
-        } else {
-            if (container) container.innerHTML = "";
-            container.append(content);
-        };
-    };
-
-    // if (appendPosition === "prepend") {
-
-    //     container.prepend(content);
-    // } else {
-    //     if (container) container.innerHTML = "";
-
-    //     console.log("showLog 5 ---------:", container, content);
-
-    //     container.append(content);
-
-    //     // if (content != null && typeof content[Symbol.iterator] === "function") {
-    //     //     container.append(...content);
-    //     // } else {
-
-    //     //     container.append(content);
-    //     // };
-    // };
-
-    if (showLog) console.log("showLog 5 :", container);
-
-    return container;
-};
-
-registerGlobal(render);
-
-export default render;

package/src/v14/meta.js

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

@@ -1,14 +0,0 @@
-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/v15/buildSpec/index.js

@@ -1,39 +0,0 @@
-import jsonRenderBuild from "json-renderers-build";
-import jsonToTag from "@keshavsoft/json-to-tag";
-
-// --- Story of Table Render ---
-const startFunc = ({
-    inTargetHtmlId,
-    inColumns, type,
-    inData, showLog
-} = {}) => {
-    // debugger
-    const localTargetHtmlId = inTargetHtmlId;
-    const localData = inData ?? [];
-    const localColumns = inColumns;
-
-    if (showLog) console.log("buildSpec 1 :", localTargetHtmlId, localData.localColumns);
-
-    let specAsJsonToDom = jsonRenderBuild({
-        type,
-        targetHtmlId: localTargetHtmlId,
-        data: localData,
-        columns: localColumns
-    });
-
-    let jsonToSend = specAsJsonToDom;
-
-
-    // if (!("tagName" in specAsJsonToDom) && "children" in specAsJsonToDom) {
-    //     jsonToSend = specAsJsonToDom.children;
-    // };
-
-    const content = jsonToTag(jsonToSend);
-    console.log("buildSpec 2 :", jsonToSend, content);
-
-    if (showLog) console.log("buildSpec 3 :", content);
-
-    return content;
-};
-
-export default startFunc;

package/src/v15/common/deriveColumnsFromData.js

@@ -1,20 +0,0 @@
-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/v15/guard.js

@@ -1,35 +0,0 @@
-const gaurdFunc = ({ intype, indata, intargetHtmlId, incoumns, inshowLog }) => {
-
-    if (typeof intype !== "string" || intype.trim() === "") {
-        console.error("type must be a string");
-        throw new Error("type must be a string");
-    }
-
-    if (!Array.isArray(indata)) {
-        console.error("data must be an Array");
-        throw new Error("data must be an Array");
-    };
-    if (typeof intargetHtmlId !== "string" || !intargetHtmlId.trim()) {
-        console.error("targetHtmlId must be a non-empty string");
-        throw new TypeError("targetHtmlId must be a non-empty string");
-    }
-
-    if (!Array.isArray(incoumns)) {
-        console.error("columns must be an array");
-        throw new TypeError("columns must be an array");
-    }
-
-    if (typeof inshowLog !== "boolean") {
-        console.error("showLog must be a boolean");
-        throw new TypeError("showLog must be a boolean");
-    }
-
-    if (inshowLog !== true) {
-        console.error("showLog must be true");
-        throw new TypeError("showLog must be true");
-    }
-
-    return true;
-};
-
-export default gaurdFunc;

package/src/v15/index.js

@@ -1,70 +0,0 @@
-import registerGlobal from "./registerGlobal.js";
-import gaurdFunc from "./guard.js";
-
-import buildSpec from "./buildSpec/index.js";
-
-const render = ({
-    type = "table",
-    targetHtmlId,
-    data,
-    classToApply,
-    columns,
-    appendPosition,
-    showLog = false
-} = {}) => {
-    const rawType = type;
-
-    const localTargetHtmlId = targetHtmlId;
-    const localData = data;
-    const localColumns = columns;
-    const localShowLog = showLog;
-
-    gaurdFunc({
-        intype: rawType,
-        indata: localData,
-        intargetHtmlId: localTargetHtmlId,
-        incoumns: localColumns,
-        inshowLog: localShowLog
-    });
-
-    if (localShowLog);
-
-    // Default to table renderer
-    const content = buildSpec({
-        inTargetHtmlId: localTargetHtmlId,
-        inColumns: localColumns, showLog,
-        inData: localData, type: rawType
-    });
-    if (showLog) console.log("showLog 2 :", content);
-
-    const container = document.getElementById(localTargetHtmlId);
-
-    if (showLog) console.log("showLog 3 :", container);
-
-    const isCollection = Array.isArray(content) ||
-        content instanceof NodeList ||
-        content instanceof HTMLCollection;
-
-    if (isCollection) {
-        if (appendPosition === "prepend") {
-            container.prepend(...content);
-        } else {
-            container.append(...content);
-        };
-    } else {
-        if (appendPosition === "prepend") {
-            container.prepend(content);
-        } else {
-            if (container) container.innerHTML = "";
-            container.append(content);
-        };
-    };
-
-    if (showLog) console.log("showLog 5 :", container);
-
-    return container;
-};
-
-registerGlobal(render);
-
-export default render;

package/src/v15/meta.js

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

@@ -1,14 +0,0 @@
-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/v16/buildSpec/index.js

@@ -1,40 +0,0 @@
-import jsonRenderBuild from "json-renderers-build";
-import jsonToTag from "@keshavsoft/json-to-tag";
-
-// --- Story of Table Render ---
-const startFunc = ({
-    inTargetHtmlId,
-    inColumns,
-    inType = "table",
-    inData,
-    inShowLog = false
-} = {}) => {
-    const localTargetHtmlId = inTargetHtmlId;
-    const localData = inData ?? [];
-    const localColumns = inColumns;
-    const localType = inType;
-    const localShowLog = inShowLog;
-
-    if (localShowLog) console.log("buildSpec 1 :", localTargetHtmlId, localData, localColumns);
-
-    let specAsJsonToDom = jsonRenderBuild({
-        type: localType,
-        targetHtmlId: localTargetHtmlId,
-        data: localData,
-        columns: localColumns
-    });
-
-    let jsonToSend = specAsJsonToDom;
-
-    const content = jsonToTag(jsonToSend);
-
-    if (localShowLog) {
-        console.log("buildSpec 2 :", jsonToSend, content);
-        console.log("buildSpec 3 :", content);
-    }
-
-    return content;
-};
-
-export { startFunc };
-export default startFunc;

package/src/v16/common/deriveColumnsFromData.js

@@ -1,20 +0,0 @@
-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/v16/guard.js

@@ -1,38 +0,0 @@
-const guardFunc = ({ inConfig } = {}) => {
-    const localConfig = inConfig;
-
-    if (!localConfig || typeof localConfig !== "object") {
-        console.error("Config must be an object");
-        throw new TypeError("Config must be an object");
-    }
-
-    if (typeof localConfig?.type !== "string") {
-        console.error("type must be string only");
-        throw new Error("type must be string only");
-    };
-
-    if (!Array.isArray(localConfig.data)) {
-        console.error("data must be an Array");
-        throw new TypeError("data must be an Array");
-    }
-
-    if (typeof localConfig.targetHtmlId !== "string" || !localConfig.targetHtmlId.trim()) {
-        console.error("targetHtmlId must be a non-empty string");
-        throw new TypeError("targetHtmlId must be a non-empty string");
-    }
-
-    if (!Array.isArray(localConfig.columns)) {
-        console.error("columns must be an array");
-        throw new TypeError("columns must be an array");
-    }
-
-    if (localConfig.showLog !== undefined && typeof localConfig.showLog !== "boolean") {
-        console.error("showLog must be a boolean");
-        throw new TypeError("showLog must be a boolean");
-    }
-
-    return true;
-};
-
-export { guardFunc };
-export default guardFunc;