@tailorkit/app 0.1.0-beta.3 → 0.1.0-beta.32

package/dist/views.d.ts

@@ -0,0 +1,126 @@
+import { h } from "preact";
+import type { ComponentChild, ComponentChildren, VNode } from "preact";
+import type { z } from "zod";
+import type { FunctionCalls, Identity } from "./server/functions";
+export interface TailorKitViews {
+}
+export interface TailorKitSlots {
+}
+export interface TailorKitServerFunctions {
+}
+export type ViewDataFields = Record<string, unknown>;
+export interface ViewInstance<TData = unknown> {
+    key: string;
+    metadata: ViewDataFields;
+    data: TData;
+}
+export interface InstanceResolverContext<TPath extends AppViewPath> {
+    context: ViewContext<TPath>;
+    identity: Identity;
+    signal: AbortSignal;
+    queries: FunctionCalls<TailorKitServerFunctions, "query">;
+}
+export interface ViewInstances<TPath extends AppViewPath, TSchema extends z.ZodType> {
+    dataSchema: TSchema;
+    /** Runs on the app server. Only registered queries are available. */
+    resolve: (context: InstanceResolverContext<TPath>) => ViewInstance<z.input<TSchema>>[] | Promise<ViewInstance<z.input<TSchema>>[]>;
+}
+export type SlotName = keyof TailorKitSlots & string;
+export type ViewPath = Extract<keyof TailorKitViews & string, `/${string}`>;
+export type AppViewPath = ViewPath;
+export type ViewProps<TPath extends ViewPath> = TailorKitViews[TPath] extends object ? TailorKitViews[TPath] : Record<string, never>;
+export type ViewPropsForPath<TPath extends AppViewPath> = TPath extends ViewPath ? ViewProps<TPath> : never;
+export type ViewContext<TPath extends AppViewPath> = ViewPropsForPath<TPath> extends {
+    context: infer TContext;
+} ? TContext : Record<string, never>;
+export type View<TProps extends object = Record<string, never>> = (props: TProps) => ComponentChild;
+export type ViewRuntimeProps<TPath extends AppViewPath, TData = unknown> = {
+    context: ViewContext<TPath>;
+    view: TPath;
+    status: "ready";
+    instance?: ViewInstance<TData>;
+} | {
+    context?: never;
+    view: TPath;
+    status: "loading";
+    instance?: never;
+} | {
+    context?: never;
+    view: TPath;
+    status: "error";
+    instance?: never;
+};
+export interface ViewDefinition<TPath extends AppViewPath = AppViewPath, TData = unknown, TSlot extends SlotName = SlotName> {
+    component: View<ViewRuntimeProps<TPath>>;
+    path: TPath;
+    slot: TSlot;
+    useContext: () => ViewContext<TPath>;
+    /** The selected instance, with data inferred from instances.dataSchema. */
+    useInstance: () => ViewInstance<TData>;
+    /** Build-only lookup key connecting this view to its extracted server implementation. */
+    instances?: {
+        resolver: string;
+    };
+}
+export type SlotView<TSlot extends SlotName> = TailorKitSlots[TSlot] extends {
+    views: infer TViews;
+} ? Extract<TViews, AppViewPath> : never;
+type SlotInstanceDefinition<TSlot extends SlotName> = TailorKitSlots[TSlot] extends {
+    multiple: true;
+} ? {
+    instances: {
+        resolver: string;
+    };
+} : {
+    instances?: never;
+};
+type SlotDefinitions = {
+    [V in SlotName]?: Partial<{
+        [P in SlotView<V>]: (ViewDefinition<P, unknown, V> & SlotInstanceDefinition<V>) | false;
+    }>;
+};
+export interface TailorKitClient<TSlots extends SlotDefinitions = SlotDefinitions> {
+    slots: TSlots;
+}
+export interface TailorKitClientMeta {
+    preactVersion: string;
+}
+export interface TailorKitClientRuntime {
+    h: typeof h;
+    render: (vnode: VNode | null, parent: Element | Document | ShadowRoot | DocumentFragment) => void;
+}
+export type TailorKitClientWithMeta<TViews extends SlotDefinitions = SlotDefinitions> = TailorKitClient<TViews> & {
+    $meta: TailorKitClientMeta;
+    $runtime: TailorKitClientRuntime;
+};
+type ViewOptions<TPath extends AppViewPath, TSlot extends SlotName, TSchema extends z.ZodType> = {
+    [S in TSlot]: {
+        slot: S;
+        view: TPath;
+        component: View;
+    } & (TPath extends SlotView<S> ? unknown : {
+        readonly __tailorkit_error__: "View is not supported by this slot";
+    }) & (TailorKitSlots[S] extends {
+        multiple: true;
+    } ? {
+        instances: ViewInstances<TPath, TSchema>;
+    } : {
+        instances?: never;
+    });
+}[TSlot];
+/** In .view.tsx files, the builder supplies the slot and filename-derived path.
+ * Keep an explicit view for a custom path and precise host context typing. */
+export declare function defineView<const TPath extends AppViewPath = AppViewPath, TSchema extends z.ZodType = z.ZodType>(options: {
+    slot?: never;
+    view?: TPath;
+    component: View;
+    instances?: ViewInstances<TPath, TSchema>;
+}): ViewDefinition<TPath, z.output<TSchema>>;
+export declare function defineView<const TPath extends AppViewPath, const TSlot extends SlotName, TSchema extends z.ZodType>(options: ViewOptions<TPath, TSlot, TSchema>): ViewDefinition<TPath, z.output<TSchema>, TSlot> & SlotInstanceDefinition<TSlot>;
+export declare const createRemoteComponent: <TProps extends object, TChildren extends boolean = false>(name: string, options?: {
+    callbacks?: Record<string, number>;
+    children?: TChildren;
+}) => View<TProps & {
+    children?: TChildren extends true ? ComponentChildren : never;
+}>;
+export {};

