@astryxdesign/core 0.0.0-bootstrap.0 → 0.1.0-canary.08d4cf4

package/dist/NavMenu/NavHeadingMenu.d.ts

@@ -0,0 +1,54 @@
+/**
+ * @file NavHeadingMenu.tsx
+ * @input Uses React, StyleX, useListFocus, NavMenuContext
+ * @output Exports NavHeadingMenu component and NavHeadingMenuProps type
+ * @position Core implementation; consumed by index.ts
+ *
+ * SYNC: When modified, update:
+ * - /packages/core/src/NavMenu/index.ts
+ */
+import React, { type ReactNode } from 'react';
+import type { BaseProps } from '../BaseProps';
+import { type NavHeadingMenuSize } from './NavMenuContext';
+export interface NavHeadingMenuProps extends BaseProps<HTMLDivElement> {
+    ref?: React.Ref<HTMLDivElement>;
+    /** Menu items (NavHeadingMenuItem, dividers, custom content). */
+    children: ReactNode;
+    /**
+     * Size — controls min-width and flows to items for padding.
+     * @default 'md'
+     */
+    size?: NavHeadingMenuSize;
+    /**
+     * Minimum width override. Takes precedence over size-based defaults.
+     */
+    minWidth?: number | string;
+}
+/**
+ * Accessible menu container for nav heading popovers.
+ *
+ * Provides `role="menu"` with arrow-key navigation (Home/End/Escape)
+ * and a size context that flows to child items for consistent padding.
+ * Pass as the `menu` prop of SideNavHeading or TopNavHeading.
+ *
+ * The parent heading component injects the close callback via context,
+ * so items automatically dismiss the popover on selection.
+ *
+ * @example
+ * ```
+ * <SideNavHeading
+ *   heading="Products"
+ *   menu={
+ *     <NavHeadingMenu size="lg">
+ *       <NavHeadingMenuItem label="Dashboard" href="/dashboard" />
+ *       <NavHeadingMenuItem label="Analytics" href="/analytics" />
+ *     </NavHeadingMenu>
+ *   }
+ * />
+ * ```
+ */
+export declare function NavHeadingMenu({ ref, children, size, minWidth, xstyle, className, style: styleProp, 'data-testid': testId, }: NavHeadingMenuProps): React.JSX.Element;
+export declare namespace NavHeadingMenu {
+    var displayName: string;
+}
+//# sourceMappingURL=NavHeadingMenu.d.ts.map

package/dist/NavMenu/NavHeadingMenu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NavHeadingMenu.d.ts","sourceRoot":"","sources":["../../src/NavMenu/NavHeadingMenu.tsx"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,EAAU,KAAK,SAAS,EAAC,MAAM,OAAO,CAAC;AAIrD,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AAG5C,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,kBAAkB,CAAC;AAsB1B,MAAM,WAAW,mBAAoB,SAAQ,SAAS,CAAC,cAAc,CAAC;IACpE,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAChC,iEAAiE;IACjE,QAAQ,EAAE,SAAS,CAAC;IAEpB;;;OAGG;IACH,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,cAAc,CAAC,EAC7B,GAAG,EACH,QAAQ,EACR,IAAW,EACX,QAAQ,EACR,MAAM,EACN,SAAS,EACT,KAAK,EAAE,SAAS,EAChB,aAAa,EAAE,MAAM,GACtB,EAAE,mBAAmB,qBAmCrB;yBA5Ce,cAAc"}

package/dist/NavMenu/NavHeadingMenu.js

