Add UI module with related types and utilities in shared package

Author: nikosdouvlis

packages/shared/package.json

@@ -70,6 +70,16 @@
         "default": "./dist/runtime/dom/index.js"
       }
     },
+    "./ui": {
+      "import": {
+        "types": "./dist/runtime/ui/index.d.mts",
+        "default": "./dist/runtime/ui/index.mjs"
+      },
+      "require": {
+        "types": "./dist/runtime/ui/index.d.ts",
+        "default": "./dist/runtime/ui/index.js"
+      }
+    },
     "./types": {
       "import": {
         "types": "./dist/types/index.d.mts",

packages/shared/src/ui/index.ts

@@ -0,0 +1,7 @@
+/**
+ * UI-related utilities and types for Clerk components
+ *
+ * @module @clerk/shared/ui
+ */
+
+export * from './types';

packages/shared/src/ui/types.ts

@@ -0,0 +1,29 @@
+/**
+ * UI-related types and utilities
+ */
+
+// Placeholder - Add UI-specific types and utilities here
+export type UIVersion = string;
+
+// TODO: replace with a proper interface
+export type MountComponentRenderer = (
+  clerk: any,
+  environment: any,
+  options: any,
+) => {
+  ensureMounted: (options?: { preloadHint?: string }) => Promise<{
+    mountImpersonationFab: () => void;
+    updateProps: (props: any) => void;
+    openModal: (name: string, props: any) => void;
+    closeModal: (name: string) => void;
+    openDrawer: (name: string, props: any) => void;
+    closeDrawer: (name: string) => void;
+    mountComponent: (config: any) => void;
+    unmountComponent: (config: any) => void;
+    prefetch: (name: string) => void;
+  }>;
+};
+
+export interface ClerkUiEntry {
+  resolve: () => Promise<MountComponentRenderer>;
+}

packages/shared/tsdown.config.mts

@@ -42,6 +42,7 @@ export default defineConfig(({ watch }) => {
         './src/workerTimers/index.ts',
         './src/types/index.ts',
         './src/dom/*.ts',
+        './src/ui/index.ts',
         './src/internal/clerk-js/*.ts',
         './src/internal/clerk-js/**/*.ts',
         '!./src/**/*.{test,spec}.{ts,tsx}',