@mindlogic-ai/logician-ui 4.0.0-alpha.26 → 4.0.0-alpha.28

package/dist/components/Appear/Appear.d.ts

@@ -0,0 +1,45 @@
+import { AppearProps } from './Appear.types';
+/**
+ * Brings an element in on mount — a fade, plus an optional scale (a *stamp*
+ * landing on something) or vertical travel (content *arriving*).
+ *
+ * ## Which of the three entrances this is
+ *
+ * The library has three, and they are not interchangeable:
+ *
+ * - `animationStyle="presence"` — a part that **has both states**. Menus,
+ *   popovers, modals: the node stays mounted and Chakra flips `_open` /
+ *   `_closed`, so it can animate *out* as well as in.
+ * - `staggerProps(index)` — items of **one list**, where the index is the
+ *   cadence and the whole point is the rhythm between siblings.
+ * - `Appear` — a **single element entering once**, on its own schedule, usually
+ *   as a response to something the reader just did. The delay is hand-set per
+ *   call site because there is no list to derive it from.
+ *
+ * The rule of thumb: if the element can close, use `presence`; if it has
+ * siblings arriving with it, use `stagger`; otherwise this.
+ *
+ * ## What it does not do
+ *
+ * It does not animate out. CSS cannot animate an element that is being removed
+ * from the DOM, which is exactly the gap `presence` fills by keeping the node
+ * mounted. FactChat's version accepts an `exit` too, but only inside an
+ * `AnimatePresence` ancestor — standalone it is a no-op there as well, so
+ * nothing that actually ran is lost in the port.
+ *
+ * ## What it puts in the DOM
+ *
+ * **One `div` around `children`**, and layout props land on that wrapper rather
+ * than on the child. Usually the same result — but the child is no longer a
+ * *direct* child of what surrounds it, so animate the inner element instead of
+ * wrapping when the parent needs its children directly: a `<tr>` needs `<td>`s,
+ * and Ark parts (`Menu.List`, `Tree`) walk their own children for focus and
+ * typeahead.
+ *
+ * ```tsx
+ * <Appear scaleFrom={0.5}>✓</Appear>
+ * <Appear rise={6} delayMs={120}>정답입니다</Appear>
+ * ```
+ */
+export declare const Appear: import("react").ForwardRefExoticComponent<AppearProps & import("react").RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=Appear.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Appear.d.ts","sourceRoot":"","sources":["../../../src/components/Appear/Appear.tsx"],"names":[],"mappings":"AAMA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,eAAO,MAAM,MAAM,wGAgClB,CAAC"}

package/dist/components/Appear/Appear.js

@@ -0,0 +1,61 @@
+"use client";
+'use strict';
+
+var jsxRuntime = require('react/jsx-runtime');
+var React = require('react');
+var react = require('@chakra-ui/react');
+var mergeCss = require('../../utils/mergeCss.js');
+var Appear_styles = require('./Appear.styles.js');
+
+/**
+ * Brings an element in on mount — a fade, plus an optional scale (a *stamp*
+ * landing on something) or vertical travel (content *arriving*).
+ *
+ * ## Which of the three entrances this is
+ *
+ * The library has three, and they are not interchangeable:
+ *
+ * - `animationStyle="presence"` — a part that **has both states**. Menus,
+ *   popovers, modals: the node stays mounted and Chakra flips `_open` /
+ *   `_closed`, so it can animate *out* as well as in.
+ * - `staggerProps(index)` — items of **one list**, where the index is the
+ *   cadence and the whole point is the rhythm between siblings.
+ * - `Appear` — a **single element entering once**, on its own schedule, usually
+ *   as a response to something the reader just did. The delay is hand-set per
+ *   call site because there is no list to derive it from.
+ *
+ * The rule of thumb: if the element can close, use `presence`; if it has
+ * siblings arriving with it, use `stagger`; otherwise this.
+ *
+ * ## What it does not do
+ *
+ * It does not animate out. CSS cannot animate an element that is being removed
+ * from the DOM, which is exactly the gap `presence` fills by keeping the node
+ * mounted. FactChat's version accepts an `exit` too, but only inside an
+ * `AnimatePresence` ancestor — standalone it is a no-op there as well, so
+ * nothing that actually ran is lost in the port.
+ *
+ * ## What it puts in the DOM
+ *
+ * **One `div` around `children`**, and layout props land on that wrapper rather
+ * than on the child. Usually the same result — but the child is no longer a
+ * *direct* child of what surrounds it, so animate the inner element instead of
+ * wrapping when the parent needs its children directly: a `<tr>` needs `<td>`s,
+ * and Ark parts (`Menu.List`, `Tree`) walk their own children for focus and
+ * typeahead.
+ *
+ * ```tsx
+ * <Appear scaleFrom={0.5}>✓</Appear>
+ * <Appear rise={6} delayMs={120}>정답입니다</Appear>
+ * ```
+ */
+const Appear = React.forwardRef(({ scaleFrom, rise, delayMs, durationMs, children, css, ...rest }, ref) => (jsxRuntime.jsx(react.Box, { ref: ref, ...rest, css: mergeCss.mergeCss(Appear_styles.appearIn, 
+    // Omitted props leave the keyframe's identity defaults in place, so one
+    // keyframe serves a plain fade, a stamp, an arrival, or all three.
+    scaleFrom === undefined ? undefined : { '--appear-scale': scaleFrom }, rise === undefined ? undefined : { '--appear-rise': `${rise}px` }, delayMs === undefined ? undefined : { animationDelay: `${delayMs}ms` }, durationMs === undefined
+        ? undefined
+        : { animationDuration: `${durationMs}ms` }, css), children: children })));
+Appear.displayName = 'Appear';
+
+exports.Appear = Appear;
+//# sourceMappingURL=Appear.js.map

