@jfdevelops/react-layout 1.0.1 → 1.2.0

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

@@ -1,4 +1,5 @@
-import { AnyRenderStateDefinition, CreateLayoutBuildingBlocks, CreateLayoutBuildingBlocksArguments, CreateLayoutBuildingBlocksResult, CreateRenderState, CreateRenderStateBuilderArguments, CreateRenderStateBuilderResult, DeferredRenderState, DefineLayoutComposables, LayoutComposablesDefinition, LazyRenderState, RenderStateCallback, RenderStateComposablesDefinition, RenderStateContext, RenderStateFragment, RenderStateName, RenderStateOverloads, RenderStateProps, TypedRenderStateCallback } from "./render-state.mjs";
+import { AsStateComposable, StateComposable, StateComposableOptions } from "./state-composable.mjs";
+import { AnyRenderStateDefinition, CreateLayoutBuildingBlocks, CreateLayoutBuildingBlocksArguments, CreateLayoutBuildingBlocksResult, CreateRenderState, CreateRenderStateBuilderArguments, CreateRenderStateBuilderResult, CreateRenderStateFromState, DeferredRenderState, DefineLayoutComposables, LayoutComposablesDefinition, LazyRenderState, RenderStateCallProps, RenderStateCallback, RenderStateComposablesDefinition, RenderStateContext, RenderStateFragment, RenderStateName, RenderStateOverloads, RenderStateProps, RenderStateReferences, TypedRenderStateCallback } from "./render-state.mjs";
 import { BaseResourceConfigComponents, ResourceConfig, ResourceConfigComponentKey, ResourceConfigComponents, ResourceConfigInput, ResourceConfigMap, SharedResourceConfigOptions, SubResourceConfig, SubResourceConfigComponentsFor } from "./types.mjs";
 import { ComponentPathVariable, ExtractPathVariables, PATH_VARIABLE_IDENTIFIER, PathHasVariables, PathVariable, ResourcePathVariable, SubResourcePathVariable } from "./paths/variables.mjs";
 import { ConfigResourceKeys, ConfigSubResourceKeys, ParameterizedEntryPath, ParameterizedResourcePath, PathComponentKeys, PathResourceCandidates, PathSubResourceKeys, PathVariables, PathVariablesForResource, ResolveParameterizedPathValue, ResourceSubResourceKeys } from "./paths/types.mjs";

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

@@ -28,7 +28,7 @@ var LazyResourceErrorBoundary = class extends react.Component {
 	}
 };
 function findDefinedLayoutComponent(module) {
-	const components = Object.values(module).filter((value) => typeof value === "function" && require_render_state.definedResourceLayoutComponentSymbol in value);
+	const components = Object.values(module).map((value) => typeof value === "object" && value !== null && "Root" in value ? value.Root : value).filter((value) => typeof value === "function" && require_render_state.definedResourceLayoutComponentSymbol in value);
 	if (components.length !== 1) throw new require_layout_configuration_error.LayoutConfigurationError(`A lazy resource module must export exactly one created resource layout component; received ${components.length}`);
 	return components[0];
 }

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

@@ -1 +1 @@
-{"version":3,"file":"lazy-resource-layout.cjs","names":["Component","definedResourceLayoutComponentSymbol","LayoutConfigurationError","ResourceModuleLoadError","Suspense","componentPropDefinitionsSymbol"],"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 DefinedLayoutFromModule<Module> = Extract<\n  Module[keyof Module],\n  DefinedLayoutComponent\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  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).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.cjs","names":["Component","definedResourceLayoutComponentSymbol","LayoutConfigurationError","ResourceModuleLoadError","Suspense","componentPropDefinitionsSymbol"],"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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"}

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

@@ -7,7 +7,10 @@ import { componentPropDefinitionsSymbol } from "@jfdevelops/react-layout-validat
 type DefinedLayoutComponent = ComponentType<any> & {
   readonly [definedResourceLayoutComponentSymbol]: true;
 };
