@octane-xplat/ui 0.7.3 → 0.10.0

package/types/generated/datetime.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Portable date/time core shared by Calendar and the date/time inputs.
+ *
+ * Values are ISO strings, never `Date` — `YYYY-MM-DD`, `HH:MM[:SS]`, and
+ * `YYYY-MM-DDTHH:MM[:SS]` carry calendar/wall-clock intent across web,
+ * NativeScript, and serialization boundaries. `Date` appears only where the
+ * platform contract needs one: `dateConstraints` callbacks and Calendar's
+ * single-mode `onChange` second argument.
+ *
+ * Locale display goes through `Intl.DateTimeFormat` (V8 on Android, JSC on
+ * iOS/macOS — all provide it) with a fixed English fallback so formatting
+ * never throws on a runtime with a reduced ICU.
+ */
+import type { DateRange, DayOfWeek, DayOfWeekName, ISODateString, ISODateTimeString, ISOTimeString } from './props.js';
+/** The runtime's best-effort display locale — device locale on native,
+ *  runtime locale on web; falls back to 'en' when Intl is reduced. */
+export declare function resolveLocale(locale?: string): string;
+export interface PlainDate {
+    readonly year: number;
+    readonly month: number;
+    readonly day: number;
+}
+export declare function daysInMonth(year: number, month: number): number;
+export declare function plainDateCreate(year: number, month: number, day: number): PlainDate | null;
+export declare function plainDateFromDate(d: Date): PlainDate;
+/** Local midnight — the only `Date` conversion; DST shifts cannot move the
+ *  calendar day because the day is read back from the same local zone. */
+export declare function plainDateToDate(pd: PlainDate): Date;
+export declare function plainDateToday(): PlainDate;
+export declare function plainDateFromISO(iso: string): PlainDate | null;
+export declare function plainDateToISO(pd: PlainDate): ISODateString;
+export declare function plainDateAddDays(pd: PlainDate, days: number): PlainDate;
+/** Month arithmetic clamps to the target month's last day
+ *  (Jan 31 + 1mo → Feb 28/29) instead of rolling into the next month. */
+export declare function plainDateAddMonths(pd: PlainDate, months: number): PlainDate;
+export declare function plainDateAddYears(pd: PlainDate, years: number): PlainDate;
+/** Whole-day difference `a − b`; UTC epoch math makes it DST-free. */
+export declare function plainDateDiffDays(a: PlainDate, b: PlainDate): number;
+export declare function plainDateCompare(a: PlainDate, b: PlainDate): number;
+export declare function plainDateIsBefore(a: PlainDate, b: PlainDate): boolean;
+export declare function plainDateIsAfter(a: PlainDate, b: PlainDate): boolean;
+export declare function plainDateIsEqual(a: PlainDate, b: PlainDate): boolean;
+export declare function plainDateSetStartOfWeek(pd: PlainDate, weekStartsOn: number): PlainDate;
+/** ISO-8601 week number. */
+export declare function plainDateGetWeekNumber(pd: PlainDate): number;
+export declare function normalizeDayOfWeek(value: DayOfWeek | DayOfWeekName | undefined): DayOfWeek;
+export type ShortWeekdayNames = readonly [string, string, string, string, string, string, string];
+export declare function getStandaloneShortWeekdayNames(locale: string): ShortWeekdayNames;
+export type DateFormatOptions = Intl.DateTimeFormatOptions;
+export declare const DATE_FORMAT_WITH_WEEKDAY: DateFormatOptions;
+export declare const DATE_FORMAT_SHORT_WITH_WEEKDAY: DateFormatOptions;
+export declare const DATE_FORMAT_LONG: DateFormatOptions;
+export declare const DATE_FORMAT_MONTH_YEAR: DateFormatOptions;
+export declare const DATE_FORMAT_SHORT: DateFormatOptions;
+export declare const DATE_FORMAT_SHORT_WITH_YEAR: DateFormatOptions;
+export declare function plainDateFormat(pd: PlainDate, options: DateFormatOptions, locale?: string): string;
+export declare function formatMonthYear(year: number, month: number, locale?: string): string;
+/** The shared date-format vocabulary Astryx exposes on `format`:
+ *  `date` "Mar 21, 2026" · `date_long` "March 21, 2026" ·
+ *  `date_weekday` "Wed, Mar 21, 2026" · `system_date` ISO `2026-03-21`. */
+export type SharedDateFormat = 'date' | 'date_long' | 'date_weekday' | 'system_date';
+export type DateInputFormat = SharedDateFormat | ((iso: ISODateString) => string);
+export declare function formatSharedDate(pd: PlainDate, format: SharedDateFormat, locale?: string): string;
+export declare function formatDateValue(iso: ISODateString, format: DateInputFormat | undefined, locale?: string): string;
+/** "Jan 25 – Feb 2" / "Jan 25 – Feb 2, 2026" style trigger text. */
+export declare function formatRangeDisplay(range: DateRange | null | undefined, locale?: string): string;
+export declare function isLocaleDayFirst(locale?: string): boolean;
+/** Parses typed input into a PlainDate — `YYYY-MM-DD`, English month-name
+ *  forms ("March 5", "5 March 2026"), and numeric `M/D/YY` or `D/M/YY`
+ *  (ambiguity resolved by the locale's day/month order). Returns null for
+ *  unparseable or out-of-range input. */
+export declare function parseDateInput(input: string, locale?: string): PlainDate | null;
+export interface ParsedTime {
+    readonly hour: number;
+    readonly minute: number;
+    readonly second: number;
+}
+/** Validate + normalize an `HH:MM[:SS]` string. Returns null when invalid. */
+export declare function parseISOTime(time: string): ParsedTime | null;
+export declare function formatISOTime(time: ParsedTime, includeSeconds?: boolean): ISOTimeString;
+export declare function formatDisplayTime12h(time: ISOTimeString, includeSeconds?: boolean): string;
+export declare function formatDisplayTime24h(time: ISOTimeString, includeSeconds?: boolean): string;
+/** Typed time input: accepts "2:30 PM", "14:30", "1430", "2pm", "143000"
+ *  and ISO `HH:MM[:SS]`; returns a normalized ISOTimeString or null. */
+export declare function parseTimeInput(input: string, includeSeconds?: boolean): ISOTimeString | null;
+export declare function compareTime(a: ISOTimeString, b: ISOTimeString): number;
+export declare function isTimeInRange(time: ISOTimeString, min?: ISOTimeString, max?: ISOTimeString): boolean;
+export declare function clampTime(time: ISOTimeString, min?: ISOTimeString, max?: ISOTimeString): ISOTimeString;
+/** Step a time by whole minutes, wrapping around midnight. */
+export declare function adjustTime(time: ISOTimeString, deltaMinutes: number, includeSeconds?: boolean): ISOTimeString;
+export declare function splitDateTime(dt: ISODateTimeString | undefined): {
+    date?: ISODateString;
+    time?: ISOTimeString;
+};
+export declare function combineDateTime(date?: ISODateString, time?: ISOTimeString): ISODateTimeString | undefined;
+export declare function currentISOTime(includeSeconds?: boolean): ISOTimeString;
+/** Which surface collects the value. `text-input` is TimeInput-only. */
+export type ResolvedInputSurface = 'typed' | 'popover' | 'sheet' | 'native';
+/** Map the deprecated `nativePicker` vocabulary onto `presentation`
+ *  (`touch` → adaptive-native, `always` → native, `never` → the Astryx
+ *  surface: bottom-sheet for pickers, text-input for TimeInput). */
+export declare function presentationFromNativePicker(nativePicker: 'touch' | 'always' | 'never' | undefined, kind: 'date' | 'time' | 'datetime'): import('./props.js').InputPresentation | undefined;
+/** `presentation` wins over the deprecated `nativePicker`. */
+export declare function effectivePresentation(presentation: string | undefined, nativePicker: 'touch' | 'always' | 'never' | undefined, kind: 'date' | 'time' | 'datetime'): import('./props.js').InputPresentation;
+/**
+ * Resolve a presentation + pointer coarseness to a concrete surface.
+ * On native targets pass `isCoarsePointer = true`; `native` there is
+ * remapped by each component leaf (the OS-authentic pickers live in the
+ * `@octane-xplat/date-picker` leaf — ui-internal `native` resolves to the
+ * self-drawn `sheet` surface).
+ */
+export declare function resolveInputSurface(effective: import('./props.js').InputPresentation, isCoarsePointer: boolean): ResolvedInputSurface;
+/** Localized wall-clock display; ISO time remains zone-free and parsing bounded. */
+export declare function formatLocalizedTime(time: ISOTimeString, hasSeconds: boolean, hourFormat: '12h' | '24h', locale: string): string;

