@modern-admin/react 0.1.0

package/dist/router.d.ts

@@ -0,0 +1,82 @@
+import * as React from 'react';
+/**
+ * Provides the SPA mount basepath (e.g. `/admin`) to all navigation
+ * primitives (`Link`, `useNavigate`, `useRoute`). Set by
+ * `AdminRouterProvider` from `window.__MODERN_ADMIN__.basePath`. Defaults
+ * to `''` (root mount).
+ */
+export declare const BasepathContext: React.Context<string>;
+/** Returns the normalised basepath (never has a trailing slash; `''` at root). */
+export declare const useBasepath: () => string;
+/** URL-persisted state for the resource list page. */
+export interface ListQueryState {
+    page?: number;
+    perPage?: number;
+    sortBy?: string;
+    direction?: 'asc' | 'desc';
+    /** Per-column filter values keyed by property path. */
+    filters?: Record<string, string>;
+}
+export type Route = {
+    name: 'home';
+} | {
+    name: 'audit-log';
+} | {
+    name: 'list';
+    resourceId: string;
+    query?: ListQueryState;
+} | {
+    name: 'show';
+    resourceId: string;
+    recordId: string;
+} | {
+    name: 'edit';
+    resourceId: string;
+    recordId: string;
+} | {
+    name: 'new';
+    resourceId: string;
+}
+/** Settings hub. Sub-section selected via `section` (e.g. 'api-keys'). */
+ | {
+    name: 'settings';
+    section?: string;
+}
+/**
+ * Extension page registered by a Pro plugin via `registerExtensionRoute`.
+ * Renders at `/ext/<key>` inside the authenticated admin shell.
+ */
+ | {
+    name: 'extension';
+    key: string;
+};
+/** Map a TSR location (pathname + raw searchStr) to the canonical `Route`
+ *  union the rest of the codebase consumes. Pure — used both at render
+ *  time (via `useRoute`) and outside the React tree if ever needed. */
+export declare const parseLocation: (pathname: string, searchStr: string) => Route;
+/** Build a path URL for the given route. Pure — kept for tests and for
+ *  `<Link>` href generation. */
+export declare const buildHref: (route: Route) => string;
+/** Current canonical route, derived from the live TSR state.
+ *  When the router has a basepath, TSR strips it from `location.pathname`
+ *  before exposing it in state — so `parseLocation` sees only the
+ *  basepath-relative portion. */
+export declare const useRoute: () => Route;
+/** Imperative navigator. Same signature as the legacy custom router so
+ *  call-sites don't change. Goes through TSR history → re-routing flows
+ *  through TSR's lifecycle. */
+export declare const useNavigate: () => ((route: Route) => void);
+/** Open an in-app route in a new browser tab, honouring the admin's
+ *  `basepath`. `buildHref` returns a basepath-relative path, so we prepend
+ *  the basepath the same way `Link`/`useNavigate` do — otherwise the new tab
+ *  loads a URL outside the admin mount (e.g. `/resources/...` instead of
+ *  `/admin/resources/...`). */
+export declare const useOpenInNewTab: () => ((route: Route) => void);
+export interface LinkProps extends React.AnchorHTMLAttributes<HTMLAnchorElement> {
+    to: Route;
+}
+/** Anchor with path href + client-side navigation on plain left-click.
+ *  Modifier clicks (cmd/ctrl/shift/alt, middle button) fall through to
+ *  default browser behaviour so "open in new tab" keeps working. */
+export declare const Link: ({ to, onClick, ...rest }: LinkProps) => React.ReactElement;
+//# sourceMappingURL=router.d.ts.map

