react-native-tinyui 2.0.0 → 3.0.0

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

@@ -0,0 +1,29 @@
+import { type CodegenTypes, type ViewProps } from 'react-native';
+import type { DirectEventHandler } from 'react-native/Libraries/Types/CodegenTypes';
+export interface NativeTipViewProps extends ViewProps {
+    tipId: string;
+    title: string;
+    message?: string;
+    systemImage?: string;
+    actions?: ReadonlyArray<Readonly<{
+        id: string;
+        title: string;
+    }>>;
+    enabled?: boolean;
+    maxDisplayCount?: CodegenTypes.Int32;
+    ignoresDisplayFrequency?: boolean;
+    arrowEdge?: string;
+    onTipAction?: DirectEventHandler<Readonly<{
+        tipId: string;
+        id: string;
+        title: string;
+    }>>;
+    onTipError?: DirectEventHandler<Readonly<{
+        tipId: string;
+        code: string;
+        message: string;
+    }>>;
+}
+declare const _default: import("react-native/types_generated/Libraries/Utilities/codegenNativeComponent").NativeComponentType<NativeTipViewProps>;
+export default _default;
+//# sourceMappingURL=TipViewNativeComponent.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,3 @@
+import type { TipViewProps } from './types.js';
+export declare const View: import("react").ForwardRefExoticComponent<TipViewProps & import("react").RefAttributes<import("react-native/types_generated/src/private/webapis/dom/nodes/ReactNativeElement").default>>;
+//# sourceMappingURL=View.d.ts.map

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

@@ -0,0 +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"}

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

@@ -1,6 +1,7 @@
 import type { TipInvalidationReason, TipKitConfiguration } from './types.js';
 export declare const TipKit: {
     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>>;
     /**
      * Clear all persisted tip, event and parameter records for testing.
      * Call and await this before configure(); rejects if already configured,
@@ -12,5 +13,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, TipStatus, } from './types.js';
+export type { TipAction, TipDisplayFrequency, TipError, TipInvalidationReason, 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;AAI1E,eAAO,MAAM,MAAM;;IAEjB;;;;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,SAAS,GACV,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;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"}

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

@@ -6,41 +6,43 @@ export interface TipKitConfiguration {
     displayFrequency?: TipDisplayFrequency;
 }
 export type TipInvalidationReason = 'actionPerformed' | 'tipClosed';
-export type TipStatus = {
-    status: 'pending' | 'available';
-} | {
-    status: 'invalidated';
-    reason: TipInvalidationReason | 'displayCountExceeded' | 'displayDurationExceeded' | 'unknown';
-};
 export interface TipAction {
+    /** Unique nonempty identity within this tip, returned by `onActionPress`. */
     id: string;
+    /** Nonempty button label, already localized by the app. */
     title: string;
 }
 export interface TipError {
     code: string;
     message: string;
 }
