@jfdevelops/react-layout 0.22.0 → 0.23.0

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

@@ -1,7 +1,9 @@
+const require_invalid_config = require('../errors/invalid-config.cjs');
+const require_missing_resource_provider = require('../errors/missing-resource-provider.cjs');
+const require_layout_configuration_error = require('../errors/layout-configuration-error.cjs');
 const require_resource = require('../resource.cjs');
 const require_utils = require('../utils.cjs');
 const require_capitalize = require('../utils/capitalize.cjs');
-const require_invalid_config = require('../errors/invalid-config.cjs');
 const require_component_keys = require('./component-keys.cjs');
 const require_get_component = require('./get-component.cjs');
 const require_create_resource_links = require('./create-resource-links.cjs');
@@ -101,6 +103,18 @@ function defineResourceLayoutImpl(options) {
 	const shellId = options.shellId;
 	assertUnreservedResourceSlugs(resources);
 	const resourcesAccessor = createLayoutResourcesAccessor(resources);
+	const ResourceContext = (0, react.createContext)(void 0);
+	function ResourceProvider({ children, resource }) {
+		return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ResourceContext.Provider, {
+			value: resource,
+			children
+		});
+	}
+	function useResource() {
+		const resource = (0, react.useContext)(ResourceContext);
+		if (resource === void 0) throw new require_missing_resource_provider.MissingResourceProviderError({});
+		return resource;
+	}
 	const normalizedResources = require_resource.normalizeResources(resources);
 	const resourcesEnum = (0, _jfdevelops_react_layout_validator.createPrimitivePropBuilder)("string").enum(require_resource.toResourceEnum(normalizedResources));
 	const definedResourceLayout = ((layoutOptions) => {
@@ -175,12 +189,16 @@ function defineResourceLayoutImpl(options) {
 				if (!(key in validatedIncludedProps)) return [];
 				return [[toLayoutRenderPropKey(key, mergedResolvedInProps[key]), validatedIncludedProps[key]]];
 			}));
