tailwind-header-dom 3.4.1

package/bin/header/v2/commands/header/template/v2/initHeader.js

@@ -0,0 +1,49 @@
+import { buildMenuItem } from "./BuildMenuItem/buildMenuItem.js";
+import { buildNav } from "./BuildNav/buildNav.js";
+
+const initHeader = (config = {}) => {
+
+    const header = document.getElementById("header");
+
+    if (!header) return;
+
+    header.appendChild(
+        buildNav(config.title)
+    );
+
+    const menu = document.getElementById("menu");
+
+    const classes = {
+        liClass: "md:text-center",
+
+        aClass: `flex justify-between items-center
+        bg-gray-700 px-4 py-2 rounded-md
+        hover:bg-gray-600
+        active:bg-gray-500 active:scale-95
+        transition-all duration-150
+        md:flex-col md:justify-center md:items-center
+        lg:bg-transparent lg:px-2 lg:py-1`,
+
+        spanClass: `ml-3 text-right w-full text-base
+        md:w-auto md:text-center md:ml-0 lg:text-lg`,
+
+        svgClass: "text-gray-300 w-6 h-6 lg:w-7 lg:h-7"
+    };
+
+    (config.items || []).forEach(item => {
+
+        const li = buildMenuItem({
+            inTextToShow: item.text,
+            inHtmlId: item.id,
+            inIconPaths: item.icon,
+            inHref: item.href,
+            onClick: item.onClick,
+            inTableName: item.tableName,
+            inClasses: classes
+        });
+
+        menu.appendChild(li);
+    });
+};
+
+export default initHeader;

package/bin/header/v2/commands/header/template/v3/BuildMenuItem/buildMenuItem.js

@@ -0,0 +1,49 @@
+import { createLi } from "../createLi.js";
+import { createAnchor } from "../createAnchor.js";
+import { createLabel } from "../createLabel.js";
+import { createIcon } from "../createIcon.js";
+import { orchestrateMenuClick } from "./orchestrateMenuClick.js";
+
+export const buildMenuItem = ({
+    inTextToShow,
+    inHtmlId,
+    inIconPaths,
+    inHref,
+    onClick,
+    inTableName,
+    inClasses
+}) => {
+    const li = createLi(inClasses.liClass);
+
+    const a = createAnchor({
+        inHtmlId,
+        inHref,
+        cls: inClasses?.aClass,
+        inTableName
+    });
+    // debugger;
+    const span = createLabel({
+        inTextToShow: inTextToShow,
+        inClassName: inClasses.spanClass
+    });
+
+    const svg = createIcon({
+        inClassName: inClasses.svgClass,
+        inIconPaths
+    });
+
+    if (onClick) {
+        a.addEventListener(
+            "click",
+            orchestrateMenuClick({
+                onClick
+            })
+        );
+    };
+
+    a.append(svg, span);
+
+    li.appendChild(a);
+
+    return li;
+};

package/bin/header/v2/commands/header/template/v3/BuildMenuItem/callKSTable.js

@@ -0,0 +1,7 @@
+export const callKSTable = async (config) => {
+    if (window.KSTable?.initTableOnly) {
+        return window.KSTable.initTableOnly(config);
+    };
+
+    return initTableOnly(config);
+};

package/bin/header/v2/commands/header/template/v3/BuildMenuItem/getDefaultKSTableConfig.js

