@jfdevelops/react-layout 0.15.1 → 0.17.0

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

@@ -4,7 +4,7 @@ const require_capitalize = require('../utils/capitalize.cjs');
 const require_get_component = require('./get-component.cjs');
 const require_create_resource_links = require('./create-resource-links.cjs');
 const require_for_resource = require('./for-resource.cjs');
-const require_for_resources = require('./for-resources.cjs');
+const require_create_for_resources = require('./for-resources/create-for-resources.cjs');
 let _jfdevelops_react_layout_composables = require("@jfdevelops/react-layout-composables");
 let _jfdevelops_react_layout_validator = require("@jfdevelops/react-layout-validator");
 let react_jsx_runtime = require("react/jsx-runtime");
@@ -50,8 +50,8 @@ function resolveLayoutOptionDefaults(defaults, options) {
 	else resolved[key] = require_utils.functionalUpdate(defaultValue, options[key]);
 	return resolved;
 }
-function defineResourceLayout(options) {
-	const { options: inProps, resources, layout } = options;
+function defineResourceLayoutImpl(options) {
+	const { options: inProps = {}, resources, layout } = options;
 	const normalizedResources = require_resource.normalizeResources(resources);
 	const resourcesEnum = (0, _jfdevelops_react_layout_validator.createPrimitivePropBuilder)("string").enum(require_resource.toResourceEnum(normalizedResources));
 	const definedResourceLayout = ((layoutOptions) => {
@@ -159,7 +159,7 @@ function defineResourceLayout(options) {
 	});
 	const createResourceLayoutExtras = {
 		forResource,
-		forResources: require_for_resources.createForResources({
+		forResources: require_create_for_resources.createForResources({
 			createLayoutForResource: createLayoutForResourceBuilder,
 			...layout.composables ? { createMakeComposableLayout: createTopLevelMakeComposable } : {},
 			createResourceLayout: definedResourceLayout,
@@ -173,6 +173,17 @@ function defineResourceLayout(options) {
 		createResourceLinks: require_create_resource_links.createResourceLinksFn(resources)
 	};
 }
+function defineResourceLayoutForResources(...baseResources) {
+	return ((options) => {
+		const { resources: extraResources, ...rest } = options;
+		const resources = extraResources ? [...baseResources, ...extraResources] : [...baseResources];
+		return defineResourceLayoutImpl({
+			...rest,
+			resources
+		});
+	});
+}
+const defineResourceLayout = Object.assign(defineResourceLayoutImpl, { forResources: defineResourceLayoutForResources });
 
 //#endregion
 exports.defineResourceLayout = defineResourceLayout;

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

@@ -1 +1 @@
-{"version":3,"file":"define-layout.cjs","names":["capitalize","functionalUpdate","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  resolveComposablePresetProps,\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  InferredInProps,\n  InPropsDefinition,\n  InPropsObject,\n  LayoutRenderProps,\n  MergedLayoutInProps,\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 {\n  type CreateResourceConfigFn,\n  createResourceConfig,\n} from './get-component';\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\ntype 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 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.\n   */\n  resources: 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> = ResourceLayoutComposition<Name, Composables> &\n  BaseComponent<Name, ResolveProps<Props>> & {\n    (props: Show<ResolveProps<Props>>): 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> = ResolveLayoutProps<InferredInProps<Resources, InProps>> &\n  RequiredPresetLayoutProps<Composables>;\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    Name,\n    Resource,\n    Props\n  >,\n) => ResourceLayoutComponent<Name, CustomProps, Composables, Resource>;\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> = CreateResourceLayoutOptionsBase<Resources, Name, Resource, Props> &\n  Partial<LayoutPropsForResource<Resources, InProps, Composables>>;\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  >,\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\nexport function defineResourceLayout<\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) {\n  const { options: inProps, resources, layout } = options;\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      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 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 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 = resolveComposablePresetProps(\n      resolvedComposables,\n      layoutOptionProps as Record<string, unknown>,\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(props: Show<ResolveProps<CustomProps>>) {\n      const validatedProps = validateProps(resolvedLayoutProps, props);\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 layoutOptionValue = readLayoutOptionValue(\n          key,\n          definition,\n          layoutOptionProps,\n        );\n        const splitValue = key in splitInProps ? splitInProps[key] : undefined;\n        const value = 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]) => includeLayoutProps?.[key] === true,\n        ),\n      );\n      const optionalIncludedPropDefinitions = Object.fromEntries(\n        Object.entries(includedPropDefinitions).filter(\n          ([key]) =>\n            includeLayoutProps?.[key] === 'optional' &&\n            includedPropValues[key] !== undefined,\n        ),\n      );\n      const validatedIncludedProps = validateProps(\n        {\n          ...requiredIncludedPropDefinitions,\n          ...optionalIncludedPropDefinitions,\n        } as Record<string, AnyBuiltPropDefinition>,\n        includedPropValues,\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 ResolveProps<CustomProps>,\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(\n    resource: LayoutResourceKey<Resources>,\n  ) {\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"],"mappings":"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"}
+{"version":3,"file":"define-layout.cjs","names":["capitalize","functionalUpdate","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  resolveComposablePresetProps,\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  InferredInProps,\n  InPropsDefinition,\n  InPropsObject,\n  LayoutRenderProps,\n  MergedLayoutInProps,\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 {\n  type CreateResourceConfigFn,\n  createResourceConfig,\n} from './get-component';\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 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.\n   */\n  resources: 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> = ResourceLayoutComposition<Name, Composables> &\n  BaseComponent<Name, ResolveProps<Props>> & {\n    (props: Show<ResolveProps<Props>>): 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> = ResolveLayoutProps<InferredInProps<Resources, InProps>> &\n  RequiredPresetLayoutProps<Composables>;\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    Name,\n    Resource,\n    Props\n  >,\n) => ResourceLayoutComponent<Name, CustomProps, Composables, Resource>;\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> = CreateResourceLayoutOptionsBase<Resources, Name, Resource, Props> &\n  Partial<LayoutPropsForResource<Resources, InProps, Composables>>;\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  >,\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\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  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      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 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 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 = resolveComposablePresetProps(\n      resolvedComposables,\n      layoutOptionProps as Record<string, unknown>,\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(props: Show<ResolveProps<CustomProps>>) {\n      const validatedProps = validateProps(resolvedLayoutProps, props);\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 layoutOptionValue = readLayoutOptionValue(\n          key,\n          definition,\n          layoutOptionProps,\n        );\n        const splitValue = key in splitInProps ? splitInProps[key] : undefined;\n        const value = 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]) => includeLayoutProps?.[key] === true,\n        ),\n      );\n      const optionalIncludedPropDefinitions = Object.fromEntries(\n        Object.entries(includedPropDefinitions).filter(\n          ([key]) =>\n            includeLayoutProps?.[key] === 'optional' &&\n            includedPropValues[key] !== undefined,\n        ),\n      );\n      const validatedIncludedProps = validateProps(\n        {\n          ...requiredIncludedPropDefinitions,\n          ...optionalIncludedPropDefinitions,\n        } as Record<string, AnyBuiltPropDefinition>,\n        includedPropValues,\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 ResolveProps<CustomProps>,\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?: 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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"}

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

@@ -4,7 +4,7 @@ import { InPropsDefinition, InPropsObject, IncludedProps, InferredInProps, Layou
 import { CreateResourceConfigFn } from "./get-component.cjs";
 import { CreateResourceLinksFn } from "./create-resource-links.cjs";
 import { CreateLayoutForResource, CreateResourceLayoutOptions, CreateResourceLayoutOptionsBase } from "./for-resource.cjs";
-import { CreateResourceLayoutForResourcesFn } from "./for-resources.cjs";
+import { CreateResourceLayoutForResourcesFn } from "./for-resources/scoped-layout.cjs";
 import { ComposableComponents, ComposableResourceLayout, CreateLayoutComposable, MakeComposable, RequiredPresetLayoutProps } from "@jfdevelops/react-layout-composables";
 import { JSX } from "react";
 import { ResolveLayoutProps, ResolveProps } from "@jfdevelops/react-layout-validator";
@@ -28,7 +28,7 @@ type LayoutRenderContext<Resources extends ReadonlyArray<ResourceDefinition>, Co
   name: string;
 };
 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 = {}> = {
+type CreateViewMapOptions<Resources extends ReadonlyArray<ResourceDefinition>, Options extends InPropsDefinition<Resources> = {}, Composables extends ComposableComponents = {}, IncludeProps extends LayoutIncludeProps<Resources, Options, Composables> = {}, CustomProps extends InPropsObject = {}> = {
   /**
    * An array of valid resource names to support.
    */
@@ -36,7 +36,7 @@ type CreateViewMapOptions<Resources extends ReadonlyArray<ResourceDefinition>, O
   /**
    * The options that are passed into the created resource layout.
    */
-  options: Options;
+  options?: Options;
   layout: {
     /**
      * The props to pass to the layout.
@@ -88,7 +88,33 @@ type DefinedResourceLayout<Resources extends ReadonlyArray<ResourceDefinition>,
   createResourceLayout: CreateResourceLayoutFn<Resources, InProps, Composables, IncludeProps, CustomProps>;
   createResourceLinks: CreateResourceLinksFn<Resources>;
 };
-declare function defineResourceLayout<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>;
+type DefineResourceLayoutForResourcesOptions<Resources extends ReadonlyArray<ResourceDefinition>, InProps extends InPropsDefinition<Resources> = {}, Composables extends ComposableComponents = {}, IncludeProps extends LayoutIncludeProps<Resources, InProps, Composables> = {}, CustomProps extends InPropsObject = {}, ExtraResources extends ReadonlyArray<ResourceDefinition> = []> = Omit<CreateViewMapOptions<Resources, InProps, Composables, IncludeProps, CustomProps>, 'resources'> & {
+  /**
+   * Additional resources to merge with those bound by
+   * {@link defineResourceLayout.forResources}.
+   */
+  resources?: ExtraResources;
+};
+type NonEmptyResourceDefinitions = readonly [ResourceDefinition, ...ResourceDefinition[]];
+/**
+ * Factory returned by {@link DefineResourceLayout.forResources}.
+ */
+type DefineResourceLayoutForResourcesFactory<BaseResources extends NonEmptyResourceDefinitions> = <const ExtraResources extends ReadonlyArray<ResourceDefinition> = [], InProps extends InPropsDefinition<[...BaseResources, ...ExtraResources]> = {}, Composables extends ComposableComponents = {}, const IncludeProps extends LayoutIncludeProps<[...BaseResources, ...ExtraResources], InProps, Composables> = {}, CustomProps extends InPropsObject = {}>(options: DefineResourceLayoutForResourcesOptions<[...BaseResources, ...ExtraResources], InProps, Composables, IncludeProps, CustomProps, ExtraResources>) => DefinedResourceLayout<[...BaseResources, ...ExtraResources], InProps, Composables, IncludeProps, CustomProps>;
+/**
+ * Binds one or more resources, then accepts the remaining
+ * {@link defineResourceLayout} options (with optional extra `resources`).
+ */
+type DefineResourceLayoutForResources = <const Resources extends NonEmptyResourceDefinitions>(...resources: Resources) => DefineResourceLayoutForResourcesFactory<Resources>;
+/**
+ * Creates a resource layout definition for a set of resources.
+ */
+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>;
+};
+type DefineResourceLayout = DefineResourceLayoutFn & {
+  forResources: DefineResourceLayoutForResources;
+};
+declare const defineResourceLayout: DefineResourceLayout;
 //#endregion
-export { CreateResourceLayoutFn, CreateResourceLayoutMakeComposableOptions, LayoutIncludeProps, LayoutPropsForResource, ResourceLayoutComponent, defineResourceLayout };
+export { CreateResourceLayoutFn, CreateResourceLayoutMakeComposableOptions, DefineResourceLayout, DefineResourceLayoutFn, DefineResourceLayoutForResources, DefineResourceLayoutForResourcesFactory, LayoutIncludeProps, LayoutProps, LayoutPropsForResource, 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":";;;;;;;;;;;;KA2DY,kBAAA,mBACQ,aAAA,CAAc,kBAAA,mBAChB,iBAAA,CAAkB,SAAA,uBACd,oBAAA,IAClB,aAAA,CAAc,mBAAA,CAAoB,SAAA,EAAW,OAAA,EAAS,WAAA;AAAA,KAE9C,WAAA,mBACQ,aAAA,CAAc,kBAAA,mBAChB,iBAAA,CAAkB,SAAA,uBACd,oBAAA,uBACC,kBAAA,CAAmB,SAAA,EAAW,OAAA,EAAS,WAAA,4BACxC,aAAA;;AAXtB;;EAgBE,OAAA,GAAU,kBAAA,CAAmB,SAAA,EAAW,OAAA,EAAS,WAAA,IAAe,YAAA;EAfhC;;;EAmBhC,MAAA,GAAS,WAAA;AAAA;AAAA,KAGN,mBAAA,mBACe,aAAA,CAAc,kBAAA,uBACZ,oBAAA;EAEpB,WAAA,EAAa,uBAAA,CAAwB,WAAA;EACrC,OAAA,EAAS,MAAA;EACT,QAAA,EAAU,iBAAA,CAAkB,SAAA;EAC5B,IAAA;AAAA;AAAA,KAEG,uBAAA,qBAA4C,oBAAA,WACzC,WAAA,gCAGJ,WAAA;AAAA,KA4GC,oBAAA,mBACe,aAAA,CAAc,kBAAA,mBAChB,iBAAA,CAAkB,SAAA,4BACd,oBAAA,4BACC,kBAAA,CAAmB,SAAA,EAAW,OAAA,EAAS,WAAA,4BACxC,aAAA;EAnJpB;;;EAwJA,SAAA,EAAW,SAAA;EAvJS;;;EA2JpB,OAAA,GAAU,OAAA;EACV,MAAA;IA3JwD;;AAAW;IA+JjE,KAAA,GAAQ,WAAA,CACN,SAAA,EACA,OAAA,EACA,WAAA,EACA,YAAA,EACA,WAAA;IAlKiB;;;;;IAyKnB,WAAA,IACE,MAAA,EAAQ,sBAAA,CAAuB,iBAAA,CAAkB,SAAA,OAC9C,WAAA;IAxKa;;;IA4KlB,MAAA,GACE,KAAA,EAAO,iBAAA,CACL,SAAA,EACA,OAAA,EACA,WAAA,EACA,YAAA,EACA,WAAA,GAEF,OAAA,EAAS,mBAAA,CAAoB,SAAA,EAAW,WAAA,MACrC,GAAA,CAAI,OAAA;EAAA;AAAA;AAAA,KAIR,yBAAA,0CAEiB,oBAAA,WACX,WAAA;EAGL,cAAA,EAAgB,cAAA,CAAe,WAAA,EAAa,IAAA;AAAA;AAAA,KAEtC,uBAAA,oCAEI,aAAA,2BACM,oBAAA,2CAElB,yBAAA,CAA0B,IAAA,EAAM,WAAA,IAClC,aAAA,CAAc,IAAA,EAAM,YAAA,CAAa,KAAA;EAAA,CAC9B,KAAA,EAAO,IAAA,CAAK,YAAA,CAAa,KAAA,KAAU,GAAA,CAAI,OAAA;EA7LjC;;;;EAAA,SAkME,QAAA,EAAU,QAAA;AAAA;AAAA,KAGX,sBAAA,mBACQ,aAAA,CAAc,kBAAA,mBAChB,iBAAA,CAAkB,SAAA,uBACd,oBAAA,SAClB,kBAAA,CAAmB,eAAA,CAAgB,SAAA,EAAW,OAAA,KAChD,yBAAA,CAA0B,WAAA;AAAA,KAEvB,0BAAA,mBACe,aAAA,CAAc,kBAAA,mBAChB,iBAAA,CAAkB,SAAA,uBACd,oBAAA,uBACC,kBAAA,CAAmB,SAAA,EAAW,OAAA,EAAS,WAAA,4BACxC,aAAA,gDAGH,iBAAA,CAAkB,SAAA,iBACrB,aAAA,OAEd,OAAA,EAAS,2BAAA,CACP,SAAA,EACA,OAAA,EACA,WAAA,EACA,IAAA,EACA,QAAA,EACA,KAAA,MAEC,uBAAA,CAAwB,IAAA,EAAM,WAAA,EAAa,WAAA,EAAa,QAAA;AAAA,KAEjD,yCAAA,mBACQ,aAAA,CAAc,kBAAA,mBAChB,iBAAA,CAAkB,SAAA,uBACd,oBAAA,wCAEH,iBAAA,CAAkB,SAAA,iBACrB,aAAA,SACZ,+BAAA,CAAgC,SAAA,EAAW,IAAA,EAAM,QAAA,EAAU,KAAA,IAC7D,OAAA,CAAQ,sBAAA,CAAuB,SAAA,EAAW,OAAA,EAAS,WAAA;AAAA,KAEhD,oCAAA,mBACe,aAAA,CAAc,kBAAA,mBAChB,iBAAA,CAAkB,SAAA,uBACd,oBAAA,uBACC,kBAAA,CAAmB,SAAA,EAAW,OAAA,EAAS,WAAA,uBACxC,aAAA,2CAGH,iBAAA,CAAkB,SAAA,iBACrB,aAAA,OAEd,OAAA,EAAS,yCAAA,CACP,SAAA,EACA,OAAA,EACA,WAAA,EACA,IAAA,EACA,QAAA,EACA,KAAA,MAEC,wBAAA,CAAyB,WAAA,EAAa,IAAA;AAAA,KAEtC,0BAAA,mBACe,aAAA,CAAc,kBAAA,mBAChB,iBAAA,CAAkB,SAAA,uBACd,oBAAA,4BACC,kBAAA,CAAmB,SAAA,EAAW,OAAA,EAAS,WAAA,4BACxC,aAAA,SAClB,0BAAA,CACF,SAAA,EACA,OAAA,EACA,WAAA,EACA,YAAA,EACA,WAAA;EArRA;;;EA0RA,WAAA,EAAa,uBAAA,CACX,SAAA,EACA,OAAA,EACA,WAAA,EACA,YAAA,EACA,WAAA;EA/R0D;;;EAoS5D,YAAA,EAAc,kCAAA,CACZ,SAAA,EACA,OAAA,EACA,WAAA,EACA,YAAA,EACA,WAAA;AAAA;AAAA,KAIC,wCAAA,mBACe,aAAA,CAAc,kBAAA,mBAChB,iBAAA,CAAkB,SAAA,uBACd,oBAAA,uBACC,kBAAA,CAAmB,SAAA,EAAW,OAAA,EAAS,WAAA,uBACxC,aAAA,WACX,WAAA;EAGL,cAAA,EAAgB,oCAAA,CACd,SAAA,EACA,OAAA,EACA,WAAA,EACA,YAAA,EACA,WAAA;AAAA;AAAA,KAII,sBAAA,mBACQ,aAAA,CAAc,kBAAA,mBAChB,iBAAA,CAAkB,SAAA,uBACd,oBAAA,4BACC,kBAAA,CAAmB,SAAA,EAAW,OAAA,EAAS,WAAA,4BACxC,aAAA,SAClB,0BAAA,CACF,SAAA,EACA,OAAA,EACA,WAAA,EACA,YAAA,EACA,WAAA,IAEA,wCAAA,CACE,SAAA,EACA,OAAA,EACA,WAAA,EACA,YAAA,EACA,WAAA;AAAA,KAGC,qBAAA,mBACe,aAAA,CAAc,kBAAA,mBAChB,iBAAA,CAAkB,SAAA,uBACd,oBAAA,4BACC,kBAAA,CAAmB,SAAA,EAAW,OAAA,EAAS,WAAA,4BACxC,aAAA;EAEpB,oBAAA,EAAsB,sBAAA,CAAuB,SAAA;EAC7C,oBAAA,EAAsB,sBAAA,CACpB,SAAA,EACA,OAAA,EACA,WAAA,EACA,YAAA,EACA,WAAA;EAEF,mBAAA,EAAqB,qBAAA,CAAsB,SAAA;AAAA;AAAA,KA2VxC,uCAAA,mBACe,aAAA,CAAc,kBAAA,mBAChB,iBAAA,CAAkB,SAAA,4BACd,oBAAA,4BACC,kBAAA,CAAmB,SAAA,EAAW,OAAA,EAAS,WAAA,4BACxC,aAAA,8BACG,aAAA,CAAc,kBAAA,UACnC,IAAA,CACF,oBAAA,CACE,SAAA,EACA,OAAA,EACA,WAAA,EACA,YAAA,EACA,WAAA;EA9rBoB;;;;EAssBtB,SAAA,GAAY,cAAA;AAAA;AAAA,KAGT,2BAAA,aACH,kBAAA,KACG,kBAAkB;;;;KAMX,uCAAA,uBACY,2BAAA,kCAEO,aAAA,CAAc,kBAAA,wBAC3B,iBAAA,KAAsB,aAAA,KAAkB,cAAA,6BACpC,oBAAA,kCACO,kBAAA,KACrB,aAAA,KAAkB,cAAA,GACtB,OAAA,EACA,WAAA,4BAEkB,aAAA,OAEpB,OAAA,EAAS,uCAAA,KACH,aAAA,KAAkB,cAAA,GACtB,OAAA,EACA,WAAA,EACA,YAAA,EACA,WAAA,EACA,cAAA,MAEC,qBAAA,KACC,aAAA,KAAkB,cAAA,GACtB,OAAA,EACA,WAAA,EACA,YAAA,EACA,WAAA;;;;AApuBI;KA2uBM,gCAAA,4BACc,2BAAA,KAErB,SAAA,EAAW,SAAA,KACX,uCAAA,CAAwC,SAAA;;;;KAKjC,sBAAA;EAAA,yBAEgB,aAAA,CAAc,kBAAA,mBACtB,iBAAA,CAAkB,SAAA,4BACd,oBAAA,kCACO,kBAAA,CACzB,SAAA,EACA,OAAA,EACA,WAAA,4BAEkB,aAAA,OAEpB,OAAA,EAAS,oBAAA,CACP,SAAA,EACA,OAAA,EACA,WAAA,EACA,YAAA,EACA,WAAA,IAED,qBAAA,CACD,SAAA,EACA,OAAA,EACA,WAAA,EACA,YAAA,EACA,WAAA;AAAA;AAAA,KAIQ,oBAAA,GAAuB,sBAAA;EACjC,YAAA,EAAc,gCAAgC;AAAA;AAAA,cAqBnC,oBAAA,EAAsB,oBAKlC"}

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

@@ -4,7 +4,7 @@ import { InPropsDefinition, InPropsObject, IncludedProps, InferredInProps, Layou
 import { CreateResourceConfigFn } from "./get-component.mjs";
 import { CreateResourceLinksFn } from "./create-resource-links.mjs";
 import { CreateLayoutForResource, CreateResourceLayoutOptions, CreateResourceLayoutOptionsBase } from "./for-resource.mjs";
-import { CreateResourceLayoutForResourcesFn } from "./for-resources.mjs";
+import { CreateResourceLayoutForResourcesFn } from "./for-resources/scoped-layout.mjs";
 import { ComposableComponents, ComposableResourceLayout, CreateLayoutComposable, MakeComposable, RequiredPresetLayoutProps } from "@jfdevelops/react-layout-composables";
 import { ResolveLayoutProps, ResolveProps } from "@jfdevelops/react-layout-validator";
 import { JSX } from "react";
@@ -28,7 +28,7 @@ type LayoutRenderContext<Resources extends ReadonlyArray<ResourceDefinition>, Co
   name: string;
 };
 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 = {}> = {
+type CreateViewMapOptions<Resources extends ReadonlyArray<ResourceDefinition>, Options extends InPropsDefinition<Resources> = {}, Composables extends ComposableComponents = {}, IncludeProps extends LayoutIncludeProps<Resources, Options, Composables> = {}, CustomProps extends InPropsObject = {}> = {
   /**
    * An array of valid resource names to support.
    */
@@ -36,7 +36,7 @@ type CreateViewMapOptions<Resources extends ReadonlyArray<ResourceDefinition>, O
   /**
    * The options that are passed into the created resource layout.
    */
-  options: Options;
+  options?: Options;
   layout: {
     /**
      * The props to pass to the layout.
@@ -88,7 +88,33 @@ type DefinedResourceLayout<Resources extends ReadonlyArray<ResourceDefinition>,
   createResourceLayout: CreateResourceLayoutFn<Resources, InProps, Composables, IncludeProps, CustomProps>;
   createResourceLinks: CreateResourceLinksFn<Resources>;
 };
-declare function defineResourceLayout<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>;
+type DefineResourceLayoutForResourcesOptions<Resources extends ReadonlyArray<ResourceDefinition>, InProps extends InPropsDefinition<Resources> = {}, Composables extends ComposableComponents = {}, IncludeProps extends LayoutIncludeProps<Resources, InProps, Composables> = {}, CustomProps extends InPropsObject = {}, ExtraResources extends ReadonlyArray<ResourceDefinition> = []> = Omit<CreateViewMapOptions<Resources, InProps, Composables, IncludeProps, CustomProps>, 'resources'> & {
+  /**
+   * Additional resources to merge with those bound by
+   * {@link defineResourceLayout.forResources}.
+   */
+  resources?: ExtraResources;
+};
+type NonEmptyResourceDefinitions = readonly [ResourceDefinition, ...ResourceDefinition[]];
+/**
+ * Factory returned by {@link DefineResourceLayout.forResources}.
+ */
+type DefineResourceLayoutForResourcesFactory<BaseResources extends NonEmptyResourceDefinitions> = <const ExtraResources extends ReadonlyArray<ResourceDefinition> = [], InProps extends InPropsDefinition<[...BaseResources, ...ExtraResources]> = {}, Composables extends ComposableComponents = {}, const IncludeProps extends LayoutIncludeProps<[...BaseResources, ...ExtraResources], InProps, Composables> = {}, CustomProps extends InPropsObject = {}>(options: DefineResourceLayoutForResourcesOptions<[...BaseResources, ...ExtraResources], InProps, Composables, IncludeProps, CustomProps, ExtraResources>) => DefinedResourceLayout<[...BaseResources, ...ExtraResources], InProps, Composables, IncludeProps, CustomProps>;
+/**
+ * Binds one or more resources, then accepts the remaining
+ * {@link defineResourceLayout} options (with optional extra `resources`).
+ */
+type DefineResourceLayoutForResources = <const Resources extends NonEmptyResourceDefinitions>(...resources: Resources) => DefineResourceLayoutForResourcesFactory<Resources>;
+/**
+ * Creates a resource layout definition for a set of resources.
+ */
+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>;
+};
+type DefineResourceLayout = DefineResourceLayoutFn & {
+  forResources: DefineResourceLayoutForResources;
+};
+declare const defineResourceLayout: DefineResourceLayout;
 //#endregion
-export { CreateResourceLayoutFn, CreateResourceLayoutMakeComposableOptions, LayoutIncludeProps, LayoutPropsForResource, ResourceLayoutComponent, defineResourceLayout };
+export { CreateResourceLayoutFn, CreateResourceLayoutMakeComposableOptions, DefineResourceLayout, DefineResourceLayoutFn, DefineResourceLayoutForResources, DefineResourceLayoutForResourcesFactory, LayoutIncludeProps, LayoutProps, LayoutPropsForResource, 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":";;;;;;;;;;;;KA2DY,kBAAA,mBACQ,aAAA,CAAc,kBAAA,mBAChB,iBAAA,CAAkB,SAAA,uBACd,oBAAA,IAClB,aAAA,CAAc,mBAAA,CAAoB,SAAA,EAAW,OAAA,EAAS,WAAA;AAAA,KAE9C,WAAA,mBACQ,aAAA,CAAc,kBAAA,mBAChB,iBAAA,CAAkB,SAAA,uBACd,oBAAA,uBACC,kBAAA,CAAmB,SAAA,EAAW,OAAA,EAAS,WAAA,4BACxC,aAAA;;AAXtB;;EAgBE,OAAA,GAAU,kBAAA,CAAmB,SAAA,EAAW,OAAA,EAAS,WAAA,IAAe,YAAA;EAfhC;;;EAmBhC,MAAA,GAAS,WAAA;AAAA;AAAA,KAGN,mBAAA,mBACe,aAAA,CAAc,kBAAA,uBACZ,oBAAA;EAEpB,WAAA,EAAa,uBAAA,CAAwB,WAAA;EACrC,OAAA,EAAS,MAAA;EACT,QAAA,EAAU,iBAAA,CAAkB,SAAA;EAC5B,IAAA;AAAA;AAAA,KAEG,uBAAA,qBAA4C,oBAAA,WACzC,WAAA,gCAGJ,WAAA;AAAA,KA4GC,oBAAA,mBACe,aAAA,CAAc,kBAAA,mBAChB,iBAAA,CAAkB,SAAA,4BACd,oBAAA,4BACC,kBAAA,CAAmB,SAAA,EAAW,OAAA,EAAS,WAAA,4BACxC,aAAA;EAnJpB;;;EAwJA,SAAA,EAAW,SAAA;EAvJS;;;EA2JpB,OAAA,GAAU,OAAA;EACV,MAAA;IA3JwD;;AAAW;IA+JjE,KAAA,GAAQ,WAAA,CACN,SAAA,EACA,OAAA,EACA,WAAA,EACA,YAAA,EACA,WAAA;IAlKiB;;;;;IAyKnB,WAAA,IACE,MAAA,EAAQ,sBAAA,CAAuB,iBAAA,CAAkB,SAAA,OAC9C,WAAA;IAxKa;;;IA4KlB,MAAA,GACE,KAAA,EAAO,iBAAA,CACL,SAAA,EACA,OAAA,EACA,WAAA,EACA,YAAA,EACA,WAAA,GAEF,OAAA,EAAS,mBAAA,CAAoB,SAAA,EAAW,WAAA,MACrC,GAAA,CAAI,OAAA;EAAA;AAAA;AAAA,KAIR,yBAAA,0CAEiB,oBAAA,WACX,WAAA;EAGL,cAAA,EAAgB,cAAA,CAAe,WAAA,EAAa,IAAA;AAAA;AAAA,KAEtC,uBAAA,oCAEI,aAAA,2BACM,oBAAA,2CAElB,yBAAA,CAA0B,IAAA,EAAM,WAAA,IAClC,aAAA,CAAc,IAAA,EAAM,YAAA,CAAa,KAAA;EAAA,CAC9B,KAAA,EAAO,IAAA,CAAK,YAAA,CAAa,KAAA,KAAU,GAAA,CAAI,OAAA;EA7LjC;;;;EAAA,SAkME,QAAA,EAAU,QAAA;AAAA;AAAA,KAGX,sBAAA,mBACQ,aAAA,CAAc,kBAAA,mBAChB,iBAAA,CAAkB,SAAA,uBACd,oBAAA,SAClB,kBAAA,CAAmB,eAAA,CAAgB,SAAA,EAAW,OAAA,KAChD,yBAAA,CAA0B,WAAA;AAAA,KAEvB,0BAAA,mBACe,aAAA,CAAc,kBAAA,mBAChB,iBAAA,CAAkB,SAAA,uBACd,oBAAA,uBACC,kBAAA,CAAmB,SAAA,EAAW,OAAA,EAAS,WAAA,4BACxC,aAAA,gDAGH,iBAAA,CAAkB,SAAA,iBACrB,aAAA,OAEd,OAAA,EAAS,2BAAA,CACP,SAAA,EACA,OAAA,EACA,WAAA,EACA,IAAA,EACA,QAAA,EACA,KAAA,MAEC,uBAAA,CAAwB,IAAA,EAAM,WAAA,EAAa,WAAA,EAAa,QAAA;AAAA,KAEjD,yCAAA,mBACQ,aAAA,CAAc,kBAAA,mBAChB,iBAAA,CAAkB,SAAA,uBACd,oBAAA,wCAEH,iBAAA,CAAkB,SAAA,iBACrB,aAAA,SACZ,+BAAA,CAAgC,SAAA,EAAW,IAAA,EAAM,QAAA,EAAU,KAAA,IAC7D,OAAA,CAAQ,sBAAA,CAAuB,SAAA,EAAW,OAAA,EAAS,WAAA;AAAA,KAEhD,oCAAA,mBACe,aAAA,CAAc,kBAAA,mBAChB,iBAAA,CAAkB,SAAA,uBACd,oBAAA,uBACC,kBAAA,CAAmB,SAAA,EAAW,OAAA,EAAS,WAAA,uBACxC,aAAA,2CAGH,iBAAA,CAAkB,SAAA,iBACrB,aAAA,OAEd,OAAA,EAAS,yCAAA,CACP,SAAA,EACA,OAAA,EACA,WAAA,EACA,IAAA,EACA,QAAA,EACA,KAAA,MAEC,wBAAA,CAAyB,WAAA,EAAa,IAAA;AAAA,KAEtC,0BAAA,mBACe,aAAA,CAAc,kBAAA,mBAChB,iBAAA,CAAkB,SAAA,uBACd,oBAAA,4BACC,kBAAA,CAAmB,SAAA,EAAW,OAAA,EAAS,WAAA,4BACxC,aAAA,SAClB,0BAAA,CACF,SAAA,EACA,OAAA,EACA,WAAA,EACA,YAAA,EACA,WAAA;EArRA;;;EA0RA,WAAA,EAAa,uBAAA,CACX,SAAA,EACA,OAAA,EACA,WAAA,EACA,YAAA,EACA,WAAA;EA/R0D;;;EAoS5D,YAAA,EAAc,kCAAA,CACZ,SAAA,EACA,OAAA,EACA,WAAA,EACA,YAAA,EACA,WAAA;AAAA;AAAA,KAIC,wCAAA,mBACe,aAAA,CAAc,kBAAA,mBAChB,iBAAA,CAAkB,SAAA,uBACd,oBAAA,uBACC,kBAAA,CAAmB,SAAA,EAAW,OAAA,EAAS,WAAA,uBACxC,aAAA,WACX,WAAA;EAGL,cAAA,EAAgB,oCAAA,CACd,SAAA,EACA,OAAA,EACA,WAAA,EACA,YAAA,EACA,WAAA;AAAA;AAAA,KAII,sBAAA,mBACQ,aAAA,CAAc,kBAAA,mBAChB,iBAAA,CAAkB,SAAA,uBACd,oBAAA,4BACC,kBAAA,CAAmB,SAAA,EAAW,OAAA,EAAS,WAAA,4BACxC,aAAA,SAClB,0BAAA,CACF,SAAA,EACA,OAAA,EACA,WAAA,EACA,YAAA,EACA,WAAA,IAEA,wCAAA,CACE,SAAA,EACA,OAAA,EACA,WAAA,EACA,YAAA,EACA,WAAA;AAAA,KAGC,qBAAA,mBACe,aAAA,CAAc,kBAAA,mBAChB,iBAAA,CAAkB,SAAA,uBACd,oBAAA,4BACC,kBAAA,CAAmB,SAAA,EAAW,OAAA,EAAS,WAAA,4BACxC,aAAA;EAEpB,oBAAA,EAAsB,sBAAA,CAAuB,SAAA;EAC7C,oBAAA,EAAsB,sBAAA,CACpB,SAAA,EACA,OAAA,EACA,WAAA,EACA,YAAA,EACA,WAAA;EAEF,mBAAA,EAAqB,qBAAA,CAAsB,SAAA;AAAA;AAAA,KA2VxC,uCAAA,mBACe,aAAA,CAAc,kBAAA,mBAChB,iBAAA,CAAkB,SAAA,4BACd,oBAAA,4BACC,kBAAA,CAAmB,SAAA,EAAW,OAAA,EAAS,WAAA,4BACxC,aAAA,8BACG,aAAA,CAAc,kBAAA,UACnC,IAAA,CACF,oBAAA,CACE,SAAA,EACA,OAAA,EACA,WAAA,EACA,YAAA,EACA,WAAA;EA9rBoB;;;;EAssBtB,SAAA,GAAY,cAAA;AAAA;AAAA,KAGT,2BAAA,aACH,kBAAA,KACG,kBAAkB;;;;KAMX,uCAAA,uBACY,2BAAA,kCAEO,aAAA,CAAc,kBAAA,wBAC3B,iBAAA,KAAsB,aAAA,KAAkB,cAAA,6BACpC,oBAAA,kCACO,kBAAA,KACrB,aAAA,KAAkB,cAAA,GACtB,OAAA,EACA,WAAA,4BAEkB,aAAA,OAEpB,OAAA,EAAS,uCAAA,KACH,aAAA,KAAkB,cAAA,GACtB,OAAA,EACA,WAAA,EACA,YAAA,EACA,WAAA,EACA,cAAA,MAEC,qBAAA,KACC,aAAA,KAAkB,cAAA,GACtB,OAAA,EACA,WAAA,EACA,YAAA,EACA,WAAA;;;;AApuBI;KA2uBM,gCAAA,4BACc,2BAAA,KAErB,SAAA,EAAW,SAAA,KACX,uCAAA,CAAwC,SAAA;;;;KAKjC,sBAAA;EAAA,yBAEgB,aAAA,CAAc,kBAAA,mBACtB,iBAAA,CAAkB,SAAA,4BACd,oBAAA,kCACO,kBAAA,CACzB,SAAA,EACA,OAAA,EACA,WAAA,4BAEkB,aAAA,OAEpB,OAAA,EAAS,oBAAA,CACP,SAAA,EACA,OAAA,EACA,WAAA,EACA,YAAA,EACA,WAAA,IAED,qBAAA,CACD,SAAA,EACA,OAAA,EACA,WAAA,EACA,YAAA,EACA,WAAA;AAAA;AAAA,KAIQ,oBAAA,GAAuB,sBAAA;EACjC,YAAA,EAAc,gCAAgC;AAAA;AAAA,cAqBnC,oBAAA,EAAsB,oBAKlC"}

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

@@ -4,7 +4,7 @@ import { capitalize } from "../utils/capitalize.mjs";
 import { createResourceConfig } from "./get-component.mjs";
 import { createResourceLinksFn } from "./create-resource-links.mjs";
 import { createForResource } from "./for-resource.mjs";
-import { createForResources } from "./for-resources.mjs";
+import { createForResources } from "./for-resources/create-for-resources.mjs";
 import { LayoutComposablePresetProvider, collectComposablePresetEntries, makeComposable, resolveComposablePresetProps, resolveLayoutComposables } from "@jfdevelops/react-layout-composables";
 import { createPrimitivePropBuilder, createProp, resolvePropDefinitionValues, validateProps } from "@jfdevelops/react-layout-validator";
 import { jsx } from "react/jsx-runtime";
@@ -50,8 +50,8 @@ function resolveLayoutOptionDefaults(defaults, options) {
 	else resolved[key] = functionalUpdate(defaultValue, options[key]);
 	return resolved;
 }
-function defineResourceLayout(options) {
-	const { options: inProps, resources, layout } = options;
+function defineResourceLayoutImpl(options) {
+	const { options: inProps = {}, resources, layout } = options;
 	const normalizedResources = normalizeResources(resources);
 	const resourcesEnum = createPrimitivePropBuilder("string").enum(toResourceEnum(normalizedResources));
 	const definedResourceLayout = ((layoutOptions) => {
@@ -173,6 +173,17 @@ function defineResourceLayout(options) {
 		createResourceLinks: createResourceLinksFn(resources)
 	};
 }
+function defineResourceLayoutForResources(...baseResources) {
+	return ((options) => {
+		const { resources: extraResources, ...rest } = options;
+		const resources = extraResources ? [...baseResources, ...extraResources] : [...baseResources];
+		return defineResourceLayoutImpl({
+			...rest,
+			resources
+		});
+	});
+}
+const defineResourceLayout = Object.assign(defineResourceLayoutImpl, { forResources: defineResourceLayoutForResources });
 
 //#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  resolveComposablePresetProps,\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  InferredInProps,\n  InPropsDefinition,\n  InPropsObject,\n  LayoutRenderProps,\n  MergedLayoutInProps,\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 {\n  type CreateResourceConfigFn,\n  createResourceConfig,\n} from './get-component';\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\ntype 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 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.\n   */\n  resources: 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> = ResourceLayoutComposition<Name, Composables> &\n  BaseComponent<Name, ResolveProps<Props>> & {\n    (props: Show<ResolveProps<Props>>): 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> = ResolveLayoutProps<InferredInProps<Resources, InProps>> &\n  RequiredPresetLayoutProps<Composables>;\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    Name,\n    Resource,\n    Props\n  >,\n) => ResourceLayoutComponent<Name, CustomProps, Composables, Resource>;\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> = CreateResourceLayoutOptionsBase<Resources, Name, Resource, Props> &\n  Partial<LayoutPropsForResource<Resources, InProps, Composables>>;\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  >,\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\nexport function defineResourceLayout<\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) {\n  const { options: inProps, resources, layout } = options;\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      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 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 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 = resolveComposablePresetProps(\n      resolvedComposables,\n      layoutOptionProps as Record<string, unknown>,\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(props: Show<ResolveProps<CustomProps>>) {\n      const validatedProps = validateProps(resolvedLayoutProps, props);\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 layoutOptionValue = readLayoutOptionValue(\n          key,\n          definition,\n          layoutOptionProps,\n        );\n        const splitValue = key in splitInProps ? splitInProps[key] : undefined;\n        const value = 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]) => includeLayoutProps?.[key] === true,\n        ),\n      );\n      const optionalIncludedPropDefinitions = Object.fromEntries(\n        Object.entries(includedPropDefinitions).filter(\n          ([key]) =>\n            includeLayoutProps?.[key] === 'optional' &&\n            includedPropValues[key] !== undefined,\n        ),\n      );\n      const validatedIncludedProps = validateProps(\n        {\n          ...requiredIncludedPropDefinitions,\n          ...optionalIncludedPropDefinitions,\n        } as Record<string, AnyBuiltPropDefinition>,\n        includedPropValues,\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 ResolveProps<CustomProps>,\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(\n    resource: LayoutResourceKey<Resources>,\n  ) {\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"],"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  resolveComposablePresetProps,\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  InferredInProps,\n  InPropsDefinition,\n  InPropsObject,\n  LayoutRenderProps,\n  MergedLayoutInProps,\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 {\n  type CreateResourceConfigFn,\n  createResourceConfig,\n} from './get-component';\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 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.\n   */\n  resources: 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> = ResourceLayoutComposition<Name, Composables> &\n  BaseComponent<Name, ResolveProps<Props>> & {\n    (props: Show<ResolveProps<Props>>): 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> = ResolveLayoutProps<InferredInProps<Resources, InProps>> &\n  RequiredPresetLayoutProps<Composables>;\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    Name,\n    Resource,\n    Props\n  >,\n) => ResourceLayoutComponent<Name, CustomProps, Composables, Resource>;\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> = CreateResourceLayoutOptionsBase<Resources, Name, Resource, Props> &\n  Partial<LayoutPropsForResource<Resources, InProps, Composables>>;\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  >,\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\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  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      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 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 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 = resolveComposablePresetProps(\n      resolvedComposables,\n      layoutOptionProps as Record<string, unknown>,\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(props: Show<ResolveProps<CustomProps>>) {\n      const validatedProps = validateProps(resolvedLayoutProps, props);\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 layoutOptionValue = readLayoutOptionValue(\n          key,\n          definition,\n          layoutOptionProps,\n        );\n        const splitValue = key in splitInProps ? splitInProps[key] : undefined;\n        const value = 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]) => includeLayoutProps?.[key] === true,\n        ),\n      );\n      const optionalIncludedPropDefinitions = Object.fromEntries(\n        Object.entries(includedPropDefinitions).filter(\n          ([key]) =>\n            includeLayoutProps?.[key] === 'optional' &&\n            includedPropValues[key] !== undefined,\n        ),\n      );\n      const validatedIncludedProps = validateProps(\n        {\n          ...requiredIncludedPropDefinitions,\n          ...optionalIncludedPropDefinitions,\n        } as Record<string, AnyBuiltPropDefinition>,\n        includedPropValues,\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 ResolveProps<CustomProps>,\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?: 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":";;;;;;;;;;;;AAyGA,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,IACpC,WAAW,UAAU,IACrB;AACN;AAEA,SAAS,sBACP,YACA,YACA,SACA;CACA,MAAM,mBAAmB,uBAAuB,UAAU,IACtD,CAAC,WAAW,UAAU,GAAG,UAAU,IACnC,CAAC,YAAY,WAAW,UAAU,CAAC;CAEvC,KAAK,MAAM,OAAO,kBAChB,IAAI,OAAO,SACT,OAAO,QAAQ;AAKrB;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,OAAO,iBACd,cACA,QAAQ,IACV;CAKN,OAAO;AACT;AAmOA,SAAS,yBAWP,SAaA;CACA,MAAM,EAAE,SAAS,UAAU,CAAC,GAAc,WAAW,WAAW;CAChE,MAAM,sBAAsB,mBAAmB,SAAS;CACxD,MAAM,gBAAgB,2BAA2B,QAAQ,EAAE,KACzD,eAAe,mBAAmB,CACpC;CACA,MAAM,0BAKJ,kBAQG;EACH,MAAM,EACJ,MACA,OAAO,yBACP,GAAG,sBACD;EACJ,MAAM,yBACJ,eAQE;EACJ,MAAM,WAAW,WAAW,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,sBAAsB,EAC1B,GAAG,kBACL;EACA,MAAM,gBAGF;GACF,UAAU,cAAc;GACxB;GACA;EACF;EACA,MAAM,sBAAsB,cACxB,yBAAyB,aAAa,aAAa,IACnD;EACJ,MAAM,wBAAwB,EAAE,GAAG,gBAAgB;EAEnD,KAAK,MAAM,EACT,OAAO,2BACJ,+BAA+B,mBAAmB,GACrD,OAAO,OAAO,uBAAuB,qBAAqB;EAG5D,MAAM,wBAAwB,6BAC5B,qBACA,iBACF;EACA,MAAM,sBAAsB;GAC1B,aAAa;GACb,UAAU,cAAc;GACxB,MAAM,cAAc;GACpB,SAAS;EACX;EAEA,SAAS,UAAU,OAAwC;GACzD,MAAM,iBAAiB,cAAc,qBAAqB,KAAK;GAC/D,MAAM,mBAAmB,OAAO,KAAK,sBAAsB,CAAC,CAAC;GAC7D,MAAM,0BAA0B,KAC9B,uBACA,gBACF;GACA,MAAM,qBAAqB,EACzB,GAAG,4BAA4B,uBAAuB,EACxD;GAEA,KAAK,MAAM,OAAO,kBAAkB;IAClC,MAAM,aAAa,sBAAsB;IACzC,MAAM,oBAAoB,sBACxB,KACA,YACA,iBACF;IACA,MAAM,aAAa,OAAO,eAAe,aAAa,OAAO;IAC7D,MAAM,QAAQ,qBAAqB;IAEnC,IAAI,UAAU,QACZ,mBAAmB,OAAO;GAE9B;GAEA,MAAM,kCAAkC,OAAO,YAC7C,OAAO,QAAQ,uBAAuB,EAAE,QACrC,CAAC,SAAS,qBAAqB,SAAS,IAC3C,CACF;GACA,MAAM,kCAAkC,OAAO,YAC7C,OAAO,QAAQ,uBAAuB,EAAE,QACrC,CAAC,SACA,qBAAqB,SAAS,cAC9B,mBAAmB,SAAS,MAChC,CACF;GACA,MAAM,yBAAyB,cAC7B;IACE,GAAG;IACH,GAAG;GACL,GACA,kBACF;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,oBAAC,gCAAD;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;GACP,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,MAAM,WAAW,OAAO,EAAE,QAAQ,aAAa;EACjD,CAAC,IACD,OAGN;EACA,MAAM,sBAAsB,OAAO,cAC/B,yBAAyB,OAAO,aAAa;GAC3C;GACA,MAAM;GACN;EACF,CAAC,IACD;EAEJ,KAAK,MAAM,EACT,OAAO,2BACJ,+BAA+B,mBAAmB,GACrD,OAAO,OAAO,iBAAiB,qBAAqB;EAGtD,OAAO;GACL,GAAG;GACH,GAAG,OAAO,OAAO;EACnB;CACF;CAEA,MAAM,EAAE,gCAAgC,gBAAgB,kBAMtD;EACA,sBAAsB;EACtB;CACF,CAAC;CAgBD,MAAM,6BAgBF;EACF;EACA,cAjCmB,mBAMnB;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,qBAL0B,sBAAsB,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"}