@@ -0,0 +1,108 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+'use client';
+
+/**
+ * @file NavHeadingMenu.tsx
+ * @input Uses React, StyleX, useListFocus, NavMenuContext
+ * @output Exports NavHeadingMenu component and NavHeadingMenuProps type
+ * @position Core implementation; consumed by index.ts
+ *
+ * SYNC: When modified, update:
+ * - /packages/core/src/NavMenu/index.ts
+ */
+import React, { useMemo } from 'react';
+import * as stylex from '@stylexjs/stylex';
+import "../theme/tokens.stylex.js";
+import { spacingVars } from "../theme/tokens.stylex.js";
+import { mergeProps, mergeRefs } from "../utils/index.js";
+import { useListFocus } from "../hooks/useListFocus.js";
+import { themeProps } from "../utils/themeProps.js";
+import { NavHeadingMenuContext, useNavHeadingCloseContext } from "./NavMenuContext.js";
+import { jsx as _jsx } from "react/jsx-runtime";
+const styles = {
+  root: {
+    k1xSpc: "x78zum5",
+    kXwgrk: "xdt5ytf",
+    kOIVth: "x1lsbc85",
+    $$css: true
+  }
+};
+const sizeStyles = {
+  sm: {
+    k7Eaqz: "x5w4yej",
+    $$css: true
+  },
+  md: {
+    k7Eaqz: "x1jzhcrs",
+    $$css: true
+  },
+  lg: {
+    k7Eaqz: "xlm99nl",
+    $$css: true
+  }
+};
+/**
+ * Accessible menu container for nav heading popovers.
+ *
+ * Provides `role="menu"` with arrow-key navigation (Home/End/Escape)
+ * and a size context that flows to child items for consistent padding.
+ * Pass as the `menu` prop of SideNavHeading or TopNavHeading.
+ *
+ * The parent heading component injects the close callback via context,
+ * so items automatically dismiss the popover on selection.
+ *
+ * @example
+ * ```
+ * <SideNavHeading
+ *   heading="Products"
+ *   menu={
+ *     <NavHeadingMenu size="lg">
+ *       <NavHeadingMenuItem label="Dashboard" href="/dashboard" />
+ *       <NavHeadingMenuItem label="Analytics" href="/analytics" />
+ *     </NavHeadingMenu>
+ *   }
+ * />
+ * ```
+ */
+export function NavHeadingMenu({
+  ref,
+  children,
+  size = 'md',
+  minWidth,
+  xstyle,
+  className,
+  style: styleProp,
+  'data-testid': testId
+}) {
+  const closeCtx = useNavHeadingCloseContext();
+  const closeMenu = closeCtx?.closeMenu;
+  const {
+    listRef,
+    handleKeyDown
+  } = useListFocus({
+    onEscape: closeMenu
+  });
+  const ctx = useMemo(() => ({
+    closeMenu: closeMenu ?? (() => {}),
+    size
+  }), [closeMenu, size]);
+  const inlineStyle = minWidth != null ? {
+    ...styleProp,
+    minWidth
+  } : styleProp;
+  return /*#__PURE__*/_jsx(NavHeadingMenuContext, {
+    value: ctx,
+    children: /*#__PURE__*/_jsx("div", {
+      ref: mergeRefs(ref, listRef),
+      role: "menu",
+      onKeyDown: handleKeyDown,
+      "data-testid": testId,
+      ...mergeProps(themeProps('nav-heading-menu', {
+        size
+      }), stylex.props(styles.root, sizeStyles[size], xstyle), className, inlineStyle),
+      children: children
+    })
+  });
+}
+NavHeadingMenu.displayName = 'NavHeadingMenu';

package/dist/NavMenu/NavHeadingMenuItem.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @file NavHeadingMenuItem.tsx
+ * @input Uses React, StyleX, Icon, Text, NavMenuContext, useLinkComponent
+ * @output Exports NavHeadingMenuItem component and NavHeadingMenuItemProps type
+ * @position Core implementation; consumed by index.ts
+ *
+ * SYNC: When modified, update:
+ * - /packages/core/src/NavMenu/index.ts
+ */
+import React, { type ReactNode } from 'react';
+import { type IconType } from '../Icon';
+import type { BaseProps } from '../BaseProps';
+export interface NavHeadingMenuItemProps extends Omit<BaseProps<HTMLElement>, 'onClick'> {
+    ref?: React.Ref<HTMLElement>;
+    /** Icon to display before the label. */
+    icon?: ReactNode | IconType;
+    /** Primary label text. */
+    label: ReactNode;
+    /** Secondary description text displayed below the label. */
+    description?: ReactNode;
+    /** URL to navigate to. Renders as an anchor element when provided. */
+    href?: string;
+    /** Callback when the item is selected. */
+    onClick?: () => void;
+    /** Whether the item is disabled. @default false */
+    isDisabled?: boolean;
+}
+/**
+ * Menu item for nav heading popovers.
+ *
+ * Reads size from the parent NavHeadingMenu for consistent padding.
+ * Automatically dismisses the menu on click via context.
+ * Renders as a link when `href` is provided.
+ *
+ * @example
+ * ```
+ * <NavHeadingMenu>
+ *   <NavHeadingMenuItem label="Dashboard" href="/dashboard" />
+ *   <NavHeadingMenuItem label="Settings" icon={GearIcon} onClick={open} />
+ * </NavHeadingMenu>
+ * ```
+ */
+export declare function NavHeadingMenuItem({ ref, icon, label, description, href, onClick, isDisabled, xstyle, className, style, 'data-testid': testId, }: NavHeadingMenuItemProps): React.JSX.Element;
+export declare namespace NavHeadingMenuItem {
+    var displayName: string;
+}
+//# sourceMappingURL=NavHeadingMenuItem.d.ts.map