-			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_jfdevelops_react_layout_composables.LayoutComposablePresetProvider, {
-				value: composablePresetProps,
-				children: render({
-					...validatedProps,
-					...layoutRenderIncludedProps
-				}, mergedRenderContext)
+			const layoutRenderProps = {
+				...validatedProps,
+				...layoutRenderIncludedProps
+			};
+			return /* @__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: render(layoutRenderProps, mergedRenderContext)
+				})
 			});
 		}
 		function createComposition(compositionOptions) {
@@ -200,7 +218,7 @@ function defineResourceLayoutImpl(options) {
 	const createTopLevelMakeComposable = () => {
 		return (options) => {
 			const layout = definedResourceLayout(options);
-			if (!("makeComposable" in layout) || typeof layout.makeComposable !== "function") throw new Error("makeComposable requires composables to be defined in the layout");
+			if (!("makeComposable" in layout) || typeof layout.makeComposable !== "function") throw new require_layout_configuration_error.LayoutConfigurationError("makeComposable requires composables to be defined in the layout");
 			return layout.makeComposable();
 		};
 	};
@@ -239,7 +257,9 @@ function defineResourceLayoutImpl(options) {
 		createResourceConfig: require_get_component.createResourceConfig,
 		createResourceLayout: Object.assign(definedResourceLayout, createResourceLayoutExtras),
 		createResourceLinks: require_create_resource_links.createResourceLinksFn(resources),
-		resources: resourcesAccessor
+		resources: resourcesAccessor,
+		ResourceProvider,
+		useResource
 	};
 }
 function defineResources(...resources) {

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

@@ -1 +1 @@
-{"version":3,"file":"define-layout.cjs","names":["createIsValidResourceFn","capitalize","functionalUpdate","isResourceConfigComponentKey","InvalidConfigError","normalizeResources","toResourceEnum","createProp","useResourceLayoutShellPublisher","pick","LayoutComposablePresetProvider","createForResource","createForResources","createResourceLinksFn","ResourceLayoutShellPublisherContext"],"sources":["../../src/create-config/define-layout.tsx"],"sourcesContent":["import {\n  type JSX,\n  type ReactNode,\n  useCallback,\n  useLayoutEffect,\n  useMemo,\n  useRef,\n  useState,\n} from 'react';\nimport {\n  type ComposableComponents,\n  type ComposableNameContext,\n  type ComposableResourceLayout,\n  type CreateLayoutComposable,\n  collectComposablePresetEntries,\n  LayoutComposablePresetProvider,\n  MakeComposable,\n  makeComposable,\n  MakeComposableOptions,\n  RequiredPresetLayoutProps,\n  resolveLayoutComposables,\n} from '@jfdevelops/react-layout-composables';\nimport {\n  type AnyBuiltPropDefinition,\n  createPrimitivePropBuilder,\n  createProp,\n  type ResolveLayoutProps,\n  type ResolveProps,\n  resolvePropDefinitionValues,\n  validateProps,\n} from '@jfdevelops/react-layout-validator';\nimport {\n  IncludedProps,\n  type IncludedPropBehavior,\n  InferredInProps,\n  InPropsDefinition,\n  InPropsObject,\n  LayoutRenderProps,\n  MergedLayoutInProps,\n  ResolvedIncludedComponentProps,\n  ResolvedIncludedConfigProps,\n  ResolvedIncludedProps,\n} from '../props';\nimport {\n  createIsValidResourceFn,\n  normalizeResources,\n  toResourceEnum,\n  type LayoutResourceKey,\n  type ResourceDefinition,\n  type ResourceDefinitionValue,\n} from '../resource';\nimport { BaseComponent, functionalUpdate, pick, Show, Updater } from '../utils';\nimport { capitalize } from '../utils/capitalize';\nimport { InvalidConfigError } from '../errors';\nimport { isResourceConfigComponentKey } from './component-keys';\nimport {\n  type CreateResourceConfigFn,\n  createResourceConfig,\n} from './get-component';\nimport type { AssertUnreservedResources } from './types';\nimport {\n  createResourceLinksFn,\n  type CreateResourceLinksFn,\n} from './create-resource-links';\nimport {\n  createForResource,\n  type CreateLayoutForResource,\n  type CreateResourceLayoutOptions,\n  type CreateResourceLayoutOptionsBase,\n} from './for-resource';\nimport {\n  createForResources,\n  type CreateResourceLayoutForResourcesFn,\n} from './for-resources';\nimport {\n  type ResourceLayoutShellPublisher,\n  ResourceLayoutShellPublisherContext,\n  useResourceLayoutShellPublisher,\n} from './shell-context';\n\nexport type LayoutIncludeProps<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n> = IncludedProps<MergedLayoutInProps<Resources, Options, Composables>>;\n\nexport type LayoutProps<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  IncludeProps extends LayoutIncludeProps<Resources, Options, Composables> = {},\n  CustomProps extends InPropsObject = {},\n> = {\n  /**\n   * Props to include in the layout.\n   */\n  include?: LayoutIncludeProps<Resources, Options, Composables> & IncludeProps;\n  /**\n   * Custom props that the layout will receive.\n   */\n  custom?: CustomProps;\n};\n\ntype LayoutRenderContext<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Composables extends ComposableComponents,\n> = {\n  composables: LayoutRenderComposables<Composables>;\n  inProps: Record<string, unknown>;\n  /**\n   * @deprecated Use `resources.current` instead. `resource` will be removed in\n   * the next major version.\n   */\n  resource: LayoutResourceKey<Resources>;\n  /**\n   * Accessor for the resources bound to this definition. Read `resources.current`\n   * for the resource this instance renders, call `resources()` for the raw\n   * value, use `resources.pick(...)` / `resources.omit(...)` to filter, or\n   * `resources.isResource(...)` to narrow an unknown value.\n   */\n  resources: LayoutRenderResourcesAccessor<Resources>;\n  name: string;\n};\n\n/**\n * A single {@link ResourceDefinition} kept by a `pick`, or `never` when it does\n * not match. Widened definitions (`string`, `{ value: string }`) are always\n * kept — the concrete keys are not known statically, so the runtime filter is\n * the source of truth.\n */\ntype PickResourceDefinition<\n  Definition,\n  Keys extends string,\n> = Definition extends ResourceDefinition\n  ? string extends ResourceDefinitionValue<Definition>\n    ? Definition\n    : ResourceDefinitionValue<Definition> extends Keys\n      ? Definition\n      : never\n  : never;\n\ntype PickResourceDefinitions<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Keys extends LayoutResourceKey<Resources>,\n> = Array<PickResourceDefinition<Resources[number], Keys>>;\n\n/**\n * A single {@link ResourceDefinition} kept by an `omit`, or `never` when it is\n * one of the omitted keys. Widened definitions are always kept.\n */\ntype OmitResourceDefinition<\n  Definition,\n  Keys extends string,\n> = Definition extends ResourceDefinition\n  ? string extends ResourceDefinitionValue<Definition>\n    ? Definition\n    : ResourceDefinitionValue<Definition> extends Keys\n      ? never\n      : Definition\n  : never;\n\ntype OmitResourceDefinitions<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Keys extends LayoutResourceKey<Resources>,\n> = Array<OmitResourceDefinition<Resources[number], Keys>>;\n\n/**\n * The result of `resources.pick(...)` / `resources.omit(...)`.\n *\n * - calling it returns the selected resource definitions.\n * - `.isResource(value)` narrows an unknown value to one of the selected keys.\n */\nexport type ResourceSelection<\n  Definitions extends ReadonlyArray<ResourceDefinition>,\n> = {\n  /** Returns the selected resource definitions. */\n  (): Show<Definitions>;\n  /**\n   * Narrows an unknown value to one of the selected resource keys.\n   *\n   * @param value - The value to test.\n   */\n  isResource(value: unknown): value is LayoutResourceKey<Definitions>;\n};\n\n/**\n * Accessor for the resources bound to a `defineResourceLayout` definition.\n *\n * - `resources()` returns the raw resources.\n * - `resources.omit(key, ...rest)` selects every resource except the named ones.\n * - `resources.pick(key, ...rest)` selects only the named resources.\n * - `resources.isResource(value)` narrows an unknown value to a resource key.\n *\n * `pick` / `omit` return a {@link ResourceSelection} thunk: call it for the\n * definitions, or use its `isResource` guard.\n */\nexport type LayoutResourcesAccessor<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = {\n  /**\n   * Returns the raw `resources` value passed to `defineResourceLayout`,\n   * exactly as declared.\n   */\n  (): Resources;\n  /**\n   * Narrows an unknown value to one of this definition's top-level resource\n   * keys.\n   *\n   * @param value - The value to test.\n   */\n  isResource(value: unknown): value is LayoutResourceKey<Resources>;\n  /**\n   * Selects every declared resource except the named ones. Requires at least\n   * one key.\n   *\n   * @param keys - Top-level resource names to exclude.\n   */\n  omit<\n    Keys extends [\n      LayoutResourceKey<Resources>,\n      ...LayoutResourceKey<Resources>[],\n    ],\n  >(\n    ...keys: Keys\n  ): ResourceSelection<OmitResourceDefinitions<Resources, Keys[number]>>;\n  /**\n   * Selects only the named resources. Requires at least one key.\n   *\n   * @param keys - Top-level resource names to keep.\n   */\n  pick<\n    Keys extends [\n      LayoutResourceKey<Resources>,\n      ...LayoutResourceKey<Resources>[],\n    ],\n  >(\n    ...keys: Keys\n  ): ResourceSelection<PickResourceDefinitions<Resources, Keys[number]>>;\n};\n\n/**\n * Render-scoped {@link LayoutResourcesAccessor}, extended with `current` — the\n * resource key the layout instance is rendering for.\n */\nexport type LayoutRenderResourcesAccessor<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = LayoutResourcesAccessor<Resources> & {\n  /** The resource this layout instance is rendering for. */\n  readonly current: LayoutResourceKey<Resources>;\n};\n\nfunction createResourceSelection(\n  definitions: ReadonlyArray<ResourceDefinition>,\n): ResourceSelection<ReadonlyArray<ResourceDefinition>> {\n  const selection = (() => definitions) as ResourceSelection<\n    ReadonlyArray<ResourceDefinition>\n  >;\n\n  selection.isResource = createIsValidResourceFn(definitions);\n\n  return selection;\n}\n\nfunction createLayoutResourcesAccessor<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n>(resources: Resources): LayoutResourcesAccessor<Resources> {\n  const accessor = (() => resources) as LayoutResourcesAccessor<Resources>;\n\n  accessor.isResource = createIsValidResourceFn(resources);\n  accessor.omit = ((...keys: string[]) =>\n    createResourceSelection(\n      resources.filter(\n        (resource) => !keys.includes(readResourceSlug(resource)),\n      ),\n    )) as LayoutResourcesAccessor<Resources>['omit'];\n  accessor.pick = ((...keys: string[]) =>\n    createResourceSelection(\n      resources.filter((resource) =>\n        keys.includes(readResourceSlug(resource)),\n      ),\n    )) as LayoutResourcesAccessor<Resources>['pick'];\n\n  return accessor;\n}\n\nfunction createLayoutRenderResourcesAccessor<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n>(\n  resources: Resources,\n  current: LayoutResourceKey<Resources>,\n): LayoutRenderResourcesAccessor<Resources> {\n  return Object.assign(createLayoutResourcesAccessor(resources), { current });\n}\ntype LayoutRenderComposables<Composables extends ComposableComponents> = [\n  keyof Composables,\n] extends [never]\n  ? undefined\n  : Composables;\n\ntype SplitLayoutInPropDefinition<\n  Props extends InPropsObject = {},\n  Content = unknown,\n> = {\n  props?: Props;\n  render: ((props: ResolveProps<Props>) => Content) | Content;\n};\n\nfunction isBuiltPropDefinition(\n  value: unknown,\n): value is AnyBuiltPropDefinition {\n  return typeof value === 'function' && value !== null && 'visibility' in value;\n}\n\nfunction isSplitLayoutInPropDefinition(\n  value: unknown,\n): value is SplitLayoutInPropDefinition {\n  return (\n    value !== null &&\n    typeof value === 'object' &&\n    'render' in value &&\n    (value as { render?: unknown }).render !== undefined\n  );\n}\n\nfunction isJSXElementDefinition(\n  definition: unknown,\n): definition is AnyBuiltPropDefinition & { type: 'JSX.Element' } {\n  return (\n    isBuiltPropDefinition(definition) &&\n    'type' in definition &&\n    definition.type === 'JSX.Element'\n  );\n}\n\nfunction toLayoutRenderPropKey(includeKey: string, definition: unknown) {\n  return isJSXElementDefinition(definition)\n    ? capitalize(includeKey)\n    : includeKey;\n}\n\nfunction readLayoutOptionValue(\n  includeKey: string,\n  definition: unknown,\n  sources: Record<string, unknown>,\n) {\n  const layoutOptionKeys = isJSXElementDefinition(definition)\n    ? [capitalize(includeKey), includeKey]\n    : [includeKey, capitalize(includeKey)];\n\n  for (const key of layoutOptionKeys) {\n    if (key in sources) {\n      return sources[key];\n    }\n  }\n\n  return undefined;\n}\n\nfunction getIncludedPropBehavior(value: unknown): IncludedPropBehavior | null {\n  if (\n    value !== null &&\n    typeof value === 'object' &&\n    'visibility' in value &&\n    'passthrough' in value\n  ) {\n    return value as IncludedPropBehavior;\n  }\n\n  return null;\n}\n\nfunction isIncludedPropRequired(value: unknown) {\n  return (\n    value === true ||\n    value === 'required' ||\n    getIncludedPropBehavior(value)?.visibility === 'required'\n  );\n}\n\nfunction allowsConfigPassthrough(value: unknown) {\n  const behavior = getIncludedPropBehavior(value);\n\n  if (!behavior) {\n    return true;\n  }\n\n  if (behavior.passthrough === 'config') {\n    return true;\n  }\n\n  // optional + component passthrough still accepts create-time defaults\n  return (\n    behavior.passthrough === 'component' && behavior.visibility === 'optional'\n  );\n}\n\nfunction allowsComponentPassthrough(value: unknown) {\n  const behavior = getIncludedPropBehavior(value);\n\n  return behavior ? behavior.passthrough === 'component' : value === 'optional';\n}\n\nfunction splitLayoutInProps(inProps: Record<string, unknown>) {\n  const resolvedInProps: Record<string, AnyBuiltPropDefinition> = {};\n  const splitInProps: Record<string, unknown> = {};\n\n  for (const [key, value] of Object.entries(inProps)) {\n    if (isBuiltPropDefinition(value)) {\n      resolvedInProps[key] = value;\n      continue;\n    }\n\n    if (isSplitLayoutInPropDefinition(value)) {\n      splitInProps[key] = value.render;\n\n      if (value.props && typeof value.props === 'object') {\n        Object.assign(resolvedInProps, value.props);\n      }\n    }\n  }\n\n  return {\n    resolvedInProps,\n    splitInProps,\n  };\n}\n\nfunction resolveLayoutOptionDefaults(\n  defaults: Record<string, unknown>,\n  options: Record<string, unknown>,\n) {\n  const resolved = { ...options };\n\n  for (const [key, defaultValue] of Object.entries(defaults)) {\n    if (key in options) {\n      if (typeof defaultValue === 'function') {\n        resolved[key] = options[key];\n      } else {\n        resolved[key] = functionalUpdate(\n          defaultValue,\n          options[key] as Updater<unknown>,\n        );\n      }\n    }\n  }\n\n  return resolved;\n}\n\n/**\n * The `layout` block of a {@link defineResourceLayout} call: the props, the\n * composable map, and the render for a per-resource page component.\n *\n * Extracted so {@link defineResourceLayout.withLayout} can reuse the exact same\n * shape while making `render` optional (see {@link ShellLayoutDefinition}).\n */\ntype LayoutDefinition<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  IncludeProps extends LayoutIncludeProps<Resources, Options, Composables>,\n  CustomProps extends InPropsObject,\n> = {\n  /**\n   * The props to pass to the layout.\n   */\n  props?: LayoutProps<Resources, Options, Composables, IncludeProps, CustomProps>;\n  /**\n   * Components used to compose the layout. Invoked per layout instance with\n   * a scoped `create` that resolves composable `name` callbacks using the\n   * layout's `resource` and `name`.\n   */\n  composables?: (\n    create: CreateLayoutComposable<LayoutResourceKey<Resources>>,\n  ) => Composables;\n  /**\n   * The render function for the layout.\n   */\n  render: (\n    props: LayoutRenderProps<\n      Resources,\n      Options,\n      Composables,\n      IncludeProps,\n      CustomProps\n    >,\n    context: LayoutRenderContext<Resources, Composables>,\n  ) => JSX.Element;\n};\n\ntype CreateViewMapOptions<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources> = {},\n  Composables extends ComposableComponents = {},\n  IncludeProps extends LayoutIncludeProps<Resources, Options, Composables> = {},\n  CustomProps extends InPropsObject = {},\n> = {\n  /**\n   * An array of valid resource names to support. Nested sub-resource slugs that\n   * collide with config keys (`component`, `detail`, `new`, …) are reserved.\n   */\n  resources: AssertUnreservedResources<Resources>;\n  /**\n   * The options that are passed into the created resource layout.\n   */\n  options?: Options;\n  layout: LayoutDefinition<\n    Resources,\n    Options,\n    Composables,\n    IncludeProps,\n    CustomProps\n  >;\n};\n\ntype ResourceLayoutComposition<\n  Name extends string,\n  Composables extends ComposableComponents,\n> = [keyof Composables] extends [never]\n  ? {}\n  : {\n      makeComposable: MakeComposable<Composables, Name>;\n    };\nexport type ResourceLayoutComponent<\n  Name extends string,\n  Props extends InPropsObject = {},\n  Composables extends ComposableComponents = {},\n  Resource extends string = string,\n  IncludedCallProps extends object = {},\n> = ResourceLayoutComposition<Name, Composables> &\n  BaseComponent<Name, Show<ResolveProps<Props> & IncludedCallProps>> & {\n    (props: Show<ResolveProps<Props> & IncludedCallProps>): JSX.Element;\n    /**\n     * A type-only property containing the resource associated with this\n     * component. This property is `undefined` at runtime.\n     */\n    readonly resource: Resource;\n  };\n\nexport type LayoutPropsForResource<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  InProps extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents = {},\n  IncludeProps extends LayoutIncludeProps<Resources, InProps, Composables> = {},\n> = [keyof IncludeProps] extends [never]\n  ? ResolveLayoutProps<InferredInProps<Resources, InProps>> &\n      RequiredPresetLayoutProps<Composables>\n  : ResolvedIncludedConfigProps<\n      MergedLayoutInProps<Resources, InProps, Composables>,\n      IncludeProps\n    >;\n\ntype CreateResourceLayoutFnImpl<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  InProps extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  IncludeProps extends LayoutIncludeProps<Resources, InProps, Composables> = {},\n  CustomProps extends InPropsObject = {},\n> = <\n  Name extends string,\n  Resource extends LayoutResourceKey<Resources>,\n  Props extends InPropsObject = {},\n>(\n  options: CreateResourceLayoutOptions<\n    Resources,\n    InProps,\n    Composables,\n    IncludeProps,\n    Name,\n    Resource,\n    Props\n  >,\n) => ResourceLayoutComponent<\n  Name,\n  CustomProps,\n  Composables,\n  Resource,\n  ResolvedIncludedComponentProps<\n    MergedLayoutInProps<Resources, InProps, Composables>,\n    IncludeProps\n  >\n>;\n\nexport type CreateResourceLayoutMakeComposableOptions<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  InProps extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  Name extends string,\n  Resource extends LayoutResourceKey<Resources>,\n  Props extends InPropsObject = {},\n  IncludeProps extends LayoutIncludeProps<Resources, InProps, Composables> = {},\n> = CreateResourceLayoutOptionsBase<Resources, Name, Resource, Props> &\n  Partial<\n    LayoutPropsForResource<Resources, InProps, Composables, IncludeProps>\n  >;\n\ntype CreateResourceLayoutMakeComposableFn<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  InProps extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  IncludeProps extends LayoutIncludeProps<Resources, InProps, Composables>,\n  CustomProps extends InPropsObject,\n> = <\n  Name extends string,\n  Resource extends LayoutResourceKey<Resources>,\n  Props extends InPropsObject = {},\n>(\n  options: CreateResourceLayoutMakeComposableOptions<\n    Resources,\n    InProps,\n    Composables,\n    Name,\n    Resource,\n    Props,\n    IncludeProps\n  >,\n) => ComposableResourceLayout<Composables, Name, any, any, any>;\n\ntype CreateResourceLayoutFnBase<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  InProps extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents = {},\n  IncludeProps extends LayoutIncludeProps<Resources, InProps, Composables> = {},\n  CustomProps extends InPropsObject = {},\n> = CreateResourceLayoutFnImpl<\n  Resources,\n  InProps,\n  Composables,\n  IncludeProps,\n  CustomProps\n> & {\n  /**\n   * A function to create a resource layout for a specific resource.\n   */\n  forResource: CreateLayoutForResource<\n    Resources,\n    InProps,\n    Composables,\n    IncludeProps,\n    CustomProps\n  >;\n  /**\n   * Creates resource layout factories for multiple defined resources.\n   */\n  forResources: CreateResourceLayoutForResourcesFn<\n    Resources,\n    InProps,\n    Composables,\n    IncludeProps,\n    CustomProps\n  >;\n};\n\ntype CreateResourceLayoutMakeComposableMember<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  InProps extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  IncludeProps extends LayoutIncludeProps<Resources, InProps, Composables>,\n  CustomProps extends InPropsObject,\n> = [keyof Composables] extends [never]\n  ? {}\n  : {\n      makeComposable: CreateResourceLayoutMakeComposableFn<\n        Resources,\n        InProps,\n        Composables,\n        IncludeProps,\n        CustomProps\n      >;\n    };\n\nexport type CreateResourceLayoutFn<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  InProps extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents = {},\n  IncludeProps extends LayoutIncludeProps<Resources, InProps, Composables> = {},\n  CustomProps extends InPropsObject = {},\n> = CreateResourceLayoutFnBase<\n  Resources,\n  InProps,\n  Composables,\n  IncludeProps,\n  CustomProps\n> &\n  CreateResourceLayoutMakeComposableMember<\n    Resources,\n    InProps,\n    Composables,\n    IncludeProps,\n    CustomProps\n  >;\n\ntype DefinedResourceLayout<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  InProps extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents = {},\n  IncludeProps extends LayoutIncludeProps<Resources, InProps, Composables> = {},\n  CustomProps extends InPropsObject = {},\n> = {\n  createResourceConfig: CreateResourceConfigFn<Resources>;\n  createResourceLayout: CreateResourceLayoutFn<\n    Resources,\n    InProps,\n    Composables,\n    IncludeProps,\n    CustomProps\n  >;\n  createResourceLinks: CreateResourceLinksFn<Resources>;\n  /**\n   * Accessor for the resources bound to this definition. Call `resources()` for\n   * the raw value, or `resources.pick(...)` / `resources.omit(...)` to filter.\n   */\n  resources: LayoutResourcesAccessor<Resources>;\n};\n\nfunction readResourceSlug(resource: ResourceDefinition) {\n  return typeof resource === 'string' ? resource : resource.value;\n}\n\nfunction assertUnreservedResourceSlugs(\n  resources: ReadonlyArray<ResourceDefinition>,\n  owner?: string,\n) {\n  for (const resource of resources) {\n    const slug = readResourceSlug(resource);\n\n    if (owner !== undefined && isResourceConfigComponentKey(slug)) {\n      throw new InvalidConfigError({\n        reason: `Sub-resource \"${slug}\" under \"${owner}\" collides with a reserved config key`,\n      });\n    }\n\n    if (typeof resource !== 'string') {\n      assertUnreservedResourceSlugs(resource.subResources, slug);\n    }\n  }\n}\n\nfunction defineResourceLayoutImpl<\n  const Resources extends ReadonlyArray<ResourceDefinition>,\n  InProps extends InPropsDefinition<Resources> = {},\n  Composables extends ComposableComponents = {},\n  const IncludeProps extends LayoutIncludeProps<\n    Resources,\n    InProps,\n    Composables\n  > = {},\n  CustomProps extends InPropsObject = {},\n>(\n  options: CreateViewMapOptions<\n    Resources,\n    InProps,\n    Composables,\n    IncludeProps,\n    CustomProps\n  >,\n): DefinedResourceLayout<\n  Resources,\n  InProps,\n  Composables,\n  IncludeProps,\n  CustomProps\n> {\n  const { options: inProps = {} as InProps, resources, layout } = options;\n  // Internal, set only by `defineResourceLayout.withLayout`: the identity of the\n  // owning definition, forwarded when a page reports its resource so the shell\n  // can tell its own pages apart from ones belonging to another definition.\n  const shellId = (options as { shellId?: symbol }).shellId;\n\n  assertUnreservedResourceSlugs(resources);\n\n  const resourcesAccessor = createLayoutResourcesAccessor(resources);\n  const normalizedResources = normalizeResources(resources);\n  const resourcesEnum = createPrimitivePropBuilder('string').enum(\n    toResourceEnum(normalizedResources),\n  );\n  const definedResourceLayout = (<\n    Name extends string,\n    Resource extends LayoutResourceKey<Resources>,\n    Props extends InPropsObject = {},\n  >(\n    layoutOptions: CreateResourceLayoutOptions<\n      Resources,\n      InProps,\n      Composables,\n      IncludeProps,\n      Name,\n      Resource,\n      Props\n    >,\n  ) => {\n    const {\n      name,\n      props: instancePropDefinitions,\n      ...layoutOptionProps\n    } = layoutOptions;\n    const createComposableLayout =\n      makeComposable<\n        LayoutRenderProps<\n          Resources,\n          InProps,\n          Composables,\n          IncludeProps,\n          CustomProps\n        >\n      >();\n    const nameProp = createProp.string().literal(name);\n    const rawResolvedOptions =\n      typeof inProps === 'function'\n        ? inProps({\n            resource: resourcesEnum,\n            name: nameProp,\n          })\n        : inProps;\n    const { resolvedInProps, splitInProps } = splitLayoutInProps({\n      ...(rawResolvedOptions as Record<string, unknown>),\n      ...(instancePropDefinitions as Record<string, unknown> | undefined),\n      ...layoutOptionProps,\n    });\n    const { composables, render, props: layoutProps } = layout;\n    const customLayoutProps = layoutProps?.custom;\n    const includeLayoutProps = layoutProps?.include;\n    const layoutOptionValues = layoutOptionProps as Record<string, unknown>;\n    const resolvedLayoutProps = {\n      ...customLayoutProps,\n    };\n    const layoutContext: ComposableNameContext<\n      LayoutResourceKey<Resources>,\n      typeof name\n    > = {\n      resource: layoutOptions.resource,\n      name,\n      capitalize,\n    };\n    const validationContext = {\n      layoutName: name,\n      resource: layoutContext.resource,\n    };\n    const resolvedComposables = composables\n      ? resolveLayoutComposables(composables, layoutContext)\n      : undefined;\n    const mergedResolvedInProps = { ...resolvedInProps };\n\n    for (const {\n      props: presetPropDefinitions,\n    } of collectComposablePresetEntries(resolvedComposables)) {\n      Object.assign(mergedResolvedInProps, presetPropDefinitions);\n    }\n\n    const composablePresetProps = Object.fromEntries(\n      collectComposablePresetEntries(resolvedComposables).map(\n        ({ key, props: presetPropDefinitions }) => {\n          const presetPropEntries = Object.entries(presetPropDefinitions);\n          const validatedDefinitions = Object.fromEntries(\n            presetPropEntries.filter(([propKey]) => {\n              const includeBehavior = includeLayoutProps?.[propKey];\n\n              return (\n                includeBehavior === undefined ||\n                (allowsConfigPassthrough(includeBehavior) &&\n                  (isIncludedPropRequired(includeBehavior) ||\n                    layoutOptionValues[propKey] !== undefined))\n              );\n            }),\n          );\n          const presetPropValues = Object.fromEntries(\n            presetPropEntries.flatMap(([propKey]) =>\n              propKey in layoutOptionValues\n                ? [[propKey, layoutOptionValues[propKey]]]\n                : [],\n            ),\n          );\n\n          return [\n            key,\n            validateProps(\n              validatedDefinitions as Record<string, AnyBuiltPropDefinition>,\n              presetPropValues,\n              validationContext,\n            ),\n          ];\n        },\n      ),\n    );\n    const mergedRenderContext = {\n      composables: resolvedComposables as LayoutRenderComposables<Composables>,\n      resource: layoutContext.resource,\n      resources: createLayoutRenderResourcesAccessor(\n        resources as Resources,\n        layoutContext.resource,\n      ),\n      name: layoutContext.name,\n      inProps: splitInProps,\n    } as LayoutRenderContext<Resources, Composables>;\n\n    function Component(\n      props: Show<\n        ResolveProps<CustomProps> &\n          ResolvedIncludedComponentProps<\n            MergedLayoutInProps<Resources, InProps, Composables>,\n            IncludeProps\n          >\n      >,\n    ) {\n      const publishResource = useResourceLayoutShellPublisher();\n\n      // Report the resource this page renders for so an ancestor `Shell` (from\n      // `defineResourceLayout.withLayout`) can resolve `resources.current` for\n      // its own render without the consumer threading a route param down to it.\n      // A layout effect, not a passive one, so the shell reflects the new\n      // resource in the same commit the page mounts — a passive effect would\n      // leave one painted frame of stale shell chrome mid-navigation. Degrades\n      // to a no-op when rendered without a `Shell` (context defaults to null).\n      useLayoutEffect(() => {\n        publishResource?.(layoutContext.resource, shellId);\n\n        return () => publishResource?.(undefined, shellId);\n      }, [publishResource, layoutContext.resource]);\n\n      const validatedProps = validateProps(resolvedLayoutProps, props, {\n        ...validationContext,\n      });\n      const includedPropKeys = Object.keys(includeLayoutProps ?? {});\n      const includedPropDefinitions = pick(\n        mergedResolvedInProps,\n        includedPropKeys,\n      ) as Record<string, unknown>;\n      const includedPropValues = {\n        ...resolvePropDefinitionValues(includedPropDefinitions),\n      } as Record<string, unknown>;\n\n      for (const key of includedPropKeys) {\n        const definition = mergedResolvedInProps[key];\n        const includeBehavior = includeLayoutProps?.[key];\n        const callSiteValue = allowsComponentPassthrough(includeBehavior)\n          ? readLayoutOptionValue(\n              key,\n              definition,\n              props as Record<string, unknown>,\n            )\n          : undefined;\n        const layoutOptionValue = allowsConfigPassthrough(includeBehavior)\n          ? readLayoutOptionValue(key, definition, layoutOptionValues)\n          : undefined;\n        const splitValue = key in splitInProps ? splitInProps[key] : undefined;\n        const value = callSiteValue ?? layoutOptionValue ?? splitValue;\n\n        if (value !== undefined) {\n          includedPropValues[key] = value;\n        }\n      }\n\n      const requiredIncludedPropDefinitions = Object.fromEntries(\n        Object.entries(includedPropDefinitions).filter(([key]) =>\n          isIncludedPropRequired(includeLayoutProps?.[key]),\n        ),\n      );\n      const optionalIncludedPropDefinitions = Object.fromEntries(\n        Object.entries(includedPropDefinitions).filter(\n          ([key]) =>\n            !isIncludedPropRequired(includeLayoutProps?.[key]) &&\n            includedPropValues[key] !== undefined,\n        ),\n      );\n      const validatedIncludedProps = validateProps(\n        {\n          ...requiredIncludedPropDefinitions,\n          ...optionalIncludedPropDefinitions,\n        } as Record<string, AnyBuiltPropDefinition>,\n        includedPropValues,\n        validationContext,\n      );\n      const layoutRenderIncludedProps = Object.fromEntries(\n        includedPropKeys.flatMap((key) => {\n          if (!(key in validatedIncludedProps)) {\n            return [];\n          }\n\n          return [\n            [\n              toLayoutRenderPropKey(key, mergedResolvedInProps[key]),\n              validatedIncludedProps[\n                key as keyof typeof validatedIncludedProps\n              ],\n            ],\n          ];\n        }),\n      );\n      const layoutRenderProps = {\n        ...validatedProps,\n        ...layoutRenderIncludedProps,\n      } as unknown as LayoutRenderProps<\n        Resources,\n        InProps,\n        Composables,\n        IncludeProps,\n        CustomProps\n      >;\n\n      return (\n        <LayoutComposablePresetProvider value={composablePresetProps}>\n          {render(layoutRenderProps, mergedRenderContext)}\n        </LayoutComposablePresetProvider>\n      );\n    }\n\n    function createComposition<\n      LayoutName extends string,\n      const Defined extends MakeComposableOptions<Composables, LayoutName>,\n    >(compositionOptions: Defined) {\n      if (!compositionOptions.components) {\n        return {} as ResourceLayoutComposition<LayoutName, Composables>;\n      }\n\n      return {\n        makeComposable: createComposableLayout(\n          compositionOptions,\n        ) as MakeComposable<Composables, LayoutName>,\n      };\n    }\n\n    return Object.assign(Component, {\n      displayName: name,\n      props: undefined as unknown as Show<\n        ResolveProps<CustomProps> &\n          ResolvedIncludedComponentProps<\n            MergedLayoutInProps<Resources, InProps, Composables>,\n            IncludeProps\n          >\n      >,\n      resource: undefined as unknown as Resource,\n      ...createComposition({\n        components: resolvedComposables as Composables | undefined,\n        name,\n      }),\n    });\n  }) as CreateResourceLayoutFnImpl<\n    Resources,\n    InProps,\n    Composables,\n    IncludeProps,\n    CustomProps\n  >;\n  const createTopLevelMakeComposable = () => {\n    return (options: Record<string, unknown>) => {\n      const layout = definedResourceLayout(options as never);\n\n      if (\n        !('makeComposable' in layout) ||\n        typeof layout.makeComposable !== 'function'\n      ) {\n        throw new Error(\n          'makeComposable requires composables to be defined in the layout',\n        );\n      }\n\n      return layout.makeComposable();\n    };\n  };\n\n  function getComponentPropDefinitions(resource: LayoutResourceKey<Resources>) {\n    const componentName = 'ScopedResourceComponent';\n    const rawResolvedOptions =\n      typeof inProps === 'function'\n        ? inProps({\n            resource: resourcesEnum,\n            name: createProp.string().literal(componentName),\n          })\n        : inProps;\n    const { resolvedInProps } = splitLayoutInProps(\n      rawResolvedOptions as Record<string, unknown>,\n    );\n    const resolvedComposables = layout.composables\n      ? resolveLayoutComposables(layout.composables, {\n          resource,\n          name: componentName,\n          capitalize,\n        })\n      : undefined;\n\n    for (const {\n      props: presetPropDefinitions,\n    } of collectComposablePresetEntries(resolvedComposables)) {\n      Object.assign(resolvedInProps, presetPropDefinitions);\n    }\n\n    return {\n      ...resolvedInProps,\n      ...layout.props?.custom,\n    };\n  }\n\n  const { createLayoutForResourceBuilder, forResource } = createForResource<\n    Resources,\n    InProps,\n    Composables,\n    IncludeProps,\n    CustomProps\n  >({\n    createResourceLayout: definedResourceLayout as never,\n    resolveLayoutOptionDefaults,\n  });\n  const forResources = createForResources<\n    Resources,\n    InProps,\n    Composables,\n    IncludeProps,\n    CustomProps\n  >({\n    createLayoutForResource: createLayoutForResourceBuilder,\n    ...(layout.composables\n      ? { createMakeComposableLayout: createTopLevelMakeComposable }\n      : {}),\n    createResourceLayout: definedResourceLayout as never,\n    getComponentPropDefinitions,\n  });\n\n  const createResourceLayoutExtras: {\n    forResource: CreateLayoutForResource<\n      Resources,\n      InProps,\n      Composables,\n      IncludeProps,\n      CustomProps\n    >;\n    forResources: CreateResourceLayoutForResourcesFn<\n      Resources,\n      InProps,\n      Composables,\n      IncludeProps,\n      CustomProps\n    >;\n    makeComposable?: ReturnType<typeof createTopLevelMakeComposable>;\n  } = {\n    forResource,\n    forResources,\n  };\n\n  if (layout.composables) {\n    createResourceLayoutExtras.makeComposable = createTopLevelMakeComposable();\n  }\n\n  const createResourceLayout = Object.assign(\n    definedResourceLayout,\n    createResourceLayoutExtras,\n  ) as CreateResourceLayoutFn<\n    Resources,\n    InProps,\n    Composables,\n    IncludeProps,\n    CustomProps\n  >;\n\n  const createResourceLinks = createResourceLinksFn(resources);\n\n  return {\n    createResourceConfig,\n    createResourceLayout,\n    createResourceLinks,\n    resources: resourcesAccessor,\n  } as DefinedResourceLayout<\n    Resources,\n    InProps,\n    Composables,\n    IncludeProps,\n    CustomProps\n  >;\n}\n\ntype DefineResourceLayoutForResourcesOptions<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  InProps extends InPropsDefinition<Resources> = {},\n  Composables extends ComposableComponents = {},\n  IncludeProps extends LayoutIncludeProps<Resources, InProps, Composables> = {},\n  CustomProps extends InPropsObject = {},\n  ExtraResources extends ReadonlyArray<ResourceDefinition> = [],\n> = Omit<\n  CreateViewMapOptions<\n    Resources,\n    InProps,\n    Composables,\n    IncludeProps,\n    CustomProps\n  >,\n  'resources'\n> & {\n  /**\n   * Additional resources to merge with those bound by\n   * {@link defineResourceLayout.forResources}.\n   */\n  resources?: AssertUnreservedResources<ExtraResources>;\n};\n\ntype NonEmptyResourceDefinitions = readonly [\n  ResourceDefinition,\n  ...ResourceDefinition[],\n];\n\n/**\n * Factory returned by {@link DefineResourceLayout.forResources}.\n */\nexport type DefineResourceLayoutForResourcesFactory<\n  BaseResources extends NonEmptyResourceDefinitions,\n> = <\n  const ExtraResources extends ReadonlyArray<ResourceDefinition> = [],\n  InProps extends InPropsDefinition<[...BaseResources, ...ExtraResources]> = {},\n  Composables extends ComposableComponents = {},\n  const IncludeProps extends LayoutIncludeProps<\n    [...BaseResources, ...ExtraResources],\n    InProps,\n    Composables\n  > = {},\n  CustomProps extends InPropsObject = {},\n>(\n  options: DefineResourceLayoutForResourcesOptions<\n    [...BaseResources, ...ExtraResources],\n    InProps,\n    Composables,\n    IncludeProps,\n    CustomProps,\n    ExtraResources\n  >,\n) => DefinedResourceLayout<\n  [...BaseResources, ...ExtraResources],\n  InProps,\n  Composables,\n  IncludeProps,\n  CustomProps\n>;\n\n/**\n * Binds one or more resources, then accepts the remaining\n * {@link defineResourceLayout} options (with optional extra `resources`).\n */\nexport type DefineResourceLayoutForResources = <\n  const Resources extends NonEmptyResourceDefinitions,\n>(\n  ...resources: Resources\n) => DefineResourceLayoutForResourcesFactory<Resources>;\n\n/**\n * Creates a resource layout definition for a set of resources.\n */\nexport type DefineResourceLayoutFn = {\n  <\n    const Resources extends ReadonlyArray<ResourceDefinition>,\n    InProps extends InPropsDefinition<Resources> = {},\n    Composables extends ComposableComponents = {},\n    const IncludeProps extends LayoutIncludeProps<\n      Resources,\n      InProps,\n      Composables\n    > = {},\n    CustomProps extends InPropsObject = {},\n  >(\n    options: CreateViewMapOptions<\n      Resources,\n      InProps,\n      Composables,\n      IncludeProps,\n      CustomProps\n    >,\n  ): DefinedResourceLayout<\n    Resources,\n    InProps,\n    Composables,\n    IncludeProps,\n    CustomProps\n  >;\n};\n\n/**\n * Captures a `resources` array with its literal tuple type intact, so it can be\n * declared separately from the `defineResourceLayout` call without needing an\n * `as const` assertion.\n */\nexport type DefineResourcesFn = <\n  const Resources extends ReadonlyArray<ResourceDefinition>,\n>(\n  ...resources: Resources\n) => Resources;\n\nfunction defineResources<\n  const Resources extends ReadonlyArray<ResourceDefinition>,\n>(...resources: Resources): Resources {\n  return resources;\n}\n\nexport type DefineResourceLayout = DefineResourceLayoutFn & {\n  forResources: DefineResourceLayoutForResources;\n  /**\n   * Builds a strongly-typed `resources` array to pass to `defineResourceLayout`\n   * (or `defineResourceLayout.forResources`) without an `as const` assertion.\n   */\n  defineResources: DefineResourcesFn;\n  /**\n   * Like {@link defineResourceLayout}, but also returns a `Shell` component.\n   *\n   * With plain `defineResourceLayout`, every page is wrapped in its own\n   * `createResourceLayout` component, so navigating between resources unmounts\n   * one page component and mounts another — the shared chrome the `render`\n   * produces (a sidebar, a header, subscriptions, observers) is rebuilt every\n   * time. `withLayout` splits that chrome into a `shell` that mounts once,\n   * above the router outlet, and stays mounted across navigation; pages mount\n   * and unmount inside it and report their resource up automatically.\n   */\n  withLayout: DefineResourceLayoutWithLayoutFn;\n};\n\nfunction defineResourceLayoutForResources<\n  const Resources extends NonEmptyResourceDefinitions,\n>(\n  ...baseResources: Resources\n): DefineResourceLayoutForResourcesFactory<Resources> {\n  return ((options) => {\n    const { resources: extraResources, ...rest } = options;\n    const resources = extraResources\n      ? [...baseResources, ...extraResources]\n      : [...baseResources];\n\n    return defineResourceLayoutImpl({\n      ...rest,\n      resources,\n    } as never);\n  }) as DefineResourceLayoutForResourcesFactory<Resources>;\n}\n\n/* -------------------------------------------------------------------------- */\n/*  defineResourceLayout.withLayout — a once-mounted application shell        */\n/* -------------------------------------------------------------------------- */\n\n/**\n * Render context passed as the second argument to\n * {@link ShellLayoutDefinition.render}.\n *\n * The same shape as a per-resource `render` context (`composables`,\n * `resources`, `name`, `inProps`), with two differences that follow from the\n * shell being mounted once above the router outlet rather than per page:\n *\n * - `resource` / `resources.current` are `LayoutResourceKey | undefined`. The\n *   shell outlives any single page, so the current resource is whatever the\n *   mounted page last reported (or the `resource` prop, or nothing yet).\n * - `children` is the shell's content region. Render it where page content\n *   belongs; it is already wrapped so mounted pages report their resource back.\n */\nexport type ShellRenderContext<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  ShellComposables extends ComposableComponents,\n> = {\n  composables: LayoutRenderComposables<ShellComposables>;\n  inProps: Record<string, unknown>;\n  /**\n   * The resource currently rendered in the outlet, or `undefined` when no\n   * per-resource page is mounted and no `resource` prop was passed.\n   */\n  resource: LayoutResourceKey<Resources> | undefined;\n  /**\n   * Resources accessor for this definition. `current` follows `resource` above\n   * and may be `undefined`.\n   */\n  resources: LayoutResourcesAccessor<Resources> & {\n    readonly current: LayoutResourceKey<Resources> | undefined;\n  };\n  name: string;\n  /**\n   * The shell's content region — typically a router `<Outlet />`. Render it\n   * where page content belongs.\n   */\n  children: ReactNode;\n};\n\n/**\n * The `shell` block of a {@link defineResourceLayout.withLayout} call: the\n * chrome that mounts once and stays mounted while pages navigate inside it.\n *\n * Mirrors {@link LayoutDefinition} (`props`, `composables`, `render`) so the\n * two blocks read the same, plus an optional `name`.\n */\nexport type ShellLayoutDefinition<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  ShellComposables extends ComposableComponents,\n  ShellIncludeProps extends LayoutIncludeProps<\n    Resources,\n    Options,\n    ShellComposables\n  >,\n  ShellCustomProps extends InPropsObject,\n> = {\n  /**\n   * Stable name for the shell component (React DevTools) and the base for any\n   * resource-scoped composable names. Defaults to `'ResourceLayoutShell'`.\n   */\n  name?: string;\n  props?: LayoutProps<\n    Resources,\n    Options,\n    ShellComposables,\n    ShellIncludeProps,\n    ShellCustomProps\n  >;\n  composables?: (\n    create: CreateLayoutComposable<LayoutResourceKey<Resources>>,\n  ) => ShellComposables;\n  render: (\n    props: LayoutRenderProps<\n      Resources,\n      Options,\n      ShellComposables,\n      ShellIncludeProps,\n      ShellCustomProps\n    >,\n    context: ShellRenderContext<Resources, ShellComposables>,\n  ) => JSX.Element;\n};\n\n/**\n * Props accepted by the `Shell` component from\n * {@link defineResourceLayout.withLayout}.\n */\nexport type ResourceLayoutShellProps<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  ShellComposables extends ComposableComponents,\n  ShellIncludeProps extends LayoutIncludeProps<\n    Resources,\n    Options,\n    ShellComposables\n  >,\n  ShellCustomProps extends InPropsObject,\n> = Show<\n  ResolveProps<ShellCustomProps> &\n    ResolvedIncludedComponentProps<\n      MergedLayoutInProps<Resources, Options, ShellComposables>,\n      ShellIncludeProps\n    > & {\n      /**\n       * The resource the shell renders for. Overrides the value reported by the\n       * page mounted in `children`. Always available — pass it from tests,\n       * stories, or a route that renders non-library content but still wants\n       * the shell.\n       */\n      resource?: LayoutResourceKey<Resources>;\n      /** The shell's content region — typically a router `<Outlet />`. */\n      children: ReactNode;\n    }\n>;\n\n/**\n * The once-mounted application shell returned from\n * {@link defineResourceLayout.withLayout}. Wrap the router outlet with it.\n */\nexport type ResourceLayoutShellComponent<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  ShellComposables extends ComposableComponents = {},\n  ShellIncludeProps extends LayoutIncludeProps<\n    Resources,\n    Options,\n    ShellComposables\n  > = {},\n  ShellCustomProps extends InPropsObject = {},\n> = BaseComponent<\n  string,\n  ResourceLayoutShellProps<\n    Resources,\n    Options,\n    ShellComposables,\n    ShellIncludeProps,\n    ShellCustomProps\n  >\n> & {\n  (\n    props: ResourceLayoutShellProps<\n      Resources,\n      Options,\n      ShellComposables,\n      ShellIncludeProps,\n      ShellCustomProps\n    >,\n  ): JSX.Element;\n};\n\n/**\n * Options for {@link defineResourceLayout.withLayout}: everything\n * {@link defineResourceLayout} accepts, plus a required `shell`, and with the\n * per-resource `layout.render` made optional.\n */\nexport type CreateResourceLayoutWithLayoutOptions<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources> = {},\n  Composables extends ComposableComponents = {},\n  IncludeProps extends LayoutIncludeProps<Resources, Options, Composables> = {},\n  CustomProps extends InPropsObject = {},\n  ShellComposables extends ComposableComponents = {},\n  ShellIncludeProps extends LayoutIncludeProps<\n    Resources,\n    Options,\n    ShellComposables\n  > = {},\n  ShellCustomProps extends InPropsObject = {},\n> = {\n  /**\n   * An array of valid resource names to support. Nested sub-resource slugs that\n   * collide with config keys (`component`, `detail`, `new`, …) are reserved.\n   */\n  resources: AssertUnreservedResources<Resources>;\n  /**\n   * The options that are passed into the created resource layout. Shared by the\n   * shell and the per-resource layout, so an `include` on either side can draw\n   * from the same definitions.\n   */\n  options?: Options;\n  /**\n   * The once-mounted shell. The returned `Shell` wraps the router outlet and\n   * stays mounted across resource navigation, so its composables (a persistent\n   * sidebar, header, breadcrumb container, …) keep their state and DOM while\n   * pages mount and unmount inside it.\n   */\n  shell: ShellLayoutDefinition<\n    Resources,\n    Options,\n    ShellComposables,\n    ShellIncludeProps,\n    ShellCustomProps\n  >;\n  /**\n   * Per-resource content. Optional here: when the shell renders the whole\n   * chrome, a page is just a slot — omit `render` and the generated component\n   * renders its own `children` into the shell's outlet. Provide it to give a\n   * resource its own header, actions, or per-page structure.\n   */\n  layout?: Omit<\n    LayoutDefinition<Resources, Options, Composables, IncludeProps, CustomProps>,\n    'render'\n  > & {\n    render?: LayoutDefinition<\n      Resources,\n      Options,\n      Composables,\n      IncludeProps,\n      CustomProps\n    >['render'];\n  };\n};\n\n/**\n * {@link DefinedResourceLayout} plus the once-mounted `Shell`.\n */\nexport type DefinedResourceLayoutWithShell<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents = {},\n  IncludeProps extends LayoutIncludeProps<Resources, Options, Composables> = {},\n  CustomProps extends InPropsObject = {},\n  ShellComposables extends ComposableComponents = {},\n  ShellIncludeProps extends LayoutIncludeProps<\n    Resources,\n    Options,\n    ShellComposables\n  > = {},\n  ShellCustomProps extends InPropsObject = {},\n> = DefinedResourceLayout<\n  Resources,\n  Options,\n  Composables,\n  IncludeProps,\n  CustomProps\n> & {\n  /**\n   * The application shell. Mount it once, wrapping the router outlet:\n   *\n   * ```tsx\n   * function AdminRoute() {\n   *   const resource = Route.useParams({ select: (p) => p.resource });\n   *   return (\n   *     <Shell resource={resource}>\n   *       <Outlet />\n   *     </Shell>\n   *   );\n   * }\n   * ```\n   *\n   * Passing `resource` is optional: a page created by `createResourceLayout`\n   * reports its own resource to the shell automatically. Pass it for routes\n   * that render non-library content, or in tests and stories.\n   */\n  Shell: ResourceLayoutShellComponent<\n    Resources,\n    Options,\n    ShellComposables,\n    ShellIncludeProps,\n    ShellCustomProps\n  >;\n};\n\n/**\n * Signature of {@link defineResourceLayout.withLayout}.\n */\nexport type DefineResourceLayoutWithLayoutFn = <\n  const Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources> = {},\n  Composables extends ComposableComponents = {},\n  const IncludeProps extends LayoutIncludeProps<\n    Resources,\n    Options,\n    Composables\n  > = {},\n  CustomProps extends InPropsObject = {},\n  ShellComposables extends ComposableComponents = {},\n  const ShellIncludeProps extends LayoutIncludeProps<\n    Resources,\n    Options,\n    ShellComposables\n  > = {},\n  ShellCustomProps extends InPropsObject = {},\n>(\n  options: CreateResourceLayoutWithLayoutOptions<\n    Resources,\n    Options,\n    Composables,\n    IncludeProps,\n    CustomProps,\n    ShellComposables,\n    ShellIncludeProps,\n    ShellCustomProps\n  >,\n) => DefinedResourceLayoutWithShell<\n  Resources,\n  Options,\n  Composables,\n  IncludeProps,\n  CustomProps,\n  ShellComposables,\n  ShellIncludeProps,\n  ShellCustomProps\n>;\n\n/**\n * Loose runtime shape of a `shell` block, used by the impl below.\n */\ntype ShellLayoutRuntime = {\n  name?: string;\n  composables?: (create: unknown) => ComposableComponents;\n  props?: {\n    include?: Record<string, unknown>;\n    custom?: Record<string, unknown>;\n  };\n  render: (\n    props: Record<string, unknown>,\n    context: Record<string, unknown>,\n  ) => JSX.Element;\n};\n\n/**\n * Builds the `Shell` component. Kept beside {@link defineResourceLayoutImpl} so\n * it can reuse the same private prop-resolution helpers.\n *\n * Unlike a per-resource component, the shell re-reads the current resource on\n * every render (reported by the mounted page) so resource-scoped composable\n * *names* can update. Composable *component identities* are resolved once and\n * kept stable: React reconciles by element type, so recreating\n * `composables.Layout` each render would remount wrapWith targets, sidebar\n * state, and the outlet. Display names are synced onto those stable functions\n * when the resource changes.\n *\n * @param shellId - Identity of the owning `withLayout` definition. The shell\n *   only accepts resource reports tagged with this id, so a page or pane from a\n *   different definition rendered in the outlet cannot corrupt its state.\n */\nfunction createResourceLayoutShellComponent(\n  resources: ReadonlyArray<ResourceDefinition>,\n  inProps:\n    | InPropsObject\n    | ((opts: Record<string, unknown>) => InPropsObject),\n  shell: ShellLayoutRuntime,\n  shellId: symbol,\n) {\n  const shellName = shell.name ?? 'ResourceLayoutShell';\n  // `resources` is the wide `ResourceDefinition[]` here (not the const generic\n  // that `defineResourceLayoutImpl` captures), so the normalize/enum types are\n  // erased to keep TS from trying to instantiate them structurally. Only the\n  // runtime key list matters — the shell validates against it, it does not\n  // surface it in a public type.\n  const resourceKeys = Object.keys(\n    normalizeResources(resources as never) as Record<string, unknown>,\n  );\n  const resourcesEnum = createPrimitivePropBuilder('string').enum(\n    resourceKeys as never,\n  );\n\n  // `options` may be a function of `{ resource, name }`. The shell has no single\n  // resource, so — like the component path in `defineResourceLayoutImpl` — the\n  // enum stands in for `resource` while resolving the definitions.\n  const rawResolvedOptions =\n    typeof inProps === 'function'\n      ? inProps({\n          resource: resourcesEnum,\n          name: createProp.string().literal(shellName),\n        })\n      : inProps;\n  const { resolvedInProps, splitInProps } = splitLayoutInProps(\n    rawResolvedOptions as Record<string, unknown>,\n  );\n\n  const includeShellProps = shell.props?.include;\n  const includeShellPropKeys = Object.keys(includeShellProps ?? {});\n  const shellCustomDefinitions = {\n    ...(shell.props?.custom ?? {}),\n  } as Record<string, AnyBuiltPropDefinition>;\n\n  function syncShellComposableDisplayNames(\n    stable: ComposableComponents,\n    resource: string,\n  ) {\n    if (!shell.composables) {\n      return;\n    }\n\n    const named = resolveLayoutComposables(shell.composables as never, {\n      resource,\n      name: shellName,\n      capitalize,\n    } as never) as ComposableComponents;\n\n    for (const [key, component] of Object.entries(named)) {\n      const stableComponent = stable[key];\n\n      if (\n        typeof stableComponent === 'function' &&\n        typeof component === 'function' &&\n        'displayName' in component\n      ) {\n        (stableComponent as { displayName?: string }).displayName = (\n          component as { displayName?: string }\n        ).displayName;\n      }\n    }\n  }\n\n  function Shell(props: Record<string, unknown>) {\n    const { children: outlet, resource: resourceProp } = props as {\n      children: ReactNode;\n      resource?: string;\n    };\n\n    // Which resource is currently in the outlet. A per-resource page reports its\n    // own resource here on mount (see the layout effect in `Component`);\n    // `undefined` between pages or on a route with no per-resource layout. An\n    // explicit `resource` prop always wins.\n    const [reportedResource, setReportedResource] = useState<\n      string | undefined\n    >(undefined);\n    const publishResource = useCallback<ResourceLayoutShellPublisher>(\n      (resource, ownerId) => {\n        // Ignore reports from components that belong to a different\n        // `defineResourceLayout` definition — they share this context but their\n        // resource is unrelated to this shell.\n        if (ownerId !== shellId) {\n          return;\n        }\n\n        setReportedResource(resource);\n      },\n      [],\n    );\n    const resource = resourceProp ?? reportedResource;\n\n    // The outlet subtree must not re-render when `reportedResource` changes —\n    // only the shell chrome should. Memoising the wrapped element lets React\n    // bail out of reconciling the page while, say, the breadcrumb label updates.\n    const shellChildren = useMemo(\n      () => (\n        <ResourceLayoutShellPublisherContext.Provider value={publishResource}>\n          {outlet}\n        </ResourceLayoutShellPublisherContext.Provider>\n      ),\n      [outlet, publishResource],\n    );\n\n    // Resolve composables once so `<composables.Layout>` keeps a stable element\n    // type across Shell re-renders (including the layout-effect resource report).\n    // Re-resolving every render would allocate new component functions and React\n    // would remount the whole chrome tree. Names still track the live resource\n    // via {@link syncShellComposableDisplayNames}.\n    const composablesRef = useRef<ComposableComponents | undefined>(undefined);\n    if (shell.composables) {\n      const nameContextResource = resource ?? '';\n\n      if (!composablesRef.current) {\n        composablesRef.current = resolveLayoutComposables(\n          shell.composables as never,\n          {\n            resource: nameContextResource,\n            name: shellName,\n            capitalize,\n          } as never,\n        ) as ComposableComponents;\n      } else {\n        syncShellComposableDisplayNames(\n          composablesRef.current,\n          nameContextResource,\n        );\n      }\n    }\n    const resolvedComposables = composablesRef.current;\n    const validationContext = {\n      layoutName: shellName,\n      resource: resource ?? '',\n    };\n\n    const mergedResolvedInProps = { ...resolvedInProps } as Record<\n      string,\n      unknown\n    >;\n    for (const {\n      props: presetPropDefinitions,\n    } of collectComposablePresetEntries(resolvedComposables)) {\n      Object.assign(mergedResolvedInProps, presetPropDefinitions);\n    }\n\n    // Included props: definition-time defaults from `options`, overridden by\n    // anything passed to `<Shell>` (component passthrough). Computed before\n    // preset validation so config-passthrough includes can reuse the defaults.\n    const includedPropDefinitions = pick(\n      mergedResolvedInProps,\n      includeShellPropKeys,\n    ) as Record<string, unknown>;\n    const includedPropValues = {\n      ...resolvePropDefinitionValues(includedPropDefinitions),\n    } as Record<string, unknown>;\n\n    for (const key of includeShellPropKeys) {\n      const definition = mergedResolvedInProps[key];\n      const behavior = includeShellProps?.[key];\n      const callSiteValue = allowsComponentPassthrough(behavior)\n        ? readLayoutOptionValue(key, definition, props)\n        : undefined;\n      // Config passthrough has no create-time call on Shell; still honour\n      // literal / split defaults from `options` when present.\n      const configValue = allowsConfigPassthrough(behavior)\n        ? readLayoutOptionValue(key, definition, {\n            ...includedPropValues,\n            ...splitInProps,\n          })\n        : undefined;\n      const splitValue = key in splitInProps ? splitInProps[key] : undefined;\n      const value = callSiteValue ?? configValue ?? splitValue;\n\n      if (value !== undefined) {\n        includedPropValues[key] = value;\n      }\n    }\n\n    // Preset props: Shell has no create-time call. Component-passthrough values\n    // come from `<Shell>` props; config-passthrough values only from definition\n    // defaults. Required config includes without a default are omitted from\n    // validation — they are not typed on Shell and cannot be supplied.\n    const composablePresetProps = Object.fromEntries(\n      collectComposablePresetEntries(resolvedComposables).map(\n        ({ key, props: presetPropDefinitions }) => {\n          const entries = Object.entries(presetPropDefinitions);\n          const validatedDefinitions = Object.fromEntries(\n            entries.filter(([propKey]) => {\n              const behavior = includeShellProps?.[propKey];\n\n              if (behavior === undefined) {\n                return true;\n              }\n\n              if (allowsComponentPassthrough(behavior)) {\n                return true;\n              }\n\n              if (allowsConfigPassthrough(behavior)) {\n                return includedPropValues[propKey] !== undefined;\n              }\n\n              return false;\n            }),\n          );\n          const values = Object.fromEntries(\n            entries.flatMap(([propKey]) => {\n              if (propKey in props) {\n                return [[propKey, props[propKey]]];\n              }\n\n              if (includedPropValues[propKey] !== undefined) {\n                return [[propKey, includedPropValues[propKey]]];\n              }\n\n              return [];\n            }),\n          );\n\n          return [\n            key,\n            validateProps(\n              validatedDefinitions as Record<string, AnyBuiltPropDefinition>,\n              values,\n              validationContext,\n            ),\n          ];\n        },\n      ),\n    );\n\n    const validatedCustomProps = validateProps(\n      shellCustomDefinitions,\n      props,\n      validationContext,\n    );\n\n    const requiredIncludedDefinitions = Object.fromEntries(\n      Object.entries(includedPropDefinitions).filter(([key]) => {\n        const behavior = includeShellProps?.[key];\n\n        if (!isIncludedPropRequired(behavior)) {\n          return false;\n        }\n\n        // Component passthrough stays required on `<Shell>` (and is typed there).\n        if (allowsComponentPassthrough(behavior)) {\n          return true;\n        }\n\n        // Config passthrough: only require when a definition-time value exists.\n        return includedPropValues[key] !== undefined;\n      }),\n    );\n    const optionalIncludedDefinitions = Object.fromEntries(\n      Object.entries(includedPropDefinitions).filter(\n        ([key]) =>\n          !isIncludedPropRequired(includeShellProps?.[key]) &&\n          includedPropValues[key] !== undefined,\n      ),\n    );\n    const validatedIncludedProps = validateProps(\n      {\n        ...requiredIncludedDefinitions,\n        ...optionalIncludedDefinitions,\n      } as Record<string, AnyBuiltPropDefinition>,\n      includedPropValues,\n      validationContext,\n    );\n    const renderIncludedProps = Object.fromEntries(\n      includeShellPropKeys.flatMap((key) =>\n        key in validatedIncludedProps\n          ? [\n              [\n                toLayoutRenderPropKey(key, mergedResolvedInProps[key]),\n                validatedIncludedProps[\n                  key as keyof typeof validatedIncludedProps\n                ],\n              ],\n            ]\n          : [],\n      ),\n    );\n\n    const renderProps = { ...validatedCustomProps, ...renderIncludedProps };\n    const renderContext = {\n      composables: resolvedComposables,\n      resource,\n      resources: createLayoutRenderResourcesAccessor(\n        resources as ReadonlyArray<ResourceDefinition>,\n        resource as never,\n      ),\n      name: shellName,\n      inProps: splitInProps,\n      children: shellChildren,\n    };\n\n    const rendered = shell.render(renderProps, renderContext);\n\n    return resolvedComposables ? (\n      <LayoutComposablePresetProvider value={composablePresetProps}>\n        {rendered}\n      </LayoutComposablePresetProvider>\n    ) : (\n      rendered\n    );\n  }\n\n  return Object.assign(Shell, {\n    displayName: shellName,\n    props: undefined as never,\n  });\n}\n\n/**\n * Implementation of {@link defineResourceLayout.withLayout}. Delegates the\n * config / links / `createResourceLayout` pieces to {@link defineResourceLayoutImpl}\n * and adds the {@link createResourceLayoutShellComponent | Shell}.\n */\nfunction defineResourceLayoutWithLayoutImpl(\n  options: Record<string, unknown>,\n): Record<string, unknown> {\n  const {\n    shell,\n    layout,\n    resources,\n    options: inProps,\n  } = options as {\n    shell: ShellLayoutRuntime;\n    layout?: {\n      composables?: unknown;\n      props?: { include?: unknown; custom?: Record<string, unknown> };\n      render?: (\n        props: Record<string, unknown>,\n        context: unknown,\n      ) => JSX.Element;\n    };\n    resources: ReadonlyArray<ResourceDefinition>;\n    options?:\n      | InPropsObject\n      | ((opts: Record<string, unknown>) => InPropsObject);\n  };\n\n  // The per-resource `render` is optional under `withLayout`. When omitted, the\n  // page is a pure content slot: give it a `children` prop (so\n  // `<UsersPage>{content}</UsersPage>` type-checks and works) and a render that\n  // drops that content into the shell's outlet. An explicit `render` is passed\n  // through untouched.\n  const resolvedLayout = layout?.render\n    ? layout\n    : {\n        ...layout,\n        props: {\n          ...layout?.props,\n          custom: {\n            children: createProp.component({ type: 'ReactNode' }).optional(),\n            ...(layout?.props?.custom ?? {}),\n          },\n        },\n        render: (pageProps: Record<string, unknown>) => (\n          <>{(pageProps.children as ReactNode) ?? null}</>\n        ),\n      };\n\n  // Ties the shell to the pages created by *its* `createResourceLayout`. Pages\n  // from other definitions rendered in the outlet carry a different id (or\n  // none) and are ignored by the shell's resource tracking.\n  const shellId = Symbol('resourceLayoutShell');\n\n  const base = defineResourceLayoutImpl({\n    resources,\n    options: inProps,\n    layout: resolvedLayout,\n    shellId,\n  } as never) as Record<string, unknown>;\n\n  const Shell = createResourceLayoutShellComponent(\n    resources,\n    (inProps ?? {}) as never,\n    shell,\n    shellId,\n  );\n\n  return { ...base, Shell };\n}\n\nexport const defineResourceLayout: DefineResourceLayout = Object.assign(\n  defineResourceLayoutImpl as DefineResourceLayoutFn,\n  {\n    forResources: defineResourceLayoutForResources,\n    defineResources,\n    withLayout:\n      defineResourceLayoutWithLayoutImpl as unknown as DefineResourceLayoutWithLayoutFn,\n  },\n);\n"],"mappings":"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"}
+{"version":3,"file":"define-layout.cjs","names":["createIsValidResourceFn","capitalize","functionalUpdate","isResourceConfigComponentKey","InvalidConfigError","MissingResourceProviderError","normalizeResources","toResourceEnum","createProp","useResourceLayoutShellPublisher","pick","LayoutComposablePresetProvider","LayoutConfigurationError","createForResource","createForResources","createResourceLinksFn","ResourceLayoutShellPublisherContext"],"sources":["../../src/create-config/define-layout.tsx"],"sourcesContent":["import {\n  createContext,\n  type JSX,\n  type ReactNode,\n  useContext,\n  useCallback,\n  useLayoutEffect,\n  useMemo,\n  useRef,\n  useState,\n} from 'react';\nimport {\n  type ComposableComponents,\n  type ComposableNameContext,\n  type ComposableResourceLayout,\n  type CreateLayoutComposable,\n  collectComposablePresetEntries,\n  LayoutComposablePresetProvider,\n  MakeComposable,\n  makeComposable,\n  MakeComposableOptions,\n  RequiredPresetLayoutProps,\n  resolveLayoutComposables,\n} from '@jfdevelops/react-layout-composables';\nimport {\n  LayoutConfigurationError,\n  MissingResourceProviderError,\n} from '../errors';\nimport {\n  type AnyBuiltPropDefinition,\n  createPrimitivePropBuilder,\n  createProp,\n  type ResolveLayoutProps,\n  type ResolveProps,\n  resolvePropDefinitionValues,\n  validateProps,\n} from '@jfdevelops/react-layout-validator';\nimport {\n  IncludedProps,\n  type IncludedPropBehavior,\n  InferredInProps,\n  InPropsDefinition,\n  InPropsObject,\n  LayoutRenderProps,\n  MergedLayoutInProps,\n  ResolvedIncludedComponentProps,\n  ResolvedIncludedConfigProps,\n  ResolvedIncludedProps,\n} from '../props';\nimport {\n  createIsValidResourceFn,\n  normalizeResources,\n  toResourceEnum,\n  type LayoutResourceKey,\n  type ResourceDefinition,\n  type ResourceDefinitionValue,\n} from '../resource';\nimport { BaseComponent, functionalUpdate, pick, Show, Updater } from '../utils';\nimport { capitalize } from '../utils/capitalize';\nimport { InvalidConfigError } from '../errors';\nimport { isResourceConfigComponentKey } from './component-keys';\nimport {\n  type CreateResourceConfigFn,\n  createResourceConfig,\n} from './get-component';\nimport type { AssertUnreservedResources } from './types';\nimport {\n  createResourceLinksFn,\n  type CreateResourceLinksFn,\n} from './create-resource-links';\nimport {\n  createForResource,\n  type CreateLayoutForResource,\n  type CreateResourceLayoutOptions,\n  type CreateResourceLayoutOptionsBase,\n} from './for-resource';\nimport {\n  createForResources,\n  type CreateResourceLayoutForResourcesFn,\n} from './for-resources';\nimport {\n  type ResourceLayoutShellPublisher,\n  ResourceLayoutShellPublisherContext,\n  useResourceLayoutShellPublisher,\n} from './shell-context';\n\nexport type LayoutIncludeProps<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n> = IncludedProps<MergedLayoutInProps<Resources, Options, Composables>>;\n\nexport type LayoutProps<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  IncludeProps extends LayoutIncludeProps<Resources, Options, Composables> = {},\n  CustomProps extends InPropsObject = {},\n> = {\n  /**\n   * Props to include in the layout.\n   */\n  include?: LayoutIncludeProps<Resources, Options, Composables> & IncludeProps;\n  /**\n   * Custom props that the layout will receive.\n   */\n  custom?: CustomProps;\n};\n\ntype LayoutRenderContext<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Composables extends ComposableComponents,\n> = {\n  composables: LayoutRenderComposables<Composables>;\n  inProps: Record<string, unknown>;\n  /**\n   * @deprecated Use `resources.current` instead. `resource` will be removed in\n   * the next major version.\n   */\n  resource: LayoutResourceKey<Resources>;\n  /**\n   * Accessor for the resources bound to this definition. Read `resources.current`\n   * for the resource this instance renders, call `resources()` for the raw\n   * value, use `resources.pick(...)` / `resources.omit(...)` to filter, or\n   * `resources.isResource(...)` to narrow an unknown value.\n   */\n  resources: LayoutRenderResourcesAccessor<Resources>;\n  name: string;\n};\n\n/**\n * A single {@link ResourceDefinition} kept by a `pick`, or `never` when it does\n * not match. Widened definitions (`string`, `{ value: string }`) are always\n * kept — the concrete keys are not known statically, so the runtime filter is\n * the source of truth.\n */\ntype PickResourceDefinition<\n  Definition,\n  Keys extends string,\n> = Definition extends ResourceDefinition\n  ? string extends ResourceDefinitionValue<Definition>\n    ? Definition\n    : ResourceDefinitionValue<Definition> extends Keys\n      ? Definition\n      : never\n  : never;\n\ntype PickResourceDefinitions<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Keys extends LayoutResourceKey<Resources>,\n> = Array<PickResourceDefinition<Resources[number], Keys>>;\n\n/**\n * A single {@link ResourceDefinition} kept by an `omit`, or `never` when it is\n * one of the omitted keys. Widened definitions are always kept.\n */\ntype OmitResourceDefinition<\n  Definition,\n  Keys extends string,\n> = Definition extends ResourceDefinition\n  ? string extends ResourceDefinitionValue<Definition>\n    ? Definition\n    : ResourceDefinitionValue<Definition> extends Keys\n      ? never\n      : Definition\n  : never;\n\ntype OmitResourceDefinitions<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Keys extends LayoutResourceKey<Resources>,\n> = Array<OmitResourceDefinition<Resources[number], Keys>>;\n\n/**\n * The result of `resources.pick(...)` / `resources.omit(...)`.\n *\n * - calling it returns the selected resource definitions.\n * - `.isResource(value)` narrows an unknown value to one of the selected keys.\n */\nexport type ResourceSelection<\n  Definitions extends ReadonlyArray<ResourceDefinition>,\n> = {\n  /** Returns the selected resource definitions. */\n  (): Show<Definitions>;\n  /**\n   * Narrows an unknown value to one of the selected resource keys.\n   *\n   * @param value - The value to test.\n   */\n  isResource(value: unknown): value is LayoutResourceKey<Definitions>;\n};\n\n/**\n * Accessor for the resources bound to a `defineResourceLayout` definition.\n *\n * - `resources()` returns the raw resources.\n * - `resources.omit(key, ...rest)` selects every resource except the named ones.\n * - `resources.pick(key, ...rest)` selects only the named resources.\n * - `resources.isResource(value)` narrows an unknown value to a resource key.\n *\n * `pick` / `omit` return a {@link ResourceSelection} thunk: call it for the\n * definitions, or use its `isResource` guard.\n */\nexport type LayoutResourcesAccessor<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = {\n  /**\n   * Returns the raw `resources` value passed to `defineResourceLayout`,\n   * exactly as declared.\n   */\n  (): Resources;\n  /**\n   * Narrows an unknown value to one of this definition's top-level resource\n   * keys.\n   *\n   * @param value - The value to test.\n   */\n  isResource(value: unknown): value is LayoutResourceKey<Resources>;\n  /**\n   * Selects every declared resource except the named ones. Requires at least\n   * one key.\n   *\n   * @param keys - Top-level resource names to exclude.\n   */\n  omit<\n    Keys extends [\n      LayoutResourceKey<Resources>,\n      ...LayoutResourceKey<Resources>[],\n    ],\n  >(\n    ...keys: Keys\n  ): ResourceSelection<OmitResourceDefinitions<Resources, Keys[number]>>;\n  /**\n   * Selects only the named resources. Requires at least one key.\n   *\n   * @param keys - Top-level resource names to keep.\n   */\n  pick<\n    Keys extends [\n      LayoutResourceKey<Resources>,\n      ...LayoutResourceKey<Resources>[],\n    ],\n  >(\n    ...keys: Keys\n  ): ResourceSelection<PickResourceDefinitions<Resources, Keys[number]>>;\n};\n\n/**\n * Render-scoped {@link LayoutResourcesAccessor}, extended with `current` — the\n * resource key the layout instance is rendering for.\n */\nexport type LayoutRenderResourcesAccessor<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = LayoutResourcesAccessor<Resources> & {\n  /** The resource this layout instance is rendering for. */\n  readonly current: LayoutResourceKey<Resources>;\n};\n\nfunction createResourceSelection(\n  definitions: ReadonlyArray<ResourceDefinition>,\n): ResourceSelection<ReadonlyArray<ResourceDefinition>> {\n  const selection = (() => definitions) as ResourceSelection<\n    ReadonlyArray<ResourceDefinition>\n  >;\n\n  selection.isResource = createIsValidResourceFn(definitions);\n\n  return selection;\n}\n\nfunction createLayoutResourcesAccessor<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n>(resources: Resources): LayoutResourcesAccessor<Resources> {\n  const accessor = (() => resources) as LayoutResourcesAccessor<Resources>;\n\n  accessor.isResource = createIsValidResourceFn(resources);\n  accessor.omit = ((...keys: string[]) =>\n    createResourceSelection(\n      resources.filter(\n        (resource) => !keys.includes(readResourceSlug(resource)),\n      ),\n    )) as LayoutResourcesAccessor<Resources>['omit'];\n  accessor.pick = ((...keys: string[]) =>\n    createResourceSelection(\n      resources.filter((resource) =>\n        keys.includes(readResourceSlug(resource)),\n      ),\n    )) as LayoutResourcesAccessor<Resources>['pick'];\n\n  return accessor;\n}\n\nfunction createLayoutRenderResourcesAccessor<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n>(\n  resources: Resources,\n  current: LayoutResourceKey<Resources>,\n): LayoutRenderResourcesAccessor<Resources> {\n  return Object.assign(createLayoutResourcesAccessor(resources), { current });\n}\ntype LayoutRenderComposables<Composables extends ComposableComponents> = [\n  keyof Composables,\n] extends [never]\n  ? undefined\n  : Composables;\n\ntype SplitLayoutInPropDefinition<\n  Props extends InPropsObject = {},\n  Content = unknown,\n> = {\n  props?: Props;\n  render: ((props: ResolveProps<Props>) => Content) | Content;\n};\n\nfunction isBuiltPropDefinition(\n  value: unknown,\n): value is AnyBuiltPropDefinition {\n  return typeof value === 'function' && value !== null && 'visibility' in value;\n}\n\nfunction isSplitLayoutInPropDefinition(\n  value: unknown,\n): value is SplitLayoutInPropDefinition {\n  return (\n    value !== null &&\n    typeof value === 'object' &&\n    'render' in value &&\n    (value as { render?: unknown }).render !== undefined\n  );\n}\n\nfunction isJSXElementDefinition(\n  definition: unknown,\n): definition is AnyBuiltPropDefinition & { type: 'JSX.Element' } {\n  return (\n    isBuiltPropDefinition(definition) &&\n    'type' in definition &&\n    definition.type === 'JSX.Element'\n  );\n}\n\nfunction toLayoutRenderPropKey(includeKey: string, definition: unknown) {\n  return isJSXElementDefinition(definition)\n    ? capitalize(includeKey)\n    : includeKey;\n}\n\nfunction readLayoutOptionValue(\n  includeKey: string,\n  definition: unknown,\n  sources: Record<string, unknown>,\n) {\n  const layoutOptionKeys = isJSXElementDefinition(definition)\n    ? [capitalize(includeKey), includeKey]\n    : [includeKey, capitalize(includeKey)];\n\n  for (const key of layoutOptionKeys) {\n    if (key in sources) {\n      return sources[key];\n    }\n  }\n\n  return undefined;\n}\n\nfunction getIncludedPropBehavior(value: unknown): IncludedPropBehavior | null {\n  if (\n    value !== null &&\n    typeof value === 'object' &&\n    'visibility' in value &&\n    'passthrough' in value\n  ) {\n    return value as IncludedPropBehavior;\n  }\n\n  return null;\n}\n\nfunction isIncludedPropRequired(value: unknown) {\n  return (\n    value === true ||\n    value === 'required' ||\n    getIncludedPropBehavior(value)?.visibility === 'required'\n  );\n}\n\nfunction allowsConfigPassthrough(value: unknown) {\n  const behavior = getIncludedPropBehavior(value);\n\n  if (!behavior) {\n    return true;\n  }\n\n  if (behavior.passthrough === 'config') {\n    return true;\n  }\n\n  // optional + component passthrough still accepts create-time defaults\n  return (\n    behavior.passthrough === 'component' && behavior.visibility === 'optional'\n  );\n}\n\nfunction allowsComponentPassthrough(value: unknown) {\n  const behavior = getIncludedPropBehavior(value);\n\n  return behavior ? behavior.passthrough === 'component' : value === 'optional';\n}\n\nfunction splitLayoutInProps(inProps: Record<string, unknown>) {\n  const resolvedInProps: Record<string, AnyBuiltPropDefinition> = {};\n  const splitInProps: Record<string, unknown> = {};\n\n  for (const [key, value] of Object.entries(inProps)) {\n    if (isBuiltPropDefinition(value)) {\n      resolvedInProps[key] = value;\n      continue;\n    }\n\n    if (isSplitLayoutInPropDefinition(value)) {\n      splitInProps[key] = value.render;\n\n      if (value.props && typeof value.props === 'object') {\n        Object.assign(resolvedInProps, value.props);\n      }\n    }\n  }\n\n  return {\n    resolvedInProps,\n    splitInProps,\n  };\n}\n\nfunction resolveLayoutOptionDefaults(\n  defaults: Record<string, unknown>,\n  options: Record<string, unknown>,\n) {\n  const resolved = { ...options };\n\n  for (const [key, defaultValue] of Object.entries(defaults)) {\n    if (key in options) {\n      if (typeof defaultValue === 'function') {\n        resolved[key] = options[key];\n      } else {\n        resolved[key] = functionalUpdate(\n          defaultValue,\n          options[key] as Updater<unknown>,\n        );\n      }\n    }\n  }\n\n  return resolved;\n}\n\n/**\n * The `layout` block of a {@link defineResourceLayout} call: the props, the\n * composable map, and the render for a per-resource page component.\n *\n * Extracted so {@link defineResourceLayout.withLayout} can reuse the exact same\n * shape while making `render` optional (see {@link ShellLayoutDefinition}).\n */\ntype LayoutDefinition<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  IncludeProps extends LayoutIncludeProps<Resources, Options, Composables>,\n  CustomProps extends InPropsObject,\n> = {\n  /**\n   * The props to pass to the layout.\n   */\n  props?: LayoutProps<Resources, Options, Composables, IncludeProps, CustomProps>;\n  /**\n   * Components used to compose the layout. Invoked per layout instance with\n   * a scoped `create` that resolves composable `name` callbacks using the\n   * layout's `resource` and `name`.\n   */\n  composables?: (\n    create: CreateLayoutComposable<LayoutResourceKey<Resources>>,\n  ) => Composables;\n  /**\n   * The render function for the layout.\n   */\n  render: (\n    props: LayoutRenderProps<\n      Resources,\n      Options,\n      Composables,\n      IncludeProps,\n      CustomProps\n    >,\n    context: LayoutRenderContext<Resources, Composables>,\n  ) => JSX.Element;\n};\n\ntype CreateViewMapOptions<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources> = {},\n  Composables extends ComposableComponents = {},\n  IncludeProps extends LayoutIncludeProps<Resources, Options, Composables> = {},\n  CustomProps extends InPropsObject = {},\n> = {\n  /**\n   * An array of valid resource names to support. Nested sub-resource slugs that\n   * collide with config keys (`component`, `detail`, `new`, …) are reserved.\n   */\n  resources: AssertUnreservedResources<Resources>;\n  /**\n   * The options that are passed into the created resource layout.\n   */\n  options?: Options;\n  layout: LayoutDefinition<\n    Resources,\n    Options,\n    Composables,\n    IncludeProps,\n    CustomProps\n  >;\n};\n\ntype ResourceLayoutComposition<\n  Name extends string,\n  Composables extends ComposableComponents,\n> = [keyof Composables] extends [never]\n  ? {}\n  : {\n      makeComposable: MakeComposable<Composables, Name>;\n    };\nexport type ResourceLayoutComponent<\n  Name extends string,\n  Props extends InPropsObject = {},\n  Composables extends ComposableComponents = {},\n  Resource extends string = string,\n  IncludedCallProps extends object = {},\n> = ResourceLayoutComposition<Name, Composables> &\n  BaseComponent<Name, Show<ResolveProps<Props> & IncludedCallProps>> & {\n    (props: Show<ResolveProps<Props> & IncludedCallProps>): JSX.Element;\n    /**\n     * A type-only property containing the resource associated with this\n     * component. This property is `undefined` at runtime.\n     */\n    readonly resource: Resource;\n  };\n\nexport type LayoutPropsForResource<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  InProps extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents = {},\n  IncludeProps extends LayoutIncludeProps<Resources, InProps, Composables> = {},\n> = [keyof IncludeProps] extends [never]\n  ? ResolveLayoutProps<InferredInProps<Resources, InProps>> &\n      RequiredPresetLayoutProps<Composables>\n  : ResolvedIncludedConfigProps<\n      MergedLayoutInProps<Resources, InProps, Composables>,\n      IncludeProps\n    >;\n\ntype CreateResourceLayoutFnImpl<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  InProps extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  IncludeProps extends LayoutIncludeProps<Resources, InProps, Composables> = {},\n  CustomProps extends InPropsObject = {},\n> = <\n  Name extends string,\n  Resource extends LayoutResourceKey<Resources>,\n  Props extends InPropsObject = {},\n>(\n  options: CreateResourceLayoutOptions<\n    Resources,\n    InProps,\n    Composables,\n    IncludeProps,\n    Name,\n    Resource,\n    Props\n  >,\n) => ResourceLayoutComponent<\n  Name,\n  CustomProps,\n  Composables,\n  Resource,\n  ResolvedIncludedComponentProps<\n    MergedLayoutInProps<Resources, InProps, Composables>,\n    IncludeProps\n  >\n>;\n\nexport type CreateResourceLayoutMakeComposableOptions<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  InProps extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  Name extends string,\n  Resource extends LayoutResourceKey<Resources>,\n  Props extends InPropsObject = {},\n  IncludeProps extends LayoutIncludeProps<Resources, InProps, Composables> = {},\n> = CreateResourceLayoutOptionsBase<Resources, Name, Resource, Props> &\n  Partial<\n    LayoutPropsForResource<Resources, InProps, Composables, IncludeProps>\n  >;\n\ntype CreateResourceLayoutMakeComposableFn<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  InProps extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  IncludeProps extends LayoutIncludeProps<Resources, InProps, Composables>,\n  CustomProps extends InPropsObject,\n> = <\n  Name extends string,\n  Resource extends LayoutResourceKey<Resources>,\n  Props extends InPropsObject = {},\n>(\n  options: CreateResourceLayoutMakeComposableOptions<\n    Resources,\n    InProps,\n    Composables,\n    Name,\n    Resource,\n    Props,\n    IncludeProps\n  >,\n) => ComposableResourceLayout<Composables, Name, any, any, any>;\n\ntype CreateResourceLayoutFnBase<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  InProps extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents = {},\n  IncludeProps extends LayoutIncludeProps<Resources, InProps, Composables> = {},\n  CustomProps extends InPropsObject = {},\n> = CreateResourceLayoutFnImpl<\n  Resources,\n  InProps,\n  Composables,\n  IncludeProps,\n  CustomProps\n> & {\n  /**\n   * A function to create a resource layout for a specific resource.\n   */\n  forResource: CreateLayoutForResource<\n    Resources,\n    InProps,\n    Composables,\n    IncludeProps,\n    CustomProps\n  >;\n  /**\n   * Creates resource layout factories for multiple defined resources.\n   */\n  forResources: CreateResourceLayoutForResourcesFn<\n    Resources,\n    InProps,\n    Composables,\n    IncludeProps,\n    CustomProps\n  >;\n};\n\ntype CreateResourceLayoutMakeComposableMember<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  InProps extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  IncludeProps extends LayoutIncludeProps<Resources, InProps, Composables>,\n  CustomProps extends InPropsObject,\n> = [keyof Composables] extends [never]\n  ? {}\n  : {\n      makeComposable: CreateResourceLayoutMakeComposableFn<\n        Resources,\n        InProps,\n        Composables,\n        IncludeProps,\n        CustomProps\n      >;\n    };\n\nexport type CreateResourceLayoutFn<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  InProps extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents = {},\n  IncludeProps extends LayoutIncludeProps<Resources, InProps, Composables> = {},\n  CustomProps extends InPropsObject = {},\n> = CreateResourceLayoutFnBase<\n  Resources,\n  InProps,\n  Composables,\n  IncludeProps,\n  CustomProps\n> &\n  CreateResourceLayoutMakeComposableMember<\n    Resources,\n    InProps,\n    Composables,\n    IncludeProps,\n    CustomProps\n  >;\n\ntype DefinedResourceLayout<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  InProps extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents = {},\n  IncludeProps extends LayoutIncludeProps<Resources, InProps, Composables> = {},\n  CustomProps extends InPropsObject = {},\n> = {\n  createResourceConfig: CreateResourceConfigFn<Resources>;\n  createResourceLayout: CreateResourceLayoutFn<\n    Resources,\n    InProps,\n    Composables,\n    IncludeProps,\n    CustomProps\n  >;\n  createResourceLinks: CreateResourceLinksFn<Resources>;\n  /**\n   * Accessor for the resources bound to this definition. Call `resources()` for\n   * the raw value, or `resources.pick(...)` / `resources.omit(...)` to filter.\n   */\n  resources: LayoutResourcesAccessor<Resources>;\n  /**\n   * Provides the current resource to descendants that call `useResource`.\n   * Components created by `createResourceLayout` install this provider\n   * automatically.\n   */\n  ResourceProvider: ResourceLayoutProvider<Resources>;\n  /** Returns the nearest current resource. */\n  useResource: () => LayoutResourceKey<Resources>;\n};\n\nexport type ResourceLayoutProviderProps<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = {\n  children: ReactNode;\n  resource: LayoutResourceKey<Resources>;\n};\n\nexport type ResourceLayoutProvider<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = (props: ResourceLayoutProviderProps<Resources>) => JSX.Element;\n\nfunction readResourceSlug(resource: ResourceDefinition) {\n  return typeof resource === 'string' ? resource : resource.value;\n}\n\nfunction assertUnreservedResourceSlugs(\n  resources: ReadonlyArray<ResourceDefinition>,\n  owner?: string,\n) {\n  for (const resource of resources) {\n    const slug = readResourceSlug(resource);\n\n    if (owner !== undefined && isResourceConfigComponentKey(slug)) {\n      throw new InvalidConfigError({\n        reason: `Sub-resource \"${slug}\" under \"${owner}\" collides with a reserved config key`,\n      });\n    }\n\n    if (typeof resource !== 'string') {\n      assertUnreservedResourceSlugs(resource.subResources, slug);\n    }\n  }\n}\n\nfunction defineResourceLayoutImpl<\n  const Resources extends ReadonlyArray<ResourceDefinition>,\n  InProps extends InPropsDefinition<Resources> = {},\n  Composables extends ComposableComponents = {},\n  const IncludeProps extends LayoutIncludeProps<\n    Resources,\n    InProps,\n    Composables\n  > = {},\n  CustomProps extends InPropsObject = {},\n>(\n  options: CreateViewMapOptions<\n    Resources,\n    InProps,\n    Composables,\n    IncludeProps,\n    CustomProps\n  >,\n): DefinedResourceLayout<\n  Resources,\n  InProps,\n  Composables,\n  IncludeProps,\n  CustomProps\n> {\n  const { options: inProps = {} as InProps, resources, layout } = options;\n  // Internal, set only by `defineResourceLayout.withLayout`: the identity of the\n  // owning definition, forwarded when a page reports its resource so the shell\n  // can tell its own pages apart from ones belonging to another definition.\n  const shellId = (options as { shellId?: symbol }).shellId;\n\n  assertUnreservedResourceSlugs(resources);\n\n  const resourcesAccessor = createLayoutResourcesAccessor(resources);\n  const ResourceContext = createContext<\n    LayoutResourceKey<Resources> | undefined\n  >(undefined);\n\n  function ResourceProvider({\n    children,\n    resource,\n  }: ResourceLayoutProviderProps<Resources>) {\n    return (\n      <ResourceContext.Provider value={resource}>\n        {children}\n      </ResourceContext.Provider>\n    );\n  }\n\n  function useResource() {\n    const resource = useContext(ResourceContext);\n\n    if (resource === undefined) {\n      throw new MissingResourceProviderError({});\n    }\n\n    return resource;\n  }\n\n  const normalizedResources = normalizeResources(resources);\n  const resourcesEnum = createPrimitivePropBuilder('string').enum(\n    toResourceEnum(normalizedResources),\n  );\n  const definedResourceLayout = (<\n    Name extends string,\n    Resource extends LayoutResourceKey<Resources>,\n    Props extends InPropsObject = {},\n  >(\n    layoutOptions: CreateResourceLayoutOptions<\n      Resources,\n      InProps,\n      Composables,\n      IncludeProps,\n      Name,\n      Resource,\n      Props\n    >,\n  ) => {\n    const {\n      name,\n      props: instancePropDefinitions,\n      ...layoutOptionProps\n    } = layoutOptions;\n    const createComposableLayout =\n      makeComposable<\n        LayoutRenderProps<\n          Resources,\n          InProps,\n          Composables,\n          IncludeProps,\n          CustomProps\n        >\n      >();\n    const nameProp = createProp.string().literal(name);\n    const rawResolvedOptions =\n      typeof inProps === 'function'\n        ? inProps({\n            resource: resourcesEnum,\n            name: nameProp,\n          })\n        : inProps;\n    const { resolvedInProps, splitInProps } = splitLayoutInProps({\n      ...(rawResolvedOptions as Record<string, unknown>),\n      ...(instancePropDefinitions as Record<string, unknown> | undefined),\n      ...layoutOptionProps,\n    });\n    const { composables, render, props: layoutProps } = layout;\n    const customLayoutProps = layoutProps?.custom;\n    const includeLayoutProps = layoutProps?.include;\n    const layoutOptionValues = layoutOptionProps as Record<string, unknown>;\n    const resolvedLayoutProps = {\n      ...customLayoutProps,\n    };\n    const layoutContext: ComposableNameContext<\n      LayoutResourceKey<Resources>,\n      typeof name\n    > = {\n      resource: layoutOptions.resource,\n      name,\n      capitalize,\n    };\n    const validationContext = {\n      layoutName: name,\n      resource: layoutContext.resource,\n    };\n    const resolvedComposables = composables\n      ? resolveLayoutComposables(composables, layoutContext)\n      : undefined;\n    const mergedResolvedInProps = { ...resolvedInProps };\n\n    for (const {\n      props: presetPropDefinitions,\n    } of collectComposablePresetEntries(resolvedComposables)) {\n      Object.assign(mergedResolvedInProps, presetPropDefinitions);\n    }\n\n    const composablePresetProps = Object.fromEntries(\n      collectComposablePresetEntries(resolvedComposables).map(\n        ({ key, props: presetPropDefinitions }) => {\n          const presetPropEntries = Object.entries(presetPropDefinitions);\n          const validatedDefinitions = Object.fromEntries(\n            presetPropEntries.filter(([propKey]) => {\n              const includeBehavior = includeLayoutProps?.[propKey];\n\n              return (\n                includeBehavior === undefined ||\n                (allowsConfigPassthrough(includeBehavior) &&\n                  (isIncludedPropRequired(includeBehavior) ||\n                    layoutOptionValues[propKey] !== undefined))\n              );\n            }),\n          );\n          const presetPropValues = Object.fromEntries(\n            presetPropEntries.flatMap(([propKey]) =>\n              propKey in layoutOptionValues\n                ? [[propKey, layoutOptionValues[propKey]]]\n                : [],\n            ),\n          );\n\n          return [\n            key,\n            validateProps(\n              validatedDefinitions as Record<string, AnyBuiltPropDefinition>,\n              presetPropValues,\n              validationContext,\n            ),\n          ];\n        },\n      ),\n    );\n    const mergedRenderContext = {\n      composables: resolvedComposables as LayoutRenderComposables<Composables>,\n      resource: layoutContext.resource,\n      resources: createLayoutRenderResourcesAccessor(\n        resources as Resources,\n        layoutContext.resource,\n      ),\n      name: layoutContext.name,\n      inProps: splitInProps,\n    } as LayoutRenderContext<Resources, Composables>;\n\n    function Component(\n      props: Show<\n        ResolveProps<CustomProps> &\n          ResolvedIncludedComponentProps<\n            MergedLayoutInProps<Resources, InProps, Composables>,\n            IncludeProps\n          >\n      >,\n    ) {\n      const publishResource = useResourceLayoutShellPublisher();\n\n      // Report the resource this page renders for so an ancestor `Shell` (from\n      // `defineResourceLayout.withLayout`) can resolve `resources.current` for\n      // its own render without the consumer threading a route param down to it.\n      // A layout effect, not a passive one, so the shell reflects the new\n      // resource in the same commit the page mounts — a passive effect would\n      // leave one painted frame of stale shell chrome mid-navigation. Degrades\n      // to a no-op when rendered without a `Shell` (context defaults to null).\n      useLayoutEffect(() => {\n        publishResource?.(layoutContext.resource, shellId);\n\n        return () => publishResource?.(undefined, shellId);\n      }, [publishResource, layoutContext.resource]);\n\n      const validatedProps = validateProps(resolvedLayoutProps, props, {\n        ...validationContext,\n      });\n      const includedPropKeys = Object.keys(includeLayoutProps ?? {});\n      const includedPropDefinitions = pick(\n        mergedResolvedInProps,\n        includedPropKeys,\n      ) as Record<string, unknown>;\n      const includedPropValues = {\n        ...resolvePropDefinitionValues(includedPropDefinitions),\n      } as Record<string, unknown>;\n\n      for (const key of includedPropKeys) {\n        const definition = mergedResolvedInProps[key];\n        const includeBehavior = includeLayoutProps?.[key];\n        const callSiteValue = allowsComponentPassthrough(includeBehavior)\n          ? readLayoutOptionValue(\n              key,\n              definition,\n              props as Record<string, unknown>,\n            )\n          : undefined;\n        const layoutOptionValue = allowsConfigPassthrough(includeBehavior)\n          ? readLayoutOptionValue(key, definition, layoutOptionValues)\n          : undefined;\n        const splitValue = key in splitInProps ? splitInProps[key] : undefined;\n        const value = callSiteValue ?? layoutOptionValue ?? splitValue;\n\n        if (value !== undefined) {\n          includedPropValues[key] = value;\n        }\n      }\n\n      const requiredIncludedPropDefinitions = Object.fromEntries(\n        Object.entries(includedPropDefinitions).filter(([key]) =>\n          isIncludedPropRequired(includeLayoutProps?.[key]),\n        ),\n      );\n      const optionalIncludedPropDefinitions = Object.fromEntries(\n        Object.entries(includedPropDefinitions).filter(\n          ([key]) =>\n            !isIncludedPropRequired(includeLayoutProps?.[key]) &&\n            includedPropValues[key] !== undefined,\n        ),\n      );\n      const validatedIncludedProps = validateProps(\n        {\n          ...requiredIncludedPropDefinitions,\n          ...optionalIncludedPropDefinitions,\n        } as Record<string, AnyBuiltPropDefinition>,\n        includedPropValues,\n        validationContext,\n      );\n      const layoutRenderIncludedProps = Object.fromEntries(\n        includedPropKeys.flatMap((key) => {\n          if (!(key in validatedIncludedProps)) {\n            return [];\n          }\n\n          return [\n            [\n              toLayoutRenderPropKey(key, mergedResolvedInProps[key]),\n              validatedIncludedProps[\n                key as keyof typeof validatedIncludedProps\n              ],\n            ],\n          ];\n        }),\n      );\n      const layoutRenderProps = {\n        ...validatedProps,\n        ...layoutRenderIncludedProps,\n      } as unknown as LayoutRenderProps<\n        Resources,\n        InProps,\n        Composables,\n        IncludeProps,\n        CustomProps\n      >;\n\n      return (\n        <ResourceProvider resource={layoutContext.resource}>\n          <LayoutComposablePresetProvider value={composablePresetProps}>\n            {render(layoutRenderProps, mergedRenderContext)}\n          </LayoutComposablePresetProvider>\n        </ResourceProvider>\n      );\n    }\n\n    function createComposition<\n      LayoutName extends string,\n      const Defined extends MakeComposableOptions<Composables, LayoutName>,\n    >(compositionOptions: Defined) {\n      if (!compositionOptions.components) {\n        return {} as ResourceLayoutComposition<LayoutName, Composables>;\n      }\n\n      return {\n        makeComposable: createComposableLayout(\n          compositionOptions,\n        ) as MakeComposable<Composables, LayoutName>,\n      };\n    }\n\n    return Object.assign(Component, {\n      displayName: name,\n      props: undefined as unknown as Show<\n        ResolveProps<CustomProps> &\n          ResolvedIncludedComponentProps<\n            MergedLayoutInProps<Resources, InProps, Composables>,\n            IncludeProps\n          >\n      >,\n      resource: undefined as unknown as Resource,\n      ...createComposition({\n        components: resolvedComposables as Composables | undefined,\n        name,\n      }),\n    });\n  }) as CreateResourceLayoutFnImpl<\n    Resources,\n    InProps,\n    Composables,\n    IncludeProps,\n    CustomProps\n  >;\n  const createTopLevelMakeComposable = () => {\n    return (options: Record<string, unknown>) => {\n      const layout = definedResourceLayout(options as never);\n\n      if (\n        !('makeComposable' in layout) ||\n        typeof layout.makeComposable !== 'function'\n      ) {\n        throw new LayoutConfigurationError(\n          'makeComposable requires composables to be defined in the layout',\n        );\n      }\n\n      return layout.makeComposable();\n    };\n  };\n\n  function getComponentPropDefinitions(resource: LayoutResourceKey<Resources>) {\n    const componentName = 'ScopedResourceComponent';\n    const rawResolvedOptions =\n      typeof inProps === 'function'\n        ? inProps({\n            resource: resourcesEnum,\n            name: createProp.string().literal(componentName),\n          })\n        : inProps;\n    const { resolvedInProps } = splitLayoutInProps(\n      rawResolvedOptions as Record<string, unknown>,\n    );\n    const resolvedComposables = layout.composables\n      ? resolveLayoutComposables(layout.composables, {\n          resource,\n          name: componentName,\n          capitalize,\n        })\n      : undefined;\n\n    for (const {\n      props: presetPropDefinitions,\n    } of collectComposablePresetEntries(resolvedComposables)) {\n      Object.assign(resolvedInProps, presetPropDefinitions);\n    }\n\n    return {\n      ...resolvedInProps,\n      ...layout.props?.custom,\n    };\n  }\n\n  const { createLayoutForResourceBuilder, forResource } = createForResource<\n    Resources,\n    InProps,\n    Composables,\n    IncludeProps,\n    CustomProps\n  >({\n    createResourceLayout: definedResourceLayout as never,\n    resolveLayoutOptionDefaults,\n  });\n  const forResources = createForResources<\n    Resources,\n    InProps,\n    Composables,\n    IncludeProps,\n    CustomProps\n  >({\n    createLayoutForResource: createLayoutForResourceBuilder,\n    ...(layout.composables\n      ? { createMakeComposableLayout: createTopLevelMakeComposable }\n      : {}),\n    createResourceLayout: definedResourceLayout as never,\n    getComponentPropDefinitions,\n  });\n\n  const createResourceLayoutExtras: {\n    forResource: CreateLayoutForResource<\n      Resources,\n      InProps,\n      Composables,\n      IncludeProps,\n      CustomProps\n    >;\n    forResources: CreateResourceLayoutForResourcesFn<\n      Resources,\n      InProps,\n      Composables,\n      IncludeProps,\n      CustomProps\n    >;\n    makeComposable?: ReturnType<typeof createTopLevelMakeComposable>;\n  } = {\n    forResource,\n    forResources,\n  };\n\n  if (layout.composables) {\n    createResourceLayoutExtras.makeComposable = createTopLevelMakeComposable();\n  }\n\n  const createResourceLayout = Object.assign(\n    definedResourceLayout,\n    createResourceLayoutExtras,\n  ) as CreateResourceLayoutFn<\n    Resources,\n    InProps,\n    Composables,\n    IncludeProps,\n    CustomProps\n  >;\n\n  const createResourceLinks = createResourceLinksFn(resources);\n\n  return {\n    createResourceConfig,\n    createResourceLayout,\n    createResourceLinks,\n    resources: resourcesAccessor,\n    ResourceProvider,\n    useResource,\n  } as DefinedResourceLayout<\n    Resources,\n    InProps,\n    Composables,\n    IncludeProps,\n    CustomProps\n  >;\n}\n\ntype DefineResourceLayoutForResourcesOptions<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  InProps extends InPropsDefinition<Resources> = {},\n  Composables extends ComposableComponents = {},\n  IncludeProps extends LayoutIncludeProps<Resources, InProps, Composables> = {},\n  CustomProps extends InPropsObject = {},\n  ExtraResources extends ReadonlyArray<ResourceDefinition> = [],\n> = Omit<\n  CreateViewMapOptions<\n    Resources,\n    InProps,\n    Composables,\n    IncludeProps,\n    CustomProps\n  >,\n  'resources'\n> & {\n  /**\n   * Additional resources to merge with those bound by\n   * {@link defineResourceLayout.forResources}.\n   */\n  resources?: AssertUnreservedResources<ExtraResources>;\n};\n\ntype NonEmptyResourceDefinitions = readonly [\n  ResourceDefinition,\n  ...ResourceDefinition[],\n];\n\n/**\n * Factory returned by {@link DefineResourceLayout.forResources}.\n */\nexport type DefineResourceLayoutForResourcesFactory<\n  BaseResources extends NonEmptyResourceDefinitions,\n> = <\n  const ExtraResources extends ReadonlyArray<ResourceDefinition> = [],\n  InProps extends InPropsDefinition<[...BaseResources, ...ExtraResources]> = {},\n  Composables extends ComposableComponents = {},\n  const IncludeProps extends LayoutIncludeProps<\n    [...BaseResources, ...ExtraResources],\n    InProps,\n    Composables\n  > = {},\n  CustomProps extends InPropsObject = {},\n>(\n  options: DefineResourceLayoutForResourcesOptions<\n    [...BaseResources, ...ExtraResources],\n    InProps,\n    Composables,\n    IncludeProps,\n    CustomProps,\n    ExtraResources\n  >,\n) => DefinedResourceLayout<\n  [...BaseResources, ...ExtraResources],\n  InProps,\n  Composables,\n  IncludeProps,\n  CustomProps\n>;\n\n/**\n * Binds one or more resources, then accepts the remaining\n * {@link defineResourceLayout} options (with optional extra `resources`).\n */\nexport type DefineResourceLayoutForResources = <\n  const Resources extends NonEmptyResourceDefinitions,\n>(\n  ...resources: Resources\n) => DefineResourceLayoutForResourcesFactory<Resources>;\n\n/**\n * Creates a resource layout definition for a set of resources.\n */\nexport type DefineResourceLayoutFn = {\n  <\n    const Resources extends ReadonlyArray<ResourceDefinition>,\n    InProps extends InPropsDefinition<Resources> = {},\n    Composables extends ComposableComponents = {},\n    const IncludeProps extends LayoutIncludeProps<\n      Resources,\n      InProps,\n      Composables\n    > = {},\n    CustomProps extends InPropsObject = {},\n  >(\n    options: CreateViewMapOptions<\n      Resources,\n      InProps,\n      Composables,\n      IncludeProps,\n      CustomProps\n    >,\n  ): DefinedResourceLayout<\n    Resources,\n    InProps,\n    Composables,\n    IncludeProps,\n    CustomProps\n  >;\n};\n\n/**\n * Captures a `resources` array with its literal tuple type intact, so it can be\n * declared separately from the `defineResourceLayout` call without needing an\n * `as const` assertion.\n */\nexport type DefineResourcesFn = <\n  const Resources extends ReadonlyArray<ResourceDefinition>,\n>(\n  ...resources: Resources\n) => Resources;\n\nfunction defineResources<\n  const Resources extends ReadonlyArray<ResourceDefinition>,\n>(...resources: Resources): Resources {\n  return resources;\n}\n\nexport type DefineResourceLayout = DefineResourceLayoutFn & {\n  forResources: DefineResourceLayoutForResources;\n  /**\n   * Builds a strongly-typed `resources` array to pass to `defineResourceLayout`\n   * (or `defineResourceLayout.forResources`) without an `as const` assertion.\n   */\n  defineResources: DefineResourcesFn;\n  /**\n   * Like {@link defineResourceLayout}, but also returns a `Shell` component.\n   *\n   * With plain `defineResourceLayout`, every page is wrapped in its own\n   * `createResourceLayout` component, so navigating between resources unmounts\n   * one page component and mounts another — the shared chrome the `render`\n   * produces (a sidebar, a header, subscriptions, observers) is rebuilt every\n   * time. `withLayout` splits that chrome into a `shell` that mounts once,\n   * above the router outlet, and stays mounted across navigation; pages mount\n   * and unmount inside it and report their resource up automatically.\n   */\n  withLayout: DefineResourceLayoutWithLayoutFn;\n};\n\nfunction defineResourceLayoutForResources<\n  const Resources extends NonEmptyResourceDefinitions,\n>(\n  ...baseResources: Resources\n): DefineResourceLayoutForResourcesFactory<Resources> {\n  return ((options) => {\n    const { resources: extraResources, ...rest } = options;\n    const resources = extraResources\n      ? [...baseResources, ...extraResources]\n      : [...baseResources];\n\n    return defineResourceLayoutImpl({\n      ...rest,\n      resources,\n    } as never);\n  }) as DefineResourceLayoutForResourcesFactory<Resources>;\n}\n\n/* -------------------------------------------------------------------------- */\n/*  defineResourceLayout.withLayout — a once-mounted application shell        */\n/* -------------------------------------------------------------------------- */\n\n/**\n * Render context passed as the second argument to\n * {@link ShellLayoutDefinition.render}.\n *\n * The same shape as a per-resource `render` context (`composables`,\n * `resources`, `name`, `inProps`), with two differences that follow from the\n * shell being mounted once above the router outlet rather than per page:\n *\n * - `resource` / `resources.current` are `LayoutResourceKey | undefined`. The\n *   shell outlives any single page, so the current resource is whatever the\n *   mounted page last reported (or the `resource` prop, or nothing yet).\n * - `children` is the shell's content region. Render it where page content\n *   belongs; it is already wrapped so mounted pages report their resource back.\n */\nexport type ShellRenderContext<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  ShellComposables extends ComposableComponents,\n> = {\n  composables: LayoutRenderComposables<ShellComposables>;\n  inProps: Record<string, unknown>;\n  /**\n   * The resource currently rendered in the outlet, or `undefined` when no\n   * per-resource page is mounted and no `resource` prop was passed.\n   */\n  resource: LayoutResourceKey<Resources> | undefined;\n  /**\n   * Resources accessor for this definition. `current` follows `resource` above\n   * and may be `undefined`.\n   */\n  resources: LayoutResourcesAccessor<Resources> & {\n    readonly current: LayoutResourceKey<Resources> | undefined;\n  };\n  name: string;\n  /**\n   * The shell's content region — typically a router `<Outlet />`. Render it\n   * where page content belongs.\n   */\n  children: ReactNode;\n};\n\n/**\n * The `shell` block of a {@link defineResourceLayout.withLayout} call: the\n * chrome that mounts once and stays mounted while pages navigate inside it.\n *\n * Mirrors {@link LayoutDefinition} (`props`, `composables`, `render`) so the\n * two blocks read the same, plus an optional `name`.\n */\nexport type ShellLayoutDefinition<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  ShellComposables extends ComposableComponents,\n  ShellIncludeProps extends LayoutIncludeProps<\n    Resources,\n    Options,\n    ShellComposables\n  >,\n  ShellCustomProps extends InPropsObject,\n> = {\n  /**\n   * Stable name for the shell component (React DevTools) and the base for any\n   * resource-scoped composable names. Defaults to `'ResourceLayoutShell'`.\n   */\n  name?: string;\n  props?: LayoutProps<\n    Resources,\n    Options,\n    ShellComposables,\n    ShellIncludeProps,\n    ShellCustomProps\n  >;\n  composables?: (\n    create: CreateLayoutComposable<LayoutResourceKey<Resources>>,\n  ) => ShellComposables;\n  render: (\n    props: LayoutRenderProps<\n      Resources,\n      Options,\n      ShellComposables,\n      ShellIncludeProps,\n      ShellCustomProps\n    >,\n    context: ShellRenderContext<Resources, ShellComposables>,\n  ) => JSX.Element;\n};\n\n/**\n * Props accepted by the `Shell` component from\n * {@link defineResourceLayout.withLayout}.\n */\nexport type ResourceLayoutShellProps<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  ShellComposables extends ComposableComponents,\n  ShellIncludeProps extends LayoutIncludeProps<\n    Resources,\n    Options,\n    ShellComposables\n  >,\n  ShellCustomProps extends InPropsObject,\n> = Show<\n  ResolveProps<ShellCustomProps> &\n    ResolvedIncludedComponentProps<\n      MergedLayoutInProps<Resources, Options, ShellComposables>,\n      ShellIncludeProps\n    > & {\n      /**\n       * The resource the shell renders for. Overrides the value reported by the\n       * page mounted in `children`. Always available — pass it from tests,\n       * stories, or a route that renders non-library content but still wants\n       * the shell.\n       */\n      resource?: LayoutResourceKey<Resources>;\n      /** The shell's content region — typically a router `<Outlet />`. */\n      children: ReactNode;\n    }\n>;\n\n/**\n * The once-mounted application shell returned from\n * {@link defineResourceLayout.withLayout}. Wrap the router outlet with it.\n */\nexport type ResourceLayoutShellComponent<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  ShellComposables extends ComposableComponents = {},\n  ShellIncludeProps extends LayoutIncludeProps<\n    Resources,\n    Options,\n    ShellComposables\n  > = {},\n  ShellCustomProps extends InPropsObject = {},\n> = BaseComponent<\n  string,\n  ResourceLayoutShellProps<\n    Resources,\n    Options,\n    ShellComposables,\n    ShellIncludeProps,\n    ShellCustomProps\n  >\n> & {\n  (\n    props: ResourceLayoutShellProps<\n      Resources,\n      Options,\n      ShellComposables,\n      ShellIncludeProps,\n      ShellCustomProps\n    >,\n  ): JSX.Element;\n};\n\n/**\n * Options for {@link defineResourceLayout.withLayout}: everything\n * {@link defineResourceLayout} accepts, plus a required `shell`, and with the\n * per-resource `layout.render` made optional.\n */\nexport type CreateResourceLayoutWithLayoutOptions<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources> = {},\n  Composables extends ComposableComponents = {},\n  IncludeProps extends LayoutIncludeProps<Resources, Options, Composables> = {},\n  CustomProps extends InPropsObject = {},\n  ShellComposables extends ComposableComponents = {},\n  ShellIncludeProps extends LayoutIncludeProps<\n    Resources,\n    Options,\n    ShellComposables\n  > = {},\n  ShellCustomProps extends InPropsObject = {},\n> = {\n  /**\n   * An array of valid resource names to support. Nested sub-resource slugs that\n   * collide with config keys (`component`, `detail`, `new`, …) are reserved.\n   */\n  resources: AssertUnreservedResources<Resources>;\n  /**\n   * The options that are passed into the created resource layout. Shared by the\n   * shell and the per-resource layout, so an `include` on either side can draw\n   * from the same definitions.\n   */\n  options?: Options;\n  /**\n   * The once-mounted shell. The returned `Shell` wraps the router outlet and\n   * stays mounted across resource navigation, so its composables (a persistent\n   * sidebar, header, breadcrumb container, …) keep their state and DOM while\n   * pages mount and unmount inside it.\n   */\n  shell: ShellLayoutDefinition<\n    Resources,\n    Options,\n    ShellComposables,\n    ShellIncludeProps,\n    ShellCustomProps\n  >;\n  /**\n   * Per-resource content. Optional here: when the shell renders the whole\n   * chrome, a page is just a slot — omit `render` and the generated component\n   * renders its own `children` into the shell's outlet. Provide it to give a\n   * resource its own header, actions, or per-page structure.\n   */\n  layout?: Omit<\n    LayoutDefinition<Resources, Options, Composables, IncludeProps, CustomProps>,\n    'render'\n  > & {\n    render?: LayoutDefinition<\n      Resources,\n      Options,\n      Composables,\n      IncludeProps,\n      CustomProps\n    >['render'];\n  };\n};\n\n/**\n * {@link DefinedResourceLayout} plus the once-mounted `Shell`.\n */\nexport type DefinedResourceLayoutWithShell<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents = {},\n  IncludeProps extends LayoutIncludeProps<Resources, Options, Composables> = {},\n  CustomProps extends InPropsObject = {},\n  ShellComposables extends ComposableComponents = {},\n  ShellIncludeProps extends LayoutIncludeProps<\n    Resources,\n    Options,\n    ShellComposables\n  > = {},\n  ShellCustomProps extends InPropsObject = {},\n> = DefinedResourceLayout<\n  Resources,\n  Options,\n  Composables,\n  IncludeProps,\n  CustomProps\n> & {\n  /**\n   * The application shell. Mount it once, wrapping the router outlet:\n   *\n   * ```tsx\n   * function AdminRoute() {\n   *   const resource = Route.useParams({ select: (p) => p.resource });\n   *   return (\n   *     <Shell resource={resource}>\n   *       <Outlet />\n   *     </Shell>\n   *   );\n   * }\n   * ```\n   *\n   * Passing `resource` is optional: a page created by `createResourceLayout`\n   * reports its own resource to the shell automatically. Pass it for routes\n   * that render non-library content, or in tests and stories.\n   */\n  Shell: ResourceLayoutShellComponent<\n    Resources,\n    Options,\n    ShellComposables,\n    ShellIncludeProps,\n    ShellCustomProps\n  >;\n};\n\n/**\n * Signature of {@link defineResourceLayout.withLayout}.\n */\nexport type DefineResourceLayoutWithLayoutFn = <\n  const Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources> = {},\n  Composables extends ComposableComponents = {},\n  const IncludeProps extends LayoutIncludeProps<\n    Resources,\n    Options,\n    Composables\n  > = {},\n  CustomProps extends InPropsObject = {},\n  ShellComposables extends ComposableComponents = {},\n  const ShellIncludeProps extends LayoutIncludeProps<\n    Resources,\n    Options,\n    ShellComposables\n  > = {},\n  ShellCustomProps extends InPropsObject = {},\n>(\n  options: CreateResourceLayoutWithLayoutOptions<\n    Resources,\n    Options,\n    Composables,\n    IncludeProps,\n    CustomProps,\n    ShellComposables,\n    ShellIncludeProps,\n    ShellCustomProps\n  >,\n) => DefinedResourceLayoutWithShell<\n  Resources,\n  Options,\n  Composables,\n  IncludeProps,\n  CustomProps,\n  ShellComposables,\n  ShellIncludeProps,\n  ShellCustomProps\n>;\n\n/**\n * Loose runtime shape of a `shell` block, used by the impl below.\n */\ntype ShellLayoutRuntime = {\n  name?: string;\n  composables?: (create: unknown) => ComposableComponents;\n  props?: {\n    include?: Record<string, unknown>;\n    custom?: Record<string, unknown>;\n  };\n  render: (\n    props: Record<string, unknown>,\n    context: Record<string, unknown>,\n  ) => JSX.Element;\n};\n\n/**\n * Builds the `Shell` component. Kept beside {@link defineResourceLayoutImpl} so\n * it can reuse the same private prop-resolution helpers.\n *\n * Unlike a per-resource component, the shell re-reads the current resource on\n * every render (reported by the mounted page) so resource-scoped composable\n * *names* can update. Composable *component identities* are resolved once and\n * kept stable: React reconciles by element type, so recreating\n * `composables.Layout` each render would remount wrapWith targets, sidebar\n * state, and the outlet. Display names are synced onto those stable functions\n * when the resource changes.\n *\n * @param shellId - Identity of the owning `withLayout` definition. The shell\n *   only accepts resource reports tagged with this id, so a page or pane from a\n *   different definition rendered in the outlet cannot corrupt its state.\n */\nfunction createResourceLayoutShellComponent(\n  resources: ReadonlyArray<ResourceDefinition>,\n  inProps:\n    | InPropsObject\n    | ((opts: Record<string, unknown>) => InPropsObject),\n  shell: ShellLayoutRuntime,\n  shellId: symbol,\n) {\n  const shellName = shell.name ?? 'ResourceLayoutShell';\n  // `resources` is the wide `ResourceDefinition[]` here (not the const generic\n  // that `defineResourceLayoutImpl` captures), so the normalize/enum types are\n  // erased to keep TS from trying to instantiate them structurally. Only the\n  // runtime key list matters — the shell validates against it, it does not\n  // surface it in a public type.\n  const resourceKeys = Object.keys(\n    normalizeResources(resources as never) as Record<string, unknown>,\n  );\n  const resourcesEnum = createPrimitivePropBuilder('string').enum(\n    resourceKeys as never,\n  );\n\n  // `options` may be a function of `{ resource, name }`. The shell has no single\n  // resource, so — like the component path in `defineResourceLayoutImpl` — the\n  // enum stands in for `resource` while resolving the definitions.\n  const rawResolvedOptions =\n    typeof inProps === 'function'\n      ? inProps({\n          resource: resourcesEnum,\n          name: createProp.string().literal(shellName),\n        })\n      : inProps;\n  const { resolvedInProps, splitInProps } = splitLayoutInProps(\n    rawResolvedOptions as Record<string, unknown>,\n  );\n\n  const includeShellProps = shell.props?.include;\n  const includeShellPropKeys = Object.keys(includeShellProps ?? {});\n  const shellCustomDefinitions = {\n    ...(shell.props?.custom ?? {}),\n  } as Record<string, AnyBuiltPropDefinition>;\n\n  function syncShellComposableDisplayNames(\n    stable: ComposableComponents,\n    resource: string,\n  ) {\n    if (!shell.composables) {\n      return;\n    }\n\n    const named = resolveLayoutComposables(shell.composables as never, {\n      resource,\n      name: shellName,\n      capitalize,\n    } as never) as ComposableComponents;\n\n    for (const [key, component] of Object.entries(named)) {\n      const stableComponent = stable[key];\n\n      if (\n        typeof stableComponent === 'function' &&\n        typeof component === 'function' &&\n        'displayName' in component\n      ) {\n        (stableComponent as { displayName?: string }).displayName = (\n          component as { displayName?: string }\n        ).displayName;\n      }\n    }\n  }\n\n  function Shell(props: Record<string, unknown>) {\n    const { children: outlet, resource: resourceProp } = props as {\n      children: ReactNode;\n      resource?: string;\n    };\n\n    // Which resource is currently in the outlet. A per-resource page reports its\n    // own resource here on mount (see the layout effect in `Component`);\n    // `undefined` between pages or on a route with no per-resource layout. An\n    // explicit `resource` prop always wins.\n    const [reportedResource, setReportedResource] = useState<\n      string | undefined\n    >(undefined);\n    const publishResource = useCallback<ResourceLayoutShellPublisher>(\n      (resource, ownerId) => {\n        // Ignore reports from components that belong to a different\n        // `defineResourceLayout` definition — they share this context but their\n        // resource is unrelated to this shell.\n        if (ownerId !== shellId) {\n          return;\n        }\n\n        setReportedResource(resource);\n      },\n      [],\n    );\n    const resource = resourceProp ?? reportedResource;\n\n    // The outlet subtree must not re-render when `reportedResource` changes —\n    // only the shell chrome should. Memoising the wrapped element lets React\n    // bail out of reconciling the page while, say, the breadcrumb label updates.\n    const shellChildren = useMemo(\n      () => (\n        <ResourceLayoutShellPublisherContext.Provider value={publishResource}>\n          {outlet}\n        </ResourceLayoutShellPublisherContext.Provider>\n      ),\n      [outlet, publishResource],\n    );\n\n    // Resolve composables once so `<composables.Layout>` keeps a stable element\n    // type across Shell re-renders (including the layout-effect resource report).\n    // Re-resolving every render would allocate new component functions and React\n    // would remount the whole chrome tree. Names still track the live resource\n    // via {@link syncShellComposableDisplayNames}.\n    const composablesRef = useRef<ComposableComponents | undefined>(undefined);\n    if (shell.composables) {\n      const nameContextResource = resource ?? '';\n\n      if (!composablesRef.current) {\n        composablesRef.current = resolveLayoutComposables(\n          shell.composables as never,\n          {\n            resource: nameContextResource,\n            name: shellName,\n            capitalize,\n          } as never,\n        ) as ComposableComponents;\n      } else {\n        syncShellComposableDisplayNames(\n          composablesRef.current,\n          nameContextResource,\n        );\n      }\n    }\n    const resolvedComposables = composablesRef.current;\n    const validationContext = {\n      layoutName: shellName,\n      resource: resource ?? '',\n    };\n\n    const mergedResolvedInProps = { ...resolvedInProps } as Record<\n      string,\n      unknown\n    >;\n    for (const {\n      props: presetPropDefinitions,\n    } of collectComposablePresetEntries(resolvedComposables)) {\n      Object.assign(mergedResolvedInProps, presetPropDefinitions);\n    }\n\n    // Included props: definition-time defaults from `options`, overridden by\n    // anything passed to `<Shell>` (component passthrough). Computed before\n    // preset validation so config-passthrough includes can reuse the defaults.\n    const includedPropDefinitions = pick(\n      mergedResolvedInProps,\n      includeShellPropKeys,\n    ) as Record<string, unknown>;\n    const includedPropValues = {\n      ...resolvePropDefinitionValues(includedPropDefinitions),\n    } as Record<string, unknown>;\n\n    for (const key of includeShellPropKeys) {\n      const definition = mergedResolvedInProps[key];\n      const behavior = includeShellProps?.[key];\n      const callSiteValue = allowsComponentPassthrough(behavior)\n        ? readLayoutOptionValue(key, definition, props)\n        : undefined;\n      // Config passthrough has no create-time call on Shell; still honour\n      // literal / split defaults from `options` when present.\n      const configValue = allowsConfigPassthrough(behavior)\n        ? readLayoutOptionValue(key, definition, {\n            ...includedPropValues,\n            ...splitInProps,\n          })\n        : undefined;\n      const splitValue = key in splitInProps ? splitInProps[key] : undefined;\n      const value = callSiteValue ?? configValue ?? splitValue;\n\n      if (value !== undefined) {\n        includedPropValues[key] = value;\n      }\n    }\n\n    // Preset props: Shell has no create-time call. Component-passthrough values\n    // come from `<Shell>` props; config-passthrough values only from definition\n    // defaults. Required config includes without a default are omitted from\n    // validation — they are not typed on Shell and cannot be supplied.\n    const composablePresetProps = Object.fromEntries(\n      collectComposablePresetEntries(resolvedComposables).map(\n        ({ key, props: presetPropDefinitions }) => {\n          const entries = Object.entries(presetPropDefinitions);\n          const validatedDefinitions = Object.fromEntries(\n            entries.filter(([propKey]) => {\n              const behavior = includeShellProps?.[propKey];\n\n              if (behavior === undefined) {\n                return true;\n              }\n\n              if (allowsComponentPassthrough(behavior)) {\n                return true;\n              }\n\n              if (allowsConfigPassthrough(behavior)) {\n                return includedPropValues[propKey] !== undefined;\n              }\n\n              return false;\n            }),\n          );\n          const values = Object.fromEntries(\n            entries.flatMap(([propKey]) => {\n              if (propKey in props) {\n                return [[propKey, props[propKey]]];\n              }\n\n              if (includedPropValues[propKey] !== undefined) {\n                return [[propKey, includedPropValues[propKey]]];\n              }\n\n              return [];\n            }),\n          );\n\n          return [\n            key,\n            validateProps(\n              validatedDefinitions as Record<string, AnyBuiltPropDefinition>,\n              values,\n              validationContext,\n            ),\n          ];\n        },\n      ),\n    );\n\n    const validatedCustomProps = validateProps(\n      shellCustomDefinitions,\n      props,\n      validationContext,\n    );\n\n    const requiredIncludedDefinitions = Object.fromEntries(\n      Object.entries(includedPropDefinitions).filter(([key]) => {\n        const behavior = includeShellProps?.[key];\n\n        if (!isIncludedPropRequired(behavior)) {\n          return false;\n        }\n\n        // Component passthrough stays required on `<Shell>` (and is typed there).\n        if (allowsComponentPassthrough(behavior)) {\n          return true;\n        }\n\n        // Config passthrough: only require when a definition-time value exists.\n        return includedPropValues[key] !== undefined;\n      }),\n    );\n    const optionalIncludedDefinitions = Object.fromEntries(\n      Object.entries(includedPropDefinitions).filter(\n        ([key]) =>\n          !isIncludedPropRequired(includeShellProps?.[key]) &&\n          includedPropValues[key] !== undefined,\n      ),\n    );\n    const validatedIncludedProps = validateProps(\n      {\n        ...requiredIncludedDefinitions,\n        ...optionalIncludedDefinitions,\n      } as Record<string, AnyBuiltPropDefinition>,\n      includedPropValues,\n      validationContext,\n    );\n    const renderIncludedProps = Object.fromEntries(\n      includeShellPropKeys.flatMap((key) =>\n        key in validatedIncludedProps\n          ? [\n              [\n                toLayoutRenderPropKey(key, mergedResolvedInProps[key]),\n                validatedIncludedProps[\n                  key as keyof typeof validatedIncludedProps\n                ],\n              ],\n            ]\n          : [],\n      ),\n    );\n\n    const renderProps = { ...validatedCustomProps, ...renderIncludedProps };\n    const renderContext = {\n      composables: resolvedComposables,\n      resource,\n      resources: createLayoutRenderResourcesAccessor(\n        resources as ReadonlyArray<ResourceDefinition>,\n        resource as never,\n      ),\n      name: shellName,\n      inProps: splitInProps,\n      children: shellChildren,\n    };\n\n    const rendered = shell.render(renderProps, renderContext);\n\n    return resolvedComposables ? (\n      <LayoutComposablePresetProvider value={composablePresetProps}>\n        {rendered}\n      </LayoutComposablePresetProvider>\n    ) : (\n      rendered\n    );\n  }\n\n  return Object.assign(Shell, {\n    displayName: shellName,\n    props: undefined as never,\n  });\n}\n\n/**\n * Implementation of {@link defineResourceLayout.withLayout}. Delegates the\n * config / links / `createResourceLayout` pieces to {@link defineResourceLayoutImpl}\n * and adds the {@link createResourceLayoutShellComponent | Shell}.\n */\nfunction defineResourceLayoutWithLayoutImpl(\n  options: Record<string, unknown>,\n): Record<string, unknown> {\n  const {\n    shell,\n    layout,\n    resources,\n    options: inProps,\n  } = options as {\n    shell: ShellLayoutRuntime;\n    layout?: {\n      composables?: unknown;\n      props?: { include?: unknown; custom?: Record<string, unknown> };\n      render?: (\n        props: Record<string, unknown>,\n        context: unknown,\n      ) => JSX.Element;\n    };\n    resources: ReadonlyArray<ResourceDefinition>;\n    options?:\n      | InPropsObject\n      | ((opts: Record<string, unknown>) => InPropsObject);\n  };\n\n  // The per-resource `render` is optional under `withLayout`. When omitted, the\n  // page is a pure content slot: give it a `children` prop (so\n  // `<UsersPage>{content}</UsersPage>` type-checks and works) and a render that\n  // drops that content into the shell's outlet. An explicit `render` is passed\n  // through untouched.\n  const resolvedLayout = layout?.render\n    ? layout\n    : {\n        ...layout,\n        props: {\n          ...layout?.props,\n          custom: {\n            children: createProp.component({ type: 'ReactNode' }).optional(),\n            ...(layout?.props?.custom ?? {}),\n          },\n        },\n        render: (pageProps: Record<string, unknown>) => (\n          <>{(pageProps.children as ReactNode) ?? null}</>\n        ),\n      };\n\n  // Ties the shell to the pages created by *its* `createResourceLayout`. Pages\n  // from other definitions rendered in the outlet carry a different id (or\n  // none) and are ignored by the shell's resource tracking.\n  const shellId = Symbol('resourceLayoutShell');\n\n  const base = defineResourceLayoutImpl({\n    resources,\n    options: inProps,\n    layout: resolvedLayout,\n    shellId,\n  } as never) as Record<string, unknown>;\n\n  const Shell = createResourceLayoutShellComponent(\n    resources,\n    (inProps ?? {}) as never,\n    shell,\n    shellId,\n  );\n\n  return { ...base, Shell };\n}\n\nexport const defineResourceLayout: DefineResourceLayout = Object.assign(\n  defineResourceLayoutImpl as DefineResourceLayoutFn,\n  {\n    forResources: defineResourceLayoutForResources,\n    defineResources,\n    withLayout:\n      defineResourceLayoutWithLayoutImpl as unknown as DefineResourceLayoutWithLayoutFn,\n  },\n);\n"],"mappings":"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"}

package/dist/create-config/define-layout.d.cts

@@ -187,7 +187,19 @@ type DefinedResourceLayout<Resources extends ReadonlyArray<ResourceDefinition>,
    * the raw value, or `resources.pick(...)` / `resources.omit(...)` to filter.
    */
   resources: LayoutResourcesAccessor<Resources>;
+  /**
+   * Provides the current resource to descendants that call `useResource`.
+   * Components created by `createResourceLayout` install this provider
+   * automatically.
+   */
+  ResourceProvider: ResourceLayoutProvider<Resources>; /** Returns the nearest current resource. */
+  useResource: () => LayoutResourceKey<Resources>;
+};
+type ResourceLayoutProviderProps<Resources extends ReadonlyArray<ResourceDefinition>> = {
+  children: ReactNode;
+  resource: LayoutResourceKey<Resources>;
 };
