@tamagui/web 3.0.5 → 3.0.7

package/src/helpers/nativeStyleEngine.ts

@@ -107,17 +107,17 @@ export interface NativeStyleEngine {
   ): NativeStyleEngineLinkHandle | null
   /**
    * links many mounted hosts to shared tables in one call: entry i links
-   * refs[i] to tableIds[i] under scopes[scopeIndexes[i]]. returns the id of
-   * entry 0; ids are consecutive, and an entry whose host is gone consumes
-   * its id unlinked
+   * refs[i] to tableIds[i] under scopes[scopeIndexes[i]]. a host already
+   * linked moves to its new entry, and the engine drops linked views that
+   * have left the tree, so table links are never unlinked by id
    */
   linkTables(
     refs: unknown[],
     tableIds: number[],
     scopeIndexes: number[],
     scopes: string[]
-  ): number
-  /** unlinks an id from linkTables */
+  ): void
+  /** unlinks an id from link with per-view slots */
   unlink(id: number): void
   /**
    * fills one state of a shared table, read by every view linked to it;
@@ -155,7 +155,7 @@ const compiledMappings = new Map<string, CompiledMapping>()
 // linked mappings per scope, with their live link counts. they remain update
 // owners across memo-generation rollovers, and a scope change only syncs the
 // mappings linked under that scope
-const scopeMappings = new Map<string, Map<CompiledMapping, number>>()
+const scopeMappings = new Map<string, Set<CompiledMapping>>()
 let nextTableId = 1
 
 function getCompiledMapping(mapping: NativeStyleThemeMapping): CompiledMapping {
@@ -223,11 +223,10 @@ function syncTableState(
 
 export function setNativeStyleEngine(next: NativeStyleEngine | null): void {
   if (engine !== next) {
-    settleReleases()
     compiledMappings.clear()
     scopeMappings.clear()
-    pendingLinks = []
-    unlinkedPending = 0
+    pendingHosts = []
+    pendingStates = []
   }
   engine = next
   if (next) {
@@ -257,7 +256,7 @@ export function updateNativeStyleScope(
     // one theme, so every scope showing it reads the same table entry
     const linked = scopeMappings.get(scopeId)
     if (linked) {
-      for (const compiled of linked.keys()) {
+      for (const compiled of linked) {
         syncTableState(compiled, stateName, theme as Record<string, unknown>)
       }
     }
@@ -267,6 +266,11 @@ export function updateNativeStyleScope(
 
 export function removeNativeStyleScope(scopeId: string): void {
   if (!scopeStates.delete(scopeId)) return
+  // a <Theme> removes and re-adds its scope in one commit whenever its state
+  // changes; only a scope still gone after that commit drops its mappings
+  queueMicrotask(() => {
+    if (!scopeStates.has(scopeId)) scopeMappings.delete(scopeId)
+  })
   engine?.removeScope(scopeId)
 }
 
@@ -278,179 +282,108 @@ export function resolveNativeStyleMapping(
   return resolveCompiledMapping(getCompiledMapping(mapping), stateName, theme).renderProps
 }
 
-interface MappingLink {
-  ref: unknown
-  compiled: CompiledMapping
+/**
+ * what a host rendered: one mapping under one scope state. every host of a
+ * compiled component that rendered that state shares one record, so a mount
+ * allocates nothing to link
+ */
+export interface NativeStyleLinkState {
+  mapping: NativeStyleThemeMapping
   scopeId: string
-  /** 0 while pending, -1 once unlinked */
-  id: number
-  /** the engine that assigned `id`: a later engine swap must not receive its unlink */
-  owner: NativeStyleEngine | null
+  stateName: string
+  theme: Record<string, unknown>
 }
 