package/dist/NavMenu/NavHeadingMenuItem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NavHeadingMenuItem.d.ts","sourceRoot":"","sources":["../../src/NavMenu/NavHeadingMenuItem.tsx"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,EAAc,KAAK,SAAS,EAAC,MAAM,OAAO,CAAC;AAEzD,OAAO,EAAiB,KAAK,QAAQ,EAAC,MAAM,SAAS,CAAC;AAUtD,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AAwD5C,MAAM,WAAW,uBAAwB,SAAQ,IAAI,CACnD,SAAS,CAAC,WAAW,CAAC,EACtB,SAAS,CACV;IACC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAC7B,wCAAwC;IACxC,IAAI,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC5B,0BAA0B;IAC1B,KAAK,EAAE,SAAS,CAAC;IACjB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,sEAAsE;IACtE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,mDAAmD;IACnD,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,GAAG,EACH,IAAI,EACJ,KAAK,EACL,WAAW,EACX,IAAI,EACJ,OAAO,EACP,UAAkB,EAClB,MAAM,EACN,SAAS,EACT,KAAK,EACL,aAAa,EAAE,MAAM,GACtB,EAAE,uBAAuB,qBAoDzB;yBAhEe,kBAAkB"}

package/dist/NavMenu/NavHeadingMenuItem.js