package/dist/components/Appear/Appear.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Appear.js","sources":["../../../src/components/Appear/Appear.tsx"],"sourcesContent":[null],"names":["forwardRef","_jsx","Box","mergeCss","appearIn"],"mappings":";;;;;;;;;AAQA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyCG;AACI,MAAM,MAAM,GAAGA,gBAAU,CAC9B,CACE,EACE,SAAS,EACT,IAAI,EACJ,OAAO,EACP,UAAU,EACV,QAAQ,EACR,GAAG,EACH,GAAG,IAAI,EACK,EACd,GAAkC,MAElCC,eAACC,SAAG,EAAA,EACF,GAAG,EAAE,GAAG,KACJ,IAAI,EACR,GAAG,EAAEC,iBAAQ,CACXC,sBAAQ;;;IAGR,SAAS,KAAK,SAAS,GAAG,SAAS,GAAG,EAAE,gBAAgB,EAAE,SAAS,EAAE,EACrE,IAAI,KAAK,SAAS,GAAG,SAAS,GAAG,EAAE,eAAe,EAAE,CAAA,EAAG,IAAI,CAAA,EAAA,CAAI,EAAE,EACjE,OAAO,KAAK,SAAS,GAAG,SAAS,GAAG,EAAE,cAAc,EAAE,CAAA,EAAG,OAAO,CAAA,EAAA,CAAI,EAAE,EACtE,UAAU,KAAK;AACb,UAAE;AACF,UAAE,EAAE,iBAAiB,EAAE,CAAA,EAAG,UAAU,CAAA,EAAA,CAAI,EAAE,EAC5C,GAAG,CACJ,EAAA,QAAA,EAEA,QAAQ,EAAA,CACL,CACP;AAGH,MAAM,CAAC,WAAW,GAAG,QAAQ;;;;"}

package/dist/components/Appear/Appear.mjs

@@ -0,0 +1,59 @@
+"use client";
+import { jsx } from 'react/jsx-runtime';
+import { forwardRef } from 'react';
+import { Box } from '@chakra-ui/react';
+import { mergeCss } from '../../utils/mergeCss.mjs';
+import { appearIn } from './Appear.styles.mjs';
+
+/**
+ * Brings an element in on mount — a fade, plus an optional scale (a *stamp*
+ * landing on something) or vertical travel (content *arriving*).
+ *
+ * ## Which of the three entrances this is
+ *
+ * The library has three, and they are not interchangeable:
+ *
+ * - `animationStyle="presence"` — a part that **has both states**. Menus,
+ *   popovers, modals: the node stays mounted and Chakra flips `_open` /
+ *   `_closed`, so it can animate *out* as well as in.
+ * - `staggerProps(index)` — items of **one list**, where the index is the
+ *   cadence and the whole point is the rhythm between siblings.
+ * - `Appear` — a **single element entering once**, on its own schedule, usually
+ *   as a response to something the reader just did. The delay is hand-set per
+ *   call site because there is no list to derive it from.
+ *
+ * The rule of thumb: if the element can close, use `presence`; if it has
+ * siblings arriving with it, use `stagger`; otherwise this.
+ *
+ * ## What it does not do
+ *
+ * It does not animate out. CSS cannot animate an element that is being removed
+ * from the DOM, which is exactly the gap `presence` fills by keeping the node
+ * mounted. FactChat's version accepts an `exit` too, but only inside an
+ * `AnimatePresence` ancestor — standalone it is a no-op there as well, so
+ * nothing that actually ran is lost in the port.
+ *
+ * ## What it puts in the DOM
+ *
+ * **One `div` around `children`**, and layout props land on that wrapper rather
+ * than on the child. Usually the same result — but the child is no longer a
+ * *direct* child of what surrounds it, so animate the inner element instead of
+ * wrapping when the parent needs its children directly: a `<tr>` needs `<td>`s,
+ * and Ark parts (`Menu.List`, `Tree`) walk their own children for focus and
+ * typeahead.
+ *
+ * ```tsx
+ * <Appear scaleFrom={0.5}>✓</Appear>
+ * <Appear rise={6} delayMs={120}>정답입니다</Appear>
+ * ```
+ */
+const Appear = forwardRef(({ scaleFrom, rise, delayMs, durationMs, children, css, ...rest }, ref) => (jsx(Box, { ref: ref, ...rest, css: mergeCss(appearIn, 
+    // Omitted props leave the keyframe's identity defaults in place, so one
+    // keyframe serves a plain fade, a stamp, an arrival, or all three.
+    scaleFrom === undefined ? undefined : { '--appear-scale': scaleFrom }, rise === undefined ? undefined : { '--appear-rise': `${rise}px` }, delayMs === undefined ? undefined : { animationDelay: `${delayMs}ms` }, durationMs === undefined
+        ? undefined
+        : { animationDuration: `${durationMs}ms` }, css), children: children })));
+Appear.displayName = 'Appear';
+
+export { Appear };
+//# sourceMappingURL=Appear.mjs.map

