@jfdevelops/react-layout 1.6.1 → 2.0.0

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

@@ -1 +1 @@
-{"version":3,"file":"render-state.mjs","names":[],"sources":["../../src/create-config/render-state.ts"],"sourcesContent":["import {\n  getLayoutDebug,\n  layoutDebug,\n} from '@jfdevelops/react-layout-devtools-core';\nimport type { MergeContract } from './define-layout';\nimport type { JSX } from 'react';\nimport {\n  collectComposablePresetEntries,\n  composablePresetMetaKey,\n  type MergePresetProps,\n  type ComposablePresetMeta,\n} from '@jfdevelops/react-layout-composables';\nimport { LayoutConfigurationError } from '../errors';\nimport {\n  createStateComposable,\n  withStateComposable,\n  type StateComposable,\n  type StateComposableHandle,\n} from './state-composable';\nimport type { ResolveProps } from '@jfdevelops/react-layout-validator';\nimport type {\n  ComposableComponents,\n  CreateLayoutComposable,\n} from '@jfdevelops/react-layout-composables';\nimport {\n  getIncludedPropBehavior,\n  type InPropsObject,\n  type NormalizedIncludedPropBehavior,\n} 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);\n\nexport const lazyRenderStateSymbol: unique symbol = Symbol(\n  'lazyRenderState'\n);\n\nexport const definedRenderStateSymbol: unique symbol = Symbol.for(\n  '@jfdevelops/react-layout/render-state'\n);\n\nexport const definedResourceLayoutComponentSymbol: unique symbol = Symbol.for(\n  '@jfdevelops/react-layout/resource-layout-component'\n);\n\n/** Runtime-compatible render-state shape used when inspecting lazy modules. */\nexport type AnyRenderStateDefinition = {\n  composables?: (\n    create: CreateLayoutComposable<any>,\n    states: any\n  ) => 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  SharedInclude extends IncludedProps<\n    MergedLayoutInProps<Resources, Options, SharedComposables>\n  > = {},\n  SharedCustom extends InPropsObject = {}\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      MergeContract<SharedInclude, IncludeProps>,\n      MergeContract<SharedCustom, 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  SharedInclude extends IncludedProps<\n    MergedLayoutInProps<Resources, Options, SharedComposables>\n  > = {},\n  SharedCustom extends InPropsObject = {}\n> = (\n  props: RenderStateProps<\n    Resources,\n    Options,\n    SharedComposables,\n    SharedInclude,\n    SharedCustom\n  >,\n  context: RenderStateContext<SharedComposables, Resources>\n) => JSX.Element;\n\ntype NormalizeRenderStateDefinition<Input> = Input extends LazyRenderState<\n  infer Definition\n>\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<\n  Definition,\n  CallProps extends object = ResolveProps<StateCustomProps<Definition>>\n> = {\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}\n  ? Props\n  : {};\n\ntype StateIncludes<Input> = NormalizeStateInput<Input> extends {\n  props?: { include?: infer Includes };\n}\n  ? Includes\n  : {};\n\ntype NormalizeStateInput<Input> = Input extends DeferredRenderState<\n  infer Definition\n>\n  ? Definition\n  : Input extends LazyRenderState<infer Definition>\n  ? Definition\n  : Input;\n\ntype StateLocalComposables<Input> = NormalizeStateInput<Input> extends {\n  composables?: (\n    ...args: any[]\n  ) => infer Components extends ComposableComponents;\n}\n  ? Components\n  : {};\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 NormalizedIncludedPropBehavior<Includes[Key]> extends {\n    visibility: 'required';\n    passthrough: 'component';\n  }\n    ? Key\n    : never]: unknown;\n} & {\n  [Key in Exclude<keyof Includes, keyof Props> as NormalizedIncludedPropBehavior<Includes[Key]> extends\n    | 'optional'\n    | { visibility: 'optional'; passthrough: 'component' }\n    ? Key\n    : never]?: unknown;\n};\n\ntype StateComponentProps<\n  Props extends InPropsObject,\n  Includes\n> = ResolvedIncludedComponentProps<\n  Props,\n  Pick<\n    Includes,\n    Extract<keyof Includes, keyof Props>\n  > extends infer Known extends IncludedProps<Props>\n    ? Known\n    : {}\n> &\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>> &\n  StateComponentProps<\n    MergedLayoutInProps<\n      Resources,\n      Options,\n      Composables & StateLocalComposables<Input>\n    >,\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<\n  Definition,\n  RenderStateCallProps<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<\n  Definition,\n  Deferred extends boolean\n> = 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  SharedInclude extends IncludedProps<\n    MergedLayoutInProps<Resources, Options, SharedComposables>\n  > = {},\n  SharedCustom extends InPropsObject = {}\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      SharedInclude,\n      SharedCustom\n    >\n  ): BoundRenderStateFragment<\n    Resources,\n    Options,\n    SharedComposables,\n    RenderStateEntry<\n      TypedRenderStateDefinition<\n        Resources,\n        Options,\n        State,\n        CustomProps,\n        SharedComposables,\n        StateComposables,\n        IncludeProps,\n        SharedInclude,\n        SharedCustom\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        SharedInclude,\n        SharedCustom\n      >,\n      'state'\n    >\n  ): BoundRenderStateFragment<\n    Resources,\n    Options,\n    SharedComposables,\n    RenderStateEntry<\n      TypedRenderStateDefinition<\n        Resources,\n        Options,\n        'default',\n        CustomProps,\n        SharedComposables,\n        StateComposables,\n        IncludeProps,\n        SharedInclude,\n        SharedCustom\n      >,\n      Deferred\n    >\n  >;\n  (\n    render: TypedRenderStateCallback<\n      Resources,\n      Options,\n      SharedComposables,\n      SharedInclude,\n      SharedCustom\n    >\n  ): BoundRenderStateFragment<\n    Resources,\n    Options,\n    SharedComposables,\n    RenderStateEntry<\n      TypedRenderStateCallback<\n        Resources,\n        Options,\n        SharedComposables,\n        SharedInclude,\n        SharedCustom\n      >,\n      Deferred\n    >\n  >;\n}\n\ntype RenderStateReference = (\n  | { readonly [definedRenderStateSymbol]: AnyRenderStateDefinition }\n  | LazyRenderState<AnyRenderStateDefinition>\n) &\n  StateComposableHandle<any>;\n\ntype ReferenceDefinition<Ref extends RenderStateReference> =\n  Ref extends LazyRenderState<infer Definition>\n    ? Definition\n    : Ref extends {\n        readonly [definedRenderStateSymbol]: infer Definition extends AnyRenderStateDefinition;\n      }\n    ? Definition\n    : never;\n\ntype FromStateEntry<\n  Ref extends RenderStateReference,\n  Definition extends AnyRenderStateDefinition\n> = Ref extends LazyRenderState<AnyRenderStateDefinition>\n  ? LazyRenderState<Definition>\n  : Extract<\n      Ref[Exclude<keyof Ref, 'asComposable' | typeof definedRenderStateSymbol>],\n      LazyRenderState<AnyRenderStateDefinition>\n    > extends never\n  ? Definition\n  : LazyRenderState<Definition>;\n\ntype ReferenceSchemas<Ref extends RenderStateReference> = StateCustomProps<\n  ReferenceDefinition<Ref>\n> &\n  MergePresetProps<StateLocalComposables<ReferenceDefinition<Ref>>>;\n\ntype DefaultReferenceIncludes<\n  Ref extends RenderStateReference,\n  CustomProps\n> = Omit<\n  StateIncludes<ReferenceDefinition<Ref>>,\n  keyof CustomProps | keyof StateCustomProps<ReferenceDefinition<Ref>>\n> & {\n  [Key in Exclude<\n    keyof StateCustomProps<ReferenceDefinition<Ref>>,\n    keyof CustomProps\n  >]: {\n    visibility: StateCustomProps<ReferenceDefinition<Ref>>[Key] extends {\n      visibility: infer Visibility;\n    }\n      ? Visibility\n      : 'required';\n    passthrough: 'component';\n  };\n};\n\ntype ReferenceIncludes<\n  Ref extends RenderStateReference,\n  CustomProps,\n  Include\n> = Include extends object\n  ? Include\n  : 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<\n  Resources,\n  Options,\n  Shared & StateLocalComposables<ReferenceDefinition<Ref>> & Local\n> &\n  StateCustomProps<\n    ReferenceDefinition<Ref>\n  > extends infer Props extends InPropsObject\n  ? Props\n  : {};\n\ntype SelectedReferenceSchemas<Ref extends RenderStateReference, Include> = Pick<\n  ReferenceSchemas<Ref>,\n  Extract<keyof Include, keyof ReferenceSchemas<Ref>>\n> extends infer Selected extends InPropsObject\n  ? Selected\n  : {};\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<\n  FromStateInProps<Resources, Options, Shared, Ref, {}>,\n  Extract<\n    keyof Include,\n    keyof FromStateInProps<Resources, Options, Shared, Ref, {}>\n  >\n> extends infer Selected extends InPropsObject\n  ? ResolveProps<Selected>\n  : {};\n\ntype ReferenceRenderProps<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Shared extends ComposableComponents,\n  Ref extends RenderStateReference\n> = RenderStateProps<\n  Resources,\n  Options,\n  Shared & StateLocalComposables<ReferenceDefinition<Ref>>,\n  StateIncludes<\n    ReferenceDefinition<Ref>\n  > extends infer Include extends IncludedProps<\n    MergedLayoutInProps<\n      Resources,\n      Options,\n      Shared & StateLocalComposables<ReferenceDefinition<Ref>>\n    >\n  >\n    ? Include\n    : {},\n  StateCustomProps<ReferenceDefinition<Ref>>\n>;\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<\n      keyof ReferenceCarriedProps<Resources, Options, Shared, Ref, Include>,\n      keyof ReferenceRenderProps<Resources, Options, Shared, Ref>\n    >\n  > & {\n    [composablePresetMetaKey]: ComposablePresetMeta<\n      SelectedReferenceSchemas<Ref, Include>\n    >;\n  };\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?: {\n    custom?: CustomProps;\n    include?: ReferenceIncludes<Ref, CustomProps, Include>;\n  };\n  composables: RenderStateComposablesDefinition<\n    Resources,\n    FromStateComposables<\n      Resources,\n      Options,\n      Shared,\n      Ref,\n      Local,\n      ReferenceIncludes<Ref, CustomProps, Include>\n    >\n  >;\n  render: (\n    props: ResolveProps<CustomProps> &\n      ResolvedIncludedProps<\n        FromStateInProps<Resources, Options, Shared, Ref, Local>,\n        ReferenceIncludes<\n          Ref,\n          CustomProps,\n          Include\n        > extends infer Selected extends IncludedProps<\n          FromStateInProps<Resources, Options, Shared, Ref, Local>\n        >\n          ? Selected\n          : {}\n      >,\n    context: RenderStateContext<\n      Shared &\n        FromStateComposables<\n          Resources,\n          Options,\n          Shared,\n          Ref,\n          Local,\n          ReferenceIncludes<Ref, CustomProps, Include>\n        >,\n      Resources\n    >\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\n    | IncludedProps<FromStateInProps<Resources, Options, Shared, Ref, Local>>\n    | 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 &\n      Record<\n        Exclude<\n          keyof Include,\n          keyof FromStateInProps<Resources, Options, Shared, Ref, Local>\n        >,\n        never\n      >;\n  };\n  composables?: (\n    create: CreateLayoutComposable<LayoutResourceKey<Resources>>,\n    states: {}\n  ) => Local & { Ref?: never };\n  render: FromStateDefinition<\n    Resources,\n    Options,\n    Shared,\n    Ref,\n    State,\n    CustomProps,\n    Local,\n    Include\n  >['render'];\n}) => BoundRenderStateFragment<\n  Resources,\n  Options,\n  Shared,\n  FromStateEntry<\n    Ref,\n    FromStateDefinition<\n      Resources,\n      Options,\n      Shared,\n      Ref,\n      State,\n      CustomProps,\n      Local,\n      Include\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 * - `.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  SharedInclude extends IncludedProps<\n    MergedLayoutInProps<Resources, Options, SharedComposables>\n  > = {},\n  SharedCustom extends InPropsObject = {}\n> extends RenderStateOverloads<\n    Resources,\n    Options,\n    SharedComposables,\n    false,\n    SharedInclude,\n    SharedCustom\n  > {\n  fromState: CreateRenderStateFromState<Resources, Options, SharedComposables>;\n  defer: RenderStateOverloads<\n    Resources,\n    Options,\n    SharedComposables,\n    true,\n    SharedInclude,\n    SharedCustom\n  >;\n  lazy<Module extends Record<string, unknown>>(\n    load: () => Promise<Module>\n  ): LazyRenderState<DefinedRenderStateFromModule<Module>> &\n    StateComposableHandle<\n      RenderStateCallProps<\n        Resources,\n        Options,\n        SharedComposables,\n        DefinedRenderStateFromModule<Module>\n      >\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, {\n    input: definition,\n    name: definition.state ?? 'default',\n  });\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  SharedInclude extends IncludedProps<\n    MergedLayoutInProps<Resources, Options, SharedComposables>\n  > = {},\n  SharedCustom extends InPropsObject = {}\n> = {\n  props?: { include?: SharedInclude; custom?: SharedCustom };\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  SharedInclude extends IncludedProps<\n    MergedLayoutInProps<Resources, Options, SharedComposables>\n  > = {},\n  SharedCustom extends InPropsObject = {}\n> = CreateRenderState<\n  Resources,\n  Options,\n  SharedComposables,\n  SharedInclude,\n  SharedCustom\n>;\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  SharedInclude extends IncludedProps<\n    MergedLayoutInProps<Resources, Options, SharedComposables>\n  > = {},\n  SharedCustom extends InPropsObject = {}\n>(\n  _arguments: CreateRenderStateBuilderArguments<\n    Resources,\n    Options,\n    SharedComposables,\n    SharedInclude,\n    SharedCustom\n  >\n): CreateRenderStateBuilderResult<\n  Resources,\n  Options,\n  SharedComposables,\n  SharedInclude,\n  SharedCustom\n> {\n  function createRenderState(\n    input: AnyRenderStateDefinition | RenderStateCallback\n  ) {\n    const definition = normalizeDefinition(input);\n    const debug = getLayoutDebug(input);\n\n    return toFragment(\n      debug ? { ...definition, [layoutDebug]: debug } : definition\n    );\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)\n      ? input.ref\n      : Object.values(input.ref)[0];\n\n    if (isLazyRenderState(entry)) {\n      const lazyState = {\n        [lazyRenderStateSymbol]: async () => {\n          const source = await findDefinedRenderState(\n            await entry[lazyRenderStateSymbol]()\n          );\n\n          return {\n            Derived: createRenderState.fromState({\n              ...input,\n              ref: toFragment(source),\n            }),\n          };\n        },\n      };\n      const name = input.state ?? 'default';\n      const fragment = { [name]: lazyState };\n\n      Object.defineProperty(fragment, definedRenderStateSymbol, {\n        value: lazyState,\n      });\n\n      return withStateComposable(fragment, { input: lazyState, name });\n    }\n\n    const source = isDeferredRenderState(entry)\n      ? entry[deferredRenderStateSymbol]\n      : definedRenderStateSymbol in input.ref\n      ? input.ref[definedRenderStateSymbol]\n      : undefined;\n\n    if (!source || typeof source.render !== 'function') {\n      throw new LayoutConfigurationError(\n        'fromState requires a created render state'\n      );\n    }\n\n    const custom = input.props?.custom ?? {};\n    const includes =\n      input.props?.include ??\n      Object.fromEntries(\n        Object.entries({\n          ...source.props?.include,\n          ...Object.fromEntries(\n            Object.entries(source.props?.custom ?? {}).map(([key, prop]) => [\n              key,\n              { visibility: prop.visibility, passthrough: 'component' },\n            ])\n          ),\n        }).filter(([key]) => !(key in custom))\n      );\n\n    return toFragment({\n      [layoutDebug]: getLayoutDebug(input),\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\n        if (Object.prototype.hasOwnProperty.call(local, 'Ref')) {\n          throw new LayoutConfigurationError(\n            'Composable name \"Ref\" is reserved by fromState'\n          );\n        }\n\n        const schemas = Object.assign(\n          {},\n          ...collectComposablePresetEntries(inherited).map(\n            ({ props }) => props\n          ),\n          source.props?.custom\n        ) as InPropsObject;\n        const selected = Object.fromEntries(\n          Object.entries(schemas).filter(([key]) => key in includes)\n        );\n        const referenceSource = {\n          ...source,\n          props: {\n            ...source.props,\n            include: Object.fromEntries(\n              Object.entries(source.props?.include ?? {}).map(\n                ([key, behavior]) => [\n                  key,\n                  {\n                    visibility:\n                      behavior === 'optional' ||\n                      getIncludedPropBehavior(behavior)?.visibility === 'optional'\n                        ? 'optional'\n                        : 'required',\n                    passthrough: 'component',\n                  },\n                ]\n              )\n            ),\n          },\n        };\n        const Ref = createStateComposable(\n          {\n            input:\n              input.lazy || isDeferredRenderState(entry)\n                ? { [deferredRenderStateSymbol]: referenceSource }\n                : referenceSource,\n            name: source.state ?? 'default',\n            fallbackStateName: input.state,\n          },\n          {\n            props: {\n              include: Object.fromEntries(\n                Object.keys(includes).map((key) => [key, true as const])\n              ),\n            },\n            normalizeIncludedKeys: true,\n          }\n        );\n\n        Object.defineProperty(Ref, composablePresetMetaKey, {\n          value: { key: 'Ref', props: selected },\n        });\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 = {\n      [deferredRenderStateSymbol]: {\n        ...definition,\n        [layoutDebug]: getLayoutDebug(input),\n      },\n      [layoutDebug]: getLayoutDebug(input),\n    };\n    const fragment = { [definition.state ?? 'default']: deferred };\n\n    Object.defineProperty(fragment, definedRenderStateSymbol, {\n      value: definition,\n    });\n\n    return withStateComposable(fragment, {\n      input: deferred,\n      name: definition.state ?? 'default',\n    });\n  };\n\n  createRenderState.lazy = (load: () => Promise<Record<string, unknown>>) => {\n    const lazyState = {\n      [lazyRenderStateSymbol]: load,\n      [layoutDebug]: getLayoutDebug(load),\n    };\n\n    return withStateComposable(lazyState, { input: lazyState, name: 'lazy' });\n  };\n\n  return createRenderState as unknown as CreateRenderStateBuilderResult<\n    Resources,\n    Options,\n    SharedComposables,\n    SharedInclude,\n    SharedCustom\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' &&\n    value !== null &&\n    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' &&\n      value !== null &&\n      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\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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"}
+{"version":3,"file":"render-state.mjs","names":[],"sources":["../../src/create-config/render-state.ts"],"sourcesContent":["import { createLazyLoader, type LazyLoader } from '../lazy/create-lazy-loader';\nimport { inspectLazy, withLazyHandle } from '../lazy/inspection';\nimport { type LazyHandle, type LazyOptions, type LazyResourceStates } from '../lazy/types';\nimport { LazyResourceModuleShapeError } from '../errors/lazy-resource-error';\nimport type { InspectionStore } from '@jfdevelops/react-layout-devtools-core';\nexport const lazyLoaderSymbol = Symbol('lazyLoader');\nexport const lazyOptionsSymbol = Symbol('lazyOptions');\nexport const lazyInspectionSymbol = Symbol('lazyInspection');\n\nimport {\n  getLayoutDebug,\n  layoutDebug,\n} from '@jfdevelops/react-layout-devtools-core';\nimport type { MergeContract } from './define-layout';\nimport type { JSX } from 'react';\nimport {\n  collectComposablePresetEntries,\n  composablePresetMetaKey,\n  type MergePresetProps,\n  type ComposablePresetMeta,\n} from '@jfdevelops/react-layout-composables';\nimport { LayoutConfigurationError } from '../errors';\nimport {\n  createStateComposable,\n  withStateComposable,\n  type StateComposable,\n  type StateComposableHandle,\n} from './state-composable';\nimport type { ResolveProps } from '@jfdevelops/react-layout-validator';\nimport type {\n  ComposableComponents,\n  CreateLayoutComposable,\n} from '@jfdevelops/react-layout-composables';\nimport {\n  getIncludedPropBehavior,\n  type InPropsObject,\n  type NormalizedIncludedPropBehavior,\n} 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);\n\nexport const lazyRenderStateSymbol: unique symbol = Symbol(\n  'lazyRenderState'\n);\n\nexport const definedRenderStateSymbol: unique symbol = Symbol.for(\n  '@jfdevelops/react-layout/render-state'\n);\n\nexport const definedResourceLayoutComponentSymbol: unique symbol = Symbol.for(\n  '@jfdevelops/react-layout/resource-layout-component'\n);\n\n/** Runtime-compatible render-state shape used when inspecting lazy modules. */\nexport type AnyRenderStateDefinition = {\n  composables?: (\n    create: CreateLayoutComposable<any>,\n    states: any\n  ) => 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> = LazyHandle & {\n  readonly [lazyLoaderSymbol]: LazyLoader<AnyRenderStateDefinition>;\n  readonly [lazyOptionsSymbol]: LazyOptions & { defaults: () => LazyResourceStates };\n  readonly [lazyInspectionSymbol]: ReturnType<typeof inspectLazy>;\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  SharedInclude extends IncludedProps<\n    MergedLayoutInProps<Resources, Options, SharedComposables>\n  > = {},\n  SharedCustom extends InPropsObject = {}\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      MergeContract<SharedInclude, IncludeProps>,\n      MergeContract<SharedCustom, 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  SharedInclude extends IncludedProps<\n    MergedLayoutInProps<Resources, Options, SharedComposables>\n  > = {},\n  SharedCustom extends InPropsObject = {}\n> = (\n  props: RenderStateProps<\n    Resources,\n    Options,\n    SharedComposables,\n    SharedInclude,\n    SharedCustom\n  >,\n  context: RenderStateContext<SharedComposables, Resources>\n) => JSX.Element;\n\ntype NormalizeRenderStateDefinition<Input> = Input extends LazyRenderState<\n  infer Definition\n>\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<\n  Definition,\n  CallProps extends object = ResolveProps<StateCustomProps<Definition>>\n> = {\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}\n  ? Props\n  : {};\n\ntype StateIncludes<Input> = NormalizeStateInput<Input> extends {\n  props?: { include?: infer Includes };\n}\n  ? Includes\n  : {};\n\ntype NormalizeStateInput<Input> = Input extends DeferredRenderState<\n  infer Definition\n>\n  ? Definition\n  : Input extends LazyRenderState<infer Definition>\n  ? Definition\n  : Input;\n\ntype StateLocalComposables<Input> = NormalizeStateInput<Input> extends {\n  composables?: (\n    ...args: any[]\n  ) => infer Components extends ComposableComponents;\n}\n  ? Components\n  : {};\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 NormalizedIncludedPropBehavior<Includes[Key]> extends {\n    visibility: 'required';\n    passthrough: 'component';\n  }\n    ? Key\n    : never]: unknown;\n} & {\n  [Key in Exclude<keyof Includes, keyof Props> as NormalizedIncludedPropBehavior<Includes[Key]> extends\n    | 'optional'\n    | { visibility: 'optional'; passthrough: 'component' }\n    ? Key\n    : never]?: unknown;\n};\n\ntype StateComponentProps<\n  Props extends InPropsObject,\n  Includes\n> = ResolvedIncludedComponentProps<\n  Props,\n  Pick<\n    Includes,\n    Extract<keyof Includes, keyof Props>\n  > extends infer Known extends IncludedProps<Props>\n    ? Known\n    : {}\n> &\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>> &\n  StateComponentProps<\n    MergedLayoutInProps<\n      Resources,\n      Options,\n      Composables & StateLocalComposables<Input>\n    >,\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<\n  Definition,\n  RenderStateCallProps<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<\n  Definition,\n  Deferred extends boolean\n> = 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  SharedInclude extends IncludedProps<\n    MergedLayoutInProps<Resources, Options, SharedComposables>\n  > = {},\n  SharedCustom extends InPropsObject = {}\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      SharedInclude,\n      SharedCustom\n    >\n  ): BoundRenderStateFragment<\n    Resources,\n    Options,\n    SharedComposables,\n    RenderStateEntry<\n      TypedRenderStateDefinition<\n        Resources,\n        Options,\n        State,\n        CustomProps,\n        SharedComposables,\n        StateComposables,\n        IncludeProps,\n        SharedInclude,\n        SharedCustom\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        SharedInclude,\n        SharedCustom\n      >,\n      'state'\n    >\n  ): BoundRenderStateFragment<\n    Resources,\n    Options,\n    SharedComposables,\n    RenderStateEntry<\n      TypedRenderStateDefinition<\n        Resources,\n        Options,\n        'default',\n        CustomProps,\n        SharedComposables,\n        StateComposables,\n        IncludeProps,\n        SharedInclude,\n        SharedCustom\n      >,\n      Deferred\n    >\n  >;\n  (\n    render: TypedRenderStateCallback<\n      Resources,\n      Options,\n      SharedComposables,\n      SharedInclude,\n      SharedCustom\n    >\n  ): BoundRenderStateFragment<\n    Resources,\n    Options,\n    SharedComposables,\n    RenderStateEntry<\n      TypedRenderStateCallback<\n        Resources,\n        Options,\n        SharedComposables,\n        SharedInclude,\n        SharedCustom\n      >,\n      Deferred\n    >\n  >;\n}\n\ntype RenderStateReference = (\n  | { readonly [definedRenderStateSymbol]: AnyRenderStateDefinition }\n  | LazyRenderState<AnyRenderStateDefinition>\n) &\n  StateComposableHandle<any>;\n\ntype ReferenceDefinition<Ref extends RenderStateReference> =\n  Ref extends LazyRenderState<infer Definition>\n    ? Definition\n    : Ref extends {\n        readonly [definedRenderStateSymbol]: infer Definition extends AnyRenderStateDefinition;\n      }\n    ? Definition\n    : never;\n\ntype FromStateEntry<\n  Ref extends RenderStateReference,\n  Definition extends AnyRenderStateDefinition\n> = Ref extends LazyRenderState<AnyRenderStateDefinition>\n  ? LazyRenderState<Definition>\n  : Extract<\n      Ref[Exclude<keyof Ref, 'asComposable' | typeof definedRenderStateSymbol>],\n      LazyRenderState<AnyRenderStateDefinition>\n    > extends never\n  ? Definition\n  : LazyRenderState<Definition>;\n\ntype ReferenceSchemas<Ref extends RenderStateReference> = StateCustomProps<\n  ReferenceDefinition<Ref>\n> &\n  MergePresetProps<StateLocalComposables<ReferenceDefinition<Ref>>>;\n\ntype DefaultReferenceIncludes<\n  Ref extends RenderStateReference,\n  CustomProps\n> = Omit<\n  StateIncludes<ReferenceDefinition<Ref>>,\n  keyof CustomProps | keyof StateCustomProps<ReferenceDefinition<Ref>>\n> & {\n  [Key in Exclude<\n    keyof StateCustomProps<ReferenceDefinition<Ref>>,\n    keyof CustomProps\n  >]: {\n    required: StateCustomProps<ReferenceDefinition<Ref>>[Key] extends { visibility: 'optional' } ? false : true;\n    suppliedVia: 'component';\n  };\n};\n\ntype ReferenceIncludes<\n  Ref extends RenderStateReference,\n  CustomProps,\n  Include\n> = Include extends object\n  ? Include\n  : 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<\n  Resources,\n  Options,\n  Shared & StateLocalComposables<ReferenceDefinition<Ref>> & Local\n> &\n  StateCustomProps<\n    ReferenceDefinition<Ref>\n  > extends infer Props extends InPropsObject\n  ? Props\n  : {};\n\ntype SelectedReferenceSchemas<Ref extends RenderStateReference, Include> = Pick<\n  ReferenceSchemas<Ref>,\n  Extract<keyof Include, keyof ReferenceSchemas<Ref>>\n> extends infer Selected extends InPropsObject\n  ? Selected\n  : {};\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<\n  FromStateInProps<Resources, Options, Shared, Ref, {}>,\n  Extract<\n    keyof Include,\n    keyof FromStateInProps<Resources, Options, Shared, Ref, {}>\n  >\n> extends infer Selected extends InPropsObject\n  ? ResolveProps<Selected>\n  : {};\n\ntype ReferenceRenderProps<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Shared extends ComposableComponents,\n  Ref extends RenderStateReference\n> = RenderStateProps<\n  Resources,\n  Options,\n  Shared & StateLocalComposables<ReferenceDefinition<Ref>>,\n  StateIncludes<\n    ReferenceDefinition<Ref>\n  > extends infer Include extends IncludedProps<\n    MergedLayoutInProps<\n      Resources,\n      Options,\n      Shared & StateLocalComposables<ReferenceDefinition<Ref>>\n    >\n  >\n    ? Include\n    : {},\n  StateCustomProps<ReferenceDefinition<Ref>>\n>;\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<\n      keyof ReferenceCarriedProps<Resources, Options, Shared, Ref, Include>,\n      keyof ReferenceRenderProps<Resources, Options, Shared, Ref>\n    >\n  > & {\n    [composablePresetMetaKey]: ComposablePresetMeta<\n      SelectedReferenceSchemas<Ref, Include>\n    >;\n  };\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?: {\n    custom?: CustomProps;\n    include?: ReferenceIncludes<Ref, CustomProps, Include>;\n  };\n  composables: RenderStateComposablesDefinition<\n    Resources,\n    FromStateComposables<\n      Resources,\n      Options,\n      Shared,\n      Ref,\n      Local,\n      ReferenceIncludes<Ref, CustomProps, Include>\n    >\n  >;\n  render: (\n    props: ResolveProps<CustomProps> &\n      ResolvedIncludedProps<\n        FromStateInProps<Resources, Options, Shared, Ref, Local>,\n        ReferenceIncludes<\n          Ref,\n          CustomProps,\n          Include\n        > extends infer Selected extends IncludedProps<\n          FromStateInProps<Resources, Options, Shared, Ref, Local>\n        >\n          ? Selected\n          : {}\n      >,\n    context: RenderStateContext<\n      Shared &\n        FromStateComposables<\n          Resources,\n          Options,\n          Shared,\n          Ref,\n          Local,\n          ReferenceIncludes<Ref, CustomProps, Include>\n        >,\n      Resources\n    >\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\n    | IncludedProps<FromStateInProps<Resources, Options, Shared, Ref, Local>>\n    | 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 &\n      Record<\n        Exclude<\n          keyof Include,\n          keyof FromStateInProps<Resources, Options, Shared, Ref, Local>\n        >,\n        never\n      >;\n  };\n  composables?: (\n    create: CreateLayoutComposable<LayoutResourceKey<Resources>>,\n    states: {}\n  ) => Local & { Ref?: never };\n  render: FromStateDefinition<\n    Resources,\n    Options,\n    Shared,\n    Ref,\n    State,\n    CustomProps,\n    Local,\n    Include\n  >['render'];\n}) => BoundRenderStateFragment<\n  Resources,\n  Options,\n  Shared,\n  FromStateEntry<\n    Ref,\n    FromStateDefinition<\n      Resources,\n      Options,\n      Shared,\n      Ref,\n      State,\n      CustomProps,\n      Local,\n      Include\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 * - `.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  SharedInclude extends IncludedProps<\n    MergedLayoutInProps<Resources, Options, SharedComposables>\n  > = {},\n  SharedCustom extends InPropsObject = {}\n> extends RenderStateOverloads<\n    Resources,\n    Options,\n    SharedComposables,\n    false,\n    SharedInclude,\n    SharedCustom\n  > {\n  fromState: CreateRenderStateFromState<Resources, Options, SharedComposables>;\n  defer: RenderStateOverloads<\n    Resources,\n    Options,\n    SharedComposables,\n    true,\n    SharedInclude,\n    SharedCustom\n  >;\n  lazy<Module extends Record<string, unknown>>(\n    load: (() => Promise<Module>) | LazyOptions<Module>\n  ): LazyRenderState<DefinedRenderStateFromModule<Module>> &\n    StateComposableHandle<\n      RenderStateCallProps<\n        Resources,\n        Options,\n        SharedComposables,\n        DefinedRenderStateFromModule<Module>\n      >\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, {\n    input: definition,\n    name: definition.state ?? 'default',\n  });\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  SharedInclude extends IncludedProps<\n    MergedLayoutInProps<Resources, Options, SharedComposables>\n  > = {},\n  SharedCustom extends InPropsObject = {}\n> = {\n  props?: { include?: SharedInclude; custom?: SharedCustom };\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  SharedInclude extends IncludedProps<\n    MergedLayoutInProps<Resources, Options, SharedComposables>\n  > = {},\n  SharedCustom extends InPropsObject = {}\n> = CreateRenderState<\n  Resources,\n  Options,\n  SharedComposables,\n  SharedInclude,\n  SharedCustom\n>;\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  SharedInclude extends IncludedProps<\n    MergedLayoutInProps<Resources, Options, SharedComposables>\n  > = {},\n  SharedCustom extends InPropsObject = {}\n>(\n  _arguments: CreateRenderStateBuilderArguments<\n    Resources,\n    Options,\n    SharedComposables,\n    SharedInclude,\n    SharedCustom\n  >,\n  environment?: { store: InspectionStore; defaults: () => LazyResourceStates; onLazy?: () => void }\n): CreateRenderStateBuilderResult<\n  Resources,\n  Options,\n  SharedComposables,\n  SharedInclude,\n  SharedCustom\n> {\n  function createRenderState(\n    input: AnyRenderStateDefinition | RenderStateCallback\n  ) {\n    const definition = normalizeDefinition(input);\n    const debug = getLayoutDebug(input);\n\n    return toFragment(\n      debug ? { ...definition, [layoutDebug]: debug } : definition\n    );\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)\n      ? input.ref\n      : Object.values(input.ref)[0];\n\n    if (isLazyRenderState(entry)) {\n      const lazyState = createRenderState.lazy(async () => {\n        if (entry.status === 'error') entry[lazyLoaderSymbol].reset();\n        const source = await entry[lazyLoaderSymbol].get();\n\n        return {\n          Derived: createRenderState.fromState({\n            ...input,\n            ref: toFragment(source),\n          }),\n        };\n      });\n      const name = input.state ?? 'default';\n      const fragment = { [name]: lazyState };\n\n      Object.defineProperty(fragment, definedRenderStateSymbol, {\n        value: lazyState,\n      });\n\n      return withStateComposable(fragment, { input: lazyState, name });\n    }\n\n    const source = isDeferredRenderState(entry)\n      ? entry[deferredRenderStateSymbol]\n      : definedRenderStateSymbol in input.ref\n      ? input.ref[definedRenderStateSymbol]\n      : undefined;\n\n    if (!source || typeof source.render !== 'function') {\n      throw new LayoutConfigurationError(\n        'fromState requires a created render state'\n      );\n    }\n\n    const custom = input.props?.custom ?? {};\n    const includes =\n      input.props?.include ??\n      Object.fromEntries(\n        Object.entries({\n          ...source.props?.include,\n          ...Object.fromEntries(\n            Object.entries(source.props?.custom ?? {}).map(([key, prop]) => [\n              key,\n              { required: prop.visibility !== 'optional', suppliedVia: 'component' },\n            ])\n          ),\n        }).filter(([key]) => !(key in custom))\n      );\n\n    return toFragment({\n      [layoutDebug]: getLayoutDebug(input),\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\n        if (Object.prototype.hasOwnProperty.call(local, 'Ref')) {\n          throw new LayoutConfigurationError(\n            'Composable name \"Ref\" is reserved by fromState'\n          );\n        }\n\n        const schemas = Object.assign(\n          {},\n          ...collectComposablePresetEntries(inherited).map(\n            ({ props }) => props\n          ),\n          source.props?.custom\n        ) as InPropsObject;\n        const selected = Object.fromEntries(\n          Object.entries(schemas).filter(([key]) => key in includes)\n        );\n        const referenceSource = {\n          ...source,\n          props: {\n            ...source.props,\n            include: Object.fromEntries(\n              Object.entries(source.props?.include ?? {}).map(\n                ([key, behavior]) => [\n                  key,\n                  {\n                    required: !(behavior === 'optional' ||\n                      getIncludedPropBehavior(behavior)?.visibility === 'optional'),\n                    suppliedVia: 'component',\n                  },\n                ]\n              )\n            ),\n          },\n        };\n        const Ref = createStateComposable(\n          {\n            input:\n              input.lazy || isDeferredRenderState(entry)\n                ? { [deferredRenderStateSymbol]: referenceSource }\n                : referenceSource,\n            name: source.state ?? 'default',\n            fallbackStateName: input.state,\n          },\n          {\n            props: {\n              include: Object.fromEntries(\n                Object.keys(includes).map((key) => [key, true as const])\n              ),\n            },\n            normalizeIncludedKeys: true,\n          }\n        );\n\n        Object.defineProperty(Ref, composablePresetMetaKey, {\n          value: { key: 'Ref', props: selected },\n        });\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 = {\n      [deferredRenderStateSymbol]: {\n        ...definition,\n        [layoutDebug]: getLayoutDebug(input),\n      },\n      [layoutDebug]: getLayoutDebug(input),\n    };\n    const fragment = { [definition.state ?? 'default']: deferred };\n\n    Object.defineProperty(fragment, definedRenderStateSymbol, {\n      value: definition,\n    });\n\n    return withStateComposable(fragment, {\n      input: deferred,\n      name: definition.state ?? 'default',\n    });\n  };\n\n  createRenderState.lazy = (\n    input: (() => Promise<Record<string, unknown>>) | LazyOptions\n  ) => {\n    environment?.onLazy?.();\n    const options = typeof input === 'function' ? { load: input } : input;\n    const inspection = inspectLazy('Render state');\n    const loaderOptions = {\n      load: options.load,\n      select: (module: Record<string, unknown>) =>\n        findDefinedRenderState(module, loaderOptions.label),\n      label: 'Render state',\n      hooks: inspection.hooks,\n    };\n    const loader = createLazyLoader(loaderOptions);\n    const lazyState = withLazyHandle(\n      {\n        [lazyRenderStateSymbol]: options.load,\n        [lazyLoaderSymbol]: loader,\n        [lazyOptionsSymbol]: {\n          ...options,\n          defaults: environment?.defaults ?? (() => ({})),\n        },\n        [lazyInspectionSymbol]: {\n          ...inspection,\n          setLabel(value: string) {\n            if (loader.status !== 'unresolved') return;\n            loaderOptions.label = value;\n            inspection.setLabel(value);\n          },\n        },\n        [layoutDebug]: getLayoutDebug(input),\n      },\n      loader\n    );\n    const result = inspection.store.attach(\n      withStateComposable(lazyState, { input: lazyState, name: 'lazy' })\n    );\n    environment?.store.connect(result);\n    return result;\n  };\n\n  return createRenderState as unknown as CreateRenderStateBuilderResult<\n    Resources,\n    Options,\n    SharedComposables,\n    SharedInclude,\n    SharedCustom\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' &&\n    value !== null &&\n    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  label = 'Render state'\n): Promise<AnyRenderStateDefinition> {\n  const definitions = Object.values(module).filter(\n    (value) =>\n      typeof value === 'object' &&\n      value !== null &&\n      definedRenderStateSymbol in value\n  ) as Array<Record<typeof definedRenderStateSymbol, AnyRenderStateDefinition>>;\n\n  if (definitions.length !== 1) {\n    throw new LazyResourceModuleShapeError(label, definitions.length);\n  }\n\n  const definition = definitions[0][definedRenderStateSymbol];\n\n  if (isLazyRenderState(definition)) {\n    if (definition.status === 'error') definition[lazyLoaderSymbol].reset();\n    return definition[lazyLoaderSymbol].get();\n  }\n  return 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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"}

package/dist/errors/lazy-resource-error.cjs

@@ -0,0 +1,37 @@
+const require_layout_configuration_error = require('./layout-configuration-error.cjs');
+const require_resource_state_error = require('./resource-state-error.cjs');
+
+//#region src/errors/lazy-resource-error.ts
+/** A lazy module must export exactly one matching layout, state, or component. */
+var LazyResourceModuleShapeError = class extends require_layout_configuration_error.LayoutConfigurationError {
+	resource;
+	received;
+	code = "lazyResourceModuleShape";
+	constructor(resource, received) {
+		super(`Lazy module "${resource}" must export exactly one matching component or state; received ${received}`);
+		this.resource = resource;
+		this.received = received;
+		this.name = "LazyResourceModuleShapeError";
+	}
+};
+/** A compound state requested before loading does not exist in the module. */
+var LazyResourceStateNotFoundError = class extends require_layout_configuration_error.LayoutConfigurationError {
+	resource;
+	state;
+	code = "lazyResourceStateNotFound";
+	constructor(resource, state) {
+		super(`Lazy resource "${resource}" does not define state "${state}"`);
+		this.resource = resource;
+		this.state = state;
+		this.name = "LazyResourceStateNotFoundError";
+	}
+};
+function isLazyResourceError(error) {
+	return error instanceof require_resource_state_error.ResourceModuleLoadError || error instanceof LazyResourceModuleShapeError || error instanceof LazyResourceStateNotFoundError;
+}
+
+//#endregion
+exports.LazyResourceModuleShapeError = LazyResourceModuleShapeError;
+exports.LazyResourceStateNotFoundError = LazyResourceStateNotFoundError;
+exports.isLazyResourceError = isLazyResourceError;
+//# sourceMappingURL=lazy-resource-error.cjs.map

package/dist/errors/lazy-resource-error.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"lazy-resource-error.cjs","names":["LayoutConfigurationError","ResourceModuleLoadError"],"sources":["../../src/errors/lazy-resource-error.ts"],"sourcesContent":["import { LayoutConfigurationError } from './layout-configuration-error';\nimport { ResourceModuleLoadError } from './resource-state-error';\n\n/** A lazy module must export exactly one matching layout, state, or component. */\nexport class LazyResourceModuleShapeError extends LayoutConfigurationError {\n  override readonly code = 'lazyResourceModuleShape';\n\n  constructor(\n    readonly resource: string,\n    readonly received: number,\n  ) {\n    super(\n      `Lazy module \"${resource}\" must export exactly one matching component or state; received ${received}`,\n    );\n    this.name = 'LazyResourceModuleShapeError';\n  }\n}\n\n/** A compound state requested before loading does not exist in the module. */\nexport class LazyResourceStateNotFoundError extends LayoutConfigurationError {\n  override readonly code = 'lazyResourceStateNotFound';\n\n  constructor(\n    readonly resource: string,\n    readonly state: string,\n  ) {\n    super(`Lazy resource \"${resource}\" does not define state \"${state}\"`);\n    this.name = 'LazyResourceStateNotFoundError';\n  }\n}\n\nexport type LazyResourceError =\n  | ResourceModuleLoadError\n  | LazyResourceModuleShapeError\n  | LazyResourceStateNotFoundError;\n\nexport type LazyResourceErrorMap = {\n  [Code in LazyResourceError['code']]: Extract<\n    LazyResourceError,\n    { code: Code }\n  >;\n};\n\nexport function isLazyResourceError(\n  error: unknown,\n): error is LazyResourceError {\n  return (\n    error instanceof ResourceModuleLoadError ||\n    error instanceof LazyResourceModuleShapeError ||\n    error instanceof LazyResourceStateNotFoundError\n  );\n}\n"],"mappings":";;;;;AAIA,IAAa,+BAAb,cAAkDA,4DAAyB;CAI9D;CACA;CAJX,AAAkB,OAAO;CAEzB,YACE,AAAS,UACT,AAAS,UACT;EACA,MACE,gBAAgB,SAAS,kEAAkE,UAC7F;EALS;EACA;EAKT,KAAK,OAAO;CACd;AACF;;AAGA,IAAa,iCAAb,cAAoDA,4DAAyB;CAIhE;CACA;CAJX,AAAkB,OAAO;CAEzB,YACE,AAAS,UACT,AAAS,OACT;EACA,MAAM,kBAAkB,SAAS,2BAA2B,MAAM,EAAE;EAH3D;EACA;EAGT,KAAK,OAAO;CACd;AACF;AAcA,SAAgB,oBACd,OAC4B;CAC5B,OACE,iBAAiBC,wDACjB,iBAAiB,gCACjB,iBAAiB;AAErB"}

package/dist/errors/lazy-resource-error.d.cts

@@ -0,0 +1,26 @@
+import { LayoutConfigurationError } from "./layout-configuration-error.cjs";
+import { ResourceModuleLoadError } from "./resource-state-error.cjs";
+
+//#region src/errors/lazy-resource-error.d.ts
+/** A lazy module must export exactly one matching layout, state, or component. */
+declare class LazyResourceModuleShapeError extends LayoutConfigurationError {
+  readonly resource: string;
+  readonly received: number;
+  readonly code = "lazyResourceModuleShape";
+  constructor(resource: string, received: number);
+}
+/** A compound state requested before loading does not exist in the module. */
+declare class LazyResourceStateNotFoundError extends LayoutConfigurationError {
+  readonly resource: string;
+  readonly state: string;
+  readonly code = "lazyResourceStateNotFound";
+  constructor(resource: string, state: string);
+}
+type LazyResourceError = ResourceModuleLoadError | LazyResourceModuleShapeError | LazyResourceStateNotFoundError;
+type LazyResourceErrorMap = { [Code in LazyResourceError['code']]: Extract<LazyResourceError, {
+  code: Code;
+}> };
+declare function isLazyResourceError(error: unknown): error is LazyResourceError;
+//#endregion
+export { LazyResourceError, LazyResourceErrorMap, LazyResourceModuleShapeError, LazyResourceStateNotFoundError, isLazyResourceError };
+//# sourceMappingURL=lazy-resource-error.d.cts.map

package/dist/errors/lazy-resource-error.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lazy-resource-error.d.cts","names":[],"sources":["../../src/errors/lazy-resource-error.ts"],"mappings":";;;;;cAIa,4BAAA,SAAqC,wBAAwB;EAAA,SAI7D,QAAA;EAAA,SACA,QAAA;EAAA,SAJO,IAAA;cAGP,QAAA,UACA,QAAA;AAAA;;cAUA,8BAAA,SAAuC,wBAAwB;EAAA,SAI/D,QAAA;EAAA,SACA,KAAA;EAAA,SAJO,IAAA;cAGP,QAAA,UACA,KAAA;AAAA;AAAA,KAOD,iBAAA,GACR,uBAAA,GACA,4BAAA,GACA,8BAAA;AAAA,KAEQ,oBAAA,cACD,iBAAA,WAA4B,OAAA,CACnC,iBAAA;EACE,IAAA,EAAM,IAAA;AAAA;AAAA,iBAII,mBAAA,CACd,KAAA,YACC,KAAA,IAAS,iBAAiB"}

package/dist/errors/lazy-resource-error.d.mts

@@ -0,0 +1,26 @@
+import { LayoutConfigurationError } from "./layout-configuration-error.mjs";
+import { ResourceModuleLoadError } from "./resource-state-error.mjs";
+
+//#region src/errors/lazy-resource-error.d.ts
+/** A lazy module must export exactly one matching layout, state, or component. */
+declare class LazyResourceModuleShapeError extends LayoutConfigurationError {
+  readonly resource: string;
+  readonly received: number;
+  readonly code = "lazyResourceModuleShape";
+  constructor(resource: string, received: number);
+}
+/** A compound state requested before loading does not exist in the module. */
+declare class LazyResourceStateNotFoundError extends LayoutConfigurationError {
+  readonly resource: string;
+  readonly state: string;
+  readonly code = "lazyResourceStateNotFound";
+  constructor(resource: string, state: string);
+}
+type LazyResourceError = ResourceModuleLoadError | LazyResourceModuleShapeError | LazyResourceStateNotFoundError;
+type LazyResourceErrorMap = { [Code in LazyResourceError['code']]: Extract<LazyResourceError, {
+  code: Code;
+}> };
+declare function isLazyResourceError(error: unknown): error is LazyResourceError;
+//#endregion
+export { LazyResourceError, LazyResourceErrorMap, LazyResourceModuleShapeError, LazyResourceStateNotFoundError, isLazyResourceError };
+//# sourceMappingURL=lazy-resource-error.d.mts.map

package/dist/errors/lazy-resource-error.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lazy-resource-error.d.mts","names":[],"sources":["../../src/errors/lazy-resource-error.ts"],"mappings":";;;;;cAIa,4BAAA,SAAqC,wBAAwB;EAAA,SAI7D,QAAA;EAAA,SACA,QAAA;EAAA,SAJO,IAAA;cAGP,QAAA,UACA,QAAA;AAAA;;cAUA,8BAAA,SAAuC,wBAAwB;EAAA,SAI/D,QAAA;EAAA,SACA,KAAA;EAAA,SAJO,IAAA;cAGP,QAAA,UACA,KAAA;AAAA;AAAA,KAOD,iBAAA,GACR,uBAAA,GACA,4BAAA,GACA,8BAAA;AAAA,KAEQ,oBAAA,cACD,iBAAA,WAA4B,OAAA,CACnC,iBAAA;EACE,IAAA,EAAM,IAAA;AAAA;AAAA,iBAII,mBAAA,CACd,KAAA,YACC,KAAA,IAAS,iBAAiB"}

package/dist/errors/lazy-resource-error.mjs

@@ -0,0 +1,35 @@
+import { LayoutConfigurationError } from "./layout-configuration-error.mjs";
+import { ResourceModuleLoadError } from "./resource-state-error.mjs";
+
+//#region src/errors/lazy-resource-error.ts
+/** A lazy module must export exactly one matching layout, state, or component. */
+var LazyResourceModuleShapeError = class extends LayoutConfigurationError {
+	resource;
+	received;
+	code = "lazyResourceModuleShape";
+	constructor(resource, received) {
+		super(`Lazy module "${resource}" must export exactly one matching component or state; received ${received}`);
+		this.resource = resource;
+		this.received = received;
+		this.name = "LazyResourceModuleShapeError";
+	}
+};
+/** A compound state requested before loading does not exist in the module. */
+var LazyResourceStateNotFoundError = class extends LayoutConfigurationError {
+	resource;
+	state;
+	code = "lazyResourceStateNotFound";
+	constructor(resource, state) {
+		super(`Lazy resource "${resource}" does not define state "${state}"`);
+		this.resource = resource;
+		this.state = state;
+		this.name = "LazyResourceStateNotFoundError";
+	}
+};
+function isLazyResourceError(error) {
+	return error instanceof ResourceModuleLoadError || error instanceof LazyResourceModuleShapeError || error instanceof LazyResourceStateNotFoundError;
+}
+
+//#endregion
+export { LazyResourceModuleShapeError, LazyResourceStateNotFoundError, isLazyResourceError };
+//# sourceMappingURL=lazy-resource-error.mjs.map

package/dist/errors/lazy-resource-error.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"lazy-resource-error.mjs","names":[],"sources":["../../src/errors/lazy-resource-error.ts"],"sourcesContent":["import { LayoutConfigurationError } from './layout-configuration-error';\nimport { ResourceModuleLoadError } from './resource-state-error';\n\n/** A lazy module must export exactly one matching layout, state, or component. */\nexport class LazyResourceModuleShapeError extends LayoutConfigurationError {\n  override readonly code = 'lazyResourceModuleShape';\n\n  constructor(\n    readonly resource: string,\n    readonly received: number,\n  ) {\n    super(\n      `Lazy module \"${resource}\" must export exactly one matching component or state; received ${received}`,\n    );\n    this.name = 'LazyResourceModuleShapeError';\n  }\n}\n\n/** A compound state requested before loading does not exist in the module. */\nexport class LazyResourceStateNotFoundError extends LayoutConfigurationError {\n  override readonly code = 'lazyResourceStateNotFound';\n\n  constructor(\n    readonly resource: string,\n    readonly state: string,\n  ) {\n    super(`Lazy resource \"${resource}\" does not define state \"${state}\"`);\n    this.name = 'LazyResourceStateNotFoundError';\n  }\n}\n\nexport type LazyResourceError =\n  | ResourceModuleLoadError\n  | LazyResourceModuleShapeError\n  | LazyResourceStateNotFoundError;\n\nexport type LazyResourceErrorMap = {\n  [Code in LazyResourceError['code']]: Extract<\n    LazyResourceError,\n    { code: Code }\n  >;\n};\n\nexport function isLazyResourceError(\n  error: unknown,\n): error is LazyResourceError {\n  return (\n    error instanceof ResourceModuleLoadError ||\n    error instanceof LazyResourceModuleShapeError ||\n    error instanceof LazyResourceStateNotFoundError\n  );\n}\n"],"mappings":";;;;;AAIA,IAAa,+BAAb,cAAkD,yBAAyB;CAI9D;CACA;CAJX,AAAkB,OAAO;CAEzB,YACE,AAAS,UACT,AAAS,UACT;EACA,MACE,gBAAgB,SAAS,kEAAkE,UAC7F;EALS;EACA;EAKT,KAAK,OAAO;CACd;AACF;;AAGA,IAAa,iCAAb,cAAoD,yBAAyB;CAIhE;CACA;CAJX,AAAkB,OAAO;CAEzB,YACE,AAAS,UACT,AAAS,OACT;EACA,MAAM,kBAAkB,SAAS,2BAA2B,MAAM,EAAE;EAH3D;EACA;EAGT,KAAK,OAAO;CACd;AACF;AAcA,SAAgB,oBACd,OAC4B;CAC5B,OACE,iBAAiB,2BACjB,iBAAiB,gCACjB,iBAAiB;AAErB"}

