@astryxdesign/core 0.6.0 → 0.6.1

package/dist/hooks/scrollOwnerRegistry.js

@@ -0,0 +1,24 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/** Private DOM registry used by future axis-aware Sticky consumers. */
+
+const owners = new WeakMap();
+export function registerScrollOwner(element, state) {
+  owners.set(element, state);
+}
+export function unregisterScrollOwner(element) {
+  owners.delete(element);
+}
+export function getRegisteredScrollOwnerState(element) {
+  return owners.get(element);
+}
+export function findNearestScrollOwner(element, axis) {
+  let candidate = element.parentElement;
+  while (candidate != null) {
+    if (owners.get(candidate)?.[axis].isScrollable === true) {
+      return candidate;
+    }
+    candidate = candidate.parentElement;
+  }
+  return null;
+}

package/dist/hooks/useFocusTrap.d.ts

@@ -8,6 +8,14 @@
  *   stack rather than ask whether a trap exists.
  */
 export declare function hasActiveFocusTrapEscape(): boolean;
+/**
+ * Keep the deprecated `hasActiveFocusTrapEscape` signal accurate for a focus
+ * trap whose Escape is coordinated by another registration in the shared
+ * stack. This hook is intentionally internal (not re-exported from `hooks`): it
+ * preserves the released read-only compatibility signal without creating a
+ * second dismissal owner.
+ */
+export declare function useFocusTrapEscapeCompatibilitySignal(isActive: boolean): void;
 /**
  * Configuration for focus trap behavior
  */

package/dist/hooks/useFocusTrap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useFocusTrap.d.ts","sourceRoot":"","sources":["../../src/hooks/useFocusTrap.ts"],"names":[],"mappings":"AA8BA;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,IAAI,OAAO,CAElD;AAgFD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW;IACrE;;OAEG;IACH,YAAY,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAExC;;OAEG;IACH,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EAC9D,OAAO,EAAE,mBAAmB,GAC3B,kBAAkB,CAAC,CAAC,CAAC,CA0QvB"}
+{"version":3,"file":"useFocusTrap.d.ts","sourceRoot":"","sources":["../../src/hooks/useFocusTrap.ts"],"names":[],"mappings":"AA8BA;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,IAAI,OAAO,CAElD;AAED;;;;;;GAMG;AACH,wBAAgB,qCAAqC,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAU7E;AAgFD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW;IACrE;;OAEG;IACH,YAAY,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAExC;;OAEG;IACH,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EAC9D,OAAO,EAAE,mBAAmB,GAC3B,kBAAkB,CAAC,CAAC,CAAC,CAkQvB"}

package/dist/hooks/useFocusTrap.js