@@ -0,0 +1,80 @@
+export const getDefaultKSTableConfig = () => {
+    return {
+        containerId: 'kSTableContainer',
+
+        tableName: "",
+
+        mode: "create",
+
+        layout: {
+            verticalPosition: "top",
+            type: "table",
+        },
+
+        endPoints: {
+            create: "",
+            update: "",
+            delete: "",
+            read: "",
+            find: ""
+        },
+
+        options: {
+            firstRow: {
+                showSearch: true
+            },
+
+            vertical: {
+                showVertical: true,
+                isDisabled: false,
+                showSaveButton: true
+            },
+
+            dataList: {
+                show: true,
+            },
+
+            table: {
+                isDisabled: false,
+                showTable: true,
+                showRowOptions: false,
+                showSerial: true,
+                showFooter: false,
+
+                footer: {
+                    showDataList: true
+                }
+            },
+
+            focus: {
+                priority: ["vertical", "footer", "search"]
+            }
+        },
+
+        columnsConfig: [],
+
+        uiClasses: {
+            form: {
+                formClass: 'grid grid-cols-3 gap-x-8 gap-y-4 p-6 verticalForm',
+                buttonClass: 'mt-2 px-4 py-1 bg-green-500 text-white',
+                rowClass: 'flex items-center space-x-4',
+                labelClass: 'w-24 text-sm font-medium',
+                inputClass: 'flex-1 border rounded px-3 py-2'
+            }
+        },
+
+        callbacks: {
+            table: {
+                onDelete: async ({ toDeletePk }) => {
+                    const fromDelete = await startFetchAsGet({
+                        inQuery: {
+                            ParentPk: toDeletePk
+                        }
+                    });
+
+                    return await fromDelete;
+                }
+            }
+        }
+    };
+};

package/bin/header/v2/commands/header/template/v3/BuildMenuItem/getKSTableConfig.js

@@ -0,0 +1,17 @@
+import { getDefaultKSTableConfig } from "./getDefaultKSTableConfig.js";
+
+export const getKSTableConfig = async ({ tableName }) => {
+    const config = getDefaultKSTableConfig();
+
+    const fromPromise = await fetch("/columns.json");
+    // debugger;
+    const columnsConfig = await fromPromise.json();
+
+    config.columnsConfig = columnsConfig[tableName].columnsConfig;
+
+    config.tableName = tableName;
+
+    config.endPoints.read = `/Api/V1/${tableName}/ShowAll`;
+
+    return config;
+};

package/bin/header/v2/commands/header/template/v3/BuildMenuItem/orchestrateMenuClick.js

@@ -0,0 +1,34 @@
+import { getKSTableConfig } from "./getKSTableConfig.js";
+import { callKSTable } from "./callKSTable.js";
+
+export const orchestrateMenuClick1 = async (event) => {
+    event.preventDefault();
+
+    const currentTarget = event.currentTarget;
+    // debugger;
+    const config = await getKSTableConfig({
+        tableName: currentTarget.dataset.tableName
+    });
+
+    await callKSTable(config);
+};
+
+export const orchestrateMenuClick =
+    ({ onClick }) =>
+        async (event) => {
+            // debugger;
+            event.preventDefault();
+
+            const currentTarget = event.currentTarget;
+            // debugger;
+            const config = await getKSTableConfig({
+                tableName: currentTarget.dataset.tableName
+            });
+
+            const fromCallKSTable = await callKSTable(config);
+            console.log("fromCallKSTable : ", fromCallKSTable);
+
+            if (onClick) {
+                await onClick(event);
+            };
+        };

package/bin/header/v2/commands/header/template/v3/BuildNav/buildBrand.js

@@ -0,0 +1,14 @@
+// /header/v1/buildBrand.js
+
+export const buildBrand = ({ inHeading = "KeshavSoft", inHtmlId = "titlehtmlId" }) => {
+
+    const div = document.createElement("div");
+
+    div.className = "text-xl font-semibold";
+
+    div.innerText = inHeading;
+
+    div.id = inHtmlId;
+
+    return div;
+};

package/bin/header/v2/commands/header/template/v3/BuildNav/buildHamburger.js

@@ -0,0 +1,20 @@
+// /header/v1/buildHamburger.js
+
+export const buildHamburger = () => {
+
+    const button = document.createElement("button");
+
+    button.className = "text-xl px-4 py-1 md:hidden";
+
+    button.innerText = "☰";
+
+    button.addEventListener("click", () => {
+
+        document
+            .getElementById("menu")
+            .classList.toggle("hidden");
+
+    });
+
+    return button;
+};