package/dist/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.tsx"],"names":[],"mappings":"AAkBA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAG9B;;;;;GAKG;AACH,eAAO,MAAM,eAAe,uBAAkC,CAAA;AAE9D,kFAAkF;AAClF,eAAO,MAAM,WAAW,QAAO,MAA2C,CAAA;AAE1E,sDAAsD;AACtD,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAA;IAC1B,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC;AAED,MAAM,MAAM,KAAK,GACb;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GACrB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,cAAc,CAAA;CAAE,GAC5D;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE;AACrC,0EAA0E;GACxE;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE;AACxC;;;GAGG;GACD;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAA;AA6CtC;;uEAEuE;AACvE,eAAO,MAAM,aAAa,GAAI,UAAU,MAAM,EAAE,WAAW,MAAM,KAAG,KAsBnE,CAAA;AAED;gCACgC;AAChC,eAAO,MAAM,SAAS,GAAI,OAAO,KAAK,KAAG,MAmBxC,CAAA;AAED;;;iCAGiC;AACjC,eAAO,MAAM,QAAQ,QAAO,KAGxB,CAAA;AAEJ;;+BAE+B;AAC/B,eAAO,MAAM,WAAW,QAAO,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CASrD,CAAA;AAED;;;;+BAI+B;AAC/B,eAAO,MAAM,eAAe,QAAO,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAMzD,CAAA;AAED,MAAM,WAAW,SAAU,SAAQ,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC;IAC9E,EAAE,EAAE,KAAK,CAAA;CACV;AAED;;oEAEoE;AACpE,eAAO,MAAM,IAAI,GAAI,0BAA0B,SAAS,KAAG,KAAK,CAAC,YAiBhE,CAAA"}

package/dist/router.jsx

