@octane-xplat/ui 0.7.3 → 0.10.0

package/types/generated/SafeArea.d.ts

@@ -1,2 +1,3 @@
+/**  @jsxImportSource @nativescript-community/octane */
 import type { SafeAreaProps } from './props.js';
 export declare function SafeArea(props: SafeAreaProps): unknown;

package/types/generated/ScrollableArea.d.ts

@@ -0,0 +1,8 @@
+import type { ScrollableAreaProps } from './props.js';
+/**  Scroll viewport (Astryx `ScrollableArea`). NativeScript's ScrollView
+ *  hosts exactly one child, so children wrap in a content flexboxlayout —
+ *  the padding + content box lives there. `axis: 'both'` nests a
+ *  horizontal scroller inside the vertical one (NS has no two-axis
+ *  ScrollView). `overscroll`/`stickyContainment`/`isFullBleed` are web
+ *  semantics and inert here; `role` has no native equivalent. */
+export declare function ScrollableArea(props: ScrollableAreaProps): unknown;

package/types/generated/ScrollableArea.web.d.ts

@@ -0,0 +1,8 @@
+import type { ScrollableAreaProps } from './props.js';
+/**  Scroll viewport (Astryx `ScrollableArea`): axis-aware scrolling with a
+ *  named, keyboard-scrollable viewport and live overflow state — see
+ *  `useScrollableArea` for the measurement. `overscroll` maps to
+ *  `overscroll-behavior`; `stickyContainment` keeps the scroller as the
+ *  sticky boundary; `isFullBleed` is inert here (no container-padding
+ *  protocol exists yet — documented deviation). */
+export declare function ScrollableArea(props: ScrollableAreaProps): import("octane/jsx-runtime").JSX.Element;

package/types/generated/Section.d.ts

@@ -0,0 +1,5 @@
+import type { SectionProps } from './props.js';
+/**  Section — banded container with surface/transparent/muted background.
+ *  The web leaf's container-padding escape has no native analog (no CSS
+ *  var propagation into layout), so this leaf is a single wrapper. */
+export declare function Section(props: SectionProps): unknown;

package/types/generated/Section.web.d.ts

@@ -0,0 +1,9 @@
+import type { SectionProps } from './props.js';
+/**  Section — a banded container. The outer element escapes an ancestor's
+ *  `--vx-container-padding-*` (bleed); the inner element re-asserts the
+ *  padding so content stays aligned, and the `vx-section-inner` class
+ *  zeroes those vars so nested Sections don't compound the escape. Both
+ *  read the vars a `Layout` container publishes — with none declared the
+ *  structure is inert, so the outer/inner split is forward-compatible
+ *  rather than dead code. */
+export declare function Section(props: SectionProps): import("octane/jsx-runtime").JSX.Element;

package/types/generated/SegmentedControl.d.ts

@@ -4,4 +4,4 @@ import type { SegmentedControlProps } from './props.js';
  *  `defaultValue` for uncontrolled. Same classes + geometry as the web
  *  leaf (the platform-authentic widget would be UISegmentedControl /
  *  Material segmented buttons — neither is shared). */
-export declare function SegmentedControl(props: SegmentedControlProps): unknown;
+export declare function SegmentedControl(inputProps: SegmentedControlProps): unknown;

package/types/generated/SegmentedControl.web.d.ts

@@ -3,4 +3,4 @@ import type { SegmentedControlProps } from './props.js';
  *  selected (`--on`). Radiogroup semantics like RadioGroup: Space/Enter
  *  selects. `value`/`onValueChange` for controlled, `defaultValue` for
  *  uncontrolled. Same classes + geometry as the native leaf. */
-export declare function SegmentedControl(props: SegmentedControlProps): import("octane/jsx-runtime").JSX.Element;
+export declare function SegmentedControl(inputProps: SegmentedControlProps): import("octane/jsx-runtime").JSX.Element;

package/types/generated/Select.d.ts

@@ -1,6 +1,3 @@
-import type { SelectProps } from "./props.js";
-/**  Select — anchored self-drawn listbox on every target (decision #48).
- *  `multiple` toggles options without closing and reports string[];
- *  `searchable` filters the list through a normalized TextInput — that
- *  combination is what Nuxt calls Combobox/InputMenu/SelectMenu. */
-export declare function Select(props: SelectProps): unknown;
+import type { SelectProps } from './props.js';
+/**  Finite-list selection with local search; Typeahead owns async result sources. */
+export declare function Select(inputProps: SelectProps): unknown;

package/types/generated/Select.web.d.ts

@@ -1,6 +1,3 @@
-import type { SelectProps } from "./props.js";
-/**  Select — anchored self-drawn listbox on every target (decision #48).
- *  `multiple` toggles options without closing and reports string[];
- *  `searchable` filters the list through a normalized TextInput — that
- *  combination is what Nuxt calls Combobox/InputMenu/SelectMenu. */
-export declare function Select(props: SelectProps): import("octane/jsx-runtime").JSX.Element;
+import type { SelectProps } from './props.js';
+/**  Finite-list selection. Async entity search belongs to Typeahead. */
+export declare function Select(inputProps: SelectProps): import("octane/jsx-runtime").JSX.Element;