package/bin/header/v2/commands/header/template/v3/BuildNav/buildMenu.js

@@ -0,0 +1,14 @@
+// /header/v1/buildMenu.js
+
+export const buildMenu = () => {
+
+    const ul = document.createElement("ul");
+
+    ul.id = "menu";
+
+    ul.className = `w-full hidden flex flex-col space-y-2 mt-4
+    md:flex md:flex-row md:space-y-0 md:gap-4
+    md:mt-0 md:w-auto md:flex-wrap`;
+
+    return ul;
+};

package/bin/header/v2/commands/header/template/v3/BuildNav/buildNav.js

@@ -0,0 +1,31 @@
+// /header/v2/buildNav.js
+
+import { buildBrand } from "./buildBrand.js";
+import { buildHamburger } from "./buildHamburger.js";
+import { buildMenu } from "./buildMenu.js";
+import { buildWrapper } from "./buildWrapper.js";
+
+export const buildNav = (inTitle = {}) => {
+
+    const {
+        nav,
+        innerDiv
+    } = buildWrapper();
+
+    innerDiv.appendChild(
+        buildBrand({
+            inHeading: inTitle.text,
+            inHtmlId: inTitle.htmlId
+        })
+    );
+
+    innerDiv.appendChild(
+        buildHamburger()
+    );
+
+    innerDiv.appendChild(
+        buildMenu()
+    );
+
+    return nav;
+};

package/bin/header/v2/commands/header/template/v3/BuildNav/buildWrapper.js

@@ -0,0 +1,29 @@
+// /header/v1/buildWrapper.js
+
+export const buildWrapper = () => {
+
+    const nav = document.createElement("nav");
+
+    nav.className = "bg-gray-800 text-white";
+
+    const outerDiv = document.createElement("div");
+
+    outerDiv.className = `mx-auto px-3 py-3
+    max-w-3xl
+    lg:max-w-5xl
+    xl:max-w-full xl:px-10`;
+
+    const innerDiv = document.createElement("div");
+
+    innerDiv.className =
+        "flex flex-wrap items-center justify-between";
+
+    outerDiv.appendChild(innerDiv);
+
+    nav.appendChild(outerDiv);
+
+    return {
+        nav,
+        innerDiv
+    };
+};

package/bin/header/v2/commands/header/template/v3/buildNav.js

@@ -0,0 +1,29 @@
+// /header/v1/buildWrapper.js
+
+export const buildWrapper = () => {
+
+    const nav = document.createElement("nav");
+
+    nav.className = "bg-gray-800 text-white";
+
+    const outerDiv = document.createElement("div");
+
+    outerDiv.className = `mx-auto px-3 py-3
+    max-w-3xl
+    lg:max-w-5xl
+    xl:max-w-full xl:px-10`;
+
+    const innerDiv = document.createElement("div");
+
+    innerDiv.className =
+        "flex flex-wrap items-center justify-between";
+
+    outerDiv.appendChild(innerDiv);
+
+    nav.appendChild(outerDiv);
+
+    return {
+        nav,
+        innerDiv
+    };
+};

package/bin/header/v2/commands/header/template/v3/createAnchor.js

@@ -0,0 +1,15 @@
+export const createAnchor = ({
+    inHtmlId = "", inHref = "#", cls = "", inTableName = ""
+}) => {
+    const a = document.createElement("a");
+
+    a.id = inHtmlId;
+    a.href = inHref;
+    a.className = cls;
+
+    if (inTableName) {
+        a.dataset.tableName = inTableName
+    };
+
+    return a;
+};

package/bin/header/v2/commands/header/template/v3/createIcon.js

