@tailorkit/react 0.1.0-beta.19 → 0.1.0-beta.21

package/README.md

@@ -0,0 +1,3 @@
+# TailorKit React
+
+React components and hooks for integrating TailorKit into your SaaS.

package/dist/components/context.d.ts

@@ -1,4 +1,4 @@
-import type { TailorKitStore } from "../store";
+import type { TailorKitStore } from "@tailorkit/client-core";
 import type { TailorKitClientConfig } from "../tailorkit";
 export interface TailorRootContextValue {
     store: TailorKitStore;

package/dist/components/slot.d.ts

@@ -1,7 +1,7 @@
+import type { ViewInstance } from "@tailorkit/app/client";
 import type { SlotDefinitions, ViewDefinition } from "@tailorkit/core/schema";
 import type { ReactNode } from "react";
 import type { ViewContext, ViewName } from "../hooks/use-register-view";
-import type { SlotInstance } from "../hooks/use-slot-instances";
 import type { TailorKitApp } from "../tailorkit";
 type DefaultViews = Record<`/${string}`, ViewDefinition>;
 type ContextPaths<TViews extends Record<string, ViewDefinition>, TView extends ViewName<TViews>> = {
@@ -11,24 +11,33 @@ type ContextFields<TView> = undefined extends ViewContext<TView> ? Partial<Exclu
 export type SlotContext<TViews extends Record<string, ViewDefinition>, TView extends ViewName<TViews>> = {
     [P in ContextPaths<TViews, TView>]: (context: ContextFields<TViews[P]>) => void;
 }[ContextPaths<TViews, TView>] extends (context: infer TContext) => void ? TContext : never;
-export interface SlotProps<TSlots extends SlotDefinitions = SlotDefinitions> {
-    app: TailorKitApp;
-    /** The host slot to render in. */
-    name: keyof TSlots & string;
-    /** Select an instance of the matching view. */
-    instanceKey?: string;
-}
+type InstanceProps<TSlot, TKey extends string, TValue> = boolean extends (TSlot extends {
+    multiple?: infer T;
+} ? T : false) ? {
+    [K in TKey]?: TValue;
+} : TSlot extends {
+    multiple: true;
+} ? {
+    [K in TKey]: TValue;
+} : {
+    [K in TKey]?: never;
+};
+export type SlotProps<TSlots extends SlotDefinitions = SlotDefinitions> = {
+    [TSlot in keyof TSlots & string]: {
+        app: TailorKitApp;
+        name: TSlot;
+    } & InstanceProps<TSlots[TSlot], "instanceKey", string>;
+}[keyof TSlots & string];
 export type ControlledSlotProps<TViews extends Record<string, ViewDefinition> = DefaultViews, TSlots extends SlotDefinitions = SlotDefinitions> = {
     [TSlot in keyof TSlots & string]: {
         [TView in Extract<ViewName<TViews>, TSlots[TSlot]["views"][number]>]: {
             app: TailorKitApp;
             name: TSlot;
             view: TView;
-        } & ({
+        } & (({
             context: SlotContext<TViews, TView>;
             status: "ready";
-            instance?: SlotInstance;
-        } | {
+        } & InstanceProps<TSlots[TSlot], "instance", ViewInstance>) | {
             context?: never;
             status: "loading" | "error";
             instance?: never;

package/dist/hooks/use-apps.d.ts

@@ -1,12 +1,13 @@
 import type { TailorKitApp } from "../tailorkit";
-import type { TailorKitAppsSnapshot, TailorKitStore } from "../store";
-export interface UseAppsOptions<TScopeNames extends string = string> {
+import type { FetchCacheOptions, TailorKitAppsSnapshot, TailorKitStore } from "@tailorkit/client-core";
+export interface UseAppsOptions<TScopeNames extends string = string> extends Pick<FetchCacheOptions, "staleTime"> {
     scopes?: readonly TScopeNames[];
     appIds?: readonly string[];
 }
 export interface UseAppsResult {
     data: TailorKitApp[] | undefined;
     error: Error | null;
+    isFetching: boolean;
     isError: boolean;
     isLoading: boolean;
     isPending: boolean;
@@ -16,6 +17,6 @@ export interface UseAppsResult {
 }
 export declare function useApps(options?: UseAppsOptions): UseAppsResult;
 export declare function useAppsStore(store: TailorKitStore, options?: UseAppsOptions): UseAppsResult;
-export declare function matchesApp(app: TailorKitApp, scopes?: readonly string[], appIds?: readonly string[]): boolean;
-export declare function useAppsSnapshot(store: TailorKitStore): TailorKitAppsSnapshot;
+export { matchesApp } from "@tailorkit/client-core";
+export declare function useAppsSnapshot(store: TailorKitStore, options?: Pick<FetchCacheOptions, "staleTime">): TailorKitAppsSnapshot;
 export declare function toUseAppsResult(snapshot: TailorKitAppsSnapshot, refetch: () => Promise<void>): UseAppsResult;

package/dist/hooks/use-slot-instances.d.ts

@@ -1,13 +1,13 @@
-import type { ViewInstance } from "@tailorkit/app/client";
-import type { TailorKitApp } from "../tailorkit";
+import type { FetchCacheOptions, TailorKitApp, SlotInstance } from "@tailorkit/client-core";
 import type { UseAppsResult } from "./use-apps";
-export type SlotInstance = ViewInstance;
-export interface UseSlotInstancesOptions<TSlot extends string = string> {
-    app: TailorKitApp;
+export type { SlotInstance } from "@tailorkit/client-core";
+export interface UseSlotInstancesOptions<TSlot extends string = string> extends FetchCacheOptions {
     slot: TSlot;
 }
 export interface UseSlotInstancesResult extends Omit<UseAppsResult, "data"> {
     data: SlotInstance[] | undefined;
 }
-/** Fetch instances for the app's matching slot view using registered host context. */
-export declare function useSlotInstances({ app, slot }: UseSlotInstancesOptions): UseSlotInstancesResult;
+/** Resolve instances across discovered apps while sharing endpoint state in client-core. */
+export declare function useSlotInstances({ slot, staleTime, gcTime, }: UseSlotInstancesOptions): UseSlotInstancesResult;
+/** Managed Slot resolves only its explicitly supplied app. */
+export declare function useAppSlotInstances(app: TailorKitApp, slot: string): UseSlotInstancesResult;