json-crud-ui-components 1.5.2 → 1.6.2

package/bin/v6/commands/initHtml.js

@@ -0,0 +1,24 @@
+import { locateSource } from "./initHtml/steps/locateSource.js";
+
+import { createProject } from "./initHtml/steps/createProject.js";
+import { announce } from "./initHtml/steps/announce.js";
+
+import resolveFolderName from "./initHtml/steps/resolveFolderName.js";
+import checks from "./initHtml/steps/checks.js";
+
+export default ({ folderName = "", toPath = process.cwd(), inAnnounce = true }) => {
+    const fromChecks = checks({ toPath, inAnnounce });
+
+    if (fromChecks) return false;
+
+    const resolvedFolderName = resolveFolderName({
+        name: folderName
+    });
+
+    const source = locateSource();
+    const destination = resolvedFolderName;
+
+    createProject({ source, destination });
+
+    if (inAnnounce) announce({ inResolvedFolderName: resolvedFolderName });
+};

package/bin/v6/commands/initJs/steps/announce.js

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

package/bin/v6/commands/initJs/steps/createProject.js

@@ -0,0 +1,7 @@
+import fs from "fs";
+
+export const createProject = ({ source, destination }) => {
+    fs.mkdirSync(destination, { recursive: true });
+    
+    fs.cpSync(source, destination, { recursive: true });
+};

package/bin/v6/commands/initJs/steps/locateDestination.js

@@ -0,0 +1,5 @@
+import path from "path";
+
+export const locateDestination = ({ inResolvedFolderName }) => {
+    return path.join(process.cwd(), inResolvedFolderName);
+};

package/bin/v6/commands/initJs/steps/locateSource.js

@@ -0,0 +1,32 @@
+import fs from "fs";
+
+import path from "path";
+import { fileURLToPath } from "url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+const templatePath = path.join(
+    __dirname,
+    "..",
+    "template"
+);
+
+const versions = fs
+    .readdirSync(templatePath)
+    .filter(item => item.startsWith("v"));
+
+const highestVersion =
+    versions.sort().at(-1);
+
+const sourceVersion =
+    highestVersion;
+
+export const locateSource = () => {
+    return path.join(
+        __dirname,
+        "..",
+        "template",
+        sourceVersion
+    );
+};

package/bin/v6/commands/initJs/steps/resolveFolderName.js

@@ -0,0 +1,17 @@
+import fs from "fs";
+
+export default function resolveFolderName({ name, inType = "basic" }) {
+    const defaultFolerName = "Index";
+
+    // case 1: force new → timestamp
+    if (name === null) {
+        name = defaultFolerName;
+    };
+
+    // case 2: user provided → strict
+    if (fs.existsSync(name)) {
+        throw new Error(`Folder already exists: ${name}`);
+    };
+
+    return name;
+};

package/bin/v6/commands/initJs/template/v4/FormLoad/DomContentLoaded/buildHeader.js

@@ -0,0 +1,58 @@
+import { initHeader } from "../../../../../../header/v6/initHeader.js";
+
+const buildHeader = async () => {
+    const headerConfig1 = {
+        items: [
+            {
+                text: "ShowAll",
+                id: "ShowAllHtmlId",
+                icon: [
+                    "M4 6h16",
+                    "M4 10h16",
+                    "M4 14h10",
+                    "M6 4h12a2 2 0 012 2v12a2 2 0 01-2 2H6a2 2 0 01-2-2V6a2 2 0 012-2z"
+                ]
+            },
+            {
+                text: "StockItems",
+                id: "StockItemsHtmlId",
+                icon: [
+                    "M3 7l9 4 9-4",
+                    "M3 7l9-4 9 4",
+                    "M3 7v10l9 4 9-4V7",
+                    "M12 11v10"
+                ]
+            },
+            {
+                text: "Transactions",
+                id: "1",
+                icon: [
+
+                    "M6 2h9l5 5v15a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2z",
+                    "M14 2v6h6",
+                    "M8 12h8",
+                    "M8 16h8"
+                ],
+                href: "../../Transactions/V7/Create/index.html"
+            },
+            {
+                text: "FromTally",
+                id: "ImportHtmlId",
+                icon: [
+                    "M4 6h16",
+                    "M4 10h16",
+                    "M4 14h10",
+                    "M6 4h12a2 2 0 012 2v12a2 2 0 01-2 2H6a2 2 0 01-2-2V6a2 2 0 012-2z"
+                ]
+            }
+        ]
+    };
+
+    const fromFetch = await fetch("./Index/headers.json");
+    const headerConfig = await fromFetch.json();
+
+    await initHeader(headerConfig);
+    // callKSHeader(headerConfig).then();
+};
+
+export { buildHeader };

package/bin/v6/commands/initJs/template/v4/FormLoad/DomContentLoaded/buildMenuItem.js

