@mdaushi/kinetics-core 0.1.0-a

package/dist/controller.d.ts

@@ -0,0 +1,37 @@
+import { TableMeta, TableState } from "./types";
+export interface TableControllerOptions {
+    url?: string;
+}
+export declare class TableController {
+    private readonly state;
+    private readonly meta;
+    constructor(state: TableState, meta: TableMeta);
+    baseParams(): Record<string, unknown>;
+    /**
+     * Receive TanStack SortingState directly.
+     */
+    resolveSort(sorting: Array<{
+        id: string;
+        desc: boolean;
+    }>): Record<string, unknown>;
+    resolveSearchParams(search: string): Record<string, unknown>;
+    resolveFilterParams(key: string, value: unknown): Record<string, unknown>;
+    resolvePageParams(pageIndex: number, pageSize: number): Record<string, unknown>;
+    /**
+     * Receive TanStack PaginationState directly.
+     */
+    resolvePagination(pagination: {
+        pageIndex: number;
+        pageSize: number;
+    }): Record<string, unknown>;
+    /** TanStack SortingState from current server state */
+    toSorting(): Array<{
+        id: string;
+        desc: boolean;
+    }>;
+    /** TanStack PaginationState from current server state */
+    toPagination(): {
+        pageIndex: number;
+        pageSize: number;
+    };
+}

package/dist/controller.js

@@ -0,0 +1,97 @@
+// All the logic for constructing query params — no dependencies on React,
+// Vue, or any other framework. The adapter (React/Vue) simply calls this method
+// and passes the results to its respective router.
+export class TableController {
+    constructor(state, meta) {
+        this.state = state;
+        this.meta = meta;
+    }
+    // Base params from current state
+    baseParams() {
+        return {
+            sort: this.state.sort,
+            direction: this.state.direction,
+            search: this.state.search,
+            filters: this.state.filters,
+            per_page: this.state.per_page,
+        };
+    }
+    // Sort
+    // resolveSortParams(columnId: string | null): Record<string, unknown> {
+    //   if (!columnId) {
+    //     return { ...this.baseParams(), sort: null, direction: "asc", page: 1 };
+    //   }
+    //   const isSameColumn = this.state.sort === columnId;
+    //   const direction =
+    //     isSameColumn && this.state.direction === "asc" ? "desc" : "asc";
+    //   return {
+    //     ...this.baseParams(),
+    //     sort: columnId,
+    //     direction,
+    //     page: 1,
+    //   };
+    // }
+    /**
+     * Receive TanStack SortingState directly.
+     */
+    resolveSort(sorting) {
+        const col = sorting[0] ?? null;
+        return {
+            ...this.baseParams(),
+            sort: col?.id ?? null,
+            direction: col?.desc ? "desc" : "asc",
+            page: 1,
+        };
+    }
+    // Search
+    resolveSearchParams(search) {
+        return {
+            ...this.baseParams(),
+            search,
+            page: 1,
+        };
+    }
+    // Filter
+    resolveFilterParams(key, value) {
+        const filters = { ...this.state.filters };
+        if (value === null || value === "" || value === undefined) {
+            delete filters[key];
+        }
+        else {
+            filters[key] = value;
+        }
+        return {
+            ...this.baseParams(),
+            filters,
+            page: 1,
+        };
+    }
+    // Pagination
+    resolvePageParams(pageIndex, pageSize) {
+        return {
+            ...this.baseParams(),
+            page: pageIndex + 1, // TanStack 0-based -> Laravel 1-based
+            per_page: pageSize,
+        };
+    }
+    /**
+     * Receive TanStack PaginationState directly.
+     */
+    resolvePagination(pagination) {
+        return this.resolvePageParams(pagination.pageIndex, pagination.pageSize);
+    }
+    // Helpers
+    /** TanStack SortingState from current server state */
+    toSorting() {
+        if (!this.state.sort)
+            return [];
+        return [{ id: this.state.sort, desc: this.state.direction === "desc" }];
+    }
+    /** TanStack PaginationState from current server state */
+    toPagination() {
+        return {
+            pageIndex: this.meta.current_page - 1,
+            pageSize: this.meta.per_page,
+        };
+    }
+}

package/dist/formatter.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Formats the value according to the column type to display as a string.
+ * Adapters (React/Vue) can use this directly or override it on a per-column basis.
+ */
+export declare function formatValue(value: unknown, type: string): string;

package/dist/formatter.js

@@ -0,0 +1,21 @@
+/**
+ * Formats the value according to the column type to display as a string.
+ * Adapters (React/Vue) can use this directly or override it on a per-column basis.
+ */
+export function formatValue(value, type) {
+    if (value === null || value === undefined)
+        return "—";
+    switch (type) {
+        case "date":
+            return new Date(value).toLocaleDateString("id-ID");
+        case "datetime":
+            return new Date(value).toLocaleString("id-ID");
+        case "currency":
+            return new Intl.NumberFormat("id-ID", {
+                style: "currency",
+                currency: "IDR",
+            }).format(value);
+        default:
+            return String(value);
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export type { TableColumn, TableMeta, TableState, TableProps, TableAction, TableActionConfirm, TableActionGroup, ActionItem, } from "./types";
+export { TableController } from "./controller";
+export type { TableControllerOptions } from "./controller";
+export { formatValue } from "./formatter";

package/dist/index.js

@@ -0,0 +1,2 @@
+export { TableController } from "./controller";
+export { formatValue } from "./formatter";

package/dist/types.d.ts

@@ -0,0 +1,55 @@
+export interface TableColumn {
+    key: string;
+    label: string;
+    sortable: boolean;
+    searchable: boolean;
+    filterable: boolean;
+    filterOptions: string[] | Record<string, string>;
+    visible: boolean;
+    type: "text" | "date" | "datetime" | "currency" | "badge" | "actions" | string;
+}
+export interface TableMeta {
+    current_page: number;
+    last_page: number;
+    per_page: number;
+    total: number;
+    from: number | null;
+    to: number | null;
+}
+export interface TableState {
+    sort: string | null;
+    direction: "asc" | "desc";
+    search: string;
+    filters: Record<string, unknown>;
+    per_page: number;
+}
+export interface TableProps<TData = Record<string, unknown>> {
+    data: TData[];
+    columns: TableColumn[];
+    meta: TableMeta;
+    state: TableState;
+}
+export interface TableActionConfirm {
+    message: string;
+}
+export interface TableAction {
+    type: "action";
+    key: string;
+    label: string;
+    icon: string | null;
+    variant: "default" | "destructive";
+    href: string | null;
+    method: Method;
+    modal: boolean;
+    disabled: boolean;
+    confirm: TableActionConfirm | null;
+    meta: Record<string, unknown>;
+}
+export type Method = "get" | "post" | "put" | "patch" | "delete";
+export interface TableActionGroup {
+    type: "group";
+    label: string;
+    icon: string | null;
+    actions: TableAction[];
+}
+export type ActionItem = TableAction | TableActionGroup;

package/dist/types.js

@@ -0,0 +1,2 @@
+// Types — mirror of TableResult::toArray() in Laravel
+export {};

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@mdaushi/kinetics-core",
+  "version": "0.1.0-a",
+  "description": "Core utilities for Kinetics — Zero-Friction Tables for Inertia.js",
+  "keywords": [
+    "inertia",
+    "laravel",
+    "datatable",
+    "tanstack-table",
+    "kinetics"
+  ],
+  "homepage": "https://github.com/mdaushi/kinetics",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mdaushi/kinetics.git",
+    "directory": "packages/core"
+  },
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "typescript": "^5.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  }
+}