package/types/generated/SelectableCard.d.ts

@@ -0,0 +1,3 @@
+/**  @jsxImportSource @nativescript-community/octane */
+import type { SelectableCardProps } from './props.js';
+export declare function SelectableCard(props: SelectableCardProps): unknown;

package/types/generated/SelectableCard.web.d.ts

@@ -0,0 +1,3 @@
+/** @jsxImportSource octane */
+import type { SelectableCardProps } from './props.js';
+export declare function SelectableCard(props: SelectableCardProps): import("octane/jsx-runtime").JSX.Element;

package/types/generated/SideNav.d.ts

@@ -0,0 +1,19 @@
+import type { SideNavCollapseButtonProps, SideNavHeadingProps, SideNavItemProps, SideNavProps, SideNavSectionProps } from './props.js';
+import { SideNavCollapseContext, SideNavRenderContext, useSideNavCollapse, useSideNavRenderMode } from './nav-contexts.js';
+export { SideNavRenderContext, SideNavCollapseContext, useSideNavCollapse, useSideNavRenderMode };
+/**  SideNav — the app's side navigation panel. Header/topContent are pinned,
+ *  children scroll, footer/footerIcons pin to the bottom. Inside AppShell it
+ *  adopts the render mode its context sets (topbar / drawer /
+ *  drawer-content). */
+export declare function SideNav(props: SideNavProps): unknown;
+/**  SideNavSection — titled group of items inside the scrollable area. */
+export declare function SideNavSection(props: SideNavSectionProps): unknown;
+/**  SideNavHeading — identity block at the top of the rail. */
+export declare function SideNavHeading(props: SideNavHeadingProps): unknown;
+/**  SideNavItem — one nav row. Native leaf: Pressable rows; `href` routes
+ *  through `followHref`. Collapsed rail shows the icon and a flyout for
+ *  children via the shared Popover. */
+export declare function SideNavItem(props: SideNavItemProps): unknown;
+/**  SideNavCollapseButton — chevron control bound to the nearest
+ *  SideNavCollapseContext. */
+export declare function SideNavCollapseButton(props: SideNavCollapseButtonProps): unknown;

package/types/generated/SideNav.web.d.ts

@@ -0,0 +1,22 @@
+import type { SideNavCollapseButtonProps, SideNavHeadingProps, SideNavItemProps, SideNavProps, SideNavSectionProps } from './props.js';
+import { SideNavCollapseContext, SideNavRenderContext, useSideNavCollapse, useSideNavRenderMode } from './nav-contexts.js';
+export { SideNavRenderContext, SideNavCollapseContext, useSideNavCollapse, useSideNavRenderMode };
+/**  SideNav — the app's side navigation panel. Header/topContent are sticky,
+ *  children scroll, footer/footerIcons pin to the bottom. Inside AppShell it
+ *  adopts the render mode its context sets (topbar / drawer /
+ *  drawer-content). */
+export declare function SideNav(props: SideNavProps): import("octane/jsx-runtime").JSX.Element;
+/**  SideNavSection — titled group of items inside the scrollable area. */
+export declare function SideNavSection(props: SideNavSectionProps): import("octane/jsx-runtime").JSX.Element;
+/**  SideNavHeading — identity block at the top of the rail: icon + linked
+ *  heading with optional super/subheading lines, trailing content, and an
+ *  optional heading menu popover. */
+export declare function SideNavHeading(props: SideNavHeadingProps): import("octane/jsx-runtime").JSX.Element;
+/**  SideNavItem — one nav row: icon + label + end content + actions +
+ *  optional nested children. Renders a link when `href` is set. In a
+ *  collapsed rail the icon is the whole item and children open a flyout. */
+export declare function SideNavItem(props: SideNavItemProps): import("octane/jsx-runtime").JSX.Element;
+/**  SideNavCollapseButton — chevron control bound to the nearest
+ *  SideNavCollapseContext, or to an externally-supplied controlled config /
+ *  imperative handle when rendered outside the SideNav. */
+export declare function SideNavCollapseButton(props: SideNavCollapseButtonProps): import("octane/jsx-runtime").JSX.Element | null;

package/types/generated/Stack.d.ts

@@ -1,3 +1,7 @@
-/**  @jsxImportSource @nativescript-community/octane */
 import type { StackProps } from './props.js';
+/**  Astryx flow Stack — flexboxlayout in `direction`, `hAlign`/`vAlign`
+ *  mapped to main/cross axes, spacing-step gap/padding (steps × 4 dips).
+ *  Children that need to overlap belong in `Absolute` instead.
+ *  `isScrollable` hosts the flow inside a ScrollView — NS layouts can't
+ *  scroll their own overflow. */
 export declare function Stack(props: StackProps): unknown;

