@koordinates/xstate-tree 5.1.0-next.7 → 5.1.0-next.9

package/lib/xstate-tree.d.ts

@@ -133,15 +133,11 @@ export declare function buildCreateRoute(history: () => XstateTreeHistory, baseP
  * @param machine - The root machine of the tree
  * @param routing - The routing configuration for the tree
  */
-export declare function buildRootComponent(machine: AnyXstateTreeMachine, routing?: {
-    routes: AnyRoute[];
-    history: XstateTreeHistory<any>;
-    basePath: string;
-    getPathName?: () => string;
-    getQueryString?: () => string;
-}): {
+export declare function buildRootComponent<TMachine extends AnyXstateTreeMachine>(options: {
+    machine: TMachine;
+} & MarkOptionalLikePropertiesOptional<RootOptions<InputFrom<TMachine>>>): {
     (): JSX.Element;
-    rootMachine: AnyXstateTreeMachine;
+    rootMachine: TMachine;
 };
 
 /**
@@ -177,7 +173,7 @@ export declare type CanHandleEvent<TMachine extends AnyStateMachine> = (e: Event
  * @param machine - The xstate machine to create the xstate-tree machine from
  * @param options - the xstate-tree options
  */
-export declare function createXStateTreeMachine<TMachine extends AnyStateMachine, TSelectorsOutput = ContextFrom<TMachine>, TActionsOutput = Record<never, string>, TSlots extends readonly Slot[] = []>(machine: TMachine, options: V2BuilderMeta<TMachine, TSelectorsOutput, TActionsOutput, TSlots>): XstateTreeMachine<TMachine>;
+export declare function createXStateTreeMachine<TMachine extends AnyStateMachine, TSelectorsOutput = ContextFrom<TMachine>, TActionsOutput = Record<never, string>, TSlots extends readonly Slot[] = []>(machine: TMachine, options: V2BuilderMeta<TMachine, TSelectorsOutput, TActionsOutput, TSlots>): XstateTreeMachine<TMachine, TSelectorsOutput, TActionsOutput, TSlots>;
 
 declare type EmptyKeys<T> = keyof {
     [K in keyof T as IsEmptyObject<T[K], true> extends true ? K : never]: T[K];
@@ -217,6 +213,8 @@ declare type IsEmptyObject<Obj, ExcludeOptional extends boolean = false> = undef
 never
 ] ? true : false;
 
+declare type IsUnknown<T> = unknown extends T ? true : false;
+
 /**
  * @public
  *
@@ -278,7 +276,10 @@ export declare function loggingMetaOptions<TEvents extends EventObject, TContext
     };
 };
 
-declare type MakeEmptyObjectPropertiesOptional<T> = Omit<T, EmptyKeys<T>> & Partial<Pick<T, EmptyKeys<T>>>;
+/**
+ * Marks any required property that can accept undefined as optional
+ */
+declare type MarkOptionalLikePropertiesOptional<T> = Omit<T, EmptyKeys<T>> & Partial<Pick<T, EmptyKeys<T>>>;
 
 /**
  * @internal
@@ -382,6 +383,17 @@ declare type Return<TRoutes extends Route<any, any, any, any>[]> = {
     error: unknown;
 };
 
+declare type RootOptions<TInput> = {
+    routing: {
+        routes: AnyRoute[];
+        history: XstateTreeHistory<any>;
+        basePath: string;
+        getPathName?: () => string;
+        getQueryString?: () => string;
+    } | undefined;
+    input: IsUnknown<TInput> extends true ? undefined : TInput;
+};
+
 /**
  * @public
  *
@@ -457,7 +469,7 @@ export declare type Route<TParams, TQuery, TEvent, TMeta> = {
 /**
  * @public
  */
-export declare type RouteArgumentFunctions<TReturn, TParams, TQuery, TMeta, TArgs = RouteArguments<TParams, TQuery, TMeta>> = IsEmptyObject<TArgs> extends true ? () => TReturn : keyof TArgs extends "meta" ? (args?: TArgs) => TReturn : EmptyRouteArguments<TParams, TQuery> extends true ? (args?: Partial<TArgs>) => TReturn : (args: MakeEmptyObjectPropertiesOptional<TArgs>) => TReturn;
+export declare type RouteArgumentFunctions<TReturn, TParams, TQuery, TMeta, TArgs = RouteArguments<TParams, TQuery, TMeta>> = IsEmptyObject<TArgs> extends true ? () => TReturn : keyof TArgs extends "meta" ? (args?: TArgs) => TReturn : EmptyRouteArguments<TParams, TQuery> extends true ? (args?: Partial<TArgs>) => TReturn : (args: MarkOptionalLikePropertiesOptional<TArgs>) => TReturn;
 
 /**
  * @public
@@ -504,7 +516,7 @@ export declare type RouteParams<T> = T extends Route<infer TParams, any, any, an
  */
 export declare type RouteQuery<T> = T extends Route<any, infer TQuery, any, any> ? TQuery : undefined;
 
-declare type RouteRedirect<TParams, TQuery, TMeta> = (args: MakeEmptyObjectPropertiesOptional<{
+declare type RouteRedirect<TParams, TQuery, TMeta> = (args: MarkOptionalLikePropertiesOptional<{
     params: TParams;
     query: TQuery;
     meta?: TMeta;
@@ -704,13 +716,13 @@ export declare type XstateTreeHistory<T = unknown> = History_2<{
 /**
  * @public
  */
-export declare type XstateTreeMachine<TMachine extends AnyStateMachine> = TMachine & XstateTreeMachineInjection<TMachine>;
+export declare type XstateTreeMachine<TMachine extends AnyStateMachine, TSelectorsOutput = ContextFrom<TMachine>, TActionsOutput = Record<never, string>, TSlots extends readonly Slot[] = Slot[]> = TMachine & XstateTreeMachineInjection<TMachine, TSelectorsOutput, TActionsOutput, TSlots>;
 
 /**
  * @internal
  */
-export declare type XstateTreeMachineInjection<TMachine extends AnyStateMachine> = {
-    _xstateTree: XstateTreeMachineStateSchemaV2<TMachine>;
+export declare type XstateTreeMachineInjection<TMachine extends AnyStateMachine, TSelectorsOutput = ContextFrom<TMachine>, TActionsOutput = Record<never, string>, TSlots extends readonly Slot[] = Slot[]> = {
+    _xstateTree: XstateTreeMachineStateSchemaV2<TMachine, TSelectorsOutput, TActionsOutput, TSlots>;
 };
 
 /**

package/lib/xstateTree.js

@@ -203,7 +203,8 @@ exports.recursivelySend = recursivelySend;
  * @param machine - The root machine of the tree
  * @param routing - The routing configuration for the tree
  */
-function buildRootComponent(machine, routing) {
+function buildRootComponent(options) {
+    const { input, machine, routing } = options;
     if (!machine._xstateTree) {
         throw new Error("Root machine is not an xstate-tree machine, missing metadata");
     }
@@ -213,6 +214,7 @@ function buildRootComponent(machine, routing) {
     const RootComponent = function XstateTreeRootComponent() {
         const lastSnapshotsRef = (0, react_2.useRef)({});
         const [_, __, interpreter] = (0, react_1.useActor)(machine, {
+            input,
             inspect(event) {
                 switch (event.type) {
                     case "@xstate.actor":

package/package.json

@@ -2,7 +2,7 @@
   "name": "@koordinates/xstate-tree",
   "main": "lib/index.js",
   "types": "lib/xstate-tree.d.ts",
-  "version": "5.1.0-next.7",
+  "version": "5.1.0-next.9",
   "license": "MIT",
   "description": "Build UIs with Actors using xstate and React",
   "keywords": [