@@ -5,8 +5,8 @@
 /**
  * @file useFocusTrap.ts
  * @input Uses React useCallback, useEffect, useRef
- * @output Exports useFocusTrap hook for trapping focus within a container and
- *   restoring focus to the previously-focused element on deactivation
+ * @output Exports useFocusTrap, the deprecated Escape-state shim, and an
+ *   internal compatibility-signal hook
  * @position Core hook; used by dialogs, modals, date pickers
  *
  * Based on WAI-ARIA dialog pattern:
@@ -39,6 +39,25 @@ export function hasActiveFocusTrapEscape() {
   return activeEscapeTrapCount > 0;
 }
 
+/**
+ * Keep the deprecated `hasActiveFocusTrapEscape` signal accurate for a focus
+ * trap whose Escape is coordinated by another registration in the shared
+ * stack. This hook is intentionally internal (not re-exported from `hooks`): it
+ * preserves the released read-only compatibility signal without creating a
+ * second dismissal owner.
+ */
+export function useFocusTrapEscapeCompatibilitySignal(isActive) {
+  useEffect(() => {
+    if (!isActive) {
+      return;
+    }
+    activeEscapeTrapCount += 1;
+    return () => {
+      activeEscapeTrapCount -= 1;
+    };
+  }, [isActive]);
+}
+
 /**
  * Whether an element is currently perceivable/focusable — excludes ones hidden
  * via `display:none`/`visibility:hidden` or inside an `inert`/`hidden` subtree,
@@ -185,15 +204,7 @@ export function useFocusTrap(options) {
     // still resolve in the right order.
     getContainer: () => containerRef.current
   });
-  useEffect(() => {
-    if (!isEscapeTrap) {
-      return;
-    }
-    activeEscapeTrapCount += 1;
-    return () => {
-      activeEscapeTrapCount -= 1;
-    };
-  }, [isEscapeTrap]);
+  useFocusTrapEscapeCompatibilitySignal(isEscapeTrap);
 
   /**
    * Focus the first focusable element.

package/dist/hooks/useScrollableArea.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @file useScrollableArea.ts
+ * @input Logical scroll intent, keyboard ownership, caller-owned viewport/content props
+ * @output Safe prop getters and stable per-axis effective scroll state
+ * @position Canonical behavior core for ScrollableArea and structure-owning adopters
+ *
+ * SYNC: When modified, update:
+ * - /packages/core/src/hooks/useScrollableArea.doc.mjs
+ * - /packages/core/src/hooks/useScrollableArea.test.tsx
+ * - /packages/core/src/hooks/index.ts
+ */
+import { type RefAttributes } from 'react';
+import type { BaseProps } from '../BaseProps';
+export type ScrollAxis = 'inline' | 'block' | 'both';
+export type ScrollOverscroll = 'allow' | 'contain';
+export type ScrollStickyContainment = 'whenScrollable' | 'always';
+export type ScrollKeyboardAccess = {
+    owner: 'content';
+} | {
+    owner: 'viewport';
+    label: string;
+    role?: 'group' | 'region';
+};
+export interface ScrollAxisState {
+    isScrollable: boolean;
+    atStart: boolean;
+    atEnd: boolean;
+}
+export interface ScrollableAreaState {
+    inline: ScrollAxisState;
+    block: ScrollAxisState;
+}
+export interface UseScrollableAreaOptions {
+    axis: ScrollAxis;
+    keyboardAccess: ScrollKeyboardAccess;
+    overscroll?: ScrollOverscroll;
+    stickyContainment?: ScrollStickyContainment;
+}
+export type ScrollableElementProps<E extends HTMLElement> = BaseProps<E> & RefAttributes<E>;
+export interface UseScrollableAreaResult {
+    getViewportProps<E extends HTMLElement>(props?: ScrollableElementProps<E>): ScrollableElementProps<E>;
+    getContentProps<E extends HTMLElement>(props?: ScrollableElementProps<E>): ScrollableElementProps<E>;
+    state: ScrollableAreaState;
+}
+/**
+ * Adds axis-aware scroll behavior to caller-owned viewport and content boxes.
+ * The returned prop getters compose refs and preserve caller props, so spread
+ * order cannot detach measurement or override behavior-owned accessibility.
+ */
+export declare function useScrollableArea({ axis, keyboardAccess, overscroll, stickyContainment, }: UseScrollableAreaOptions): UseScrollableAreaResult;
+//# sourceMappingURL=useScrollableArea.d.ts.map

package/dist/hooks/useScrollableArea.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useScrollableArea.d.ts","sourceRoot":"","sources":["../../src/hooks/useScrollableArea.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;GAUG;AAEH,OAAO,EAOL,KAAK,aAAa,EAEnB,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AAiB5C,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;AACrD,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,SAAS,CAAC;AACnD,MAAM,MAAM,uBAAuB,GAAG,gBAAgB,GAAG,QAAQ,CAAC;AAElE,MAAM,MAAM,oBAAoB,GAC5B;IAAC,KAAK,EAAE,SAAS,CAAA;CAAC,GAClB;IAAC,KAAK,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAA;CAAC,CAAC;AAElE,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,eAAe,CAAC;IACxB,KAAK,EAAE,eAAe,CAAC;CACxB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,UAAU,CAAC;IACjB,cAAc,EAAE,oBAAoB,CAAC;IACrC,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,iBAAiB,CAAC,EAAE,uBAAuB,CAAC;CAC7C;AAED,MAAM,MAAM,sBAAsB,CAAC,CAAC,SAAS,WAAW,IAAI,SAAS,CAAC,CAAC,CAAC,GACtE,aAAa,CAAC,CAAC,CAAC,CAAC;AAEnB,MAAM,WAAW,uBAAuB;IACtC,gBAAgB,CAAC,CAAC,SAAS,WAAW,EACpC,KAAK,CAAC,EAAE,sBAAsB,CAAC,CAAC,CAAC,GAChC,sBAAsB,CAAC,CAAC,CAAC,CAAC;IAC7B,eAAe,CAAC,CAAC,SAAS,WAAW,EACnC,KAAK,CAAC,EAAE,sBAAsB,CAAC,CAAC,CAAC,GAChC,sBAAsB,CAAC,CAAC,CAAC,CAAC;IAC7B,KAAK,EAAE,mBAAmB,CAAC;CAC5B;AAiGD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,IAAI,EACJ,cAAc,EACd,UAAoB,EACpB,iBAAoC,GACrC,EAAE,wBAAwB,GAAG,uBAAuB,CAwRpD"}