package/dist/components/Appear/Appear.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Appear.mjs","sources":["../../../src/components/Appear/Appear.tsx"],"sourcesContent":[null],"names":["_jsx"],"mappings":";;;;;;;AAQA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyCG;AACI,MAAM,MAAM,GAAG,UAAU,CAC9B,CACE,EACE,SAAS,EACT,IAAI,EACJ,OAAO,EACP,UAAU,EACV,QAAQ,EACR,GAAG,EACH,GAAG,IAAI,EACK,EACd,GAAkC,MAElCA,IAAC,GAAG,EAAA,EACF,GAAG,EAAE,GAAG,KACJ,IAAI,EACR,GAAG,EAAE,QAAQ,CACX,QAAQ;;;IAGR,SAAS,KAAK,SAAS,GAAG,SAAS,GAAG,EAAE,gBAAgB,EAAE,SAAS,EAAE,EACrE,IAAI,KAAK,SAAS,GAAG,SAAS,GAAG,EAAE,eAAe,EAAE,CAAA,EAAG,IAAI,CAAA,EAAA,CAAI,EAAE,EACjE,OAAO,KAAK,SAAS,GAAG,SAAS,GAAG,EAAE,cAAc,EAAE,CAAA,EAAG,OAAO,CAAA,EAAA,CAAI,EAAE,EACtE,UAAU,KAAK;AACb,UAAE;AACF,UAAE,EAAE,iBAAiB,EAAE,CAAA,EAAG,UAAU,CAAA,EAAA,CAAI,EAAE,EAC5C,GAAG,CACJ,EAAA,QAAA,EAEA,QAAQ,EAAA,CACL,CACP;AAGH,MAAM,CAAC,WAAW,GAAG,QAAQ;;;;"}

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

@@ -0,0 +1,18 @@
+import type { SystemStyleObject } from '@chakra-ui/react';
+/**
+ * A mount entrance.
+ *
+ * `overshoot`, and that is the whole reason this is not just a fade: an entrance
+ * that settles slightly past its resting state reads as something *landing*,
+ * which is what a stamp is. On `standard` the same scale reads as a rendering
+ * hiccup — the curve is doing more work here than the amplitude.
+ *
+ * `motion.base`, the default for anything arriving.
+ *
+ * Under reduced motion the fade stays and the movement goes. The element still
+ * has to become visible — it was not there a moment ago — but neither the scale
+ * nor the travel carries information, so both are dropped by resetting their
+ * custom properties to identity rather than by killing the animation.
+ */
+export declare const appearIn: SystemStyleObject;
+//# sourceMappingURL=Appear.styles.d.ts.map

package/dist/components/Appear/Appear.styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Appear.styles.d.ts","sourceRoot":"","sources":["../../../src/components/Appear/Appear.styles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,QAAQ,EAAE,iBAUtB,CAAC"}

package/dist/components/Appear/Appear.styles.js

@@ -0,0 +1,32 @@
+"use client";
+'use strict';
+
+/**
+ * A mount entrance.
+ *
+ * `overshoot`, and that is the whole reason this is not just a fade: an entrance
+ * that settles slightly past its resting state reads as something *landing*,
+ * which is what a stamp is. On `standard` the same scale reads as a rendering
+ * hiccup — the curve is doing more work here than the amplitude.
+ *
+ * `motion.base`, the default for anything arriving.
+ *
+ * Under reduced motion the fade stays and the movement goes. The element still
+ * has to become visible — it was not there a moment ago — but neither the scale
+ * nor the travel carries information, so both are dropped by resetting their
+ * custom properties to identity rather than by killing the animation.
+ */
+const appearIn = {
+    animationName: 'appear-in',
+    animationDuration: 'motion.base',
+    animationTimingFunction: 'overshoot',
+    animationFillMode: 'both',
+    _motionReduce: {
+        '--appear-scale': '1',
+        '--appear-rise': '0px',
+        animationTimingFunction: 'standard',
+    },
+};
+
+exports.appearIn = appearIn;
+//# sourceMappingURL=Appear.styles.js.map