package/types/generated/Stack.web.d.ts

@@ -1,3 +1,5 @@
-/** @jsxImportSource octane */
 import type { StackProps } from './props.js';
+/**  Astryx flow Stack — flex container in `direction`, `hAlign`/`vAlign`
+ *  mapped to main/cross axes, spacing-step gap/padding. Children that need
+ *  to overlap belong in `Absolute` instead. */
 export declare function Stack(props: StackProps): import("octane/jsx-runtime").JSX.Element;

package/types/generated/StackItem.d.ts

@@ -0,0 +1,5 @@
+import type { StackItemProps } from './props.js';
+/**  StackItem — per-child size (`fill` grows into remaining space) and
+ *  cross-axis alignment inside a `Stack`. `isScrollable` hosts the content
+ *  in a ScrollView on native (NS layouts can't scroll their own overflow). */
+export declare function StackItem(props: StackItemProps): unknown;

package/types/generated/StackItem.web.d.ts

@@ -0,0 +1,6 @@
+/** @jsxImportSource octane */
+import type { StackItemProps } from './props.js';
+/**  StackItem — per-child size (`fill` grows into remaining space) and
+ *  cross-axis alignment inside a `Stack`. Carries the flex `min-*: 0`
+ *  reset so `size="fill" isScrollable` is a complete scroll region. */
+export declare function StackItem(props: StackItemProps): import("octane/jsx-runtime").JSX.Element;

package/types/generated/StatusDot.d.ts

@@ -0,0 +1,6 @@
+import type { StatusDotProps } from './props.js';
+/**  StatusDot — an 8pt colored status signal. `label` is the dot's accessible
+ *  name. `isPulsing` loops an opacity animation on the native view (no CSS
+ *  keyframes in the NS engine). `tooltip` wraps the shared Tooltip — a no-op
+ *  on touch targets by Tooltip's own contract. */
+export declare function StatusDot(props: StatusDotProps): unknown;

package/types/generated/StatusDot.web.d.ts

@@ -0,0 +1,7 @@
+/** @jsxImportSource octane */
+import type { StatusDotProps } from './props.js';
+/**  StatusDot — an 8px colored status signal. Non-focusable `role="img"` with
+ *  `aria-label` so the status reaches screen readers without hover. `icon`
+ *  paints in the variant's on-color inside an aria-hidden span; `isPulsing`
+ *  animates (reduced-motion users get the still dot). */
+export declare function StatusDot(props: StatusDotProps): import("octane/jsx-runtime").JSX.Element;

package/types/generated/Switch.d.ts

@@ -4,4 +4,4 @@ import type { SwitchProps } from "./props.js";
  *  targets. The `.vx-switch--on` state class flips justify-content, which
  *  slides the thumb. The platform widget (UISwitch/MaterialSwitch) lives
  *  in `ui/ios` + `ui/android`. */
-export declare function Switch(props: SwitchProps): unknown;
+export declare function Switch(inputProps: SwitchProps): unknown;

package/types/generated/Switch.web.d.ts

@@ -3,4 +3,4 @@ import type { SwitchProps } from "./props.js";
 /**  Self-drawn switch — track + thumb, identical pixels across targets.
  *  The platform widget (UISwitch/MaterialSwitch) lives in `ui/ios` +
  *  `ui/android`. Toggles on click, Space, and Enter. */
-export declare function Switch(props: SwitchProps): import("octane/jsx-runtime").JSX.Element;
+export declare function Switch(inputProps: SwitchProps): import("octane/jsx-runtime").JSX.Element;

package/types/generated/TabList.d.ts

@@ -0,0 +1,18 @@
+import type { TabListProps, TabProps, TabMenuProps } from './props.js';
+import { TabListContext } from './nav-contexts.js';
+export { TabListContext };
+export { useTabListContext } from './nav-contexts.js';
+/**  TabList — tab strip providing TabListContext to Tab/TabMenu children.
+ *  Native leaf: a horizontal flexbox row; `overflow` `auto`/`scroll` wraps it
+ *  in a horizontal scroller and the selected tab is scrolled into view. The
+ *  WAI-ARIA tablist pattern carries `tab` semantics to each stop; there's no
+ *  composite-widget arrow model on pointer platforms. `role="tablist"`
+ *  switches item semantics; the strip itself doesn't gain native grouping. */
+export declare function TabList(props: TabListProps): unknown;
+/**  Tab — a single stop in a TabList. Native leaf renders a Pressable;
+ *  `href` activates through the deep-link/route table (`followHref`) in
+ *  addition to reporting selection. */
+export declare function Tab(props: TabProps): unknown;
+/**  TabMenu — overflow trigger inside a TabList. Native leaf opens the
+ *  shared anchored Popover with menuitemradio-style rows. */
+export declare function TabMenu(props: TabMenuProps): unknown;

package/types/generated/TabList.web.d.ts