-// views link lazily: a mount only records its host here, and the engine
-// links every pending view in one call before a scope next changes. linking
-// exists for theme switches, so a mount pays nothing native, and a view that
-// unmounts before any switch never reaches the engine
-let pendingLinks: MappingLink[] = []
-// pending entries unlinked before any flush; compacted once they dominate
-let unlinkedPending = 0
-
-function trackScopeMapping(link: MappingLink, delta: 1 | -1) {
-  let linked = scopeMappings.get(link.scopeId)
-  if (!linked) scopeMappings.set(link.scopeId, (linked = new Map()))
-  const count = (linked.get(link.compiled) ?? 0) + delta
-  if (count) {
-    linked.set(link.compiled, count)
-  } else {
-    linked.delete(link.compiled)
-    if (!linked.size) scopeMappings.delete(link.scopeId)
-  }
+export function createNativeStyleLinkState(
+  mapping: NativeStyleThemeMapping,
+  scopeId: string,
+  stateName: string,
+  theme: Record<string, unknown>
+): NativeStyleLinkState {
+  return { mapping, scopeId, stateName, theme }
 }
 
-/** links every pending view in one engine call */
-export function flushNativeStyleLinks(): void {
-  settleReleases()
-  if (!pendingLinks.length) return
-  const links = pendingLinks
-  pendingLinks = []
-  unlinkedPending = 0
-  if (!engine) return
-  const live = links.filter((link) => link.id === 0)
-  if (!live.length) return
-  const refs: unknown[] = []
-  const tableIds: number[] = []
-  const scopeIndexes: number[] = []
-  const scopes: string[] = []
-  for (const link of live) {
-    let scopeIndex = scopes.indexOf(link.scopeId)
-    if (scopeIndex === -1) scopeIndex = scopes.push(link.scopeId) - 1
-    refs.push(link.ref)
-    tableIds.push(link.compiled.tableId)
-    scopeIndexes.push(scopeIndex)
-  }
-  const firstId = engine.linkTables(refs, tableIds, scopeIndexes, scopes)
-  for (let i = 0; i < live.length; i++) {
-    const link = live[i]!
-    link.id = firstId + i
-    link.owner = engine
-    link.ref = null
-    trackScopeMapping(link, 1)
-  }
+// views link lazily: a mount only records its host and the state it rendered,
+// and the engine links every pending view in one call before a scope next
+// changes. linking exists for theme switches, so a mount pays nothing native.
+// nothing unlinks: the engine drops views that left the tree when it links, so
+// an unmount costs nothing either
+let pendingHosts: unknown[] = []
+let pendingStates: NativeStyleLinkState[] = []
+// past this many pending hosts, link them once the JS thread idles, so hosts
+// that mount and unmount without a scope change never accumulate
+const maxPendingHosts = 4096
+let idleFlushQueued = false
+
+function idleFlush() {
+  idleFlushQueued = false
+  flushNativeStyleLinks()
 }
 
-// React detaches and re-attaches a callback ref whenever the callback changes,
-// which a parent re-render does to every child. a release settles after the
-// commit, so the same host attaching again keeps its link and the engine keeps
-// its per-view caches instead of unlinking and relinking every view
-interface Release {
-  compiled: CompiledMapping
-  scopeId: string
-  handle: NativeStyleEngineLinkHandle
-  settle: () => void
-}
-const releases = new Map<unknown, Release>()
-let settleQueued = false
-
-function settleReleases() {
-  settleQueued = false
-  if (!releases.size) return
-  const settling = [...releases.values()]
-  releases.clear()
-  for (const release of settling) release.settle()
+function addScopeMapping(scopeId: string, compiled: CompiledMapping) {
+  let linked = scopeMappings.get(scopeId)
+  if (!linked) scopeMappings.set(scopeId, (linked = new Set()))
+  linked.add(compiled)
 }
 
-function releasable(
-  ref: unknown,
-  compiled: CompiledMapping,
-  scopeId: string,
-  id: number,
-  settle: () => void
-): NativeStyleEngineLinkHandle {
-  const handle: NativeStyleEngineLinkHandle = {
-    id,
-    unlink: () => {
-      const prior = releases.get(ref)
-      if (prior && prior.handle !== handle) prior.settle()
-      releases.set(ref, { compiled, scopeId, handle, settle })
-      if (!settleQueued) {
-        settleQueued = true
-        queueMicrotask(settleReleases)
-      }
-    },
+/** links every pending view in one engine call */
+export function flushNativeStyleLinks(): void {
+  if (!pendingHosts.length) return
+  const hosts = pendingHosts
+  const states = pendingStates
+  pendingHosts = []
+  pendingStates = []
+  if (!engine) return
+  const tableIds: number[] = new Array(hosts.length)
+  const scopeIndexes: number[] = new Array(hosts.length)
+  const scopes: string[] = []
+  let last: NativeStyleLinkState | undefined
+  let tableId = 0
+  let scopeIndex = 0
+  for (let i = 0; i < hosts.length; i++) {
+    const state = states[i]!
+    if (state !== last) {
+      last = state
+      const compiled = getCompiledMapping(state.mapping)
+      // the table must hold the state each view rendered before the switch
+      syncTableState(compiled, state.stateName, state.theme)
+      addScopeMapping(state.scopeId, compiled)
+      tableId = compiled.tableId
+      scopeIndex = scopes.indexOf(state.scopeId)
+      if (scopeIndex === -1) scopeIndex = scopes.push(state.scopeId) - 1
+    }
+    tableIds[i] = tableId
+    scopeIndexes[i] = scopeIndex
   }
-  return handle
+  engine.linkTables(hosts, tableIds, scopeIndexes, scopes)
 }
 
-export function linkNativeStyleMapping(
-  ref: unknown,
-  mapping: NativeStyleThemeMapping,
-  scopeId: string,
-  stateName: string,
-  theme: Record<string, unknown>
-): NativeStyleEngineLinkHandle | null {
-  if (!engine) return null
-
-  const compiled = getCompiledMapping(mapping)
+/** records a mounted host for linking. a host attaching twice links once */
+export function linkNativeStyleHost(host: unknown, state: NativeStyleLinkState): void {
+  if (!engine) return
   // a scope can advance (layout effect) after a concurrent render captured its
-  // theme but before that render's host ref links. link that host now against
+  // theme but before that render's host attaches. link that host now against
   // the live scope state and have the engine commit it once to correct the
   // stale React commit.
-  const scopeState = scopeStates.get(scopeId)
-  const stale =
-    scopeState && (scopeState.name !== stateName || scopeState.theme !== theme)
-  const kept = releases.get(ref)
-  if (kept) {
-    releases.delete(ref)
-    if (!stale && kept.compiled === compiled && kept.scopeId === scopeId)
-      return kept.handle
-    kept.settle()
+  const live = scopeStates.get(state.scopeId)
+  if (live && (live.name !== state.stateName || live.theme !== state.theme)) {
+    const compiled = getCompiledMapping(state.mapping)
+    syncTableState(compiled, live.name, live.theme as Record<string, unknown>)
+    addScopeMapping(state.scopeId, compiled)
+    engine.link(host, compiled.tableId, state.scopeId, true)
+    return
   }
-  if (stale) {
-    syncTableState(compiled, scopeState.name, scopeState.theme as Record<string, unknown>)
-    const handle = engine.link(ref, compiled.tableId, scopeId, true)
-    if (!handle) return null
-    const link: MappingLink = {
-      ref: null,
-      compiled,
-      scopeId,
-      id: handle.id,
-      owner: engine,
-    }
-    trackScopeMapping(link, 1)
-    return releasable(ref, compiled, scopeId, handle.id, () => {
-      if (link.id === -1) return
-      link.id = -1
-      if (link.owner === engine) trackScopeMapping(link, -1)
-      handle.unlink()
-    })
+  pendingHosts.push(host)
+  pendingStates.push(state)
+  if (pendingHosts.length >= maxPendingHosts && !idleFlushQueued) {
+    idleFlushQueued = true
+    requestIdleCallback(idleFlush)
   }
-
-  // the table must hold the state this view rendered before a switch links it
-  syncTableState(compiled, stateName, theme)
-  const link: MappingLink = { ref, compiled, scopeId, id: 0, owner: null }
-  pendingLinks.push(link)
-  return releasable(ref, compiled, scopeId, 0, () => {
-    const id = link.id
-    if (id === -1) return
-    link.id = -1
-    link.ref = null
-    if (id > 0) {
-      // scope accounting was reset when the engine changed
-      if (link.owner === engine) trackScopeMapping(link, -1)
-      link.owner!.unlink(id)
-    } else if (++unlinkedPending > 512 && unlinkedPending * 2 > pendingLinks.length) {
-      pendingLinks = pendingLinks.filter((pending) => pending.id === 0)
-      unlinkedPending = 0
-    }
-  })
 }
 
 /** memo-generation and live-owner sizes for development diagnostics and probes */
 export const getNativeStyleEngineCacheStats = () => {
-  const active = new Set(
-    [...scopeMappings.values()].flatMap((linked) => [...linked.keys()])
-  )
+  const active = new Set([...scopeMappings.values()].flatMap((linked) => [...linked]))
   return {
     mappings: compiledMappings.size,
     activeMappings: active.size,
@@ -499,16 +432,38 @@ export function updateNativeStyleLink(
   }
 }
 
+// per view id, how many pending entries a render of that view superseded
+let superseded: Map<number, number> | null = null
+
 export function queueNativeViewState(entry: NativeViewStateUpdate): void {
   if (!engine) return
   if (!pending) {
     pending = []
     queueMicrotask(() => {
-      const entries = pending!
+      let entries = pending!
+      const dropped = superseded
       pending = null
+      superseded = null
+      if (dropped) {
+        entries = entries.filter(
+          (queued, index) => index >= (dropped.get(queued.id) ?? 0)
+        )
+      }
+      if (!entries.length) return
       engine?.applyViewStates(entries)
       flushListener?.(entries)
     })
   }
   pending.push(entry)
 }
+
+/**
+ * a render of a linked view commits its current styles, so updates it queued
+ * before rendering carry older props and must not land after that commit: a
+ * parent passing a raw theme value re-renders the view with the new value
+ * while the view's own theme listener queued a push of the old one
+ */
+export function supersedeNativeViewStates(id: number): void {
+  if (!pending) return
+  ;(superseded ||= new Map()).set(id, pending.length)
+}

package/types/_withNativeStyle.d.ts

@@ -3,9 +3,10 @@ import { type NativeStyleThemeMapping } from './helpers/nativeStyleEngine';
 /**
  * internal: emitted by the native compiler when experimental.nativeFastPath is on.
  *
- * One component over the host: the theme scope is the only context read, the
- * host ref links straight to the engine and unlinks through React's ref
- * cleanup, so a themed view costs one component and one engine call to mount.
+ * One component over the host: the theme scope is the only context read and
+ * the host ref queues the host for the engine's next batched link. Links never
+ * detach (the engine prunes unmounted views), so a themed view costs one
+ * component and one array push to mount.
  *
  * `host: 'view'`: `Component` is RN's host view (`unstable_NativeView`).
  * <View> resets TextAncestorContext for its children when it sits inside a

package/types/_withNativeStyle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_withNativeStyle.d.ts","sourceRoot":"","sources":["../src/_withNativeStyle.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAc,MAAM,OAAO,CAAA;AAElC,OAAO,EAIL,KAAK,uBAAuB,EAC7B,MAAM,6BAA6B,CAAA;AAYpC;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,gBAAgB,cAChB,GAAG,aACH,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,kBAClB,uBAAuB,SAChC,MAAM,GAAG,MAAM;YAkHU,GAAG;sBAIA,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC;CAG3D,CAAA"}
+{"version":3,"file":"_withNativeStyle.d.ts","sourceRoot":"","sources":["../src/_withNativeStyle.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAc,MAAM,OAAO,CAAA;AAElC,OAAO,EAML,KAAK,uBAAuB,EAC7B,MAAM,6BAA6B,CAAA;AAYpC;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,gBAAgB,cAChB,GAAG,aACH,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,kBAClB,uBAAuB,SAChC,MAAM,GAAG,MAAM;YA0IU,GAAG;sBAIA,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC;CAG3D,CAAA"}

package/types/createComponent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createComponent.d.ts","sourceRoot":"","sources":["../src/createComponent.tsx"],"names":[],"mappings":"AAaA,OAAO,KAA2C,MAAM,OAAO,CAAA;AAuC/D,OAAO,KAAK,EASV,YAAY,EACZ,gBAAgB,EAChB,qBAAqB,EACrB,cAAc,EAOf,MAAM,SAAS,CAAA;AAahB,KAAK,iBAAiB,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,qBAAqB,CAAC,CAAC,CAAA;AAEpF,eAAO,MAAM,kBAAkB,wBAA+B,CAAA;AAuK9D,wBAAgB,eAAe,CAC7B,kBAAkB,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,EAAE,EACnD,GAAG,SAAS,cAAc,GAAG,cAAc,EAC3C,SAAS,GAAG,KAAK,EACjB,UAAU,SAAS,MAAM,GAAG,KAAK,EACjC,YAAY,EAAE,YAAY,wEAqkE3B"}
+{"version":3,"file":"createComponent.d.ts","sourceRoot":"","sources":["../src/createComponent.tsx"],"names":[],"mappings":"AAaA,OAAO,KAA2C,MAAM,OAAO,CAAA;AAwC/D,OAAO,KAAK,EASV,YAAY,EACZ,gBAAgB,EAChB,qBAAqB,EACrB,cAAc,EAOf,MAAM,SAAS,CAAA;AAahB,KAAK,iBAAiB,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,qBAAqB,CAAC,CAAC,CAAA;AAEpF,eAAO,MAAM,kBAAkB,wBAA+B,CAAA;AAuK9D,wBAAgB,eAAe,CAC7B,kBAAkB,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,EAAE,EACnD,GAAG,SAAS,cAAc,GAAG,cAAc,EAC3C,SAAS,GAAG,KAAK,EACjB,UAAU,SAAS,MAAM,GAAG,KAAK,EACjC,YAAY,EAAE,YAAY,wEAykE3B"}

package/types/helpers/getSplitStyles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getSplitStyles.d.ts","sourceRoot":"","sources":["../../src/helpers/getSplitStyles.tsx"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EACV,gBAAgB,EAEhB,mBAAmB,EAEnB,iBAAiB,EACjB,SAAS,EACT,cAAc,EACd,aAAa,EAGb,eAAe,EACf,YAAY,EAGZ,qBAAqB,EACrB,qBAAqB,EAErB,WAAW,EAGZ,MAAM,UAAU,CAAA;AAkBjB,OAAO,EAAE,oBAAoB,EAAE,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAKlF,OAAO,EAAE,oBAAoB,EAAE,CAAA;AAqB/B,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAe3D,OAAO,EAAE,0BAA0B,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAA;AACvF,YAAY,EACV,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,mBAAmB,EAAE,CAAA;AAE9B,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAA;AAK3D,MAAM,MAAM,gBAAgB,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAA;AAMhE,MAAM,MAAM,aAAa,GAAG,CAC1B,KAAK,EAAE;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CAAE,EAC7B,YAAY,EAAE,YAAY,EAC1B,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,qBAAqB,EACrC,UAAU,EAAE,eAAe,EAC3B,iBAAiB,CAAC,EAAE,cAAc,GAAG,IAAI,EACzC,OAAO,CAAC,EAAE,iBAAiB,EAC3B,YAAY,CAAC,EAAE,gBAAgB,GAAG,IAAI,EAEtC,WAAW,CAAC,EAAE,MAAM,EACpB,iBAAiB,CAAC,EAAE,OAAO,EAC3B,KAAK,CAAC,EAAE,SAAS,EAEjB,eAAe,CAAC,EAAE,mBAAmB,GAAG,IAAI,EAC5C,iBAAiB,CAAC,EAAE,iBAAiB,KAClC,IAAI,GAAG,cAAc,CAAA;AAiV1B,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,WAEhF;AAssBD,eAAO,MAAM,cAAc,EAAE,aAyuB5B,CAAA;AAoYD,MAAM,MAAM,UAAU,GAAG,CACvB,KAAK,EAAE,aAAa,EACpB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,GAAG,EACV,gBAAgB,CAAC,EAAE,OAAO,EAC1B,aAAa,CAAC,EAAE,GAAG,KAChB,IAAI,CAAA;AAi5CT,KAAK,oBAAoB,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,KAAK,IAAI,CAAA;AAgCnF,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,aAAa,EACpB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,GAAG,EACV,MAAM,EAAE,OAAO,EACf,IAAI,EAAE,oBAAoB,GAAG,IAAI,EACjC,QAAQ,SAAI,EACZ,WAAW,UAAQ,WA4OpB;AAqJD,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,aAAa,EACpB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,GAAG,EACV,QAAQ,EAAE,GAAG,EACb,SAAS,EAAE,OAAO,EAClB,QAAQ,EAAE,OAAO,QAyBlB;AAID,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,qBAAqB,sBAgBtF;AAMD,cAAc,mBAAmB,CAAA"}
+{"version":3,"file":"getSplitStyles.d.ts","sourceRoot":"","sources":["../../src/helpers/getSplitStyles.tsx"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EACV,gBAAgB,EAEhB,mBAAmB,EAEnB,iBAAiB,EACjB,SAAS,EACT,cAAc,EACd,aAAa,EAGb,eAAe,EACf,YAAY,EAGZ,qBAAqB,EACrB,qBAAqB,EAErB,WAAW,EAGZ,MAAM,UAAU,CAAA;AAkBjB,OAAO,EAAE,oBAAoB,EAAE,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAKlF,OAAO,EAAE,oBAAoB,EAAE,CAAA;AAqB/B,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAe3D,OAAO,EAAE,0BAA0B,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAA;AACvF,YAAY,EACV,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,mBAAmB,EAAE,CAAA;AAE9B,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAA;AAK3D,MAAM,MAAM,gBAAgB,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAA;AAMhE,MAAM,MAAM,aAAa,GAAG,CAC1B,KAAK,EAAE;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CAAE,EAC7B,YAAY,EAAE,YAAY,EAC1B,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,qBAAqB,EACrC,UAAU,EAAE,eAAe,EAC3B,iBAAiB,CAAC,EAAE,cAAc,GAAG,IAAI,EACzC,OAAO,CAAC,EAAE,iBAAiB,EAC3B,YAAY,CAAC,EAAE,gBAAgB,GAAG,IAAI,EAEtC,WAAW,CAAC,EAAE,MAAM,EACpB,iBAAiB,CAAC,EAAE,OAAO,EAC3B,KAAK,CAAC,EAAE,SAAS,EAEjB,eAAe,CAAC,EAAE,mBAAmB,GAAG,IAAI,EAC5C,iBAAiB,CAAC,EAAE,iBAAiB,KAClC,IAAI,GAAG,cAAc,CAAA;AAiV1B,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,WAEhF;AAssBD,eAAO,MAAM,cAAc,EAAE,aAyuB5B,CAAA;AAoYD,MAAM,MAAM,UAAU,GAAG,CACvB,KAAK,EAAE,aAAa,EACpB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,GAAG,EACV,gBAAgB,CAAC,EAAE,OAAO,EAC1B,aAAa,CAAC,EAAE,GAAG,KAChB,IAAI,CAAA;AAo5CT,KAAK,oBAAoB,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,KAAK,IAAI,CAAA;AAgCnF,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,aAAa,EACpB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,GAAG,EACV,MAAM,EAAE,OAAO,EACf,IAAI,EAAE,oBAAoB,GAAG,IAAI,EACjC,QAAQ,SAAI,EACZ,WAAW,UAAQ,WA4OpB;AAqJD,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,aAAa,EACpB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,GAAG,EACV,QAAQ,EAAE,GAAG,EACb,SAAS,EAAE,OAAO,EAClB,QAAQ,EAAE,OAAO,QAyBlB;AAID,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,qBAAqB,sBAgBtF;AAMD,cAAc,mBAAmB,CAAA"}

package/types/helpers/nativeStyleEngine.d.ts

@@ -42,12 +42,12 @@ export interface NativeStyleEngine {
     link(ref: unknown, table: NativeStyleEngineSlots | number, scopeId?: string, commitNow?: boolean): NativeStyleEngineLinkHandle | null;
     /**
      * links many mounted hosts to shared tables in one call: entry i links
-     * refs[i] to tableIds[i] under scopes[scopeIndexes[i]]. returns the id of
-     * entry 0; ids are consecutive, and an entry whose host is gone consumes
-     * its id unlinked
+     * refs[i] to tableIds[i] under scopes[scopeIndexes[i]]. a host already
+     * linked moves to its new entry, and the engine drops linked views that
+     * have left the tree, so table links are never unlinked by id
      */
-    linkTables(refs: unknown[], tableIds: number[], scopeIndexes: number[], scopes: string[]): number;
-    /** unlinks an id from linkTables */
+    linkTables(refs: unknown[], tableIds: number[], scopeIndexes: number[], scopes: string[]): void;
+    /** unlinks an id from link with per-view slots */
     unlink(id: number): void;
     /**
      * fills one state of a shared table, read by every view linked to it;
@@ -64,9 +64,22 @@ export declare function getNativeStyleEngine(): NativeStyleEngine | null;
 export declare function updateNativeStyleScope(scopeId: string, stateName: string, theme: object): void;
 export declare function removeNativeStyleScope(scopeId: string): void;
 export declare function resolveNativeStyleMapping(mapping: NativeStyleThemeMapping, stateName: string, theme: Record<string, unknown>): Record<string, unknown>;
+/**
+ * what a host rendered: one mapping under one scope state. every host of a
+ * compiled component that rendered that state shares one record, so a mount
+ * allocates nothing to link
+ */
+export interface NativeStyleLinkState {
+    mapping: NativeStyleThemeMapping;
+    scopeId: string;
+    stateName: string;
+    theme: Record<string, unknown>;
+}
+export declare function createNativeStyleLinkState(mapping: NativeStyleThemeMapping, scopeId: string, stateName: string, theme: Record<string, unknown>): NativeStyleLinkState;
 /** links every pending view in one engine call */
 export declare function flushNativeStyleLinks(): void;
-export declare function linkNativeStyleMapping(ref: unknown, mapping: NativeStyleThemeMapping, scopeId: string, stateName: string, theme: Record<string, unknown>): NativeStyleEngineLinkHandle | null;
+/** records a mounted host for linking. a host attaching twice links once */
+export declare function linkNativeStyleHost(host: unknown, state: NativeStyleLinkState): void;
 /** memo-generation and live-owner sizes for development diagnostics and probes */
 export declare const getNativeStyleEngineCacheStats: () => {
     mappings: number;
@@ -89,4 +102,11 @@ export declare function updateNativeStyleLink(ref: {
     nativePushedKeys?: Set<string>;
 }, host: unknown): void;
 export declare function queueNativeViewState(entry: NativeViewStateUpdate): void;
+/**
+ * a render of a linked view commits its current styles, so updates it queued
+ * before rendering carry older props and must not land after that commit: a
+ * parent passing a raw theme value re-renders the view with the new value
+ * while the view's own theme listener queued a push of the old one
+ */
+export declare function supersedeNativeViewStates(id: number): void;
 //# sourceMappingURL=nativeStyleEngine.d.ts.map

package/types/helpers/nativeStyleEngine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nativeStyleEngine.d.ts","sourceRoot":"","sources":["../../src/helpers/nativeStyleEngine.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"nativeStyleEngine.d.ts","sourceRoot":"","sources":["../../src/helpers/nativeStyleEngine.ts"],"names":[],"mappings":"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"}