package/types/generated/dialog-context.d.ts

@@ -0,0 +1,14 @@
+/** Dialog-internal wiring: the header's title becomes the dialog's
+ *  accessible name (web `aria-labelledby`) and the modal autofocus target.
+ *  Scoped to the dialog subtree — on native this context lives inside the
+ *  overlay root, which is still a single Octane root, so context works. */
+export interface DialogContextValue {
+    /** Id the DialogHeader title should stamp on itself. */
+    titleId: string;
+    /** False while `isInline` — title carries no autofocus/label duties. */
+    isModal: boolean;
+}
+export declare const DialogContext: import("octane").Context<DialogContextValue | null>;
+/** JSX-provider form — the universal renderer's context is a callable
+ *  rather than a `.Provider` member (same aliasing as FieldProvider). */
+export declare const DialogProvider: any;

package/types/generated/escape-props.d.ts

@@ -17,4 +17,5 @@ export declare function nativeAccessibilityState(state?: {
     disabled?: boolean;
     selected?: boolean;
     checked?: boolean;
+    pressed?: boolean;
 }): string | undefined;

package/types/generated/field-context.d.ts

@@ -0,0 +1,38 @@
+import type { FieldControlProps } from './props.js';
+export interface FieldContextValue extends FieldControlProps {
+    controlId?: string;
+    labelId?: string;
+    descriptionId?: string;
+    statusId?: string;
+}
+export declare const FieldContext: import("octane").Context<FieldContextValue | null>;
+export declare const FieldProvider: any;
+export interface ResolvedFieldControlProps extends FieldControlProps {
+    id?: string;
+    fieldLabel?: string;
+    ariaLabel?: string;
+    ariaLabelledBy?: string;
+    ariaDescribedBy?: string;
+    accessibilityHint?: string;
+    /** True when the control renders inside an `InputGroup`'s surface —
+     *  it should drop its own border/radius/background chrome. */
+    inInputGroup?: boolean;
+}
+/** Resolve wrapper defaults and the accessibility links for a field control. */
+export declare function useFieldControlProps<T extends FieldControlProps & {
+    id?: string;
+    accessibilityLabel?: string;
+    accessibilityHint?: string;
+    web?: Record<string, any>;
+}>(props: T): T & ResolvedFieldControlProps;
+/** Resolve field-control props and report whether a surrounding Field owns
+ *  the label, so third-party controls can compose with Field without nesting. */
+export declare function useFieldControl<T extends FieldControlProps & {
+    id?: string;
+    accessibilityLabel?: string;
+    accessibilityHint?: string;
+    web?: Record<string, any>;
+}>(props: T): {
+    props: T & ResolvedFieldControlProps;
+    inField: boolean;
+};

