lecodes-sdk 2.0.9 → 2.0.11

package/src/ui/UITabs.ts

@@ -1,4 +1,4 @@
-import { PagerElement, type UIPager } from "./UIPager"
+import { PagerElement, _activePagers, type UIPager } from "./UIPager"
 import { ScreenElement, UIScreen } from "./UIScreen"
 import { UIButton } from "./UIButton"
 import { UIRow, UIColumn, type UIRow as UIRowType } from "./UIContainer"
@@ -63,6 +63,9 @@ export interface UITabs extends UIScreen {
   readonly bar: UIRowType,
 }
 
+/** The tabs by the pager each owns — what `UITabs.current` resolves through the active pagers. */
+const _byPager = new WeakMap<PagerElement, TabsElement>()
+
 export class TabsElement extends ScreenElement {
   private readonly ids: string[]
   private readonly _pagerEl: PagerElement
@@ -80,6 +83,7 @@ export class TabsElement extends ScreenElement {
     if (this.ids.length === 0) console.warn("UITabs: no tabs declared")
 
     this._pagerEl = new PagerElement({ flexGrow: 1 }, this.ids.map((id) => defs[id].screen))
+    _byPager.set(this._pagerEl, this)
 
     const buttons = this.ids.map((id, i) => {
       const def = defs[id]
@@ -173,10 +177,44 @@ export class TabsElement extends ScreenElement {
   }
 }
 
-/** Create the standard bottom-tab shell — see {@link UITabs}. Keys are tab ids in tab order;
- *  each tab needs a `label` and its root `screen` (plus an optional `icon`). */
-export function UITabs(tabs: Record<string, UITabDef>): UITabs {
-  return new TabsElement(tabs) as unknown as UITabs
+export interface UITabsConstructor {
+  /** Create the standard bottom-tab shell — see {@link UITabs}. Keys are tab ids in tab order;
+   *  each tab needs a `label` and its root `screen` (plus an optional `icon`). */
+  (tabs: Record<string, UITabDef>): UITabs
+  /** The tabs whose page is currently visible, or `null` when the visible screen is not a tab
+   *  of any — the twin of `UIPager.current`, so a screen switches tabs with no reference
+   *  threading: `UITabs.current?.select("services")`. With tabs nested inside a tab's page,
+   *  resolves to the innermost. */
+  readonly current: UITabs | null
+  /** `UITabs.current.select(id)` — switch the visible tabs to `id`; a console warning and no-op
+   *  when no tabs are on screen. */
+  select(id: string, animated?: boolean): void
+}
+
+const tabsFactory = (tabs: Record<string, UITabDef>): UITabs => new TabsElement(tabs) as unknown as UITabs
+
+/** Create the standard bottom-tab shell — see {@link UITabs}; `UITabs.current` / `UITabs.select(id)`
+ *  reach the visible tabs from anywhere. */
+export const UITabs = tabsFactory as unknown as UITabsConstructor
+
+const _resolveCurrent = (): TabsElement | null => {
+  const pagers = _activePagers()
+  for (let i = pagers.length - 1; i >= 0; i--) {
+    const tabs = _byPager.get(pagers[i])
+    if (tabs) return tabs
+  }
+  return null
+}
+
+// The ambient statics, attached the way UIPager's are (a statement that mutates a binding this
+// module declares is kept by chisel iff `UITabs` is reached — see UIPager.ts).
+Object.defineProperty(UITabs, "current", {
+  get: () => (_resolveCurrent() ?? null) as unknown as UITabs | null,
+})
+;(UITabs as any).select = (id: string, animated?: boolean) => {
+  const tabs = _resolveCurrent()
+  if (!tabs) { console.warn("UITabs.select: no tabs on the current screen"); return }
+  tabs.select(id, animated)
 }
 
 // ---- defineTabs — the design-stage twin ---------------------------------------------------------

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.9"
+export const SDK_VERSION = "2.0.11"
 
 /** The major of a semver string, or null when it is not one. */
 export const sdkMajor = (version: string | null | undefined): number | null => {