@@ -0,0 +1,15 @@
+import type { TabListProps, TabProps, TabMenuProps } from './props.js';
+import { TabListContext } from './nav-contexts.js';
+export { TabListContext };
+export { useTabListContext } from './nav-contexts.js';
+/**  TabList — tab strip providing TabListContext to Tab/TabMenu children.
+ *  A `<nav>` landmark by default; `role="tablist"` switches to the WAI-ARIA
+ *  tabs pattern. Owns roving-tabindex arrow navigation and horizontal
+ *  overflow scrolling with edge fades + arrow affordances. */
+export declare function TabList(props: TabListProps): import("octane/jsx-runtime").JSX.Element;
+/**  Tab — a single stop in a TabList. Renders as a button, or as an anchor
+ *  when `href` is set under the nav pattern. */
+export declare function Tab(props: TabProps): import("octane/jsx-runtime").JSX.Element;
+/**  TabMenu — overflow trigger inside a TabList; opens a menu of extra tab
+ *  options. The selected option's label becomes the trigger text. */
+export declare function TabMenu(props: TabMenuProps): import("octane/jsx-runtime").JSX.Element;

package/types/generated/TextArea.d.ts

@@ -3,6 +3,6 @@ import type { TextAreaProps } from "./props.js";
  *  `autoGrow` is its default; `rows`/`maxRows` have no NS equivalent, so the
  *  leaf converts them to min/maxHeight in dips using the widget's own line
  *  height (iOS `font.lineHeight`, Android `getLineHeight()` px→dip — measured
- *  on `loaded`, re-fit every commit for prop/style changes). The driver's
- *  text→textChange echo suppression applies here unchanged. */
-export declare function TextArea(props: TextAreaProps): unknown;
+ *  on `loaded`, re-fit every commit for prop/style changes). Imperative
+ *  writes suppress their synchronous textChange echo through text-write. */
+export declare function TextArea(inputProps: TextAreaProps): unknown;

package/types/generated/TextArea.web.d.ts

@@ -1,9 +1,9 @@
 import type { TextAreaProps } from "./props.js";
 /**  Multiline input — <textarea>. `autoGrow` re-fits height to content after
- *  every commit via scrollHeight, capped by `maxRows` translated to a real
+ *  input and value updates via scrollHeight, capped by `maxRows` translated to a real
  *  max-height from the element's computed line-height; past the cap the
  *  field scrolls. `useLayoutEffect` so the measure lands pre-paint in the
  *  commit that wrote `value`. Deps are explicit — tsrx infers them from the
  *  closure's reads otherwise, and `props.value` (the thing that changes the
  *  height) isn't read inside. */
-export declare function TextArea(props: TextAreaProps): import("octane/jsx-runtime").JSX.Element;
+export declare function TextArea(inputProps: TextAreaProps): import("octane/jsx-runtime").JSX.Element;

package/types/generated/TextInput.d.ts

@@ -1,9 +1,8 @@
 import type { TextInputProps } from "./props.js";
-/**  Controlled single-line input. The driver suppresses the textChange echo
- *  of its own `text` writes (upstream #5, since 0.2.1) — no leaf-side
- *  guard needed. `editable` defaults true at the leaf too: an undefined
+/**  Controlled single-line input. Imperative writes suppress their synchronous
+ *  textChange echo through text-write. `isReadOnly` defaults false: an undefined
  *  write coerces ios.userInteractionEnabled to NO (dead field) — the
  *  driver's skip-undefined patch covers it, the ?? stays as documentation.
  *  `text` isn't a bound prop: the leaf writes it imperatively so the
  *  Android selection survives controlled writes (see text-write). */
-export declare function TextInput(props: TextInputProps): unknown;
+export declare function TextInput(inputProps: TextInputProps): unknown;

package/types/generated/Thumbnail.d.ts

@@ -0,0 +1,6 @@
+import type { ThumbnailProps } from './props.js';
+/**  Thumbnail — square image preview. `isLoading` shows a Skeleton without
+ *  `src`, an ActivityIndicator overlay over `src`. Load failure falls back to the
+ *  placeholder (NS Image's isLoading→false with no imageSource). On touch
+ *  targets the remove button is always visible — there is no hover state. */
+export declare function Thumbnail(props: ThumbnailProps): unknown;

package/types/generated/Thumbnail.web.d.ts

@@ -0,0 +1,8 @@
+import type { ThumbnailProps } from './props.js';
+/**  Thumbnail — a 40px square image preview. `src` failure (or none) falls
+ *  back to a placeholder glyph; `isLoading` shows a skeleton without `src`
+ *  and a spinner overlay with it. `onRemove` overlays a remove affordance —
+ *  'hover' reveals it on hover/focus, 'always' keeps it visible. An empty
+ *  `alt` is explicitly decorative; a missing one dev-warns unless `label`
+ *  (or web aria attrs) names the group. */
+export declare function Thumbnail(props: ThumbnailProps): import("octane/jsx-runtime").JSX.Element;

package/types/generated/TimeInput.d.ts