package/types/generated/form-layout-context.d.ts

@@ -0,0 +1,11 @@
+import type { FormLayoutDirection, FormOptionality } from './props.js';
+export interface FormLayoutContextValue {
+    direction: FormLayoutDirection;
+    defaultOptionality?: FormOptionality;
+}
+/** Layered arrangement context: `Field`/`FormField` switches to a
+ *  horizontal-labels render under `direction === 'horizontal-labels'`, and
+ *  `useFieldControlProps` resolves `aria-required` from
+ *  `defaultOptionality`. Nested FormLayouts shadow the outer value. */
+export declare const FormLayoutContext: import("octane").Context<FormLayoutContextValue>;
+export declare const FormLayoutProvider: any;

package/types/generated/index.mobile.d.ts

@@ -1,4 +1,3 @@
 export * from './index.shared.js';
 export { KeyboardAvoiding } from './KeyboardAvoiding.mobile.js';
-export type { KeyboardAvoidingProps } from './props.js';
 import './theme/status-bar-scheme.mobile.js';

package/types/generated/index.shared.d.ts

@@ -1,65 +1,161 @@
 export { View } from './View.js';
-export { View as Column } from './View.js';
-export { Row } from './Row.js';
+/** Vertical flow stack (Astryx `Stack` with direction="vertical"). */
+export { VStack } from './VStack.js';
+/** Horizontal flow stack (Astryx `Stack` with direction="horizontal"). */
+export { HStack } from './HStack.js';
 export { Grid } from './Grid.js';
+/** Flow container — `direction`, `hAlign`/`vAlign`, spacing-step
+ *  `gap`/`padding`. Overlapping children belong in `Absolute`. */
 export { Stack } from './Stack.js';
+/** Per-child size/alignment override inside `Stack`. */
+export { StackItem } from './StackItem.js';
+export { Center } from './Center.js';
+export { Section } from './Section.js';
+export { AspectRatio } from './AspectRatio.js';
+export { VisuallyHidden } from './VisuallyHidden.js';
 export { Absolute } from './Absolute.js';
 export type { PanEvent, SwipeEvent, SetTranslate } from './props.js';
 export { setTranslate } from './translate.js';
 export { Spacer } from './Spacer.js';
 export { Text } from './Text.js';
+export { Markdown, MarkdownScreen } from './Markdown.js';
+export type { MdDoc, MdNode, MdInline, MarkdownProps } from './props.js';
+export { parseMdDoc, parseMdNodes, mdInlineText } from './markdown-parse.js';
+export { createMarkdownIncrementalState, parseMarkdownIncremental, trimStreamingArtifacts, computeBoundaries, computeSegments, markdownTextLength, } from './markdown-stream.js';
+export type { MarkdownIncrementalState, MdTextSegment } from './markdown-stream.js';
 export { RichText, RichTextSpan } from './RichText.js';
 export { Pressable } from './Pressable.js';
 export { Button } from './Button.js';
+export { IconButton } from './IconButton.js';
+export { ButtonGroup } from './ButtonGroup.js';
+export { ToggleButton, ToggleButtonGroup } from './ToggleButton.js';
+export { ClickableCard } from './ClickableCard.js';
+export { SelectableCard } from './SelectableCard.js';
+export { MoreMenu } from './MoreMenu.js';
+export { PowerSearch, PowerSearchToken, PowerSearchFilterEditor } from './PowerSearch.js';
+export { createPowerSearchConfig, usePowerSearchConfig, resolveOperatorLabel, } from './power-search-config.js';
 export { Collapsible } from './Collapsible.js';
 export { Accordion } from './Accordion.js';
-export { Checkbox } from './Checkbox.js';
-export { RadioGroup } from './RadioGroup.js';
+/** Self-drawn checkbox, exported under Astryx's component name. */
+export { Checkbox as CheckboxInput } from './Checkbox.js';
+/** Single-choice option list, exported under Astryx's component name. */
+export { RadioGroup as RadioList } from './RadioGroup.js';
 export { DropdownMenu } from './DropdownMenu.js';
 export { ContextMenu } from './ContextMenu.js';
 export { Badge } from './Badge.js';
-export { Separator } from './Separator.js';
+/** Visual separator between content sections, exported under Astryx's name. */
+export { Separator as Divider } from './Separator.js';
 export { Skeleton } from './Skeleton.js';
 export { Avatar } from './Avatar.js';
 export { AvatarGroup } from './AvatarGroup.js';
-export type { AccordionItemSpec, AccordionProps, AvatarGroupProps, AvatarProps, BadgeProps, ButtonProps, CheckboxProps, CollapsibleProps, ContextMenuProps, DropdownMenuProps, MenuItem, RadioGroupProps, RadioOption, SegmentedControlProps, SeparatorProps, SkeletonProps, } from './props.js';
-export { FormField } from './FormField.js';
+export type { AccordionItemSpec, AccordionProps, AvatarGroupProps, AvatarProps, BadgeProps, ButtonProps, IconButtonProps, ButtonGroupProps, ButtonGroupContextValue, ButtonGroupOrientation, ToggleButtonProps, ToggleButtonGroupProps, ToggleButtonGroupSingleProps, ToggleButtonGroupMultipleProps, ClickableCardProps, SelectableCardProps, MoreMenuProps, MoreMenuPlacement, MoreMenuAlignment, MoreMenuPresentation, PowerSearchProps, PowerSearchSize, PowerSearchTokenProps, PowerSearchEditorProps, PowerSearchComponentOverride, PowerSearchComponents, PowerSearchHandle, PowerSearchChangeType, 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, PowerSearchEntity, DateTimeRange, DateTimeRangePart, DateRangeFilterPreset, RelativeDateFilterPreset, FieldDefinition, PowerSearchFieldType, PowerSearchFieldTypeToJS, InferData, PowerSearchItem, PowerSearchAuxData, EnumItem, OperatorTokenizationConfig, CheckboxProps, CollapsibleProps, ContextMenuProps, FieldControlProps, FieldControlSize, FieldStatus, FieldStatusType, DropdownMenuProps, MenuItem, RadioGroupProps, RadioOption, SegmentedControlProps, SeparatorProps, SkeletonProps, } from './props.js';
+/** Labeled control wrapper, exported under Astryx's component name. */
+export { FormField as Field } from './FormField.js';
+export { useFieldControl } from './field-context.js';
 export { FieldGroup } from './FieldGroup.js';
