lecodes-sdk 2.5.0 → 2.6.0

package/dist/types/gl/Foliage.d.ts

@@ -41,6 +41,12 @@ export type FoliageOptions = {
     /** Coverage held over distance: the cards' alpha × (1 + coverage × mip level), so a far crown does not thin out as its
      *  atlas mips away. Default 0.25, 0 = none; past ~0.5 a crown turns into a solid mass. */
     coverage?: number;
+    /** 0..1: THE SKY THROUGH A THIN LEAF. A crown's cards are lit by the sky on their hull normal (out of the crown's centre),
+     *  so a card below the crown's middle faces DOWN and reads the sky's lower hemisphere — the ground of the environment
+     *  map, which under an overcast sky is a tenth of the zenith: the lower half of every plant went black (2026-11-04). A
+     *  leaf is thin: this share of the sky on the OTHER side of the card is added, so the underside of a crown takes this
+     *  fraction of what its top takes. Default 0.3, 0 = the hull alone. */
+    skyThrough?: number;
     /** THE PLANTS' CASTER DISTANCE, metres: a plant casts the sun's shadow only this close to the camera (the LOD pass takes
      *  the farther ones out of the shadow map; 3 m of hysteresis). Meant for a level with a BAKED ground, which keeps the
      *  far shadows while the shadow map holds a fraction of the casters (the Forest's Radeon frame: 6 ms of 39 at 25 m).

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

@@ -1,4 +1,4 @@
-import { ModalElement, type UIModalStyle } from "./UIModal";
+import { ModalElement, type UIModalShow, type UIModalStyle } from "./UIModal";
 import type { UIWidget } from "./UIWidget";
 import { type ChildrenFn, type UIChildArg, type UINodeChild } from "./UINode";
 export type UIBottomSheetStyle = UIModalStyle;
@@ -10,14 +10,18 @@ export type UIBottomSheetStyle = UIModalStyle;
  * node type — docs/bottom-sheet-plan.md): hosts without sheet support show a static bottom panel.
  *
  * With detents, content lays out at the HIGHEST detent's size; lower detents show the top
- * slice. The scrim, `onOpen`/`onClose`, back-button and scrim-tap dismissal all come from the
- * modal machinery.
+ * slice. The scrim, `bindShow` / `onDismiss`, `onOpen` / `onClose` all come from the modal
+ * machinery; the drag below the lowest detent is the sheet's third dismissal gesture, routed like
+ * the scrim tap. The host hears whether a drag may dismiss (`sheetDismissible`):
+ * `dismissible(false)`, or a bound sheet with no `onDismiss`, resists instead.
  *
  * ```ts
- * const actions = UIBottomSheet(rows).style({ bgColor: "#1c1c1e", borderRadius: 16 })   // content-sized
+ * const actions = UIBottomSheet(rows).style({ bgColor: "#1c1c1e", borderRadius: 16 })   // content-sized, show()
+ *
+ * const card = UIBottomSheet(place).bindShow(() => data.value.pick != null).onDismiss(on.unpick)   // the data's
  *
  * const mapSheet = UIBottomSheet(results).style({ bgColor: "#1c1c1e", borderRadius: 16 })
- *   .detents([0.3, 0.6, 1])
+ *   .detents([0.3, 0.6, 1]).dismissible(false)                                            // persistent: show() once placed
  *   .onDetent(i => map.setPadding(...))
  * ```
  */
@@ -32,15 +36,20 @@ export interface UIBottomSheet extends UIWidget {
     readonly detent: number;
     /** Fires on every settle: a finger snap on native hosts, or a `setDetent()` call. */
     onDetent(callback: (index: number) => void): this;
-    /** Mount and slide in to the current detent. No-op while already open. */
+    /** Bind the shown state, as on `UIModal`: a function of the data (`bindShow(() =>
+     *  data.value.pick != null)`) or a signal. */
+    bindShow(value: UIModalShow): this;
+    /** Slide in to the current detent. No-op while already shown. Bound: as on `UIModal`. */
     show(): void;
-    /** Slide out, fade the scrim, then unmount. No-op while closed. */
+    /** Slide out, fade the scrim. No-op while hidden. */
     hide(): void;
-    /** True from `show()` until `hide()` starts. */
-    readonly isOpen: boolean;
-    /** Called when `show()` mounts the sheet. */
+    /** The user asked to close — a scrim tap, the back press, a drag below the lowest detent. The
+     *  one hook for all three; a bound sheet needs it to be dismissible at all (it resists the drag
+     *  otherwise). When the callback leaves the sheet open, it slides back to its detent. */
+    onDismiss(callback: () => void): this;
+    /** Called when the sheet opens. */
     onOpen(callback: () => void): this;
-    /** Called when the sheet starts closing — scrim tap, back button, drag-dismiss, or `hide()`. */
+    /** Called when the sheet starts closing — a dismissal, `hide()`, the data. */
     onClose(callback: () => void): this;
     /** `dismissible(false)`: scrim taps, the back button and dragging below the lowest detent no
      *  longer close the sheet (a drag collapses to the lowest detent instead). Default `true`. */
@@ -51,13 +60,11 @@ export declare class BottomSheetElement extends ModalElement {
     _detent: number;
     readonly _detentListeners: ((index: number) => void)[];
     constructor(style: UIBottomSheetStyle, children: UINodeChild[] | ChildrenFn);
+    _syncDismissible(): void;
     detents(list: number[]): this;
     get detent(): number;
     setDetent(index: number): void;
     onDetent(callback: (index: number) => void): this;
-    show(): void;
-    hide(): void;
-    dismissible(enabled: boolean): this;
 }
 /** Create a bottom sheet (see {@link UIBottomSheet}) — content-sized by default; call
  *  `.detents([...])` for snap positions. Same argument forms as `UIColumn`. */

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

@@ -1,5 +1,6 @@
 import { type UIWidget, type UIWidgetStyle, WidgetElement } from "./UIWidget";
 import { type BaseStyle, type ChildrenFn, type Color, type DrawableStyle, type UIChildArg, type UINodeChild } from "./UINode";
+import { type Signal } from "../core/signals";
 export type UIModalStyle = UIWidgetStyle;
 /**
  * The modal's hidden pose: `show()` animates from it, `hide()` animates to it. `duration` (ms)
@@ -9,25 +10,45 @@ export type UIModalTransition = DrawableStyle & BaseStyle & {
     overlayColor?: Color | null;
     duration?: number;
 };
+/** What `bindShow()` takes: a function of the data, or a signal the modal also writes (`false` on
+ *  a dismissal, `show()` / `hide()` set it). */
+export type UIModalShow = (() => boolean) | Signal<boolean>;
 /**
  * A dialog: a `UIWidget` with the modal boilerplate built in. Comes with a scrim
- * (`overlayColor: "rgba(0, 0, 0, 0.5)"` unless overridden), animates on `show()`/`hide()` and on
- * a state block flipping its `display` (a 200 ms fade by default — swap the pose via
- * `transition()`; the runtime plays it as tracks that never touch the style), and closes itself
- * on a scrim tap or the Android back button (disable via `dismissible(false)`). Everything else
- * is a plain widget: declare it where it belongs — among its screen's children, hidden until a
- * tap (`display: "none"`), or shown with `show()` from anywhere, which puts a parentless modal in
- * the app layer. A dialog bound to data (its display from a binding) is declared
- * `dismissible(false)` and routes `onOverlayTap` / `onBack` into the data's dismiss, so the data
- * stays what the screen shows.
+ * (`overlayColor: "rgba(0, 0, 0, 0.5)"` unless overridden), is HIDDEN until shown, animates on
+ * every show / hide (a 200 ms fade by default — swap the pose via `transition()`; the runtime
+ * plays it as tracks that never touch the style).
+ *
+ * One state, shown or not, driven one of two ways:
+ * - `show()` / `hide()` from code — an action sheet opened by a button;
+ * - `bindShow(…)`: a function of the data (`bindShow(() => data.value.confirm)` — the data is the
+ *   truth, `show()` / `hide()` are refused) or a `Signal<boolean>` the modal reads AND writes.
+ *
+ * A dismissal — the scrim tap, the back press, a sheet dragged below its lowest detent — is ONE
+ * request, `onDismiss`. By default it hides an unbound modal and writes `false` into a bound
+ * signal; a bound function has nowhere to write, so a modal bound to one without `onDismiss`
+ * cannot be dismissed (a forced choice — the same as `dismissible(false)`). `display` is not a
+ * modal's switch: a `.style({ display })` on it throws (a bound display died on the first
+ * dismissal, which wrote a static `display: "none"` over the binding — the dialog never opened
+ * again).
  */
 export interface UIModal extends UIWidget {
-    /** Show and play the entrance transition. No-op while already open. */
+    /**
+     * Bind the shown state. A function: the modal follows the data, and `show()` / `hide()` are
+     * errors — flip the data (`onDismiss` is where a dismissal goes). A signal: read and written —
+     * a dismissal sets it `false`, `show()` / `hide()` set it.
+     *
+     * ```ts
+     * UIModal(...).bindShow(() => data.value.confirm).onDismiss(on.cancel)   // the data is the truth
+     * UIModal(...).bindShow(confirmOpen)                                       // a Signal<boolean>
+     * ```
+     */
+    bindShow(value: UIModalShow): this;
+    /** Show and play the entrance transition. No-op while already shown. Bound to a signal: writes
+     *  `true` into it; bound to a function: an error (flip the data). */
     show(): void;
-    /** Play the exit transition, then hide. No-op while closed or already closing. */
+    /** Play the exit transition, then hide. No-op while hidden. Bound: as `show()`. */
     hide(): void;
-    /** True from `show()` until `hide()` starts (already false during the exit animation). */
-    readonly isOpen: boolean;
     /**
      * Replace the show/hide animation. `hidden` is the off-screen pose — `show()` animates from
      * it, `hide()` animates to it. Default `{ opacity: 0, duration: 200 }` (a fade); the pose
@@ -39,13 +60,17 @@ export interface UIModal extends UIWidget {
      * ```
      */
     transition(hidden: UIModalTransition): this;
-    /** Called when the modal opens — `show()`, or a state block flipping its display. */
+    /** The user asked to close: a scrim tap, the back press, a sheet dragged below its lowest
+     *  detent. Replaces the default (hide, or `false` into the signal): the callback decides —
+     *  usually the action that flips the data the modal is bound to. */
+    onDismiss(callback: () => void): this;
+    /** Called when the modal is shown — whoever showed it. */
     onOpen(callback: () => void): this;
-    /** Called when the modal starts closing — scrim tap, back button, a `hide()` call, or a state
-     *  block flipping its display. */
+    /** Called when the modal starts hiding — whoever hid it. */
     onClose(callback: () => void): this;
-    /** `dismissible(false)` keeps scrim taps and the back button from closing the modal
-     *  (forced-choice dialogs, a dialog whose display is bound to data). Default `true`. */
+    /** `dismissible(false)`: the dismissal gestures are off — the scrim tap does nothing, the back
+     *  press is swallowed, a sheet resists below its lowest detent (a forced choice, the persistent
+     *  map sheet). Default `true`. */
     dismissible(enabled: boolean): this;
 }
 export declare class ModalElement extends WidgetElement {
@@ -53,20 +78,23 @@ export declare class ModalElement extends WidgetElement {
     _transition: UIModalTransition;
     readonly _openListeners: (() => void)[];
     readonly _closeListeners: (() => void)[];
+    readonly _dismissListeners: (() => void)[];
     private _poseObj?;
     private _poseKey;
     constructor(style: UIModalStyle, children: UINodeChild[] | ChildrenFn);
     private _pose;
     transition(hidden: UIModalTransition): this;
+    bindShow(value: UIModalShow): this;
     show(): void;
     hide(): void;
-    get isOpen(): boolean;
+    _setOpen(open: boolean): void;
+    onDismiss(callback: () => void): this;
     onOpen(callback: () => void): this;
     onClose(callback: () => void): this;
     dismissible(enabled: boolean): this;
 }
-/** Create a modal dialog (see {@link UIModal}): declare it among its screen's children with
- *  `display: "none"` and `show()` it from a tap, or `show()` a parentless one from anywhere.
- *  Same argument forms as `UIColumn`. */
+/** Create a modal dialog (see {@link UIModal}): give it to its screen (`.widgets(dialog)`) and
+ *  `show()` it from a tap, bind it to the data with `bindShow(() => …)`, or `show()` a parentless
+ *  one from anywhere. Same argument forms as `UIColumn`. */
 export declare function UIModal(...children: UIChildArg[]): UIModal;
 export declare function UIModal(children: UINodeChild[] | ChildrenFn): UIModal;

package/dist/types/version.d.ts

@@ -1,4 +1,4 @@
-export declare const SDK_VERSION = "2.5.0";
+export declare const SDK_VERSION = "2.6.0";
 /** 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