akanjs 2.4.2-rc.2 → 3.0.0-alpha.0

package/types/common/isThenable.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Whether a value is awaitable. Duck-typed rather than `instanceof Promise` so a thenable produced by a
+ * different realm or promise implementation still counts — a same-realm check silently misses those.
+ *
+ * `<Button>` uses this to decide whether a click handler is asynchronous: a handler that returns a
+ * thenable gets the pending/success states, a plain one renders as an ordinary button. That makes the
+ * distinction impossible to forget, unlike an explicit flag.
+ */
+export declare const isThenable: (value: unknown) => value is PromiseLike<unknown>;

package/types/constant/purify.d.ts

@@ -1,4 +1,4 @@
-import { type Dayjs, type GetStateObject, type Upload } from "akanjs/base";
+import { type Dayjs, type GetStateObject } from "akanjs/base";
 import { type BaseObject, type ConstantModelRef, type DefaultOf, type DefaultOfSchema } from ".";
 type Purified<O> = O extends BaseObject ? string : O extends BaseObject[] ? string[] : O extends Dayjs ? Dayjs : O extends object ? PurifiedModel<O> : O;
 type PurifiedWithObjectToId<T, StateKeys extends keyof GetStateObject<T> = keyof GetStateObject<T>> = {
@@ -6,7 +6,8 @@ type PurifiedWithObjectToId<T, StateKeys extends keyof GetStateObject<T> = keyof
 } & {
     [K in StateKeys as null extends T[K] ? K : never]?: Purified<T[K]> | undefined;
 };
-export type PurifiedModel<T> = T extends Upload[] ? FileList : T extends (infer S)[] ? PurifiedModel<S>[] : T extends string | number | boolean | Dayjs | File ? T : T extends Map<infer K, infer V> ? Map<K, PurifiedModel<V>> : PurifiedWithObjectToId<T>;
+export type PurifiedModel<T> = T extends (infer S)[] ? PurifiedModel<S>[] : T extends string | number | boolean | Dayjs | File ? T : T extends Map<infer K, infer V> ? Map<K, PurifiedModel<V>> : PurifiedWithObjectToId<T>;
+export type UploadableClientArg<T> = [T] extends [File[]] ? File[] | FileList : T;
 export type PurifyFunc<Input, _DefaultInput = DefaultOf<Input>, _PurifiedInput = PurifiedModel<Input>> = (self: _DefaultInput, isChild?: boolean) => _PurifiedInput | null;
 export type PurifyFuncV2<Input, RelationKey extends string = never, _DefaultInput = DefaultOfSchema<Input, RelationKey>, _PurifiedInput = PurifiedModel<Input>> = (self: _DefaultInput, isChild?: boolean) => _PurifiedInput | null;
 export declare const makePurify: <I>(modelRef: ConstantModelRef<I>) => PurifyFunc<I>;

package/types/fetch/fetchType/sliceFetch.type.d.ts

@@ -60,7 +60,7 @@ type AppliedBaseSliceFetchType<RefName extends string, Input, Full, _Capitalized
 } & {
     [K in `get${_CapitalizedRefName}Edit`]: (id: string, option?: FetchPolicy) => Promise<ServerEdit<RefName, Full>>;
 } & {
-    [K in `add${_CapitalizedRefName}Files`]: (fileList: FileList, parentId?: string, option?: FetchPolicy) => Promise<ProtoFile[]>;
+    [K in `add${_CapitalizedRefName}Files`]: (fileList: FileList | File[], parentId?: string, option?: FetchPolicy) => Promise<ProtoFile[]>;
 } & {
     [K in `merge${_CapitalizedRefName}`]: (modelOrId: Full | string, data: Partial<_PurifiedInput>, option?: FetchPolicy) => Promise<Full>;
 };

package/types/signal/endpointInfo.d.ts

@@ -1,5 +1,5 @@
 import { type Dayjs, type EnumInstance, type PromiseOrObject } from "akanjs/base";
-import type { ConstantFieldType, ConstantFieldTypeInput, DocumentModel, FieldToValue, ParamFieldType, PlainTypeToFieldType, PurifiedModel } from "akanjs/constant";
+import type { ConstantFieldType, ConstantFieldTypeInput, DocumentModel, FieldToValue, ParamFieldType, PlainTypeToFieldType, PurifiedModel, UploadableClientArg } from "akanjs/constant";
 import type { ServiceModel } from "akanjs/service";
 import type { InternalArgCls } from "./internalArg.d.ts";
 import type { ArgType, SignalOption, SrvMap } from "./types.d.ts";
@@ -45,7 +45,7 @@ export declare class EndpointInfo<ReqType extends EndpointType = EndpointType, S
     static getReturnInfo<Returns extends ConstantFieldTypeInput = ConstantFieldTypeInput, Nullable extends boolean = false>(modelRef: Returns, signalOption?: SignalOption<Returns, Nullable>): ReturnInfo<Returns, Nullable>;
     constructor(type: ReqType, returnRef: Returns, signalOption?: SignalOption<Returns, Nullable>);
     param<ArgName extends string, Arg extends ParamFieldType, _ClientArg = FieldToValue<Arg>, _ServerArg = DocumentModel<_ClientArg>>(name: string, arg: Arg, option?: Omit<EndpointArgProps, "nullable">): EndpointInfo<ReqType, Srvs, [...ArgNames, ArgName], [...Args, arg: _ClientArg], InternalArgs, [...ServerArgs, arg: _ServerArg], Returns, ClientReturns, ServerReturns, Nullable>;
