@octane-xplat/ui 0.5.0 → 0.6.0

package/types/android.d.ts

@@ -0,0 +1,53 @@
+// Boundary types for @octane-xplat/ui/android — Android-authentic widgets.
+// OS chrome is the point; the self-drawn shared versions live in the root
+// export. This subpath resolves only under the `native` condition.
+
+import type { UniversalComponent } from 'octane/universal'
+import type {
+	ActivityIndicatorProps,
+	DrawerProps,
+	ListProps,
+	ModalProps,
+	ModalOpenOptions,
+	ModalOpenResult,
+	OpenModal,
+	RefreshProps,
+	SwitchProps,
+	SliderProps,
+	TabsProps,
+	TabSpec,
+} from './props'
+
+export type {
+	ActivityIndicatorProps,
+	DrawerProps,
+	ListProps,
+	ModalProps,
+	ModalOpenOptions,
+	ModalOpenResult,
+	OpenModal,
+	RefreshProps,
+	SwitchProps,
+	SliderProps,
+	TabsProps,
+	TabSpec,
+} from './props'
+
+/** Material SwitchMaterial via NativeScript `switch`. */
+export declare const MaterialSwitch: UniversalComponent<SwitchProps>
+/** Android SeekBar via NativeScript `slider`. */
+export declare const SeekBar: UniversalComponent<SliderProps>
+/** Android indeterminate ProgressBar via NativeScript `activityindicator`. */
+export declare const CircularProgressIndicator: UniversalComponent<ActivityIndicatorProps>
+/** Android RecyclerView via NativeScript `listview` — recycled platform list. */
+export declare const RecyclerView: UniversalComponent<ListProps>
+/** Android bottom navigation via NativeScript TabView. Caveat: `stack`
+ *  panes rely on Frame-in-TabViewItem, which is unreliable upstream
+ *  (NativeScript#11444) — the shared `Tabs` keeps stack history in the
+ *  route store and is the reliable path on Android. */
+export declare const BottomNavigationView: UniversalComponent<TabsProps>
+/** Platform modal presentation (`showModal`; fullscreen=false → dialog). */
+export declare const MaterialDialog: UniversalComponent<ModalProps>
+export declare const openModal: OpenModal
+/** AndroidX DrawerLayout via the ui-drawer plugin. */
+export declare const DrawerLayout: UniversalComponent<DrawerProps>

package/types/index.d.ts

