akanjs 2.3.11-rc.9 → 2.3.12-rc.0

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # akanjs
 
+## 2.3.11
+
+### Minor Changes
+
+- 595390a: feat: UiOverride 시스템 및 \_overrides.tsx 지원 추가
+
+  - `akanjs/ui/UiOverride` 추가: `Provider`, `createOverridable`, `useUiOverride`, `override` API로 UI 컴포넌트 커스터마이징 지원
+  - 모든 akanjs UI 컴포넌트(Button, Modal, Select, Table 등)에 `useUiOverride()` 통합
+  - 라우트 시스템에 `_overrides.tsx` 지원 추가 (routeConvention, routeTreeBuilder)
+  - qualityScanner에 `_overrides.tsx` 파일 검증 로직 추가
+  - 앱 예제: `apps/minimal`에 `_overrides.tsx`, `BrandModal`, `OverrideDemo` 추가
+  - `apps/akan` 문서에 UI 커스터마이징 가이드 페이지 추가
+  - devkit에 `no-throw-raw-error.grit` lint rule 추가
+  - `PushNotificationServer.ts` 리팩토링
+  - biome.json 업데이트 및 패키지 의존성 정리
+
+### Patch Changes
+
+- 5ce752a: enhance: add host option for staging server tests
+- 5ce752a: add host option for staging server tests
+
 ## 2.3.10
 
 ### Patch Changes

package/client/csrTypes.ts