package/dist/errors/react-layout-error.cjs

@@ -1,5 +1,5 @@
-let _jfdevelops_create_error = require("@jfdevelops/create-error");
 let arktype = require("arktype");
+let _jfdevelops_create_error = require("@jfdevelops/create-error");
 
 //#region src/errors/react-layout-error.ts
 function makeJsonSafe(value) {

package/dist/errors/react-layout-error.mjs

@@ -1,5 +1,5 @@
-import { createError } from "@jfdevelops/create-error";
 import { type } from "arktype";
+import { createError } from "@jfdevelops/create-error";
 
 //#region src/errors/react-layout-error.ts
 function makeJsonSafe(value) {

package/dist/errors/resource-state-error.cjs

@@ -3,10 +3,13 @@
 /** Identifies a failed dynamic import for a resource layout or render state. */
 var ResourceModuleLoadError = class extends Error {
 	resource;
+	cause;
 	code = "resourceModuleLoad";
 	constructor(resource, cause) {
-		super(`Unable to load resource module "${resource}"`, { cause });
+		const detail = cause instanceof Error ? `${cause.name}: ${cause.message}` : typeof cause === "string" ? cause : void 0;
+		super(`Unable to load resource module "${resource}"${detail ? `: ${detail}` : ""}`, { cause });
 		this.resource = resource;
+		this.cause = cause;
 		this.name = "ResourceModuleLoadError";
 	}
 };

package/dist/errors/resource-state-error.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"resource-state-error.cjs","names":[],"sources":["../../src/errors/resource-state-error.ts"],"sourcesContent":["/** Identifies a failed dynamic import for a resource layout or render state. */\nexport class ResourceModuleLoadError extends Error {\n  readonly code = 'resourceModuleLoad';\n\n  constructor(\n    readonly resource: string,\n    cause: unknown,\n  ) {\n    super(`Unable to load resource module \"${resource}\"`, { cause });\n    this.name = 'ResourceModuleLoadError';\n  }\n}\n\n/** Wraps an exception thrown while rendering a named resource state. */\nexport class ResourceRenderError extends Error {\n  readonly code = 'resourceRender';\n\n  constructor(\n    readonly resource: string,\n    readonly state: string,\n    cause: unknown,\n  ) {\n    super(`Unable to render resource \"${resource}\" state \"${state}\"`, {\n      cause,\n    });\n    this.name = 'ResourceRenderError';\n  }\n}\n\n/** Library errors that can trigger a configured resource `Error` state. */\nexport type ResourceStateError =\n  | ResourceModuleLoadError\n  | ResourceRenderError;\n"],"mappings":";;;AACA,IAAa,0BAAb,cAA6C,MAAM;CAItC;CAHX,AAAS,OAAO;CAEhB,YACE,AAAS,UACT,OACA;EACA,MAAM,mCAAmC,SAAS,IAAI,EAAE,MAAM,CAAC;EAHtD;EAIT,KAAK,OAAO;CACd;AACF;;AAGA,IAAa,sBAAb,cAAyC,MAAM;CAIlC;CACA;CAJX,AAAS,OAAO;CAEhB,YACE,AAAS,UACT,AAAS,OACT,OACA;EACA,MAAM,8BAA8B,SAAS,WAAW,MAAM,IAAI,EAChE,MACF,CAAC;EANQ;EACA;EAMT,KAAK,OAAO;CACd;AACF"}
+{"version":3,"file":"resource-state-error.cjs","names":[],"sources":["../../src/errors/resource-state-error.ts"],"sourcesContent":["/** Identifies a failed dynamic import for a resource layout or render state. */\nexport class ResourceModuleLoadError extends Error {\n  readonly code = 'resourceModuleLoad';\n\n  constructor(\n    readonly resource: string,\n    override readonly cause: unknown,\n  ) {\n    const detail = cause instanceof Error\n      ? `${cause.name}: ${cause.message}`\n      : typeof cause === 'string' ? cause : undefined;\n    super(`Unable to load resource module \"${resource}\"${detail ? `: ${detail}` : ''}`, { cause });\n    this.name = 'ResourceModuleLoadError';\n  }\n}\n\n/** Wraps an exception thrown while rendering a named resource state. */\nexport class ResourceRenderError extends Error {\n  readonly code = 'resourceRender';\n\n  constructor(\n    readonly resource: string,\n    readonly state: string,\n    cause: unknown,\n  ) {\n    super(`Unable to render resource \"${resource}\" state \"${state}\"`, {\n      cause,\n    });\n    this.name = 'ResourceRenderError';\n  }\n}\n\n/** Library errors that can trigger a configured resource `Error` state. */\nexport type ResourceStateError =\n  | ResourceModuleLoadError\n  | ResourceRenderError;\n"],"mappings":";;;AACA,IAAa,0BAAb,cAA6C,MAAM;CAItC;CACS;CAJpB,AAAS,OAAO;CAEhB,YACE,AAAS,UACT,AAAkB,OAClB;EACA,MAAM,SAAS,iBAAiB,QAC5B,GAAG,MAAM,KAAK,IAAI,MAAM,YACxB,OAAO,UAAU,WAAW,QAAQ;EACxC,MAAM,mCAAmC,SAAS,GAAG,SAAS,KAAK,WAAW,MAAM,EAAE,MAAM,CAAC;EANpF;EACS;EAMlB,KAAK,OAAO;CACd;AACF;;AAGA,IAAa,sBAAb,cAAyC,MAAM;CAIlC;CACA;CAJX,AAAS,OAAO;CAEhB,YACE,AAAS,UACT,AAAS,OACT,OACA;EACA,MAAM,8BAA8B,SAAS,WAAW,MAAM,IAAI,EAChE,MACF,CAAC;EANQ;EACA;EAMT,KAAK,OAAO;CACd;AACF"}

package/dist/errors/resource-state-error.d.cts

@@ -2,6 +2,7 @@
 /** Identifies a failed dynamic import for a resource layout or render state. */
 declare class ResourceModuleLoadError extends Error {
   readonly resource: string;
+  readonly cause: unknown;
   readonly code = "resourceModuleLoad";
   constructor(resource: string, cause: unknown);
 }

package/dist/errors/resource-state-error.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"resource-state-error.d.cts","names":[],"sources":["../../src/errors/resource-state-error.ts"],"mappings":";;cACa,uBAAA,SAAgC,KAAK;EAAA,SAIrC,QAAA;EAAA,SAHF,IAAA;cAGE,QAAA,UACT,KAAA;AAAA;;cAQS,mBAAA,SAA4B,KAAK;EAAA,SAIjC,QAAA;EAAA,SACA,KAAA;EAAA,SAJF,IAAA;cAGE,QAAA,UACA,KAAA,UACT,KAAA;AAAA;AANJ;AAAA,KAgBY,kBAAA,GACR,uBAAA,GACA,mBAAmB"}
+{"version":3,"file":"resource-state-error.d.cts","names":[],"sources":["../../src/errors/resource-state-error.ts"],"mappings":";;cACa,uBAAA,SAAgC,KAAK;EAAA,SAIrC,QAAA;EAAA,SACS,KAAA;EAAA,SAJX,IAAA;cAGE,QAAA,UACS,KAAA;AAAA;;cAWT,mBAAA,SAA4B,KAAK;EAAA,SAIjC,QAAA;EAAA,SACA,KAAA;EAAA,SAJF,IAAA;cAGE,QAAA,UACA,KAAA,UACT,KAAA;AAAA;AANJ;AAAA,KAgBY,kBAAA,GACR,uBAAA,GACA,mBAAmB"}

