lecodes-sdk 2.0.2 → 2.0.3

package/package.json

@@ -42,7 +42,7 @@
     "typescript": "~5.8.3",
     "gl-matrix": "^3.4.4"
   },
-  "version": "2.0.2",
+  "version": "2.0.3",
   "files": [
     "src",
     "dist",

package/src/bridges/tree.d.ts

@@ -95,6 +95,10 @@ declare global {
     routerPop(index: i32, transition: i32): void
     routerHide(transition: i32): void
     routerRestore(transition: i32): void
+    // The ADDRESS of a destination (`UIScreen.url`): a route (`/product/42`) a host with an address
+    // bar shows while the destination is the one on screen; null takes it away. OPTIONAL: a host
+    // without an address bar has no such method (the SDK feature-detects) — Web Lite has it.
+    setDestUrl?(kind: u8, id: f64, url: string | null): void
     // Does the host registerView(name)? / the contract version its half was generated from (0 = no
     // such view; on a host that does not say, 1 for a view it has) / the NativeView method channel:
     // `args` is the array of the call's arguments, the callbacks settle exactly once through the

package/src/chisel.ts

@@ -128,7 +128,7 @@ export const chiselVocab: ChiselVocab = {
       "onScroll", "onScrollRelease", "onOverscroll", "onRefresh", "onSubmit",
       "onSelect", "onChange", "onFocus", "onBlur", "onOverlayTap", "onDetent",
       "onEndReached", "onStartReached",
-      "append", "insert", "remove", "setContent", "keepAlive",
+      "append", "insert", "remove", "setContent", "keepAlive", "url",
       "attachTo", "detents", "dismissible", "transition", "setSourceRect",
       "push", "pop", "popToRoot", "replace", "select",
       // UITabs / UIVirtualizedList / the native views (NativeView, CameraView, MapView, QRScanner)

package/src/ui/UIScreen.ts

@@ -37,6 +37,23 @@ export interface UIScreen extends UIContainerBase<UIScreenStyle, DrawableStyle &
    */
   keepAlive(enabled?: boolean): this
 
+  /**
+   * The screen's ADDRESS on the web: while the screen is the one shown, the browser's address
+   * bar shows it, and a link copied from there opens the app with it (`app.launchUrl`). A route,
+   * not a page's address: `"/product/42"`, `"/search?q=shoes"` — the app never sees where the
+   * page is served from. Call it again to change the address of a screen that is shown (a
+   * filter, a search): the entry of the browser's history is replaced, not added to. `null`
+   * takes the address away; a screen with none keeps the address of the one under it.
+   *
+   * The way in is the app's: read `app.launchUrl` at start and listen to the `"url"` event, as
+   * for a deep link on a phone. No-op on hosts without an address bar.
+   *
+   * ```ts
+   * const ProductScreen = (id: string) => UIScreen(...).url(`/product/${id}`)
+   * ```
+   */
+  url(route: string | null): this
+
   /** Touch began on the screen; `ev.track(...)` takes over the rest of the gesture. */
   onTouchStart(callback: (ev: TouchStartEvent<UIScreen>) => void): this,
   /** @internal The destination tuple (Presentable). */
@@ -80,6 +97,12 @@ export class ScreenElement extends ContainerElement<"screen"> {
     return this
   }
 
+  url(route: string | null): this {
+    // an optional method of the bridge: a host without an address bar has none
+    if (this._h.id !== 0) tree().setDestUrl?.(TREE_DEST_SCREEN, this._h.id, route)
+    return this
+  }
+
   readonly touchStartListeners: any[] = []
   onTouchStart (callback: any): this {
     this.touchStartListeners.push(callback)

package/src/version.ts

@@ -4,7 +4,7 @@
 // same manifest). Its MAJOR is the bundle ↔ runtime contract: a bundle's `// sdk:` header line
 // and a host's embedded version must agree on the major for the host to run the bundle; minor
 // and patch never gate anything (features are detected, never versioned).
-export const SDK_VERSION = "2.0.2"
+export const SDK_VERSION = "2.0.3"
 
 /** The major of a semver string, or null when it is not one. */
 export const sdkMajor = (version: string | null | undefined): number | null => {

package/tests/helpers/fakeTree.ts

@@ -192,6 +192,8 @@ export class FakeTree {
   }
   routerHide = (transition: number): void => { this.rec("routerHide", transition); this.closeCurrent() }
   routerRestore = (transition: number): void => { this.rec("routerRestore", transition); const top = this.stack[this.stack.length - 1]; if (top) this.present(top, transition) }
+  /** A host with an address bar has it (Web Lite); a test of a host without one deletes it. */
+  setDestUrl?: (kind: number, id: number, url: string | null) => void = (kind, id, url) => { this.rec("setDestUrl", kind, id, url) }
   isViewSupported = (name: string): boolean => { this.rec("isViewSupported", name); return this.supportedViews.has(name) }
   supportedViews = new Set<string>()
   /** The contract version of a supported view (1 unless a test says otherwise). */