lecodes-sdk 2.2.3 → 2.2.5

package/dist/types/ui/UIWidget.d.ts

@@ -1,5 +1,6 @@
 import { TouchStartEvent } from "../runtime/touch";
 import { ContainerElement, type BaseStyle, type Color, type ContainerStyle, type DrawableStyle, type PaddingStyle, type PositionStyle, type UIChildArg, type UIContainerBase, type UINodeChild, type ChildrenFn } from "./UINode";
+import type { Presentable } from "./presentable";
 export type UIWidgetStyle = ContainerStyle & DrawableStyle & PaddingStyle & BaseStyle & PositionStyle & {
     /** Shown (`"flex"`, the default) or not: what `show()` / `hide()` write, what a state block may
      *  flip (`$open: { display: "flex" }`). */
@@ -8,13 +9,13 @@ export type UIWidgetStyle = ContainerStyle & DrawableStyle & PaddingStyle & Base
      *  removes the layer. A tap on it fires `onOverlayTap`. */
     overlayColor?: Color | null;
 };
-/** A floating overlay that belongs to a WINDOW, not to a box (docs/plans/widgets-plan.md): a dialog,
- *  a sheet, a HUD, a mini-player. A widget is a CHILD of the place it belongs to — a `UIScreen`
- *  (among its children), a surface's content (`scene.setContent([hud])`) or the app layer
- *  (`UIOverlay`) — and is laid out and painted in the box of the outermost presented destination
- *  that contains it: absolutely positioned in that box, above everything else in it. A widget on a
- *  tab page covers the tab bar and rides the shell's push and pop. A widget inside a `UIColumn` or
- *  any other box is an error: a floating element of a box is an absolute child, not a widget.
+/** A floating overlay that belongs to a DESTINATION, not to a box (docs/plans/widgets-plan.md): a
+ *  dialog, a sheet, a HUD, a mini-player. A widget is one of the `widgets` of the place it belongs
+ *  to — `UIScreen(content).widgets(dialog)`, `scene.widgets(hud)` — and is laid out and painted in
+ *  the box of the outermost presented destination that contains it: absolutely positioned in that
+ *  box, above everything else in it. A widget on a tab page covers the tab bar and rides the
+ *  shell's push and pop. A widget among the children of a box is an error: a floating element of
+ *  a box is an absolute child, not a widget.
  *
  *  It shows with its place unless its style says `display: "none"`; `show()` / `hide()` flip that,
  *  and so does a state block (`$class: { display: "flex" }`). `UIModal` / `UIPopover` /
@@ -23,18 +24,24 @@ export interface UIWidget extends UIContainerBase<UIWidgetStyle, DrawableStyle &
     overlayColor?: Color | null;
 }> {
     readonly type: "widget";
-    /** Show the widget: `display: "flex"`, on top of its root — it moves to the end of its parent's
-     *  children, so a dialog opened later covers an earlier one and a HUD declared after it. A widget
-     *  with no parent is appended to the app layer first (`UIOverlay`) — a global overlay above every
-     *  destination, up until `hide()`. */
+    /** Show the widget: `display: "flex"`, on top of its root — it moves to the end of its
+     *  destination's widgets, so a dialog opened later covers an earlier one and a HUD declared after
+     *  it. A widget that belongs nowhere goes ABOVE EVERY destination — a global loader, a dialog
+     *  opened from anywhere — and stays there, hidden by `hide()`, until it is given a place. */
     show(): void;
-    /** Hide the widget: `display: "none"`. It stays where it is (its place, the app layer), ready
-     *  for the next `show()`. */
+    /** Hide the widget: `display: "none"`. It stays where it is, ready for the next `show()`. */
     hide(): void;
     /** Shown right now by its own display (`show()` ran, `hide()` hasn't, no state block hides
      *  it). True for a widget hidden WITH its page or its covered screen: that is its place's
      *  visibility, not the widget's. */
     readonly isShown: boolean;
