@qontinui/ui-bridge-native 0.6.1 → 0.6.2

package/dist/index.mjs

@@ -349,6 +349,51 @@ var NativeUIBridgeRegistry = class {
       this.emit("element:stateChanged", { id, state: newState });
     }
   }
+  /**
+   * Update an element's descriptive metadata (label / accessibilityLabel /
+   * testId). Sister to {@link updateElementState} (which carries layout +
+   * visibility) and {@link updateElementProps} (which carries event handlers).
+   *
+   * Idempotent — if every passed field equals the existing value, the call
+   * returns without mutating the entry or emitting an event. This keeps
+   * `useUIElement().updateLabel(...)` cheap when consumers re-publish from a
+   * render path that produces the same string on every tick.
+   *
+   * Returns `true` when the entry was mutated, `false` otherwise. Callers
+   * that want to gate a `console.warn` on no-op invocations can use the
+   * return value instead of recomputing equality.
+   */
+  updateElementMeta(id, meta) {
+    const element = this.elements.get(id);
+    if (!element) return false;
+    const currentIdentifier = element.getIdentifier();
+    const nextLabel = meta.label !== void 0 ? meta.label : element.label;
+    const nextAccessibilityLabel = meta.accessibilityLabel !== void 0 ? meta.accessibilityLabel : currentIdentifier.accessibilityLabel;
+    const nextTestId = meta.testId !== void 0 ? meta.testId : currentIdentifier.testId;
+    const labelChanged = nextLabel !== element.label;
+    const accessibilityLabelChanged = nextAccessibilityLabel !== currentIdentifier.accessibilityLabel;
+    const testIdChanged = nextTestId !== currentIdentifier.testId;
+    if (!labelChanged && !accessibilityLabelChanged && !testIdChanged) {
+      return false;
+    }
+    const updated = {
+      ...element,
+      label: nextLabel,
+      getIdentifier: () => ({
+        uiId: id,
+        testId: nextTestId,
+        accessibilityLabel: nextAccessibilityLabel,
+        treePath: currentIdentifier.treePath
+      })
+    };
+    this.elements.set(id, updated);
+    this.emit("element:registered", {
+      id,
+      type: element.type,
+      label: nextLabel
+    });
+    return true;
+  }
   /**
    * Update element props (for action execution)
    */
@@ -5164,6 +5209,7 @@ function flattenStateStyles(stateStyles) {
   return Object.keys(result).length > 0 ? result : void 0;
 }
 var warnedDeadButtonIds = /* @__PURE__ */ new Set();
+var warnedRedundantUpdateLabelIds = /* @__PURE__ */ new Set();
 function scheduleDeadButtonWarning(bridge, id, type) {
   if (type !== "button" && type !== "pressable") return;
   if (warnedDeadButtonIds.has(id)) return;
@@ -5392,6 +5438,23 @@ function useUIElement(options) {
     },
     [bridge, id]
   );
+  const updateLabel = useCallback(
+    (newLabel) => {
+      if (!bridge || !registered) return;
+      const changed = bridge.registry.updateElementMeta(id, {
+        label: newLabel,
+        accessibilityLabel: newLabel,
+        testId: id
+      });
+      if (!changed && !warnedRedundantUpdateLabelIds.has(id)) {
+        warnedRedundantUpdateLabelIds.add(id);
+        console.warn(
+          `[UI Bridge] updateLabel("${newLabel}") on element "${id}" was a no-op (label unchanged). Gate the call behind a useEffect with [label] deps to avoid redundant publishes.`
+        );
+      }
+    },
+    [bridge, registered, id]
+  );
   const updateStyle = useCallback(
     (newStyle, newStateStyles) => {
       if (!bridge || !registered) return;
@@ -5417,7 +5480,8 @@ function useUIElement(options) {
     register,
     unregister,
     registeredElement,
-    updateStyle
+    updateStyle,
+    updateLabel
   };
 }
 function useUIElementWithProps(options) {