@jfdevelops/react-layout 2.0.0 → 2.2.0

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

@@ -4,7 +4,7 @@ const require_merge_layout_props = require('./merge-layout-props.cjs');
 const require_inspection = require('../lazy/inspection.cjs');
 const require_render_state = require('./render-state.cjs');
 const require_define_layout = require('./define-layout.cjs');
-const require_create_error_component = require('../lazy/create-error-component.cjs');
+const require_create_render_state = require('../lazy/create-render-state.cjs');
 const require_lazy_resource_layout = require('./lazy-resource-layout.cjs');
 let _jfdevelops_react_layout_devtools_core = require("@jfdevelops/react-layout-devtools-core");
 
@@ -45,8 +45,9 @@ function createDefinedResourceLayout(configuration) {
 	let lazyDefaultsDefined = false;
 	let lazyLayoutCreated = false;
 	function defineLazyDefaults(defaults) {
-		if (lazyDefaultsDefined) throw new require_layout_configuration_error.LayoutConfigurationError("Lazy resource defaults can only be defined once.");
-		if (lazyLayoutCreated) throw new require_layout_configuration_error.LayoutConfigurationError("Lazy resource defaults must be defined before creating a lazy resource layout.");
+		const replacingInDevelopment = lazyDefaultsDefined && process.env.NODE_ENV !== "production";
+		if (lazyDefaultsDefined && !replacingInDevelopment) throw new require_layout_configuration_error.LayoutConfigurationError("Lazy resource defaults can only be defined once.");
+		if (lazyLayoutCreated && !replacingInDevelopment) throw new require_layout_configuration_error.LayoutConfigurationError("Lazy resource defaults must be defined before creating a lazy resource layout.");
 		lazyDefaults = defaults;
 		lazyDefaultsDefined = true;
 	}
@@ -54,7 +55,15 @@ function createDefinedResourceLayout(configuration) {
 		value: void 0,
 		enumerable: false
 	});