+type ResourceLayoutProvider<Resources extends ReadonlyArray<ResourceDefinition>> = (props: ResourceLayoutProviderProps<Resources>) => JSX.Element;
 type DefineResourceLayoutForResourcesOptions<Resources extends ReadonlyArray<ResourceDefinition>, InProps extends InPropsDefinition<Resources> = {}, Composables extends ComposableComponents = {}, IncludeProps extends LayoutIncludeProps<Resources, InProps, Composables> = {}, CustomProps extends InPropsObject = {}, ExtraResources extends ReadonlyArray<ResourceDefinition> = []> = Omit<CreateViewMapOptions<Resources, InProps, Composables, IncludeProps, CustomProps>, 'resources'> & {
   /**
    * Additional resources to merge with those bound by
@@ -375,5 +387,5 @@ type DefinedResourceLayoutWithShell<Resources extends ReadonlyArray<ResourceDefi
 type DefineResourceLayoutWithLayoutFn = <const Resources extends ReadonlyArray<ResourceDefinition>, Options extends InPropsDefinition<Resources> = {}, Composables extends ComposableComponents = {}, const IncludeProps extends LayoutIncludeProps<Resources, Options, Composables> = {}, CustomProps extends InPropsObject = {}, ShellComposables extends ComposableComponents = {}, const ShellIncludeProps extends LayoutIncludeProps<Resources, Options, ShellComposables> = {}, ShellCustomProps extends InPropsObject = {}>(options: CreateResourceLayoutWithLayoutOptions<Resources, Options, Composables, IncludeProps, CustomProps, ShellComposables, ShellIncludeProps, ShellCustomProps>) => DefinedResourceLayoutWithShell<Resources, Options, Composables, IncludeProps, CustomProps, ShellComposables, ShellIncludeProps, ShellCustomProps>;
 declare const defineResourceLayout: DefineResourceLayout;
 //#endregion
-export { CreateResourceLayoutFn, CreateResourceLayoutMakeComposableOptions, CreateResourceLayoutWithLayoutOptions, DefineResourceLayout, DefineResourceLayoutFn, DefineResourceLayoutForResources, DefineResourceLayoutForResourcesFactory, DefineResourceLayoutWithLayoutFn, DefineResourcesFn, DefinedResourceLayoutWithShell, LayoutIncludeProps, LayoutProps, LayoutPropsForResource, LayoutRenderResourcesAccessor, LayoutResourcesAccessor, ResourceLayoutComponent, ResourceLayoutShellComponent, ResourceLayoutShellProps, ResourceSelection, ShellLayoutDefinition, ShellRenderContext, defineResourceLayout };
+export { CreateResourceLayoutFn, CreateResourceLayoutMakeComposableOptions, CreateResourceLayoutWithLayoutOptions, DefineResourceLayout, DefineResourceLayoutFn, DefineResourceLayoutForResources, DefineResourceLayoutForResourcesFactory, DefineResourceLayoutWithLayoutFn, DefineResourcesFn, DefinedResourceLayoutWithShell, LayoutIncludeProps, LayoutProps, LayoutPropsForResource, LayoutRenderResourcesAccessor, LayoutResourcesAccessor, ResourceLayoutComponent, ResourceLayoutProvider, ResourceLayoutProviderProps, ResourceLayoutShellComponent, ResourceLayoutShellProps, ResourceSelection, ShellLayoutDefinition, ShellRenderContext, defineResourceLayout };
 //# sourceMappingURL=define-layout.d.cts.map

package/dist/create-config/define-layout.d.cts.map

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

package/dist/create-config/define-layout.d.mts

@@ -187,7 +187,19 @@ type DefinedResourceLayout<Resources extends ReadonlyArray<ResourceDefinition>,
    * the raw value, or `resources.pick(...)` / `resources.omit(...)` to filter.
    */
   resources: LayoutResourcesAccessor<Resources>;
+  /**
+   * Provides the current resource to descendants that call `useResource`.
+   * Components created by `createResourceLayout` install this provider
+   * automatically.
+   */
+  ResourceProvider: ResourceLayoutProvider<Resources>; /** Returns the nearest current resource. */
+  useResource: () => LayoutResourceKey<Resources>;
+};
+type ResourceLayoutProviderProps<Resources extends ReadonlyArray<ResourceDefinition>> = {
+  children: ReactNode;
+  resource: LayoutResourceKey<Resources>;
 };
