react-native-tinyui 3.1.0 → 3.2.0

package/README.md

@@ -82,7 +82,7 @@ Available components:
 - `Stepper`
 - `ConcentricView`
 - `SFSymbol`
-- `TipKit` (enables `TipKit.View`, `TipKit.Popover`, `TipKit.configure`, `TipKit.resetDatastore` and `TipKit.invalidate`)
+- `TipKit` (enables `TipKit.Group`, `TipKit.View`, `TipKit.Popover`, `TipKit.configure`, `TipKit.resetDatastore` and `TipKit.invalidate`)
 
 `TipKit` is one optional module containing both native views,
 `TinyuiTipPopoverView` and `TinyuiTipView`. Select it once in your app's
@@ -431,8 +431,77 @@ The remaining props are shared by both components:
 | `ignoresDisplayFrequency` | Exempts this tip from the app-wide display interval | `false` |
 | `arrowEdge` | `top`, `bottom`, `leading`, `trailing`; Popover also accepts `auto`, View accepts `none` | Popover: `auto`; View: `none` |
 | `onActionPress` | Receives the selected `{ id, title }`; does not automatically invalidate | — |
+| `onInvalidated` | Receives `{ reason }` when invalidated, including persisted invalidation on mount; Popover waits until dismissal finishes | — |
 | `onError` | Receives `{ code, message }`; otherwise a warning is logged | — |
 
+`TipKit.Popover` also accepts `invalidateOnOutsideDismiss`. It defaults to
+`false`, or inherits its Group's value. When enabled, tapping outside the bubble
+invalidates the tip with `tipClosed`. Programmatic hiding, disabling, unmounting
+and leaving the screen do not themselves invalidate it.
+
+### Ordered groups
+
+`TipKit.Group` presents tips in the explicit `tipIds` order. It is a React
+coordinator available on **iOS 17+**, backed by native TipKit eligibility and
+persisted invalidation; it does not wrap Apple's iOS 18 `TipGroup` API.
+`priority` currently supports only `ordered` and defaults to it. The Group adds
+no layout view, so its tips can be nested in ordinary layout components.
+
+```tsx
+// At app startup, before mounting tips:
+await TipKit.configure({ displayFrequency: 'immediate' });
+
+// In your screen:
+<TipKit.Group
+  priority="ordered"
+  tipIds={['favorite-v1', 'share-v1']}
+  enabled={isScreenFocused}
+  invalidateOnOutsideDismiss
+>
+  <TipKit.Popover tipId="favorite-v1" title="Save your favorites">
+    <Button
+      title="Favorite"
+      onPress={async () => {
+        await TipKit.invalidate('favorite-v1', 'actionPerformed');
+        saveFavorite();
+      }}
+    />
+  </TipKit.Popover>
+  <TipKit.Popover tipId="share-v1" title="Share with a friend">
+    <Button
+      title="Share"
+      onPress={async () => {
+        await TipKit.invalidate('share-v1', 'actionPerformed');
+        shareItem();
+      }}
+    />
+  </TipKit.Popover>
+</TipKit.Group>;
+```
+
+- The system close button, `TipKit.invalidate`, or native display limits complete
+  a step. The next tip is enabled after the preceding popover has finished
+  dismissing. Action buttons still require explicit invalidation.
+- Outside dismissal does **not** complete a step by default. Opt in with
+  `invalidateOnOutsideDismiss`, either on the Group or an individual Popover.
+  An explicit Popover value overrides the Group's value.
+- Already-invalidated tips are skipped when the group mounts again. Keep IDs
+  stable across launches. Progress is driven by native state, not JS storage.
+- The next tip still obeys native eligibility and display frequency. Use
+  `immediate` at startup for consecutive tips; TinyUI otherwise defaults to
+  `daily`.
+- Use each declared ID for one `TipKit.View` or `TipKit.Popover` in the group.
+  A missing, disabled or ineligible current tip blocks later tips. Keep the
+  current tip mounted and enabled until it reports invalidation; invalidate it
+  instead of immediately disabling it when its feature is used.
+- `enabled={false}` pauses the group without completing a step. Groups are
+  independent; this is not a global queue for other tips, sheets or screens.
+
+`onInvalidated` reports `actionPerformed`, `tipClosed`, `displayCountExceeded`,
+`displayDurationExceeded`, or `unknown` for an unrecognized native reason.
+It is a state notification, not an outside-dismiss callback, and can fire again
+when an already-invalidated tip resumes observation.
+
 Both components accept standard `ViewProps` and a native view ref. For Popover,
 `style` lays out the anchor, not the bubble. UIKit chooses the bubble's size and may adapt
 the arrow to available space; leading/trailing follow layout direction. Bubble
@@ -481,8 +550,9 @@ launch will erase users' tip history on every launch.
 requires configuration first. It persistently invalidates the ID even when no
 view for that tip is mounted. `reason` may be `actionPerformed` or `tipClosed`.
 
-Both native views observe TipKit's `shouldDisplayUpdates` to show or remove
-the tip. Eligibility and visibility changes are not sent to JavaScript.
+Both native views observe TipKit's `statusUpdates` to show or remove
+the tip. Invalidation is sent to JavaScript through `onInvalidated`; other
+eligibility and visibility changes are not sent to JavaScript.
 Call `invalidate` with `actionPerformed` after the feature is used, or with
 `tipClosed` to permanently dismiss the tip. TipKit also handles the system
 close button and display limits.
@@ -496,7 +566,7 @@ with the same ID share their TipKit history. Keep `maxDisplayCount` and
 tip. Hiding a tip, unmounting it or reconfiguring TinyUI never resets history.
 
 Use `enabled={isScreenFocused && businessCondition}` with your navigation
-library. Each mounted, enabled Popover anchor starts its own `shouldDisplayUpdates`
+library. Each mounted, enabled Popover anchor starts its own `statusUpdates`
 observation once it has a size and a parent view controller. Disabling,
 detaching or recycling the component stops observation and dismisses its
 bubble; changing `tipId` starts a new observation. This follows the independent
@@ -517,7 +587,8 @@ detached or recycled. They do not present a view controller or block interaction
 with the rest of the screen. Both presentations use the same datastore; an
 invalidation affects every instance of the same `tipId`.
 
-Native rule/event builders and TipGroup are not exposed. The example's
+Native rule/event builders and Apple's TipGroup are not exposed. Use the
+React `TipKit.Group` above for ordered presentation. The example's
 **Inline view** switch toggles between both presentations. Its **New demo tip**
 button deliberately creates another
 ID for trying the behavior again without clearing the app's TipKit datastore.

package/ios/TipKit/TinyuiTipPopoverProvider.swift

@@ -4,6 +4,7 @@ import UIKit
 @objc public protocol TinyuiTipPopoverDelegate: AnyObject {
   func onTipAction(tipId: String, id: String, title: String)
   func onTipError(tipId: String, code: String, message: String)
+  func onTipInvalidated(tipId: String, reason: String)
 }
 
 @MainActor
@@ -26,6 +27,8 @@ import UIKit
   private var presentedTipId: String?
   private var isPresenting = false
   private var isDismissing = false
+  private var invalidateOnOutsideDismiss = false
+  private var pendingInvalidation: (tipId: String, reason: String)?
 
   @objc public convenience init(delegate: TinyuiTipPopoverDelegate) {
     self.init(frame: .zero)
@@ -34,6 +37,7 @@ import UIKit
 
   @objc public func configure(_ configuration: [String: Any], enabled: Bool, arrowEdge: String) {
     let nextTip = TinyuiTip(configuration: configuration)
+    if tip?.id != nextTip.id { pendingInvalidation = nil }
     if tip?.id != nextTip.id || self.enabled != enabled {
       stop()
       lastError = nil
@@ -41,6 +45,7 @@ import UIKit
     tip = nextTip
     self.enabled = enabled
     self.arrowEdge = arrowEdge
+    invalidateOnOutsideDismiss = configuration["invalidateOnOutsideDismiss"] as? Bool ?? false
     // Validate changed options even when an observation is already running.
     do {
       try TinyuiTipsRuntime.shared.remember(nextTip)
@@ -87,10 +92,16 @@ import UIKit
     }
 
     observation = Task { @MainActor [weak self] in
-      for await shouldDisplay in tip.shouldDisplayUpdates {
+      var reportedInvalidation = false
+      for await status in tip.statusUpdates {
         guard !Task.isCancelled, let self else { break }
-        self.shouldDisplay = shouldDisplay
+        if case .available = status { self.shouldDisplay = true } else { self.shouldDisplay = false }
+        if case .invalidated(let reason) = status, !reportedInvalidation {
+          reportedInvalidation = true
+          self.pendingInvalidation = (tip.id, TinyuiTipsRuntime.invalidationReason(reason))
+        }
         self.updatePresentation()
+        self.reportInvalidationIfDismissed()
       }
     }
   }
@@ -178,11 +189,25 @@ import UIKit
     presentedTipId = nil
     isPresenting = false
     isDismissing = false
+    reportInvalidationIfDismissed()
+  }
+
+  private func reportInvalidationIfDismissed() {
+    // The next grouped anchor must not present until this transition finishes.
+    guard controller == nil, let event = pendingInvalidation else { return }
+    pendingInvalidation = nil
+    delegate?.onTipInvalidated(tipId: event.tipId, reason: event.reason)
   }
 
   public func presentationControllerDidDismiss(_ presentationController: UIPresentationController) {
     guard let controller, presentationController.presentedViewController === controller else { return }
+    let dismissedTip = presentedTipId == tip?.id ? tip : nil
+    let shouldInvalidate = invalidateOnOutsideDismiss && !isDismissing
     finishDismissal(controller)
+    // Programmatic hiding, navigation and recycling do not complete a tip.
+    if shouldInvalidate, let dismissedTip, case .available = dismissedTip.status {
+      dismissedTip.invalidate(reason: .tipClosed)
+    }
   }
 
   public func adaptivePresentationStyle(for controller: UIPresentationController) -> UIModalPresentationStyle { .none }
@@ -199,6 +224,8 @@ import UIKit
     enabled = false
     tip = nil
     lastError = nil
+    pendingInvalidation = nil
+    invalidateOnOutsideDismiss = false
     stop()
     parentViewController = nil
   }

package/ios/TipKit/TinyuiTipPopoverView.mm

@@ -65,6 +65,7 @@ using namespace facebook::react;
     @"actions": actions,
     @"maxDisplayCount": @(next.maxDisplayCount),
     @"ignoresDisplayFrequency": @(next.ignoresDisplayFrequency),
+    @"invalidateOnOutsideDismiss": @(next.invalidateOnOutsideDismiss),
   } enabled:next.enabled arrowEdge:RCTNSStringFromString(next.arrowEdge)];
   [super updateProps:props oldProps:oldProps];
 }
