{"version":3,"file":"async.cjs","sources":["../src/async.ts"],"sourcesContent":["import type {Children, Component, Context} from \"./crank.js\";\nimport {createElement} from \"./crank.js\";\n\n/**\n * Creates a lazy-loaded component from an initializer function.\n *\n * @param initializer - Function that returns a Promise resolving to a component or module\n * @returns A component that loads the target component on first render\n *\n * @example\n * ```jsx\n * const LazyComponent = lazy(() => import('./MyComponent'));\n *\n * <Suspense fallback={<div>Loading...</div>}>\n *   <LazyComponent prop=\"value\" />\n * </Suspense>\n * ```\n */\nexport function lazy<T extends Component>(\n\tinitializer: () => Promise<T | {default: T}>,\n): T {\n\treturn async function* LazyComponent(\n\t\tthis: Context,\n\t\tprops: any,\n\t): AsyncGenerator<Children> {\n\t\tlet Component = await initializer();\n\t\tif (Component && typeof Component === \"object\" && \"default\" in Component) {\n\t\t\tComponent = Component.default;\n\t\t}\n\n\t\tif (typeof Component !== \"function\") {\n\t\t\tthrow new Error(\n\t\t\t\t\"Lazy component initializer must return a Component or a module with a default export that is a Component.\",\n\t\t\t);\n\t\t}\n\n\t\tfor (props of this) {\n\t\t\tyield createElement(Component, props);\n\t\t}\n\t} as unknown as T;\n}\n\nasync function SuspenseEmpty() {\n\tawait new Promise((resolve) => setTimeout(resolve));\n\treturn null;\n}\n\nasync function SuspenseFallback(\n\tthis: Context,\n\t{\n\t\tchildren,\n\t\ttimeout,\n\t\tschedule,\n\t}: {\n\t\tchildren: Children;\n\t\ttimeout: number;\n\t\tschedule: () => Promise<unknown>;\n\t},\n): Promise<Children> {\n\tthis.schedule(schedule);\n\tawait new Promise((resolve) => setTimeout(resolve, timeout));\n\treturn children;\n}\n\nfunction SuspenseChildren(\n\tthis: Context,\n\t{\n\t\tchildren,\n\t\tschedule,\n\t}: {\n\t\tchildren: Children;\n\t\tschedule: () => Promise<unknown>;\n\t},\n) {\n\tthis.schedule(schedule);\n\treturn children;\n}\n\n/**\n * A component that displays a fallback while its children are loading.\n *\n * When used within a SuspenseList, coordinates with siblings to control\n * reveal order and fallback behavior.\n *\n * @param children - The content to display when loading is complete\n * @param fallback - The content to display while children are loading\n * @param timeout - Time in milliseconds before showing fallback (defaults to\n * 300ms standalone, or inherits from SuspenseList)\n *\n * @example\n * ```jsx\n * <Suspense fallback={<div>Loading...</div>}>\n *   <AsyncComponent />\n * </Suspense>\n * ```\n */\nexport async function* Suspense(\n\tthis: Context,\n\t{\n\t\tchildren,\n\t\tfallback,\n\t\ttimeout,\n\t}: {children: Children; fallback: Children; timeout?: number},\n): AsyncGenerator<Children> {\n\tconst controller = this.consume(SuspenseListController);\n\tthis.provide(SuspenseListController, undefined);\n\tfor await ({children, fallback, timeout} of this) {\n\t\tif (timeout == null) {\n\t\t\tif (controller) {\n\t\t\t\ttimeout = controller.timeout;\n\t\t\t} else {\n\t\t\t\ttimeout = 300;\n\t\t\t}\n\t\t}\n\n\t\tif (!controller) {\n\t\t\tyield createElement(SuspenseFallback, {\n\t\t\t\ttimeout: timeout!,\n\t\t\t\tchildren: fallback,\n\t\t\t\tschedule: () => {},\n\t\t\t});\n\t\t\tyield children;\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst items = await controller.register(this);\n\t\tif (controller.revealOrder !== \"together\") {\n\t\t\tif (!controller.isHead(this, items)) {\n\t\t\t\tyield createElement(SuspenseEmpty);\n\t\t\t}\n\n\t\t\tif (controller.tail !== \"hidden\") {\n\t\t\t\tyield createElement(SuspenseFallback, {\n\t\t\t\t\ttimeout: timeout!,\n\t\t\t\t\tchildren: fallback,\n\t\t\t\t\tschedule: () => controller.scheduleFallback(this, items),\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\n\t\tyield createElement(SuspenseChildren, {\n\t\t\tchildren,\n\t\t\tschedule: () => controller.scheduleChildren(this, items),\n\t\t});\n\t}\n}\n\nconst SuspenseListController = Symbol.for(\"SuspenseListController\");\n\ninterface SuspenseListItem {\n\tctx: Context;\n\tresolve: () => void;\n\tpromise: Promise<void>;\n}\n\ninterface SuspenseListController {\n\ttimeout?: number;\n\trevealOrder?: \"forwards\" | \"backwards\" | \"together\";\n\ttail?: \"collapsed\" | \"hidden\";\n\tregister(ctx: Context): Promise<Array<SuspenseListItem>>;\n\tisHead(ctx: Context, items: Array<SuspenseListItem>): boolean;\n\tscheduleFallback(ctx: Context, items: Array<SuspenseListItem>): Promise<void>;\n\tscheduleChildren(ctx: Context, items: Array<SuspenseListItem>): Promise<void>;\n}\n\ndeclare global {\n\tnamespace Crank {\n\t\tinterface ProvisionMap {\n\t\t\t[SuspenseListController]: SuspenseListController;\n\t\t}\n\t}\n}\n\n/**\n * Controls when child <Suspense> components show their content or fallbacks\n * based on the specified reveal order. The <SuspenseList> resolves when\n * coordination effort is complete (not necessarily when all content is\n * loaded).\n *\n * @param revealOrder - How children should be revealed:\n *   - \"forwards\" (default): Show children in document order, waiting for\n *     predecessors\n *   - \"backwards\": Show children in reverse order, waiting for successors\n *   - \"together\": Show all children simultaneously when all are ready\n *   In Crank, the default behavior of async components is to render together,\n *   so \"together\" might not be necessary if you are not using <Suspense>\n *   fallbacks.\n *e@param tail - How to handle fallbacks:\n *   - \"collapsed\" (default): Show only the fallback for the next unresolved\n *     Suspense component\n *   - \"hidden\": Hide all fallbacks\n *   Tail behavior only applies when revealOrder is not \"together\".\n * @param timeout - Default timeout for Suspense children in milliseconds\n * @param children - The elements containing Suspense components to coordinate.\n *   Suspense components which are not rendered immediately (because they are\n *   the children of another async component) will not be coordinated.\n *\n * @example\n * ```jsx\n * <SuspenseList revealOrder=\"forwards\" tail=\"collapsed\">\n *   <Suspense fallback={<div>Loading A...</div>}>\n *     <ComponentA />\n *   </Suspense>\n *   <Suspense fallback={<div>Loading B...</div>}>\n *     <ComponentB />\n *   </Suspense>\n * </SuspenseList>\n * ```\n */\nexport function* SuspenseList(\n\tthis: Context,\n\t{\n\t\trevealOrder = \"forwards\",\n\t\ttail = \"collapsed\",\n\t\ttimeout,\n\t\tchildren,\n\t}: {\n\t\trevealOrder?: \"forwards\" | \"backwards\" | \"together\";\n\t\ttail?: \"collapsed\" | \"hidden\";\n\t\ttimeout?: number;\n\t\tchildren: Children;\n\t},\n): Generator<Children> {\n\tlet finishRegistration: () => void;\n\tlet registering: Promise<void> | null = null;\n\tlet items: Array<SuspenseListItem> = [];\n\tconst controller: SuspenseListController = {\n\t\ttimeout,\n\t\trevealOrder,\n\t\ttail,\n\t\tasync register(ctx: Context) {\n\t\t\tif (registering) {\n\t\t\t\tlet childrenResolver!: () => void;\n\t\t\t\tconst childrenPromise = new Promise<void>(\n\t\t\t\t\t(r) => (childrenResolver = r),\n\t\t\t\t);\n\n\t\t\t\titems.push({\n\t\t\t\t\tctx,\n\t\t\t\t\tresolve: childrenResolver!,\n\t\t\t\t\tpromise: childrenPromise,\n\t\t\t\t});\n\n\t\t\t\t// Wait for registration to complete\n\t\t\t\tawait registering;\n\t\t\t\treturn items;\n\t\t\t}\n\n\t\t\tconsole.error(\n\t\t\t\t\"Component registered outside SuspenseList registration window\",\n\t\t\t);\n\t\t\treturn [];\n\t\t},\n\n\t\tisHead(ctx: Context, suspenseItems: Array<SuspenseListItem>): boolean {\n\t\t\tconst index = suspenseItems.findIndex((item) => item.ctx === ctx);\n\t\t\tif (index === -1) {\n\t\t\t\treturn false;\n\t\t\t}\n\t\t\tif (revealOrder === \"forwards\") {\n\t\t\t\treturn index === 0;\n\t\t\t} else if (revealOrder === \"backwards\") {\n\t\t\t\treturn index === suspenseItems.length - 1;\n\t\t\t}\n\n\t\t\treturn false;\n\t\t},\n\n\t\tasync scheduleFallback(\n\t\t\tctx: Context,\n\t\t\tsuspenseItems: Array<SuspenseListItem>,\n\t\t) {\n\t\t\tconst index = suspenseItems.findIndex((item) => item.ctx === ctx);\n\t\t\tif (index === -1) {\n\t\t\t\treturn;\n\t\t\t} else if (revealOrder === \"forwards\") {\n\t\t\t\tawait Promise.all(\n\t\t\t\t\tsuspenseItems.slice(0, index).map((item) => item.promise),\n\t\t\t\t);\n\t\t\t} else if (revealOrder === \"backwards\") {\n\t\t\t\tawait Promise.all(\n\t\t\t\t\tsuspenseItems.slice(index + 1).map((item) => item.promise),\n\t\t\t\t);\n\t\t\t}\n\t\t},\n\n\t\tasync scheduleChildren(\n\t\t\tctx: Context,\n\t\t\tsuspenseItems: Array<SuspenseListItem>,\n\t\t) {\n\t\t\tconst index = suspenseItems.findIndex((item) => item.ctx === ctx);\n\t\t\tif (index === -1) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\t// This children content is ready\n\t\t\tsuspenseItems[index].resolve();\n\t\t\t// Children coordination - determine when this content should show\n\t\t\tif (revealOrder === \"together\") {\n\t\t\t\tawait Promise.all(suspenseItems.map((item) => item.promise));\n\t\t\t} else if (revealOrder === \"forwards\") {\n\t\t\t\tconst waitFor = suspenseItems\n\t\t\t\t\t.slice(0, index + 1)\n\t\t\t\t\t.map((item) => item.promise);\n\t\t\t\tawait Promise.all(waitFor);\n\t\t\t} else if (revealOrder === \"backwards\") {\n\t\t\t\tconst waitFor = suspenseItems\n\t\t\t\t\t.slice(index + 1)\n\t\t\t\t\t.map((item) => item.promise);\n\t\t\t\tawait Promise.all(waitFor);\n\t\t\t}\n\t\t},\n\t};\n\n\tthis.provide(SuspenseListController, controller);\n\tfor ({\n\t\trevealOrder = \"forwards\",\n\t\ttail = \"collapsed\",\n\t\ttimeout,\n\t\tchildren,\n\t} of this) {\n\t\titems = [];\n\t\tcontroller.timeout = timeout;\n\t\tcontroller.revealOrder = revealOrder;\n\t\tcontroller.tail = tail;\n\t\tregistering = new Promise((r) => (finishRegistration = r));\n\t\t// TODO: Is there a more precise timing for the registration window\n\t\tconst timerId = setTimeout(() => {\n\t\t\tfinishRegistration();\n\t\t\tregistering = null;\n\t\t});\n\t\tthis.cleanup(() => clearTimeout(timerId));\n\t\tyield children;\n\t}\n}\n"],"names":["createElement"],"mappings":"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"}