@@ -0,0 +1,19 @@
+export const createIcon = ({
+    inIconPaths = [],
+    inClassName = ""
+}) => {
+    const svg = document.createElementNS("http://www.w3.org/2000/svg", "svg");
+
+    svg.setAttribute("class", inClassName);
+    svg.setAttribute("fill", "none");
+    svg.setAttribute("stroke", "currentColor");
+    svg.setAttribute("viewBox", "0 0 24 24");
+
+    inIconPaths.forEach(d => {
+        const path = document.createElementNS("http://www.w3.org/2000/svg", "path");
+        path.setAttribute("d", d);
+        svg.appendChild(path);
+    });
+
+    return svg;
+};

package/bin/header/v2/commands/header/template/v3/createLabel.js

@@ -0,0 +1,9 @@
+export const createLabel = ({
+    inTextToShow = "",
+    inClassName = ""
+}) => {
+    const span = document.createElement("span");
+    span.className = inClassName;
+    span.textContent = inTextToShow;
+    return span;
+};

package/bin/header/v2/commands/header/template/v3/createLi.js

@@ -0,0 +1,5 @@
+export const createLi = (cls = "") => {
+    const li = document.createElement("li");
+    li.className = cls;
+    return li;
+};

package/bin/header/v2/commands/header/template/v3/initHeader.js

@@ -0,0 +1,49 @@
+import { buildMenuItem } from "./BuildMenuItem/buildMenuItem.js";
+import { buildNav } from "./BuildNav/buildNav.js";
+
+const initHeader = (config = {}) => {
+
+    const header = document.getElementById("header");
+
+    if (!header) return;
+
+    header.appendChild(
+        buildNav(config.title)
+    );
+
+    const menu = document.getElementById("menu");
+
+    (config.items || []).forEach(item => {
+
+        const classes = {
+            liClass: "md:text-center",
+
+            aClass: `${item?.uiClasses?.aClass} flex justify-between items-center
+        bg-gray-700 px-4 py-2 rounded-md
+        hover:bg-gray-600
+        active:bg-gray-500 active:scale-95
+        transition-all duration-150
+        md:flex-col md:justify-center md:items-center
+        lg:bg-transparent lg:px-2 lg:py-1`,
+
+            spanClass: `ml-3 text-right w-full text-base
+        md:w-auto md:text-center md:ml-0 lg:text-lg`,
+
+            svgClass: "text-gray-300 w-6 h-6 lg:w-7 lg:h-7"
+        };
+
+        const li = buildMenuItem({
+            inTextToShow: item.text,
+            inHtmlId: item.id,
+            inIconPaths: item.icon,
+            inHref: item.href,
+            onClick: item.onClick,
+            inTableName: item.tableName,
+            inClasses: classes
+        });
+
+        menu.appendChild(li);
+    });
+};
+
+export default initHeader;

package/bin/header/v2/commands/header.js

@@ -0,0 +1,74 @@
+import { locateSource } from "./header/steps/locateSource.js";
+import { locateDestination } from "./header/steps/locateDestination.js";
+
+import { createProject } from "./header/steps/createProject.js";
+import { announce } from "./header/steps/announce.js";
+
+import resolveFolderName from "./header/steps/resolveFolderName.js";
+import checks from "./header/steps/checks.js";
+
+export default ({
+    folderName = "",
+    toPath = process.cwd(),
+    inAnnounce = true,
+    showLog = false
+}) => {
+    if (showLog) {
+        console.log(`Resolving folder name..., folderName : ${folderName}`);
+    };
+
+    const resolvedFolderName = resolveFolderName({
+        name: folderName
+    });
+
+    if (showLog) {
+        console.log(`\n[1] Running checks..., resolvedFolderName : ${resolvedFolderName}`);
+    };
+
+    const fromChecks = checks({
+        inFolderName: resolvedFolderName,
+        toPath,
+        inShowLog: showLog
+    });
+
+    if (fromChecks) return false;
+
+    if (showLog) {
+        console.log("Locating source...");
+    }
+
+    const source = locateSource({
+        showLog
+    });
+
+    if (showLog) {
+        console.log("Locating destination...");
+    }
+
+    const destination = locateDestination({
+        inResolvedFolderName: resolvedFolderName,
+        showLog
+    });
+
+    if (showLog) {
+        console.log("Creating project...");
+    }
+
+    createProject({
+        source,
+        destination,
+        showLog
+    });
+
+    if (inAnnounce) {
+
+        if (showLog) {
+            console.log("Announcing...");
+        }
+
+        announce({
+            inResolvedFolderName: resolvedFolderName,
+            showLog
+        });
+    }
+};