+/** Form-field arrangement container (Astryx FormLayout). */
+export { FormLayout } from './FormLayout.js';
+export { InputGroup, InputGroupText } from './InputGroup.js';
+/** Reusable labeled row, exported under Astryx's component name. */
+export { Item } from './Item.js';
+/** Content list + row (Astryx `List`/`ListItem` — not a virtualized list). */
+export { List } from './List.js';
 export { ListItem } from './ListItem.js';
-export { InputNumber } from './InputNumber.js';
+/** Bounded numeric entry, exported under Astryx's component name. */
+export { InputNumber as NumberInput } from './InputNumber.js';
 export { PinInput } from './PinInput.js';
-export { Select } from './Select.js';
-export { SelectMenu, Combobox, InputMenu } from './aliases.js';
-export { InputTags } from './InputTags.js';
+/** Option picker, exported under Astryx's component name. */
+export { Select as Selector } from './Select.js';
+/** Multi-choice option picker, exported under Astryx's component name. */
+export { SelectMenu as MultiSelector } from './aliases.js';
+export { BaseTypeahead } from './BaseTypeahead.js';
+export { Typeahead } from './Typeahead.js';
+export { TypeaheadItem } from './TypeaheadItem.js';
+export { createStaticSource } from './typeahead-source.js';
+export { Token } from './Token.js';
+export { Tokenizer } from './Tokenizer.js';
+export { ComplexSelector } from './ComplexSelector.js';
 export { InputRating } from './InputRating.js';
-export { CheckboxGroup } from './CheckboxGroup.js';
-export type { CheckboxGroupProps, FieldGroupProps, ListItemComponent, ListItemProps, ListItemSlotProps, FormFieldProps, InputNumberProps, InputRatingProps, InputTagsProps, PinInputProps, SelectOption, SelectProps, } from './props.js';
-export { Breadcrumb } from './Breadcrumb.js';
+/** Multi-choice checkbox list, exported under Astryx's component name. */
+export { CheckboxGroup as CheckboxList } from './CheckboxGroup.js';
+export { Calendar } from './Calendar.js';
+export { DateInput } from './DateInput.js';
+export { TimeInput } from './TimeInput.js';
+export { DateTimeInput } from './DateTimeInput.js';
+export { DateRangeInput } from './DateRangeInput.js';
+export { useCalendarDays, useCalendarConstraints, useCalendarNavigation } from './calendar-hooks.js';
+export { isSameDay, isDateInRange, getWeekNumber } from './calendar-core.js';
+export type { CalendarDay, CalendarMonthGrid } from './calendar-core.js';
+export type { UseCalendarDaysOptions, UseCalendarDaysReturn, UseCalendarConstraintsOptions, UseCalendarConstraintsReturn, UseCalendarNavigationOptions, UseCalendarNavigationReturn, } from './calendar-hooks.js';
+export type { CheckboxGroupProps, FieldGroupProps, FormLayoutProps, InputGroupProps, InputGroupTextProps, ItemComponent, ItemSlotProps, ListItemProps, ListProps, FormFieldProps, InputNumberProps, InputRatingProps, BaseTypeaheadProps, ComplexSelectorHandle, ComplexSelectorProps, ComplexSelectorRenderState, ComplexSelectorSize, ComplexSelectorVariant, PinInputProps, SearchableItem, SearchSource, CreateStaticSourceOptions, SelectOption, SelectProps, TokenColor, TokenProps, TokenSize, TokenizerChange, TokenizerHandle, TokenizerOverflowBehavior, TokenizerProps, TokenizerSize, TypeaheadInputHandle, TypeaheadItemProps, TypeaheadKeyDownHandler, TypeaheadProps, CalendarProps, DateLocaleProps, DateInputMessages, CalendarSingleProps, CalendarRangeProps, CalendarHandle, DateInputProps, DateInputSize, DateInputFormat, DateInputNativePicker, DateInputPresentation, DateInputStatus, DateInputStatusType, DateRangeInputProps, DateRangeInputSize, DateRangeInputStatus, DateRangeInputStatusType, DateTimeInputProps, DateTimeInputSize, DateTimeInputHourFormat, DateTimeInputNativePicker, DateTimeInputPresentation, DateTimeInputTimeIncrement, DateTimeInputTimeOptionInterval, DateTimeInputStatus, DateTimeInputStatusType, DayOfWeek, DayOfWeekName, DateRange, FieldStatusVariant, InputPresentation, ISODateString, ISODateTimeString, ISOTimeString, NativePickerPolicy, PickerPresentation, DateRangePreset, TimeInputProps, TimeInputSize, TimeInputHourFormat, TimeInputNativePicker, TimeInputPresentation, TimeInputStatus, TimeInputStatusType, } from './props.js';
+/** Ancestor path trail, exported under Astryx's component name. */
+export { AppShell } from './AppShell.js';
+export { AppShellMobileContext } from './AppShell.js';
+export { TopNav, TopNavHeading, TopNavItem, TopNavMenu, TopNavMegaMenu, TopNavMegaMenuItem, TopNavMegaMenuFeaturedCard, } from './TopNav.js';
+export { TopNavRenderContext, useTopNavRenderMode } from './TopNav.js';
+export { SideNav, SideNavSection, SideNavHeading, SideNavItem, SideNavCollapseButton, useSideNavCollapse, SideNavRenderContext, useSideNavRenderMode, } from './SideNav.js';
+export { MobileNav, MobileNavToggle, useAppShellMobile } from './MobileNav.js';
+export { NavIcon } from './NavIcon.js';
+export { NavHeadingMenu, NavHeadingMenuItem } from './NavMenu.js';
+export { NavHeadingMenuContext, NavHeadingCloseContext, useNavHeadingMenuContext, useNavHeadingCloseContext, } from './NavMenu.js';
+export { TabList, Tab, TabMenu, useTabListContext } from './TabList.js';
+export { Toolbar } from './Toolbar.js';
+export { OverflowList } from './OverflowList.js';
+export { useResizable, ResizeHandle } from './Resizable.js';
+export { pixel, percent } from './resize-math.js';
+export type { AppShellProps, AppShellMobileContextValue, AppShellVariant, AppShellBreakpoint, MobileNavConfig, MobileNavProps, MobileNavToggleProps, NavElementSize, NavHeadingMenuSize, NavHeadingCloseContextValue, NavHeadingMenuContextValue, NavHeadingMenuItemProps, NavHeadingMenuProps, NavIconProps, NavItemSize, OverflowItem, OverflowListProps, ResizableConfig, ResizableDirection, ResizablePercentSize, ResizablePixelSize, ResizableMinConfig, ResizableMaxConfig, ResizableRegionSizing, ResizableProps, ResizableRegion, ResizableRegionConfig, ResizableSize, ResizeHandleProps, SideNavCollapseButtonProps, SideNavCollapseState, SideNavCollapsibleConfig, SideNavControlledCollapsible, SideNavImperativeCollapseHandle, SideNavRenderMode, SideNavHeadingProps, SideNavItemProps, SideNavProps, SideNavSectionProps, SpacingStep, TabListContextValue, TabListLayout, TabListOverflow, TabListPattern, TabListSize, TabListProps, TabMenuOption, TabMenuProps, TabProps, ToolbarProps, ToolbarSize, ToolbarVariant, TopNavHeadingProps, TopNavItemProps, TopNavMenuItemData, TopNavMenuProps, TopNavMegaMenuFeaturedCardProps, TopNavMegaMenuItemProps, TopNavMegaMenuProps, TopNavProps, TopNavRenderMode, TopNavSlot, UseResizableMultiConfig, UseResizableSingleOptions, UseResizableSingleConfig, } from './props.js';
+export { Breadcrumb as Breadcrumbs } from './Breadcrumb.js';
 export { Pagination } from './Pagination.js';
 export { Stepper } from './Stepper.js';
 export { NavigationMenu } from './NavigationMenu.js';
 export { CommandPalette } from './CommandPalette.js';