@@ -0,0 +1,121 @@
+// orchestrator
+export const buildMenuItem = ({
+    inTextToShow,
+    inHtmlId,
+    inIconPaths,
+    inHref
+}) => {
+    const textToShow = inTextToShow;
+    const htmlId = inHtmlId;
+    const iconPaths = inIconPaths;
+
+    const li = createLi();
+    const a = createAnchor({ inHtmlId: htmlId, inHref });
+    const span = createLabel({ inTextToShow: textToShow });
+    const svg = createIcon({ inIconPaths: iconPaths });
+
+    a.append(svg, span);
+    li.appendChild(a);
+
+    return li;
+};
+
+const createLi = () => {
+    const htmlLi = document.createElement("li");
+
+    htmlLi.className = "md:text-center";
+
+    return htmlLi;
+
+
+};
+
+// createAnchor
+const createAnchor = ({ inHtmlId = "htmlId",
+    inHref = "#"
+}) => {
+    const a = document.createElement("a");
+    a.id = inHtmlId;
+    a.href = inHref;
+    // a.className =
+    //     "group flex items-center md:flex-col md:items-center gap-0 md:gap-1 cursor-pointer hover:bg-gray-700 px-2 py-1 rounded transition-colors duration-200 active:scale-95 focus:outline-none focus:ring-2 focus:ring-gray-500";
+
+    a.className = `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`;
+
+    return a;
+};
+
+// createLabel (no transform → no height change)
+const createLabel = ({ inTextToShow = "Menu1" }) => {
+    const span = document.createElement("span");
+    span.className =
+        "ml-3 text-right w-full text-base md:w-auto md:text-center md:ml-0 lg:text-lg";
+
+    span.textContent = inTextToShow;
+
+    return span;
+};
+
+// createIcon (safe transform: no layout shift)
+const createIcon = ({ inIconPaths = [] }) => {
+    const svg = document.createElementNS("http://www.w3.org/2000/svg", "svg");
+    // svg.setAttribute(
+    //     "class",
+    //     "w-6 h-6 md:order-1 md:mb-0 text-gray-400 group-hover:text-white transition-all duration-200 transform group-hover:scale-95 group-hover:-translate-y-0.5"
+    // );
+
+
+    svg.setAttribute(
+        "class",
+        "text-gray-300 w-6 h-6 lg:w-7 lg:h-7"
+    );
+
+
+    //                                 <svg class="text-gray-300 w-6 h-6 lg:w-7 lg:h-7" fill="none" stroke="currentColor"
+
+
+    svg.setAttribute("fill", "none");
+    svg.setAttribute("stroke", "currentColor");
+    svg.setAttribute("viewBox", "0 0 24 24");
+    svg.setAttribute("stroke-width", "1.5");
+    svg.setAttribute("stroke-linecap", "round");
+    svg.setAttribute("stroke-linejoin", "round");
+
+    inIconPaths.forEach(d => {
+        const path = document.createElementNS("http://www.w3.org/2000/svg", "path");
+        path.setAttribute("d", d);
+        svg.appendChild(path);
+    });
+
+    return svg;
+};
+
+
+
+//                         <li class="md:text-center">
+//                             <a id="LedgersHtmlId"
+//                              href="#" class="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">
+
+//                                 <!-- LEFT: ICON -->
+//                                 <svg class="text-gray-300 w-6 h-6 lg:w-7 lg:h-7" fill="none" stroke="currentColor"
+//                                     viewBox="0 0 24 24">
+//                                     <path
+//                                         d="M4 6h16M4 10h16M4 14h10M6 4h12a2 2 0 012 2v12a2 2 0 01-2 2H6a2 2 0 01-2-2V6a2 2 0 012-2z" />
+//                                 </svg>
+
+//                                 <!-- RIGHT: LABEL -->
+//                                 <span class="ml-3 text-right w-full text-base
+//                                      md:w-auto md:text-center md:ml-0
+//                                      lg:text-lg
+//                                      ">Ledgers</span>
+
+//                             </a>
+//                         </li>

package/bin/v6/commands/initJs/template/v4/FormLoad/DomContentLoaded/runAfterDomLoad.js

@@ -0,0 +1,7 @@
+import { buildHeader } from "./buildHeader.js";
+
+const runAfterDomLoad = () => {
+    buildHeader().then();
+};
+
+export { runAfterDomLoad };

package/bin/v6/commands/initJs/template/v4/FormLoad/DomContentLoaded/start.js

@@ -0,0 +1,7 @@
+import { runAfterDomLoad } from "./runAfterDomLoad.js";
+
+export function startDomContentLoaded() {
+    document.addEventListener("DOMContentLoaded", () => {
+        runAfterDomLoad();
+    });
+}