@@ -0,0 +1,8 @@
+import type { TimeInputProps } from './props.js';
+/**
+ * Time entry field — `HH:MM[:SS]` values. `text-input`/`popover`
+ * presentations keep the typed field; `bottom-sheet` and `native`/
+ * `adaptive-*` resolve to the self-drawn wheel sheet (the OS time picker is
+ * the `@octane-xplat/date-picker` leaf, not part of the shared control).
+ * Arrow-key stepping has no touch equivalent — the typed field still parses. */
+export declare function TimeInput(props: TimeInputProps): unknown;

package/types/generated/TimeInput.web.d.ts

@@ -0,0 +1,6 @@
+import type { TimeInputProps } from './props.js';
+/**  Time entry field — `HH:MM[:SS]` values, typed input with arrow-key
+ *  stepping, wheel sheet on touch surfaces, `<input type=time>` for
+ *  `native`. `adaptive-native` (default) keeps the typed field when the OS
+ *  picker can't express the contract (`hasSeconds`, `increment !== 1`). */
+export declare function TimeInput(props: TimeInputProps): import("octane/jsx-runtime").JSX.Element;

package/types/generated/TimeWheelPanel.d.ts

@@ -0,0 +1,16 @@
+import type { ISOTimeString } from './props.js';
+interface TimeWheelProps {
+    value?: ISOTimeString;
+    hasSeconds?: boolean;
+    hourFormat?: '12h' | '24h';
+    min?: ISOTimeString;
+    max?: ISOTimeString;
+    onCommit: (time: ISOTimeString) => void;
+    onDismiss?: () => void;
+}
+/**  Bottom-sheet time picker — scrollable option columns + commit row.
+ *  Columns are scrollviews of tap-to-select rows (the self-drawn wheel
+ *  equivalent — a NativeScript `listpicker` per column is the alternative,
+ *  but scroll columns keep sizing/theming identical across targets). */
+export declare function TimeWheelPanel(props: TimeWheelProps): unknown;
+export {};

package/types/generated/TimeWheelPanel.web.d.ts

@@ -0,0 +1,16 @@
+import type { ISOTimeString } from './props.js';
+interface TimeWheelProps {
+    value?: ISOTimeString;
+    hasSeconds?: boolean;
+    hourFormat?: '12h' | '24h';
+    min?: ISOTimeString;
+    max?: ISOTimeString;
+    onCommit: (time: ISOTimeString) => void;
+    onDismiss?: () => void;
+}
+/**  Bottom-sheet time picker — scrollable option columns (hour, minute,
+ *  seconds, AM/PM) + commit row. The touch surface for `bottom-sheet` /
+ *  `adaptive-bottom-sheet` presentations; a self-drawn wheel equivalent —
+ *  column lists rather than a rotary drum. */
+export declare function TimeWheelPanel(props: TimeWheelProps): import("octane/jsx-runtime").JSX.Element;
+export {};

package/types/generated/Timer.d.ts

@@ -0,0 +1,5 @@
+import type { TimerProps } from './props.js';
+/**  Timer — live elapsed duration label since `startTime` (ms; defaults to
+ *  mount). Native has no `<time>` element — the ISO 8601 duration rides on
+ *  `accessibilityValue`. Tick cadence follows the displayed precision. */
+export declare function Timer(props: TimerProps): unknown;

package/types/generated/Timer.web.d.ts

@@ -0,0 +1,6 @@
+import type { TimerProps } from './props.js';
+/**  Timer — live elapsed duration since `startTime` (ms; defaults to mount).
+ *  Renders a semantic `<time>` whose `dateTime` is the ISO 8601 duration.
+ *  The tick cadence follows the displayed precision — seconds under an hour
+ *  in 'elapsed' mode, minutes after. */
+export declare function Timer(props: TimerProps): import("octane/jsx-runtime").JSX.Element;

package/types/generated/Timestamp.d.ts

@@ -0,0 +1,8 @@
+import type { TimestampProps } from './props.js';
+/**  Timestamp — human-readable instant on native. A label carrying the
+ *  formatted text; relative formats set the absolute `full` form as the
+ *  accessible label. `isLive` re-renders on the relative cadence. There is
+ *  no pointer-hover surface on touch targets, so `hasTooltip`/`tooltipEntries`
+ *  are accepted for API parity but inert (the absolute instant stays
+ *  reachable via the accessible label — see docs/app/components.md). */
+export declare function Timestamp(props: TimestampProps): unknown;

package/types/generated/Timestamp.web.d.ts

@@ -0,0 +1,7 @@
+import type { TimestampProps } from './props.js';
+/**  Timestamp — human-readable instant. `<time dateTime>` carries the ISO
+ *  instant; relative formats announce the absolute `full` form via
+ *  aria-label. 'auto' is relative below `autoThreshold` seconds, else
+ *  `date_time`. `isLive` re-renders on the relative cadence. `hasTooltip`
+ *  opens the HoverCard with one row per tooltip entry. */
+export declare function Timestamp(props: TimestampProps): import("octane/jsx-runtime").JSX.Element;