@@ -0,0 +1,135 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+'use client';
+
+/**
+ * @file NavHeadingMenuItem.tsx
+ * @input Uses React, StyleX, Icon, Text, NavMenuContext, useLinkComponent
+ * @output Exports NavHeadingMenuItem component and NavHeadingMenuItemProps type
+ * @position Core implementation; consumed by index.ts
+ *
+ * SYNC: When modified, update:
+ * - /packages/core/src/NavMenu/index.ts
+ */
+import React, { useCallback } from 'react';
+import * as stylex from '@stylexjs/stylex';
+import { renderIconSlot } from "../Icon/index.js";
+import { Text } from "../Text/index.js";
+import "../theme/tokens.stylex.js";
+import { colorVars, spacingVars, typographyVars, typeScaleVars, radiusVars } from "../theme/tokens.stylex.js";
+import { mergeProps } from "../utils/index.js";
+import { useNavHeadingMenuContext } from "./NavMenuContext.js";
+import { useLinkComponent } from "../Link/useLinkComponent.js";
+import { themeProps } from "../utils/themeProps.js";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+const styles = {
+  root: {
+    kB7OPa: "x9f619",
+    k1xSpc: "x78zum5",
+    kGNEyG: "x6s0dn4",
+    kOIVth: "x1txdalj",
+    kzqmXN: "xh8yej3",
+    kaIpWk: "xh6dtrn",
+    kMv6JI: "x9ynric",
+    kGuDYH: "xcr08ib",
+    kMwMTN: "x1tgivj0",
+    kWkggS: "xjbqb8w x1c52tdz xe9uy6x",
+    kkrTdU: "x1ypdohk",
+    k9WMMc: "xdpxx8g",
+    kI3sdo: "x1a2a7pz",
+    kybGjl: "x1hl2dhg",
+    $$css: true
+  },
+  disabled: {
+    kSiTet: "xbyyjgo",
+    kkrTdU: "x1h6gzvc",
+    $$css: true
+  }
+};
+const sizeStyles = {
+  sm: {
+    k8WAf4: "xu0wf1k",
+    kg3NbH: "xf314gf",
+    $$css: true
+  },
+  md: {
+    k8WAf4: "xce4md1",
+    kg3NbH: "xf314gf",
+    $$css: true
+  },
+  lg: {
+    k8WAf4: "x8o8v82",
+    kg3NbH: "xrrkdod",
+    $$css: true
+  }
+};
+/**
+ * Menu item for nav heading popovers.
+ *
+ * Reads size from the parent NavHeadingMenu for consistent padding.
+ * Automatically dismisses the menu on click via context.
+ * Renders as a link when `href` is provided.
+ *
+ * @example
+ * ```
+ * <NavHeadingMenu>
+ *   <NavHeadingMenuItem label="Dashboard" href="/dashboard" />
+ *   <NavHeadingMenuItem label="Settings" icon={GearIcon} onClick={open} />
+ * </NavHeadingMenu>
+ * ```
+ */
+export function NavHeadingMenuItem({
+  ref,
+  icon,
+  label,
+  description,
+  href,
+  onClick,
+  isDisabled = false,
+  xstyle,
+  className,
+  style,
+  'data-testid': testId
+}) {
+  const ctx = useNavHeadingMenuContext();
+  const size = ctx?.size ?? 'md';
+  const handleClick = useCallback(() => {
+    if (isDisabled) {
+      return;
+    }
+    onClick?.();
+    ctx?.closeMenu();
+  }, [isDisabled, onClick, ctx]);
+  const LinkComponent = useLinkComponent();
+  const Element = href ? LinkComponent : 'div';
+  return /*#__PURE__*/_jsxs(Element, {
+    ref: ref,
+    role: "menuitem",
+    tabIndex: isDisabled ? undefined : -1,
+    "aria-disabled": isDisabled || undefined,
+    href: href,
+    onClick: handleClick,
+    "data-testid": testId,
+    ...mergeProps(themeProps('nav-heading-menu-item', {
+      size
+    }), stylex.props(styles.root, sizeStyles[size], isDisabled && styles.disabled, xstyle), className, style),
+    children: [icon && renderIconSlot(icon, {
+      size: 'sm',
+      color: 'secondary'
+    }), /*#__PURE__*/_jsxs("span", {
+      ...{
+        className: "x78zum5 xdt5ytf x98rzlu xeuugli"
+      },
+      children: [typeof label === 'string' ? /*#__PURE__*/_jsx(Text, {
+        type: "body",
+        maxLines: 1,
+        children: label
+      }) : label, description && /*#__PURE__*/_jsx(Text, {
+        type: "supporting",
+        maxLines: 1,
+        children: description
+      })]
+    })]
+  });
+}
+NavHeadingMenuItem.displayName = 'NavHeadingMenuItem';

package/dist/NavMenu/NavMenuContext.d.ts

@@ -0,0 +1,22 @@
+export type NavHeadingMenuSize = 'sm' | 'md' | 'lg';
+/**
+ * Close callback provided by the nav heading popover.
+ * NavHeadingMenu reads this to dismiss the popover on item selection
+ * and on Escape.
+ */
+export interface NavHeadingCloseContextValue {
+    closeMenu: () => void;
+}
+export declare const NavHeadingCloseContext: import("react").Context<NavHeadingCloseContextValue | null>;
+export declare function useNavHeadingCloseContext(): NavHeadingCloseContextValue | null;
+/**
+ * Size and close context provided by NavHeadingMenu to its children.
+ * Items read this for consistent padding and dismiss-on-click.
+ */
+export interface NavHeadingMenuContextValue {
+    size: NavHeadingMenuSize;
+    closeMenu: () => void;
+}
+export declare const NavHeadingMenuContext: import("react").Context<NavHeadingMenuContextValue | null>;
+export declare function useNavHeadingMenuContext(): NavHeadingMenuContextValue | null;
+//# sourceMappingURL=NavMenuContext.d.ts.map

