@starasia/admin 8.31.1 → 9.0.0

package/dist/adapters/react-router.cjs.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const u=require("react-router");function s(e){const t=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(e){for(const r in e)if(r!=="default"){const n=Object.getOwnPropertyDescriptor(e,r);Object.defineProperty(t,r,n.get?n:{enumerable:!0,get:()=>e[r]})}}return t.default=e,Object.freeze(t)}const a=s(u),o={useLocation:()=>a.useLocation(),useParams:()=>a.useParams(),useSearchParams:()=>{const[e,t]=a.useSearchParams();return[e,t]},useNavigate:()=>{const e=a.useNavigate();return(t,r)=>{if(typeof t=="number"){e(t);return}e(t,r)}},Link:a.Link,Outlet:a.Outlet};exports.reactRouterAdapter=o;

package/dist/adapters/react-router.d.ts

@@ -0,0 +1,12 @@
+import { StarasiaRouterAdapter } from '../router/types';
+
+/**
+ * Adapter router untuk react-router (>=7).
+ * Hampir passthrough — react-router sudah punya semua primitive yang
+ * dibutuhkan kontrak StarasiaRouterAdapter.
+ *
+ * @example
+ * import { reactRouterAdapter } from "@starasia/admin/adapters/react-router";
+ * <App routerAdapter={reactRouterAdapter} router={<RouterProvider router={router} />} />
+ */
+export declare const reactRouterAdapter: StarasiaRouterAdapter;

package/dist/adapters/react-router.es.js

@@ -0,0 +1,24 @@
+import * as a from "react-router";
+const s = {
+  useLocation: () => a.useLocation(),
+  useParams: () => a.useParams(),
+  useSearchParams: () => {
+    const [r, e] = a.useSearchParams();
+    return [r, e];
+  },
+  useNavigate: () => {
+    const r = a.useNavigate();
+    return (e, t) => {
+      if (typeof e == "number") {
+        r(e);
+        return;
+      }
+      r(e, t);
+    };
+  },
+  Link: a.Link,
+  Outlet: a.Outlet
+};
+export {
+  s as reactRouterAdapter
+};

package/dist/adapters/tanstack.cjs.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const l=require("react"),r=require("@tanstack/react-router"),S={useLocation:()=>{const e=r.useLocation();return{pathname:e.pathname,search:e.searchStr??"",hash:e.hash??"",state:e.state}},useParams:()=>r.useParams({strict:!1}),useSearchParams:()=>{const e=r.useNavigate(),a=r.useLocation().searchStr??"",o=new URLSearchParams(a);return[o,(c,s)=>{const n=typeof c=="function"?c(new URLSearchParams(o)):c,i=n instanceof URLSearchParams?n:new URLSearchParams(n),u={};i.forEach((h,m)=>{u[m]=h}),e({to:".",search:u,replace:s==null?void 0:s.replace})}]},useNavigate:()=>{const e=r.useNavigate();return(t,a)=>{if(typeof t=="number"){window.history.go(t);return}e({to:t,replace:a==null?void 0:a.replace})}},Link:({to:e,children:t,...a})=>l.createElement(r.Link,{to:e,...a},t),Outlet:r.Outlet};exports.tanstackAdapter=S;

package/dist/adapters/tanstack.d.ts

@@ -0,0 +1,20 @@
+import { StarasiaRouterAdapter } from '../router/types';
+
+/**
+ * Adapter router untuk TanStack Router (>=1).
+ *
+ * Karena kontrak @starasia/admin string-based (untyped), adapter ini
+ * "menurunkan" API typed TanStack ke string:
+ *   - useParams / useSearch pakai `{ strict: false }`
+ *   - navigasi pakai `to: "."` (current route) + search object
+ *
+ * ⚠️ Catatan untuk consumer TanStack:
+ *   Route yang memakai query-param via FilterBar/useTabState/useRouteInfo
+ *   sebaiknya punya `validateSearch` yang permisif (mengizinkan key dinamis),
+ *   karena DS menulis search param secara dinamis.
+ *
+ * @example
+ * import { tanstackAdapter } from "@starasia/admin/adapters/tanstack";
+ * <App routerAdapter={tanstackAdapter} router={<RouterProvider router={router} />} />
+ */
+export declare const tanstackAdapter: StarasiaRouterAdapter;

package/dist/adapters/tanstack.es.js

@@ -0,0 +1,42 @@
+import P from "react";
+import { Outlet as S, Link as f, useNavigate as o, useLocation as i, useParams as L } from "@tanstack/react-router";
+const R = {
+  useLocation: () => {
+    const a = i();
+    return {
+      pathname: a.pathname,
+      search: a.searchStr ?? "",
+      hash: a.hash ?? "",
+      state: a.state
+    };
+  },
+  useParams: () => L({ strict: !1 }),
+  useSearchParams: () => {
+    const a = o(), e = i().searchStr ?? "", n = new URLSearchParams(e);
+    return [n, (t, c) => {
+      const s = typeof t == "function" ? t(new URLSearchParams(n)) : t, m = s instanceof URLSearchParams ? s : new URLSearchParams(s), h = {};
+      m.forEach((u, l) => {
+        h[l] = u;
+      }), a({
+        to: ".",
+        search: h,
+        replace: c == null ? void 0 : c.replace
+      });
+    }];
+  },
+  useNavigate: () => {
+    const a = o();
+    return (r, e) => {
+      if (typeof r == "number") {
+        window.history.go(r);
+        return;
+      }
+      a({ to: r, replace: e == null ? void 0 : e.replace });
+    };
+  },
+  Link: ({ to: a, children: r, ...e }) => P.createElement(f, { to: a, ...e }, r),
+  Outlet: S
+};
+export {
+  R as tanstackAdapter
+};

