headless-table-core 0.1.6

package/README.md

@@ -0,0 +1,148 @@
+# smart-table-core
+
+Simple, headless utilities for building **searchable, sortable, paginated tables**.
+
+No UI.  
+No framework lock-in.  
+Works with Angular, React, Vue, or plain JavaScript.
+
+---
+
+## Install
+
+```bash
+npm install @qureshiowais91/smart-table-core
+````
+
+---
+
+## Import
+
+```ts
+import {
+  getValue,
+  sortData,
+  filterData,
+  paginate
+} from "@qureshiowais91/smart-table-core";
+```
+
+---
+
+## Example data
+
+```ts
+const users = [
+  {
+    id: 1,
+    user: { name: "Ali", profile: { age: 28 } },
+    email: "ali@gmail.com"
+  },
+  {
+    id: 2,
+    user: { name: "Zara", profile: { age: 24 } },
+    email: "zara@gmail.com"
+  }
+];
+```
+
+---
+
+## getValue – safe nested access
+
+```ts
+getValue(users[0], "user.name");          // "Ali"
+getValue(users[0], "user.profile.age");  // 28
+getValue(users[0], "user.address.city"); // ""
+```
+
+With fallback:
+
+```ts
+getValue(users[0], "user.address.city", "N/A");
+```
+
+---
+
+## sortData – sort by column
+
+```ts
+sortData(users, "user.name", "asc");
+sortData(users, "user.profile.age", "desc");
+```
+
+* Non-mutating
+* Supports nested keys
+
+---
+
+## filterData – global search
+
+```ts
+filterData(users, "ali", ["user.name", "email"]);
+```
+
+* Case-insensitive
+* Searches multiple fields
+
+---
+
+## paginate – pagination logic
+
+```ts
+paginate(users, 1, 10);
+```
+
+Returns:
+
+```ts
+{
+  data: [...],
+  total: number,
+  page: number,
+  limit: number
+}
+```
+
+---
+
+## Recommended usage (real flow)
+
+```ts
+let rows = users;
+
+rows = filterData(rows, searchText, ["user.name", "email"]);
+rows = sortData(rows, sortKey, sortOrder);
+const result = paginate(rows, page, limit);
+
+// render result.data
+```
+
+---
+
+## Notes
+
+* This library handles **logic only**
+* You control UI and rendering
+* Original data is never mutated
+
+---
+
+## License
+
+MIT
+
+```
+
+---
+
+### This README is **good enough to ship**.
+
+If you want next:
+- Ultra-short README for npm page
+- Examples folder
+- React hook version
+- Angular wrapper
+
+Just tell me.
+

package/dist/filterData.d.ts

@@ -0,0 +1 @@
+export declare function filterData<T>(data: T[], search: string, keys: string[]): T[];

package/dist/filterData.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.filterData = filterData;
+const getValue_1 = require("./getValue");
+function filterData(data, search, keys) {
+    if (!search)
+        return data;
+    const query = search.toLowerCase();
+    return data.filter(row => keys.some(key => String((0, getValue_1.getValue)(row, key))
+        .toLowerCase()
+        .includes(query)));
+}

package/dist/getValue.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Safely get nested object value using dot notation
+ * Example: getValue(row, "user.profile.name")
+ */
+export declare function getValue<T = any>(obj: Record<string, any>, path: string, fallback?: T): T;

package/dist/getValue.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getValue = getValue;
+/**
+ * Safely get nested object value using dot notation
+ * Example: getValue(row, "user.profile.name")
+ */
+function getValue(obj, path, fallback = "") {
+    if (!obj || !path)
+        return fallback;
+    return path.split(".").reduce((acc, key) => {
+        return acc && acc[key] !== undefined ? acc[key] : fallback;
+    }, obj);
+}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./getValue";
+export * from "./sortData";
+export * from "./filterData";
+export * from "./paginate";

package/dist/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./getValue"), exports);
+__exportStar(require("./sortData"), exports);
+__exportStar(require("./filterData"), exports);
+__exportStar(require("./paginate"), exports);

package/dist/paginate.d.ts

@@ -0,0 +1,6 @@
+export declare function paginate<T>(data: T[], page: number, limit: number): {
+    data: T[];
+    total: number;
+    page: number;
+    limit: number;
+};

package/dist/paginate.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.paginate = paginate;
+function paginate(data, page, limit) {
+    const start = (page - 1) * limit;
+    const end = start + limit;
+    return {
+        data: data.slice(start, end),
+        total: data.length,
+        page,
+        limit
+    };
+}

package/dist/sortData.d.ts

@@ -0,0 +1 @@
+export declare function sortData<T>(data: T[], key: string, order?: "asc" | "desc"): T[];

package/dist/sortData.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sortData = sortData;
+const getValue_1 = require("./getValue");
+function sortData(data, key, order = "asc") {
+    return [...data].sort((a, b) => {
+        const aVal = (0, getValue_1.getValue)(a, key);
+        const bVal = (0, getValue_1.getValue)(b, key);
+        if (aVal > bVal)
+            return order === "asc" ? 1 : -1;
+        if (aVal < bVal)
+            return order === "asc" ? -1 : 1;
+        return 0;
+    });
+}

package/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "headless-table-core",
+  "version": "0.1.6",
+  "description": "Headless utilities for building sortable, searchable tables",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc"
+  },
+  "license": "MIT",
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  }
+}