package/dist/components/Appear/Appear.styles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Appear.styles.js","sources":["../../../src/components/Appear/Appear.styles.ts"],"sourcesContent":[null],"names":[],"mappings":";;;AAEA;;;;;;;;;;;;;;AAcG;AACI,MAAM,QAAQ,GAAsB;AACzC,IAAA,aAAa,EAAE,WAAW;AAC1B,IAAA,iBAAiB,EAAE,aAAa;AAChC,IAAA,uBAAuB,EAAE,WAAW;AACpC,IAAA,iBAAiB,EAAE,MAAM;AACzB,IAAA,aAAa,EAAE;AACb,QAAA,gBAAgB,EAAE,GAAG;AACrB,QAAA,eAAe,EAAE,KAAK;AACtB,QAAA,uBAAuB,EAAE,UAAU;AACpC,KAAA;;;;;"}

package/dist/components/Appear/Appear.styles.mjs

@@ -0,0 +1,30 @@
+"use client";
+/**
+ * A mount entrance.
+ *
+ * `overshoot`, and that is the whole reason this is not just a fade: an entrance
+ * that settles slightly past its resting state reads as something *landing*,
+ * which is what a stamp is. On `standard` the same scale reads as a rendering
+ * hiccup — the curve is doing more work here than the amplitude.
+ *
+ * `motion.base`, the default for anything arriving.
+ *
+ * Under reduced motion the fade stays and the movement goes. The element still
+ * has to become visible — it was not there a moment ago — but neither the scale
+ * nor the travel carries information, so both are dropped by resetting their
+ * custom properties to identity rather than by killing the animation.
+ */
+const appearIn = {
+    animationName: 'appear-in',
+    animationDuration: 'motion.base',
+    animationTimingFunction: 'overshoot',
+    animationFillMode: 'both',
+    _motionReduce: {
+        '--appear-scale': '1',
+        '--appear-rise': '0px',
+        animationTimingFunction: 'standard',
+    },
+};
+
+export { appearIn };
+//# sourceMappingURL=Appear.styles.mjs.map

package/dist/components/Appear/Appear.styles.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Appear.styles.mjs","sources":["../../../src/components/Appear/Appear.styles.ts"],"sourcesContent":[null],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;AAcG;AACI,MAAM,QAAQ,GAAsB;AACzC,IAAA,aAAa,EAAE,WAAW;AAC1B,IAAA,iBAAiB,EAAE,aAAa;AAChC,IAAA,uBAAuB,EAAE,WAAW;AACpC,IAAA,iBAAiB,EAAE,MAAM;AACzB,IAAA,aAAa,EAAE;AACb,QAAA,gBAAgB,EAAE,GAAG;AACrB,QAAA,eAAe,EAAE,KAAK;AACtB,QAAA,uBAAuB,EAAE,UAAU;AACpC,KAAA;;;;;"}

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

@@ -0,0 +1,18 @@
+import type { BoxProps } from '@chakra-ui/react';
+export interface AppearProps extends Omit<BoxProps, 'scale' | 'translate'> {
+    /**
+     * Scale to grow from — for a **stamp**: a mark that lands on something, like a
+     * ✓ on a correct answer or a reward medallion. Omit for a plain fade.
+     */
+    scaleFrom?: number;
+    /**
+     * Vertical travel in px — for content **arriving**: a row, a card, a banner.
+     * Positive values rise from below.
+     */
+    rise?: number;
+    /** Delay before it appears. */
+    delayMs?: number;
+    /** Defaults to `motion.base` (300ms). */
+    durationMs?: number;
+}
+//# sourceMappingURL=Appear.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Appear.types.d.ts","sourceRoot":"","sources":["../../../src/components/Appear/Appear.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,MAAM,WAAW,WAAY,SAAQ,IAAI,CAAC,QAAQ,EAAE,OAAO,GAAG,WAAW,CAAC;IACxE;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

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

@@ -0,0 +1,3 @@
+export { Appear } from './Appear';
+export type { AppearProps } from './Appear.types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/Appear/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC"}

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":"AAOA,OAAO,EAAE,cAAc,EAAe,MAAM,gBAAgB,CAAC;AAkE7D,eAAO,MAAM,MAAM,gEAA0C,CAAC"}
+{"version":3,"file":"Button.d.ts","sourceRoot":"","sources":["../../../src/components/Button/Button.tsx"],"names":[],"mappings":"AAOA,OAAO,EAAE,cAAc,EAAe,MAAM,gBAAgB,CAAC;AAqH7D,eAAO,MAAM,MAAM,gEAA0C,CAAC"}