package/dist/hooks/useScrollableArea.js

@@ -0,0 +1,287 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+'use client';
+
+/**
+ * @file useScrollableArea.ts
+ * @input Logical scroll intent, keyboard ownership, caller-owned viewport/content props
+ * @output Safe prop getters and stable per-axis effective scroll state
+ * @position Canonical behavior core for ScrollableArea and structure-owning adopters
+ *
+ * SYNC: When modified, update:
+ * - /packages/core/src/hooks/useScrollableArea.doc.mjs
+ * - /packages/core/src/hooks/useScrollableArea.test.tsx
+ * - /packages/core/src/hooks/index.ts
+ */
+import { useCallback, useMemo, useRef, useState } from 'react';
+import * as stylex from '@stylexjs/stylex';
+import { useIsomorphicLayoutEffect } from "./useIsomorphicLayoutEffect.js";
+import { mergeProps } from "../utils/mergeProps.js";
+import { mergeRefs } from "../utils/mergeRefs.js";
+import { observeResize } from "../utils/sharedResizeObserver.js";
+import { getLogicalAxisMapping, measureLogicalOverflowGeometry, measureLogicalScrollAxis } from "./scrollGeometry.js";
+import { registerScrollOwner, unregisterScrollOwner } from "./scrollOwnerRegistry.js";
+const INACTIVE_AXIS_STATE = {
+  isScrollable: false,
+  atStart: true,
+  atEnd: true
+};
+const INITIAL_STATE = {
+  inline: INACTIVE_AXIS_STATE,
+  block: INACTIVE_AXIS_STATE
+};
+const INITIAL_OVERFLOW = {
+  inline: false,
+  block: false
+};
+const INITIAL_MAPPING = {
+  inline: 'x',
+  block: 'y',
+  inlineReversed: false,
+  blockReversed: false
+};
+const styles = {
+  overflow: (overflowX, overflowY) => [{
+    kXHlph: overflowX != null ? "xyto64x" : overflowX,
+    kORKVm: overflowY != null ? "x4ncuvb" : overflowY,
+    $$css: true
+  }, {
+    "--x-overflowX": overflowX != null ? overflowX : undefined,
+    "--x-overflowY": overflowY != null ? overflowY : undefined
+  }]
+};
+function axisIsRequested(requested, axis) {
+  return requested === axis || requested === 'both';
+}
+function statesEqual(a, b) {
+  return a.inline.isScrollable === b.inline.isScrollable && a.inline.atStart === b.inline.atStart && a.inline.atEnd === b.inline.atEnd && a.block.isScrollable === b.block.isScrollable && a.block.atStart === b.block.atStart && a.block.atEnd === b.block.atEnd;
+}
+function overflowEqual(a, b) {
+  return a.inline === b.inline && a.block === b.block;
+}
+function mappingsEqual(a, b) {
+  return a.inline === b.inline && a.block === b.block && a.inlineReversed === b.inlineReversed && a.blockReversed === b.blockReversed;
+}
+function withoutOwnedOverflow(style) {
+  if (style == null) {
+    return undefined;
+  }
+  const result = {
+    ...style
+  };
+  delete result.overflow;
+  delete result.overflowX;
+  delete result.overflowY;
+  delete result.overflowInline;
+  delete result.overflowBlock;
+  return result;
+}
+function useStableComposedRef(internalRef) {
+  const cachedExternalRef = useRef(undefined);
+  const cachedComposedRef = useRef(null);
+  return useCallback(externalRef => {
+    if (cachedComposedRef.current != null && Object.is(cachedExternalRef.current, externalRef)) {
+      return cachedComposedRef.current;
+    }
+    const composed = mergeRefs(externalRef, internalRef);
+    cachedExternalRef.current = externalRef;
+    cachedComposedRef.current = composed;
+    return composed;
+  }, [internalRef]);
+}
+
+/**
+ * Adds axis-aware scroll behavior to caller-owned viewport and content boxes.
+ * The returned prop getters compose refs and preserve caller props, so spread
+ * order cannot detach measurement or override behavior-owned accessibility.
+ */
+export function useScrollableArea({
+  axis,
+  keyboardAccess,
+  overscroll = 'allow',
+  stickyContainment = 'whenScrollable'
+}) {
+  const [viewport, setViewport] = useState(null);
+  const [content, setContent] = useState(null);
+  const [measured, setMeasured] = useState(INITIAL_STATE);
+  const [overflow, setOverflow] = useState(INITIAL_OVERFLOW);
+  const [mapping, setMapping] = useState(INITIAL_MAPPING);
+  const stateRef = useRef(INITIAL_STATE);
+  const viewportRef = useCallback(node => {
+    setViewport(current => current === node ? current : node);
+  }, []);
+  const contentRef = useCallback(node => {
+    setContent(current => current === node ? current : node);
+  }, []);
+  const getComposedViewportRef = useStableComposedRef(viewportRef);
+  const getComposedContentRef = useStableComposedRef(contentRef);
+  useIsomorphicLayoutEffect(() => {
+    if (viewport == null || content == null) {
+      return;
+    }
+    let frame = null;
+    let isActive = true;
+    const measure = () => {
+      frame = null;
+      const computedStyle = getComputedStyle(viewport);
+      const nextMapping = getLogicalAxisMapping(computedStyle.writingMode, computedStyle.direction);
+      const inlineOverflow = axisIsRequested(axis, 'inline') ? measureLogicalOverflowGeometry(viewport, 'inline', nextMapping) : false;
+      const blockOverflow = axisIsRequested(axis, 'block') ? measureLogicalOverflowGeometry(viewport, 'block', nextMapping) : false;
+      const inline = axisIsRequested(axis, 'inline') ? measureLogicalScrollAxis(viewport, 'inline', nextMapping) : INACTIVE_AXIS_STATE;
+      const block = axisIsRequested(axis, 'block') ? measureLogicalScrollAxis(viewport, 'block', nextMapping) : INACTIVE_AXIS_STATE;
+
+      // Hidden, disconnected, and zero-size viewports are unknown rather than
+      // fitting. Keep the last valid state until a bounded signal remeasures.
+      if (inlineOverflow == null || blockOverflow == null || inline == null || block == null) {
+        return;
+      }
+      const nextOverflow = {
+        inline: inlineOverflow,
+        block: blockOverflow
+      };
+      const nextState = {
+        inline,
+        block
+      };
+      stateRef.current = nextState;
+      registerScrollOwner(viewport, nextState);
+      // eslint-disable-next-line @eslint-react/set-state-in-effect -- measured DOM geometry controls whether the viewport becomes a CSS scroll container
+      setOverflow(current => overflowEqual(current, nextOverflow) ? current : nextOverflow);
+      // eslint-disable-next-line @eslint-react/set-state-in-effect -- measured DOM state is the hook's output
+      setMeasured(current => statesEqual(current, nextState) ? current : nextState);
+      // eslint-disable-next-line @eslint-react/set-state-in-effect -- writing-mode changes remap behavior-owned physical CSS
+      setMapping(current => mappingsEqual(current, nextMapping) ? current : nextMapping);
+    };
+    const scheduleMeasure = () => {
+      if (!isActive || frame != null) {
+        return;
+      }
+      frame = window.requestAnimationFrame(measure);
+    };
+    registerScrollOwner(viewport, stateRef.current);
+    measure();
+    const stopObservingViewport = observeResize(viewport, scheduleMeasure);
+    const stopObservingContent = observeResize(content, scheduleMeasure);
+    viewport.addEventListener('scroll', scheduleMeasure, {
+      passive: true
+    });
+    window.addEventListener('resize', scheduleMeasure);
+    window.visualViewport?.addEventListener('resize', scheduleMeasure);
+    content.addEventListener('load', scheduleMeasure, true);
+    viewport.addEventListener('transitionend', scheduleMeasure);
+    viewport.addEventListener('animationend', scheduleMeasure);
+    content.addEventListener('transitionend', scheduleMeasure);
+    content.addEventListener('animationend', scheduleMeasure);
+    const mutationObserver = typeof MutationObserver === 'undefined' ? null : new MutationObserver(scheduleMeasure);
+    mutationObserver?.observe(viewport, {
+      attributes: true,
+      attributeFilter: ['class', 'dir', 'hidden', 'style']
+    });
+    mutationObserver?.observe(content, {
+      attributes: true,
+      attributeFilter: ['class', 'dir', 'hidden', 'style'],
+      characterData: true,
+      childList: true,
+      subtree: true
+    });
+    let ancestor = viewport.parentElement;
+    while (ancestor != null) {
+      mutationObserver?.observe(ancestor, {
+        attributes: true,
+        attributeFilter: ['class', 'dir', 'hidden', 'style']
+      });
+      ancestor = ancestor.parentElement;
+    }
+    const fonts = document.fonts;
+    fonts?.addEventListener?.('loadingdone', scheduleMeasure);
+    void fonts?.ready.then(scheduleMeasure);
+    return () => {
+      isActive = false;
+      unregisterScrollOwner(viewport);
+      stopObservingViewport();
+      stopObservingContent();
+      mutationObserver?.disconnect();
+      viewport.removeEventListener('scroll', scheduleMeasure);
+      window.removeEventListener('resize', scheduleMeasure);
+      window.visualViewport?.removeEventListener('resize', scheduleMeasure);
+      content.removeEventListener('load', scheduleMeasure, true);
+      viewport.removeEventListener('transitionend', scheduleMeasure);
+      viewport.removeEventListener('animationend', scheduleMeasure);
+      content.removeEventListener('transitionend', scheduleMeasure);
+      content.removeEventListener('animationend', scheduleMeasure);
+      fonts?.removeEventListener?.('loadingdone', scheduleMeasure);
+      if (frame != null) {
+        window.cancelAnimationFrame(frame);
+      }
+    };
+  }, [axis, content, viewport]);
+  const state = useMemo(() => ({
+    inline: axisIsRequested(axis, 'inline') ? measured.inline : INACTIVE_AXIS_STATE,
+    block: axisIsRequested(axis, 'block') ? measured.block : INACTIVE_AXIS_STATE
+  }), [axis, measured]);
+  const getViewportProps = useCallback((props = {}) => {
+    const hasEffectiveAxis = state.inline.isScrollable || state.block.isScrollable;
+    const requestedX = axisIsRequested(axis, 'inline') && mapping.inline === 'x' || axisIsRequested(axis, 'block') && mapping.block === 'x';
+    const requestedY = axisIsRequested(axis, 'inline') && mapping.inline === 'y' || axisIsRequested(axis, 'block') && mapping.block === 'y';
+    const overflowingX = overflow.inline && mapping.inline === 'x' || overflow.block && mapping.block === 'x';
+    const overflowingY = overflow.inline && mapping.inline === 'y' || overflow.block && mapping.block === 'y';
+    const containsSticky = overflowingX || overflowingY || stickyContainment === 'always';
+    const scrollsOnX = stickyContainment === 'always' ? requestedX : overflowingX;
+    const scrollsOnY = stickyContainment === 'always' ? requestedY : overflowingY;
+    const {
+      xstyle,
+      ...domProps
+    } = props;
+    const callerProps = {
+      ...domProps,
+      style: withoutOwnedOverflow(domProps.style)
+    };
+    const styledProps = mergeProps(callerProps, stylex.props(xstyle, styles.overflow(containsSticky ? scrollsOnX ? 'auto' : 'hidden' : 'clip', containsSticky ? scrollsOnY ? 'auto' : 'hidden' : 'clip')));
+    const keepsProgrammaticFocus = !hasEffectiveAxis && viewport != null && typeof document !== 'undefined' && document.activeElement === viewport;
+    const behaviorStyle = {
+      ...styledProps.style
+    };
+    const containInline = overscroll === 'contain' && state.inline.isScrollable;
+    const containBlock = overscroll === 'contain' && state.block.isScrollable;
+    const inlinePhysical = mapping.inline;
+    const blockPhysical = mapping.block;
+    if (axisIsRequested(axis, 'inline')) {
+      behaviorStyle[inlinePhysical === 'x' ? 'overscrollBehaviorX' : 'overscrollBehaviorY'] = containInline ? 'contain' : 'auto';
+    }
+    if (axisIsRequested(axis, 'block')) {
+      behaviorStyle[blockPhysical === 'x' ? 'overscrollBehaviorX' : 'overscrollBehaviorY'] = containBlock ? 'contain' : 'auto';
+    }
+    const keyboardProps = keyboardAccess.owner === 'viewport' ? {
+      role: keyboardAccess.role ?? 'group',
+      'aria-label': keyboardAccess.label,
+      tabIndex: hasEffectiveAxis ? 0 : keepsProgrammaticFocus ? -1 : undefined
+    } : {};
+    const result = {
+      ...styledProps,
+      ...keyboardProps,
+      ref: getComposedViewportRef(styledProps.ref),
+      style: behaviorStyle,
+      'data-scroll-axis': axis,
+      'data-scrollable-inline': state.inline.isScrollable ? 'true' : undefined,
+      'data-scrollable-block': state.block.isScrollable ? 'true' : undefined,
+      'data-scroll-inline-start': state.inline.atStart ? 'true' : undefined,
+      'data-scroll-inline-end': state.inline.atEnd ? 'true' : undefined,
+      'data-scroll-block-start': state.block.atStart ? 'true' : undefined,
+      'data-scroll-block-end': state.block.atEnd ? 'true' : undefined
+    };
+    return result;
+  }, [axis, getComposedViewportRef, keyboardAccess, mapping, overflow, overscroll, state, stickyContainment, viewport]);
+  const getContentProps = useCallback((props = {}) => {
+    const result = {
+      ...props,
+      ref: getComposedContentRef(props.ref),
+      'data-scroll-content': ''
+    };
+    return result;
+  }, [getComposedContentRef]);
+  return {
+    getViewportProps,
+    getContentProps,
+    state
+  };
+}