@@ -87,6 +88,15 @@ using namespace facebook::react;
   });
 }
 
+- (void)onTipInvalidatedWithTipId:(NSString *)tipId reason:(NSString *)reason
+{
+  if (_eventEmitter == nullptr) return;
+  std::static_pointer_cast<const TinyuiTipPopoverViewEventEmitter>(_eventEmitter)->onTipInvalidated({
+    .tipId = std::string(tipId.UTF8String ?: ""),
+    .reason = std::string(reason.UTF8String ?: "unknown"),
+  });
+}
+
 - (void)prepareForRecycle
 {
   [_provider reset];

package/ios/TipKit/TinyuiTipView.mm

@@ -83,6 +83,15 @@ using namespace facebook::react;
   });
 }
 
+- (void)onTipInvalidatedWithTipId:(NSString *)tipId reason:(NSString *)reason
+{
+  if (_eventEmitter == nullptr) return;
+  std::static_pointer_cast<const TinyuiTipViewEventEmitter>(_eventEmitter)->onTipInvalidated({
+    .tipId = std::string(tipId.UTF8String ?: ""),
+    .reason = std::string(reason.UTF8String ?: "unknown"),
+  });
+}
+
 - (void)prepareForRecycle
 {
   _state.reset();

package/ios/TipKit/TinyuiTipViewProvider.swift

@@ -5,6 +5,7 @@ import UIKit
 @objc public protocol TinyuiTipViewDelegate: AnyObject {
   func onTipAction(tipId: String, id: String, title: String)
   func onTipError(tipId: String, code: String, message: String)
+  func onTipInvalidated(tipId: String, reason: String)
   // Fabric consumes this size directly; it is not a JavaScript event.
   func onTipSizeChange(tipId: String, width: CGFloat, height: CGFloat)
 }
@@ -69,9 +70,14 @@ import UIKit
       return
     }
     observation = Task { @MainActor [weak self] in
-      for await shouldDisplay in tip.shouldDisplayUpdates {
+      var reportedInvalidation = false
+      for await status in tip.statusUpdates {
         guard !Task.isCancelled, let self else { break }
-        if shouldDisplay { self.showTip() } else { self.removeTip() }
+        if case .available = status { self.showTip() } else { self.removeTip() }
+        if case .invalidated(let reason) = status, !reportedInvalidation {
+          reportedInvalidation = true
+          self.delegate?.onTipInvalidated(tipId: tip.id, reason: TinyuiTipsRuntime.invalidationReason(reason))
+        }
       }
     }
   }

package/ios/TipKit/TinyuiTipsRuntime.swift

@@ -80,6 +80,18 @@ import Foundation
     ])
   }
 