@@ -0,0 +1,187 @@
+// Routing engine compat layer over @tanstack/react-router with `createBrowserHistory()`.
+//
+// Why browser history? Clean, standard path-based URLs (`/resources/:id?page=2`).
+// Works with server-side analytics and deep links. Requires an SPA fallback rule
+// on the server (`try_files ... index.html` in nginx, `historyApiFallback` in
+// Vite preview). This is the one-line standard config for any modern static host
+// (Vercel, Netlify, nginx). No SSR is used — admin pages are auth-walled.
+//
+// Why TSR? Future-proof primitives — devtools, search-param schemas, per-route
+// loaders, code-splitting — without paying for SSR/Nitro (TanStack Start).
+//
+// Public API (Route discriminated union, `Link`, `useRoute`, `useNavigate`,
+// `buildHref`) is kept stable. `Route` is the canonical surface; the underlying
+// TSR state is mapped to it via `parseLocation`. Search params are kept
+// opaque to TSR (`parseSearch`/`stringifySearch` are no-ops in `admin-router`):
+// `ListQueryState` (with `filters[<key>]=<v>` keys) is parsed manually from
+// the raw `searchStr` so the URL format doesn't depend on TSR's JSON-search encoding.
+import * as React from 'react';
+import { useRouter, useRouterState } from '@tanstack/react-router';
+/**
+ * Provides the SPA mount basepath (e.g. `/admin`) to all navigation
+ * primitives (`Link`, `useNavigate`, `useRoute`). Set by
+ * `AdminRouterProvider` from `window.__MODERN_ADMIN__.basePath`. Defaults
+ * to `''` (root mount).
+ */
+export const BasepathContext = React.createContext('');
+/** Returns the normalised basepath (never has a trailing slash; `''` at root). */
+export const useBasepath = () => React.useContext(BasepathContext);
+const parseListQuery = (search) => {
+    if (!search)
+        return undefined;
+    const params = new URLSearchParams(search.startsWith('?') ? search.slice(1) : search);
+    const out = {};
+    const page = params.get('page');
+    if (page) {
+        const n = Number(page);
+        if (Number.isFinite(n) && n >= 1)
+            out.page = n;
+    }
+    const perPage = params.get('perPage');
+    if (perPage) {
+        const n = Number(perPage);
+        if (Number.isFinite(n) && n >= 1)
+            out.perPage = n;
+    }
+    const sortBy = params.get('sortBy');
+    if (sortBy)
+        out.sortBy = sortBy;
+    const direction = params.get('direction');
+    if (direction === 'asc' || direction === 'desc')
+        out.direction = direction;
+    const filters = {};
+    params.forEach((value, key) => {
+        const m = key.match(/^filters\[(.+)\]$/);
+        if (m && m[1] != null && value !== '')
+            filters[m[1]] = value;
+    });
+    if (Object.keys(filters).length > 0)
+        out.filters = filters;
+    return Object.keys(out).length > 0 ? out : undefined;
+};
+const buildListQuery = (q) => {
+    if (!q)
+        return '';
+    const params = new URLSearchParams();
+    if (q.page != null && q.page !== 1)
+        params.set('page', String(q.page));
+    if (q.perPage != null && q.perPage !== 20)
+        params.set('perPage', String(q.perPage));
+    if (q.sortBy)
+        params.set('sortBy', q.sortBy);
+    if (q.direction)
+        params.set('direction', q.direction);
+    if (q.filters) {
+        for (const [k, v] of Object.entries(q.filters)) {
+            if (v != null && v !== '')
+                params.set(`filters[${k}]`, v);
+        }
+    }
+    const s = params.toString();
+    return s ? `?${s}` : '';
+};
+/** Map a TSR location (pathname + raw searchStr) to the canonical `Route`
+ *  union the rest of the codebase consumes. Pure — used both at render
+ *  time (via `useRoute`) and outside the React tree if ever needed. */
+export const parseLocation = (pathname, searchStr) => {
+    const parts = pathname.split('/').filter(Boolean);
+    if (parts.length === 0)
+        return { name: 'home' };
+    if (parts[0] === 'audit-log')
+        return { name: 'audit-log' };
+    if (parts[0] === 'settings') {
+        const section = parts[1] ? decodeURIComponent(parts[1]) : undefined;
+        return section ? { name: 'settings', section } : { name: 'settings' };
+    }
+    if (parts[0] === 'ext' && parts[1]) {
+        return { name: 'extension', key: decodeURIComponent(parts[1]) };
+    }
+    if (parts[0] === 'resources' && parts[1]) {
+        const resourceId = decodeURIComponent(parts[1]);
+        if (parts[2] === 'new')
+            return { name: 'new', resourceId };
+        if (parts[2] && parts[3] === 'edit') {
+            return { name: 'edit', resourceId, recordId: decodeURIComponent(parts[2]) };
+        }
+        if (parts[2])
+            return { name: 'show', resourceId, recordId: decodeURIComponent(parts[2]) };
+        const query = parseListQuery(searchStr);
+        return query ? { name: 'list', resourceId, query } : { name: 'list', resourceId };
+    }
+    return { name: 'home' };
+};
+/** Build a path URL for the given route. Pure — kept for tests and for
+ *  `<Link>` href generation. */
+export const buildHref = (route) => {
+    switch (route.name) {
+        case 'home':
+            return '/';
+        case 'audit-log':
+            return '/audit-log';
+        case 'list':
+            return `/resources/${encodeURIComponent(route.resourceId)}${buildListQuery(route.query)}`;
+        case 'show':
+            return `/resources/${encodeURIComponent(route.resourceId)}/${encodeURIComponent(route.recordId)}`;
+        case 'edit':
+            return `/resources/${encodeURIComponent(route.resourceId)}/${encodeURIComponent(route.recordId)}/edit`;
+        case 'new':
+            return `/resources/${encodeURIComponent(route.resourceId)}/new`;
+        case 'settings':
+            return route.section ? `/settings/${encodeURIComponent(route.section)}` : '/settings';
+        case 'extension':
+            return `/ext/${encodeURIComponent(route.key)}`;
+    }
+};
+/** Current canonical route, derived from the live TSR state.
+ *  When the router has a basepath, TSR strips it from `location.pathname`
+ *  before exposing it in state — so `parseLocation` sees only the
+ *  basepath-relative portion. */
+export const useRoute = () => useRouterState({
+    select: (s) => parseLocation(s.location.pathname, s.location.searchStr ?? ''),
+});
+/** Imperative navigator. Same signature as the legacy custom router so
+ *  call-sites don't change. Goes through TSR history → re-routing flows
+ *  through TSR's lifecycle. */
+export const useNavigate = () => {
+    const router = useRouter();
+    const basepath = useBasepath();
+    return React.useCallback((next) => {
+        router.history.push(basepath + buildHref(next));
+    }, [router, basepath]);
+};
+/** Open an in-app route in a new browser tab, honouring the admin's
+ *  `basepath`. `buildHref` returns a basepath-relative path, so we prepend
+ *  the basepath the same way `Link`/`useNavigate` do — otherwise the new tab
+ *  loads a URL outside the admin mount (e.g. `/resources/...` instead of
+ *  `/admin/resources/...`). */
+export const useOpenInNewTab = () => {
+    const basepath = useBasepath();
+    return React.useCallback((route) => {
+        if (typeof window === 'undefined')
+            return;
+        window.open(basepath + buildHref(route), '_blank', 'noopener,noreferrer');
+    }, [basepath]);
+};
+/** Anchor with path href + client-side navigation on plain left-click.
+ *  Modifier clicks (cmd/ctrl/shift/alt, middle button) fall through to
+ *  default browser behaviour so "open in new tab" keeps working. */
+export const Link = ({ to, onClick, ...rest }) => {
+    const router = useRouter();
+    const basepath = useBasepath();
+    const href = basepath + buildHref(to);
+    const handleClick = React.useCallback((event) => {
+        onClick?.(event);
+        if (event.defaultPrevented)
+            return;
+        if (event.button !== 0)
+            return;
+        if (event.metaKey || event.ctrlKey || event.shiftKey || event.altKey)
+            return;
+        if (rest.target && rest.target !== '_self')
+            return;
+        event.preventDefault();
+        router.history.push(href);
+    }, [onClick, router, href, rest.target]);
+    return <a href={href} onClick={handleClick} {...rest}/>;
+};
+//# sourceMappingURL=router.jsx.map