package/dist/index.d.ts

@@ -35,6 +35,7 @@ export * from './CheckboxList';
 export * from './Collapsible';
 export * from './RadioList';
 export * from './Resizable';
+export * from './ScrollableArea';
 export * from './Divider';
 export * from './VisuallyHidden';
 export * from './EmptyState';

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -41,6 +41,7 @@ export * from "./CheckboxList/index.js";
 export * from "./Collapsible/index.js";
 export * from "./RadioList/index.js";
 export * from "./Resizable/index.js";
+export * from "./ScrollableArea/index.js";
 export * from "./Divider/index.js";
 export * from "./VisuallyHidden/index.js";
 export * from "./EmptyState/index.js";

package/dist/theme/defineTheme.d.ts

@@ -247,12 +247,8 @@ export interface DefineThemeInput {
      *  Values can be a string or [light, dark] tuple.
      *  Only include tokens you want to override; defaults fill the rest. */
     tokens?: Partial<Record<TokenName, TokenValue>>;
-    /**
-     * Theme-family-local CSS custom properties. Keys use the complete
-     * `--astryx-theme-${name}-...` spelling and values follow `TokenValue`.
-     * These names are available only to this enrolled theme lineage and do not
-     * become portable `TokenName` values.
-     */
+    /** Theme-family-local values keyed by any valid CSS custom-property name;
+     *  prefixes do not establish ownership. */
     localTokens?: Record<string, TokenValue>;
     /**
      * Component style overrides — keyed by component name (lowercase).

package/dist/theme/defineTheme.d.ts.map

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

package/dist/theme/defineTheme.js

@@ -226,7 +226,7 @@ export function defineTheme(input) {
   // media-surface value stays more specific in the authored cascade.
   const __onDark = resolveOnMedia('dark', input.onDark, base?.__onDark);
   const __onLight = resolveOnMedia('light', input.onLight, base?.__onLight);
-  const localTokenContract = resolveLocalTokenContract(input, base, tokens, components, __onDark, __onLight);
+  const localTokenContract = resolveLocalTokenContract(input, base, tokens, tokenDefaults);
 
   // Adaptations inherit their breakpoint map and ordered rules. Every rule is
   // re-resolved against this theme's effective root axes, so a child can change

package/dist/theme/derivedVarRegistry.js

@@ -126,7 +126,7 @@ export const derivedVarRegistry = {
  * the old key still selects the element. Without this the rule would land but
  * its derived vars would not expand, and the half that travels through a var
  * (a hover card's radius, a text area's inline padding) would silently do
- * nothing. Drop these with the classes, in the next major.
+ * nothing. Keep these aliases aligned with the emitted compatibility classes.
  */
 const DEPRECATED_REGISTRY_KEYS = {
   hovercard: 'hover-card',

package/dist/theme/localTokens.d.ts

@@ -1,14 +1,11 @@
 /**
  * @file localTokens.ts
  * @input Root and adaptation theme-local token declarations and references
- * @output Validated enrollment metadata plus normalized conditional writes
- * @position Theme-local namespace owner; final adaptation-cycle validation is
+ * @output Validated exact-name ownership metadata plus normalized conditional writes
+ * @position Theme-local ownership boundary; final adaptation-cycle validation is
  *   performed after the reachable ordered cascade is assembled.
  */
-import type { ComponentStyleMap, DefinedTheme, TokenValue } from './defineTheme';
-import type { ResolvedOnMedia } from './onMediaTokens';
-/** Whether a custom-property name belongs to Astryx's reserved local namespace. */
-export declare function isReservedThemeLocalTokenName(name: string): boolean;
+import type { DefinedTheme, TokenValue } from './defineTheme';
 export interface ResolvedLocalTokenContract {
     localTokens: Record<string, string>;
     owners: Record<string, string>;
@@ -19,18 +16,18 @@ export declare function assertNoTokenCycles(tokenValues: Record<string, string>,
  * Resolve and validate the opt-in theme-local token contract.
  *
  * Themes that omit `localTokens` and do not extend an enrolled base bypass this
- * function's reserved-namespace checks so legacy token behavior stays intact.
+ * function's exact owner and lineage checks so legacy token behavior stays intact.
  */
 export declare function resolveLocalTokenContract(input: {
     name: string;
     localTokens?: Record<string, TokenValue>;
-}, base: DefinedTheme | undefined, tokens: Record<string, string>, components: ComponentStyleMap | undefined, onDark: ResolvedOnMedia | undefined, onLight: ResolvedOnMedia | undefined): ResolvedLocalTokenContract | undefined;
+}, base: DefinedTheme | undefined, tokens: Record<string, string>, portableTokens: Readonly<Record<string, string>>): ResolvedLocalTokenContract | undefined;
 /**
  * Resolve theme-local values written by one adaptation rule.
  *
  * Adaptations may replace names already enrolled by the root theme lineage, but
- * they never enroll names of their own. This validates one rule's references;
- * cycle validation waits until all co-matching writes have cascaded in order.
+ * they never enroll names of their own. Cycle validation waits until all
+ * co-matching writes have cascaded in order.
  */
-export declare function resolveAdaptationLocalTokens(themeName: string, ruleIndex: number, declarations: Record<string, TokenValue> | undefined, rootLocalTokens: Record<string, string> | undefined, tokens: Record<string, string>, components: ComponentStyleMap | undefined): Record<string, string> | undefined;
+export declare function resolveAdaptationLocalTokens(themeName: string, ruleIndex: number, declarations: Record<string, TokenValue> | undefined, rootLocalTokens: Record<string, string> | undefined): Record<string, string> | undefined;
 //# sourceMappingURL=localTokens.d.ts.map

package/dist/theme/localTokens.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"localTokens.d.ts","sourceRoot":"","sources":["../../src/theme/localTokens.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAC,iBAAiB,EAAE,YAAY,EAAE,UAAU,EAAC,MAAM,eAAe,CAAC;AAC/E,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,iBAAiB,CAAC;AAOrD,mFAAmF;AACnF,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnE;AAED,MAAM,WAAW,0BAA0B;IACzC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAqED,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACnC,OAAO,CAAC,EAAE,MAAM,EAChB,aAAa,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GAClC,IAAI,CA4GN;AA6ED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE;IACL,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CAC1C,EACD,IAAI,EAAE,YAAY,GAAG,SAAS,EAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,UAAU,EAAE,iBAAiB,GAAG,SAAS,EACzC,MAAM,EAAE,eAAe,GAAG,SAAS,EACnC,OAAO,EAAE,eAAe,GAAG,SAAS,GACnC,0BAA0B,GAAG,SAAS,CAwExC;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,SAAS,EACpD,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EACnD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,UAAU,EAAE,iBAAiB,GAAG,SAAS,GACxC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CA+CpC"}
+{"version":3,"file":"localTokens.d.ts","sourceRoot":"","sources":["../../src/theme/localTokens.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAC,YAAY,EAAE,UAAU,EAAC,MAAM,eAAe,CAAC;AAY5D,MAAM,WAAW,0BAA0B;IACzC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAuDD,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACnC,OAAO,CAAC,EAAE,MAAM,EAChB,aAAa,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GAClC,IAAI,CA4GN;AAwDD;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE;IACL,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CAC1C,EACD,IAAI,EAAE,YAAY,GAAG,SAAS,EAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAC/C,0BAA0B,GAAG,SAAS,CAgExC;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,SAAS,EACpD,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,GAClD,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAwBpC"}