@astryxdesign/core 0.5.2-canary.501e975 → 0.5.2-canary.51676e7

package/dist/AppShell/AppShell.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AppShell.d.ts","sourceRoot":"","sources":["../../src/AppShell/AppShell.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAQL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAmBf,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AAO5C,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,SAAS,CAAC;AA+BhD;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC;AAE7D;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,kBAAkB,CAAC;AAEvD;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IAEzC;;;;OAIG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;IAEpB;;;OAGG;IACH,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAEhC;;;;;;;;;OASG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,aAAc,SAAQ,SAAS,CAAC,cAAc,CAAC;IAC9D,wCAAwC;IACxC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAChC;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,eAAe,CAAC;IAE1B;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC;IAEnB;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;IAEpB;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,WAAW,CAAC;IAE7B;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAEzB;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,SAAS,CAAC,EAAE,KAAK,GAAG,eAAe,GAAG,SAAS,CAAC;IAEhD;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;IAEpB;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AA4KD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,QAAQ,CAAC,EACvB,OAAoB,EACpB,MAAM,EACN,QAAQ,EACR,cAAc,EACd,aAAa,EAAE,UAAU,EACzB,MAAe,EACf,SAAS,EACT,OAAO,EACP,MAAM,EACN,MAAM,EACN,SAAS,EACT,KAAK,EACL,GAAG,EACH,GAAG,IAAI,EACR,EAAE,aAAa,qBAkZf;yBAjae,QAAQ"}
+{"version":3,"file":"AppShell.d.ts","sourceRoot":"","sources":["../../src/AppShell/AppShell.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAQL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAmBf,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AAO5C,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,SAAS,CAAC;AA+BhD;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC;AAE7D;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,kBAAkB,CAAC;AAEvD;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IAEzC;;;;OAIG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;IAEpB;;;OAGG;IACH,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAEhC;;;;;;;;;OASG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,aAAc,SAAQ,SAAS,CAAC,cAAc,CAAC;IAC9D,wCAAwC;IACxC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAChC;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,eAAe,CAAC;IAE1B;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC;IAEnB;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;IAEpB;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,WAAW,CAAC;IAE7B;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAEzB;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,SAAS,CAAC,EAAE,KAAK,GAAG,eAAe,GAAG,SAAS,CAAC;IAEhD;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;IAEpB;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AA4KD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,QAAQ,CAAC,EACvB,OAAoB,EACpB,MAAM,EACN,QAAQ,EACR,cAAc,EACd,aAAa,EAAE,UAAU,EACzB,MAAe,EACf,SAAS,EACT,OAAO,EACP,MAAM,EACN,MAAM,EACN,SAAS,EACT,KAAK,EACL,GAAG,EACH,GAAG,IAAI,EACR,EAAE,aAAa,qBAiZf;yBAhae,QAAQ"}

package/dist/AppShell/AppShell.js

@@ -36,7 +36,7 @@ import { AppShellMobileContext } from "./AppShellMobileContext.js";
 import { mergeProps, isRenderable } from "../utils/index.js";
 import { focusOutlineProps } from "../utils/focusOutline.stylex.js";
 import { useMediaQuery } from "../hooks/useMediaQuery.js";
-import { observeResize, unobserveResize } from "../utils/sharedResizeObserver.js";
+import { observeResize } from "../utils/sharedResizeObserver.js";
 import { themeProps } from "../utils/themeProps.js";
 import { useTranslator } from "../i18n/index.js";
 import { useMergedRefs } from "../hooks/useMergedRefs.js";
@@ -320,8 +320,7 @@ export function AppShell({
       const height = headerEl.getBoundingClientRect().height;
       shellEl.style.setProperty('--_app-shell-header-height', `${height}px`);
     };
-    observeResize(headerEl, () => updateHeight());
-    return () => unobserveResize(headerEl);
+    return observeResize(headerEl, () => updateHeight());
   }, [isAuto]);
 
   // =========================================================================

package/dist/Chat/ChatComposer.d.ts

@@ -46,8 +46,8 @@ export interface ChatComposerProps extends Omit<BaseProps<HTMLDivElement>, 'onCh
     /**
      * Resting elevation of the composer body. `low` (the default) keeps today's
      * raised look — low at rest, bumping to med on hover / focus. `none` flattens
-     * it and draws a border with the same rest / hover / focus treatment as a
-     * text input (emphasized border → accent on focus, with matching inset rings).
+     * it and draws a border. Keyboard focus in the editor adds the shared focus
+     * ring in either presentation; pointer focus does not add that ring.
      * @default 'low'
      */
     elevation?: 'none' | 'low';