package/dist/router.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.jsx","sourceRoot":"","sources":["../src/router.tsx"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,EAAE;AACF,kFAAkF;AAClF,iFAAiF;AACjF,8EAA8E;AAC9E,iFAAiF;AACjF,0EAA0E;AAC1E,EAAE;AACF,+EAA+E;AAC/E,2EAA2E;AAC3E,EAAE;AACF,4EAA4E;AAC5E,gFAAgF;AAChF,wEAAwE;AACxE,gFAAgF;AAChF,4EAA4E;AAC5E,sFAAsF;AAEtF,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAElE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC,aAAa,CAAS,EAAE,CAAC,CAAA;AAE9D,kFAAkF;AAClF,MAAM,CAAC,MAAM,WAAW,GAAG,GAAW,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,eAAe,CAAC,CAAA;AA2B1E,MAAM,cAAc,GAAG,CAAC,MAAc,EAA8B,EAAE;IACpE,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAA;IAC7B,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;IACrF,MAAM,GAAG,GAAmB,EAAE,CAAA;IAC9B,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IAC/B,IAAI,IAAI,EAAE,CAAC;QACT,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAA;QACtB,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,GAAG,CAAC,IAAI,GAAG,CAAC,CAAA;IAChD,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;IACrC,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAA;QACzB,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,GAAG,CAAC,OAAO,GAAG,CAAC,CAAA;IACnD,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IACnC,IAAI,MAAM;QAAE,GAAG,CAAC,MAAM,GAAG,MAAM,CAAA;IAC/B,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;IACzC,IAAI,SAAS,KAAK,KAAK,IAAI,SAAS,KAAK,MAAM;QAAE,GAAG,CAAC,SAAS,GAAG,SAAS,CAAA;IAC1E,MAAM,OAAO,GAA2B,EAAE,CAAA;IAC1C,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QAC5B,MAAM,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAA;QACxC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,IAAI,KAAK,KAAK,EAAE;YAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAA;IAC9D,CAAC,CAAC,CAAA;IACF,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC;QAAE,GAAG,CAAC,OAAO,GAAG,OAAO,CAAA;IAC1D,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAA;AACtD,CAAC,CAAA;AAED,MAAM,cAAc,GAAG,CAAC,CAA6B,EAAU,EAAE;IAC/D,IAAI,CAAC,CAAC;QAAE,OAAO,EAAE,CAAA;IACjB,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAA;IACpC,IAAI,CAAC,CAAC,IAAI,IAAI,IAAI,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC;QAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;IACtE,IAAI,CAAC,CAAC,OAAO,IAAI,IAAI,IAAI,CAAC,CAAC,OAAO,KAAK,EAAE;QAAE,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAA;IACnF,IAAI,CAAC,CAAC,MAAM;QAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAA;IAC5C,IAAI,CAAC,CAAC,SAAS;QAAE,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,SAAS,CAAC,CAAA;IACrD,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;QACd,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;YAC/C,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE;gBAAE,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC,CAAA;QAC3D,CAAC;IACH,CAAC;IACD,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAA;IAC3B,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;AACzB,CAAC,CAAA;AAED;;uEAEuE;AACvE,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,QAAgB,EAAE,SAAiB,EAAS,EAAE;IAC1E,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IACjD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;IAC/C,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,WAAW;QAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAA;IAC1D,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,UAAU,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;QACnE,OAAO,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAA;IACvE,CAAC;IACD,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACnC,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IACjE,CAAC;IACD,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,WAAW,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACzC,MAAM,UAAU,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;QAC/C,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK;YAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,CAAA;QAC1D,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC;YACpC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;QAC7E,CAAC;QACD,IAAI,KAAK,CAAC,CAAC,CAAC;YAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;QACzF,MAAM,KAAK,GAAG,cAAc,CAAC,SAAS,CAAC,CAAA;QACvC,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,CAAA;IACnF,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;AACzB,CAAC,CAAA;AAED;gCACgC;AAChC,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAY,EAAU,EAAE;IAChD,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACrB,KAAK,MAAM;YACT,OAAO,GAAG,CAAA;QACZ,KAAK,WAAW;YACd,OAAO,YAAY,CAAA;QACrB,KAAK,MAAM;YACT,OAAO,cAAc,kBAAkB,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,cAAc,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAA;QAC3F,KAAK,MAAM;YACT,OAAO,cAAc,kBAAkB,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,kBAAkB,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAA;QACnG,KAAK,MAAM;YACT,OAAO,cAAc,kBAAkB,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,kBAAkB,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAA;QACxG,KAAK,KAAK;YACR,OAAO,cAAc,kBAAkB,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAA;QACjE,KAAK,UAAU;YACb,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,kBAAkB,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,CAAA;QACvF,KAAK,WAAW;YACd,OAAO,QAAQ,kBAAkB,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAA;IAChD,CAAC;AACH,CAAC,CAAA;AAED;;;iCAGiC;AACjC,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAU,EAAE,CAClC,cAAc,CAAC;IACb,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,SAAS,IAAI,EAAE,CAAC;CAC9E,CAAC,CAAA;AAEJ;;+BAE+B;AAC/B,MAAM,CAAC,MAAM,WAAW,GAAG,GAA6B,EAAE;IACxD,MAAM,MAAM,GAAG,SAAS,EAAE,CAAA;IAC1B,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAA;IAC9B,OAAO,KAAK,CAAC,WAAW,CACtB,CAAC,IAAW,EAAE,EAAE;QACd,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAA;IACjD,CAAC,EACD,CAAC,MAAM,EAAE,QAAQ,CAAC,CACnB,CAAA;AACH,CAAC,CAAA;AAED;;;;+BAI+B;AAC/B,MAAM,CAAC,MAAM,eAAe,GAAG,GAA6B,EAAE;IAC5D,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAA;IAC9B,OAAO,KAAK,CAAC,WAAW,CAAC,CAAC,KAAY,EAAE,EAAE;QACxC,IAAI,OAAO,MAAM,KAAK,WAAW;YAAE,OAAM;QACzC,MAAM,CAAC,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,qBAAqB,CAAC,CAAA;IAC3E,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAA;AAChB,CAAC,CAAA;AAMD;;oEAEoE;AACpE,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,IAAI,EAAa,EAAsB,EAAE;IAC9E,MAAM,MAAM,GAAG,SAAS,EAAE,CAAA;IAC1B,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAA;IAC9B,MAAM,IAAI,GAAG,QAAQ,GAAG,SAAS,CAAC,EAAE,CAAC,CAAA;IACrC,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,CACnC,CAAC,KAA0C,EAAE,EAAE;QAC7C,OAAO,EAAE,CAAC,KAAK,CAAC,CAAA;QAChB,IAAI,KAAK,CAAC,gBAAgB;YAAE,OAAM;QAClC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAM;QAC9B,IAAI,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,MAAM;YAAE,OAAM;QAC5E,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,KAAK,OAAO;YAAE,OAAM;QAClD,KAAK,CAAC,cAAc,EAAE,CAAA;QACtB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC3B,CAAC,EACD,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CACrC,CAAA;IACD,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,IAAI,CAAC,EAAG,CAAA;AAC1D,CAAC,CAAA"}

