@tamagui/element 2.7.7 → 3.0.0-beta.637.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tamagui/element",
-  "version": "2.7.7",
+  "version": "3.0.0-beta.637.1",
   "files": [
     "src",
     "types",
@@ -10,15 +10,15 @@
   "sideEffects": false,
   "main": "dist/cjs",
   "module": "dist/esm",
-  "types": "./src",
+  "types": "./types/index.d.ts",
   "exports": {
     "./package.json": "./package.json",
     ".": {
       "react-native": {
-        "types": "./src/index.native.ts",
+        "types": "./types/index.native.d.ts",
         "default": "./dist/esm/index.native.js"
       },
-      "types": "./src/index.ts",
+      "types": "./types/index.d.ts",
       "browser": "./dist/esm/index.mjs",
       "module": "./dist/esm/index.mjs",
       "import": "./dist/esm/index.mjs",
@@ -30,16 +30,16 @@
     "access": "public"
   },
   "scripts": {
-    "build": "tamagui-build --skip-types",
-    "watch": "tamagui-build --skip-types --watch",
+    "build": "tamagui-build",
+    "watch": "tamagui-build --watch",
     "clean": "tamagui-build clean",
     "clean:build": "tamagui-build clean:build"
   },
   "dependencies": {
-    "@tamagui/compose-refs": "2.7.7"
+    "@tamagui/compose-refs": "3.0.0-beta.637.1"
   },
   "devDependencies": {
-    "@tamagui/build": "2.7.7"
+    "@tamagui/build": "3.0.0-beta.637.1"
   },
   "peerDependencies": {
     "react": "*"

package/types/getWebElement.d.ts

@@ -0,0 +1,13 @@
+import type { TamaguiElement } from './types';
+/**
+ * Narrows a TamaguiElement to an HTMLElement, with optional generic for further casting.
+ * Throws if the element is not an instanceof HTMLElement.
+ *
+ * @example
+ * ```tsx
+ * const el = getWebElement(ref.current) // HTMLElement
+ * const input = getWebElement<HTMLInputElement>(ref.current) // HTMLInputElement
+ * ```
+ */
+export declare function getWebElement<T extends HTMLElement = HTMLElement>(element: TamaguiElement | null | undefined): T;
+//# sourceMappingURL=getWebElement.d.ts.map

package/types/index.d.ts

@@ -0,0 +1,5 @@
+export * from './useWebRef';
+export * from './useNativeRef';
+export * from './getWebElement';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/types/index.native.d.ts

@@ -0,0 +1,5 @@
+export * from './useNativeRef';
+export * from './types';
+export { useNativeRef as useWebRef } from './useNativeRef';
+export declare function getWebElement(): never;
+//# sourceMappingURL=index.native.d.ts.map

package/types/types.d.ts

@@ -0,0 +1,29 @@
+import type { View } from 'react-native';
+type MeasureOnSuccessCallback = (x: number, y: number, width: number, height: number, pageX: number, pageY: number) => void;
+type MeasureInWindowOnSuccessCallback = (x: number, y: number, width: number, height: number) => void;
+type MeasureLayoutOnSuccessCallback = (left: number, top: number, width: number, height: number) => void;
+/**
+ * Methods added to element refs that work across web and native.
+ * On web these are added at runtime to HTMLElements.
+ * On native these exist on View already.
+ */
+export interface TamaguiElementMethods {
+    measure(callback: MeasureOnSuccessCallback): void;
+    measureInWindow(callback: MeasureInWindowOnSuccessCallback): void;
+    measureLayout(relativeToNativeNode: View | HTMLElement, onSuccess: MeasureLayoutOnSuccessCallback, onFail?: () => void): void;
+    focus(): void;
+    blur(): void;
+}
+export type TamaguiElement = (HTMLElement & TamaguiElementMethods) | View;
+/**
+ * Web-specific element type that extends HTMLElement with Tamagui methods.
+ * Use this when you need an HTMLElement ref in web-only code.
+ */
+export type TamaguiWebElement<T extends HTMLElement = HTMLElement> = T & TamaguiElementMethods;
+/**
+ * Native-specific element type (View).
+ * Use this when you need a View ref in native-only code.
+ */
+export type TamaguiNativeElement = View;
+export {};
+//# sourceMappingURL=types.d.ts.map

package/types/useNativeRef.d.ts

@@ -0,0 +1,31 @@
+import * as React from 'react';
+import type { TextInput } from 'react-native';
+/**
+ * Creates a ref for native-only code that properly types to View.
+ * Returns both ref and composedRef for component usage.
+ *
+ * @example
+ * ```tsx
+ * const { ref, composedRef } = useNativeRef(forwardedRef)
+ * // ref.current is typed as View
+ * ```
+ */
+export declare function useNativeRef(forwardedRef?: React.ForwardedRef<any>): {
+    ref: React.RefObject<import("react-native").View | null>;
+    composedRef: (node: import("react-native").View | null) => void;
+};
+/**
+ * Creates a ref for native TextInput components.
+ * Returns both ref and composedRef for component usage.
+ *
+ * @example
+ * ```tsx
+ * const { ref, composedRef } = useNativeInputRef(forwardedRef)
+ * // ref.current is typed as TextInput
+ * ```
+ */
+export declare function useNativeInputRef(forwardedRef?: React.ForwardedRef<any>): {
+    ref: React.RefObject<TextInput | null>;
+    composedRef: (node: TextInput | null) => void;
+};
+//# sourceMappingURL=useNativeRef.d.ts.map

package/types/useWebRef.d.ts

@@ -0,0 +1,19 @@
+import * as React from 'react';
+import type { TamaguiElement } from './types';
+/**
+ * Creates a ref for web-only code that properly types to HTMLElement.
+ * Useful when you need to access HTMLElement-specific properties (like selectionStart)
+ * that aren't available on the cross-platform TamaguiElement type.
+ *
+ * @example
+ * ```tsx
+ * const { ref, composedRef } = useWebRef<HTMLInputElement>(forwardedRef)
+ * // ref.current is typed as HTMLInputElement
+ * // composedRef is for passing to components
+ * ```
+ */
+export declare function useWebRef<T extends TamaguiElement | HTMLElement>(forwardedRef?: React.ForwardedRef<any>): {
+    ref: React.RefObject<T | null>;
+    composedRef: (node: T | null) => void;
+};
+//# sourceMappingURL=useWebRef.d.ts.map

package/dist/esm/index.js.map

@@ -1 +0,0 @@
-{"version":3,"names":[],"sources":["../../src/index.ts"],"sourcesContent":[null],"mappings":"AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc","ignoreList":[]}

package/dist/esm/index.mjs.map

@@ -1 +0,0 @@
-{"version":3,"names":[],"sources":["../../src/index.ts"],"sourcesContent":[null],"mappings":"AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc","ignoreList":[]}

package/dist/esm/types.mjs.map

@@ -1 +0,0 @@
-{"version":3,"names":[],"sources":[],"sourcesContent":[],"mappings":"","ignoreList":[]}

package/dist/esm/types.native.js.map

@@ -1 +0,0 @@
-{"version":3,"names":[],"sources":[],"sourcesContent":[],"mappings":"","ignoreList":[]}