package/dist/NavMenu/NavMenuContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NavMenuContext.d.ts","sourceRoot":"","sources":["../../src/NavMenu/NavMenuContext.tsx"],"names":[],"mappings":"AAgBA,MAAM,MAAM,kBAAkB,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAEpD;;;;GAIG;AACH,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,MAAM,IAAI,CAAC;CACvB;AAED,eAAO,MAAM,sBAAsB,6DACsB,CAAC;AAG1D,wBAAgB,yBAAyB,IAAI,2BAA2B,GAAG,IAAI,CAE9E;AAED;;;GAGG;AACH,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,kBAAkB,CAAC;IACzB,SAAS,EAAE,MAAM,IAAI,CAAC;CACvB;AAED,eAAO,MAAM,qBAAqB,4DACsB,CAAC;AAGzD,wBAAgB,wBAAwB,IAAI,0BAA0B,GAAG,IAAI,CAE5E"}

package/dist/NavMenu/NavMenuContext.js

@@ -0,0 +1,37 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+'use client';
+
+/**
+ * @file NavMenuContext.tsx
+ * @input Uses React createContext/use
+ * @output Exports NavHeadingCloseContext, NavHeadingMenuContext, and hooks
+ * @position Context providers; consumed by NavHeadingMenu and NavHeadingMenuItem
+ *
+ * SYNC: When modified, update:
+ * - /packages/core/src/NavMenu/index.ts
+ */
+import { createContext, use } from 'react';
+
+/**
+ * Close callback provided by the nav heading popover.
+ * NavHeadingMenu reads this to dismiss the popover on item selection
+ * and on Escape.
+ */
+
+export const NavHeadingCloseContext = /*#__PURE__*/createContext(null);
+NavHeadingCloseContext.displayName = 'NavHeadingCloseContext';
+export function useNavHeadingCloseContext() {
+  return use(NavHeadingCloseContext);
+}
+
+/**
+ * Size and close context provided by NavHeadingMenu to its children.
+ * Items read this for consistent padding and dismiss-on-click.
+ */
+
+export const NavHeadingMenuContext = /*#__PURE__*/createContext(null);
+NavHeadingMenuContext.displayName = 'NavHeadingMenuContext';
+export function useNavHeadingMenuContext() {
+  return use(NavHeadingMenuContext);
+}

package/dist/NavMenu/NavMenuItem.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @file NavMenuItem.tsx
+ * @input NavHeadingMenuItem
+ * @output Exports deprecated NavMenuItem alias
+ * @position Compatibility re-export; prefer NavHeadingMenuItem
+ */
+import { NavHeadingMenuItem } from './NavHeadingMenuItem';
+import type { NavHeadingMenuItemProps } from './NavHeadingMenuItem';
+/** @deprecated Use NavHeadingMenuItem instead. */
+export type NavMenuItemProps = NavHeadingMenuItemProps;
+/** @deprecated Use NavHeadingMenuItem instead. */
+export declare const NavMenuItem: typeof NavHeadingMenuItem;
+//# sourceMappingURL=NavMenuItem.d.ts.map

package/dist/NavMenu/NavMenuItem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NavMenuItem.d.ts","sourceRoot":"","sources":["../../src/NavMenu/NavMenuItem.tsx"],"names":[],"mappings":"AAIA;;;;;GAKG;AAEH,OAAO,EAAC,kBAAkB,EAAC,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAC,uBAAuB,EAAC,MAAM,sBAAsB,CAAC;AAElE,kDAAkD;AAClD,MAAM,MAAM,gBAAgB,GAAG,uBAAuB,CAAC;AAEvD,kDAAkD;AAClD,eAAO,MAAM,WAAW,2BAAqB,CAAC"}

package/dist/NavMenu/NavMenuItem.js

@@ -0,0 +1,16 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+'use client';
+
+/**
+ * @file NavMenuItem.tsx
+ * @input NavHeadingMenuItem
+ * @output Exports deprecated NavMenuItem alias
+ * @position Compatibility re-export; prefer NavHeadingMenuItem
+ */
+import { NavHeadingMenuItem } from "./NavHeadingMenuItem.js";
+
+/** @deprecated Use NavHeadingMenuItem instead. */
+
+/** @deprecated Use NavHeadingMenuItem instead. */
+export const NavMenuItem = NavHeadingMenuItem;

package/dist/NavMenu/index.d.ts

@@ -0,0 +1,9 @@
+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 { NavMenuItem } from './NavMenuItem';
+export type { NavMenuItemProps } from './NavMenuItem';
+//# sourceMappingURL=index.d.ts.map