package/dist/show-when.d.ts

@@ -0,0 +1,7 @@
+import type { ShowWhenSpec } from './types.js';
+/**
+ * Evaluate a `ShowWhenSpec` against the live form values.
+ * Returns `true` (visible) when no rule is configured.
+ */
+export declare function evaluateShowWhen(rule: ShowWhenSpec | undefined, values: Record<string, unknown>): boolean;
+//# sourceMappingURL=show-when.d.ts.map

package/dist/show-when.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"show-when.d.ts","sourceRoot":"","sources":["../src/show-when.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAiB9C;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,YAAY,GAAG,SAAS,EAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAkCT"}

package/dist/show-when.js

@@ -0,0 +1,77 @@
+// Pure helper that evaluates a `ShowWhenSpec` against a snapshot of form
+// values. Lives outside React/RHF on purpose so both the edit page renderer
+// and the validation builder can share the exact same semantics.
+//
+// Operator semantics:
+//   - `equals`            — control value === provided value
+//   - `notEquals`         — control value !== provided value
+//   - `in`                — control value matches any item in array
+//   - `notIn`             — control value matches none of the items
+//   - `isEmpty:true`      — control value is null / undefined / ''
+//   - `isEmpty:false`     — control value is NOT null / undefined / ''
+//   - `defaultWhenEmpty`  — fallback: shows the field when control is empty,
+//                           regardless of the other operators
+//
+// Operators combine with OR — the field shows when **any** of them passes.
+// When no operator is configured, the rule trivially passes (visible).
+const isBlank = (v) => v === undefined || v === null || (typeof v === 'string' && v.trim() === '');
+/** Loose equality that handles primitives + dates + arrays of primitives. */
+const sameValue = (a, b) => {
+    if (a === b)
+        return true;
+    if (a == null || b == null)
+        return false;
+    if (a instanceof Date && b instanceof Date)
+        return a.getTime() === b.getTime();
+    // Coerce numbers vs string-numbers (HTML inputs ship strings).
+    if (typeof a === 'number' && typeof b === 'string')
+        return String(a) === b;
+    if (typeof a === 'string' && typeof b === 'number')
+        return a === String(b);
+    if (typeof a === 'boolean' && typeof b === 'string')
+        return String(a) === b;
+    return false;
+};
+/**
+ * Evaluate a `ShowWhenSpec` against the live form values.
+ * Returns `true` (visible) when no rule is configured.
+ */
+export function evaluateShowWhen(rule, values) {
+    if (!rule)
+        return true;
+    const control = values[rule.field];
+    const empty = isBlank(control);
+    // Default branch: when control is empty AND defaultWhenEmpty is set, show.
+    if (rule.defaultWhenEmpty && empty)
+        return true;
+    let anyOperator = false;
+    if ('equals' in rule && rule.equals !== undefined) {
+        anyOperator = true;
+        if (sameValue(control, rule.equals))
+            return true;
+    }
+    if ('notEquals' in rule && rule.notEquals !== undefined) {
+        anyOperator = true;
+        if (!sameValue(control, rule.notEquals))
+            return true;
+    }
+    if (rule.in && rule.in.length > 0) {
+        anyOperator = true;
+        if (rule.in.some((v) => sameValue(control, v)))
+            return true;
+    }
+    if (rule.notIn && rule.notIn.length > 0) {
+        anyOperator = true;
+        if (!rule.notIn.some((v) => sameValue(control, v)))
+            return true;
+    }
+    if (rule.isEmpty !== undefined) {
+        anyOperator = true;
+        if (rule.isEmpty === empty)
+            return true;
+    }
+    // Rule with operators that all failed → hidden.
+    // Rule with no operators (only `field` declared) → visible.
+    return !anyOperator;
+}
+//# sourceMappingURL=show-when.js.map

