@jfdevelops/react-layout 0.18.1 → 0.19.0

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

@@ -12,6 +12,16 @@ let _jfdevelops_react_layout_validator = require("@jfdevelops/react-layout-valid
 let react_jsx_runtime = require("react/jsx-runtime");
 
 //#region src/create-config/define-layout.tsx
+function createLayoutResourcesAccessor(resources) {
+	const accessor = (() => resources);
+	accessor.isResource = require_resource.createIsValidResourceFn(resources);
+	accessor.omit = ((...keys) => resources.filter((resource) => !keys.includes(readResourceSlug(resource))));
+	accessor.pick = ((...keys) => resources.filter((resource) => keys.includes(readResourceSlug(resource))));
+	return accessor;
+}
+function createLayoutRenderResourcesAccessor(resources, current) {
+	return Object.assign(createLayoutResourcesAccessor(resources), { current });
+}
 function isBuiltPropDefinition(value) {
 	return typeof value === "function" && value !== null && "visibility" in value;
 }
@@ -82,6 +92,7 @@ function assertUnreservedResourceSlugs(resources, owner) {
 function defineResourceLayoutImpl(options) {
 	const { options: inProps = {}, resources, layout } = options;
 	assertUnreservedResourceSlugs(resources);
+	const resourcesAccessor = createLayoutResourcesAccessor(resources);
 	const normalizedResources = require_resource.normalizeResources(resources);
 	const resourcesEnum = (0, _jfdevelops_react_layout_validator.createPrimitivePropBuilder)("string").enum(require_resource.toResourceEnum(normalizedResources));
 	const definedResourceLayout = ((layoutOptions) => {
@@ -123,6 +134,7 @@ function defineResourceLayoutImpl(options) {
 		const mergedRenderContext = {
 			composables: resolvedComposables,
 			resource: layoutContext.resource,
+			resources: createLayoutRenderResourcesAccessor(resources, layoutContext.resource),
 			name: layoutContext.name,
 			inProps: splitInProps
 		};
@@ -213,9 +225,13 @@ function defineResourceLayoutImpl(options) {
 	return {
 		createResourceConfig: require_get_component.createResourceConfig,
 		createResourceLayout: Object.assign(definedResourceLayout, createResourceLayoutExtras),
-		createResourceLinks: require_create_resource_links.createResourceLinksFn(resources)
+		createResourceLinks: require_create_resource_links.createResourceLinksFn(resources),
+		resources: resourcesAccessor
 	};
 }
+function defineResources(...resources) {
+	return resources;
+}
 function defineResourceLayoutForResources(...baseResources) {
 	return ((options) => {
 		const { resources: extraResources, ...rest } = options;
@@ -226,7 +242,10 @@ function defineResourceLayoutForResources(...baseResources) {
 		});
 	});
 }
-const defineResourceLayout = Object.assign(defineResourceLayoutImpl, { forResources: defineResourceLayoutForResources });
+const defineResourceLayout = Object.assign(defineResourceLayoutImpl, {
+	forResources: defineResourceLayoutForResources,
+	defineResources
+});
 
 //#endregion
 exports.defineResourceLayout = defineResourceLayout;

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

@@ -1 +1 @@
-{"version":3,"file":"define-layout.cjs","names":["capitalize","functionalUpdate","isResourceConfigComponentKey","InvalidConfigError","normalizeResources","toResourceEnum","createProp","pick","LayoutComposablePresetProvider","createForResource","createForResources","createResourceLinksFn"],"sources":["../../src/create-config/define-layout.tsx"],"sourcesContent":["import type { JSX } 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  normalizeResources,\n  toResourceEnum,\n  type LayoutResourceKey,\n  type ResourceDefinition,\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';\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  resource: LayoutResourceKey<Resources>;\n  name: string;\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\n    ? behavior.passthrough === 'component'\n    : 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\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: {\n    /**\n     * The props to pass to the layout.\n     */\n    props?: LayoutProps<\n      Resources,\n      Options,\n      Composables,\n      IncludeProps,\n      CustomProps\n    >;\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};\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\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\n  assertUnreservedResourceSlugs(resources);\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(\n              ([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          );\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<\n                string,\n                AnyBuiltPropDefinition\n              >,\n              presetPropValues,\n              validationContext,\n            ),\n          ];\n        },\n      ),\n    );\n    const mergedRenderContext = {\n      composables: resolvedComposables as LayoutRenderComposables<Composables>,\n      resource: layoutContext.resource,\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 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(\n          ([key]) => 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  } 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\nexport type DefineResourceLayout = DefineResourceLayoutFn & {\n  forResources: DefineResourceLayoutForResources;\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\nexport const defineResourceLayout: DefineResourceLayout = Object.assign(\n  defineResourceLayoutImpl as DefineResourceLayoutFn,\n  {\n    forResources: defineResourceLayoutForResources,\n  },\n);\n"],"mappings":";;;;;;;;;;;;;;AA+GA,SAAS,sBACP,OACiC;CACjC,OAAO,OAAO,UAAU,cAAc,UAAU,QAAQ,gBAAgB;AAC1E;AAEA,SAAS,8BACP,OACsC;CACtC,OACE,UAAU,QACV,OAAO,UAAU,YACjB,YAAY,SACX,MAA+B,WAAW;AAE/C;AAEA,SAAS,uBACP,YACgE;CAChE,OACE,sBAAsB,UAAU,KAChC,UAAU,cACV,WAAW,SAAS;AAExB;AAEA,SAAS,sBAAsB,YAAoB,YAAqB;CACtE,OAAO,uBAAuB,UAAU,IACpCA,8BAAW,UAAU,IACrB;AACN;AAEA,SAAS,sBACP,YACA,YACA,SACA;CACA,MAAM,mBAAmB,uBAAuB,UAAU,IACtD,CAACA,8BAAW,UAAU,GAAG,UAAU,IACnC,CAAC,YAAYA,8BAAW,UAAU,CAAC;CAEvC,KAAK,MAAM,OAAO,kBAChB,IAAI,OAAO,SACT,OAAO,QAAQ;AAKrB;AAEA,SAAS,wBAAwB,OAA6C;CAC5E,IACE,UAAU,QACV,OAAO,UAAU,YACjB,gBAAgB,SAChB,iBAAiB,OAEjB,OAAO;CAGT,OAAO;AACT;AAEA,SAAS,uBAAuB,OAAgB;CAC9C,OACE,UAAU,QACV,UAAU,cACV,wBAAwB,KAAK,GAAG,eAAe;AAEnD;AAEA,SAAS,wBAAwB,OAAgB;CAC/C,MAAM,WAAW,wBAAwB,KAAK;CAE9C,IAAI,CAAC,UACH,OAAO;CAGT,IAAI,SAAS,gBAAgB,UAC3B,OAAO;CAIT,OACE,SAAS,gBAAgB,eAAe,SAAS,eAAe;AAEpE;AAEA,SAAS,2BAA2B,OAAgB;CAClD,MAAM,WAAW,wBAAwB,KAAK;CAE9C,OAAO,WACH,SAAS,gBAAgB,cACzB,UAAU;AAChB;AAEA,SAAS,mBAAmB,SAAkC;CAC5D,MAAM,kBAA0D,CAAC;CACjE,MAAM,eAAwC,CAAC;CAE/C,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,OAAO,GAAG;EAClD,IAAI,sBAAsB,KAAK,GAAG;GAChC,gBAAgB,OAAO;GACvB;EACF;EAEA,IAAI,8BAA8B,KAAK,GAAG;GACxC,aAAa,OAAO,MAAM;GAE1B,IAAI,MAAM,SAAS,OAAO,MAAM,UAAU,UACxC,OAAO,OAAO,iBAAiB,MAAM,KAAK;EAE9C;CACF;CAEA,OAAO;EACL;EACA;CACF;AACF;AAEA,SAAS,4BACP,UACA,SACA;CACA,MAAM,WAAW,EAAE,GAAG,QAAQ;CAE9B,KAAK,MAAM,CAAC,KAAK,iBAAiB,OAAO,QAAQ,QAAQ,GACvD,IAAI,OAAO,SACT,IAAI,OAAO,iBAAiB,YAC1B,SAAS,OAAO,QAAQ;MAExB,SAAS,OAAOC,+BACd,cACA,QAAQ,IACV;CAKN,OAAO;AACT;AAwPA,SAAS,iBAAiB,UAA8B;CACtD,OAAO,OAAO,aAAa,WAAW,WAAW,SAAS;AAC5D;AAEA,SAAS,8BACP,WACA,OACA;CACA,KAAK,MAAM,YAAY,WAAW;EAChC,MAAM,OAAO,iBAAiB,QAAQ;EAEtC,IAAI,UAAU,UAAaC,oDAA6B,IAAI,GAC1D,MAAM,IAAIC,0CAAmB,EAC3B,QAAQ,iBAAiB,KAAK,WAAW,MAAM,uCACjD,CAAC;EAGH,IAAI,OAAO,aAAa,UACtB,8BAA8B,SAAS,cAAc,IAAI;CAE7D;AACF;AAEA,SAAS,yBAWP,SAaA;CACA,MAAM,EAAE,SAAS,UAAU,CAAC,GAAc,WAAW,WAAW;CAEhE,8BAA8B,SAAS;CAEvC,MAAM,sBAAsBC,oCAAmB,SAAS;CACxD,MAAM,mFAA2C,QAAQ,EAAE,KACzDC,gCAAe,mBAAmB,CACpC;CACA,MAAM,0BAKJ,kBASG;EACH,MAAM,EACJ,MACA,OAAO,yBACP,GAAG,sBACD;EACJ,MAAM,kFASF;EACJ,MAAM,WAAWC,8CAAW,OAAO,EAAE,QAAQ,IAAI;EAQjD,MAAM,EAAE,iBAAiB,iBAAiB,mBAAmB;GAC3D,GAPA,OAAO,YAAY,aACf,QAAQ;IACN,UAAU;IACV,MAAM;GACR,CAAC,IACD;GAGJ,GAAI;GACJ,GAAG;EACL,CAAC;EACD,MAAM,EAAE,aAAa,QAAQ,OAAO,gBAAgB;EACpD,MAAM,oBAAoB,aAAa;EACvC,MAAM,qBAAqB,aAAa;EACxC,MAAM,qBAAqB;EAC3B,MAAM,sBAAsB,EAC1B,GAAG,kBACL;EACA,MAAM,gBAGF;GACF,UAAU,cAAc;GACxB;GACA;EACF;EACA,MAAM,oBAAoB;GACxB,YAAY;GACZ,UAAU,cAAc;EAC1B;EACA,MAAM,sBAAsB,iFACC,aAAa,aAAa,IACnD;EACJ,MAAM,wBAAwB,EAAE,GAAG,gBAAgB;EAEnD,KAAK,MAAM,EACT,OAAO,oGAC2B,mBAAmB,GACrD,OAAO,OAAO,uBAAuB,qBAAqB;EAG5D,MAAM,wBAAwB,OAAO,qFACJ,mBAAmB,EAAE,KACjD,EAAE,KAAK,OAAO,4BAA4B;GACzC,MAAM,oBAAoB,OAAO,QAAQ,qBAAqB;GAuB9D,OAAO,CACL,2DAvB2B,OAAO,YAClC,kBAAkB,QACf,CAAC,aAAa;IACb,MAAM,kBAAkB,qBAAqB;IAE7C,OACE,oBAAoB,UACnB,wBAAwB,eAAe,MACrC,uBAAuB,eAAe,KACrC,mBAAmB,aAAa;GAExC,CACF,CAaqB,GAXE,OAAO,YAC9B,kBAAkB,SAAS,CAAC,aAC1B,WAAW,qBACP,CAAC,CAAC,SAAS,mBAAmB,QAAQ,CAAC,IACvC,CAAC,CACP,CAUiB,GACf,iBACF,CACF;EACF,CACF,CACF;EACA,MAAM,sBAAsB;GAC1B,aAAa;GACb,UAAU,cAAc;GACxB,MAAM,cAAc;GACpB,SAAS;EACX;EAEA,SAAS,UACP,OAOA;GACA,MAAM,uEAA+B,qBAAqB,OAAO,EAC/D,GAAG,kBACL,CAAC;GACD,MAAM,mBAAmB,OAAO,KAAK,sBAAsB,CAAC,CAAC;GAC7D,MAAM,0BAA0BC,mBAC9B,uBACA,gBACF;GACA,MAAM,qBAAqB,EACzB,uEAA+B,uBAAuB,EACxD;GAEA,KAAK,MAAM,OAAO,kBAAkB;IAClC,MAAM,aAAa,sBAAsB;IACzC,MAAM,kBAAkB,qBAAqB;IAC7C,MAAM,gBAAgB,2BAA2B,eAAe,IAC5D,sBACE,KACA,YACA,KACF,IACA;IACJ,MAAM,oBAAoB,wBAAwB,eAAe,IAC7D,sBAAsB,KAAK,YAAY,kBAAkB,IACzD;IACJ,MAAM,aAAa,OAAO,eAAe,aAAa,OAAO;IAC7D,MAAM,QAAQ,iBAAiB,qBAAqB;IAEpD,IAAI,UAAU,QACZ,mBAAmB,OAAO;GAE9B;GAEA,MAAM,kCAAkC,OAAO,YAC7C,OAAO,QAAQ,uBAAuB,EAAE,QACrC,CAAC,SAAS,uBAAuB,qBAAqB,IAAI,CAC7D,CACF;GACA,MAAM,kCAAkC,OAAO,YAC7C,OAAO,QAAQ,uBAAuB,EAAE,QACrC,CAAC,SACA,CAAC,uBAAuB,qBAAqB,IAAI,KACjD,mBAAmB,SAAS,MAChC,CACF;GACA,MAAM,+EACJ;IACE,GAAG;IACH,GAAG;GACL,GACA,oBACA,iBACF;GACA,MAAM,4BAA4B,OAAO,YACvC,iBAAiB,SAAS,QAAQ;IAChC,IAAI,EAAE,OAAO,yBACX,OAAO,CAAC;IAGV,OAAO,CACL,CACE,sBAAsB,KAAK,sBAAsB,IAAI,GACrD,uBACE,IAEJ,CACF;GACF,CAAC,CACH;GAYA,OACE,2CAACC,qEAAD;IAAgC,OAAO;cACpC,OAAO;KAZV,GAAG;KACH,GAAG;IAWuB,GAAG,mBAAmB;GAChB;EAEpC;EAEA,SAAS,kBAGP,oBAA6B;GAC7B,IAAI,CAAC,mBAAmB,YACtB,OAAO,CAAC;GAGV,OAAO,EACL,gBAAgB,uBACd,kBACF,EACF;EACF;EAEA,OAAO,OAAO,OAAO,WAAW;GAC9B,aAAa;GACb,OAAO;GAOP,UAAU;GACV,GAAG,kBAAkB;IACnB,YAAY;IACZ;GACF,CAAC;EACH,CAAC;CACH;CAOA,MAAM,qCAAqC;EACzC,QAAQ,YAAqC;GAC3C,MAAM,SAAS,sBAAsB,OAAgB;GAErD,IACE,EAAE,oBAAoB,WACtB,OAAO,OAAO,mBAAmB,YAEjC,MAAM,IAAI,MACR,iEACF;GAGF,OAAO,OAAO,eAAe;EAC/B;CACF;CAEA,SAAS,4BAA4B,UAAwC;EAC3E,MAAM,gBAAgB;EAQtB,MAAM,EAAE,oBAAoB,mBAN1B,OAAO,YAAY,aACf,QAAQ;GACN,UAAU;GACV,MAAMF,8CAAW,OAAO,EAAE,QAAQ,aAAa;EACjD,CAAC,IACD,OAGN;EACA,MAAM,sBAAsB,OAAO,iFACN,OAAO,aAAa;GAC3C;GACA,MAAM;GACN;EACF,CAAC,IACD;EAEJ,KAAK,MAAM,EACT,OAAO,oGAC2B,mBAAmB,GACrD,OAAO,OAAO,iBAAiB,qBAAqB;EAGtD,OAAO;GACL,GAAG;GACH,GAAG,OAAO,OAAO;EACnB;CACF;CAEA,MAAM,EAAE,gCAAgC,gBAAgBG,uCAMtD;EACA,sBAAsB;EACtB;CACF,CAAC;CAgBD,MAAM,6BAgBF;EACF;EACA,cAjCmBC,gDAMnB;GACA,yBAAyB;GACzB,GAAI,OAAO,cACP,EAAE,4BAA4B,6BAA6B,IAC3D,CAAC;GACL,sBAAsB;GACtB;EACF,CAoBa;CACb;CAEA,IAAI,OAAO,aACT,2BAA2B,iBAAiB,6BAA6B;CAgB3E,OAAO;EACL;EACA,sBAf2B,OAAO,OAClC,uBACA,0BAamB;EACnB,qBAL0BC,oDAAsB,SAK9B;CACpB;AAOF;AA4GA,SAAS,iCAGP,GAAG,eACiD;CACpD,SAAS,YAAY;EACnB,MAAM,EAAE,WAAW,gBAAgB,GAAG,SAAS;EAC/C,MAAM,YAAY,iBACd,CAAC,GAAG,eAAe,GAAG,cAAc,IACpC,CAAC,GAAG,aAAa;EAErB,OAAO,yBAAyB;GAC9B,GAAG;GACH;EACF,CAAU;CACZ;AACF;AAEA,MAAa,uBAA6C,OAAO,OAC/D,0BACA,EACE,cAAc,iCAChB,CACF"}
+{"version":3,"file":"define-layout.cjs","names":["createIsValidResourceFn","capitalize","functionalUpdate","isResourceConfigComponentKey","InvalidConfigError","normalizeResources","toResourceEnum","createProp","pick","LayoutComposablePresetProvider","createForResource","createForResources","createResourceLinksFn"],"sources":["../../src/create-config/define-layout.tsx"],"sourcesContent":["import type { JSX } 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} 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';\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\ntype PickResourceDefinitions<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Keys extends LayoutResourceKey<Resources>,\n> = Array<Extract<Resources[number], Keys | { value: Keys }>>;\n\ntype OmitResourceDefinitions<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Keys extends LayoutResourceKey<Resources>,\n> = Array<Exclude<Resources[number], Keys | { value: Keys }>>;\n\n/**\n * Accessor for the resources bound to a `defineResourceLayout` definition.\n *\n * - `resources()` returns the raw resources.\n * - `resources.omit(...keys)` returns the resources except for the omitted ones.\n * - `resources.pick(...keys)` returns only the picked resources.\n * - `resources.isResource(value)` narrows an unknown value to a resource key.\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   * Returns the declared resources with the named ones removed, preserving the\n   * order and shape of the remaining definitions.\n   *\n   * @param keys - Top-level resource names to exclude.\n   */\n  omit<Keys extends LayoutResourceKey<Resources>>(\n    ...keys: Keys[]\n  ): Show<OmitResourceDefinitions<Resources, Keys>>;\n  /**\n   * Returns only the declared resources matching the named ones, preserving the\n   * order and shape of the selected definitions.\n   *\n   * @param keys - Top-level resource names to keep.\n   */\n  pick<Keys extends LayoutResourceKey<Resources>>(\n    ...keys: Keys[]\n  ): Show<PickResourceDefinitions<Resources, Keys>>;\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 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    resources.filter(\n      (resource) => !keys.includes(readResourceSlug(resource)),\n    )) as LayoutResourcesAccessor<Resources>['omit'];\n  accessor.pick = ((...keys: string[]) =>\n    resources.filter((resource) =>\n      keys.includes(readResourceSlug(resource)),\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\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: {\n    /**\n     * The props to pass to the layout.\n     */\n    props?: LayoutProps<\n      Resources,\n      Options,\n      Composables,\n      IncludeProps,\n      CustomProps\n    >;\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};\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\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 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\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\nexport const defineResourceLayout: DefineResourceLayout = Object.assign(\n  defineResourceLayoutImpl as DefineResourceLayoutFn,\n  {\n    forResources: defineResourceLayoutForResources,\n    defineResources,\n  },\n);\n"],"mappings":"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"}

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

@@ -25,9 +25,69 @@ type LayoutProps<Resources extends ReadonlyArray<ResourceDefinition>, Options ex
 type LayoutRenderContext<Resources extends ReadonlyArray<ResourceDefinition>, Composables extends ComposableComponents> = {
   composables: LayoutRenderComposables<Composables>;
   inProps: Record<string, unknown>;
+  /**
+   * @deprecated Use `resources.current` instead. `resource` will be removed in
+   * the next major version.
+   */
   resource: LayoutResourceKey<Resources>;
+  /**
+   * Accessor for the resources bound to this definition. Read `resources.current`
+   * for the resource this instance renders, call `resources()` for the raw
+   * value, use `resources.pick(...)` / `resources.omit(...)` to filter, or
+   * `resources.isResource(...)` to narrow an unknown value.
+   */
+  resources: LayoutRenderResourcesAccessor<Resources>;
   name: string;
 };
+type PickResourceDefinitions<Resources extends ReadonlyArray<ResourceDefinition>, Keys extends LayoutResourceKey<Resources>> = Array<Extract<Resources[number], Keys | {
+  value: Keys;
+}>>;
+type OmitResourceDefinitions<Resources extends ReadonlyArray<ResourceDefinition>, Keys extends LayoutResourceKey<Resources>> = Array<Exclude<Resources[number], Keys | {
+  value: Keys;
+}>>;
+/**
+ * Accessor for the resources bound to a `defineResourceLayout` definition.
+ *
+ * - `resources()` returns the raw resources.
+ * - `resources.omit(...keys)` returns the resources except for the omitted ones.
+ * - `resources.pick(...keys)` returns only the picked resources.
+ * - `resources.isResource(value)` narrows an unknown value to a resource key.
+ */
+type LayoutResourcesAccessor<Resources extends ReadonlyArray<ResourceDefinition>> = {
+  /**
+   * Returns the raw `resources` value passed to `defineResourceLayout`,
+   * exactly as declared.
+   */
+  (): Resources;
+  /**
+   * Narrows an unknown value to one of this definition's top-level resource
+   * keys.
+   *
+   * @param value - The value to test.
+   */
+  isResource(value: unknown): value is LayoutResourceKey<Resources>;
+  /**
+   * Returns the declared resources with the named ones removed, preserving the
+   * order and shape of the remaining definitions.
+   *
+   * @param keys - Top-level resource names to exclude.
+   */
+  omit<Keys extends LayoutResourceKey<Resources>>(...keys: Keys[]): Show<OmitResourceDefinitions<Resources, Keys>>;
+  /**
+   * Returns only the declared resources matching the named ones, preserving the
+   * order and shape of the selected definitions.
+   *
+   * @param keys - Top-level resource names to keep.
+   */
+  pick<Keys extends LayoutResourceKey<Resources>>(...keys: Keys[]): Show<PickResourceDefinitions<Resources, Keys>>;
+};
+/**
+ * Render-scoped {@link LayoutResourcesAccessor}, extended with `current` — the
+ * resource key the layout instance is rendering for.
+ */
+type LayoutRenderResourcesAccessor<Resources extends ReadonlyArray<ResourceDefinition>> = LayoutResourcesAccessor<Resources> & {
+  /** The resource this layout instance is rendering for. */readonly current: LayoutResourceKey<Resources>;
+};
 type LayoutRenderComposables<Composables extends ComposableComponents> = [keyof Composables] extends [never] ? undefined : Composables;
 type CreateViewMapOptions<Resources extends ReadonlyArray<ResourceDefinition>, Options extends InPropsDefinition<Resources> = {}, Composables extends ComposableComponents = {}, IncludeProps extends LayoutIncludeProps<Resources, Options, Composables> = {}, CustomProps extends InPropsObject = {}> = {
   /**
@@ -89,6 +149,11 @@ type DefinedResourceLayout<Resources extends ReadonlyArray<ResourceDefinition>,
   createResourceConfig: CreateResourceConfigFn<Resources>;
   createResourceLayout: CreateResourceLayoutFn<Resources, InProps, Composables, IncludeProps, CustomProps>;
   createResourceLinks: CreateResourceLinksFn<Resources>;
+  /**
+   * Accessor for the resources bound to this definition. Call `resources()` for
+   * the raw value, or `resources.pick(...)` / `resources.omit(...)` to filter.
+   */
+  resources: LayoutResourcesAccessor<Resources>;
 };
 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'> & {
   /**
@@ -113,10 +178,21 @@ type DefineResourceLayoutForResources = <const Resources extends NonEmptyResourc
 type DefineResourceLayoutFn = {
   <const Resources extends ReadonlyArray<ResourceDefinition>, InProps extends InPropsDefinition<Resources> = {}, Composables extends ComposableComponents = {}, const IncludeProps extends LayoutIncludeProps<Resources, InProps, Composables> = {}, CustomProps extends InPropsObject = {}>(options: CreateViewMapOptions<Resources, InProps, Composables, IncludeProps, CustomProps>): DefinedResourceLayout<Resources, InProps, Composables, IncludeProps, CustomProps>;
 };
+/**
+ * Captures a `resources` array with its literal tuple type intact, so it can be
+ * declared separately from the `defineResourceLayout` call without needing an
+ * `as const` assertion.
+ */
+type DefineResourcesFn = <const Resources extends ReadonlyArray<ResourceDefinition>>(...resources: Resources) => Resources;
 type DefineResourceLayout = DefineResourceLayoutFn & {
   forResources: DefineResourceLayoutForResources;
+  /**
+   * Builds a strongly-typed `resources` array to pass to `defineResourceLayout`
+   * (or `defineResourceLayout.forResources`) without an `as const` assertion.
+   */
+  defineResources: DefineResourcesFn;
 };
 declare const defineResourceLayout: DefineResourceLayout;
 //#endregion
-export { CreateResourceLayoutFn, CreateResourceLayoutMakeComposableOptions, DefineResourceLayout, DefineResourceLayoutFn, DefineResourceLayoutForResources, DefineResourceLayoutForResourcesFactory, LayoutIncludeProps, LayoutProps, LayoutPropsForResource, ResourceLayoutComponent, defineResourceLayout };
+export { CreateResourceLayoutFn, CreateResourceLayoutMakeComposableOptions, DefineResourceLayout, DefineResourceLayoutFn, DefineResourceLayoutForResources, DefineResourceLayoutForResourcesFactory, DefineResourcesFn, LayoutIncludeProps, LayoutProps, LayoutPropsForResource, LayoutRenderResourcesAccessor, LayoutResourcesAccessor, ResourceLayoutComponent, 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

@@ -25,9 +25,69 @@ type LayoutProps<Resources extends ReadonlyArray<ResourceDefinition>, Options ex
 type LayoutRenderContext<Resources extends ReadonlyArray<ResourceDefinition>, Composables extends ComposableComponents> = {
   composables: LayoutRenderComposables<Composables>;
   inProps: Record<string, unknown>;
+  /**
+   * @deprecated Use `resources.current` instead. `resource` will be removed in
+   * the next major version.
+   */
   resource: LayoutResourceKey<Resources>;
+  /**
+   * Accessor for the resources bound to this definition. Read `resources.current`
+   * for the resource this instance renders, call `resources()` for the raw
+   * value, use `resources.pick(...)` / `resources.omit(...)` to filter, or
+   * `resources.isResource(...)` to narrow an unknown value.
+   */
+  resources: LayoutRenderResourcesAccessor<Resources>;
   name: string;
 };
+type PickResourceDefinitions<Resources extends ReadonlyArray<ResourceDefinition>, Keys extends LayoutResourceKey<Resources>> = Array<Extract<Resources[number], Keys | {
+  value: Keys;
+}>>;
+type OmitResourceDefinitions<Resources extends ReadonlyArray<ResourceDefinition>, Keys extends LayoutResourceKey<Resources>> = Array<Exclude<Resources[number], Keys | {
+  value: Keys;
+}>>;
+/**
+ * Accessor for the resources bound to a `defineResourceLayout` definition.
+ *
+ * - `resources()` returns the raw resources.
+ * - `resources.omit(...keys)` returns the resources except for the omitted ones.
+ * - `resources.pick(...keys)` returns only the picked resources.
+ * - `resources.isResource(value)` narrows an unknown value to a resource key.
+ */
+type LayoutResourcesAccessor<Resources extends ReadonlyArray<ResourceDefinition>> = {
+  /**
+   * Returns the raw `resources` value passed to `defineResourceLayout`,
+   * exactly as declared.
+   */
+  (): Resources;
+  /**
+   * Narrows an unknown value to one of this definition's top-level resource
+   * keys.
+   *
+   * @param value - The value to test.
+   */
+  isResource(value: unknown): value is LayoutResourceKey<Resources>;
+  /**
+   * Returns the declared resources with the named ones removed, preserving the
+   * order and shape of the remaining definitions.
+   *
+   * @param keys - Top-level resource names to exclude.
+   */
+  omit<Keys extends LayoutResourceKey<Resources>>(...keys: Keys[]): Show<OmitResourceDefinitions<Resources, Keys>>;
+  /**
+   * Returns only the declared resources matching the named ones, preserving the
+   * order and shape of the selected definitions.
+   *
+   * @param keys - Top-level resource names to keep.
+   */
+  pick<Keys extends LayoutResourceKey<Resources>>(...keys: Keys[]): Show<PickResourceDefinitions<Resources, Keys>>;
+};
+/**
+ * Render-scoped {@link LayoutResourcesAccessor}, extended with `current` — the
+ * resource key the layout instance is rendering for.
+ */
+type LayoutRenderResourcesAccessor<Resources extends ReadonlyArray<ResourceDefinition>> = LayoutResourcesAccessor<Resources> & {
+  /** The resource this layout instance is rendering for. */readonly current: LayoutResourceKey<Resources>;
+};
 type LayoutRenderComposables<Composables extends ComposableComponents> = [keyof Composables] extends [never] ? undefined : Composables;
 type CreateViewMapOptions<Resources extends ReadonlyArray<ResourceDefinition>, Options extends InPropsDefinition<Resources> = {}, Composables extends ComposableComponents = {}, IncludeProps extends LayoutIncludeProps<Resources, Options, Composables> = {}, CustomProps extends InPropsObject = {}> = {
   /**
@@ -89,6 +149,11 @@ type DefinedResourceLayout<Resources extends ReadonlyArray<ResourceDefinition>,
   createResourceConfig: CreateResourceConfigFn<Resources>;
   createResourceLayout: CreateResourceLayoutFn<Resources, InProps, Composables, IncludeProps, CustomProps>;
   createResourceLinks: CreateResourceLinksFn<Resources>;
+  /**
+   * Accessor for the resources bound to this definition. Call `resources()` for
+   * the raw value, or `resources.pick(...)` / `resources.omit(...)` to filter.
+   */
+  resources: LayoutResourcesAccessor<Resources>;
 };
 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'> & {
   /**
@@ -113,10 +178,21 @@ type DefineResourceLayoutForResources = <const Resources extends NonEmptyResourc
 type DefineResourceLayoutFn = {
   <const Resources extends ReadonlyArray<ResourceDefinition>, InProps extends InPropsDefinition<Resources> = {}, Composables extends ComposableComponents = {}, const IncludeProps extends LayoutIncludeProps<Resources, InProps, Composables> = {}, CustomProps extends InPropsObject = {}>(options: CreateViewMapOptions<Resources, InProps, Composables, IncludeProps, CustomProps>): DefinedResourceLayout<Resources, InProps, Composables, IncludeProps, CustomProps>;
 };
+/**
+ * Captures a `resources` array with its literal tuple type intact, so it can be
+ * declared separately from the `defineResourceLayout` call without needing an
+ * `as const` assertion.
+ */
+type DefineResourcesFn = <const Resources extends ReadonlyArray<ResourceDefinition>>(...resources: Resources) => Resources;
 type DefineResourceLayout = DefineResourceLayoutFn & {
   forResources: DefineResourceLayoutForResources;
+  /**
+   * Builds a strongly-typed `resources` array to pass to `defineResourceLayout`
+   * (or `defineResourceLayout.forResources`) without an `as const` assertion.
+   */
+  defineResources: DefineResourcesFn;
 };
 declare const defineResourceLayout: DefineResourceLayout;
 //#endregion
-export { CreateResourceLayoutFn, CreateResourceLayoutMakeComposableOptions, DefineResourceLayout, DefineResourceLayoutFn, DefineResourceLayoutForResources, DefineResourceLayoutForResourcesFactory, LayoutIncludeProps, LayoutProps, LayoutPropsForResource, ResourceLayoutComponent, defineResourceLayout };
+export { CreateResourceLayoutFn, CreateResourceLayoutMakeComposableOptions, DefineResourceLayout, DefineResourceLayoutFn, DefineResourceLayoutForResources, DefineResourceLayoutForResourcesFactory, DefineResourcesFn, LayoutIncludeProps, LayoutProps, LayoutPropsForResource, LayoutRenderResourcesAccessor, LayoutResourcesAccessor, ResourceLayoutComponent, defineResourceLayout };
 //# sourceMappingURL=define-layout.d.mts.map

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

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

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

@@ -1,4 +1,4 @@
-import { normalizeResources, toResourceEnum } from "../resource.mjs";
+import { createIsValidResourceFn, normalizeResources, toResourceEnum } from "../resource.mjs";
 import { functionalUpdate, pick } from "../utils.mjs";
 import { capitalize } from "../utils/capitalize.mjs";
 import { InvalidConfigError } from "../errors/invalid-config.mjs";
@@ -12,6 +12,16 @@ import { createPrimitivePropBuilder, createProp, resolvePropDefinitionValues, va
 import { jsx } from "react/jsx-runtime";
 
 //#region src/create-config/define-layout.tsx
+function createLayoutResourcesAccessor(resources) {
+	const accessor = (() => resources);
+	accessor.isResource = createIsValidResourceFn(resources);
+	accessor.omit = ((...keys) => resources.filter((resource) => !keys.includes(readResourceSlug(resource))));
+	accessor.pick = ((...keys) => resources.filter((resource) => keys.includes(readResourceSlug(resource))));
+	return accessor;
+}
+function createLayoutRenderResourcesAccessor(resources, current) {
+	return Object.assign(createLayoutResourcesAccessor(resources), { current });
+}
 function isBuiltPropDefinition(value) {
 	return typeof value === "function" && value !== null && "visibility" in value;
 }
@@ -82,6 +92,7 @@ function assertUnreservedResourceSlugs(resources, owner) {
 function defineResourceLayoutImpl(options) {
 	const { options: inProps = {}, resources, layout } = options;
 	assertUnreservedResourceSlugs(resources);
+	const resourcesAccessor = createLayoutResourcesAccessor(resources);
 	const normalizedResources = normalizeResources(resources);
 	const resourcesEnum = createPrimitivePropBuilder("string").enum(toResourceEnum(normalizedResources));
 	const definedResourceLayout = ((layoutOptions) => {
@@ -123,6 +134,7 @@ function defineResourceLayoutImpl(options) {
 		const mergedRenderContext = {
 			composables: resolvedComposables,
 			resource: layoutContext.resource,
+			resources: createLayoutRenderResourcesAccessor(resources, layoutContext.resource),
 			name: layoutContext.name,
 			inProps: splitInProps
 		};
@@ -213,9 +225,13 @@ function defineResourceLayoutImpl(options) {
 	return {
 		createResourceConfig,
 		createResourceLayout: Object.assign(definedResourceLayout, createResourceLayoutExtras),
-		createResourceLinks: createResourceLinksFn(resources)
+		createResourceLinks: createResourceLinksFn(resources),
+		resources: resourcesAccessor
 	};
 }
+function defineResources(...resources) {
+	return resources;
+}
 function defineResourceLayoutForResources(...baseResources) {
 	return ((options) => {
 		const { resources: extraResources, ...rest } = options;
@@ -226,7 +242,10 @@ function defineResourceLayoutForResources(...baseResources) {
 		});
 	});
 }
-const defineResourceLayout = Object.assign(defineResourceLayoutImpl, { forResources: defineResourceLayoutForResources });
+const defineResourceLayout = Object.assign(defineResourceLayoutImpl, {
+	forResources: defineResourceLayoutForResources,
+	defineResources
+});
 
 //#endregion
 export { defineResourceLayout };

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

@@ -1 +1 @@
-{"version":3,"file":"define-layout.mjs","names":[],"sources":["../../src/create-config/define-layout.tsx"],"sourcesContent":["import type { JSX } 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  normalizeResources,\n  toResourceEnum,\n  type LayoutResourceKey,\n  type ResourceDefinition,\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';\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  resource: LayoutResourceKey<Resources>;\n  name: string;\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\n    ? behavior.passthrough === 'component'\n    : 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\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: {\n    /**\n     * The props to pass to the layout.\n     */\n    props?: LayoutProps<\n      Resources,\n      Options,\n      Composables,\n      IncludeProps,\n      CustomProps\n    >;\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};\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\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\n  assertUnreservedResourceSlugs(resources);\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(\n              ([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          );\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<\n                string,\n                AnyBuiltPropDefinition\n              >,\n              presetPropValues,\n              validationContext,\n            ),\n          ];\n        },\n      ),\n    );\n    const mergedRenderContext = {\n      composables: resolvedComposables as LayoutRenderComposables<Composables>,\n      resource: layoutContext.resource,\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 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(\n          ([key]) => 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  } 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\nexport type DefineResourceLayout = DefineResourceLayoutFn & {\n  forResources: DefineResourceLayoutForResources;\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\nexport const defineResourceLayout: DefineResourceLayout = Object.assign(\n  defineResourceLayoutImpl as DefineResourceLayoutFn,\n  {\n    forResources: defineResourceLayoutForResources,\n  },\n);\n"],"mappings":"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"}
+{"version":3,"file":"define-layout.mjs","names":[],"sources":["../../src/create-config/define-layout.tsx"],"sourcesContent":["import type { JSX } 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} 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';\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\ntype PickResourceDefinitions<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Keys extends LayoutResourceKey<Resources>,\n> = Array<Extract<Resources[number], Keys | { value: Keys }>>;\n\ntype OmitResourceDefinitions<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Keys extends LayoutResourceKey<Resources>,\n> = Array<Exclude<Resources[number], Keys | { value: Keys }>>;\n\n/**\n * Accessor for the resources bound to a `defineResourceLayout` definition.\n *\n * - `resources()` returns the raw resources.\n * - `resources.omit(...keys)` returns the resources except for the omitted ones.\n * - `resources.pick(...keys)` returns only the picked resources.\n * - `resources.isResource(value)` narrows an unknown value to a resource key.\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   * Returns the declared resources with the named ones removed, preserving the\n   * order and shape of the remaining definitions.\n   *\n   * @param keys - Top-level resource names to exclude.\n   */\n  omit<Keys extends LayoutResourceKey<Resources>>(\n    ...keys: Keys[]\n  ): Show<OmitResourceDefinitions<Resources, Keys>>;\n  /**\n   * Returns only the declared resources matching the named ones, preserving the\n   * order and shape of the selected definitions.\n   *\n   * @param keys - Top-level resource names to keep.\n   */\n  pick<Keys extends LayoutResourceKey<Resources>>(\n    ...keys: Keys[]\n  ): Show<PickResourceDefinitions<Resources, Keys>>;\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 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    resources.filter(\n      (resource) => !keys.includes(readResourceSlug(resource)),\n    )) as LayoutResourcesAccessor<Resources>['omit'];\n  accessor.pick = ((...keys: string[]) =>\n    resources.filter((resource) =>\n      keys.includes(readResourceSlug(resource)),\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\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: {\n    /**\n     * The props to pass to the layout.\n     */\n    props?: LayoutProps<\n      Resources,\n      Options,\n      Composables,\n      IncludeProps,\n      CustomProps\n    >;\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};\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\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 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\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\nexport const defineResourceLayout: DefineResourceLayout = Object.assign(\n  defineResourceLayoutImpl as DefineResourceLayoutFn,\n  {\n    forResources: defineResourceLayoutForResources,\n    defineResources,\n  },\n);\n"],"mappings":"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"}

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

@@ -6,4 +6,4 @@ import { ForPaths, ForPathsRenderContext, RenderedPathComponent, RenderedPathCom
 import { IsSubResourceKey, IsSubResourceKeyOptions, IsSubResourceKeyResult } from "./is-sub-resource-key.cjs";
 import { ComponentTypes, CreateResourceConfigFn, CreatedResourceConfig, GetComponent, GetComponentAtBound, GetComponentForResource, GetComponentForResourceOptions, GetComponentOptions, GetComponentOptionsForResource, ResourceConfigPath, ResourceFromGetComponentBound, SubResourceFromGetComponentBound, ValidateForResourceBound } from "./get-component.cjs";
 import { CreateResourceLinkConfig, CreateResourceLinkGroupInput, CreateResourceLinkGroupOptions, CreateResourceLinkOptions, CreateResourceLinksFn, CreateResourceLinksWithGroups, CreateResourceLinksWithGroupsFn, CreatedResourceHref, CreatedResourceLink, CreatedResourceLinkBase, InferHashFromResourceLinkHref, ResourceAnchorLinkFn, ResourceLinkHref } from "./create-resource-links.cjs";
-import { CreateResourceLayoutFn, CreateResourceLayoutMakeComposableOptions, DefineResourceLayout, DefineResourceLayoutFn, DefineResourceLayoutForResources, DefineResourceLayoutForResourcesFactory, defineResourceLayout } from "./define-layout.cjs";
+import { CreateResourceLayoutFn, CreateResourceLayoutMakeComposableOptions, DefineResourceLayout, DefineResourceLayoutFn, DefineResourceLayoutForResources, DefineResourceLayoutForResourcesFactory, DefineResourcesFn, LayoutRenderResourcesAccessor, LayoutResourcesAccessor, defineResourceLayout } from "./define-layout.cjs";

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

@@ -6,4 +6,4 @@ import { ForPaths, ForPathsRenderContext, RenderedPathComponent, RenderedPathCom
 import { IsSubResourceKey, IsSubResourceKeyOptions, IsSubResourceKeyResult } from "./is-sub-resource-key.mjs";
 import { ComponentTypes, CreateResourceConfigFn, CreatedResourceConfig, GetComponent, GetComponentAtBound, GetComponentForResource, GetComponentForResourceOptions, GetComponentOptions, GetComponentOptionsForResource, ResourceConfigPath, ResourceFromGetComponentBound, SubResourceFromGetComponentBound, ValidateForResourceBound } from "./get-component.mjs";
 import { CreateResourceLinkConfig, CreateResourceLinkGroupInput, CreateResourceLinkGroupOptions, CreateResourceLinkOptions, CreateResourceLinksFn, CreateResourceLinksWithGroups, CreateResourceLinksWithGroupsFn, CreatedResourceHref, CreatedResourceLink, CreatedResourceLinkBase, InferHashFromResourceLinkHref, ResourceAnchorLinkFn, ResourceLinkHref } from "./create-resource-links.mjs";
-import { CreateResourceLayoutFn, CreateResourceLayoutMakeComposableOptions, DefineResourceLayout, DefineResourceLayoutFn, DefineResourceLayoutForResources, DefineResourceLayoutForResourcesFactory, defineResourceLayout } from "./define-layout.mjs";
+import { CreateResourceLayoutFn, CreateResourceLayoutMakeComposableOptions, DefineResourceLayout, DefineResourceLayoutFn, DefineResourceLayoutForResources, DefineResourceLayoutForResourcesFactory, DefineResourcesFn, LayoutRenderResourcesAccessor, LayoutResourcesAccessor, defineResourceLayout } from "./define-layout.mjs";

package/dist/index.d.cts

@@ -6,7 +6,7 @@ import { CreateGetComponentForPath, GetComponentForPath, ResolvedPathValue } fro
 import { ForPaths, ForPathsRenderContext, RenderedPathComponent, RenderedPathComponentHOF, TargetPathBuilder } from "./create-config/for-paths/builder.cjs";
 import { IsSubResourceKey } from "./create-config/is-sub-resource-key.cjs";
 import { ComponentTypes, CreatedResourceConfig } from "./create-config/get-component.cjs";
-import { defineResourceLayout } from "./create-config/define-layout.cjs";
+import { DefineResourcesFn, LayoutRenderResourcesAccessor, LayoutResourcesAccessor, defineResourceLayout } from "./create-config/define-layout.cjs";
 import { CreateReactLayoutErrorOptions, CreatedReactLayoutError, ErrorMessageRenderer, ReactLayoutError, ReactLayoutErrorContext, ReactLayoutErrorRendererFactory, createReactLayoutError } from "./errors/react-layout-error.cjs";
 import { InvalidConfigContext, InvalidConfigError } from "./errors/invalid-config.cjs";
 import { InvalidPathContext, InvalidPathError } from "./errors/invalid-path.cjs";
@@ -16,4 +16,4 @@ import { InvalidComponentContext, InvalidComponentError } from "./errors/invalid
 import { MissingPathVariableContext, MissingPathVariableError } from "./errors/missing-path-variable.cjs";
 import { AnyComposableComponent, ComposableComponent, ComposableComponentCallable, ComposableComponents, ComposableNameContext, ComposablePresetComponent, ComposablePresetComponentCallProps, ComposablePresetMeta, ComposablePresetProps, ComposableResourceLayout, CreateLayoutComposable, DefinedComposableComponentRecord, LayoutComposablePresetProvider, LayoutComposablesFactory, MakeComposable, MakeComposableOptions, MergePresetProps, PresetPropsFromComposable, RequiredPresetLayoutProps, RequiredPresetRenderProps, ResolveLayoutComposables, collectComposablePresetEntries, createComposableComponent, createLayoutComposableFactory, defineComposableComponent, makeComposable, resolveComposablePresetProps, resolveLayoutComposables } from "@jfdevelops/react-layout-composables";
 import { AnyBuiltPropDefinition, ExtractDefinitionValue, PropError, PropErrorOptions, ResolveLayoutProps, ResolveLayoutPropsAsDefined, ResolveProps, ResolvedBuiltPropShape, createPrimitivePropBuilder, createProp, isPropDefinitionShape, resolvePropDefinitionValues, validateProps } from "@jfdevelops/react-layout-validator";
-export { type AnyBuiltPropDefinition, type AnyComposableComponent, type BaseComponent, type ComponentTypes, type ComposableComponent, type ComposableComponentCallable, type ComposableComponents, type ComposableNameContext, type ComposablePresetComponent, type ComposablePresetComponentCallProps, type ComposablePresetMeta, type ComposablePresetProps, type ComposableResourceLayout, type CreateGetComponentForPath, type CreateLayoutComposable, type CreateReactLayoutErrorOptions, type CreatedReactLayoutError, type CreatedResourceConfig, type DefinedComposableComponentRecord, type ErrorMessageRenderer, type ExtractDefinitionValue, type ForPaths, type ForPathsRenderContext, type GetComponentForPath, type InPropsDefinition, type InPropsFunction, type InPropsObject, type InPropsOptions, type IncludedPropBehavior, type IncludedProps, type InferredInProps, type InvalidComponentContext, InvalidComponentError, type InvalidConfigContext, InvalidConfigError, type InvalidPathContext, InvalidPathError, type InvalidResourceContext, InvalidResourceError, type InvalidSubResourceContext, InvalidSubResourceError, type IsSubResourceKey, LayoutComposablePresetProvider, type LayoutComposablesFactory, type LayoutRenderProps, type LayoutResourceKey, type MakeComposable, type MakeComposableOptions, type MergeIntersection, type MergePresetProps, type MergedLayoutInProps, type MissingPathVariableContext, MissingPathVariableError, type NormalizeResource, type NormalizeResources, type ParameterizedResourcePath, type PathVariables, type PresetPropsFromComposable, PropError, type PropErrorOptions, type PropsContextRender, type PropsRenderDefinition, ReactLayoutError, type ReactLayoutErrorContext, type ReactLayoutErrorRendererFactory, type RenderedPathComponent, type RenderedPathComponentHOF, type RequiredPresetLayoutProps, type RequiredPresetRenderProps, type ResolveLayoutComposables, type ResolveLayoutProps, type ResolveLayoutPropsAsDefined, type ResolveProps, type ResolvedBuiltPropShape, type ResolvedIncludedComponentProps, type ResolvedIncludedConfigProps, type ResolvedIncludedProps, type ResolvedIncludedPropsAsDefined, type ResolvedPathValue, type ResourceDefinition, type ResourceEnum, type ResourceLayoutComponentProps, type ResourceTree, type Show, type TargetPathBuilder, type UnionToIntersection, collectComposablePresetEntries, createComposableComponent, createLayoutComposableFactory, createPrimitivePropBuilder, createProp, createReactLayoutError, defineComposableComponent, defineResourceLayout, isPropDefinitionShape, makeComposable, normalizeResource, normalizeResources, pick, resolveComposablePresetProps, resolveLayoutComposables, resolvePropDefinitionValues, toResourceEnum, validateProps };
+export { type AnyBuiltPropDefinition, type AnyComposableComponent, type BaseComponent, type ComponentTypes, type ComposableComponent, type ComposableComponentCallable, type ComposableComponents, type ComposableNameContext, type ComposablePresetComponent, type ComposablePresetComponentCallProps, type ComposablePresetMeta, type ComposablePresetProps, type ComposableResourceLayout, type CreateGetComponentForPath, type CreateLayoutComposable, type CreateReactLayoutErrorOptions, type CreatedReactLayoutError, type CreatedResourceConfig, type DefineResourcesFn, type DefinedComposableComponentRecord, type ErrorMessageRenderer, type ExtractDefinitionValue, type ForPaths, type ForPathsRenderContext, type GetComponentForPath, type InPropsDefinition, type InPropsFunction, type InPropsObject, type InPropsOptions, type IncludedPropBehavior, type IncludedProps, type InferredInProps, type InvalidComponentContext, InvalidComponentError, type InvalidConfigContext, InvalidConfigError, type InvalidPathContext, InvalidPathError, type InvalidResourceContext, InvalidResourceError, type InvalidSubResourceContext, InvalidSubResourceError, type IsSubResourceKey, LayoutComposablePresetProvider, type LayoutComposablesFactory, type LayoutRenderProps, type LayoutRenderResourcesAccessor, type LayoutResourceKey, type LayoutResourcesAccessor, type MakeComposable, type MakeComposableOptions, type MergeIntersection, type MergePresetProps, type MergedLayoutInProps, type MissingPathVariableContext, MissingPathVariableError, type NormalizeResource, type NormalizeResources, type ParameterizedResourcePath, type PathVariables, type PresetPropsFromComposable, PropError, type PropErrorOptions, type PropsContextRender, type PropsRenderDefinition, ReactLayoutError, type ReactLayoutErrorContext, type ReactLayoutErrorRendererFactory, type RenderedPathComponent, type RenderedPathComponentHOF, type RequiredPresetLayoutProps, type RequiredPresetRenderProps, type ResolveLayoutComposables, type ResolveLayoutProps, type ResolveLayoutPropsAsDefined, type ResolveProps, type ResolvedBuiltPropShape, type ResolvedIncludedComponentProps, type ResolvedIncludedConfigProps, type ResolvedIncludedProps, type ResolvedIncludedPropsAsDefined, type ResolvedPathValue, type ResourceDefinition, type ResourceEnum, type ResourceLayoutComponentProps, type ResourceTree, type Show, type TargetPathBuilder, type UnionToIntersection, collectComposablePresetEntries, createComposableComponent, createLayoutComposableFactory, createPrimitivePropBuilder, createProp, createReactLayoutError, defineComposableComponent, defineResourceLayout, isPropDefinitionShape, makeComposable, normalizeResource, normalizeResources, pick, resolveComposablePresetProps, resolveLayoutComposables, resolvePropDefinitionValues, toResourceEnum, validateProps };

package/dist/index.d.mts

@@ -6,7 +6,7 @@ import { CreateGetComponentForPath, GetComponentForPath, ResolvedPathValue } fro
 import { ForPaths, ForPathsRenderContext, RenderedPathComponent, RenderedPathComponentHOF, TargetPathBuilder } from "./create-config/for-paths/builder.mjs";
 import { IsSubResourceKey } from "./create-config/is-sub-resource-key.mjs";
 import { ComponentTypes, CreatedResourceConfig } from "./create-config/get-component.mjs";
-import { defineResourceLayout } from "./create-config/define-layout.mjs";
+import { DefineResourcesFn, LayoutRenderResourcesAccessor, LayoutResourcesAccessor, defineResourceLayout } from "./create-config/define-layout.mjs";
 import { CreateReactLayoutErrorOptions, CreatedReactLayoutError, ErrorMessageRenderer, ReactLayoutError, ReactLayoutErrorContext, ReactLayoutErrorRendererFactory, createReactLayoutError } from "./errors/react-layout-error.mjs";
 import { InvalidConfigContext, InvalidConfigError } from "./errors/invalid-config.mjs";
 import { InvalidPathContext, InvalidPathError } from "./errors/invalid-path.mjs";
@@ -16,4 +16,4 @@ import { InvalidComponentContext, InvalidComponentError } from "./errors/invalid
 import { MissingPathVariableContext, MissingPathVariableError } from "./errors/missing-path-variable.mjs";
 import { AnyComposableComponent, ComposableComponent, ComposableComponentCallable, ComposableComponents, ComposableNameContext, ComposablePresetComponent, ComposablePresetComponentCallProps, ComposablePresetMeta, ComposablePresetProps, ComposableResourceLayout, CreateLayoutComposable, DefinedComposableComponentRecord, LayoutComposablePresetProvider, LayoutComposablesFactory, MakeComposable, MakeComposableOptions, MergePresetProps, PresetPropsFromComposable, RequiredPresetLayoutProps, RequiredPresetRenderProps, ResolveLayoutComposables, collectComposablePresetEntries, createComposableComponent, createLayoutComposableFactory, defineComposableComponent, makeComposable, resolveComposablePresetProps, resolveLayoutComposables } from "@jfdevelops/react-layout-composables";
 import { AnyBuiltPropDefinition, ExtractDefinitionValue, PropError, PropErrorOptions, ResolveLayoutProps, ResolveLayoutPropsAsDefined, ResolveProps, ResolvedBuiltPropShape, createPrimitivePropBuilder, createProp, isPropDefinitionShape, resolvePropDefinitionValues, validateProps } from "@jfdevelops/react-layout-validator";
-export { type AnyBuiltPropDefinition, type AnyComposableComponent, type BaseComponent, type ComponentTypes, type ComposableComponent, type ComposableComponentCallable, type ComposableComponents, type ComposableNameContext, type ComposablePresetComponent, type ComposablePresetComponentCallProps, type ComposablePresetMeta, type ComposablePresetProps, type ComposableResourceLayout, type CreateGetComponentForPath, type CreateLayoutComposable, type CreateReactLayoutErrorOptions, type CreatedReactLayoutError, type CreatedResourceConfig, type DefinedComposableComponentRecord, type ErrorMessageRenderer, type ExtractDefinitionValue, type ForPaths, type ForPathsRenderContext, type GetComponentForPath, type InPropsDefinition, type InPropsFunction, type InPropsObject, type InPropsOptions, type IncludedPropBehavior, type IncludedProps, type InferredInProps, type InvalidComponentContext, InvalidComponentError, type InvalidConfigContext, InvalidConfigError, type InvalidPathContext, InvalidPathError, type InvalidResourceContext, InvalidResourceError, type InvalidSubResourceContext, InvalidSubResourceError, type IsSubResourceKey, LayoutComposablePresetProvider, type LayoutComposablesFactory, type LayoutRenderProps, type LayoutResourceKey, type MakeComposable, type MakeComposableOptions, type MergeIntersection, type MergePresetProps, type MergedLayoutInProps, type MissingPathVariableContext, MissingPathVariableError, type NormalizeResource, type NormalizeResources, type ParameterizedResourcePath, type PathVariables, type PresetPropsFromComposable, PropError, type PropErrorOptions, type PropsContextRender, type PropsRenderDefinition, ReactLayoutError, type ReactLayoutErrorContext, type ReactLayoutErrorRendererFactory, type RenderedPathComponent, type RenderedPathComponentHOF, type RequiredPresetLayoutProps, type RequiredPresetRenderProps, type ResolveLayoutComposables, type ResolveLayoutProps, type ResolveLayoutPropsAsDefined, type ResolveProps, type ResolvedBuiltPropShape, type ResolvedIncludedComponentProps, type ResolvedIncludedConfigProps, type ResolvedIncludedProps, type ResolvedIncludedPropsAsDefined, type ResolvedPathValue, type ResourceDefinition, type ResourceEnum, type ResourceLayoutComponentProps, type ResourceTree, type Show, type TargetPathBuilder, type UnionToIntersection, collectComposablePresetEntries, createComposableComponent, createLayoutComposableFactory, createPrimitivePropBuilder, createProp, createReactLayoutError, defineComposableComponent, defineResourceLayout, isPropDefinitionShape, makeComposable, normalizeResource, normalizeResources, pick, resolveComposablePresetProps, resolveLayoutComposables, resolvePropDefinitionValues, toResourceEnum, validateProps };
+export { type AnyBuiltPropDefinition, type AnyComposableComponent, type BaseComponent, type ComponentTypes, type ComposableComponent, type ComposableComponentCallable, type ComposableComponents, type ComposableNameContext, type ComposablePresetComponent, type ComposablePresetComponentCallProps, type ComposablePresetMeta, type ComposablePresetProps, type ComposableResourceLayout, type CreateGetComponentForPath, type CreateLayoutComposable, type CreateReactLayoutErrorOptions, type CreatedReactLayoutError, type CreatedResourceConfig, type DefineResourcesFn, type DefinedComposableComponentRecord, type ErrorMessageRenderer, type ExtractDefinitionValue, type ForPaths, type ForPathsRenderContext, type GetComponentForPath, type InPropsDefinition, type InPropsFunction, type InPropsObject, type InPropsOptions, type IncludedPropBehavior, type IncludedProps, type InferredInProps, type InvalidComponentContext, InvalidComponentError, type InvalidConfigContext, InvalidConfigError, type InvalidPathContext, InvalidPathError, type InvalidResourceContext, InvalidResourceError, type InvalidSubResourceContext, InvalidSubResourceError, type IsSubResourceKey, LayoutComposablePresetProvider, type LayoutComposablesFactory, type LayoutRenderProps, type LayoutRenderResourcesAccessor, type LayoutResourceKey, type LayoutResourcesAccessor, type MakeComposable, type MakeComposableOptions, type MergeIntersection, type MergePresetProps, type MergedLayoutInProps, type MissingPathVariableContext, MissingPathVariableError, type NormalizeResource, type NormalizeResources, type ParameterizedResourcePath, type PathVariables, type PresetPropsFromComposable, PropError, type PropErrorOptions, type PropsContextRender, type PropsRenderDefinition, ReactLayoutError, type ReactLayoutErrorContext, type ReactLayoutErrorRendererFactory, type RenderedPathComponent, type RenderedPathComponentHOF, type RequiredPresetLayoutProps, type RequiredPresetRenderProps, type ResolveLayoutComposables, type ResolveLayoutProps, type ResolveLayoutPropsAsDefined, type ResolveProps, type ResolvedBuiltPropShape, type ResolvedIncludedComponentProps, type ResolvedIncludedConfigProps, type ResolvedIncludedProps, type ResolvedIncludedPropsAsDefined, type ResolvedPathValue, type ResourceDefinition, type ResourceEnum, type ResourceLayoutComponentProps, type ResourceTree, type Show, type TargetPathBuilder, type UnionToIntersection, collectComposablePresetEntries, createComposableComponent, createLayoutComposableFactory, createPrimitivePropBuilder, createProp, createReactLayoutError, defineComposableComponent, defineResourceLayout, isPropDefinitionShape, makeComposable, normalizeResource, normalizeResources, pick, resolveComposablePresetProps, resolveLayoutComposables, resolvePropDefinitionValues, toResourceEnum, validateProps };

package/dist/resource.cjs

@@ -16,6 +16,11 @@ function normalizeResource(resource) {
 function normalizeResources(resources) {
 	return normalizeResourcesTree(resources);
 }
+function createIsValidResourceFn(resources) {
+	return (value) => {
+		return typeof value === "string" && Object.keys(normalizeResources(resources)).includes(value);
+	};
+}
 function toResourceEnum(resources) {
 	const keys = Object.keys(resources);
 	if (keys.length === 0) throw new Error("No resources provided");
@@ -23,6 +28,7 @@ function toResourceEnum(resources) {
 }
 
 //#endregion
+exports.createIsValidResourceFn = createIsValidResourceFn;
 exports.normalizeResource = normalizeResource;
 exports.normalizeResources = normalizeResources;
 exports.toResourceEnum = toResourceEnum;

package/dist/resource.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"resource.cjs","names":[],"sources":["../src/resource.ts"],"sourcesContent":["import { ReactNode } from 'react';\nimport { NonEmptyReadonlyArray } from '@jfdevelops/react-layout-validator';\nimport { MergeIntersection, UnionToIntersection } from './utils';\n\nexport type ResourceDefinition =\n  | string\n  | {\n      value: string;\n      subResources: ReadonlyArray<\n        ResourceDefinition & {\n          /**\n           * Whether to allow any string as a sub resource.\n           *\n           * @default false\n           */\n          allowAnyString?: boolean;\n        }\n      >;\n    };\n\nexport type ResourceTree = Record<\n  string,\n  {\n    subResources: ResourceTree;\n  }\n>;\n\nexport type NormalizeResource<Resource extends ResourceDefinition> =\n  Resource extends string\n    ? {\n        [Key in Resource]: {\n          subResources: {};\n        };\n      }\n    : Resource extends {\n          value: infer Value extends string;\n          subResources: infer SubResources extends\n            ReadonlyArray<ResourceDefinition>;\n        }\n      ? {\n          [Key in Value]: {\n            subResources: NormalizeResources<SubResources>;\n          };\n        }\n      : never;\n\nexport type NormalizeResources<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = MergeIntersection<\n  UnionToIntersection<NormalizeResource<Resources[number]>>\n>;\nexport type ResourceLayoutComponentProps = {\n  children: ReactNode;\n};\n\nfunction normalizeResourceTree(resource: ResourceDefinition): ResourceTree {\n  if (typeof resource === 'string') {\n    return {\n      [resource]: {\n        subResources: {},\n      },\n    };\n  }\n\n  const { value, subResources } = resource;\n\n  return {\n    [value]: {\n      subResources: normalizeResourcesTree(subResources),\n    },\n  };\n}\n\nfunction normalizeResourcesTree(\n  resources: ReadonlyArray<ResourceDefinition>,\n): ResourceTree {\n  const normalizedResources: ResourceTree = {};\n\n  for (const resource of resources) {\n    Object.assign(normalizedResources, normalizeResourceTree(resource));\n  }\n\n  return normalizedResources;\n}\n\nexport function normalizeResource(resource: ResourceDefinition): ResourceTree {\n  return normalizeResourceTree(resource);\n}\n\nexport function normalizeResources<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n>(resources: Resources): NormalizeResources<Resources> {\n  return normalizeResourcesTree(resources) as NormalizeResources<Resources>;\n}\n\nexport function createIsValidResourceFn<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n>(resources: Resources) {\n  return (value: unknown): value is LayoutResourceKey<Resources> => {\n    return (\n      typeof value === 'string' &&\n      Object.keys(normalizeResources(resources)).includes(value)\n    );\n  };\n}\n\ntype ResourceDefinitionValue<Resource extends ResourceDefinition> =\n  Resource extends string\n    ? Resource\n    : Resource extends { value: infer Value extends string }\n      ? Value\n      : never;\n\n/**\n * Top-level resource names declared in a `resources` array. Preserves string\n * literal unions for const resource definitions (unlike `keyof` on the\n * normalized resource tree, which tends to widen to `string` in hovers).\n */\nexport type LayoutResourceKey<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = ResourceDefinitionValue<Resources[number]>;\n\nexport type ResourceDefinitionForKey<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Key extends string,\n> = Extract<Resources[number], Key | { value: Key }>;\n\n/** `subResources` array declared on a layout resource. */\nexport type SubResourceDefinitionsFor<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends LayoutResourceKey<Resources>,\n> =\n  ResourceDefinitionForKey<Resources, Resource> extends {\n    subResources: infer SubResources extends ReadonlyArray<ResourceDefinition>;\n  }\n    ? SubResources\n    : readonly [];\n\ntype CanNestSubResourceParam<\n  MaxDepth extends number,\n  DepthAcc extends readonly unknown[],\n> = [...DepthAcc, unknown]['length'] extends MaxDepth ? false : true;\n\n/**\n * `subResource` route param: a slug at the current depth, or `{ value, subResource }`\n * when that slug has nested `subResources` in the layout tree and `MaxDepth` allows it.\n */\nexport type RecursiveSubResourceParam<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  SubDefs extends ReadonlyArray<ResourceDefinition>,\n  MaxDepth extends number = 6,\n  DepthAcc extends readonly unknown[] = readonly [],\n> =\n  LayoutResourceKey<SubDefs> extends infer Key\n    ? Key extends LayoutResourceKey<SubDefs>\n      ? CanNestSubResourceParam<MaxDepth, DepthAcc> extends true\n        ? ResourceDefinitionForKey<SubDefs, Key> extends {\n            subResources: infer Nested extends\n              ReadonlyArray<ResourceDefinition>;\n          }\n          ? [LayoutResourceKey<Nested>] extends [never]\n            ? Key\n            :\n                | Key\n                | {\n                    value: Key;\n                    subResource: RecursiveSubResourceParam<\n                      Resources,\n                      Nested,\n                      MaxDepth,\n                      readonly [...DepthAcc, unknown]\n                    >;\n                  }\n          : Key\n        : Key\n      : never\n    : never;\n\n/** Recursive `subResource` values for a layout resource (full tree depth). */\nexport type SubResourceParamForResource<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends LayoutResourceKey<Resources>,\n> = [SubResourceDefinitionsFor<Resources, Resource>] extends [readonly []]\n  ? never\n  : RecursiveSubResourceParam<\n      Resources,\n      SubResourceDefinitionsFor<Resources, Resource>\n    >;\n\nexport type GetSubResourceKeys<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends LayoutResourceKey<Resources>,\n> =\n  ResourceDefinitionForKey<Resources, Resource> extends {\n    subResources: infer SubResources extends ReadonlyArray<ResourceDefinition>;\n  }\n    ? LayoutResourceKey<SubResources>\n    : never;\nexport type ResourceEnum<Resources extends ReadonlyArray<ResourceDefinition>> =\n  NonEmptyReadonlyArray<LayoutResourceKey<Resources>>;\nexport function toResourceEnum<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n>(resources: NormalizeResources<Resources>) {\n  const keys = Object.keys(resources);\n\n  if (keys.length === 0) {\n    throw new Error('No resources provided');\n  }\n\n  return keys as unknown as ResourceEnum<Resources>;\n}\n"],"mappings":";;AAuDA,SAAS,sBAAsB,UAA4C;CACzE,IAAI,OAAO,aAAa,UACtB,OAAO,GACJ,WAAW,EACV,cAAc,CAAC,EACjB,EACF;CAGF,MAAM,EAAE,OAAO,iBAAiB;CAEhC,OAAO,GACJ,QAAQ,EACP,cAAc,uBAAuB,YAAY,EACnD,EACF;AACF;AAEA,SAAS,uBACP,WACc;CACd,MAAM,sBAAoC,CAAC;CAE3C,KAAK,MAAM,YAAY,WACrB,OAAO,OAAO,qBAAqB,sBAAsB,QAAQ,CAAC;CAGpE,OAAO;AACT;AAEA,SAAgB,kBAAkB,UAA4C;CAC5E,OAAO,sBAAsB,QAAQ;AACvC;AAEA,SAAgB,mBAEd,WAAqD;CACrD,OAAO,uBAAuB,SAAS;AACzC;AA2GA,SAAgB,eAEd,WAA0C;CAC1C,MAAM,OAAO,OAAO,KAAK,SAAS;CAElC,IAAI,KAAK,WAAW,GAClB,MAAM,IAAI,MAAM,uBAAuB;CAGzC,OAAO;AACT"}
+{"version":3,"file":"resource.cjs","names":[],"sources":["../src/resource.ts"],"sourcesContent":["import { ReactNode } from 'react';\nimport { NonEmptyReadonlyArray } from '@jfdevelops/react-layout-validator';\nimport { MergeIntersection, UnionToIntersection } from './utils';\n\nexport type ResourceDefinition =\n  | string\n  | {\n      value: string;\n      subResources: ReadonlyArray<\n        ResourceDefinition & {\n          /**\n           * Whether to allow any string as a sub resource.\n           *\n           * @default false\n           */\n          allowAnyString?: boolean;\n        }\n      >;\n    };\n\nexport type ResourceTree = Record<\n  string,\n  {\n    subResources: ResourceTree;\n  }\n>;\n\nexport type NormalizeResource<Resource extends ResourceDefinition> =\n  Resource extends string\n    ? {\n        [Key in Resource]: {\n          subResources: {};\n        };\n      }\n    : Resource extends {\n          value: infer Value extends string;\n          subResources: infer SubResources extends\n            ReadonlyArray<ResourceDefinition>;\n        }\n      ? {\n          [Key in Value]: {\n            subResources: NormalizeResources<SubResources>;\n          };\n        }\n      : never;\n\nexport type NormalizeResources<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = MergeIntersection<\n  UnionToIntersection<NormalizeResource<Resources[number]>>\n>;\nexport type ResourceLayoutComponentProps = {\n  children: ReactNode;\n};\n\nfunction normalizeResourceTree(resource: ResourceDefinition): ResourceTree {\n  if (typeof resource === 'string') {\n    return {\n      [resource]: {\n        subResources: {},\n      },\n    };\n  }\n\n  const { value, subResources } = resource;\n\n  return {\n    [value]: {\n      subResources: normalizeResourcesTree(subResources),\n    },\n  };\n}\n\nfunction normalizeResourcesTree(\n  resources: ReadonlyArray<ResourceDefinition>,\n): ResourceTree {\n  const normalizedResources: ResourceTree = {};\n\n  for (const resource of resources) {\n    Object.assign(normalizedResources, normalizeResourceTree(resource));\n  }\n\n  return normalizedResources;\n}\n\nexport function normalizeResource(resource: ResourceDefinition): ResourceTree {\n  return normalizeResourceTree(resource);\n}\n\nexport function normalizeResources<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n>(resources: Resources): NormalizeResources<Resources> {\n  return normalizeResourcesTree(resources) as NormalizeResources<Resources>;\n}\n\nexport function createIsValidResourceFn<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n>(resources: Resources) {\n  return (value: unknown): value is LayoutResourceKey<Resources> => {\n    return (\n      typeof value === 'string' &&\n      Object.keys(normalizeResources(resources)).includes(value)\n    );\n  };\n}\n\ntype ResourceDefinitionValue<Resource extends ResourceDefinition> =\n  Resource extends string\n    ? Resource\n    : Resource extends { value: infer Value extends string }\n      ? Value\n      : never;\n\n/**\n * Top-level resource names declared in a `resources` array. Preserves string\n * literal unions for const resource definitions (unlike `keyof` on the\n * normalized resource tree, which tends to widen to `string` in hovers).\n */\nexport type LayoutResourceKey<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = ResourceDefinitionValue<Resources[number]>;\n\nexport type ResourceDefinitionForKey<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Key extends string,\n> = Extract<Resources[number], Key | { value: Key }>;\n\n/** `subResources` array declared on a layout resource. */\nexport type SubResourceDefinitionsFor<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends LayoutResourceKey<Resources>,\n> =\n  ResourceDefinitionForKey<Resources, Resource> extends {\n    subResources: infer SubResources extends ReadonlyArray<ResourceDefinition>;\n  }\n    ? SubResources\n    : readonly [];\n\ntype CanNestSubResourceParam<\n  MaxDepth extends number,\n  DepthAcc extends readonly unknown[],\n> = [...DepthAcc, unknown]['length'] extends MaxDepth ? false : true;\n\n/**\n * `subResource` route param: a slug at the current depth, or `{ value, subResource }`\n * when that slug has nested `subResources` in the layout tree and `MaxDepth` allows it.\n */\nexport type RecursiveSubResourceParam<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  SubDefs extends ReadonlyArray<ResourceDefinition>,\n  MaxDepth extends number = 6,\n  DepthAcc extends readonly unknown[] = readonly [],\n> =\n  LayoutResourceKey<SubDefs> extends infer Key\n    ? Key extends LayoutResourceKey<SubDefs>\n      ? CanNestSubResourceParam<MaxDepth, DepthAcc> extends true\n        ? ResourceDefinitionForKey<SubDefs, Key> extends {\n            subResources: infer Nested extends\n              ReadonlyArray<ResourceDefinition>;\n          }\n          ? [LayoutResourceKey<Nested>] extends [never]\n            ? Key\n            :\n                | Key\n                | {\n                    value: Key;\n                    subResource: RecursiveSubResourceParam<\n                      Resources,\n                      Nested,\n                      MaxDepth,\n                      readonly [...DepthAcc, unknown]\n                    >;\n                  }\n          : Key\n        : Key\n      : never\n    : never;\n\n/** Recursive `subResource` values for a layout resource (full tree depth). */\nexport type SubResourceParamForResource<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends LayoutResourceKey<Resources>,\n> = [SubResourceDefinitionsFor<Resources, Resource>] extends [readonly []]\n  ? never\n  : RecursiveSubResourceParam<\n      Resources,\n      SubResourceDefinitionsFor<Resources, Resource>\n    >;\n\nexport type GetSubResourceKeys<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends LayoutResourceKey<Resources>,\n> =\n  ResourceDefinitionForKey<Resources, Resource> extends {\n    subResources: infer SubResources extends ReadonlyArray<ResourceDefinition>;\n  }\n    ? LayoutResourceKey<SubResources>\n    : never;\nexport type ResourceEnum<Resources extends ReadonlyArray<ResourceDefinition>> =\n  NonEmptyReadonlyArray<LayoutResourceKey<Resources>>;\nexport function toResourceEnum<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n>(resources: NormalizeResources<Resources>) {\n  const keys = Object.keys(resources);\n\n  if (keys.length === 0) {\n    throw new Error('No resources provided');\n  }\n\n  return keys as unknown as ResourceEnum<Resources>;\n}\n"],"mappings":";;AAuDA,SAAS,sBAAsB,UAA4C;CACzE,IAAI,OAAO,aAAa,UACtB,OAAO,GACJ,WAAW,EACV,cAAc,CAAC,EACjB,EACF;CAGF,MAAM,EAAE,OAAO,iBAAiB;CAEhC,OAAO,GACJ,QAAQ,EACP,cAAc,uBAAuB,YAAY,EACnD,EACF;AACF;AAEA,SAAS,uBACP,WACc;CACd,MAAM,sBAAoC,CAAC;CAE3C,KAAK,MAAM,YAAY,WACrB,OAAO,OAAO,qBAAqB,sBAAsB,QAAQ,CAAC;CAGpE,OAAO;AACT;AAEA,SAAgB,kBAAkB,UAA4C;CAC5E,OAAO,sBAAsB,QAAQ;AACvC;AAEA,SAAgB,mBAEd,WAAqD;CACrD,OAAO,uBAAuB,SAAS;AACzC;AAEA,SAAgB,wBAEd,WAAsB;CACtB,QAAQ,UAA0D;EAChE,OACE,OAAO,UAAU,YACjB,OAAO,KAAK,mBAAmB,SAAS,CAAC,EAAE,SAAS,KAAK;CAE7D;AACF;AAgGA,SAAgB,eAEd,WAA0C;CAC1C,MAAM,OAAO,OAAO,KAAK,SAAS;CAElC,IAAI,KAAK,WAAW,GAClB,MAAM,IAAI,MAAM,uBAAuB;CAGzC,OAAO;AACT"}

package/dist/resource.mjs

@@ -15,6 +15,11 @@ function normalizeResource(resource) {
 function normalizeResources(resources) {
 	return normalizeResourcesTree(resources);
 }
+function createIsValidResourceFn(resources) {
+	return (value) => {
+		return typeof value === "string" && Object.keys(normalizeResources(resources)).includes(value);
+	};
+}
 function toResourceEnum(resources) {
 	const keys = Object.keys(resources);
 	if (keys.length === 0) throw new Error("No resources provided");
@@ -22,5 +27,5 @@ function toResourceEnum(resources) {
 }
 
 //#endregion
-export { normalizeResource, normalizeResources, toResourceEnum };
+export { createIsValidResourceFn, normalizeResource, normalizeResources, toResourceEnum };
 //# sourceMappingURL=resource.mjs.map

package/dist/resource.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"resource.mjs","names":[],"sources":["../src/resource.ts"],"sourcesContent":["import { ReactNode } from 'react';\nimport { NonEmptyReadonlyArray } from '@jfdevelops/react-layout-validator';\nimport { MergeIntersection, UnionToIntersection } from './utils';\n\nexport type ResourceDefinition =\n  | string\n  | {\n      value: string;\n      subResources: ReadonlyArray<\n        ResourceDefinition & {\n          /**\n           * Whether to allow any string as a sub resource.\n           *\n           * @default false\n           */\n          allowAnyString?: boolean;\n        }\n      >;\n    };\n\nexport type ResourceTree = Record<\n  string,\n  {\n    subResources: ResourceTree;\n  }\n>;\n\nexport type NormalizeResource<Resource extends ResourceDefinition> =\n  Resource extends string\n    ? {\n        [Key in Resource]: {\n          subResources: {};\n        };\n      }\n    : Resource extends {\n          value: infer Value extends string;\n          subResources: infer SubResources extends\n            ReadonlyArray<ResourceDefinition>;\n        }\n      ? {\n          [Key in Value]: {\n            subResources: NormalizeResources<SubResources>;\n          };\n        }\n      : never;\n\nexport type NormalizeResources<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = MergeIntersection<\n  UnionToIntersection<NormalizeResource<Resources[number]>>\n>;\nexport type ResourceLayoutComponentProps = {\n  children: ReactNode;\n};\n\nfunction normalizeResourceTree(resource: ResourceDefinition): ResourceTree {\n  if (typeof resource === 'string') {\n    return {\n      [resource]: {\n        subResources: {},\n      },\n    };\n  }\n\n  const { value, subResources } = resource;\n\n  return {\n    [value]: {\n      subResources: normalizeResourcesTree(subResources),\n    },\n  };\n}\n\nfunction normalizeResourcesTree(\n  resources: ReadonlyArray<ResourceDefinition>,\n): ResourceTree {\n  const normalizedResources: ResourceTree = {};\n\n  for (const resource of resources) {\n    Object.assign(normalizedResources, normalizeResourceTree(resource));\n  }\n\n  return normalizedResources;\n}\n\nexport function normalizeResource(resource: ResourceDefinition): ResourceTree {\n  return normalizeResourceTree(resource);\n}\n\nexport function normalizeResources<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n>(resources: Resources): NormalizeResources<Resources> {\n  return normalizeResourcesTree(resources) as NormalizeResources<Resources>;\n}\n\nexport function createIsValidResourceFn<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n>(resources: Resources) {\n  return (value: unknown): value is LayoutResourceKey<Resources> => {\n    return (\n      typeof value === 'string' &&\n      Object.keys(normalizeResources(resources)).includes(value)\n    );\n  };\n}\n\ntype ResourceDefinitionValue<Resource extends ResourceDefinition> =\n  Resource extends string\n    ? Resource\n    : Resource extends { value: infer Value extends string }\n      ? Value\n      : never;\n\n/**\n * Top-level resource names declared in a `resources` array. Preserves string\n * literal unions for const resource definitions (unlike `keyof` on the\n * normalized resource tree, which tends to widen to `string` in hovers).\n */\nexport type LayoutResourceKey<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = ResourceDefinitionValue<Resources[number]>;\n\nexport type ResourceDefinitionForKey<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Key extends string,\n> = Extract<Resources[number], Key | { value: Key }>;\n\n/** `subResources` array declared on a layout resource. */\nexport type SubResourceDefinitionsFor<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends LayoutResourceKey<Resources>,\n> =\n  ResourceDefinitionForKey<Resources, Resource> extends {\n    subResources: infer SubResources extends ReadonlyArray<ResourceDefinition>;\n  }\n    ? SubResources\n    : readonly [];\n\ntype CanNestSubResourceParam<\n  MaxDepth extends number,\n  DepthAcc extends readonly unknown[],\n> = [...DepthAcc, unknown]['length'] extends MaxDepth ? false : true;\n\n/**\n * `subResource` route param: a slug at the current depth, or `{ value, subResource }`\n * when that slug has nested `subResources` in the layout tree and `MaxDepth` allows it.\n */\nexport type RecursiveSubResourceParam<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  SubDefs extends ReadonlyArray<ResourceDefinition>,\n  MaxDepth extends number = 6,\n  DepthAcc extends readonly unknown[] = readonly [],\n> =\n  LayoutResourceKey<SubDefs> extends infer Key\n    ? Key extends LayoutResourceKey<SubDefs>\n      ? CanNestSubResourceParam<MaxDepth, DepthAcc> extends true\n        ? ResourceDefinitionForKey<SubDefs, Key> extends {\n            subResources: infer Nested extends\n              ReadonlyArray<ResourceDefinition>;\n          }\n          ? [LayoutResourceKey<Nested>] extends [never]\n            ? Key\n            :\n                | Key\n                | {\n                    value: Key;\n                    subResource: RecursiveSubResourceParam<\n                      Resources,\n                      Nested,\n                      MaxDepth,\n                      readonly [...DepthAcc, unknown]\n                    >;\n                  }\n          : Key\n        : Key\n      : never\n    : never;\n\n/** Recursive `subResource` values for a layout resource (full tree depth). */\nexport type SubResourceParamForResource<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends LayoutResourceKey<Resources>,\n> = [SubResourceDefinitionsFor<Resources, Resource>] extends [readonly []]\n  ? never\n  : RecursiveSubResourceParam<\n      Resources,\n      SubResourceDefinitionsFor<Resources, Resource>\n    >;\n\nexport type GetSubResourceKeys<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends LayoutResourceKey<Resources>,\n> =\n  ResourceDefinitionForKey<Resources, Resource> extends {\n    subResources: infer SubResources extends ReadonlyArray<ResourceDefinition>;\n  }\n    ? LayoutResourceKey<SubResources>\n    : never;\nexport type ResourceEnum<Resources extends ReadonlyArray<ResourceDefinition>> =\n  NonEmptyReadonlyArray<LayoutResourceKey<Resources>>;\nexport function toResourceEnum<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n>(resources: NormalizeResources<Resources>) {\n  const keys = Object.keys(resources);\n\n  if (keys.length === 0) {\n    throw new Error('No resources provided');\n  }\n\n  return keys as unknown as ResourceEnum<Resources>;\n}\n"],"mappings":";AAuDA,SAAS,sBAAsB,UAA4C;CACzE,IAAI,OAAO,aAAa,UACtB,OAAO,GACJ,WAAW,EACV,cAAc,CAAC,EACjB,EACF;CAGF,MAAM,EAAE,OAAO,iBAAiB;CAEhC,OAAO,GACJ,QAAQ,EACP,cAAc,uBAAuB,YAAY,EACnD,EACF;AACF;AAEA,SAAS,uBACP,WACc;CACd,MAAM,sBAAoC,CAAC;CAE3C,KAAK,MAAM,YAAY,WACrB,OAAO,OAAO,qBAAqB,sBAAsB,QAAQ,CAAC;CAGpE,OAAO;AACT;AAEA,SAAgB,kBAAkB,UAA4C;CAC5E,OAAO,sBAAsB,QAAQ;AACvC;AAEA,SAAgB,mBAEd,WAAqD;CACrD,OAAO,uBAAuB,SAAS;AACzC;AA2GA,SAAgB,eAEd,WAA0C;CAC1C,MAAM,OAAO,OAAO,KAAK,SAAS;CAElC,IAAI,KAAK,WAAW,GAClB,MAAM,IAAI,MAAM,uBAAuB;CAGzC,OAAO;AACT"}
+{"version":3,"file":"resource.mjs","names":[],"sources":["../src/resource.ts"],"sourcesContent":["import { ReactNode } from 'react';\nimport { NonEmptyReadonlyArray } from '@jfdevelops/react-layout-validator';\nimport { MergeIntersection, UnionToIntersection } from './utils';\n\nexport type ResourceDefinition =\n  | string\n  | {\n      value: string;\n      subResources: ReadonlyArray<\n        ResourceDefinition & {\n          /**\n           * Whether to allow any string as a sub resource.\n           *\n           * @default false\n           */\n          allowAnyString?: boolean;\n        }\n      >;\n    };\n\nexport type ResourceTree = Record<\n  string,\n  {\n    subResources: ResourceTree;\n  }\n>;\n\nexport type NormalizeResource<Resource extends ResourceDefinition> =\n  Resource extends string\n    ? {\n        [Key in Resource]: {\n          subResources: {};\n        };\n      }\n    : Resource extends {\n          value: infer Value extends string;\n          subResources: infer SubResources extends\n            ReadonlyArray<ResourceDefinition>;\n        }\n      ? {\n          [Key in Value]: {\n            subResources: NormalizeResources<SubResources>;\n          };\n        }\n      : never;\n\nexport type NormalizeResources<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = MergeIntersection<\n  UnionToIntersection<NormalizeResource<Resources[number]>>\n>;\nexport type ResourceLayoutComponentProps = {\n  children: ReactNode;\n};\n\nfunction normalizeResourceTree(resource: ResourceDefinition): ResourceTree {\n  if (typeof resource === 'string') {\n    return {\n      [resource]: {\n        subResources: {},\n      },\n    };\n  }\n\n  const { value, subResources } = resource;\n\n  return {\n    [value]: {\n      subResources: normalizeResourcesTree(subResources),\n    },\n  };\n}\n\nfunction normalizeResourcesTree(\n  resources: ReadonlyArray<ResourceDefinition>,\n): ResourceTree {\n  const normalizedResources: ResourceTree = {};\n\n  for (const resource of resources) {\n    Object.assign(normalizedResources, normalizeResourceTree(resource));\n  }\n\n  return normalizedResources;\n}\n\nexport function normalizeResource(resource: ResourceDefinition): ResourceTree {\n  return normalizeResourceTree(resource);\n}\n\nexport function normalizeResources<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n>(resources: Resources): NormalizeResources<Resources> {\n  return normalizeResourcesTree(resources) as NormalizeResources<Resources>;\n}\n\nexport function createIsValidResourceFn<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n>(resources: Resources) {\n  return (value: unknown): value is LayoutResourceKey<Resources> => {\n    return (\n      typeof value === 'string' &&\n      Object.keys(normalizeResources(resources)).includes(value)\n    );\n  };\n}\n\ntype ResourceDefinitionValue<Resource extends ResourceDefinition> =\n  Resource extends string\n    ? Resource\n    : Resource extends { value: infer Value extends string }\n      ? Value\n      : never;\n\n/**\n * Top-level resource names declared in a `resources` array. Preserves string\n * literal unions for const resource definitions (unlike `keyof` on the\n * normalized resource tree, which tends to widen to `string` in hovers).\n */\nexport type LayoutResourceKey<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = ResourceDefinitionValue<Resources[number]>;\n\nexport type ResourceDefinitionForKey<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Key extends string,\n> = Extract<Resources[number], Key | { value: Key }>;\n\n/** `subResources` array declared on a layout resource. */\nexport type SubResourceDefinitionsFor<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends LayoutResourceKey<Resources>,\n> =\n  ResourceDefinitionForKey<Resources, Resource> extends {\n    subResources: infer SubResources extends ReadonlyArray<ResourceDefinition>;\n  }\n    ? SubResources\n    : readonly [];\n\ntype CanNestSubResourceParam<\n  MaxDepth extends number,\n  DepthAcc extends readonly unknown[],\n> = [...DepthAcc, unknown]['length'] extends MaxDepth ? false : true;\n\n/**\n * `subResource` route param: a slug at the current depth, or `{ value, subResource }`\n * when that slug has nested `subResources` in the layout tree and `MaxDepth` allows it.\n */\nexport type RecursiveSubResourceParam<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  SubDefs extends ReadonlyArray<ResourceDefinition>,\n  MaxDepth extends number = 6,\n  DepthAcc extends readonly unknown[] = readonly [],\n> =\n  LayoutResourceKey<SubDefs> extends infer Key\n    ? Key extends LayoutResourceKey<SubDefs>\n      ? CanNestSubResourceParam<MaxDepth, DepthAcc> extends true\n        ? ResourceDefinitionForKey<SubDefs, Key> extends {\n            subResources: infer Nested extends\n              ReadonlyArray<ResourceDefinition>;\n          }\n          ? [LayoutResourceKey<Nested>] extends [never]\n            ? Key\n            :\n                | Key\n                | {\n                    value: Key;\n                    subResource: RecursiveSubResourceParam<\n                      Resources,\n                      Nested,\n                      MaxDepth,\n                      readonly [...DepthAcc, unknown]\n                    >;\n                  }\n          : Key\n        : Key\n      : never\n    : never;\n\n/** Recursive `subResource` values for a layout resource (full tree depth). */\nexport type SubResourceParamForResource<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends LayoutResourceKey<Resources>,\n> = [SubResourceDefinitionsFor<Resources, Resource>] extends [readonly []]\n  ? never\n  : RecursiveSubResourceParam<\n      Resources,\n      SubResourceDefinitionsFor<Resources, Resource>\n    >;\n\nexport type GetSubResourceKeys<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends LayoutResourceKey<Resources>,\n> =\n  ResourceDefinitionForKey<Resources, Resource> extends {\n    subResources: infer SubResources extends ReadonlyArray<ResourceDefinition>;\n  }\n    ? LayoutResourceKey<SubResources>\n    : never;\nexport type ResourceEnum<Resources extends ReadonlyArray<ResourceDefinition>> =\n  NonEmptyReadonlyArray<LayoutResourceKey<Resources>>;\nexport function toResourceEnum<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n>(resources: NormalizeResources<Resources>) {\n  const keys = Object.keys(resources);\n\n  if (keys.length === 0) {\n    throw new Error('No resources provided');\n  }\n\n  return keys as unknown as ResourceEnum<Resources>;\n}\n"],"mappings":";AAuDA,SAAS,sBAAsB,UAA4C;CACzE,IAAI,OAAO,aAAa,UACtB,OAAO,GACJ,WAAW,EACV,cAAc,CAAC,EACjB,EACF;CAGF,MAAM,EAAE,OAAO,iBAAiB;CAEhC,OAAO,GACJ,QAAQ,EACP,cAAc,uBAAuB,YAAY,EACnD,EACF;AACF;AAEA,SAAS,uBACP,WACc;CACd,MAAM,sBAAoC,CAAC;CAE3C,KAAK,MAAM,YAAY,WACrB,OAAO,OAAO,qBAAqB,sBAAsB,QAAQ,CAAC;CAGpE,OAAO;AACT;AAEA,SAAgB,kBAAkB,UAA4C;CAC5E,OAAO,sBAAsB,QAAQ;AACvC;AAEA,SAAgB,mBAEd,WAAqD;CACrD,OAAO,uBAAuB,SAAS;AACzC;AAEA,SAAgB,wBAEd,WAAsB;CACtB,QAAQ,UAA0D;EAChE,OACE,OAAO,UAAU,YACjB,OAAO,KAAK,mBAAmB,SAAS,CAAC,EAAE,SAAS,KAAK;CAE7D;AACF;AAgGA,SAAgB,eAEd,WAA0C;CAC1C,MAAM,OAAO,OAAO,KAAK,SAAS;CAElC,IAAI,KAAK,WAAW,GAClB,MAAM,IAAI,MAAM,uBAAuB;CAGzC,OAAO;AACT"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jfdevelops/react-layout",
-  "version": "0.18.1",
+  "version": "0.19.0",
   "description": "A React library for creating layout components.",
   "repository": {
     "type": "git",