@jfdevelops/react-layout 1.6.1 → 2.1.0

package/dist/create-config/lazy-resource-layout.d.cts

@@ -1,3 +1,5 @@
+import { LazyHandle, LazyOptions, LazyResourceErrorComponent, LazyResourceLoadingComponent, LazyResourceStates } from "../lazy/types.cjs";
+import { LazyResourceLoadHooks } from "../lazy/create-lazy-loader.cjs";
 import { ResourceDefinition, ResourcePath } from "../resource.cjs";
 import { definedResourceLayoutComponentSymbol } from "./render-state.cjs";
 import { ComponentProps, ComponentType } from "react";
@@ -17,38 +19,14 @@ type LazyUnsupportedStatic = 'makeComposable' | 'props' | 'resource' | typeof co
  * and composition factories are intentionally omitted because they cannot be
  * read synchronously without loading the module.
  */
-type LazyResourceLayoutComponent<Module> = ComponentType<ComponentProps<DefinedLayoutFromModule<Module>>> & Pick<DefinedLayoutFromModule<Module>, Exclude<keyof DefinedLayoutFromModule<Module>, LazyUnsupportedStatic>>;
-/** Component rendered while a resource module or one of its states is loading. */
-type LazyResourceLoadingComponent = ComponentType;
-/**
- * Component rendered when a resource module cannot be loaded. Calling
- * `retry` discards React's rejected lazy cache entry and imports it again.
- */
-type LazyResourceErrorComponent = ComponentType<{
-  error: unknown;
-  retry: () => void;
-}>;
-/** Loading and module-error UI used around a lazy resource component. */
-type LazyResourceStates = {
-  Error?: LazyResourceErrorComponent;
-  Loading?: LazyResourceLoadingComponent;
-};
-/**
- * Configuration for a lazy resource component. `resource` is checked against
- * the bound resource paths, including dot-delimited subresources, and `load`
- * must resolve to a module with exactly one created resource component.
- */
-type LazyResourceLayoutOptions<Resources extends ReadonlyArray<ResourceDefinition>, Module extends Record<string, unknown>> = {
-  load: () => Promise<Module>;
+type LazyResourceLayoutComponent<Module> = ComponentType<ComponentProps<DefinedLayoutFromModule<Module>>> & LazyHandle & Pick<DefinedLayoutFromModule<Module>, Exclude<keyof DefinedLayoutFromModule<Module>, LazyUnsupportedStatic>>;
+/** Lazy resource options, sharing import and fallback semantics with lazy states. */
+type LazyResourceLayoutOptions<Resources extends ReadonlyArray<ResourceDefinition>, Module extends Record<string, unknown>> = LazyOptions<Module> & {
   resource: ResourcePath<Resources>;
-  states?: LazyResourceStates;
+  states?: LazyResourceStates<ResourcePath<Resources>>;
 };
-/**
- * Creates a cached lazy proxy for a resource component and all of its compound
- * state components. This is normally called through
- * `defineResourceLayout.lazy(...)`, which supplies shared defaults.
- */
-declare function createLazyResourceLayout<Resources extends ReadonlyArray<ResourceDefinition>, Module extends Record<string, unknown>>(options: LazyResourceLayoutOptions<Resources, Module>, defaults: LazyResourceStates): LazyResourceLayoutComponent<Module>;
+/** Cached resource component and its compound states, backed by the shared loader. */
+declare function createLazyResourceLayout<Resources extends ReadonlyArray<ResourceDefinition>, Module extends Record<string, unknown>>(options: LazyResourceLayoutOptions<Resources, Module>, defaults: LazyResourceStates<any>, hooks?: LazyResourceLoadHooks): LazyResourceLayoutComponent<Module>;
 //#endregion
-export { LazyResourceErrorComponent, LazyResourceLayoutComponent, LazyResourceLayoutOptions, LazyResourceLoadingComponent, LazyResourceStates, createLazyResourceLayout };
+export { LazyResourceLayoutComponent, LazyResourceLayoutOptions, createLazyResourceLayout };
 //# sourceMappingURL=lazy-resource-layout.d.cts.map

package/dist/create-config/lazy-resource-layout.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"lazy-resource-layout.d.cts","names":[],"sources":["../../src/create-config/lazy-resource-layout.tsx"],"mappings":";;;;;;KAkBK,sBAAA,GAAyB,aAAA;EAAA,UAClB,oCAAoC;AAAA;AAAA,KAG3C,mBAAA,WAA8B,MAAA,SAAe,sBAAA,GAC9C,MAAA,GACA,MAAA;EAAiB,IAAA,qBAAyB,sBAAA;AAAA,IACxC,IAAA;AAAA,KAGD,uBAAA,WAAkC,mBAAA,CAAoB,MAAA,OAAa,MAAA;AAAA,KAEnE,qBAAA,oDAIM,8BAAA,UACA,oCAAoC;;;;;;KAOnC,2BAAA,WAAsC,aAAA,CAChD,cAAA,CAAe,uBAAA,CAAwB,MAAA,MAEvC,IAAA,CACE,uBAAA,CAAwB,MAAA,GACxB,OAAA,OAAc,uBAAA,CAAwB,MAAA,GAAS,qBAAA;;KAIvC,4BAAA,GAA+B,aAAa;;;;;KAK5C,0BAAA,GAA6B,aAAa;EACpD,KAAA;EACA,KAAA;AAAA;;KAIU,kBAAA;EACV,KAAA,GAAQ,0BAAA;EACR,OAAA,GAAU,4BAA4B;AAAA;;;;;;KAQ5B,yBAAA,mBACQ,aAAA,CAAc,kBAAA,kBACjB,MAAA;EAEf,IAAA,QAAY,OAAA,CAAQ,MAAA;EACpB,QAAA,EAAU,YAAA,CAAa,SAAA;EACvB,MAAA,GAAS,kBAAA;AAAA;;;AAlDmE;AAAA;;iBAwH9D,wBAAA,mBACI,aAAA,CAAc,kBAAA,kBACjB,MAAA,mBAEf,OAAA,EAAS,yBAAA,CAA0B,SAAA,EAAW,MAAA,GAC9C,QAAA,EAAU,kBAAA,GACT,2BAAA,CAA4B,MAAA"}
+{"version":3,"file":"lazy-resource-layout.d.cts","names":[],"sources":["../../src/create-config/lazy-resource-layout.tsx"],"mappings":";;;;;;;;KAsBK,sBAAA,GAAyB,aAAA;EAAA,UAClB,oCAAoC;AAAA;AAAA,KAG3C,mBAAA,WAA8B,MAAA,SAAe,sBAAA,GAC9C,MAAA,GACA,MAAA;EAAiB,IAAA,qBAAyB,sBAAA;AAAA,IACxC,IAAA;AAAA,KAGD,uBAAA,WAAkC,mBAAA,CACrC,MAAA,OAAa,MAAA;AAAA,KAGV,qBAAA,oDAIM,8BAAA,UACA,oCAAoC;;;;;;KAOnC,2BAAA,WAAsC,aAAA,CAChD,cAAA,CAAe,uBAAA,CAAwB,MAAA,MAEvC,UAAA,GACA,IAAA,CACE,uBAAA,CAAwB,MAAA,GACxB,OAAA,OAAc,uBAAA,CAAwB,MAAA,GAAS,qBAAA;;KAIvC,yBAAA,mBACQ,aAAA,CAAc,kBAAA,kBACjB,MAAA,qBACb,WAAA,CAAY,MAAA;EACd,QAAA,EAAU,YAAA,CAAa,SAAA;EACvB,MAAA,GAAS,kBAAA,CAAmB,YAAA,CAAa,SAAA;AAAA;;iBAwB3B,wBAAA,mBACI,aAAA,CAAc,kBAAA,kBACjB,MAAA,mBAEf,OAAA,EAAS,yBAAA,CAA0B,SAAA,EAAW,MAAA,GAC9C,QAAA,EAAU,kBAAA,OACV,KAAA,GAAO,qBAAA,GACN,2BAAA,CAA4B,MAAA"}