@@ -13,34 +13,33 @@ import type {
 	ActivityIndicatorProps,
 	BeforeLoad,
 	BeforeLoadArgs,
+	CameraViewHandle,
+	CameraViewProps,
 	ColorScheme,
 	DrawerProps,
 	GridProps,
 	HeadingProps,
-	HoverableProps,
 	IconGlyph,
 	IconProps,
 	ImageProps,
 	KeyboardAvoidingProps,
 	LayoutChildProps,
 	LinkProps,
-	ListProps,
 	MeterProps,
-	ModalProps,
-	ModalOpenOptions,
 	ModalOpenResult,
 	MeasureBounds,
 	MeasureResult,
 	NavLinkProps,
-	OpenModal,
 	OpenWindowOptions,
 	OverlayProps,
 	PopoverAnchorRef,
 	PopoverPlacement,
 	PopoverProps,
+	PagerProps,
 	PlatformBadgeProps,
 	PressableProps,
 	ReadableStore,
+	RefreshProps,
 	Route,
 	RouteContext,
 	RouteHead,
@@ -54,6 +53,8 @@ import type {
 	SafeAreaProps,
 	ScreenTable,
 	ScrollViewProps,
+	SearchInputProps,
+	SegmentedControlProps,
 	SliderProps,
 	Store,
 	SpacerProps,
@@ -68,7 +69,14 @@ import type {
 	ToastOptions,
 	ToastPosition,
 	UseMeasureOptions,
+	VideoEvent,
+	VideoFit,
+	VideoHandle,
+	VideoProps,
 	ViewProps,
+	WebViewHandle,
+	WebViewLoadEvent,
+	WebViewProps,
 } from './props'
 
 export type {
@@ -77,34 +85,32 @@ export type {
 	ActivityIndicatorProps,
 	BeforeLoad,
 	BeforeLoadArgs,
+	CameraViewHandle,
+	CameraViewProps,
 	ColorScheme,
 	DrawerProps,
 	GridProps,
 	HeadingProps,
-	HoverableProps,
 	IconGlyph,
 	IconProps,
 	ImageProps,
 	KeyboardAvoidingProps,
 	LayoutChildProps,
 	LinkProps,
-	ListProps,
-	ModalProps,
-	ModalOpenOptions,
 	ModalOpenResult,
 	MeasureBounds,
 	MeasureResult,
 	NavLinkProps,
-	OpenModal,
 	OpenWindowOptions,
 	OverlayProps,
 	PopoverAnchorRef,
 	PopoverPlacement,
 	PopoverProps,
+	PagerProps,
 	PanEvent,
-	PlatformBadgeProps,
 	PressableProps,
 	ReadableStore,
+	RefreshProps,
 	Route,
 	RouteContext,
 	RouteHead,
@@ -118,6 +124,8 @@ export type {
 	SafeAreaProps,
 	ScreenTable,
 	ScrollViewProps,
+	SearchInputProps,
+	SegmentedControlProps,
 	SliderProps,
 	Store,
 	SpacerProps,
@@ -133,7 +141,14 @@ export type {
 	ToastOptions,
 	ToastPosition,
 	UseMeasureOptions,
+	VideoEvent,
+	VideoFit,
+	VideoHandle,
+	VideoProps,
 	ViewProps,
+	WebViewHandle,
+	WebViewLoadEvent,
+	WebViewProps,
 } from './props'
 
 /** ScrollBox shares ScrollView's public shell props; native renders it inline. */
@@ -157,33 +172,34 @@ export declare const Link: UniversalComponent<LinkProps>
 export declare const NavLink: UniversalComponent<NavLinkProps>
 export declare const TextInput: UniversalComponent<TextInputProps>
 export declare const TextArea: UniversalComponent<TextAreaProps>
-export declare const List: UniversalComponent<ListProps>
+export declare const SearchInput: UniversalComponent<SearchInputProps>
 export declare const ScrollBox: UniversalComponent<ScrollBoxProps>
 export declare const ScrollView: UniversalComponent<ScrollViewProps>
+export declare const Pager: UniversalComponent<PagerProps>
 export declare const Image: UniversalComponent<ImageProps>
+export declare const WebView: UniversalComponent<WebViewProps>
+export declare const Video: UniversalComponent<VideoProps>
+export declare const CameraView: UniversalComponent<CameraViewProps>
 export declare const Screen: UniversalComponent<ScreenProps>
 export declare const SafeArea: UniversalComponent<SafeAreaProps>
 export declare const KeyboardAvoiding: UniversalComponent<KeyboardAvoidingProps>
 export declare const Drawer: UniversalComponent<DrawerProps>
 export declare const Switch: UniversalComponent<SwitchProps>
+export declare const SegmentedControl: UniversalComponent<SegmentedControlProps>
 export declare const ActivityIndicator: UniversalComponent<ActivityIndicatorProps>
 export declare const Meter: UniversalComponent<MeterProps>
 export declare const Slider: UniversalComponent<SliderProps>
 export declare const Icon: UniversalComponent<IconProps>
 export declare const Heading: UniversalComponent<HeadingProps>
-export declare const PlatformBadge: UniversalComponent<PlatformBadgeProps>
 
 export declare function registerIcon(name: string, glyph: IconGlyph): void
 export declare function registerIcons(record: Record<string, IconGlyph>): void
 
 // ---------- overlays / shells ----------
 
-export declare const Modal: UniversalComponent<ModalProps>
-export declare const openModal: OpenModal
 export declare function openWindow(options?: OpenWindowOptions): any
 export declare const Overlay: UniversalComponent<OverlayProps>
 export declare const Popover: UniversalComponent<PopoverProps>
-export declare const Hoverable: UniversalComponent<HoverableProps>
 export declare function showToast(content: ToastContent, options?: ToastOptions): void
 export declare const Tabs: UniversalComponent<TabsProps>
 
@@ -198,7 +214,6 @@ export declare function stackEntries(): IterableIterator<[string, any]>
 export declare function pushRoute(r: Route): void
 export declare function popRoute(stack?: string): void
 export declare function routeStacks(): string[]
-export declare function layoutsForRoute(name: string): any[]
 export declare function routeFor(stack: string): Route | null
 export declare function currentRoute(): Route | null
 export declare function canGoBack(stack?: string): boolean

package/types/index.native.d.ts

@@ -0,0 +1,273 @@
+// Boundary types for @octane-xplat/ui — the thin shell over the real
+// contract. Every interface lives in `src/props.ts` (imported by both
+// platform leaves and emitted here as `./props`), so the ONLY hand-written
+// part is the mechanical `declare const X: UniversalComponent<XProps>`
+// wrapper — component shapes can't drift from the source. tsrx-tsc can't
+// emit declarations for .tsrx (upstream: tsrx-org/tsrx#136); this file is
+// what `tsc --emitDeclarationOnly` on pure .ts buys us.
+
+import type { UniversalComponent } from 'octane/universal'
+import type {
+	AnimatedValue,
+	AbsoluteProps,
+	ActivityIndicatorProps,
+	BeforeLoad,
+	BeforeLoadArgs,
+	CameraViewHandle,
+	CameraViewProps,
+	ColorScheme,
+	DrawerProps,
+	GridProps,
+	HeadingProps,
+	IconGlyph,
+	IconProps,
+	ImageProps,
+	KeyboardAvoidingProps,
+	LayoutChildProps,
+	LinkProps,
+	MeterProps,
+	ModalOpenResult,
+	MeasureBounds,
+	MeasureResult,
+	NavLinkProps,
+	OpenWindowOptions,
+	OverlayProps,
+	PopoverAnchorRef,
+	PopoverPlacement,
+	PopoverProps,
+	PagerProps,
+	PlatformBadgeProps,
+	PressableProps,
+	ReadableStore,
+	RefreshProps,
+	Route,
+	RouteContext,
+	RouteHead,
+	RouteHeadExport,
+	RouteManifest,
+	RouteMeta,
+	RichTextProps,
+	RichTextSpanProps,
+	RowProps,
+	ScreenProps,
+	SafeAreaProps,
+	ScreenTable,
+	ScrollViewProps,
+	SearchInputProps,
+	SegmentedControlProps,
+	SliderProps,
+	Store,
+	SpacerProps,
+	StackProps,
+	SwitchProps,
+	TabSpec,
+	TabsProps,
+	TextAreaProps,
+	TextInputProps,
+	TextProps,
+	ToastContent,
+	ToastOptions,
+	ToastPosition,
+	UseMeasureOptions,
+	VideoEvent,
+	VideoFit,
+	VideoHandle,
+	VideoProps,
+	ViewProps,
+	WebViewHandle,
+	WebViewLoadEvent,
+	WebViewProps,
+} from './props'
+
+export type {
+	AbsoluteProps,
+	AnimatedValue,
+	ActivityIndicatorProps,
+	BeforeLoad,
+	BeforeLoadArgs,
+	CameraViewHandle,
+	CameraViewProps,
+	ColorScheme,
+	DrawerProps,
+	GridProps,
+	HeadingProps,
+	IconGlyph,
+	IconProps,
+	ImageProps,
+	KeyboardAvoidingProps,
+	LayoutChildProps,
+	LinkProps,
+	ModalOpenResult,
+	MeasureBounds,
+	MeasureResult,
+	NavLinkProps,
+	OpenWindowOptions,
+	OverlayProps,
+	PopoverAnchorRef,
+	PopoverPlacement,
+	PopoverProps,
+	PagerProps,
+	PanEvent,
+	PressableProps,
+	ReadableStore,
+	RefreshProps,
+	Route,
+	RouteContext,
+	RouteHead,
+	RouteHeadExport,
+	RouteManifest,
+	RouteMeta,
+	RichTextProps,
+	RichTextSpanProps,
+	RowProps,
+	ScreenProps,
+	SafeAreaProps,
+	ScreenTable,
+	ScrollViewProps,
+	SearchInputProps,
+	SegmentedControlProps,
+	SliderProps,
+	Store,
+	SpacerProps,
+	StackProps,
+	SwipeEvent,
+	SwitchProps,
+	TabSpec,
+	TabsProps,
+	TextAreaProps,
+	TextInputProps,
+	TextProps,
+	ToastContent,
+	ToastOptions,
+	ToastPosition,
+	UseMeasureOptions,
+	VideoEvent,
+	VideoFit,
+	VideoHandle,
+	VideoProps,
+	ViewProps,
+	WebViewHandle,
+	WebViewLoadEvent,
+	WebViewProps,
+} from './props'
+
+/** ScrollBox shares ScrollView's public shell props; native renders it inline. */
+export type ScrollBoxProps = ScrollViewProps
+
+// ---------- primitives ----------
+
+export declare const View: UniversalComponent<ViewProps>
+/** Column-direction alias of View. */
+export declare const Column: UniversalComponent<ViewProps>
+export declare const Row: UniversalComponent<RowProps>
+export declare const Grid: UniversalComponent<GridProps>
+export declare const Stack: UniversalComponent<StackProps>
+export declare const Absolute: UniversalComponent<AbsoluteProps>
+export declare const Spacer: UniversalComponent<SpacerProps>
+export declare const Text: UniversalComponent<TextProps>
+export declare const RichText: UniversalComponent<RichTextProps>
+export declare const RichTextSpan: UniversalComponent<RichTextSpanProps>
+export declare const Pressable: UniversalComponent<PressableProps>
+export declare const Link: UniversalComponent<LinkProps>
+export declare const NavLink: UniversalComponent<NavLinkProps>
+export declare const TextInput: UniversalComponent<TextInputProps>
+export declare const TextArea: UniversalComponent<TextAreaProps>
+export declare const SearchInput: UniversalComponent<SearchInputProps>
+export declare const ScrollBox: UniversalComponent<ScrollBoxProps>
+export declare const ScrollView: UniversalComponent<ScrollViewProps>
+export declare const Pager: UniversalComponent<PagerProps>
+export declare const Image: UniversalComponent<ImageProps>
+export declare const WebView: UniversalComponent<WebViewProps>
+export declare const Video: UniversalComponent<VideoProps>
+export declare const CameraView: UniversalComponent<CameraViewProps>
+export declare const Screen: UniversalComponent<ScreenProps>
+export declare const SafeArea: UniversalComponent<SafeAreaProps>
+export declare const KeyboardAvoiding: UniversalComponent<KeyboardAvoidingProps>
+export declare const Drawer: UniversalComponent<DrawerProps>
+export declare const Switch: UniversalComponent<SwitchProps>
+export declare const SegmentedControl: UniversalComponent<SegmentedControlProps>
+export declare const ActivityIndicator: UniversalComponent<ActivityIndicatorProps>
+export declare const Meter: UniversalComponent<MeterProps>
+export declare const Slider: UniversalComponent<SliderProps>
+export declare const Icon: UniversalComponent<IconProps>
+export declare const Heading: UniversalComponent<HeadingProps>
+
+export declare function registerIcon(name: string, glyph: IconGlyph): void
+export declare function registerIcons(record: Record<string, IconGlyph>): void
+
+// ---------- overlays / shells ----------
+
+export declare function openWindow(options?: OpenWindowOptions): any
+export declare const Overlay: UniversalComponent<OverlayProps>
+export declare const Popover: UniversalComponent<PopoverProps>
+export declare function showToast(content: ToastContent, options?: ToastOptions): void
+export declare const Tabs: UniversalComponent<TabsProps>
+
+// ---------- stacks (native registry; no-op on web) ----------
+
+export declare function registerStack(name: string, frame: any): void
+export declare function getStack(name: string): any
+export declare function stackEntries(): IterableIterator<[string, any]>
+
+// ---------- routes (real on both: URL store on web, Frame stacks on native) ----------
+
+export declare function pushRoute(r: Route): void
+export declare function popRoute(stack?: string): void
+export declare function routeStacks(): string[]
+export declare function routeFor(stack: string): Route | null
+export declare function currentRoute(): Route | null
+export declare function canGoBack(stack?: string): boolean
+export declare function useCanGoBack(stack?: string): boolean
+export declare function redirect(route: Route): never
+export declare function useRoute(stack: string): Route | null
+/** name → screen table; native pushRoute resolves `route.name` through
+ *  it, web outlets fall back to it via `screenFor`. `manifest` (from
+ *  deriveRouteManifest) enables path-param URL matching on web. Call
+ *  once at boot. */
+export declare function registerScreens(table: ScreenTable, manifest?: RouteMeta[]): void
+/** One-call registration for route-dir apps — screens + URL patterns +
+ *  layouts all come from deriveRouteManifest. */
+export declare function registerRoutes(manifest: RouteManifest): void
+export declare function screenFor(name: string): any
+/** Canonical /<stack>/<path> for a Route — Link's href on web. */
+export declare function hrefFor(r: Route): string
+
+// ---------- route dir (file → route manifest; docs/navigation-notes.md) ----------
+
+/** Turn an `import.meta.glob` module map of the route dir into
+ *  {screens, routes, layouts}: `demo/[id].tsrx` → 'demo/:id',
+ *  `_layout.tsrx` → layouts[''], platform suffixes deduped by `prefer`
+ *  rank (web: ['web']; native: ['ios'|'android','native']). */
+export declare function deriveRouteManifest(
+	files: Record<string, any>,
+	prefer: readonly string[],
+	dir?: string,
+): RouteManifest
+
+// ---------- animation / theme ----------
+
+export declare function useAnimation(initial?: number, prop?: string): AnimatedValue
+export declare function useMeasure(options?: UseMeasureOptions): MeasureResult
+export declare function getColorScheme(): ColorScheme
+export declare function useColorScheme(): ColorScheme
+export interface SafeAreaInsets {
+	top: number
+	right: number
+	bottom: number
+	left: number
+}
+
+export declare function useSafeAreaInsets(): SafeAreaInsets
+
+// ---------- styled ----------
+
+export declare function styled<P extends { className?: any }, V extends Record<string, any>>(
+	Base: (props: P) => any,
+	def: { base?: any; variants?: V },
+): UniversalComponent<P & { [K in keyof V]?: boolean }>
+
+// ---------- stores ----------
+
+export declare function createStore<T>(initial: T): Store<T>
+export declare function useStore<T>(store: ReadableStore<T>): T
+export declare function useStore<T, S>(store: ReadableStore<T>, select: (state: T) => S): S