+  static func invalidationReason(_ reason: Tips.InvalidationReason) -> String {
+    if #available(iOS 18.0, *), reason == .displayDurationExceeded {
+      return "displayDurationExceeded"
+    }
+    switch reason {
+    case .actionPerformed: return "actionPerformed"
+    case .tipClosed: return "tipClosed"
+    case .displayCountExceeded: return "displayCountExceeded"
+    default: return "unknown"
+    }
+  }
+
   func remember(_ tip: TinyuiTip) throws {
     if let previous = knownTips[tip.id],
        previous.maximumDisplayCount != tip.maximumDisplayCount || previous.ignoresFrequency != tip.ignoresFrequency {

package/lib/module/TipKit/Group.js

@@ -0,0 +1,52 @@
+"use strict";
+
+import { createContext, useCallback, useContext, useMemo, useState } from 'react';
+import { assertComponentEnabled } from "../utils/index.js";
+import { validateTipId } from "./validation.js";
+import { jsx as _jsx } from "react/jsx-runtime";
+const GroupContext = /*#__PURE__*/createContext(null);
+
+/** Orders tips by ID while native TipKit owns eligibility and persisted history. */
+export function Group({
+  tipIds,
+  priority = 'ordered',
+  enabled = true,
+  invalidateOnOutsideDismiss = false,
+  children
+}) {
+  assertComponentEnabled('TipKit');
+  if (priority !== 'ordered') {
+    throw new Error('[TinyUI] TipKit.Group only supports ordered priority.');
+  }
+  const ids = new Set();
+  for (const tipId of tipIds) {
+    validateTipId(tipId);
+    if (ids.has(tipId)) {
+      throw new Error('[TinyUI] TipKit.Group tipIds must be unique.');
+    }
+    ids.add(tipId);
+  }
+  const [completed, setCompleted] = useState(() => new Set());
+  const complete = useCallback(tipId => {
+    setCompleted(previous => previous.has(tipId) ? previous : new Set([...previous, tipId]));
+  }, []);
+  const value = useMemo(() => ({
+    tipIds: new Set(tipIds),
+    currentTipId: tipIds.find(id => !completed.has(id)),
+    enabled,
+    invalidateOnOutsideDismiss,
+    complete
+  }), [tipIds, completed, enabled, invalidateOnOutsideDismiss, complete]);
+  return /*#__PURE__*/_jsx(GroupContext.Provider, {
+    value: value,
+    children: children
+  });
+}
+export function useTipGroup(tipId) {
+  const group = useContext(GroupContext);
+  if (group && !group.tipIds.has(tipId)) {
+    throw new Error(`[TinyUI] TipKit tipId "${tipId}" is missing from its Group's tipIds.`);
+  }
+  return group;
+}
+//# sourceMappingURL=Group.js.map

package/lib/module/TipKit/Group.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createContext","useCallback","useContext","useMemo","useState","assertComponentEnabled","validateTipId","jsx","_jsx","GroupContext","Group","tipIds","priority","enabled","invalidateOnOutsideDismiss","children","Error","ids","Set","tipId","has","add","completed","setCompleted","complete","previous","value","currentTipId","find","id","Provider","useTipGroup","group"],"sourceRoot":"../../../src","sources":["TipKit/Group.tsx"],"mappings":";;AAAA,SACEA,aAAa,EACbC,WAAW,EACXC,UAAU,EACVC,OAAO,EACPC,QAAQ,QACH,OAAO;AAEd,SAASC,sBAAsB,QAAQ,mBAAU;AAEjD,SAASC,aAAa,QAAQ,iBAAc;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAU7C,MAAMC,YAAY,gBAAGT,aAAa,CAA2B,IAAI,CAAC;;AAElE;AACA,OAAO,SAASU,KAAKA,CAAC;EACpBC,MAAM;EACNC,QAAQ,GAAG,SAAS;EACpBC,OAAO,GAAG,IAAI;EACdC,0BAA0B,GAAG,KAAK;EAClCC;AACa,CAAC,EAAE;EAChBV,sBAAsB,CAAC,QAAQ,CAAC;EAChC,IAAIO,QAAQ,KAAK,SAAS,EAAE;IAC1B,MAAM,IAAII,KAAK,CAAC,uDAAuD,CAAC;EAC1E;EACA,MAAMC,GAAG,GAAG,IAAIC,GAAG,CAAS,CAAC;EAC7B,KAAK,MAAMC,KAAK,IAAIR,MAAM,EAAE;IAC1BL,aAAa,CAACa,KAAK,CAAC;IACpB,IAAIF,GAAG,CAACG,GAAG,CAACD,KAAK,CAAC,EAAE;MAClB,MAAM,IAAIH,KAAK,CAAC,8CAA8C,CAAC;IACjE;IACAC,GAAG,CAACI,GAAG,CAACF,KAAK,CAAC;EAChB;EAEA,MAAM,CAACG,SAAS,EAAEC,YAAY,CAAC,GAAGnB,QAAQ,CACxC,MAAM,IAAIc,GAAG,CAAC,CAChB,CAAC;EACD,MAAMM,QAAQ,GAAGvB,WAAW,CAAEkB,KAAa,IAAK;IAC9CI,YAAY,CAAEE,QAAQ,IACpBA,QAAQ,CAACL,GAAG,CAACD,KAAK,CAAC,GAAGM,QAAQ,GAAG,IAAIP,GAAG,CAAC,CAAC,GAAGO,QAAQ,EAAEN,KAAK,CAAC,CAC/D,CAAC;EACH,CAAC,EAAE,EAAE,CAAC;EACN,MAAMO,KAAK,GAAGvB,OAAO,CACnB,OAAO;IACLQ,MAAM,EAAE,IAAIO,GAAG,CAACP,MAAM,CAAC;IACvBgB,YAAY,EAAEhB,MAAM,CAACiB,IAAI,CAAEC,EAAE,IAAK,CAACP,SAAS,CAACF,GAAG,CAACS,EAAE,CAAC,CAAC;IACrDhB,OAAO;IACPC,0BAA0B;IAC1BU;EACF,CAAC,CAAC,EACF,CAACb,MAAM,EAAEW,SAAS,EAAET,OAAO,EAAEC,0BAA0B,EAAEU,QAAQ,CACnE,CAAC;EAED,oBACEhB,IAAA,CAACC,YAAY,CAACqB,QAAQ;IAACJ,KAAK,EAAEA,KAAM;IAAAX,QAAA,EAAEA;EAAQ,CAAwB,CAAC;AAE3E;AAEA,OAAO,SAASgB,WAAWA,CAACZ,KAAa,EAAE;EACzC,MAAMa,KAAK,GAAG9B,UAAU,CAACO,YAAY,CAAC;EACtC,IAAIuB,KAAK,IAAI,CAACA,KAAK,CAACrB,MAAM,CAACS,GAAG,CAACD,KAAK,CAAC,EAAE;IACrC,MAAM,IAAIH,KAAK,CACb,0BAA0BG,KAAK,uCACjC,CAAC;EACH;EACA,OAAOa,KAAK;AACd","ignoreList":[]}

package/lib/module/TipKit/Popover.js

@@ -5,10 +5,12 @@ import { View } from 'react-native';
 import { assertComponentEnabled } from "../utils/index.js";
 import NativeTipPopoverView from './TipPopoverNativeComponent';
 import { validateTip } from "./validation.js";
+import { useTipGroup } from "./Group.js";
 import { jsx as _jsx } from "react/jsx-runtime";
 export const Popover = /*#__PURE__*/forwardRef(function TipPopoverRoot(props, ref) {
   assertComponentEnabled('TipKit');
   validateTip(props);
+  const group = useTipGroup(props.tipId);
   const {
     children,
     tipId,
@@ -21,6 +23,8 @@ export const Popover = /*#__PURE__*/forwardRef(function TipPopoverRoot(props, re
     ignoresDisplayFrequency = false,
     arrowEdge = 'auto',
     onActionPress,
+    onInvalidated,
+    invalidateOnOutsideDismiss = group?.invalidateOnOutsideDismiss ?? false,
     onError,
     ...viewProps
   } = props;
@@ -33,7 +37,8 @@ export const Popover = /*#__PURE__*/forwardRef(function TipPopoverRoot(props, re
     message: message,
     systemImage: systemImage,
     actions: actions,
-    enabled: enabled,
+    enabled: enabled && (!group || group.enabled && group.currentTipId === tipId),
+    invalidateOnOutsideDismiss: invalidateOnOutsideDismiss,
     maxDisplayCount: maxDisplayCount ?? 0,
     ignoresDisplayFrequency: ignoresDisplayFrequency,
     arrowEdge: arrowEdge,
@@ -47,6 +52,15 @@ export const Popover = /*#__PURE__*/forwardRef(function TipPopoverRoot(props, re
         });
       }
     },
+    onTipInvalidated: ({
+      nativeEvent
+    }) => {
+      if (nativeEvent.tipId !== tipId) return;
+      group?.complete(tipId);
+      onInvalidated?.({
+        reason: nativeEvent.reason
+      });
+    },
     onTipError: ({
       nativeEvent
     }) => {

package/lib/module/TipKit/Popover.js.map

@@ -1 +1 @@
-{"version":3,"names":["forwardRef","View","assertComponentEnabled","NativeTipPopoverView","validateTip","jsx","_jsx","Popover","TipPopoverRoot","props","ref","children","tipId","title","message","systemImage","actions","enabled","maxDisplayCount","ignoresDisplayFrequency","arrowEdge","onActionPress","onError","viewProps","collapsable","onTipAction","nativeEvent","id","onTipError","error","code","console","warn","displayName"],"sourceRoot":"../../../src","sources":["TipKit/Popover.tsx"],"mappings":";;AAAA,SAASA,UAAU,QAA2B,OAAO;AACrD,SAASC,IAAI,QAAQ,cAAc;AAEnC,SAASC,sBAAsB,QAAQ,mBAAU;AACjD,OAAOC,oBAAoB,MAAM,6BAA6B;AAE9D,SAASC,WAAW,QAAQ,iBAAc;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAE3C,OAAO,MAAMC,OAAO,gBAAGP,UAAU,CAC/B,SAASQ,cAAcA,CAACC,KAAK,EAAEC,GAAG,EAAE;EAClCR,sBAAsB,CAAC,QAAQ,CAAC;EAChCE,WAAW,CAACK,KAAK,CAAC;EAClB,MAAM;IACJE,QAAQ;IACRC,KAAK;IACLC,KAAK;IACLC,OAAO;IACPC,WAAW;IACXC,OAAO;IACPC,OAAO,GAAG,IAAI;IACdC,eAAe;IACfC,uBAAuB,GAAG,KAAK;IAC/BC,SAAS,GAAG,MAAM;IAClBC,aAAa;IACbC,OAAO;IACP,GAAGC;EACL,CAAC,GAAGd,KAAK;EAET,oBACEH,IAAA,CAACH,oBAAoB;IAAA,GACfoB,SAAS;IACbb,GAAG,EAAEA,GAAI;IACTc,WAAW,EAAE,KAAM;IACnBZ,KAAK,EAAEA,KAAM;IACbC,KAAK,EAAEA,KAAM;IACbC,OAAO,EAAEA,OAAQ;IACjBC,WAAW,EAAEA,WAAY;IACzBC,OAAO,EAAEA,OAAQ;IACjBC,OAAO,EAAEA,OAAQ;IACjBC,eAAe,EAAEA,eAAe,IAAI,CAAE;IACtCC,uBAAuB,EAAEA,uBAAwB;IACjDC,SAAS,EAAEA,SAAU;IACrBK,WAAW,EAAEA,CAAC;MAAEC;IAAY,CAAC,KAAK;MAChC,IAAIA,WAAW,CAACd,KAAK,KAAKA,KAAK,EAAE;QAC/BS,aAAa,GAAG;UAAEM,EAAE,EAAED,WAAW,CAACC,EAAE;UAAEd,KAAK,EAAEa,WAAW,CAACb;QAAM,CAAC,CAAC;MACnE;IACF,CAAE;IACFe,UAAU,EAAEA,CAAC;MAAEF;IAAY,CAAC,KAAK;MAC/B,IAAIA,WAAW,CAACd,KAAK,KAAKA,KAAK,EAAE;MACjC,MAAMiB,KAAK,GAAG;QACZC,IAAI,EAAEJ,WAAW,CAACI,IAAI;QACtBhB,OAAO,EAAEY,WAAW,CAACZ;MACvB,CAAC;MACD,IAAIQ,OAAO,EAAEA,OAAO,CAACO,KAAK,CAAC,CAAC,KAE1BE,OAAO,CAACC,IAAI,CACV,2BAA2BH,KAAK,CAACC,IAAI,KAAKD,KAAK,CAACf,OAAO,EACzD,CAAC;IACL,CAAE;IAAAH,QAAA,eAEFL,IAAA,CAACL,IAAI;MAACuB,WAAW,EAAE,KAAM;MAAAb,QAAA,EAAEA;IAAQ,CAAO;EAAC,CACvB,CAAC;AAE3B,CACF,CAAC;AAEDJ,OAAO,CAAC0B,WAAW,GAAG,gBAAgB","ignoreList":[]}
+{"version":3,"names":["forwardRef","View","assertComponentEnabled","NativeTipPopoverView","validateTip","useTipGroup","jsx","_jsx","Popover","TipPopoverRoot","props","ref","group","tipId","children","title","message","systemImage","actions","enabled","maxDisplayCount","ignoresDisplayFrequency","arrowEdge","onActionPress","onInvalidated","invalidateOnOutsideDismiss","onError","viewProps","collapsable","currentTipId","onTipAction","nativeEvent","id","onTipInvalidated","complete","reason","onTipError","error","code","console","warn","displayName"],"sourceRoot":"../../../src","sources":["TipKit/Popover.tsx"],"mappings":";;AAAA,SAASA,UAAU,QAA2B,OAAO;AACrD,SAASC,IAAI,QAAQ,cAAc;AAEnC,SAASC,sBAAsB,QAAQ,mBAAU;AACjD,OAAOC,oBAAoB,MAAM,6BAA6B;AAE9D,SAASC,WAAW,QAAQ,iBAAc;AAC1C,SAASC,WAAW,QAAQ,YAAS;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAEtC,OAAO,MAAMC,OAAO,gBAAGR,UAAU,CAC/B,SAASS,cAAcA,CAACC,KAAK,EAAEC,GAAG,EAAE;EAClCT,sBAAsB,CAAC,QAAQ,CAAC;EAChCE,WAAW,CAACM,KAAK,CAAC;EAClB,MAAME,KAAK,GAAGP,WAAW,CAACK,KAAK,CAACG,KAAK,CAAC;EACtC,MAAM;IACJC,QAAQ;IACRD,KAAK;IACLE,KAAK;IACLC,OAAO;IACPC,WAAW;IACXC,OAAO;IACPC,OAAO,GAAG,IAAI;IACdC,eAAe;IACfC,uBAAuB,GAAG,KAAK;IAC/BC,SAAS,GAAG,MAAM;IAClBC,aAAa;IACbC,aAAa;IACbC,0BAA0B,GAAGb,KAAK,EAAEa,0BAA0B,IAAI,KAAK;IACvEC,OAAO;IACP,GAAGC;EACL,CAAC,GAAGjB,KAAK;EAET,oBACEH,IAAA,CAACJ,oBAAoB;IAAA,GACfwB,SAAS;IACbhB,GAAG,EAAEA,GAAI;IACTiB,WAAW,EAAE,KAAM;IACnBf,KAAK,EAAEA,KAAM;IACbE,KAAK,EAAEA,KAAM;IACbC,OAAO,EAAEA,OAAQ;IACjBC,WAAW,EAAEA,WAAY;IACzBC,OAAO,EAAEA,OAAQ;IACjBC,OAAO,EACLA,OAAO,KAAK,CAACP,KAAK,IAAKA,KAAK,CAACO,OAAO,IAAIP,KAAK,CAACiB,YAAY,KAAKhB,KAAM,CACtE;IACDY,0BAA0B,EAAEA,0BAA2B;IACvDL,eAAe,EAAEA,eAAe,IAAI,CAAE;IACtCC,uBAAuB,EAAEA,uBAAwB;IACjDC,SAAS,EAAEA,SAAU;IACrBQ,WAAW,EAAEA,CAAC;MAAEC;IAAY,CAAC,KAAK;MAChC,IAAIA,WAAW,CAAClB,KAAK,KAAKA,KAAK,EAAE;QAC/BU,aAAa,GAAG;UAAES,EAAE,EAAED,WAAW,CAACC,EAAE;UAAEjB,KAAK,EAAEgB,WAAW,CAAChB;QAAM,CAAC,CAAC;MACnE;IACF,CAAE;IACFkB,gBAAgB,EAAEA,CAAC;MAAEF;IAAY,CAAC,KAAK;MACrC,IAAIA,WAAW,CAAClB,KAAK,KAAKA,KAAK,EAAE;MACjCD,KAAK,EAAEsB,QAAQ,CAACrB,KAAK,CAAC;MACtBW,aAAa,GAAG;QACdW,MAAM,EAAEJ,WAAW,CAACI;MACtB,CAAC,CAAC;IACJ,CAAE;IACFC,UAAU,EAAEA,CAAC;MAAEL;IAAY,CAAC,KAAK;MAC/B,IAAIA,WAAW,CAAClB,KAAK,KAAKA,KAAK,EAAE;MACjC,MAAMwB,KAAK,GAAG;QACZC,IAAI,EAAEP,WAAW,CAACO,IAAI;QACtBtB,OAAO,EAAEe,WAAW,CAACf;MACvB,CAAC;MACD,IAAIU,OAAO,EAAEA,OAAO,CAACW,KAAK,CAAC,CAAC,KAE1BE,OAAO,CAACC,IAAI,CACV,2BAA2BH,KAAK,CAACC,IAAI,KAAKD,KAAK,CAACrB,OAAO,EACzD,CAAC;IACL,CAAE;IAAAF,QAAA,eAEFP,IAAA,CAACN,IAAI;MAAC2B,WAAW,EAAE,KAAM;MAAAd,QAAA,EAAEA;IAAQ,CAAO;EAAC,CACvB,CAAC;AAE3B,CACF,CAAC;AAEDN,OAAO,CAACiC,WAAW,GAAG,gBAAgB","ignoreList":[]}

package/lib/module/TipKit/TipPopoverNativeComponent.ts

@@ -12,6 +12,7 @@ export interface NativeTipPopoverProps extends ViewProps {
   systemImage?: string;
   actions?: ReadonlyArray<Readonly<{ id: string; title: string }>>;
   enabled?: boolean;
+  invalidateOnOutsideDismiss?: boolean;
   maxDisplayCount?: CodegenTypes.Int32;
   ignoresDisplayFrequency?: boolean;
   arrowEdge?: string;
@@ -21,6 +22,12 @@ export interface NativeTipPopoverProps extends ViewProps {
   onTipError?: DirectEventHandler<
     Readonly<{ tipId: string; code: string; message: string }>
   >;
+  onTipInvalidated?: DirectEventHandler<
+    Readonly<{
+      tipId: string;
+      reason: string;
+    }>
+  >;
 }
 
 export default codegenNativeComponent<NativeTipPopoverProps>(

package/lib/module/TipKit/TipViewNativeComponent.ts

@@ -21,6 +21,12 @@ export interface NativeTipViewProps extends ViewProps {
   onTipError?: DirectEventHandler<
     Readonly<{ tipId: string; code: string; message: string }>
   >;
+  onTipInvalidated?: DirectEventHandler<
+    Readonly<{
+      tipId: string;
+      reason: string;
+    }>
+  >;
 }
 
 export default codegenNativeComponent<NativeTipViewProps>('TinyuiTipView', {

package/lib/module/TipKit/View.js

@@ -4,10 +4,12 @@ import { forwardRef } from 'react';
 import { assertComponentEnabled } from "../utils/index.js";
 import NativeTipView from './TipViewNativeComponent';
 import { validateTip } from "./validation.js";
+import { useTipGroup } from "./Group.js";
 import { jsx as _jsx } from "react/jsx-runtime";
 export const View = /*#__PURE__*/forwardRef(function TipViewRoot(props, ref) {
   assertComponentEnabled('TipKit');
   validateTip(props, 'TipKit.View');
+  const group = useTipGroup(props.tipId);
   const {
     tipId,
     title,
@@ -19,6 +21,7 @@ export const View = /*#__PURE__*/forwardRef(function TipViewRoot(props, ref) {
     ignoresDisplayFrequency = false,
     arrowEdge = 'none',
     onActionPress,
+    onInvalidated,
     onError,
     ...viewProps
   } = props;
@@ -32,7 +35,7 @@ export const View = /*#__PURE__*/forwardRef(function TipViewRoot(props, ref) {
     message: message,
     systemImage: systemImage,
     actions: actions,
-    enabled: enabled,
+    enabled: enabled && (!group || group.enabled && group.currentTipId === tipId),
     maxDisplayCount: maxDisplayCount ?? 0,
     ignoresDisplayFrequency: ignoresDisplayFrequency,
     arrowEdge: arrowEdge,
@@ -46,6 +49,15 @@ export const View = /*#__PURE__*/forwardRef(function TipViewRoot(props, ref) {
         });
       }
     },
+    onTipInvalidated: ({
+      nativeEvent
+    }) => {
+      if (nativeEvent.tipId !== tipId) return;
+      group?.complete(tipId);
+      onInvalidated?.({
+        reason: nativeEvent.reason
+      });
+    },
     onTipError: ({
       nativeEvent
     }) => {

package/lib/module/TipKit/View.js.map

@@ -1 +1 @@
-{"version":3,"names":["forwardRef","assertComponentEnabled","NativeTipView","validateTip","jsx","_jsx","View","TipViewRoot","props","ref","tipId","title","message","systemImage","actions","enabled","maxDisplayCount","ignoresDisplayFrequency","arrowEdge","onActionPress","onError","viewProps","children","undefined","collapsable","onTipAction","nativeEvent","id","onTipError","error","code","console","warn","displayName"],"sourceRoot":"../../../src","sources":["TipKit/View.tsx"],"mappings":";;AAAA,SAASA,UAAU,QAA2B,OAAO;AAGrD,SAASC,sBAAsB,QAAQ,mBAAU;AACjD,OAAOC,aAAa,MAAM,0BAA0B;AAEpD,SAASC,WAAW,QAAQ,iBAAc;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAE3C,OAAO,MAAMC,IAAI,gBAAGN,UAAU,CAG5B,SAASO,WAAWA,CAACC,KAAK,EAAEC,GAAG,EAAE;EACjCR,sBAAsB,CAAC,QAAQ,CAAC;EAChCE,WAAW,CAACK,KAAK,EAAE,aAAa,CAAC;EACjC,MAAM;IACJE,KAAK;IACLC,KAAK;IACLC,OAAO;IACPC,WAAW;IACXC,OAAO;IACPC,OAAO,GAAG,IAAI;IACdC,eAAe;IACfC,uBAAuB,GAAG,KAAK;IAC/BC,SAAS,GAAG,MAAM;IAClBC,aAAa;IACbC,OAAO;IACP,GAAGC;EACL,CAAC,GAAGb,KAAK;EAET,oBACEH,IAAA,CAACH,aAAa;IAAA,GACRmB,SAAS;IACbC,QAAQ,EAAEC,SAAU;IACpBd,GAAG,EAAEA,GAAI;IACTe,WAAW,EAAE,KAAM;IACnBd,KAAK,EAAEA,KAAM;IACbC,KAAK,EAAEA,KAAM;IACbC,OAAO,EAAEA,OAAQ;IACjBC,WAAW,EAAEA,WAAY;IACzBC,OAAO,EAAEA,OAAQ;IACjBC,OAAO,EAAEA,OAAQ;IACjBC,eAAe,EAAEA,eAAe,IAAI,CAAE;IACtCC,uBAAuB,EAAEA,uBAAwB;IACjDC,SAAS,EAAEA,SAAU;IACrBO,WAAW,EAAEA,CAAC;MAAEC;IAAY,CAAC,KAAK;MAChC,IAAIA,WAAW,CAAChB,KAAK,KAAKA,KAAK,EAAE;QAC/BS,aAAa,GAAG;UAAEQ,EAAE,EAAED,WAAW,CAACC,EAAE;UAAEhB,KAAK,EAAEe,WAAW,CAACf;QAAM,CAAC,CAAC;MACnE;IACF,CAAE;IACFiB,UAAU,EAAEA,CAAC;MAAEF;IAAY,CAAC,KAAK;MAC/B,IAAIA,WAAW,CAAChB,KAAK,KAAKA,KAAK,EAAE;MACjC,MAAMmB,KAAK,GAAG;QACZC,IAAI,EAAEJ,WAAW,CAACI,IAAI;QACtBlB,OAAO,EAAEc,WAAW,CAACd;MACvB,CAAC;MACD,IAAIQ,OAAO,EAAEA,OAAO,CAACS,KAAK,CAAC,CAAC,KAE1BE,OAAO,CAACC,IAAI,CAAC,wBAAwBH,KAAK,CAACC,IAAI,KAAKD,KAAK,CAACjB,OAAO,EAAE,CAAC;IACxE;EAAE,CACH,CAAC;AAEN,CAAC,CAAC;AAEFN,IAAI,CAAC2B,WAAW,GAAG,aAAa","ignoreList":[]}
+{"version":3,"names":["forwardRef","assertComponentEnabled","NativeTipView","validateTip","useTipGroup","jsx","_jsx","View","TipViewRoot","props","ref","group","tipId","title","message","systemImage","actions","enabled","maxDisplayCount","ignoresDisplayFrequency","arrowEdge","onActionPress","onInvalidated","onError","viewProps","children","undefined","collapsable","currentTipId","onTipAction","nativeEvent","id","onTipInvalidated","complete","reason","onTipError","error","code","console","warn","displayName"],"sourceRoot":"../../../src","sources":["TipKit/View.tsx"],"mappings":";;AAAA,SAASA,UAAU,QAA2B,OAAO;AAGrD,SAASC,sBAAsB,QAAQ,mBAAU;AACjD,OAAOC,aAAa,MAAM,0BAA0B;AAEpD,SAASC,WAAW,QAAQ,iBAAc;AAC1C,SAASC,WAAW,QAAQ,YAAS;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAEtC,OAAO,MAAMC,IAAI,gBAAGP,UAAU,CAG5B,SAASQ,WAAWA,CAACC,KAAK,EAAEC,GAAG,EAAE;EACjCT,sBAAsB,CAAC,QAAQ,CAAC;EAChCE,WAAW,CAACM,KAAK,EAAE,aAAa,CAAC;EACjC,MAAME,KAAK,GAAGP,WAAW,CAACK,KAAK,CAACG,KAAK,CAAC;EACtC,MAAM;IACJA,KAAK;IACLC,KAAK;IACLC,OAAO;IACPC,WAAW;IACXC,OAAO;IACPC,OAAO,GAAG,IAAI;IACdC,eAAe;IACfC,uBAAuB,GAAG,KAAK;IAC/BC,SAAS,GAAG,MAAM;IAClBC,aAAa;IACbC,aAAa;IACbC,OAAO;IACP,GAAGC;EACL,CAAC,GAAGf,KAAK;EAET,oBACEH,IAAA,CAACJ,aAAa;IAAA,GACRsB,SAAS;IACbC,QAAQ,EAAEC,SAAU;IACpBhB,GAAG,EAAEA,GAAI;IACTiB,WAAW,EAAE,KAAM;IACnBf,KAAK,EAAEA,KAAM;IACbC,KAAK,EAAEA,KAAM;IACbC,OAAO,EAAEA,OAAQ;IACjBC,WAAW,EAAEA,WAAY;IACzBC,OAAO,EAAEA,OAAQ;IACjBC,OAAO,EACLA,OAAO,KAAK,CAACN,KAAK,IAAKA,KAAK,CAACM,OAAO,IAAIN,KAAK,CAACiB,YAAY,KAAKhB,KAAM,CACtE;IACDM,eAAe,EAAEA,eAAe,IAAI,CAAE;IACtCC,uBAAuB,EAAEA,uBAAwB;IACjDC,SAAS,EAAEA,SAAU;IACrBS,WAAW,EAAEA,CAAC;MAAEC;IAAY,CAAC,KAAK;MAChC,IAAIA,WAAW,CAAClB,KAAK,KAAKA,KAAK,EAAE;QAC/BS,aAAa,GAAG;UAAEU,EAAE,EAAED,WAAW,CAACC,EAAE;UAAElB,KAAK,EAAEiB,WAAW,CAACjB;QAAM,CAAC,CAAC;MACnE;IACF,CAAE;IACFmB,gBAAgB,EAAEA,CAAC;MAAEF;IAAY,CAAC,KAAK;MACrC,IAAIA,WAAW,CAAClB,KAAK,KAAKA,KAAK,EAAE;MACjCD,KAAK,EAAEsB,QAAQ,CAACrB,KAAK,CAAC;MACtBU,aAAa,GAAG;QACdY,MAAM,EAAEJ,WAAW,CAACI;MACtB,CAAC,CAAC;IACJ,CAAE;IACFC,UAAU,EAAEA,CAAC;MAAEL;IAAY,CAAC,KAAK;MAC/B,IAAIA,WAAW,CAAClB,KAAK,KAAKA,KAAK,EAAE;MACjC,MAAMwB,KAAK,GAAG;QACZC,IAAI,EAAEP,WAAW,CAACO,IAAI;QACtBvB,OAAO,EAAEgB,WAAW,CAAChB;MACvB,CAAC;MACD,IAAIS,OAAO,EAAEA,OAAO,CAACa,KAAK,CAAC,CAAC,KAE1BE,OAAO,CAACC,IAAI,CAAC,wBAAwBH,KAAK,CAACC,IAAI,KAAKD,KAAK,CAACtB,OAAO,EAAE,CAAC;IACxE;EAAE,CACH,CAAC;AAEN,CAAC,CAAC;AAEFP,IAAI,CAACiC,WAAW,GAAG,aAAa","ignoreList":[]}

package/lib/module/TipKit/index.js

@@ -4,7 +4,9 @@ import { assertComponentEnabled, getNativeTinyui } from "../utils/index.js";
 import { validateTipId } from "./validation.js";
 import { Popover } from "./Popover.js";
 import { View } from "./View.js";
+import { Group } from "./Group.js";
 export const TipKit = {
+  Group,
   Popover,
   View,
   /**

package/lib/module/TipKit/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["assertComponentEnabled","getNativeTinyui","validateTipId","Popover","View","TipKit","resetDatastore","resetTipsDatastore","configure","displayFrequency","includes","Error","configureTips","invalidate","tipId","reason","invalidateTip"],"sourceRoot":"../../../src","sources":["TipKit/index.ts"],"mappings":";;AAAA,SAASA,sBAAsB,EAAEC,eAAe,QAAQ,mBAAU;AAElE,SAASC,aAAa,QAAQ,iBAAc;AAC5C,SAASC,OAAO,QAAQ,cAAW;AACnC,SAASC,IAAI,QAAQ,WAAQ;AAE7B,OAAO,MAAMC,MAAM,GAAG;EACpBF,OAAO;EACPC,IAAI;EACJ;AACF;AACA;AACA;AACA;EACE,MAAME,cAAcA,CAAA,EAAkB;IACpCN,sBAAsB,CAAC,QAAQ,CAAC;IAChC,MAAMC,eAAe,CAAC,CAAC,CAACM,kBAAkB,CAAC,CAAC;EAC9C,CAAC;EAED;EACA,MAAMC,SAASA,CAAC;IACdC,gBAAgB,GAAG;EACA,CAAC,GAAG,CAAC,CAAC,EAAiB;IAC1CT,sBAAsB,CAAC,QAAQ,CAAC;IAChC,IACE,CAAC,CAAC,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC,CAACU,QAAQ,CAC7DD,gBACF,CAAC,EACD;MACA,MAAM,IAAIE,KAAK,CACb,iEACF,CAAC;IACH;IACA,MAAMV,eAAe,CAAC,CAAC,CAACW,aAAa,CAACH,gBAAgB,CAAC;EACzD,CAAC;EAED;EACA,MAAMI,UAAUA,CACdC,KAAa,EACbC,MAA6B,GAAG,iBAAiB,EAClC;IACff,sBAAsB,CAAC,QAAQ,CAAC;IAChCE,aAAa,CAACY,KAAK,CAAC;IACpB,IAAIC,MAAM,KAAK,iBAAiB,IAAIA,MAAM,KAAK,WAAW,EAAE;MAC1D,MAAM,IAAIJ,KAAK,CAAC,wDAAwD,CAAC;IAC3E;IACA,MAAMV,eAAe,CAAC,CAAC,CAACe,aAAa,CAACF,KAAK,EAAEC,MAAM,CAAC;EACtD;AACF,CAAC","ignoreList":[]}
+{"version":3,"names":["assertComponentEnabled","getNativeTinyui","validateTipId","Popover","View","Group","TipKit","resetDatastore","resetTipsDatastore","configure","displayFrequency","includes","Error","configureTips","invalidate","tipId","reason","invalidateTip"],"sourceRoot":"../../../src","sources":["TipKit/index.ts"],"mappings":";;AAAA,SAASA,sBAAsB,EAAEC,eAAe,QAAQ,mBAAU;AAElE,SAASC,aAAa,QAAQ,iBAAc;AAC5C,SAASC,OAAO,QAAQ,cAAW;AACnC,SAASC,IAAI,QAAQ,WAAQ;AAC7B,SAASC,KAAK,QAAQ,YAAS;AAE/B,OAAO,MAAMC,MAAM,GAAG;EACpBD,KAAK;EACLF,OAAO;EACPC,IAAI;EACJ;AACF;AACA;AACA;AACA;EACE,MAAMG,cAAcA,CAAA,EAAkB;IACpCP,sBAAsB,CAAC,QAAQ,CAAC;IAChC,MAAMC,eAAe,CAAC,CAAC,CAACO,kBAAkB,CAAC,CAAC;EAC9C,CAAC;EAED;EACA,MAAMC,SAASA,CAAC;IACdC,gBAAgB,GAAG;EACA,CAAC,GAAG,CAAC,CAAC,EAAiB;IAC1CV,sBAAsB,CAAC,QAAQ,CAAC;IAChC,IACE,CAAC,CAAC,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC,CAACW,QAAQ,CAC7DD,gBACF,CAAC,EACD;MACA,MAAM,IAAIE,KAAK,CACb,iEACF,CAAC;IACH;IACA,MAAMX,eAAe,CAAC,CAAC,CAACY,aAAa,CAACH,gBAAgB,CAAC;EACzD,CAAC;EAED;EACA,MAAMI,UAAUA,CACdC,KAAa,EACbC,MAA6B,GAAG,iBAAiB,EAClC;IACfhB,sBAAsB,CAAC,QAAQ,CAAC;IAChCE,aAAa,CAACa,KAAK,CAAC;IACpB,IAAIC,MAAM,KAAK,iBAAiB,IAAIA,MAAM,KAAK,WAAW,EAAE;MAC1D,MAAM,IAAIJ,KAAK,CAAC,wDAAwD,CAAC;IAC3E;IACA,MAAMX,eAAe,CAAC,CAAC,CAACgB,aAAa,CAACF,KAAK,EAAEC,MAAM,CAAC;EACtD;AACF,CAAC","ignoreList":[]}

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["Menu","SwipeActions","TipKit","Stepper","ConcentricView","SFSymbol","Popover","PopoverClose","getNativeTinyui","assertComponentEnabled","LiquidGlassText"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AAAA,SAASA,IAAI,QAAQ,iBAAQ;AAC7B,SAASC,YAAY,QAAQ,yBAAgB;AAO7C,SAASC,MAAM,QAAQ,mBAAU;AAuBjC,SAASC,OAAO,QAAQ,oBAAW;AAGnC,SAASC,cAAc,QAAQ,2BAAkB;AAGjD,SAASC,QAAQ,QAAQ,qBAAY;AAWrC,SAASC,OAAO,EAAEC,YAAY,QAAQ,oBAAW;AAUjD,SAASC,eAAe,EAAEC,sBAAsB,QAAQ,kBAAS;AAGjE,SAASC,eAAe,QAAQ,4BAAmB","ignoreList":[]}
+{"version":3,"names":["Menu","SwipeActions","TipKit","Stepper","ConcentricView","SFSymbol","Popover","PopoverClose","getNativeTinyui","assertComponentEnabled","LiquidGlassText"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AAAA,SAASA,IAAI,QAAQ,iBAAQ;AAC7B,SAASC,YAAY,QAAQ,yBAAgB;AAO7C,SAASC,MAAM,QAAQ,mBAAU;AAyBjC,SAASC,OAAO,QAAQ,oBAAW;AAGnC,SAASC,cAAc,QAAQ,2BAAkB;AAGjD,SAASC,QAAQ,QAAQ,qBAAY;AAWrC,SAASC,OAAO,EAAEC,YAAY,QAAQ,oBAAW;AAUjD,SAASC,eAAe,EAAEC,sBAAsB,QAAQ,kBAAS;AAGjE,SAASC,eAAe,QAAQ,4BAAmB","ignoreList":[]}

package/lib/typescript/src/TipKit/Group.d.ts

@@ -0,0 +1,13 @@
+import type { TipGroupProps } from './types.js';
+interface GroupContextValue {
+    tipIds: ReadonlySet<string>;
+    currentTipId: string | undefined;
+    enabled: boolean;
+    invalidateOnOutsideDismiss: boolean;
+    complete: (tipId: string) => void;
+}
+/** Orders tips by ID while native TipKit owns eligibility and persisted history. */
+export declare function Group({ tipIds, priority, enabled, invalidateOnOutsideDismiss, children, }: TipGroupProps): import("react").JSX.Element;
+export declare function useTipGroup(tipId: string): GroupContextValue | null;
+export {};
+//# sourceMappingURL=Group.d.ts.map

package/lib/typescript/src/TipKit/Group.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Group.d.ts","sourceRoot":"","sources":["../../../../src/TipKit/Group.tsx"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAS,CAAC;AAG7C,UAAU,iBAAiB;IACzB,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC5B,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,0BAA0B,EAAE,OAAO,CAAC;IACpC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAID,oFAAoF;AACpF,wBAAgB,KAAK,CAAC,EACpB,MAAM,EACN,QAAoB,EACpB,OAAc,EACd,0BAAkC,EAClC,QAAQ,GACT,EAAE,aAAa,+BAoCf;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,4BAQxC"}

package/lib/typescript/src/TipKit/Popover.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Popover.d.ts","sourceRoot":"","sources":["../../../../src/TipKit/Popover.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAS,CAAC;AAG/C,eAAO,MAAM,OAAO,6LAwDnB,CAAC"}
+{"version":3,"file":"Popover.d.ts","sourceRoot":"","sources":["../../../../src/TipKit/Popover.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAwB,MAAM,YAAS,CAAC;AAIrE,eAAO,MAAM,OAAO,6LAqEnB,CAAC"}

package/lib/typescript/src/TipKit/TipPopoverNativeComponent.d.ts

@@ -10,6 +10,7 @@ export interface NativeTipPopoverProps extends ViewProps {
         title: string;
     }>>;
     enabled?: boolean;
+    invalidateOnOutsideDismiss?: boolean;
     maxDisplayCount?: CodegenTypes.Int32;
     ignoresDisplayFrequency?: boolean;
     arrowEdge?: string;
@@ -23,6 +24,10 @@ export interface NativeTipPopoverProps extends ViewProps {
         code: string;
         message: string;
     }>>;
+    onTipInvalidated?: DirectEventHandler<Readonly<{
+        tipId: string;
+        reason: string;
+    }>>;
 }
 declare const _default: import("react-native/types_generated/Libraries/Utilities/codegenNativeComponent").NativeComponentType<NativeTipPopoverProps>;
 export default _default;

package/lib/typescript/src/TipKit/TipPopoverNativeComponent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TipPopoverNativeComponent.d.ts","sourceRoot":"","sources":["../../../../src/TipKit/TipPopoverNativeComponent.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2CAA2C,CAAC;AAEpF,MAAM,WAAW,qBAAsB,SAAQ,SAAS;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,aAAa,CAAC,QAAQ,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IACjE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,eAAe,CAAC,EAAE,YAAY,CAAC,KAAK,CAAC;IACrC,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,kBAAkB,CAC9B,QAAQ,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CACvD,CAAC;IACF,UAAU,CAAC,EAAE,kBAAkB,CAC7B,QAAQ,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAC3D,CAAC;CACH;;AAED,wBAKE"}
+{"version":3,"file":"TipPopoverNativeComponent.d.ts","sourceRoot":"","sources":["../../../../src/TipKit/TipPopoverNativeComponent.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2CAA2C,CAAC;AAEpF,MAAM,WAAW,qBAAsB,SAAQ,SAAS;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,aAAa,CAAC,QAAQ,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IACjE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,eAAe,CAAC,EAAE,YAAY,CAAC,KAAK,CAAC;IACrC,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,kBAAkB,CAC9B,QAAQ,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CACvD,CAAC;IACF,UAAU,CAAC,EAAE,kBAAkB,CAC7B,QAAQ,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAC3D,CAAC;IACF,gBAAgB,CAAC,EAAE,kBAAkB,CACnC,QAAQ,CAAC;QACP,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC,CACH,CAAC;CACH;;AAED,wBAKE"}

package/lib/typescript/src/TipKit/TipViewNativeComponent.d.ts

@@ -23,6 +23,10 @@ export interface NativeTipViewProps extends ViewProps {
         code: string;
         message: string;
     }>>;
+    onTipInvalidated?: DirectEventHandler<Readonly<{
+        tipId: string;
+        reason: string;
+    }>>;
 }
 declare const _default: import("react-native/types_generated/Libraries/Utilities/codegenNativeComponent").NativeComponentType<NativeTipViewProps>;
 export default _default;

package/lib/typescript/src/TipKit/TipViewNativeComponent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TipViewNativeComponent.d.ts","sourceRoot":"","sources":["../../../../src/TipKit/TipViewNativeComponent.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2CAA2C,CAAC;AAEpF,MAAM,WAAW,kBAAmB,SAAQ,SAAS;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,aAAa,CAAC,QAAQ,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IACjE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,eAAe,CAAC,EAAE,YAAY,CAAC,KAAK,CAAC;IACrC,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,kBAAkB,CAC9B,QAAQ,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CACvD,CAAC;IACF,UAAU,CAAC,EAAE,kBAAkB,CAC7B,QAAQ,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAC3D,CAAC;CACH;;AAED,wBAEG"}
+{"version":3,"file":"TipViewNativeComponent.d.ts","sourceRoot":"","sources":["../../../../src/TipKit/TipViewNativeComponent.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2CAA2C,CAAC;AAEpF,MAAM,WAAW,kBAAmB,SAAQ,SAAS;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,aAAa,CAAC,QAAQ,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IACjE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,eAAe,CAAC,EAAE,YAAY,CAAC,KAAK,CAAC;IACrC,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,kBAAkB,CAC9B,QAAQ,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CACvD,CAAC;IACF,UAAU,CAAC,EAAE,kBAAkB,CAC7B,QAAQ,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAC3D,CAAC;IACF,gBAAgB,CAAC,EAAE,kBAAkB,CACnC,QAAQ,CAAC;QACP,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC,CACH,CAAC;CACH;;AAED,wBAEG"}

package/lib/typescript/src/TipKit/View.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"View.d.ts","sourceRoot":"","sources":["../../../../src/TipKit/View.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAS,CAAC;AAG5C,eAAO,MAAM,IAAI,0LAqDf,CAAC"}
+{"version":3,"file":"View.d.ts","sourceRoot":"","sources":["../../../../src/TipKit/View.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAwB,MAAM,YAAS,CAAC;AAIlE,eAAO,MAAM,IAAI,0LAgEf,CAAC"}

package/lib/typescript/src/TipKit/index.d.ts

@@ -1,5 +1,7 @@
 import type { TipInvalidationReason, TipKitConfiguration } from './types.js';
+import { Group } from './Group.js';
 export declare const TipKit: {
+    Group: typeof Group;
     Popover: import("react").ForwardRefExoticComponent<import("./types.js").TipPopoverProps & import("react").RefAttributes<import("react-native/types_generated/src/private/webapis/dom/nodes/ReactNativeElement").default>>;
     View: import("react").ForwardRefExoticComponent<import("./types.js").TipViewProps & import("react").RefAttributes<import("react-native/types_generated/src/private/webapis/dom/nodes/ReactNativeElement").default>>;
     /**
@@ -13,5 +15,5 @@ export declare const TipKit: {
     /** Persistently invalidate a tip, including when its view is not mounted. */
     invalidate(tipId: string, reason?: TipInvalidationReason): Promise<void>;
 };
-export type { TipAction, TipDisplayFrequency, TipError, TipInvalidationReason, TipKitConfiguration, TipPopoverProps, TipViewProps, } from './types.js';
+export type { TipAction, TipDisplayFrequency, TipError, TipInvalidationReason, TipInvalidationEvent, TipGroupProps, TipKitConfiguration, TipPopoverProps, TipViewProps, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/TipKit/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/TipKit/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,YAAS,CAAC;AAK1E,eAAO,MAAM,MAAM;;;IAGjB;;;;OAIG;sBACqB,OAAO,CAAC,IAAI,CAAC;IAKrC,sFAAsF;sCAGnF,mBAAmB,GAAQ,OAAO,CAAC,IAAI,CAAC;IAc3C,6EAA6E;sBAEpE,MAAM,WACL,qBAAqB,GAC5B,OAAO,CAAC,IAAI,CAAC;CAQjB,CAAC;AAEF,YAAY,EACV,SAAS,EACT,mBAAmB,EACnB,QAAQ,EACR,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,EACf,YAAY,GACb,MAAM,YAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/TipKit/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,YAAS,CAAC;AAI1E,OAAO,EAAE,KAAK,EAAE,MAAM,YAAS,CAAC;AAEhC,eAAO,MAAM,MAAM;;;;IAIjB;;;;OAIG;sBACqB,OAAO,CAAC,IAAI,CAAC;IAKrC,sFAAsF;sCAGnF,mBAAmB,GAAQ,OAAO,CAAC,IAAI,CAAC;IAc3C,6EAA6E;sBAEpE,MAAM,WACL,qBAAqB,GAC5B,OAAO,CAAC,IAAI,CAAC;CAQjB,CAAC;AAEF,YAAY,EACV,SAAS,EACT,mBAAmB,EACnB,QAAQ,EACR,qBAAqB,EACrB,oBAAoB,EACpB,aAAa,EACb,mBAAmB,EACnB,eAAe,EACf,YAAY,GACb,MAAM,YAAS,CAAC"}

package/lib/typescript/src/TipKit/types.d.ts

@@ -6,6 +6,20 @@ export interface TipKitConfiguration {
     displayFrequency?: TipDisplayFrequency;
 }
 export type TipInvalidationReason = 'actionPerformed' | 'tipClosed';
+export interface TipInvalidationEvent {
+    reason: TipInvalidationReason | 'displayCountExceeded' | 'displayDurationExceeded' | 'unknown';
+}
+export interface TipGroupProps {
+    /** Stable tip IDs in presentation order, independent of the layout tree. */
+    tipIds: readonly string[];
+    /** Currently only ordered presentation is supported. Defaults to ordered. */
+    priority?: 'ordered';
+    /** Pause all tips in this group without completing them. Defaults to true. */
+    enabled?: boolean;
+    /** Treat tapping outside a popover as completion. Defaults to false. */
+    invalidateOnOutsideDismiss?: boolean;
+    children: ReactNode;
+}
 export interface TipAction {
     /** Unique nonempty identity within this tip, returned by `onActionPress`. */
     id: string;
@@ -31,9 +45,13 @@ export interface TipContentProps extends Omit<ViewProps, 'children'> {
     ignoresDisplayFrequency?: boolean;
     /** Receives the tapped button's id and title; does not automatically invalidate the tip. */
     onActionPress?: (action: TipAction) => void;
+    /** Called for native invalidation, including persisted invalidation on mount. */
+    onInvalidated?: (event: TipInvalidationEvent) => void;
     onError?: (error: TipError) => void;
 }
 export interface TipPopoverProps extends TipContentProps {
+    /** Invalidate on outside dismissal. Inherits from Group; otherwise false. */
+    invalidateOnOutsideDismiss?: boolean;
     /** Anchor content. Its existing touch handlers are preserved. */
     children: ReactNode;
     /** Preferred arrow edge on the bubble; UIKit may adapt to available space. */

package/lib/typescript/src/TipKit/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/TipKit/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,MAAM,mBAAmB,GAC7B,WAAW,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE1D,MAAM,WAAW,mBAAmB;IAClC,+DAA+D;IAC/D,gBAAgB,CAAC,EAAE,mBAAmB,CAAC;CACxC;AAED,MAAM,MAAM,qBAAqB,GAAG,iBAAiB,GAAG,WAAW,CAAC;AAEpE,MAAM,WAAW,SAAS;IACxB,6EAA6E;IAC7E,EAAE,EAAE,MAAM,CAAC;IACX,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAgB,SAAQ,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC;IAClE,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2FAA2F;IAC3F,OAAO,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;IAC/B,0EAA0E;IAC1E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,2DAA2D;IAC3D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,4FAA4F;IAC5F,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,IAAI,CAAC;IAC5C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;CACrC;AAED,MAAM,WAAW,eAAgB,SAAQ,eAAe;IACtD,iEAAiE;IACjE,QAAQ,EAAE,SAAS,CAAC;IACpB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;CAChE;AAED,MAAM,WAAW,YAAa,SAAQ,eAAe;IACnD,yEAAyE;IACzE,QAAQ,CAAC,EAAE,KAAK,CAAC;IACjB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;CAChE"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/TipKit/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,MAAM,mBAAmB,GAC7B,WAAW,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE1D,MAAM,WAAW,mBAAmB;IAClC,+DAA+D;IAC/D,gBAAgB,CAAC,EAAE,mBAAmB,CAAC;CACxC;AAED,MAAM,MAAM,qBAAqB,GAAG,iBAAiB,GAAG,WAAW,CAAC;AAEpE,MAAM,WAAW,oBAAoB;IACnC,MAAM,EACF,qBAAqB,GACrB,sBAAsB,GACtB,yBAAyB,GACzB,SAAS,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,4EAA4E;IAC5E,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,8EAA8E;IAC9E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,wEAAwE;IACxE,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,6EAA6E;IAC7E,EAAE,EAAE,MAAM,CAAC;IACX,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAgB,SAAQ,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC;IAClE,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2FAA2F;IAC3F,OAAO,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;IAC/B,0EAA0E;IAC1E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,2DAA2D;IAC3D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,4FAA4F;IAC5F,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,IAAI,CAAC;IAC5C,iFAAiF;IACjF,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,CAAC;IACtD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;CACrC;AAED,MAAM,WAAW,eAAgB,SAAQ,eAAe;IACtD,6EAA6E;IAC7E,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,iEAAiE;IACjE,QAAQ,EAAE,SAAS,CAAC;IACpB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;CAChE;AAED,MAAM,WAAW,YAAa,SAAQ,eAAe;IACnD,yEAAyE;IACzE,QAAQ,CAAC,EAAE,KAAK,CAAC;IACjB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;CAChE"}

package/lib/typescript/src/index.d.ts

@@ -2,7 +2,7 @@ export { Menu } from './Menu/index.js';
 export { SwipeActions } from './SwipeActions/index.js';
 export type { SwipeAction, SwipeActionPressEvent, SwipeActionsEdge, SwipeActionsProps, } from './SwipeActions/index.js';
 export { TipKit } from './TipKit/index.js';
-export type { TipAction, TipDisplayFrequency, TipError, TipInvalidationReason, TipPopoverProps, TipViewProps, TipKitConfiguration, } from './TipKit/index.js';
+export type { TipAction, TipDisplayFrequency, TipError, TipInvalidationReason, TipInvalidationEvent, TipGroupProps, TipPopoverProps, TipViewProps, TipKitConfiguration, } from './TipKit/index.js';
 export type { MenuActionOption, MenuActionPressEvent, MenuActionPressEventData, MenuDividerOption, MenuItemState, MenuOption, MenuProps, MenuRef, MenuSectionOption, MenuSubmenuOption, } from './Menu/index.js';
 export { Stepper } from './Stepper/index.js';
 export type { StepperProps } from './Stepper/index.js';

package/lib/typescript/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAQ,CAAC;AAC9B,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAgB,CAAC;AAC9C,YAAY,EACV,WAAW,EACX,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,yBAAgB,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAU,CAAC;AAClC,YAAY,EACV,SAAS,EACT,mBAAmB,EACnB,QAAQ,EACR,qBAAqB,EACrB,eAAe,EACf,YAAY,EACZ,mBAAmB,GACpB,MAAM,mBAAU,CAAC;AAClB,YAAY,EACV,gBAAgB,EAChB,oBAAoB,EACpB,wBAAwB,EACxB,iBAAiB,EACjB,aAAa,EACb,UAAU,EACV,SAAS,EACT,OAAO,EACP,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,iBAAQ,CAAC;AAEhB,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAW,CAAC;AACpC,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAW,CAAC;AAE9C,OAAO,EAAE,cAAc,EAAE,MAAM,2BAAkB,CAAC;AAClD,YAAY,EAAE,mBAAmB,EAAE,MAAM,2BAAkB,CAAC;AAE5D,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAY,CAAC;AACtC,YAAY,EACV,yBAAyB,EACzB,cAAc,EACd,qBAAqB,EACrB,aAAa,EACb,qBAAqB,EACrB,aAAa,EACb,cAAc,GACf,MAAM,qBAAY,CAAC;AAEpB,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAW,CAAC;AAClD,YAAY,EACV,gBAAgB,EAChB,uBAAuB,EACvB,iBAAiB,EACjB,cAAc,EACd,wBAAwB,EACxB,YAAY,GACb,MAAM,oBAAW,CAAC;AAEnB,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,kBAAS,CAAC;AAClE,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAS,CAAC;AAE/C,OAAO,EAAE,eAAe,EAAE,MAAM,4BAAmB,CAAC;AACpD,YAAY,EACV,yBAAyB,EACzB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,4BAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAQ,CAAC;AAC9B,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAgB,CAAC;AAC9C,YAAY,EACV,WAAW,EACX,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,yBAAgB,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAU,CAAC;AAClC,YAAY,EACV,SAAS,EACT,mBAAmB,EACnB,QAAQ,EACR,qBAAqB,EACrB,oBAAoB,EACpB,aAAa,EACb,eAAe,EACf,YAAY,EACZ,mBAAmB,GACpB,MAAM,mBAAU,CAAC;AAClB,YAAY,EACV,gBAAgB,EAChB,oBAAoB,EACpB,wBAAwB,EACxB,iBAAiB,EACjB,aAAa,EACb,UAAU,EACV,SAAS,EACT,OAAO,EACP,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,iBAAQ,CAAC;AAEhB,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAW,CAAC;AACpC,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAW,CAAC;AAE9C,OAAO,EAAE,cAAc,EAAE,MAAM,2BAAkB,CAAC;AAClD,YAAY,EAAE,mBAAmB,EAAE,MAAM,2BAAkB,CAAC;AAE5D,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAY,CAAC;AACtC,YAAY,EACV,yBAAyB,EACzB,cAAc,EACd,qBAAqB,EACrB,aAAa,EACb,qBAAqB,EACrB,aAAa,EACb,cAAc,GACf,MAAM,qBAAY,CAAC;AAEpB,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAW,CAAC;AAClD,YAAY,EACV,gBAAgB,EAChB,uBAAuB,EACvB,iBAAiB,EACjB,cAAc,EACd,wBAAwB,EACxB,YAAY,GACb,MAAM,oBAAW,CAAC;AAEnB,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,kBAAS,CAAC;AAClE,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAS,CAAC;AAE/C,OAAO,EAAE,eAAe,EAAE,MAAM,4BAAmB,CAAC;AACpD,YAAY,EACV,yBAAyB,EACzB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,4BAAmB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-tinyui",
-  "version": "3.1.0",
+  "version": "3.2.0",
   "description": "Dependency-free native iOS Menu, SwipeActions, Popover, TipKit, Stepper, ConcentricView, SFSymbol and LiquidGlassText components for React Native",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",

package/src/TipKit/Group.tsx

@@ -0,0 +1,76 @@
+import {
+  createContext,
+  useCallback,
+  useContext,
+  useMemo,
+  useState,
+} from 'react';
+
+import { assertComponentEnabled } from '../utils';
+import type { TipGroupProps } from './types';
+import { validateTipId } from './validation';
+
+interface GroupContextValue {
+  tipIds: ReadonlySet<string>;
+  currentTipId: string | undefined;
+  enabled: boolean;
+  invalidateOnOutsideDismiss: boolean;
+  complete: (tipId: string) => void;
+}
+
+const GroupContext = createContext<GroupContextValue | null>(null);
+
+/** Orders tips by ID while native TipKit owns eligibility and persisted history. */
+export function Group({
+  tipIds,
+  priority = 'ordered',
+  enabled = true,
+  invalidateOnOutsideDismiss = false,
+  children,
+}: TipGroupProps) {
+  assertComponentEnabled('TipKit');
+  if (priority !== 'ordered') {
+    throw new Error('[TinyUI] TipKit.Group only supports ordered priority.');
+  }
+  const ids = new Set<string>();
+  for (const tipId of tipIds) {
+    validateTipId(tipId);
+    if (ids.has(tipId)) {
+      throw new Error('[TinyUI] TipKit.Group tipIds must be unique.');
+    }
+    ids.add(tipId);
+  }
+
+  const [completed, setCompleted] = useState<ReadonlySet<string>>(
+    () => new Set()
+  );
+  const complete = useCallback((tipId: string) => {
+    setCompleted((previous) =>
+      previous.has(tipId) ? previous : new Set([...previous, tipId])
+    );
+  }, []);
+  const value = useMemo(
+    () => ({
+      tipIds: new Set(tipIds),
+      currentTipId: tipIds.find((id) => !completed.has(id)),
+      enabled,
+      invalidateOnOutsideDismiss,
+      complete,
+    }),
+    [tipIds, completed, enabled, invalidateOnOutsideDismiss, complete]
+  );
+
+  return (
+    <GroupContext.Provider value={value}>{children}</GroupContext.Provider>
+  );
+}
+
+export function useTipGroup(tipId: string) {
+  const group = useContext(GroupContext);
+  if (group && !group.tipIds.has(tipId)) {
+    throw new Error(
+      `[TinyUI] TipKit tipId "${tipId}" is missing from its Group's tipIds.`
+    );
+  }
+  return group;
+}

package/src/TipKit/Popover.tsx

@@ -3,13 +3,15 @@ import { View } from 'react-native';
 
 import { assertComponentEnabled } from '../utils';
 import NativeTipPopoverView from './TipPopoverNativeComponent';
-import type { TipPopoverProps } from './types';
+import type { TipPopoverProps, TipInvalidationEvent } from './types';
 import { validateTip } from './validation';
+import { useTipGroup } from './Group';
 
 export const Popover = forwardRef<ComponentRef<typeof View>, TipPopoverProps>(
   function TipPopoverRoot(props, ref) {
     assertComponentEnabled('TipKit');
     validateTip(props);
+    const group = useTipGroup(props.tipId);
     const {
       children,
       tipId,
@@ -22,6 +24,8 @@ export const Popover = forwardRef<ComponentRef<typeof View>, TipPopoverProps>(
       ignoresDisplayFrequency = false,
       arrowEdge = 'auto',
       onActionPress,
+      onInvalidated,
+      invalidateOnOutsideDismiss = group?.invalidateOnOutsideDismiss ?? false,
       onError,
       ...viewProps
     } = props;
@@ -36,7 +40,10 @@ export const Popover = forwardRef<ComponentRef<typeof View>, TipPopoverProps>(
         message={message}
         systemImage={systemImage}
         actions={actions}
-        enabled={enabled}
+        enabled={
+          enabled && (!group || (group.enabled && group.currentTipId === tipId))
+        }
+        invalidateOnOutsideDismiss={invalidateOnOutsideDismiss}
         maxDisplayCount={maxDisplayCount ?? 0}
         ignoresDisplayFrequency={ignoresDisplayFrequency}
         arrowEdge={arrowEdge}
@@ -45,6 +52,13 @@ export const Popover = forwardRef<ComponentRef<typeof View>, TipPopoverProps>(
             onActionPress?.({ id: nativeEvent.id, title: nativeEvent.title });
           }
         }}
+        onTipInvalidated={({ nativeEvent }) => {
+          if (nativeEvent.tipId !== tipId) return;
+          group?.complete(tipId);
+          onInvalidated?.({
+            reason: nativeEvent.reason as TipInvalidationEvent['reason'],
+          });
+        }}
         onTipError={({ nativeEvent }) => {
           if (nativeEvent.tipId !== tipId) return;
           const error = {

package/src/TipKit/TipPopoverNativeComponent.ts

@@ -12,6 +12,7 @@ export interface NativeTipPopoverProps extends ViewProps {
   systemImage?: string;
   actions?: ReadonlyArray<Readonly<{ id: string; title: string }>>;
   enabled?: boolean;
+  invalidateOnOutsideDismiss?: boolean;
   maxDisplayCount?: CodegenTypes.Int32;
   ignoresDisplayFrequency?: boolean;
   arrowEdge?: string;
@@ -21,6 +22,12 @@ export interface NativeTipPopoverProps extends ViewProps {
   onTipError?: DirectEventHandler<
     Readonly<{ tipId: string; code: string; message: string }>
   >;
+  onTipInvalidated?: DirectEventHandler<
+    Readonly<{
+      tipId: string;
+      reason: string;
+    }>
+  >;
 }
 
 export default codegenNativeComponent<NativeTipPopoverProps>(

package/src/TipKit/TipViewNativeComponent.ts

@@ -21,6 +21,12 @@ export interface NativeTipViewProps extends ViewProps {
   onTipError?: DirectEventHandler<
     Readonly<{ tipId: string; code: string; message: string }>
   >;
+  onTipInvalidated?: DirectEventHandler<
+    Readonly<{
+      tipId: string;
+      reason: string;
+    }>
+  >;
 }
 
 export default codegenNativeComponent<NativeTipViewProps>('TinyuiTipView', {

package/src/TipKit/View.tsx

@@ -3,8 +3,9 @@ import type { View as ReactNativeView } from 'react-native';
 
 import { assertComponentEnabled } from '../utils';
 import NativeTipView from './TipViewNativeComponent';
-import type { TipViewProps } from './types';
+import type { TipViewProps, TipInvalidationEvent } from './types';
 import { validateTip } from './validation';
+import { useTipGroup } from './Group';
 
 export const View = forwardRef<
   ComponentRef<typeof ReactNativeView>,
@@ -12,6 +13,7 @@ export const View = forwardRef<
 >(function TipViewRoot(props, ref) {
   assertComponentEnabled('TipKit');
   validateTip(props, 'TipKit.View');
+  const group = useTipGroup(props.tipId);
   const {
     tipId,
     title,
@@ -23,6 +25,7 @@ export const View = forwardRef<
     ignoresDisplayFrequency = false,
     arrowEdge = 'none',
     onActionPress,
+    onInvalidated,
     onError,
     ...viewProps
   } = props;
@@ -38,7 +41,9 @@ export const View = forwardRef<
       message={message}
       systemImage={systemImage}
       actions={actions}
-      enabled={enabled}
+      enabled={
+        enabled && (!group || (group.enabled && group.currentTipId === tipId))
+      }
       maxDisplayCount={maxDisplayCount ?? 0}
       ignoresDisplayFrequency={ignoresDisplayFrequency}
       arrowEdge={arrowEdge}
@@ -47,6 +52,13 @@ export const View = forwardRef<
           onActionPress?.({ id: nativeEvent.id, title: nativeEvent.title });
         }
       }}
+      onTipInvalidated={({ nativeEvent }) => {
+        if (nativeEvent.tipId !== tipId) return;
+        group?.complete(tipId);
+        onInvalidated?.({
+          reason: nativeEvent.reason as TipInvalidationEvent['reason'],
+        });
+      }}
       onTipError={({ nativeEvent }) => {
         if (nativeEvent.tipId !== tipId) return;
         const error = {

package/src/TipKit/index.ts

@@ -3,8 +3,10 @@ import type { TipInvalidationReason, TipKitConfiguration } from './types';
 import { validateTipId } from './validation';
 import { Popover } from './Popover';
 import { View } from './View';
+import { Group } from './Group';
 
 export const TipKit = {
+  Group,
   Popover,
   View,
   /**
@@ -53,6 +55,8 @@ export type {
   TipDisplayFrequency,
   TipError,
   TipInvalidationReason,
+  TipInvalidationEvent,
+  TipGroupProps,
   TipKitConfiguration,
   TipPopoverProps,
   TipViewProps,

package/src/TipKit/types.ts

@@ -11,6 +11,26 @@ export interface TipKitConfiguration {
 
 export type TipInvalidationReason = 'actionPerformed' | 'tipClosed';
 
+export interface TipInvalidationEvent {
+  reason:
+    | TipInvalidationReason
+    | 'displayCountExceeded'
+    | 'displayDurationExceeded'
+    | 'unknown';
+}
+
+export interface TipGroupProps {
+  /** Stable tip IDs in presentation order, independent of the layout tree. */
+  tipIds: readonly string[];
+  /** Currently only ordered presentation is supported. Defaults to ordered. */
+  priority?: 'ordered';
+  /** Pause all tips in this group without completing them. Defaults to true. */
+  enabled?: boolean;
+  /** Treat tapping outside a popover as completion. Defaults to false. */
+  invalidateOnOutsideDismiss?: boolean;
+  children: ReactNode;
+}
+
 export interface TipAction {
   /** Unique nonempty identity within this tip, returned by `onActionPress`. */
   id: string;
@@ -38,10 +58,14 @@ export interface TipContentProps extends Omit<ViewProps, 'children'> {
   ignoresDisplayFrequency?: boolean;
   /** Receives the tapped button's id and title; does not automatically invalidate the tip. */
   onActionPress?: (action: TipAction) => void;
+  /** Called for native invalidation, including persisted invalidation on mount. */
+  onInvalidated?: (event: TipInvalidationEvent) => void;
   onError?: (error: TipError) => void;
 }
 
 export interface TipPopoverProps extends TipContentProps {
+  /** Invalidate on outside dismissal. Inherits from Group; otherwise false. */
+  invalidateOnOutsideDismiss?: boolean;
   /** Anchor content. Its existing touch handlers are preserved. */
   children: ReactNode;
   /** Preferred arrow edge on the bubble; UIKit may adapt to available space. */

package/src/index.tsx

@@ -12,6 +12,8 @@ export type {
   TipDisplayFrequency,
   TipError,
   TipInvalidationReason,
+  TipInvalidationEvent,
+  TipGroupProps,
   TipPopoverProps,
   TipViewProps,
   TipKitConfiguration,