package/dist/errors/resource-state-error.d.mts

@@ -2,6 +2,7 @@
 /** Identifies a failed dynamic import for a resource layout or render state. */
 declare class ResourceModuleLoadError extends Error {
   readonly resource: string;
+  readonly cause: unknown;
   readonly code = "resourceModuleLoad";
   constructor(resource: string, cause: unknown);
 }

package/dist/errors/resource-state-error.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"resource-state-error.d.mts","names":[],"sources":["../../src/errors/resource-state-error.ts"],"mappings":";;cACa,uBAAA,SAAgC,KAAK;EAAA,SAIrC,QAAA;EAAA,SAHF,IAAA;cAGE,QAAA,UACT,KAAA;AAAA;;cAQS,mBAAA,SAA4B,KAAK;EAAA,SAIjC,QAAA;EAAA,SACA,KAAA;EAAA,SAJF,IAAA;cAGE,QAAA,UACA,KAAA,UACT,KAAA;AAAA;AANJ;AAAA,KAgBY,kBAAA,GACR,uBAAA,GACA,mBAAmB"}
+{"version":3,"file":"resource-state-error.d.mts","names":[],"sources":["../../src/errors/resource-state-error.ts"],"mappings":";;cACa,uBAAA,SAAgC,KAAK;EAAA,SAIrC,QAAA;EAAA,SACS,KAAA;EAAA,SAJX,IAAA;cAGE,QAAA,UACS,KAAA;AAAA;;cAWT,mBAAA,SAA4B,KAAK;EAAA,SAIjC,QAAA;EAAA,SACA,KAAA;EAAA,SAJF,IAAA;cAGE,QAAA,UACA,KAAA,UACT,KAAA;AAAA;AANJ;AAAA,KAgBY,kBAAA,GACR,uBAAA,GACA,mBAAmB"}

