sera-components 1.6.2 → 1.6.3

package/dist/utils/index.d.ts

@@ -1,3 +1,4 @@
 export * from './utils';
 export * from './trie';
 export * from './property-utils';
+export * from './test-id';

package/dist/utils/test-id.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Context to control test ID generation.
+ * Set to true to enable data-testid attributes on components.
+ *
+ * @example
+ * ```tsx
+ * // In your app entry point
+ * import { TestIdProvider } from "sera-components";
+ *
+ * function App() {
+ *   // Enable test IDs only in development/test mode
+ *   const enableTestIds = import.meta.env.DEV || import.meta.env.MODE === "test";
+ *
+ *   return (
+ *     <TestIdProvider value={enableTestIds}>
+ *       <YourApp />
+ *     </TestIdProvider>
+ *   );
+ * }
+ * ```
+ */
+export declare const TestIdContext: import('react').Context<boolean>;
+/**
+ * Provider component for enabling/disabling test IDs globally.
+ *
+ * @example
+ * ```tsx
+ * <TestIdProvider value={true}>
+ *   <App />
+ * </TestIdProvider>
+ * ```
+ */
+export declare const TestIdProvider: import('react').Provider<boolean>;
+/**
+ * Hook that returns test ID props when test IDs are enabled via TestIdContext.
+ * Returns an object with data-testid attribute when enabled, or an empty object when disabled.
+ *
+ * @param name - The test ID name to use
+ * @returns An object containing the data-testid attribute or an empty object
+ *
+ * @example
+ * ```tsx
+ * function MyInput({ name }: { name: string }) {
+ *   const testId = useTestId(`input:${name}`);
+ *   return <input {...testId} />;
+ * }
+ * ```
+ */
+export declare function useTestId(name: string): {
+    "data-testid"?: string;
+};
+/**
+ * Non-hook utility for getting test ID props.
+ * Use this when you can't use hooks (e.g., in render functions or callbacks).
+ *
+ * @param name - The test ID name to use
+ * @param enabled - Whether test IDs are enabled
+ * @returns An object containing the data-testid attribute or an empty object
+ */
+export declare function getTestIdProps(name: string, enabled: boolean): {
+    "data-testid"?: string;
+};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "sera-components",
   "private": false,
-  "version": "1.6.2",
+  "version": "1.6.3",
   "type": "module",
   "files": [
     "dist"