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

package/src/index.ts

@@ -1,206 +0,0 @@
-import { createContext, h, render } from "preact";
-import type { ComponentChild, ComponentChildren, ComponentType, VNode } from "preact";
-import { useContext } from "preact/hooks";
-
-declare const __PREACT_VERSION__: string;
-
-const preactVersion = __PREACT_VERSION__;
-
-// oxlint-disable-next-line typescript-eslint/no-empty-interface, typescript-eslint/no-empty-object-type
-export interface TailorKitScreens {}
-
-export type ScreenPath = Extract<keyof TailorKitScreens & string, `/${string}`>;
-export type AppScreenPath = ScreenPath;
-
-export type ScreenProps<TPath extends ScreenPath> = TailorKitScreens[TPath] extends object
-  ? TailorKitScreens[TPath]
-  : Record<string, never>;
-
-export type ScreenPropsForPath<TPath extends AppScreenPath> = TPath extends ScreenPath
-  ? ScreenProps<TPath>
-  : never;
-
-export type ScreenContext<TPath extends AppScreenPath> =
-  ScreenPropsForPath<TPath> extends { context: infer TContext } ? TContext : Record<string, never>;
-
-export type View<TProps extends object = Record<string, never>> = (props: TProps) => ComponentChild;
-
-export type ScreenRuntimeProps<TPath extends AppScreenPath> =
-  | {
-      context: ScreenContext<TPath>;
-      screen: TPath;
-      status: "ready";
-    }
-  | {
-      context?: never;
-      screen: TPath;
-      status: "loading";
-    }
-  | {
-      context?: never;
-      screen: TPath;
-      status: "error";
-    };
-
-export interface ScreenDefinition<TPath extends AppScreenPath = AppScreenPath> {
-  component: View<ScreenRuntimeProps<TPath>>;
-  path: TPath;
-  useContext: () => ScreenContext<TPath>;
-}
-
-type RegisteredScreens = {
-  [TPath in AppScreenPath]: ScreenDefinition<TPath>;
-};
-
-type ScreenDefinitions = Partial<RegisteredScreens>;
-
-type InvalidScreenPath<TScreens> = Exclude<keyof TScreens & string, `/${string}`>;
-
-type RequireScreenPaths<TScreens> =
-  InvalidScreenPath<TScreens> extends never
-    ? unknown
-    : {
-        readonly __tailorkit_error__: `Screen paths must start with "/". Invalid screen: ${InvalidScreenPath<TScreens>}`;
-      };
-
-type ScreenKeyPathMismatch<TScreens> = {
-  [TPath in keyof TScreens & string]: TScreens[TPath] extends ScreenDefinition<infer TScreenPath>
-    ? TScreenPath extends TPath
-      ? never
-      : TPath
-    : TPath;
-}[keyof TScreens & string];
-
-type RequireMatchingScreenKeys<TScreens> =
-  ScreenKeyPathMismatch<TScreens> extends never
-    ? unknown
-    : {
-        readonly __tailorkit_error__: `Screen key must match createScreen path. Invalid screen: ${ScreenKeyPathMismatch<TScreens>}`;
-      };
-
-export interface TailorKitClient<TScreens extends ScreenDefinitions = ScreenDefinitions> {
-  screens: TScreens;
-}
-
-export interface TailorKitClientMeta {
-  preactVersion: string;
-}
-
-export interface TailorKitClientRuntime {
-  h: typeof h;
-  render: (vnode: VNode, parent: Element | Document | ShadowRoot | DocumentFragment) => void;
-}
-
-export type TailorKitClientWithMeta<TScreens extends ScreenDefinitions = ScreenDefinitions> =
-  TailorKitClient<TScreens> & {
-    $meta: TailorKitClientMeta;
-    $runtime: TailorKitClientRuntime;
-  };
-
-export const createScreen = <const TPath extends AppScreenPath>(
-  path: TPath,
-  options: {
-    component: View<Record<string, never>>;
-    error?: View<Record<string, never>>;
-    loading?: View<Record<string, never>>;
-  },
-): ScreenDefinition<TPath> => {
-  const Context = createContext<ScreenContext<TPath> | null>(null);
-
-  const Screen = (props: ScreenRuntimeProps<TPath>) => {
-    if (props.status === "loading") {
-      return options.loading ? h(options.loading as ComponentType<object>, {}) : null;
-    }
-
-    if (props.status === "error") {
-      return options.error ? h(options.error as ComponentType<object>, {}) : null;
-    }
-
-    return h(
-      Context.Provider,
-      { value: props.context as ScreenContext<TPath> },
-      h(options.component as ComponentType<object>, {}),
-    );
-  };
-
-  return {
-    component: Screen,
-    path,
-    useContext: () => {
-      const context = useContext(Context);
-
-      if (context === null) {
-        throw new Error(`Screen context is only available while rendering "${path}".`);
-      }
-
-      return context;
-    },
-  };
-};
-
-export const defineClient = <const TScreens extends ScreenDefinitions>(
-  client: TailorKitClient<TScreens> &
-    RequireScreenPaths<TScreens> &
-    RequireMatchingScreenKeys<TScreens>,
-): TailorKitClientWithMeta<TScreens> => ({
-  ...client,
-  $meta: {
-    preactVersion,
-  },
-  $runtime: {
-    h,
-    render,
-  },
-});
-
-const componentTagPrefix = "tailorkit-";
-
-const toComponentTagName = (name: string): string =>
-  `${componentTagPrefix}${name
-    .replaceAll(/([a-z0-9])([A-Z])/gu, "$1-$2")
-    .replaceAll(/[\s_]+/gu, "-")
-    .toLowerCase()}`;
-
-const toCallbackEventName = (name: string): string =>
-  `tailorkitcallback${name.replaceAll(/[^A-Za-z0-9_$]/gu, "").toLowerCase()}`;
-
-const toEventProp = (event: string): string => `on${event}`;
-
-export const createRemoteComponent = <TProps extends object, TSlots extends readonly string[]>(
-  name: string,
-  options: { callbacks?: Record<string, number>; slots: TSlots },
-): View<TProps & { children?: ComponentChildren }> => {
-  const tagName = toComponentTagName(name);
-  const callbacks = options.callbacks;
-
-  if (!callbacks || Object.keys(callbacks).length === 0) {
-    return function RemoteComponent({ children, ...props }) {
-      return h(tagName, props, children);
-    };
-  }
-
-  return function RemoteComponent({ children, ...props }) {
-    const nextProps = { ...props } as Record<string, unknown>;
-    const callbackMap: Record<string, { callback: string; inputCount: number }> = {};
-
-    for (const [key, inputCount] of Object.entries(callbacks)) {
-      const callback = nextProps[key];
-      Reflect.deleteProperty(nextProps, key);
-      if (typeof callback !== "function") {
-        continue;
-      }
-
-      const eventName = toCallbackEventName(key);
-      callbackMap[eventName] = { callback: key, inputCount };
-      nextProps[toEventProp(eventName)] = (event: { detail?: unknown[] }) => {
-        callback(...(event.detail ?? []).slice(0, inputCount));
-      };
-    }
-
-    if (Object.keys(callbackMap).length > 0) {
-      nextProps["data-tailorkit-callbacks"] = JSON.stringify(callbackMap);
-    }
-
-    return h(tagName, nextProps, children);
-  };
-};

package/src/preact-version.ts

@@ -1,31 +0,0 @@
-export const MINIMUM_PREACT_MAJOR_VERSION = 10;
-
-export interface PreactVersionCheck {
-  major: number;
-  version: string;
-}
-
-export const parsePreactVersion = (version: string): PreactVersionCheck => {
-  const match = /^(\d+)\./u.exec(version);
-
-  if (!match?.[1]) {
-    throw new Error(`Unable to parse Preact version "${version}".`);
-  }
-
-  return {
-    major: Number.parseInt(match[1], 10),
-    version,
-  };
-};
-
-export const assertSupportedPreactVersion = (version: string): PreactVersionCheck => {
-  const check = parsePreactVersion(version);
-
-  if (check.major < MINIMUM_PREACT_MAJOR_VERSION) {
-    throw new Error(
-      `TailorKit requires Preact ${MINIMUM_PREACT_MAJOR_VERSION}.0.0 or newer, but found ${version}.`,
-    );
-  }
-
-  return check;
-};