package/dist/NavMenu/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/NavMenu/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAC,cAAc,EAAC,MAAM,kBAAkB,CAAC;AAChD,YAAY,EAAC,mBAAmB,EAAC,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAC,kBAAkB,EAAC,MAAM,sBAAsB,CAAC;AACxD,YAAY,EAAC,uBAAuB,EAAC,MAAM,sBAAsB,CAAC;AAClE,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,0BAA0B,EAC1B,2BAA2B,EAC3B,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAC,WAAW,EAAC,MAAM,eAAe,CAAC;AAC1C,YAAY,EAAC,gBAAgB,EAAC,MAAM,eAAe,CAAC"}

package/dist/NavMenu/index.js

@@ -0,0 +1,9 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+'use client';
+
+export { NavHeadingMenu } from "./NavHeadingMenu.js";
+export { NavHeadingMenuItem } from "./NavHeadingMenuItem.js";
+export { NavHeadingMenuContext, useNavHeadingMenuContext, NavHeadingCloseContext, useNavHeadingCloseContext } from "./NavMenuContext.js";
+// Backward compat — use NavHeadingMenuItem instead.
+export { NavMenuItem } from "./NavMenuItem.js";

package/dist/NumberInput/NumberInput.d.ts

@@ -0,0 +1,193 @@
+/**
+ * @file NumberInput.tsx
+ * @input Uses React, useId, useState, useMemo, useCallback, Field, Icon
+ * @output Exports NumberInput component, NumberInputProps
+ * @position Core implementation; consumed by index.ts, tested by NumberInput.test.tsx
+ *
+ * SYNC: When modified, update these files to stay in sync:
+ * - /packages/core/src/NumberInput/NumberInput.doc.mjs (props table, features, implementation notes)
+ * - /packages/core/src/NumberInput/NumberInput.test.tsx (tests for new/changed behavior)
+ * - /packages/core/src/NumberInput/index.ts (exports if types change)
+ * - /apps/storybook/stories/NumberInput.stories.tsx (storybook stories)
+ * - /packages/cli/templates/blocks/components/NumberInput/ (showcase blocks)
+ */
+import { type FocusEvent, type KeyboardEvent, type ReactNode } from 'react';
+import * as stylex from '@stylexjs/stylex';
+import { type InputStatus } from '../Field';
+import { type IconType } from '../Icon';
+declare const sizeStyles: Readonly<{
+    readonly sm: Readonly<{
+        readonly height: stylex.StyleXClassNameFor<"height", "28px">;
+    }>;
+    readonly md: Readonly<{
+        readonly height: stylex.StyleXClassNameFor<"height", "32px">;
+    }>;
+    readonly lg: Readonly<{
+        readonly height: stylex.StyleXClassNameFor<"height", "36px">;
+    }>;
+}>;
+export type NumberInputSize = keyof typeof sizeStyles;
+export type { InputStatus as NumberInputStatus, InputStatusType as NumberInputStatusType, } from '../Field';
+import type { BaseProps } from '../BaseProps';
+import type { SizeValue } from '../utils/types';
+interface NumberInputPropsBase extends Omit<BaseProps, 'onChange' | 'defaultValue'> {
+    /** Ref forwarded to the root element */
+    ref?: React.Ref<HTMLInputElement>;
+    /**
+     * Label text for the input (always rendered for accessibility).
+     */
+    label: string;
+    /**
+     * Whether to visually hide the label (still accessible to screen readers).
+     * @default false
+     */
+    isLabelHidden?: boolean;
+    /**
+     * Description text displayed between the label and input.
+     */
+    description?: string;
+    /**
+     * Whether the field is optional. Mutually exclusive with isRequired.
+     * @default false
+     */
+    isOptional?: boolean;
+    /**
+     * Whether the field is required. Mutually exclusive with isOptional.
+     * @default false
+     */
+    isRequired?: boolean;
+    /**
+     * Whether the input is disabled.
+     * @default false
+     */
+    isDisabled?: boolean;
+    /**
+     * Icon to display at the start of the input.
+     * Accepts a ReactNode (e.g. `<Icon icon={SearchIcon} />`) or an SVG icon component directly.
+     */
+    startIcon?: ReactNode | IconType;
+    /**
+     * Icon to display before the label text.
+     */
+    labelIcon?: ReactNode | IconType;
+    /**
+     * Status indicator for the input.
+     * When set, displays a colored border and status icon.
+     * If message is provided, displays a floating message box below the input.
+     */
+    status?: InputStatus;
+    /**
+     * The size of the input.
+     * - 'sm': Compact size (28px height)
+     * - 'md': Default size (32px height)
+     * - 'lg': Large size (36px height)
+     * @default 'md'
+     */
+    size?: NumberInputSize;
+    /**
+     * The current value of the input.
+     * Use null or undefined to represent an empty/unset value.
+     */
+    value: number | null | undefined;
+    /**
+     * Placeholder text shown when the input is empty.
+     */
+    placeholder?: string;
+    /**
+     * Width of the field. Numbers are treated as pixels, strings are used as-is
+     * (e.g. `'100%'`). Sizes the whole field (label, control, and status) so they
+     * stay aligned, unlike setting width via `xstyle`/`className`/`style`.
+     */
+    width?: SizeValue;
+    /**
+     * Tooltip text to display in an info icon at the end of the label.
+     */
+    labelTooltip?: string;
+    /**
+     * Whether to automatically focus the input on mount.
+     * @default false
+     */
+    hasAutoFocus?: boolean;
+    /**
+     * The HTML name attribute for the input.
+     * Useful for form submissions.
+     */
+    htmlName?: string;
+    /**
+     * The HTML autocomplete attribute for the input.
+     */
+    autoComplete?: string;
+    /**
+     * The minimum value allowed.
+     */
+    min?: number | null;
+    /**
+     * The maximum value allowed.
+     */
+    max?: number | null;
+    /**
+     * The step increment for the input.
+     * @default 1
+     */
+    step?: number | null;
+    /**
+     * Units text to display at the end of the input (e.g., "%" or "GB").
+     */
+    units?: string | null;
+    /**
+     * Whether to only allow integer values (no floating point).
+     * @default false
+     */
+    isIntegerOnly?: boolean;
+    /**
+     * Callback fired when the input receives focus.
+     */
+    onFocus?: (e: FocusEvent<HTMLInputElement>) => void;
+    /**
+     * Callback fired when the input loses focus.
+     */
+    onBlur?: (e: FocusEvent<HTMLInputElement>) => void;
+    /**
+     * Callback fired when the user presses the Enter key.
+     */
+    onEnter?: () => void;
+    /**
+     * Callback fired on keydown events on the input.
+     */
+    onKeyDown?: (e: KeyboardEvent<HTMLInputElement>) => void;
+}
+/**
+ * Without `hasClear`, onChange only receives valid numbers.
+ * With `hasClear`, onChange also receives `null` when the user clears the input.
+ */
+type NumberInputPropsNonClearable = NumberInputPropsBase & {
+    hasClear?: false;
+    onChange: (value: number) => void;
+};
+type NumberInputPropsClearable = NumberInputPropsBase & {
+    /**
+     * Whether to show a clear button when a value is set.
+     * When clicked, resets the value to null and returns focus to the input.
+     *
+     * When enabled, the `onChange` callback type widens to also accept `null`,
+     * signaling that the user cleared the input.
+     */
+    hasClear: true;
+    onChange: (value: number | null) => void;
+};
+export type NumberInputProps = NumberInputPropsNonClearable | NumberInputPropsClearable;
+/**
+ * A number input component for collecting numeric user input.
+ * Only calls onChange when the entered value passes validation.
+ *
+ * @example
+ * ```
+ * <NumberInput label="Quantity" value={quantity} onChange={setQuantity} />
+ * <NumberInput label="Price" value={price} onChange={setPrice} min={0} step={0.01} />
+ * ```
+ */
+export declare function NumberInput({ label, isLabelHidden, description, isOptional, isRequired, isDisabled, startIcon, labelIcon, status, size: sizeProp, onChange, value, placeholder, labelTooltip, hasAutoFocus, htmlName, autoComplete, min, max, step, units, isIntegerOnly, onFocus, onBlur, hasClear, onEnter, onKeyDown, width, xstyle, className, style, ref, ...rest }: NumberInputProps): import("react").JSX.Element;
+export declare namespace NumberInput {
+    var displayName: string;
+}
+//# sourceMappingURL=NumberInput.d.ts.map