+type ResourceLayoutProvider<Resources extends ReadonlyArray<ResourceDefinition>> = (props: ResourceLayoutProviderProps<Resources>) => JSX.Element;
 type DefineResourceLayoutForResourcesOptions<Resources extends ReadonlyArray<ResourceDefinition>, InProps extends InPropsDefinition<Resources> = {}, Composables extends ComposableComponents = {}, IncludeProps extends LayoutIncludeProps<Resources, InProps, Composables> = {}, CustomProps extends InPropsObject = {}, ExtraResources extends ReadonlyArray<ResourceDefinition> = []> = Omit<CreateViewMapOptions<Resources, InProps, Composables, IncludeProps, CustomProps>, 'resources'> & {
   /**
    * Additional resources to merge with those bound by
@@ -375,5 +387,5 @@ type DefinedResourceLayoutWithShell<Resources extends ReadonlyArray<ResourceDefi
 type DefineResourceLayoutWithLayoutFn = <const Resources extends ReadonlyArray<ResourceDefinition>, Options extends InPropsDefinition<Resources> = {}, Composables extends ComposableComponents = {}, const IncludeProps extends LayoutIncludeProps<Resources, Options, Composables> = {}, CustomProps extends InPropsObject = {}, ShellComposables extends ComposableComponents = {}, const ShellIncludeProps extends LayoutIncludeProps<Resources, Options, ShellComposables> = {}, ShellCustomProps extends InPropsObject = {}>(options: CreateResourceLayoutWithLayoutOptions<Resources, Options, Composables, IncludeProps, CustomProps, ShellComposables, ShellIncludeProps, ShellCustomProps>) => DefinedResourceLayoutWithShell<Resources, Options, Composables, IncludeProps, CustomProps, ShellComposables, ShellIncludeProps, ShellCustomProps>;
 declare const defineResourceLayout: DefineResourceLayout;
 //#endregion
-export { CreateResourceLayoutFn, CreateResourceLayoutMakeComposableOptions, CreateResourceLayoutWithLayoutOptions, DefineResourceLayout, DefineResourceLayoutFn, DefineResourceLayoutForResources, DefineResourceLayoutForResourcesFactory, DefineResourceLayoutWithLayoutFn, DefineResourcesFn, DefinedResourceLayoutWithShell, LayoutIncludeProps, LayoutProps, LayoutPropsForResource, LayoutRenderResourcesAccessor, LayoutResourcesAccessor, ResourceLayoutComponent, ResourceLayoutShellComponent, ResourceLayoutShellProps, ResourceSelection, ShellLayoutDefinition, ShellRenderContext, defineResourceLayout };
+export { CreateResourceLayoutFn, CreateResourceLayoutMakeComposableOptions, CreateResourceLayoutWithLayoutOptions, DefineResourceLayout, DefineResourceLayoutFn, DefineResourceLayoutForResources, DefineResourceLayoutForResourcesFactory, DefineResourceLayoutWithLayoutFn, DefineResourcesFn, DefinedResourceLayoutWithShell, LayoutIncludeProps, LayoutProps, LayoutPropsForResource, LayoutRenderResourcesAccessor, LayoutResourcesAccessor, ResourceLayoutComponent, ResourceLayoutProvider, ResourceLayoutProviderProps, ResourceLayoutShellComponent, ResourceLayoutShellProps, ResourceSelection, ShellLayoutDefinition, ShellRenderContext, defineResourceLayout };
 //# sourceMappingURL=define-layout.d.mts.map