-type DefinedLayoutFromModule<Module> = Extract<Module[keyof Module], DefinedLayoutComponent>;
+type UnwrapDefinedLayout<Export> = Export extends DefinedLayoutComponent ? Export : Export extends {
+  Root: infer Root extends DefinedLayoutComponent;
+} ? Root : never;
+type DefinedLayoutFromModule<Module> = UnwrapDefinedLayout<Module[keyof Module]>;
 type LazyUnsupportedStatic = 'makeComposable' | 'props' | 'resource' | typeof componentPropDefinitionsSymbol | typeof definedResourceLayoutComponentSymbol;
 /**
  * Public surface available before a lazy module resolves. Component metadata

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,uBAAA,WAAkC,OAAA,CACrC,MAAA,OAAa,MAAA,GACb,sBAAA;AAAA,KAGG,qBAAA,oDAIM,8BAAA,UACA,oCAAoC;;AAbC;AAAA;;;KAoBpC,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;;AA7BO;AAO/C;;;KA8BY,yBAAA,mBACQ,aAAA,CAAc,kBAAA,kBACjB,MAAA;EAEf,IAAA,QAAY,OAAA,CAAQ,MAAA;EACpB,QAAA,EAAU,YAAA,CAAa,SAAA;EACvB,MAAA,GAAS,kBAAA;AAAA;;;;;;iBAgEK,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":";;;;;;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"}

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

@@ -7,7 +7,10 @@ import { componentPropDefinitionsSymbol } from "@jfdevelops/react-layout-validat
 type DefinedLayoutComponent = ComponentType<any> & {
   readonly [definedResourceLayoutComponentSymbol]: true;
 };
-type DefinedLayoutFromModule<Module> = Extract<Module[keyof Module], DefinedLayoutComponent>;
+type UnwrapDefinedLayout<Export> = Export extends DefinedLayoutComponent ? Export : Export extends {
+  Root: infer Root extends DefinedLayoutComponent;
+} ? Root : never;
+type DefinedLayoutFromModule<Module> = UnwrapDefinedLayout<Module[keyof Module]>;
 type LazyUnsupportedStatic = 'makeComposable' | 'props' | 'resource' | typeof componentPropDefinitionsSymbol | typeof definedResourceLayoutComponentSymbol;
 /**
  * Public surface available before a lazy module resolves. Component metadata

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,uBAAA,WAAkC,OAAA,CACrC,MAAA,OAAa,MAAA,GACb,sBAAA;AAAA,KAGG,qBAAA,oDAIM,8BAAA,UACA,oCAAoC;;AAbC;AAAA;;;KAoBpC,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;;AA7BO;AAO/C;;;KA8BY,yBAAA,mBACQ,aAAA,CAAc,kBAAA,kBACjB,MAAA;EAEf,IAAA,QAAY,OAAA,CAAQ,MAAA;EACpB,QAAA,EAAU,YAAA,CAAa,SAAA;EACvB,MAAA,GAAS,kBAAA;AAAA;;;;;;iBAgEK,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":";;;;;;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"}

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

@@ -28,7 +28,7 @@ var LazyResourceErrorBoundary = class extends Component {
 	}
 };
 function findDefinedLayoutComponent(module) {
-	const components = Object.values(module).filter((value) => typeof value === "function" && definedResourceLayoutComponentSymbol in value);
+	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}`);
 	return components[0];
 }

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 DefinedLayoutFromModule<Module> = Extract<\n  Module[keyof Module],\n  DefinedLayoutComponent\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  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).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 {\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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"}

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

@@ -1,3 +1,6 @@
+const require_layout_configuration_error = require('../errors/layout-configuration-error.cjs');
+const require_state_composable = require('./state-composable.cjs');
+let _jfdevelops_react_layout_composables = require("@jfdevelops/react-layout-composables");
 
 //#region src/create-config/render-state.ts
 const deferredRenderStateSymbol = Symbol("deferredRenderState");
@@ -16,7 +19,10 @@ function toFragment(definition) {
 		enumerable: false,
 		value: definition
 	});
-	return fragment;
+	return require_state_composable.withStateComposable(fragment, {
+		input: definition,
+		name: definition.state ?? "default"
+	});
 }
 /**
 * Creates a state factory whose `props.include` keys are constrained by the
@@ -26,11 +32,93 @@ function createRenderStateBuilder(_arguments) {
 	function createRenderState(input) {
 		return toFragment(normalizeDefinition(input));
 	}
+	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]());
+				return { Derived: createRenderState.fromState({
+					...input,
+					ref: toFragment(source)
+				}) };
+			} };
+			const name = input.state ?? "default";
+			const fragment = { [name]: lazyState };
+			Object.defineProperty(fragment, definedRenderStateSymbol, { value: lazyState });
+			return require_state_composable.withStateComposable(fragment, {
+				input: lazyState,
+				name
+			});
+		}
+		const source = isDeferredRenderState(entry) ? entry[deferredRenderStateSymbol] : definedRenderStateSymbol in input.ref ? input.ref[definedRenderStateSymbol] : void 0;
+		if (!source || typeof source.render !== "function") throw new require_layout_configuration_error.LayoutConfigurationError("fromState requires a created render state");
+		const custom = input.props?.custom ?? {};
+		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"
+			}]))
+		}).filter(([key]) => !(key in custom)));
+		return toFragment({
+			state: input.state ?? "default",
+			props: {
+				custom,
+				include: includes
+			},
+			composables: (create, states) => {
+				const inherited = source.composables?.(create, states) ?? {};
+				const local = input.composables?.(create, states) ?? {};
+				if (Object.prototype.hasOwnProperty.call(local, "Ref")) throw new require_layout_configuration_error.LayoutConfigurationError("Composable name \"Ref\" is reserved by fromState");
+				const schemas = Object.assign({}, ...(0, _jfdevelops_react_layout_composables.collectComposablePresetEntries)(inherited).map(({ props }) => props), source.props?.custom);
+				const selected = Object.fromEntries(Object.entries(schemas).filter(([key]) => key in includes));
+				const referenceSource = {
+					...source,
+					props: {
+						...source.props,
+						include: Object.fromEntries(Object.entries(source.props?.include ?? {}).map(([key, behavior]) => [key, {
+							visibility: behavior === "optional" || typeof behavior === "object" && behavior !== null && "visibility" in behavior && behavior.visibility === "optional" ? "optional" : "required",
+							passthrough: "component"
+						}]))
+					}
+				};
+				const Ref = require_state_composable.createStateComposable({
+					input: input.lazy || isDeferredRenderState(entry) ? { [deferredRenderStateSymbol]: referenceSource } : referenceSource,
+					name: source.state ?? "default",
+					fallbackStateName: input.state
+				}, {
+					props: { include: Object.fromEntries(Object.keys(includes).map((key) => [key, true])) },
+					normalizeIncludedKeys: true
+				});
+				Object.defineProperty(Ref, _jfdevelops_react_layout_composables.composablePresetMetaKey, { value: {
+					key: "Ref",
+					props: selected
+				} });
+				return {
+					...local,
+					Ref
+				};
+			},
+			render: input.render
+		});
+	};
 	createRenderState.defer = (input) => {
 		const definition = normalizeDefinition(input);
-		return { [definition.state ?? "default"]: { [deferredRenderStateSymbol]: definition } };
+		const deferred = { [deferredRenderStateSymbol]: definition };
+		const fragment = { [definition.state ?? "default"]: deferred };
+		Object.defineProperty(fragment, definedRenderStateSymbol, { value: definition });
+		return require_state_composable.withStateComposable(fragment, {
+			input: deferred,
+			name: definition.state ?? "default"
+		});
+	};
+	createRenderState.lazy = (load) => {
+		const lazyState = { [lazyRenderStateSymbol]: load };
+		return require_state_composable.withStateComposable(lazyState, {
+			input: lazyState,
+			name: "lazy"
+		});
 	};
-	createRenderState.lazy = (load) => ({ [lazyRenderStateSymbol]: load });
 	return createRenderState;
 }
 /** Type guard for states created with `createRenderState.defer(...)`. */
@@ -42,13 +130,14 @@ function isLazyRenderState(value) {
 	return typeof value === "object" && value !== null && lazyRenderStateSymbol in value;
 }
 /**
-* Selects the single state definition exported by a lazy module. Throws when
-* the module exports none or more than one, avoiding ambiguous selection.
+* Resolves the single state exported by a lazy module, including derived lazy
+* states. Throws when a module exports none or more than one.
 */