-    body<ArgName extends string, ExplicitType = unknown, Arg extends ConstantFieldTypeInput = PlainTypeToFieldType<ExplicitType>, Optional extends boolean = false, _ArgType = unknown extends ExplicitType ? FieldToValue<Arg> : ExplicitType, _ClientArg = PurifiedModel<_ArgType>, _ServerArg = DocumentModel<_ArgType>>(name: ArgName, arg: Arg, option?: EndpointArgProps<Optional>): EndpointInfo<ReqType, Srvs, [...ArgNames, ArgName], Optional extends true ? [...Args, arg?: _ClientArg | null] : [...Args, arg: _ClientArg], InternalArgs, [...ServerArgs, arg: _ServerArg | (Optional extends true ? undefined : never)], Returns, ClientReturns, ServerReturns, Nullable>;
+    body<ArgName extends string, ExplicitType = unknown, Arg extends ConstantFieldTypeInput = PlainTypeToFieldType<ExplicitType>, Optional extends boolean = false, _ArgType = unknown extends ExplicitType ? FieldToValue<Arg> : ExplicitType, _ClientArg = UploadableClientArg<PurifiedModel<_ArgType>>, _ServerArg = DocumentModel<_ArgType>>(name: ArgName, arg: Arg, option?: EndpointArgProps<Optional>): EndpointInfo<ReqType, Srvs, [...ArgNames, ArgName], Optional extends true ? [...Args, arg?: _ClientArg | null] : [...Args, arg: _ClientArg], InternalArgs, [...ServerArgs, arg: _ServerArg | (Optional extends true ? undefined : never)], Returns, ClientReturns, ServerReturns, Nullable>;
     room<ArgName extends string, ExplicitType = unknown, Arg extends ConstantFieldTypeInput = PlainTypeToFieldType<ExplicitType>, _ArgType = unknown extends ExplicitType ? FieldToValue<Arg> : ExplicitType, _ClientArg = PurifiedModel<_ArgType>, _ServerArg = DocumentModel<_ArgType>>(name: string, arg: Arg, option?: Omit<EndpointArgProps, "nullable">): EndpointInfo<ReqType, Srvs, [...ArgNames, ArgName], [...Args, arg: _ClientArg], InternalArgs, [...ServerArgs, arg: _ServerArg], Returns, ClientReturns, ServerReturns, Nullable>;
     msg<ArgName extends string, ExplicitType = unknown, Arg extends ConstantFieldTypeInput = PlainTypeToFieldType<ExplicitType>, Optional extends boolean = false, _ArgType = unknown extends ExplicitType ? FieldToValue<Arg> : ExplicitType, _ClientArg = PurifiedModel<_ArgType>, _ServerArg = DocumentModel<_ArgType>>(name: string, arg: Arg, option?: EndpointArgProps<Optional>): EndpointInfo<ReqType, Srvs, [...ArgNames, ArgName], Optional extends true ? [...Args, arg?: _ClientArg | null] : [...Args, arg: _ClientArg], InternalArgs, [...ServerArgs, arg: _ServerArg | (Optional extends true ? undefined : never)], Returns, ClientReturns, ServerReturns, Nullable>;
     search<ArgName extends string, ExplicitType = unknown, Arg extends ConstantFieldTypeInput = PlainTypeToFieldType<ExplicitType>, _ArgType = unknown extends ExplicitType ? FieldToValue<Arg> : ExplicitType, _ClientArg = PurifiedModel<_ArgType>, _ServerArg = DocumentModel<_ArgType>>(name: string, arg: Arg, option?: Omit<EndpointArgProps, "nullable">): EndpointInfo<ReqType, Srvs, [...ArgNames, ArgName], [...Args, arg?: _ClientArg | null], InternalArgs, [...ServerArgs, arg: _ServerArg | undefined], Returns, ClientReturns, ServerReturns, Nullable>;

package/types/signal/slice.d.ts

