@jfdevelops/react-layout 0.17.2 → 0.17.3

package/dist/create-config/for-resources/create-for-resources.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"create-for-resources.cjs","names":["capitalize","reservedScopedComponentNames","isRenderableComponentType","resolveScopedRenderResult","withScopedCompoundStatics"],"sources":["../../../src/create-config/for-resources/create-for-resources.ts"],"sourcesContent":["import {\n  createContext,\n  createElement,\n  type ComponentType,\n  type JSX,\n  useContext,\n} from 'react';\nimport type { ComposableComponents } from '@jfdevelops/react-layout-composables';\nimport {\n  type AnyBuiltPropDefinition,\n  validateProps,\n} from '@jfdevelops/react-layout-validator';\nimport type { InPropsDefinition, InPropsObject } from '../../props';\nimport type { LayoutResourceKey, ResourceDefinition } from '../../resource';\nimport { capitalize } from '../../utils/capitalize';\nimport type { LayoutIncludeProps } from '../define-layout';\nimport type {\n  CapitalizedResource,\n  ResourcesLayoutName,\n} from './resource-selection';\nimport type { CreateResourceLayoutForResourcesFn } from './scoped-layout';\nimport {\n  isRenderableComponentType,\n  reservedScopedComponentNames,\n  resolveScopedRenderResult,\n  type ScopedRenderResult,\n  withScopedCompoundStatics,\n} from './scoped-render';\n\ntype CreateForResourcesOptions<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = {\n  createLayoutForResource: (\n    defaultName: string | undefined,\n    resource: LayoutResourceKey<Resources>,\n  ) => unknown;\n  createMakeComposableLayout?: () => (\n    options: Record<string, unknown>,\n  ) => unknown;\n  createResourceLayout: (options: Record<string, unknown>) => unknown;\n  getComponentPropDefinitions: (\n    resource: LayoutResourceKey<Resources>,\n  ) => Record<string, AnyBuiltPropDefinition>;\n};\n\nexport function createForResources<\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  createLayoutForResource,\n  createMakeComposableLayout,\n  createResourceLayout,\n  getComponentPropDefinitions,\n}: CreateForResourcesOptions<Resources>) {\n  return ((...resourcesOrOptions: Array<unknown>) => {\n    const firstArgument = resourcesOrOptions[0];\n    let resourceOptions: Array<{\n      resource: LayoutResourceKey<Resources>;\n      name?:\n        | string\n        | ((\n            resource: CapitalizedResource<LayoutResourceKey<Resources>>,\n          ) => string);\n    }>;\n\n    if (typeof firstArgument === 'string') {\n      resourceOptions = resourcesOrOptions.map((resource) => ({\n        resource: resource as LayoutResourceKey<Resources>,\n      }));\n    } else if (\n      firstArgument !== null &&\n      typeof firstArgument === 'object' &&\n      'resources' in firstArgument &&\n      Array.isArray(firstArgument.resources)\n    ) {\n      const { name, resources } = firstArgument as {\n        name?: ResourcesLayoutName<LayoutResourceKey<Resources>>;\n        resources: Array<LayoutResourceKey<Resources>>;\n      };\n      resourceOptions = resources.map((resource) => ({\n        name: typeof name === 'function' ? name : name?.[resource],\n        resource,\n      }));\n    } else {\n      resourceOptions = Object.entries(firstArgument ?? {}).map(\n        ([resource, options]) => ({\n          ...(options as {\n            name?:\n              | string\n              | ((\n                  resource: CapitalizedResource<LayoutResourceKey<Resources>>,\n                ) => string);\n          }),\n          resource: resource as LayoutResourceKey<Resources>,\n        }),\n      );\n    }\n\n    const defaultNames = new Map(\n      resourceOptions.map(({ name, resource }) => [\n        resource,\n        typeof name === 'function'\n          ? name(\n              capitalize(resource) as CapitalizedResource<\n                LayoutResourceKey<Resources>\n              >,\n            )\n          : name,\n      ]),\n    );\n\n    function scopedCreateResourceLayout(options: Record<string, unknown>) {\n      const resource = options.resource as LayoutResourceKey<Resources>;\n\n      return createResourceLayout({\n        ...options,\n        name: options.name ?? defaultNames.get(resource),\n      });\n    }\n\n    function scopedForResource(options: {\n      name?: string;\n      resource: LayoutResourceKey<Resources>;\n    }) {\n      return createLayoutForResource(\n        options.name ?? defaultNames.get(options.resource),\n        options.resource,\n      );\n    }\n\n    type ScopedComponentRenderFn = (\n      props: Record<string, unknown>,\n      components: Record<string, (props?: never) => JSX.Element>,\n    ) => ScopedRenderResult;\n\n    type ScopedResourceScopedComponentDefinition = {\n      props?: Record<string, AnyBuiltPropDefinition>;\n      render: ScopedComponentRenderFn;\n    };\n\n    type ScopedComponentEntry = {\n      [option: string]: unknown;\n      name?: string;\n      components?: Record<string, ScopedResourceScopedComponentDefinition>;\n      render: ScopedComponentRenderFn;\n    };\n\n    function createComponent(componentOptions: {\n      props?: {\n        include?: Record<string, true | 'optional'>;\n        custom?: Record<string, AnyBuiltPropDefinition>;\n      };\n      resources?: Record<string, ScopedComponentEntry>;\n      render: (\n        props: Record<string, unknown>,\n        context: Record<string, (props: never) => JSX.Element>,\n      ) => ScopedRenderResult;\n    }) {\n      const include = componentOptions.props?.include ?? {};\n      const custom = componentOptions.props?.custom ?? {};\n      const selectedResources = new Set(\n        resourceOptions.map(({ resource }) => resource),\n      );\n      const componentPropsContext = createContext<\n        Record<string, unknown> | undefined\n      >(undefined);\n      const definedEntries = new Map<\n        LayoutResourceKey<Resources>,\n        ScopedComponentEntry\n      >();\n\n      for (const [key, entry] of Object.entries(\n        componentOptions.resources ?? {},\n      )) {\n        const resource = key as LayoutResourceKey<Resources>;\n\n        if (!selectedResources.has(resource)) {\n          throw new Error(\n            `Resource \"${key}\" is not available in this scoped component`,\n          );\n        }\n\n        definedEntries.set(resource, entry);\n      }\n\n      /** Resolved scoped components, per resource. */\n      const resourceScopedComponents = new Map<\n        LayoutResourceKey<Resources>,\n        Record<string, (props?: never) => JSX.Element>\n      >();\n      const contextResources = new Map<string, LayoutResourceKey<Resources>>();\n      const renderContext: Record<string, (props: never) => JSX.Element> =\n        Object.fromEntries(\n          [...definedEntries].map(([resource, entry]) => {\n            const contextKey = capitalize(resource);\n\n            if (contextKey === 'Root') {\n              throw new Error(\n                `Resource \"${resource}\" maps to the reserved render context key \"Root\"`,\n              );\n            }\n\n            const existingResource = contextResources.get(contextKey);\n\n            if (existingResource !== undefined) {\n              throw new Error(\n                `Resources \"${existingResource}\" and \"${resource}\" both map to render context key \"${contextKey}\"`,\n              );\n            }\n\n            contextResources.set(contextKey, resource);\n\n            /**\n             * Built once per resource so every scoped component keeps a stable\n             * identity, and shared by the resource render, the render context,\n             * and any component bound through `asHOF()`.\n             */\n            const scopedComponents: Record<\n              string,\n              (props?: never) => JSX.Element\n            > = {};\n\n            for (const [name, definition] of Object.entries(\n              entry.components ?? {},\n            )) {\n              if (reservedScopedComponentNames.has(name)) {\n                throw new Error(\n                  `Scoped component \"${name}\" for resource \"${resource}\" uses a reserved name`,\n                );\n              }\n\n              const ownPropDefinitions = definition.props ?? {};\n              // Last call-site own-props / returned component for this scoped\n              // entry. Compound statics re-run `render` with these so\n              // `<DataTable variant=\"b\" />` then `<DataTable.Loading />` sees \"b\".\n              let cachedOwnProps: Record<string, unknown> = {};\n              let cachedReturnedComponent:\n                | ComponentType<Record<string, unknown>>\n                | undefined;\n\n              function ScopedComponent(ownProps?: Record<string, unknown>) {\n                const componentProps = useContext(componentPropsContext);\n\n                if (componentProps === undefined) {\n                  throw new Error(\n                    `Scoped component \"${name}\" must be rendered inside its scoped component`,\n                  );\n                }\n\n                const resolvedOwnProps = ownProps ?? {};\n                cachedOwnProps = resolvedOwnProps;\n\n                validateProps(ownPropDefinitions, resolvedOwnProps, {\n                  layoutName:\n                    entry.name ??\n                    defaultNames.get(resource) ??\n                    capitalize(resource),\n                  resource,\n                });\n\n                // Mount a returned component type with call-site props; pass\n                // nodes (elements, portals, null) through unchanged.\n                const result = definition.render(\n                  { ...componentProps, ...resolvedOwnProps, resource },\n                  scopedComponents,\n                );\n\n                if (isRenderableComponentType(result)) {\n                  cachedReturnedComponent = result as ComponentType<\n                    Record<string, unknown>\n                  >;\n                }\n\n                return resolveScopedRenderResult(result, resolvedOwnProps);\n              }\n\n              // Types expose compound statics from the returned component\n              // (`DataTable.Loading`); attach matching runtime wrappers.\n              scopedComponents[name] = withScopedCompoundStatics(\n                ScopedComponent,\n                (staticName) => {\n                  function CompoundStatic(ownProps?: Record<string, unknown>) {\n                    const componentProps = useContext(componentPropsContext);\n\n                    if (componentProps === undefined) {\n                      throw new Error(\n                        `Scoped component \"${name}.${staticName}\" must be rendered inside its scoped component`,\n                      );\n                    }\n\n                    // Prefer the component from the last parent call (same\n                    // closure as that call's own-props). Fall back to re-running\n                    // render with cached parent props when needed.\n                    let result: unknown = cachedReturnedComponent;\n\n                    if (!isRenderableComponentType(result)) {\n                      result = definition.render(\n                        {\n                          ...componentProps,\n                          ...cachedOwnProps,\n                          resource,\n                        },\n                        scopedComponents,\n                      );\n                    }\n\n                    if (!isRenderableComponentType(result)) {\n                      throw new Error(\n                        `Scoped component \"${name}\" must return a component type to use static \"${staticName}\"`,\n                      );\n                    }\n\n                    const staticComponent = (\n                      result as ComponentType<Record<string, unknown>> &\n                        Record<string, unknown>\n                    )[staticName];\n\n                    if (!isRenderableComponentType(staticComponent)) {\n                      throw new Error(\n                        `Scoped component \"${name}\" has no component static \"${staticName}\"`,\n                      );\n                    }\n\n                    // Loading's props — those mount the static itself.\n                    return createElement(staticComponent, ownProps ?? {});\n                  }\n\n                  CompoundStatic.displayName = `${name}.${staticName}`;\n                  return CompoundStatic;\n                },\n              ) as (props?: never) => JSX.Element;\n            }\n\n            resourceScopedComponents.set(resource, scopedComponents);\n\n            function ResourceRender(ownProps?: Record<string, unknown>) {\n              const componentProps = useContext(componentPropsContext);\n\n              if (componentProps === undefined) {\n                throw new Error(\n                  `Render context component \"${contextKey}\" must be rendered inside its scoped component`,\n                );\n              }\n\n              // Call-site props on `context.Users({ title, heading })` merge into\n              // the resource render props and mount a returned component type.\n              const callProps = { ...componentProps, ...ownProps, resource };\n              return resolveScopedRenderResult(\n                entry.render(callProps, scopedComponents),\n                ownProps,\n              );\n            }\n\n            return [\n              contextKey,\n              Object.assign(ResourceRender, scopedComponents),\n            ];\n          }),\n        );\n\n      /**\n       * Layouts are created once per resource and cached. Creating one during\n       * render would hand React a new component type on every pass, remounting\n       * the whole subtree.\n       */\n      const roots = new Map<\n        LayoutResourceKey<Resources>,\n        (props: Record<string, unknown>) => JSX.Element\n      >();\n\n      function Root(rootProps: Record<string, unknown>) {\n        const componentProps = useContext(componentPropsContext);\n\n        if (componentProps === undefined) {\n          throw new Error(\n            'Render context component \"Root\" must be rendered inside its scoped component',\n          );\n        }\n\n        const resource =\n          componentProps.resource as LayoutResourceKey<Resources>;\n        let root = roots.get(resource);\n\n        if (root === undefined) {\n          const entry = definedEntries.get(resource);\n\n          if (entry === undefined) {\n            throw new Error(\n              `Render context component \"Root\" requires a \"resources.${resource}\" entry to build the layout for resource \"${resource}\"`,\n            );\n          }\n\n          // Layout option values come from the outer component call site\n          // (`<Directory title=\"…\" />`), not from the resource entry.\n          const availableDefinitions =\n            getComponentPropDefinitions(resource);\n          const layoutOptions: Record<string, unknown> = {};\n\n          for (const key of Object.keys(availableDefinitions)) {\n            if (key in componentProps) {\n              layoutOptions[key] = componentProps[key];\n            }\n\n            const capitalized = capitalize(key);\n            if (capitalized in componentProps) {\n              layoutOptions[capitalized] = componentProps[capitalized];\n            }\n          }\n\n          root = scopedCreateResourceLayout({\n            ...layoutOptions,\n            name:\n              entry.name ??\n              defaultNames.get(resource) ??\n              capitalize(resource),\n            resource,\n          }) as (props: Record<string, unknown>) => JSX.Element;\n          roots.set(resource, root);\n        }\n\n        return createElement(root, rootProps);\n      }\n\n      renderContext.Root = Root;\n\n      function Component(componentProps: Record<string, unknown>) {\n        const componentResource =\n          componentProps.resource as LayoutResourceKey<Resources>;\n\n        if (!selectedResources.has(componentResource)) {\n          throw new Error(\n            `Resource \"${componentResource}\" is not available in this scoped component`,\n          );\n        }\n\n        const availableDefinitions =\n          getComponentPropDefinitions(componentResource);\n        const definitionsToValidate: Record<string, AnyBuiltPropDefinition> =\n          {};\n\n        for (const [key, inclusion] of Object.entries(include)) {\n          const definition = availableDefinitions[key];\n\n          if (!definition) {\n            continue;\n          }\n\n          // Keep declared keys as-is — do not capitalize JSX.Element props.\n          if (inclusion === true || key in componentProps) {\n            definitionsToValidate[key] = definition;\n          }\n        }\n\n        for (const [key, definition] of Object.entries(custom)) {\n          if (key === 'children' || key === 'resource') {\n            continue;\n          }\n\n          definitionsToValidate[key] = definition;\n        }\n\n        validateProps(definitionsToValidate, componentProps, {\n          layoutName:\n            definedEntries.get(componentResource)?.name ??\n            defaultNames.get(componentResource) ??\n            capitalize(componentResource),\n          resource: componentResource,\n        });\n\n        // Top-level render may return a component type; mount it with the full\n        // component props (include/custom + inferred return-type props).\n        return createElement(\n          componentPropsContext.Provider,\n          { value: componentProps },\n          resolveScopedRenderResult(\n            componentOptions.render(componentProps, renderContext),\n            componentProps,\n          ),\n        );\n      }\n\n      /**\n       * Bound components are created once per resource and cached. Returning a\n       * fresh component from the factory would hand React a new component type\n       * whenever the caller rebinds, remounting the subtree.\n       */\n      const boundComponents = new Map<\n        LayoutResourceKey<Resources>,\n        (props: Record<string, unknown>) => JSX.Element\n      >();\n\n      function bindResource(resource: LayoutResourceKey<Resources>) {\n        if (!selectedResources.has(resource)) {\n          throw new Error(\n            `Resource \"${resource}\" is not available in this scoped component`,\n          );\n        }\n\n        let boundComponent = boundComponents.get(resource);\n\n        if (boundComponent === undefined) {\n          boundComponent = Object.assign(\n            (boundProps: Record<string, unknown>) =>\n              createElement(Component, { ...boundProps, resource }),\n            {\n              displayName: `ScopedResourceComponent(${resource})`,\n              props: undefined,\n              resource: undefined,\n            },\n            resourceScopedComponents.get(resource) ?? {},\n          );\n          boundComponents.set(resource, boundComponent);\n        }\n\n        return boundComponent;\n      }\n\n      function asHOF() {\n        return bindResource;\n      }\n\n      return Object.assign(Component, {\n        asHOF,\n        displayName: 'ScopedResourceComponent',\n        props: undefined,\n      });\n    }\n\n    type CreateComponentPropsBag = {\n      include?: Record<string, true | 'optional'>;\n      custom?: Record<string, AnyBuiltPropDefinition>;\n    };\n\n    const createResourceComponentExtras = new WeakMap<\n      object,\n      CreateComponentPropsBag\n    >();\n\n    function mergeCreateComponentProps(\n      ...bags: Array<CreateComponentPropsBag | undefined>\n    ): CreateComponentPropsBag {\n      const include: Record<string, true | 'optional'> = {};\n      const custom: Record<string, AnyBuiltPropDefinition> = {};\n\n      for (const bag of bags) {\n        Object.assign(include, bag?.include);\n        Object.assign(custom, bag?.custom);\n      }\n\n      return { include, custom };\n    }\n\n    function createComponentSetProps(baseProps: CreateComponentPropsBag) {\n      function createWithProps(componentOptions: {\n        props?: CreateComponentPropsBag;\n        resources?: Record<string, ScopedComponentEntry>;\n        render: (\n          props: Record<string, unknown>,\n          context: Record<string, (props: never) => JSX.Element>,\n        ) => ScopedRenderResult;\n      }) {\n        const fromEntries = mergeCreateComponentProps(\n          ...Object.values(componentOptions.resources ?? {}).map(\n            (entry) => createResourceComponentExtras.get(entry),\n          ),\n        );\n\n        return createComponent({\n          ...componentOptions,\n          props: mergeCreateComponentProps(\n            baseProps,\n            fromEntries,\n            componentOptions.props,\n          ),\n        });\n      }\n\n      createWithProps.createResourceComponents = (options: {\n        resource: LayoutResourceKey<Resources>;\n        props?: CreateComponentPropsBag;\n        name?: string;\n        components?: Record<string, ScopedResourceScopedComponentDefinition>;\n        render: ScopedComponentRenderFn;\n      }) => {\n        const { resource, props, ...entry } = options;\n\n        if (\n          !resourceOptions.some(\n            (resourceOption) => resourceOption.resource === resource,\n          )\n        ) {\n          throw new Error(\n            `Resource \"${resource}\" is not available in this scoped component`,\n          );\n        }\n\n        if (props !== undefined) {\n          createResourceComponentExtras.set(entry, props);\n        }\n\n        return entry;\n      };\n\n      return createWithProps;\n    }\n\n    Object.assign(createComponent, {\n      setProps: createComponentSetProps,\n    });\n\n    const scopedExtras: {\n      createComponent: typeof createComponent;\n      forResource: typeof scopedForResource;\n      makeComposable?: (options: Record<string, unknown>) => unknown;\n      resources: undefined;\n    } = {\n      createComponent,\n      forResource: scopedForResource,\n      resources: undefined,\n    };\n\n    if (createMakeComposableLayout) {\n      const makeComposableLayout = createMakeComposableLayout();\n\n      scopedExtras.makeComposable = (options) => {\n        const resource = options.resource as LayoutResourceKey<Resources>;\n\n        return makeComposableLayout({\n          ...options,\n          name: options.name ?? defaultNames.get(resource),\n        });\n      };\n    }\n\n    return Object.assign(scopedCreateResourceLayout, scopedExtras);\n  }) as unknown as CreateResourceLayoutForResourcesFn<\n    Resources,\n    InProps,\n    Composables,\n    IncludeProps,\n    CustomProps\n  >;\n}\n"],"mappings":"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"}
+{"version":3,"file":"create-for-resources.cjs","names":["capitalize","reservedScopedComponentNames","isRenderableComponentType","resolveScopedRenderResult","withScopedCompoundStatics"],"sources":["../../../src/create-config/for-resources/create-for-resources.ts"],"sourcesContent":["import {\n  createContext,\n  createElement,\n  type ComponentType,\n  type JSX,\n  useContext,\n} from 'react';\nimport type { ComposableComponents } from '@jfdevelops/react-layout-composables';\nimport {\n  type AnyBuiltPropDefinition,\n  validateProps,\n} from '@jfdevelops/react-layout-validator';\nimport type { InPropsDefinition, InPropsObject } from '../../props';\nimport type { LayoutResourceKey, ResourceDefinition } from '../../resource';\nimport { capitalize } from '../../utils/capitalize';\nimport type { LayoutIncludeProps } from '../define-layout';\nimport type {\n  CapitalizedResource,\n  ResourcesLayoutName,\n} from './resource-selection';\nimport type { CreateResourceLayoutForResourcesFn } from './scoped-layout';\nimport {\n  isRenderableComponentType,\n  reservedScopedComponentNames,\n  resolveScopedRenderResult,\n  type ScopedRenderResult,\n  withScopedCompoundStatics,\n} from './scoped-render';\n\ntype CreateForResourcesOptions<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = {\n  createLayoutForResource: (\n    defaultName: string | undefined,\n    resource: LayoutResourceKey<Resources>,\n  ) => unknown;\n  createMakeComposableLayout?: () => (\n    options: Record<string, unknown>,\n  ) => unknown;\n  createResourceLayout: (options: Record<string, unknown>) => unknown;\n  getComponentPropDefinitions: (\n    resource: LayoutResourceKey<Resources>,\n  ) => Record<string, AnyBuiltPropDefinition>;\n};\n\nexport function createForResources<\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  createLayoutForResource,\n  createMakeComposableLayout,\n  createResourceLayout,\n  getComponentPropDefinitions,\n}: CreateForResourcesOptions<Resources>) {\n  return ((...resourcesOrOptions: Array<unknown>) => {\n    const firstArgument = resourcesOrOptions[0];\n    let resourceOptions: Array<{\n      resource: LayoutResourceKey<Resources>;\n      name?:\n        | string\n        | ((\n            resource: CapitalizedResource<LayoutResourceKey<Resources>>,\n          ) => string);\n    }>;\n\n    if (typeof firstArgument === 'string') {\n      resourceOptions = resourcesOrOptions.map((resource) => ({\n        resource: resource as LayoutResourceKey<Resources>,\n      }));\n    } else if (\n      firstArgument !== null &&\n      typeof firstArgument === 'object' &&\n      'resources' in firstArgument &&\n      Array.isArray(firstArgument.resources)\n    ) {\n      const { name, resources } = firstArgument as {\n        name?: ResourcesLayoutName<LayoutResourceKey<Resources>>;\n        resources: Array<LayoutResourceKey<Resources>>;\n      };\n      resourceOptions = resources.map((resource) => ({\n        name: typeof name === 'function' ? name : name?.[resource],\n        resource,\n      }));\n    } else {\n      resourceOptions = Object.entries(firstArgument ?? {}).map(\n        ([resource, options]) => ({\n          ...(options as {\n            name?:\n              | string\n              | ((\n                  resource: CapitalizedResource<LayoutResourceKey<Resources>>,\n                ) => string);\n          }),\n          resource: resource as LayoutResourceKey<Resources>,\n        }),\n      );\n    }\n\n    const defaultNames = new Map(\n      resourceOptions.map(({ name, resource }) => [\n        resource,\n        typeof name === 'function'\n          ? name(\n              capitalize(resource) as CapitalizedResource<\n                LayoutResourceKey<Resources>\n              >,\n            )\n          : name,\n      ]),\n    );\n\n    function scopedCreateResourceLayout(options: Record<string, unknown>) {\n      const resource = options.resource as LayoutResourceKey<Resources>;\n\n      return createResourceLayout({\n        ...options,\n        name: options.name ?? defaultNames.get(resource),\n      });\n    }\n\n    function scopedForResource(options: {\n      name?: string;\n      resource: LayoutResourceKey<Resources>;\n    }) {\n      return createLayoutForResource(\n        options.name ?? defaultNames.get(options.resource),\n        options.resource,\n      );\n    }\n\n    type ScopedComponentRenderFn = (\n      props: Record<string, unknown>,\n      components: Record<string, (props?: never) => JSX.Element>,\n    ) => ScopedRenderResult;\n\n    type ScopedResourceScopedComponentDefinition = {\n      props?: Record<string, AnyBuiltPropDefinition>;\n      render: ScopedComponentRenderFn;\n    };\n\n    type ScopedComponentEntry = {\n      [option: string]: unknown;\n      name?: string;\n      props?: CreateComponentPropsBag;\n      components?: Record<string, ScopedResourceScopedComponentDefinition>;\n      render: ScopedComponentRenderFn;\n    };\n\n    type CreateComponentPropsBag = {\n      include?: Record<string, true | 'optional'>;\n      custom?: Record<string, AnyBuiltPropDefinition>;\n      defined?: Record<string, unknown>;\n    };\n\n    function mergeCreateComponentProps(\n      ...bags: Array<CreateComponentPropsBag | undefined>\n    ): CreateComponentPropsBag {\n      const include: Record<string, true | 'optional'> = {};\n      const custom: Record<string, AnyBuiltPropDefinition> = {};\n\n      for (const bag of bags) {\n        Object.assign(include, bag?.include);\n        Object.assign(custom, bag?.custom);\n\n        for (const key of Object.keys(bag?.defined ?? {})) {\n          include[key] = true;\n        }\n      }\n\n      return { include, custom };\n    }\n\n    function createComponent(componentOptions: {\n      props?: {\n        include?: Record<string, true | 'optional'>;\n        custom?: Record<string, AnyBuiltPropDefinition>;\n      };\n      resources?: Record<string, ScopedComponentEntry>;\n      render: (\n        props: Record<string, unknown>,\n        context: Record<string, (props: never) => JSX.Element>,\n      ) => ScopedRenderResult;\n    }) {\n      const mergedProps = mergeCreateComponentProps(\n        componentOptions.props,\n        ...Object.values(componentOptions.resources ?? {}).map(\n          (entry) => entry.props,\n        ),\n      );\n      const include = mergedProps.include ?? {};\n      const custom = mergedProps.custom ?? {};\n      const selectedResources = new Set(\n        resourceOptions.map(({ resource }) => resource),\n      );\n      const componentPropsContext = createContext<\n        Record<string, unknown> | undefined\n      >(undefined);\n      const definedEntries = new Map<\n        LayoutResourceKey<Resources>,\n        ScopedComponentEntry\n      >();\n\n      for (const [key, entry] of Object.entries(\n        componentOptions.resources ?? {},\n      )) {\n        const resource = key as LayoutResourceKey<Resources>;\n\n        if (!selectedResources.has(resource)) {\n          throw new Error(\n            `Resource \"${key}\" is not available in this scoped component`,\n          );\n        }\n\n        definedEntries.set(resource, entry);\n      }\n\n      /** Resolved scoped components, per resource. */\n      const resourceScopedComponents = new Map<\n        LayoutResourceKey<Resources>,\n        Record<string, (props?: never) => JSX.Element>\n      >();\n      const contextResources = new Map<string, LayoutResourceKey<Resources>>();\n      const renderContext: Record<string, (props: never) => JSX.Element> =\n        Object.fromEntries(\n          [...definedEntries].map(([resource, entry]) => {\n            const contextKey = capitalize(resource);\n\n            if (contextKey === 'Root') {\n              throw new Error(\n                `Resource \"${resource}\" maps to the reserved render context key \"Root\"`,\n              );\n            }\n\n            const existingResource = contextResources.get(contextKey);\n\n            if (existingResource !== undefined) {\n              throw new Error(\n                `Resources \"${existingResource}\" and \"${resource}\" both map to render context key \"${contextKey}\"`,\n              );\n            }\n\n            contextResources.set(contextKey, resource);\n\n            /**\n             * Built once per resource so every scoped component keeps a stable\n             * identity, and shared by the resource render, the render context,\n             * and any component bound through `asHOF()`.\n             */\n            const scopedComponents: Record<\n              string,\n              (props?: never) => JSX.Element\n            > = {};\n\n            for (const [name, definition] of Object.entries(\n              entry.components ?? {},\n            )) {\n              if (reservedScopedComponentNames.has(name)) {\n                throw new Error(\n                  `Scoped component \"${name}\" for resource \"${resource}\" uses a reserved name`,\n                );\n              }\n\n              const ownPropDefinitions = definition.props ?? {};\n              // Last call-site own-props / returned component for this scoped\n              // entry. Compound statics re-run `render` with these so\n              // `<DataTable variant=\"b\" />` then `<DataTable.Loading />` sees \"b\".\n              let cachedOwnProps: Record<string, unknown> = {};\n              let cachedReturnedComponent:\n                | ComponentType<Record<string, unknown>>\n                | undefined;\n\n              function ScopedComponent(ownProps?: Record<string, unknown>) {\n                const componentProps = useContext(componentPropsContext);\n\n                if (componentProps === undefined) {\n                  throw new Error(\n                    `Scoped component \"${name}\" must be rendered inside its scoped component`,\n                  );\n                }\n\n                const resolvedOwnProps = ownProps ?? {};\n                cachedOwnProps = resolvedOwnProps;\n\n                validateProps(ownPropDefinitions, resolvedOwnProps, {\n                  layoutName:\n                    entry.name ??\n                    defaultNames.get(resource) ??\n                    capitalize(resource),\n                  resource,\n                });\n\n                // Mount a returned component type with call-site props; pass\n                // nodes (elements, portals, null) through unchanged.\n                const result = definition.render(\n                  { ...componentProps, ...resolvedOwnProps, resource },\n                  scopedComponents,\n                );\n\n                if (isRenderableComponentType(result)) {\n                  cachedReturnedComponent = result as ComponentType<\n                    Record<string, unknown>\n                  >;\n                }\n\n                return resolveScopedRenderResult(result, resolvedOwnProps);\n              }\n\n              // Types expose compound statics from the returned component\n              // (`DataTable.Loading`); attach matching runtime wrappers.\n              scopedComponents[name] = withScopedCompoundStatics(\n                ScopedComponent,\n                (staticName) => {\n                  function CompoundStatic(ownProps?: Record<string, unknown>) {\n                    const componentProps = useContext(componentPropsContext);\n\n                    if (componentProps === undefined) {\n                      throw new Error(\n                        `Scoped component \"${name}.${staticName}\" must be rendered inside its scoped component`,\n                      );\n                    }\n\n                    // Prefer the component from the last parent call (same\n                    // closure as that call's own-props). Fall back to re-running\n                    // render with cached parent props when needed.\n                    let result: unknown = cachedReturnedComponent;\n\n                    if (!isRenderableComponentType(result)) {\n                      result = definition.render(\n                        {\n                          ...componentProps,\n                          ...cachedOwnProps,\n                          resource,\n                        },\n                        scopedComponents,\n                      );\n                    }\n\n                    if (!isRenderableComponentType(result)) {\n                      throw new Error(\n                        `Scoped component \"${name}\" must return a component type to use static \"${staticName}\"`,\n                      );\n                    }\n\n                    const staticComponent = (\n                      result as ComponentType<Record<string, unknown>> &\n                        Record<string, unknown>\n                    )[staticName];\n\n                    if (!isRenderableComponentType(staticComponent)) {\n                      throw new Error(\n                        `Scoped component \"${name}\" has no component static \"${staticName}\"`,\n                      );\n                    }\n\n                    // Loading's props — those mount the static itself.\n                    return createElement(staticComponent, ownProps ?? {});\n                  }\n\n                  CompoundStatic.displayName = `${name}.${staticName}`;\n                  return CompoundStatic;\n                },\n              ) as (props?: never) => JSX.Element;\n            }\n\n            resourceScopedComponents.set(resource, scopedComponents);\n\n            function ResourceRender(ownProps?: Record<string, unknown>) {\n              const componentProps = useContext(componentPropsContext);\n\n              if (componentProps === undefined) {\n                throw new Error(\n                  `Render context component \"${contextKey}\" must be rendered inside its scoped component`,\n                );\n              }\n\n              // Call-site props on `context.Users({ title, heading })` merge into\n              // the resource render props and mount a returned component type.\n              const callProps = { ...componentProps, ...ownProps, resource };\n              return resolveScopedRenderResult(\n                entry.render(callProps, scopedComponents),\n                ownProps,\n              );\n            }\n\n            return [\n              contextKey,\n              Object.assign(ResourceRender, scopedComponents),\n            ];\n          }),\n        );\n\n      /**\n       * Layouts are created once per resource and cached. Creating one during\n       * render would hand React a new component type on every pass, remounting\n       * the whole subtree.\n       */\n      const roots = new Map<\n        LayoutResourceKey<Resources>,\n        (props: Record<string, unknown>) => JSX.Element\n      >();\n\n      function Root(rootProps: Record<string, unknown>) {\n        const componentProps = useContext(componentPropsContext);\n\n        if (componentProps === undefined) {\n          throw new Error(\n            'Render context component \"Root\" must be rendered inside its scoped component',\n          );\n        }\n\n        const resource =\n          componentProps.resource as LayoutResourceKey<Resources>;\n        let root = roots.get(resource);\n\n        if (root === undefined) {\n          const entry = definedEntries.get(resource);\n\n          if (entry === undefined) {\n            throw new Error(\n              `Render context component \"Root\" requires a \"resources.${resource}\" entry to build the layout for resource \"${resource}\"`,\n            );\n          }\n\n          // Layout option values come from the outer component call site\n          // (`<Directory title=\"…\" />`), not from the resource entry.\n          const availableDefinitions =\n            getComponentPropDefinitions(resource);\n          const layoutOptions: Record<string, unknown> = {};\n          const defined = entry.props?.defined ?? {};\n\n          for (const key of Object.keys(availableDefinitions)) {\n            if (key in defined) {\n              layoutOptions[key] = defined[key];\n            }\n\n            const capitalized = capitalize(key);\n            if (capitalized in defined) {\n              layoutOptions[capitalized] = defined[capitalized];\n            }\n\n            if (key in componentProps) {\n              layoutOptions[key] = componentProps[key];\n            }\n\n            if (capitalized in componentProps) {\n              layoutOptions[capitalized] = componentProps[capitalized];\n            }\n          }\n\n          root = scopedCreateResourceLayout({\n            ...layoutOptions,\n            name:\n              entry.name ??\n              defaultNames.get(resource) ??\n              capitalize(resource),\n            resource,\n          }) as (props: Record<string, unknown>) => JSX.Element;\n          roots.set(resource, root);\n        }\n\n        const entry = definedEntries.get(resource);\n        const definedCustom: Record<string, unknown> = {};\n\n        for (const [key, value] of Object.entries(\n          entry?.props?.defined ?? {},\n        )) {\n          if (key in custom) {\n            definedCustom[key] = value;\n          }\n        }\n\n        return createElement(root, { ...definedCustom, ...rootProps });\n      }\n\n      renderContext.Root = Root;\n\n      function Component(componentProps: Record<string, unknown>) {\n        const componentResource =\n          componentProps.resource as LayoutResourceKey<Resources>;\n\n        if (!selectedResources.has(componentResource)) {\n          throw new Error(\n            `Resource \"${componentResource}\" is not available in this scoped component`,\n          );\n        }\n\n        const defined =\n          definedEntries.get(componentResource)?.props?.defined ?? {};\n        const resolvedComponentProps = { ...defined, ...componentProps };\n        const availableDefinitions =\n          getComponentPropDefinitions(componentResource);\n        const definitionsToValidate: Record<string, AnyBuiltPropDefinition> =\n          {};\n\n        for (const [key, inclusion] of Object.entries(include)) {\n          const definition = availableDefinitions[key];\n\n          if (!definition) {\n            continue;\n          }\n\n          // Keep declared keys as-is — do not capitalize JSX.Element props.\n          if (inclusion === true || key in resolvedComponentProps) {\n            definitionsToValidate[key] = definition;\n          }\n        }\n\n        for (const [key, definition] of Object.entries(custom)) {\n          if (key === 'children' || key === 'resource') {\n            continue;\n          }\n\n          definitionsToValidate[key] = definition;\n        }\n\n        validateProps(definitionsToValidate, resolvedComponentProps, {\n          layoutName:\n            definedEntries.get(componentResource)?.name ??\n            defaultNames.get(componentResource) ??\n            capitalize(componentResource),\n          resource: componentResource,\n        });\n\n        // Top-level render may return a component type; mount it with the full\n        // component props (include/custom + inferred return-type props).\n        return createElement(\n          componentPropsContext.Provider,\n          { value: resolvedComponentProps },\n          resolveScopedRenderResult(\n            componentOptions.render(resolvedComponentProps, renderContext),\n            resolvedComponentProps,\n          ),\n        );\n      }\n\n      /**\n       * Bound components are created once per resource and cached. Returning a\n       * fresh component from the factory would hand React a new component type\n       * whenever the caller rebinds, remounting the subtree.\n       */\n      const boundComponents = new Map<\n        LayoutResourceKey<Resources>,\n        (props: Record<string, unknown>) => JSX.Element\n      >();\n\n      function bindResource(resource: LayoutResourceKey<Resources>) {\n        if (!selectedResources.has(resource)) {\n          throw new Error(\n            `Resource \"${resource}\" is not available in this scoped component`,\n          );\n        }\n\n        let boundComponent = boundComponents.get(resource);\n\n        if (boundComponent === undefined) {\n          boundComponent = Object.assign(\n            (boundProps: Record<string, unknown>) =>\n              createElement(Component, { ...boundProps, resource }),\n            {\n              displayName: `ScopedResourceComponent(${resource})`,\n              props: undefined,\n              resource: undefined,\n            },\n            resourceScopedComponents.get(resource) ?? {},\n          );\n          boundComponents.set(resource, boundComponent);\n        }\n\n        return boundComponent;\n      }\n\n      function asHOF() {\n        return bindResource;\n      }\n\n      return Object.assign(Component, {\n        asHOF,\n        displayName: 'ScopedResourceComponent',\n        props: undefined,\n      });\n    }\n\n    function createComponentSetProps(baseProps: CreateComponentPropsBag) {\n      function createWithProps(componentOptions: {\n        props?: CreateComponentPropsBag;\n        resources?: Record<string, ScopedComponentEntry>;\n        render: (\n          props: Record<string, unknown>,\n          context: Record<string, (props: never) => JSX.Element>,\n        ) => ScopedRenderResult;\n      }) {\n        return createComponent({\n          ...componentOptions,\n          props: mergeCreateComponentProps(baseProps, componentOptions.props),\n        });\n      }\n\n      createWithProps.createResourceComponents = createResourceComponents;\n\n      return createWithProps;\n    }\n\n    function createResourceComponents(options: {\n      resource: LayoutResourceKey<Resources>;\n      props?: CreateComponentPropsBag;\n      name?: string;\n      components?: Record<string, ScopedResourceScopedComponentDefinition>;\n      render: ScopedComponentRenderFn;\n    }) {\n      const { resource, props, ...entry } = options;\n\n      if (\n        !resourceOptions.some(\n          (resourceOption) => resourceOption.resource === resource,\n        )\n      ) {\n        throw new Error(\n          `Resource \"${resource}\" is not available in this scoped component`,\n        );\n      }\n\n      return { ...entry, props: props ?? {} };\n    }\n\n    Object.assign(createComponent, {\n      setProps: createComponentSetProps,\n    });\n\n    const scopedExtras: {\n      createComponent: typeof createComponent;\n      createResourceComponents: typeof createResourceComponents;\n      forResource: typeof scopedForResource;\n      makeComposable?: (options: Record<string, unknown>) => unknown;\n      resources: undefined;\n    } = {\n      createComponent,\n      createResourceComponents,\n      forResource: scopedForResource,\n      resources: undefined,\n    };\n\n    if (createMakeComposableLayout) {\n      const makeComposableLayout = createMakeComposableLayout();\n\n      scopedExtras.makeComposable = (options) => {\n        const resource = options.resource as LayoutResourceKey<Resources>;\n\n        return makeComposableLayout({\n          ...options,\n          name: options.name ?? defaultNames.get(resource),\n        });\n      };\n    }\n\n    return Object.assign(scopedCreateResourceLayout, scopedExtras);\n  }) as unknown as CreateResourceLayoutForResourcesFn<\n    Resources,\n    InProps,\n    Composables,\n    IncludeProps,\n    CustomProps\n  >;\n}\n"],"mappings":"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"}

