lecodes-cli 0.8.2 → 0.9.1

package/runtime/sdk/ui/UIVirtualizedList.ts

@@ -1,6 +1,7 @@
-import { Element, type DrawableStyle, type ElementStyle, type OnLayoutCallback, type BoundingClientRect, type PaddingStyle, type Style, type UINodeChild } from "./UINode"
+import { Element, type Color, type DrawableStyle, type ElementStyle, type OnLayoutCallback, type BoundingClientRect, type PaddingStyle, type Style, type UINodeChild } from "./UINode"
 
-export type UIVirtualizedListStyle = DrawableStyle & ElementStyle
+// refreshControlColor tints the native pull-to-refresh spinner (pairs with onRefresh).
+export type UIVirtualizedListStyle = DrawableStyle & ElementStyle & { refreshControlColor?: Color }
 
 export interface VListConfig<T> {
     /** Стабильный уникальный ключ айтема */
@@ -40,6 +41,9 @@ export interface UIVirtualizedList<T = unknown> {
     scrollToEnd(animated?: boolean): void
 
     onScroll(callback: (scrollPosition: number) => void): this
+    /** Pull-to-refresh: спиннер держится, пока не разрешится промис. Навесить ДО маунта
+     *  (нативка читает при создании ноды). Только native-хосты; на вебе no-op. */
+    onRefresh(callback: () => void | Promise<void>): this
     /** Порог в px от нижнего края контента. Срабатывает один раз до ухода от края (защёлка в нативке) */
     onEndReached(thresholdPx: number, callback: () => void): this
     /** Порог от верхнего края — подгрузка истории в чате */
@@ -76,7 +80,10 @@ export class VListElement<T> extends Element<"vlist"> implements UIVirtualizedLi
     private estimate: (item: T) => number
 
     constructor(config: VListConfig<T>) {
-        super("vlist", {})
+        // flexShrink: 1 default (SDK-owned, same as UIScrollable): an explicit height/flexBasis
+        // larger than the available space shrinks to fit instead of overflowing. The vlist's own
+        // yoga basis is 0 (items live in detached roots), so this is inert until a size is set.
+        super("vlist", { flexShrink: 1 })
         this.keyOf = config.keyOf
         this.renderItem = config.render
         this.estimate = typeof config.estimatedHeight === "function"
@@ -191,6 +198,12 @@ export class VListElement<T> extends Element<"vlist"> implements UIVirtualizedLi
         this.sl.push(callback)
         return this
     }
+    // Читается нативкой при маунте (тот же контракт, что у UIScrollable).
+    declare _refreshCallback: any
+    onRefresh(callback: () => void | Promise<void>): this {
+        this._refreshCallback = callback
+        return this
+    }
     onEndReached(thresholdPx: number, callback: () => void): this {
         this._endThreshold = thresholdPx
         this.erl.push(callback)

package/runtime/sdk/ui/UIWidget.ts

@@ -20,7 +20,10 @@ export interface UIWidget {
    * Attach this widget to a destination (a `Scene`, a `UIScreen`, …): the widget lives on that
    * page's layer — it shows/hides with the page and rides its transition, and a screen pushed
    * on top covers it (a scene HUD behaves like part of the scene). Sticky until `attachTo(null)`
-   * (= back to a global overlay). Set it while the widget is hidden.
+   * (= back to a global overlay). Set it while the widget is hidden. The widget is always its own
+   * overlay root mounted into the owner's page view — it never becomes a child of the owner, so it
+   * stays topmost and its updates never trigger the owner's relayout. Works with a `UIScreen` that
+   * is a page inside a `UIPager`: the widget mounts into that tab and rides its swipe.
    */
   attachTo(owner: Presentable | null): this,
 
@@ -66,7 +69,10 @@ export class WidgetElement extends ContainerElement<"widget"> {
     return this
   }
   show(): void {
-    // Global overlay unless explicitly attached via attachTo(owner).
+    // A widget is always its OWN overlay root (a separate Yoga tree mounted above the owner's
+    // content) — never a child of the owner, so it stays topmost, its updates never relayout the
+    // owner, and it doesn't pollute the owner's children. `attachTo(owner)` just tells the host
+    // which page view to mount that root into; ownerless widgets are global overlays.
     if (this._owner && _navSupported()) {
       _creatorUI.showWidget(this, _descOf(this._owner))
     } else {

package/runtime/sdk/ui/presentable.ts

@@ -49,7 +49,8 @@ export type Transition = TransitionName | TransitionSpec
 
 export type PresentOptions = {
   /** Transition to play while this destination replaces the current one (default "none" for a
-   *  direct open(); the Router applies its own defaults — push/fade/pop). */
+   *  direct open(); the Router applies its own defaults — push/pop, and the theme's
+   *  `replaceTransition` for replace). */
   transition?: Transition
 }
 

package/runtime/sdk/ui/router.ts

@@ -1,11 +1,13 @@
 import { _bumpNavEpoch, _descOf, _navSupported, _setCurrent, Presentable, type Transition } from "./presentable"
+import { _navDefaults } from "./theme"
 
 type RouterOptions = {
   showDefaultBackButton?: boolean
 }
 
 type NavigateOptions = {
-  /** Transition to play. Defaults: `"push"` for push, `"fade"` for replace, `"pop"` for pop. */
+  /** Transition to play. Defaults: `"push"` for push, `"pop"` for pop; replace follows the
+   *  theme's `replaceTransition` (`"none"` out of the box). */
   transition?: Transition
 }
 
@@ -74,7 +76,7 @@ export const Router: Router = /*#__PURE__*/ Object.freeze({
     const desc = wireDesc(page)
     const go = () => {
       _bumpNavEpoch()
-      _creatorUI.routerReplace(desc, opts?.transition ?? "fade")
+      _creatorUI.routerReplace(desc, opts?.transition ?? _navDefaults.replace)
       _setCurrent(page)   // optimistic — host onChange confirms (async on native hosts)
     }
     const prep = page._prepare?.()

package/runtime/sdk/ui/theme.ts

@@ -20,30 +20,57 @@
 // numbers are LENGTHS (px). `null` removes a key (comfort knobs reset to their defaults:
 // 12 vertical, 16 horizontal — the page gutter). Env names (safe-*, vw/vh/vmin/vmax) are
 // host-owned facts, never theme keys — they're skipped with a warning.
+//
+// One key is not a style var: `replaceTransition` — the app-wide default for
+// `Router.replace` (any Transition, name or custom spec; `null` resets to "none"). The
+// router resolves it in the SDK, so it's consumed here and never sent to the host table.
+
+import type { Transition } from "./presentable"
 
 export type ThemeValues = Record<string, string | number | null>
 
-export type ThemeAccessors<T extends ThemeValues> = {
+/** @internal Navigation defaults the theme owns; the router reads them at call time.
+ *  (SDK-side state, deliberately NOT in the host var table — `var(--replaceTransition)`
+ *  is not a style value.) */
+export const _navDefaults: { replace: Transition } = { replace: "none" }
+
+// (Unconstrained: it also maps inputs whose `replaceTransition` key was carved out.)
+export type ThemeAccessors<T> = {
   readonly [K in keyof T]: K extends string ? `var(--${K})` : never
 }
 
 const RESERVED = ["safe-top", "safe-bottom", "safe-left", "safe-right", "vw", "vh", "vmin", "vmax"]
 
-const setTheme = <T extends ThemeValues>(values: T): ThemeAccessors<T> => {
+/** Merge app theme variables and get typed `var(--key)` accessors back. Strings/numbers are
+ *  style values (numbers = px); `null` removes a key. One special key: `replaceTransition` —
+ *  the app-wide default transition for `Router.replace` (any transition name or custom spec;
+ *  out of the box `"none"`). */
+const setTheme = <T extends Record<string, string | number | Transition | null>>(
+  // Only `replaceTransition` may carry a Transition — every other key is a style value.
+  values: T & { [K in Exclude<keyof T, "replaceTransition">]: string | number | null }
+): ThemeAccessors<Omit<T, "replaceTransition">> => {
   const accessors: Record<string, string> = {}
-  let send: ThemeValues = values
+  let send = values as ThemeValues
+  const strip = (key: string) => {
+    if (send === values) send = { ...values } as ThemeValues
+    delete send[key]
+  }
   for (const key of Object.keys(values)) {
+    if (key === "replaceTransition") {
+      _navDefaults.replace = (values[key] ?? "none") as Transition
+      strip(key)   // SDK-consumed, no accessor: it isn't a style var
+      continue
+    }
     if (RESERVED.includes(key)) {
       console.warn(`theme(): "${key}" is an environment value (host-owned) — ignored`)
-      if (send === values) send = { ...values }
-      delete send[key]
+      strip(key)
       continue
     }
     accessors[key] = `var(--${key})`
   }
   // Optional during rollout: hosts without the method simply don't theme (values still type).
-  _creatorUI.setTheme?.(send)
-  return accessors as ThemeAccessors<T>
+  if (Object.keys(send).length > 0) _creatorUI.setTheme?.(send)
+  return accessors as ThemeAccessors<Omit<T, "replaceTransition">>
 }
 
 export const theme = Object.assign(setTheme, {