+    /** @deprecated A widget is one of the `widgets` of the place it belongs to (2026-10-07): write
+     *  `UIScreen(content).widgets(widget)` / `scene.widgets(widget)` instead. This alias is
+     *  `owner.widgets.append(widget)` with the widget hidden, so the `show()` that follows flips it as
+     *  on any placed widget; `attachTo(null)` takes it out, and the next `show()` puts it above every
+     *  destination. For the projects compiled before the change; removed with the release that
+     *  recompiles them. */
+    attachTo(owner: Presentable | null): this;
     /** 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`). */
@@ -51,6 +58,8 @@ export declare class WidgetElement extends ContainerElement<"widget"> {
     show(): void;
     hide(): void;
     get isShown(): boolean;
+    /** @deprecated see the interface */
+    attachTo(owner: Presentable | null): this;
     readonly touchStartListeners: any[];
     onTouchStart(callback: any): this;
     readonly otl: (() => void)[];
@@ -60,8 +69,8 @@ export declare class WidgetElement extends ContainerElement<"widget"> {
     /** @deprecated see the interface */
     onBackPressed(callback: any): this;
 }
-/** Create a widget (same argument forms as `UIColumn`). Put it where it belongs — among a screen's
- *  children, in `scene.setContent([...])`, or `UIOverlay` — position it with absolute-style props
+/** Create a widget (same argument forms as `UIColumn`). Give it to the destination it belongs to —
+ *  `UIScreen(content).widgets(w)`, `scene.widgets(w)` — position it with absolute-style props
  *  (`top`/`left`/`bottom`/`right`), then `show()`/`hide()`. */
 export declare function UIWidget(...children: UIChildArg[]): UIWidget;
 export declare function UIWidget(children: UINodeChild[] | ChildrenFn): UIWidget;

package/dist/types/ui/presentable.d.ts

@@ -1,5 +1,5 @@
 import type { EasingInput } from "../animate/tween/easing";
-import type { UIWidget } from "./UIWidget";
+import type { WidgetSet } from "./UILayer";
 /** The built-in transitions (ui/transitions.ts holds what each one is). `push` / `pop` are the
  *  stacked-navigation pair — the incoming screen slides over the other one, which drifts and dims;
  *  the rest are two-screen moves. */
@@ -74,12 +74,12 @@ export interface Presentable {
     onOpen(callback: () => void): this;
     onClose(callback: () => void): this;
     onBack(callback: () => void): this;
-    /** The destination's widgets (docs/plans/widgets-plan.md): a dialog, a HUD, a sheet declared as
-     *  CONTENT of the place they belong to. A `UIScreen` takes them among its children; a surface — a
-     *  `Scene`, a `Scene2D`, a `NativeView`, a `UIVideo` — takes widgets alone, laid out over it while
-     *  it is presented (touches outside a widget's box reach the surface). A widget shows with its
-     *  destination unless its style says `display: "none"`; `show()` / `hide()` flip that. */
-    setContent(content: (UIWidget | null | undefined | false)[] | (() => (UIWidget | null | undefined | false)[])): this;
+    /** The destination's widgets (docs/plans/widgets-plan.md): a dialog, a HUD, a sheet — what floats
+     *  over it. `x.widgets(a, b)` sets them, `x.widgets.append` / `.remove` manage them, `x.widgets.list`
+     *  reads them; the same on a `UIScreen` (apart from its `children`), a `Scene`, a `Scene2D`, a
+     *  `NativeView`, a `UIVideo`. A widget shows with its destination unless its style says
+     *  `display: "none"`; `show()` / `hide()` flip that. */
+    readonly widgets: WidgetSet<this>;
 }
 /** Runtime companion of the `Presentable` interface (declaration merging): the navigation
  *  state that isn't tied to the Router. */

package/dist/types/version.d.ts

@@ -1,4 +1,4 @@
-export declare const SDK_VERSION = "2.2.3";
+export declare const SDK_VERSION = "2.2.5";
 /** The major of a semver string, or null when it is not one. */
 export declare const sdkMajor: (version: string | null | undefined) => number | null;
 /** The `// sdk: <version>` line of a compiled bundle's header (sdk/src/compile/header.ts), read from