-export type { BreadcrumbItem, BreadcrumbProps, CommandPaletteProps, NavigationMenuItem, NavigationMenuProps, PaginationProps, StepperProps, StepperStep, } from './props.js';
+export type { BreadcrumbItem, BreadcrumbProps, CommandPaletteProps, CommandPaletteItem, CommandPaletteMenuItem, NavigationMenuItem, NavigationMenuProps, PaginationProps, StepperProps, StepperStep, } from './props.js';
 export { Table } from './Table.js';
 export { Timeline } from './Timeline.js';
-export { Tree } from './Tree.js';
+/** Expandable hierarchy, exported under Astryx's component name. */
+export { Tree as TreeList } from './Tree.js';
 export { Alert } from './Alert.js';
 export { Card } from './Card.js';
 export { Chip } from './Chip.js';
 export { Kbd } from './Kbd.js';
-export { Empty } from './Empty.js';
+/** Empty-state block, exported under Astryx's component name. */
+export { Empty as EmptyState } from './Empty.js';
 export { Banner } from './Banner.js';
 export { User } from './User.js';
 export { ProgressGroup } from './ProgressGroup.js';
 export type { AlertProps, BannerProps, CardProps, ChipProps, EmptyProps, KbdProps, ProgressGroupProps, TableColumn, TableProps, TimelineItem, TimelineProps, TreeNode, TreeProps, UserProps, } from './props.js';