package/types/generated/Toast.d.ts

@@ -0,0 +1,7 @@
+import type { ToastProps } from './props.js';
+/**
+ * Toast surface (Astryx `Toast`), native leaf. Auto-hide timer; a
+ * horizontal pan drags the card and releases-to-dismiss past the
+ * threshold; `accessibilityLiveRegion` announces info politely and errors
+ * assertively. */
+export declare function Toast(props: ToastProps): unknown;

package/types/generated/Toast.web.d.ts

@@ -0,0 +1,9 @@
+import type { ToastProps } from './props.js';
+/**
+ * Toast surface (Astryx `Toast`), web leaf. Manages its own auto-hide
+ * timer (pauses while hovered or focused, like upstream), horizontal
+ * swipe/touch drag to dismiss, and `renderContent` takeover. ARIA:
+ * `role="status" aria-live="polite"` for info, `role="alert"` for error. */
+export declare function Toast(props: ToastProps): import("octane/jsx-runtime").JSX.Element;
+/**  Internal viewport alias; the public card remains `Toast`. */
+export declare const ToastSurface: typeof Toast;

package/types/generated/ToggleButton.d.ts

@@ -0,0 +1,3 @@
+import type { ToggleButtonProps, ToggleButtonGroupProps } from './props.js';
+export declare function ToggleButton(props: ToggleButtonProps): unknown;
+export declare function ToggleButtonGroup(props: ToggleButtonGroupProps): unknown;

package/types/generated/ToggleButton.web.d.ts

@@ -0,0 +1,3 @@
+import type { ToggleButtonProps, ToggleButtonGroupProps } from './props.js';
+export declare function ToggleButton(props: ToggleButtonProps): import("octane/jsx-runtime").JSX.Element;
+export declare function ToggleButtonGroup(props: ToggleButtonGroupProps): import("octane/jsx-runtime").JSX.Element;

package/types/generated/Token.d.ts

@@ -0,0 +1,4 @@
+import type { TokenProps } from "./props.js";
+/**  Token — inline entity chip. Native leaf: a chip row; `onClick`/`href`
+ *  (opens the URL) make it pressable, `onRemove` adds the ✕ affordance. */
+export declare function Token(props: TokenProps): unknown;

package/types/generated/Token.web.d.ts

@@ -0,0 +1,7 @@
+import type { TokenProps } from "./props.js";
+/**  Token — inline entity chip. Plain `<span>` by default; `onClick` renders
+ *  an inner button hit-surface (real button semantics, :focus-within ring on
+ *  the chip); `href` renders an `<a>`; `href` + `onRemove` keeps them
+ *  siblings (a <button> inside an <a> is invalid HTML) and delegates clicks
+ *  on the rest of the chip to the link, including ⌘/Ctrl-click new-tab. */
+export declare function Token(props: TokenProps): import("octane/jsx-runtime").JSX.Element;

package/types/generated/Tokenizer.d.ts

@@ -0,0 +1,6 @@
+import type { SearchableItem, TokenizerProps } from "./props.js";
+/**  Multi-select field: Token chips + a BaseTypeahead input. Native leaf —
+ *  Backspace-removes-last-token needs key events native text fields don't
+ *  emit, so removal is the token ✕ (and the clear-all lane); truncation is
+ *  measured off native layout (`layoutChanged`), not ResizeObserver. */
+export declare function Tokenizer<T extends SearchableItem>(props: TokenizerProps<T>): unknown;

package/types/generated/Tokenizer.web.d.ts

@@ -0,0 +1,5 @@
+import type { SearchableItem, TokenizerProps } from "./props.js";
+/**  Multi-select field: Token chips + a BaseTypeahead input. Selecting adds a
+ *  token and clears the query; Backspace on an empty input removes the last
+ *  token; `hasCreate` offers a "Create \"…\"" entry for unmatched text. */
+export declare function Tokenizer<T extends SearchableItem>(props: TokenizerProps<T>): import("octane/jsx-runtime").JSX.Element;

package/types/generated/Toolbar.d.ts

@@ -0,0 +1,6 @@
+/**  @jsxImportSource @nativescript-community/octane */
+import type { ToolbarProps } from './props.js';
+/**  Toolbar — named contextual action region with start / optional center /
+ *  end slots. Native leaf: the same slot layout minus keyboard roving
+ *  (pointer platforms carry the composite-widget arrow navigation). */
+export declare function Toolbar(props: ToolbarProps): unknown;

package/types/generated/Toolbar.web.d.ts

@@ -0,0 +1,5 @@
+import type { ToolbarProps } from './props.js';
+/**  Toolbar — named contextual action region with start / optional center /
+ *  end slots and roving-tabindex arrow navigation across the focusable
+ *  children. Outer chrome paints the variant and divider edges. */
+export declare function Toolbar(props: ToolbarProps): import("octane/jsx-runtime").JSX.Element;