@@ -191,6 +191,8 @@ export interface Route {
   path: string;
   renderPage?: RouteRender;
   renderLayout?: RouteRender;
+  /** Synthetic layout render from a `_overrides.tsx` at this node; wraps the subtree in a UI-override provider. */
+  renderOverrides?: RouteRender;
   pageIncludesOwnLayout?: boolean;
   isSpecialRoute?: boolean;
 

package/common/routeConvention.ts

@@ -1,11 +1,13 @@
 const ROUTE_SOURCE_RE = /^\.\/(.+)\.(tsx|ts|jsx|js)$/;
 const SOURCE_EXT_RE = /\.(tsx|ts|jsx|js)$/;
-const RESERVED_ROUTE_FILES = new Set(["_layout", "_index"]);
+const RESERVED_ROUTE_FILES = new Set(["_layout", "_index", "_overrides"]);
 const INTERNAL_ROOT_LAYOUT_LEAF = "__root_layout";
 const IMPLICIT_LOCALE_SEGMENT = "[lang]";
 const SPECIAL_ROUTE_LEAVES = new Set(["robots.txt"]);
 
-export type RouteModuleKind = "page" | "layout";
+const DIRECTORY_SCOPED_LEAVES = new Set(["_layout", "_index", "_overrides"]);
+
+export type RouteModuleKind = "page" | "layout" | "overrides";
 
 export interface ParsedRouteModuleKey {
   key: string;
@@ -51,7 +53,7 @@ export function validatePageSourceFile(filePath: string, options: ValidatePageSo
   if (ext !== "tsx") throw new Error(`[route-convention] route source files under page/ must use .tsx: ${displayPath}`);
   if (leaf.startsWith("_") && !RESERVED_ROUTE_FILES.has(leaf) && leaf !== INTERNAL_ROOT_LAYOUT_LEAF)
     throw new Error(
-      `[route-convention] only _index.tsx and _layout.tsx are allowed as reserved route files under page/: ${displayPath}`,
+      `[route-convention] only _index.tsx, _layout.tsx and _overrides.tsx are allowed as reserved route files under page/: ${displayPath}`,
     );
   if (/^[A-Z]/.test(leaf))
     throw new Error(`[route-convention] route page filenames must not start with an uppercase letter: ${displayPath}`);
@@ -97,13 +99,14 @@ export function parseRouteModuleKey(key: string): ParsedRouteModuleKey {
   }
 
   const isInternalRootLayout = leaf === INTERNAL_ROOT_LAYOUT_LEAF;
-  const kind: RouteModuleKind = leaf === "_layout" || isInternalRootLayout ? "layout" : "page";
+  const kind: RouteModuleKind =
+    leaf === "_layout" || isInternalRootLayout ? "layout" : leaf === "_overrides" ? "overrides" : "page";
   if (leaf.startsWith("_") && !RESERVED_ROUTE_FILES.has(leaf) && !isInternalRootLayout) {
     throw new Error(`[route-convention] unsupported reserved route file "${leaf}" in ${key}`);
   }
 
   const sourceRouteSegments =
-    leaf === "_layout" || leaf === "_index" || isInternalRootLayout ? moduleSegments.slice(0, -1) : moduleSegments;
+    DIRECTORY_SCOPED_LEAVES.has(leaf) || isInternalRootLayout ? moduleSegments.slice(0, -1) : moduleSegments;
   const isSpecialRoute = kind === "page" && SPECIAL_ROUTE_LEAVES.has(leaf);
   const routeSegments = isSpecialRoute ? sourceRouteSegments : [IMPLICIT_LOCALE_SEGMENT, ...sourceRouteSegments];
   for (const segment of routeSegments) validateRouteSegment(segment, key);

package/fetch/client/fetchClient.ts

@@ -101,6 +101,9 @@ export class FetchClient {
               : undefined,
           getGuards: signal.getGuards ?? current.getGuards,
           cruGuards: signal.cruGuards ?? current.cruGuards,
+          createGuards: signal.createGuards ?? current.createGuards,
+          updateGuards: signal.updateGuards ?? current.updateGuards,
+          removeGuards: signal.removeGuards ?? current.removeGuards,
         }
       : signal;
   }
@@ -353,6 +356,10 @@ export class FetchClient {
       modelId: `${refName}Id`,
       lightModel: `light${capRefName}`,
     };
+    
+    const createGuards = signal.createGuards ?? signal.cruGuards;
+    const updateGuards = signal.updateGuards ?? signal.cruGuards;
+    const removeGuards = signal.removeGuards ?? signal.cruGuards;
     const endpoint: { [key: string]: SerializedEndpoint } = {};
     if (signal.getGuards) {
       endpoint[names.model] = {
@@ -368,13 +375,15 @@ export class FetchClient {
         guards: signal.getGuards,
       };
     }
-    if (signal.cruGuards) {
+    if (createGuards) {
       endpoint[names.createModel] = {
         type: "mutation",
         args: [{ type: "body", name: "data", refName, modelType: "input" }],
         returns: { refName, modelType: "full" },
-        guards: signal.cruGuards,
+        guards: createGuards,
       };
+    }
+    if (updateGuards) {
       endpoint[names.updateModel] = {
         type: "mutation",
         args: [
@@ -382,13 +391,15 @@ export class FetchClient {
           { type: "body", name: "data", refName, modelType: "input" },
         ],
         returns: { refName, modelType: "full" },
-        guards: signal.cruGuards,
+        guards: updateGuards,
       };
+    }
+    if (removeGuards) {
       endpoint[names.removeModel] = {
         type: "mutation",
         args: [{ type: "param", name: names.modelId, refName: "ID" }],
         returns: { refName, modelType: "full" },
-        guards: signal.cruGuards,
+        guards: removeGuards,
       };
     }
     return endpoint;
@@ -414,7 +425,9 @@ export class FetchClient {
       this.#setHandlerFactory(key, () => this.#makeHttpFn(key, value, signal.prefix));
     });
 
-    if (signal.cruGuards) {
+    const anyCruGuards = signal.cruGuards ?? signal.createGuards ?? signal.updateGuards ?? signal.removeGuards;
+    const updateGuards = signal.updateGuards ?? signal.cruGuards;
+    if (anyCruGuards) {
       this.#setHandlerFactory(
         names.viewModel,
         () =>
@@ -461,15 +474,17 @@ export class FetchClient {
             return { refName, [`${refName}Obj`]: modelObj, [`${refName}ViewAt`]: new Date() };
           }) as FetchHandler,
       );
-      this.#setHandlerFactory(
-        names.mergeModel,
-        () =>
-          (async (modelOrId: string | { id: string }, data: UnknownRecord, option?: FetchPolicy) => {
-            const id = typeof modelOrId === "string" ? modelOrId : modelOrId.id;
-            const updateFn = this.#requireHandler(names.updateModel, names.mergeModel);
-            return await updateFn(id, data, option);
-          }) as FetchHandler,
-      );
+      if (updateGuards) {
+        this.#setHandlerFactory(
+          names.mergeModel,
+          () =>
+            (async (modelOrId: string | { id: string }, data: UnknownRecord, option?: FetchPolicy) => {
+              const id = typeof modelOrId === "string" ? modelOrId : modelOrId.id;
+              const updateFn = this.#requireHandler(names.updateModel, names.mergeModel);
+              return await updateFn(id, data, option);
+            }) as FetchHandler,
+        );
+      }
     }
 
     this.#setHandlerFactory(

package/fetch/serializer/fetch.serializer.ts

@@ -102,6 +102,16 @@ export class FetchSerializer {
       ...(sliceCls.cruGuards.filter((g) => g.name !== "None").length
         ? { cruGuards: sliceCls.cruGuards.map((g) => g.name) }
         : {}),
+
+      ...(sliceCls.createGuards !== sliceCls.cruGuards && sliceCls.createGuards.filter((g) => g.name !== "None").length
+        ? { createGuards: sliceCls.createGuards.map((g) => g.name) }
+        : {}),
+      ...(sliceCls.updateGuards !== sliceCls.cruGuards && sliceCls.updateGuards.filter((g) => g.name !== "None").length
+        ? { updateGuards: sliceCls.updateGuards.map((g) => g.name) }
+        : {}),
+      ...(sliceCls.removeGuards !== sliceCls.cruGuards && sliceCls.removeGuards.filter((g) => g.name !== "None").length
+        ? { removeGuards: sliceCls.removeGuards.map((g) => g.name) }
+        : {}),
       endpoint,
     };
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akanjs",
-  "version": "2.3.11-rc.9",
+  "version": "2.3.12-rc.0",
   "sourceType": "module",
   "type": "module",
   "publishConfig": {

package/server/resolver/signal.resolver.ts

@@ -232,14 +232,14 @@ export class SignalResolver {
         });
 
       endpointObj[`create${capitalizedRefName}`] = (builder as any)
-        .mutation(cnst.full, { guards: sliceCls.cruGuards })
+        .mutation(cnst.full, { guards: sliceCls.createGuards })
         .body("data", cnst.input)
         .exec(async function (this: any, data: any) {
           return await this[serviceName].__create(data);
         });
 
       endpointObj[`update${capitalizedRefName}`] = (builder as any)
-        .mutation(cnst.full, { guards: sliceCls.cruGuards })
+        .mutation(cnst.full, { guards: sliceCls.updateGuards })
         .param(`${refName}Id`, ID)
         .body("data", cnst.input)
         .exec(async function (this: any, id: string, data: any) {
@@ -247,7 +247,7 @@ export class SignalResolver {
         });
 
       endpointObj[`remove${capitalizedRefName}`] = (builder as any)
-        .mutation(cnst.full, { guards: sliceCls.cruGuards })
+        .mutation(cnst.full, { guards: sliceCls.removeGuards })
         .param(`${refName}Id`, ID)
         .exec(async function (this: any, id: string) {
           return await this[serviceName].__remove(id);

package/server/routeTreeBuilder.ts

@@ -18,9 +18,12 @@ import {
   parseRouteModuleKey,
   routeSegmentToTreePath,
 } from "akanjs/common";
+import { createElement } from "react";
 import { validatePageConfig } from "../client/frameConfig";
 import { resolveHeadExport, resolveMetadataHead } from "./metadata";
 
+type RouteModuleKindWithOverrides = "page" | "layout" | "overrides";
+
 export type PagesContext = Record<string, () => Promise<RouteModule>>;
 
 export const defaultPageState: PageState = {
@@ -197,6 +200,14 @@ export class RouteTreeBuilder {
     const targetPath = pathSegments[pathSegments.length - 1];
     if (!targetPath) return;
 
+    if (parsed.kind === "overrides") {
+      targetRouteMap.set(targetPath, {
+        ...(targetRouteMap.get(targetPath) ?? { path: targetPath, children: new Map<string, Route>() }),
+        renderOverrides: this.#makeOverridesRender(filePath, loader),
+      } as Route);
+      return;
+    }
+
     const routeRender = RouteTreeBuilder.#makeRouteRender(filePath, parsed.kind, loader);
     targetRouteMap.set(targetPath, {
       ...(targetRouteMap.get(targetPath) ?? { path: targetPath, children: new Map<string, Route>() }),
@@ -224,8 +235,10 @@ export class RouteTreeBuilder {
     const pathSegments = [...parentPaths, ...(currentPathSegment ? [currentPathSegment] : [])];
     const currentRootLayout = isRoot && route.renderLayout ? route.renderLayout : null;
     const currentLayout = !isRoot && route.renderLayout ? route.renderLayout : null;
+
+    const currentOverrideRenders = route.renderOverrides ? [route.renderOverrides] : [];
     const renderRootLayouts = [...parentRootLayouts, ...(currentRootLayout ? [currentRootLayout] : [])];
-    const renderLayouts = [...parentLayouts, ...(currentLayout ? [currentLayout] : [])];
+    const renderLayouts = [...parentLayouts, ...currentOverrideRenders, ...(currentLayout ? [currentLayout] : [])];
     if (route.renderLayout) {
       this.#fallbackRoutes.push({
         path: routePath,
@@ -237,7 +250,10 @@ export class RouteTreeBuilder {
     const routeHead = RouteTreeBuilder.#composeHeadResolvers(route.renderLayout?.resolveHead, parentHead);
     const pageRenderRootLayouts =
       route.pageIncludesOwnLayout === false && currentRootLayout ? parentRootLayouts : renderRootLayouts;
-    const pageRenderLayouts = route.pageIncludesOwnLayout === false && currentLayout ? parentLayouts : renderLayouts;
+    const pageRenderLayouts =
+      route.pageIncludesOwnLayout === false && currentLayout
+        ? [...parentLayouts, ...currentOverrideRenders]
+        : renderLayouts;
     const pageHead = route.pageIncludesOwnLayout === false ? parentHead : routeHead;
     return [
       ...(route.renderPage
@@ -262,7 +278,7 @@ export class RouteTreeBuilder {
     ];
   }
 
-  static #makeLazyModule(key: string, kind: "page" | "layout", loader: () => Promise<RouteModule>) {
+  static #makeLazyModule(key: string, kind: RouteModuleKindWithOverrides, loader: () => Promise<RouteModule>) {
     let cached: RouteModule | null = null;
     let loaded = false;
     RouteTreeBuilder.#moduleCacheStats.moduleCount += 1;
@@ -285,7 +301,12 @@ export class RouteTreeBuilder {
     };
   }
 
-  static #validateRouteModuleExports(key: string, kind: "page" | "layout", mod: RouteModule) {
+  static #validateRouteModuleExports(key: string, kind: RouteModuleKindWithOverrides, mod: RouteModule) {
+    if (kind === "overrides") {
+      
+      if (!mod.default) throw new Error(`[route-convention] ${key} generated override wrapper has no default export`);
+      return;
+    }
     const parsed = parseRouteModuleKey(key);
     const allowed =
       kind === "page"
@@ -378,6 +399,18 @@ export class RouteTreeBuilder {
     return routeRender;
   }
 
+  #makeOverridesRender(key: string, loader: () => Promise<RouteModule>): RouteRender {
+    const loadModule = RouteTreeBuilder.#makeLazyModule(key, "overrides", loader);
+    return {
+      isAsync: true,
+      render: (async ({ children }: LayoutProps) => {
+        const mod = await loadModule();
+        if (!mod.default) throw new Error(`[route-convention] ${key} generated override wrapper has no default export`);
+        return createElement(mod.default as never, { children } as never);
+      }) as RouteRender["render"],
+    };
+  }
+
   static #composeHeadResolvers(...resolvers: (ResolveHead | undefined)[]): ResolveHead | undefined {
     const chain = resolvers.filter((resolver): resolver is ResolveHead => Boolean(resolver));
     if (chain.length === 0) return undefined;

package/signal/serializer/fetch.serializer.ts

@@ -99,6 +99,16 @@ export class FetchSerializer {
       ...(sliceCls.cruGuards.filter((g) => g.name !== "None").length
         ? { cruGuards: sliceCls.cruGuards.map((g) => g.name) }
         : {}),
+
+      ...(sliceCls.createGuards !== sliceCls.cruGuards && sliceCls.createGuards.filter((g) => g.name !== "None").length
+        ? { createGuards: sliceCls.createGuards.map((g) => g.name) }
+        : {}),
+      ...(sliceCls.updateGuards !== sliceCls.cruGuards && sliceCls.updateGuards.filter((g) => g.name !== "None").length
+        ? { updateGuards: sliceCls.updateGuards.map((g) => g.name) }
+        : {}),
+      ...(sliceCls.removeGuards !== sliceCls.cruGuards && sliceCls.removeGuards.filter((g) => g.name !== "None").length
+        ? { removeGuards: sliceCls.removeGuards.map((g) => g.name) }
+        : {}),
       endpoint,
     };
   }

package/signal/signalContext.ts

@@ -341,6 +341,11 @@ export class SignalContext<
   getEnv() {
     return this.#env;
   }
+  getArg<T = unknown>(argName: string): T | undefined {
+    const index = this.endpointInfo.args.findIndex((arg) => arg.name === argName);
+    if (index === -1) return undefined;
+    return this.args[index] as T;
+  }
 }
 
 export class HttpExecutionContext<Appended = unknown> {

package/signal/slice.ts

@@ -35,6 +35,9 @@ export type SliceCls<
   [SLICE_META]: SliceInfoObj;
   getGuards: GuardCls[];
   cruGuards: GuardCls[];
+  createGuards: GuardCls[];
+  updateGuards: GuardCls[];
+  removeGuards: GuardCls[];
 };
 
 interface RootSliceOption {
@@ -42,6 +45,9 @@ interface RootSliceOption {
     root?: Cls<Guard> | Cls<Guard>[];
     get?: Cls<Guard> | Cls<Guard>[];
     cru?: Cls<Guard> | Cls<Guard>[];
+    create?: Cls<Guard> | Cls<Guard>[];
+    update?: Cls<Guard> | Cls<Guard>[];
+    remove?: Cls<Guard> | Cls<Guard>[];
   };
   prefix?: string;
 }
@@ -123,21 +129,14 @@ export function slice<
     srv.cnst.insight,
     srv.db.filter,
   );
-  const rootGuards = option.guards?.root
-    ? Array.isArray(option.guards.root)
-      ? option.guards.root
-      : [option.guards.root]
-    : [];
-  const getGuards = option.guards?.get
-    ? Array.isArray(option.guards.get)
-      ? option.guards.get
-      : [option.guards.get]
-    : [];
-  const cruGuards = option.guards?.cru
-    ? Array.isArray(option.guards.cru)
-      ? option.guards.cru
-      : [option.guards.cru]
-    : [];
+  const toGuards = (guard?: Cls<Guard> | Cls<Guard>[]) => (guard ? (Array.isArray(guard) ? guard : [guard]) : []);
+  const rootGuards = toGuards(option.guards?.root);
+  const getGuards = toGuards(option.guards?.get);
+  const cruGuards = toGuards(option.guards?.cru);
+
+  const createGuards = option.guards?.create ? toGuards(option.guards.create) : cruGuards;
+  const updateGuards = option.guards?.update ? toGuards(option.guards.update) : cruGuards;
+  const removeGuards = option.guards?.remove ? toGuards(option.guards.remove) : cruGuards;
   const srvKeys = [
     ...new Set([...Object.keys(srv.srvMap), ...libSlices.flatMap((libSlice) => Object.keys(libSlice.srv.srvMap))]),
   ];
@@ -148,6 +147,9 @@ export function slice<
     static srv = srv;
     static getGuards = getGuards;
     static cruGuards = cruGuards;
+    static createGuards = createGuards;
+    static updateGuards = updateGuards;
+    static removeGuards = removeGuards;
     static [SLICE_META] = Object.assign(
       {
         [""]: init({ guards: rootGuards })

package/signal/types.ts

@@ -129,6 +129,9 @@ export interface SerializedSignal {
   filter?: SerializedFilter;
   getGuards?: string[];
   cruGuards?: string[];
+  createGuards?: string[];
+  updateGuards?: string[];
+  removeGuards?: string[];
 }
 
 export type SignalType = "restapi" | "websocket";

package/types/client/csrTypes.d.ts

@@ -190,6 +190,8 @@ export interface Route {
     path: string;
     renderPage?: RouteRender;
     renderLayout?: RouteRender;
+    /** Synthetic layout render from a `_overrides.tsx` at this node; wraps the subtree in a UI-override provider. */
+    renderOverrides?: RouteRender;
     pageIncludesOwnLayout?: boolean;
     isSpecialRoute?: boolean;
     loader?: () => unknown;

package/types/common/routeConvention.d.ts

@@ -1,4 +1,4 @@
-export type RouteModuleKind = "page" | "layout";
+export type RouteModuleKind = "page" | "layout" | "overrides";
 export interface ParsedRouteModuleKey {
     key: string;
     kind: RouteModuleKind;

package/types/signal/signalContext.d.ts

@@ -48,6 +48,7 @@ export declare class SignalContext<Ctx extends HttpExecutionContext | WebSocketE
     getWebSocketContext<Appended = unknown>(): WebSocketExecutionContext<Appended>;
     getRoomId(key: string): string;
     getEnv(): Env;
+    getArg<T = unknown>(argName: string): T | undefined;
 }
 export declare class HttpExecutionContext<Appended = unknown> {
     #private;

package/types/signal/slice.d.ts

@@ -27,12 +27,18 @@ export type SliceCls<SrvModule extends ServiceModel = ServiceModel, SliceInfoObj
     [SLICE_META]: SliceInfoObj;
     getGuards: GuardCls[];
     cruGuards: GuardCls[];
+    createGuards: GuardCls[];
+    updateGuards: GuardCls[];
+    removeGuards: GuardCls[];
 };
 interface RootSliceOption {
     guards?: {
         root?: Cls<Guard> | Cls<Guard>[];
         get?: Cls<Guard> | Cls<Guard>[];
         cru?: Cls<Guard> | Cls<Guard>[];
+        create?: Cls<Guard> | Cls<Guard>[];
+        update?: Cls<Guard> | Cls<Guard>[];
+        remove?: Cls<Guard> | Cls<Guard>[];
     };
     prefix?: string;
 }

package/types/signal/types.d.ts

@@ -122,6 +122,9 @@ export interface SerializedSignal {
     filter?: SerializedFilter;
     getGuards?: string[];
     cruGuards?: string[];
+    createGuards?: string[];
+    updateGuards?: string[];
+    removeGuards?: string[];
 }
 export type SignalType = "restapi" | "websocket";
 export type WebsocketReqData = {

package/types/ui/Button.d.ts

@@ -8,4 +8,9 @@ export type ButtonProps<Result> = Omit<ButtonHTMLAttributes<HTMLButtonElement>,
     /** Called after the button briefly enters success state. */
     onSuccess?: (result: Result) => void;
 };
-export declare const Button: <Result = unknown>({ className, children, onClick, onSuccess, ...rest }: ButtonProps<Result>) => import("react/jsx-runtime").JSX.Element;
+/**
+ * Async-aware button. Resolves to a route-scoped override when a `page/**\/_overrides.tsx`
+ * in the route's ancestry declares one, otherwise renders {@link DefaultButton}. The public
+ * generic signature is preserved, so `<Button<Todo> onSuccess={(r: Todo) => …} />` still infers.
+ */
+export declare const Button: <Result = unknown>(props: ButtonProps<Result>) => React.ReactElement<ButtonProps<Result>, string | React.JSXElementConstructor<any>>;

package/types/ui/DatePicker.d.ts

@@ -1,5 +1,5 @@
 import { type Dayjs } from "akanjs/base";
-interface DatePickerProps {
+export interface DatePickerProps {
     value?: Dayjs | null;
     onChange: (value: Dayjs | null) => void;
     showTime?: boolean;
@@ -10,12 +10,7 @@ interface DatePickerProps {
     placement?: "top" | "bottom" | "left" | "right";
     defaultValue?: Dayjs;
 }
-export declare const DatePicker: {
-    ({ value, onChange, showTime, format, timeIntervals, disabledDate, placement, className, defaultValue, }: DatePickerProps): import("react/jsx-runtime").JSX.Element;
-    RangePicker: ({ value, onChange, format, showTime, timeIntervals, disabledDate, className, }: RangePickerProps) => import("react/jsx-runtime").JSX.Element;
-    TimePicker: ({ disabled, className, value, format, onChange, timeIntervals, }: TimePickerProps) => import("react/jsx-runtime").JSX.Element;
-};
-interface RangePickerProps {
+export interface RangePickerProps {
     value: [Dayjs | null, Dayjs | null];
     onChange: (value: [Dayjs | null, Dayjs | null]) => void;
     format?: string;
@@ -24,7 +19,7 @@ interface RangePickerProps {
     disabledDate?: (date: Dayjs) => boolean | null | undefined;
     className?: string;
 }
-interface TimePickerProps {
+export interface TimePickerProps {
     value: Dayjs | null;
     onChange: (value: Dayjs) => void;
     format?: string;
@@ -33,4 +28,12 @@ interface TimePickerProps {
     className?: string;
     disabled?: boolean;
 }
-export {};
+/**
+ * Date picker. `DatePicker`, `DatePicker.RangePicker`, and `DatePicker.TimePicker` each resolve to a
+ * route-scoped override when a `page/**\/_overrides.tsx` in the route's ancestry declares one (slots
+ * `DatePicker`, `DatePickerRangePicker`, `DatePickerTimePicker`).
+ */
+export declare const DatePicker: import("react").ComponentType<DatePickerProps> & {
+    RangePicker: import("react").ComponentType<RangePickerProps>;
+    TimePicker: import("react").ComponentType<TimePickerProps>;
+};

package/types/ui/Dropdown.d.ts

@@ -11,4 +11,9 @@ export interface DropdownProps {
     /** Additional classes for the dropdown content panel. */
     dropdownClassName?: string;
 }
-export declare const Dropdown: ({ value, content, className, buttonClassName, dropdownClassName }: DropdownProps) => import("react/jsx-runtime").JSX.Element;
+export declare const DefaultDropdown: ({ value, content, className, buttonClassName, dropdownClassName }: DropdownProps) => import("react/jsx-runtime").JSX.Element;
+/**
+ * Dropdown. Resolves to a route-scoped override when a `page/**\/_overrides.tsx`
+ * in the route's ancestry declares one, otherwise renders {@link DefaultDropdown}.
+ */
+export declare const Dropdown: import("react").ComponentType<DropdownProps>;

package/types/ui/Empty.d.ts

@@ -9,4 +9,10 @@ export interface EmptyProps {
     /** Minimum empty-state height in pixels. */
     minHeight?: number;
 }
-export declare const Empty: ({ className, description, children, minHeight }: EmptyProps) => import("react/jsx-runtime").JSX.Element;
+export declare const DefaultEmpty: ({ className, description, children, minHeight }: EmptyProps) => import("react/jsx-runtime").JSX.Element;
+/**
+ * Empty-state placeholder. Resolves to a route-scoped override when a
+ * `page/**\/_overrides.tsx` in the route's ancestry declares one, otherwise
+ * renders {@link DefaultEmpty}.
+ */
+export declare const Empty: import("react").ComponentType<EmptyProps>;

package/types/ui/Input.d.ts

@@ -24,14 +24,6 @@ export type InputProps = Omit<InputHTMLAttributes<HTMLInputElement>, "value" | "
     /** Called when Escape is pressed after blurring the input. */
     onPressEscape?: (e: KeyboardEvent<HTMLInputElement>) => void;
 };
-export declare const Input: {
-    ({ className, nullable, inputRef, value, cacheKey, inputStyleType, icon, iconClassName, inputClassName, inputWrapperClassName, onPressEnter, onPressEscape, onChange, validate, ...rest }: InputProps): import("react/jsx-runtime").JSX.Element;
-    TextArea: ({ className, nullable, value, inputClassName, inputWrapperClassName, cacheKey, onPressEnter, onPressEscape, onChange, validate, ...rest }: TextAreaProps) => import("react/jsx-runtime").JSX.Element;
-    Password: ({ className, nullable, value, icon, iconClassName, inputClassName, inputWrapperClassName, cacheKey, onPressEnter, onPressEscape, onChange, validate, ...rest }: PasswordProps) => import("react/jsx-runtime").JSX.Element;
-    Email: ({ inputStyleType, className, nullable, value, cacheKey, onPressEnter, onPressEscape, onChange, validate, icon, iconClassName, inputClassName, inputWrapperClassName, ...rest }: EmailProps) => import("react/jsx-runtime").JSX.Element;
-    Number: ({ className, nullable, value, icon, cacheKey, iconClassName, inputClassName, inputWrapperClassName, numberFormat, onPressEnter, onPressEscape, validate, onChange, formatter, parser, ...rest }: NumberProps) => import("react/jsx-runtime").JSX.Element;
-    Checkbox: ({ checked, onChange, className, ...rest }: CheckboxProps) => import("react/jsx-runtime").JSX.Element;
-};
 export type TextAreaProps = Omit<TextareaHTMLAttributes<HTMLTextAreaElement>, "value" | "type" | "onChange" | "onPressEnter"> & {
     inputRef?: RefObject<HTMLTextAreaElement | null>;
     value: string;
@@ -93,3 +85,15 @@ export type CheckboxProps = Omit<InputHTMLAttributes<HTMLInputElement>, "onChang
     checked: boolean;
     onChange: (checked: boolean, e: ChangeEvent<HTMLInputElement>) => void;
 };
+/**
+ * Text input plus its field variants. Each leaf resolves to a route-scoped override when a
+ * `page/**\/_overrides.tsx` in the route's ancestry declares one (slots `Input`, `InputTextArea`,
+ * `InputPassword`, `InputEmail`, `InputNumber`, `InputCheckbox`), otherwise renders the default.
+ */
+export declare const Input: React.ComponentType<InputProps> & {
+    TextArea: React.ComponentType<TextAreaProps>;
+    Password: React.ComponentType<PasswordProps>;
+    Email: React.ComponentType<EmailProps>;
+    Number: React.ComponentType<NumberProps>;
+    Checkbox: React.ComponentType<CheckboxProps>;
+};

package/types/ui/Loading/index.d.ts

@@ -1,8 +1,13 @@
+/**
+ * Loading indicators. Each member is an independent override slot (`LoadingSpin`, `LoadingSkeleton`,
+ * `LoadingProgressBar`, `LoadingButton`, `LoadingInput`, `LoadingArea`), resolved from the closest
+ * `page/**\/_overrides.tsx` in the route's ancestry, otherwise the shipped default.
+ */
 export declare const Loading: {
-    Area: () => import("react/jsx-runtime").JSX.Element;
-    Button: ({ className, active, style }: import("./Button.d.ts").LoadingProps) => import("react/jsx-runtime").JSX.Element;
-    Input: ({ className, active, style }: import("./Input.d.ts").LoadingProps) => import("react/jsx-runtime").JSX.Element;
-    ProgressBar: ({ className, value, max }: import("./ProgressBar.d.ts").ProgressBarProps) => import("react/jsx-runtime").JSX.Element;
-    Skeleton: ({ className, active, style }: import("./Skeleton.d.ts").SkeletonProps) => import("react/jsx-runtime").JSX.Element;
-    Spin: ({ indicator, isCenter, className }: import("./Spin.d.ts").SpinProps) => import("react/jsx-runtime").JSX.Element;
+    Area: import("react").ComponentType<Record<string, never>>;
+    Button: import("react").ComponentType<import("./Button.d.ts").LoadingProps>;
+    Input: import("react").ComponentType<import("./Input.d.ts").LoadingProps>;
+    ProgressBar: import("react").ComponentType<import("./ProgressBar.d.ts").ProgressBarProps>;
+    Skeleton: import("react").ComponentType<import("./Skeleton.d.ts").SkeletonProps>;
+    Spin: import("react").ComponentType<import("./Spin.d.ts").SpinProps>;
 };

package/types/ui/Menu.d.ts

@@ -1,12 +1,12 @@
 import { type ReactNode } from "react";
-interface MenuItem {
+export interface MenuItem {
     label: ReactNode;
     key: string;
     children?: MenuItem[];
     icon?: ReactNode;
     type?: string;
 }
-interface MenuProps {
+export interface MenuProps {
     className?: string;
     ulClassName?: string;
     liClassName?: string;
@@ -22,5 +22,10 @@ interface MenuProps {
     onMouseOver?: () => void;
     onMouseLeave?: () => void;
 }
-export declare const Menu: ({ items, onClick, selectedKeys, labelClassName, defaultSelectedKeys, className, ulClassName, liClassName, style, mode, activeStyle, inlineCollapsed, onMouseOver, onMouseLeave, }: MenuProps) => import("react/jsx-runtime").JSX.Element;
-export {};
+export declare const DefaultMenu: ({ items, onClick, selectedKeys, labelClassName, defaultSelectedKeys, className, ulClassName, liClassName, style, mode, activeStyle, inlineCollapsed, onMouseOver, onMouseLeave, }: MenuProps) => import("react/jsx-runtime").JSX.Element;
+/**
+ * Navigation menu. Resolves to a route-scoped override when a
+ * `page/**\/_overrides.tsx` in the route's ancestry declares one, otherwise
+ * renders {@link DefaultMenu}.
+ */
+export declare const Menu: import("react").ComponentType<MenuProps>;