@tpzdsp/next-toolkit 1.0.1

package/src/utils/renderers.tsx

@@ -0,0 +1,68 @@
+import type { ReactElement, ReactNode } from 'react';
+
+import {
+  type RenderHookOptions,
+  type RenderHookResult,
+  render,
+  renderHook,
+} from '@testing-library/react';
+
+type WrapperParams = {
+  children: ReactNode;
+};
+
+type Options = {
+  initialEntries?: string[];
+  renderHookOptions?: RenderHookOptions<unknown>;
+};
+
+/**
+ * A custom testing-library component renderer that wraps the component being
+ * rendered with any Providers used in the app. Any test can pre-configure the
+ * Providers, to be in any state they wish.
+ *
+ * @param ui The component to render.
+ * @param options The options to configure any providers.
+ *
+ * @returns The rendered component.
+ */
+const customRender = (ui: ReactElement, options?: Options) => {
+  const { renderHookOptions } = options ?? {};
+
+  return render(ui, {
+    wrapper: ({ children }: WrapperParams): ReactElement => <>{children}</>,
+    ...renderHookOptions,
+  });
+};
+
+/**
+ * A custom testing-library hook renderer that wraps the hook being rendered
+ * with any Providers used in the app. Any test can pre-configure the
+ * Providers, to be in any state they wish.
+ *
+ * @param callback A function wrapping the hook being rendered.
+ * @param options The options to configure any providers.
+ *
+ * @returns The rendered hook.
+ */
+const customRenderHook = <T, P>(
+  callback: () => unknown,
+  options?: Options,
+): RenderHookResult<T, P> => {
+  const { renderHookOptions } = options ?? {};
+
+  const wrapper = ({ children }: WrapperParams): ReactElement => <>{children}</>;
+
+  const utils = renderHook(() => callback(), { wrapper, ...renderHookOptions });
+
+  return utils as RenderHookResult<T, P>;
+};
+
+export { screen, waitFor, within, act } from '@testing-library/react';
+export { default as userEvent } from '@testing-library/user-event';
+
+// Override render export with our custom render function.
+export { customRender as render };
+
+// Override renderHook export with our custom renderHook function.
+export { customRenderHook as renderHook };

package/src/utils/utils.ts

@@ -0,0 +1,63 @@
+import { decode } from 'jsonwebtoken';
+import { twMerge } from 'tailwind-merge';
+
+import type { Credentials, DecodedJWT } from '../types';
+
+export const decodeAuthToken = (token: string): Credentials | null => {
+  if (!token) {
+    return null;
+  }
+
+  try {
+    const user = decode(token) as unknown as DecodedJWT;
+
+    return { token, user };
+  } catch {
+    return null;
+  }
+};
+
+/**
+ * Utility function to merge Tailwind CSS classes with conflict resolution
+ * Uses tailwind-merge to handle conflicting utility classes
+ */
+export const cn = (...classes: (string | undefined | null | false)[]): string => {
+  return twMerge(classes.filter(Boolean).join(' '));
+};
+
+/**
+ * Debounce utility function
+ */
+export const debounce = <T extends (...args: never[]) => unknown>(
+  func: T,
+  wait: number,
+): ((...args: Parameters<T>) => void) => {
+  let timeout: ReturnType<typeof setTimeout>;
+
+  return (...args: Parameters<T>) => {
+    const later = () => {
+      clearTimeout(timeout);
+      func(...args);
+    };
+
+    clearTimeout(timeout);
+    timeout = setTimeout(later, wait);
+  };
+};
+
+/**
+ * Format bytes to human readable format
+ */
+export const formatBytes = (bytes: number, decimals = 2): string => {
+  if (bytes === 0) {
+    return '0 Bytes';
+  }
+
+  const k = 1024;
+  const dm = decimals < 0 ? 0 : decimals;
+  const sizes = ['Bytes', 'KB', 'MB', 'GB', 'TB', 'PB', 'EB', 'ZB', 'YB'];
+
+  const i = Math.floor(Math.log(bytes) / Math.log(k));
+
+  return parseFloat((bytes / Math.pow(k, i)).toFixed(dm)) + ' ' + sizes[i];
+};

package/src/vite-env.d.ts

@@ -0,0 +1,17 @@
+/// <reference types="vite/client" />
+
+// CSS module declarations
+declare module '*.css' {
+  const content: string;
+  export default content;
+}
+
+declare module '*.scss' {
+  const content: string;
+  export default content;
+}
+
+declare module '*.sass' {
+  const content: string;
+  export default content;
+}