package/types/generated/Tooltip.web.d.ts

@@ -1,12 +1,12 @@
 import type { TooltipProps } from './props.js';
 /**
- * Delayed hover-intent tooltip anchored through Popover. `focusin`/`focusout`
+ * Delayed hover-intent tooltip anchored through useLayer. `focusin`/`focusout`
  * bubble, so keyboard focus on a focusable child opens it without forcing a
  * tab stop on the wrapper; while open the resolved focusable element gets
  * `aria-describedby` pointing at the `role="tooltip"` panel. Escape, blur,
  * and scroll (capture, so nested scrollers count) dismiss.
  *
  * Web-only (the `ui/web` subpath) — hover/focus intent has no touch-platform
- * semantic and a long-press stand-in would repeat the Hoverable trap
+ * semantic and a long-press stand-in would repeat the old hover-wrapper trap
  * (decision #47). */
 export declare function Tooltip(props: TooltipProps): import("octane/jsx-runtime").JSX.Element;

package/types/generated/TopNav.d.ts

@@ -0,0 +1,25 @@
+import type { TopNavHeadingProps, TopNavItemProps, TopNavMenuProps, TopNavMegaMenuProps, TopNavMegaMenuItemProps, TopNavMegaMenuFeaturedCardProps, TopNavProps } from './props.js';
+import { TopNavMobileContentContext, TopNavRenderContext, TopNavSlotContext, useTopNavMobileContent, useTopNavRenderMode, useTopNavSlot } from './nav-contexts.js';
+export { TopNavRenderContext, TopNavSlotContext, TopNavMobileContentContext, useTopNavRenderMode, useTopNavSlot, useTopNavMobileContent };
+/**  TopNav — the app's top navigation bar. Native leaf: the same three
+ *  render modes — `default` full bar, `mobile-bar` (heading + end +
+ *  toggle), `drawer` (content inside MobileNav). Hover-driven menus open on
+ *  tap on pointer platforms. */
+export declare function TopNav(props: TopNavProps): unknown;
+/**  TopNavHeading — the brand block: logo + heading link with optional
+ *  super/subheading lines and an optional heading menu popover. */
+export declare function TopNavHeading(props: TopNavHeadingProps): unknown;
+/**  TopNavItem — one nav link in the bar. Native leaf: Pressable rows;
+ *  `href` routes through `followHref`. */
+export declare function TopNavItem(props: TopNavItemProps): unknown;
+/**  TopNavMenu — trigger that opens a list popover on press (hover platforms
+ *  get hover intent in the web leaf). */
+export declare function TopNavMenu(props: TopNavMenuProps): unknown;
+/**  TopNavMegaMenu — trigger opening a wide panel with an items grid plus an
+ *  optional featured panel. Native leaf: a press-opened anchored popover. */
+export declare function TopNavMegaMenu(props: TopNavMegaMenuProps): unknown;
+/**  TopNavMegaMenuItem — one link in the mega menu items grid. */
+export declare function TopNavMegaMenuItem(props: TopNavMegaMenuItemProps): unknown;
+/**  TopNavMegaMenuFeaturedCard — the marketing card inside a mega menu's
+ *  featured panel. */
+export declare function TopNavMegaMenuFeaturedCard(props: TopNavMegaMenuFeaturedCardProps): unknown;

package/types/generated/TopNav.web.d.ts

@@ -0,0 +1,23 @@
+import type { TopNavHeadingProps, TopNavItemProps, TopNavMenuProps, TopNavMegaMenuProps, TopNavMegaMenuItemProps, TopNavMegaMenuFeaturedCardProps, TopNavProps } from './props.js';
+import { TopNavMobileContentContext, TopNavRenderContext, TopNavSlotContext, useTopNavMobileContent, useTopNavRenderMode, useTopNavSlot } from './nav-contexts.js';
+export { TopNavRenderContext, TopNavSlotContext, TopNavMobileContentContext, useTopNavRenderMode, useTopNavSlot, useTopNavMobileContent };
+/**  TopNav — the app's top navigation bar. Three render modes: `default`
+ *  (full bar), `mobile-bar` (heading + end + toggle, set by AppShell below
+ *  the breakpoint), and `drawer` (content inside the MobileNav overlay). */
+export declare function TopNav(props: TopNavProps): import("octane/jsx-runtime").JSX.Element;
+/**  TopNavHeading — the brand block: logo + heading link with optional
+ *  super/subheading lines and an optional heading menu popover. */
+export declare function TopNavHeading(props: TopNavHeadingProps): import("octane/jsx-runtime").JSX.Element;
+/**  TopNavItem — one nav link in the bar (start/center/end slots); in the
+ *  drawer render mode it stretches to a full-width row. */
+export declare function TopNavItem(props: TopNavItemProps): import("octane/jsx-runtime").JSX.Element;
+/**  TopNavMenu — trigger that opens a list popover on hover or press. */
+export declare function TopNavMenu(props: TopNavMenuProps): import("octane/jsx-runtime").JSX.Element;
+/**  TopNavMegaMenu — trigger opening a wide panel with an items grid plus an
+ *  optional featured panel. */
+export declare function TopNavMegaMenu(props: TopNavMegaMenuProps): import("octane/jsx-runtime").JSX.Element;
+/**  TopNavMegaMenuItem — one link in the mega menu items grid. */
+export declare function TopNavMegaMenuItem(props: TopNavMegaMenuItemProps): import("octane/jsx-runtime").JSX.Element;
+/**  TopNavMegaMenuFeaturedCard — the marketing card inside a mega menu's
+ *  featured panel. */
+export declare function TopNavMegaMenuFeaturedCard(props: TopNavMegaMenuFeaturedCardProps): import("octane/jsx-runtime").JSX.Element;