package/dist/show-when.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"show-when.js","sourceRoot":"","sources":["../src/show-when.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,194 @@
+export type View = 'list' | 'show' | 'edit' | 'filter';
+/**
+ * Mirror of `core` `ShowWhen` — declarative rule that conditionally hides a
+ * field on the edit form based on the current value of another form field.
+ * Operators combine with OR semantics; `defaultWhenEmpty` triggers when the
+ * control field is null / undefined / ''.
+ */
+export interface ShowWhenSpec {
+    field: string;
+    equals?: unknown;
+    notEquals?: unknown;
+    in?: unknown[];
+    notIn?: unknown[];
+    isEmpty?: boolean;
+    defaultWhenEmpty?: boolean;
+}
+/**
+ * Mirror of `core` `KeyValueField` — declares one row in the key-value
+ * editor used as a friendly alternative to the raw JSON editor.
+ */
+export interface KeyValueFieldSpec {
+    key: string;
+    label?: string;
+    type?: 'string' | 'number' | 'boolean' | 'textarea' | 'select' | 'autocomplete';
+    description?: string;
+    placeholder?: string;
+    isRequired?: boolean;
+    availableValues?: ReadonlyArray<string | {
+        value: string;
+        label: string;
+    }>;
+    /** For `type: 'autocomplete'`: pull dynamic suggestions from another resource. */
+    suggestionsResource?: string;
+    /** Path of the field on `suggestionsResource` to project. */
+    suggestionsField?: string;
+}
+export interface PropertyJSON {
+    path: string;
+    label: string;
+    type: string;
+    isId: boolean;
+    isSortable: boolean;
+    isRequired: boolean;
+    isDisabled: boolean;
+    isArray: boolean;
+    reference: string | null;
+    availableValues: Array<{
+        value: string;
+        label: string;
+    }> | null;
+    components: {
+        list?: string;
+        edit?: string;
+        show?: string;
+        filter?: string;
+    } | Record<string, string>;
+    visibility: Record<View, boolean>;
+    position: number;
+    description?: string;
+    showWhen?: ShowWhenSpec;
+    keyValueFields?: KeyValueFieldSpec[];
+    custom: Record<string, unknown>;
+}
+export interface ActionGroup {
+    name: string;
+    icon?: string;
+}
+export interface ActionDescriptor {
+    name: string;
+    actionType: 'resource' | 'record' | 'bulk';
+    resourceId: string;
+    nesting?: ActionGroup[];
+    guard?: string;
+    component?: string | null;
+    custom?: Record<string, unknown>;
+}
+export interface RelatedResource {
+    resourceId: string;
+    foreignKey: string;
+    label?: string;
+}
+export interface ResourceJSON {
+    id: string;
+    name: string;
+    navigation: {
+        name?: string;
+        icon?: string;
+        group?: string;
+    } | null;
+    relatedResources?: RelatedResource[];
+    properties: PropertyJSON[];
+    actions: ActionDescriptor[];
+}
+export interface CurrentUser {
+    id: string;
+    email?: string;
+    name?: string;
+    role?: string;
+    avatarUrl?: string;
+    [claim: string]: unknown;
+}
+/**
+ * Mirror of `core` `AdminFeatures`. Each flag is `true` iff the
+ * corresponding backend subsystem is wired and ready. The SPA uses these
+ * to hide UI surfaces (audit-log link, settings sections, revisions
+ * button, AI assistant widget) for features the host hasn't enabled.
+ */
+export interface AdminFeatures {
+    auditLog: boolean;
+    history: boolean;
+    webhooks: boolean;
+    apiKeys: boolean;
+    aiAssistant: boolean;
+}
+/** Defensive resolver for older API servers that don't yet surface
+ *  `features` in their `/admin/api/config` payload — every flag falls back
+ *  to `false`, so optional surfaces stay hidden until the backend opts in. */
+export declare const resolveFeatures: (raw?: Partial<AdminFeatures>) => AdminFeatures;
+export interface AdminConfig {
+    rootPath: string;
+    branding?: {
+        companyName?: string;
+        logo?: string;
+        theme?: string;
+    };
+    auth: Record<string, unknown>;
+    resources: ResourceJSON[];
+    features?: Partial<AdminFeatures>;
+}
+export interface RecordJSON {
+    id: string;
+    title: string;
+    params: Record<string, unknown>;
+    populated: Record<string, unknown>;
+    errors: Record<string, unknown>;
+    baseError: unknown | null;
+}
+export interface ListResponse {
+    records: RecordJSON[];
+    meta: {
+        total: number;
+        page: number;
+        perPage: number;
+        sortBy?: string;
+        direction?: 'asc' | 'desc';
+    };
+}
+export interface RecordResponse {
+    record: RecordJSON;
+}
+/** Generic response from a custom action invocation (record / bulk / resource). */
+export interface CustomActionResponse {
+    record?: RecordJSON;
+    records?: RecordJSON[];
+    notice?: {
+        message: string;
+        type: 'success' | 'info' | 'error' | 'warning';
+    };
+    redirectUrl?: string;
+    [key: string]: unknown;
+}
+export interface ListQuery {
+    page?: number;
+    perPage?: number;
+    sortBy?: string;
+    direction?: 'asc' | 'desc';
+    filters?: Record<string, string>;
+}
+/**
+ * Props contract for a property **display** component. Shared between the
+ * built-in `PropertyDisplay` and any custom property extension registered
+ * via `registerPropertyExtension`.
+ */
+export interface PropertyDisplayProps {
+    property: PropertyJSON;
+    value: unknown;
+    view?: 'list' | 'show';
+    /** The record's `populated` map (pre-fetched reference titles). */
+    populated?: Record<string, unknown>;
+}
+/**
+ * Props contract for a property **editor** component. Shared between the
+ * built-in `PropertyEditor` and any custom property extension registered
+ * via `registerPropertyExtension`.
+ */
+export interface PropertyEditorProps {
+    property: PropertyJSON;
+    value: unknown;
+    onChange(next: unknown): void;
+    disabled?: boolean;
+    /** Required for `type: 'file'` properties to route uploads correctly. */
+    resourceId?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,18 @@
+// Wire-shape mirror of `ResourceDecorator#toJSON()` and friends. We re-declare
+// rather than re-import so the React bundle doesn't drag in the full core
+// (which references Node-only deps in a few corners).
+const ALL_FEATURES_OFF = {
+    auditLog: false,
+    history: false,
+    webhooks: false,
+    apiKeys: false,
+    aiAssistant: false,
+};
+/** Defensive resolver for older API servers that don't yet surface
+ *  `features` in their `/admin/api/config` payload — every flag falls back
+ *  to `false`, so optional surfaces stay hidden until the backend opts in. */
+export const resolveFeatures = (raw) => ({
+    ...ALL_FEATURES_OFF,
+    ...(raw ?? {}),
+});
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,0EAA0E;AAC1E,sDAAsD;AA+GtD,MAAM,gBAAgB,GAAkB;IACtC,QAAQ,EAAE,KAAK;IACf,OAAO,EAAE,KAAK;IACd,QAAQ,EAAE,KAAK;IACf,OAAO,EAAE,KAAK;IACd,WAAW,EAAE,KAAK;CACnB,CAAA;AAED;;8EAE8E;AAC9E,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,GAA4B,EAAiB,EAAE,CAAC,CAAC;IAC/E,GAAG,gBAAgB;IACnB,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC;CACf,CAAC,CAAA"}