package/bin/v6/commands/initJs/template/v4/FormLoad/start.js

@@ -0,0 +1,5 @@
+import { startDomContentLoaded } from "./DomContentLoaded/start.js";
+
+export function startFormLoad() {
+    startDomContentLoaded();
+}

package/bin/v6/commands/initJs/template/v4/headers.json

@@ -0,0 +1,45 @@
+{
+    "items": [
+        {
+            "text": "ShowAll",
+            "id": "ShowAllHtmlId",
+            "icon": [
+                "M4 6h16",
+                "M4 10h16",
+                "M4 14h10",
+                "M6 4h12a2 2 0 012 2v12a2 2 0 01-2 2H6a2 2 0 01-2-2V6a2 2 0 012-2z"
+            ]
+        },
+        {
+            "text": "Search",
+            "id": "SearchHtmlId",
+            "icon": [
+                "M3 7l9 4 9-4",
+                "M3 7l9-4 9 4",
+                "M3 7v10l9 4 9-4V7",
+                "M12 11v10"
+            ]
+        },
+        {
+            "text": "Transactions",
+            "id": "1",
+            "icon": [
+                "M6 2h9l5 5v15a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2z",
+                "M14 2v6h6",
+                "M8 12h8",
+                "M8 16h8"
+            ],
+            "href": "../../Transactions/V7/Create/index.html"
+        },
+        {
+            "text": "FromTally",
+            "id": "ImportHtmlId",
+            "icon": [
+                "M4 6h16",
+                "M4 10h16",
+                "M4 14h10",
+                "M6 4h12a2 2 0 012 2v12a2 2 0 01-2 2H6a2 2 0 01-2-2V6a2 2 0 012-2z"
+            ]
+        }
+    ]
+}

package/bin/v6/commands/initJs/template/v4/start.js

@@ -0,0 +1,7 @@
+import { startFormLoad } from "./FormLoad/start.js";
+
+function startApp() {
+    startFormLoad();
+};
+
+startApp();

package/bin/{v4/commands/init.js → v6/commands/initJs.js}

@@ -1,11 +1,11 @@
-import { locateSource } from "./init/steps/locateSource.js";
-import { locateDestination } from "./init/steps/locateDestination.js";
+import { locateSource } from "./initJs/steps/locateSource.js";
+import { locateDestination } from "./initJs/steps/locateDestination.js";
 
-import { createProject } from "./init/steps/createProject.js";
-import { announce } from "./init/steps/announce.js";
+import { createProject } from "./initJs/steps/createProject.js";
+import { announce } from "./initJs/steps/announce.js";
 
-import resolveFolderName from "./init/steps/resolveFolderName.js";
-import checks from "./init/steps/checks.js";
+import resolveFolderName from "./initJs/steps/resolveFolderName.js";
+import checks from "./initJs/steps/checks.js";
 
 export default ({ folderName = "", toPath = process.cwd(), inAnnounce = true }) => {
     const fromChecks = checks({ toPath, inAnnounce });

package/bin/v6/core/getAllVersions.js

@@ -0,0 +1,12 @@
+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);
+
+export default map;

package/bin/v6/core/showUsage.js

@@ -0,0 +1,41 @@
+import allVersions from "./getAllVersions.js";
+
+/*
+KSchema CLI – Dynamic Usage Renderer
+*/
+
+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";
+
+    const commandLines = Object.entries(allVersions)
+        .map(([name]) =>
+            `  ${g}${name.padEnd(20)}${r}`
+        )
+        .join("\n");
+
+    const exampleLines = Object.entries(allVersions)
+        .map(([name]) =>
+            `  ${gray}npx @keshavsoft/express-todo ${name}${r}`
+        )
+        .join("\n");
+
+    console.log(`
+${c}🚀 express-todo v${version}${r}
+
+${y}Usage:${r}
+  ${g}npx @keshavsoft/express-todo${r} <command> [options]
+
+${y}Commands:${r}
+${commandLines}
+
+${y}Examples:${r}
+${exampleLines}
+
+${y}Tip:${r}
+  ${gray}npm i -g @keshavsoft/express-todo${r}
+`);
+}

package/bin/{v4 → v6}/start.js

@@ -10,6 +10,8 @@ const version = pkg.version;
 const run = async () => {
   const input = parseInput();
 
+  if (!input.cmd) return showUsage(version);
+
   if (input.action === "--help" || input.action === "-h" || input.action === "help") return showUsage(version);
 
   const command = resolveCommand(input.cmd);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "json-crud-ui-components",
-  "version": "1.5.2",
+  "version": "1.6.2",
   "description": "working on ui for our json crud using modules",
   "keywords": [
     "cli",

package/bin/v4/core/showUsage.js

@@ -1,49 +0,0 @@
-/*
-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}
-`);
-}