@starasia/admin 8.32.0 → 9.0.0

package/dist/router/index.d.ts

@@ -0,0 +1,2 @@
+export * from './types';
+export * from './provider';

package/dist/router/provider.d.ts

@@ -0,0 +1,17 @@
+import { default as React, PropsWithChildren } from 'react';
+import { StarasiaRouterAdapter } from './types';
+
+export type StarasiaRouterProviderProps = PropsWithChildren<{
+    adapter: StarasiaRouterAdapter;
+}>;
+/**
+ * Menyediakan router adapter ke seluruh komponen @starasia/admin.
+ * Biasanya tidak dipakai langsung — `<App routerAdapter={...} />` sudah
+ * membungkus app dengan provider ini secara otomatis.
+ */
+export declare const StarasiaRouterProvider: ({ adapter, children, }: StarasiaRouterProviderProps) => React.JSX.Element;
+/**
+ * Mengambil router adapter aktif. Throw kalau belum dipasang supaya
+ * kesalahan setup ketahuan lebih awal dan jelas.
+ */
+export declare const useRouterAdapter: () => StarasiaRouterAdapter;

package/dist/router/types.d.ts

@@ -0,0 +1,54 @@
+import { ComponentType, CSSProperties, ReactNode, MouseEvent } from 'react';
+
+/**
+ * Bentuk lokasi minimal yang dibutuhkan komponen @starasia/admin.
+ * Sengaja string-based (lowest common denominator) supaya bisa dipetakan
+ * dari router apa pun (react-router, TanStack Router, dll).
+ */
+export interface RouterLocation {
+    pathname: string;
+    search: string;
+    hash: string;
+    state?: unknown;
+    key?: string;
+}
+/** Target navigasi: path string, atau angka untuk history back/forward. */
+export type NavigateTo = string | number;
+export interface NavigateOptions {
+    replace?: boolean;
+    state?: unknown;
+}
+export type SearchParamsInit = string | URLSearchParams | Record<string, string | string[]> | Array<[string, string]>;
+/**
+ * Pengganti router-agnostic untuk `SetURLSearchParams` milik react-router.
+ * Signature dibuat kompatibel dengan pemakaian existing
+ * (`setSearchParams({ ...obj })` dan `setSearchParams(prev => ...)`).
+ */
+export type SetSearchParams = (next?: SearchParamsInit | ((prev: URLSearchParams) => SearchParamsInit), opts?: NavigateOptions) => void;
+export interface RouterLinkProps {
+    to: string;
+    replace?: boolean;
+    state?: unknown;
+    style?: CSSProperties;
+    className?: string;
+    children?: ReactNode;
+    onClick?: (event: MouseEvent<HTMLAnchorElement>) => void;
+    [key: string]: unknown;
+}
+/**
+ * Kontrak router yang dikonsumsi @starasia/admin. Consumer menyediakan
+ * implementasinya lewat `<App routerAdapter={...} />` atau
+ * `<StarasiaRouterProvider adapter={...}>`.
+ *
+ * Adapter siap pakai:
+ *   import { reactRouterAdapter } from "@starasia/admin/adapters/react-router";
+ *   import { tanstackAdapter }    from "@starasia/admin/adapters/tanstack";
+ */
+export interface StarasiaRouterAdapter {
+    useLocation: () => RouterLocation;
+    useParams: () => Record<string, string | undefined>;
+    useSearchParams: () => [URLSearchParams, SetSearchParams];
+    useNavigate: () => (to: NavigateTo, opts?: NavigateOptions) => void;
+    Link: ComponentType<RouterLinkProps>;
+    Outlet: ComponentType;
+}

package/package.json

@@ -1,11 +1,30 @@
 {
   "name": "@starasia/admin",
-  "version": "8.32.0",
+  "version": "9.0.0",
   "description": "Core Admin Dashboard for starasia UI",
   "author": "Rizki Izzul Haq",
   "main": "dist/index.umd.js",
   "module": "dist/index.es.js",
   "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.es.js",
+      "require": "./dist/index.umd.js"
+    },
+    "./adapters/react-router": {
+      "types": "./dist/adapters/react-router.d.ts",
+      "import": "./dist/adapters/react-router.es.js",
+      "require": "./dist/adapters/react-router.cjs.js"
+    },
+    "./adapters/tanstack": {
+      "types": "./dist/adapters/tanstack.d.ts",
+      "import": "./dist/adapters/tanstack.es.js",
+      "require": "./dist/adapters/tanstack.cjs.js"
+    },
+    "./dist/*": "./dist/*",
+    "./package.json": "./package.json"
+  },
   "files": [
     "dist"
   ],
@@ -18,7 +37,16 @@
   "peerDependencies": {
     "react": ">=18.2.0 <20.0.0",
     "react-dom": ">=18.2.0 <20.0.0",
-    "react-router": ">=7"
+    "react-router": ">=7",
+    "@tanstack/react-router": ">=1"
+  },
+  "peerDependenciesMeta": {
+    "react-router": {
+      "optional": true
+    },
+    "@tanstack/react-router": {
+      "optional": true
+    }
   },
   "dependencies": {
     "@starasia/accordion": "3.1.1",
@@ -60,12 +88,14 @@
     "react-easy-crop": "^5.5.6"
   },
   "devDependencies": {
+    "@tanstack/react-router": "^1.58.0",
     "@types/node": "^20.19.26",
     "@types/react": "^18.3.27",
     "@types/react-dom": "^18.3.7",
     "@vitejs/plugin-react": "^4.7.0",
     "react": "18.3.1",
     "react-dom": "18.3.1",
+    "react-router": "^7.0.0",
     "tsconfig-paths": "^4.2.0",
     "typescript": "^5.9.3",
     "vite": "^5.4.21",
@@ -73,6 +103,6 @@
   },
   "scripts": {
     "dev": "vite --config vite.config.ts --port 3002",
-    "build": "vite build --config vite.config.ts"
+    "build": "vite build --config vite.config.ts && vite build --config vite.adapters.config.ts"
   }
 }