package/dist/create-config/for-resources/create-for-resources.mjs

@@ -30,9 +30,23 @@ function createForResources({ createLayoutForResource, createMakeComposableLayou
 		function scopedForResource(options) {
 			return createLayoutForResource(options.name ?? defaultNames.get(options.resource), options.resource);
 		}
+		function mergeCreateComponentProps(...bags) {
+			const include = {};
+			const custom = {};
+			for (const bag of bags) {
+				Object.assign(include, bag?.include);
+				Object.assign(custom, bag?.custom);
+				for (const key of Object.keys(bag?.defined ?? {})) include[key] = true;
+			}
+			return {
+				include,
+				custom
+			};
+		}
 		function createComponent(componentOptions) {
-			const include = componentOptions.props?.include ?? {};
-			const custom = componentOptions.props?.custom ?? {};
+			const mergedProps = mergeCreateComponentProps(componentOptions.props, ...Object.values(componentOptions.resources ?? {}).map((entry) => entry.props));
+			const include = mergedProps.include ?? {};
+			const custom = mergedProps.custom ?? {};
 			const selectedResources = new Set(resourceOptions.map(({ resource }) => resource));
 			const componentPropsContext = createContext(void 0);
 			const definedEntries = /* @__PURE__ */ new Map();
@@ -126,9 +140,12 @@ function createForResources({ createLayoutForResource, createMakeComposableLayou
 					if (entry === void 0) throw new Error(`Render context component "Root" requires a "resources.${resource}" entry to build the layout for resource "${resource}"`);
 					const availableDefinitions = getComponentPropDefinitions(resource);
 					const layoutOptions = {};
+					const defined = entry.props?.defined ?? {};
 					for (const key of Object.keys(availableDefinitions)) {
-						if (key in componentProps) layoutOptions[key] = componentProps[key];
+						if (key in defined) layoutOptions[key] = defined[key];
 						const capitalized = capitalize(key);
+						if (capitalized in defined) layoutOptions[capitalized] = defined[capitalized];
+						if (key in componentProps) layoutOptions[key] = componentProps[key];
 						if (capitalized in componentProps) layoutOptions[capitalized] = componentProps[capitalized];
 					}
 					root = scopedCreateResourceLayout({
@@ -138,28 +155,38 @@ function createForResources({ createLayoutForResource, createMakeComposableLayou
 					});
 					roots.set(resource, root);
 				}
-				return createElement(root, rootProps);
+				const entry = definedEntries.get(resource);
+				const definedCustom = {};
+				for (const [key, value] of Object.entries(entry?.props?.defined ?? {})) if (key in custom) definedCustom[key] = value;
+				return createElement(root, {
+					...definedCustom,
+					...rootProps
+				});
 			}
 			renderContext.Root = Root;
 			function Component(componentProps) {
 				const componentResource = componentProps.resource;
 				if (!selectedResources.has(componentResource)) throw new Error(`Resource "${componentResource}" is not available in this scoped component`);
+				const resolvedComponentProps = {
+					...definedEntries.get(componentResource)?.props?.defined ?? {},
+					...componentProps
+				};
 				const availableDefinitions = getComponentPropDefinitions(componentResource);
 				const definitionsToValidate = {};
 				for (const [key, inclusion] of Object.entries(include)) {
 					const definition = availableDefinitions[key];
 					if (!definition) continue;
-					if (inclusion === true || key in componentProps) definitionsToValidate[key] = definition;
+					if (inclusion === true || key in resolvedComponentProps) definitionsToValidate[key] = definition;
 				}
 				for (const [key, definition] of Object.entries(custom)) {
 					if (key === "children" || key === "resource") continue;
 					definitionsToValidate[key] = definition;
 				}
-				validateProps(definitionsToValidate, componentProps, {
+				validateProps(definitionsToValidate, resolvedComponentProps, {
 					layoutName: definedEntries.get(componentResource)?.name ?? defaultNames.get(componentResource) ?? capitalize(componentResource),
 					resource: componentResource
 				});
-				return createElement(componentPropsContext.Provider, { value: componentProps }, resolveScopedRenderResult(componentOptions.render(componentProps, renderContext), componentProps));
+				return createElement(componentPropsContext.Provider, { value: resolvedComponentProps }, resolveScopedRenderResult(componentOptions.render(resolvedComponentProps, renderContext), resolvedComponentProps));
 			}
 			/**
 			* Bound components are created once per resource and cached. Returning a
@@ -192,38 +219,28 @@ function createForResources({ createLayoutForResource, createMakeComposableLayou
 				props: void 0
 			});
 		}
-		const createResourceComponentExtras = /* @__PURE__ */ new WeakMap();
-		function mergeCreateComponentProps(...bags) {
-			const include = {};
-			const custom = {};
-			for (const bag of bags) {
-				Object.assign(include, bag?.include);
-				Object.assign(custom, bag?.custom);
-			}
-			return {
-				include,
-				custom
-			};
-		}
 		function createComponentSetProps(baseProps) {
 			function createWithProps(componentOptions) {
-				const fromEntries = mergeCreateComponentProps(...Object.values(componentOptions.resources ?? {}).map((entry) => createResourceComponentExtras.get(entry)));
 				return createComponent({
 					...componentOptions,
-					props: mergeCreateComponentProps(baseProps, fromEntries, componentOptions.props)
+					props: mergeCreateComponentProps(baseProps, componentOptions.props)
 				});
 			}
-			createWithProps.createResourceComponents = (options) => {
-				const { resource, props, ...entry } = options;
-				if (!resourceOptions.some((resourceOption) => resourceOption.resource === resource)) throw new Error(`Resource "${resource}" is not available in this scoped component`);
-				if (props !== void 0) createResourceComponentExtras.set(entry, props);
-				return entry;
-			};
+			createWithProps.createResourceComponents = createResourceComponents;
 			return createWithProps;
 		}
+		function createResourceComponents(options) {
+			const { resource, props, ...entry } = options;
+			if (!resourceOptions.some((resourceOption) => resourceOption.resource === resource)) throw new Error(`Resource "${resource}" is not available in this scoped component`);
+			return {
+				...entry,
+				props: props ?? {}
+			};
+		}
 		Object.assign(createComponent, { setProps: createComponentSetProps });
 		const scopedExtras = {
 			createComponent,
+			createResourceComponents,
 			forResource: scopedForResource,
 			resources: void 0
 		};

package/dist/create-config/for-resources/create-for-resources.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"create-for-resources.mjs","names":[],"sources":["../../../src/create-config/for-resources/create-for-resources.ts"],"sourcesContent":["import {\n  createContext,\n  createElement,\n  type ComponentType,\n  type JSX,\n  useContext,\n} from 'react';\nimport type { ComposableComponents } from '@jfdevelops/react-layout-composables';\nimport {\n  type AnyBuiltPropDefinition,\n  validateProps,\n} from '@jfdevelops/react-layout-validator';\nimport type { InPropsDefinition, InPropsObject } from '../../props';\nimport type { LayoutResourceKey, ResourceDefinition } from '../../resource';\nimport { capitalize } from '../../utils/capitalize';\nimport type { LayoutIncludeProps } from '../define-layout';\nimport type {\n  CapitalizedResource,\n  ResourcesLayoutName,\n} from './resource-selection';\nimport type { CreateResourceLayoutForResourcesFn } from './scoped-layout';\nimport {\n  isRenderableComponentType,\n  reservedScopedComponentNames,\n  resolveScopedRenderResult,\n  type ScopedRenderResult,\n  withScopedCompoundStatics,\n} from './scoped-render';\n\ntype CreateForResourcesOptions<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = {\n  createLayoutForResource: (\n    defaultName: string | undefined,\n    resource: LayoutResourceKey<Resources>,\n  ) => unknown;\n  createMakeComposableLayout?: () => (\n    options: Record<string, unknown>,\n  ) => unknown;\n  createResourceLayout: (options: Record<string, unknown>) => unknown;\n  getComponentPropDefinitions: (\n    resource: LayoutResourceKey<Resources>,\n  ) => Record<string, AnyBuiltPropDefinition>;\n};\n\nexport function createForResources<\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  createLayoutForResource,\n  createMakeComposableLayout,\n  createResourceLayout,\n  getComponentPropDefinitions,\n}: CreateForResourcesOptions<Resources>) {\n  return ((...resourcesOrOptions: Array<unknown>) => {\n    const firstArgument = resourcesOrOptions[0];\n    let resourceOptions: Array<{\n      resource: LayoutResourceKey<Resources>;\n      name?:\n        | string\n        | ((\n            resource: CapitalizedResource<LayoutResourceKey<Resources>>,\n          ) => string);\n    }>;\n\n    if (typeof firstArgument === 'string') {\n      resourceOptions = resourcesOrOptions.map((resource) => ({\n        resource: resource as LayoutResourceKey<Resources>,\n      }));\n    } else if (\n      firstArgument !== null &&\n      typeof firstArgument === 'object' &&\n      'resources' in firstArgument &&\n      Array.isArray(firstArgument.resources)\n    ) {\n      const { name, resources } = firstArgument as {\n        name?: ResourcesLayoutName<LayoutResourceKey<Resources>>;\n        resources: Array<LayoutResourceKey<Resources>>;\n      };\n      resourceOptions = resources.map((resource) => ({\n        name: typeof name === 'function' ? name : name?.[resource],\n        resource,\n      }));\n    } else {\n      resourceOptions = Object.entries(firstArgument ?? {}).map(\n        ([resource, options]) => ({\n          ...(options as {\n            name?:\n              | string\n              | ((\n                  resource: CapitalizedResource<LayoutResourceKey<Resources>>,\n                ) => string);\n          }),\n          resource: resource as LayoutResourceKey<Resources>,\n        }),\n      );\n    }\n\n    const defaultNames = new Map(\n      resourceOptions.map(({ name, resource }) => [\n        resource,\n        typeof name === 'function'\n          ? name(\n              capitalize(resource) as CapitalizedResource<\n                LayoutResourceKey<Resources>\n              >,\n            )\n          : name,\n      ]),\n    );\n\n    function scopedCreateResourceLayout(options: Record<string, unknown>) {\n      const resource = options.resource as LayoutResourceKey<Resources>;\n\n      return createResourceLayout({\n        ...options,\n        name: options.name ?? defaultNames.get(resource),\n      });\n    }\n\n    function scopedForResource(options: {\n      name?: string;\n      resource: LayoutResourceKey<Resources>;\n    }) {\n      return createLayoutForResource(\n        options.name ?? defaultNames.get(options.resource),\n        options.resource,\n      );\n    }\n\n    type ScopedComponentRenderFn = (\n      props: Record<string, unknown>,\n      components: Record<string, (props?: never) => JSX.Element>,\n    ) => ScopedRenderResult;\n\n    type ScopedResourceScopedComponentDefinition = {\n      props?: Record<string, AnyBuiltPropDefinition>;\n      render: ScopedComponentRenderFn;\n    };\n\n    type ScopedComponentEntry = {\n      [option: string]: unknown;\n      name?: string;\n      components?: Record<string, ScopedResourceScopedComponentDefinition>;\n      render: ScopedComponentRenderFn;\n    };\n\n    function createComponent(componentOptions: {\n      props?: {\n        include?: Record<string, true | 'optional'>;\n        custom?: Record<string, AnyBuiltPropDefinition>;\n      };\n      resources?: Record<string, ScopedComponentEntry>;\n      render: (\n        props: Record<string, unknown>,\n        context: Record<string, (props: never) => JSX.Element>,\n      ) => ScopedRenderResult;\n    }) {\n      const include = componentOptions.props?.include ?? {};\n      const custom = componentOptions.props?.custom ?? {};\n      const selectedResources = new Set(\n        resourceOptions.map(({ resource }) => resource),\n      );\n      const componentPropsContext = createContext<\n        Record<string, unknown> | undefined\n      >(undefined);\n      const definedEntries = new Map<\n        LayoutResourceKey<Resources>,\n        ScopedComponentEntry\n      >();\n\n      for (const [key, entry] of Object.entries(\n        componentOptions.resources ?? {},\n      )) {\n        const resource = key as LayoutResourceKey<Resources>;\n\n        if (!selectedResources.has(resource)) {\n          throw new Error(\n            `Resource \"${key}\" is not available in this scoped component`,\n          );\n        }\n\n        definedEntries.set(resource, entry);\n      }\n\n      /** Resolved scoped components, per resource. */\n      const resourceScopedComponents = new Map<\n        LayoutResourceKey<Resources>,\n        Record<string, (props?: never) => JSX.Element>\n      >();\n      const contextResources = new Map<string, LayoutResourceKey<Resources>>();\n      const renderContext: Record<string, (props: never) => JSX.Element> =\n        Object.fromEntries(\n          [...definedEntries].map(([resource, entry]) => {\n            const contextKey = capitalize(resource);\n\n            if (contextKey === 'Root') {\n              throw new Error(\n                `Resource \"${resource}\" maps to the reserved render context key \"Root\"`,\n              );\n            }\n\n            const existingResource = contextResources.get(contextKey);\n\n            if (existingResource !== undefined) {\n              throw new Error(\n                `Resources \"${existingResource}\" and \"${resource}\" both map to render context key \"${contextKey}\"`,\n              );\n            }\n\n            contextResources.set(contextKey, resource);\n\n            /**\n             * Built once per resource so every scoped component keeps a stable\n             * identity, and shared by the resource render, the render context,\n             * and any component bound through `asHOF()`.\n             */\n            const scopedComponents: Record<\n              string,\n              (props?: never) => JSX.Element\n            > = {};\n\n            for (const [name, definition] of Object.entries(\n              entry.components ?? {},\n            )) {\n              if (reservedScopedComponentNames.has(name)) {\n                throw new Error(\n                  `Scoped component \"${name}\" for resource \"${resource}\" uses a reserved name`,\n                );\n              }\n\n              const ownPropDefinitions = definition.props ?? {};\n              // Last call-site own-props / returned component for this scoped\n              // entry. Compound statics re-run `render` with these so\n              // `<DataTable variant=\"b\" />` then `<DataTable.Loading />` sees \"b\".\n              let cachedOwnProps: Record<string, unknown> = {};\n              let cachedReturnedComponent:\n                | ComponentType<Record<string, unknown>>\n                | undefined;\n\n              function ScopedComponent(ownProps?: Record<string, unknown>) {\n                const componentProps = useContext(componentPropsContext);\n\n                if (componentProps === undefined) {\n                  throw new Error(\n                    `Scoped component \"${name}\" must be rendered inside its scoped component`,\n                  );\n                }\n\n                const resolvedOwnProps = ownProps ?? {};\n                cachedOwnProps = resolvedOwnProps;\n\n                validateProps(ownPropDefinitions, resolvedOwnProps, {\n                  layoutName:\n                    entry.name ??\n                    defaultNames.get(resource) ??\n                    capitalize(resource),\n                  resource,\n                });\n\n                // Mount a returned component type with call-site props; pass\n                // nodes (elements, portals, null) through unchanged.\n                const result = definition.render(\n                  { ...componentProps, ...resolvedOwnProps, resource },\n                  scopedComponents,\n                );\n\n                if (isRenderableComponentType(result)) {\n                  cachedReturnedComponent = result as ComponentType<\n                    Record<string, unknown>\n                  >;\n                }\n\n                return resolveScopedRenderResult(result, resolvedOwnProps);\n              }\n\n              // Types expose compound statics from the returned component\n              // (`DataTable.Loading`); attach matching runtime wrappers.\n              scopedComponents[name] = withScopedCompoundStatics(\n                ScopedComponent,\n                (staticName) => {\n                  function CompoundStatic(ownProps?: Record<string, unknown>) {\n                    const componentProps = useContext(componentPropsContext);\n\n                    if (componentProps === undefined) {\n                      throw new Error(\n                        `Scoped component \"${name}.${staticName}\" must be rendered inside its scoped component`,\n                      );\n                    }\n\n                    // Prefer the component from the last parent call (same\n                    // closure as that call's own-props). Fall back to re-running\n                    // render with cached parent props when needed.\n                    let result: unknown = cachedReturnedComponent;\n\n                    if (!isRenderableComponentType(result)) {\n                      result = definition.render(\n                        {\n                          ...componentProps,\n                          ...cachedOwnProps,\n                          resource,\n                        },\n                        scopedComponents,\n                      );\n                    }\n\n                    if (!isRenderableComponentType(result)) {\n                      throw new Error(\n                        `Scoped component \"${name}\" must return a component type to use static \"${staticName}\"`,\n                      );\n                    }\n\n                    const staticComponent = (\n                      result as ComponentType<Record<string, unknown>> &\n                        Record<string, unknown>\n                    )[staticName];\n\n                    if (!isRenderableComponentType(staticComponent)) {\n                      throw new Error(\n                        `Scoped component \"${name}\" has no component static \"${staticName}\"`,\n                      );\n                    }\n\n                    // Loading's props — those mount the static itself.\n                    return createElement(staticComponent, ownProps ?? {});\n                  }\n\n                  CompoundStatic.displayName = `${name}.${staticName}`;\n                  return CompoundStatic;\n                },\n              ) as (props?: never) => JSX.Element;\n            }\n\n            resourceScopedComponents.set(resource, scopedComponents);\n\n            function ResourceRender(ownProps?: Record<string, unknown>) {\n              const componentProps = useContext(componentPropsContext);\n\n              if (componentProps === undefined) {\n                throw new Error(\n                  `Render context component \"${contextKey}\" must be rendered inside its scoped component`,\n                );\n              }\n\n              // Call-site props on `context.Users({ title, heading })` merge into\n              // the resource render props and mount a returned component type.\n              const callProps = { ...componentProps, ...ownProps, resource };\n              return resolveScopedRenderResult(\n                entry.render(callProps, scopedComponents),\n                ownProps,\n              );\n            }\n\n            return [\n              contextKey,\n              Object.assign(ResourceRender, scopedComponents),\n            ];\n          }),\n        );\n\n      /**\n       * Layouts are created once per resource and cached. Creating one during\n       * render would hand React a new component type on every pass, remounting\n       * the whole subtree.\n       */\n      const roots = new Map<\n        LayoutResourceKey<Resources>,\n        (props: Record<string, unknown>) => JSX.Element\n      >();\n\n      function Root(rootProps: Record<string, unknown>) {\n        const componentProps = useContext(componentPropsContext);\n\n        if (componentProps === undefined) {\n          throw new Error(\n            'Render context component \"Root\" must be rendered inside its scoped component',\n          );\n        }\n\n        const resource =\n          componentProps.resource as LayoutResourceKey<Resources>;\n        let root = roots.get(resource);\n\n        if (root === undefined) {\n          const entry = definedEntries.get(resource);\n\n          if (entry === undefined) {\n            throw new Error(\n              `Render context component \"Root\" requires a \"resources.${resource}\" entry to build the layout for resource \"${resource}\"`,\n            );\n          }\n\n          // Layout option values come from the outer component call site\n          // (`<Directory title=\"…\" />`), not from the resource entry.\n          const availableDefinitions =\n            getComponentPropDefinitions(resource);\n          const layoutOptions: Record<string, unknown> = {};\n\n          for (const key of Object.keys(availableDefinitions)) {\n            if (key in componentProps) {\n              layoutOptions[key] = componentProps[key];\n            }\n\n            const capitalized = capitalize(key);\n            if (capitalized in componentProps) {\n              layoutOptions[capitalized] = componentProps[capitalized];\n            }\n          }\n\n          root = scopedCreateResourceLayout({\n            ...layoutOptions,\n            name:\n              entry.name ??\n              defaultNames.get(resource) ??\n              capitalize(resource),\n            resource,\n          }) as (props: Record<string, unknown>) => JSX.Element;\n          roots.set(resource, root);\n        }\n\n        return createElement(root, rootProps);\n      }\n\n      renderContext.Root = Root;\n\n      function Component(componentProps: Record<string, unknown>) {\n        const componentResource =\n          componentProps.resource as LayoutResourceKey<Resources>;\n\n        if (!selectedResources.has(componentResource)) {\n          throw new Error(\n            `Resource \"${componentResource}\" is not available in this scoped component`,\n          );\n        }\n\n        const availableDefinitions =\n          getComponentPropDefinitions(componentResource);\n        const definitionsToValidate: Record<string, AnyBuiltPropDefinition> =\n          {};\n\n        for (const [key, inclusion] of Object.entries(include)) {\n          const definition = availableDefinitions[key];\n\n          if (!definition) {\n            continue;\n          }\n\n          // Keep declared keys as-is — do not capitalize JSX.Element props.\n          if (inclusion === true || key in componentProps) {\n            definitionsToValidate[key] = definition;\n          }\n        }\n\n        for (const [key, definition] of Object.entries(custom)) {\n          if (key === 'children' || key === 'resource') {\n            continue;\n          }\n\n          definitionsToValidate[key] = definition;\n        }\n\n        validateProps(definitionsToValidate, componentProps, {\n          layoutName:\n            definedEntries.get(componentResource)?.name ??\n            defaultNames.get(componentResource) ??\n            capitalize(componentResource),\n          resource: componentResource,\n        });\n\n        // Top-level render may return a component type; mount it with the full\n        // component props (include/custom + inferred return-type props).\n        return createElement(\n          componentPropsContext.Provider,\n          { value: componentProps },\n          resolveScopedRenderResult(\n            componentOptions.render(componentProps, renderContext),\n            componentProps,\n          ),\n        );\n      }\n\n      /**\n       * Bound components are created once per resource and cached. Returning a\n       * fresh component from the factory would hand React a new component type\n       * whenever the caller rebinds, remounting the subtree.\n       */\n      const boundComponents = new Map<\n        LayoutResourceKey<Resources>,\n        (props: Record<string, unknown>) => JSX.Element\n      >();\n\n      function bindResource(resource: LayoutResourceKey<Resources>) {\n        if (!selectedResources.has(resource)) {\n          throw new Error(\n            `Resource \"${resource}\" is not available in this scoped component`,\n          );\n        }\n\n        let boundComponent = boundComponents.get(resource);\n\n        if (boundComponent === undefined) {\n          boundComponent = Object.assign(\n            (boundProps: Record<string, unknown>) =>\n              createElement(Component, { ...boundProps, resource }),\n            {\n              displayName: `ScopedResourceComponent(${resource})`,\n              props: undefined,\n              resource: undefined,\n            },\n            resourceScopedComponents.get(resource) ?? {},\n          );\n          boundComponents.set(resource, boundComponent);\n        }\n\n        return boundComponent;\n      }\n\n      function asHOF() {\n        return bindResource;\n      }\n\n      return Object.assign(Component, {\n        asHOF,\n        displayName: 'ScopedResourceComponent',\n        props: undefined,\n      });\n    }\n\n    type CreateComponentPropsBag = {\n      include?: Record<string, true | 'optional'>;\n      custom?: Record<string, AnyBuiltPropDefinition>;\n    };\n\n    const createResourceComponentExtras = new WeakMap<\n      object,\n      CreateComponentPropsBag\n    >();\n\n    function mergeCreateComponentProps(\n      ...bags: Array<CreateComponentPropsBag | undefined>\n    ): CreateComponentPropsBag {\n      const include: Record<string, true | 'optional'> = {};\n      const custom: Record<string, AnyBuiltPropDefinition> = {};\n\n      for (const bag of bags) {\n        Object.assign(include, bag?.include);\n        Object.assign(custom, bag?.custom);\n      }\n\n      return { include, custom };\n    }\n\n    function createComponentSetProps(baseProps: CreateComponentPropsBag) {\n      function createWithProps(componentOptions: {\n        props?: CreateComponentPropsBag;\n        resources?: Record<string, ScopedComponentEntry>;\n        render: (\n          props: Record<string, unknown>,\n          context: Record<string, (props: never) => JSX.Element>,\n        ) => ScopedRenderResult;\n      }) {\n        const fromEntries = mergeCreateComponentProps(\n          ...Object.values(componentOptions.resources ?? {}).map(\n            (entry) => createResourceComponentExtras.get(entry),\n          ),\n        );\n\n        return createComponent({\n          ...componentOptions,\n          props: mergeCreateComponentProps(\n            baseProps,\n            fromEntries,\n            componentOptions.props,\n          ),\n        });\n      }\n\n      createWithProps.createResourceComponents = (options: {\n        resource: LayoutResourceKey<Resources>;\n        props?: CreateComponentPropsBag;\n        name?: string;\n        components?: Record<string, ScopedResourceScopedComponentDefinition>;\n        render: ScopedComponentRenderFn;\n      }) => {\n        const { resource, props, ...entry } = options;\n\n        if (\n          !resourceOptions.some(\n            (resourceOption) => resourceOption.resource === resource,\n          )\n        ) {\n          throw new Error(\n            `Resource \"${resource}\" is not available in this scoped component`,\n          );\n        }\n\n        if (props !== undefined) {\n          createResourceComponentExtras.set(entry, props);\n        }\n\n        return entry;\n      };\n\n      return createWithProps;\n    }\n\n    Object.assign(createComponent, {\n      setProps: createComponentSetProps,\n    });\n\n    const scopedExtras: {\n      createComponent: typeof createComponent;\n      forResource: typeof scopedForResource;\n      makeComposable?: (options: Record<string, unknown>) => unknown;\n      resources: undefined;\n    } = {\n      createComponent,\n      forResource: scopedForResource,\n      resources: undefined,\n    };\n\n    if (createMakeComposableLayout) {\n      const makeComposableLayout = createMakeComposableLayout();\n\n      scopedExtras.makeComposable = (options) => {\n        const resource = options.resource as LayoutResourceKey<Resources>;\n\n        return makeComposableLayout({\n          ...options,\n          name: options.name ?? defaultNames.get(resource),\n        });\n      };\n    }\n\n    return Object.assign(scopedCreateResourceLayout, scopedExtras);\n  }) as unknown as CreateResourceLayoutForResourcesFn<\n    Resources,\n    InProps,\n    Composables,\n    IncludeProps,\n    CustomProps\n  >;\n}\n"],"mappings":"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"}
+{"version":3,"file":"create-for-resources.mjs","names":[],"sources":["../../../src/create-config/for-resources/create-for-resources.ts"],"sourcesContent":["import {\n  createContext,\n  createElement,\n  type ComponentType,\n  type JSX,\n  useContext,\n} from 'react';\nimport type { ComposableComponents } from '@jfdevelops/react-layout-composables';\nimport {\n  type AnyBuiltPropDefinition,\n  validateProps,\n} from '@jfdevelops/react-layout-validator';\nimport type { InPropsDefinition, InPropsObject } from '../../props';\nimport type { LayoutResourceKey, ResourceDefinition } from '../../resource';\nimport { capitalize } from '../../utils/capitalize';\nimport type { LayoutIncludeProps } from '../define-layout';\nimport type {\n  CapitalizedResource,\n  ResourcesLayoutName,\n} from './resource-selection';\nimport type { CreateResourceLayoutForResourcesFn } from './scoped-layout';\nimport {\n  isRenderableComponentType,\n  reservedScopedComponentNames,\n  resolveScopedRenderResult,\n  type ScopedRenderResult,\n  withScopedCompoundStatics,\n} from './scoped-render';\n\ntype CreateForResourcesOptions<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = {\n  createLayoutForResource: (\n    defaultName: string | undefined,\n    resource: LayoutResourceKey<Resources>,\n  ) => unknown;\n  createMakeComposableLayout?: () => (\n    options: Record<string, unknown>,\n  ) => unknown;\n  createResourceLayout: (options: Record<string, unknown>) => unknown;\n  getComponentPropDefinitions: (\n    resource: LayoutResourceKey<Resources>,\n  ) => Record<string, AnyBuiltPropDefinition>;\n};\n\nexport function createForResources<\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  createLayoutForResource,\n  createMakeComposableLayout,\n  createResourceLayout,\n  getComponentPropDefinitions,\n}: CreateForResourcesOptions<Resources>) {\n  return ((...resourcesOrOptions: Array<unknown>) => {\n    const firstArgument = resourcesOrOptions[0];\n    let resourceOptions: Array<{\n      resource: LayoutResourceKey<Resources>;\n      name?:\n        | string\n        | ((\n            resource: CapitalizedResource<LayoutResourceKey<Resources>>,\n          ) => string);\n    }>;\n\n    if (typeof firstArgument === 'string') {\n      resourceOptions = resourcesOrOptions.map((resource) => ({\n        resource: resource as LayoutResourceKey<Resources>,\n      }));\n    } else if (\n      firstArgument !== null &&\n      typeof firstArgument === 'object' &&\n      'resources' in firstArgument &&\n      Array.isArray(firstArgument.resources)\n    ) {\n      const { name, resources } = firstArgument as {\n        name?: ResourcesLayoutName<LayoutResourceKey<Resources>>;\n        resources: Array<LayoutResourceKey<Resources>>;\n      };\n      resourceOptions = resources.map((resource) => ({\n        name: typeof name === 'function' ? name : name?.[resource],\n        resource,\n      }));\n    } else {\n      resourceOptions = Object.entries(firstArgument ?? {}).map(\n        ([resource, options]) => ({\n          ...(options as {\n            name?:\n              | string\n              | ((\n                  resource: CapitalizedResource<LayoutResourceKey<Resources>>,\n                ) => string);\n          }),\n          resource: resource as LayoutResourceKey<Resources>,\n        }),\n      );\n    }\n\n    const defaultNames = new Map(\n      resourceOptions.map(({ name, resource }) => [\n        resource,\n        typeof name === 'function'\n          ? name(\n              capitalize(resource) as CapitalizedResource<\n                LayoutResourceKey<Resources>\n              >,\n            )\n          : name,\n      ]),\n    );\n\n    function scopedCreateResourceLayout(options: Record<string, unknown>) {\n      const resource = options.resource as LayoutResourceKey<Resources>;\n\n      return createResourceLayout({\n        ...options,\n        name: options.name ?? defaultNames.get(resource),\n      });\n    }\n\n    function scopedForResource(options: {\n      name?: string;\n      resource: LayoutResourceKey<Resources>;\n    }) {\n      return createLayoutForResource(\n        options.name ?? defaultNames.get(options.resource),\n        options.resource,\n      );\n    }\n\n    type ScopedComponentRenderFn = (\n      props: Record<string, unknown>,\n      components: Record<string, (props?: never) => JSX.Element>,\n    ) => ScopedRenderResult;\n\n    type ScopedResourceScopedComponentDefinition = {\n      props?: Record<string, AnyBuiltPropDefinition>;\n      render: ScopedComponentRenderFn;\n    };\n\n    type ScopedComponentEntry = {\n      [option: string]: unknown;\n      name?: string;\n      props?: CreateComponentPropsBag;\n      components?: Record<string, ScopedResourceScopedComponentDefinition>;\n      render: ScopedComponentRenderFn;\n    };\n\n    type CreateComponentPropsBag = {\n      include?: Record<string, true | 'optional'>;\n      custom?: Record<string, AnyBuiltPropDefinition>;\n      defined?: Record<string, unknown>;\n    };\n\n    function mergeCreateComponentProps(\n      ...bags: Array<CreateComponentPropsBag | undefined>\n    ): CreateComponentPropsBag {\n      const include: Record<string, true | 'optional'> = {};\n      const custom: Record<string, AnyBuiltPropDefinition> = {};\n\n      for (const bag of bags) {\n        Object.assign(include, bag?.include);\n        Object.assign(custom, bag?.custom);\n\n        for (const key of Object.keys(bag?.defined ?? {})) {\n          include[key] = true;\n        }\n      }\n\n      return { include, custom };\n    }\n\n    function createComponent(componentOptions: {\n      props?: {\n        include?: Record<string, true | 'optional'>;\n        custom?: Record<string, AnyBuiltPropDefinition>;\n      };\n      resources?: Record<string, ScopedComponentEntry>;\n      render: (\n        props: Record<string, unknown>,\n        context: Record<string, (props: never) => JSX.Element>,\n      ) => ScopedRenderResult;\n    }) {\n      const mergedProps = mergeCreateComponentProps(\n        componentOptions.props,\n        ...Object.values(componentOptions.resources ?? {}).map(\n          (entry) => entry.props,\n        ),\n      );\n      const include = mergedProps.include ?? {};\n      const custom = mergedProps.custom ?? {};\n      const selectedResources = new Set(\n        resourceOptions.map(({ resource }) => resource),\n      );\n      const componentPropsContext = createContext<\n        Record<string, unknown> | undefined\n      >(undefined);\n      const definedEntries = new Map<\n        LayoutResourceKey<Resources>,\n        ScopedComponentEntry\n      >();\n\n      for (const [key, entry] of Object.entries(\n        componentOptions.resources ?? {},\n      )) {\n        const resource = key as LayoutResourceKey<Resources>;\n\n        if (!selectedResources.has(resource)) {\n          throw new Error(\n            `Resource \"${key}\" is not available in this scoped component`,\n          );\n        }\n\n        definedEntries.set(resource, entry);\n      }\n\n      /** Resolved scoped components, per resource. */\n      const resourceScopedComponents = new Map<\n        LayoutResourceKey<Resources>,\n        Record<string, (props?: never) => JSX.Element>\n      >();\n      const contextResources = new Map<string, LayoutResourceKey<Resources>>();\n      const renderContext: Record<string, (props: never) => JSX.Element> =\n        Object.fromEntries(\n          [...definedEntries].map(([resource, entry]) => {\n            const contextKey = capitalize(resource);\n\n            if (contextKey === 'Root') {\n              throw new Error(\n                `Resource \"${resource}\" maps to the reserved render context key \"Root\"`,\n              );\n            }\n\n            const existingResource = contextResources.get(contextKey);\n\n            if (existingResource !== undefined) {\n              throw new Error(\n                `Resources \"${existingResource}\" and \"${resource}\" both map to render context key \"${contextKey}\"`,\n              );\n            }\n\n            contextResources.set(contextKey, resource);\n\n            /**\n             * Built once per resource so every scoped component keeps a stable\n             * identity, and shared by the resource render, the render context,\n             * and any component bound through `asHOF()`.\n             */\n            const scopedComponents: Record<\n              string,\n              (props?: never) => JSX.Element\n            > = {};\n\n            for (const [name, definition] of Object.entries(\n              entry.components ?? {},\n            )) {\n              if (reservedScopedComponentNames.has(name)) {\n                throw new Error(\n                  `Scoped component \"${name}\" for resource \"${resource}\" uses a reserved name`,\n                );\n              }\n\n              const ownPropDefinitions = definition.props ?? {};\n              // Last call-site own-props / returned component for this scoped\n              // entry. Compound statics re-run `render` with these so\n              // `<DataTable variant=\"b\" />` then `<DataTable.Loading />` sees \"b\".\n              let cachedOwnProps: Record<string, unknown> = {};\n              let cachedReturnedComponent:\n                | ComponentType<Record<string, unknown>>\n                | undefined;\n\n              function ScopedComponent(ownProps?: Record<string, unknown>) {\n                const componentProps = useContext(componentPropsContext);\n\n                if (componentProps === undefined) {\n                  throw new Error(\n                    `Scoped component \"${name}\" must be rendered inside its scoped component`,\n                  );\n                }\n\n                const resolvedOwnProps = ownProps ?? {};\n                cachedOwnProps = resolvedOwnProps;\n\n                validateProps(ownPropDefinitions, resolvedOwnProps, {\n                  layoutName:\n                    entry.name ??\n                    defaultNames.get(resource) ??\n                    capitalize(resource),\n                  resource,\n                });\n\n                // Mount a returned component type with call-site props; pass\n                // nodes (elements, portals, null) through unchanged.\n                const result = definition.render(\n                  { ...componentProps, ...resolvedOwnProps, resource },\n                  scopedComponents,\n                );\n\n                if (isRenderableComponentType(result)) {\n                  cachedReturnedComponent = result as ComponentType<\n                    Record<string, unknown>\n                  >;\n                }\n\n                return resolveScopedRenderResult(result, resolvedOwnProps);\n              }\n\n              // Types expose compound statics from the returned component\n              // (`DataTable.Loading`); attach matching runtime wrappers.\n              scopedComponents[name] = withScopedCompoundStatics(\n                ScopedComponent,\n                (staticName) => {\n                  function CompoundStatic(ownProps?: Record<string, unknown>) {\n                    const componentProps = useContext(componentPropsContext);\n\n                    if (componentProps === undefined) {\n                      throw new Error(\n                        `Scoped component \"${name}.${staticName}\" must be rendered inside its scoped component`,\n                      );\n                    }\n\n                    // Prefer the component from the last parent call (same\n                    // closure as that call's own-props). Fall back to re-running\n                    // render with cached parent props when needed.\n                    let result: unknown = cachedReturnedComponent;\n\n                    if (!isRenderableComponentType(result)) {\n                      result = definition.render(\n                        {\n                          ...componentProps,\n                          ...cachedOwnProps,\n                          resource,\n                        },\n                        scopedComponents,\n                      );\n                    }\n\n                    if (!isRenderableComponentType(result)) {\n                      throw new Error(\n                        `Scoped component \"${name}\" must return a component type to use static \"${staticName}\"`,\n                      );\n                    }\n\n                    const staticComponent = (\n                      result as ComponentType<Record<string, unknown>> &\n                        Record<string, unknown>\n                    )[staticName];\n\n                    if (!isRenderableComponentType(staticComponent)) {\n                      throw new Error(\n                        `Scoped component \"${name}\" has no component static \"${staticName}\"`,\n                      );\n                    }\n\n                    // Loading's props — those mount the static itself.\n                    return createElement(staticComponent, ownProps ?? {});\n                  }\n\n                  CompoundStatic.displayName = `${name}.${staticName}`;\n                  return CompoundStatic;\n                },\n              ) as (props?: never) => JSX.Element;\n            }\n\n            resourceScopedComponents.set(resource, scopedComponents);\n\n            function ResourceRender(ownProps?: Record<string, unknown>) {\n              const componentProps = useContext(componentPropsContext);\n\n              if (componentProps === undefined) {\n                throw new Error(\n                  `Render context component \"${contextKey}\" must be rendered inside its scoped component`,\n                );\n              }\n\n              // Call-site props on `context.Users({ title, heading })` merge into\n              // the resource render props and mount a returned component type.\n              const callProps = { ...componentProps, ...ownProps, resource };\n              return resolveScopedRenderResult(\n                entry.render(callProps, scopedComponents),\n                ownProps,\n              );\n            }\n\n            return [\n              contextKey,\n              Object.assign(ResourceRender, scopedComponents),\n            ];\n          }),\n        );\n\n      /**\n       * Layouts are created once per resource and cached. Creating one during\n       * render would hand React a new component type on every pass, remounting\n       * the whole subtree.\n       */\n      const roots = new Map<\n        LayoutResourceKey<Resources>,\n        (props: Record<string, unknown>) => JSX.Element\n      >();\n\n      function Root(rootProps: Record<string, unknown>) {\n        const componentProps = useContext(componentPropsContext);\n\n        if (componentProps === undefined) {\n          throw new Error(\n            'Render context component \"Root\" must be rendered inside its scoped component',\n          );\n        }\n\n        const resource =\n          componentProps.resource as LayoutResourceKey<Resources>;\n        let root = roots.get(resource);\n\n        if (root === undefined) {\n          const entry = definedEntries.get(resource);\n\n          if (entry === undefined) {\n            throw new Error(\n              `Render context component \"Root\" requires a \"resources.${resource}\" entry to build the layout for resource \"${resource}\"`,\n            );\n          }\n\n          // Layout option values come from the outer component call site\n          // (`<Directory title=\"…\" />`), not from the resource entry.\n          const availableDefinitions =\n            getComponentPropDefinitions(resource);\n          const layoutOptions: Record<string, unknown> = {};\n          const defined = entry.props?.defined ?? {};\n\n          for (const key of Object.keys(availableDefinitions)) {\n            if (key in defined) {\n              layoutOptions[key] = defined[key];\n            }\n\n            const capitalized = capitalize(key);\n            if (capitalized in defined) {\n              layoutOptions[capitalized] = defined[capitalized];\n            }\n\n            if (key in componentProps) {\n              layoutOptions[key] = componentProps[key];\n            }\n\n            if (capitalized in componentProps) {\n              layoutOptions[capitalized] = componentProps[capitalized];\n            }\n          }\n\n          root = scopedCreateResourceLayout({\n            ...layoutOptions,\n            name:\n              entry.name ??\n              defaultNames.get(resource) ??\n              capitalize(resource),\n            resource,\n          }) as (props: Record<string, unknown>) => JSX.Element;\n          roots.set(resource, root);\n        }\n\n        const entry = definedEntries.get(resource);\n        const definedCustom: Record<string, unknown> = {};\n\n        for (const [key, value] of Object.entries(\n          entry?.props?.defined ?? {},\n        )) {\n          if (key in custom) {\n            definedCustom[key] = value;\n          }\n        }\n\n        return createElement(root, { ...definedCustom, ...rootProps });\n      }\n\n      renderContext.Root = Root;\n\n      function Component(componentProps: Record<string, unknown>) {\n        const componentResource =\n          componentProps.resource as LayoutResourceKey<Resources>;\n\n        if (!selectedResources.has(componentResource)) {\n          throw new Error(\n            `Resource \"${componentResource}\" is not available in this scoped component`,\n          );\n        }\n\n        const defined =\n          definedEntries.get(componentResource)?.props?.defined ?? {};\n        const resolvedComponentProps = { ...defined, ...componentProps };\n        const availableDefinitions =\n          getComponentPropDefinitions(componentResource);\n        const definitionsToValidate: Record<string, AnyBuiltPropDefinition> =\n          {};\n\n        for (const [key, inclusion] of Object.entries(include)) {\n          const definition = availableDefinitions[key];\n\n          if (!definition) {\n            continue;\n          }\n\n          // Keep declared keys as-is — do not capitalize JSX.Element props.\n          if (inclusion === true || key in resolvedComponentProps) {\n            definitionsToValidate[key] = definition;\n          }\n        }\n\n        for (const [key, definition] of Object.entries(custom)) {\n          if (key === 'children' || key === 'resource') {\n            continue;\n          }\n\n          definitionsToValidate[key] = definition;\n        }\n\n        validateProps(definitionsToValidate, resolvedComponentProps, {\n          layoutName:\n            definedEntries.get(componentResource)?.name ??\n            defaultNames.get(componentResource) ??\n            capitalize(componentResource),\n          resource: componentResource,\n        });\n\n        // Top-level render may return a component type; mount it with the full\n        // component props (include/custom + inferred return-type props).\n        return createElement(\n          componentPropsContext.Provider,\n          { value: resolvedComponentProps },\n          resolveScopedRenderResult(\n            componentOptions.render(resolvedComponentProps, renderContext),\n            resolvedComponentProps,\n          ),\n        );\n      }\n\n      /**\n       * Bound components are created once per resource and cached. Returning a\n       * fresh component from the factory would hand React a new component type\n       * whenever the caller rebinds, remounting the subtree.\n       */\n      const boundComponents = new Map<\n        LayoutResourceKey<Resources>,\n        (props: Record<string, unknown>) => JSX.Element\n      >();\n\n      function bindResource(resource: LayoutResourceKey<Resources>) {\n        if (!selectedResources.has(resource)) {\n          throw new Error(\n            `Resource \"${resource}\" is not available in this scoped component`,\n          );\n        }\n\n        let boundComponent = boundComponents.get(resource);\n\n        if (boundComponent === undefined) {\n          boundComponent = Object.assign(\n            (boundProps: Record<string, unknown>) =>\n              createElement(Component, { ...boundProps, resource }),\n            {\n              displayName: `ScopedResourceComponent(${resource})`,\n              props: undefined,\n              resource: undefined,\n            },\n            resourceScopedComponents.get(resource) ?? {},\n          );\n          boundComponents.set(resource, boundComponent);\n        }\n\n        return boundComponent;\n      }\n\n      function asHOF() {\n        return bindResource;\n      }\n\n      return Object.assign(Component, {\n        asHOF,\n        displayName: 'ScopedResourceComponent',\n        props: undefined,\n      });\n    }\n\n    function createComponentSetProps(baseProps: CreateComponentPropsBag) {\n      function createWithProps(componentOptions: {\n        props?: CreateComponentPropsBag;\n        resources?: Record<string, ScopedComponentEntry>;\n        render: (\n          props: Record<string, unknown>,\n          context: Record<string, (props: never) => JSX.Element>,\n        ) => ScopedRenderResult;\n      }) {\n        return createComponent({\n          ...componentOptions,\n          props: mergeCreateComponentProps(baseProps, componentOptions.props),\n        });\n      }\n\n      createWithProps.createResourceComponents = createResourceComponents;\n\n      return createWithProps;\n    }\n\n    function createResourceComponents(options: {\n      resource: LayoutResourceKey<Resources>;\n      props?: CreateComponentPropsBag;\n      name?: string;\n      components?: Record<string, ScopedResourceScopedComponentDefinition>;\n      render: ScopedComponentRenderFn;\n    }) {\n      const { resource, props, ...entry } = options;\n\n      if (\n        !resourceOptions.some(\n          (resourceOption) => resourceOption.resource === resource,\n        )\n      ) {\n        throw new Error(\n          `Resource \"${resource}\" is not available in this scoped component`,\n        );\n      }\n\n      return { ...entry, props: props ?? {} };\n    }\n\n    Object.assign(createComponent, {\n      setProps: createComponentSetProps,\n    });\n\n    const scopedExtras: {\n      createComponent: typeof createComponent;\n      createResourceComponents: typeof createResourceComponents;\n      forResource: typeof scopedForResource;\n      makeComposable?: (options: Record<string, unknown>) => unknown;\n      resources: undefined;\n    } = {\n      createComponent,\n      createResourceComponents,\n      forResource: scopedForResource,\n      resources: undefined,\n    };\n\n    if (createMakeComposableLayout) {\n      const makeComposableLayout = createMakeComposableLayout();\n\n      scopedExtras.makeComposable = (options) => {\n        const resource = options.resource as LayoutResourceKey<Resources>;\n\n        return makeComposableLayout({\n          ...options,\n          name: options.name ?? defaultNames.get(resource),\n        });\n      };\n    }\n\n    return Object.assign(scopedCreateResourceLayout, scopedExtras);\n  }) as unknown as CreateResourceLayoutForResourcesFn<\n    Resources,\n    InProps,\n    Composables,\n    IncludeProps,\n    CustomProps\n  >;\n}\n"],"mappings":"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"}

package/dist/create-config/for-resources/scoped-layout.d.cts

@@ -2,7 +2,7 @@ import { LayoutResourceKey, ResourceDefinition } from "../../resource.cjs";
 import { InPropsDefinition, InPropsObject } from "../../props.cjs";
 import { CreateLayoutForResourceOptions, CreateResourceLayoutOptionsBase, CreatedLayoutForResource, SetDefaultPropForResourceFn } from "../for-resource.cjs";
 import { AtLeastOneResourceLayoutNameKey, AtLeastOneResourceLayoutSelection, CapitalizedResource, HasResourceLayoutName, MappedResourceLayoutArguments, ResourceLayoutNames, ResourceLayoutSelection, SelectedLayoutResources, SelectedResourceLayoutArguments, SelectedResourceLayoutName, SelectedResourceLayoutNames, SharedResourceLayoutArguments } from "./resource-selection.cjs";
-import { ScopedCreateComponent } from "./create-component.cjs";
+import { ScopedCreateComponent, ScopedCreateResourceComponents } from "./create-component.cjs";
 import { LayoutIncludeProps, LayoutPropsForResource, ResourceLayoutComponent } from "../define-layout.cjs";
 import { ComposableComponents, ComposableResourceLayout } from "@jfdevelops/react-layout-composables";
 
@@ -80,7 +80,8 @@ type ScopedCreateResourceLayoutFn<Resources extends ReadonlyArray<ResourceDefini
    * shared component render function.
    * @returns A component scoped to the selected resources.
    */
-  createComponent: ScopedCreateComponent<Resources, InProps, Composables, Arguments, CustomProps>;
+  createComponent: ScopedCreateComponent<Resources, InProps, Composables, Arguments, CustomProps>; /** Builds one reusable entry for the selected resources. */
+  createResourceComponents: ScopedCreateResourceComponents<Resources, InProps, Composables, Arguments, CustomProps, {}, {}>;
   forResource: ScopedCreateLayoutForResource<Resources, InProps, Composables, Arguments, CustomProps>;
   /**
    * Type-only property containing the target resource union. This property is

package/dist/create-config/for-resources/scoped-layout.d.cts.map

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

package/dist/create-config/for-resources/scoped-layout.d.mts

@@ -2,7 +2,7 @@ import { LayoutResourceKey, ResourceDefinition } from "../../resource.mjs";
 import { InPropsDefinition, InPropsObject } from "../../props.mjs";
 import { CreateLayoutForResourceOptions, CreateResourceLayoutOptionsBase, CreatedLayoutForResource, SetDefaultPropForResourceFn } from "../for-resource.mjs";
 import { AtLeastOneResourceLayoutNameKey, AtLeastOneResourceLayoutSelection, CapitalizedResource, HasResourceLayoutName, MappedResourceLayoutArguments, ResourceLayoutNames, ResourceLayoutSelection, SelectedLayoutResources, SelectedResourceLayoutArguments, SelectedResourceLayoutName, SelectedResourceLayoutNames, SharedResourceLayoutArguments } from "./resource-selection.mjs";
-import { ScopedCreateComponent } from "./create-component.mjs";
+import { ScopedCreateComponent, ScopedCreateResourceComponents } from "./create-component.mjs";
 import { LayoutIncludeProps, LayoutPropsForResource, ResourceLayoutComponent } from "../define-layout.mjs";
 import { ComposableComponents, ComposableResourceLayout } from "@jfdevelops/react-layout-composables";
 
@@ -80,7 +80,8 @@ type ScopedCreateResourceLayoutFn<Resources extends ReadonlyArray<ResourceDefini
    * shared component render function.
    * @returns A component scoped to the selected resources.
    */
-  createComponent: ScopedCreateComponent<Resources, InProps, Composables, Arguments, CustomProps>;
+  createComponent: ScopedCreateComponent<Resources, InProps, Composables, Arguments, CustomProps>; /** Builds one reusable entry for the selected resources. */
+  createResourceComponents: ScopedCreateResourceComponents<Resources, InProps, Composables, Arguments, CustomProps, {}, {}>;
   forResource: ScopedCreateLayoutForResource<Resources, InProps, Composables, Arguments, CustomProps>;
   /**
    * Type-only property containing the target resource union. This property is

package/dist/create-config/for-resources/scoped-layout.d.mts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jfdevelops/react-layout",
-  "version": "0.17.2",
+  "version": "0.17.3",
   "description": "A React library for creating layout components.",
   "repository": {
     "type": "git",
@@ -27,8 +27,8 @@
     "node": "^20.19.0 || >=22.12.0"
   },
   "dependencies": {
-    "@jfdevelops/react-layout-composables": "0.2.5",
-    "@jfdevelops/react-layout-validator": "0.2.5"
+    "@jfdevelops/react-layout-composables": "0.2.6",
+    "@jfdevelops/react-layout-validator": "0.2.6"
   },
   "peerDependencies": {
     "react": ">=18",

package/skills/build-react-layouts/references/factory-patterns.md

@@ -84,24 +84,33 @@ need distinct render implementations:
 
 ```tsx
 const createCalendarPage = createResourceLayout
-  .forResources('appointments', 'availability')
+  .forResources('appointments', 'availability');
+
+const appointments = createCalendarPage.createResourceComponents({
+  resource: 'appointments',
+  props: {
+    defined: { segments: { title: 'Appointments' } },
+  },
+  render: function AppointmentsRender() {
+    return <AppointmentsView />;
+  },
+});
+
+const availability = createCalendarPage.createResourceComponents({
+  resource: 'availability',
+  props: {
+    defined: { segments: { title: 'Availability' } },
+  },
+  render: function AvailabilityRender() {
+    return <AvailabilityView />;
+  },
+});
+
+const createCalendarResourcePage = createCalendarPage
   .createComponent({
-    props: {
-      include: {
-        segments: true,
-      },
-    },
     resources: {
-      appointments: {
-        render: function AppointmentsRender() {
-          return <AppointmentsView />;
-        },
-      },
-      availability: {
-        render: function AvailabilityRender() {
-          return <AvailabilityView />;
-        },
-      },
+      appointments,
+      availability,
     },
     render: function Render({ resource, children }, context) {
       return (
@@ -118,13 +127,21 @@ const createCalendarPage = createResourceLayout
   })
   .asHOF();
 
-export const AppointmentsPage = createCalendarPage('appointments');
-export const AvailabilityPage = createCalendarPage('availability');
+export const AppointmentsPage = createCalendarResourcePage('appointments');
+export const AvailabilityPage = createCalendarResourcePage('availability');
 
-<AppointmentsPage segments={{ title: 'Appointments' }} />;
-<AvailabilityPage segments={{ title: 'Availability' }} />;
+<AppointmentsPage />;
+<AppointmentsPage segments={{ title: 'Override' }} />;
+<AvailabilityPage />;
 ```
 
+Resource entries use one optional `props` bag: `include` exposes layout props
+without defaults, `custom` declares additional props, and `defined` bakes
+values into that resource. Every `defined` key is included automatically and
+becomes optional at the bound call site. When a caller supplies the same prop,
+the call-site value wins. Keep layout values inside `props.defined`, not beside
+`render` on the entry.
+
 Use this pattern only when the resources share meaningful behavior, controls,
 or state transitions. The outer renderer should own behavior shared by the
 resource subset. Each resource renderer should own resource-specific data and