package/dist/create-config/lazy-resource-layout.d.mts

@@ -1,3 +1,5 @@
+import { LazyHandle, LazyOptions, LazyResourceErrorComponent, LazyResourceLoadingComponent, LazyResourceStates } from "../lazy/types.mjs";
+import { LazyResourceLoadHooks } from "../lazy/create-lazy-loader.mjs";
 import { ResourceDefinition, ResourcePath } from "../resource.mjs";
 import { definedResourceLayoutComponentSymbol } from "./render-state.mjs";
 import { ComponentProps, ComponentType } from "react";
@@ -17,38 +19,14 @@ type LazyUnsupportedStatic = 'makeComposable' | 'props' | 'resource' | typeof co
  * and composition factories are intentionally omitted because they cannot be
  * read synchronously without loading the module.
  */
-type LazyResourceLayoutComponent<Module> = ComponentType<ComponentProps<DefinedLayoutFromModule<Module>>> & Pick<DefinedLayoutFromModule<Module>, Exclude<keyof DefinedLayoutFromModule<Module>, LazyUnsupportedStatic>>;
-/** Component rendered while a resource module or one of its states is loading. */
-type LazyResourceLoadingComponent = ComponentType;
-/**
- * Component rendered when a resource module cannot be loaded. Calling
- * `retry` discards React's rejected lazy cache entry and imports it again.
- */
-type LazyResourceErrorComponent = ComponentType<{
-  error: unknown;
-  retry: () => void;
-}>;
-/** Loading and module-error UI used around a lazy resource component. */
-type LazyResourceStates = {
-  Error?: LazyResourceErrorComponent;
-  Loading?: LazyResourceLoadingComponent;
-};
-/**
- * Configuration for a lazy resource component. `resource` is checked against
- * the bound resource paths, including dot-delimited subresources, and `load`
- * must resolve to a module with exactly one created resource component.
- */
-type LazyResourceLayoutOptions<Resources extends ReadonlyArray<ResourceDefinition>, Module extends Record<string, unknown>> = {
-  load: () => Promise<Module>;
+type LazyResourceLayoutComponent<Module> = ComponentType<ComponentProps<DefinedLayoutFromModule<Module>>> & LazyHandle & Pick<DefinedLayoutFromModule<Module>, Exclude<keyof DefinedLayoutFromModule<Module>, LazyUnsupportedStatic>>;
+/** Lazy resource options, sharing import and fallback semantics with lazy states. */
+type LazyResourceLayoutOptions<Resources extends ReadonlyArray<ResourceDefinition>, Module extends Record<string, unknown>> = LazyOptions<Module> & {
   resource: ResourcePath<Resources>;
-  states?: LazyResourceStates;
+  states?: LazyResourceStates<ResourcePath<Resources>>;
 };
-/**
- * Creates a cached lazy proxy for a resource component and all of its compound
- * state components. This is normally called through
- * `defineResourceLayout.lazy(...)`, which supplies shared defaults.
- */
-declare function createLazyResourceLayout<Resources extends ReadonlyArray<ResourceDefinition>, Module extends Record<string, unknown>>(options: LazyResourceLayoutOptions<Resources, Module>, defaults: LazyResourceStates): LazyResourceLayoutComponent<Module>;
+/** Cached resource component and its compound states, backed by the shared loader. */
+declare function createLazyResourceLayout<Resources extends ReadonlyArray<ResourceDefinition>, Module extends Record<string, unknown>>(options: LazyResourceLayoutOptions<Resources, Module>, defaults: LazyResourceStates<any>, hooks?: LazyResourceLoadHooks): LazyResourceLayoutComponent<Module>;
 //#endregion
-export { LazyResourceErrorComponent, LazyResourceLayoutComponent, LazyResourceLayoutOptions, LazyResourceLoadingComponent, LazyResourceStates, createLazyResourceLayout };
+export { LazyResourceLayoutComponent, LazyResourceLayoutOptions, createLazyResourceLayout };
 //# sourceMappingURL=lazy-resource-layout.d.mts.map

package/dist/create-config/lazy-resource-layout.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"lazy-resource-layout.d.mts","names":[],"sources":["../../src/create-config/lazy-resource-layout.tsx"],"mappings":";;;;;;KAkBK,sBAAA,GAAyB,aAAA;EAAA,UAClB,oCAAoC;AAAA;AAAA,KAG3C,mBAAA,WAA8B,MAAA,SAAe,sBAAA,GAC9C,MAAA,GACA,MAAA;EAAiB,IAAA,qBAAyB,sBAAA;AAAA,IACxC,IAAA;AAAA,KAGD,uBAAA,WAAkC,mBAAA,CAAoB,MAAA,OAAa,MAAA;AAAA,KAEnE,qBAAA,oDAIM,8BAAA,UACA,oCAAoC;;;;;;KAOnC,2BAAA,WAAsC,aAAA,CAChD,cAAA,CAAe,uBAAA,CAAwB,MAAA,MAEvC,IAAA,CACE,uBAAA,CAAwB,MAAA,GACxB,OAAA,OAAc,uBAAA,CAAwB,MAAA,GAAS,qBAAA;;KAIvC,4BAAA,GAA+B,aAAa;;;;;KAK5C,0BAAA,GAA6B,aAAa;EACpD,KAAA;EACA,KAAA;AAAA;;KAIU,kBAAA;EACV,KAAA,GAAQ,0BAAA;EACR,OAAA,GAAU,4BAA4B;AAAA;;;;;;KAQ5B,yBAAA,mBACQ,aAAA,CAAc,kBAAA,kBACjB,MAAA;EAEf,IAAA,QAAY,OAAA,CAAQ,MAAA;EACpB,QAAA,EAAU,YAAA,CAAa,SAAA;EACvB,MAAA,GAAS,kBAAA;AAAA;;;AAlDmE;AAAA;;iBAwH9D,wBAAA,mBACI,aAAA,CAAc,kBAAA,kBACjB,MAAA,mBAEf,OAAA,EAAS,yBAAA,CAA0B,SAAA,EAAW,MAAA,GAC9C,QAAA,EAAU,kBAAA,GACT,2BAAA,CAA4B,MAAA"}
+{"version":3,"file":"lazy-resource-layout.d.mts","names":[],"sources":["../../src/create-config/lazy-resource-layout.tsx"],"mappings":";;;;;;;;KAsBK,sBAAA,GAAyB,aAAA;EAAA,UAClB,oCAAoC;AAAA;AAAA,KAG3C,mBAAA,WAA8B,MAAA,SAAe,sBAAA,GAC9C,MAAA,GACA,MAAA;EAAiB,IAAA,qBAAyB,sBAAA;AAAA,IACxC,IAAA;AAAA,KAGD,uBAAA,WAAkC,mBAAA,CACrC,MAAA,OAAa,MAAA;AAAA,KAGV,qBAAA,oDAIM,8BAAA,UACA,oCAAoC;;;;;;KAOnC,2BAAA,WAAsC,aAAA,CAChD,cAAA,CAAe,uBAAA,CAAwB,MAAA,MAEvC,UAAA,GACA,IAAA,CACE,uBAAA,CAAwB,MAAA,GACxB,OAAA,OAAc,uBAAA,CAAwB,MAAA,GAAS,qBAAA;;KAIvC,yBAAA,mBACQ,aAAA,CAAc,kBAAA,kBACjB,MAAA,qBACb,WAAA,CAAY,MAAA;EACd,QAAA,EAAU,YAAA,CAAa,SAAA;EACvB,MAAA,GAAS,kBAAA,CAAmB,YAAA,CAAa,SAAA;AAAA;;iBAwB3B,wBAAA,mBACI,aAAA,CAAc,kBAAA,kBACjB,MAAA,mBAEf,OAAA,EAAS,yBAAA,CAA0B,SAAA,EAAW,MAAA,GAC9C,QAAA,EAAU,kBAAA,OACV,KAAA,GAAO,qBAAA,GACN,2BAAA,CAA4B,MAAA"}