-function findDefinedRenderState(module) {
+async function findDefinedRenderState(module) {
 	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}.`);
-	return definitions[0][definedRenderStateSymbol];
+	const definition = definitions[0][definedRenderStateSymbol];
+	return isLazyRenderState(definition) ? findDefinedRenderState(await definition[lazyRenderStateSymbol]()) : definition;
 }
 
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"render-state.cjs","names":[],"sources":["../../src/create-config/render-state.ts"],"sourcesContent":["import type { JSX } from 'react';\nimport type {\n  ComposableComponents,\n  CreateLayoutComposable,\n} from '@jfdevelops/react-layout-composables';\nimport type { InPropsObject } from '../props';\nimport type {\n  IncludedProps,\n  InPropsDefinition,\n  LayoutRenderProps,\n  MergedLayoutInProps,\n} from '../props';\nimport type { LayoutResourceKey, ResourceDefinition } from '../resource';\n\nexport const deferredRenderStateSymbol: unique symbol = Symbol(\n  'deferredRenderState',\n) as never;\nexport const lazyRenderStateSymbol: unique symbol = Symbol(\n  'lazyRenderState',\n) as never;\nexport const definedRenderStateSymbol: unique symbol = Symbol.for(\n  '@jfdevelops/react-layout/render-state',\n) as never;\nexport const definedResourceLayoutComponentSymbol: unique symbol = Symbol.for(\n  '@jfdevelops/react-layout/resource-layout-component',\n) as never;\n\n/** Runtime-compatible render-state shape used when inspecting lazy modules. */\nexport type AnyRenderStateDefinition = {\n  composables?: (create: CreateLayoutComposable<any>) => ComposableComponents;\n  props?: {\n    include?: Record<string, unknown>;\n    custom?: InPropsObject;\n  };\n  render: (props: any, context: any) => JSX.Element;\n  state?: string;\n};\n\n/** An inline state whose first render is scheduled through `React.lazy`. */\nexport type DeferredRenderState<Definition extends AnyRenderStateDefinition> = {\n  readonly [deferredRenderStateSymbol]: Definition;\n};\n\n/** A state definition supplied by a separately imported module. */\nexport type LazyRenderState<Definition extends AnyRenderStateDefinition> = {\n  readonly [lazyRenderStateSymbol]: () => Promise<Record<string, unknown>>;\n  readonly definition?: Definition;\n};\n\n/**\n * State names accepted by `createRenderState`. Built-in states are suggested by\n * autocomplete while any other string still creates a custom compound state.\n */\nexport type RenderStateName =\n  | 'default'\n  | 'Loading'\n  | 'Error'\n  | 'NotFound'\n  | (string & {});\n\n/** Callback shorthand for a render state with no local configuration. */\nexport type RenderStateCallback = (props: any, context: any) => JSX.Element;\n\n/**\n * Defines state-local composable components with a `create` helper narrowed to\n * the resources bound to the surrounding builder.\n */\nexport type RenderStateComposablesDefinition<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Composables extends ComposableComponents,\n> = (\n  create: CreateLayoutComposable<LayoutResourceKey<Resources>>,\n) => Composables;\n\n/**\n * Defines reusable layout-level composables while preserving their inferred\n * names, props, and bound resource union.\n */\nexport type LayoutComposablesDefinition<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Composables extends ComposableComponents,\n> = RenderStateComposablesDefinition<Resources, Composables>;\n\ntype BuilderRenderComposables<Composables extends ComposableComponents> = [\n  keyof Composables,\n] extends [never]\n  ? undefined\n  : Composables;\n\n/** Values available as the second argument of a created state's `render`. */\nexport type RenderStateContext<\n  Composables extends ComposableComponents,\n> = {\n  composables: BuilderRenderComposables<Composables>;\n  retry?: () => void;\n};\n\n/**\n * Resolves one state's custom props and explicitly included option/composable\n * props to the values received by its render callback.\n */\nexport type RenderStateProps<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  IncludeProps extends IncludedProps<\n    MergedLayoutInProps<Resources, Options, Composables>\n  >,\n  CustomProps extends InPropsObject,\n> = LayoutRenderProps<\n  Resources,\n  Options,\n  Composables,\n  IncludeProps,\n  CustomProps\n>;\n\ntype TypedRenderStateDefinition<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  State extends string,\n  CustomProps extends InPropsObject,\n  SharedComposables extends ComposableComponents,\n  StateComposables extends ComposableComponents,\n  IncludeProps extends IncludedProps<\n    MergedLayoutInProps<\n      Resources,\n      Options,\n      SharedComposables & StateComposables\n    >\n  >,\n> = {\n  composables?: RenderStateComposablesDefinition<Resources, StateComposables>;\n  props?: {\n    include?: IncludeProps;\n    custom?: CustomProps;\n  };\n  render: (\n    props: RenderStateProps<\n      Resources,\n      Options,\n      SharedComposables & StateComposables,\n      IncludeProps,\n      CustomProps\n    >,\n    context: RenderStateContext<SharedComposables & StateComposables>,\n  ) => JSX.Element;\n  state: State;\n};\n\n/**\n * Callback shorthand for a created state, typed with the bound resources,\n * options, and shared composables.\n */\nexport type TypedRenderStateCallback<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  SharedComposables extends ComposableComponents,\n> = (\n  props: RenderStateProps<Resources, Options, SharedComposables, {}, {}>,\n  context: RenderStateContext<SharedComposables>,\n) => JSX.Element;\n\ntype NormalizeRenderStateDefinition<Input> =\n  Input extends DeferredRenderState<infer Definition>\n    ? Definition\n    : Input extends RenderStateCallback\n      ? { render: Input; state: 'default' }\n      : Input extends AnyRenderStateDefinition\n        ? Input\n        : never;\n\ntype StateName<Definition> = Definition extends DeferredRenderState<\n  infer DeferredDefinition\n>\n  ? StateName<DeferredDefinition>\n  : Definition extends { state?: infer State extends string }\n    ? State\n    : 'default';\n\n/**\n * A spreadable state entry keyed by its literal state name. Spreading this into\n * `layout.render` is what creates compound members such as `Users.Loading`.\n */\nexport type RenderStateFragment<Definition> = {\n  [State in StateName<NormalizeRenderStateDefinition<Definition>>]: Definition;\n} & {\n  readonly [definedRenderStateSymbol]: NormalizeRenderStateDefinition<Definition>;\n};\n\ntype DefinedRenderStateFromModule<Module> = Extract<\n  Module[keyof Module],\n  { readonly [definedRenderStateSymbol]: AnyRenderStateDefinition }\n>[typeof definedRenderStateSymbol];\n\n/** Wraps a state definition in the deferred marker when `Deferred` is `true`. */\ntype RenderStateEntry<Definition, Deferred extends boolean> = Deferred extends true\n  ? DeferredRenderState<NormalizeRenderStateDefinition<Definition>>\n  : Definition;\n\n/**\n * Overloads shared by `createRenderState` and `createRenderState.defer`. Each\n * accepts a full definition, a definition without `state`, or a render\n * callback; `Deferred` decides whether the returned entry is deferred.\n */\nexport interface RenderStateOverloads<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  SharedComposables extends ComposableComponents,\n  Deferred extends boolean,\n> {\n  <\n    const State extends RenderStateName,\n    const CustomProps extends InPropsObject = {},\n    const StateComposables extends ComposableComponents = {},\n    const IncludeProps extends IncludedProps<\n      MergedLayoutInProps<\n        Resources,\n        Options,\n        SharedComposables & StateComposables\n      >\n    > = {},\n  >(\n    definition: TypedRenderStateDefinition<\n      Resources,\n      Options,\n      State,\n      CustomProps,\n      SharedComposables,\n      StateComposables,\n      IncludeProps\n    >,\n  ): RenderStateFragment<\n    RenderStateEntry<\n      TypedRenderStateDefinition<\n        Resources,\n        Options,\n        State,\n        CustomProps,\n        SharedComposables,\n        StateComposables,\n        IncludeProps\n      >,\n      Deferred\n    >\n  >;\n  <\n    const CustomProps extends InPropsObject = {},\n    const StateComposables extends ComposableComponents = {},\n    const IncludeProps extends IncludedProps<\n      MergedLayoutInProps<\n        Resources,\n        Options,\n        SharedComposables & StateComposables\n      >\n    > = {},\n  >(\n    definition: Omit<\n      TypedRenderStateDefinition<\n        Resources,\n        Options,\n        'default',\n        CustomProps,\n        SharedComposables,\n        StateComposables,\n        IncludeProps\n      >,\n      'state'\n    >,\n  ): RenderStateFragment<\n    RenderStateEntry<\n      TypedRenderStateDefinition<\n        Resources,\n        Options,\n        'default',\n        CustomProps,\n        SharedComposables,\n        StateComposables,\n        IncludeProps\n      >,\n      Deferred\n    >\n  >;\n  (\n    render: TypedRenderStateCallback<Resources, Options, SharedComposables>,\n  ): RenderStateFragment<\n    RenderStateEntry<\n      TypedRenderStateCallback<Resources, Options, SharedComposables>,\n      Deferred\n    >\n  >;\n}\n\n/**\n * Creates independently typed render-state fragments.\n *\n * - Calling it directly creates an eager state.\n * - `.defer(...)` schedules an inline definition through `React.lazy`, but\n *   does not create a separate JavaScript chunk.\n * - `.lazy(() => import(...))` imports a complete named state definition as a\n *   separate chunk.\n */\nexport interface CreateRenderState<\n  Resources extends ReadonlyArray<ResourceDefinition> = ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources> = {},\n  SharedComposables extends ComposableComponents = {},\n> extends RenderStateOverloads<Resources, Options, SharedComposables, false> {\n  defer: RenderStateOverloads<Resources, Options, SharedComposables, true>;\n  lazy<Module extends Record<string, unknown>>(\n    load: () => Promise<Module>,\n  ): LazyRenderState<DefinedRenderStateFromModule<Module>>;\n}\n\nfunction normalizeDefinition(\n  input: AnyRenderStateDefinition | RenderStateCallback,\n): AnyRenderStateDefinition {\n  return typeof input === 'function'\n    ? { render: input, state: 'default' }\n    : input;\n}\n\nfunction toFragment<Definition extends AnyRenderStateDefinition>(\n  definition: Definition,\n) {\n  const fragment = {\n    [definition.state ?? 'default']: definition,\n  } as RenderStateFragment<Definition>;\n\n  Object.defineProperty(fragment, definedRenderStateSymbol, {\n    enumerable: false,\n    value: definition,\n  });\n\n  return fragment;\n}\n\n/** Inputs used internally to bind resource and option types to a state builder. */\nexport type CreateRenderStateBuilderArguments<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  SharedComposables extends ComposableComponents = {},\n> = {\n  /** Shared composables whose components and preset props every state can use. */\n  composables?: LayoutComposablesDefinition<Resources, SharedComposables>;\n  /** Option props that individual states can expose through `props.include`. */\n  options: Options;\n  /** Resources used to constrain composable names and resource-specific props. */\n  resources: Resources;\n};\n\n/** The state factory produced for a particular resource and option definition. */\nexport type CreateRenderStateBuilderResult<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  SharedComposables extends ComposableComponents = {},\n> = CreateRenderState<Resources, Options, SharedComposables>;\n\n/**\n * Creates a state factory whose `props.include` keys are constrained by the\n * supplied resources and options.\n */\nexport function createRenderStateBuilder<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  SharedComposables extends ComposableComponents = {},\n>(\n  _arguments: CreateRenderStateBuilderArguments<\n    Resources,\n    Options,\n    SharedComposables\n  >,\n): CreateRenderStateBuilderResult<Resources, Options, SharedComposables> {\n  function createRenderState(\n    input: AnyRenderStateDefinition | RenderStateCallback,\n  ) {\n    return toFragment(normalizeDefinition(input));\n  }\n\n  createRenderState.defer = (\n    input: AnyRenderStateDefinition | RenderStateCallback,\n  ) => {\n    const definition = normalizeDefinition(input);\n\n    return {\n      [definition.state ?? 'default']: {\n        [deferredRenderStateSymbol]: definition,\n      },\n    };\n  };\n  createRenderState.lazy = (\n    load: () => Promise<Record<string, unknown>>,\n  ) => ({\n    [lazyRenderStateSymbol]: load,\n  });\n\n  return createRenderState as CreateRenderStateBuilderResult<\n    Resources,\n    Options,\n    SharedComposables\n  >;\n}\n\n/** Type guard for states created with `createRenderState.defer(...)`. */\nexport function isDeferredRenderState(\n  value: unknown,\n): value is DeferredRenderState<AnyRenderStateDefinition> {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    deferredRenderStateSymbol in value\n  );\n}\n\n/** Type guard for states created with `createRenderState.lazy(...)`. */\nexport function isLazyRenderState(\n  value: unknown,\n): value is LazyRenderState<AnyRenderStateDefinition> {\n  return (\n    typeof value === 'object' && value !== null && lazyRenderStateSymbol in value\n  );\n}\n\n/**\n * Selects the single state definition exported by a lazy module. Throws when\n * the module exports none or more than one, avoiding ambiguous selection.\n */\nexport function findDefinedRenderState(\n  module: Record<string, unknown>,\n): AnyRenderStateDefinition {\n  const definitions = Object.values(module).filter(\n    (value) =>\n      typeof value === 'object' && value !== null && definedRenderStateSymbol in value,\n  ) as Array<Record<typeof definedRenderStateSymbol, AnyRenderStateDefinition>>;\n\n  if (definitions.length !== 1) {\n    throw new Error(\n      `A lazy render-state module must export exactly one defined render state; received ${definitions.length}.`,\n    );\n  }\n\n  return definitions[0][definedRenderStateSymbol];\n}\n\n/** Identity helper that contextually types a reusable composables callback. */\nexport type DefineLayoutComposables<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = <const Composables extends ComposableComponents>(\n  definition: LayoutComposablesDefinition<Resources, Composables>,\n) => LayoutComposablesDefinition<Resources, Composables>;\n\n/** Public cross-file building blocks returned by a defined layout builder. */\nexport type CreateLayoutBuildingBlocks<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n> = {\n  composables: DefineLayoutComposables<Resources>;\n  createRenderState: CreateRenderState<Resources, Options>;\n};\n\n/** Resource and option bindings used to create layout building blocks. */\nexport type CreateLayoutBuildingBlocksArguments<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n> = CreateRenderStateBuilderArguments<Resources, Options>;\n\n/** Layout helpers produced for the supplied resource and option bindings. */\nexport type CreateLayoutBuildingBlocksResult<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n> = CreateLayoutBuildingBlocks<Resources, Options>;\n\n/**\n * Creates the reusable `composables` and `createRenderState` helpers without\n * introducing an identity wrapper around the layout object itself.\n */\nexport function createLayoutBuildingBlocks<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n>(\n  arguments_: CreateLayoutBuildingBlocksArguments<Resources, Options>,\n): CreateLayoutBuildingBlocksResult<Resources, Options> {\n  function composables<const Composables extends ComposableComponents>(\n    definition: LayoutComposablesDefinition<Resources, Composables>,\n  ): LayoutComposablesDefinition<Resources, Composables> {\n    return definition;\n  }\n\n  return {\n    composables,\n    createRenderState: createRenderStateBuilder(arguments_),\n  };\n}\n\n/** Preserves a bound resource tuple for consumers that need to re-export it. */\nexport type BoundResources<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = Resources;\n"],"mappings":";;AAcA,MAAa,4BAA2C,OACtD,qBACF;AACA,MAAa,wBAAuC,OAClD,iBACF;AACA,MAAa,2BAA0C,OAAO,IAC5D,uCACF;AACA,MAAa,uCAAsD,OAAO,IACxE,oDACF;AAgSA,SAAS,oBACP,OAC0B;CAC1B,OAAO,OAAO,UAAU,aACpB;EAAE,QAAQ;EAAO,OAAO;CAAU,IAClC;AACN;AAEA,SAAS,WACP,YACA;CACA,MAAM,WAAW,GACd,WAAW,SAAS,YAAY,WACnC;CAEA,OAAO,eAAe,UAAU,0BAA0B;EACxD,YAAY;EACZ,OAAO;CACT,CAAC;CAED,OAAO;AACT;;;;;AA2BA,SAAgB,yBAKd,YAKuE;CACvE,SAAS,kBACP,OACA;EACA,OAAO,WAAW,oBAAoB,KAAK,CAAC;CAC9C;CAEA,kBAAkB,SAChB,UACG;EACH,MAAM,aAAa,oBAAoB,KAAK;EAE5C,OAAO,GACJ,WAAW,SAAS,YAAY,GAC9B,4BAA4B,WAC/B,EACF;CACF;CACA,kBAAkB,QAChB,UACI,GACH,wBAAwB,KAC3B;CAEA,OAAO;AAKT;;AAGA,SAAgB,sBACd,OACwD;CACxD,OACE,OAAO,UAAU,YACjB,UAAU,QACV,6BAA6B;AAEjC;;AAGA,SAAgB,kBACd,OACoD;CACpD,OACE,OAAO,UAAU,YAAY,UAAU,QAAQ,yBAAyB;AAE5E;;;;;AAMA,SAAgB,uBACd,QAC0B;CAC1B,MAAM,cAAc,OAAO,OAAO,MAAM,EAAE,QACvC,UACC,OAAO,UAAU,YAAY,UAAU,QAAQ,4BAA4B,KAC/E;CAEA,IAAI,YAAY,WAAW,GACzB,MAAM,IAAI,MACR,qFAAqF,YAAY,OAAO,EAC1G;CAGF,OAAO,YAAY,GAAG;AACxB"}
+{"version":3,"file":"render-state.cjs","names":["withStateComposable","LayoutConfigurationError","createStateComposable","composablePresetMetaKey"],"sources":["../../src/create-config/render-state.ts"],"sourcesContent":["import type { JSX } from 'react';\nimport { collectComposablePresetEntries, composablePresetMetaKey, type MergePresetProps, type ComposablePresetMeta } from '@jfdevelops/react-layout-composables';\nimport { LayoutConfigurationError } from '../errors';\nimport { createStateComposable, withStateComposable, type StateComposable, type StateComposableHandle } from './state-composable';\nimport type { ResolveProps } from '@jfdevelops/react-layout-validator';\nimport type {\n  ComposableComponents,\n  CreateLayoutComposable,\n} from '@jfdevelops/react-layout-composables';\nimport type { InPropsObject } from '../props';\nimport type {\n  IncludedProps,\n  InPropsDefinition,\n  LayoutRenderProps,\n  MergedLayoutInProps,\n  ResolvedIncludedComponentProps,\n  ResolvedIncludedProps,\n} from '../props';\nimport type { LayoutResourceKey, ResourceDefinition } from '../resource';\nimport type { LayoutRenderResourcesAccessor } from './define-layout';\n\nexport const deferredRenderStateSymbol: unique symbol = Symbol(\n  'deferredRenderState',\n) as never;\nexport const lazyRenderStateSymbol: unique symbol = Symbol(\n  'lazyRenderState',\n) as never;\nexport const definedRenderStateSymbol: unique symbol = Symbol.for(\n  '@jfdevelops/react-layout/render-state',\n) as never;\nexport const definedResourceLayoutComponentSymbol: unique symbol = Symbol.for(\n  '@jfdevelops/react-layout/resource-layout-component',\n) as never;\n\n/** Runtime-compatible render-state shape used when inspecting lazy modules. */\nexport type AnyRenderStateDefinition = {\n  composables?: (create: CreateLayoutComposable<any>, states: any) => ComposableComponents;\n  props?: {\n    include?: Record<string, unknown>;\n    custom?: InPropsObject;\n  };\n  render: (props: any, context: any) => JSX.Element;\n  state?: string;\n};\n\n/** An inline state whose first render is scheduled through `React.lazy`. */\nexport type DeferredRenderState<Definition extends AnyRenderStateDefinition> = {\n  readonly [deferredRenderStateSymbol]: Definition;\n};\n\n/** A state definition supplied by a separately imported module. */\nexport type LazyRenderState<Definition extends AnyRenderStateDefinition> = {\n  readonly [lazyRenderStateSymbol]: () => Promise<Record<string, unknown>>;\n  readonly definition?: Definition;\n};\n\n/**\n * State names accepted by `createRenderState`. Built-in states are suggested by\n * autocomplete while any other string still creates a custom compound state.\n */\nexport type RenderStateName =\n  | 'default'\n  | 'Loading'\n  | 'Error'\n  | 'NotFound'\n  | (string & {});\n\n/** Callback shorthand for a render state with no local configuration. */\nexport type RenderStateCallback = (props: any, context: any) => JSX.Element;\n\n/**\n * Defines state-local composable components with a `create` helper narrowed to\n * the resources bound to the surrounding builder.\n */\nexport type RenderStateComposablesDefinition<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Composables extends ComposableComponents,\n  States = {},\n> = (\n  create: CreateLayoutComposable<LayoutResourceKey<Resources>>,\n  states: States,\n) => Composables;\n\n/**\n * Defines reusable layout-level composables while preserving their inferred\n * names, props, and bound resource union.\n */\nexport type LayoutComposablesDefinition<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Composables extends ComposableComponents,\n> = RenderStateComposablesDefinition<Resources, Composables>;\n\ntype BuilderRenderComposables<Composables extends ComposableComponents> = [\n  keyof Composables,\n] extends [never]\n  ? undefined\n  : Composables;\n\n/** Values available as the second argument of a created state's `render`. */\nexport type RenderStateContext<\n  Composables extends ComposableComponents,\n  Resources extends ReadonlyArray<ResourceDefinition> = ReadonlyArray<ResourceDefinition>,\n> = {\n  resources: LayoutRenderResourcesAccessor<Resources>;\n  composables: BuilderRenderComposables<Composables>;\n  retry?: () => void;\n};\n\n/**\n * Resolves one state's custom props and explicitly included option/composable\n * props to the values received by its render callback.\n */\nexport type RenderStateProps<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  IncludeProps extends IncludedProps<\n    MergedLayoutInProps<Resources, Options, Composables>\n  >,\n  CustomProps extends InPropsObject,\n> = LayoutRenderProps<\n  Resources,\n  Options,\n  Composables,\n  IncludeProps,\n  CustomProps\n>;\n\ntype TypedRenderStateDefinition<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  State extends string,\n  CustomProps extends InPropsObject,\n  SharedComposables extends ComposableComponents,\n  StateComposables extends ComposableComponents,\n  IncludeProps extends IncludedProps<\n    MergedLayoutInProps<\n      Resources,\n      Options,\n      SharedComposables & StateComposables\n    >\n  >,\n> = {\n  composables?: RenderStateComposablesDefinition<Resources, StateComposables>;\n  props?: {\n    include?: IncludeProps;\n    custom?: CustomProps;\n  };\n  render: (\n    props: RenderStateProps<\n      Resources,\n      Options,\n      SharedComposables & StateComposables,\n      IncludeProps,\n      CustomProps\n    >,\n    context: RenderStateContext<SharedComposables & StateComposables, Resources>,\n  ) => JSX.Element;\n  state: State;\n};\n\n/**\n * Callback shorthand for a created state, typed with the bound resources,\n * options, and shared composables.\n */\nexport type TypedRenderStateCallback<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  SharedComposables extends ComposableComponents,\n> = (\n  props: RenderStateProps<Resources, Options, SharedComposables, {}, {}>,\n  context: RenderStateContext<SharedComposables, Resources>,\n) => JSX.Element;\n\ntype NormalizeRenderStateDefinition<Input> =\n  Input extends LazyRenderState<infer Definition>\n    ? Definition\n    : Input extends DeferredRenderState<infer Definition>\n    ? Definition\n    : Input extends RenderStateCallback\n      ? { render: Input; state: 'default' }\n      : Input extends AnyRenderStateDefinition\n        ? Input\n        : never;\n\ntype StateName<Definition> = Definition extends DeferredRenderState<\n  infer DeferredDefinition\n>\n  ? StateName<DeferredDefinition>\n  : Definition extends { state?: infer State extends string }\n    ? State\n    : 'default';\n\n/**\n * A spreadable state entry keyed by its literal state name. Spreading this into\n * `layout.render` is what creates compound members such as `Users.Loading`.\n */\nexport type RenderStateFragment<Definition, CallProps extends object = ResolveProps<StateCustomProps<Definition>>> = {\n  [State in StateName<NormalizeRenderStateDefinition<Definition>>]: Definition;\n} & {\n  readonly [definedRenderStateSymbol]: NormalizeRenderStateDefinition<Definition>;\n} & StateComposableHandle<CallProps>;\n\ntype StateCustomProps<Input> = NormalizeStateInput<Input> extends {\n  props?: { custom?: infer Props extends InPropsObject };\n} ? Props : {};\n\ntype StateIncludes<Input> = NormalizeStateInput<Input> extends {\n  props?: { include?: infer Includes };\n} ? Includes : {};\n\ntype NormalizeStateInput<Input> = Input extends DeferredRenderState<infer Definition>\n  ? Definition\n  : Input extends LazyRenderState<infer Definition> ? Definition : Input;\n\ntype StateLocalComposables<Input> = NormalizeStateInput<Input> extends {\n  composables?: (...args: any[]) => infer Components extends ComposableComponents;\n} ? Components : {};\n\n/**\n * A composables callback cannot infer its own return value into its arguments.\n * Preserve the declared call-site contract for props supplied by local presets,\n * even when their value types are not yet available in the callback context.\n */\ntype UnresolvedStateComponentProps<Props, Includes> = {\n  [Key in Exclude<keyof Includes, keyof Props> as Includes[Key] extends {\n    visibility: 'required'; passthrough: 'component';\n  } ? Key : never]: unknown;\n} & {\n  [Key in Exclude<keyof Includes, keyof Props> as Includes[Key] extends\n    | 'optional'\n    | { visibility: 'optional'; passthrough: 'component' }\n    ? Key : never]?: unknown;\n};\n\ntype StateComponentProps<Props extends InPropsObject, Includes> =\n  ResolvedIncludedComponentProps<Props,\n    Pick<Includes, Extract<keyof Includes, keyof Props>> extends infer Known extends IncludedProps<Props>\n      ? Known : {}\n  > & UnresolvedStateComponentProps<Props, Includes>;\n\n/** Call-site props of a referenced state; creation-time options stay bound. */\nexport type RenderStateCallProps<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  Input,\n> = ResolveProps<StateCustomProps<Input>> & StateComponentProps<\n  MergedLayoutInProps<Resources, Options, Composables & StateLocalComposables<Input>>,\n  StateIncludes<Input>\n>;\n\n/** Typed references to all the states declared in an inline render map. */\nexport type RenderStateReferences<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  States,\n> = {\n  readonly [State in keyof States & string]: StateComposable<\n    RenderStateCallProps<Resources, Options, Composables, States[State]>\n  >;\n};\n\ntype BoundRenderStateFragment<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  Definition,\n> = RenderStateFragment<Definition, RenderStateCallProps<\n  Resources, Options, Composables, Definition\n>>;\n\ntype DefinedRenderStateFromModule<Module> = Extract<\n  Module[keyof Module],\n  { readonly [definedRenderStateSymbol]: AnyRenderStateDefinition }\n>[typeof definedRenderStateSymbol];\n\n/** Wraps a state definition in the deferred marker when `Deferred` is `true`. */\ntype RenderStateEntry<Definition, Deferred extends boolean> = Deferred extends true\n  ? DeferredRenderState<NormalizeRenderStateDefinition<Definition>>\n  : Definition;\n\n/**\n * Overloads shared by `createRenderState` and `createRenderState.defer`. Each\n * accepts a full definition, a definition without `state`, or a render\n * callback; `Deferred` decides whether the returned entry is deferred.\n */\nexport interface RenderStateOverloads<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  SharedComposables extends ComposableComponents,\n  Deferred extends boolean,\n> {\n  <\n    const State extends RenderStateName,\n    const CustomProps extends InPropsObject = {},\n    const StateComposables extends ComposableComponents = {},\n    const IncludeProps extends IncludedProps<\n      MergedLayoutInProps<\n        Resources,\n        Options,\n        SharedComposables & StateComposables\n      >\n    > = {},\n  >(\n    definition: TypedRenderStateDefinition<\n      Resources,\n      Options,\n      State,\n      CustomProps,\n      SharedComposables,\n      StateComposables,\n      IncludeProps\n    >,\n  ): BoundRenderStateFragment<Resources, Options, SharedComposables,\n    RenderStateEntry<\n      TypedRenderStateDefinition<\n        Resources,\n        Options,\n        State,\n        CustomProps,\n        SharedComposables,\n        StateComposables,\n        IncludeProps\n      >,\n      Deferred\n    >\n  >;\n  <\n    const CustomProps extends InPropsObject = {},\n    const StateComposables extends ComposableComponents = {},\n    const IncludeProps extends IncludedProps<\n      MergedLayoutInProps<\n        Resources,\n        Options,\n        SharedComposables & StateComposables\n      >\n    > = {},\n  >(\n    definition: Omit<\n      TypedRenderStateDefinition<\n        Resources,\n        Options,\n        'default',\n        CustomProps,\n        SharedComposables,\n        StateComposables,\n        IncludeProps\n      >,\n      'state'\n    >,\n  ): BoundRenderStateFragment<Resources, Options, SharedComposables,\n    RenderStateEntry<\n      TypedRenderStateDefinition<\n        Resources,\n        Options,\n        'default',\n        CustomProps,\n        SharedComposables,\n        StateComposables,\n        IncludeProps\n      >,\n      Deferred\n    >\n  >;\n  (\n    render: TypedRenderStateCallback<Resources, Options, SharedComposables>,\n  ): BoundRenderStateFragment<Resources, Options, SharedComposables,\n    RenderStateEntry<\n      TypedRenderStateCallback<Resources, Options, SharedComposables>,\n      Deferred\n    >\n  >;\n}\n\ntype RenderStateReference = (\n  | { readonly [definedRenderStateSymbol]: AnyRenderStateDefinition }\n  | LazyRenderState<AnyRenderStateDefinition>\n) & StateComposableHandle<any>;\n\ntype ReferenceDefinition<Ref extends RenderStateReference> =\n  Ref extends LazyRenderState<infer Definition> ? Definition\n    : Ref extends { readonly [definedRenderStateSymbol]: infer Definition extends AnyRenderStateDefinition }\n      ? Definition : never;\n\ntype FromStateEntry<Ref extends RenderStateReference, Definition extends AnyRenderStateDefinition> =\n  Ref extends LazyRenderState<AnyRenderStateDefinition> ? LazyRenderState<Definition>\n    : Extract<Ref[Exclude<keyof Ref, 'asComposable' | typeof definedRenderStateSymbol>], LazyRenderState<AnyRenderStateDefinition>> extends never\n      ? Definition : LazyRenderState<Definition>;\ntype ReferenceSchemas<Ref extends RenderStateReference> =\n  StateCustomProps<ReferenceDefinition<Ref>> & MergePresetProps<StateLocalComposables<ReferenceDefinition<Ref>>>;\n\ntype DefaultReferenceIncludes<Ref extends RenderStateReference, CustomProps> =\n  Omit<StateIncludes<ReferenceDefinition<Ref>>, keyof CustomProps | keyof StateCustomProps<ReferenceDefinition<Ref>>> & {\n    [Key in Exclude<keyof StateCustomProps<ReferenceDefinition<Ref>>, keyof CustomProps>]: {\n      visibility: StateCustomProps<ReferenceDefinition<Ref>>[Key] extends { visibility: infer Visibility }\n        ? Visibility : 'required';\n      passthrough: 'component';\n    };\n  };\n\ntype ReferenceIncludes<Ref extends RenderStateReference, CustomProps, Include> =\n  Include extends object ? Include : DefaultReferenceIncludes<Ref, CustomProps>;\n\ntype FromStateInProps<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Shared extends ComposableComponents,\n  Ref extends RenderStateReference,\n  Local extends ComposableComponents,\n> = (MergedLayoutInProps<Resources, Options, Shared & StateLocalComposables<ReferenceDefinition<Ref>> & Local> &\n  StateCustomProps<ReferenceDefinition<Ref>>) extends infer Props extends InPropsObject ? Props : {};\n\ntype SelectedReferenceSchemas<Ref extends RenderStateReference, Include> =\n  Pick<ReferenceSchemas<Ref>, Extract<keyof Include, keyof ReferenceSchemas<Ref>>> extends infer Selected extends InPropsObject\n    ? Selected : {};\n\ntype ReferenceCarriedProps<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Shared extends ComposableComponents,\n  Ref extends RenderStateReference,\n  Include,\n> = Pick<FromStateInProps<Resources, Options, Shared, Ref, {}>,\n  Extract<keyof Include, keyof FromStateInProps<Resources, Options, Shared, Ref, {}>>\n> extends infer Selected extends InPropsObject ? ResolveProps<Selected> : {};\n\ntype ReferenceRenderProps<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Shared extends ComposableComponents,\n  Ref extends RenderStateReference,\n> = RenderStateProps<Resources, Options, Shared & StateLocalComposables<ReferenceDefinition<Ref>>,\n  StateIncludes<ReferenceDefinition<Ref>> extends infer Include extends IncludedProps<MergedLayoutInProps<Resources, Options, Shared & StateLocalComposables<ReferenceDefinition<Ref>>>> ? Include : {},\n  StateCustomProps<ReferenceDefinition<Ref>>>;\n\ntype FromStateComposables<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Shared extends ComposableComponents,\n  Ref extends RenderStateReference,\n  Local extends ComposableComponents,\n  Include,\n> = Local & {\n  Ref: StateComposable<\n    ReferenceRenderProps<Resources, Options, Shared, Ref>,\n    Extract<keyof ReferenceCarriedProps<Resources, Options, Shared, Ref, Include>, keyof ReferenceRenderProps<Resources, Options, Shared, Ref>>\n  > & { [composablePresetMetaKey]: ComposablePresetMeta<SelectedReferenceSchemas<Ref, Include>> };\n};\n\ntype FromStateDefinition<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Shared extends ComposableComponents,\n  Ref extends RenderStateReference,\n  State extends string,\n  CustomProps extends InPropsObject,\n  Local extends ComposableComponents,\n  Include,\n> = {\n  state: State;\n  props?: { custom?: CustomProps; include?: ReferenceIncludes<Ref, CustomProps, Include> };\n  composables: RenderStateComposablesDefinition<Resources,\n    FromStateComposables<Resources, Options, Shared, Ref, Local, ReferenceIncludes<Ref, CustomProps, Include>>>;\n  render: (\n    props: ResolveProps<CustomProps> & ResolvedIncludedProps<FromStateInProps<Resources, Options, Shared, Ref, Local>,\n      ReferenceIncludes<Ref, CustomProps, Include> extends infer Selected extends IncludedProps<FromStateInProps<Resources, Options, Shared, Ref, Local>> ? Selected : {}>,\n    context: RenderStateContext<Shared & FromStateComposables<Resources, Options, Shared, Ref, Local, ReferenceIncludes<Ref, CustomProps, Include>>, Resources>,\n  ) => JSX.Element;\n};\n\n/** Creates a state with inherited props and a composable reference to its source. */\nexport type CreateRenderStateFromState<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Shared extends ComposableComponents,\n> = <\n  const Ref extends RenderStateReference,\n  const State extends RenderStateName = 'default',\n  const CustomProps extends InPropsObject = {},\n  const Local extends ComposableComponents = {},\n  const Include extends IncludedProps<FromStateInProps<Resources, Options, Shared, Ref, Local>> | undefined = undefined,\n>(definition: {\n  ref: Ref;\n  /** Defer Ref rendering through React.lazy. Defaults to false. */\n  lazy?: boolean;\n  state?: State;\n  props?: {\n    custom?: CustomProps;\n    include?: Include & Record<Exclude<keyof Include, keyof FromStateInProps<Resources, Options, Shared, Ref, Local>>, never>;\n  };\n  composables?: (create: CreateLayoutComposable<LayoutResourceKey<Resources>>, states: {}) => Local & { Ref?: never };\n  render: FromStateDefinition<Resources, Options, Shared, Ref, State, CustomProps, Local, Include>['render'];\n}) => BoundRenderStateFragment<Resources, Options, Shared,\n  FromStateEntry<Ref, FromStateDefinition<Resources, Options, Shared, Ref, State, CustomProps, Local, Include>>>;\n\n/**\n * Creates independently typed render-state fragments.\n *\n * - Calling it directly creates an eager state.\n * - `.defer(...)` schedules an inline definition through `React.lazy`, but\n *   does not create a separate JavaScript chunk.\n * - `.lazy(() => import(...))` imports a complete named state definition as a\n *   separate chunk.\n * - `.fromState({ ref, ... })` inherits a state's props and exposes it as `Ref`.\n */\nexport interface CreateRenderState<\n  Resources extends ReadonlyArray<ResourceDefinition> = ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources> = {},\n  SharedComposables extends ComposableComponents = {},\n> extends RenderStateOverloads<Resources, Options, SharedComposables, false> {\n  fromState: CreateRenderStateFromState<Resources, Options, SharedComposables>;\n  defer: RenderStateOverloads<Resources, Options, SharedComposables, true>;\n  lazy<Module extends Record<string, unknown>>(\n    load: () => Promise<Module>,\n  ): LazyRenderState<DefinedRenderStateFromModule<Module>> & StateComposableHandle<\n    RenderStateCallProps<Resources, Options, SharedComposables, DefinedRenderStateFromModule<Module>>\n  >;\n}\n\nfunction normalizeDefinition(\n  input: AnyRenderStateDefinition | RenderStateCallback,\n): AnyRenderStateDefinition {\n  return typeof input === 'function'\n    ? { render: input, state: 'default' }\n    : input;\n}\n\nfunction toFragment<Definition extends AnyRenderStateDefinition>(\n  definition: Definition,\n) {\n  const fragment = {\n    [definition.state ?? 'default']: definition,\n  } as RenderStateFragment<Definition>;\n\n  Object.defineProperty(fragment, definedRenderStateSymbol, {\n    enumerable: false,\n    value: definition,\n  });\n\n  return withStateComposable(fragment, { input: definition, name: definition.state ?? 'default' });\n}\n\n/** Inputs used internally to bind resource and option types to a state builder. */\nexport type CreateRenderStateBuilderArguments<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  SharedComposables extends ComposableComponents = {},\n> = {\n  /** Shared composables whose components and preset props every state can use. */\n  composables?: LayoutComposablesDefinition<Resources, SharedComposables>;\n  /** Option props that individual states can expose through `props.include`. */\n  options: Options;\n  /** Resources used to constrain composable names and resource-specific props. */\n  resources: Resources;\n};\n\n/** The state factory produced for a particular resource and option definition. */\nexport type CreateRenderStateBuilderResult<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  SharedComposables extends ComposableComponents = {},\n> = CreateRenderState<Resources, Options, SharedComposables>;\n\n/**\n * Creates a state factory whose `props.include` keys are constrained by the\n * supplied resources and options.\n */\nexport function createRenderStateBuilder<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  SharedComposables extends ComposableComponents = {},\n>(\n  _arguments: CreateRenderStateBuilderArguments<\n    Resources,\n    Options,\n    SharedComposables\n  >,\n): CreateRenderStateBuilderResult<Resources, Options, SharedComposables> {\n  function createRenderState(\n    input: AnyRenderStateDefinition | RenderStateCallback,\n  ) {\n    return toFragment(normalizeDefinition(input));\n  }\n\n  createRenderState.fromState = (input: {\n    ref: RenderStateReference;\n    lazy?: boolean;\n    state?: string;\n    props?: AnyRenderStateDefinition['props'];\n    composables?: AnyRenderStateDefinition['composables'];\n    render: AnyRenderStateDefinition['render'];\n  }): object => {\n    const entry = isLazyRenderState(input.ref) ? input.ref : Object.values(input.ref)[0];\n    if (isLazyRenderState(entry)) {\n      const lazyState = {\n        [lazyRenderStateSymbol]: async () => {\n          const source = await findDefinedRenderState(await entry[lazyRenderStateSymbol]());\n          return { Derived: createRenderState.fromState({ ...input, ref: toFragment(source) }) };\n        },\n      };\n      const name = input.state ?? 'default';\n      const fragment = { [name]: lazyState };\n      Object.defineProperty(fragment, definedRenderStateSymbol, { value: lazyState });\n      return withStateComposable(fragment, { input: lazyState, name });\n    }\n    const source = isDeferredRenderState(entry)\n      ? entry[deferredRenderStateSymbol]\n      : definedRenderStateSymbol in input.ref ? input.ref[definedRenderStateSymbol] : undefined;\n    if (!source || typeof source.render !== 'function') {\n      throw new LayoutConfigurationError('fromState requires a created render state');\n    }\n    const custom = input.props?.custom ?? {};\n    const includes = input.props?.include ?? Object.fromEntries(\n      Object.entries({\n        ...source.props?.include,\n        ...Object.fromEntries(Object.entries(source.props?.custom ?? {}).map(([key, prop]) => [\n          key, { visibility: prop.visibility, passthrough: 'component' },\n        ])),\n      }).filter(([key]) => !(key in custom)),\n    );\n    return toFragment({\n      state: input.state ?? 'default',\n      props: { custom, include: includes },\n      composables: (create, states) => {\n        const inherited = source.composables?.(create, states) ?? {};\n        const local = input.composables?.(create, states) ?? {};\n        if (Object.prototype.hasOwnProperty.call(local, 'Ref')) {\n          throw new LayoutConfigurationError('Composable name \"Ref\" is reserved by fromState');\n        }\n        const schemas = Object.assign({},\n          ...collectComposablePresetEntries(inherited).map(({ props }) => props),\n          source.props?.custom,\n        ) as InPropsObject;\n        const selected = Object.fromEntries(Object.entries(schemas).filter(([key]) => key in includes));\n        const referenceSource = {\n          ...source,\n          props: {\n            ...source.props,\n            include: Object.fromEntries(Object.entries(source.props?.include ?? {}).map(([key, behavior]) => [\n              key, {\n                visibility: behavior === 'optional' || (typeof behavior === 'object' && behavior !== null && 'visibility' in behavior && behavior.visibility === 'optional')\n                  ? 'optional' : 'required',\n                passthrough: 'component',\n              },\n            ])),\n          },\n        };\n        const Ref = createStateComposable({\n          input: input.lazy || isDeferredRenderState(entry) ? { [deferredRenderStateSymbol]: referenceSource } : referenceSource,\n          name: source.state ?? 'default',\n          fallbackStateName: input.state,\n        }, {\n          props: { include: Object.fromEntries(Object.keys(includes).map((key) => [key, true as const])) },\n          normalizeIncludedKeys: true,\n        });\n        Object.defineProperty(Ref, composablePresetMetaKey, {\n          value: { key: 'Ref', props: selected },\n        });\n        return { ...local, Ref };\n      },\n      render: input.render,\n    });\n  };\n\n  createRenderState.defer = (\n    input: AnyRenderStateDefinition | RenderStateCallback,\n  ) => {\n    const definition = normalizeDefinition(input);\n\n    const deferred = { [deferredRenderStateSymbol]: definition };\n    const fragment = { [definition.state ?? 'default']: deferred };\n    Object.defineProperty(fragment, definedRenderStateSymbol, { value: definition });\n    return withStateComposable(fragment, {\n      input: deferred, name: definition.state ?? 'default',\n    });\n  };\n  createRenderState.lazy = (\n    load: () => Promise<Record<string, unknown>>,\n  ) => {\n    const lazyState = { [lazyRenderStateSymbol]: load };\n    return withStateComposable(lazyState, { input: lazyState, name: 'lazy' });\n  };\n\n  return createRenderState as unknown as CreateRenderStateBuilderResult<\n    Resources,\n    Options,\n    SharedComposables\n  >;\n}\n\n/** Type guard for states created with `createRenderState.defer(...)`. */\nexport function isDeferredRenderState(\n  value: unknown,\n): value is DeferredRenderState<AnyRenderStateDefinition> {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    deferredRenderStateSymbol in value\n  );\n}\n\n/** Type guard for states created with `createRenderState.lazy(...)`. */\nexport function isLazyRenderState(\n  value: unknown,\n): value is LazyRenderState<AnyRenderStateDefinition> {\n  return (\n    typeof value === 'object' && value !== null && lazyRenderStateSymbol in value\n  );\n}\n\n/**\n * Resolves the single state exported by a lazy module, including derived lazy\n * states. Throws when a module exports none or more than one.\n */\nexport async function findDefinedRenderState(\n  module: Record<string, unknown>,\n): Promise<AnyRenderStateDefinition> {\n  const definitions = Object.values(module).filter(\n    (value) =>\n      typeof value === 'object' && value !== null && definedRenderStateSymbol in value,\n  ) as Array<Record<typeof definedRenderStateSymbol, AnyRenderStateDefinition>>;\n\n  if (definitions.length !== 1) {\n    throw new Error(\n      `A lazy render-state module must export exactly one defined render state; received ${definitions.length}.`,\n    );\n  }\n\n  const definition = definitions[0][definedRenderStateSymbol];\n  return isLazyRenderState(definition)\n    ? findDefinedRenderState(await definition[lazyRenderStateSymbol]())\n    : definition;\n}\n\n/** Identity helper that contextually types a reusable composables callback. */\nexport type DefineLayoutComposables<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = <const Composables extends ComposableComponents>(\n  definition: LayoutComposablesDefinition<Resources, Composables>,\n) => LayoutComposablesDefinition<Resources, Composables>;\n\n/** Public cross-file building blocks returned by a defined layout builder. */\nexport type CreateLayoutBuildingBlocks<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n> = {\n  composables: DefineLayoutComposables<Resources>;\n  createRenderState: CreateRenderState<Resources, Options>;\n};\n\n/** Resource and option bindings used to create layout building blocks. */\nexport type CreateLayoutBuildingBlocksArguments<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n> = CreateRenderStateBuilderArguments<Resources, Options>;\n\n/** Layout helpers produced for the supplied resource and option bindings. */\nexport type CreateLayoutBuildingBlocksResult<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n> = CreateLayoutBuildingBlocks<Resources, Options>;\n\n/**\n * Creates the reusable `composables` and `createRenderState` helpers without\n * introducing an identity wrapper around the layout object itself.\n */\nexport function createLayoutBuildingBlocks<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n>(\n  arguments_: CreateLayoutBuildingBlocksArguments<Resources, Options>,\n): CreateLayoutBuildingBlocksResult<Resources, Options> {\n  function composables<const Composables extends ComposableComponents>(\n    definition: LayoutComposablesDefinition<Resources, Composables>,\n  ): LayoutComposablesDefinition<Resources, Composables> {\n    return definition;\n  }\n\n  return {\n    composables,\n    createRenderState: createRenderStateBuilder(arguments_),\n  };\n}\n\n/** Preserves a bound resource tuple for consumers that need to re-export it. */\nexport type BoundResources<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = Resources;\n"],"mappings":"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"}