package/dist/components/Button/Button.js

@@ -20,14 +20,39 @@ var Button_styles = require('./Button.styles.js');
  * <Button colorPalette="danger" variant="solid">Delete</Button>
  * <Button colorPalette="secondary" variant="outline">Cancel</Button>
  * <Button colorPalette="neutral" variant="ghost">Close</Button>
+ * <Button colorPalette="primary" variant="solid" lift>Get started</Button>
  *
  * // `as` carries the element's own props (see Button.types.ts):
  * <Button as="a" href="/docs" target="_blank">문서</Button>
  * ```
  */
-const ButtonImpl = React.forwardRef(({ colorPalette, variant = 'soft', size, children, ...rest }, ref) => {
+const ButtonImpl = React.forwardRef(({ colorPalette, variant = 'soft', size, lift, children, _hover: hoverProp, _active: activeProp, ...rest }, ref) => {
     const palette = colorPalette ?? 'primary';
-    const styles = Button_styles.getButtonStyles(palette, variant);
+    const base = Button_styles.getButtonStyles(palette, variant);
+    // Merged rather than spread after: each variant already owns `_hover` and
+    // `_active` for its colours, and replacing either would drop them.
+    const styles = lift
+        ? {
+            ...base,
+            _hover: {
+                ...base._hover,
+                translate: '0 -1px',
+                // `drop-shadow`, not `box-shadow`. The keyboard focus ring is a
+                // box-shadow, and Chakra emits `:hover` after `:focus-visible`, so
+                // a focused button being hovered would lose its ring to this. A
+                // different property cannot collide with it at all — and unlike a
+                // box-shadow it follows the border radius for free.
+                filter: 'drop-shadow(0 3px 6px rgba(0, 0, 0, 0.18))',
+                // A black shadow does nothing on a dark canvas; deepen it there.
+                _dark: { filter: 'drop-shadow(0 3px 8px rgba(0, 0, 0, 0.55))' },
+            },
+            // Pressing puts it back on the surface, under the `scale`.
+            _active: { ...base._active, translate: '0 0', filter: 'none' },
+            // `:hover` still matches a disabled button, so the lift has to be
+            // switched off here rather than left to pointer-events.
+            _disabled: { translate: '0 0', filter: 'none' },
+        }
+        : base;
     /**
      * Chakra Button automatically maps size prop to textStyle:
      * - 2xs, xs → textStyle="xs" (10.5px with 14px base)
@@ -38,7 +63,21 @@ const ButtonImpl = React.forwardRef(({ colorPalette, variant = 'soft', size, chi
      * We override fontSize for xs size to 'sm' (12.25px) for better readability.
      * Other sizes use Chakra's default textStyle mapping.
      */
-    return (jsxRuntime.jsx(react.Button, { border: "1px solid", lineHeight: "1.2", fontWeight: "semibold", size: size, borderRadius: "md", ...styles, ...focusRing.focusRing, cursor: "pointer", transitionProperty: "all", transitionDuration: "0.25s", transitionTimingFunction: "ease-in-out", ref: ref, ...rest, children: children }));
+    return (jsxRuntime.jsx(react.Button, { border: "1px solid", lineHeight: "1.2", fontWeight: "semibold", size: size, borderRadius: "md", ...styles, 
+        // Merged, not left to `{...rest}`. A prop spread later replaces the
+        // whole object, so a call site adding one line — the 2px press ledge
+        // FactChat puts on its quiz buttons — used to silently drop the
+        // variant's pressed colour *and* the scale with it, and the button
+        // stopped reading as pressed at all. Its own keys still win; it just
+        // no longer erases the ones it did not mention.
+        _hover: { ...styles._hover, ...hoverProp }, _active: { ...styles._active, ...activeProp }, ...focusRing.focusRing, cursor: "pointer", 
+        // Explicit identity so the press transitions from a definite value
+        // rather than relying on `scale: none` being read as 1.
+        scale: "1", 
+        // 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, ...rest, children: children }));
 });
 /**
  * Type-level polymorphism over the same runtime — see `polymorphic` in

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

@@ -1 +1 @@
-{"version":3,"file":"Button.js","sources":["../../../src/components/Button/Button.tsx"],"sourcesContent":[null],"names":["forwardRef","getButtonStyles","_jsx","ChakraButton","focusRing","polymorphic"],"mappings":";;;;;;;;;;AASA;;;;;;;;;;;;;;;;AAgBG;AACH,MAAM,UAAU,GAAGA,gBAAU,CAC3B,CAAC,EAAE,YAAY,EAAE,OAAO,GAAG,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,EAAE,GAAG,KAAI;AACnE,IAAA,MAAM,OAAO,GAAG,YAAY,IAAI,SAAS;IAEzC,MAAM,MAAM,GAAGC,6BAAe,CAAC,OAAO,EAAE,OAAO,CAAC;AAEhD;;;;;;;;;AASG;IACH,QACEC,cAAA,CAACC,YAAY,EAAA,EACX,MAAM,EAAC,WAAW,EAClB,UAAU,EAAC,KAAK,EAChB,UAAU,EAAC,UAAU,EACrB,IAAI,EAAE,IAAI,EACV,YAAY,EAAC,IAAI,EAAA,GACb,MAAM,EAAA,GACNC,mBAAS,EACb,MAAM,EAAC,SAAS,EAChB,kBAAkB,EAAC,KAAK,EACxB,kBAAkB,EAAC,OAAO,EAC1B,wBAAwB,EAAC,aAAa,EACtC,GAAG,EAAE,GAAG,EAAA,GACJ,IAAI,EAAA,QAAA,EAEP,QAAQ,EAAA,CACI;AAEnB,CAAC,CACF;AAED;;;;;;AAMG;AACH,UAAU,CAAC,WAAW,GAAG,QAAQ;MAEpB,MAAM,GAAGC,uBAAW,CAAiB,UAAU;;;;"}
+{"version":3,"file":"Button.js","sources":["../../../src/components/Button/Button.tsx"],"sourcesContent":[null],"names":["forwardRef","getButtonStyles","_jsx","ChakraButton","focusRing","buttonTransition","polymorphic"],"mappings":";;;;;;;;;;AASA;;;;;;;;;;;;;;;;;AAiBG;AACH,MAAM,UAAU,GAAGA,gBAAU,CAC3B,CACE,EACE,YAAY,EACZ,OAAO,GAAG,MAAM,EAChB,IAAI,EACJ,IAAI,EACJ,QAAQ,EACR,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,UAAU,EACnB,GAAG,IAAI,EACR,EACD,GAAG,KACD;AACF,IAAA,MAAM,OAAO,GAAG,YAAY,IAAI,SAAS;IAEzC,MAAM,IAAI,GAAGC,6BAAe,CAAC,OAAO,EAAE,OAAO,CAAC;;;IAI9C,MAAM,MAAM,GAAG;AACb,UAAE;AACE,YAAA,GAAG,IAAI;AACP,YAAA,MAAM,EAAE;gBACN,GAAG,IAAI,CAAC,MAAM;AACd,gBAAA,SAAS,EAAE,QAAQ;;;;;;AAMnB,gBAAA,MAAM,EAAE,4CAA4C;;AAEpD,gBAAA,KAAK,EAAE,EAAE,MAAM,EAAE,4CAA4C,EAAE;AAChE,aAAA;;AAED,YAAA,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE;;;YAG9D,SAAS,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE;AAChD;UACD,IAAI;AAER;;;;;;;;;AASG;IACH,QACEC,cAAA,CAACC,YAAY,EAAA,EACX,MAAM,EAAC,WAAW,EAClB,UAAU,EAAC,KAAK,EAChB,UAAU,EAAC,UAAU,EACrB,IAAI,EAAE,IAAI,EACV,YAAY,EAAC,IAAI,EAAA,GACb,MAAM;;;;;;;QAOV,MAAM,EAAE,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,SAAS,EAAE,EAC1C,OAAO,EAAE,EAAE,GAAG,MAAM,CAAC,OAAO,EAAE,GAAG,UAAU,EAAE,EAAA,GACzCC,mBAAS,EACb,MAAM,EAAC,SAAS;;;AAGhB,QAAA,KAAK,EAAC,GAAG;;;;AAIT,QAAA,UAAU,EAAEC,8BAAgB,EAC5B,cAAc,EAAC,WAAW,EAC1B,GAAG,EAAE,GAAG,KACJ,IAAI,EAAA,QAAA,EAEP,QAAQ,EAAA,CACI;AAEnB,CAAC,CACF;AAED;;;;;;AAMG;AACH,UAAU,CAAC,WAAW,GAAG,QAAQ;MAEpB,MAAM,GAAGC,uBAAW,CAAiB,UAAU;;;;"}

package/dist/components/Button/Button.mjs

@@ -4,7 +4,7 @@ import { forwardRef } from 'react';
 import { Button as Button$1 } from '@chakra-ui/react';
 import { focusRing } from '../../utils/focusRing.mjs';
 import { polymorphic } from '../../types/polymorphic.mjs';
-import { getButtonStyles } from './Button.styles.mjs';
+import { getButtonStyles, buttonTransition } from './Button.styles.mjs';
 
 /**
  * Button component with two-dimensional variant system.
@@ -18,14 +18,39 @@ import { getButtonStyles } from './Button.styles.mjs';
  * <Button colorPalette="danger" variant="solid">Delete</Button>
  * <Button colorPalette="secondary" variant="outline">Cancel</Button>
  * <Button colorPalette="neutral" variant="ghost">Close</Button>
+ * <Button colorPalette="primary" variant="solid" lift>Get started</Button>
  *
  * // `as` carries the element's own props (see Button.types.ts):
  * <Button as="a" href="/docs" target="_blank">문서</Button>
  * ```
  */