package/dist/create-config/lazy-resource-layout.mjs

@@ -1,109 +1,93 @@
-import { LayoutConfigurationError } from "../errors/layout-configuration-error.mjs";
-import { ResourceModuleLoadError } from "../errors/resource-state-error.mjs";
+import { LazyResourceModuleShapeError } from "../errors/lazy-resource-error.mjs";
+import { LazyBoundary } from "../lazy/lazy-boundary.mjs";
+import { createLazyLoader } from "../lazy/create-lazy-loader.mjs";
 import { definedResourceLayoutComponentSymbol } from "./render-state.mjs";
-import { Component, Suspense, lazy, useReducer, useRef } from "react";
 import { jsx } from "react/jsx-runtime";
 import { componentPropDefinitionsSymbol } from "@jfdevelops/react-layout-validator";
 
 //#region src/create-config/lazy-resource-layout.tsx
-var LazyResourceErrorBoundary = class extends Component {
-	state = {};
-	static getDerivedStateFromError(error) {
-		return { error };
-	}
-	retry = () => {
-		this.props.onRetry();
-		this.setState({ error: void 0 });
-	};
-	render() {
-		if (this.state.error !== void 0) {
-			const { ErrorComponent } = this.props;
-			if (!ErrorComponent) throw this.state.error;
-			return /* @__PURE__ */ jsx(ErrorComponent, {
-				error: this.state.error,
-				retry: this.retry
-			});
-		}
-		return this.props.children;
-	}
-};
-function findDefinedLayoutComponent(module) {
+function findDefinedLayoutComponent(module, resource) {
 	const components = Object.values(module).map((value) => typeof value === "object" && value !== null && "Root" in value ? value.Root : value).filter((value) => typeof value === "function" && definedResourceLayoutComponentSymbol in value);
-	if (components.length !== 1) throw new LayoutConfigurationError(`A lazy resource module must export exactly one created resource layout component; received ${components.length}`);
+	if (components.length !== 1) throw new LazyResourceModuleShapeError(resource, components.length);
 	return components[0];
 }
-/**
-* Creates a cached lazy proxy for a resource component and all of its compound
-* state components. This is normally called through
-* `defineResourceLayout.lazy(...)`, which supplies shared defaults.
-*/
-function createLazyResourceLayout(options, defaults) {
-	const runtimeOptions = options;
-	let loadedComponentPromise;
-	const stateComponents = /* @__PURE__ */ new Map();
-	const resolvedStates = {
+/** Cached resource component and its compound states, backed by the shared loader. */
+function createLazyResourceLayout(options, defaults, hooks = {}) {
+	const runtime = options;
+	const resource = runtime.resource;
+	const states = {
 		...defaults,
-		...runtimeOptions.states
+		...runtime.states
 	};
-	function loadComponent() {
-		loadedComponentPromise ??= runtimeOptions.load().then(findDefinedLayoutComponent).catch((error) => {
-			throw new ResourceModuleLoadError(runtimeOptions.resource, error);
-		});
-		return loadedComponentPromise;
-	}
-	function resetLoad() {
-		loadedComponentPromise = void 0;
-		stateComponents.clear();
-	}
-	function createMemberComponent(member) {
-		function createLazyComponent() {
-			return lazy(async () => {
-				const component = await loadComponent();
-				const selected = member === void 0 ? component : component[member];
-				if (typeof selected !== "function") throw new LayoutConfigurationError(`Lazy resource "${runtimeOptions.resource}" does not define state "${String(member)}"`);
-				return { default: selected };
-			});
-		}
+	const loader = createLazyLoader({
+		load: runtime.load,
+		select: (module) => findDefinedLayoutComponent(module, resource),
+		label: resource,
+		hooks
+	});
+	const members = /* @__PURE__ */ new Map();
+	function createMember(member) {
 		function LazyMember(props) {
-			const [, rerender] = useReducer((version) => version + 1, 0);
-			const LazyComponent = useRef(createLazyComponent());
-			const LoadingComponent = resolvedStates.Loading;
-			const CurrentLazyComponent = LazyComponent.current;
-			function retry() {
-				resetLoad();
-				LazyComponent.current = createLazyComponent();
-				rerender();
-			}
-			return /* @__PURE__ */ jsx(LazyResourceErrorBoundary, {
-				ErrorComponent: resolvedStates.Error,
-				onRetry: retry,
-				children: /* @__PURE__ */ jsx(Suspense, {
-					fallback: LoadingComponent ? /* @__PURE__ */ jsx(LoadingComponent, {}) : null,
-					children: /* @__PURE__ */ jsx(CurrentLazyComponent, { ...props })
-				})
+			const Loading = states.Loading;
+			return /* @__PURE__ */ jsx(LazyBoundary, {
+				loader,
+				member,
+				resource,
+				componentProps: props,
+				ErrorComponent: states.Error,
+				onMount: hooks.onMount,
+				fallback: runtime.fallback !== void 0 ? runtime.fallback : Loading ? /* @__PURE__ */ jsx(Loading, { resource }) : null
 			});
 		}
-		const resourceName = runtimeOptions.resource;
-		LazyMember.displayName = member === void 0 ? `LazyResource(${resourceName})` : `LazyResource(${resourceName}).${String(member)}`;
+		LazyMember.displayName = `LazyResource(${resource})${member ? `.${member}` : ""}`;
+		Object.defineProperties(LazyMember, {
+			preload: { value: loader.preload },
+			status: { get: () => loader.status }
+		});
 		return LazyMember;
 	}
-	const Component = createMemberComponent();
-	const unsupportedStatics = new Set([
+	const Component = createMember();
+	const reservedStatics = new Set([
 		"makeComposable",
 		"props",
 		"resource",
 		componentPropDefinitionsSymbol,
-		definedResourceLayoutComponentSymbol
+		definedResourceLayoutComponentSymbol,
+		"contextTypes",
+		"childContextTypes",
+		"contextType",
+		"propTypes",
+		"defaultProps",
+		"getDerivedStateFromProps",
+		"getDerivedStateFromError",
+		"getDefaultProps",
+		"$$typeof",
+		"_payload",
+		"_init",
+		"render",
+		"compare",
+		"type",
+		"then",
+		"catch",
+		"finally",
+		"toJSON",
+		"asymmetricMatch",
+		"__esModule",
+		"default"
 	]);
-	return new Proxy(Component, { get(target, property, receiver) {
-		if (Reflect.has(target, property)) return Reflect.get(target, property, receiver);
-		if (typeof property !== "string" || unsupportedStatics.has(property)) return;
-		const existing = stateComponents.get(property);
-		if (existing) return existing;
-		const stateComponent = createMemberComponent(property);
-		stateComponents.set(property, stateComponent);
-		return stateComponent;
-	} });
+	return new Proxy(Component, {
+		get(target, property, receiver) {
+			if (Reflect.has(target, property)) return Reflect.get(target, property, receiver);
+			if (typeof property !== "string" || reservedStatics.has(property) || !/^[A-Z]/.test(property)) return void 0;
+			let component = members.get(property);
+			if (!component) {
+				component = createMember(property);
+				members.set(property, component);
+			}
+			return component;
+		},
+		has: (target, property) => Reflect.has(target, property)
+	});
 }
 
 //#endregion

package/dist/create-config/lazy-resource-layout.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"lazy-resource-layout.mjs","names":[],"sources":["../../src/create-config/lazy-resource-layout.tsx"],"sourcesContent":["import {\n  Component,\n  type ComponentProps,\n  type ComponentType,\n  type JSX,\n  lazy,\n  Suspense,\n  useReducer,\n  useRef,\n} from 'react';\nimport {\n  LayoutConfigurationError,\n  ResourceModuleLoadError,\n} from '../errors';\nimport { componentPropDefinitionsSymbol } from '@jfdevelops/react-layout-validator';\nimport type { ResourcePath, ResourceDefinition } from '../resource';\nimport { definedResourceLayoutComponentSymbol } from './render-state';\n\ntype DefinedLayoutComponent = ComponentType<any> & {\n  readonly [definedResourceLayoutComponentSymbol]: true;\n};\n\ntype UnwrapDefinedLayout<Export> = Export extends DefinedLayoutComponent\n  ? Export\n  : Export extends { Root: infer Root extends DefinedLayoutComponent }\n    ? Root\n    : never;\n\ntype DefinedLayoutFromModule<Module> = UnwrapDefinedLayout<Module[keyof Module]>;\n\ntype LazyUnsupportedStatic =\n  | 'makeComposable'\n  | 'props'\n  | 'resource'\n  | typeof componentPropDefinitionsSymbol\n  | typeof definedResourceLayoutComponentSymbol;\n\n/**\n * Public surface available before a lazy module resolves. Component metadata\n * and composition factories are intentionally omitted because they cannot be\n * read synchronously without loading the module.\n */\nexport type LazyResourceLayoutComponent<Module> = ComponentType<\n  ComponentProps<DefinedLayoutFromModule<Module>>\n> &\n  Pick<\n    DefinedLayoutFromModule<Module>,\n    Exclude<keyof DefinedLayoutFromModule<Module>, LazyUnsupportedStatic>\n  >;\n\n/** Component rendered while a resource module or one of its states is loading. */\nexport type LazyResourceLoadingComponent = ComponentType;\n/**\n * Component rendered when a resource module cannot be loaded. Calling\n * `retry` discards React's rejected lazy cache entry and imports it again.\n */\nexport type LazyResourceErrorComponent = ComponentType<{\n  error: unknown;\n  retry: () => void;\n}>;\n\n/** Loading and module-error UI used around a lazy resource component. */\nexport type LazyResourceStates = {\n  Error?: LazyResourceErrorComponent;\n  Loading?: LazyResourceLoadingComponent;\n};\n\n/**\n * Configuration for a lazy resource component. `resource` is checked against\n * the bound resource paths, including dot-delimited subresources, and `load`\n * must resolve to a module with exactly one created resource component.\n */\nexport type LazyResourceLayoutOptions<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Module extends Record<string, unknown>,\n> = {\n  load: () => Promise<Module>;\n  resource: ResourcePath<Resources>;\n  states?: LazyResourceStates;\n};\n\ntype BoundaryProps = {\n  children: JSX.Element;\n  ErrorComponent?: LazyResourceErrorComponent;\n  onRetry: () => void;\n};\n\ntype BoundaryState = {\n  error?: unknown;\n};\n\nclass LazyResourceErrorBoundary extends Component<\n  BoundaryProps,\n  BoundaryState\n> {\n  state: BoundaryState = {};\n\n  static getDerivedStateFromError(error: unknown): BoundaryState {\n    return { error };\n  }\n\n  retry = () => {\n    this.props.onRetry();\n    this.setState({ error: undefined });\n  };\n\n  render() {\n    if (this.state.error !== undefined) {\n      const { ErrorComponent } = this.props;\n\n      if (!ErrorComponent) {\n        throw this.state.error;\n      }\n\n      return <ErrorComponent error={this.state.error} retry={this.retry} />;\n    }\n\n    return this.props.children;\n  }\n}\n\nfunction findDefinedLayoutComponent(module: Record<string, unknown>) {\n  const components = Object.values(module)\n    .map((value) =>\n      typeof value === 'object' && value !== null && 'Root' in value\n        ? value.Root\n        : value,\n    )\n    .filter(\n      (value): value is DefinedLayoutComponent =>\n        typeof value === 'function' &&\n        definedResourceLayoutComponentSymbol in value,\n    );\n\n  if (components.length !== 1) {\n    throw new LayoutConfigurationError(\n      `A lazy resource module must export exactly one created resource layout component; received ${components.length}`,\n    );\n  }\n\n  return components[0];\n}\n\n/**\n * Creates a cached lazy proxy for a resource component and all of its compound\n * state components. This is normally called through\n * `defineResourceLayout.lazy(...)`, which supplies shared defaults.\n */\nexport function createLazyResourceLayout<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Module extends Record<string, unknown>,\n>(\n  options: LazyResourceLayoutOptions<Resources, Module>,\n  defaults: LazyResourceStates,\n): LazyResourceLayoutComponent<Module> {\n  const runtimeOptions = options as {\n    load: () => Promise<Record<string, unknown>>;\n    resource: string;\n    states?: LazyResourceStates;\n  };\n  let loadedComponentPromise: Promise<DefinedLayoutComponent> | undefined;\n  const stateComponents = new Map<PropertyKey, ComponentType<any>>();\n  const resolvedStates = { ...defaults, ...runtimeOptions.states };\n\n  function loadComponent() {\n    loadedComponentPromise ??= runtimeOptions\n      .load()\n      .then(findDefinedLayoutComponent)\n      .catch((error: unknown) => {\n        throw new ResourceModuleLoadError(runtimeOptions.resource, error);\n      });\n\n    return loadedComponentPromise;\n  }\n\n  function resetLoad() {\n    loadedComponentPromise = undefined;\n    stateComponents.clear();\n  }\n\n  function createMemberComponent(member?: PropertyKey) {\n    function createLazyComponent() {\n      return lazy(async () => {\n        const component = await loadComponent();\n        const selected =\n          member === undefined\n            ? component\n            : (component as unknown as Record<PropertyKey, unknown>)[member];\n\n        if (typeof selected !== 'function') {\n          throw new LayoutConfigurationError(\n            `Lazy resource \"${runtimeOptions.resource}\" does not define state \"${String(member)}\"`,\n          );\n        }\n\n        return { default: selected as ComponentType<any> };\n      });\n    }\n\n    function LazyMember(props: Record<string, unknown>) {\n      const [, rerender] = useReducer((version) => version + 1, 0);\n      const LazyComponent = useRef(createLazyComponent());\n      const LoadingComponent = resolvedStates.Loading;\n      const CurrentLazyComponent = LazyComponent.current;\n\n      function retry() {\n        resetLoad();\n        LazyComponent.current = createLazyComponent();\n        rerender();\n      }\n\n      return (\n        <LazyResourceErrorBoundary\n          ErrorComponent={resolvedStates.Error}\n          onRetry={retry}\n        >\n          <Suspense\n            fallback={LoadingComponent ? <LoadingComponent /> : null}\n          >\n            <CurrentLazyComponent {...props} />\n          </Suspense>\n        </LazyResourceErrorBoundary>\n      );\n    }\n\n    const resourceName = runtimeOptions.resource;\n    LazyMember.displayName =\n      member === undefined\n        ? `LazyResource(${resourceName})`\n        : `LazyResource(${resourceName}).${String(member)}`;\n\n    return LazyMember;\n  }\n\n  const Component = createMemberComponent();\n  const unsupportedStatics = new Set<PropertyKey>([\n    'makeComposable',\n    'props',\n    'resource',\n    componentPropDefinitionsSymbol,\n    definedResourceLayoutComponentSymbol,\n  ]);\n\n  return new Proxy(Component, {\n    get(target, property, receiver) {\n      if (Reflect.has(target, property)) {\n        return Reflect.get(target, property, receiver);\n      }\n\n      if (typeof property !== 'string' || unsupportedStatics.has(property)) {\n        return undefined;\n      }\n\n      const existing = stateComponents.get(property);\n\n      if (existing) {\n        return existing;\n      }\n\n      const stateComponent = createMemberComponent(property);\n      stateComponents.set(property, stateComponent);\n\n      return stateComponent;\n    },\n  }) as unknown as LazyResourceLayoutComponent<Module>;\n}\n"],"mappings":"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"}
+{"version":3,"file":"lazy-resource-layout.mjs","names":[],"sources":["../../src/create-config/lazy-resource-layout.tsx"],"sourcesContent":["import { type ComponentProps, type ComponentType } from 'react';\nimport { LazyResourceModuleShapeError } from '../errors/lazy-resource-error';\nimport { componentPropDefinitionsSymbol } from '@jfdevelops/react-layout-validator';\nimport type { ResourcePath, ResourceDefinition } from '../resource';\nimport { definedResourceLayoutComponentSymbol } from './render-state';\nimport {\n  createLazyLoader,\n  type LazyResourceLoadHooks,\n} from '../lazy/create-lazy-loader';\nimport { LazyBoundary } from '../lazy/lazy-boundary';\nimport type {\n  LazyHandle,\n  LazyOptions,\n  LazyResourceStates,\n} from '../lazy/types';\nexport type {\n  LazyResourceErrorComponent,\n  LazyResourceLoadingComponent,\n  LazyResourceStates,\n} from '../lazy/types';\nexport type { LazyResourceLoadHooks } from '../lazy/create-lazy-loader';\n\ntype DefinedLayoutComponent = ComponentType<any> & {\n  readonly [definedResourceLayoutComponentSymbol]: true;\n};\n\ntype UnwrapDefinedLayout<Export> = Export extends DefinedLayoutComponent\n  ? Export\n  : Export extends { Root: infer Root extends DefinedLayoutComponent }\n    ? Root\n    : never;\n\ntype DefinedLayoutFromModule<Module> = UnwrapDefinedLayout<\n  Module[keyof Module]\n>;\n\ntype LazyUnsupportedStatic =\n  | 'makeComposable'\n  | 'props'\n  | 'resource'\n  | typeof componentPropDefinitionsSymbol\n  | typeof definedResourceLayoutComponentSymbol;\n\n/**\n * Public surface available before a lazy module resolves. Component metadata\n * and composition factories are intentionally omitted because they cannot be\n * read synchronously without loading the module.\n */\nexport type LazyResourceLayoutComponent<Module> = ComponentType<\n  ComponentProps<DefinedLayoutFromModule<Module>>\n> &\n  LazyHandle &\n  Pick<\n    DefinedLayoutFromModule<Module>,\n    Exclude<keyof DefinedLayoutFromModule<Module>, LazyUnsupportedStatic>\n  >;\n\n/** Lazy resource options, sharing import and fallback semantics with lazy states. */\nexport type LazyResourceLayoutOptions<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Module extends Record<string, unknown>,\n> = LazyOptions<Module> & {\n  resource: ResourcePath<Resources>;\n  states?: LazyResourceStates<ResourcePath<Resources>>;\n};\n\nfunction findDefinedLayoutComponent(\n  module: Record<string, unknown>,\n  resource: string,\n) {\n  const components = Object.values(module)\n    .map((value) =>\n      typeof value === 'object' && value !== null && 'Root' in value\n        ? value.Root\n        : value,\n    )\n    .filter(\n      (value): value is DefinedLayoutComponent =>\n        typeof value === 'function' &&\n        definedResourceLayoutComponentSymbol in value,\n    );\n  if (components.length !== 1)\n    throw new LazyResourceModuleShapeError(resource, components.length);\n  return components[0];\n}\n\n/** Cached resource component and its compound states, backed by the shared loader. */\nexport function createLazyResourceLayout<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Module extends Record<string, unknown>,\n>(\n  options: LazyResourceLayoutOptions<Resources, Module>,\n  defaults: LazyResourceStates<any>,\n  hooks: LazyResourceLoadHooks = {},\n): LazyResourceLayoutComponent<Module> {\n  const runtime = options as unknown as LazyOptions<Module> & {\n    resource: string;\n    states?: LazyResourceStates;\n  };\n  const resource = runtime.resource;\n  const states = { ...defaults, ...runtime.states } as LazyResourceStates;\n  const loader = createLazyLoader({\n    load: runtime.load,\n    select: (module) => findDefinedLayoutComponent(module, resource),\n    label: resource,\n    hooks,\n  });\n  const members = new Map<string, ComponentType<any>>();\n  function createMember(member?: string) {\n    function LazyMember(props: Record<string, unknown>) {\n      const Loading = states.Loading;\n      return (\n        <LazyBoundary\n          loader={loader}\n          member={member}\n          resource={resource}\n          componentProps={props}\n          ErrorComponent={states.Error}\n          onMount={hooks.onMount}\n          fallback={\n            runtime.fallback !== undefined ? (\n              runtime.fallback\n            ) : Loading ? (\n              <Loading resource={resource} />\n            ) : null\n          }\n        />\n      );\n    }\n    LazyMember.displayName = `LazyResource(${resource})${member ? `.${member}` : ''}`;\n    Object.defineProperties(LazyMember, {\n      preload: { value: loader.preload },\n      status: { get: () => loader.status },\n    });\n    return LazyMember;\n  }\n  const Component = createMember();\n  const reservedStatics = new Set<PropertyKey>([\n    'makeComposable',\n    'props',\n    'resource',\n    componentPropDefinitionsSymbol,\n    definedResourceLayoutComponentSymbol,\n    'contextTypes',\n    'childContextTypes',\n    'contextType',\n    'propTypes',\n    'defaultProps',\n    'getDerivedStateFromProps',\n    'getDerivedStateFromError',\n    'getDefaultProps',\n    '$$typeof',\n    '_payload',\n    '_init',\n    'render',\n    'compare',\n    'type',\n    'then',\n    'catch',\n    'finally',\n    'toJSON',\n    'asymmetricMatch',\n    '__esModule',\n    'default',\n  ]);\n  return new Proxy(Component, {\n    get(target, property, receiver) {\n      if (Reflect.has(target, property))\n        return Reflect.get(target, property, receiver);\n      if (\n        typeof property !== 'string' ||\n        reservedStatics.has(property) ||\n        !/^[A-Z]/.test(property)\n      )\n        return undefined;\n      let component = members.get(property);\n      if (!component) {\n        component = createMember(property);\n        members.set(property, component);\n      }\n      return component;\n    },\n    has: (target, property) => Reflect.has(target, property),\n  }) as unknown as LazyResourceLayoutComponent<Module>;\n}\n"],"mappings":";;;;;;;;AAkEA,SAAS,2BACP,QACA,UACA;CACA,MAAM,aAAa,OAAO,OAAO,MAAM,EACpC,KAAK,UACJ,OAAO,UAAU,YAAY,UAAU,QAAQ,UAAU,QACrD,MAAM,OACN,KACN,EACC,QACE,UACC,OAAO,UAAU,cACjB,wCAAwC,KAC5C;CACF,IAAI,WAAW,WAAW,GACxB,MAAM,IAAI,6BAA6B,UAAU,WAAW,MAAM;CACpE,OAAO,WAAW;AACpB;;AAGA,SAAgB,yBAId,SACA,UACA,QAA+B,CAAC,GACK;CACrC,MAAM,UAAU;CAIhB,MAAM,WAAW,QAAQ;CACzB,MAAM,SAAS;EAAE,GAAG;EAAU,GAAG,QAAQ;CAAO;CAChD,MAAM,SAAS,iBAAiB;EAC9B,MAAM,QAAQ;EACd,SAAS,WAAW,2BAA2B,QAAQ,QAAQ;EAC/D,OAAO;EACP;CACF,CAAC;CACD,MAAM,0BAAU,IAAI,IAAgC;CACpD,SAAS,aAAa,QAAiB;EACrC,SAAS,WAAW,OAAgC;GAClD,MAAM,UAAU,OAAO;GACvB,OACE,oBAAC,cAAD;IACU;IACA;IACE;IACV,gBAAgB;IAChB,gBAAgB,OAAO;IACvB,SAAS,MAAM;IACf,UACE,QAAQ,aAAa,SACnB,QAAQ,WACN,UACF,oBAAC,SAAD,EAAmB,SAAW,KAC5B;GAEP;EAEL;EACA,WAAW,cAAc,gBAAgB,SAAS,GAAG,SAAS,IAAI,WAAW;EAC7E,OAAO,iBAAiB,YAAY;GAClC,SAAS,EAAE,OAAO,OAAO,QAAQ;GACjC,QAAQ,EAAE,WAAW,OAAO,OAAO;EACrC,CAAC;EACD,OAAO;CACT;CACA,MAAM,YAAY,aAAa;CAC/B,MAAM,kBAAkB,IAAI,IAAiB;EAC3C;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF,CAAC;CACD,OAAO,IAAI,MAAM,WAAW;EAC1B,IAAI,QAAQ,UAAU,UAAU;GAC9B,IAAI,QAAQ,IAAI,QAAQ,QAAQ,GAC9B,OAAO,QAAQ,IAAI,QAAQ,UAAU,QAAQ;GAC/C,IACE,OAAO,aAAa,YACpB,gBAAgB,IAAI,QAAQ,KAC5B,CAAC,SAAS,KAAK,QAAQ,GAEvB,OAAO;GACT,IAAI,YAAY,QAAQ,IAAI,QAAQ;GACpC,IAAI,CAAC,WAAW;IACd,YAAY,aAAa,QAAQ;IACjC,QAAQ,IAAI,UAAU,SAAS;GACjC;GACA,OAAO;EACT;EACA,MAAM,QAAQ,aAAa,QAAQ,IAAI,QAAQ,QAAQ;CACzD,CAAC;AACH"}

package/dist/create-config/preview.cjs

@@ -1,6 +1,6 @@
 let react = require("react");
-let _jfdevelops_react_layout_devtools_core = require("@jfdevelops/react-layout-devtools-core");
 let react_jsx_runtime = require("react/jsx-runtime");
+let _jfdevelops_react_layout_devtools_core = require("@jfdevelops/react-layout-devtools-core");
 
 //#region src/create-config/preview.tsx
 /** Typed, partial props used only while an opted-in development preview is forced. */

package/dist/create-config/preview.d.cts

@@ -1,4 +1,6 @@
 import { ComponentType } from "react";
+import { InspectionStore } from "@jfdevelops/react-layout-devtools-core";
+
 //#region src/create-config/preview.d.ts
 type PropsOf<T> = T extends ((props: infer P, ...rest: never[]) => unknown) ? Partial<P> : never;
 type LayoutPreviewProps<T> = { [K in keyof T as K extends 'Root' | 'makeComposable' ? never : T[K] extends ((...args: never[]) => unknown) ? K : never]?: PropsOf<T[K]> } & {

package/dist/create-config/preview.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"preview.d.cts","names":[],"sources":["../../src/create-config/preview.tsx"],"mappings":";;KAcK,OAAA,MAAa,CAAA,WAAW,KAAA,cAAmB,IAAA,yBAC5C,OAAA,CAAQ,CAAA;AAAA,KAGA,kBAAA,oBACE,CAAA,IAAK,CAAA,6CAEb,CAAA,CAAE,CAAA,eAAe,IAAA,yBACjB,CAAA,YACS,OAAA,CAAQ,CAAA,CAAE,CAAA;EACnB,OAAA,GAAU,OAAA,CAAQ,CAAA;IAAY,IAAA;EAAA,IAAkB,CAAA,GAAI,CAAA;AAAA;;iBAG1C,mBAAA,mBACd,MAAA,EAAQ,CAAA,EACR,QAAA,EAAU,kBAAA,CAAmB,CAAA,IAC5B,CAAA"}
+{"version":3,"file":"preview.d.cts","names":[],"sources":["../../src/create-config/preview.tsx"],"mappings":";;;;KAcK,OAAA,MAAa,CAAA,WAAW,KAAA,cAAmB,IAAA,yBAC5C,OAAA,CAAQ,CAAA;AAAA,KAGA,kBAAA,oBACE,CAAA,IAAK,CAAA,6CAEb,CAAA,CAAE,CAAA,eAAe,IAAA,yBACjB,CAAA,YACS,OAAA,CAAQ,CAAA,CAAE,CAAA;EACnB,OAAA,GAAU,OAAA,CAAQ,CAAA;IAAY,IAAA;EAAA,IAAkB,CAAA,GAAI,CAAA;AAAA;;iBAG1C,mBAAA,mBACd,MAAA,EAAQ,CAAA,EACR,QAAA,EAAU,kBAAA,CAAmB,CAAA,IAC5B,CAAA"}

package/dist/create-config/preview.d.mts

@@ -1,4 +1,6 @@
 import { ComponentType } from "react";
+import { InspectionStore } from "@jfdevelops/react-layout-devtools-core";
+
 //#region src/create-config/preview.d.ts
 type PropsOf<T> = T extends ((props: infer P, ...rest: never[]) => unknown) ? Partial<P> : never;
 type LayoutPreviewProps<T> = { [K in keyof T as K extends 'Root' | 'makeComposable' ? never : T[K] extends ((...args: never[]) => unknown) ? K : never]?: PropsOf<T[K]> } & {

package/dist/create-config/preview.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"preview.d.mts","names":[],"sources":["../../src/create-config/preview.tsx"],"mappings":";;KAcK,OAAA,MAAa,CAAA,WAAW,KAAA,cAAmB,IAAA,yBAC5C,OAAA,CAAQ,CAAA;AAAA,KAGA,kBAAA,oBACE,CAAA,IAAK,CAAA,6CAEb,CAAA,CAAE,CAAA,eAAe,IAAA,yBACjB,CAAA,YACS,OAAA,CAAQ,CAAA,CAAE,CAAA;EACnB,OAAA,GAAU,OAAA,CAAQ,CAAA;IAAY,IAAA;EAAA,IAAkB,CAAA,GAAI,CAAA;AAAA;;iBAG1C,mBAAA,mBACd,MAAA,EAAQ,CAAA,EACR,QAAA,EAAU,kBAAA,CAAmB,CAAA,IAC5B,CAAA"}
+{"version":3,"file":"preview.d.mts","names":[],"sources":["../../src/create-config/preview.tsx"],"mappings":";;;;KAcK,OAAA,MAAa,CAAA,WAAW,KAAA,cAAmB,IAAA,yBAC5C,OAAA,CAAQ,CAAA;AAAA,KAGA,kBAAA,oBACE,CAAA,IAAK,CAAA,6CAEb,CAAA,CAAE,CAAA,eAAe,IAAA,yBACjB,CAAA,YACS,OAAA,CAAQ,CAAA,CAAE,CAAA;EACnB,OAAA,GAAU,OAAA,CAAQ,CAAA;IAAY,IAAA;EAAA,IAAkB,CAAA,GAAI,CAAA;AAAA;;iBAG1C,mBAAA,mBACd,MAAA,EAAQ,CAAA,EACR,QAAA,EAAU,kBAAA,CAAmB,CAAA,IAC5B,CAAA"}

package/dist/create-config/preview.mjs

@@ -1,6 +1,6 @@
 import { Component, createElement, useLayoutEffect, useState } from "react";
-import { inspectionId, layoutPreviewFixtures } from "@jfdevelops/react-layout-devtools-core";
 import { jsx, jsxs } from "react/jsx-runtime";
+import { inspectionId, layoutPreviewFixtures } from "@jfdevelops/react-layout-devtools-core";
 
 //#region src/create-config/preview.tsx
 /** Typed, partial props used only while an opted-in development preview is forced. */

package/dist/create-config/render-state-context.cjs

@@ -0,0 +1,24 @@
+let react = require("react");
+let react_jsx_runtime = require("react/jsx-runtime");
+
+//#region src/create-config/render-state-context.tsx
+/** Active state for descendants, including scoped components. */
+const RenderStateNameContext = (0, react.createContext)("default");
+/** Only state references carry the caller's name into another state's layout. */
+const ReferencedRenderStateContext = (0, react.createContext)(void 0);
+/** Automatic fallbacks start their own state instead of inheriting a reference. */
+function RenderStateFallback({ state, children }) {
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ReferencedRenderStateContext.Provider, {
+		value: void 0,
+		children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(RenderStateNameContext.Provider, {
+			value: state,
+			children
+		})
+	});
+}
+
+//#endregion
+exports.ReferencedRenderStateContext = ReferencedRenderStateContext;
+exports.RenderStateFallback = RenderStateFallback;
+exports.RenderStateNameContext = RenderStateNameContext;
+//# sourceMappingURL=render-state-context.cjs.map

package/dist/create-config/render-state-context.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-state-context.cjs","names":[],"sources":["../../src/create-config/render-state-context.tsx"],"sourcesContent":["import { createContext } from 'react';\n\n/** Active state for descendants, including scoped components. */\nexport const RenderStateNameContext = createContext<string>('default');\n\n/** Only state references carry the caller's name into another state's layout. */\nexport const ReferencedRenderStateContext = createContext<string | undefined>(\n  undefined,\n);\n\n/** Automatic fallbacks start their own state instead of inheriting a reference. */\nexport function RenderStateFallback({\n  state,\n  children,\n}: {\n  state: 'Loading' | 'Error';\n  children: import('react').ReactNode;\n}) {\n  return (\n    <ReferencedRenderStateContext.Provider value={undefined}>\n      <RenderStateNameContext.Provider value={state}>\n        {children}\n      </RenderStateNameContext.Provider>\n    </ReferencedRenderStateContext.Provider>\n  );\n}\n"],"mappings":";;;;;AAGA,MAAa,kDAA+C,SAAS;;AAGrE,MAAa,wDACX,MACF;;AAGA,SAAgB,oBAAoB,EAClC,OACA,YAIC;CACD,OACE,2CAAC,6BAA6B,UAA9B;EAAuC,OAAO;YAC5C,2CAAC,uBAAuB,UAAxB;GAAiC,OAAO;GACrC;EAC8B;CACI;AAE3C"}

package/dist/create-config/render-state-context.mjs

@@ -0,0 +1,22 @@
+import { createContext } from "react";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/create-config/render-state-context.tsx
+/** Active state for descendants, including scoped components. */
+const RenderStateNameContext = createContext("default");
+/** Only state references carry the caller's name into another state's layout. */
+const ReferencedRenderStateContext = createContext(void 0);
+/** Automatic fallbacks start their own state instead of inheriting a reference. */
+function RenderStateFallback({ state, children }) {
+	return /* @__PURE__ */ jsx(ReferencedRenderStateContext.Provider, {
+		value: void 0,
+		children: /* @__PURE__ */ jsx(RenderStateNameContext.Provider, {
+			value: state,
+			children
+		})
+	});
+}
+
+//#endregion
+export { ReferencedRenderStateContext, RenderStateFallback, RenderStateNameContext };
+//# sourceMappingURL=render-state-context.mjs.map

package/dist/create-config/render-state-context.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-state-context.mjs","names":[],"sources":["../../src/create-config/render-state-context.tsx"],"sourcesContent":["import { createContext } from 'react';\n\n/** Active state for descendants, including scoped components. */\nexport const RenderStateNameContext = createContext<string>('default');\n\n/** Only state references carry the caller's name into another state's layout. */\nexport const ReferencedRenderStateContext = createContext<string | undefined>(\n  undefined,\n);\n\n/** Automatic fallbacks start their own state instead of inheriting a reference. */\nexport function RenderStateFallback({\n  state,\n  children,\n}: {\n  state: 'Loading' | 'Error';\n  children: import('react').ReactNode;\n}) {\n  return (\n    <ReferencedRenderStateContext.Provider value={undefined}>\n      <RenderStateNameContext.Provider value={state}>\n        {children}\n      </RenderStateNameContext.Provider>\n    </ReferencedRenderStateContext.Provider>\n  );\n}\n"],"mappings":";;;;;AAGA,MAAa,yBAAyB,cAAsB,SAAS;;AAGrE,MAAa,+BAA+B,cAC1C,MACF;;AAGA,SAAgB,oBAAoB,EAClC,OACA,YAIC;CACD,OACE,oBAAC,6BAA6B,UAA9B;EAAuC,OAAO;YAC5C,oBAAC,uBAAuB,UAAxB;GAAiC,OAAO;GACrC;EAC8B;CACI;AAE3C"}

package/dist/create-config/render-state.cjs

@@ -1,10 +1,16 @@
 const require_layout_configuration_error = require('../errors/layout-configuration-error.cjs');
+const require_lazy_resource_error = require('../errors/lazy-resource-error.cjs');
 const require_state_composable = require('./state-composable.cjs');
 const require_props = require('../props.cjs');
+const require_create_lazy_loader = require('../lazy/create-lazy-loader.cjs');
+const require_inspection = require('../lazy/inspection.cjs');
 let _jfdevelops_react_layout_composables = require("@jfdevelops/react-layout-composables");
 let _jfdevelops_react_layout_devtools_core = require("@jfdevelops/react-layout-devtools-core");
 
 //#region src/create-config/render-state.ts
+const lazyLoaderSymbol = Symbol("lazyLoader");
+const lazyOptionsSymbol = Symbol("lazyOptions");
+const lazyInspectionSymbol = Symbol("lazyInspection");
 const deferredRenderStateSymbol = Symbol("deferredRenderState");
 const lazyRenderStateSymbol = Symbol("lazyRenderState");
 const definedRenderStateSymbol = Symbol.for("@jfdevelops/react-layout/render-state");
@@ -30,7 +36,7 @@ function toFragment(definition) {
 * Creates a state factory whose `props.include` keys are constrained by the
 * supplied resources and options.
 */
-function createRenderStateBuilder(_arguments) {
+function createRenderStateBuilder(_arguments, environment) {
 	function createRenderState(input) {
 		const definition = normalizeDefinition(input);
 		const debug = (0, _jfdevelops_react_layout_devtools_core.getLayoutDebug)(input);
@@ -39,16 +45,18 @@ function createRenderStateBuilder(_arguments) {
 			[_jfdevelops_react_layout_devtools_core.layoutDebug]: debug
 		} : definition);
 	}
+	createRenderState.forStates = (..._states) => createRenderState;
 	createRenderState.fromState = (input) => {
 		const entry = isLazyRenderState(input.ref) ? input.ref : Object.values(input.ref)[0];
 		if (isLazyRenderState(entry)) {
-			const lazyState = { [lazyRenderStateSymbol]: async () => {
-				const source = await findDefinedRenderState(await entry[lazyRenderStateSymbol]());
+			const lazyState = createRenderState.lazy(async () => {
+				if (entry.status === "error") entry[lazyLoaderSymbol].reset();
+				const source = await entry[lazyLoaderSymbol].get();
 				return { Derived: createRenderState.fromState({
 					...input,
 					ref: toFragment(source)
 				}) };
-			} };
+			});
 			const name = input.state ?? "default";
 			const fragment = { [name]: lazyState };
 			Object.defineProperty(fragment, definedRenderStateSymbol, { value: lazyState });
@@ -63,8 +71,8 @@ function createRenderStateBuilder(_arguments) {
 		const includes = input.props?.include ?? Object.fromEntries(Object.entries({
 			...source.props?.include,
 			...Object.fromEntries(Object.entries(source.props?.custom ?? {}).map(([key, prop]) => [key, {
-				visibility: prop.visibility,
-				passthrough: "component"
+				required: prop.visibility !== "optional",
+				suppliedVia: "component"
 			}]))
 		}).filter(([key]) => !(key in custom)));
 		return toFragment({
@@ -85,8 +93,8 @@ function createRenderStateBuilder(_arguments) {
 					props: {
 						...source.props,
 						include: Object.fromEntries(Object.entries(source.props?.include ?? {}).map(([key, behavior]) => [key, {
-							visibility: behavior === "optional" || require_props.getIncludedPropBehavior(behavior)?.visibility === "optional" ? "optional" : "required",
-							passthrough: "component"
+							required: !(behavior === "optional" || require_props.getIncludedPropBehavior(behavior)?.visibility === "optional"),
+							suppliedVia: "component"
 						}]))
 					}
 				};
@@ -126,15 +134,40 @@ function createRenderStateBuilder(_arguments) {
 			name: definition.state ?? "default"
 		});
 	};
-	createRenderState.lazy = (load) => {
-		const lazyState = {
-			[lazyRenderStateSymbol]: load,
-			[_jfdevelops_react_layout_devtools_core.layoutDebug]: (0, _jfdevelops_react_layout_devtools_core.getLayoutDebug)(load)
+	createRenderState.lazy = (input) => {
+		environment?.onLazy?.();
+		const options = typeof input === "function" ? { load: input } : input;
+		const inspection = require_inspection.inspectLazy("Render state");
+		const loaderOptions = {
+			load: options.load,
+			select: (module) => findDefinedRenderState(module, loaderOptions.label),
+			label: "Render state",
+			hooks: inspection.hooks
 		};
-		return require_state_composable.withStateComposable(lazyState, {
+		const loader = require_create_lazy_loader.createLazyLoader(loaderOptions);
+		const lazyState = require_inspection.withLazyHandle({
+			[lazyRenderStateSymbol]: options.load,
+			[lazyLoaderSymbol]: loader,
+			[lazyOptionsSymbol]: {
+				...options,
+				defaults: environment?.defaults ?? (() => ({}))
+			},
+			[lazyInspectionSymbol]: {
+				...inspection,
+				setLabel(value) {
+					if (loader.status !== "unresolved") return;
+					loaderOptions.label = value;
+					inspection.setLabel(value);
+				}
+			},
+			[_jfdevelops_react_layout_devtools_core.layoutDebug]: (0, _jfdevelops_react_layout_devtools_core.getLayoutDebug)(input)
+		}, loader);
+		const result = inspection.store.attach(require_state_composable.withStateComposable(lazyState, {
 			input: lazyState,
 			name: "lazy"
-		});
+		}));
+		environment?.store.connect(result);
+		return result;
 	};
 	return createRenderState;
 }
@@ -150,19 +183,26 @@ function isLazyRenderState(value) {
 * Resolves the single state exported by a lazy module, including derived lazy
 * states. Throws when a module exports none or more than one.
 */
-async function findDefinedRenderState(module) {
+async function findDefinedRenderState(module, label = "Render state") {
 	const definitions = Object.values(module).filter((value) => typeof value === "object" && value !== null && definedRenderStateSymbol in value);
-	if (definitions.length !== 1) throw new Error(`A lazy render-state module must export exactly one defined render state; received ${definitions.length}.`);
+	if (definitions.length !== 1) throw new require_lazy_resource_error.LazyResourceModuleShapeError(label, definitions.length);
 	const definition = definitions[0][definedRenderStateSymbol];
-	return isLazyRenderState(definition) ? findDefinedRenderState(await definition[lazyRenderStateSymbol]()) : definition;
+	if (isLazyRenderState(definition)) {
+		if (definition.status === "error") definition[lazyLoaderSymbol].reset();
+		return definition[lazyLoaderSymbol].get();
+	}
+	return definition;
 }
 
 //#endregion
 exports.createRenderStateBuilder = createRenderStateBuilder;
 exports.deferredRenderStateSymbol = deferredRenderStateSymbol;
+exports.definedRenderStateSymbol = definedRenderStateSymbol;
 exports.definedResourceLayoutComponentSymbol = definedResourceLayoutComponentSymbol;
 exports.findDefinedRenderState = findDefinedRenderState;
 exports.isDeferredRenderState = isDeferredRenderState;
 exports.isLazyRenderState = isLazyRenderState;
-exports.lazyRenderStateSymbol = lazyRenderStateSymbol;
+exports.lazyInspectionSymbol = lazyInspectionSymbol;
+exports.lazyLoaderSymbol = lazyLoaderSymbol;
+exports.lazyOptionsSymbol = lazyOptionsSymbol;
 //# sourceMappingURL=render-state.cjs.map