-export interface TipPopoverProps extends Omit<ViewProps, 'children'> {
-    /** Anchor content. Its existing touch handlers are preserved. */
-    children: ReactNode;
+export interface TipContentProps extends Omit<ViewProps, 'children'> {
     /** Stable identity used by TipKit to persist this tip's history. */
     tipId: string;
     title: string;
     message?: string;
     systemImage?: string;
+    /** Native action buttons, each with its own id and title; TipKit controls their layout. */
     actions?: readonly TipAction[];
     /** Allows presentation when TipKit is also eligible. Defaults to true. */
     enabled?: boolean;
     /** Omit to leave the number of presentations unlimited. */
     maxDisplayCount?: number;
     ignoresDisplayFrequency?: boolean;
-    /** Preferred arrow edge on the bubble; UIKit may adapt to available space. */
-    arrowEdge?: 'top' | 'bottom' | 'leading' | 'trailing' | 'auto';
-    /** TipKit eligibility, independent of whether the bubble is on screen. */
-    onStatusChange?: (status: TipStatus) => void;
-    onVisibleChange?: (visible: boolean) => void;
-    /** Actions do not automatically invalidate the tip. */
+    /** Receives the tapped button's id and title; does not automatically invalidate the tip. */
     onActionPress?: (action: TipAction) => void;
     onError?: (error: TipError) => void;
 }
+export interface TipPopoverProps extends TipContentProps {
+    /** Anchor content. Its existing touch handlers are preserved. */
+    children: ReactNode;
+    /** Preferred arrow edge on the bubble; UIKit may adapt to available space. */
+    arrowEdge?: 'top' | 'bottom' | 'leading' | 'trailing' | 'auto';
+}
+export interface TipViewProps extends TipContentProps {
+    /** Inline tips render native content and do not take anchor children. */
+    children?: never;
+    /** Optional arrow on the inline view. Defaults to no arrow. */
+    arrowEdge?: 'top' | 'bottom' | 'leading' | 'trailing' | 'none';
+}
 //# sourceMappingURL=types.d.ts.map

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,MAAM,SAAS,GACjB;IAAE,MAAM,EAAE,SAAS,GAAG,WAAW,CAAA;CAAE,GACnC;IACE,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EACF,qBAAqB,GACrB,sBAAsB,GACtB,yBAAyB,GACzB,SAAS,CAAC;CACf,CAAC;AAEN,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,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,iEAAiE;IACjE,QAAQ,EAAE,SAAS,CAAC;IACpB,oEAAoE;IACpE,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,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,8EAA8E;IAC9E,SAAS,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;IAC/D,0EAA0E;IAC1E,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,IAAI,CAAC;IAC7C,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAC7C,uDAAuD;IACvD,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,IAAI,CAAC;IAC5C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;CACrC"}
+{"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"}

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

@@ -1,4 +1,4 @@
-import type { TipPopoverProps } from './types.js';
+import type { TipContentProps } from './types.js';
 export declare function validateTipId(tipId: string): void;
-export declare function validateTip(props: TipPopoverProps): void;
+export declare function validateTip(props: TipContentProps, component?: string): void;
 //# sourceMappingURL=validation.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../../src/TipKit/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAS,CAAC;AAE/C,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAIjD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CA8BxD"}
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../../src/TipKit/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAS,CAAC;AAE/C,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAIjD;AAED,wBAAgB,WAAW,CACzB,KAAK,EAAE,eAAe,EACtB,SAAS,SAAmB,GAC3B,IAAI,CA8BN"}

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

@@ -1,6 +1,6 @@
 export { Menu } from './Menu/index.js';
 export { TipKit } from './TipKit/index.js';
-export type { TipAction, TipDisplayFrequency, TipError, TipInvalidationReason, TipPopoverProps, TipKitConfiguration, TipStatus, } from './TipKit/index.js';
+export type { TipAction, TipDisplayFrequency, TipError, TipInvalidationReason, 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,mBAAmB,EACnB,SAAS,GACV,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,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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-tinyui",
-  "version": "2.0.0",
+  "version": "3.0.0",
   "description": "Dependency-free native iOS Menu, Popover, TipKit, Stepper, ConcentricView, SFSymbol and LiquidGlassText components for React Native",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
@@ -172,6 +172,9 @@
         },
         "TinyuiTipPopoverView": {
           "className": "TinyuiTipPopoverView"
+        },
+        "TinyuiTipView": {
+          "className": "TinyuiTipView"
         }
       }
     }

package/src/TipKit/Popover.tsx

@@ -3,7 +3,7 @@ import { View } from 'react-native';
 
 import { assertComponentEnabled } from '../utils';
 import NativeTipPopoverView from './TipPopoverNativeComponent';
