react-native-tinyui 3.0.0 → 3.2.0

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

@@ -1,6 +1,8 @@
 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,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/lib/typescript/src/utils/getNativeTinyui.d.ts

@@ -1,5 +1,5 @@
 import { type Spec } from '../NativeTinyui.js';
-export type TinyuiComponent = 'Menu' | 'Popover' | 'LiquidGlassText' | 'Stepper' | 'ConcentricView' | 'SFSymbol' | 'TipKit';
+export type TinyuiComponent = 'Menu' | 'SwipeActions' | 'Popover' | 'LiquidGlassText' | 'Stepper' | 'ConcentricView' | 'SFSymbol' | 'TipKit';
 /**
  * Returns the Tinyui TurboModule instance. The native module is always
  * compiled (Core), so this is safe to call.

package/lib/typescript/src/utils/getNativeTinyui.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getNativeTinyui.d.ts","sourceRoot":"","sources":["../../../../src/utils/getNativeTinyui.ts"],"names":[],"mappings":"AAAA,OAAqB,EAAE,KAAK,IAAI,EAAE,MAAM,oBAAiB,CAAC;AAE1D,MAAM,MAAM,eAAe,GACvB,MAAM,GACN,SAAS,GACT,iBAAiB,GACjB,SAAS,GACT,gBAAgB,GAChB,UAAU,GACV,QAAQ,CAAC;AAKb;;;GAGG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAStC;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,eAAe,GAAG,IAAI,CAWvE"}
+{"version":3,"file":"getNativeTinyui.d.ts","sourceRoot":"","sources":["../../../../src/utils/getNativeTinyui.ts"],"names":[],"mappings":"AAAA,OAAqB,EAAE,KAAK,IAAI,EAAE,MAAM,oBAAiB,CAAC;AAE1D,MAAM,MAAM,eAAe,GACvB,MAAM,GACN,cAAc,GACd,SAAS,GACT,iBAAiB,GACjB,SAAS,GACT,gBAAgB,GAChB,UAAU,GACV,QAAQ,CAAC;AAKb;;;GAGG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAStC;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,eAAe,GAAG,IAAI,CAWvE"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "react-native-tinyui",
-  "version": "3.0.0",
-  "description": "Dependency-free native iOS Menu, Popover, TipKit, Stepper, ConcentricView, SFSymbol and LiquidGlassText components for React Native",
+  "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",
   "exports": {
@@ -20,6 +20,11 @@
       "types": "./lib/typescript/src/Popover/index.d.ts",
       "default": "./lib/module/Popover/index.js"
     },
+    "./swipe-actions": {
+      "react-native-tinyui-source": "./src/SwipeActions/index.tsx",
+      "types": "./lib/typescript/src/SwipeActions/index.d.ts",
+      "default": "./lib/module/SwipeActions/index.js"
+    },
     "./stepper": {
       "react-native-tinyui-source": "./src/Stepper/index.tsx",
       "types": "./lib/typescript/src/Stepper/index.d.ts",
@@ -152,6 +157,9 @@
         }
       },
       "components": {
+        "TinyuiSwipeActionsView": {
+          "className": "TinyuiSwipeActionsView"
+        },
         "TinyuiMenuView": {
           "className": "TinyuiMenuView"
         },

package/react-native-tinyui.podspec

@@ -4,6 +4,11 @@ require "pathname"
 package = JSON.parse(File.read(File.join(__dir__, "package.json")))
 
 components = {
+  "SwipeActions" => {
+    :source_files => "ios/SwipeActions/**/*.{h,m,mm,swift,cpp}",
+    :definition => "TINYUI_FEATURE_SWIPE_ACTIONS=1",
+    :frameworks => ["UIKit"],
+  },
   "Menu" => {
     :source_files => "ios/Menu/**/*.{h,m,mm,swift,cpp}",
     :definition => "TINYUI_FEATURE_MENU=1",
@@ -100,7 +105,7 @@ Pod::Spec.new do |s|
   s.source       = { :git => "https://github.com/luoxuhai/react-native-tinyui.git", :tag => "#{s.version}" }
 
   s.source_files = source_files
-  s.private_header_files = ["ios/Core/**/*.h", "ios/Menu/**/*.h", "ios/Popover/**/*.h", "ios/LiquidGlassText/**/*.h", "ios/Stepper/**/*.h", "ios/ConcentricView/**/*.h", "ios/SFSymbol/**/*.h", "ios/TipKit/**/*.h"]
+  s.private_header_files = ["ios/Core/**/*.h", "ios/Menu/**/*.h", "ios/SwipeActions/**/*.h", "ios/Popover/**/*.h", "ios/LiquidGlassText/**/*.h", "ios/Stepper/**/*.h", "ios/ConcentricView/**/*.h", "ios/SFSymbol/**/*.h", "ios/TipKit/**/*.h"]
   s.preserve_paths = "ios/LiquidGlassText/GlassText-LICENSE"
   s.swift_version = "5.0"
   s.frameworks = frameworks unless frameworks.empty?

package/src/SwipeActions/SwipeActionsNativeComponent.ts

@@ -0,0 +1,19 @@
+import {
+  codegenNativeComponent,
+  type CodegenTypes,
+  type ViewProps,
+} from 'react-native';
+import type { DirectEventHandler } from 'react-native/Libraries/Types/CodegenTypes';
+
+export interface NativeSwipeActionsProps extends ViewProps {
+  actionsConfig: CodegenTypes.UnsafeMixed;
+  edge?: CodegenTypes.WithDefault<'leading' | 'trailing', 'trailing'>;
+  allowsFullSwipe?: CodegenTypes.WithDefault<boolean, true>;
+  disabled?: boolean;
+  onActionPress?: DirectEventHandler<Readonly<{ id: string; title: string }>>;
+}
+
+export default codegenNativeComponent<NativeSwipeActionsProps>(
+  'TinyuiSwipeActionsView',
+  { excludedPlatforms: ['android'] }
+);

package/src/SwipeActions/actions.ts

@@ -0,0 +1,26 @@
+import { processColor } from 'react-native';
+
+import type { SwipeAction } from './types';
+
+export function serializeSwipeActions(actions: readonly SwipeAction[]) {
+  const ids = new Set<string>();
+
+  return actions.map((action, index) => {
+    const id = action.id ?? `item.${index}`;
+    if (ids.has(id)) {
+      throw new Error(`SwipeActions action id "${id}" must be unique.`);
+    }
+    ids.add(id);
+
+    return {
+      id,
+      title: action.title,
+      systemImage: action.systemImage,
+      tintColor:
+        action.tintColor === undefined
+          ? undefined
+          : processColor(action.tintColor),
+      destructive: action.destructive ?? false,
+    };
+  });
+}

package/src/SwipeActions/index.tsx

@@ -0,0 +1,54 @@
+import { forwardRef, type ComponentRef } from 'react';
+import { StyleSheet, View } from 'react-native';
+
+import { assertComponentEnabled } from '../utils';
+import { serializeSwipeActions } from './actions';
+import NativeSwipeActionsView from './SwipeActionsNativeComponent';
+import type { SwipeActionsProps } from './types';
+
+export const SwipeActions = forwardRef<
+  ComponentRef<typeof View>,
+  SwipeActionsProps
+>(function SwipeActionsRoot(
+  {
+    actions,
+    children,
+    contentContainerStyle,
+    edge = 'trailing',
+    allowsFullSwipe = true,
+    disabled = false,
+    style,
+    ...viewProps
+  },
+  ref
+) {
+  assertComponentEnabled('SwipeActions');
+
+  return (
+    <NativeSwipeActionsView
+      {...viewProps}
+      ref={ref}
+      actionsConfig={serializeSwipeActions(actions)}
+      edge={edge}
+      allowsFullSwipe={allowsFullSwipe}
+      disabled={disabled}
+      style={[styles.container, style]}
+    >
+      <View collapsable={false} style={[styles.content, contentContainerStyle]}>
+        {children}
+      </View>
+    </NativeSwipeActionsView>
+  );
+});
+
+const styles = StyleSheet.create({
+  container: { overflow: 'hidden' },
+  content: { flexGrow: 1 },
+});
+
+export type {
+  SwipeAction,
+  SwipeActionPressEvent,
+  SwipeActionsEdge,
+  SwipeActionsProps,
+} from './types';

package/src/SwipeActions/types.ts

@@ -0,0 +1,37 @@
+import type { ReactNode } from 'react';
+import type { ColorValue, StyleProp, ViewProps, ViewStyle } from 'react-native';
+
+export type SwipeActionsEdge = 'leading' | 'trailing';
+
+export interface SwipeAction {
+  /** Stable identifier. Defaults to `item.<index>` when omitted. */
+  id?: string;
+  /** Button title and accessible action name. */
+  title: string;
+  /** SF Symbol name. */
+  systemImage?: string;
+  /** Native action background color, including semantic and dynamic colors. */
+  tintColor?: ColorValue;
+  /** Uses the system destructive appearance. Does not remove the React row. */
+  destructive?: boolean;
+}
+
+export type SwipeActionPressEvent = Readonly<{
+  nativeEvent: Readonly<{ id: string; title: string }>;
+}>;
+
+export interface SwipeActionsProps extends Omit<ViewProps, 'children'> {
+  /** The React Native row content. */
+  children: ReactNode;
+  /** Styles the moving row, including its background, corners and padding. */
+  contentContainerStyle?: StyleProp<ViewStyle>;
+  /** Actions ordered from the selected edge inward. */
+  actions: readonly SwipeAction[];
+  /** Logical edge; respects layout direction. Defaults to `trailing`. */
+  edge?: SwipeActionsEdge;
+  /** A full swipe performs the first action. Defaults to `true`. */
+  allowsFullSwipe?: boolean;
+  /** Disables swipe actions without disabling the row's children. */
+  disabled?: boolean;
+  onActionPress?: (event: SwipeActionPressEvent) => void;
+}

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

@@ -1,10 +1,19 @@
 export { Menu } from './Menu';
+export { SwipeActions } from './SwipeActions';
+export type {
+  SwipeAction,
+  SwipeActionPressEvent,
+  SwipeActionsEdge,
+  SwipeActionsProps,
+} from './SwipeActions';
 export { TipKit } from './TipKit';
 export type {
   TipAction,
   TipDisplayFrequency,
   TipError,
   TipInvalidationReason,
+  TipInvalidationEvent,
+  TipGroupProps,
   TipPopoverProps,
   TipViewProps,
   TipKitConfiguration,

package/src/utils/getNativeTinyui.ts

@@ -2,6 +2,7 @@ import NativeTinyui, { type Spec } from '../NativeTinyui';
 
 export type TinyuiComponent =
   | 'Menu'
+  | 'SwipeActions'
   | 'Popover'
   | 'LiquidGlassText'
   | 'Stepper'