@tailorkit/react 0.1.0-beta.1 → 0.1.0-beta.11

package/dist/node-store.d.ts

@@ -14,4 +14,3 @@ export declare class NodeStore {
     subscribeRoot(listener: Listener): () => void;
 }
 export {};
-//# sourceMappingURL=node-store.d.ts.map

package/dist/primitives.d.ts

@@ -2,37 +2,28 @@ import type { CSSProperties, ReactNode } from "react";
 import type { TailorKitTheme } from "@tailorkit/core/schema";
 type PrimitiveProps = Record<string, unknown>;
 interface PrimitiveThemeContextValue {
-    screenId: string;
+    viewId: string;
     theme: TailorKitTheme;
 }
 export declare const PrimitiveThemeContext: import("react").Context<PrimitiveThemeContextValue | null>;
-export declare const buildThemeCss: (screenId: string, theme: TailorKitTheme) => string;
+export declare const buildThemeCss: (viewId: string, theme: TailorKitTheme) => string;
 export declare const primitives: {
-    readonly Box: ({ props, slots }: {
+    readonly Box: ({ props, children }: {
         props: PrimitiveProps;
-        slots: {
-            default?: ReactNode;
-        };
+        children?: ReactNode;
     }) => import("react").JSX.Element;
-    readonly Flex: ({ props, slots }: {
+    readonly Flex: ({ props, children }: {
         props: PrimitiveProps;
-        slots: {
-            default?: ReactNode;
-        };
+        children?: ReactNode;
     }) => import("react").JSX.Element;
-    readonly Grid: ({ props, slots }: {
+    readonly Grid: ({ props, children }: {
         props: PrimitiveProps;
-        slots: {
-            default?: ReactNode;
-        };
+        children?: ReactNode;
     }) => import("react").JSX.Element;
-    readonly Inline: ({ props, slots }: {
+    readonly Inline: ({ props, children }: {
         props: PrimitiveProps;
-        slots: {
-            default?: ReactNode;
-        };
+        children?: ReactNode;
     }) => import("react").JSX.Element;
 };
 export type PrimitiveStyle = CSSProperties;
 export {};
-//# sourceMappingURL=primitives.d.ts.map

package/dist/remote-context.d.ts

@@ -1,9 +1,8 @@
-import type { HostToWorkerPayload } from "@tailorkit/sandbox/protocol";
+import type { HostToIframePayload } from "@tailorkit/sandbox/protocol";
 import type { NodeStore } from "./node-store";
 export interface RemoteViewContext {
     components: Record<string, unknown>;
-    dispatch: (payload: HostToWorkerPayload) => void;
+    dispatch: (payload: HostToIframePayload) => void;
     store: NodeStore;
 }
 export declare const RemoteUIContext: import("react").Context<RemoteViewContext | null>;
-//# sourceMappingURL=remote-context.d.ts.map

package/dist/remote-view.d.ts

@@ -4,12 +4,11 @@ interface RemoteViewHostProps {
     components: Record<string, unknown>;
     createIframe?: () => HTMLIFrameElement;
     props?: Record<string, unknown>;
-    runtimeUrl?: string | URL;
 }
-export declare function RemoteViewHost({ appUrl, components, createIframe, props, runtimeUrl, }: RemoteViewHostProps): ReactNode;
+export declare function RemoteViewHost({ appUrl, components, createIframe, props, }: RemoteViewHostProps): ReactNode;
 interface RemoteViewProps {
     nodeId: string;
 }
-export declare const RemoteView: import("react").MemoExoticComponent<({ nodeId }: RemoteViewProps) => ReactNode>;
+declare function RemoteViewComponent({ nodeId }: RemoteViewProps): ReactNode;
+export declare const RemoteView: import("react").MemoExoticComponent<typeof RemoteViewComponent>;
 export {};
-//# sourceMappingURL=remote-view.d.ts.map

package/dist/store.d.ts

@@ -0,0 +1,33 @@
+import type { TailorKitSchemaSpecType } from "@tailorkit/core/spec";
+import type { TailorKitApp } from "./tailor-kit";
+export interface TailorKitAppsSnapshot {
+    apps: TailorKitApp[];
+    error: Error | null;
+    status: "error" | "idle" | "loading" | "ready";
+}
+interface TailorKitMetaSnapshot {
+    assetsBaseUrl: string | null;
+    error: Error | null;
+    schema: TailorKitSchemaSpecType | null;
+    status: "error" | "idle" | "loading" | "ready";
+}
+export type TailorKitStore = ReturnType<typeof createTailorKitStore>;
+export declare function createTailorKitStore(baseUrlInput: string | URL, initialApps?: TailorKitApp[], previewSessionId?: string): {
+    baseUrl: URL;
+    views: {
+        getSnapshot: () => import("@tailorkit/core/views").ActiveView | null;
+        subscribe(listener: () => void): () => void;
+        register(entry: Omit<import("./view-registry").ViewEntry, "order">): void;
+        unregister(id: symbol): void;
+    };
+    setProvidedApps(apps: TailorKitApp[] | undefined): void;
+    fetchApps: (options?: {
+        force?: boolean;
+    }) => Promise<void>;
+    fetchMeta: () => Promise<void>;
+    getAppsSnapshot: () => TailorKitAppsSnapshot;
+    getMetaSnapshot: () => TailorKitMetaSnapshot;
+    subscribe: (listener: () => void) => (() => void);
+};
+export declare function toBaseUrl(value: string | URL): URL;
+export {};

package/dist/tailor-kit.d.ts

@@ -1,17 +1,13 @@
 import type { ReactNode } from "react";
-import type { TailorKitSchemaSpecType } from "@tailorkit/core/spec";
-import type { TailorKitTheme, CallbackMap, ComponentDefinition, ComponentProps, ComponentSlots, Schema, ScreenDefinition, TailorKitSchema } from "@tailorkit/core/schema";
+import type { TailorKitTheme, CallbackMap, ComponentDefinition, ComponentProps, Schema, ViewDefinition, SlotDefinitions, TailorKitSchema } from "@tailorkit/core/schema";
 import type { primitives } from "./primitives";
-import { Root } from "./components";
-import type { UseAppsResult } from "./hooks/use-apps";
-import type { CurrentScreenOptions, ScreenName } from "./hooks/use-current-screen";
-type ReactComponentSlots<TComponent> = {
-    [TSlot in keyof ComponentSlots<TComponent>]: ReactNode;
-};
-type AnyComponentDefinition = ComponentDefinition<Schema | undefined, CallbackMap, readonly string[] | undefined>;
+import type { ViewOptions, ViewName } from "./hooks/use-view";
+type AnyComponentDefinition = ComponentDefinition<Schema | undefined, CallbackMap, boolean | undefined>;
 type ComponentRenderer<TComponent extends AnyComponentDefinition> = (args: {
     props: ComponentProps<TComponent>;
-    slots: ReactComponentSlots<TComponent>;
+    children?: TComponent extends {
+        children: true;
+    } ? ReactNode : never;
 }) => ReactNode;
 type ComponentRenderers<TComponents extends Record<string, AnyComponentDefinition>> = {
     [TName in keyof TComponents]?: ComponentRenderer<TComponents[TName]>;
@@ -23,64 +19,75 @@ export interface TailorKitApp {
     clientPath?: string;
     description?: string;
     id: string;
+    logoPaths?: {
+        dark?: string;
+        light?: string;
+    };
     projectId?: string;
     currentDeployment?: {
         id: string;
     } | null;
     name?: string;
-}
-export interface TailorKitAppsSnapshot {
-    apps: TailorKitApp[];
-    error: Error | null;
-    status: "error" | "idle" | "loading" | "ready";
-}
-interface TailorKitMetaSnapshot {
-    assetsBaseUrl: string | null;
-    error: Error | null;
-    schema: TailorKitSchemaSpecType | null;
-    status: "error" | "idle" | "loading" | "ready";
-}
-export interface CurrentScreenEntry {
-    context: unknown;
-    id: symbol;
-    order: number;
-    screen: string;
-    status: "error" | "loading" | "ready";
+    preview?: {
+        sessionId: string;
+        status: "connected" | "offline";
+    };
 }
 interface AppViewBaseProps {
     app: TailorKitApp;
     createIframe?: () => HTMLIFrameElement;
     fallback?: ReactNode;
-    runtimeUrl?: string | URL;
 }
-type AppViewScreenProps<TScreens extends Record<string, ScreenDefinition>, TScreen extends ScreenName<TScreens> = ScreenName<TScreens>> = [ScreenName<TScreens>] extends [never] ? {
+type AppViewViewProps<TViews extends Record<string, ViewDefinition>, TView extends ViewName<TViews> = ViewName<TViews>> = [ViewName<TViews>] extends [never] ? {
     context?: never;
-    screen?: never;
+    view?: never;
     status?: never;
 } : {
     context?: never;
-    screen?: never;
+    view?: never;
     status?: never;
-} | CurrentScreenOptions<TScreens, TScreen>;
-export type AppViewProps<TScreens extends Record<string, ScreenDefinition>, TScreen extends ScreenName<TScreens> = ScreenName<TScreens>> = AppViewBaseProps & AppViewScreenProps<TScreens, TScreen>;
-export interface TailorKitInstance<TScreens extends Record<string, ScreenDefinition> = Record<string, never>> {
-    AppView: (props: AppViewProps<TScreens>) => ReactNode;
-    Root: (props: Omit<Parameters<typeof Root>[0], "tailor">) => ReactNode;
-    getApp: (id: string) => TailorKitApp | undefined;
-    getApps: () => TailorKitApp[];
-    useApps: () => UseAppsResult;
-    useCurrentScreen: <TScreen extends ScreenName<TScreens>>(options: CurrentScreenOptions<TScreens, TScreen>) => void;
+} | ViewOptions<TViews, TView>;
+export type AppViewProps<TViews extends Record<string, ViewDefinition> = RegisteredViews, TView extends ViewName<TViews> = ViewName<TViews>> = {
+    [V in RegisteredSlots]: AppViewBaseProps & {
+        slot: V;
+    } & AppViewViewProps<TViews, Extract<TView, SlotView<V>>>;
+}[RegisteredSlots];
+export interface Register {
+}
+export type RegisteredViews = Register extends {
+    client: TailorKitInstance<infer S>;
+} ? S : Record<`/${string}`, ViewDefinition>;
+type RegisteredSlotMap = Register extends {
+    client: {
+        readonly $slots?: infer V;
+    };
+} ? V : SlotDefinitions;
+export type RegisteredSlots = keyof RegisteredSlotMap & string;
+type SlotView<V extends RegisteredSlots> = RegisteredSlotMap[V] extends {
+    views: readonly (infer P)[];
+} ? Extract<P, string> : never;
+export interface TailorKitInstance<TViews extends Record<string, ViewDefinition> = Record<string, ViewDefinition>, TSlots extends SlotDefinitions = SlotDefinitions> {
+    readonly $slots?: TSlots;
+    readonly $views?: TViews;
+    readonly baseUrl: string | URL;
+    /**
+     * A host-selected, scope-authorized local-development preview session.
+     * The host handler resolves this server-side before returning app URLs.
+     */
+    readonly previewSessionId?: string;
+    readonly components: Record<string, unknown>;
+    readonly theme: TailorKitTheme;
 }
 type PrimitiveRenderers = typeof primitives;
 type CustomComponentRenderers<TComponents extends Record<string, AnyComponentDefinition>> = {
     [TName in Exclude<keyof TComponents, keyof PrimitiveRenderers>]?: ComponentRenderer<TComponents[TName]>;
 };
-export declare function components<TComponents extends Record<string, AnyComponentDefinition>>(_schema: TailorKitSchema<TComponents, Record<string, ScreenDefinition>>, customComponents: CustomComponentRenderers<TComponents>): ComponentRenderers<TComponents>;
+export declare function components<TComponents extends Record<string, AnyComponentDefinition>>(_schema: TailorKitSchema<TComponents, Record<string, ViewDefinition>>, customComponents: CustomComponentRenderers<TComponents>): ComponentRenderers<TComponents>;
 interface TailorKitServerShape {
     $internal: {
         schema: {
             components: Record<string, unknown>;
-            screens: Record<string, unknown>;
+            views: Record<string, unknown>;
         };
     };
 }
@@ -88,30 +95,16 @@ type ServerComponentMap<TTailor extends TailorKitServerShape> = TTailor["$intern
 type ServerComponents<TTailor extends TailorKitServerShape> = {
     [TName in keyof ServerComponentMap<TTailor>]: ServerComponentMap<TTailor>[TName] extends AnyComponentDefinition ? ServerComponentMap<TTailor>[TName] : never;
 };
-type ServerScreenMap<TTailor extends TailorKitServerShape> = TTailor["$internal"]["schema"]["screens"];
-type ServerScreens<TTailor extends TailorKitServerShape> = {
-    [TName in keyof ServerScreenMap<TTailor>]: ServerScreenMap<TTailor>[TName] extends ScreenDefinition ? ServerScreenMap<TTailor>[TName] : never;
+type ServerViewMap<TTailor extends TailorKitServerShape> = TTailor["$internal"]["schema"]["views"];
+type ServerViews<TTailor extends TailorKitServerShape> = {
+    [TName in keyof ServerViewMap<TTailor>]: ServerViewMap<TTailor>[TName] extends ViewDefinition ? ServerViewMap<TTailor>[TName] : never;
 };
 export declare function createTailorKitClient<TTailor extends TailorKitServerShape>(options: {
     baseUrl: string | URL;
+    previewSessionId?: string;
     components?: CompleteComponentRenderers<ServerComponents<TTailor>>;
     theme?: TailorKitTheme;
-}): TailorKitInstance<ServerScreens<TTailor>>;
-export type TailorKitStore = ReturnType<typeof createTailorKitStore>;
-declare function createTailorKitStore(baseUrlInput: string | URL): {
-    baseUrl: URL;
-    fetchApps: (options?: {
-        force?: boolean;
-    }) => Promise<void>;
-    fetchMeta: () => Promise<void>;
-    getApp: (id: string) => TailorKitApp | undefined;
-    getApps: () => TailorKitApp[];
-    getAppsSnapshot: () => TailorKitAppsSnapshot;
-    getCurrentScreen: () => CurrentScreenEntry | null;
-    getMetaSnapshot: () => TailorKitMetaSnapshot;
-    registerScreen: (entry: Omit<CurrentScreenEntry, "order">) => void;
-    subscribe: (listener: () => void) => (() => void);
-    unregisterScreen: (id: symbol) => void;
-};
-export type { CurrentScreenOptions } from "./hooks/use-current-screen";
-//# sourceMappingURL=tailor-kit.d.ts.map
+}): TailorKitInstance<ServerViews<TTailor>, TTailor extends {
+    readonly $slots?: infer V extends SlotDefinitions;
+} ? V : SlotDefinitions>;
+export type { ViewOptions } from "./hooks/use-view";

package/dist/view-registry.d.ts

@@ -0,0 +1,14 @@
+import type { ActiveView, ViewStatus } from "@tailorkit/core/views";
+export interface ViewEntry {
+    id: symbol;
+    view: string;
+    context: unknown;
+    status: ViewStatus;
+    order: number;
+}
+export declare function createViewRegistry(): {
+    getSnapshot: () => ActiveView | null;
+    subscribe(listener: () => void): () => void;
+    register(entry: Omit<ViewEntry, "order">): void;
+    unregister(id: symbol): void;
+};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tailorkit/react",
-  "version": "0.1.0-beta.1",
-  "license": "AGPL-3.0-only",
+  "version": "0.1.0-beta.11",
+  "license": "Apache-2.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/AlfieJones/tailorkit.git",
@@ -11,18 +11,8 @@
     "dist"
   ],
   "type": "module",
-  "imports": {
-    "#*": [
-      "./src/*",
-      "./src/*.ts",
-      "./src/*.tsx",
-      "./src/*/index.ts",
-      "./src/*/index.tsx"
-    ]
-  },
   "exports": {
     ".": {
-      "development": "./src/index.ts",
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     }
@@ -33,20 +23,20 @@
   "dependencies": {
     "@floating-ui/react-dom": "^2.1.9",
     "@standard-schema/spec": "^1.1.0",
-    "@tailorkit/core": "0.1.0-beta.1",
-    "@tailorkit/sandbox": "0.1.0-beta.1"
+    "@tailorkit/core": "0.1.0-beta.11",
+    "@tailorkit/sandbox": "0.1.0-beta.11"
   },
   "devDependencies": {
     "@tailorkit/config": "0.0.0",
-    "@testing-library/react": "^16.3.2",
+    "@testing-library/react": "^16.3.3",
     "@types/node": "26.2.0",
-    "@types/react": "^19.2.18",
-    "happy-dom": "^20.11.6",
-    "react": "^19.2.8",
-    "react-dom": "^19.2.8",
+    "@types/react": "^19.3.0",
+    "happy-dom": "^20.14.5",
+    "react": "^19.3.0",
+    "react-dom": "^19.3.0",
     "tsup": "^8.5.1",
     "typescript": "^7.0.2",
-    "vitest": "^4.1.11"
+    "vitest": "^5.0.0"
   },
   "peerDependencies": {
     "react": ">=19.2.6"