-import type { TipPopoverProps, TipStatus } from './types';
+import type { TipPopoverProps } from './types';
 import { validateTip } from './validation';
 
 export const Popover = forwardRef<ComponentRef<typeof View>, TipPopoverProps>(
@@ -21,8 +21,6 @@ export const Popover = forwardRef<ComponentRef<typeof View>, TipPopoverProps>(
       maxDisplayCount,
       ignoresDisplayFrequency = false,
       arrowEdge = 'auto',
-      onStatusChange,
-      onVisibleChange,
       onActionPress,
       onError,
       ...viewProps
@@ -42,24 +40,6 @@ export const Popover = forwardRef<ComponentRef<typeof View>, TipPopoverProps>(
         maxDisplayCount={maxDisplayCount ?? 0}
         ignoresDisplayFrequency={ignoresDisplayFrequency}
         arrowEdge={arrowEdge}
-        onTipStatusChange={({ nativeEvent }) => {
-          if (nativeEvent.tipId !== tipId) return;
-          if (nativeEvent.status === 'invalidated') {
-            onStatusChange?.({
-              status: 'invalidated',
-              reason: nativeEvent.reason,
-            } as TipStatus);
-          } else if (
-            nativeEvent.status === 'pending' ||
-            nativeEvent.status === 'available'
-          ) {
-            onStatusChange?.({ status: nativeEvent.status });
-          }
-        }}
-        onTipVisibleChange={({ nativeEvent }) => {
-          if (nativeEvent.tipId === tipId)
-            onVisibleChange?.(nativeEvent.visible);
-        }}
         onTipAction={({ nativeEvent }) => {
           if (nativeEvent.tipId === tipId) {
             onActionPress?.({ id: nativeEvent.id, title: nativeEvent.title });

package/src/TipKit/TipPopoverNativeComponent.ts

@@ -15,12 +15,6 @@ export interface NativeTipPopoverProps extends ViewProps {
   maxDisplayCount?: CodegenTypes.Int32;
   ignoresDisplayFrequency?: boolean;
   arrowEdge?: string;
-  onTipStatusChange?: DirectEventHandler<
-    Readonly<{ tipId: string; status: string; reason: string }>
-  >;
-  onTipVisibleChange?: DirectEventHandler<
-    Readonly<{ tipId: string; visible: boolean }>
-  >;
   onTipAction?: DirectEventHandler<
     Readonly<{ tipId: string; id: string; title: string }>
   >;

package/src/TipKit/TipViewNativeComponent.ts

@@ -0,0 +1,28 @@
+import {
+  codegenNativeComponent,
+  type CodegenTypes,
+  type ViewProps,
+} from 'react-native';
+import type { DirectEventHandler } from 'react-native/Libraries/Types/CodegenTypes';
+
+export interface NativeTipViewProps extends ViewProps {
+  tipId: string;
+  title: string;
+  message?: string;
+  systemImage?: string;
+  actions?: ReadonlyArray<Readonly<{ id: string; title: string }>>;
+  enabled?: boolean;
+  maxDisplayCount?: CodegenTypes.Int32;
+  ignoresDisplayFrequency?: boolean;
+  arrowEdge?: string;
+  onTipAction?: DirectEventHandler<
+    Readonly<{ tipId: string; id: string; title: string }>
+  >;
+  onTipError?: DirectEventHandler<
+    Readonly<{ tipId: string; code: string; message: string }>
+  >;
+}
+
+export default codegenNativeComponent<NativeTipViewProps>('TinyuiTipView', {
+  excludedPlatforms: ['android'],
+});

package/src/TipKit/View.tsx

@@ -0,0 +1,64 @@
+import { forwardRef, type ComponentRef } from 'react';
+import type { View as ReactNativeView } from 'react-native';
+
+import { assertComponentEnabled } from '../utils';
+import NativeTipView from './TipViewNativeComponent';
+import type { TipViewProps } from './types';
+import { validateTip } from './validation';
+
+export const View = forwardRef<
+  ComponentRef<typeof ReactNativeView>,
+  TipViewProps
+>(function TipViewRoot(props, ref) {
+  assertComponentEnabled('TipKit');
+  validateTip(props, 'TipKit.View');
+  const {
+    tipId,
+    title,
+    message,
+    systemImage,
+    actions,
+    enabled = true,
+    maxDisplayCount,
+    ignoresDisplayFrequency = false,
+    arrowEdge = 'none',
+    onActionPress,
+    onError,
+    ...viewProps
+  } = props;
+
+  return (
+    <NativeTipView
+      {...viewProps}
+      children={undefined}
+      ref={ref}
+      collapsable={false}
+      tipId={tipId}
+      title={title}
+      message={message}
+      systemImage={systemImage}
+      actions={actions}
+      enabled={enabled}
+      maxDisplayCount={maxDisplayCount ?? 0}
+      ignoresDisplayFrequency={ignoresDisplayFrequency}
+      arrowEdge={arrowEdge}
+      onTipAction={({ nativeEvent }) => {
+        if (nativeEvent.tipId === tipId) {
+          onActionPress?.({ id: nativeEvent.id, title: nativeEvent.title });
+        }
+      }}
+      onTipError={({ nativeEvent }) => {
+        if (nativeEvent.tipId !== tipId) return;
+        const error = {
+          code: nativeEvent.code,
+          message: nativeEvent.message,
+        };
+        if (onError) onError(error);
+        else
+          console.warn(`[TinyUI] TipKit.View ${error.code}: ${error.message}`);
+      }}
+    />
+  );
+});
+
+View.displayName = 'TipKit.View';

package/src/TipKit/index.ts

@@ -2,9 +2,11 @@ import { assertComponentEnabled, getNativeTinyui } from '../utils';
 import type { TipInvalidationReason, TipKitConfiguration } from './types';
 import { validateTipId } from './validation';
 import { Popover } from './Popover';
+import { View } from './View';
 
 export const TipKit = {
   Popover,
+  View,
   /**
    * Clear all persisted tip, event and parameter records for testing.
    * Call and await this before configure(); rejects if already configured,
@@ -53,5 +55,5 @@ export type {
   TipInvalidationReason,
   TipKitConfiguration,
   TipPopoverProps,
-  TipStatus,
+  TipViewProps,
 } from './types';

package/src/TipKit/types.ts

@@ -11,19 +11,10 @@ export interface TipKitConfiguration {
 
 export type TipInvalidationReason = 'actionPerformed' | 'tipClosed';
 
-export type TipStatus =
-  | { status: 'pending' | 'available' }
-  | {
-      status: 'invalidated';
-      reason:
-        | TipInvalidationReason
-        | 'displayCountExceeded'
-        | 'displayDurationExceeded'
-        | 'unknown';
-    };
-
 export interface TipAction {
+  /** Unique nonempty identity within this tip, returned by `onActionPress`. */
   id: string;
+  /** Nonempty button label, already localized by the app. */
   title: string;
 }
 
@@ -32,26 +23,34 @@ export interface TipError {
   message: string;
 }
 
-export interface TipPopoverProps extends Omit<ViewProps, 'children'> {
-  /** Anchor content. Its existing touch handlers are preserved. */
-  children: ReactNode;
+export interface TipContentProps extends Omit<ViewProps, 'children'> {
   /** Stable identity used by TipKit to persist this tip's history. */
   tipId: string;
   title: string;
   message?: string;
   systemImage?: string;
+  /** Native action buttons, each with its own id and title; TipKit controls their layout. */
   actions?: readonly TipAction[];
   /** Allows presentation when TipKit is also eligible. Defaults to true. */
   enabled?: boolean;
   /** Omit to leave the number of presentations unlimited. */
   maxDisplayCount?: number;
   ignoresDisplayFrequency?: boolean;
-  /** Preferred arrow edge on the bubble; UIKit may adapt to available space. */
-  arrowEdge?: 'top' | 'bottom' | 'leading' | 'trailing' | 'auto';
-  /** TipKit eligibility, independent of whether the bubble is on screen. */
-  onStatusChange?: (status: TipStatus) => void;
-  onVisibleChange?: (visible: boolean) => void;
-  /** Actions do not automatically invalidate the tip. */
+  /** Receives the tapped button's id and title; does not automatically invalidate the tip. */
   onActionPress?: (action: TipAction) => void;
   onError?: (error: TipError) => void;
 }
+
+export interface TipPopoverProps extends TipContentProps {
+  /** Anchor content. Its existing touch handlers are preserved. */
+  children: ReactNode;
+  /** Preferred arrow edge on the bubble; UIKit may adapt to available space. */
+  arrowEdge?: 'top' | 'bottom' | 'leading' | 'trailing' | 'auto';
+}
+
+export interface TipViewProps extends TipContentProps {
+  /** Inline tips render native content and do not take anchor children. */
+  children?: never;
+  /** Optional arrow on the inline view. Defaults to no arrow. */
+  arrowEdge?: 'top' | 'bottom' | 'leading' | 'trailing' | 'none';
+}

package/src/TipKit/validation.ts

@@ -1,4 +1,4 @@
-import type { TipPopoverProps } from './types';
+import type { TipContentProps } from './types';
 
 export function validateTipId(tipId: string): void {
   if (typeof tipId !== 'string' || tipId.trim().length === 0) {
@@ -6,10 +6,13 @@ export function validateTipId(tipId: string): void {
   }
 }
 
-export function validateTip(props: TipPopoverProps): void {
+export function validateTip(
+  props: TipContentProps,
+  component = 'TipKit.Popover'
+): void {
   validateTipId(props.tipId);
   if (typeof props.title !== 'string' || props.title.trim().length === 0) {
-    throw new Error('[TinyUI] TipKit.Popover title must be a nonempty string.');
+    throw new Error(`[TinyUI] ${component} title must be a nonempty string.`);
   }
   if (
     props.maxDisplayCount !== undefined &&
@@ -18,7 +21,7 @@ export function validateTip(props: TipPopoverProps): void {
       props.maxDisplayCount > 2147483647)
   ) {
     throw new Error(
-      '[TinyUI] TipKit.Popover maxDisplayCount must be a positive 32-bit integer.'
+      `[TinyUI] ${component} maxDisplayCount must be a positive 32-bit integer.`
     );
   }
   const ids = new Set<string>();
@@ -31,7 +34,7 @@ export function validateTip(props: TipPopoverProps): void {
       ids.has(action.id)
     ) {
       throw new Error(
-        '[TinyUI] TipKit.Popover actions need unique nonempty ids and nonempty titles.'
+        `[TinyUI] ${component} actions need unique nonempty ids and nonempty titles.`
       );
     }
     ids.add(action.id);

package/src/index.tsx

@@ -6,8 +6,8 @@ export type {
   TipError,
   TipInvalidationReason,
   TipPopoverProps,
+  TipViewProps,
   TipKitConfiguration,
-  TipStatus,
 } from './TipKit';
 export type {
   MenuActionOption,