@skalfa/skalfa-app-core 1.0.0 → 1.0.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Skalfa
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,63 @@
+<p align="center">
+  <img src="https://skalfa.sejedigital.com/images/logo-skalfa.png" alt="Skalfa Logo" width="300" />
+</p>
+
+# @skalfa/skalfa-app-core
+
+> Core framework engine and foundational utility hook library for the Skalfa Next.js frontend.
+
+---
+
+## About this Package
+
+This package is part of the **Skalfa Framework**, a premium development ecosystem designed to build high-performance, modular web applications and APIs.
+
+### Usage Scope & Standalone Status
+> 🔒 **Skalfa Ecosystem Integration:** This package is designed to run **integrated within the Skalfa ecosystem** (such as Skalfa API or Skalfa App). It relies on the global service registry and core framework abstractions to operate.
+
+---
+
+## Documentation
+
+See the usage documentation at [Documentation](https://skalfa.sejedigital.com).
+
+---
+
+## Installation
+
+You can install this package using your preferred package manager:
+
+```bash
+# Using npm
+npm install @skalfa/skalfa-app-core
+
+# Using bun
+bun add @skalfa/skalfa-app-core
+```
+
+---
+
+## Pre-installed Dependencies
+
+The following key dependencies are packaged and managed within this project:
+
+| Dependency | Scope | Version |
+| :--- | :--- | :--- |
+| `axios` | runtime | `^1.12.0` |
+| `clsx` | runtime | `^2.1.1` |
+| `crypto-js` | runtime | `^4.2.0` |
+| `js-cookie` | runtime | `^3.0.5` |
+| `lz-string` | runtime | `^1.5.0` |
+| `moment` | runtime | `^2.30.1` |
+| `tailwind-merge` | runtime | `^3.0.2` |
+| `validator` | runtime | `^13.15.22` |
+| `@types/node` | development | `^20.0.0` |
+| `@types/react` | development | `^19.0.0` |
+| `@types/react-dom` | development | `^19.0.0` |
+| `typescript` | development | `^6.0.3` |
+
+---
+
+## License
+
+This package is licensed under the **MIT License**. For full license text, see the [LICENSE](LICENSE) file.

package/dist/{api.util.js → api/api.js}

@@ -2,8 +2,8 @@
 import { useEffect, useState } from "react";
 import axios from "axios";
 import { redirect } from "next/navigation";
-import { auth } from "./auth.util";
-import { cavity } from "./cavity.util";
+import { auth } from "../auth";
+import { cavity } from "../cavity";
 // =========================>
 // ## Build auth bearer
 // =========================>

package/dist/api/index.d.ts

@@ -0,0 +1 @@
+export * from "./api";

package/dist/api/index.js

@@ -0,0 +1 @@
+export * from "./api";

package/dist/{auth.util.js → auth/auth.js}

@@ -1,6 +1,6 @@
 import { redirect } from 'next/navigation';
 import Cookies from 'js-cookie';
-import { encryption } from './encryption.util';
+import { encryption } from '../encryption';
 export const auth = {
     // ==============================>
     // ## Path of login page

package/dist/auth/index.d.ts

@@ -0,0 +1 @@
+export * from "./auth";

package/dist/auth/index.js

@@ -0,0 +1 @@
+export * from "./auth";

package/dist/{cavity.util.js → cavity/cavity.js}

@@ -1,5 +1,5 @@
-import { registry } from "./registry";
-import { logger } from "./commands/logger";
+import { registry } from "../registry";
+import { logger } from "../logger";
 const name = String(process.env.NEXT_PUBLIC_APP_NAME || "").toLowerCase().trim().replace(/[^\w\s-]/g, "").replace(/[\s_-]+/g, "-").replace(/^-+|-+$/g, "") + ".cavity";
 const storeName = "cache";
 const version = 1;

package/dist/cavity/index.d.ts

@@ -0,0 +1 @@
+export * from "./cavity";

package/dist/cavity/index.js

@@ -0,0 +1 @@
+export * from "./cavity";

package/dist/cn/index.d.ts

@@ -0,0 +1 @@
+export * from "./cn";

package/dist/cn/index.js

@@ -0,0 +1 @@
+export * from "./cn";

package/dist/commands/blueprint.js

@@ -1,7 +1,7 @@
 import fs from "fs";
 import path from "path";
-import { logger } from "./logger";
-import { conversion } from "../conversion.util";
+import { conversion } from "../conversion/conversion";
+import { logger } from "../logger";
 const renderJS = (value, indent = 0) => {
     const pad = " ".repeat(indent);
     if (Array.isArray(value)) {

package/dist/commands/cli.d.ts

@@ -0,0 +1,6 @@
+import { Command } from "commander";
+export declare const usePdfCommand: Command;
+export declare const blueprintCommand: Command;
+export declare const barrelsCommand: Command;
+export declare const watchBarrelsCommand: Command;
+export declare function runCli(): void;

package/dist/commands/cli.js

@@ -0,0 +1,107 @@
+import { Command } from "commander";
+import { usePdf } from "./use-pdf";
+import { blueprint } from "./blueprint";
+import { logger } from "../logger";
+import fs from "fs";
+import path from "path";
+import { exec, execSync } from "child_process";
+// =====================================>
+// ## Command: use-pdf
+// =====================================>
+export const usePdfCommand = new Command("use-pdf")
+    .description("Copy pdf.worker.min.mjs ke folder public/")
+    .action(() => {
+    usePdf();
+});
+// =====================================>
+// ## Command: blueprint
+// =====================================>
+export const blueprintCommand = new Command("blueprint")
+    .description("Generate blueprint")
+    .option("-o, --only <names...>", "Run only specific blueprints")
+    .action(async (opts) => {
+    await blueprint({ only: opts.only });
+    logger.info("Success run all blueprints!");
+    process.exit(0);
+});
+// =====================================>
+// ## Command: barrels (run once)
+// =====================================>
+export const barrelsCommand = new Command("barrels")
+    .description("Generate barrels auto-imports using barrelsby")
+    .action(() => {
+    const rootDir = process.cwd();
+    const configPath = path.join(rootDir, "barrels.json");
+    if (!fs.existsSync(configPath)) {
+        logger.error("barrels.json config file not found at project root");
+        process.exit(1);
+    }
+    logger.info("Generating barrels...");
+    try {
+        execSync("npx barrelsby -c barrels.json", { cwd: rootDir, stdio: "inherit" });
+        logger.info("Barrels successfully generated!");
+        process.exit(0);
+    }
+    catch (err) {
+        logger.error(`Failed to generate barrels: ${err}`);
+        process.exit(1);
+    }
+});
+// =====================================>
+// ## Command: watch:barrels (file watcher)
+// =====================================>
+export const watchBarrelsCommand = new Command("watch:barrels")
+    .description("Watch directories and update barrels automatically on file changes")
+    .action(async () => {
+    const rootDir = process.cwd();
+    const configPath = path.join(rootDir, "barrels.json");
+    if (!fs.existsSync(configPath)) {
+        logger.error("barrels.json config file not found at project root");
+        process.exit(1);
+    }
+    let config = {};
+    try {
+        const configText = fs.readFileSync(configPath, "utf8");
+        config = JSON.parse(configText);
+    }
+    catch (err) {
+        logger.error(`Failed to parse barrels.json: ${err}`);
+        process.exit(1);
+    }
+    const directories = Array.isArray(config.directory) ? config.directory : [config.directory];
+    // Run barrels once at startup
+    logger.info("Initializing barrels generation...");
+    try {
+        execSync("npx barrelsby -c barrels.json", { cwd: rootDir });
+    }
+    catch { }
+    directories.forEach((dir) => {
+        const absoluteDir = path.join(rootDir, dir);
+        if (!fs.existsSync(absoluteDir)) {
+            logger.error(`Barrels error: ${absoluteDir} directory not found`);
+            return;
+        }
+        fs.watch(absoluteDir, { recursive: true }, (_, filename) => {
+            if (filename && (filename.endsWith(".ts") || filename.endsWith(".tsx")) && filename !== "index.ts") {
+                exec("npx barrelsby -c barrels.json", { cwd: rootDir }, (error) => {
+                    if (error) {
+                        logger.error(`Failed to update barrels for ${dir}: ${error.message}`);
+                    }
+                    else {
+                        logger.info(`Barrels updated: ${path.join(dir, "index.ts")}`);
+                    }
+                });
+            }
+        });
+    });
+    logger.start("Barrels watcher running for: " + directories.join(", "));
+});
+export function runCli() {
+    const program = new Command();
+    program.name("skalfa").description("Skalfa-app CLI").version("1.0.0");
+    program.addCommand(usePdfCommand);
+    program.addCommand(blueprintCommand);
+    program.addCommand(barrelsCommand);
+    program.addCommand(watchBarrelsCommand);
+    program.parse(process.argv);
+}

package/dist/commands/use-pdf.js

@@ -1,7 +1,7 @@
 import fs from "fs";
 import path from "path";
 import { fileURLToPath } from "url";
-import { logger } from "./logger";
+import { logger } from "../logger";
 export function usePdf() {
     const __filename = fileURLToPath(import.meta.url);
     const __dirname = path.dirname(__filename);

package/dist/conversion/index.d.ts

@@ -0,0 +1 @@
+export * from "./conversion";

package/dist/conversion/index.js

@@ -0,0 +1 @@
+export * from "./conversion";

package/dist/encryption/index.d.ts

@@ -0,0 +1 @@
+export * from "./encryption";

package/dist/encryption/index.js

@@ -0,0 +1 @@
+export * from "./encryption";

package/dist/{form.util.d.ts → form/form.d.ts}

@@ -1,5 +1,5 @@
-import { ValidationRules } from "./validation.util";
-import { ApiType } from "./api.util";
+import { ValidationRules } from "../validation";
+import { ApiType } from "../api";
 type DBSchema = any;
 export interface FormRegisterType {
     name: string;

package/dist/{form.util.js → form/form.js}

@@ -1,8 +1,8 @@
 "use client";
 import { useReducer, useEffect, useState } from "react";
-import { registry } from "./registry";
-import { validation } from "./validation.util";
-import { api } from "./api.util";
+import { registry } from "../registry";
+import { validation } from "../validation";
+import { api } from "../api";
 const initialState = {
     formRegisters: [],
     formValues: [],

package/dist/form/index.d.ts

@@ -0,0 +1 @@
+export * from "./form";

package/dist/form/index.js

@@ -0,0 +1 @@
+export * from "./form";

package/dist/hooks.d.ts

@@ -0,0 +1,14 @@
+export declare const useResponsive: () => {
+    isXs: boolean;
+    isSm: boolean;
+    isMd: boolean;
+    isLg: boolean;
+    isXl: boolean;
+    isMobile: boolean;
+    isTablet: boolean;
+    isDesktop: boolean;
+    width: number;
+    height: number;
+};
+export declare function useKeyboardOpen(): boolean;
+export declare const useLazySearch: (keyword: string) => string[];

package/dist/hooks.js

@@ -0,0 +1,63 @@
+"use client";
+import { useEffect, useState } from "react";
+// ==============================>
+// ## Detect device size
+// ==============================>
+export const useResponsive = () => {
+    const [windowSize, setWindowSize] = useState({ width: 0, height: 0 });
+    useEffect(() => {
+        if (typeof window === "undefined")
+            return;
+        const handleResize = () => {
+            setWindowSize({ width: window.innerWidth, height: window.innerHeight });
+        };
+        handleResize();
+        window.addEventListener("resize", handleResize);
+        return () => window.removeEventListener("resize", handleResize);
+    }, []);
+    return {
+        isXs: windowSize.width < 640,
+        isSm: windowSize.width < 768,
+        isMd: windowSize.width < 1024,
+        isLg: windowSize.width < 1280,
+        isXl: windowSize.width >= 1280,
+        isMobile: windowSize.width < 768,
+        isTablet: windowSize.width >= 768 && windowSize.width < 1024,
+        isDesktop: windowSize.width >= 1024,
+        width: windowSize.width,
+        height: windowSize.height,
+    };
+};
+// ==============================>
+// ## Detect keyboard open
+// ==============================>
+export function useKeyboardOpen() {
+    const [isKeyboardOpen, setIsKeyboardOpen] = useState(false);
+    useEffect(() => {
+        const handleResize = () => {
+            if (window.visualViewport) {
+                const viewportHeight = window.visualViewport.height;
+                const windowHeight = window.innerHeight;
+                setIsKeyboardOpen(viewportHeight < windowHeight);
+            }
+        };
+        window.visualViewport?.addEventListener("resize", handleResize);
+        return () => window.visualViewport?.removeEventListener("resize", handleResize);
+    }, []);
+    return isKeyboardOpen;
+}
+// ==============================>
+// ## Search with typing reference
+// ==============================>
+export const useLazySearch = (keyword) => {
+    const [keywordSearch, setKeywordSearch] = useState("");
+    const [doSearch, setDoSearch] = useState(false);
+    useEffect(() => {
+        if (keyword != undefined) {
+            const delaySearch = setTimeout(() => setDoSearch(!doSearch), 500);
+            return () => clearTimeout(delaySearch);
+        }
+    }, [keyword]);
+    useEffect(() => setKeywordSearch(keyword), [doSearch]);
+    return [keywordSearch];
+};

package/dist/index.d.ts

@@ -1,27 +1,15 @@
-export * from "./api.util";
-export * from "./auth.util";
-export * from "./cavity.util";
-export * from "./encryption.util";
-export * from "./cn.util";
-export * from "./form.util";
-export * from "./resource.util";
-export * from "./table.util";
-export * from "./validation.util";
-export * from "./conversion.util";
-export * from "./shortcut.util";
-export * from "./commands/logger";
+export * from "./api";
+export * from "./auth";
+export * from "./cavity";
+export * from "./encryption";
+export * from "./cn";
+export * from "./form";
+export * from "./resource";
+export * from "./table";
+export * from "./validation";
+export * from "./conversion";
+export * from "./shortcut";
+export * from "./logger";
 export * from "./registry";
-export declare const useResponsive: () => {
-    isXs: boolean;
-    isSm: boolean;
-    isMd: boolean;
-    isLg: boolean;
-    isXl: boolean;
-    isMobile: boolean;
-    isTablet: boolean;
-    isDesktop: boolean;
-    width: number;
-    height: number;
-};
-export declare function useKeyboardOpen(): boolean;
-export declare const useLazySearch: (keyword: string) => string[];
+export * from "./commands/cli";
+export * from "./hooks";

package/dist/index.js

@@ -1,79 +1,18 @@
-"use client";
-import { useEffect, useState } from "react";
 // ==============================>
 // ## Export all from core utils
 // ==============================>
-export * from "./api.util";
-export * from "./auth.util";
-export * from "./cavity.util";
-export * from "./encryption.util";
-export * from "./cn.util";
-export * from "./form.util";
-export * from "./resource.util";
-export * from "./table.util";
-export * from "./validation.util";
-export * from "./conversion.util";
-export * from "./shortcut.util";
-export * from "./commands/logger";
+export * from "./api";
+export * from "./auth";
+export * from "./cavity";
+export * from "./encryption";
+export * from "./cn";
+export * from "./form";
+export * from "./resource";
+export * from "./table";
+export * from "./validation";
+export * from "./conversion";
+export * from "./shortcut";
+export * from "./logger";
 export * from "./registry";
-// ==============================>
-// ## Detect device size
-// ==============================>
-export const useResponsive = () => {
-    const [windowSize, setWindowSize] = useState({ width: 0, height: 0 });
-    useEffect(() => {
-        if (typeof window === "undefined")
-            return;
-        const handleResize = () => {
-            setWindowSize({ width: window.innerWidth, height: window.innerHeight });
-        };
-        handleResize();
-        window.addEventListener("resize", handleResize);
-        return () => window.removeEventListener("resize", handleResize);
-    }, []);
-    return {
-        isXs: windowSize.width < 640,
-        isSm: windowSize.width < 768,
-        isMd: windowSize.width < 1024,
-        isLg: windowSize.width < 1280,
-        isXl: windowSize.width >= 1280,
-        isMobile: windowSize.width < 768,
-        isTablet: windowSize.width >= 768 && windowSize.width < 1024,
-        isDesktop: windowSize.width >= 1024,
-        width: windowSize.width,
-        height: windowSize.height,
-    };
-};
-// ==============================>
-// ## Detect keyboard open
-// ==============================>
-export function useKeyboardOpen() {
-    const [isKeyboardOpen, setIsKeyboardOpen] = useState(false);
-    useEffect(() => {
-        const handleResize = () => {
-            if (window.visualViewport) {
-                const viewportHeight = window.visualViewport.height;
-                const windowHeight = window.innerHeight;
-                setIsKeyboardOpen(viewportHeight < windowHeight);
-            }
-        };
-        window.visualViewport?.addEventListener("resize", handleResize);
-        return () => window.visualViewport?.removeEventListener("resize", handleResize);
-    }, []);
-    return isKeyboardOpen;
-}
-// ==============================>
-// ## Search with typing reference
-// ==============================>
-export const useLazySearch = (keyword) => {
-    const [keywordSearch, setKeywordSearch] = useState("");
-    const [doSearch, setDoSearch] = useState(false);
-    useEffect(() => {
-        if (keyword != undefined) {
-            const delaySearch = setTimeout(() => setDoSearch(!doSearch), 500);
-            return () => clearTimeout(delaySearch);
-        }
-    }, [keyword]);
-    useEffect(() => setKeywordSearch(keyword), [doSearch]);
-    return [keywordSearch];
-};
+export * from "./commands/cli";
+export * from "./hooks";

package/dist/resource/index.d.ts

@@ -0,0 +1 @@
+export * from "./resource";

package/dist/resource/index.js

@@ -0,0 +1 @@
+export * from "./resource";

package/dist/{resource.util.d.ts → resource/resource.d.ts}

@@ -1,4 +1,4 @@
-import { ApiType } from "./api.util";
+import { ApiType } from "../api";
 export type ResourceParams = {
     page?: number;
     paginate?: number;

package/dist/{resource.util.js → resource/resource.js}

@@ -1,7 +1,7 @@
 "use client";
 import { useEffect, useState } from "react";
-import { useGetApi } from "./api.util";
-import { registry } from "./registry";
+import { useGetApi } from "../api";
+import { registry } from "../registry";
 export function useResource(props) {
     const isApi = "path" in props || "url" in props;
     const apiResult = useGetApi(isApi ? props : {}, !isApi);

package/dist/shortcut/index.d.ts

@@ -0,0 +1 @@
+export * from "./shortcut";

package/dist/shortcut/index.js

@@ -0,0 +1 @@
+export * from "./shortcut";

package/dist/table/index.d.ts

@@ -0,0 +1 @@
+export * from "./table";

package/dist/table/index.js

@@ -0,0 +1 @@
+export * from "./table";

package/dist/{table.util.d.ts → table/table.d.ts}

@@ -1,5 +1,5 @@
-import { ApiFilterType, ApiParamsType } from "./api.util";
-import { ResourceParams, UseResourceProps } from "./resource.util";
+import { ApiFilterType, ApiParamsType } from "../api";
+import { ResourceParams, UseResourceProps } from "../resource";
 export type TableStateType = {
     params?: ApiParamsType;
     data?: Record<string, any>[];

package/dist/{table.util.js → table/table.js}

@@ -2,8 +2,8 @@
 import { useEffect, useState } from "react";
 import { useRouter, useSearchParams } from "next/navigation";
 import LZString from "lz-string";
-import { conversion } from "./conversion.util";
-import { useResource } from "./resource.util";
+import { conversion } from "../conversion";
+import { useResource } from "../resource";
 export const useTable = (fetchControl, id = "", title = "", urlParam) => {
     const [state, setState] = useState({});
     const router = useRouter();

package/dist/validation/index.d.ts

@@ -0,0 +1 @@
+export * from "./validation";

package/dist/validation/index.js

@@ -0,0 +1 @@
+export * from "./validation";

package/dist/{validation.util.js → validation/validation.js}

@@ -1,7 +1,7 @@
 "use client";
 import { useEffect, useState } from "react";
 import validator from "validator";
-import { validationLangs } from "./langs";
+import { validationLangs } from "./validation.langs";
 // ==========================>
 // ## Validation core
 // ==========================>

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@skalfa/skalfa-app-core",
-  "version": "1.0.0",
-  "description": "Core utility functions for the Skalfa Next.js frontend framework.",
+  "version": "1.0.4",
+  "description": "Core framework engine and foundational utility hook library for the Skalfa Next.js frontend.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [
@@ -20,6 +20,7 @@
   "dependencies": {
     "axios": "^1.12.0",
     "clsx": "^2.1.1",
+    "commander": "^12.1.0",
     "crypto-js": "^4.2.0",
     "js-cookie": "^3.0.5",
     "lz-string": "^1.5.0",
@@ -42,6 +43,6 @@
     "next": "16.1.1",
     "react": "^19.2.1",
     "react-dom": "^19.2.1",
-    "typescript": "^5.0.0"
+    "typescript": "^6.0.3"
   }
 }

package/dist/commands/barrels.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/commands/barrels.js

@@ -1,22 +0,0 @@
-import path from "path";
-import fs from "fs";
-import { exec } from "child_process";
-import { logger } from "./logger";
-const rootDir = path.resolve();
-const configText = fs.readFileSync("barrels.json", "utf8");
-const config = JSON.parse(configText);
-const directories = Array.isArray(config.directory) ? config.directory : [config.directory];
-directories.forEach((dir) => {
-    const absoluteDir = path.join(rootDir, dir);
-    if (!fs.existsSync(absoluteDir)) {
-        logger.error(`Barrels error: ${absoluteDir} directory not found`);
-        return;
-    }
-    fs.watch(absoluteDir, { recursive: true }, (_, filename) => {
-        if (filename && (filename.endsWith(".ts") || filename.endsWith(".tsx")) && filename !== "index.ts") {
-            exec("npx barrelsby -c barrels.json", { cwd: rootDir });
-            logger.info("Barrels updated " + absoluteDir + "/index.ts");
-        }
-    });
-});
-logger.start("Barrels watched " + directories.join(", "));

package/dist/commands/light.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/commands/light.js

@@ -1,16 +0,0 @@
-import { Command } from "commander";
-import { usePdf } from "./use-pdf";
-import { blueprint } from "./blueprint";
-import { logger } from "./logger";
-const program = new Command();
-program.name("light").description("Next Light CLI").version("1.0.0");
-program.command("use-pdf").description("Copy pdf.worker.min.mjs ke folder public/").action(usePdf);
-program.command("blueprint")
-    .option("-o, --only <names...>", "Run only specific blueprints")
-    .description("Generate blueprint")
-    .action(async (opts) => {
-    await blueprint({ only: opts.only });
-    logger.info("Success run all blueprints!");
-    process.exit(0);
-});
-program.parse();

package/dist/langs/index.d.ts

@@ -1 +0,0 @@
-export * from "./validation.langs";

package/dist/langs/index.js

@@ -1 +0,0 @@
-export * from "./validation.langs";