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

package/dist/components/index.d.ts

@@ -1 +1,2 @@
 export { Root } from "./root";
+export { Slot } from "./slot";

package/dist/components/slot.d.ts

@@ -0,0 +1,42 @@
+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>> = {
+    [P in ViewName<TViews>]: P extends "/" | TView ? P : TView extends `${P}/${string}` ? P : never;
+}[ViewName<TViews>];
+type ContextFields<TView> = undefined extends ViewContext<TView> ? Partial<Exclude<ViewContext<TView>, undefined>> : ViewContext<TView>;
+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;
+}
+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;
+        } | {
+            context?: never;
+            status: "loading" | "error";
+            instance?: never;
+        });
+    }[Extract<ViewName<TViews>, TSlots[TSlot]["views"][number]>];
+}[keyof TSlots & string];
+export type SlotComponent<TViews extends Record<string, ViewDefinition> = DefaultViews, TSlots extends SlotDefinitions = SlotDefinitions> = ((props: SlotProps<TSlots>) => ReactNode) & {
+    Controlled: (props: ControlledSlotProps<TViews, TSlots>) => ReactNode;
+};
+export declare const Slot: SlotComponent;
+export {};

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

@@ -1,7 +1,8 @@
 import type { TailorKitApp } from "../tailorkit";
-import type { TailorKitStore } from "../store";
+import type { TailorKitAppsSnapshot, TailorKitStore } from "../store";
 export interface UseAppsOptions<TScopeNames extends string = string> {
     scopes?: readonly TScopeNames[];
+    appIds?: readonly string[];
 }
 export interface UseAppsResult {
     data: TailorKitApp[] | undefined;
@@ -15,3 +16,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 declare function toUseAppsResult(snapshot: TailorKitAppsSnapshot, refetch: () => Promise<void>): UseAppsResult;

package/dist/hooks/{use-view.d.ts → use-register-view.d.ts}

@@ -20,6 +20,6 @@ interface ErrorViewOptions<TView extends string> {
 }
 export type ViewOptions<TViews extends Record<string, ViewDefinition> = DefaultViews, TView extends ViewName<TViews> = ViewName<TViews>> = TView extends ViewName<TViews> ? ReadyViewOptions<TViews, TView> | LoadingViewOptions<TView> | ErrorViewOptions<TView> : never;
 export type ViewState<TViews extends Record<string, ViewDefinition> = DefaultViews, TView extends ViewName<TViews> = ViewName<TViews>> = Omit<ReadyViewOptions<TViews, TView>, "view"> | Omit<LoadingViewOptions<TView>, "view"> | Omit<ErrorViewOptions<TView>, "view">;
-export type UseView<TViews extends Record<string, ViewDefinition>> = <TView extends ViewName<TViews>>(view: TView, options: ViewState<TViews, NoInfer<TView>>) => void;
-export declare function useView<TViews extends Record<string, ViewDefinition> = DefaultViews, TView extends ViewName<TViews> = ViewName<TViews>>(view: TView, options: ViewState<TViews, NoInfer<TView>>): void;
+export type UseRegisterView<TViews extends Record<string, ViewDefinition>> = <TView extends ViewName<TViews>>(view: TView, options: ViewState<TViews, NoInfer<TView>>) => void;
+export declare function useRegisterView<TViews extends Record<string, ViewDefinition> = DefaultViews, TView extends ViewName<TViews> = ViewName<TViews>>(view: TView, options: ViewState<TViews, NoInfer<TView>>): void;
 export {};

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

@@ -0,0 +1,13 @@
+import type { ViewInstance } from "@tailorkit/app/client";
+import type { TailorKitApp } from "../tailorkit";
+import type { UseAppsResult } from "./use-apps";
+export type SlotInstance = ViewInstance;
+export interface UseSlotInstancesOptions<TSlot extends string = string> {
+    app: TailorKitApp;
+    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;

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

@@ -0,0 +1,9 @@
+import type { TailorKitView } from "../tailorkit";
+import type { UseAppsOptions, UseAppsResult } from "./use-apps";
+export interface UseViewsOptions<TScopeNames extends string = string, TSlot extends string = string> extends UseAppsOptions<TScopeNames> {
+    slot?: TSlot;
+}
+export interface UseViewsResult extends Omit<UseAppsResult, "data"> {
+    data: TailorKitView[] | undefined;
+}
+export declare function useViews(options?: UseViewsOptions): UseViewsResult;

package/dist/index.d.ts

@@ -1,7 +1,10 @@
-export { AppView } from "./components/app-view";
+export { Slot } from "./components/slot";
+export type { ControlledSlotProps, SlotComponent, SlotContext, SlotProps } from "./components/slot";
 export { components, createTailorKitClient } from "./tailorkit";
-export type { AppViewProps, TailorKitApp, TailorKitClientConfig, TailorKitInstance, } from "./tailorkit";
+export type { TailorKitApp, TailorKitView, TailorKitClientConfig, TailorKitInstance, } from "./tailorkit";
 export { Root } from "./components/root";
 export type { UseAppsOptions, UseAppsResult } from "./hooks/use-apps";
-export type { UseView, ViewOptions, ViewState } from "./hooks/use-view";
+export type { UseViewsOptions, UseViewsResult } from "./hooks/use-views";
+export type { SlotInstance, UseSlotInstancesOptions, UseSlotInstancesResult, } from "./hooks/use-slot-instances";
+export type { UseRegisterView, ViewOptions, ViewState } from "./hooks/use-register-view";
 export { primitives } from "./primitives";