package/types/generated/Typeahead.d.ts

@@ -0,0 +1,6 @@
+import type { SearchableItem, TypeaheadProps } from "./props.js";
+/**  Single-selection search-as-you-type field: Field chrome + input wrapper +
+ *  a Token over the input while a value is selected. Tapping the token or
+ *  wrapper enters edit mode (input repopulated with the label); leaving the
+ *  field without selecting restores the token. */
+export declare function Typeahead<T extends SearchableItem>(props: TypeaheadProps<T>): unknown;

package/types/generated/Typeahead.web.d.ts

@@ -0,0 +1,6 @@
+import type { SearchableItem, TypeaheadProps } from "./props.js";
+/**  Single-selection search-as-you-type field: Field chrome + input wrapper +
+ *  a Token painted over the input while a value is selected. Clicking the
+ *  token or wrapper enters edit mode (input repopulated with the label);
+ *  blur or Escape without a selection restores the token. */
+export declare function Typeahead<T extends SearchableItem>(props: TypeaheadProps<T>): import("octane/jsx-runtime").JSX.Element;

package/types/generated/TypeaheadItem.d.ts

@@ -0,0 +1,4 @@
+import type { SearchableItem, TypeaheadItemProps } from "./props.js";
+/**  Default option content for typeahead dropdowns — label with an optional
+ *  leading icon and supporting description. `item.element` wins when set. */
+export declare function TypeaheadItem<T extends SearchableItem>(props: TypeaheadItemProps<T>): unknown;

package/types/generated/TypeaheadItem.web.d.ts

@@ -0,0 +1,5 @@
+import type { SearchableItem, TypeaheadItemProps } from "./props.js";
+/**  Default option content for typeahead dropdowns — label with an optional
+ *  leading icon and supporting description. `item.element` wins when set.
+ *  Exported for use in custom `renderItem` implementations. */
+export declare function TypeaheadItem<T extends SearchableItem>(props: TypeaheadItemProps<T>): import("octane/jsx-runtime").JSX.Element;

package/types/generated/VStack.d.ts

@@ -0,0 +1,5 @@
+/**  @jsxImportSource @nativescript-community/octane */
+import type { VStackProps } from './props.js';
+/**  Vertical flow stack — `Stack` with `direction="vertical"`.
+ *  `vAlign` is the main axis (justify-content), `hAlign` the cross axis. */
+export declare function VStack(props: VStackProps): unknown;

package/types/generated/View.web.d.ts

@@ -2,6 +2,6 @@ import type { ViewProps } from './props.js';
 /**  Neutral flex-column container — the RN-shaped default block.
  *  onPan is pointer plumbing: pointerdown/move/up on the element.
  *  pointermove isn't in octane's delegated-event set, so the leaf attaches
- *  raw listeners via a ref — that's why `bind` exists. Payloads normalize
+ *  raw listeners through its internal ref. Payloads normalize
  *  to the shared shape {x,y,dx,dy,vx,vy,state,target}. */
 export declare function View(props: ViewProps): import("octane/jsx-runtime").JSX.Element;

package/types/generated/VirtualList.d.ts

@@ -1,5 +1,5 @@
 import type { VirtualListProps } from './props.js';
-/**  Shared vertical virtualization over NativeScript ScrollView. Off-window
- *  rows unmount; measured row-height changes above the visible anchor adjust
- *  the native scroll offset after layout. */
+/**  Shared vertical virtualization with pooled outer hosts and keyed logical
+ *  rows. Off-window item subtrees unmount; measured heights position cells and
+ *  preserve the visible keyed anchor after layout. */
 export declare function VirtualList<T = any>(props: VirtualListProps<T>): unknown;

package/types/generated/VisuallyHidden.d.ts

@@ -0,0 +1,6 @@
+import type { VisuallyHiddenProps } from './props.js';
+/**  VisuallyHidden — a 1dip, fully transparent container that keeps its
+ *  subtree in the native accessibility tree (opacity:0 views stay exposed
+ *  to TalkBack/VoiceOver, unlike visibility=hidden which drops them on
+ *  iOS). For screen-reader labels and live-region announcements. */
+export declare function VisuallyHidden(props: VisuallyHiddenProps): unknown;