package/dist/errors/resource-state-error.mjs

@@ -2,10 +2,13 @@
 /** Identifies a failed dynamic import for a resource layout or render state. */
 var ResourceModuleLoadError = class extends Error {
 	resource;
+	cause;
 	code = "resourceModuleLoad";
 	constructor(resource, cause) {
-		super(`Unable to load resource module "${resource}"`, { cause });
+		const detail = cause instanceof Error ? `${cause.name}: ${cause.message}` : typeof cause === "string" ? cause : void 0;
+		super(`Unable to load resource module "${resource}"${detail ? `: ${detail}` : ""}`, { cause });
 		this.resource = resource;
+		this.cause = cause;
 		this.name = "ResourceModuleLoadError";
 	}
 };

package/dist/errors/resource-state-error.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"resource-state-error.mjs","names":[],"sources":["../../src/errors/resource-state-error.ts"],"sourcesContent":["/** Identifies a failed dynamic import for a resource layout or render state. */\nexport class ResourceModuleLoadError extends Error {\n  readonly code = 'resourceModuleLoad';\n\n  constructor(\n    readonly resource: string,\n    cause: unknown,\n  ) {\n    super(`Unable to load resource module \"${resource}\"`, { cause });\n    this.name = 'ResourceModuleLoadError';\n  }\n}\n\n/** Wraps an exception thrown while rendering a named resource state. */\nexport class ResourceRenderError extends Error {\n  readonly code = 'resourceRender';\n\n  constructor(\n    readonly resource: string,\n    readonly state: string,\n    cause: unknown,\n  ) {\n    super(`Unable to render resource \"${resource}\" state \"${state}\"`, {\n      cause,\n    });\n    this.name = 'ResourceRenderError';\n  }\n}\n\n/** Library errors that can trigger a configured resource `Error` state. */\nexport type ResourceStateError =\n  | ResourceModuleLoadError\n  | ResourceRenderError;\n"],"mappings":";;AACA,IAAa,0BAAb,cAA6C,MAAM;CAItC;CAHX,AAAS,OAAO;CAEhB,YACE,AAAS,UACT,OACA;EACA,MAAM,mCAAmC,SAAS,IAAI,EAAE,MAAM,CAAC;EAHtD;EAIT,KAAK,OAAO;CACd;AACF;;AAGA,IAAa,sBAAb,cAAyC,MAAM;CAIlC;CACA;CAJX,AAAS,OAAO;CAEhB,YACE,AAAS,UACT,AAAS,OACT,OACA;EACA,MAAM,8BAA8B,SAAS,WAAW,MAAM,IAAI,EAChE,MACF,CAAC;EANQ;EACA;EAMT,KAAK,OAAO;CACd;AACF"}
+{"version":3,"file":"resource-state-error.mjs","names":[],"sources":["../../src/errors/resource-state-error.ts"],"sourcesContent":["/** Identifies a failed dynamic import for a resource layout or render state. */\nexport class ResourceModuleLoadError extends Error {\n  readonly code = 'resourceModuleLoad';\n\n  constructor(\n    readonly resource: string,\n    override readonly cause: unknown,\n  ) {\n    const detail = cause instanceof Error\n      ? `${cause.name}: ${cause.message}`\n      : typeof cause === 'string' ? cause : undefined;\n    super(`Unable to load resource module \"${resource}\"${detail ? `: ${detail}` : ''}`, { cause });\n    this.name = 'ResourceModuleLoadError';\n  }\n}\n\n/** Wraps an exception thrown while rendering a named resource state. */\nexport class ResourceRenderError extends Error {\n  readonly code = 'resourceRender';\n\n  constructor(\n    readonly resource: string,\n    readonly state: string,\n    cause: unknown,\n  ) {\n    super(`Unable to render resource \"${resource}\" state \"${state}\"`, {\n      cause,\n    });\n    this.name = 'ResourceRenderError';\n  }\n}\n\n/** Library errors that can trigger a configured resource `Error` state. */\nexport type ResourceStateError =\n  | ResourceModuleLoadError\n  | ResourceRenderError;\n"],"mappings":";;AACA,IAAa,0BAAb,cAA6C,MAAM;CAItC;CACS;CAJpB,AAAS,OAAO;CAEhB,YACE,AAAS,UACT,AAAkB,OAClB;EACA,MAAM,SAAS,iBAAiB,QAC5B,GAAG,MAAM,KAAK,IAAI,MAAM,YACxB,OAAO,UAAU,WAAW,QAAQ;EACxC,MAAM,mCAAmC,SAAS,GAAG,SAAS,KAAK,WAAW,MAAM,EAAE,MAAM,CAAC;EANpF;EACS;EAMlB,KAAK,OAAO;CACd;AACF;;AAGA,IAAa,sBAAb,cAAyC,MAAM;CAIlC;CACA;CAJX,AAAS,OAAO;CAEhB,YACE,AAAS,UACT,AAAS,OACT,OACA;EACA,MAAM,8BAA8B,SAAS,WAAW,MAAM,IAAI,EAChE,MACF,CAAC;EANQ;EACA;EAMT,KAAK,OAAO;CACd;AACF"}