@@ -51,7 +51,7 @@ export declare function slice<SrvModule extends ServiceModel, BuildSlice extends
     [""]: SliceInfo<SrvRefName<SrvModule>, _Input, _Full, _Light, _Insight, _Filter, SrvMap<SrvModule>, [
         "query"
     ], [
-        _Query
+        query?: _Query | null
     ], [
     ], [
         _Query

package/types/signal/sliceInfo.d.ts

@@ -1,5 +1,5 @@
 import type { Cls, PromiseOrObject } from "akanjs/base";
-import type { BaseInsight, BaseObject, ConstantFieldTypeInput, DocumentModel, FieldToValue, ParamFieldType, PlainTypeToFieldType, PurifiedModel, QueryOf } from "akanjs/constant";
+import type { BaseInsight, BaseObject, ConstantFieldTypeInput, DocumentModel, FieldToValue, ParamFieldType, PlainTypeToFieldType, PurifiedModel, QueryOf, UploadableClientArg } from "akanjs/constant";
 import type { FilterCls, FilterInstance } from "akanjs/document";
 import type { ServiceModel } from "akanjs/service";
 import { type ArgInfo, type EndpointArgProps, type InternalArgInfo, type InternalArgProps } from "./endpointInfo.d.ts";
@@ -23,7 +23,7 @@ export declare class SliceInfo<RefName extends string = string, Input = any, Ful
     execFn: ((...args: [...ServerArgs, ...InternalArgs]) => QueryOf<DocumentModel<Full>>) | null;
     constructor(refName: RefName, input: Cls<Input>, full: Cls<Full>, light: Cls<Light>, insight: Cls<Insight>, filter: FilterCls<Filter>, signalOption?: SignalOption);
     param<ArgName extends string, Arg extends ParamFieldType, _ClientArg = FieldToValue<Arg>, _ServerArg = DocumentModel<_ClientArg>>(name: ArgName, arg: Arg, option?: Omit<EndpointArgProps, "nullable">): SliceInfo<RefName, Input, Full, Light, Insight, Filter, Srvs, [...ArgNames, ArgName], [...Args, arg: _ClientArg], InternalArgs, [...ServerArgs, arg: _ServerArg]>;
-    body<ArgName extends string, ExplicitType = unknown, Arg extends ConstantFieldTypeInput = PlainTypeToFieldType<ExplicitType>, Optional extends boolean = false, _ArgType = unknown extends ExplicitType ? FieldToValue<Arg> : ExplicitType, _ClientArg = PurifiedModel<_ArgType>, _ServerArg = DocumentModel<_ArgType>>(name: ArgName, arg: Arg, option?: EndpointArgProps<Optional>): SliceInfo<RefName, Input, Full, Light, Insight, Filter, Srvs, [...ArgNames, ArgName], Optional extends true ? [...Args, arg?: _ClientArg | null] : [...Args, arg: _ClientArg], InternalArgs, [...ServerArgs, arg: _ServerArg | (Optional extends true ? undefined : never)]>;
+    body<ArgName extends string, ExplicitType = unknown, Arg extends ConstantFieldTypeInput = PlainTypeToFieldType<ExplicitType>, Optional extends boolean = false, _ArgType = unknown extends ExplicitType ? FieldToValue<Arg> : ExplicitType, _ClientArg = UploadableClientArg<PurifiedModel<_ArgType>>, _ServerArg = DocumentModel<_ArgType>>(name: ArgName, arg: Arg, option?: EndpointArgProps<Optional>): SliceInfo<RefName, Input, Full, Light, Insight, Filter, Srvs, [...ArgNames, ArgName], Optional extends true ? [...Args, arg?: _ClientArg | null] : [...Args, arg: _ClientArg], InternalArgs, [...ServerArgs, arg: _ServerArg | (Optional extends true ? undefined : never)]>;
     search<ArgName extends string, ExplicitType = unknown, Arg extends ConstantFieldTypeInput = PlainTypeToFieldType<ExplicitType>, _ArgType = unknown extends ExplicitType ? FieldToValue<Arg> : ExplicitType, _ClientArg = PurifiedModel<_ArgType>, _ServerArg = DocumentModel<_ArgType>>(name: ArgName, arg: Arg, option?: Omit<EndpointArgProps, "nullable">): SliceInfo<RefName, Input, Full, Light, Insight, Filter, Srvs, [...ArgNames, ArgName], [...Args, arg?: _ClientArg | null], InternalArgs, [...ServerArgs, arg: _ServerArg | undefined]>;
     with<ArgType, Optional extends boolean = false>(argRef: InternalArgCls<ArgType>, option?: InternalArgProps<Optional>): SliceInfo<RefName, Input, Full, Light, Insight, Filter, Srvs, ArgNames, Args, [...InternalArgs, arg: NonNullable<ArgType> | (Optional extends true ? null : never)], ServerArgs>;
     exec(query: (this: {

package/types/store/action.d.ts

@@ -111,7 +111,7 @@ type ArrayFieldAddOrSubSetters<RefName extends string, _CapRef extends string, _
     }) => void;
 };
 type FormSetter<Full, RefName extends string, _CapitalizedRefName extends string = Capitalize<RefName>, _DefaultState = DefaultOf<Full>> = FieldFormSetter<_DefaultState, RefName, _CapitalizedRefName> & ArrayFieldAddSetters<RefName, _CapitalizedRefName, _DefaultState> & ArrayFieldSubSetters<RefName, _CapitalizedRefName, _DefaultState> & ArrayFieldAddOrSubSetters<RefName, _CapitalizedRefName, _DefaultState> & {
-    [K in keyof _DefaultState as _DefaultState[K] extends (ProtoFile | null) | ProtoFile[] ? K extends string ? SetterKey<"upload", K, RefName, _CapitalizedRefName> : never : never]: (fileList: FileList, idx?: number) => Promise<void>;
+    [K in keyof _DefaultState as _DefaultState[K] extends (ProtoFile | null) | ProtoFile[] ? K extends string ? SetterKey<"upload", K, RefName, _CapitalizedRefName> : never : never]: (fileList: FileList | File[], idx?: number) => Promise<void>;
 } & {
     [K in `writeOn${_CapitalizedRefName}`]: (path: string | (string | number)[], value: any) => void;
 };

package/types/store/state.d.ts

@@ -3,7 +3,7 @@ import { type DefaultOf } from "akanjs/constant";
 import type { ExtractSort, FilterInstance } from "akanjs/document";
 import type { SerializedSlice, SlceCnstCapitalizedRefName, SlceCnstDefault, SlceCnstFull, SlceCnstInsight, SlceCnstLight, SlceCnstRefName, SlceDbFilter, SlceDbSort, SliceCls } from "akanjs/signal";
 import type { StoreSliceArgs, StoreSliceMap, StoreSliceSuffixCap, Submit } from "./types.d.ts";
-export type SliceStateKey = "defaultModel" | "modelInsight" | "modelList" | "modelListLoading" | "modelInitList" | "modelInitAt" | "modelSelection" | "lastPageOfModel" | "pageOfModel" | "limitOfModel" | "queryArgsOfModel" | "sortOfModel";
+export type SliceStateKey = "defaultModel" | "modelInsight" | "modelList" | "modelListLoading" | "modelInitList" | "modelInitAt" | "modelStaleAt" | "modelSelection" | "lastPageOfModel" | "pageOfModel" | "limitOfModel" | "queryArgsOfModel" | "sortOfModel";
 type _SliceMap<S extends SliceCls> = StoreSliceMap<S>;
 type _StateRefName<S extends SliceCls> = SlceCnstRefName<S>;
 type _StateCap<S extends SliceCls> = SlceCnstCapitalizedRefName<S>;
@@ -42,6 +42,8 @@ export type SliceState<RefName extends string, Suffix extends string, Full, Ligh
     [K in `${RefName}InitList${_CapitalizedSuffix}`]: DataList<Light>;
 } & {
     [K in `${RefName}InitAt${_CapitalizedSuffix}`]: Date;
+} & {
+    [K in `${RefName}StaleAt${_CapitalizedSuffix}`]: Date;
 } & {
     [K in `${RefName}Selection${_CapitalizedSuffix}`]: DataList<Light>;
 } & {
@@ -64,7 +66,7 @@ type DefaultSliceStateFields<SlceCls extends SliceCls, _RefName extends string,
 } & {
     [Suffix in _Suffixes as `${_RefName}List${StoreSliceSuffixCap<SlceCls, Suffix>}` | `${_RefName}InitList${StoreSliceSuffixCap<SlceCls, Suffix>}` | `${_RefName}Selection${StoreSliceSuffixCap<SlceCls, Suffix>}`]: DataList<_Light>;
 } & {
-    [Suffix in _Suffixes as `${_RefName}InitAt${StoreSliceSuffixCap<SlceCls, Suffix>}`]: Date;
+    [Suffix in _Suffixes as `${_RefName}InitAt${StoreSliceSuffixCap<SlceCls, Suffix>}` | `${_RefName}StaleAt${StoreSliceSuffixCap<SlceCls, Suffix>}`]: Date;
 } & {
     [Suffix in _Suffixes as `${_RefName}ListLoading${StoreSliceSuffixCap<SlceCls, Suffix>}`]: boolean;
 } & {

package/types/test/sampleOf.d.ts

@@ -1,5 +1,5 @@
-import type { BaseObject, ConstantCls, DocumentModel } from "akanjs/constant";
+import type { BaseObject, ConstantCls, DocumentModel, FieldObject } from "akanjs/constant";
 export type SampleOf<Model> = DocumentModel<{
     [K in keyof Model as Model[K] extends BaseObject ? never : K]: NonNullable<Model[K]>;
 }>;
-export declare const sampleOf: <Model>(modelRef: ConstantCls<Model>) => DocumentModel<{ [K in keyof Model as Model[K] extends BaseObject ? never : K]: NonNullable<Model[K]>; }>;
+export declare const sampleOf: <Model, FieldObj extends FieldObject>(modelRef: ConstantCls<Model, FieldObj>) => DocumentModel<{ [K in keyof Model as Model[K] extends BaseObject ? never : K]: NonNullable<Model[K]>; }>;

package/types/ui/Badge.d.ts

@@ -0,0 +1,6 @@
+import type { HTMLAttributes } from "react";
+import { type BadgeVariants, badgeRecipe } from "./recipe.d.ts";
+export { badgeRecipe, type BadgeVariants };
+export type BadgeProps = HTMLAttributes<HTMLSpanElement> & BadgeVariants;
+/** Status/label pill. Route-overridable via `page/**\/_overrides.tsx` (slot `Badge`). */
+export declare const Badge: import("react").ComponentType<BadgeProps>;

package/types/ui/Button.d.ts

@@ -1,16 +1,36 @@
 import type React from "react";
 import { type ButtonHTMLAttributes } from "react";
-export type ButtonProps<Result> = Omit<ButtonHTMLAttributes<HTMLButtonElement>, "onClick"> & {
-    /** Async-aware click handler. Call onError to show the localized error state without throwing. */
-    onClick: (e: React.MouseEvent<HTMLButtonElement>, { onError }: {
+import { type ButtonVariants, buttonRecipe } from "./recipe.d.ts";
+export { buttonRecipe, type ButtonVariants };
+export type ButtonProps<Result> = Omit<ButtonHTMLAttributes<HTMLButtonElement>, "onClick"> & ButtonVariants & {
+    /**
+     * Click handler. Returning a promise is what opts this button into the async states — a plain
+     * synchronous handler renders as an ordinary button with no spinner. Call onError to show the
+     * localized error state without throwing.
+     */
+    onClick?: (e: React.MouseEvent<HTMLButtonElement>, { onError }: {
         onError: (error: string) => void;
     }) => Promise<Result> | Result;
     /** Called after the button briefly enters success state. */
     onSuccess?: (result: Result) => void;
+    /**
+     * How the pending/success indicator is drawn. Both modes keep the button's box fixed — CSS cannot
+     * animate an auto width, so a resizing button can only ever snap.
+     *
+     * `hold` (default) fades a bare indicator over the children, so the box stays exactly the children's
+     * size. `replace` cross-fades to a labelled indicator ("Processing…"); both labels stay stacked in the
+     * DOM, so the box is the wider of the two from the start and still never moves — at the cost of an idle
+     * button that is as wide as its longest state.
+     */
+    loadingMode?: "hold" | "replace";
+    /** Whether a failed action renders its message under the button. Off leaves it to the framework toast. */
+    showError?: boolean;
 };
 /**
- * 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.
+ * Button whose async states are driven by the handler's return value: return a promise and it shows a
+ * pending indicator, then a brief success state; return nothing and it behaves as a plain 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/Load/Units.d.ts

@@ -18,6 +18,8 @@ interface DefaultProps<L extends {
     renderList?: (list: DataList<L>) => ReactNode;
     reverse?: boolean;
     pagination?: boolean;
+    /** Max age in ms of the cached slice data before the client refetches on mount; `0` always refetches. */
+    staleTime?: number;
 }
 interface UnitsProps<RefName extends string, Light extends {
     id: string;
@@ -26,5 +28,5 @@ interface UnitsProps<RefName extends string, Light extends {
 }
 export default function Units<RefName extends string, Light extends {
     id: string;
-}>({ containerRef, className, init, noDiv, from, to, loading, renderItem, renderList, renderEmpty, filter, sort, reverse, style, pagination, }: UnitsProps<RefName, Light>): import("react/jsx-runtime").JSX.Element;
+}>({ containerRef, className, init, noDiv, from, to, loading, renderItem, renderList, renderEmpty, filter, sort, reverse, style, pagination, staleTime, }: UnitsProps<RefName, Light>): import("react/jsx-runtime").JSX.Element;
 export {};

package/types/ui/RecentTime.d.ts

@@ -6,7 +6,7 @@ export interface RecentTimeProps {
     breakUnit?: Intl.RelativeTimeFormatUnit;
     /** Use compact automatic formatting or always include date and time. */
     format?: "full" | "auto";
-    /** Additional classes for the tooltip span. */
+    /** Additional classes for the trigger span. */
     className?: string;
 }
 export declare const RecentTime: ({ date, breakUnit, format, className }: RecentTimeProps) => import("react/jsx-runtime").JSX.Element | null;

package/types/ui/Signal/Collapse.d.ts

@@ -0,0 +1,12 @@
+import type { ReactNode } from "react";
+/**
+ * Signal 도큐먼트/테스트 카드의 접이식 컨테이너.
+ * daisyui `collapse`(checkbox+CSS) → 네이티브 `<details>/<summary>`. 플러그인 의존 없음.
+ */
+export declare const SignalCollapse: ({ summary, children, open, className, contentClassName, }: {
+    summary: ReactNode;
+    children: ReactNode;
+    open?: boolean;
+    className?: string;
+    contentClassName?: string;
+}) => import("react/jsx-runtime").JSX.Element;

package/types/ui/Signal/style.d.ts

@@ -2,14 +2,13 @@ export declare const signalUi: {
     sectionTitle: string;
     sectionDescription: string;
     sectionPanel: string;
-    endpointCard: string;
-    endpointContent: string;
     tablePanel: string;
+    tableClass: string;
     inputRow: string;
     inputLabel: string;
     codePanel: string;
 };
-export declare const getEndpointBadgeClassName: (type: string) => "badge badge-primary" | "badge badge-secondary";
-export declare const getGuardBadgeClassName: (guard: string) => "badge badge-primary" | "badge badge-secondary" | "badge";
-export declare const getStatusBadgeClassName: (status: string) => "badge badge-outline" | "badge badge-primary" | "badge badge-error";
-export declare const getStatusTextareaClassName: (status: string) => "" | "border-error text-error" | "border-primary" | "textarea-disabled";
+export declare const getEndpointBadgeClassName: (type: string) => string;
+export declare const getGuardBadgeClassName: (guard: string) => string;
+export declare const getStatusBadgeClassName: (status: string) => string;
+export declare const getStatusTextareaClassName: (status: string) => "" | "pointer-events-none opacity-50" | "border-destructive text-destructive" | "border-primary";

package/types/ui/Switch.d.ts

@@ -0,0 +1,14 @@
+export interface SwitchProps {
+    checked?: boolean;
+    defaultChecked?: boolean;
+    disabled?: boolean;
+    onChange?: (checked: boolean) => void;
+    className?: string;
+    /** 켜짐 상태 색. daisyui `toggle-accent/toggle-primary` 대체. */
+    variant?: "primary" | "accent" | "success";
+}
+/**
+ * 순수 Tailwind 스위치 (`<button role="switch">`). daisyui `toggle`/`swap` 대체.
+ * `<button>` 이라 포커스·Space/Enter 토글이 네이티브로 제공된다. controlled/uncontrolled 모두 지원.
+ */
+export declare const Switch: ({ checked, defaultChecked, disabled, onChange, className, variant, }: SwitchProps) => import("react/jsx-runtime").JSX.Element;

package/types/ui/Tooltip.d.ts

@@ -0,0 +1,11 @@
+import type { ReactNode } from "react";
+export interface TooltipProps {
+    /** 툴팁에 표시할 내용. 비어 있으면 트리거만 그대로 렌더한다. */
+    content?: ReactNode;
+    children: ReactNode;
+    side?: "top" | "right" | "bottom" | "left";
+    className?: string;
+    /** 색상 변형. daisyui `tooltip-primary/info` 대체. */
+    variant?: "default" | "primary" | "info";
+}
+export declare const Tooltip: import("react").ComponentType<TooltipProps>;

package/types/ui/UiOverride/Provider.d.ts

@@ -1,14 +1,15 @@
 import { type ReactNode } from "react";
-import { type AkanUiOverrides } from "./context.d.ts";
+import { type AkanUiOverrideManifest } from "./context.d.ts";
 export interface UiOverrideProviderProps {
-    /** Override map for this subtree; merged over any ancestor overrides. */
-    value?: Partial<AkanUiOverrides>;
+    /** Override manifest for this subtree; merged over any ancestor overrides. */
+    value?: AkanUiOverrideManifest;
     children?: ReactNode;
 }
 /**
  * Supplies route-scoped UI overrides. Merges its own `value` over the overrides
  * inherited from ancestors so the closest declaration wins, matching nested
- * `_overrides.tsx` resolution. `routeTreeBuilder` mounts one of these per route
- * node once the `_overrides.tsx` convention is wired.
+ * `_overrides.tsx` resolution. The `recipes` map merges per-slot (a child that
+ * swaps only `button` keeps an ancestor's `badge` swap). `routeTreeBuilder`
+ * mounts one of these per route node once the `_overrides.tsx` convention is wired.
  */
 export declare const UiOverrideProvider: ({ value, children }: UiOverrideProviderProps) => import("react/jsx-runtime").JSX.Element;

package/types/ui/UiOverride/context.d.ts

@@ -1,4 +1,6 @@
 import { type ComponentType } from "react";
+import type { ClassNameValue as ClassValue } from "tailwind-merge";
+import type { BadgeProps } from "../Badge.d.ts";
 import type { ButtonProps } from "../Button.d.ts";
 import type { DatePickerProps, RangePickerProps, TimePickerProps } from "../DatePicker.d.ts";
 import type { DropdownProps } from "../Dropdown.d.ts";
@@ -14,9 +16,11 @@ import type { ModalProps } from "../Modal.d.ts";
 import type { PaginationProps } from "../Pagination.d.ts";
 import type { PopconfirmProps } from "../Popconfirm.d.ts";
 import type { ItemProps as RadioItemProps, RadioProps } from "../Radio.d.ts";
+import type { BadgeVariants, ButtonVariants } from "../recipe.d.ts";
 import type { SelectProps } from "../Select.d.ts";
 import type { TableProps } from "../Table.d.ts";
 import type { MultiProps as ToggleSelectMultiProps, ToggleSelectProps } from "../ToggleSelect.d.ts";
+import type { TooltipProps } from "../Tooltip.d.ts";
 import type { UnauthorizedProps } from "../Unauthorized.d.ts";
 /**
  * Registry of framework UI components an app may replace per-route through a
@@ -31,6 +35,7 @@ import type { UnauthorizedProps } from "../Unauthorized.d.ts";
  * before they can be listed here without losing call-site typing.
  */
 export interface AkanUiOverrides {
+    Badge: ComponentType<BadgeProps>;
     Modal: ComponentType<ModalProps>;
     Empty: ComponentType<EmptyProps>;
     Pagination: ComponentType<PaginationProps>;
@@ -38,6 +43,7 @@ export interface AkanUiOverrides {
     Dropdown: ComponentType<DropdownProps>;
     Table: ComponentType<TableProps>;
     Menu: ComponentType<MenuProps>;
+    Tooltip: ComponentType<TooltipProps>;
     Unauthorized: ComponentType<UnauthorizedProps>;
     Button: ComponentType<ButtonProps<unknown>>;
     Select: ComponentType<SelectProps<string | number | boolean | null | undefined>>;
@@ -64,9 +70,24 @@ export interface AkanUiOverrides {
 export type AkanUiOverrideName = keyof AkanUiOverrides;
 /** Prop contract an app-authored Modal override must satisfy. */
 export type AkanModalComponent = AkanUiOverrides["Modal"];
+/**
+ * Registry of framework recipe slots an app may swap through the same `_overrides.tsx`
+ * manifest: `override({ recipes: { button: neonButtonRecipe } })`. A recipe swap changes
+ * only the className factory — the component's structure/behavior (async states, focus,
+ * a11y) is untouched. Each replacement must accept the framework recipe's full variant
+ * contract, so every call site keeps working.
+ */
+export interface AkanUiRecipes {
+    button: (variants?: ButtonVariants, className?: ClassValue) => string;
+    badge: (variants?: BadgeVariants, className?: ClassValue) => string;
+}
+/** Shape of an `_overrides.tsx` manifest: component slots plus an optional recipe-slot map. */
+export type AkanUiOverrideManifest = Partial<AkanUiOverrides> & {
+    recipes?: Partial<AkanUiRecipes>;
+};
 /**
  * Holds the override map for the current route subtree. Empty at the root, then
  * merged (child wins) by each nested `UiOverrideProvider`, mirroring how nested
  * `_layout.tsx` / `_overrides.tsx` stack down the route tree.
  */
-export declare const UiOverrideContext: import("react").Context<Partial<AkanUiOverrides>>;
+export declare const UiOverrideContext: import("react").Context<AkanUiOverrideManifest>;

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

@@ -1,5 +1,6 @@
-export type { AkanModalComponent, AkanUiOverrideName, AkanUiOverrides } from "./context.d.ts";
+export type { AkanModalComponent, AkanUiOverrideManifest, AkanUiOverrideName, AkanUiOverrides, AkanUiRecipes, } from "./context.d.ts";
 export { createOverridable } from "./createOverridable.d.ts";
 export { override } from "./override.d.ts";
 export { UiOverrideProvider, type UiOverrideProviderProps } from "./Provider.d.ts";
 export { useUiOverride } from "./useUiOverride.d.ts";
+export { useUiRecipe } from "./useUiRecipe.d.ts";

package/types/ui/UiOverride/override.d.ts

@@ -1,18 +1,19 @@
-import type { AkanUiOverrides } from "./context.d.ts";
+import type { AkanUiOverrideManifest } from "./context.d.ts";
 /**
  * Typed manifest builder for a `page/_overrides.tsx` file:
  *
  * ```tsx
- * export default override({ Modal: BrandModal });
+ * export default override({ Modal: BrandModal, recipes: { button: neonButtonRecipe } });
  * ```
  *
- * It type-checks each binding against that slot's public component contract and rejects unknown slot names as
+ * It type-checks each binding against that slot's public contract and rejects unknown slot names as
  * excess properties — so the manifest is validated at compile time and app components need no annotation of
- * their own. Keys are the framework component names (`Modal`), matching `useUiOverride` and the `<Modal>` call
- * sites.
+ * their own. Component keys are the framework component names (`Modal`), matching `useUiOverride` and the
+ * `<Modal>` call sites; the optional `recipes` map swaps recipe slots (look only, behavior untouched),
+ * matching `useUiRecipe` and the recipe names in `AkanUiRecipes`.
  *
  * It is a pure, server-safe identity function (no React, no `createContext`), so the manifest needs no
  * `"use client"` directive. The framework generates a `"use client"` wrapper layout that reads this map and
  * mounts the override provider around the route subtree (see `writeGeneratedOverridesLayoutFile`).
  */
-export declare const override: (overrides: Partial<AkanUiOverrides>) => Partial<AkanUiOverrides>;
+export declare const override: (overrides: AkanUiOverrideManifest) => AkanUiOverrideManifest;

package/types/ui/UiOverride/useUiRecipe.d.ts

@@ -0,0 +1,8 @@
+import { type AkanUiRecipes } from "./context.d.ts";
+/**
+ * Resolves the active recipe swap for a framework recipe slot in the current route
+ * subtree, or `undefined` when no `_overrides.tsx` in the ancestry declares one.
+ * Framework components consume it as `const recipe = useUiRecipe("button") ?? buttonRecipe;`
+ * so an app can restyle every instance app/route-wide without touching behavior.
+ */
+export declare const useUiRecipe: <K extends keyof AkanUiRecipes>(name: K) => AkanUiRecipes[K] | undefined;

package/types/ui/index.d.ts

@@ -1,4 +1,5 @@
 export { animated } from "./animated.d.ts";
+export { Badge } from "./Badge.d.ts";
 export { BottomSheet, type BottomSheetRef } from "./BottomSheet.d.ts";
 export { Button } from "./Button.d.ts";
 export { ClientSide } from "./ClientSide.d.ts";
@@ -34,12 +35,15 @@ export { Portal } from "./Portal.d.ts";
 export { Radio } from "./Radio.d.ts";
 export { RecentTime } from "./RecentTime.d.ts";
 export { Refresh } from "./Refresh.d.ts";
+export { type BadgeVariants, type ButtonVariants, badgeRecipe, buttonRecipe, type InputSurfaceVariants, inputRecipe, recipe, tv, } from "./recipe.d.ts";
 export { ScreenNavigator } from "./ScreenNavigator.d.ts";
 export { Select } from "./Select.d.ts";
 export { Signal } from "./Signal.d.ts";
+export { Switch, type SwitchProps } from "./Switch.d.ts";
 export { System, type WebAppManifest } from "./System.d.ts";
 export { Tab } from "./Tab.d.ts";
 export { Table } from "./Table.d.ts";
 export { ToggleSelect } from "./ToggleSelect.d.ts";
-export { type AkanModalComponent, type AkanUiOverrideName, type AkanUiOverrides, createOverridable, override, UiOverrideProvider, type UiOverrideProviderProps, useUiOverride, } from "./UiOverride.d.ts";
+export { Tooltip, type TooltipProps } from "./Tooltip.d.ts";
+export { type AkanModalComponent, type AkanUiOverrideManifest, type AkanUiOverrideName, type AkanUiOverrides, type AkanUiRecipes, createOverridable, override, UiOverrideProvider, type UiOverrideProviderProps, useUiOverride, useUiRecipe, } from "./UiOverride.d.ts";
 export { Unauthorized } from "./Unauthorized.d.ts";

package/types/ui/recipe/badgeRecipe.d.ts

@@ -0,0 +1,13 @@
+/** 뱃지 look — 시맨틱 variant. `<Badge>` 가 소비하며, recipes.badge 슬롯으로 교체 가능. */
+export declare const badgeRecipe: (variants?: Omit<({
+    variant?: "default" | "error" | "info" | "warning" | "success" | "primary" | "secondary" | "accent" | "outline" | undefined;
+} & {
+    class?: import("tailwind-variants").ClassValue;
+    className?: never;
+}) | ({
+    variant?: "default" | "error" | "info" | "warning" | "success" | "primary" | "secondary" | "accent" | "outline" | undefined;
+} & {
+    class?: never;
+    className?: import("tailwind-variants").ClassValue;
+}), "class" | "className"> | undefined, className?: import("tailwind-merge").ClassNameValue) => string;
+export type BadgeVariants = NonNullable<Parameters<typeof badgeRecipe>[0]>;

package/types/ui/recipe/buttonRecipe.d.ts

@@ -0,0 +1,15 @@
+/** 버튼 look — 시맨틱 variant × size. `<Button>` 이 소비하며, `_overrides.tsx` 의 recipes.button 슬롯으로 교체 가능. */
+export declare const buttonRecipe: (variants?: Omit<({
+    size?: "lg" | "md" | "sm" | "xs" | "icon" | undefined;
+    variant?: "link" | "info" | "warning" | "success" | "primary" | "secondary" | "accent" | "destructive" | "outline" | "ghost" | undefined;
+} & {
+    class?: import("tailwind-variants").ClassValue;
+    className?: never;
+}) | ({
+    size?: "lg" | "md" | "sm" | "xs" | "icon" | undefined;
+    variant?: "link" | "info" | "warning" | "success" | "primary" | "secondary" | "accent" | "destructive" | "outline" | "ghost" | undefined;
+} & {
+    class?: never;
+    className?: import("tailwind-variants").ClassValue;
+}), "class" | "className"> | undefined, className?: import("tailwind-merge").ClassNameValue) => string;
+export type ButtonVariants = NonNullable<Parameters<typeof buttonRecipe>[0]>;

package/types/ui/recipe/factory.d.ts

@@ -0,0 +1,24 @@
+import type { ClassNameValue as ClassValue } from "tailwind-merge";
+/**
+ * recipe 팩토리 모듈 — 변형 팩토리를 만드는 **인프라**. **서버-안전** (절대 `"use client"` 금지).
+ * 실제 recipe 정의는 이 폴더의 형제 파일 하나당 하나씩 둔다 — 프레임워크는 `./<name>Recipe.ts`,
+ * 각 앱은 `apps/<app>/ui/Recipe/<name>.ts`.
+ */
+export declare const tv: import("tailwind-variants").TV;
+/**
+ * recipe 팩토리 — `tv({...})` 인스턴스를 받아 겉을 `(변형, className?)` 2-인자로 노출하고,
+ * className 병합(cn)을 안으로 숨긴다. 타입은 넘겨받은 tv 인스턴스에서 그대로 추론되어 변형 타입이
+ * 정확히 보존된다. 반환은 순수 className 문자열이라 서버-안전.
+ *
+ *   export const xRecipe = recipe(tv({ base, variants }));
+ *   xRecipe({ variant: "primary" }, "w-full")            // cn 불필요
+ *
+ * 2번째 인자는 `ClassNameValue` — 문자열 하나만이 아니라 **배열·중첩 배열·falsy 값**을 그대로 받는다.
+ * 여러 클래스를 합칠 때 `cn(...)` 으로 감쌀 이유가 없다(모르면 감싸게 되는데, cn 을 몰아내려고 만든
+ * 2-인자 계약이 거기서 새어나간다):
+ *
+ *   xRecipe({}, ["h-full", className])                   // ✅ cn 불필요
+ *   xRecipe({}, ["h-full", isWide && "w-full"])          // ✅ falsy 는 무시됨
+ *   xRecipe({}, cn("h-full", className))                 // ❌ 불필요한 래핑
+ */
+export declare const recipe: <P extends object>(styles: (props?: P) => string) => (variants?: Omit<P, "class" | "className">, className?: ClassValue) => string;

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

@@ -0,0 +1,18 @@
+/**
+ * recipe 레이어 — 프리미티브의 스타일 recipe(변형)를 모으는 **서버-안전** 폴더.
+ * **여기엔 절대 `"use client"` 를 붙이지 않는다.** 팩토리(`recipe`/`tv`)는 `./factory` 에 있다.
+ *
+ * 구조: recipe 하나당 파일 하나(`<name>Recipe.ts`), 이 index 는 재수출만 한다. 앱도 같은 구조를
+ * `apps/<app>/ui/Recipe/` 에서 계승한다.
+ *
+ * 호출 규격: `xRecipe(변형객체, 커스텀클래스?)`. 두 번째 인자 className 은 recipe 안에서 tailwind-merge 로
+ * 자동 병합되므로 호출부에서 `cn(...)` 으로 감쌀 필요가 없다. 문자열 하나만이 아니라 배열도 받는다:
+ *   buttonRecipe({ variant: "primary" }, "w-full rounded-2xl")   // ✅ cn 불필요
+ *   buttonRecipe({ variant: "primary" }, ["h-full", className])  // ✅ 배열 — 여기서도 cn 불필요
+ *
+ * 레이어: styles.css(토큰) → recipe(변형) → 컴포넌트(동작).
+ */
+export { type BadgeVariants, badgeRecipe } from "./badgeRecipe.d.ts";
+export { type ButtonVariants, buttonRecipe } from "./buttonRecipe.d.ts";
+export { recipe, tv } from "./factory.d.ts";
+export { type InputSurfaceVariants, inputRecipe } from "./inputRecipe.d.ts";

package/types/ui/recipe/inputRecipe.d.ts

@@ -0,0 +1,13 @@
+/** 입력 표면 look — Input/TextArea 가 공유하는 필드 셸. kind 로 한 줄 필드(field)/멀티라인(area)을 고른다. */
+export declare const inputRecipe: (variants?: Omit<({
+    kind?: "field" | "area" | undefined;
+} & {
+    class?: import("tailwind-variants").ClassValue;
+    className?: never;
+}) | ({
+    kind?: "field" | "area" | undefined;
+} & {
+    class?: never;
+    className?: import("tailwind-variants").ClassValue;
+}), "class" | "className"> | undefined, className?: import("tailwind-merge").ClassNameValue) => string;
+export type InputSurfaceVariants = NonNullable<Parameters<typeof inputRecipe>[0]>;

package/types/ui/recipe.d.ts

@@ -0,0 +1 @@
+export * from "./recipe/index.d.ts";

package/ui/Badge.tsx

@@ -0,0 +1,17 @@
+"use client";
+import type { HTMLAttributes } from "react";
+import { type BadgeVariants, badgeRecipe } from "./recipe";
+import { createOverridable, useUiRecipe } from "./UiOverride";
+
+export { badgeRecipe, type BadgeVariants };
+
+export type BadgeProps = HTMLAttributes<HTMLSpanElement> & BadgeVariants;
+
+const DefaultBadge = ({ className, variant, ...rest }: BadgeProps) => {
+  
+  const recipe = useUiRecipe("badge") ?? badgeRecipe;
+  return <span className={recipe({ variant }, className)} {...rest} />;
+};
+
+/** Status/label pill. Route-overridable via `page/**\/_overrides.tsx` (slot `Badge`). */
+export const Badge = createOverridable("Badge", DefaultBadge);

package/ui/BottomSheet.tsx

@@ -1,6 +1,6 @@
 "use client";
 import { useDrag } from "@use-gesture/react";
-import { clsx } from "akanjs/client";
+import { cn } from "akanjs/client";
 import { st } from "akanjs/store";
 import { animated } from "akanjs/ui";
 import { forwardRef, type ReactNode, useEffect, useImperativeHandle, useRef } from "react";
@@ -66,23 +66,21 @@ export const BottomSheet = forwardRef<BottomSheetRef, BottomSheetProps>(
             opacity,
           }}
           onClick={() => void closeModal()}
-          className={clsx("fixed top-0 left-0 size-full bg-gray-500/50", {
-            "z-50": open,
-            "-z-[1]": !open,
-          })}
+          className={cn("fixed top-0 left-0 size-full bg-muted-foreground/50", open && "z-50", !open && "-z-[1]")}
         />
         <animated.div
           ref={ref}
           style={{ y, paddingTop: type === "full" ? pageState.topSafeArea : 0 }}
-          className={clsx("fixed bottom-0 left-0 z-[101] w-full bg-base-100", {
-            "h-[90%] rounded-t-3xl": type === "half",
-            "h-[100vh]": type === "full",
-          })}
+          className={cn(
+            "fixed bottom-0 left-0 z-[101] w-full bg-background",
+            type === "half" && "h-[90%] rounded-t-3xl",
+            type === "full" && "h-[100vh]",
+          )}
         >
           <div className="flex h-8 w-full items-start justify-center pt-2">
             {type === "half" ? (
               <animated.div {...bind()} className="flex h-8 w-full items-start justify-center pt-2">
-                <div className="h-2 w-32 rounded-full bg-gray-300"></div>
+                <div className="h-2 w-32 rounded-full bg-muted"></div>
               </animated.div>
             ) : (
               <button