@mindlogic-ai/logician-ui 5.0.0-alpha.3 → 5.0.0-alpha.30

package/MIGRATION-5.0.md

@@ -82,7 +82,8 @@ row above; for the rest pick the role by use (`primary.*`, a status family,
 `fg.placeholder`, `fg.onPrimary`, `fg.link`/`fg.linkHover`,
 `primary.{hover,active,wash,washActive,selected}`,
 `secondary.{surface,surfaceStrong,border,fg,fgStrong}`, `action.*`, `send.*`,
-`count.*`, `disabled.*`, `focus.ring`, `info.*`, status
+`count.*`, `control.{on,onFg}` (on/off state), `mark.starred` (favourite,
+bookmark), `disabled.*`, `focus.ring`, `info.*`, status
 `{bg,border,fg,solid,onSolid}` (+`danger.solidHover/solidActive`), `tooltip.*`,
 `category.{hue}.{surface,fg}`, `neutral.1–12`, `secondary.1–12`. High-contrast
 values apply under `prefers-contrast: more`.
@@ -143,6 +144,44 @@ Kept as `@deprecated` exports: `ButtonColorPalette`, `buttonColorPalettes`,
 `getIconButtonStyles(variant, isDestructive)`, `getTagStyles({ tone, selected,
 category, interactive })`. `LINK_RAMP` entries are plain token strings now.
 
+### Control sizes (shared scale)
+
+Every control that takes `size` now resolves it through one table,
+`controlSizes` (`src/theme/controlSizes.ts`, exported from the package root):
+the same height, type size, inline padding, icon size and corner per size.
+`Button` is the reference and does not change.
+
+| size | height     | 14px root | 16px `ScaledContext` | type (textStyle)    |
+| ---- | ---------- | --------- | -------------------- | ------------------- |
+| xs   | `sizes.8`  | 28px      | 28px                 | `xs` (12.25 / 14px) |
+| sm   | `sizes.9`  | 31.5px    | 36px                 | `sm` (14 / 16px)    |
+| md   | `sizes.10` | 35px      | 40px                 | `sm`                |
+| lg   | `sizes.11` | 38.5px    | 44px                 | `md` (14 / 16px)    |
+
+What changes on screen:
+
+- **Interactive `Tag`** (`as="button"`, `selected`, `onClick`, a link) now has
+  the control height of its `size` (default `md`, 35px) instead of the badge
+  height (`lg` was 21px). Filter chips written as `<Tag as="button" size="lg">`
+  become 38.5px — pick `size="xs"` / `"sm"` to match the row they sit in.
+  Static tags (badges) are unchanged. `xs` is new.
+- **SegmentedControl** is 1px shorter at every size at the 14px root (it was
+  Button + 1px) and its labels use the control type (xs 10.5 → 12.25px,
+  sm / md 12.25 → 14px).
+- **Input / PasswordInput / Textarea / Select `lg` (and `xl`)** type goes back
+  to the 14 / 16px control step (was 16 / 18.3px); the height is unchanged at
+  the root, and inside a `ScaledContext` `lg` is 44px (was 50px).
+- **Combobox `lg`** is 38.5px (was 42px), like every other `lg` control.
+- **Input, Textarea, Select, Combobox** corners are 8px (`radii.md`, Button's)
+  instead of 6px.
+- **Switch label** takes the size's type (was a fixed 12.25px).
+- **SingleDatePicker / RangeDatePicker** take `size`; the trigger's calendar
+  icon follows the control icon ramp (was a fixed 21px). **MonthPicker** takes
+  `size` (was always `md`).
+
+To put your own icon in a control, size it from the same table:
+`<SearchIcon boxSize={controlSizes[size].iconBoxSize} />`.
+
 ## 4. After the codemod — what a human checks
 
 - Call sites the codemod reported (dynamic props, spreads, raw primitives).

package/README.md

@@ -93,6 +93,7 @@ function App() {
 - **Pagination** - Page navigation component
 - **Menu** - Dropdown and context menus
 - **Tabs** - Tab navigation component
+- **NavList** - Side navigation and filter rails (links or filters, not tabs)
 
 #### Feedback
 

package/USAGE.md

@@ -298,6 +298,26 @@ function App() {
 </Button>
 ```
 
+### Rows of controls (filter bars, toolbars, inline forms)
+
+Give every control in the row the same `size` and nothing else — no `h=` /
+`height` overrides. `Button`, `IconButton`, `Input`, `Select`, `Combobox`,
+`SegmentedControl`, interactive `Tag`, the date-picker triggers and `Tabs` all
+resolve `size` through the shared `controlSizes` scale, so they share height,
+type, padding and corner per size (also inside `ScaledContext`). See the
+Storybook page **Foundations / Control sizes**.
+
+```tsx
+<HStack gap="2">
+  <SegmentedControl size="sm" options={views} />
+  <Tag as="button" size="sm" selected>전체 22</Tag>
+  <Input size="sm" leftIcon={<SearchIcon boxSize={controlSizes.sm.iconBoxSize} />} />
+  <SelectField size="sm" options={sortOptions} ariaLabel="정렬" />
+  <RangeDatePicker size="sm" selectedDates={dates} onDateChange={setDates} />
+  <IconButton size="sm" aria-label="필터"><FilterIcon boxSize={controlSizes.sm.iconBoxSize} /></IconButton>
+</HStack>
+```
+
 ### 5. Actions in Feedback Surfaces
 
 - A toast takes at most one action, through the `action` prop; dismiss is the ×

package/dist/components/Avatar/Avatar.d.ts

@@ -1,7 +1,24 @@
-import { Avatar as ChakraAvatar, AvatarRootProps as ChakraAvatarRootProps } from '@chakra-ui/react';
+import { type ComponentProps, type ForwardRefExoticComponent, type ReactNode, type RefAttributes } from 'react';
+import { AvatarGroupProps as ChakraAvatarGroupProps, AvatarRootProps as ChakraAvatarRootProps, AvatarRootProvider as ChakraAvatarRootProvider, type ConditionalValue } from '@chakra-ui/react';
 import { SystemHue } from '@/theme/colors';
-export type { AvatarFallbackProps, AvatarGroupProps, AvatarIconProps, AvatarImageProps, AvatarRootProps, } from '@chakra-ui/react';
-export type AvatarProps = ChakraAvatarRootProps & {
+export type { AvatarFallbackProps, AvatarIconProps, AvatarImageProps, } from '@chakra-ui/react';
+/**
+ * Chakra's variants plus Logician's `logo`. Chakra types `variant` from its
+ * own recipe, so the theme-level `logo` variant needs widening here.
+ */
+export type AvatarVariant = 'subtle' | 'solid' | 'outline' | 'logo';
+/** `P` with `variant` widened to {@link AvatarVariant}. */
+type WithAvatarVariant<P> = Omit<P, 'variant'> & {
+    /**
+     * `subtle` (default): the `colorPalette` fill — a person's category hue, or
+     * the neutral pair. `logo`: the light `bg.logo` tile for model, chatbot and
+     * brand marks, the same in both modes.
+     */
+    variant?: ConditionalValue<AvatarVariant>;
+};
+export type AvatarRootProps = WithAvatarVariant<ChakraAvatarRootProps>;
+export type AvatarRootProviderProps = WithAvatarVariant<ComponentProps<typeof ChakraAvatarRootProvider>>;
+export type AvatarProps = AvatarRootProps & {
     src?: string;
     name?: string;
     /**
@@ -14,6 +31,15 @@ export type AvatarProps = ChakraAvatarRootProps & {
      */
     colorHue?: SystemHue;
 };
+export interface AvatarGroupProps extends Omit<WithAvatarVariant<ChakraAvatarGroupProps>, 'children'> {
+    children?: ReactNode;
+    /**
+     * Show at most this many avatars; the rest collapse into a trailing "+N"
+     * counter in the neutral pair. Omit to show all. Chakra 3 dropped 2.x's
+     * `max`; this restores it.
+     */
+    max?: number;
+}
 /**
  * A stable hash of `name` into one of `SYSTEM_HUE_NAMES`, so a given name
  * always lands on the same hue (no lookup table, nothing to keep in sync) and
@@ -24,15 +50,32 @@ export type AvatarProps = ChakraAvatarRootProps & {
  */
 export declare function hueForName(name: string): SystemHue;
 export declare function hueForName(name: string | undefined): SystemHue | undefined;
+/**
+ * The `colorPalette` an avatar paints with: `category.<hue>` for a person
+ * (`colorHue`, else {@link hueForName}), `category.neutral` with no name. The
+ * avatar recipe maps `colorPalette.surface` / `colorPalette.fg` onto it.
+ */
+export declare function avatarColorPalette(name: string | undefined, colorHue?: SystemHue): `category.${SystemHue | 'neutral'}`;
 /**
  * Fallback (initials / icon) colours: the person's hue when there is one,
  * otherwise the neutral pair Badge `neutral` uses.
+ *
+ * @deprecated The avatar recipe now paints the root from `colorPalette` (see
+ * {@link avatarColorPalette}); `Avatar` no longer calls this. Kept for
+ * callers that colour a non-avatar element to match a person. Removed in 6.0.
  */
 export declare function avatarFallbackColors(name: string | undefined, colorHue?: SystemHue): {
     bg: string;
     color: string;
 };
-export declare const Avatar: import("react").ForwardRefExoticComponent<ChakraAvatar.RootProps & {
+export declare const Avatar: ForwardRefExoticComponent<Omit<ChakraAvatarRootProps, "variant"> & {
+    /**
+     * `subtle` (default): the `colorPalette` fill — a person's category hue, or
+     * the neutral pair. `logo`: the light `bg.logo` tile for model, chatbot and
+     * brand marks, the same in both modes.
+     */
+    variant?: ConditionalValue<AvatarVariant>;
+} & {
     src?: string;
     name?: string;
     /**
@@ -44,13 +87,27 @@ export declare const Avatar: import("react").ForwardRefExoticComponent<ChakraAva
      * (`bg.muted` / `secondary.fgStrong`), not a hue.
      */
     colorHue?: SystemHue;
-} & import("react").RefAttributes<HTMLDivElement>> & {
-    Root: import("react").ForwardRefExoticComponent<ChakraAvatar.RootProps & import("react").RefAttributes<HTMLDivElement>>;
-    RootProvider: import("react").ForwardRefExoticComponent<import("node_modules/@chakra-ui/react/dist/types/components/avatar/avatar").AvatarRootProviderProps & import("react").RefAttributes<HTMLDivElement>>;
-    Fallback: import("react").ForwardRefExoticComponent<ChakraAvatar.FallbackProps & import("react").RefAttributes<HTMLDivElement>>;
-    Image: import("react").ForwardRefExoticComponent<ChakraAvatar.ImageProps & import("react").RefAttributes<HTMLImageElement>>;
-    Icon: import("react").ForwardRefExoticComponent<ChakraAvatar.IconProps & import("react").RefAttributes<SVGElement>>;
-    Group: import("react").ForwardRefExoticComponent<import("@chakra-ui/react").AvatarGroupProps & import("react").RefAttributes<HTMLDivElement>>;
+} & RefAttributes<HTMLDivElement>> & {
+    Root: ForwardRefExoticComponent<Omit<ChakraAvatarRootProps, "variant"> & {
+        /**
+         * `subtle` (default): the `colorPalette` fill — a person's category hue, or
+         * the neutral pair. `logo`: the light `bg.logo` tile for model, chatbot and
+         * brand marks, the same in both modes.
+         */
+        variant?: ConditionalValue<AvatarVariant>;
+    } & RefAttributes<HTMLDivElement>>;
+    RootProvider: ForwardRefExoticComponent<Omit<import("node_modules/@chakra-ui/react/dist/types/components/avatar/avatar").AvatarRootProviderProps & RefAttributes<HTMLDivElement>, "variant"> & {
+        /**
+         * `subtle` (default): the `colorPalette` fill — a person's category hue, or
+         * the neutral pair. `logo`: the light `bg.logo` tile for model, chatbot and
+         * brand marks, the same in both modes.
+         */
+        variant?: ConditionalValue<AvatarVariant>;
+    } & RefAttributes<HTMLDivElement>>;
+    Fallback: ForwardRefExoticComponent<import("@chakra-ui/react").AvatarFallbackProps & RefAttributes<HTMLDivElement>>;
+    Image: ForwardRefExoticComponent<import("@chakra-ui/react").AvatarImageProps & RefAttributes<HTMLImageElement>>;
+    Icon: ForwardRefExoticComponent<import("@chakra-ui/react").AvatarIconProps & RefAttributes<SVGElement>>;
+    Group: ForwardRefExoticComponent<AvatarGroupProps & RefAttributes<HTMLDivElement>>;
     Context: (props: import("@ark-ui/react").AvatarContextProps) => import("react").ReactNode;
 };
 //# sourceMappingURL=Avatar.d.ts.map

package/dist/components/Avatar/Avatar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Avatar.d.ts","sourceRoot":"","sources":["../../../src/components/Avatar/Avatar.tsx"],"names":[],"mappings":"AACA,OAAO,EACL,MAAM,IAAI,YAAY,EAOtB,eAAe,IAAI,qBAAqB,EAEzC,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAoB,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE7D,YAAY,EACV,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,MAAM,WAAW,GAAG,qBAAqB,GAAG;IAChD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;AACpD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AAgB5E;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,QAAQ,CAAC,EAAE,SAAS,GACnB;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAI/B;AA4BD,eAAO,MAAM,MAAM;UA7EX,MAAM;WACL,MAAM;IACb;;;;;;;OAOG;eACQ,SAAS;;;;;;;;;CA2EpB,CAAC"}
+{"version":3,"file":"Avatar.d.ts","sourceRoot":"","sources":["../../../src/components/Avatar/Avatar.tsx"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EAEnB,KAAK,yBAAyB,EAC9B,KAAK,SAAS,EACd,KAAK,aAAa,EACnB,MAAM,OAAO,CAAC;AACf,OAAO,EAIL,gBAAgB,IAAI,sBAAsB,EAI1C,eAAe,IAAI,qBAAqB,EACxC,kBAAkB,IAAI,wBAAwB,EAC9C,KAAK,gBAAgB,EACtB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAoB,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE7D,YAAY,EACV,mBAAmB,EACnB,eAAe,EACf,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAE1B;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAEpE,2DAA2D;AAC3D,KAAK,iBAAiB,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,SAAS,CAAC,GAAG;IAC/C;;;;OAIG;IACH,OAAO,CAAC,EAAE,gBAAgB,CAAC,aAAa,CAAC,CAAC;CAC3C,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,iBAAiB,CAAC,qBAAqB,CAAC,CAAC;AACvE,MAAM,MAAM,uBAAuB,GAAG,iBAAiB,CACrD,cAAc,CAAC,OAAO,wBAAwB,CAAC,CAChD,CAAC;AAcF,MAAM,MAAM,WAAW,GAAG,eAAe,GAAG;IAC1C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB,CAAC;AAEF,MAAM,WAAW,gBAAiB,SAAQ,IAAI,CAC5C,iBAAiB,CAAC,sBAAsB,CAAC,EACzC,UAAU,CACX;IACC,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;AACpD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AAgB5E;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,QAAQ,CAAC,EAAE,SAAS,GACnB,YAAY,SAAS,GAAG,SAAS,EAAE,CAGrC;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,QAAQ,CAAC,EAAE,SAAS,GACnB;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAI/B;AAwDD,eAAO,MAAM,MAAM;IAjKjB;;;;OAIG;cACO,gBAAgB,CAAC,aAAa,CAAC;;UAqBnC,MAAM;WACL,MAAM;IACb;;;;;;;OAOG;eACQ,SAAS;;;QApCpB;;;;WAIG;kBACO,gBAAgB,CAAC,aAAa,CAAC;;;QALzC;;;;WAIG;kBACO,gBAAgB,CAAC,aAAa,CAAC;;;;;;;CAoKzC,CAAC"}

package/dist/components/Avatar/Avatar.js

@@ -6,6 +6,10 @@ var React = require('react');
 var react = require('@chakra-ui/react');
 var colors = require('../../theme/colors.js');
 
+// Chakra's parts, typed for the `logo` variant.
+const AvatarRoot = react.AvatarRoot;
+const AvatarRootProvider = react.AvatarRootProvider;
+const ChakraAvatarGroupTyped = react.AvatarGroup;
 function hueForName(name) {
     // No name, no identity to colour: `undefined` so the caller falls back to
     // the neutral pair. `SYSTEM_HUE_NAMES[0]` is red, and a red placeholder
@@ -21,9 +25,22 @@ function hueForName(name) {
     const index = Math.abs(hash) % colors.SYSTEM_HUE_NAMES.length;
     return colors.SYSTEM_HUE_NAMES[index];
 }
+/**
+ * The `colorPalette` an avatar paints with: `category.<hue>` for a person
+ * (`colorHue`, else {@link hueForName}), `category.neutral` with no name. The
+ * avatar recipe maps `colorPalette.surface` / `colorPalette.fg` onto it.
+ */
+function avatarColorPalette(name, colorHue) {
+    const hue = colorHue ?? hueForName(name);
+    return hue ? `category.${hue}` : 'category.neutral';
+}
 /**
  * Fallback (initials / icon) colours: the person's hue when there is one,
  * otherwise the neutral pair Badge `neutral` uses.
+ *
+ * @deprecated The avatar recipe now paints the root from `colorPalette` (see
+ * {@link avatarColorPalette}); `Avatar` no longer calls this. Kept for
+ * callers that colour a non-avatar element to match a person. Removed in 6.0.
  */
 function avatarFallbackColors(name, colorHue) {
     const hue = colorHue ?? hueForName(name);
@@ -31,23 +48,42 @@ function avatarFallbackColors(name, colorHue) {
         return { bg: 'bg.muted', color: 'secondary.fgStrong' };
     return { bg: `category.${hue}.surface`, color: `category.${hue}.fg` };
 }
+/**
+ * Chakra's `AvatarGroup` (overlapping avatars; `size` / `variant` reach every
+ * child through the recipe props context) with the `max` overflow cap. The
+ * counter is always the neutral `subtle` pair, whatever the group's variant:
+ * it is a count, not a person or a logo.
+ */
+const AvatarGroup = React.forwardRef(({ max, children, ...rest }, ref) => {
+    const items = React.Children.toArray(children);
+    const visible = typeof max === 'number' ? items.slice(0, Math.max(0, max)) : items;
+    const overflow = items.length - visible.length;
+    return (jsxRuntime.jsxs(ChakraAvatarGroupTyped, { ref: ref, ...rest, children: [visible, overflow > 0 && (
+            // Spans so a group inside a button (a popover trigger) stays phrasing
+            // content; the recipe sets the display, so nothing else changes.
+            jsxRuntime.jsx(AvatarRoot, { as: "span", colorPalette: "category.neutral", variant: "subtle", children: jsxRuntime.jsxs(react.AvatarFallback, { as: "span", children: ["+", overflow] }) }))] }));
+});
+AvatarGroup.displayName = 'AvatarGroup';
 const AvatarComponent = React.forwardRef((props, ref) => {
     const { src, name, colorHue, ...rest } = props;
-    const fallback = avatarFallbackColors(name, colorHue);
-    return (jsxRuntime.jsxs(react.Avatar.Root, { ref: ref, borderWidth: "1px", borderColor: "border.subtle", overflow: "hidden", bgColor: "transparent", ...rest, children: [jsxRuntime.jsx(react.Avatar.Fallback, { name: name, bg: fallback.bg, color: fallback.color }), jsxRuntime.jsx(react.Avatar.Image, { src: src })] }));
+    // Fill, text colour, border and the full-circle fallback all come from
+    // the avatar recipe (src/theme/recipes/avatar.ts); only the palette is
+    // chosen here. A caller's own `colorPalette` still wins.
+    return (jsxRuntime.jsxs(AvatarRoot, { ref: ref, colorPalette: avatarColorPalette(name, colorHue), ...rest, children: [jsxRuntime.jsx(react.AvatarFallback, { name: name }), jsxRuntime.jsx(react.AvatarImage, { src: src })] }));
 });
 AvatarComponent.displayName = 'Avatar';
 const Avatar = Object.assign(AvatarComponent, {
-    Root: react.AvatarRoot,
-    RootProvider: react.AvatarRootProvider,
+    Root: AvatarRoot,
+    RootProvider: AvatarRootProvider,
     Fallback: react.AvatarFallback,
     Image: react.AvatarImage,
     Icon: react.AvatarIcon,
-    Group: react.AvatarGroup,
+    Group: AvatarGroup,
     Context: react.AvatarContext,
 });
 
 exports.Avatar = Avatar;
+exports.avatarColorPalette = avatarColorPalette;
 exports.avatarFallbackColors = avatarFallbackColors;
 exports.hueForName = hueForName;
 //# sourceMappingURL=Avatar.js.map

package/dist/components/Avatar/Avatar.js.map

@@ -1 +1 @@
-{"version":3,"file":"Avatar.js","sources":["../../../src/components/Avatar/Avatar.tsx"],"sourcesContent":[null],"names":["SYSTEM_HUE_NAMES","forwardRef","_jsxs","ChakraAvatar","_jsx","AvatarRoot","AvatarRootProvider","AvatarFallback","AvatarImage","AvatarIcon","AvatarGroup","AvatarContext"],"mappings":";;;;;;;;AA+CM,SAAU,UAAU,CAAC,IAAwB,EAAA;;;;AAIjD,IAAA,IAAI,CAAC,IAAI;AAAE,QAAA,OAAO,SAAS;IAC3B,IAAI,IAAI,GAAG,CAAC;AACZ,IAAA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE;;;AAGvC,QAAA,IAAI,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7C;AACA,IAAA,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAGA,uBAAgB,CAAC,MAAM;AACtD,IAAA,OAAOA,uBAAgB,CAAC,KAAK,CAAC;AAChC;AAEA;;;AAGG;AACG,SAAU,oBAAoB,CAClC,IAAwB,EACxB,QAAoB,EAAA;IAEpB,MAAM,GAAG,GAAG,QAAQ,IAAI,UAAU,CAAC,IAAI,CAAC;AACxC,IAAA,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,oBAAoB,EAAE;AAChE,IAAA,OAAO,EAAE,EAAE,EAAE,CAAA,SAAA,EAAY,GAAG,CAAA,QAAA,CAAU,EAAE,KAAK,EAAE,CAAA,SAAA,EAAY,GAAG,CAAA,GAAA,CAAK,EAAE;AACvE;AAEA,MAAM,eAAe,GAAGC,gBAAU,CAChC,CAAC,KAAK,EAAE,GAAG,KAAI;AACb,IAAA,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK;IAC9C,MAAM,QAAQ,GAAG,oBAAoB,CAAC,IAAI,EAAE,QAAQ,CAAC;AACrD,IAAA,QACEC,eAAA,CAACC,YAAY,CAAC,IAAI,EAAA,EAChB,GAAG,EAAE,GAAG,EACR,WAAW,EAAC,KAAK,EACjB,WAAW,EAAC,eAAe,EAC3B,QAAQ,EAAC,QAAQ,EACjB,OAAO,EAAC,aAAa,EAAA,GACjB,IAAI,EAAA,QAAA,EAAA,CAERC,cAAA,CAACD,YAAY,CAAC,QAAQ,EAAA,EACpB,IAAI,EAAE,IAAI,EACV,EAAE,EAAE,QAAQ,CAAC,EAAE,EACf,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAA,CACrB,EACFC,cAAA,CAACD,YAAY,CAAC,KAAK,EAAA,EAAC,GAAG,EAAE,GAAG,EAAA,CAAI,CAAA,EAAA,CACd;AAExB,CAAC,CACF;AAED,eAAe,CAAC,WAAW,GAAG,QAAQ;MAEzB,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,eAAe,EAAE;AACnD,IAAA,IAAI,EAAEE,gBAAU;AAChB,IAAA,YAAY,EAAEC,wBAAkB;AAChC,IAAA,QAAQ,EAAEC,oBAAc;AACxB,IAAA,KAAK,EAAEC,iBAAW;AAClB,IAAA,IAAI,EAAEC,gBAAU;AAChB,IAAA,KAAK,EAAEC,iBAAW;AAClB,IAAA,OAAO,EAAEC,mBAAa;AACvB,CAAA;;;;;;"}
+{"version":3,"file":"Avatar.js","sources":["../../../src/components/Avatar/Avatar.tsx"],"sourcesContent":[null],"names":["ChakraAvatarRoot","ChakraAvatarRootProvider","ChakraAvatarGroup","SYSTEM_HUE_NAMES","forwardRef","Children","_jsxs","_jsx","AvatarFallback","AvatarImage","AvatarIcon","AvatarContext"],"mappings":"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"}

package/dist/components/Avatar/Avatar.mjs

@@ -1,9 +1,13 @@
 "use client";
 import { jsxs, jsx } from 'react/jsx-runtime';
-import { forwardRef } from 'react';
-import { Avatar as Avatar$1, AvatarContext, AvatarGroup, AvatarIcon, AvatarImage, AvatarFallback, AvatarRootProvider, AvatarRoot } from '@chakra-ui/react';
+import { forwardRef, Children } from 'react';
+import { AvatarGroup as AvatarGroup$1, AvatarRoot as AvatarRoot$1, AvatarFallback, AvatarImage, AvatarContext, AvatarIcon, AvatarRootProvider as AvatarRootProvider$1 } from '@chakra-ui/react';
 import { SYSTEM_HUE_NAMES } from '../../theme/colors.mjs';
 
+// Chakra's parts, typed for the `logo` variant.
+const AvatarRoot = AvatarRoot$1;
+const AvatarRootProvider = AvatarRootProvider$1;
+const ChakraAvatarGroupTyped = AvatarGroup$1;
 function hueForName(name) {
     // No name, no identity to colour: `undefined` so the caller falls back to
     // the neutral pair. `SYSTEM_HUE_NAMES[0]` is red, and a red placeholder
@@ -19,9 +23,22 @@ function hueForName(name) {
     const index = Math.abs(hash) % SYSTEM_HUE_NAMES.length;
     return SYSTEM_HUE_NAMES[index];
 }
+/**
+ * The `colorPalette` an avatar paints with: `category.<hue>` for a person
+ * (`colorHue`, else {@link hueForName}), `category.neutral` with no name. The
+ * avatar recipe maps `colorPalette.surface` / `colorPalette.fg` onto it.
+ */
+function avatarColorPalette(name, colorHue) {
+    const hue = colorHue ?? hueForName(name);
+    return hue ? `category.${hue}` : 'category.neutral';
+}
 /**
  * Fallback (initials / icon) colours: the person's hue when there is one,
  * otherwise the neutral pair Badge `neutral` uses.
+ *
+ * @deprecated The avatar recipe now paints the root from `colorPalette` (see
+ * {@link avatarColorPalette}); `Avatar` no longer calls this. Kept for
+ * callers that colour a non-avatar element to match a person. Removed in 6.0.
  */
 function avatarFallbackColors(name, colorHue) {
     const hue = colorHue ?? hueForName(name);
@@ -29,10 +46,28 @@ function avatarFallbackColors(name, colorHue) {
         return { bg: 'bg.muted', color: 'secondary.fgStrong' };
     return { bg: `category.${hue}.surface`, color: `category.${hue}.fg` };
 }
+/**
+ * Chakra's `AvatarGroup` (overlapping avatars; `size` / `variant` reach every
+ * child through the recipe props context) with the `max` overflow cap. The
+ * counter is always the neutral `subtle` pair, whatever the group's variant:
+ * it is a count, not a person or a logo.
+ */
+const AvatarGroup = forwardRef(({ max, children, ...rest }, ref) => {
+    const items = Children.toArray(children);
+    const visible = typeof max === 'number' ? items.slice(0, Math.max(0, max)) : items;
+    const overflow = items.length - visible.length;
+    return (jsxs(ChakraAvatarGroupTyped, { ref: ref, ...rest, children: [visible, overflow > 0 && (
+            // Spans so a group inside a button (a popover trigger) stays phrasing
+            // content; the recipe sets the display, so nothing else changes.
+            jsx(AvatarRoot, { as: "span", colorPalette: "category.neutral", variant: "subtle", children: jsxs(AvatarFallback, { as: "span", children: ["+", overflow] }) }))] }));
+});
+AvatarGroup.displayName = 'AvatarGroup';
 const AvatarComponent = forwardRef((props, ref) => {
     const { src, name, colorHue, ...rest } = props;
-    const fallback = avatarFallbackColors(name, colorHue);
-    return (jsxs(Avatar$1.Root, { ref: ref, borderWidth: "1px", borderColor: "border.subtle", overflow: "hidden", bgColor: "transparent", ...rest, children: [jsx(Avatar$1.Fallback, { name: name, bg: fallback.bg, color: fallback.color }), jsx(Avatar$1.Image, { src: src })] }));
+    // Fill, text colour, border and the full-circle fallback all come from
+    // the avatar recipe (src/theme/recipes/avatar.ts); only the palette is
+    // chosen here. A caller's own `colorPalette` still wins.
+    return (jsxs(AvatarRoot, { ref: ref, colorPalette: avatarColorPalette(name, colorHue), ...rest, children: [jsx(AvatarFallback, { name: name }), jsx(AvatarImage, { src: src })] }));
 });
 AvatarComponent.displayName = 'Avatar';
 const Avatar = Object.assign(AvatarComponent, {
@@ -45,5 +80,5 @@ const Avatar = Object.assign(AvatarComponent, {
     Context: AvatarContext,
 });
 
-export { Avatar, avatarFallbackColors, hueForName };
+export { Avatar, avatarColorPalette, avatarFallbackColors, hueForName };
 //# sourceMappingURL=Avatar.mjs.map

package/dist/components/Avatar/Avatar.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"Avatar.mjs","sources":["../../../src/components/Avatar/Avatar.tsx"],"sourcesContent":[null],"names":["_jsxs","ChakraAvatar","_jsx"],"mappings":";;;;;;AA+CM,SAAU,UAAU,CAAC,IAAwB,EAAA;;;;AAIjD,IAAA,IAAI,CAAC,IAAI;AAAE,QAAA,OAAO,SAAS;IAC3B,IAAI,IAAI,GAAG,CAAC;AACZ,IAAA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE;;;AAGvC,QAAA,IAAI,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7C;AACA,IAAA,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,MAAM;AACtD,IAAA,OAAO,gBAAgB,CAAC,KAAK,CAAC;AAChC;AAEA;;;AAGG;AACG,SAAU,oBAAoB,CAClC,IAAwB,EACxB,QAAoB,EAAA;IAEpB,MAAM,GAAG,GAAG,QAAQ,IAAI,UAAU,CAAC,IAAI,CAAC;AACxC,IAAA,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,oBAAoB,EAAE;AAChE,IAAA,OAAO,EAAE,EAAE,EAAE,CAAA,SAAA,EAAY,GAAG,CAAA,QAAA,CAAU,EAAE,KAAK,EAAE,CAAA,SAAA,EAAY,GAAG,CAAA,GAAA,CAAK,EAAE;AACvE;AAEA,MAAM,eAAe,GAAG,UAAU,CAChC,CAAC,KAAK,EAAE,GAAG,KAAI;AACb,IAAA,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK;IAC9C,MAAM,QAAQ,GAAG,oBAAoB,CAAC,IAAI,EAAE,QAAQ,CAAC;AACrD,IAAA,QACEA,IAAA,CAACC,QAAY,CAAC,IAAI,EAAA,EAChB,GAAG,EAAE,GAAG,EACR,WAAW,EAAC,KAAK,EACjB,WAAW,EAAC,eAAe,EAC3B,QAAQ,EAAC,QAAQ,EACjB,OAAO,EAAC,aAAa,EAAA,GACjB,IAAI,EAAA,QAAA,EAAA,CAERC,GAAA,CAACD,QAAY,CAAC,QAAQ,EAAA,EACpB,IAAI,EAAE,IAAI,EACV,EAAE,EAAE,QAAQ,CAAC,EAAE,EACf,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAA,CACrB,EACFC,GAAA,CAACD,QAAY,CAAC,KAAK,EAAA,EAAC,GAAG,EAAE,GAAG,EAAA,CAAI,CAAA,EAAA,CACd;AAExB,CAAC,CACF;AAED,eAAe,CAAC,WAAW,GAAG,QAAQ;MAEzB,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,eAAe,EAAE;AACnD,IAAA,IAAI,EAAE,UAAU;AAChB,IAAA,YAAY,EAAE,kBAAkB;AAChC,IAAA,QAAQ,EAAE,cAAc;AACxB,IAAA,KAAK,EAAE,WAAW;AAClB,IAAA,IAAI,EAAE,UAAU;AAChB,IAAA,KAAK,EAAE,WAAW;AAClB,IAAA,OAAO,EAAE,aAAa;AACvB,CAAA;;;;"}
+{"version":3,"file":"Avatar.mjs","sources":["../../../src/components/Avatar/Avatar.tsx"],"sourcesContent":[null],"names":["ChakraAvatarRoot","ChakraAvatarRootProvider","ChakraAvatarGroup","_jsxs","_jsx"],"mappings":"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"}

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

@@ -1,3 +1,3 @@
-export type { AvatarFallbackProps, AvatarGroupProps, AvatarIconProps, AvatarImageProps, AvatarProps, AvatarRootProps, } from './Avatar';
-export { Avatar, avatarFallbackColors, hueForName } from './Avatar';
+export type { AvatarFallbackProps, AvatarGroupProps, AvatarIconProps, AvatarImageProps, AvatarProps, AvatarRootProps, AvatarRootProviderProps, AvatarVariant, } from './Avatar';
+export { Avatar, avatarColorPalette, avatarFallbackColors, hueForName, } from './Avatar';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/Avatar/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/Avatar/index.tsx"],"names":[],"mappings":"AAAA,YAAY,EACV,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,eAAe,GAChB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,MAAM,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/Avatar/index.tsx"],"names":[],"mappings":"AAAA,YAAY,EACV,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,eAAe,EACf,uBAAuB,EACvB,aAAa,GACd,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,MAAM,EACN,kBAAkB,EAClB,oBAAoB,EACpB,UAAU,GACX,MAAM,UAAU,CAAC"}

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

@@ -1,8 +1,31 @@
 import { BoxProps } from '@chakra-ui/react';
 export type BannerSize = 'sm' | 'md' | 'lg';
+/**
+ * Banner variants (5.0).
+ *
+ * - `info` (default): a system fact the reader should know before acting
+ *   (a setting that is locked, where a value comes from). Nothing is wrong.
+ * - `success`: something finished and the result stays relevant on this
+ *   screen.
+ * - `warning`: it still works, but read this first (irreversible step,
+ *   something expiring).
+ * - `danger`: it failed or is blocked, and the reader has to do something.
+ * - `neutral`: a brand notice with no status (`primary.main` accent bar).
+ */
+export type BannerVariant = 'info' | 'success' | 'warning' | 'danger' | 'neutral';
 export interface BannerProps extends BoxProps {
-    variant?: 'info' | 'success' | 'warning' | 'danger' | 'neutral';
+    /**
+     * Meaning of the message. Status variants only for a status every reader
+     * shares; `neutral` for a notice with none.
+     * @default 'info'
+     */
+    variant?: BannerVariant;
+    /** Hide the leading status icon. The text must still say the status. */
     hideIcon?: boolean;
+    /**
+     * `sm` = subtext, `md` = body text, `lg` = h5 text style.
+     * @default 'md'
+     */
     size?: BannerSize;
 }
 //# sourceMappingURL=Banner.types.d.ts.map

package/dist/components/Banner/Banner.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Banner.types.d.ts","sourceRoot":"","sources":["../../../src/components/Banner/Banner.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE5C,MAAM,WAAW,WAAY,SAAQ,QAAQ;IAC3C,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;IAChE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB"}
+{"version":3,"file":"Banner.types.d.ts","sourceRoot":"","sources":["../../../src/components/Banner/Banner.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE5C;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,aAAa,GACrB,MAAM,GACN,SAAS,GACT,SAAS,GACT,QAAQ,GACR,SAAS,CAAC;AAEd,MAAM,WAAW,WAAY,SAAQ,QAAQ;IAC3C;;;;OAIG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB"}

package/dist/components/BottomSheet/BottomSheet.styles.d.ts

@@ -3,7 +3,7 @@
  * (`header` / `body` / `footer`) that have no machine behaviour of their own —
  * the same extension Chakra makes for its dialog-backed `Drawer`.
  */
-export declare const bottomSheetAnatomy: import("@zag-js/anatomy").AnatomyInstance<"content" | "body" | "footer" | "header" | "title" | "positioner" | "description" | "trigger" | "backdrop" | "grabber" | "grabberIndicator" | "closeTrigger" | "swipeArea">;
+export declare const bottomSheetAnatomy: import("@zag-js/anatomy").AnatomyInstance<"content" | "body" | "footer" | "header" | "title" | "description" | "positioner" | "trigger" | "backdrop" | "grabber" | "grabberIndicator" | "closeTrigger" | "swipeArea">;
 /**
  * The BottomSheet's slot recipe.
  *
@@ -28,5 +28,5 @@ export declare const bottomSheetAnatomy: import("@zag-js/anatomy").AnatomyInstan
  * drops to `motion.instant` so the sheet lands on its snap point without
  * travelling there.
  */
-export declare const bottomSheetSlotRecipe: import("@chakra-ui/react").SlotRecipeDefinition<"content" | "body" | "footer" | "header" | "title" | "positioner" | "description" | "trigger" | "backdrop" | "grabber" | "grabberIndicator" | "closeTrigger" | "swipeArea", import("@chakra-ui/react").SlotRecipeVariantRecord<"content" | "body" | "footer" | "header" | "title" | "positioner" | "description" | "trigger" | "backdrop" | "grabber" | "grabberIndicator" | "closeTrigger" | "swipeArea">>;
+export declare const bottomSheetSlotRecipe: import("@chakra-ui/react").SlotRecipeDefinition<"content" | "body" | "footer" | "header" | "title" | "description" | "positioner" | "trigger" | "backdrop" | "grabber" | "grabberIndicator" | "closeTrigger" | "swipeArea", import("@chakra-ui/react").SlotRecipeVariantRecord<"content" | "body" | "footer" | "header" | "title" | "description" | "positioner" | "trigger" | "backdrop" | "grabber" | "grabberIndicator" | "closeTrigger" | "swipeArea">>;
 //# sourceMappingURL=BottomSheet.styles.d.ts.map

package/dist/components/Button/Button.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Button.d.ts","sourceRoot":"","sources":["../../../src/components/Button/Button.tsx"],"names":[],"mappings":"AAaA,OAAO,EAAE,cAAc,EAA8B,MAAM,gBAAgB,CAAC;AA8J5E,eAAO,MAAM,MAAM,gEAA0C,CAAC"}
+{"version":3,"file":"Button.d.ts","sourceRoot":"","sources":["../../../src/components/Button/Button.tsx"],"names":[],"mappings":"AAcA,OAAO,EAAE,cAAc,EAA8B,MAAM,gBAAgB,CAAC;AAwM5E,eAAO,MAAM,MAAM,gEAA0C,CAAC"}

package/dist/components/Button/Button.js

@@ -4,6 +4,7 @@
 var jsxRuntime = require('react/jsx-runtime');
 var React = require('react');
 var react = require('@chakra-ui/react');
+var useTranslate = require('../../hooks/useTranslate.js');
 var focusRing = require('../../utils/focusRing.js');
 var mergeCss = require('../../utils/mergeCss.js');
 var polymorphic = require('../../types/polymorphic.js');
@@ -27,11 +28,18 @@ var Button_styles = require('./Button.styles.js');
  * <Button as="a" href="/docs" target="_blank">문서</Button>
  * ```
  */
-const ButtonImpl = React.forwardRef(({ variant: variantProp, isDestructive: isDestructiveProp = false, size, lift, children, _hover: hoverProp, _active: activeProp, _disabled: disabledProp, css: cssProp, ...restWithLegacy }, ref) => {
+const ButtonImpl = React.forwardRef(({ variant: variantProp, isDestructive: isDestructiveProp = false, size, lift, disabled, focusableWhenDisabled = false, onDisabledClick, onClick, children, _hover: hoverProp, _active: activeProp, _disabled: disabledProp, css: cssProp, ...restWithLegacy }, ref) => {
     // 4.x callers (untyped JS, `as any`) can still hand us `colorPalette` and
     // an old variant name. Strip it so it never reaches Chakra's own recipe,
     // and map the pair onto a 5.0 role — see `Button.legacy.ts`.
-    const { colorPalette: legacyPalette, ...rest } = restWithLegacy;
+    const { colorPalette: legacyPalette, loadingText: loadingTextProp, ...rest } = restWithLegacy;
+    // A busy button says what it is doing: 처리 중 unless the call site names
+    // the verb (저장 중). `loadingText={null}` opts out — spinner only, and the
+    // button keeps its width.
+    const translate = useTranslate.useTranslate();
+    const loadingText = loadingTextProp === undefined
+        ? translate('processing')
+        : (loadingTextProp ?? undefined);
     let variant = variantProp ?? 'subtle';
     let isDestructive = isDestructiveProp;
     if (Button_legacy.isLegacyButtonProps('button', legacyPalette, variantProp)) {
@@ -41,6 +49,23 @@ const ButtonImpl = React.forwardRef(({ variant: variantProp, isDestructive: isDe
         isDestructive = isDestructive || resolved.isDestructive;
     }
     const base = Button_styles.getButtonStyles(variant, isDestructive);
+    // `focusableWhenDisabled`: disabled by ARIA, not by the attribute, so the
+    // button stays focusable and can answer a press. `aria-disabled=true` is
+    // in Chakra's `_disabled` condition, so the disabled colours and cursor
+    // still apply; `data-disabled` is what `_hover` / `_active` exclude, so
+    // without it the button would still react to the pointer. `loading` keeps
+    // the native attribute (Chakra sets it) — see `focusableWhenDisabled`.
+    const softDisabled = !!disabled && focusableWhenDisabled && !rest.loading;
+    const handleClick = softDisabled
+        ? (event) => {
+            // Also what stops a `type="submit"` button from submitting.
+            event.preventDefault();
+            // A native disabled button sends no click to its ancestors either —
+            // a clickable row around it must not run its own action.
+            event.stopPropagation();
+            onDisabledClick?.(event);
+        }
+        : onClick;
     // Merged rather than spread after: each variant already owns `_hover` and
     // `_active` for its colours, and replacing either would drop them.
     const styles = lift
@@ -104,7 +129,10 @@ const ButtonImpl = React.forwardRef(({ variant: variantProp, isDestructive: isDe
         // Two clocks on one element — the press is faster than the colour
         // change — so the shorthand is written out and only the reduced-motion
         // guard comes from the vocabulary.
-        transition: Button_styles.buttonTransition, animationStyle: "composite", ref: ref, "data-variant": variant, "data-destructive": isDestructive || undefined, ...rest, 
+        transition: Button_styles.buttonTransition, animationStyle: "composite", ref: ref, "data-variant": variant, "data-destructive": isDestructive || undefined, loadingText: loadingText, disabled: softDisabled ? undefined : disabled, onClick: handleClick, ...rest, ...(softDisabled && {
+            'aria-disabled': true,
+            'data-disabled': '',
+        }), 
         // The `action` icon rule lives in `css` (a nested selector cannot be a
         // style prop); merged so a call site's `css` adds to it.
         css: mergeCss.mergeCss(base.css, cssProp), children: children }));

package/dist/components/Button/Button.js.map

@@ -1 +1 @@
-{"version":3,"file":"Button.js","sources":["../../../src/components/Button/Button.tsx"],"sourcesContent":[null],"names":["forwardRef","isLegacyButtonProps","resolveLegacyButtonVariant","warnLegacyButtonProps","getButtonStyles","_jsx","ChakraButton","mergeCss","focusRing","buttonTransition","polymorphic"],"mappings":"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"}
+{"version":3,"file":"Button.js","sources":["../../../src/components/Button/Button.tsx"],"sourcesContent":[null],"names":["forwardRef","useTranslate","isLegacyButtonProps","resolveLegacyButtonVariant","warnLegacyButtonProps","getButtonStyles","_jsx","ChakraButton","mergeCss","focusRing","buttonTransition","polymorphic"],"mappings":"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"}