lecodes-cli 0.11.0 → 0.12.0

package/runtime/sdk/ui/UIVideo.ts

@@ -1,34 +1,27 @@
 import type { VideoPlayer } from "../runtime/media"
 import { _bumpNavEpoch, _navSupported, _setCurrent, Presentable, type PresentOptions } from "./presentable"
-import { Element, type AnimateStyle, type AppearStyle, type BaseStyle, type DisappearStyle, type DrawableStyle, type ElementStyle, type OnLayoutCallback, type BoundingClientRect, type Classes, type Style, type StyleFn } from "./UINode"
+import { Element, type BaseStyle, type DrawableStyle, type ElementStyle, type UIElementBase } from "./UINode"
 
 export type UIVideoStyle = ElementStyle & DrawableStyle & { objectFit?: "cover" | "contain" | "fill" }
 
 /** A video surface showing a `VideoPlayer`'s output — embeddable in a screen AND
  *  fullscreen-presentable (`open()`), with seamless promotion between the two. */
-export interface UIVideo {
+export interface UIVideo extends UIElementBase<UIVideoStyle, DrawableStyle & BaseStyle> {
   readonly type: "video",
   /** The player driving this surface (playback control lives on it). */
   player: VideoPlayer
-  style: Style<this, UIVideoStyle>
-  animateTo: AnimateStyle<this, DrawableStyle & BaseStyle>
-  animateFrom: AnimateStyle<this, DrawableStyle & BaseStyle>
 
   /** Show fullscreen as the current destination. Promotion: if this video is mounted in a screen,
    *  the SAME native player moves fullscreen — playback uninterrupted; a pop moves it back. */
   open(options?: PresentOptions): void
+  /** Dismiss if this is the visible destination. */
   close(): void
+  /** Became the visible destination. */
   onOpen(callback: () => void): this
+  /** Stopped being the visible destination. */
   onClose(callback: () => void): this
+  /** Hardware/system back while current. */
   onBackPressed(callback: () => void): this
-
-  onLayout(onLayout: OnLayoutCallback): this
-  getBoundingClientRect(): BoundingClientRect | null
-
-  /** Style-class proxy — read `el.class.checked`, set `el.class.checked = true`, toggle with
-   *  `!el.class.checked`, bind `el.class.done = () => sig.value`, batch/chain `el.class({ … })`.
-   *  Classes cascade to descendants. See {@link Classes}. */
-  readonly class: Classes<this>
 }
 
 class VideoElement extends Element<"video"> implements Presentable {

package/runtime/sdk/ui/UIVirtualizedList.ts

@@ -1,4 +1,4 @@
-import { Element, type Color, type DrawableStyle, type ElementStyle, type OnLayoutCallback, type BoundingClientRect, type PaddingStyle, type Classes, type Style, type UINodeChild } from "./UINode"
+import { Element, type Color, type DrawableStyle, type ElementStyle, type UIElementBase, type UINodeChild } from "./UINode"
 
 export type UIVirtualizedListStyle = DrawableStyle & ElementStyle & {
   /** Tint of the native pull-to-refresh spinner (pairs with `onRefresh`). */
@@ -27,27 +27,34 @@ export interface VListConfig<T> {
 
 /** A windowed (virtualized) list: only the items near the viewport are mounted — for long feeds
  *  and chats. Items are keyed; feed it via `setData`/`append`/`prepend`. */
-export interface UIVirtualizedList<T = unknown> {
+export interface UIVirtualizedList<T = unknown> extends UIElementBase<UIVirtualizedListStyle> {
     readonly type: "vlist"
-    style: Style<this, UIVirtualizedListStyle>
 
     /** Replace the data wholesale — vanished keys are unmounted by the host's window sync. */
     setData(items: T[]): this
+    /** Append items to the end (auto-scrolls when `inverted` and resting at the bottom). */
     append(...items: T[]): this
     /** Insert at the start WITHOUT a scroll jump (the host compensates the offset). */
     prepend(...items: T[]): this
     /** Update items with the same keys: mounted ones re-render; the cached height persists until
      *  re-measured. */
     update(...items: T[]): this
+    /** Remove items by key. */
     removeByKey(...keys: string[]): this
 
+    /** Number of data items (mounted or not). */
     readonly itemCount: number
+    /** The data item under `key`, if any. */
     getItem(key: string): T | undefined
 
+    /** Scroll to `offset` px. */
     scrollTo(offset: number, animated?: boolean): void
+    /** Scroll to the item with `key`. */
     scrollToKey(key: string, animated?: boolean): void
+    /** Scroll to the end of the content. */
     scrollToEnd(animated?: boolean): void
 
+    /** Scroll position changed (px from the start edge). */
     onScroll(callback: (scrollPosition: number) => void): this
     /** Pull-to-refresh: the spinner stays until the returned promise settles. Attach BEFORE the
      *  node mounts (hosts read it at creation). Native hosts only — no-op on web. */
@@ -57,13 +64,6 @@ export interface UIVirtualizedList<T = unknown> {
     onEndReached(thresholdPx: number, callback: () => void): this
     /** Same, for the top edge — chat history loading. */
     onStartReached(thresholdPx: number, callback: () => void): this
-    onLayout(onLayout: OnLayoutCallback): this
-    getBoundingClientRect(): BoundingClientRect | null
-
-    /** Style-class proxy — read `el.class.checked`, set `el.class.checked = true`, toggle with
-     *  `!el.class.checked`, bind `el.class.done = () => sig.value`, batch/chain `el.class({ … })`.
-     *  Classes cascade to descendants. See {@link Classes}. */
-    readonly class: Classes<this>
 }
 
 export class VListElement<T> extends Element<"vlist"> implements UIVirtualizedList<T> {

package/runtime/sdk/ui/UIWidget.ts

@@ -1,6 +1,6 @@
 import { TouchStartEvent } from "../runtime/touch"
 import { _descOf, _navSupported, Presentable } from "./presentable"
-import { ContainerElement, buildUI, type AnimateStyle, type BaseStyle, type Color, type ContainerStyle, type DrawableStyle, type OnLayoutCallback, type BoundingClientRect, type PaddingStyle, type PositionStyle, type Classes, type Style, type UIChildArg, type UINodeChild, type ChildrenFn } from "./UINode"
+import { ContainerElement, buildUI, type BaseStyle, type Color, type ContainerStyle, type DrawableStyle, type PaddingStyle, type PositionStyle, type UIChildArg, type UIContainerBase, type UINodeChild, type ChildrenFn } from "./UINode"
 
 
 export type UIWidgetStyle = ContainerStyle & DrawableStyle & PaddingStyle & BaseStyle & PositionStyle & {
@@ -13,11 +13,8 @@ export type UIWidgetStyle = ContainerStyle & DrawableStyle & PaddingStyle & Base
 /** A floating overlay — absolutely positioned in device coordinates, mounted above the page as
  *  its own layout root (never a child of what's underneath). The base of dialogs, toasts,
  *  mini-players and scene HUDs; `UIModal`/`UIPopover`/`UIBottomSheet` build on it. */
-export interface UIWidget {
+export interface UIWidget extends UIContainerBase<UIWidgetStyle, DrawableStyle & BaseStyle & { overlayColor?: Color | null }> {
   readonly type: "widget",
-  style: Style<this, UIWidgetStyle>,
-  animateTo: AnimateStyle<this, DrawableStyle & BaseStyle & { overlayColor?: Color | null }>
-  animateFrom: AnimateStyle<this, DrawableStyle & BaseStyle & { overlayColor?: Color | null }>
 
   /**
    * Attach this widget to a destination (a `Scene`, a `UIScreen`, …): the widget lives on that
@@ -42,25 +39,12 @@ export interface UIWidget {
   /** Mounted right now (`show()` ran, `hide()` hasn't). */
   readonly isShow: boolean,
 
-  append(...nodes: UINodeChild[]): UIWidget
-  insert(index: number, ...nodes: UINodeChild[]): UIWidget
-  remove(...nodes: UINodeChild[]): UIWidget
-  setContent(nodes: UINodeChild[] | ChildrenFn): this
-  
-  readonly children: UINodeChild[],
-
-  onLayout(onLayout: OnLayoutCallback): this
-  getBoundingClientRect(): BoundingClientRect | null
+  /** Touch began on the widget; `ev.track(...)` takes over the rest of the gesture. */
   onTouchStart(callback: (ev: TouchStartEvent<UIWidget>) => void): this,
   /** Tap on the overlay layer (requires an `overlayColor`). */
   onOverlayTap(callback: () => void): this,
   /** Hardware/system back while the widget is shown. */
   onBackPressed(callback: () => void): this
-
-  /** Style-class proxy — read `el.class.checked`, set `el.class.checked = true`, toggle with
-   *  `!el.class.checked`, bind `el.class.done = () => sig.value`, batch/chain `el.class({ … })`.
-   *  Classes cascade to descendants. See {@link Classes}. */
-  readonly class: Classes<this>
 }