@navios/di-react 0.1.1 → 0.2.0

package/lib/index.d.mts

@@ -1,18 +1,297 @@
-export { ContainerContext } from './_tsup-dts-rollup.mjs';
-export { ContainerProvider } from './_tsup-dts-rollup.mjs';
-export { ContainerProviderProps } from './_tsup-dts-rollup.mjs';
-export { ScopeContext } from './_tsup-dts-rollup.mjs';
-export { ScopeProvider } from './_tsup-dts-rollup.mjs';
-export { ScopeProviderProps } from './_tsup-dts-rollup.mjs';
-export { useContainer } from './_tsup-dts-rollup.mjs';
-export { useService } from './_tsup-dts-rollup.mjs';
-export { UseServiceResult } from './_tsup-dts-rollup.mjs';
-export { useSuspenseService } from './_tsup-dts-rollup.mjs';
-export { useOptionalService } from './_tsup-dts-rollup.mjs';
-export { UseOptionalServiceResult } from './_tsup-dts-rollup.mjs';
-export { useInvalidate } from './_tsup-dts-rollup.mjs';
-export { useInvalidateInstance } from './_tsup-dts-rollup.mjs';
-export { useScope } from './_tsup-dts-rollup.mjs';
-export { useScopeOrThrow } from './_tsup-dts-rollup.mjs';
-export { UnionToArray } from './_tsup-dts-rollup.mjs';
-export { Join } from './_tsup-dts-rollup.mjs';
+import * as react1 from "react";
+import { ReactNode } from "react";
+import { BoundInjectionToken, ClassType, Container, Factorable, FactoryInjectionToken, IContainer, InjectionToken, InjectionTokenSchemaType, ScopedContainer } from "@navios/di";
+import { ZodType, z } from "zod/v4";
+
+//#region src/providers/context.d.mts
+/**
+ * Context for the root Container.
+ * This is set by ContainerProvider and provides the base container.
+ */
+declare const ContainerContext: react1.Context<Container | null>;
+/**
+ * Context for the current ScopedContainer (if inside a ScopeProvider).
+ * This allows nested components to access request-scoped services.
+ */
+declare const ScopedContainerContext: react1.Context<ScopedContainer | null>;
+//#endregion
+//#region src/providers/container-provider.d.mts
+interface ContainerProviderProps {
+  container: Container;
+  children: ReactNode;
+}
+declare function ContainerProvider({
+  container,
+  children
+}: ContainerProviderProps): react1.ReactElement<unknown, string | react1.JSXElementConstructor<any>>;
+//#endregion
+//#region src/providers/scope-provider.d.mts
+interface ScopeProviderProps {
+  /**
+   * Optional explicit scope ID. If not provided, a unique ID will be generated.
+   * Useful when you need to reference the scope externally.
+   */
+  scopeId?: string;
+  /**
+   * Optional metadata to attach to the request context.
+   * Can be used to pass data like user info, request headers, etc.
+   */
+  metadata?: Record<string, unknown>;
+  /**
+   * Priority for service resolution. Higher priority scopes take precedence.
+   * @default 100
+   */
+  priority?: number;
+  children: ReactNode;
+}
+/**
+ * ScopeProvider creates a new request scope for dependency injection.
+ *
+ * Services with `scope: 'Request'` will be instantiated once per ScopeProvider
+ * and shared among all components within that provider.
+ *
+ * This is useful for:
+ * - Table rows that need isolated state
+ * - Modal dialogs with their own service instances
+ * - Multi-tenant scenarios
+ * - Any case where you need isolated service instances
+ *
+ * @example
+ * ```tsx
+ * // Each row gets its own RowStateService instance
+ * {rows.map(row => (
+ *   <ScopeProvider key={row.id} scopeId={row.id} metadata={{ rowData: row }}>
+ *     <TableRow />
+ *   </ScopeProvider>
+ * ))}
+ * ```
+ */
+declare function ScopeProvider({
+  scopeId,
+  metadata,
+  priority,
+  children
+}: ScopeProviderProps): react1.ReactElement<unknown, string | react1.JSXElementConstructor<any>> | null;
+//#endregion
+//#region src/hooks/use-container.d.mts
+/**
+ * Hook to get the current container (ScopedContainer if inside ScopeProvider, otherwise Container).
+ *
+ * This is the primary hook for accessing the DI container. It automatically
+ * returns the correct container based on context:
+ * - Inside a ScopeProvider: returns the ScopedContainer for request-scoped services
+ * - Outside a ScopeProvider: returns the root Container
+ *
+ * @returns The current container (ScopedContainer or Container)
+ */
+declare function useContainer(): IContainer;
+/**
+ * Hook to get the root Container, regardless of whether we're inside a ScopeProvider.
+ *
+ * Use this when you need access to the root container specifically,
+ * for example to create new request scopes programmatically.
+ *
+ * @returns The root Container
+ */
+declare function useRootContainer(): Container;
+//#endregion
+//#region src/types.d.mts
+type UnionToArray<T> = UnionToArrayImpl<T, never>;
+type UnionToArrayImpl<T, L extends any[]> = T extends any ? UnionToArrayImpl<Exclude<T, T>, [...L, T]> : L;
+type Join<T extends any[], Delimiter extends string> = T extends [] ? '' : T extends [infer First extends string | number | symbol] ? First extends string | number ? `${First}` : never : T extends [infer First extends string | number | symbol, ...infer Rest extends any[]] ? First extends string | number ? `${First}${Delimiter}${Join<Rest, Delimiter>}` : never : '';
+//#endregion
+//#region src/hooks/use-service.d.mts
+interface UseServiceResult<T> {
+  data: T | undefined;
+  error: Error | undefined;
+  isLoading: boolean;
+  isSuccess: boolean;
+  isError: boolean;
+  refetch: () => void;
+}
+declare function useService<T extends ClassType>(token: T): UseServiceResult<InstanceType<T> extends Factorable<infer R> ? R : InstanceType<T>>;
+declare function useService<T, S extends InjectionTokenSchemaType>(token: InjectionToken<T, S>, args: z.input<S>): UseServiceResult<T>;
+declare function useService<T, S extends InjectionTokenSchemaType, R extends boolean>(token: InjectionToken<T, S, R>): R extends false ? UseServiceResult<T> : S extends ZodType<infer Type> ? `Error: Your token requires args: ${Join<UnionToArray<keyof Type>, ', '>}` : 'Error: Your token requires args';
+declare function useService<T>(token: InjectionToken<T, undefined>): UseServiceResult<T>;
+declare function useService<T>(token: BoundInjectionToken<T, any>): UseServiceResult<T>;
+declare function useService<T>(token: FactoryInjectionToken<T, any>): UseServiceResult<T>;
+//#endregion
+//#region src/hooks/use-suspense-service.d.mts
+declare function useSuspenseService<T extends ClassType>(token: T): InstanceType<T> extends Factorable<infer R> ? R : InstanceType<T>;
+declare function useSuspenseService<T, S extends InjectionTokenSchemaType>(token: InjectionToken<T, S>, args: z.input<S>): T;
+declare function useSuspenseService<T, S extends InjectionTokenSchemaType, R extends boolean>(token: InjectionToken<T, S, R>): R extends false ? T : S extends ZodType<infer Type> ? `Error: Your token requires args: ${Join<UnionToArray<keyof Type>, ', '>}` : 'Error: Your token requires args';
+declare function useSuspenseService<T>(token: InjectionToken<T, undefined>): T;
+declare function useSuspenseService<T>(token: BoundInjectionToken<T, any>): T;
+declare function useSuspenseService<T>(token: FactoryInjectionToken<T, any>): T;
+//#endregion
+//#region src/hooks/use-optional-service.d.mts
+interface UseOptionalServiceResult<T> {
+  /**
+   * The service instance if found and loaded successfully, otherwise undefined.
+   */
+  data: T | undefined;
+  /**
+   * Error that occurred during loading (excludes "not found" which is not an error).
+   */
+  error: Error | undefined;
+  /**
+   * True while the service is being loaded.
+   */
+  isLoading: boolean;
+  /**
+   * True if the service was loaded successfully.
+   */
+  isSuccess: boolean;
+  /**
+   * True if the service was not found (not registered in the container).
+   */
+  isNotFound: boolean;
+  /**
+   * True if an error occurred during loading.
+   */
+  isError: boolean;
+  /**
+   * Function to manually re-fetch the service.
+   */
+  refetch: () => void;
+}
+declare function useOptionalService<T extends ClassType>(token: T): UseOptionalServiceResult<InstanceType<T> extends Factorable<infer R> ? R : InstanceType<T>>;
+declare function useOptionalService<T, S extends InjectionTokenSchemaType>(token: InjectionToken<T, S>, args: z.input<S>): UseOptionalServiceResult<T>;
+declare function useOptionalService<T, S extends InjectionTokenSchemaType, R extends boolean>(token: InjectionToken<T, S, R>): R extends false ? UseOptionalServiceResult<T> : S extends ZodType<infer Type> ? `Error: Your token requires args: ${Join<UnionToArray<keyof Type>, ', '>}` : 'Error: Your token requires args';
+declare function useOptionalService<T>(token: InjectionToken<T, undefined>): UseOptionalServiceResult<T>;
+declare function useOptionalService<T>(token: BoundInjectionToken<T, any>): UseOptionalServiceResult<T>;
+declare function useOptionalService<T>(token: FactoryInjectionToken<T, any>): UseOptionalServiceResult<T>;
+//#endregion
+//#region src/hooks/use-invalidate.d.mts
+type InvalidatableToken = ClassType | InjectionToken<any, any> | BoundInjectionToken<any, any> | FactoryInjectionToken<any, any>;
+/**
+ * Hook that returns a function to invalidate a service by its token.
+ *
+ * When called, this will:
+ * 1. Destroy the current service instance
+ * 2. Trigger re-fetch in all components using useService/useSuspenseService for that token
+ *
+ * @example
+ * ```tsx
+ * function UserProfile() {
+ *   const { data: user } = useService(UserService)
+ *   const invalidateUser = useInvalidate(UserService)
+ *
+ *   const handleRefresh = () => {
+ *     invalidateUser() // All components using UserService will re-fetch
+ *   }
+ *
+ *   return (
+ *     <div>
+ *       <span>{user?.name}</span>
+ *       <button onClick={handleRefresh}>Refresh</button>
+ *     </div>
+ *   )
+ * }
+ * ```
+ */
+declare function useInvalidate<T extends InvalidatableToken>(token: T): () => Promise<void>;
+/**
+ * Hook that returns a function to invalidate a service by its token with args.
+ *
+ * @example
+ * ```tsx
+ * function UserProfile({ userId }: { userId: string }) {
+ *   const args = useMemo(() => ({ userId }), [userId])
+ *   const { data: user } = useService(UserToken, args)
+ *   const invalidateUser = useInvalidate(UserToken, args)
+ *
+ *   return (
+ *     <div>
+ *       <span>{user?.name}</span>
+ *       <button onClick={() => invalidateUser()}>Refresh</button>
+ *     </div>
+ *   )
+ * }
+ * ```
+ */
+declare function useInvalidate<T, S extends InjectionTokenSchemaType>(token: InjectionToken<T, S>, args: S extends undefined ? never : unknown): () => Promise<void>;
+/**
+ * Hook that returns a function to invalidate a service instance directly.
+ *
+ * This is useful when you have the service instance and want to invalidate it
+ * without knowing its token.
+ *
+ * @example
+ * ```tsx
+ * function UserProfile() {
+ *   const { data: user } = useService(UserService)
+ *   const invalidateInstance = useInvalidateInstance()
+ *
+ *   const handleRefresh = () => {
+ *     if (user) {
+ *       invalidateInstance(user)
+ *     }
+ *   }
+ *
+ *   return (
+ *     <div>
+ *       <span>{user?.name}</span>
+ *       <button onClick={handleRefresh}>Refresh</button>
+ *     </div>
+ *   )
+ * }
+ * ```
+ */
+declare function useInvalidateInstance(): (instance: unknown) => Promise<void>;
+//#endregion
+//#region src/hooks/use-scope.d.mts
+/**
+ * Hook to get the current scope ID.
+ * Returns null if not inside a ScopeProvider.
+ */
+declare function useScope(): string | null;
+/**
+ * Hook to get the current scope ID, throwing if not inside a ScopeProvider.
+ * Use this when your component requires a scope to function correctly.
+ */
+declare function useScopeOrThrow(): string;
+/**
+ * Hook to get the current ScopedContainer.
+ * Returns null if not inside a ScopeProvider.
+ *
+ * Use this to access scope metadata or other ScopedContainer methods.
+ *
+ * @example
+ * ```tsx
+ * function TableRow() {
+ *   const scope = useScopedContainer()
+ *   const rowData = scope?.getMetadata('rowData')
+ *   // ...
+ * }
+ * ```
+ */
+declare function useScopedContainer(): ScopedContainer | null;
+/**
+ * Hook to get the current ScopedContainer, throwing if not inside a ScopeProvider.
+ * Use this when your component requires a scope to function correctly.
+ */
+declare function useScopedContainerOrThrow(): ScopedContainer;
+/**
+ * Hook to get metadata from the current scope.
+ * Returns undefined if not inside a ScopeProvider or if the key doesn't exist.
+ *
+ * @example
+ * ```tsx
+ * // In parent component:
+ * <ScopeProvider metadata={{ userId: '123', theme: 'dark' }}>
+ *   <ChildComponent />
+ * </ScopeProvider>
+ *
+ * // In child component:
+ * function ChildComponent() {
+ *   const userId = useScopeMetadata<string>('userId')
+ *   const theme = useScopeMetadata<'light' | 'dark'>('theme')
+ *   // ...
+ * }
+ * ```
+ */
+declare function useScopeMetadata<T = unknown>(key: string): T | undefined;
+//#endregion
+export { ContainerContext, ContainerProvider, type ContainerProviderProps, Join, ScopeProvider, type ScopeProviderProps, ScopedContainerContext, UnionToArray, type UseOptionalServiceResult, type UseServiceResult, useContainer, useInvalidate, useInvalidateInstance, useOptionalService, useRootContainer, useScope, useScopeMetadata, useScopeOrThrow, useScopedContainer, useScopedContainerOrThrow, useService, useSuspenseService };
+//# sourceMappingURL=index.d.mts.map