package/bin/header/v2/core/parseInput.js

@@ -0,0 +1,9 @@
+export default function parseInput() {
+    const [cmd, folderName] = process.argv.slice(2);
+
+    return {
+        cmd: cmd || null,
+        folderName: folderName || null,
+        toPath: process.cwd()
+    };
+};

package/bin/header/v2/core/resolveCommand.js

@@ -0,0 +1,16 @@
+import fs from "fs";
+
+const files = fs.readdirSync(new URL("../commands/", import.meta.url));
+
+const entries = await Promise.all(
+    files.filter(f => f.endsWith(".js"))
+        .map(async f => [f.replace(".js", ""), (await import(`../commands/${f}`)).default])
+);
+
+const map = Object.fromEntries(entries);
+
+const resolveCommand = (cmd) => {
+    return map[cmd] || null;
+};
+
+export default resolveCommand;

package/bin/header/v2/core/showUsage.js

@@ -0,0 +1,49 @@
+/*
+JSON CRUD UI CLI – Entry Flow
+
+1. Read user input from terminal (parseInput)
+2. If no command → show usage
+3. If help flags → show usage
+4. Resolve command dynamically
+5. If command not found → show usage
+6. Validate command requirements
+7. Execute command
+
+Goal:
+- Zero confusion for user
+- Single source of truth (showUsage)
+- Self-validating commands
+- Easy to extend (drop-in command architecture)
+*/
+
+export default function showUsage(version) {
+    const g = "\x1b[32m";
+    const y = "\x1b[33m";
+    const c = "\x1b[36m";
+    const gray = "\x1b[90m";
+    const r = "\x1b[0m";
+
+    console.log(`
+${c}🚀 json-crud-ui-components v${version}${r}
+
+${y}Usage:${r}
+  ${g}npx json-crud-ui-components${r} <command>
+
+${y}Commands:${r}
+  ${g}init${r}             Creates initial boilerplate structure
+  ${g}addListeners${r}     Adds listeners boilerplate
+  ${g}buildHeader${r}      Builds header structure
+  ${g}htmlIdClick${r}      Adds htmlIdClick handler
+
+${y}Examples:${r}
+  ${gray}npx json-crud-ui-components init${r}
+  ${gray}npx json-crud-ui-components addListeners${r}
+
+${y}Architecture:${r}
+  ${gray}commands are auto-loaded dynamically${r}
+  ${gray}each command validates required files${r}
+
+${y}Tip:${r}
+  ${gray}Run init first before feature commands${r}
+`);
+}

package/bin/header/v2/start.js

@@ -0,0 +1,24 @@
+import parseInput from "./core/parseInput.js";
+import showUsage from './core/showUsage.js';
+
+import resolveCommand from "./core/resolveCommand.js";
+
+import pkg from '../../package.json' with { type: 'json' };
+
+const version = pkg.version;
+
+const run = async () => {
+  const input = parseInput();
+
+  if (input.action === "--help" || input.action === "-h" || input.action === "help") return showUsage(version);
+
+  const command = resolveCommand(input.cmd);
+
+  if (!command) return (console.log(`Unknown command: ${input.cmd}\n`), showUsage(version));
+
+  await command({
+    folderName: input.folderName
+  });
+};
+
+export default run;

package/bin/header/v3/commands/header/steps/announce.js

@@ -0,0 +1,3 @@
+export const announce = ({ inResolvedFolderName }) => {
+    console.log(`[keshavsoft] Project created: ${inResolvedFolderName}`);
+};