-const ButtonImpl = forwardRef(({ colorPalette, variant = 'soft', size, children, ...rest }, ref) => {
+const ButtonImpl = forwardRef(({ colorPalette, variant = 'soft', size, lift, children, _hover: hoverProp, _active: activeProp, ...rest }, ref) => {
     const palette = colorPalette ?? 'primary';
-    const styles = getButtonStyles(palette, variant);
+    const base = getButtonStyles(palette, variant);
+    // Merged rather than spread after: each variant already owns `_hover` and
+    // `_active` for its colours, and replacing either would drop them.
+    const styles = lift
+        ? {
+            ...base,
+            _hover: {
+                ...base._hover,
+                translate: '0 -1px',
+                // `drop-shadow`, not `box-shadow`. The keyboard focus ring is a
+                // box-shadow, and Chakra emits `:hover` after `:focus-visible`, so
+                // a focused button being hovered would lose its ring to this. A
+                // different property cannot collide with it at all — and unlike a
+                // box-shadow it follows the border radius for free.
+                filter: 'drop-shadow(0 3px 6px rgba(0, 0, 0, 0.18))',
+                // A black shadow does nothing on a dark canvas; deepen it there.
+                _dark: { filter: 'drop-shadow(0 3px 8px rgba(0, 0, 0, 0.55))' },
+            },
+            // Pressing puts it back on the surface, under the `scale`.
+            _active: { ...base._active, translate: '0 0', filter: 'none' },
+            // `:hover` still matches a disabled button, so the lift has to be
+            // switched off here rather than left to pointer-events.
+            _disabled: { translate: '0 0', filter: 'none' },
+        }
+        : base;
     /**
      * Chakra Button automatically maps size prop to textStyle:
      * - 2xs, xs → textStyle="xs" (10.5px with 14px base)
@@ -36,7 +61,21 @@ const ButtonImpl = forwardRef(({ colorPalette, variant = 'soft', size, children,
      * We override fontSize for xs size to 'sm' (12.25px) for better readability.
      * Other sizes use Chakra's default textStyle mapping.
      */
-    return (jsx(Button$1, { border: "1px solid", lineHeight: "1.2", fontWeight: "semibold", size: size, borderRadius: "md", ...styles, ...focusRing, cursor: "pointer", transitionProperty: "all", transitionDuration: "0.25s", transitionTimingFunction: "ease-in-out", ref: ref, ...rest, children: children }));
+    return (jsx(Button$1, { border: "1px solid", lineHeight: "1.2", fontWeight: "semibold", size: size, borderRadius: "md", ...styles, 
+        // Merged, not left to `{...rest}`. A prop spread later replaces the
+        // whole object, so a call site adding one line — the 2px press ledge
+        // FactChat puts on its quiz buttons — used to silently drop the
+        // variant's pressed colour *and* the scale with it, and the button
+        // stopped reading as pressed at all. Its own keys still win; it just
+        // no longer erases the ones it did not mention.
+        _hover: { ...styles._hover, ...hoverProp }, _active: { ...styles._active, ...activeProp }, ...focusRing, cursor: "pointer", 
+        // Explicit identity so the press transitions from a definite value
+        // rather than relying on `scale: none` being read as 1.
+        scale: "1", 
+        // 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: buttonTransition, animationStyle: "composite", ref: ref, ...rest, children: children }));
 });
 /**
  * Type-level polymorphism over the same runtime — see `polymorphic` in

package/dist/components/Button/Button.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"Button.mjs","sources":["../../../src/components/Button/Button.tsx"],"sourcesContent":[null],"names":["_jsx","ChakraButton"],"mappings":";;;;;;;;AASA;;;;;;;;;;;;;;;;AAgBG;AACH,MAAM,UAAU,GAAG,UAAU,CAC3B,CAAC,EAAE,YAAY,EAAE,OAAO,GAAG,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,EAAE,GAAG,KAAI;AACnE,IAAA,MAAM,OAAO,GAAG,YAAY,IAAI,SAAS;IAEzC,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC;AAEhD;;;;;;;;;AASG;IACH,QACEA,GAAA,CAACC,QAAY,EAAA,EACX,MAAM,EAAC,WAAW,EAClB,UAAU,EAAC,KAAK,EAChB,UAAU,EAAC,UAAU,EACrB,IAAI,EAAE,IAAI,EACV,YAAY,EAAC,IAAI,EAAA,GACb,MAAM,EAAA,GACN,SAAS,EACb,MAAM,EAAC,SAAS,EAChB,kBAAkB,EAAC,KAAK,EACxB,kBAAkB,EAAC,OAAO,EAC1B,wBAAwB,EAAC,aAAa,EACtC,GAAG,EAAE,GAAG,EAAA,GACJ,IAAI,EAAA,QAAA,EAEP,QAAQ,EAAA,CACI;AAEnB,CAAC,CACF;AAED;;;;;;AAMG;AACH,UAAU,CAAC,WAAW,GAAG,QAAQ;MAEpB,MAAM,GAAG,WAAW,CAAiB,UAAU;;;;"}
+{"version":3,"file":"Button.mjs","sources":["../../../src/components/Button/Button.tsx"],"sourcesContent":[null],"names":["_jsx","ChakraButton"],"mappings":";;;;;;;;AASA;;;;;;;;;;;;;;;;;AAiBG;AACH,MAAM,UAAU,GAAG,UAAU,CAC3B,CACE,EACE,YAAY,EACZ,OAAO,GAAG,MAAM,EAChB,IAAI,EACJ,IAAI,EACJ,QAAQ,EACR,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,UAAU,EACnB,GAAG,IAAI,EACR,EACD,GAAG,KACD;AACF,IAAA,MAAM,OAAO,GAAG,YAAY,IAAI,SAAS;IAEzC,MAAM,IAAI,GAAG,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC;;;IAI9C,MAAM,MAAM,GAAG;AACb,UAAE;AACE,YAAA,GAAG,IAAI;AACP,YAAA,MAAM,EAAE;gBACN,GAAG,IAAI,CAAC,MAAM;AACd,gBAAA,SAAS,EAAE,QAAQ;;;;;;AAMnB,gBAAA,MAAM,EAAE,4CAA4C;;AAEpD,gBAAA,KAAK,EAAE,EAAE,MAAM,EAAE,4CAA4C,EAAE;AAChE,aAAA;;AAED,YAAA,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE;;;YAG9D,SAAS,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE;AAChD;UACD,IAAI;AAER;;;;;;;;;AASG;IACH,QACEA,GAAA,CAACC,QAAY,EAAA,EACX,MAAM,EAAC,WAAW,EAClB,UAAU,EAAC,KAAK,EAChB,UAAU,EAAC,UAAU,EACrB,IAAI,EAAE,IAAI,EACV,YAAY,EAAC,IAAI,EAAA,GACb,MAAM;;;;;;;QAOV,MAAM,EAAE,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,SAAS,EAAE,EAC1C,OAAO,EAAE,EAAE,GAAG,MAAM,CAAC,OAAO,EAAE,GAAG,UAAU,EAAE,EAAA,GACzC,SAAS,EACb,MAAM,EAAC,SAAS;;;AAGhB,QAAA,KAAK,EAAC,GAAG;;;;AAIT,QAAA,UAAU,EAAE,gBAAgB,EAC5B,cAAc,EAAC,WAAW,EAC1B,GAAG,EAAE,GAAG,KACJ,IAAI,EAAA,QAAA,EAEP,QAAQ,EAAA,CACI;AAEnB,CAAC,CACF;AAED;;;;;;AAMG;AACH,UAAU,CAAC,WAAW,GAAG,QAAQ;MAEpB,MAAM,GAAG,WAAW,CAAiB,UAAU;;;;"}

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

@@ -1,6 +1,7 @@
 import { ButtonProps as ChakraButtonProps } from '@chakra-ui/react';
 import { ButtonColorPalette, ButtonVariant } from './Button.types';
 type StyleProps = Partial<ChakraButtonProps>;
+export declare const buttonTransition: string;
 /**
  * Two-dimensional Button styles using the Golden Ratio color system.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"Button.styles.d.ts","sourceRoot":"","sources":["../../../src/components/Button/Button.styles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,IAAI,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAEpE,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEnE,KAAK,UAAU,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAC3C,kBAAkB,EAClB,MAAM,CAAC,aAAa,EAAE,UAAU,CAAC,CA6VlC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,GAC1B,eAAc,kBAA8B,EAC5C,UAAS,aAAuB,KAC/B,UAEF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,kBAAkB,EAOnD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,sBAAsB,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,uBAAuB,+EAA2B,CAAC;AAEhE;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,aAAa,EAKzC,CAAC"}
+{"version":3,"file":"Button.styles.d.ts","sourceRoot":"","sources":["../../../src/components/Button/Button.styles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,IAAI,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAEpE,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEnE,KAAK,UAAU,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;AA8B7C,eAAO,MAAM,gBAAgB,QAoBjB,CAAC;AAEb;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAC3C,kBAAkB,EAClB,MAAM,CAAC,aAAa,EAAE,UAAU,CAAC,CAmXlC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,GAC1B,eAAc,kBAA8B,EAC5C,UAAS,aAAuB,KAC/B,UAEF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,kBAAkB,EAOnD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,sBAAsB,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,uBAAuB,+EAA2B,CAAC;AAEhE;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,aAAa,EAKzC,CAAC"}