+export { ChatLayout } from './ChatLayout.js';
+export { ChatLayoutScrollButton } from './ChatLayoutScrollButton.js';
+export { ChatMessageList } from './ChatMessageList.js';
+export { ChatMessage } from './ChatMessage.js';
+export { ChatMessageBubble } from './ChatMessageBubble.js';
+export { ChatMessageMetadata } from './ChatMessageMetadata.js';
+export { ChatSystemMessage } from './ChatSystemMessage.js';
+export { ChatToolCalls } from './ChatToolCalls.js';
+export { ChatTokenizedText } from './ChatTokenizedText.js';
+export { ChatComposer } from './ChatComposer.js';
+export { ChatComposerInput, ChatComposerTokenElement } from './ChatComposerInput.js';
+export { ChatComposerDrawer } from './ChatComposerDrawer.js';
+export { ChatSendButton } from './ChatSendButton.js';
+export { ChatDictationButton } from './ChatDictationButton.js';
+export { useChatStreamScroll } from './useChatStreamScroll.js';
+export { useChatNewMessages } from './useChatNewMessages.js';
+export { useChatPasteAsToken } from './useChatPasteAsToken.js';
+export { useChatComposerTokens } from './useChatComposerTokens.js';
+export { useSpeechRecognition } from './useSpeechRecognition.js';
+export { useChatDictation } from './useChatDictation.js';
+export { useChatLayoutContext, useChatComposerContext } from './chat-context.js';
+export type { ChatComposerContextValue, ChatComposerDensity, ChatComposerDrawerProps, ChatComposerFile, ChatComposerInputControl, ChatComposerInputHandle, ChatComposerInputProps, ChatComposerKeyEvent, ChatComposerPasteEvent, ChatComposerProps, ChatComposerSearchSource, ChatComposerStatus, ChatComposerToken, ChatComposerTokenBadge, ChatComposerTokenCustom, ChatComposerTokenElementProps, ChatComposerTokenVariant, ChatComposerTrigger, ChatComposerTriggerItem, ChatDensity, ChatDictationButtonProps, ChatLayoutContextValue, ChatLayoutProps, ChatLayoutScrollButtonProps, ChatListContextValue, ChatMessageBubbleProps, ChatMessageBubbleVariant, ChatMessageContextValue, ChatMessageListProps, ChatMessageMetadataProps, ChatMessageProps, ChatMessageSender, ChatMessageStatus, ChatScrollToBottomOptions, ChatSystemMessageProps, ChatSystemMessageVariant, ChatTokenizedTextProps, ChatToolCallItem, ChatToolCallStatus, ChatToolCallsProps, TokenPortal, UseChatComposerTokensOptions, UseChatComposerTokensReturn, UseChatDictationOptions, UseChatDictationReturn, UseChatNewMessagesOptions, UseChatNewMessagesReturn, UseChatPasteAsTokenOptions, UseChatPasteAsTokenReturn, UseChatStreamScrollOptions, UseChatStreamScrollReturn, UseSpeechRecognitionOptions, UseSpeechRecognitionReturn, } from './props.js';
 export { Link } from './Link.js';
 export { NavLink } from './NavLink.js';
 export { TextInput } from './TextInput.js';
 export { TextArea } from './TextArea.js';
 export { SearchInput } from './SearchInput.js';
 export { SegmentedControl } from './SegmentedControl.js';
-export { ScrollBox } from './ScrollBox.js';
-export { ScrollView } from './ScrollView.js';
+/** Scrollable region with axis-aware accessibility — Astryx
+ *  `ScrollableArea`. */
+export { ScrollableArea } from './ScrollableArea.js';
+export { useScrollableArea } from './use-scrollable-area.js';
 export { VirtualList } from './VirtualList.js';
 export type { VirtualListProps } from './props.js';
 export { Image } from './Image.js';
@@ -67,10 +163,23 @@ export { WebView } from './WebView.js';
 export type { WebViewContentSize, WebViewHandle, WebViewLoadEvent, WebViewProps } from './props.js';
 export { Overlay } from './Overlay.js';
 export { Popover } from './Popover.js';
-export { Hoverable } from './Hoverable.js';
+/** Anchored-layer primitive — anchor-relative (context) or fixed x/y
+ *  overlay content (Astryx `useLayer`). */
+export { useLayer } from './use-layer.js';
+export { Dialog, DialogHeader } from './Dialog.js';
+export { useImperativeDialog } from './use-imperative-dialog.js';
+export { AlertDialog } from './AlertDialog.js';
+export { useImperativeAlertDialog } from './use-imperative-alert-dialog.js';
+export { HoverCard } from './HoverCard.js';
+export { useHoverCard } from './use-hover-card.js';
 export { Tooltip } from './Tooltip.js';
-export { showToast } from './toast-anchor.js';
-export type { HoverableProps, OverlayProps, PopoverAnchorRef, PopoverProps, PopoverPlacement, ToastContent, ToastOptions, ToastPosition, TooltipProps, } from './props.js';
+export { Carousel } from './Carousel.js';
+export { Lightbox } from './Lightbox.js';
+export { useLightbox } from './use-lightbox.js';
+export { Toast } from './Toast.js';
+export { ToastViewport } from './toast-viewport.js';
+export { showToast, useToast } from './toast-service.js';
+export type { AlertDialogProps, DialogHeaderProps, DialogOptions, DialogPosition, DialogProps, DialogPurpose, DialogVariant, ImperativeAlertDialogReturn, ImperativeDialogReturn, HoverCardAlignment, HoverCardFocusTrigger, HoverCardOptions, HoverCardPlacement, HoverCardProps, HoverCardReturn, HoverCardTouchTrigger, CarouselHandle, CarouselProps, LightboxMedia, LightboxMediaType, LightboxProps, LightboxTriggerProps, UseLightboxOptions, UseLightboxReturn, OverlayProps, PopoverAnchorRef, PopoverProps, PopoverPlacement, PopoverAlignment, ContextLayerOptions, ContextLayerReturn, ContextRenderProps, FixedLayerOptions, FixedLayerReturn, FixedRenderProps, LayerAlignment, LayerOptions, LayerPlacement, LayerReturn, ScrollAxis, ScrollAxisState, ScrollKeyboardAccess, ScrollOverscroll, ScrollStickyContainment, ScrollableAreaProps, ScrollableAreaState, UseScrollableAreaOptions, UseScrollableAreaResult, ShowToastFn, ToastCollisionBehavior, ToastDismissReason, ToastEntry, ToastOptions, ToastPosition, ToastProps, ToastType, ToastViewportProps, TooltipProps, } from './props.js';
 export { useAnimation } from './anim.js';
 export type { AnimatedValue } from './anim.js';
 export { useThemeScheme, getThemeScheme, setThemePreference, getThemePreference, themeSchemeClasses, onThemeSchemeChange, applyThemeClasses, } from './theme/theme-scheme.js';