package/dist/index.cjs

@@ -1,5 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_react_layout_error = require('./errors/react-layout-error.cjs');
+const require_layout_configuration_error = require('./errors/layout-configuration-error.cjs');
+const require_resource_state_error = require('./errors/resource-state-error.cjs');
+const require_lazy_resource_error = require('./errors/lazy-resource-error.cjs');
 const require_invalid_config = require('./errors/invalid-config.cjs');
 const require_invalid_path = require('./errors/invalid-path.cjs');
 const require_invalid_resource = require('./errors/invalid-resource.cjs');
@@ -9,8 +12,6 @@ const require_invalid_part = require('./errors/invalid-part.cjs');
 const require_invalid_part_type = require('./errors/invalid-part-type.cjs');
 const require_missing_path_variable = require('./errors/missing-path-variable.cjs');
 const require_missing_resource_provider = require('./errors/missing-resource-provider.cjs');
-const require_layout_configuration_error = require('./errors/layout-configuration-error.cjs');
-const require_resource_state_error = require('./errors/resource-state-error.cjs');
 const require_preview = require('./create-config/preview.cjs');
 const require_resource = require('./resource.cjs');
 const require_utils = require('./utils.cjs');
@@ -34,6 +35,8 @@ Object.defineProperty(exports, 'LayoutComposablePresetProvider', {
   }
 });
 exports.LayoutConfigurationError = require_layout_configuration_error.LayoutConfigurationError;