package/dist/Chat/ChatComposer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChatComposer.d.ts","sourceRoot":"","sources":["../../src/Chat/ChatComposer.tsx"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,EAKZ,KAAK,SAAS,EAEf,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AA0B5C,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;AAEtE,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAC7C,SAAS,CAAC,cAAc,CAAC,EACzB,UAAU,GAAG,UAAU,CACxB;IACC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAChC,+CAA+C;IAC/C,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,kFAAkF;IAClF,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,qCAAqC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,sBAAsB;IACtB,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAI3B,6GAA6G;IAC7G,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,yHAAyH;IACzH,aAAa,CAAC,EAAE,SAAS,CAAC;IAC1B,yGAAyG;IACzG,aAAa,CAAC,EAAE,SAAS,CAAC;IAC1B,2DAA2D;IAC3D,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,gHAAgH;IAChH,aAAa,CAAC,EAAE,SAAS,CAAC;IAC1B,gHAAgH;IAChH,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,gDAAgD;IAChD,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,iEAAiE;IACjE,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,oDAAoD;IACpD,cAAc,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC;CACnC;AAoMD;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,qBAiLpD;yBAjLe,YAAY"}
+{"version":3,"file":"ChatComposer.d.ts","sourceRoot":"","sources":["../../src/Chat/ChatComposer.tsx"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,EAKZ,KAAK,SAAS,EAGf,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AA+B5C,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;AAEtE,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAC7C,SAAS,CAAC,cAAc,CAAC,EACzB,UAAU,GAAG,UAAU,CACxB;IACC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAChC,+CAA+C;IAC/C,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,kFAAkF;IAClF,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,qCAAqC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,sBAAsB;IACtB,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAI3B,6GAA6G;IAC7G,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,yHAAyH;IACzH,aAAa,CAAC,EAAE,SAAS,CAAC;IAC1B,yGAAyG;IACzG,aAAa,CAAC,EAAE,SAAS,CAAC;IAC1B,2DAA2D;IAC3D,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,gHAAgH;IAChH,aAAa,CAAC,EAAE,SAAS,CAAC;IAC1B,gHAAgH;IAChH,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,gDAAgD;IAChD,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,iEAAiE;IACjE,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,oDAAoD;IACpD,cAAc,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC;CACnC;AA8MD;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,qBA2MpD;yBA3Me,YAAY"}

package/dist/Chat/ChatComposer.js

@@ -33,6 +33,8 @@ import { ChatComposerContext } from "./ChatContext.js";
 import { ChatSendButton } from "./ChatSendButton.js";
 import { themeProps } from "../utils/themeProps.js";
 import { useTranslator } from "../i18n/index.js";
+import { focusOutlineStyles } from "../utils/focusOutline.stylex.js";
+import { getInteractionModality, useInteractionModalityTracking } from "../utils/interactionModality.js";
 
 // =============================================================================
 // Types
@@ -65,7 +67,8 @@ const styles = {
 
 // Resting elevation for the composer body, narrowed to two steps.
 // - `low` (default) preserves today's look: low at rest, bumping to med on
-//   hover / focus-within (a CSS-only interaction state the component owns).
+//   hover / focus-within. The WCAG focus indicator is a separate shared ring,
+//   gated to keyboard focus in the editor; the shadow change remains depth.
 // - `none` is flat; depth comes from a border + inset rings instead. The
 //   border is drawn *inside* the padding — its width is subtracted from every
 //   side (like Card) so total inset (border + padding) equals the elevated
@@ -88,6 +91,9 @@ const elevationStyles = {
     $$css: true
   }
 };
+function isComposerEditor(target) {
+  return target instanceof HTMLElement && target.matches('textarea, [contenteditable="true"], [role="textbox"], input:not([type]), input[type="text"], input[type="search"], input[type="email"], input[type="url"], input[type="tel"], input[type="password"]');
+}
 
 // =============================================================================
 // Component
@@ -134,6 +140,8 @@ export function ChatComposer(props) {
   } = props;
   const placeholder = placeholderFromProps ?? t('@astryx.chat.composer.placeholder');
   const [internalValue, setInternalValue] = useState('');
+  const [hasKeyboardEditorFocus, setHasKeyboardEditorFocus] = useState(false);
+  useInteractionModalityTracking();
   const isControlled = controlledValue !== undefined;
   const currentValue = isControlled ? controlledValue : internalValue;
   const updateValue = useCallback(newValue => {
@@ -175,6 +183,14 @@ export function ChatComposer(props) {
     const editable = bodyRef.current?.querySelector('[contenteditable="true"], textarea');
     editable?.focus();
   }, []);
+  const handleBodyFocusCapture = useCallback(event => {
+    setHasKeyboardEditorFocus(isComposerEditor(event.target) && getInteractionModality() === 'keyboard');
+  }, []);
+  const handleBodyBlurCapture = useCallback(event => {
+    if (!event.currentTarget.contains(event.relatedTarget)) {
+      setHasKeyboardEditorFocus(false);
+    }
+  }, []);
   const statusEl = status ? /*#__PURE__*/_jsxs("div", {
     role: status.type === 'error' ? 'alert' : 'status',
     ...{
@@ -238,7 +254,10 @@ export function ChatComposer(props) {
       children: [statusPosition === 'top' && statusEl, drawer, /*#__PURE__*/_jsxs("div", {
         ref: bodyRef,
         onClick: handleBodyClick,
-        ...stylex.props(styles.body, elevationStyles[elevation], density === 'compact' && styles.compact, xstyle),
+        onPointerDownCapture: () => setHasKeyboardEditorFocus(false),
+        onFocusCapture: handleBodyFocusCapture,
+        onBlurCapture: handleBodyBlurCapture,
+        ...stylex.props(styles.body, elevationStyles[elevation], hasKeyboardEditorFocus && focusOutlineStyles.focusWithin, density === 'compact' && styles.compact, xstyle),
         children: [(headerActions || headerContext) && /*#__PURE__*/_jsxs("div", {
           ...{
             className: "x78zum5 x6s0dn4 x1qughib x1txdalj xe0p6wg"

package/dist/Chat/ChatComposerInput.d.ts.map

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

package/dist/Chat/ChatComposerInput.js

@@ -30,7 +30,7 @@ import { colorVars, spacingVars, typeScaleVars, typographyVars } from "../theme/
 import { mergeProps, isImeKeyEvent } from "../utils/index.js";
 import { useTriggerMenu } from "./useTriggerMenu.js";
 import { useChatComposerTokens, isCustomToken } from "./useChatComposerTokens.js";
-import { ensureCaretInside, insertTextAtCursor } from "./chatComposerSelection.js";
+import { ensureCaretInside, insertTextAtCursor, isSelectionAtStart, isSelectionAtEnd } from "./chatComposerSelection.js";
 import { ChatPastedTextToken } from "./ChatPastedTextToken.js";
 import { useChatPasteAsToken } from "./useChatPasteAsToken.js";
 import { Badge } from "../Badge/index.js";
@@ -373,12 +373,29 @@ export function ChatComposerInput(props) {
       return;
     }
 
-    // History navigation (only when trigger menu is not active)
+    // History navigation (only when trigger menu is not active).
+    // Recall only at the text boundaries so the caret can still move
+    // between lines in a multi-line draft: ArrowUp recalls the
+    // previous message when the caret is at the very start, ArrowDown
+    // steps forward when it's at the very end. A recalled message is
+    // shown fully selected (see `selectAll` below); that spans both
+    // boundaries at once, so repeated presses keep stepping through
+    // history. Mid-text, we bail before `preventDefault` and let the
+    // browser move the caret up/down a line.
     if (hasHistory && (e.key === 'ArrowUp' || e.key === 'ArrowDown')) {
       if (!editableRef.current) {
         return;
       }
-      const text = serialize(editableRef.current);
+      const editable = editableRef.current;
+      const isCollapsed = window.getSelection()?.isCollapsed ?? true;
+      const atStart = isSelectionAtStart(editable);
+      const atEnd = isSelectionAtEnd(editable);
+      const canRecallPrev = atStart && (isCollapsed || atEnd);
+      const canRecallNext = atEnd && (isCollapsed || atStart);
+      if (e.key === 'ArrowUp' ? !canRecallPrev : !canRecallNext) {
+        return;
+      }
+      const text = serialize(editable);
       const history = historyRef.current;
       if (history.length === 0) {
         return;

package/dist/Chat/chatComposerSelection.d.ts

@@ -32,6 +32,31 @@
  * support).
  */
 export declare function ensureCaretInside(editable: HTMLElement): Selection | null;
+/**
+ * Whether the current selection's start boundary sits at the very
+ * beginning of `editable`'s content.
+ *
+ * Used by the composer to decide when ArrowUp should recall message
+ * history versus move the caret up a line: history is only recalled
+ * when the caret is at the very start of the draft. This handles both
+ * the editable root and offset 0 of its leading text node without
+ * cloning the draft's contents.
+ *
+ * Returns `false` when there is no selection, the range is not inside
+ * `editable`, or the boundary APIs are unavailable — callers treat
+ * that as "not at the boundary" and let the browser move the caret.
+ */
+export declare function isSelectionAtStart(editable: HTMLElement): boolean;
+/**
+ * Whether the current selection's end boundary sits at the very end of
+ * `editable`'s content.
+ *
+ * The ArrowDown counterpart to {@link isSelectionAtStart}: history is
+ * only stepped forward when the caret is at the very end of the draft.
+ *
+ * Returns `false` under the same conditions as {@link isSelectionAtStart}.
+ */
+export declare function isSelectionAtEnd(editable: HTMLElement): boolean;
 /**
  * Insert plain text at the current selection, scoped to `editable`.
  *

package/dist/Chat/chatComposerSelection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chatComposerSelection.d.ts","sourceRoot":"","sources":["../../src/Chat/chatComposerSelection.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,WAAW,GAAG,SAAS,GAAG,IAAI,CAmBzE;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,WAAW,EACrB,IAAI,EAAE,MAAM,GACX,OAAO,CAiBT"}
+{"version":3,"file":"chatComposerSelection.d.ts","sourceRoot":"","sources":["../../src/Chat/chatComposerSelection.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,WAAW,GAAG,SAAS,GAAG,IAAI,CAmBzE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO,CAYjE;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO,CAO/D;AAiED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,WAAW,EACrB,IAAI,EAAE,MAAM,GACX,OAAO,CAiBT"}

package/dist/Chat/chatComposerSelection.js

@@ -55,6 +55,84 @@ export function ensureCaretInside(editable) {
   return selection;
 }
 
+/**
+ * Whether the current selection's start boundary sits at the very
+ * beginning of `editable`'s content.
+ *
+ * Used by the composer to decide when ArrowUp should recall message
+ * history versus move the caret up a line: history is only recalled
+ * when the caret is at the very start of the draft. This handles both
+ * the editable root and offset 0 of its leading text node without
+ * cloning the draft's contents.
+ *
+ * Returns `false` when there is no selection, the range is not inside
+ * `editable`, or the boundary APIs are unavailable — callers treat
+ * that as "not at the boundary" and let the browser move the caret.
+ */
+export function isSelectionAtStart(editable) {
+  const selection = window.getSelection();
+  if (!selection || selection.rangeCount === 0) {
+    return false;
+  }
+  const range = selection.getRangeAt(0);
+  return isBoundaryAtEdge(editable, range.startContainer, range.startOffset, 'start');
+}
+
+/**
+ * Whether the current selection's end boundary sits at the very end of
+ * `editable`'s content.
+ *
+ * The ArrowDown counterpart to {@link isSelectionAtStart}: history is
+ * only stepped forward when the caret is at the very end of the draft.
+ *
+ * Returns `false` under the same conditions as {@link isSelectionAtStart}.
+ */
+export function isSelectionAtEnd(editable) {
+  const selection = window.getSelection();
+  if (!selection || selection.rangeCount === 0) {
+    return false;
+  }
+  const range = selection.getRangeAt(0);
+  return isBoundaryAtEdge(editable, range.endContainer, range.endOffset, 'end');
+}
+
+/**
+ * Check whether a Range boundary is at an edge of `editable` without
+ * materializing the content before or after it. Chromium represents a caret
+ * at the start of non-empty contenteditables as the first text node at offset
+ * zero (and likewise uses the last text node's length at the end). Those are
+ * distinct DOM boundary points from the editable's child offsets, so
+ * `compareBoundaryPoints` cannot be used here.
+ */
+function isBoundaryAtEdge(editable, container, offset, edge) {
+  if (!editable.contains(container) || !isAtNodeEdge(container, offset, edge)) {
+    return false;
+  }
+  for (let node = container; node && node !== editable;) {
+    if (hasContentSibling(node, edge)) {
+      return false;
+    }
+    node = node.parentNode;
+  }
+  return true;
+}
+function isAtNodeEdge(node, offset, edge) {
+  if (node.nodeType === Node.TEXT_NODE || node.nodeType === Node.CDATA_SECTION_NODE) {
+    return edge === 'start' ? offset === 0 : offset === (node.nodeValue?.length ?? 0);
+  }
+  return edge === 'start' ? offset === 0 : offset === node.childNodes.length;
+}
+function hasContentSibling(node, edge) {
+  for (let sibling = edge === 'start' ? node.previousSibling : node.nextSibling; sibling; sibling = edge === 'start' ? sibling.previousSibling : sibling.nextSibling) {
+    // Elements (including <br> and tokens) represent a content boundary even
+    // when they have no text. Empty text nodes and comments do not.
+    if (sibling.nodeType === Node.ELEMENT_NODE || sibling.nodeType === Node.TEXT_NODE && sibling.nodeValue !== '') {
+      return true;
+    }
+  }
+  return false;
+}
+
 /**
  * Insert plain text at the current selection, scoped to `editable`.
  *

package/dist/Chat/useChatNewMessages.js

@@ -23,7 +23,7 @@
  * - /packages/core/src/Chat/index.ts (exports)
  */
 import { useCallback, useEffect, useRef, useState } from 'react';
-import { observeResize, unobserveResize } from "../utils/sharedResizeObserver.js";
+import { observeResize } from "../utils/sharedResizeObserver.js";
 
 // =============================================================================
 // Types
@@ -49,7 +49,7 @@ export function useChatNewMessages({
   const elementRef = useRef(null);
   const cleanupRef = useRef(null);
   const attach = useCallback(el => {
-    observeResize(el, () => {
+    const unobserve = observeResize(el, () => {
       onResizeRef.current?.();
       const messages = el.getElementsByClassName('astryx-chat-message');
       const last = messages.length > 0 ? messages[messages.length - 1] : null;
@@ -60,7 +60,7 @@ export function useChatNewMessages({
         }
       }
     });
-    cleanupRef.current = () => unobserveResize(el);
+    cleanupRef.current = unobserve;
   }, []);
   const detach = useCallback(() => {
     cleanupRef.current?.();

package/dist/Chat/useChatStreamScroll.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useChatStreamScroll.d.ts","sourceRoot":"","sources":["../../src/Chat/useChatStreamScroll.ts"],"names":[],"mappings":"AAoCA,MAAM,WAAW,yBAAyB;IACxC;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;CACjC;AAED,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAE/C;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,yBAAyB;IACxC,6DAA6D;IAC7D,YAAY,EAAE,OAAO,CAAC;IAEtB,yDAAyD;IACzD,QAAQ,EAAE,OAAO,CAAC;IAElB,yDAAyD;IACzD,cAAc,EAAE,CAAC,OAAO,CAAC,EAAE,yBAAyB,KAAK,IAAI,CAAC;IAE9D,sFAAsF;IACtF,eAAe,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,IAAI,CAAC;IAE3C,6CAA6C;IAC7C,IAAI,EAAE,MAAM,IAAI,CAAC;IAEjB,0BAA0B;IAC1B,MAAM,EAAE,MAAM,IAAI,CAAC;IAEnB,oEAAoE;IACpE,cAAc,EAAE,MAAM,IAAI,CAAC;IAE3B,mDAAmD;IACnD,mBAAmB,EAAE,MAAM,IAAI,CAAC;CACjC;AAQD,wBAAgB,mBAAmB,CAAC,EAClC,SAAS,EACT,OAAc,EACd,aAAkB,EAClB,eAAqB,EACrB,OAAa,EACb,SAAgB,EAChB,IAAW,GACZ,EAAE,0BAA0B,GAAG,yBAAyB,CAyRxD"}
+{"version":3,"file":"useChatStreamScroll.d.ts","sourceRoot":"","sources":["../../src/Chat/useChatStreamScroll.ts"],"names":[],"mappings":"AAsCA,MAAM,WAAW,yBAAyB;IACxC;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;CACjC;AAED,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAE/C;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,yBAAyB;IACxC,6DAA6D;IAC7D,YAAY,EAAE,OAAO,CAAC;IAEtB,yDAAyD;IACzD,QAAQ,EAAE,OAAO,CAAC;IAElB,yDAAyD;IACzD,cAAc,EAAE,CAAC,OAAO,CAAC,EAAE,yBAAyB,KAAK,IAAI,CAAC;IAE9D,sFAAsF;IACtF,eAAe,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,IAAI,CAAC;IAE3C,6CAA6C;IAC7C,IAAI,EAAE,MAAM,IAAI,CAAC;IAEjB,0BAA0B;IAC1B,MAAM,EAAE,MAAM,IAAI,CAAC;IAEnB,oEAAoE;IACpE,cAAc,EAAE,MAAM,IAAI,CAAC;IAE3B,mDAAmD;IACnD,mBAAmB,EAAE,MAAM,IAAI,CAAC;CACjC;AA8BD,wBAAgB,mBAAmB,CAAC,EAClC,SAAS,EACT,OAAc,EACd,aAAkB,EAClB,eAAqB,EACrB,OAAa,EACb,SAAgB,EAChB,IAAW,GACZ,EAAE,0BAA0B,GAAG,yBAAyB,CAqQxD"}

package/dist/Chat/useChatStreamScroll.js

@@ -18,10 +18,12 @@
  * - Under `prefers-reduced-motion`, every spring path falls back to the
  *   same instant jump — following still works, it just doesn't animate
  *
- * Uses scroll direction (lastScrollTop comparison) to detect user
- * intent — works for wheel, touch, scrollbar drag, keyboard, everything.
- * Tracks scrollHeight/offsetHeight changes to ignore Chrome synthetic
- * scroll events caused by content resize.
+ * Reads user intent from position: a scroll that lands above the last
+ * position this hook set or saw is the reader — wheel, touch, scrollbar
+ * drag, keyboard, everything, including a move the spring's next frame
+ * would otherwise outrun. While following, the hook owns the position:
+ * it disables scroll anchoring on the container, so the only move the
+ * browser makes on its own is a resize clamp onto the bottom.
  *
  * SYNC: When modified, update:
  * - /packages/core/src/Chat/index.ts (exports)
@@ -38,6 +40,24 @@ import { useMediaQuery } from "../hooks/useMediaQuery.js";
 // =============================================================================
 
 const SIXTY_FPS_MS = 1000 / 60;
+
+// While following, the hook owns the container's position, so the browser's
+// scroll anchoring must not move it. The rule rides on an attribute rather
+// than the element's inline style: a consumer's own `overflow-anchor` is never
+// read, written or restored — it simply applies again once the attribute is
+// gone. `!important` so an inline `auto` cannot switch anchoring back on under
+// a following container; an inline `!important` still wins, deliberately.
+const FOLLOWING_ATTR = 'data-astryx-chat-following';
+const FOLLOWING_STYLE_ATTR = 'data-astryx-chat-following-style';
+function ensureFollowingStyle() {
+  if (typeof document === 'undefined' || document.head.querySelector(`[${FOLLOWING_STYLE_ATTR}]`)) {
+    return;
+  }
+  const style = document.createElement('style');
+  style.setAttribute(FOLLOWING_STYLE_ATTR, '');
+  style.textContent = `[${FOLLOWING_ATTR}]{overflow-anchor:none !important}`;
+  document.head.appendChild(style);
+}
 export function useChatStreamScroll({
   scrollRef,
   enabled = true,
@@ -56,12 +76,24 @@ export function useChatStreamScroll({
   const velocityRef = useRef(0);
   const animatingRef = useRef(false);
   const lastTickRef = useRef(undefined);
-
-  // For scroll direction detection
+  // The spring's pending frame, so a jump can cancel it for real.
+  const rafRef = useRef(0);
+  // The last position this hook set or saw. Updated by every write of ours
+  // (spring frame, jump, scrollToMessage) as well as by every scroll event,
+  // so a reader's move that lands between two spring frames still shows as
+  // "above where we put it" even when the next frame's write outran it.
   const lastScrollTopRef = useRef(0);
-  // For synthetic scroll detection
-  const lastScrollHeightRef = useRef(0);
-  const lastOffsetHeightRef = useRef(0);
+
+  // While following, this hook is the only thing that should move the
+  // container: scroll anchoring is off, so the browser's one remaining move
+  // is the resize clamp onto the bottom, and every other upward move is the
+  // reader. Unlocked, the element's own anchoring applies again — a reader up
+  // in the history wants it when content above them changes.
+  const setLocked = useCallback(locked => {
+    lockedRef.current = locked;
+    setIsLocked(locked);
+    scrollRef.current?.toggleAttribute(FOLLOWING_ATTR, locked);
+  }, [scrollRef]);
 
   // --- Spring animation ---
 
@@ -94,7 +126,8 @@ export function useChatStreamScroll({
     lastTickRef.current = now;
     velocityRef.current = (damping * velocityRef.current + stiffness * diff) / mass;
     el.scrollTop += velocityRef.current * tickDelta;
-    requestAnimationFrame(animate);
+    lastScrollTopRef.current = el.scrollTop;
+    rafRef.current = requestAnimationFrame(animate);
   }, [scrollRef, damping, stiffness, mass]);
 
   // Jump to the bottom in a single frame — cancels any in-flight spring so
@@ -104,6 +137,7 @@ export function useChatStreamScroll({
     if (!el) {
       return;
     }
+    cancelAnimationFrame(rafRef.current);
     animatingRef.current = false;
     velocityRef.current = 0;
     lastTickRef.current = undefined;
@@ -125,15 +159,14 @@ export function useChatStreamScroll({
     if (!animatingRef.current) {
       animatingRef.current = true;
       lastTickRef.current = undefined;
-      requestAnimationFrame(animate);
+      rafRef.current = requestAnimationFrame(animate);
     }
   }, [animate, jumpToBottom, prefersReducedMotion]);
 
   // --- Public API ---
 
   const scrollToBottom = useCallback(options => {
-    lockedRef.current = true;
-    setIsLocked(true);
+    setLocked(true);
     setIsScrolledUp(false);
     initialFillPendingRef.current = false;
     if (options?.behavior === 'instant') {
@@ -141,7 +174,7 @@ export function useChatStreamScroll({
       return;
     }
     startAnimation();
-  }, [startAnimation, jumpToBottom]);
+  }, [setLocked, startAnimation, jumpToBottom]);
   const scrollToMessage = useCallback(el => {
     const container = scrollRef.current;
     if (!container) {
@@ -168,16 +201,14 @@ export function useChatStreamScroll({
     }
   }, [scrollRef, scrollToMessage]);
   const lock = useCallback(() => {
-    lockedRef.current = true;
-    setIsLocked(true);
+    setLocked(true);
     setIsScrolledUp(false);
     startAnimation();
-  }, [startAnimation]);
+  }, [setLocked, startAnimation]);
   const unlock = useCallback(() => {
-    lockedRef.current = false;
+    setLocked(false);
     animatingRef.current = false;
-    setIsLocked(false);
-  }, []);
+  }, [setLocked]);
   const scrollIfLocked = useCallback(() => {
     if (!enabled) {
       return;
@@ -205,11 +236,9 @@ export function useChatStreamScroll({
     if (!el || !enabled) {
       return;
     }
-
-    // Initialize tracking values
     lastScrollTopRef.current = el.scrollTop;
-    lastScrollHeightRef.current = el.scrollHeight;
-    lastOffsetHeightRef.current = el.offsetHeight;
+    ensureFollowingStyle();
+    el.toggleAttribute(FOLLOWING_ATTR, lockedRef.current);
     const onScroll = () => {
       const {
         scrollTop,
@@ -220,65 +249,29 @@ export function useChatStreamScroll({
 
       // Button visibility
       setIsScrolledUp(dist > buttonThreshold);
-
-      // Detect synthetic scroll — Chrome fires scroll events when
-      // scrollHeight or offsetHeight changes (content resize, keyboard).
-      const scrollHeightChanged = scrollHeight !== lastScrollHeightRef.current;
-      const offsetHeightChanged = offsetHeight !== lastOffsetHeightRef.current;
-      lastScrollHeightRef.current = scrollHeight;
-      lastOffsetHeightRef.current = offsetHeight;
-      if (scrollHeightChanged || offsetHeightChanged) {
-        // Synthetic scroll from resize — don't change lock state
-        lastScrollTopRef.current = scrollTop;
-        return;
-      }
-
-      // Scroll direction — unlock on scroll up
       const isScrollingUp = scrollTop < lastScrollTopRef.current;
       lastScrollTopRef.current = scrollTop;
-      if (isScrollingUp && lockedRef.current) {
-        lockedRef.current = false;
+
+      // With anchoring off, the browser only ever moves a following
+      // container up to clamp it onto a new, smaller bottom, and a reader
+      // scrolling up never lands there. (clientHeight, not dist: offsetHeight
+      // includes borders and a horizontal scrollbar.)
+      const landedAtBottom = scrollHeight - scrollTop - el.clientHeight < 1;
+      if (isScrollingUp && !landedAtBottom && lockedRef.current) {
+        setLocked(false);
         animatingRef.current = false;
-        setIsLocked(false);
       }
     };
     const onScrollEnd = () => {
       const dist = el.scrollHeight - el.scrollTop - el.offsetHeight;
       if (dist <= lockThreshold) {
-        lockedRef.current = true;
-        setIsLocked(true);
-      }
-    };
-
-    // Wheel up while animating — interrupt immediately.
-    // onScroll direction detection covers most cases, but wheel fires
-    // before the scroll position updates so we can react faster.
-    const onWheel = e => {
-      if (e.deltaY < 0 && animatingRef.current) {
-        lockedRef.current = false;
-        animatingRef.current = false;
-        setIsLocked(false);
-      }
-    };
-
-    // Touch move — user is dragging, take control
-    const onTouchMove = () => {
-      if (animatingRef.current) {
-        lockedRef.current = false;
-        animatingRef.current = false;
-        setIsLocked(false);
+        setLocked(true);
       }
     };
     el.addEventListener('scroll', onScroll, {
       passive: true
     });
     el.addEventListener('scrollend', onScrollEnd);
-    el.addEventListener('wheel', onWheel, {
-      passive: true
-    });
-    el.addEventListener('touchmove', onTouchMove, {
-      passive: true
-    });
 
     // Initial scroll to bottom — content already present at mount.
     requestAnimationFrame(() => {
@@ -291,10 +284,9 @@ export function useChatStreamScroll({
     return () => {
       el.removeEventListener('scroll', onScroll);
       el.removeEventListener('scrollend', onScrollEnd);
-      el.removeEventListener('wheel', onWheel);
-      el.removeEventListener('touchmove', onTouchMove);
+      el.removeAttribute(FOLLOWING_ATTR);
     };
-  }, [scrollRef, enabled, lockThreshold, buttonThreshold]);
+  }, [scrollRef, enabled, lockThreshold, buttonThreshold, setLocked]);
   return {
     isScrolledUp,
     isLocked,

package/dist/CheckboxInput/CheckboxInput.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CheckboxInput.d.ts","sourceRoot":"","sources":["../../src/CheckboxInput/CheckboxInput.tsx"],"names":[],"mappings":"AAIA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAOL,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,MAAM,MAAM,kBAAkB,CAAC;AAS3C,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,gBAAgB,CAAC;AAG9C,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,SAAS,CAAC;AACtC,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,gBAAgB,CAAC;AAmFhD,QAAA,MAAM,iBAAiB;;;;;;;;;EASrB,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,MAAM,OAAO,iBAAiB,CAAC;AAE/D,MAAM,WAAW,kBAAmB,SAAQ,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC;IACrE,wDAAwD;IACxD,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAClC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,WAAW,CAAC,gBAAgB,CAAC,KAAK,IAAI,CAAC;IACxE;;OAEG;IACH,YAAY,CAAC,EAAE,CACb,OAAO,EAAE,OAAO,EAChB,CAAC,EAAE,WAAW,CAAC,gBAAgB,CAAC,KAC7B,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;OAEG;IACH,KAAK,EAAE,OAAO,GAAG,eAAe,CAAC;IACjC;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;OAIG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,CAAC,gBAAgB,CAAC,KAAK,IAAI,CAAC;IACpD;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,CAAC,gBAAgB,CAAC,KAAK,IAAI,CAAC;IACnD;;OAEG;IACH,SAAS,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IACjC;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAOD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAAC,EAC5B,KAAK,EACL,aAAqB,EACrB,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,SAAiB,EACjB,KAAK,EACL,UAAkB,EAClB,QAAQ,EACR,eAAe,EACf,UAAkB,EAClB,UAAkB,EAClB,UAAkB,EAClB,IAAW,EACX,OAAO,EACP,MAAM,EACN,SAAS,EACT,MAAM,EACN,KAAK,EACL,MAAM,EACN,SAAS,EACT,KAAK,EACL,GAAG,EACH,GAAG,IAAI,EACR,EAAE,kBAAkB,+BA6MpB;yBAtOe,aAAa"}
+{"version":3,"file":"CheckboxInput.d.ts","sourceRoot":"","sources":["../../src/CheckboxInput/CheckboxInput.tsx"],"names":[],"mappings":"AAIA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAOL,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,MAAM,MAAM,kBAAkB,CAAC;AAS3C,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,gBAAgB,CAAC;AAG9C,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,SAAS,CAAC;AACtC,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,gBAAgB,CAAC;AAsEhD,QAAA,MAAM,iBAAiB;;;;;;;;;EASrB,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,MAAM,OAAO,iBAAiB,CAAC;AAE/D,MAAM,WAAW,kBAAmB,SAAQ,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC;IACrE,wDAAwD;IACxD,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAClC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,WAAW,CAAC,gBAAgB,CAAC,KAAK,IAAI,CAAC;IACxE;;OAEG;IACH,YAAY,CAAC,EAAE,CACb,OAAO,EAAE,OAAO,EAChB,CAAC,EAAE,WAAW,CAAC,gBAAgB,CAAC,KAC7B,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;OAEG;IACH,KAAK,EAAE,OAAO,GAAG,eAAe,CAAC;IACjC;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;OAIG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,CAAC,gBAAgB,CAAC,KAAK,IAAI,CAAC;IACpD;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,CAAC,gBAAgB,CAAC,KAAK,IAAI,CAAC;IACnD;;OAEG;IACH,SAAS,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IACjC;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAOD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAAC,EAC5B,KAAK,EACL,aAAqB,EACrB,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,SAAiB,EACjB,KAAK,EACL,UAAkB,EAClB,QAAQ,EACR,eAAe,EACf,UAAkB,EAClB,UAAkB,EAClB,UAAkB,EAClB,IAAW,EACX,OAAO,EACP,MAAM,EACN,SAAS,EACT,MAAM,EACN,KAAK,EACL,MAAM,EACN,SAAS,EACT,KAAK,EACL,GAAG,EACH,GAAG,IAAI,EACR,EAAE,kBAAkB,+BA+MpB;yBAxOe,aAAa"}

package/dist/CheckboxInput/CheckboxInput.js

@@ -23,7 +23,7 @@ import { FieldLabel } from "../Field/FieldLabel.js";
 import { FieldStatus } from "../FieldStatus/FieldStatus.js";
 import { Spinner } from "../Spinner/index.js";
 import { useTooltip } from "../Tooltip/index.js";
-import { mergeProps } from "../utils/index.js";
+import { mergeProps, rtlStyles } from "../utils/index.js";
 import { indicatorScope } from "../Indicator/indicator.markers.stylex.js";
 import { useIndicatorFocusRing } from "../hooks/useIndicatorFocusRing.js";
 import { useResolvedRequired } from "../hooks/useResolvedRequired.js";
@@ -54,16 +54,17 @@ const styles = {
   },
   input: {
     kVAEAm: "x10l6tqk",
+    k87sOh: "xwa60dl",
     kogj98: "x1ghz6dp",
     kmVPX3: "x1717udv",
     kSiTet: "xg01cxk",
     kkrTdU: "x1ypdohk x16khyan",
     kY2c9j: "x1vjfegm",
-    k7Eaqz: "xkagaj0",
-    kAzted: "x80b3aj",
-    k87sOh: "xijlfn0",
-    kLqNvP: "x1hsn8va",
-    k3aq6I: "x8i4i9p",
+    $$css: true
+  },
+  inputCoarse: {
+    kjFi6P: "xkagaj0",
+    kHzOjL: "x80b3aj",
     $$css: true
   },
   inputDisabled: {
@@ -270,7 +271,7 @@ export function CheckboxInput({
           "aria-describedby": ariaDescribedBy,
           "aria-invalid": status?.type === 'error' ? true : undefined,
           "aria-busy": isBusy || undefined,
-          ...stylex.props(styles.input, wrapperSizeStyles[size], isDisabled && styles.inputDisabled)
+          ...stylex.props(styles.input, rtlStyles.centerInline('-50%'), styles.inputCoarse, wrapperSizeStyles[size], isDisabled && styles.inputDisabled)
         }), /*#__PURE__*/_jsx("span", {
           ref: indicatorRef,
           ...{

package/dist/CheckboxList/CheckboxListItem.d.ts

@@ -19,7 +19,9 @@ export interface CheckboxListItemProps extends BaseProps<HTMLLIElement> {
      *
      * Accepts a plain string (single-line truncation applied automatically)
      * or a ReactNode for rich content (no truncation constraints —
-     * child components control their own text behavior).
+     * child components control their own text behavior). Links and buttons in
+     * the label keep their own behavior; only non-interactive row clicks
+     * delegate to the checkbox.
      */
     label: ReactNode;
     /**
@@ -47,9 +49,9 @@ export interface CheckboxListItemProps extends BaseProps<HTMLLIElement> {
      */
     value?: string;
     /**
-     * Secondary text below the label.
+     * Secondary content below the label. Accepts a plain string or a ReactNode.
      */
-    description?: string;
+    description?: ReactNode;
     /**
      * Content rendered after the label area.
      */