@@ -83,12 +192,14 @@ export { Tabs } from './Tabs.js';
 export type { TabSpec } from './Tabs.js';
 export { Switch } from './Switch.js';
 export { SafeArea } from './SafeArea.js';
+export { KeyboardAvoiding } from './KeyboardAvoiding.js';
 export { Drawer } from './Drawer.js';
 export { useSafeAreaInsets } from './safeAreaInsets.js';
 export type { SafeAreaInsets } from './safeAreaInsets.js';
 export { useMeasure } from './useMeasure.js';
 export type { MeasureBounds, MeasureResult, UseMeasureOptions } from './props.js';
-export { ActivityIndicator } from './ActivityIndicator.js';
+/** Loading indicator, exported under Astryx's component name. */
+export { ActivityIndicator as Spinner } from './ActivityIndicator.js';
 export { Meter } from './Meter.js';
 export { Slider } from './Slider.js';
 export { Icon } from './Icon.js';
@@ -98,14 +209,47 @@ export type { IconGlyph } from './icons.js';
 export type { ActivityIndicatorProps, HeadingProps, IconProps, MeterProps, RefreshProps, SearchInputProps, SliderProps, } from './props.js';
 export { isNative } from './platform.js';
 export { registerStack, getStack, stackEntries } from './stacks.js';
-export { pushRoute, popRoute, routeStacks, pushDeepLink, routeFor, currentRoute, currentModalRoute, canGoBack, useCanGoBack, useRoute, useModalRoute, redirect, addBackInterceptor, registerScreens, registerRoutes, addRoutes, screenFor, hrefFor, layoutsForRoute, } from './route.js';
+export { pushRoute, popRoute, routeStacks, pushDeepLink, routeFor, currentRoute, currentModalRoute, canGoBack, useCanGoBack, useRoute, useModalRoute, redirect, addBackInterceptor, registerScreens, registerRoutes, addRoutes, screenFor, hrefFor, layoutsForRoute, errorBoundaryFor, } from './route.js';
+export { RouteBoundary } from './RouteBoundary.js';
 export { useBackInterceptor } from './use-back.js';
-export { deriveRouteManifest, defineRoutes, mergeRouteManifests } from './route-table.js';
-export type { BeforeLoad, BeforeLoadArgs, LinkProps, NavLinkProps, Route, RouteContext, RouteHead, RouteHeadExport, RouteMeta, RouteManifest, RouteSpec, RouteSpecSet, ScreenTable, ModalOpenResult, OpenWindowOptions, } from './props.js';
+export { deriveRouteManifest, defineRoutes, mergeRouteManifests, manifestToJson, } from './route-table.js';
+export type { BeforeLoad, BeforeLoadArgs, LinkProps, NavLinkProps, Route, RouteContext, RouteErrorBoundaryProps, RouteHead, RouteHeadExport, RouteMeta, RouteManifest, RouteManifestJson, RouteJson, RouteDataMode, RouteNameOfPath, RouteParamsFromSpecs, RoutePathParams, RoutePresentationsFromSpecs, RouteSpec, RouteSpecSet, ManifestRouteNames, ManifestRouteParams, ManifestRoutePresentations, SpecRouteInfo, ScreenTable, ModalOpenResult, OpenWindowOptions, } from './props.js';
 export { createStore } from './store.js';
 export type { Store, ReadableStore } from './store.js';
 export { useStore } from './use-store.js';