package/lib/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/providers/context.mts","../src/providers/container-provider.mts","../src/providers/scope-provider.mts","../src/hooks/use-container.mts","../src/types.mts","../src/hooks/use-service.mts","../src/hooks/use-suspense-service.mts","../src/hooks/use-optional-service.mts","../src/hooks/use-invalidate.mts","../src/hooks/use-scope.mts"],"sourcesContent":[],"mappings":"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"}

package/lib/index.d.ts

@@ -1,18 +1,297 @@
-export { ContainerContext } from './_tsup-dts-rollup.js';
-export { ContainerProvider } from './_tsup-dts-rollup.js';
-export { ContainerProviderProps } from './_tsup-dts-rollup.js';
-export { ScopeContext } from './_tsup-dts-rollup.js';
-export { ScopeProvider } from './_tsup-dts-rollup.js';
-export { ScopeProviderProps } from './_tsup-dts-rollup.js';
-export { useContainer } from './_tsup-dts-rollup.js';
-export { useService } from './_tsup-dts-rollup.js';
-export { UseServiceResult } from './_tsup-dts-rollup.js';
-export { useSuspenseService } from './_tsup-dts-rollup.js';
-export { useOptionalService } from './_tsup-dts-rollup.js';
-export { UseOptionalServiceResult } from './_tsup-dts-rollup.js';
-export { useInvalidate } from './_tsup-dts-rollup.js';
-export { useInvalidateInstance } from './_tsup-dts-rollup.js';
-export { useScope } from './_tsup-dts-rollup.js';
-export { useScopeOrThrow } from './_tsup-dts-rollup.js';
-export { UnionToArray } from './_tsup-dts-rollup.js';
-export { Join } from './_tsup-dts-rollup.js';
+import * as react3 from "react";
+import { ReactNode } from "react";
+import { BoundInjectionToken, ClassType, Container, Factorable, FactoryInjectionToken, IContainer, InjectionToken, InjectionTokenSchemaType, ScopedContainer } from "@navios/di";
+import { ZodType, z } from "zod/v4";
+
+//#region src/providers/context.d.mts
+/**
+ * Context for the root Container.
+ * This is set by ContainerProvider and provides the base container.
+ */
+declare const ContainerContext: react3.Context<Container | null>;
+/**
+ * Context for the current ScopedContainer (if inside a ScopeProvider).
+ * This allows nested components to access request-scoped services.
+ */
+declare const ScopedContainerContext: react3.Context<ScopedContainer | null>;
+//#endregion
+//#region src/providers/container-provider.d.mts
+interface ContainerProviderProps {
+  container: Container;
+  children: ReactNode;
+}
+declare function ContainerProvider({
+  container,
+  children
+}: ContainerProviderProps): react3.ReactElement<unknown, string | react3.JSXElementConstructor<any>>;
+//#endregion
+//#region src/providers/scope-provider.d.mts
+interface ScopeProviderProps {
+  /**
+   * Optional explicit scope ID. If not provided, a unique ID will be generated.
+   * Useful when you need to reference the scope externally.
+   */
+  scopeId?: string;
+  /**
+   * Optional metadata to attach to the request context.
+   * Can be used to pass data like user info, request headers, etc.
+   */
+  metadata?: Record<string, unknown>;
+  /**
+   * Priority for service resolution. Higher priority scopes take precedence.
+   * @default 100
+   */
+  priority?: number;
+  children: ReactNode;
+}
+/**
+ * ScopeProvider creates a new request scope for dependency injection.
+ *
+ * Services with `scope: 'Request'` will be instantiated once per ScopeProvider
+ * and shared among all components within that provider.
+ *
+ * This is useful for:
+ * - Table rows that need isolated state
+ * - Modal dialogs with their own service instances
+ * - Multi-tenant scenarios
+ * - Any case where you need isolated service instances
+ *
+ * @example
+ * ```tsx
+ * // Each row gets its own RowStateService instance
+ * {rows.map(row => (
+ *   <ScopeProvider key={row.id} scopeId={row.id} metadata={{ rowData: row }}>
+ *     <TableRow />
+ *   </ScopeProvider>
+ * ))}
+ * ```
+ */
+declare function ScopeProvider({
+  scopeId,
+  metadata,
+  priority,
+  children
+}: ScopeProviderProps): react3.ReactElement<unknown, string | react3.JSXElementConstructor<any>> | null;
+//#endregion
+//#region src/hooks/use-container.d.mts
+/**
+ * Hook to get the current container (ScopedContainer if inside ScopeProvider, otherwise Container).
+ *
+ * This is the primary hook for accessing the DI container. It automatically
+ * returns the correct container based on context:
+ * - Inside a ScopeProvider: returns the ScopedContainer for request-scoped services
+ * - Outside a ScopeProvider: returns the root Container
+ *
+ * @returns The current container (ScopedContainer or Container)
+ */
+declare function useContainer(): IContainer;
+/**
+ * Hook to get the root Container, regardless of whether we're inside a ScopeProvider.
+ *
+ * Use this when you need access to the root container specifically,
+ * for example to create new request scopes programmatically.
+ *
+ * @returns The root Container
+ */
+declare function useRootContainer(): Container;
+//#endregion
+//#region src/types.d.mts
+type UnionToArray<T> = UnionToArrayImpl<T, never>;
+type UnionToArrayImpl<T, L extends any[]> = T extends any ? UnionToArrayImpl<Exclude<T, T>, [...L, T]> : L;
+type Join<T extends any[], Delimiter extends string> = T extends [] ? '' : T extends [infer First extends string | number | symbol] ? First extends string | number ? `${First}` : never : T extends [infer First extends string | number | symbol, ...infer Rest extends any[]] ? First extends string | number ? `${First}${Delimiter}${Join<Rest, Delimiter>}` : never : '';
+//#endregion
+//#region src/hooks/use-service.d.mts
+interface UseServiceResult<T> {
+  data: T | undefined;
+  error: Error | undefined;
+  isLoading: boolean;
+  isSuccess: boolean;
+  isError: boolean;
+  refetch: () => void;
+}
+declare function useService<T extends ClassType>(token: T): UseServiceResult<InstanceType<T> extends Factorable<infer R> ? R : InstanceType<T>>;
+declare function useService<T, S extends InjectionTokenSchemaType>(token: InjectionToken<T, S>, args: z.input<S>): UseServiceResult<T>;
+declare function useService<T, S extends InjectionTokenSchemaType, R extends boolean>(token: InjectionToken<T, S, R>): R extends false ? UseServiceResult<T> : S extends ZodType<infer Type> ? `Error: Your token requires args: ${Join<UnionToArray<keyof Type>, ', '>}` : 'Error: Your token requires args';
+declare function useService<T>(token: InjectionToken<T, undefined>): UseServiceResult<T>;
+declare function useService<T>(token: BoundInjectionToken<T, any>): UseServiceResult<T>;
+declare function useService<T>(token: FactoryInjectionToken<T, any>): UseServiceResult<T>;
+//#endregion
+//#region src/hooks/use-suspense-service.d.mts
+declare function useSuspenseService<T extends ClassType>(token: T): InstanceType<T> extends Factorable<infer R> ? R : InstanceType<T>;
+declare function useSuspenseService<T, S extends InjectionTokenSchemaType>(token: InjectionToken<T, S>, args: z.input<S>): T;
+declare function useSuspenseService<T, S extends InjectionTokenSchemaType, R extends boolean>(token: InjectionToken<T, S, R>): R extends false ? T : S extends ZodType<infer Type> ? `Error: Your token requires args: ${Join<UnionToArray<keyof Type>, ', '>}` : 'Error: Your token requires args';
+declare function useSuspenseService<T>(token: InjectionToken<T, undefined>): T;
+declare function useSuspenseService<T>(token: BoundInjectionToken<T, any>): T;
+declare function useSuspenseService<T>(token: FactoryInjectionToken<T, any>): T;
+//#endregion
+//#region src/hooks/use-optional-service.d.mts
+interface UseOptionalServiceResult<T> {
+  /**
+   * The service instance if found and loaded successfully, otherwise undefined.
+   */
+  data: T | undefined;
+  /**
+   * Error that occurred during loading (excludes "not found" which is not an error).
+   */
+  error: Error | undefined;
+  /**
+   * True while the service is being loaded.
+   */
+  isLoading: boolean;
+  /**
+   * True if the service was loaded successfully.
+   */
+  isSuccess: boolean;
+  /**
+   * True if the service was not found (not registered in the container).
+   */
+  isNotFound: boolean;
+  /**
+   * True if an error occurred during loading.
+   */
+  isError: boolean;
+  /**
+   * Function to manually re-fetch the service.
+   */
+  refetch: () => void;
+}
+declare function useOptionalService<T extends ClassType>(token: T): UseOptionalServiceResult<InstanceType<T> extends Factorable<infer R> ? R : InstanceType<T>>;
+declare function useOptionalService<T, S extends InjectionTokenSchemaType>(token: InjectionToken<T, S>, args: z.input<S>): UseOptionalServiceResult<T>;
+declare function useOptionalService<T, S extends InjectionTokenSchemaType, R extends boolean>(token: InjectionToken<T, S, R>): R extends false ? UseOptionalServiceResult<T> : S extends ZodType<infer Type> ? `Error: Your token requires args: ${Join<UnionToArray<keyof Type>, ', '>}` : 'Error: Your token requires args';
+declare function useOptionalService<T>(token: InjectionToken<T, undefined>): UseOptionalServiceResult<T>;
+declare function useOptionalService<T>(token: BoundInjectionToken<T, any>): UseOptionalServiceResult<T>;
+declare function useOptionalService<T>(token: FactoryInjectionToken<T, any>): UseOptionalServiceResult<T>;
+//#endregion
+//#region src/hooks/use-invalidate.d.mts
+type InvalidatableToken = ClassType | InjectionToken<any, any> | BoundInjectionToken<any, any> | FactoryInjectionToken<any, any>;
+/**
+ * Hook that returns a function to invalidate a service by its token.
+ *
+ * When called, this will:
+ * 1. Destroy the current service instance
+ * 2. Trigger re-fetch in all components using useService/useSuspenseService for that token
+ *
+ * @example
+ * ```tsx
+ * function UserProfile() {
+ *   const { data: user } = useService(UserService)
+ *   const invalidateUser = useInvalidate(UserService)
+ *
+ *   const handleRefresh = () => {
+ *     invalidateUser() // All components using UserService will re-fetch
+ *   }
+ *
+ *   return (
+ *     <div>
+ *       <span>{user?.name}</span>
+ *       <button onClick={handleRefresh}>Refresh</button>
+ *     </div>
+ *   )
+ * }
+ * ```
+ */
+declare function useInvalidate<T extends InvalidatableToken>(token: T): () => Promise<void>;
+/**
+ * Hook that returns a function to invalidate a service by its token with args.
+ *
+ * @example
+ * ```tsx
+ * function UserProfile({ userId }: { userId: string }) {
+ *   const args = useMemo(() => ({ userId }), [userId])
+ *   const { data: user } = useService(UserToken, args)
+ *   const invalidateUser = useInvalidate(UserToken, args)
+ *
+ *   return (
+ *     <div>
+ *       <span>{user?.name}</span>
+ *       <button onClick={() => invalidateUser()}>Refresh</button>
+ *     </div>
+ *   )
+ * }
+ * ```
+ */
+declare function useInvalidate<T, S extends InjectionTokenSchemaType>(token: InjectionToken<T, S>, args: S extends undefined ? never : unknown): () => Promise<void>;
+/**
+ * Hook that returns a function to invalidate a service instance directly.
+ *
+ * This is useful when you have the service instance and want to invalidate it
+ * without knowing its token.
+ *
+ * @example
+ * ```tsx
+ * function UserProfile() {
+ *   const { data: user } = useService(UserService)
+ *   const invalidateInstance = useInvalidateInstance()
+ *
+ *   const handleRefresh = () => {
+ *     if (user) {
+ *       invalidateInstance(user)
+ *     }
+ *   }
+ *
+ *   return (
+ *     <div>
+ *       <span>{user?.name}</span>
+ *       <button onClick={handleRefresh}>Refresh</button>
+ *     </div>
+ *   )
+ * }
+ * ```
+ */
+declare function useInvalidateInstance(): (instance: unknown) => Promise<void>;
+//#endregion
+//#region src/hooks/use-scope.d.mts
+/**
+ * Hook to get the current scope ID.
+ * Returns null if not inside a ScopeProvider.
+ */
+declare function useScope(): string | null;
+/**
+ * Hook to get the current scope ID, throwing if not inside a ScopeProvider.
+ * Use this when your component requires a scope to function correctly.
+ */
+declare function useScopeOrThrow(): string;
+/**
+ * Hook to get the current ScopedContainer.
+ * Returns null if not inside a ScopeProvider.
+ *
+ * Use this to access scope metadata or other ScopedContainer methods.
+ *
+ * @example
+ * ```tsx
+ * function TableRow() {
+ *   const scope = useScopedContainer()
+ *   const rowData = scope?.getMetadata('rowData')
+ *   // ...
+ * }
+ * ```
+ */
+declare function useScopedContainer(): ScopedContainer | null;
+/**
+ * Hook to get the current ScopedContainer, throwing if not inside a ScopeProvider.
+ * Use this when your component requires a scope to function correctly.
+ */
+declare function useScopedContainerOrThrow(): ScopedContainer;
+/**
+ * Hook to get metadata from the current scope.
+ * Returns undefined if not inside a ScopeProvider or if the key doesn't exist.
+ *
+ * @example
+ * ```tsx
+ * // In parent component:
+ * <ScopeProvider metadata={{ userId: '123', theme: 'dark' }}>
+ *   <ChildComponent />
+ * </ScopeProvider>
+ *
+ * // In child component:
+ * function ChildComponent() {
+ *   const userId = useScopeMetadata<string>('userId')
+ *   const theme = useScopeMetadata<'light' | 'dark'>('theme')
+ *   // ...
+ * }
+ * ```
+ */
+declare function useScopeMetadata<T = unknown>(key: string): T | undefined;
+//#endregion
+export { ContainerContext, ContainerProvider, type ContainerProviderProps, Join, ScopeProvider, type ScopeProviderProps, ScopedContainerContext, UnionToArray, type UseOptionalServiceResult, type UseServiceResult, useContainer, useInvalidate, useInvalidateInstance, useOptionalService, useRootContainer, useScope, useScopeMetadata, useScopeOrThrow, useScopedContainer, useScopedContainerOrThrow, useService, useSuspenseService };
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/providers/context.mts","../src/providers/container-provider.mts","../src/providers/scope-provider.mts","../src/hooks/use-container.mts","../src/types.mts","../src/hooks/use-service.mts","../src/hooks/use-suspense-service.mts","../src/hooks/use-optional-service.mts","../src/hooks/use-invalidate.mts","../src/hooks/use-scope.mts"],"sourcesContent":[],"mappings":"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"}