package/package.json

@@ -1,69 +1,91 @@
 {
   "name": "@tailorkit/app",
-  "version": "0.1.0-beta.3",
-  "license": "AGPL-3.0-only",
+  "version": "0.1.0-beta.32",
+  "license": "Apache-2.0",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/AlfieJones/tailorkit.git",
+    "url": "git+https://github.com/TailorKit-Labs/TailorKit.git",
     "directory": "packages/app"
   },
   "files": [
-    "dist",
-    "src"
+    "dist"
   ],
   "type": "module",
   "imports": {
-    "#*": [
-      "./src/*",
-      "./src/*.ts",
-      "./src/*.tsx",
-      "./src/*/index.ts",
-      "./src/*/index.tsx"
-    ]
+    "#env": "./src/env.ts",
+    "#*": {
+      "development": [
+        "./src/*",
+        "./src/*.ts",
+        "./src/*.tsx",
+        "./src/*/index.ts",
+        "./src/*/index.tsx"
+      ],
+      "types": [
+        "./dist/*",
+        "./dist/*.d.ts",
+        "./dist/*/index.d.ts"
+      ],
+      "default": [
+        "./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"
     },
-    "./config": {
-      "development": "./src/config/index.ts",
-      "types": "./dist/config/index.d.ts",
-      "import": "./dist/config.js"
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.js"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js"
     },
-    "./config/loader": {
-      "development": "./src/config/loader.ts",
-      "types": "./dist/config/loader.d.ts",
-      "import": "./dist/config-loader.js"
+    "./protocol": {
+      "types": "./dist/protocol.d.ts",
+      "import": "./dist/protocol.js"
     },
-    "./builder": {
-      "development": "./src/builder/index.ts",
-      "types": "./dist/builder/index.d.ts",
-      "import": "./dist/builder.js"
+    "./client/connection": {
+      "types": "./dist/client/connection.d.ts",
+      "import": "./dist/client-connection.js"
     }
   },
   "publishConfig": {
     "access": "public"
   },
   "dependencies": {
-    "@tailorkit/core": "0.1.0-beta.3",
-    "cosmiconfig": "^10.0.0",
-    "vite": "^8.2.2",
-    "zod": "^4.4.3"
+    "@nanostores/preact": "1.1.1",
+    "@orpc/client": "2.0.0-beta.40",
+    "@orpc/contract": "2.0.0-beta.40",
+    "drizzle-orm": "1.0.0-rc.4-5d5b77c",
+    "nanostores": "1.5.5",
+    "zod": "^4.6.5"
   },
   "devDependencies": {
     "@tailorkit/config": "0.0.0",
-    "@types/node": "26.2.0",
-    "preact": "^10.29.8",
+    "@types/node": "26.6.4",
+    "happy-dom": "^20.14.6",
+    "preact": "^11.0.1",
     "tsup": "^8.5.1",
-    "typescript": "^7.0.2"
+    "typescript": "^7.0.2",
+    "vite": "npm:@voidzero-dev/vite-plus-core@1.1.0",
+    "vite-plus": "1.1.0"
   },
   "peerDependencies": {
-    "preact": "^10.0.0"
+    "preact": "^11.0.0"
   },
   "scripts": {
     "build": "tsup --config tsup.config.ts && tsc -p tsconfig.build.json",
-    "check-types": "tsc --noEmit"
+    "check-types": "tsc --noEmit",
+    "test": "vp test run",
+    "lint": "vp lint .",
+    "lint:fix": "vp lint --fix ."
   }
 }