@astryxdesign/core 0.7.4 → 0.7.5-canary.04434e7

package/dist/NavIcon/NavIcon.d.ts

@@ -12,7 +12,7 @@
  * - /packages/cli/assets/templates/blocks/components/NavIcon/NavIconShowcase.tsx
  */
 import type { ReactNode } from 'react';
-import type { BaseProps } from '../BaseProps';
+import type { BaseProps } from '../BaseProps.js';
 export interface NavIconProps extends BaseProps<HTMLSpanElement> {
     /** Ref forwarded to the root element */
     ref?: React.Ref<HTMLSpanElement>;

package/dist/NavIcon/index.d.ts

@@ -6,6 +6,6 @@
  *
  * SYNC: When modified, update /packages/core/src/NavIcon/NavIcon.doc.mjs
  */
-export { NavIcon } from './NavIcon';
-export type { NavIconProps } from './NavIcon';
+export { NavIcon } from './NavIcon.js';
+export type { NavIconProps } from './NavIcon.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/NavMenu/NavHeadingMenu.d.ts

@@ -8,8 +8,8 @@
  * - /packages/core/src/NavMenu/index.ts
  */
 import React, { type ReactNode } from 'react';
-import type { BaseProps } from '../BaseProps';
-import { type NavHeadingMenuSize } from './NavMenuContext';
+import type { BaseProps } from '../BaseProps.js';
+import { type NavHeadingMenuSize } from './NavMenuContext.js';
 export interface NavHeadingMenuProps extends BaseProps<HTMLDivElement> {
     ref?: React.Ref<HTMLDivElement>;
     /** Menu items (NavHeadingMenuItem, dividers, custom content). */

package/dist/NavMenu/NavHeadingMenuItem.d.ts

@@ -8,8 +8,8 @@
  * - /packages/core/src/NavMenu/index.ts
  */
 import React, { type ReactNode } from 'react';
-import { type IconType } from '../Icon';
-import type { BaseProps } from '../BaseProps';
+import { type IconType } from '../Icon/index.js';
+import type { BaseProps } from '../BaseProps.js';
 export interface NavHeadingMenuItemProps extends Omit<BaseProps<HTMLElement>, 'onClick'> {
     ref?: React.Ref<HTMLElement>;
     /** Icon to display before the label. */

package/dist/NavMenu/index.d.ts

@@ -1,7 +1,7 @@
-export { NavHeadingMenu } from './NavHeadingMenu';
-export type { NavHeadingMenuProps } from './NavHeadingMenu';
-export { NavHeadingMenuItem } from './NavHeadingMenuItem';
-export type { NavHeadingMenuItemProps } from './NavHeadingMenuItem';
-export { NavHeadingMenuContext, useNavHeadingMenuContext, NavHeadingCloseContext, useNavHeadingCloseContext, } from './NavMenuContext';
-export type { NavHeadingMenuContextValue, NavHeadingCloseContextValue, NavHeadingMenuSize, } from './NavMenuContext';
+export { NavHeadingMenu } from './NavHeadingMenu.js';
+export type { NavHeadingMenuProps } from './NavHeadingMenu.js';
+export { NavHeadingMenuItem } from './NavHeadingMenuItem.js';
+export type { NavHeadingMenuItemProps } from './NavHeadingMenuItem.js';
+export { NavHeadingMenuContext, useNavHeadingMenuContext, NavHeadingCloseContext, useNavHeadingCloseContext, } from './NavMenuContext.js';
+export type { NavHeadingMenuContextValue, NavHeadingCloseContextValue, NavHeadingMenuSize, } from './NavMenuContext.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/NumberInput/NumberInput.d.ts

@@ -15,8 +15,8 @@
  */
 import { type FocusEvent, type KeyboardEvent, type ReactNode } from 'react';
 import * as stylex from '@stylexjs/stylex';
-import { type InputStatus, type FieldStatusVariant } from '../Field';
-import { type IconType } from '../Icon';
+import { type InputStatus, type FieldStatusVariant } from '../Field/index.js';
+import { type IconType } from '../Icon/index.js';
 declare const sizeStyles: Readonly<{
     readonly sm: Readonly<{
         readonly height: stylex.StyleXClassNameFor<"height", "28px">;
@@ -29,9 +29,9 @@ declare const sizeStyles: Readonly<{
     }>;
 }>;
 export type NumberInputSize = keyof typeof sizeStyles;
-export type { InputStatus as NumberInputStatus, InputStatusType as NumberInputStatusType, } from '../Field';
-import { type FieldInputBaseProps } from '../Field/fieldParts';
-import type { SizeValue } from '../utils/types';
+export type { InputStatus as NumberInputStatus, InputStatusType as NumberInputStatusType, } from '../Field/index.js';
+import { type FieldInputBaseProps } from '../Field/fieldParts.js';
+import type { SizeValue } from '../utils/types.js';
 interface NumberInputPropsBase extends Omit<FieldInputBaseProps, 'onChange' | 'defaultValue'> {
     /** Ref forwarded to the root element */
     ref?: React.Ref<HTMLInputElement>;
@@ -67,7 +67,7 @@ interface NumberInputPropsBase extends Omit<FieldInputBaseProps, 'onChange' | 'd
      * Whether the input is read-only.
      * The value is shown at full opacity and still submits with the form, but
      * cannot be edited. Unlike `isDisabled`, a read-only input is not dimmed and
-     * stays in the tab order — use it for a value the user should see and send
+     * keeps its form value — use it for a value the user should see and send
      * but not change. Stepping is off in every form while read-only: arrow keys,
      * the wheel, and the number steppers. `isDisabled` takes precedence when both
      * are set.
@@ -81,8 +81,8 @@ interface NumberInputPropsBase extends Omit<FieldInputBaseProps, 'onChange' | 'd
      * keyboard and assistive technology. The field cannot be edited (it becomes
      * read-only) while disabled.
      *
-     * Use this instead of wrapping a disabled input in `Tooltip` — disabled
-     * controls don't emit the pointer events an external tooltip needs.
+     * Use this instead of wrapping a disabled input in `Tooltip`, so the reason
+     * is attached to the field itself.
      *
      * @example
      * ```

package/dist/NumberInput/NumberInput.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NumberInput.d.ts","sourceRoot":"","sources":["../../src/NumberInput/NumberInput.tsx"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAML,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,MAAM,MAAM,kBAAkB,CAAC;AAS3C,OAAO,EAGL,KAAK,WAAW,EAKhB,KAAK,kBAAkB,EACxB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAuB,KAAK,QAAQ,EAAC,MAAM,SAAS,CAAC;AA8I5D,QAAA,MAAM,UAAU;;;;;;;;;;EAUd,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,UAAU,CAAC;AAMtD,YAAY,EACV,WAAW,IAAI,iBAAiB,EAChC,eAAe,IAAI,qBAAqB,GACzC,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,KAAK,mBAAmB,EAEzB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,gBAAgB,CAAC;AAM9C,UAAU,oBAAqB,SAAQ,IAAI,CACzC,mBAAmB,EACnB,UAAU,GAAG,cAAc,CAC5B;IACC,wCAAwC;IACxC,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;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;;;;;;OASG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,SAAS,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IACjC;;OAEG;IACH,SAAS,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IACjC;;;;OAIG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,kBAAkB,CAAC;IACnC;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,eAAe,CAAC;IAEvB;;;OAGG;IACH,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACjC;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACxC;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;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,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB;;OAEG;IACH,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,aAAa,CAAC,gBAAgB,CAAC,KAAK,IAAI,CAAC;CAC1D;AAED;;;GAGG;AACH,KAAK,4BAA4B,GAAG,oBAAoB,GAAG;IACzD,QAAQ,CAAC,EAAE,KAAK,CAAC;IACjB,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC,CAAC;AAEF,KAAK,yBAAyB,GAAG,oBAAoB,GAAG;IACtD;;;;;;OAMG;IACH,QAAQ,EAAE,IAAI,CAAC;IACf,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;CAC1C,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAC1B,4BAA4B,GAAG,yBAAyB,CAAC;AAsF3D;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,EAC1B,KAAK,EACL,aAAqB,EACrB,WAAW,EACX,UAAkB,EAClB,UAAkB,EAClB,UAAkB,EAClB,UAAkB,EAClB,eAAe,EACf,SAAS,EACT,SAAS,EACT,MAAM,EACN,aAA0B,EAC1B,IAAI,EAAE,QAAQ,EACd,QAAQ,EACR,KAAK,EACL,WAAW,EACX,YAAY,EACZ,YAAoB,EACpB,QAAQ,EACR,YAAY,EACZ,GAAG,EACH,GAAG,EACH,IAAI,EACJ,WAAW,EACX,cAAqB,EACrB,iBAAyB,EACzB,KAAK,EACL,aAAqB,EACrB,OAAO,EACP,MAAM,EACN,QAAQ,EACR,OAAO,EACP,SAAS,EACT,KAAK,EACL,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,GAAG,EACH,EAAE,EAAE,MAAM,EACV,kBAAkB,EAAE,mBAAmB,EACvC,GAAG,SAAS,EACb,EAAE,gBAAgB,+BAqflB;yBAliBe,WAAW"}
+{"version":3,"file":"NumberInput.d.ts","sourceRoot":"","sources":["../../src/NumberInput/NumberInput.tsx"],"names":[],"mappings":"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"}

package/dist/NumberInput/NumberInput.js

@@ -28,6 +28,7 @@ import { useTooltip } from "../Tooltip/index.js";
 import { getInputARIA } from "../utils/index.js";
 import { interactionOverlayStyles } from "../utils/interactionOverlay.stylex.js";
 import { usePressFeedback } from "../hooks/usePressFeedback.js";
+import { inputDisabledFocusStyles } from "../Field/inputDisabledFocus.js";
 import { useSize } from "../SizeContext/SizeContext.js";
 import { useInputContainer } from "../hooks/useInputContainer.js";
 import { useInputStatusIcon } from "../hooks/useInputStatusIcon.js";
@@ -275,12 +276,14 @@ export function NumberInput({
   const [pendingInput, setPendingInput] = useState(null);
   const [isFocused, setIsFocused] = useState(false);
 
-  // Disabled-reason tooltip. Disabled controls swallow pointer events, so the
-  // tooltip listeners attach to the input container (which already exists) and
+  // Disabled-reason tooltip. The tooltip listeners attach to the input container (which already exists) and
   // the input stays perceivable via aria-disabled instead of the native
   // disabled attribute. The field is made read-only so it can't be typed into,
   // and value mutation is blocked by the isDisabled guard in the handlers.
   const showsDisabledMessage = isDisabled && !!disabledMessage;
+  // A disabled field keeps its tab stop but, like a natively disabled one,
+  // runs no caller event handler other than focus and blur (`spec:AST-085` FR2).
+  const fieldProps = isDisabled ? Object.fromEntries(Object.entries(rest).filter(([key]) => !/^on[A-Z]/.test(key) || /^on(Focus|Blur)/.test(key))) : rest;
   const disabledMessageTooltip = useTooltip({
     placement: 'above',
     // The container div is not naturally focusable; focusin bubbles up from
@@ -359,6 +362,12 @@ export function NumberInput({
     if (pendingInput === null) {
       return;
     }
+    if (isDisabled) {
+      // A field disabled mid-entry commits nothing; its draft is dropped, as
+      // a natively disabled field's was (spec:AST-085 FR2).
+      setPendingInput(null);
+      return;
+    }
     const decision = resolveNumberInputCommit(pendingInput, {
       min,
       max,
@@ -376,7 +385,7 @@ export function NumberInput({
     } else if (decision.type === 'commit' && decision.value !== value) {
       onChange(decision.value);
     }
-  }, [hasClear, isIntegerOnly, locale, max, min, onChange, pendingInput, value]);
+  }, [hasClear, isDisabled, isIntegerOnly, locale, max, min, onChange, pendingInput, value]);
 
   // Blur ends the edit and displays the resulting committed value.
   const handleBlur = useCallback(e => {
@@ -419,6 +428,13 @@ export function NumberInput({
 
   // Handle keyboard events
   const handleKeyDown = useCallback(e => {
+    if (isDisabled) {
+      // A read-only field still submits its form on Enter.
+      if (e.key === 'Enter') {
+        e.preventDefault();
+      }
+      return;
+    }
     // The field is type="text" for formatted display, so an IME can compose
     // into it: Enter commits the candidate and the arrows walk the candidate
     // window. The composing keydown fires before compositionend, so without
@@ -442,7 +458,7 @@ export function NumberInput({
       onEnter?.();
     }
     onKeyDown?.(e);
-  }, [commitPendingInput, onEnter, onKeyDown, stepValue]);
+  }, [commitPendingInput, isDisabled, onEnter, onKeyDown, stepValue]);
 
   // React's delegated wheel listener can be passive, so use a native,
   // explicitly non-passive listener to prevent page scrolling only when this
@@ -479,12 +495,13 @@ export function NumberInput({
     if (!e || e.detail === 0) {
       inputRef.current?.focus();
     } else {
-      // Defer focus restoration past the button's unmount task so iOS Safari
-      // and touch browsers don't jump the page scroll to 0 on tap.
-      requestAnimationFrame(() => {
-        inputRef.current?.focus({
-          preventScroll: true
-        });
+      // Focus inside the tap: iOS Safari brings up its keyboard only for a
+      // focus made while handling the touch, so a field the tap reaches
+      // unfocused gets its keyboard, as UIKit's clear button makes the
+      // field first responder. `preventScroll` keeps a scrolled page where
+      // it is.
+      inputRef.current?.focus({
+        preventScroll: true
       });
     }
   }, [hasClear, onChange]);
@@ -513,7 +530,7 @@ export function NumberInput({
       status: status?.type ?? null,
       disabled: isDisabled ? 'disabled' : null,
       readonly: isReadOnly ? 'readonly' : null
-    }), stylex.props(inputWrapperStyles.base, styles.wrapper, hasNumberSteppers && styles.wrapperWithNumberSteppers, sizeStyles[size], isDisabled && inputWrapperStyles.disabled, status && inputStatusBorderStyles[status.type], status && !isDisabled && inputStatusHoverShadowStyles[status.type], status && inputStatusFocusWithinStyles[status.type], inputGroup && groupStyles.inGroup, controlXstyle), controlClassName, controlStyle),
+    }), stylex.props(inputWrapperStyles.base, styles.wrapper, hasNumberSteppers && styles.wrapperWithNumberSteppers, sizeStyles[size], isDisabled && inputWrapperStyles.disabled, isDisabled && inputDisabledFocusStyles.ring, status && inputStatusBorderStyles[status.type], status && !isDisabled && inputStatusHoverShadowStyles[status.type], status && inputStatusFocusWithinStyles[status.type], inputGroup && groupStyles.inGroup, controlXstyle), controlClassName, controlStyle),
     children: [startIcon && renderIconSlot(startIcon, {
       size: 'sm',
       color: 'secondary'
@@ -521,7 +538,7 @@ export function NumberInput({
       id: inputLabelID,
       children: label
     }), /*#__PURE__*/_jsx("input", {
-      ...rest,
+      ...fieldProps,
       ref: mergedInputRef,
       id: id,
       name: isDisabled || formatValue ? undefined : htmlName,
@@ -535,13 +552,12 @@ export function NumberInput({
       onBlur: handleBlur,
       onKeyDown: handleKeyDown,
       placeholder: placeholder
-      // With a disabledMessage the input keeps focusability via aria-disabled
-      // so the reason is focus-discoverable; readOnly + the handler guards
-      // keep the value from changing.
+      // A disabled input keeps its place in the tab order (spec:AST-085):
+      // aria-disabled instead of the native attribute, with readOnly + the
+      // handler guards keeping the value from changing.
       ,
-      disabled: isDisabled && !showsDisabledMessage,
-      "aria-disabled": showsDisabledMessage ? 'true' : undefined,
-      readOnly: isReadOnly || showsDisabledMessage || undefined,
+      "aria-disabled": isDisabled ? 'true' : undefined,
+      readOnly: isReadOnly || isDisabled || undefined,
       autoFocus: hasAutoFocus,
       "data-autofocus": hasAutoFocus || undefined,
       "aria-valuemin": min ?? undefined,
@@ -597,12 +613,17 @@ export function NumberInput({
         type: "button",
         tabIndex: -1,
         ...pressable,
-        disabled: isDisabled || isReadOnly || !canIncrement,
+        "aria-disabled": isDisabled || isReadOnly || !canIncrement || undefined,
         "aria-label": t('@astryx.numberInput.incrementLabel', {
           label
         }),
         onPointerDown: event => event.preventDefault(),
         onClick: () => {
+          // An aria-disabled stepper does nothing, as a natively disabled
+          // one did (spec:AST-085 FR2).
+          if (isDisabled || isReadOnly || !canIncrement) {
+            return;
+          }
           inputRef.current?.focus();
           stepValue(1);
         },
@@ -617,12 +638,17 @@ export function NumberInput({
         type: "button",
         tabIndex: -1,
         ...pressable,
-        disabled: isDisabled || isReadOnly || !canDecrement,
+        "aria-disabled": isDisabled || isReadOnly || !canDecrement || undefined,
         "aria-label": t('@astryx.numberInput.decrementLabel', {
           label
         }),
         onPointerDown: event => event.preventDefault(),
         onClick: () => {
+          // An aria-disabled stepper does nothing, as a natively disabled
+          // one did (spec:AST-085 FR2).
+          if (isDisabled || isReadOnly || !canDecrement) {
+            return;
+          }
           inputRef.current?.focus();
           stepValue(-1);
         },

package/dist/NumberInput/index.d.ts

@@ -6,6 +6,6 @@
  *
  * SYNC: When modified, update this header and /packages/core/src/NumberInput/NumberInput.doc.mjs
  */
-export { NumberInput } from './NumberInput';
-export type { NumberInputProps, NumberInputSize, NumberInputStatus, NumberInputStatusType, } from './NumberInput';
+export { NumberInput } from './NumberInput.js';
+export type { NumberInputProps, NumberInputSize, NumberInputStatus, NumberInputStatusType, } from './NumberInput.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/NumberInput/numberInputCommit.d.ts

@@ -10,7 +10,7 @@
  * - /packages/core/src/Table/plugins/filtering/useTableFiltering.tsx
  * - /packages/core/src/PowerSearch/PowerSearchValueEditor.tsx
  */
-import type { Locale } from '../i18n';
+import type { Locale } from '../i18n/index.js';
 interface NumberInputValidationOptions {
     min?: number | null;
     max?: number | null;

package/dist/NumberInput/numberParser.d.ts

@@ -32,7 +32,7 @@
  * - /packages/core/src/NumberInput/numberParser.test.ts
  * - /packages/core/src/NumberInput/numberParser.docblock.test.ts
  */
-import type { Locale } from '../i18n';
+import type { Locale } from '../i18n/index.js';
 /**
  * Read a number out of text the way a person in `locale` writes one: their
  * grouping and decimal separators, their group sizes, their digit script, an

package/dist/Outline/Outline.d.ts

@@ -1,6 +1,6 @@
-import type { BaseProps } from '../BaseProps';
-import type { OutlineItem } from './types';
-export type { OutlineItem } from './types';
+import type { BaseProps } from '../BaseProps.js';
+import type { OutlineItem } from './types.js';
+export type { OutlineItem } from './types.js';
 export interface OutlineProps extends BaseProps<HTMLElement> {
     /** Ref forwarded to the root nav element. */
     ref?: React.Ref<HTMLElement>;

package/dist/Outline/index.d.ts

@@ -6,11 +6,11 @@
  *
  * SYNC: When modified, update /packages/core/src/Outline/Outline.doc.mjs
  */
-export { Outline } from './Outline';
-export type { OutlineProps } from './Outline';
-export type { OutlineItem } from './types';
-export { parseOutlineFromMarkdown } from './parseOutlineFromMarkdown';
-export type { ParseOutlineFromMarkdownOptions } from './parseOutlineFromMarkdown';
-export { useOutlineFromMarkdown } from './useOutlineFromMarkdown';
-export { useOutlineFromDOM } from './useOutlineFromDOM';
+export { Outline } from './Outline.js';
+export type { OutlineProps } from './Outline.js';
+export type { OutlineItem } from './types.js';
+export { parseOutlineFromMarkdown } from './parseOutlineFromMarkdown.js';
+export type { ParseOutlineFromMarkdownOptions } from './parseOutlineFromMarkdown.js';
+export { useOutlineFromMarkdown } from './useOutlineFromMarkdown.js';
+export { useOutlineFromDOM } from './useOutlineFromDOM.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/Outline/parseOutlineFromMarkdown.d.ts

@@ -1,5 +1,5 @@
-import type { MarkdownExtensionNode, MarkdownPluginEntry } from '../Markdown/plugins/protocol';
-import type { OutlineItem } from './types';
+import type { MarkdownExtensionNode, MarkdownPluginEntry } from '../Markdown/plugins/protocol.js';
+import type { OutlineItem } from './types.js';
 /**
  * Extract heading items from a Markdown string.
  *

package/dist/Outline/useOutlineFromDOM.d.ts

@@ -1,4 +1,4 @@
-import type { OutlineItem } from './types';
+import type { OutlineItem } from './types.js';
 /** Build outline items from h1-h6 elements inside a DOM container. */
 export declare function useOutlineFromDOM(containerRef: React.RefObject<HTMLElement | null>): OutlineItem[];
 //# sourceMappingURL=useOutlineFromDOM.d.ts.map

package/dist/Outline/useOutlineFromMarkdown.d.ts

@@ -1,6 +1,6 @@
-import type { ParseOutlineFromMarkdownOptions } from './parseOutlineFromMarkdown';
-import type { MarkdownExtensionNode } from '../Markdown/plugins/protocol';
-import type { OutlineItem } from './types';
+import type { ParseOutlineFromMarkdownOptions } from './parseOutlineFromMarkdown.js';
+import type { MarkdownExtensionNode } from '../Markdown/plugins/protocol.js';
+import type { OutlineItem } from './types.js';
 /** Extract a stable outline from a Markdown string. */
 export declare function useOutlineFromMarkdown<Node extends MarkdownExtensionNode = never>(markdown: string, options?: ParseOutlineFromMarkdownOptions<Node>): OutlineItem[];
 //# sourceMappingURL=useOutlineFromMarkdown.d.ts.map

package/dist/Outline/useScrollSpy.d.ts

@@ -1,4 +1,4 @@
-import type { OutlineItem } from './types';
+import type { OutlineItem } from './types.js';
 interface UseScrollSpyOptions {
     activeId?: string;
     items: OutlineItem[];

package/dist/OverflowList/OverflowList.d.ts

@@ -14,8 +14,8 @@
  * - /packages/cli/assets/templates/blocks/components/OverflowList/ (showcase blocks)
  */
 import { type ReactNode, type ReactElement } from 'react';
-import type { BaseProps } from '../BaseProps';
-import type { SpacingStep } from '../utils/types';
+import type { BaseProps } from '../BaseProps.js';
+import type { SpacingStep } from '../utils/types.js';
 export interface OverflowItem {
     /** The React element for this item */
     child: ReactElement;

package/dist/OverflowList/index.d.ts

@@ -1,6 +1,6 @@
 /**
  * @file OverflowList component barrel export
  */
-export { OverflowList } from './OverflowList';
-export type { OverflowListProps, OverflowItem } from './OverflowList';
+export { OverflowList } from './OverflowList.js';
+export type { OverflowListProps, OverflowItem } from './OverflowList.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/Overlay/Overlay.d.ts

@@ -11,8 +11,8 @@
  * use the useOverlay hook directly.
  */
 import type { ReactNode, Ref } from 'react';
-import type { BaseProps } from '../BaseProps';
-import type { OverlayScrimMode, OverlayPosition, OverlayAlign, OverlayShowOn } from './OverlayScrim';
+import type { BaseProps } from '../BaseProps.js';
+import type { OverlayScrimMode, OverlayPosition, OverlayAlign, OverlayShowOn } from './OverlayScrim.js';
 export interface OverlayProps extends Pick<BaseProps<HTMLDivElement>, 'xstyle' | 'className' | 'style'> {
     /** Ref forwarded to the container element. */
     ref?: Ref<HTMLDivElement>;

package/dist/Overlay/index.d.ts

@@ -2,9 +2,9 @@
  * @file index.ts
  * @position Overlay barrel export
  */
-export { Overlay } from './Overlay';
-export type { OverlayProps } from './Overlay';
-export { useOverlay } from './useOverlay';
-export type { UseOverlayOptions, UseOverlayResult, OverlayContainerProps, } from './useOverlay';
-export type { OverlayScrimMode, OverlayPosition, OverlayAlign, OverlayShowOn, } from './OverlayScrim';
+export { Overlay } from './Overlay.js';
+export type { OverlayProps } from './Overlay.js';
+export { useOverlay } from './useOverlay.js';
+export type { UseOverlayOptions, UseOverlayResult, OverlayContainerProps, } from './useOverlay.js';
+export type { OverlayScrimMode, OverlayPosition, OverlayAlign, OverlayShowOn, } from './OverlayScrim.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/Overlay/useOverlay.d.ts

@@ -12,7 +12,7 @@
  * and scrim rendering.
  */
 import { type ReactNode, type ReactElement, type MouseEvent } from 'react';
-import type { OverlayScrimMode, OverlayPosition, OverlayAlign, OverlayShowOn } from './OverlayScrim';
+import type { OverlayScrimMode, OverlayPosition, OverlayAlign, OverlayShowOn } from './OverlayScrim.js';
 export interface UseOverlayOptions {
     /** Content rendered inside the scrim overlay. */
     content?: ReactNode;

package/dist/Pagination/Pagination.d.ts

@@ -1,5 +1,5 @@
-import type { BaseProps } from '../BaseProps';
-import type { PaginationVariantMap } from './index';
+import type { BaseProps } from '../BaseProps.js';
+import type { PaginationVariantMap } from './index.js';
 /** Visual variant controlling what appears between prev/next buttons.
  * Extensible via module augmentation of PaginationVariantMap.
  */

package/dist/Pagination/index.d.ts

@@ -25,6 +25,6 @@ export interface PaginationVariantMap {
     input: true;
     none: true;
 }
-export { Pagination, generatePageRange } from './Pagination';
-export type { PaginationProps, PaginationVariant, PaginationSize, } from './Pagination';
+export { Pagination, generatePageRange } from './Pagination.js';
+export type { PaginationProps, PaginationVariant, PaginationSize, } from './Pagination.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/Popover/Popover.d.ts

@@ -13,9 +13,9 @@
  * - /packages/cli/assets/templates/blocks/components/Popover/ (showcase blocks)
  */
 import React, { type ReactElement, type ReactNode } from 'react';
-import type { BaseProps } from '../BaseProps';
-import type { LayerAlignment, LayerPlacement } from '../Layer/useLayer';
-import type { SpacingStep } from '../utils/types';
+import type { BaseProps } from '../BaseProps.js';
+import type { LayerAlignment, LayerPlacement } from '../Layer/useLayer.js';
+import type { SpacingStep } from '../utils/types.js';
 /**
  * Props passed to render-prop children for explicit trigger wiring.
  */

package/dist/Popover/index.d.ts

@@ -6,8 +6,8 @@
  *
  * SYNC: When adding new Popover files, update exports here
  */
-export { usePopover } from './usePopover';
-export type { UsePopoverOptions, UsePopoverReturn } from './usePopover';
-export { Popover } from './Popover';
-export type { PopoverProps, PopoverTriggerRenderProps } from './Popover';
+export { usePopover } from './usePopover.js';
+export type { UsePopoverOptions, UsePopoverReturn } from './usePopover.js';
+export { Popover } from './Popover.js';
+export type { PopoverProps, PopoverTriggerRenderProps } from './Popover.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/Popover/usePopover.d.ts

@@ -11,9 +11,9 @@
  * - /packages/core/src/Popover/index.ts
  */
 import React, { type ReactNode } from 'react';
-import { type ContextRenderProps } from '../Layer/useLayer';
+import { type ContextRenderProps } from '../Layer/useLayer.js';
 import type { StyleXStyles } from '@stylexjs/stylex';
-import type { SpacingStep } from '../utils/types';
+import type { SpacingStep } from '../utils/types.js';
 /**
  * Options for usePopover
  */

package/dist/PowerSearch/PowerSearch.d.ts

@@ -10,11 +10,11 @@
  * - /packages/cli/assets/templates/blocks/components/PowerSearch/ (showcase blocks)
  */
 import React, { type ReactNode } from 'react';
-import type { BaseProps } from '../BaseProps';
-import { type TokenizerOverflowBehavior } from '../Tokenizer';
-import type { IconType } from '../Icon';
-import type { InputStatus, FieldStatusVariant } from '../Field';
-import type { PowerSearchConfig, PowerSearchFilter, PowerSearchChangeType, PowerSearchHandle, PowerSearchComponents } from './types';
+import type { BaseProps } from '../BaseProps.js';
+import { type TokenizerOverflowBehavior } from '../Tokenizer/index.js';
+import type { IconType } from '../Icon/index.js';
+import type { InputStatus, FieldStatusVariant } from '../Field/index.js';
+import type { PowerSearchConfig, PowerSearchFilter, PowerSearchChangeType, PowerSearchHandle, PowerSearchComponents } from './types.js';
 export type PowerSearchSize = 'sm' | 'md' | 'lg';
 export interface PowerSearchProps extends Omit<BaseProps<HTMLElement>, 'onChange'> {
     /** PowerSearch configuration defining available fields and operators. */

package/dist/PowerSearch/PowerSearchEditPopover.d.ts

@@ -8,8 +8,8 @@
  * - /packages/core/src/PowerSearch/index.ts
  */
 import React from 'react';
-import type { InternalConfig } from './useInternalConfig';
-import type { PowerSearchFilter, PartialFilter } from './types';
+import type { InternalConfig } from './useInternalConfig.js';
+import type { PowerSearchFilter, PartialFilter } from './types.js';
 export interface PowerSearchEditPopoverProps {
     config: InternalConfig;
     /** The filter being edited/created. */

package/dist/PowerSearch/PowerSearchFilterEditor.d.ts

@@ -5,7 +5,7 @@
  * @position Public component; used internally by PowerSearch and available for consumer composition
  */
 import React from 'react';
-import type { PowerSearchEditorProps } from './types';
+import type { PowerSearchEditorProps } from './types.js';
 /**
  * Default filter editor for PowerSearch.
  *

package/dist/PowerSearch/PowerSearchToken.d.ts

@@ -5,7 +5,7 @@
  * @position Public component; used internally by PowerSearch and available for consumer composition
  */
 import React from 'react';
-import type { PowerSearchTokenProps } from './types';
+import type { PowerSearchTokenProps } from './types.js';
 /**
  * Default token pill for PowerSearch filters.
  *

package/dist/PowerSearch/PowerSearchValueEditor.d.ts

@@ -8,8 +8,8 @@
  * - /packages/core/src/PowerSearch/index.ts
  */
 import React from 'react';
-import type { OperatorValue, FilterValue } from './types';
-import type { InternalConfig } from './useInternalConfig';
+import type { OperatorValue, FilterValue } from './types.js';
+import type { InternalConfig } from './useInternalConfig.js';
 export interface PowerSearchValueEditorProps {
     operatorValue: OperatorValue;
     filterValue: FilterValue | undefined;

package/dist/PowerSearch/formatFilterValue.d.ts

@@ -7,9 +7,9 @@
  * SYNC: When modified, update:
  * - /packages/core/src/PowerSearch/index.ts
  */
-import type { OperatorValue, FilterValue } from './types';
-import type { InternalConfig } from './useInternalConfig';
-import type { Locale, TranslatorFn } from '../i18n';
+import type { OperatorValue, FilterValue } from './types.js';
+import type { InternalConfig } from './useInternalConfig.js';
+import type { Locale, TranslatorFn } from '../i18n/index.js';
 export declare function formatDateAbsolute(unixSeconds: number, locale: Locale, timezoneID?: string): string;
 /**
  * Compact date-only rendering (no time-of-day) for the token pill's inline

package/dist/PowerSearch/index.d.ts

@@ -6,12 +6,12 @@
  *
  * SYNC: When adding new PowerSearch files, update exports here
  */
-export { PowerSearch } from './PowerSearch';
-export type { PowerSearchProps, PowerSearchSize } from './PowerSearch';
-export { PowerSearchToken } from './PowerSearchToken';
-export { PowerSearchFilterEditor } from './PowerSearchFilterEditor';
-export { resolveOperatorLabel } from './resolveOperatorLabel';
-export { createPowerSearchConfig, usePowerSearchConfig, } from './usePowerSearchConfig';
-export type { FieldDefinition, InferData } from './usePowerSearchConfig';
-export type { PowerSearchConfig, PowerSearchField, PowerSearchOperator, PowerSearchOperatorBase, PowerSearchOperatorWithLabel, PowerSearchOperatorWithI18nKey, OperatorValue, EmptyOperatorValue, StringOperatorValue, StringListOperatorValue, IntegerOperatorValue, FloatOperatorValue, TimeOperatorValue, DateAbsoluteOperatorValue, DateRelativeOperatorValue, DateRangeOperatorValue, EnumOperatorValue, EnumListOperatorValue, EntityListOperatorValue, CustomOperatorValue, NestedOperatorValue, FilterValue, FilterValueEmpty, FilterValueString, FilterValueStringList, FilterValueInteger, FilterValueFloat, FilterValueTime, FilterValueDateAbsolute, FilterValueDateRelative, FilterValueDateRange, FilterValueEnum, FilterValueEnumList, FilterValueEntityList, FilterValueCustom, FilterValueNested, PowerSearchFilter, PartialFilter, EnumItem, PowerSearchEntity, DateTimeRange, DateTimeRangePart, DateRangeFilterPreset, RelativeDateFilterPreset, OperatorTokenizationConfig, PowerSearchChangeType, PowerSearchHandle, PowerSearchTokenProps, PowerSearchEditorProps, PowerSearchComponentOverride, PowerSearchComponents, } from './types';
+export { PowerSearch } from './PowerSearch.js';
+export type { PowerSearchProps, PowerSearchSize } from './PowerSearch.js';
+export { PowerSearchToken } from './PowerSearchToken.js';
+export { PowerSearchFilterEditor } from './PowerSearchFilterEditor.js';
+export { resolveOperatorLabel } from './resolveOperatorLabel.js';
+export { createPowerSearchConfig, usePowerSearchConfig, } from './usePowerSearchConfig.js';
+export type { FieldDefinition, InferData } from './usePowerSearchConfig.js';
+export type { PowerSearchConfig, PowerSearchField, PowerSearchOperator, PowerSearchOperatorBase, PowerSearchOperatorWithLabel, PowerSearchOperatorWithI18nKey, OperatorValue, EmptyOperatorValue, StringOperatorValue, StringListOperatorValue, IntegerOperatorValue, FloatOperatorValue, TimeOperatorValue, DateAbsoluteOperatorValue, DateRelativeOperatorValue, DateRangeOperatorValue, EnumOperatorValue, EnumListOperatorValue, EntityListOperatorValue, CustomOperatorValue, NestedOperatorValue, FilterValue, FilterValueEmpty, FilterValueString, FilterValueStringList, FilterValueInteger, FilterValueFloat, FilterValueTime, FilterValueDateAbsolute, FilterValueDateRelative, FilterValueDateRange, FilterValueEnum, FilterValueEnumList, FilterValueEntityList, FilterValueCustom, FilterValueNested, PowerSearchFilter, PartialFilter, EnumItem, PowerSearchEntity, DateTimeRange, DateTimeRangePart, DateRangeFilterPreset, RelativeDateFilterPreset, OperatorTokenizationConfig, PowerSearchChangeType, PowerSearchHandle, PowerSearchTokenProps, PowerSearchEditorProps, PowerSearchComponentOverride, PowerSearchComponents, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/PowerSearch/resolveDateTimeRangePart.d.ts

@@ -4,7 +4,7 @@
  * @output Resolves absolute, now, and relative range parts to Unix seconds
  * @position Internal PowerSearch date-range utility; shared by filtering and editing
  */
-import type { DateTimeRangePart } from './types';
+import type { DateTimeRangePart } from './types.js';
 /** Resolves a range part against one caller-supplied instant. */
 export declare function resolveDateTimeRangePart(part: DateTimeRangePart, nowSeconds?: number): number;
 //# sourceMappingURL=resolveDateTimeRangePart.d.ts.map