fansunited-management-components 1.50.7 → 1.50.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fansunited-management-components",
-  "version": "1.50.7",
+  "version": "1.50.9",
   "main": "index.es.js",
   "module": "index.es.js",
   "types": "index.d.ts",

package/src/context/ComponentContext.d.ts

@@ -0,0 +1,25 @@
+import { default as React, PropsWithChildren, ReactNode } from 'react';
+import { ComponentsMap } from '../constants/components';
+
+/**
+ * Provides a registry of public Fans United components by name.
+ * Use `useComponentContext()` to resolve components dynamically with preserved types.
+ */
+type ComponentProviderProps = {
+    config?: any;
+    children?: ReactNode;
+};
+/**
+ * React context mapping component names to their React function components.
+ * Uses explicit ComponentsMap interface to preserve individual component types.
+ */
+declare const ComponentContext: React.Context<ComponentsMap | null>;
+/**
+ * Provider that exposes the components registry to descendants with preserved types.
+ * Each component maintains its original prop types and JSDoc documentation.
+ *
+ * @param {{ config?: any; children?: React.ReactNode }} props
+ * @returns {JSX.Element}
+ */
+declare const ComponentProvider: React.FC<ComponentProviderProps & PropsWithChildren>;
+export { ComponentContext, ComponentProvider };

package/src/hooks/useComponentContext.d.ts

@@ -1,13 +1,30 @@
+import { ComponentsMap } from '../constants/components';
+
 /**
  * Hook to access the registry of public components provided by ComponentProvider.
- * Preserves individual component types and JSDoc documentation.
+ * Each component maintains its original type information, props, and JSDoc documentation.
  *
- * @returns {ComponentsMap} Registry of components with preserved types and JSDoc
+ * @returns {ComponentsMap} Registry of components with preserved individual types and JSDoc
  * @throws {Error} If used outside of a ComponentProvider.
  *
  * @example
  * ```tsx
  * const { Spinner, Login } = useComponentContext();
+ * // TypeScript will now show:
+ * // - Spinner with proper props (my: number) and JSDoc
+ * // - Login with its specific props and JSDoc
  * ```
  */
-export declare const useComponentContext: () => import('../constants/components').ComponentsMap;
+export declare const useComponentContext: () => ComponentsMap;
+/**
+ * Get a specific component with full type safety and JSDoc preservation.
+ *
+ * @example
+ * ```tsx
+ * const components = useComponentContext();
+ * const SpinnerComponent = getTypedComponent(components, 'Spinner');
+ * // SpinnerComponent now has full type info: React.FC<{my: number}>
+ * ```
+ */
+export declare function getTypedComponent<K extends keyof ComponentsMap>(components: ComponentsMap, componentName: K): ComponentsMap[K];
+export declare const useTypedComponentGetter: () => <K extends keyof ComponentsMap>(componentName: K) => ComponentsMap[K];

package/src/index.d.ts

@@ -1,3 +1,5 @@
+import { getTypedComponent } from './hooks/useComponentContext';
+
 declare const _default: {
     APIProvider: import('react').FC<{
         config: any;
@@ -25,5 +27,7 @@ declare const _default: {
         isMobile: boolean;
         isPhone: boolean;
     };
+    getTypedComponent: typeof getTypedComponent;
+    useTypedComponentGetter: () => <K extends keyof import('./constants/components').ComponentsMap>(componentName: K) => import('./constants/components').ComponentsMap[K];
 };
 export default _default;