+exports.LazyResourceModuleShapeError = require_lazy_resource_error.LazyResourceModuleShapeError;
+exports.LazyResourceStateNotFoundError = require_lazy_resource_error.LazyResourceStateNotFoundError;
 exports.MissingPathVariableError = require_missing_path_variable.MissingPathVariableError;
 exports.MissingResourceProviderError = require_missing_resource_provider.MissingResourceProviderError;
 Object.defineProperty(exports, 'PropError', {
@@ -85,6 +88,7 @@ Object.defineProperty(exports, 'defineComposableComponent', {
 exports.defineLayoutName = require_layout_name.defineLayoutName;
 exports.defineLayoutPreview = require_preview.defineLayoutPreview;
 exports.defineResourceLayout = require_define_layout.defineResourceLayout;
+exports.isLazyResourceError = require_lazy_resource_error.isLazyResourceError;
 Object.defineProperty(exports, 'isPropDefinitionShape', {
   enumerable: true,
   get: function () {

package/dist/index.d.cts

@@ -1,3 +1,7 @@
+import { LayoutConfigurationError, LayoutConfigurationErrorContext } from "./errors/layout-configuration-error.cjs";
+import { ResourceModuleLoadError, ResourceRenderError, ResourceStateError } from "./errors/resource-state-error.cjs";
+import { LazyResourceError, LazyResourceErrorMap, LazyResourceModuleShapeError, LazyResourceStateNotFoundError, isLazyResourceError } from "./errors/lazy-resource-error.cjs";
+import { CreateLazyErrorComponent, LazyErrorHandlers, LazyHandle, LazyOptions, LazyResourceErrorComponent, LazyResourceErrorProps, LazyResourceLoadingComponent, LazyResourceStates, LoadStatus } from "./lazy/types.cjs";
 import { BaseComponent, MergeIntersection, Show, UnionToIntersection, pick } from "./utils.cjs";
 import { LayoutResourceKey, NormalizeResource, NormalizeResources, NormalizedResourceDefinition, NormalizedResourceDefinitions, ResourceDefinition, ResourceDefinitionValue, ResourceEnum, ResourceLayoutComponentProps, ResourcePath, ResourceTree, normalizeResource, normalizeResourceDefinitions, normalizeResources, toResourceEnum } from "./resource.cjs";
 import { InPropsDefinition, InPropsFunction, InPropsObject, InPropsOptions, IncludedComponentPropDefinitions, IncludedPropBehavior, IncludedProps, InferredInProps, LayoutRenderProps, MergedLayoutInProps, PropsContextRender, PropsRenderDefinition, ResolvedIncludedComponentProps, ResolvedIncludedConfigProps, ResolvedIncludedProps, ResolvedIncludedPropsAsDefined } from "./props.cjs";
@@ -10,8 +14,9 @@ import { ForPaths, ForPathsRenderContext, RenderedPathComponent, RenderedPathCom
 import { IsSubResourceKey } from "./create-config/is-sub-resource-key.cjs";
 import { ComponentTypes, CreateResourceConfigFn, CreateResourceConfigForResource, CreatedResourceConfig, ResourceConfigFragment } from "./create-config/get-component.cjs";
 import { CreateResourceMap, CreateResourceMapFn } from "./create-config/create-resource-links.cjs";
+import { ScopedComponentRenderFn } from "./lazy/scoped-content.cjs";
 import { ContextualInlineRenderState, ContextualInlineRenderStates, CreateResourceLayoutWithLayoutOptions, CreateViewMapBuiltInRenderStatesOptions, CreateViewMapFunctionRenderOptions, CreateViewMapInlineRenderStatesOptions, CreateViewMapRenderStatesOptions, DefineResourceLayoutWithLayoutFn, DefineResourcesFn, DefinedResourceLayoutWithShell, LayoutRenderResourcesAccessor, LayoutResourcesAccessor, ResourceLayoutProvider, ResourceLayoutProviderProps, ResourceLayoutShellComponent, ResourceLayoutShellProps, ResourceSelection, ShellLayoutDefinition, ShellRenderContext, TypedBuiltInRenderStates, TypedInlineRenderState, defineResourceLayout } from "./create-config/define-layout.cjs";
-import { LazyResourceErrorComponent, LazyResourceLayoutComponent, LazyResourceLayoutOptions, LazyResourceLoadingComponent, LazyResourceStates } from "./create-config/lazy-resource-layout.cjs";
+import { LazyResourceLayoutComponent, LazyResourceLayoutOptions } from "./create-config/lazy-resource-layout.cjs";
 import { BoundDefineResourceLayout, CreateDefinedResourceLayoutOptions, CreateDefinedResourceLayoutResult, DefineLazyDefaults, DefinedResourceLayoutInput, NonEmptyResources, createDefinedResourceLayout } from "./create-config/create-defined-resource-layout.cjs";
 import { ResourceLayoutShellPublisher } from "./create-config/shell-context.cjs";
 import { LayoutPreviewProps, defineLayoutPreview } from "./create-config/preview.cjs";
@@ -25,8 +30,6 @@ import { InvalidPartContext, InvalidPartError } from "./errors/invalid-part.cjs"
 import { InvalidPartTypeContext, InvalidPartTypeError } from "./errors/invalid-part-type.cjs";
 import { MissingPathVariableContext, MissingPathVariableError } from "./errors/missing-path-variable.cjs";
 import { MissingResourceProviderError } from "./errors/missing-resource-provider.cjs";
-import { LayoutConfigurationError, LayoutConfigurationErrorContext } from "./errors/layout-configuration-error.cjs";
-import { ResourceModuleLoadError, ResourceRenderError, ResourceStateError } from "./errors/resource-state-error.cjs";
 import { AnyComposableComponent, ComposableComponent, ComposableComponentCallable, ComposableComponents, ComposableNameContext, ComposablePresetComponent, ComposablePresetComponentCallProps, ComposablePresetMeta, ComposablePresetProps, ComposableResourceLayout, CreateLayoutComposable, DefinedComposableComponentRecord, LayoutComposablePresetProvider, LayoutComposablesFactory, MakeComposable, MakeComposableOptions, MergePresetProps, PresetPropsFromComposable, RequiredPresetLayoutProps, RequiredPresetRenderProps, ResolveLayoutComposables, collectComposablePresetEntries, createComposableComponent, createLayoutComposableFactory, defineComposableComponent, makeComposable, resolveComposablePresetProps, resolveLayoutComposables } from "@jfdevelops/react-layout-composables";
 import { AnyBuiltPropDefinition, ExtractDefinitionValue, PropError, PropErrorOptions, ResolveLayoutProps, ResolveLayoutPropsAsDefined, ResolveProps, ResolvedBuiltPropShape, createPrimitivePropBuilder, createProp, isPropDefinitionShape, resolvePropDefinitionValues, validateProps } from "@jfdevelops/react-layout-validator";
-export { type AnyBuiltPropDefinition, type AnyComposableComponent, type AnyRenderStateDefinition, type AsStateComposable, type BaseComponent, type BoundDefineResourceLayout, type ComponentTypes, type ComposableComponent, type ComposableComponentCallable, type ComposableComponents, type ComposableNameContext, type ComposablePresetComponent, type ComposablePresetComponentCallProps, type ComposablePresetMeta, type ComposablePresetProps, type ComposableResourceLayout, type ContextualInlineRenderState, type ContextualInlineRenderStates, type CreateDefinedResourceLayoutOptions, type CreateDefinedResourceLayoutResult, type CreateGetComponentForPath, type CreateLayoutBuildingBlocks, type CreateLayoutBuildingBlocksArguments, type CreateLayoutBuildingBlocksResult, type CreateLayoutComposable, type CreateRenderState, type CreateRenderStateBuilderArguments, type CreateRenderStateBuilderResult, type CreateRenderStateFromState, type CreateResourceConfigFn, type CreateResourceConfigForResource, type CreateResourceLayoutWithLayoutOptions, type CreateResourceMap, type CreateResourceMapFn, type CreateViewMapBuiltInRenderStatesOptions, type CreateViewMapFunctionRenderOptions, type CreateViewMapInlineRenderStatesOptions, type CreateViewMapRenderStatesOptions, type CreatedResourceConfig, type DeferredRenderState, type DefineLayoutComposables, type DefineLazyDefaults, type DefineResourceLayoutWithLayoutFn, type DefineResourcesFn, type DefinedComposableComponentRecord, type DefinedResourceLayoutInput, type DefinedResourceLayoutWithShell, type ExtractDefinitionValue, type ForPaths, type ForPathsRenderContext, type GetComponentForPath, type InPropsDefinition, type InPropsFunction, type InPropsObject, type InPropsOptions, type IncludedComponentPropDefinitions, type IncludedPropBehavior, type IncludedProps, type InferredInProps, type InvalidComponentContext, InvalidComponentError, type InvalidConfigContext, InvalidConfigError, type InvalidPartContext, InvalidPartError, type InvalidPartTypeContext, InvalidPartTypeError, type InvalidPathContext, InvalidPathError, type InvalidResourceContext, InvalidResourceError, type InvalidSubResourceContext, InvalidSubResourceError, type IsSubResourceKey, LayoutComposablePresetProvider, type LayoutComposablesDefinition, type LayoutComposablesFactory, LayoutConfigurationError, type LayoutConfigurationErrorContext, type LayoutNameCallback, type LayoutNameContext, type LayoutNameFactory, type LayoutNameInput, type LayoutNameOptions, type LayoutNamePartDefinitions, type LayoutNamePartType, type LayoutNamePartValues, type LayoutNameParts, type LayoutNameResolver, type LayoutPreviewProps, type LayoutRenderProps, type LayoutRenderResourcesAccessor, type LayoutResourceKey, type LayoutResourcesAccessor, type LazyRenderState, type LazyResourceErrorComponent, type LazyResourceLayoutComponent, type LazyResourceLayoutOptions, type LazyResourceLoadingComponent, type LazyResourceStates, type MakeComposable, type MakeComposableOptions, type MergeIntersection, type MergePresetProps, type MergedLayoutInProps, type MissingPathVariableContext, MissingPathVariableError, MissingResourceProviderError, type NonEmptyResources, type NormalizeResource, type NormalizeResources, type NormalizedResourceDefinition, type NormalizedResourceDefinitions, type ParameterizedResourcePath, type PathVariables, type PresetPropsFromComposable, PropError, type PropErrorOptions, type PropsContextRender, type PropsRenderDefinition, ReactLayoutError, type RenderStateCallProps, type RenderStateCallback, type RenderStateComposablesDefinition, type RenderStateContext, type RenderStateFragment, type RenderStateName, type RenderStateOverloads, type RenderStateProps, type RenderStateReferences, type RenderedPathComponent, type RenderedPathComponentHOF, type RequiredPresetLayoutProps, type RequiredPresetRenderProps, type ResolveLayoutComposables, type ResolveLayoutProps, type ResolveLayoutPropsAsDefined, type ResolveProps, type ResolvedBuiltPropShape, type ResolvedIncludedComponentProps, type ResolvedIncludedConfigProps, type ResolvedIncludedProps, type ResolvedIncludedPropsAsDefined, type ResolvedLayoutName, type ResolvedPathValue, type ResourceConfigFragment, type ResourceDefinition, type ResourceDefinitionValue, type ResourceEnum, type ResourceLayoutComponentProps, type ResourceLayoutProvider, type ResourceLayoutProviderProps, type ResourceLayoutShellComponent, type ResourceLayoutShellProps, type ResourceLayoutShellPublisher, ResourceModuleLoadError, type ResourcePath, ResourceRenderError, type ResourceSelection, type ResourceStateError, type ResourceTree, type ShellLayoutDefinition, type ShellRenderContext, type Show, type StateComposable, type StateComposableOptions, type TargetPathBuilder, type TypedBuiltInRenderStates, type TypedInlineRenderState, type TypedRenderStateCallback, type UnionToIntersection, collectComposablePresetEntries, createComposableComponent, createDefinedResourceLayout, createLayoutComposableFactory, createPrimitivePropBuilder, createProp, defineComposableComponent, defineLayoutName, defineLayoutPreview, defineResourceLayout, isPropDefinitionShape, makeComposable, normalizeResource, normalizeResourceDefinitions, normalizeResources, pick, resolveComposablePresetProps, resolveLayoutComposables, resolvePropDefinitionValues, toResourceEnum, validateProps };
+export { type AnyBuiltPropDefinition, type AnyComposableComponent, type AnyRenderStateDefinition, type AsStateComposable, type BaseComponent, type BoundDefineResourceLayout, type ComponentTypes, type ComposableComponent, type ComposableComponentCallable, type ComposableComponents, type ComposableNameContext, type ComposablePresetComponent, type ComposablePresetComponentCallProps, type ComposablePresetMeta, type ComposablePresetProps, type ComposableResourceLayout, type ContextualInlineRenderState, type ContextualInlineRenderStates, type CreateDefinedResourceLayoutOptions, type CreateDefinedResourceLayoutResult, type CreateGetComponentForPath, type CreateLayoutBuildingBlocks, type CreateLayoutBuildingBlocksArguments, type CreateLayoutBuildingBlocksResult, type CreateLayoutComposable, type CreateLazyErrorComponent, type CreateRenderState, type CreateRenderStateBuilderArguments, type CreateRenderStateBuilderResult, type CreateRenderStateFromState, type CreateResourceConfigFn, type CreateResourceConfigForResource, type CreateResourceLayoutWithLayoutOptions, type CreateResourceMap, type CreateResourceMapFn, type CreateViewMapBuiltInRenderStatesOptions, type CreateViewMapFunctionRenderOptions, type CreateViewMapInlineRenderStatesOptions, type CreateViewMapRenderStatesOptions, type CreatedResourceConfig, type DeferredRenderState, type DefineLayoutComposables, type DefineLazyDefaults, type DefineResourceLayoutWithLayoutFn, type DefineResourcesFn, type DefinedComposableComponentRecord, type DefinedResourceLayoutInput, type DefinedResourceLayoutWithShell, type ExtractDefinitionValue, type ForPaths, type ForPathsRenderContext, type GetComponentForPath, type InPropsDefinition, type InPropsFunction, type InPropsObject, type InPropsOptions, type IncludedComponentPropDefinitions, type IncludedPropBehavior, type IncludedProps, type InferredInProps, type InvalidComponentContext, InvalidComponentError, type InvalidConfigContext, InvalidConfigError, type InvalidPartContext, InvalidPartError, type InvalidPartTypeContext, InvalidPartTypeError, type InvalidPathContext, InvalidPathError, type InvalidResourceContext, InvalidResourceError, type InvalidSubResourceContext, InvalidSubResourceError, type IsSubResourceKey, LayoutComposablePresetProvider, type LayoutComposablesDefinition, type LayoutComposablesFactory, LayoutConfigurationError, type LayoutConfigurationErrorContext, type LayoutNameCallback, type LayoutNameContext, type LayoutNameFactory, type LayoutNameInput, type LayoutNameOptions, type LayoutNamePartDefinitions, type LayoutNamePartType, type LayoutNamePartValues, type LayoutNameParts, type LayoutNameResolver, type LayoutPreviewProps, type LayoutRenderProps, type LayoutRenderResourcesAccessor, type LayoutResourceKey, type LayoutResourcesAccessor, type LazyErrorHandlers, type LazyHandle, type LazyOptions, type LazyRenderState, type LazyResourceError, type LazyResourceErrorComponent, type LazyResourceErrorMap, type LazyResourceErrorProps, type LazyResourceLayoutComponent, type LazyResourceLayoutOptions, type LazyResourceLoadingComponent, LazyResourceModuleShapeError, LazyResourceStateNotFoundError, type LazyResourceStates, type LoadStatus, type MakeComposable, type MakeComposableOptions, type MergeIntersection, type MergePresetProps, type MergedLayoutInProps, type MissingPathVariableContext, MissingPathVariableError, MissingResourceProviderError, type NonEmptyResources, type NormalizeResource, type NormalizeResources, type NormalizedResourceDefinition, type NormalizedResourceDefinitions, type ParameterizedResourcePath, type PathVariables, type PresetPropsFromComposable, PropError, type PropErrorOptions, type PropsContextRender, type PropsRenderDefinition, ReactLayoutError, type RenderStateCallProps, type RenderStateCallback, type RenderStateComposablesDefinition, type RenderStateContext, type RenderStateFragment, type RenderStateName, type RenderStateOverloads, type RenderStateProps, type RenderStateReferences, type RenderedPathComponent, type RenderedPathComponentHOF, type RequiredPresetLayoutProps, type RequiredPresetRenderProps, type ResolveLayoutComposables, type ResolveLayoutProps, type ResolveLayoutPropsAsDefined, type ResolveProps, type ResolvedBuiltPropShape, type ResolvedIncludedComponentProps, type ResolvedIncludedConfigProps, type ResolvedIncludedProps, type ResolvedIncludedPropsAsDefined, type ResolvedLayoutName, type ResolvedPathValue, type ResourceConfigFragment, type ResourceDefinition, type ResourceDefinitionValue, type ResourceEnum, type ResourceLayoutComponentProps, type ResourceLayoutProvider, type ResourceLayoutProviderProps, type ResourceLayoutShellComponent, type ResourceLayoutShellProps, type ResourceLayoutShellPublisher, ResourceModuleLoadError, type ResourcePath, ResourceRenderError, type ResourceSelection, type ResourceStateError, type ResourceTree, type ScopedComponentRenderFn, type ShellLayoutDefinition, type ShellRenderContext, type Show, type StateComposable, type StateComposableOptions, type TargetPathBuilder, type TypedBuiltInRenderStates, type TypedInlineRenderState, type TypedRenderStateCallback, type UnionToIntersection, collectComposablePresetEntries, createComposableComponent, createDefinedResourceLayout, createLayoutComposableFactory, createPrimitivePropBuilder, createProp, defineComposableComponent, defineLayoutName, defineLayoutPreview, defineResourceLayout, isLazyResourceError, isPropDefinitionShape, makeComposable, normalizeResource, normalizeResourceDefinitions, normalizeResources, pick, resolveComposablePresetProps, resolveLayoutComposables, resolvePropDefinitionValues, toResourceEnum, validateProps };