-	defineLazyDefaults.createErrorComponent = require_create_error_component.createLazyErrorComponent;
+	defineLazyDefaults.createRenderState = require_create_render_state.createLazyRenderStateBuilder({
+		resources,
+		options,
+		composables
+	});
+	defineLazyDefaults.createErrorComponent = ((render) => defineLazyDefaults.createRenderState({
+		state: "Error",
+		render
+	}));
 	const boundDefineResourceLayout = ((layout) => {
 		const localComposables = layout.composables;
 		const definition = defineBoundLayout({
@@ -94,7 +103,7 @@ function createDefinedResourceLayout(configuration) {
 				}
 				return module;
 			}
-		}, lazyDefaults, lazyInspection.hooks);
+		}, () => lazyDefaults, lazyInspection.hooks);
 	};
 	return inspection.attach({
 		createRenderState: require_render_state.createRenderStateBuilder({

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

@@ -1 +1 @@
-{"version":3,"file":"create-defined-resource-layout.cjs","names":["defineResourceLayout","LayoutConfigurationError","createLazyErrorComponent","lazyDefaultsSymbol","layoutDebug","mergeLayoutProps","inspectLazy","createLazyResourceLayout","layoutInspection","createRenderStateBuilder","createLayoutResourcesAccessor"],"sources":["../../src/create-config/create-defined-resource-layout.ts"],"sourcesContent":["import { inspectLazy } from '../lazy/inspection';\nimport type { ResourcePath } from '../resource';\nimport { createLazyErrorComponent } from '../lazy/create-error-component';\nimport { lazyDefaultsSymbol, type CreateLazyErrorComponent } from '../lazy/types';\nimport type { LazyResourceError } from '../errors/lazy-resource-error';\nimport {\n  getLayoutDebug,\n  layoutDebug,\n  createInspectionStore,\n  layoutInspection,\n  getInspectionSource,\n} from '@jfdevelops/react-layout-devtools-core';\nimport { mergeLayoutProps } from './merge-layout-props';\nimport type { LayoutNameInput } from './layout-name';\nimport type { MergeContract } from './define-layout';\nimport type {\n  ComposableComponents,\n  CreateLayoutComposable,\n} from '@jfdevelops/react-layout-composables';\nimport { LayoutConfigurationError } from '../errors';\nimport type { InPropsDefinition, InPropsObject } from '../props';\nimport type { LayoutResourceKey, ResourceDefinition } from '../resource';\nimport {\n  type CreateViewMapFunctionRenderOptions,\n  type DefinedResourceLayout,\n  defineResourceLayout,\n  type LayoutIncludeProps,\n  type LayoutResourcesAccessor,\n  type CreateViewMapRenderStatesOptions,\n  type DefinedResourceLayoutFromStates,\n  createLayoutResourcesAccessor,\n} from './define-layout';\nimport {\n  createLazyResourceLayout,\n  type LazyResourceLayoutOptions,\n  type LazyResourceStates,\n} from './lazy-resource-layout';\nimport {\n  createRenderStateBuilder,\n  type CreateRenderState,\n  type RenderStateReferences,\n  type LayoutComposablesDefinition,\n} from './render-state';\n\n/** A resource tuple with at least one entry, preserving literal and nested paths. */\nexport type NonEmptyResources = readonly [\n  ResourceDefinition,\n  ...ResourceDefinition[]\n];\n\n/** Configuration shared by every layout created from one defined-layout factory. */\nexport type CreateDefinedResourceLayoutOptions<\n  Resources extends NonEmptyResources,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  DefaultNamespace extends boolean = false,\n  SharedInclude extends LayoutIncludeProps<\n    Resources,\n    Options,\n    Composables\n  > = {},\n  SharedCustom extends InPropsObject = {},\n  DefaultNaming extends\n    | LayoutNameInput<LayoutResourceKey<Resources>>\n    | undefined = undefined\n> = {\n  namespace?: DefaultNamespace;\n  /** Default naming convention; explicit definition and component names override it. */\n  name?: DefaultNaming;\n  /** Shared prop contracts, merged by key with layout and state contracts. */\n  props?: {\n    include?: LayoutIncludeProps<Resources, Options, Composables> & SharedInclude;\n    custom?: SharedCustom;\n  };\n  /** Resources supported by every layout created from this factory. */\n  resources: Resources;\n  /** Props that render states can opt into through `props.include`. */\n  options?: Options;\n  /** Layout-wide composables available to every render state. */\n  composables?: LayoutComposablesDefinition<Resources, Composables>;\n};\n\n/** The flat layout definition accepted after shared configuration is bound. */\nexport type DefinedResourceLayoutInput<\n  Resources extends NonEmptyResources,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  IncludeProps extends LayoutIncludeProps<Resources, Options, Composables>,\n  CustomProps extends InPropsObject,\n  Render,\n  Namespace extends boolean = false\n> = Omit<\n  CreateViewMapFunctionRenderOptions<\n    Resources,\n    Options,\n    Composables,\n    IncludeProps,\n    CustomProps\n  >['layout'],\n  'composables' | 'render'\n> & { render: Render; namespace?: Namespace };\n\ntype BoundLayoutComposables<\n  Shared extends ComposableComponents,\n  Local extends ComposableComponents\n> = Omit<Shared, keyof Local> & Local;\n\n/** Flattens a definition's layout while preserving its namespace setting. */\ntype BoundLayoutInput<\n  Definition extends { layout: unknown; namespace?: boolean }\n> = Definition['layout'] &\n  Pick<Definition, 'namespace'> &\n  (Definition extends { name?: infer Name } ? { name?: Name } : {});\n\n/** A `defineResourceLayout` function with its shared configuration pre-bound. */\nexport type BoundDefineResourceLayout<\n  Resources extends NonEmptyResources,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  DefaultNamespace extends boolean = false,\n  SharedInclude extends LayoutIncludeProps<\n    Resources,\n    Options,\n    Composables\n  > = {},\n  SharedCustom extends InPropsObject = {},\n  DefaultNaming extends\n    | LayoutNameInput<LayoutResourceKey<Resources>>\n    | undefined = undefined\n> = {\n  /**\n   * Defines a layout whose `render` map contains the required `default` state\n   * and any built-in or custom compound component states.\n   * Keep this overload first so incomplete render objects suggest state keys.\n   * Use `createRenderState` for state-local `composables(create)` callbacks;\n   * the helper infers their render context independently of the enclosing map.\n   */\n  <\n    const Render extends { default: unknown } & Record<string, unknown>,\n    LocalComposables extends ComposableComponents = {},\n    Namespace extends boolean = DefaultNamespace,\n    const IncludeProps extends LayoutIncludeProps<\n      Resources,\n      Options,\n      BoundLayoutComposables<Composables, LocalComposables>\n    > = {},\n    CustomProps extends InPropsObject = {},\n    const Naming extends\n      | LayoutNameInput<\n          LayoutResourceKey<Resources>,\n          ('default' | keyof Render) & string\n        >\n      | undefined = DefaultNaming\n  >(\n    layout: Omit<\n      BoundLayoutInput<\n        CreateViewMapRenderStatesOptions<\n          Resources,\n          Options,\n          BoundLayoutComposables<Composables, LocalComposables>,\n          MergeContract<SharedInclude, IncludeProps>,\n          MergeContract<SharedCustom, CustomProps>,\n          Render,\n          Namespace\n        >\n      >,\n      'composables' | 'name' | 'props'\n    > & {\n      name?: Naming;\n      props?: {\n        include?: LayoutIncludeProps<\n          Resources,\n          Options,\n          BoundLayoutComposables<Composables, LocalComposables>\n        > & IncludeProps;\n        custom?: CustomProps;\n      };\n      composables?: (\n        create: CreateLayoutComposable<LayoutResourceKey<Resources>>,\n        states: RenderStateReferences<Resources, Options, Composables, Render>\n      ) => LocalComposables;\n    }\n  ): DefinedResourceLayoutFromStates<\n    Resources,\n    Options,\n    BoundLayoutComposables<Composables, LocalComposables>,\n    Render,\n    Namespace,\n    MergeContract<SharedInclude, IncludeProps>,\n    MergeContract<SharedCustom, CustomProps>,\n    Naming\n  >;\n  /** Defines a layout whose `render` value is a single default-state callback. */\n  <\n    const IncludeProps extends LayoutIncludeProps<\n      Resources,\n      Options,\n      BoundLayoutComposables<Composables, LocalComposables>\n    > = {},\n    CustomProps extends InPropsObject = {},\n    LocalComposables extends ComposableComponents = {},\n    Namespace extends boolean = DefaultNamespace,\n    const Naming extends\n      | LayoutNameInput<LayoutResourceKey<Resources>, 'default'>\n      | undefined = DefaultNaming\n  >(\n    layout: Omit<\n      BoundLayoutInput<\n        CreateViewMapFunctionRenderOptions<\n          Resources,\n          Options,\n          BoundLayoutComposables<Composables, LocalComposables>,\n          MergeContract<SharedInclude, IncludeProps>,\n          MergeContract<SharedCustom, CustomProps>,\n          Namespace\n        >\n      >,\n      'composables' | 'name' | 'props'\n    > & {\n      name?: Naming;\n      props?: {\n        include?: LayoutIncludeProps<\n          Resources,\n          Options,\n          BoundLayoutComposables<Composables, LocalComposables>\n        > & IncludeProps;\n        custom?: CustomProps;\n      };\n      composables?: (\n        create: CreateLayoutComposable<LayoutResourceKey<Resources>>,\n        states: {}\n      ) => LocalComposables;\n    }\n  ): DefinedResourceLayout<\n    Resources,\n    Options,\n    BoundLayoutComposables<Composables, LocalComposables>,\n    MergeContract<SharedInclude, IncludeProps>,\n    MergeContract<SharedCustom, CustomProps>,\n    {},\n    Namespace,\n    Naming\n  >;\n  /**\n   * Creates a lazy proxy for the single library-defined component exported by\n   * a resource module.\n   *\n   * @param options - Resource path and named-module import callback.\n   */\n  lazy<Module extends Record<string, unknown>>(\n    options: LazyResourceLayoutOptions<Resources, Module>\n  ): ReturnType<typeof createLazyResourceLayout<Resources, Module>>;\n};\n\n/** Registers loading and module-error components used by lazy layouts. */\nexport type DefineLazyDefaults<Resource = string> = {\n  /**\n   * Sets defaults once, before the factory creates its first lazy layout.\n   *\n   * @param defaults - Shared components for pending module loads and failures.\n   */\n  (defaults: LazyResourceStates<Resource>): void;\n  readonly errors: LazyResourceError;\n  createErrorComponent: CreateLazyErrorComponent<Resource>;\n};\n\n/** Reusable helpers produced by {@link createDefinedResourceLayout}. */\nexport type CreateDefinedResourceLayoutResult<\n  Resources extends NonEmptyResources,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  DefaultNamespace extends boolean = false,\n  SharedInclude extends LayoutIncludeProps<\n    Resources,\n    Options,\n    Composables\n  > = {},\n  SharedCustom extends InPropsObject = {},\n  DefaultNaming extends\n    | LayoutNameInput<LayoutResourceKey<Resources>>\n    | undefined = undefined\n> = {\n  /** Creates eager, deferred, or separately imported render-state fragments. */\n  createRenderState: CreateRenderState<\n    Resources,\n    Options,\n    Composables,\n    SharedInclude,\n    SharedCustom\n  >;\n  /** Sets the shared loading and module-error UI used by lazy layouts. */\n  defineLazyDefaults: DefineLazyDefaults<ResourcePath<Resources>>;\n  /** Defines a layout using the resources, options, and composables already bound. */\n  defineResourceLayout: BoundDefineResourceLayout<\n    Resources,\n    Options,\n    Composables,\n    DefaultNamespace,\n    SharedInclude,\n    SharedCustom,\n    DefaultNaming\n  >;\n  /** Reads, selects, or validates the resources bound to this factory. */\n  resources: LayoutResourcesAccessor<Resources>;\n};\n\n/**\n * A configuration that may omit its name cannot guarantee a naming default.\n */\ntype DefinedFactoryNaming<Naming> = undefined extends Naming ? undefined : Naming;\n\n/**\n * Creates type-linked layout helpers from one shared configuration. The returned\n * `defineResourceLayout` accepts the layout directly, while `createRenderState`\n * carries the same resource and option types across file boundaries.\n *\n * @param configuration - Resources and optional shared props/composables to\n * bind to every returned helper.\n * @returns Helpers that share the configuration's inferred literal types.\n *\n * @example\n * ```tsx\n * const { createRenderState, defineResourceLayout } =\n *   createDefinedResourceLayout({\n *     resources: ['users'],\n *     options: { title: createProp.string() },\n *   });\n *\n * const Loading = createRenderState({\n *   state: 'Loading',\n *   props: { include: { title: true } },\n *   render: ({ title }) => <p>Loading {title}</p>,\n * });\n *\n * export const usersLayout = defineResourceLayout({\n *   render: { default: () => <Users />, ...Loading },\n * });\n * ```\n */\nexport function createDefinedResourceLayout<\n  const Resources extends NonEmptyResources,\n  const Options extends InPropsDefinition<Resources> = {},\n  Composables extends ComposableComponents = {},\n  DefaultNamespace extends boolean = false,\n  const SharedInclude extends object = {},\n  const SharedCustom extends InPropsObject = {},\n  const DefaultNaming extends\n    | LayoutNameInput<LayoutResourceKey<Resources>>\n    | undefined = LayoutNameInput<LayoutResourceKey<Resources>> | undefined\n>(\n  configuration: CreateDefinedResourceLayoutOptions<\n    Resources,\n    Options,\n    Composables,\n    DefaultNamespace,\n    SharedInclude,\n    SharedCustom,\n    DefaultNaming\n  >\n): CreateDefinedResourceLayoutResult<\n  Resources,\n  Options,\n  Composables,\n  DefaultNamespace,\n  SharedInclude,\n  SharedCustom,\n  DefinedFactoryNaming<DefaultNaming>\n> {\n  const { resources, options = {} as Options, composables } = configuration;\n  const defineBoundLayout = defineResourceLayout.forResources(...resources);\n  const inspection = createInspectionStore();\n  let lazyDefaults: LazyResourceStates<ResourcePath<Resources>> = {};\n  let lazyDefaultsDefined = false;\n  let lazyLayoutCreated = false;\n\n  function defineLazyDefaults(\n    defaults: LazyResourceStates<ResourcePath<Resources>>\n  ): void {\n    if (lazyDefaultsDefined) {\n      throw new LayoutConfigurationError(\n        'Lazy resource defaults can only be defined once.'\n      );\n    }\n\n    if (lazyLayoutCreated) {\n      throw new LayoutConfigurationError(\n        'Lazy resource defaults must be defined before creating a lazy resource layout.'\n      );\n    }\n\n    lazyDefaults = defaults;\n\n    lazyDefaultsDefined = true;\n  }\n\n  Object.defineProperty(defineLazyDefaults, 'errors', {\n    value: undefined,\n    enumerable: false,\n  });\n  defineLazyDefaults.createErrorComponent = createLazyErrorComponent as CreateLazyErrorComponent<ResourcePath<Resources>>;\n\n  const boundDefineResourceLayout = ((layout: Record<string, unknown>) => {\n    const localComposables = layout.composables as\n      | LayoutComposablesDefinition<Resources, ComposableComponents>\n      | undefined;\n    const definition = defineBoundLayout({\n      [lazyDefaultsSymbol]: () => lazyDefaults,\n      [layoutDebug]: getLayoutDebug(layout) ?? getLayoutDebug(configuration),\n      options,\n      name: layout.name ?? configuration.name,\n      namespace: layout.namespace ?? configuration.namespace,\n      layout: {\n        ...layout,\n        props: mergeLayoutProps(\n          configuration.props,\n          layout.props as { include?: object; custom?: object }\n        ),\n        composables:\n          composables || localComposables\n            ? (\n                create: CreateLayoutComposable<LayoutResourceKey<Resources>>,\n                states: {}\n              ) => ({\n                ...composables?.(create, states),\n                ...localComposables?.(create, states),\n              })\n            : undefined,\n      },\n    } as never);\n\n    inspection.connect(definition);\n\n    return definition;\n  }) as unknown as BoundDefineResourceLayout<\n    Resources,\n    Options,\n    Composables,\n    DefaultNamespace,\n    SharedInclude,\n    SharedCustom,\n    DefinedFactoryNaming<DefaultNaming>\n  >;\n\n  boundDefineResourceLayout.lazy = <Module extends Record<string, unknown>>(\n    lazyOptions: LazyResourceLayoutOptions<Resources, Module>\n  ): ReturnType<typeof createLazyResourceLayout<Resources, Module>> => {\n    lazyLayoutCreated = true;\n\n    const label = (lazyOptions as unknown as { resource: string }).resource;\n    const lazyInspection = inspectLazy(label, inspection);\n    const id = lazyInspection.id;\n\n    return createLazyResourceLayout(\n      {\n        ...lazyOptions,\n        load: async () => {\n          const module: Record<string, unknown> = await lazyOptions.load();\n\n          for (const entry of Object.values(module)) {\n            const component =\n              entry && typeof entry === 'object' && 'Root' in entry\n                ? entry.Root\n                : entry;\n\n            if (\n              ((typeof component === 'object' && component !== null) ||\n                typeof component === 'function') &&\n              layoutInspection in component\n            ) {\n              inspection.connect(component);\n\n              const target = getInspectionSource(component)\n                .getSnapshot()\n                .nodes.find(\n                  (n) =>\n                    n.kind === 'layout' &&\n                    n.label ===\n                      (component as { displayName?: string }).displayName\n                );\n\n              if (target) inspection.edge(id, target.id, 'references');\n            }\n          }\n\n          return module as Module;\n        },\n      },\n      lazyDefaults,\n      lazyInspection.hooks\n    );\n  };\n\n  return inspection.attach({\n    createRenderState: createRenderStateBuilder(\n      {\n        props: configuration.props,\n        composables,\n        options,\n        resources,\n      },\n      {\n        store: inspection,\n        defaults: () => lazyDefaults as LazyResourceStates,\n        onLazy: () => {\n          lazyLayoutCreated = true;\n        },\n      }\n    ),\n    defineLazyDefaults: defineLazyDefaults as DefineLazyDefaults<\n      ResourcePath<Resources>\n    >,\n    defineResourceLayout: boundDefineResourceLayout,\n    resources: createLayoutResourcesAccessor(resources),\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmVA,SAAgB,4BAWd,eAiBA;CACA,MAAM,EAAE,WAAW,UAAU,CAAC,GAAc,gBAAgB;CAC5D,MAAM,oBAAoBA,2CAAqB,aAAa,GAAG,SAAS;CACxE,MAAM,+EAAmC;CACzC,IAAI,eAA4D,CAAC;CACjE,IAAI,sBAAsB;CAC1B,IAAI,oBAAoB;CAExB,SAAS,mBACP,UACM;EACN,IAAI,qBACF,MAAM,IAAIC,4DACR,kDACF;EAGF,IAAI,mBACF,MAAM,IAAIA,4DACR,gFACF;EAGF,eAAe;EAEf,sBAAsB;CACxB;CAEA,OAAO,eAAe,oBAAoB,UAAU;EAClD,OAAO;EACP,YAAY;CACd,CAAC;CACD,mBAAmB,uBAAuBC;CAE1C,MAAM,8BAA8B,WAAoC;EACtE,MAAM,mBAAmB,OAAO;EAGhC,MAAM,aAAa,kBAAkB;IAClCC,yCAA2B;IAC3BC,gHAA6B,MAAM,gEAAoB,aAAa;GACrE;GACA,MAAM,OAAO,QAAQ,cAAc;GACnC,WAAW,OAAO,aAAa,cAAc;GAC7C,QAAQ;IACN,GAAG;IACH,OAAOC,4CACL,cAAc,OACd,OAAO,KACT;IACA,aACE,eAAe,oBAET,QACA,YACI;KACJ,GAAG,cAAc,QAAQ,MAAM;KAC/B,GAAG,mBAAmB,QAAQ,MAAM;IACtC,KACA;GACR;EACF,CAAU;EAEV,WAAW,QAAQ,UAAU;EAE7B,OAAO;CACT;CAUA,0BAA0B,QACxB,gBACmE;EACnE,oBAAoB;EAEpB,MAAM,QAAS,YAAgD;EAC/D,MAAM,iBAAiBC,+BAAY,OAAO,UAAU;EACpD,MAAM,KAAK,eAAe;EAE1B,OAAOC,sDACL;GACE,GAAG;GACH,MAAM,YAAY;IAChB,MAAM,SAAkC,MAAM,YAAY,KAAK;IAE/D,KAAK,MAAM,SAAS,OAAO,OAAO,MAAM,GAAG;KACzC,MAAM,YACJ,SAAS,OAAO,UAAU,YAAY,UAAU,QAC5C,MAAM,OACN;KAEN,KACI,OAAO,cAAc,YAAY,cAAc,QAC/C,OAAO,cAAc,eACvBC,2DAAoB,WACpB;MACA,WAAW,QAAQ,SAAS;MAE5B,MAAM,yEAA6B,SAAS,EACzC,YAAY,EACZ,MAAM,MACJ,MACC,EAAE,SAAS,YACX,EAAE,UACC,UAAuC,WAC9C;MAEF,IAAI,QAAQ,WAAW,KAAK,IAAI,OAAO,IAAI,YAAY;KACzD;IACF;IAEA,OAAO;GACT;EACF,GACA,cACA,eAAe,KACjB;CACF;CAEA,OAAO,WAAW,OAAO;EACvB,mBAAmBC,8CACjB;GACE,OAAO,cAAc;GACrB;GACA;GACA;EACF,GACA;GACE,OAAO;GACP,gBAAgB;GAChB,cAAc;IACZ,oBAAoB;GACtB;EACF,CACF;EACoB;EAGpB,sBAAsB;EACtB,WAAWC,oDAA8B,SAAS;CACpD,CAAC;AACH"}
+{"version":3,"file":"create-defined-resource-layout.cjs","names":["defineResourceLayout","LayoutConfigurationError","createLazyRenderStateBuilder","lazyDefaultsSymbol","layoutDebug","mergeLayoutProps","inspectLazy","createLazyResourceLayout","layoutInspection","createRenderStateBuilder","createLayoutResourcesAccessor"],"sources":["../../src/create-config/create-defined-resource-layout.ts"],"sourcesContent":["import { inspectLazy } from '../lazy/inspection';\nimport type { ResourcePath } from '../resource';\nimport { createLazyRenderStateBuilder, type CreateLazyRenderState, type CreateBoundLazyErrorComponent } from '../lazy/create-render-state';\nimport { lazyDefaultsSymbol } from '../lazy/types';\nimport type { LazyResourceError } from '../errors/lazy-resource-error';\nimport {\n  getLayoutDebug,\n  layoutDebug,\n  createInspectionStore,\n  layoutInspection,\n  getInspectionSource,\n} from '@jfdevelops/react-layout-devtools-core';\nimport { mergeLayoutProps } from './merge-layout-props';\nimport type { LayoutNameInput } from './layout-name';\nimport type { MergeContract } from './define-layout';\nimport type {\n  ComposableComponents,\n  CreateLayoutComposable,\n} from '@jfdevelops/react-layout-composables';\nimport { LayoutConfigurationError } from '../errors';\nimport type { InPropsDefinition, InPropsObject } from '../props';\nimport type { LayoutResourceKey, ResourceDefinition } from '../resource';\nimport {\n  type CreateViewMapFunctionRenderOptions,\n  type DefinedResourceLayout,\n  defineResourceLayout,\n  type LayoutIncludeProps,\n  type LayoutResourcesAccessor,\n  type CreateViewMapRenderStatesOptions,\n  type DefinedResourceLayoutFromStates,\n  createLayoutResourcesAccessor,\n} from './define-layout';\nimport {\n  createLazyResourceLayout,\n  type LazyResourceLayoutOptions,\n  type LazyResourceStates,\n} from './lazy-resource-layout';\nimport {\n  createRenderStateBuilder,\n  type CreateRenderState,\n  type RenderStateContext,\n  type RenderStateReferences,\n  type LayoutComposablesDefinition,\n} from './render-state';\n\n/** A resource tuple with at least one entry, preserving literal and nested paths. */\nexport type NonEmptyResources = readonly [\n  ResourceDefinition,\n  ...ResourceDefinition[]\n];\n\n/** Configuration shared by every layout created from one defined-layout factory. */\nexport type CreateDefinedResourceLayoutOptions<\n  Resources extends NonEmptyResources,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  DefaultNamespace extends boolean = false,\n  SharedInclude extends LayoutIncludeProps<\n    Resources,\n    Options,\n    Composables\n  > = {},\n  SharedCustom extends InPropsObject = {},\n  DefaultNaming extends\n    | LayoutNameInput<LayoutResourceKey<Resources>>\n    | undefined = undefined\n> = {\n  namespace?: DefaultNamespace;\n  /** Default naming convention; explicit definition and component names override it. */\n  name?: DefaultNaming;\n  /** Shared prop contracts, merged by key with layout and state contracts. */\n  props?: {\n    include?: LayoutIncludeProps<Resources, Options, Composables> & SharedInclude;\n    custom?: SharedCustom;\n  };\n  /** Resources supported by every layout created from this factory. */\n  resources: Resources;\n  /** Props that render states can opt into through `props.include`. */\n  options?: Options;\n  /** Layout-wide composables available to every render state. */\n  composables?: LayoutComposablesDefinition<Resources, Composables>;\n};\n\n/** The flat layout definition accepted after shared configuration is bound. */\nexport type DefinedResourceLayoutInput<\n  Resources extends NonEmptyResources,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  IncludeProps extends LayoutIncludeProps<Resources, Options, Composables>,\n  CustomProps extends InPropsObject,\n  Render,\n  Namespace extends boolean = false\n> = Omit<\n  CreateViewMapFunctionRenderOptions<\n    Resources,\n    Options,\n    Composables,\n    IncludeProps,\n    CustomProps\n  >['layout'],\n  'composables' | 'render'\n> & { render: Render; namespace?: Namespace };\n\ntype BoundLayoutComposables<\n  Shared extends ComposableComponents,\n  Local extends ComposableComponents\n> = Omit<Shared, keyof Local> & Local;\n\n/** Flattens a definition's layout while preserving its namespace setting. */\ntype BoundLayoutInput<\n  Definition extends { layout: unknown; namespace?: boolean }\n> = Definition['layout'] &\n  Pick<Definition, 'namespace'> &\n  (Definition extends { name?: infer Name } ? { name?: Name } : {});\n\n/** A `defineResourceLayout` function with its shared configuration pre-bound. */\nexport type BoundDefineResourceLayout<\n  Resources extends NonEmptyResources,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  DefaultNamespace extends boolean = false,\n  SharedInclude extends LayoutIncludeProps<\n    Resources,\n    Options,\n    Composables\n  > = {},\n  SharedCustom extends InPropsObject = {},\n  DefaultNaming extends\n    | LayoutNameInput<LayoutResourceKey<Resources>>\n    | undefined = undefined\n> = {\n  /**\n   * Defines a layout whose `render` map contains the required `default` state\n   * and any built-in or custom compound component states.\n   * Keep this overload first so incomplete render objects suggest state keys.\n   * Use `createRenderState` for state-local `composables(create)` callbacks;\n   * the helper infers their render context independently of the enclosing map.\n   */\n  <\n    const Render extends { default: unknown } & Record<string, unknown>,\n    LocalComposables extends ComposableComponents = {},\n    Namespace extends boolean = DefaultNamespace,\n    const IncludeProps extends LayoutIncludeProps<\n      Resources,\n      Options,\n      BoundLayoutComposables<Composables, LocalComposables>\n    > = {},\n    CustomProps extends InPropsObject = {},\n    const Naming extends\n      | LayoutNameInput<\n          LayoutResourceKey<Resources>,\n          ('default' | keyof Render) & string\n        >\n      | undefined = DefaultNaming\n  >(\n    layout: Omit<\n      BoundLayoutInput<\n        CreateViewMapRenderStatesOptions<\n          Resources,\n          Options,\n          BoundLayoutComposables<Composables, LocalComposables>,\n          MergeContract<SharedInclude, IncludeProps>,\n          MergeContract<SharedCustom, CustomProps>,\n          Render,\n          Namespace\n        >\n      >,\n      'composables' | 'name' | 'props'\n    > & {\n      name?: Naming;\n      props?: {\n        include?: LayoutIncludeProps<\n          Resources,\n          Options,\n          BoundLayoutComposables<Composables, LocalComposables>\n        > & IncludeProps;\n        custom?: CustomProps;\n      };\n      composables?: (\n        create: CreateLayoutComposable<LayoutResourceKey<Resources>>,\n        states: RenderStateReferences<Resources, Options, Composables, Render>\n      ) => LocalComposables;\n    }\n  ): DefinedResourceLayoutFromStates<\n    Resources,\n    Options,\n    BoundLayoutComposables<Composables, LocalComposables>,\n    Render,\n    Namespace,\n    MergeContract<SharedInclude, IncludeProps>,\n    MergeContract<SharedCustom, CustomProps>,\n    Naming\n  >;\n  /** Defines a layout whose `render` value is a single default-state callback. */\n  <\n    const IncludeProps extends LayoutIncludeProps<\n      Resources,\n      Options,\n      BoundLayoutComposables<Composables, LocalComposables>\n    > = {},\n    CustomProps extends InPropsObject = {},\n    LocalComposables extends ComposableComponents = {},\n    Namespace extends boolean = DefaultNamespace,\n    const Naming extends\n      | LayoutNameInput<LayoutResourceKey<Resources>, 'default'>\n      | undefined = DefaultNaming\n  >(\n    layout: Omit<\n      BoundLayoutInput<\n        CreateViewMapFunctionRenderOptions<\n          Resources,\n          Options,\n          BoundLayoutComposables<Composables, LocalComposables>,\n          MergeContract<SharedInclude, IncludeProps>,\n          MergeContract<SharedCustom, CustomProps>,\n          Namespace\n        >\n      >,\n      'composables' | 'name' | 'props'\n    > & {\n      name?: Naming;\n      props?: {\n        include?: LayoutIncludeProps<\n          Resources,\n          Options,\n          BoundLayoutComposables<Composables, LocalComposables>\n        > & IncludeProps;\n        custom?: CustomProps;\n      };\n      composables?: (\n        create: CreateLayoutComposable<LayoutResourceKey<Resources>>,\n        states: {}\n      ) => LocalComposables;\n    }\n  ): DefinedResourceLayout<\n    Resources,\n    Options,\n    BoundLayoutComposables<Composables, LocalComposables>,\n    MergeContract<SharedInclude, IncludeProps>,\n    MergeContract<SharedCustom, CustomProps>,\n    {},\n    Namespace,\n    Naming\n  >;\n  /**\n   * Creates a lazy proxy for the single library-defined component exported by\n   * a resource module.\n   *\n   * @param options - Resource path and named-module import callback.\n   */\n  lazy<Module extends Record<string, unknown>>(\n    options: LazyResourceLayoutOptions<Resources, Module>\n  ): ReturnType<typeof createLazyResourceLayout<Resources, Module>>;\n};\n\n/** Registers loading and module-error components used by lazy layouts. */\nexport type DefineLazyDefaults<\n  Resource = string,\n  Resources extends ReadonlyArray<ResourceDefinition> = ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources> = {},\n  Composables extends ComposableComponents = {},\n> = {\n  /**\n   * Sets defaults before the first lazy layout. Development reloads may replace them.\n   *\n   * @param defaults - Shared components for pending module loads and failures.\n   */\n  (defaults: LazyResourceStates<Resource>): void;\n  readonly errors: LazyResourceError;\n  createRenderState: CreateLazyRenderState<Resources, Options, Composables>;\n  /** @deprecated Use createRenderState({ state: 'Error', render }) instead. */\n  createErrorComponent: CreateBoundLazyErrorComponent<Resource, RenderStateContext<Composables, Resources, 'Error'>>;\n};\n\n/** Reusable helpers produced by {@link createDefinedResourceLayout}. */\nexport type CreateDefinedResourceLayoutResult<\n  Resources extends NonEmptyResources,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  DefaultNamespace extends boolean = false,\n  SharedInclude extends LayoutIncludeProps<\n    Resources,\n    Options,\n    Composables\n  > = {},\n  SharedCustom extends InPropsObject = {},\n  DefaultNaming extends\n    | LayoutNameInput<LayoutResourceKey<Resources>>\n    | undefined = undefined\n> = {\n  /** Creates eager, deferred, or separately imported render-state fragments. */\n  createRenderState: CreateRenderState<\n    Resources,\n    Options,\n    Composables,\n    SharedInclude,\n    SharedCustom\n  >;\n  /** Sets the shared loading and module-error UI used by lazy layouts. */\n  defineLazyDefaults: DefineLazyDefaults<ResourcePath<Resources>, Resources, Options, Composables>;\n  /** Defines a layout using the resources, options, and composables already bound. */\n  defineResourceLayout: BoundDefineResourceLayout<\n    Resources,\n    Options,\n    Composables,\n    DefaultNamespace,\n    SharedInclude,\n    SharedCustom,\n    DefaultNaming\n  >;\n  /** Reads, selects, or validates the resources bound to this factory. */\n  resources: LayoutResourcesAccessor<Resources>;\n};\n\n/**\n * A configuration that may omit its name cannot guarantee a naming default.\n */\ntype DefinedFactoryNaming<Naming> = undefined extends Naming ? undefined : Naming;\n\n/**\n * Creates type-linked layout helpers from one shared configuration. The returned\n * `defineResourceLayout` accepts the layout directly, while `createRenderState`\n * carries the same resource and option types across file boundaries.\n *\n * @param configuration - Resources and optional shared props/composables to\n * bind to every returned helper.\n * @returns Helpers that share the configuration's inferred literal types.\n *\n * @example\n * ```tsx\n * const { createRenderState, defineResourceLayout } =\n *   createDefinedResourceLayout({\n *     resources: ['users'],\n *     options: { title: createProp.string() },\n *   });\n *\n * const Loading = createRenderState({\n *   state: 'Loading',\n *   props: { include: { title: true } },\n *   render: ({ title }) => <p>Loading {title}</p>,\n * });\n *\n * export const usersLayout = defineResourceLayout({\n *   render: { default: () => <Users />, ...Loading },\n * });\n * ```\n */\nexport function createDefinedResourceLayout<\n  const Resources extends NonEmptyResources,\n  const Options extends InPropsDefinition<Resources> = {},\n  Composables extends ComposableComponents = {},\n  DefaultNamespace extends boolean = false,\n  const SharedInclude extends object = {},\n  const SharedCustom extends InPropsObject = {},\n  const DefaultNaming extends\n    | LayoutNameInput<LayoutResourceKey<Resources>>\n    | undefined = LayoutNameInput<LayoutResourceKey<Resources>> | undefined\n>(\n  configuration: CreateDefinedResourceLayoutOptions<\n    Resources,\n    Options,\n    Composables,\n    DefaultNamespace,\n    SharedInclude,\n    SharedCustom,\n    DefaultNaming\n  >\n): CreateDefinedResourceLayoutResult<\n  Resources,\n  Options,\n  Composables,\n  DefaultNamespace,\n  SharedInclude,\n  SharedCustom,\n  DefinedFactoryNaming<DefaultNaming>\n> {\n  const { resources, options = {} as Options, composables } = configuration;\n  const defineBoundLayout = defineResourceLayout.forResources(...resources);\n  const inspection = createInspectionStore();\n  let lazyDefaults: LazyResourceStates<ResourcePath<Resources>> = {};\n  let lazyDefaultsDefined = false;\n  let lazyLayoutCreated = false;\n\n  function defineLazyDefaults(\n    defaults: LazyResourceStates<ResourcePath<Resources>>\n  ): void {\n    const replacingInDevelopment = lazyDefaultsDefined && process.env.NODE_ENV !== 'production';\n    if (lazyDefaultsDefined && !replacingInDevelopment) {\n      throw new LayoutConfigurationError(\n        'Lazy resource defaults can only be defined once.'\n      );\n    }\n\n    if (lazyLayoutCreated && !replacingInDevelopment) {\n      throw new LayoutConfigurationError(\n        'Lazy resource defaults must be defined before creating a lazy resource layout.'\n      );\n    }\n\n    lazyDefaults = defaults;\n\n    lazyDefaultsDefined = true;\n  }\n\n  Object.defineProperty(defineLazyDefaults, 'errors', {\n    value: undefined,\n    enumerable: false,\n  });\n  defineLazyDefaults.createRenderState = createLazyRenderStateBuilder({ resources, options, composables });\n  defineLazyDefaults.createErrorComponent = ((render: any) =>\n    defineLazyDefaults.createRenderState({ state: 'Error', render })\n  ) as CreateBoundLazyErrorComponent<ResourcePath<Resources>, RenderStateContext<Composables, Resources, 'Error'>>;\n\n  const boundDefineResourceLayout = ((layout: Record<string, unknown>) => {\n    const localComposables = layout.composables as\n      | LayoutComposablesDefinition<Resources, ComposableComponents>\n      | undefined;\n    const definition = defineBoundLayout({\n      [lazyDefaultsSymbol]: () => lazyDefaults,\n      [layoutDebug]: getLayoutDebug(layout) ?? getLayoutDebug(configuration),\n      options,\n      name: layout.name ?? configuration.name,\n      namespace: layout.namespace ?? configuration.namespace,\n      layout: {\n        ...layout,\n        props: mergeLayoutProps(\n          configuration.props,\n          layout.props as { include?: object; custom?: object }\n        ),\n        composables:\n          composables || localComposables\n            ? (\n                create: CreateLayoutComposable<LayoutResourceKey<Resources>>,\n                states: {}\n              ) => ({\n                ...composables?.(create, states),\n                ...localComposables?.(create, states),\n              })\n            : undefined,\n      },\n    } as never);\n\n    inspection.connect(definition);\n\n    return definition;\n  }) as unknown as BoundDefineResourceLayout<\n    Resources,\n    Options,\n    Composables,\n    DefaultNamespace,\n    SharedInclude,\n    SharedCustom,\n    DefinedFactoryNaming<DefaultNaming>\n  >;\n\n  boundDefineResourceLayout.lazy = <Module extends Record<string, unknown>>(\n    lazyOptions: LazyResourceLayoutOptions<Resources, Module>\n  ): ReturnType<typeof createLazyResourceLayout<Resources, Module>> => {\n    lazyLayoutCreated = true;\n\n    const label = (lazyOptions as unknown as { resource: string }).resource;\n    const lazyInspection = inspectLazy(label, inspection);\n    const id = lazyInspection.id;\n\n    return createLazyResourceLayout(\n      {\n        ...lazyOptions,\n        load: async () => {\n          const module: Record<string, unknown> = await lazyOptions.load();\n\n          for (const entry of Object.values(module)) {\n            const component =\n              entry && typeof entry === 'object' && 'Root' in entry\n                ? entry.Root\n                : entry;\n\n            if (\n              ((typeof component === 'object' && component !== null) ||\n                typeof component === 'function') &&\n              layoutInspection in component\n            ) {\n              inspection.connect(component);\n\n              const target = getInspectionSource(component)\n                .getSnapshot()\n                .nodes.find(\n                  (n) =>\n                    n.kind === 'layout' &&\n                    n.label ===\n                      (component as { displayName?: string }).displayName\n                );\n\n              if (target) inspection.edge(id, target.id, 'references');\n            }\n          }\n\n          return module as Module;\n        },\n      },\n      () => lazyDefaults,\n      lazyInspection.hooks\n    );\n  };\n\n  return inspection.attach({\n    createRenderState: createRenderStateBuilder(\n      {\n        props: configuration.props,\n        composables,\n        options,\n        resources,\n      },\n      {\n        store: inspection,\n        defaults: () => lazyDefaults as LazyResourceStates,\n        onLazy: () => {\n          lazyLayoutCreated = true;\n        },\n      }\n    ),\n    defineLazyDefaults: defineLazyDefaults as DefineLazyDefaults<\n      ResourcePath<Resources>, Resources, Options, Composables\n    >,\n    defineResourceLayout: boundDefineResourceLayout,\n    resources: createLayoutResourcesAccessor(resources),\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2VA,SAAgB,4BAWd,eAiBA;CACA,MAAM,EAAE,WAAW,UAAU,CAAC,GAAc,gBAAgB;CAC5D,MAAM,oBAAoBA,2CAAqB,aAAa,GAAG,SAAS;CACxE,MAAM,+EAAmC;CACzC,IAAI,eAA4D,CAAC;CACjE,IAAI,sBAAsB;CAC1B,IAAI,oBAAoB;CAExB,SAAS,mBACP,UACM;EACN,MAAM,yBAAyB,uBAAuB,QAAQ,IAAI,aAAa;EAC/E,IAAI,uBAAuB,CAAC,wBAC1B,MAAM,IAAIC,4DACR,kDACF;EAGF,IAAI,qBAAqB,CAAC,wBACxB,MAAM,IAAIA,4DACR,gFACF;EAGF,eAAe;EAEf,sBAAsB;CACxB;CAEA,OAAO,eAAe,oBAAoB,UAAU;EAClD,OAAO;EACP,YAAY;CACd,CAAC;CACD,mBAAmB,oBAAoBC,yDAA6B;EAAE;EAAW;EAAS;CAAY,CAAC;CACvG,mBAAmB,yBAAyB,WAC1C,mBAAmB,kBAAkB;EAAE,OAAO;EAAS;CAAO,CAAC;CAGjE,MAAM,8BAA8B,WAAoC;EACtE,MAAM,mBAAmB,OAAO;EAGhC,MAAM,aAAa,kBAAkB;IAClCC,yCAA2B;IAC3BC,gHAA6B,MAAM,gEAAoB,aAAa;GACrE;GACA,MAAM,OAAO,QAAQ,cAAc;GACnC,WAAW,OAAO,aAAa,cAAc;GAC7C,QAAQ;IACN,GAAG;IACH,OAAOC,4CACL,cAAc,OACd,OAAO,KACT;IACA,aACE,eAAe,oBAET,QACA,YACI;KACJ,GAAG,cAAc,QAAQ,MAAM;KAC/B,GAAG,mBAAmB,QAAQ,MAAM;IACtC,KACA;GACR;EACF,CAAU;EAEV,WAAW,QAAQ,UAAU;EAE7B,OAAO;CACT;CAUA,0BAA0B,QACxB,gBACmE;EACnE,oBAAoB;EAEpB,MAAM,QAAS,YAAgD;EAC/D,MAAM,iBAAiBC,+BAAY,OAAO,UAAU;EACpD,MAAM,KAAK,eAAe;EAE1B,OAAOC,sDACL;GACE,GAAG;GACH,MAAM,YAAY;IAChB,MAAM,SAAkC,MAAM,YAAY,KAAK;IAE/D,KAAK,MAAM,SAAS,OAAO,OAAO,MAAM,GAAG;KACzC,MAAM,YACJ,SAAS,OAAO,UAAU,YAAY,UAAU,QAC5C,MAAM,OACN;KAEN,KACI,OAAO,cAAc,YAAY,cAAc,QAC/C,OAAO,cAAc,eACvBC,2DAAoB,WACpB;MACA,WAAW,QAAQ,SAAS;MAE5B,MAAM,yEAA6B,SAAS,EACzC,YAAY,EACZ,MAAM,MACJ,MACC,EAAE,SAAS,YACX,EAAE,UACC,UAAuC,WAC9C;MAEF,IAAI,QAAQ,WAAW,KAAK,IAAI,OAAO,IAAI,YAAY;KACzD;IACF;IAEA,OAAO;GACT;EACF,SACM,cACN,eAAe,KACjB;CACF;CAEA,OAAO,WAAW,OAAO;EACvB,mBAAmBC,8CACjB;GACE,OAAO,cAAc;GACrB;GACA;GACA;EACF,GACA;GACE,OAAO;GACP,gBAAgB;GAChB,cAAc;IACZ,oBAAoB;GACtB;EACF,CACF;EACoB;EAGpB,sBAAsB;EACtB,WAAWC,oDAA8B,SAAS;CACpD,CAAC;AACH"}

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

@@ -1,10 +1,11 @@
 import { LazyResourceError } from "../errors/lazy-resource-error.cjs";
-import { CreateLazyErrorComponent, LazyResourceStates } from "../lazy/types.cjs";
+import { LazyResourceStates } from "../lazy/types.cjs";
 import { LayoutResourceKey, ResourceDefinition, ResourcePath } from "../resource.cjs";
 import { InPropsDefinition, InPropsObject } from "../props.cjs";
-import { CreateRenderState, LayoutComposablesDefinition, RenderStateReferences } from "./render-state.cjs";
+import { CreateRenderState, LayoutComposablesDefinition, RenderStateContext, RenderStateReferences } from "./render-state.cjs";
 import { LayoutNameInput } from "./layout-name.cjs";
 import { CreateViewMapFunctionRenderOptions, CreateViewMapRenderStatesOptions, DefinedResourceLayout, DefinedResourceLayoutFromStates, LayoutIncludeProps, LayoutResourcesAccessor, MergeContract } from "./define-layout.cjs";
+import { CreateBoundLazyErrorComponent, CreateLazyRenderState } from "../lazy/create-render-state.cjs";
 import { LazyResourceLayoutOptions, createLazyResourceLayout } from "./lazy-resource-layout.cjs";
 import { ComposableComponents, CreateLayoutComposable } from "@jfdevelops/react-layout-composables";
 
@@ -74,20 +75,21 @@ type BoundDefineResourceLayout<Resources extends NonEmptyResources, Options exte
   lazy<Module extends Record<string, unknown>>(options: LazyResourceLayoutOptions<Resources, Module>): ReturnType<typeof createLazyResourceLayout<Resources, Module>>;
 };
 /** Registers loading and module-error components used by lazy layouts. */
-type DefineLazyDefaults<Resource = string> = {
+type DefineLazyDefaults<Resource = string, Resources extends ReadonlyArray<ResourceDefinition> = ReadonlyArray<ResourceDefinition>, Options extends InPropsDefinition<Resources> = {}, Composables extends ComposableComponents = {}> = {
   /**
-   * Sets defaults once, before the factory creates its first lazy layout.
+   * Sets defaults before the first lazy layout. Development reloads may replace them.
    *
    * @param defaults - Shared components for pending module loads and failures.
    */
   (defaults: LazyResourceStates<Resource>): void;
   readonly errors: LazyResourceError;
-  createErrorComponent: CreateLazyErrorComponent<Resource>;
+  createRenderState: CreateLazyRenderState<Resources, Options, Composables>; /** @deprecated Use createRenderState({ state: 'Error', render }) instead. */
+  createErrorComponent: CreateBoundLazyErrorComponent<Resource, RenderStateContext<Composables, Resources, 'Error'>>;
 };
 /** Reusable helpers produced by {@link createDefinedResourceLayout}. */
 type CreateDefinedResourceLayoutResult<Resources extends NonEmptyResources, Options extends InPropsDefinition<Resources>, Composables extends ComposableComponents, DefaultNamespace extends boolean = false, SharedInclude extends LayoutIncludeProps<Resources, Options, Composables> = {}, SharedCustom extends InPropsObject = {}, DefaultNaming extends LayoutNameInput<LayoutResourceKey<Resources>> | undefined = undefined> = {
   /** Creates eager, deferred, or separately imported render-state fragments. */createRenderState: CreateRenderState<Resources, Options, Composables, SharedInclude, SharedCustom>; /** Sets the shared loading and module-error UI used by lazy layouts. */
-  defineLazyDefaults: DefineLazyDefaults<ResourcePath<Resources>>; /** Defines a layout using the resources, options, and composables already bound. */
+  defineLazyDefaults: DefineLazyDefaults<ResourcePath<Resources>, Resources, Options, Composables>; /** Defines a layout using the resources, options, and composables already bound. */
   defineResourceLayout: BoundDefineResourceLayout<Resources, Options, Composables, DefaultNamespace, SharedInclude, SharedCustom, DefaultNaming>; /** Reads, selects, or validates the resources bound to this factory. */
   resources: LayoutResourcesAccessor<Resources>;
 };

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

@@ -1 +1 @@
-{"version":3,"file":"create-defined-resource-layout.d.cts","names":[],"sources":["../../src/create-config/create-defined-resource-layout.ts"],"mappings":"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"}
+{"version":3,"file":"create-defined-resource-layout.d.cts","names":[],"sources":["../../src/create-config/create-defined-resource-layout.ts"],"mappings":"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"}

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

@@ -1,10 +1,11 @@
 import { LazyResourceError } from "../errors/lazy-resource-error.mjs";
-import { CreateLazyErrorComponent, LazyResourceStates } from "../lazy/types.mjs";
+import { LazyResourceStates } from "../lazy/types.mjs";
 import { LayoutResourceKey, ResourceDefinition, ResourcePath } from "../resource.mjs";
 import { InPropsDefinition, InPropsObject } from "../props.mjs";
-import { CreateRenderState, LayoutComposablesDefinition, RenderStateReferences } from "./render-state.mjs";
+import { CreateRenderState, LayoutComposablesDefinition, RenderStateContext, RenderStateReferences } from "./render-state.mjs";
 import { LayoutNameInput } from "./layout-name.mjs";
 import { CreateViewMapFunctionRenderOptions, CreateViewMapRenderStatesOptions, DefinedResourceLayout, DefinedResourceLayoutFromStates, LayoutIncludeProps, LayoutResourcesAccessor, MergeContract } from "./define-layout.mjs";
+import { CreateBoundLazyErrorComponent, CreateLazyRenderState } from "../lazy/create-render-state.mjs";
 import { LazyResourceLayoutOptions, createLazyResourceLayout } from "./lazy-resource-layout.mjs";
 import { ComposableComponents, CreateLayoutComposable } from "@jfdevelops/react-layout-composables";
 
@@ -74,20 +75,21 @@ type BoundDefineResourceLayout<Resources extends NonEmptyResources, Options exte
   lazy<Module extends Record<string, unknown>>(options: LazyResourceLayoutOptions<Resources, Module>): ReturnType<typeof createLazyResourceLayout<Resources, Module>>;
 };
 /** Registers loading and module-error components used by lazy layouts. */
-type DefineLazyDefaults<Resource = string> = {
+type DefineLazyDefaults<Resource = string, Resources extends ReadonlyArray<ResourceDefinition> = ReadonlyArray<ResourceDefinition>, Options extends InPropsDefinition<Resources> = {}, Composables extends ComposableComponents = {}> = {
   /**
-   * Sets defaults once, before the factory creates its first lazy layout.
+   * Sets defaults before the first lazy layout. Development reloads may replace them.
    *
    * @param defaults - Shared components for pending module loads and failures.
    */
   (defaults: LazyResourceStates<Resource>): void;
   readonly errors: LazyResourceError;
-  createErrorComponent: CreateLazyErrorComponent<Resource>;
+  createRenderState: CreateLazyRenderState<Resources, Options, Composables>; /** @deprecated Use createRenderState({ state: 'Error', render }) instead. */
+  createErrorComponent: CreateBoundLazyErrorComponent<Resource, RenderStateContext<Composables, Resources, 'Error'>>;
 };
 /** Reusable helpers produced by {@link createDefinedResourceLayout}. */
 type CreateDefinedResourceLayoutResult<Resources extends NonEmptyResources, Options extends InPropsDefinition<Resources>, Composables extends ComposableComponents, DefaultNamespace extends boolean = false, SharedInclude extends LayoutIncludeProps<Resources, Options, Composables> = {}, SharedCustom extends InPropsObject = {}, DefaultNaming extends LayoutNameInput<LayoutResourceKey<Resources>> | undefined = undefined> = {
   /** Creates eager, deferred, or separately imported render-state fragments. */createRenderState: CreateRenderState<Resources, Options, Composables, SharedInclude, SharedCustom>; /** Sets the shared loading and module-error UI used by lazy layouts. */
-  defineLazyDefaults: DefineLazyDefaults<ResourcePath<Resources>>; /** Defines a layout using the resources, options, and composables already bound. */
+  defineLazyDefaults: DefineLazyDefaults<ResourcePath<Resources>, Resources, Options, Composables>; /** Defines a layout using the resources, options, and composables already bound. */
   defineResourceLayout: BoundDefineResourceLayout<Resources, Options, Composables, DefaultNamespace, SharedInclude, SharedCustom, DefaultNaming>; /** Reads, selects, or validates the resources bound to this factory. */
   resources: LayoutResourcesAccessor<Resources>;
 };

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

@@ -1 +1 @@
-{"version":3,"file":"create-defined-resource-layout.d.mts","names":[],"sources":["../../src/create-config/create-defined-resource-layout.ts"],"mappings":"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"}
+{"version":3,"file":"create-defined-resource-layout.d.mts","names":[],"sources":["../../src/create-config/create-defined-resource-layout.ts"],"mappings":"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"}

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

@@ -4,7 +4,7 @@ import { mergeLayoutProps } from "./merge-layout-props.mjs";
 import { inspectLazy } from "../lazy/inspection.mjs";
 import { createRenderStateBuilder } from "./render-state.mjs";
 import { createLayoutResourcesAccessor, defineResourceLayout } from "./define-layout.mjs";
-import { createLazyErrorComponent } from "../lazy/create-error-component.mjs";
+import { createLazyRenderStateBuilder } from "../lazy/create-render-state.mjs";
 import { createLazyResourceLayout } from "./lazy-resource-layout.mjs";
 import { createInspectionStore, getInspectionSource, getLayoutDebug, layoutDebug, layoutInspection } from "@jfdevelops/react-layout-devtools-core";
 
@@ -45,8 +45,9 @@ function createDefinedResourceLayout(configuration) {
 	let lazyDefaultsDefined = false;
 	let lazyLayoutCreated = false;
 	function defineLazyDefaults(defaults) {
-		if (lazyDefaultsDefined) throw new LayoutConfigurationError("Lazy resource defaults can only be defined once.");
-		if (lazyLayoutCreated) throw new LayoutConfigurationError("Lazy resource defaults must be defined before creating a lazy resource layout.");
+		const replacingInDevelopment = lazyDefaultsDefined && process.env.NODE_ENV !== "production";
+		if (lazyDefaultsDefined && !replacingInDevelopment) throw new LayoutConfigurationError("Lazy resource defaults can only be defined once.");
+		if (lazyLayoutCreated && !replacingInDevelopment) throw new LayoutConfigurationError("Lazy resource defaults must be defined before creating a lazy resource layout.");
 		lazyDefaults = defaults;
 		lazyDefaultsDefined = true;
 	}
@@ -54,7 +55,15 @@ function createDefinedResourceLayout(configuration) {
 		value: void 0,
 		enumerable: false
 	});
-	defineLazyDefaults.createErrorComponent = createLazyErrorComponent;
+	defineLazyDefaults.createRenderState = createLazyRenderStateBuilder({
+		resources,
+		options,
+		composables
+	});
+	defineLazyDefaults.createErrorComponent = ((render) => defineLazyDefaults.createRenderState({
+		state: "Error",
+		render
+	}));
 	const boundDefineResourceLayout = ((layout) => {
 		const localComposables = layout.composables;
 		const definition = defineBoundLayout({
@@ -94,7 +103,7 @@ function createDefinedResourceLayout(configuration) {
 				}
 				return module;
 			}
-		}, lazyDefaults, lazyInspection.hooks);
+		}, () => lazyDefaults, lazyInspection.hooks);
 	};
 	return inspection.attach({
 		createRenderState: createRenderStateBuilder({

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

@@ -1 +1 @@
-{"version":3,"file":"create-defined-resource-layout.mjs","names":[],"sources":["../../src/create-config/create-defined-resource-layout.ts"],"sourcesContent":["import { inspectLazy } from '../lazy/inspection';\nimport type { ResourcePath } from '../resource';\nimport { createLazyErrorComponent } from '../lazy/create-error-component';\nimport { lazyDefaultsSymbol, type CreateLazyErrorComponent } from '../lazy/types';\nimport type { LazyResourceError } from '../errors/lazy-resource-error';\nimport {\n  getLayoutDebug,\n  layoutDebug,\n  createInspectionStore,\n  layoutInspection,\n  getInspectionSource,\n} from '@jfdevelops/react-layout-devtools-core';\nimport { mergeLayoutProps } from './merge-layout-props';\nimport type { LayoutNameInput } from './layout-name';\nimport type { MergeContract } from './define-layout';\nimport type {\n  ComposableComponents,\n  CreateLayoutComposable,\n} from '@jfdevelops/react-layout-composables';\nimport { LayoutConfigurationError } from '../errors';\nimport type { InPropsDefinition, InPropsObject } from '../props';\nimport type { LayoutResourceKey, ResourceDefinition } from '../resource';\nimport {\n  type CreateViewMapFunctionRenderOptions,\n  type DefinedResourceLayout,\n  defineResourceLayout,\n  type LayoutIncludeProps,\n  type LayoutResourcesAccessor,\n  type CreateViewMapRenderStatesOptions,\n  type DefinedResourceLayoutFromStates,\n  createLayoutResourcesAccessor,\n} from './define-layout';\nimport {\n  createLazyResourceLayout,\n  type LazyResourceLayoutOptions,\n  type LazyResourceStates,\n} from './lazy-resource-layout';\nimport {\n  createRenderStateBuilder,\n  type CreateRenderState,\n  type RenderStateReferences,\n  type LayoutComposablesDefinition,\n} from './render-state';\n\n/** A resource tuple with at least one entry, preserving literal and nested paths. */\nexport type NonEmptyResources = readonly [\n  ResourceDefinition,\n  ...ResourceDefinition[]\n];\n\n/** Configuration shared by every layout created from one defined-layout factory. */\nexport type CreateDefinedResourceLayoutOptions<\n  Resources extends NonEmptyResources,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  DefaultNamespace extends boolean = false,\n  SharedInclude extends LayoutIncludeProps<\n    Resources,\n    Options,\n    Composables\n  > = {},\n  SharedCustom extends InPropsObject = {},\n  DefaultNaming extends\n    | LayoutNameInput<LayoutResourceKey<Resources>>\n    | undefined = undefined\n> = {\n  namespace?: DefaultNamespace;\n  /** Default naming convention; explicit definition and component names override it. */\n  name?: DefaultNaming;\n  /** Shared prop contracts, merged by key with layout and state contracts. */\n  props?: {\n    include?: LayoutIncludeProps<Resources, Options, Composables> & SharedInclude;\n    custom?: SharedCustom;\n  };\n  /** Resources supported by every layout created from this factory. */\n  resources: Resources;\n  /** Props that render states can opt into through `props.include`. */\n  options?: Options;\n  /** Layout-wide composables available to every render state. */\n  composables?: LayoutComposablesDefinition<Resources, Composables>;\n};\n\n/** The flat layout definition accepted after shared configuration is bound. */\nexport type DefinedResourceLayoutInput<\n  Resources extends NonEmptyResources,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  IncludeProps extends LayoutIncludeProps<Resources, Options, Composables>,\n  CustomProps extends InPropsObject,\n  Render,\n  Namespace extends boolean = false\n> = Omit<\n  CreateViewMapFunctionRenderOptions<\n    Resources,\n    Options,\n    Composables,\n    IncludeProps,\n    CustomProps\n  >['layout'],\n  'composables' | 'render'\n> & { render: Render; namespace?: Namespace };\n\ntype BoundLayoutComposables<\n  Shared extends ComposableComponents,\n  Local extends ComposableComponents\n> = Omit<Shared, keyof Local> & Local;\n\n/** Flattens a definition's layout while preserving its namespace setting. */\ntype BoundLayoutInput<\n  Definition extends { layout: unknown; namespace?: boolean }\n> = Definition['layout'] &\n  Pick<Definition, 'namespace'> &\n  (Definition extends { name?: infer Name } ? { name?: Name } : {});\n\n/** A `defineResourceLayout` function with its shared configuration pre-bound. */\nexport type BoundDefineResourceLayout<\n  Resources extends NonEmptyResources,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  DefaultNamespace extends boolean = false,\n  SharedInclude extends LayoutIncludeProps<\n    Resources,\n    Options,\n    Composables\n  > = {},\n  SharedCustom extends InPropsObject = {},\n  DefaultNaming extends\n    | LayoutNameInput<LayoutResourceKey<Resources>>\n    | undefined = undefined\n> = {\n  /**\n   * Defines a layout whose `render` map contains the required `default` state\n   * and any built-in or custom compound component states.\n   * Keep this overload first so incomplete render objects suggest state keys.\n   * Use `createRenderState` for state-local `composables(create)` callbacks;\n   * the helper infers their render context independently of the enclosing map.\n   */\n  <\n    const Render extends { default: unknown } & Record<string, unknown>,\n    LocalComposables extends ComposableComponents = {},\n    Namespace extends boolean = DefaultNamespace,\n    const IncludeProps extends LayoutIncludeProps<\n      Resources,\n      Options,\n      BoundLayoutComposables<Composables, LocalComposables>\n    > = {},\n    CustomProps extends InPropsObject = {},\n    const Naming extends\n      | LayoutNameInput<\n          LayoutResourceKey<Resources>,\n          ('default' | keyof Render) & string\n        >\n      | undefined = DefaultNaming\n  >(\n    layout: Omit<\n      BoundLayoutInput<\n        CreateViewMapRenderStatesOptions<\n          Resources,\n          Options,\n          BoundLayoutComposables<Composables, LocalComposables>,\n          MergeContract<SharedInclude, IncludeProps>,\n          MergeContract<SharedCustom, CustomProps>,\n          Render,\n          Namespace\n        >\n      >,\n      'composables' | 'name' | 'props'\n    > & {\n      name?: Naming;\n      props?: {\n        include?: LayoutIncludeProps<\n          Resources,\n          Options,\n          BoundLayoutComposables<Composables, LocalComposables>\n        > & IncludeProps;\n        custom?: CustomProps;\n      };\n      composables?: (\n        create: CreateLayoutComposable<LayoutResourceKey<Resources>>,\n        states: RenderStateReferences<Resources, Options, Composables, Render>\n      ) => LocalComposables;\n    }\n  ): DefinedResourceLayoutFromStates<\n    Resources,\n    Options,\n    BoundLayoutComposables<Composables, LocalComposables>,\n    Render,\n    Namespace,\n    MergeContract<SharedInclude, IncludeProps>,\n    MergeContract<SharedCustom, CustomProps>,\n    Naming\n  >;\n  /** Defines a layout whose `render` value is a single default-state callback. */\n  <\n    const IncludeProps extends LayoutIncludeProps<\n      Resources,\n      Options,\n      BoundLayoutComposables<Composables, LocalComposables>\n    > = {},\n    CustomProps extends InPropsObject = {},\n    LocalComposables extends ComposableComponents = {},\n    Namespace extends boolean = DefaultNamespace,\n    const Naming extends\n      | LayoutNameInput<LayoutResourceKey<Resources>, 'default'>\n      | undefined = DefaultNaming\n  >(\n    layout: Omit<\n      BoundLayoutInput<\n        CreateViewMapFunctionRenderOptions<\n          Resources,\n          Options,\n          BoundLayoutComposables<Composables, LocalComposables>,\n          MergeContract<SharedInclude, IncludeProps>,\n          MergeContract<SharedCustom, CustomProps>,\n          Namespace\n        >\n      >,\n      'composables' | 'name' | 'props'\n    > & {\n      name?: Naming;\n      props?: {\n        include?: LayoutIncludeProps<\n          Resources,\n          Options,\n          BoundLayoutComposables<Composables, LocalComposables>\n        > & IncludeProps;\n        custom?: CustomProps;\n      };\n      composables?: (\n        create: CreateLayoutComposable<LayoutResourceKey<Resources>>,\n        states: {}\n      ) => LocalComposables;\n    }\n  ): DefinedResourceLayout<\n    Resources,\n    Options,\n    BoundLayoutComposables<Composables, LocalComposables>,\n    MergeContract<SharedInclude, IncludeProps>,\n    MergeContract<SharedCustom, CustomProps>,\n    {},\n    Namespace,\n    Naming\n  >;\n  /**\n   * Creates a lazy proxy for the single library-defined component exported by\n   * a resource module.\n   *\n   * @param options - Resource path and named-module import callback.\n   */\n  lazy<Module extends Record<string, unknown>>(\n    options: LazyResourceLayoutOptions<Resources, Module>\n  ): ReturnType<typeof createLazyResourceLayout<Resources, Module>>;\n};\n\n/** Registers loading and module-error components used by lazy layouts. */\nexport type DefineLazyDefaults<Resource = string> = {\n  /**\n   * Sets defaults once, before the factory creates its first lazy layout.\n   *\n   * @param defaults - Shared components for pending module loads and failures.\n   */\n  (defaults: LazyResourceStates<Resource>): void;\n  readonly errors: LazyResourceError;\n  createErrorComponent: CreateLazyErrorComponent<Resource>;\n};\n\n/** Reusable helpers produced by {@link createDefinedResourceLayout}. */\nexport type CreateDefinedResourceLayoutResult<\n  Resources extends NonEmptyResources,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  DefaultNamespace extends boolean = false,\n  SharedInclude extends LayoutIncludeProps<\n    Resources,\n    Options,\n    Composables\n  > = {},\n  SharedCustom extends InPropsObject = {},\n  DefaultNaming extends\n    | LayoutNameInput<LayoutResourceKey<Resources>>\n    | undefined = undefined\n> = {\n  /** Creates eager, deferred, or separately imported render-state fragments. */\n  createRenderState: CreateRenderState<\n    Resources,\n    Options,\n    Composables,\n    SharedInclude,\n    SharedCustom\n  >;\n  /** Sets the shared loading and module-error UI used by lazy layouts. */\n  defineLazyDefaults: DefineLazyDefaults<ResourcePath<Resources>>;\n  /** Defines a layout using the resources, options, and composables already bound. */\n  defineResourceLayout: BoundDefineResourceLayout<\n    Resources,\n    Options,\n    Composables,\n    DefaultNamespace,\n    SharedInclude,\n    SharedCustom,\n    DefaultNaming\n  >;\n  /** Reads, selects, or validates the resources bound to this factory. */\n  resources: LayoutResourcesAccessor<Resources>;\n};\n\n/**\n * A configuration that may omit its name cannot guarantee a naming default.\n */\ntype DefinedFactoryNaming<Naming> = undefined extends Naming ? undefined : Naming;\n\n/**\n * Creates type-linked layout helpers from one shared configuration. The returned\n * `defineResourceLayout` accepts the layout directly, while `createRenderState`\n * carries the same resource and option types across file boundaries.\n *\n * @param configuration - Resources and optional shared props/composables to\n * bind to every returned helper.\n * @returns Helpers that share the configuration's inferred literal types.\n *\n * @example\n * ```tsx\n * const { createRenderState, defineResourceLayout } =\n *   createDefinedResourceLayout({\n *     resources: ['users'],\n *     options: { title: createProp.string() },\n *   });\n *\n * const Loading = createRenderState({\n *   state: 'Loading',\n *   props: { include: { title: true } },\n *   render: ({ title }) => <p>Loading {title}</p>,\n * });\n *\n * export const usersLayout = defineResourceLayout({\n *   render: { default: () => <Users />, ...Loading },\n * });\n * ```\n */\nexport function createDefinedResourceLayout<\n  const Resources extends NonEmptyResources,\n  const Options extends InPropsDefinition<Resources> = {},\n  Composables extends ComposableComponents = {},\n  DefaultNamespace extends boolean = false,\n  const SharedInclude extends object = {},\n  const SharedCustom extends InPropsObject = {},\n  const DefaultNaming extends\n    | LayoutNameInput<LayoutResourceKey<Resources>>\n    | undefined = LayoutNameInput<LayoutResourceKey<Resources>> | undefined\n>(\n  configuration: CreateDefinedResourceLayoutOptions<\n    Resources,\n    Options,\n    Composables,\n    DefaultNamespace,\n    SharedInclude,\n    SharedCustom,\n    DefaultNaming\n  >\n): CreateDefinedResourceLayoutResult<\n  Resources,\n  Options,\n  Composables,\n  DefaultNamespace,\n  SharedInclude,\n  SharedCustom,\n  DefinedFactoryNaming<DefaultNaming>\n> {\n  const { resources, options = {} as Options, composables } = configuration;\n  const defineBoundLayout = defineResourceLayout.forResources(...resources);\n  const inspection = createInspectionStore();\n  let lazyDefaults: LazyResourceStates<ResourcePath<Resources>> = {};\n  let lazyDefaultsDefined = false;\n  let lazyLayoutCreated = false;\n\n  function defineLazyDefaults(\n    defaults: LazyResourceStates<ResourcePath<Resources>>\n  ): void {\n    if (lazyDefaultsDefined) {\n      throw new LayoutConfigurationError(\n        'Lazy resource defaults can only be defined once.'\n      );\n    }\n\n    if (lazyLayoutCreated) {\n      throw new LayoutConfigurationError(\n        'Lazy resource defaults must be defined before creating a lazy resource layout.'\n      );\n    }\n\n    lazyDefaults = defaults;\n\n    lazyDefaultsDefined = true;\n  }\n\n  Object.defineProperty(defineLazyDefaults, 'errors', {\n    value: undefined,\n    enumerable: false,\n  });\n  defineLazyDefaults.createErrorComponent = createLazyErrorComponent as CreateLazyErrorComponent<ResourcePath<Resources>>;\n\n  const boundDefineResourceLayout = ((layout: Record<string, unknown>) => {\n    const localComposables = layout.composables as\n      | LayoutComposablesDefinition<Resources, ComposableComponents>\n      | undefined;\n    const definition = defineBoundLayout({\n      [lazyDefaultsSymbol]: () => lazyDefaults,\n      [layoutDebug]: getLayoutDebug(layout) ?? getLayoutDebug(configuration),\n      options,\n      name: layout.name ?? configuration.name,\n      namespace: layout.namespace ?? configuration.namespace,\n      layout: {\n        ...layout,\n        props: mergeLayoutProps(\n          configuration.props,\n          layout.props as { include?: object; custom?: object }\n        ),\n        composables:\n          composables || localComposables\n            ? (\n                create: CreateLayoutComposable<LayoutResourceKey<Resources>>,\n                states: {}\n              ) => ({\n                ...composables?.(create, states),\n                ...localComposables?.(create, states),\n              })\n            : undefined,\n      },\n    } as never);\n\n    inspection.connect(definition);\n\n    return definition;\n  }) as unknown as BoundDefineResourceLayout<\n    Resources,\n    Options,\n    Composables,\n    DefaultNamespace,\n    SharedInclude,\n    SharedCustom,\n    DefinedFactoryNaming<DefaultNaming>\n  >;\n\n  boundDefineResourceLayout.lazy = <Module extends Record<string, unknown>>(\n    lazyOptions: LazyResourceLayoutOptions<Resources, Module>\n  ): ReturnType<typeof createLazyResourceLayout<Resources, Module>> => {\n    lazyLayoutCreated = true;\n\n    const label = (lazyOptions as unknown as { resource: string }).resource;\n    const lazyInspection = inspectLazy(label, inspection);\n    const id = lazyInspection.id;\n\n    return createLazyResourceLayout(\n      {\n        ...lazyOptions,\n        load: async () => {\n          const module: Record<string, unknown> = await lazyOptions.load();\n\n          for (const entry of Object.values(module)) {\n            const component =\n              entry && typeof entry === 'object' && 'Root' in entry\n                ? entry.Root\n                : entry;\n\n            if (\n              ((typeof component === 'object' && component !== null) ||\n                typeof component === 'function') &&\n              layoutInspection in component\n            ) {\n              inspection.connect(component);\n\n              const target = getInspectionSource(component)\n                .getSnapshot()\n                .nodes.find(\n                  (n) =>\n                    n.kind === 'layout' &&\n                    n.label ===\n                      (component as { displayName?: string }).displayName\n                );\n\n              if (target) inspection.edge(id, target.id, 'references');\n            }\n          }\n\n          return module as Module;\n        },\n      },\n      lazyDefaults,\n      lazyInspection.hooks\n    );\n  };\n\n  return inspection.attach({\n    createRenderState: createRenderStateBuilder(\n      {\n        props: configuration.props,\n        composables,\n        options,\n        resources,\n      },\n      {\n        store: inspection,\n        defaults: () => lazyDefaults as LazyResourceStates,\n        onLazy: () => {\n          lazyLayoutCreated = true;\n        },\n      }\n    ),\n    defineLazyDefaults: defineLazyDefaults as DefineLazyDefaults<\n      ResourcePath<Resources>\n    >,\n    defineResourceLayout: boundDefineResourceLayout,\n    resources: createLayoutResourcesAccessor(resources),\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmVA,SAAgB,4BAWd,eAiBA;CACA,MAAM,EAAE,WAAW,UAAU,CAAC,GAAc,gBAAgB;CAC5D,MAAM,oBAAoB,qBAAqB,aAAa,GAAG,SAAS;CACxE,MAAM,aAAa,sBAAsB;CACzC,IAAI,eAA4D,CAAC;CACjE,IAAI,sBAAsB;CAC1B,IAAI,oBAAoB;CAExB,SAAS,mBACP,UACM;EACN,IAAI,qBACF,MAAM,IAAI,yBACR,kDACF;EAGF,IAAI,mBACF,MAAM,IAAI,yBACR,gFACF;EAGF,eAAe;EAEf,sBAAsB;CACxB;CAEA,OAAO,eAAe,oBAAoB,UAAU;EAClD,OAAO;EACP,YAAY;CACd,CAAC;CACD,mBAAmB,uBAAuB;CAE1C,MAAM,8BAA8B,WAAoC;EACtE,MAAM,mBAAmB,OAAO;EAGhC,MAAM,aAAa,kBAAkB;IAClC,2BAA2B;IAC3B,cAAc,eAAe,MAAM,KAAK,eAAe,aAAa;GACrE;GACA,MAAM,OAAO,QAAQ,cAAc;GACnC,WAAW,OAAO,aAAa,cAAc;GAC7C,QAAQ;IACN,GAAG;IACH,OAAO,iBACL,cAAc,OACd,OAAO,KACT;IACA,aACE,eAAe,oBAET,QACA,YACI;KACJ,GAAG,cAAc,QAAQ,MAAM;KAC/B,GAAG,mBAAmB,QAAQ,MAAM;IACtC,KACA;GACR;EACF,CAAU;EAEV,WAAW,QAAQ,UAAU;EAE7B,OAAO;CACT;CAUA,0BAA0B,QACxB,gBACmE;EACnE,oBAAoB;EAEpB,MAAM,QAAS,YAAgD;EAC/D,MAAM,iBAAiB,YAAY,OAAO,UAAU;EACpD,MAAM,KAAK,eAAe;EAE1B,OAAO,yBACL;GACE,GAAG;GACH,MAAM,YAAY;IAChB,MAAM,SAAkC,MAAM,YAAY,KAAK;IAE/D,KAAK,MAAM,SAAS,OAAO,OAAO,MAAM,GAAG;KACzC,MAAM,YACJ,SAAS,OAAO,UAAU,YAAY,UAAU,QAC5C,MAAM,OACN;KAEN,KACI,OAAO,cAAc,YAAY,cAAc,QAC/C,OAAO,cAAc,eACvB,oBAAoB,WACpB;MACA,WAAW,QAAQ,SAAS;MAE5B,MAAM,SAAS,oBAAoB,SAAS,EACzC,YAAY,EACZ,MAAM,MACJ,MACC,EAAE,SAAS,YACX,EAAE,UACC,UAAuC,WAC9C;MAEF,IAAI,QAAQ,WAAW,KAAK,IAAI,OAAO,IAAI,YAAY;KACzD;IACF;IAEA,OAAO;GACT;EACF,GACA,cACA,eAAe,KACjB;CACF;CAEA,OAAO,WAAW,OAAO;EACvB,mBAAmB,yBACjB;GACE,OAAO,cAAc;GACrB;GACA;GACA;EACF,GACA;GACE,OAAO;GACP,gBAAgB;GAChB,cAAc;IACZ,oBAAoB;GACtB;EACF,CACF;EACoB;EAGpB,sBAAsB;EACtB,WAAW,8BAA8B,SAAS;CACpD,CAAC;AACH"}
+{"version":3,"file":"create-defined-resource-layout.mjs","names":[],"sources":["../../src/create-config/create-defined-resource-layout.ts"],"sourcesContent":["import { inspectLazy } from '../lazy/inspection';\nimport type { ResourcePath } from '../resource';\nimport { createLazyRenderStateBuilder, type CreateLazyRenderState, type CreateBoundLazyErrorComponent } from '../lazy/create-render-state';\nimport { lazyDefaultsSymbol } from '../lazy/types';\nimport type { LazyResourceError } from '../errors/lazy-resource-error';\nimport {\n  getLayoutDebug,\n  layoutDebug,\n  createInspectionStore,\n  layoutInspection,\n  getInspectionSource,\n} from '@jfdevelops/react-layout-devtools-core';\nimport { mergeLayoutProps } from './merge-layout-props';\nimport type { LayoutNameInput } from './layout-name';\nimport type { MergeContract } from './define-layout';\nimport type {\n  ComposableComponents,\n  CreateLayoutComposable,\n} from '@jfdevelops/react-layout-composables';\nimport { LayoutConfigurationError } from '../errors';\nimport type { InPropsDefinition, InPropsObject } from '../props';\nimport type { LayoutResourceKey, ResourceDefinition } from '../resource';\nimport {\n  type CreateViewMapFunctionRenderOptions,\n  type DefinedResourceLayout,\n  defineResourceLayout,\n  type LayoutIncludeProps,\n  type LayoutResourcesAccessor,\n  type CreateViewMapRenderStatesOptions,\n  type DefinedResourceLayoutFromStates,\n  createLayoutResourcesAccessor,\n} from './define-layout';\nimport {\n  createLazyResourceLayout,\n  type LazyResourceLayoutOptions,\n  type LazyResourceStates,\n} from './lazy-resource-layout';\nimport {\n  createRenderStateBuilder,\n  type CreateRenderState,\n  type RenderStateContext,\n  type RenderStateReferences,\n  type LayoutComposablesDefinition,\n} from './render-state';\n\n/** A resource tuple with at least one entry, preserving literal and nested paths. */\nexport type NonEmptyResources = readonly [\n  ResourceDefinition,\n  ...ResourceDefinition[]\n];\n\n/** Configuration shared by every layout created from one defined-layout factory. */\nexport type CreateDefinedResourceLayoutOptions<\n  Resources extends NonEmptyResources,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  DefaultNamespace extends boolean = false,\n  SharedInclude extends LayoutIncludeProps<\n    Resources,\n    Options,\n    Composables\n  > = {},\n  SharedCustom extends InPropsObject = {},\n  DefaultNaming extends\n    | LayoutNameInput<LayoutResourceKey<Resources>>\n    | undefined = undefined\n> = {\n  namespace?: DefaultNamespace;\n  /** Default naming convention; explicit definition and component names override it. */\n  name?: DefaultNaming;\n  /** Shared prop contracts, merged by key with layout and state contracts. */\n  props?: {\n    include?: LayoutIncludeProps<Resources, Options, Composables> & SharedInclude;\n    custom?: SharedCustom;\n  };\n  /** Resources supported by every layout created from this factory. */\n  resources: Resources;\n  /** Props that render states can opt into through `props.include`. */\n  options?: Options;\n  /** Layout-wide composables available to every render state. */\n  composables?: LayoutComposablesDefinition<Resources, Composables>;\n};\n\n/** The flat layout definition accepted after shared configuration is bound. */\nexport type DefinedResourceLayoutInput<\n  Resources extends NonEmptyResources,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  IncludeProps extends LayoutIncludeProps<Resources, Options, Composables>,\n  CustomProps extends InPropsObject,\n  Render,\n  Namespace extends boolean = false\n> = Omit<\n  CreateViewMapFunctionRenderOptions<\n    Resources,\n    Options,\n    Composables,\n    IncludeProps,\n    CustomProps\n  >['layout'],\n  'composables' | 'render'\n> & { render: Render; namespace?: Namespace };\n\ntype BoundLayoutComposables<\n  Shared extends ComposableComponents,\n  Local extends ComposableComponents\n> = Omit<Shared, keyof Local> & Local;\n\n/** Flattens a definition's layout while preserving its namespace setting. */\ntype BoundLayoutInput<\n  Definition extends { layout: unknown; namespace?: boolean }\n> = Definition['layout'] &\n  Pick<Definition, 'namespace'> &\n  (Definition extends { name?: infer Name } ? { name?: Name } : {});\n\n/** A `defineResourceLayout` function with its shared configuration pre-bound. */\nexport type BoundDefineResourceLayout<\n  Resources extends NonEmptyResources,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  DefaultNamespace extends boolean = false,\n  SharedInclude extends LayoutIncludeProps<\n    Resources,\n    Options,\n    Composables\n  > = {},\n  SharedCustom extends InPropsObject = {},\n  DefaultNaming extends\n    | LayoutNameInput<LayoutResourceKey<Resources>>\n    | undefined = undefined\n> = {\n  /**\n   * Defines a layout whose `render` map contains the required `default` state\n   * and any built-in or custom compound component states.\n   * Keep this overload first so incomplete render objects suggest state keys.\n   * Use `createRenderState` for state-local `composables(create)` callbacks;\n   * the helper infers their render context independently of the enclosing map.\n   */\n  <\n    const Render extends { default: unknown } & Record<string, unknown>,\n    LocalComposables extends ComposableComponents = {},\n    Namespace extends boolean = DefaultNamespace,\n    const IncludeProps extends LayoutIncludeProps<\n      Resources,\n      Options,\n      BoundLayoutComposables<Composables, LocalComposables>\n    > = {},\n    CustomProps extends InPropsObject = {},\n    const Naming extends\n      | LayoutNameInput<\n          LayoutResourceKey<Resources>,\n          ('default' | keyof Render) & string\n        >\n      | undefined = DefaultNaming\n  >(\n    layout: Omit<\n      BoundLayoutInput<\n        CreateViewMapRenderStatesOptions<\n          Resources,\n          Options,\n          BoundLayoutComposables<Composables, LocalComposables>,\n          MergeContract<SharedInclude, IncludeProps>,\n          MergeContract<SharedCustom, CustomProps>,\n          Render,\n          Namespace\n        >\n      >,\n      'composables' | 'name' | 'props'\n    > & {\n      name?: Naming;\n      props?: {\n        include?: LayoutIncludeProps<\n          Resources,\n          Options,\n          BoundLayoutComposables<Composables, LocalComposables>\n        > & IncludeProps;\n        custom?: CustomProps;\n      };\n      composables?: (\n        create: CreateLayoutComposable<LayoutResourceKey<Resources>>,\n        states: RenderStateReferences<Resources, Options, Composables, Render>\n      ) => LocalComposables;\n    }\n  ): DefinedResourceLayoutFromStates<\n    Resources,\n    Options,\n    BoundLayoutComposables<Composables, LocalComposables>,\n    Render,\n    Namespace,\n    MergeContract<SharedInclude, IncludeProps>,\n    MergeContract<SharedCustom, CustomProps>,\n    Naming\n  >;\n  /** Defines a layout whose `render` value is a single default-state callback. */\n  <\n    const IncludeProps extends LayoutIncludeProps<\n      Resources,\n      Options,\n      BoundLayoutComposables<Composables, LocalComposables>\n    > = {},\n    CustomProps extends InPropsObject = {},\n    LocalComposables extends ComposableComponents = {},\n    Namespace extends boolean = DefaultNamespace,\n    const Naming extends\n      | LayoutNameInput<LayoutResourceKey<Resources>, 'default'>\n      | undefined = DefaultNaming\n  >(\n    layout: Omit<\n      BoundLayoutInput<\n        CreateViewMapFunctionRenderOptions<\n          Resources,\n          Options,\n          BoundLayoutComposables<Composables, LocalComposables>,\n          MergeContract<SharedInclude, IncludeProps>,\n          MergeContract<SharedCustom, CustomProps>,\n          Namespace\n        >\n      >,\n      'composables' | 'name' | 'props'\n    > & {\n      name?: Naming;\n      props?: {\n        include?: LayoutIncludeProps<\n          Resources,\n          Options,\n          BoundLayoutComposables<Composables, LocalComposables>\n        > & IncludeProps;\n        custom?: CustomProps;\n      };\n      composables?: (\n        create: CreateLayoutComposable<LayoutResourceKey<Resources>>,\n        states: {}\n      ) => LocalComposables;\n    }\n  ): DefinedResourceLayout<\n    Resources,\n    Options,\n    BoundLayoutComposables<Composables, LocalComposables>,\n    MergeContract<SharedInclude, IncludeProps>,\n    MergeContract<SharedCustom, CustomProps>,\n    {},\n    Namespace,\n    Naming\n  >;\n  /**\n   * Creates a lazy proxy for the single library-defined component exported by\n   * a resource module.\n   *\n   * @param options - Resource path and named-module import callback.\n   */\n  lazy<Module extends Record<string, unknown>>(\n    options: LazyResourceLayoutOptions<Resources, Module>\n  ): ReturnType<typeof createLazyResourceLayout<Resources, Module>>;\n};\n\n/** Registers loading and module-error components used by lazy layouts. */\nexport type DefineLazyDefaults<\n  Resource = string,\n  Resources extends ReadonlyArray<ResourceDefinition> = ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources> = {},\n  Composables extends ComposableComponents = {},\n> = {\n  /**\n   * Sets defaults before the first lazy layout. Development reloads may replace them.\n   *\n   * @param defaults - Shared components for pending module loads and failures.\n   */\n  (defaults: LazyResourceStates<Resource>): void;\n  readonly errors: LazyResourceError;\n  createRenderState: CreateLazyRenderState<Resources, Options, Composables>;\n  /** @deprecated Use createRenderState({ state: 'Error', render }) instead. */\n  createErrorComponent: CreateBoundLazyErrorComponent<Resource, RenderStateContext<Composables, Resources, 'Error'>>;\n};\n\n/** Reusable helpers produced by {@link createDefinedResourceLayout}. */\nexport type CreateDefinedResourceLayoutResult<\n  Resources extends NonEmptyResources,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  DefaultNamespace extends boolean = false,\n  SharedInclude extends LayoutIncludeProps<\n    Resources,\n    Options,\n    Composables\n  > = {},\n  SharedCustom extends InPropsObject = {},\n  DefaultNaming extends\n    | LayoutNameInput<LayoutResourceKey<Resources>>\n    | undefined = undefined\n> = {\n  /** Creates eager, deferred, or separately imported render-state fragments. */\n  createRenderState: CreateRenderState<\n    Resources,\n    Options,\n    Composables,\n    SharedInclude,\n    SharedCustom\n  >;\n  /** Sets the shared loading and module-error UI used by lazy layouts. */\n  defineLazyDefaults: DefineLazyDefaults<ResourcePath<Resources>, Resources, Options, Composables>;\n  /** Defines a layout using the resources, options, and composables already bound. */\n  defineResourceLayout: BoundDefineResourceLayout<\n    Resources,\n    Options,\n    Composables,\n    DefaultNamespace,\n    SharedInclude,\n    SharedCustom,\n    DefaultNaming\n  >;\n  /** Reads, selects, or validates the resources bound to this factory. */\n  resources: LayoutResourcesAccessor<Resources>;\n};\n\n/**\n * A configuration that may omit its name cannot guarantee a naming default.\n */\ntype DefinedFactoryNaming<Naming> = undefined extends Naming ? undefined : Naming;\n\n/**\n * Creates type-linked layout helpers from one shared configuration. The returned\n * `defineResourceLayout` accepts the layout directly, while `createRenderState`\n * carries the same resource and option types across file boundaries.\n *\n * @param configuration - Resources and optional shared props/composables to\n * bind to every returned helper.\n * @returns Helpers that share the configuration's inferred literal types.\n *\n * @example\n * ```tsx\n * const { createRenderState, defineResourceLayout } =\n *   createDefinedResourceLayout({\n *     resources: ['users'],\n *     options: { title: createProp.string() },\n *   });\n *\n * const Loading = createRenderState({\n *   state: 'Loading',\n *   props: { include: { title: true } },\n *   render: ({ title }) => <p>Loading {title}</p>,\n * });\n *\n * export const usersLayout = defineResourceLayout({\n *   render: { default: () => <Users />, ...Loading },\n * });\n * ```\n */\nexport function createDefinedResourceLayout<\n  const Resources extends NonEmptyResources,\n  const Options extends InPropsDefinition<Resources> = {},\n  Composables extends ComposableComponents = {},\n  DefaultNamespace extends boolean = false,\n  const SharedInclude extends object = {},\n  const SharedCustom extends InPropsObject = {},\n  const DefaultNaming extends\n    | LayoutNameInput<LayoutResourceKey<Resources>>\n    | undefined = LayoutNameInput<LayoutResourceKey<Resources>> | undefined\n>(\n  configuration: CreateDefinedResourceLayoutOptions<\n    Resources,\n    Options,\n    Composables,\n    DefaultNamespace,\n    SharedInclude,\n    SharedCustom,\n    DefaultNaming\n  >\n): CreateDefinedResourceLayoutResult<\n  Resources,\n  Options,\n  Composables,\n  DefaultNamespace,\n  SharedInclude,\n  SharedCustom,\n  DefinedFactoryNaming<DefaultNaming>\n> {\n  const { resources, options = {} as Options, composables } = configuration;\n  const defineBoundLayout = defineResourceLayout.forResources(...resources);\n  const inspection = createInspectionStore();\n  let lazyDefaults: LazyResourceStates<ResourcePath<Resources>> = {};\n  let lazyDefaultsDefined = false;\n  let lazyLayoutCreated = false;\n\n  function defineLazyDefaults(\n    defaults: LazyResourceStates<ResourcePath<Resources>>\n  ): void {\n    const replacingInDevelopment = lazyDefaultsDefined && process.env.NODE_ENV !== 'production';\n    if (lazyDefaultsDefined && !replacingInDevelopment) {\n      throw new LayoutConfigurationError(\n        'Lazy resource defaults can only be defined once.'\n      );\n    }\n\n    if (lazyLayoutCreated && !replacingInDevelopment) {\n      throw new LayoutConfigurationError(\n        'Lazy resource defaults must be defined before creating a lazy resource layout.'\n      );\n    }\n\n    lazyDefaults = defaults;\n\n    lazyDefaultsDefined = true;\n  }\n\n  Object.defineProperty(defineLazyDefaults, 'errors', {\n    value: undefined,\n    enumerable: false,\n  });\n  defineLazyDefaults.createRenderState = createLazyRenderStateBuilder({ resources, options, composables });\n  defineLazyDefaults.createErrorComponent = ((render: any) =>\n    defineLazyDefaults.createRenderState({ state: 'Error', render })\n  ) as CreateBoundLazyErrorComponent<ResourcePath<Resources>, RenderStateContext<Composables, Resources, 'Error'>>;\n\n  const boundDefineResourceLayout = ((layout: Record<string, unknown>) => {\n    const localComposables = layout.composables as\n      | LayoutComposablesDefinition<Resources, ComposableComponents>\n      | undefined;\n    const definition = defineBoundLayout({\n      [lazyDefaultsSymbol]: () => lazyDefaults,\n      [layoutDebug]: getLayoutDebug(layout) ?? getLayoutDebug(configuration),\n      options,\n      name: layout.name ?? configuration.name,\n      namespace: layout.namespace ?? configuration.namespace,\n      layout: {\n        ...layout,\n        props: mergeLayoutProps(\n          configuration.props,\n          layout.props as { include?: object; custom?: object }\n        ),\n        composables:\n          composables || localComposables\n            ? (\n                create: CreateLayoutComposable<LayoutResourceKey<Resources>>,\n                states: {}\n              ) => ({\n                ...composables?.(create, states),\n                ...localComposables?.(create, states),\n              })\n            : undefined,\n      },\n    } as never);\n\n    inspection.connect(definition);\n\n    return definition;\n  }) as unknown as BoundDefineResourceLayout<\n    Resources,\n    Options,\n    Composables,\n    DefaultNamespace,\n    SharedInclude,\n    SharedCustom,\n    DefinedFactoryNaming<DefaultNaming>\n  >;\n\n  boundDefineResourceLayout.lazy = <Module extends Record<string, unknown>>(\n    lazyOptions: LazyResourceLayoutOptions<Resources, Module>\n  ): ReturnType<typeof createLazyResourceLayout<Resources, Module>> => {\n    lazyLayoutCreated = true;\n\n    const label = (lazyOptions as unknown as { resource: string }).resource;\n    const lazyInspection = inspectLazy(label, inspection);\n    const id = lazyInspection.id;\n\n    return createLazyResourceLayout(\n      {\n        ...lazyOptions,\n        load: async () => {\n          const module: Record<string, unknown> = await lazyOptions.load();\n\n          for (const entry of Object.values(module)) {\n            const component =\n              entry && typeof entry === 'object' && 'Root' in entry\n                ? entry.Root\n                : entry;\n\n            if (\n              ((typeof component === 'object' && component !== null) ||\n                typeof component === 'function') &&\n              layoutInspection in component\n            ) {\n              inspection.connect(component);\n\n              const target = getInspectionSource(component)\n                .getSnapshot()\n                .nodes.find(\n                  (n) =>\n                    n.kind === 'layout' &&\n                    n.label ===\n                      (component as { displayName?: string }).displayName\n                );\n\n              if (target) inspection.edge(id, target.id, 'references');\n            }\n          }\n\n          return module as Module;\n        },\n      },\n      () => lazyDefaults,\n      lazyInspection.hooks\n    );\n  };\n\n  return inspection.attach({\n    createRenderState: createRenderStateBuilder(\n      {\n        props: configuration.props,\n        composables,\n        options,\n        resources,\n      },\n      {\n        store: inspection,\n        defaults: () => lazyDefaults as LazyResourceStates,\n        onLazy: () => {\n          lazyLayoutCreated = true;\n        },\n      }\n    ),\n    defineLazyDefaults: defineLazyDefaults as DefineLazyDefaults<\n      ResourcePath<Resources>, Resources, Options, Composables\n    >,\n    defineResourceLayout: boundDefineResourceLayout,\n    resources: createLayoutResourcesAccessor(resources),\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2VA,SAAgB,4BAWd,eAiBA;CACA,MAAM,EAAE,WAAW,UAAU,CAAC,GAAc,gBAAgB;CAC5D,MAAM,oBAAoB,qBAAqB,aAAa,GAAG,SAAS;CACxE,MAAM,aAAa,sBAAsB;CACzC,IAAI,eAA4D,CAAC;CACjE,IAAI,sBAAsB;CAC1B,IAAI,oBAAoB;CAExB,SAAS,mBACP,UACM;EACN,MAAM,yBAAyB,uBAAuB,QAAQ,IAAI,aAAa;EAC/E,IAAI,uBAAuB,CAAC,wBAC1B,MAAM,IAAI,yBACR,kDACF;EAGF,IAAI,qBAAqB,CAAC,wBACxB,MAAM,IAAI,yBACR,gFACF;EAGF,eAAe;EAEf,sBAAsB;CACxB;CAEA,OAAO,eAAe,oBAAoB,UAAU;EAClD,OAAO;EACP,YAAY;CACd,CAAC;CACD,mBAAmB,oBAAoB,6BAA6B;EAAE;EAAW;EAAS;CAAY,CAAC;CACvG,mBAAmB,yBAAyB,WAC1C,mBAAmB,kBAAkB;EAAE,OAAO;EAAS;CAAO,CAAC;CAGjE,MAAM,8BAA8B,WAAoC;EACtE,MAAM,mBAAmB,OAAO;EAGhC,MAAM,aAAa,kBAAkB;IAClC,2BAA2B;IAC3B,cAAc,eAAe,MAAM,KAAK,eAAe,aAAa;GACrE;GACA,MAAM,OAAO,QAAQ,cAAc;GACnC,WAAW,OAAO,aAAa,cAAc;GAC7C,QAAQ;IACN,GAAG;IACH,OAAO,iBACL,cAAc,OACd,OAAO,KACT;IACA,aACE,eAAe,oBAET,QACA,YACI;KACJ,GAAG,cAAc,QAAQ,MAAM;KAC/B,GAAG,mBAAmB,QAAQ,MAAM;IACtC,KACA;GACR;EACF,CAAU;EAEV,WAAW,QAAQ,UAAU;EAE7B,OAAO;CACT;CAUA,0BAA0B,QACxB,gBACmE;EACnE,oBAAoB;EAEpB,MAAM,QAAS,YAAgD;EAC/D,MAAM,iBAAiB,YAAY,OAAO,UAAU;EACpD,MAAM,KAAK,eAAe;EAE1B,OAAO,yBACL;GACE,GAAG;GACH,MAAM,YAAY;IAChB,MAAM,SAAkC,MAAM,YAAY,KAAK;IAE/D,KAAK,MAAM,SAAS,OAAO,OAAO,MAAM,GAAG;KACzC,MAAM,YACJ,SAAS,OAAO,UAAU,YAAY,UAAU,QAC5C,MAAM,OACN;KAEN,KACI,OAAO,cAAc,YAAY,cAAc,QAC/C,OAAO,cAAc,eACvB,oBAAoB,WACpB;MACA,WAAW,QAAQ,SAAS;MAE5B,MAAM,SAAS,oBAAoB,SAAS,EACzC,YAAY,EACZ,MAAM,MACJ,MACC,EAAE,SAAS,YACX,EAAE,UACC,UAAuC,WAC9C;MAEF,IAAI,QAAQ,WAAW,KAAK,IAAI,OAAO,IAAI,YAAY;KACzD;IACF;IAEA,OAAO;GACT;EACF,SACM,cACN,eAAe,KACjB;CACF;CAEA,OAAO,WAAW,OAAO;EACvB,mBAAmB,yBACjB;GACE,OAAO,cAAc;GACrB;GACA;GACA;EACF,GACA;GACE,OAAO;GACP,gBAAgB;GAChB,cAAc;IACZ,oBAAoB;GACtB;EACF,CACF;EACoB;EAGpB,sBAAsB;EACtB,WAAW,8BAA8B,SAAS;CACpD,CAAC;AACH"}

package/dist/create-config/define-layout.cjs

@@ -1,3 +1,4 @@
+const require_render_state_context = require('./render-state-context.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');
@@ -39,7 +40,10 @@ var RenderStateBoundary = class extends react.Component {
 		this.setState({ error: void 0 });
 	};
 	render() {
-		if (this.state.error !== void 0) return this.props.fallback(this.state.error, this.retry);
+		if (this.state.error !== void 0) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_render_state_context.RenderStateFallback, {
+			state: "Error",
+			children: this.props.fallback(this.state.error, this.retry)
+		});
 		return this.props.children;
 	}
 };
@@ -124,6 +128,28 @@ function resolveLayoutOptionDefaults(defaults, options) {
 	else resolved[key] = require_utils.functionalUpdate(defaultValue, options[key]);
 	return resolved;
 }
+function optionalStateChildren(props) {
+	if (!props) return props;
+	const children = props.custom?.children;
+	const childrenInclude = props.include?.children;
+	return {
+		...props,
+		include: props.include && {
+			...props.include,
+			..."children" in props.include ? { children: typeof childrenInclude === "object" && childrenInclude !== null ? {
+				...childrenInclude,
+				required: false
+			} : childrenInclude === true || childrenInclude === "required" ? {
+				required: false,
+				suppliedVia: "config"
+			} : "optional" } : {}
+		},
+		custom: props.custom && {
+			...props.custom,
+			...children ? { children: children.visibility === "required" ? children.optional?.() ?? children : children } : {}
+		}
+	};
+}
 function getSynchronousRenderStateDefinition(input, fallbackProps) {
 	if (require_render_state.isLazyRenderState(input)) return;
 	if (require_render_state.isDeferredRenderState(input)) return input[require_render_state.deferredRenderStateSymbol];
@@ -143,7 +169,7 @@ function assertUnreservedResourceSlugs(resources, owner) {
 		if (typeof resource !== "string") assertUnreservedResourceSlugs(resource.subResources, slug);
 	}
 }
-function defineResourceLayoutImpl(options, inheritedStateScope, inheritedInspection) {
+function defineResourceLayoutImpl(options, inheritedStateScope, inheritedInspection, renderStateName = "default") {
 	const { options: inProps = {}, resources, layout, namespace: defaultNamespace = false } = options;
 	const getLazyDefaults = options[require_types.lazyDefaultsSymbol] ?? (() => ({}));
 	const shellId = options.shellId;
@@ -326,7 +352,8 @@ function defineResourceLayoutImpl(options, inheritedStateScope, inheritedInspect
 			composables: resolvedComposables,
 			resources: createLayoutRenderResourcesAccessor(resources, layoutContext.resource),
 			name: layoutContext.name,
-			inProps: splitInProps
+			inProps: splitInProps,
+			state: renderStateName
 		};
 		const stateComponents = {};
 		let CreatedDefaultStateComponent;
@@ -335,10 +362,22 @@ function defineResourceLayoutImpl(options, inheritedStateScope, inheritedInspect
 				if (CreatedDefaultStateComponent) return;
 				return inspectionStore.mount(activeInspection.layout, activeInspection.state, ...resourceId ? [resourceId] : []);
 			}, []);
-			if (CreatedDefaultStateComponent) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CreatedDefaultStateComponent, { ...renderProps });
-			return render(renderProps, mergedRenderContext);
+			const state = (0, react.useContext)(require_render_state_context.RenderStateNameContext);
+			if (CreatedDefaultStateComponent) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_render_state_context.ReferencedRenderStateContext.Provider, {
+				value: state,
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CreatedDefaultStateComponent, { ...renderProps })
+			});
+			return require_inspection.markInspectionRoots(render(renderProps, {
+				...mergedRenderContext,
+				state
+			}), [
+				activeInspection.layout,
+				activeInspection.state,
+				...resourceId ? [resourceId] : []
+			]);
 		}
 		function Component(props) {
+			const state = (0, react.useContext)(require_render_state_context.ReferencedRenderStateContext) ?? renderStateName;
 			const publishResource = require_shell_context.useResourceLayoutShellPublisher();
 			const fallbackOptions = (0, react.useContext)(require_fallback_props.LazyFallbackPropsContext);
 			(0, react.useLayoutEffect)(() => {
@@ -372,17 +411,23 @@ function defineResourceLayoutImpl(options, inheritedStateScope, inheritedInspect
 				...validatedProps,
 				...layoutRenderIncludedProps
 			};
-			const rendered = /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ResourceProvider, {
-				resource: layoutContext.resource,
-				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_jfdevelops_react_layout_composables.LayoutComposablePresetProvider, {
-					value: composablePresetProps,
-					children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_state_composable.StateComposableContext.Provider, {
-						value: {
-							scope: stateScope,
-							props: layoutRenderProps,
-							definitions: mergedResolvedInProps
-						},
-						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(RenderDefaultState, { renderProps: layoutRenderProps })
+			const rendered = /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_render_state_context.ReferencedRenderStateContext.Provider, {
+				value: void 0,
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_render_state_context.RenderStateNameContext.Provider, {
+					value: state,
+					children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ResourceProvider, {
+						resource: layoutContext.resource,
+						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_jfdevelops_react_layout_composables.LayoutComposablePresetProvider, {
+							value: composablePresetProps,
+							children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_state_composable.StateComposableContext.Provider, {
+								value: {
+									scope: stateScope,
+									props: layoutRenderProps,
+									definitions: mergedResolvedInProps
+								},
+								children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(RenderDefaultState, { renderProps: layoutRenderProps })
+							})
+						})
 					})
 				})
 			});
@@ -449,7 +494,10 @@ function defineResourceLayoutImpl(options, inheritedStateScope, inheritedInspect
 				const LoadingComponent = fallbackStateName === "Loading" ? void 0 : stateComponents.Loading;
 				const ErrorComponent = fallbackStateName === "Error" ? void 0 : stateComponents.Error;
 				const rendered = /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react.Suspense, {
-					fallback: LoadingComponent ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(LoadingComponent, {}) : null,
+					fallback: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_render_state_context.RenderStateFallback, {
+						state: "Loading",
+						children: LoadingComponent ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(LoadingComponent, {}) : null
+					}),
 					children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(DeferredState, { ...props })
 				});
 				return ErrorComponent ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(RenderStateBoundary, {
@@ -481,22 +529,22 @@ function defineResourceLayoutImpl(options, inheritedStateScope, inheritedInspect
 				...composables?.(create, stateScope.states) ?? {},
 				...definition.composables?.(create, stateScope.states)
 			}) : void 0;
-			const stateRender = stateName === "Error" ? (props, context) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(RenderStateRetryContext.Consumer, { children: (retry) => definition.render(props, {
+			const stateRender = stateName === "Error" ? (props, context) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(RenderStateRetryContext.Consumer, { children: (retry) => require_inspection.markInspectionRoots(definition.render(props, {
 				...context,
 				retry
-			}) }) : definition.render;
+			}), [activeInspection.layout, ...inspectedState ? [inspectedState] : []]) }) : definition.render;
 			const StateComponent = defineResourceLayoutImpl({
 				resources,
 				options: inProps,
 				layout: {
 					composables: stateComposables,
-					props: require_merge_layout_props.mergeLayoutProps(legacyLayoutProps, definition.props),
+					props: optionalStateChildren(require_merge_layout_props.mergeLayoutProps(legacyLayoutProps, definition.props)),
 					render: stateRender
 				}
 			}, stateScope, {
 				...activeInspection,
 				state: inspectedState ?? getReferenceStateId(definition, stateName)
-			}).createResourceLayout({
+			}, stateName).createResourceLayout({
 				...layoutOptions,
 				name,
 				namespace: false