package/dist/components/AdvanceFilterBar/types.d.ts

@@ -1,4 +1,4 @@
-import { SetURLSearchParams } from 'react-router';
+import { SetSearchParams } from '../../router/types';
 import { FilterConfig } from './FilterDrawer';
 import { IconName } from '@starasia/icon';
 
@@ -32,7 +32,7 @@ export type ChangeHandler = (params: {
     name?: string;
     type?: InputType;
     withSearchParam?: boolean;
-    setSearchParams: SetURLSearchParams;
+    setSearchParams: SetSearchParams;
     searchQueries: Record<string, string>;
     dropdownSearchKey?: string;
     filterKey?: string;

package/dist/components/PageLayout/index.d.ts

@@ -43,6 +43,12 @@ export interface PageLayoutProps extends PropsWithChildren {
     titleTag?: string;
     header?: boolean;
     headerBorder?: boolean;
+    /**
+     * Disable the page enter animation (`pageLayoutEnter` fade/slide on mount).
+     * Defaults to `false`. Set `true` when the page mounts/unmounts frequently
+     * (e.g. tab switches) or when the slide-in fights another transition.
+     */
+    disableAnimation?: boolean;
     /**
      * Extra header rows rendered below the main header. Each row gets the same
      * padding as the main header (paddingBlock "sm" / paddingInline "md"), an
@@ -56,5 +62,5 @@ export interface PageLayoutProps extends PropsWithChildren {
     containerProps?: Omit<BoxProps, "variant" | "gap">;
     headerProps?: Omit<BoxProps, "gap">;
 }
-export declare const PageLayout: React.MemoExoticComponent<({ backButton, title, titleIcon, titleTag, children, header, headerBorder, subHeaders, action, titleTagProps, containerProps, headerProps, }: PageLayoutProps) => React.JSX.Element>;
+export declare const PageLayout: React.MemoExoticComponent<({ backButton, title, titleIcon, titleTag, children, header, headerBorder, disableAnimation, subHeaders, action, titleTagProps, containerProps, headerProps, }: PageLayoutProps) => React.JSX.Element>;
 export {};

package/dist/entries/App/index.d.ts

@@ -1,9 +1,17 @@
 import { default as React, PropsWithChildren } from 'react';
 import { SidebarMenuItem, SidebarMenus } from '../../types';
 import { ThemeObject } from '@starasia/theme';
+import { StarasiaRouterAdapter } from '../../router';
 
 interface AppProps extends PropsWithChildren {
     router: React.ReactNode;
+    /**
+     * Router adapter — menghubungkan komponen @starasia/admin ke router consumer.
+     * Wajib. Import dari:
+     *   '@starasia/admin/adapters/react-router' → reactRouterAdapter
+     *   '@starasia/admin/adapters/tanstack'     → tanstackAdapter
+     */
+    routerAdapter: StarasiaRouterAdapter;
     menus: SidebarMenus;
     menuBottom?: SidebarMenuItem[];
     logo: string;
@@ -15,8 +23,8 @@ interface AppProps extends PropsWithChildren {
         photoURL?: string;
     } | null;
 }
-export declare const AppComponent: ({ router, menus, menuBottom, logo, appName, initialUserData, theme, }: AppProps) => React.JSX.Element;
-export declare const App: React.MemoExoticComponent<({ router, menus, menuBottom, logo, appName, initialUserData, theme, }: AppProps) => React.JSX.Element>;
+export declare const AppComponent: ({ router, routerAdapter, menus, menuBottom, logo, appName, initialUserData, theme, }: AppProps) => React.JSX.Element;
+export declare const App: React.MemoExoticComponent<({ router, routerAdapter, menus, menuBottom, logo, appName, initialUserData, theme, }: AppProps) => React.JSX.Element>;
 export * from './hooks';
 export * from './context';
 export * from './sidebarBadges';

package/dist/hooks/useRouteInfo.d.ts

@@ -1,14 +1,14 @@
-import { useSearchParams, Location } from 'react-router';
+import { RouterLocation, SetSearchParams } from '../router/types';
 
 type UseRouteInfoReturn = {
-    setSearchParams: ReturnType<typeof useSearchParams>[1];
+    setSearchParams: SetSearchParams;
     searchParams: URLSearchParams;
     searchQueries: Record<string, string>;
     isHasQuery: (key: string, value: string) => boolean;
     getQueryParam: (key: string) => string | null;
     getRouteParam: (key: string) => string | undefined;
     params: Record<string, string | undefined>;
-    location: Location;
+    location: RouterLocation;
     id?: string;
     hasId: boolean;
 };

package/dist/hooks/useRouteParams.d.ts

@@ -1,14 +1,14 @@
-import { useSearchParams, Location } from 'react-router';
+import { RouterLocation, SetSearchParams } from '../router/types';
 
 type UseRouteParamsReturn = {
-    setSearchParams: ReturnType<typeof useSearchParams>[1];
+    setSearchParams: SetSearchParams;
     searchParams: URLSearchParams;
     searchQueries: Record<string, string>;
     isHasQuery: (key: string, value: string) => boolean;
     getQueryParam: (key: string) => string | null;
     getRouteParam: (key: string) => string | undefined;
     params: Record<string, string | undefined>;
-    location: Location;
+    location: RouterLocation;
     id?: string;
     hasId: boolean;
 };