-export { Sheet } from './Sheet.js';
-export { openSheet, closeSheet } from './sheet-service.js';
-export type { SheetProps, SheetOpenOptions, OpenSheet } from './props.js';
-export type { AbsoluteProps, DrawerProps, GridProps, ImageProps, LayoutChildProps, PressableProps, RichTextProps, RichTextSpanProps, RowProps, ScreenProps, SafeAreaProps, ScrollBoxProps, ScrollViewProps, SpacerProps, StackProps, SwitchProps, TabsProps, TextAreaProps, TextInputProps, TextProps, ViewProps, } from './props.js';
+export { cachedQuery$, invalidateQueries, clearQueryCache, createMemoryQueryStorage, } from './query-cache.js';
+export { platformQueryStorage } from './query-storage.js';
+export type { QueryKey, QueryKeyPart, QueryStorageAdapter, QueryPersistence, CachedQueryOptions, } from './query-cache.js';
+export { BottomSheet, BottomSheetSwitcher } from './BottomSheet.js';
+export { openBottomSheet, closeBottomSheet } from './bottom-sheet-service.js';
+export type { BottomSheetOpenOptions, BottomSheetProps, BottomSheetSnapPoint, BottomSheetSwitcherProps, OpenBottomSheet, } from './props.js';
+export { CheckboxIndicator, CheckIndicator, RadioIndicator } from './indicators.js';
+export { defaultIndicators, getIndicator, registerIndicator, registerIndicators, useIndicator, indicatorScope, } from './indicators.js';
+export type { IndicatorComponent, IndicatorFamily, IndicatorFamilyMap, IndicatorMap, IndicatorName, IndicatorNameOfFamily, IndicatorPosition, IndicatorRegistry, IndicatorSize, IndicatorState, } from './props.js';
+export type { AbsoluteProps, AspectRatioFit, AspectRatioProps, AspectRatioShape, CenterAxis, CenterProps, DividerProps, FormLayoutDirection, FormOptionality, HStackProps, VStackProps, IndicatorProps, InputGroupSize, ItemProps, ListDensity, ListMarkerStyle, ListStyle, SectionDividerSide, SectionProps, SectionVariant, SizeValue, StackAlignment, StackCrossAlignment, StackDirection, StackItemCrossAlignSelf, StackItemProps, StackItemSize, StackMainAlignment, StackPaddingProps, StackSizeProps, StackWrap, VisuallyHiddenProps, CheckboxInputProps, CheckboxListProps, RadioListProps, FieldProps, NumberInputProps, SelectorProps, MultiSelectorProps, BreadcrumbsProps, TreeListProps, EmptyStateProps, SpinnerProps, DrawerProps, GridProps, ImageProps, KeyboardAvoidingProps, LayoutChildProps, PressableProps, RichTextProps, RichTextSpanProps, RowProps, ScreenProps, SafeAreaProps, SpacerProps, StackProps, SwitchProps, TabsProps, TextAreaProps, TextInputProps, TextProps, ViewProps, } from './props.js';
+export { Blockquote } from './Blockquote.js';
+export { Code } from './Code.js';
+export { CodeBlock } from './CodeBlock.js';
+export { MetadataList } from './MetadataList.js';
+export { MetadataListItem } from './MetadataListItem.js';
+export { Thumbnail } from './Thumbnail.js';
+export { ProgressBar } from './ProgressBar.js';
+export { StatusDot } from './StatusDot.js';
+export { Timestamp } from './Timestamp.js';
+export { Timer } from './Timer.js';
+export { Citation } from './Citation.js';
+export { Outline } from './Outline.js';
+export { useOutlineFromMarkdown, useOutlineFromDoc } from './outline-hooks.js';
+export { useOutlineFromDOM } from './outline-dom.js';
+export { parseOutlineFromMarkdown, outlineFromDoc, markdownHeadings, inlineMarkdownText, slugify, uniqueSlug, } from './outline-utils.js';
+export { tokenize, tokenizeAsync, tokenizeStreaming, flatTokensToLines, SYNC_TOKENIZE_THRESHOLD, TOKEN_TYPES, syntaxTokenVar, syntaxTokenVarRef, } from './code-tokenizer.js';
+export type { SyntaxTokenType } from './code-tokenizer.js';
+export type { BlockquoteProps, CodeProps, CodeColor, CodeSize, CodeBlockProps, CodeTokenizer, SyntaxThemeOverride, SyntaxToken, TokenLine, MetadataListProps, MetadataListItemProps, MetadataListColumns, MetadataListLabelConfig, ThumbnailProps, ProgressBarProps, ProgressBarMark, ProgressBarVariant, ProgressBarVariantMap, StatusDotProps, StatusDotVariant, StatusDotVariantMap, TimestampProps, TimestampFormat, TimestampTooltipEntry, TimestampTooltipFormat, TimerProps, TimerFormat, CitationProps, CitationSource, OutlineProps, OutlineItem, OutlineFromDOMOptions, TextType, TextSize, TextColor, TextWeight, } from './props.js';
+export { DropdownMenuItem, DropdownMenuDivider, DropdownMenuCheckboxItem, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSubMenu, } from './MenuParts.js';
+export { DropdownMenuItem as ContextMenuItem, DropdownMenuDivider as ContextMenuDivider, DropdownMenuCheckboxItem as ContextMenuCheckboxItem, DropdownMenuRadioGroup as ContextMenuRadioGroup, DropdownMenuRadioItem as ContextMenuRadioItem, DropdownMenuSubMenu as ContextMenuSubMenu, } from './MenuParts.js';
+export { DropdownMenuItem as BreadcrumbMenuItem, DropdownMenuDivider as BreadcrumbMenuDivider, DropdownMenuCheckboxItem as BreadcrumbMenuCheckboxItem, DropdownMenuRadioGroup as BreadcrumbMenuRadioGroup, DropdownMenuRadioItem as BreadcrumbMenuRadioItem, DropdownMenuSubMenu as BreadcrumbMenuSubMenu, } from './MenuParts.js';
+export { DropdownMenuContext, useDropdownMenuContext } from './menu-context.js';
+export type { MenuOption, MenuItemData, MenuActionData, MenuDividerData, MenuCheckboxData, MenuRadioOptionData, MenuRadioGroupData, MenuItemProps, MenuCheckboxItemProps, MenuRadioGroupProps, MenuRadioItemProps, MenuDividerProps, MenuSubMenuProps, MenuContextValue, } from './props.js';
+export type { MenuItemProps as DropdownMenuItemProps, MenuDividerProps as DropdownMenuDividerProps, MenuCheckboxItemProps as DropdownMenuCheckboxItemProps, MenuRadioGroupProps as DropdownMenuRadioGroupProps, MenuRadioItemProps as DropdownMenuRadioItemProps, MenuSubMenuProps as DropdownMenuSubMenuProps, } from './props.js';
+export type { MenuItemProps as ContextMenuItemProps, MenuDividerProps as ContextMenuDividerProps, MenuCheckboxItemProps as ContextMenuCheckboxItemProps, MenuRadioGroupProps as ContextMenuRadioGroupProps, MenuRadioItemProps as ContextMenuRadioItemProps, MenuSubMenuProps as ContextMenuSubMenuProps, } from './props.js';
+export type { MenuItemProps as BreadcrumbMenuItemProps, MenuDividerProps as BreadcrumbMenuDividerProps, MenuCheckboxItemProps as BreadcrumbMenuCheckboxItemProps, MenuRadioGroupProps as BreadcrumbMenuRadioGroupProps, MenuRadioItemProps as BreadcrumbMenuRadioItemProps, MenuSubMenuProps as BreadcrumbMenuSubMenuProps, } from './props.js';