@jfdevelops/react-layout 0.15.0 → 0.16.0

package/dist/create-config/for-resources/resource-selection.d.mts

@@ -0,0 +1,47 @@
+import { LayoutResourceKey, ResourceDefinition } from "../../resource.mjs";
+
+//#region src/create-config/for-resources/resource-selection.d.ts
+type CapitalizedResource<Resource extends string> = Resource extends Resource ? {
+  toLowerCase: () => Lowercase<Capitalize<Resource>>;
+} & Capitalize<Resource> : never;
+type ResourceLayoutNames<Resource extends string, CallbackName extends string = string> = { [TargetResource in Resource]?: string | ((resource: CapitalizedResource<TargetResource>) => CallbackName) };
+type AtLeastOneResourceLayoutNameKey<Resource extends string> = { [TargetResource in Resource]: Record<TargetResource, unknown> & Partial<Record<Exclude<Resource, TargetResource>, unknown>> }[Resource];
+type SelectedResourceLayoutNames<Resource extends string, SelectedResource extends Resource, CallbackName extends string> = { [TargetResource in Resource as TargetResource extends SelectedResource ? TargetResource : never]?: string | ((resource: CapitalizedResource<TargetResource>) => CallbackName) };
+type ResourceLayoutSelection<Resources extends ReadonlyArray<ResourceDefinition>, CallbackName extends string = string> = { [Resource in LayoutResourceKey<Resources>]?: {
+  name?: string | ((resource: CapitalizedResource<Resource>) => CallbackName);
+} };
+type AtLeastOneResourceLayoutSelection<Resources extends ReadonlyArray<ResourceDefinition>, CallbackName extends string> = { [Resource in LayoutResourceKey<Resources>]: Required<Pick<ResourceLayoutSelection<Resources, CallbackName>, Resource>> & Omit<ResourceLayoutSelection<Resources, CallbackName>, Resource> }[LayoutResourceKey<Resources>];
+type SelectedLayoutResources<Resources extends ReadonlyArray<ResourceDefinition>, Arguments extends ReadonlyArray<unknown>> = Arguments extends ReadonlyArray<LayoutResourceKey<Resources>> ? Arguments[number] : Arguments[0] extends {
+  resources: ReadonlyArray<infer Resource>;
+} ? Resource & LayoutResourceKey<Resources> : keyof Arguments[0] & LayoutResourceKey<Resources>;
+type ResolveResourceLayoutName<Name> = Name extends ((...args: never[]) => infer Result) ? Result & string : Name extends string ? Name : string;
+type NormalizeCapitalizedResourceName<Name extends string, Resource extends string> = Name extends Name ? NormalizeCapitalizedResourceNameMatch<Name, Resource> extends infer Match ? [Match] extends [never] ? Name : Match : never : never;
+type NormalizeCapitalizedResourceNameMatch<Name extends string, Resource extends string> = Resource extends Resource ? Name extends `${CapitalizedResource<Resource>}${infer Suffix}` ? `${Capitalize<Resource>}${Suffix}` : never : never;
+type SelectedResourceLayoutName<Arguments, Resource extends string> = Arguments extends ReadonlyArray<string> ? string : Arguments extends readonly [infer Options] ? Options extends {
+  resources: ReadonlyArray<string>;
+  name?: infer Name;
+} ? Name extends ((...args: never[]) => unknown) ? ResolveResourceLayoutName<Name> : Name extends Record<Resource, infer ResourceName> ? ResolveResourceLayoutName<ResourceName> : string : Options extends Record<Resource, infer ResourceOptions> ? ResourceOptions extends {
+  name?: infer Name;
+} ? ResolveResourceLayoutName<Name> : string : string : string;
+type NormalizeResourceLayoutNames<Names, CallbackName extends string> = { [Resource in keyof Names]: Names[Resource] extends ((...args: never[]) => unknown) ? (resource: CapitalizedResource<Resource & string>) => NormalizeCapitalizedResourceName<CallbackName, Resource & string> : Names[Resource] };
+type NormalizeResourceLayoutSelection<Selection> = { [Resource in keyof Selection]: Selection[Resource] extends {
+  name: infer Name;
+} ? {
+  name: Name extends ((...args: never[]) => unknown) ? (resource: CapitalizedResource<Resource & string>) => NormalizeCapitalizedResourceName<ResolveResourceLayoutName<Name>, Resource & string> : Name;
+} : Selection[Resource] };
+type SharedResourceLayoutArguments<Resources extends ReadonlyArray<ResourceDefinition>, ResourceKeys extends ReadonlyArray<LayoutResourceKey<Resources>>, Name extends string> = readonly [{
+  resources: ResourceKeys;
+  name: (resource: CapitalizedResource<ResourceKeys[number]>) => NormalizeCapitalizedResourceName<Name, ResourceKeys[number]>;
+}];
+type MappedResourceLayoutArguments<Resources extends ReadonlyArray<ResourceDefinition>, ResourceKeys extends ReadonlyArray<LayoutResourceKey<Resources>>, Names, CallbackName extends string> = readonly [{
+  resources: ResourceKeys;
+  name: NormalizeResourceLayoutNames<Names, CallbackName>;
+}];
+type SelectedResourceLayoutArguments<Selection> = readonly [NormalizeResourceLayoutSelection<Selection>];
+type HasResourceLayoutName<Arguments, Resource extends string> = Arguments extends ReadonlyArray<string> ? false : Arguments extends readonly [infer Options] ? Options extends {
+  resources: ReadonlyArray<string>;
+  name: infer Name;
+} ? Name extends ((...args: never[]) => unknown) ? true : Name extends Record<Resource, unknown> ? true : false : Options extends Record<Resource, infer ResourceOptions> ? 'name' extends keyof ResourceOptions ? true : false : false : false;
+//#endregion
+export { AtLeastOneResourceLayoutNameKey, AtLeastOneResourceLayoutSelection, CapitalizedResource, HasResourceLayoutName, MappedResourceLayoutArguments, ResourceLayoutNames, ResourceLayoutSelection, SelectedLayoutResources, SelectedResourceLayoutArguments, SelectedResourceLayoutName, SelectedResourceLayoutNames, SharedResourceLayoutArguments };
+//# sourceMappingURL=resource-selection.d.mts.map

package/dist/create-config/for-resources/resource-selection.d.mts.map

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

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

@@ -0,0 +1,185 @@
+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 { LayoutIncludeProps, LayoutPropsForResource, ResourceLayoutComponent } from "../define-layout.cjs";
+import { ComposableComponents, ComposableResourceLayout } from "@jfdevelops/react-layout-composables";
+
+//#region src/create-config/for-resources/scoped-layout.d.ts
+type ScopedCreateResourceLayoutOptions<Resources extends ReadonlyArray<ResourceDefinition>, InProps extends InPropsDefinition<Resources>, Composables extends ComposableComponents, Arguments extends ReadonlyArray<unknown>, Name extends string, Resource extends SelectedLayoutResources<Resources, Arguments>, Props extends InPropsObject> = LayoutPropsForResource<Resources, InProps, Composables> & {
+  resource: Resource;
+  props?: Props;
+} & (HasResourceLayoutName<Arguments, Resource> extends true ? {
+  name?: Name;
+} : {
+  name: Name;
+});
+type ScopedCreateResourceLayoutFnImpl<Resources extends ReadonlyArray<ResourceDefinition>, InProps extends InPropsDefinition<Resources>, Composables extends ComposableComponents, Arguments extends ReadonlyArray<unknown>, CustomProps extends InPropsObject> = <Resource extends SelectedLayoutResources<Resources, Arguments>, Name extends string = SelectedResourceLayoutName<Arguments, Resource>, Props extends InPropsObject = {}>(options: ScopedCreateResourceLayoutOptions<Resources, InProps, Composables, Arguments, Name, Resource, Props>) => ResourceLayoutComponent<Name, CustomProps, Composables, Resource>;
+type ScopedCreateLayoutForResource<Resources extends ReadonlyArray<ResourceDefinition>, InProps extends InPropsDefinition<Resources>, Composables extends ComposableComponents, Arguments extends ReadonlyArray<unknown>, CustomProps extends InPropsObject> = <Resource extends SelectedLayoutResources<Resources, Arguments>, Name extends string = SelectedResourceLayoutName<Arguments, Resource>>(options: CreateLayoutForResourceOptions<Resources, Name, Resource>) => CreatedLayoutForResource<Resources, InProps, Composables, Name, Resource, CustomProps> & {
+  setDefaults: SetDefaultPropForResourceFn<Resources, InProps, Composables, Name, Resource, CustomProps>;
+};
+type ScopedCreateResourceLayoutMakeComposableFn<Resources extends ReadonlyArray<ResourceDefinition>, InProps extends InPropsDefinition<Resources>, Composables extends ComposableComponents, Arguments extends ReadonlyArray<unknown>> = <Resource extends SelectedLayoutResources<Resources, Arguments>, Name extends string = SelectedResourceLayoutName<Arguments, Resource>, Props extends InPropsObject = {}>(options: Omit<CreateResourceLayoutOptionsBase<Resources, Name, Resource>, 'name'> & Partial<LayoutPropsForResource<Resources, InProps, Composables>> & {
+  props?: Props;
+} & (HasResourceLayoutName<Arguments, Resource> extends true ? {
+  name?: Name;
+} : {
+  name: Name;
+})) => ComposableResourceLayout<Composables, Name, any, any, any>;
+type ScopedCreateResourceLayoutFn<Resources extends ReadonlyArray<ResourceDefinition>, InProps extends InPropsDefinition<Resources>, Composables extends ComposableComponents, Arguments extends ReadonlyArray<unknown>, CustomProps extends InPropsObject> = ScopedCreateResourceLayoutFnImpl<Resources, InProps, Composables, Arguments, CustomProps> & {
+  /**
+   * Creates a component shared by the target resources. Included layout props
+   * become component props, and `children` is always available as an optional
+   * prop in both the render callback and at the call site.
+   *
+   * Each key of `resources` holds that resource's scoped `components` and
+   * `render`. Layout option values like `title` are call-site props on
+   * `context.<Resource>` / the outer component — not fields on the entry.
+   * The render context exposes `Root` and one capitalized component per key
+   * present in `resources`.
+   *
+   * Each entry may also declare `components` — components scoped to that
+   * resource, available to the entry's own `render`, on `context.<Resource>`,
+   * and on the component returned by `asHOF()`.
+   *
+   * @example
+   * const Directory = createDirectoryLayout.createComponent({
+   *   props: { include: { title: true, actions: 'optional' } },
+   *   resources: {
+   *     users: {
+   *       components: {
+   *         Toolbar: { render: ({ title }) => <nav>{title}</nav> },
+   *       },
+   *       render: ({ resource }, components) => (
+   *         <>
+   *           <components.Toolbar />
+   *           <span>{resource}</span>
+   *         </>
+   *       ),
+   *     },
+   *     admins: {
+   *       render: ({ resource }) => <span>{resource}</span>,
+   *     },
+   *   },
+   *   render: ({ actions, children, resource }, context) => (
+   *     <context.Root actions={actions}>
+   *       {children}
+   *       {resource === 'users' ? (
+   *         <context.Users title="Users" />
+   *       ) : (
+   *         <context.Admins title="Admins" />
+   *       )}
+   *       <context.Users.Toolbar />
+   *     </context.Root>
+   *   ),
+   * })
+   *
+   * <Directory resource='users' title='Users' />
+   *
+   * @param options The props configuration, per-resource entries, and the
+   * shared component render function.
+   * @returns A component scoped to the selected resources.
+   */
+  createComponent: ScopedCreateComponent<Resources, InProps, Composables, Arguments, CustomProps>;
+  forResource: ScopedCreateLayoutForResource<Resources, InProps, Composables, Arguments, CustomProps>;
+  /**
+   * Type-only property containing the target resource union. This property is
+   * `undefined` at runtime and exists solely for extracting the scoped type.
+   *
+   * @example
+   * type AccountResource = typeof createAccountLayout.resources;
+   */
+  readonly resources: SelectedLayoutResources<Resources, Arguments>;
+} & ([keyof Composables] extends [never] ? {} : {
+  makeComposable: ScopedCreateResourceLayoutMakeComposableFn<Resources, InProps, Composables, Arguments>;
+});
+type CreateResourceLayoutForResourcesFn<Resources extends ReadonlyArray<ResourceDefinition>, InProps extends InPropsDefinition<Resources>, Composables extends ComposableComponents = {}, IncludeProps extends LayoutIncludeProps<Resources, InProps, Composables> = {}, CustomProps extends InPropsObject = {}> = {
+  /**
+   * Creates a layout factory scoped to the listed resources.
+   *
+   * Layout names must be supplied when a layout is created.
+   *
+   * @example
+   * createResourceLayout.forResources('users', 'admins')
+   *
+   * @param resources Resources available from the returned layout factory.
+   * @returns A layout factory scoped to the selected resources.
+   */
+  <const ResourceKeys extends readonly [LayoutResourceKey<Resources>, ...Array<LayoutResourceKey<Resources>>]>(...resources: ResourceKeys): ScopedCreateResourceLayoutFn<Resources, InProps, Composables, ResourceKeys, CustomProps>;
+  /**
+   * Creates a layout factory scoped to a resource list without default names.
+   *
+   * @example
+   * createResourceLayout.forResources({ resources: ['users', 'admins'] })
+   *
+   * @param options The resources to expose without configured default names.
+   * @returns A layout factory scoped to the selected resources.
+   */
+  <const ResourceKeys extends ReadonlyArray<LayoutResourceKey<Resources>>>(options: {
+    resources: ResourceKeys;
+    name?: never;
+  }): ScopedCreateResourceLayoutFn<Resources, InProps, Composables, readonly [{
+    resources: ResourceKeys;
+  }], CustomProps>;
+  /**
+   * Creates a scoped layout factory with optional default names per resource.
+   *
+   * Each map key is limited to the resources selected in `resources`. Values
+   * can be strings or callbacks receiving that resource's capitalized name.
+   *
+   * @example
+   * createResourceLayout.forResources({
+   *   resources: ['users', 'admins'],
+   *   name: {
+   *     users: resource => `${resource}Page`,
+   *     admins: 'AdminDirectory',
+   *   },
+   * })
+   *
+   * @param options The selected resources and their optional default names.
+   * @returns A layout factory scoped to the selected resources.
+   */
+  <const ResourceKeys extends ReadonlyArray<LayoutResourceKey<Resources>>, const CallbackName extends string, const Names>(options: {
+    resources: ResourceKeys;
+    name: SelectedResourceLayoutNames<LayoutResourceKey<Resources>, NoInfer<ResourceKeys[number]>, CallbackName> & AtLeastOneResourceLayoutNameKey<NoInfer<ResourceKeys[number]>> & Record<string, NonNullable<ResourceLayoutNames<LayoutResourceKey<Resources>, CallbackName>[LayoutResourceKey<Resources>]>>;
+  } & {
+    name: Names & Record<Exclude<keyof Names, ResourceKeys[number]>, never>;
+  }): ScopedCreateResourceLayoutFn<Resources, InProps, Composables, MappedResourceLayoutArguments<Resources, ResourceKeys, Names, CallbackName>, CustomProps>;
+  /**
+   * Creates a scoped layout factory with one default-name callback shared by
+   * every selected resource. The callback receives a capitalized resource
+   * whose `toLowerCase()` result retains the corresponding literal type.
+   *
+   * @example
+   * createResourceLayout.forResources({
+   *   resources: ['users', 'admins'],
+   *   name: resource => `${resource}Page`,
+   * })
+   *
+   * @param options The selected resources and shared default-name callback.
+   * @returns A layout factory scoped to the selected resources.
+   */
+  <const ResourceKeys extends ReadonlyArray<LayoutResourceKey<Resources>>, const Name extends string>(options: {
+    resources: ReadonlyArray<LayoutResourceKey<Resources>>;
+    name: (resource: CapitalizedResource<ResourceKeys[number]>) => Name;
+  } & {
+    resources: ResourceKeys;
+  }): ScopedCreateResourceLayoutFn<Resources, InProps, Composables, SharedResourceLayoutArguments<Resources, ResourceKeys, Name>, CustomProps>;
+  /**
+   * Creates a scoped layout factory from a resource-keyed configuration.
+   * Only configured resources are available from the returned factory.
+   *
+   * @example
+   * createResourceLayout.forResources({
+   *   users: { name: resource => `${resource}Page` },
+   *   admins: { name: 'AdminDirectory' },
+   * })
+   *
+   * @param options Resource-keyed layout defaults.
+   * @returns A layout factory scoped to the configured resources.
+   */
+  <const CallbackName extends string, const Selection extends ResourceLayoutSelection<Resources, CallbackName>>(options: Selection & AtLeastOneResourceLayoutSelection<Resources, CallbackName> & Partial<Record<Exclude<'resources', LayoutResourceKey<Resources>>, never>> & Record<Exclude<keyof Selection, LayoutResourceKey<Resources>>, never>): ScopedCreateResourceLayoutFn<Resources, InProps, Composables, SelectedResourceLayoutArguments<Selection>, CustomProps>;
+};
+//#endregion
+export { CreateResourceLayoutForResourcesFn };
+//# sourceMappingURL=scoped-layout.d.cts.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,185 @@
+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 { LayoutIncludeProps, LayoutPropsForResource, ResourceLayoutComponent } from "../define-layout.mjs";
+import { ComposableComponents, ComposableResourceLayout } from "@jfdevelops/react-layout-composables";
+
+//#region src/create-config/for-resources/scoped-layout.d.ts
+type ScopedCreateResourceLayoutOptions<Resources extends ReadonlyArray<ResourceDefinition>, InProps extends InPropsDefinition<Resources>, Composables extends ComposableComponents, Arguments extends ReadonlyArray<unknown>, Name extends string, Resource extends SelectedLayoutResources<Resources, Arguments>, Props extends InPropsObject> = LayoutPropsForResource<Resources, InProps, Composables> & {
+  resource: Resource;
+  props?: Props;
+} & (HasResourceLayoutName<Arguments, Resource> extends true ? {
+  name?: Name;
+} : {
+  name: Name;
+});
+type ScopedCreateResourceLayoutFnImpl<Resources extends ReadonlyArray<ResourceDefinition>, InProps extends InPropsDefinition<Resources>, Composables extends ComposableComponents, Arguments extends ReadonlyArray<unknown>, CustomProps extends InPropsObject> = <Resource extends SelectedLayoutResources<Resources, Arguments>, Name extends string = SelectedResourceLayoutName<Arguments, Resource>, Props extends InPropsObject = {}>(options: ScopedCreateResourceLayoutOptions<Resources, InProps, Composables, Arguments, Name, Resource, Props>) => ResourceLayoutComponent<Name, CustomProps, Composables, Resource>;
+type ScopedCreateLayoutForResource<Resources extends ReadonlyArray<ResourceDefinition>, InProps extends InPropsDefinition<Resources>, Composables extends ComposableComponents, Arguments extends ReadonlyArray<unknown>, CustomProps extends InPropsObject> = <Resource extends SelectedLayoutResources<Resources, Arguments>, Name extends string = SelectedResourceLayoutName<Arguments, Resource>>(options: CreateLayoutForResourceOptions<Resources, Name, Resource>) => CreatedLayoutForResource<Resources, InProps, Composables, Name, Resource, CustomProps> & {
+  setDefaults: SetDefaultPropForResourceFn<Resources, InProps, Composables, Name, Resource, CustomProps>;
+};
+type ScopedCreateResourceLayoutMakeComposableFn<Resources extends ReadonlyArray<ResourceDefinition>, InProps extends InPropsDefinition<Resources>, Composables extends ComposableComponents, Arguments extends ReadonlyArray<unknown>> = <Resource extends SelectedLayoutResources<Resources, Arguments>, Name extends string = SelectedResourceLayoutName<Arguments, Resource>, Props extends InPropsObject = {}>(options: Omit<CreateResourceLayoutOptionsBase<Resources, Name, Resource>, 'name'> & Partial<LayoutPropsForResource<Resources, InProps, Composables>> & {
+  props?: Props;
+} & (HasResourceLayoutName<Arguments, Resource> extends true ? {
+  name?: Name;
+} : {
+  name: Name;
+})) => ComposableResourceLayout<Composables, Name, any, any, any>;
+type ScopedCreateResourceLayoutFn<Resources extends ReadonlyArray<ResourceDefinition>, InProps extends InPropsDefinition<Resources>, Composables extends ComposableComponents, Arguments extends ReadonlyArray<unknown>, CustomProps extends InPropsObject> = ScopedCreateResourceLayoutFnImpl<Resources, InProps, Composables, Arguments, CustomProps> & {
+  /**
+   * Creates a component shared by the target resources. Included layout props
+   * become component props, and `children` is always available as an optional
+   * prop in both the render callback and at the call site.
+   *
+   * Each key of `resources` holds that resource's scoped `components` and
+   * `render`. Layout option values like `title` are call-site props on
+   * `context.<Resource>` / the outer component — not fields on the entry.
+   * The render context exposes `Root` and one capitalized component per key
+   * present in `resources`.
+   *
+   * Each entry may also declare `components` — components scoped to that
+   * resource, available to the entry's own `render`, on `context.<Resource>`,
+   * and on the component returned by `asHOF()`.
+   *
+   * @example
+   * const Directory = createDirectoryLayout.createComponent({
+   *   props: { include: { title: true, actions: 'optional' } },
+   *   resources: {
+   *     users: {
+   *       components: {
+   *         Toolbar: { render: ({ title }) => <nav>{title}</nav> },
+   *       },
+   *       render: ({ resource }, components) => (
+   *         <>
+   *           <components.Toolbar />
+   *           <span>{resource}</span>
+   *         </>
+   *       ),
+   *     },
+   *     admins: {
+   *       render: ({ resource }) => <span>{resource}</span>,
+   *     },
+   *   },
+   *   render: ({ actions, children, resource }, context) => (
+   *     <context.Root actions={actions}>
+   *       {children}
+   *       {resource === 'users' ? (
+   *         <context.Users title="Users" />
+   *       ) : (
+   *         <context.Admins title="Admins" />
+   *       )}
+   *       <context.Users.Toolbar />
+   *     </context.Root>
+   *   ),
+   * })
+   *
+   * <Directory resource='users' title='Users' />
+   *
+   * @param options The props configuration, per-resource entries, and the
+   * shared component render function.
+   * @returns A component scoped to the selected resources.
+   */
+  createComponent: ScopedCreateComponent<Resources, InProps, Composables, Arguments, CustomProps>;
+  forResource: ScopedCreateLayoutForResource<Resources, InProps, Composables, Arguments, CustomProps>;
+  /**
+   * Type-only property containing the target resource union. This property is
+   * `undefined` at runtime and exists solely for extracting the scoped type.
+   *
+   * @example
+   * type AccountResource = typeof createAccountLayout.resources;
+   */
+  readonly resources: SelectedLayoutResources<Resources, Arguments>;
+} & ([keyof Composables] extends [never] ? {} : {
+  makeComposable: ScopedCreateResourceLayoutMakeComposableFn<Resources, InProps, Composables, Arguments>;
+});
+type CreateResourceLayoutForResourcesFn<Resources extends ReadonlyArray<ResourceDefinition>, InProps extends InPropsDefinition<Resources>, Composables extends ComposableComponents = {}, IncludeProps extends LayoutIncludeProps<Resources, InProps, Composables> = {}, CustomProps extends InPropsObject = {}> = {
+  /**
+   * Creates a layout factory scoped to the listed resources.
+   *
+   * Layout names must be supplied when a layout is created.
+   *
+   * @example
+   * createResourceLayout.forResources('users', 'admins')
+   *
+   * @param resources Resources available from the returned layout factory.
+   * @returns A layout factory scoped to the selected resources.
+   */
+  <const ResourceKeys extends readonly [LayoutResourceKey<Resources>, ...Array<LayoutResourceKey<Resources>>]>(...resources: ResourceKeys): ScopedCreateResourceLayoutFn<Resources, InProps, Composables, ResourceKeys, CustomProps>;
+  /**
+   * Creates a layout factory scoped to a resource list without default names.
+   *
+   * @example
+   * createResourceLayout.forResources({ resources: ['users', 'admins'] })
+   *
+   * @param options The resources to expose without configured default names.
+   * @returns A layout factory scoped to the selected resources.
+   */
+  <const ResourceKeys extends ReadonlyArray<LayoutResourceKey<Resources>>>(options: {
+    resources: ResourceKeys;
+    name?: never;
+  }): ScopedCreateResourceLayoutFn<Resources, InProps, Composables, readonly [{
+    resources: ResourceKeys;
+  }], CustomProps>;
+  /**
+   * Creates a scoped layout factory with optional default names per resource.
+   *
+   * Each map key is limited to the resources selected in `resources`. Values
+   * can be strings or callbacks receiving that resource's capitalized name.
+   *
+   * @example
+   * createResourceLayout.forResources({
+   *   resources: ['users', 'admins'],
+   *   name: {
+   *     users: resource => `${resource}Page`,
+   *     admins: 'AdminDirectory',
+   *   },
+   * })
+   *
+   * @param options The selected resources and their optional default names.
+   * @returns A layout factory scoped to the selected resources.
+   */
+  <const ResourceKeys extends ReadonlyArray<LayoutResourceKey<Resources>>, const CallbackName extends string, const Names>(options: {
+    resources: ResourceKeys;
+    name: SelectedResourceLayoutNames<LayoutResourceKey<Resources>, NoInfer<ResourceKeys[number]>, CallbackName> & AtLeastOneResourceLayoutNameKey<NoInfer<ResourceKeys[number]>> & Record<string, NonNullable<ResourceLayoutNames<LayoutResourceKey<Resources>, CallbackName>[LayoutResourceKey<Resources>]>>;
+  } & {
+    name: Names & Record<Exclude<keyof Names, ResourceKeys[number]>, never>;
+  }): ScopedCreateResourceLayoutFn<Resources, InProps, Composables, MappedResourceLayoutArguments<Resources, ResourceKeys, Names, CallbackName>, CustomProps>;
+  /**
+   * Creates a scoped layout factory with one default-name callback shared by
+   * every selected resource. The callback receives a capitalized resource
+   * whose `toLowerCase()` result retains the corresponding literal type.
+   *
+   * @example
+   * createResourceLayout.forResources({
+   *   resources: ['users', 'admins'],
+   *   name: resource => `${resource}Page`,
+   * })
+   *
+   * @param options The selected resources and shared default-name callback.
+   * @returns A layout factory scoped to the selected resources.
+   */
+  <const ResourceKeys extends ReadonlyArray<LayoutResourceKey<Resources>>, const Name extends string>(options: {
+    resources: ReadonlyArray<LayoutResourceKey<Resources>>;
+    name: (resource: CapitalizedResource<ResourceKeys[number]>) => Name;
+  } & {
+    resources: ResourceKeys;
+  }): ScopedCreateResourceLayoutFn<Resources, InProps, Composables, SharedResourceLayoutArguments<Resources, ResourceKeys, Name>, CustomProps>;
+  /**
+   * Creates a scoped layout factory from a resource-keyed configuration.
+   * Only configured resources are available from the returned factory.
+   *
+   * @example
+   * createResourceLayout.forResources({
+   *   users: { name: resource => `${resource}Page` },
+   *   admins: { name: 'AdminDirectory' },
+   * })
+   *
+   * @param options Resource-keyed layout defaults.
+   * @returns A layout factory scoped to the configured resources.
+   */
+  <const CallbackName extends string, const Selection extends ResourceLayoutSelection<Resources, CallbackName>>(options: Selection & AtLeastOneResourceLayoutSelection<Resources, CallbackName> & Partial<Record<Exclude<'resources', LayoutResourceKey<Resources>>, never>> & Record<Exclude<keyof Selection, LayoutResourceKey<Resources>>, never>): ScopedCreateResourceLayoutFn<Resources, InProps, Composables, SelectedResourceLayoutArguments<Selection>, CustomProps>;
+};
+//#endregion
+export { CreateResourceLayoutForResourcesFn };
+//# sourceMappingURL=scoped-layout.d.mts.map

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

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

package/dist/create-config/for-resources/scoped-render.cjs

@@ -0,0 +1,103 @@
+let react = require("react");
+
+//#region src/create-config/for-resources/scoped-render.ts
+/**
+* Names a scoped component cannot use. Scoped components are attached to
+* function objects, so they collide with the component's own statics and with
+* non-writable `Function.prototype` properties. `__proto__` is reserved so
+* assignment cannot hit the prototype setter on a normal object.
+*/
+const reservedScopedComponentNames = new Set([
+	"__proto__",
+	"apply",
+	"arguments",
+	"bind",
+	"call",
+	"caller",
+	"displayName",
+	"length",
+	"name",
+	"props",
+	"prototype",
+	"resource"
+]);
+/**
+* `$$typeof` tags for object component wrappers that `createElement` accepts
+* as `type` (forwardRef, memo, lazy).
+*
+* Do not treat "any object with `$$typeof`" as a component: portals also have
+* `$$typeof` (`Symbol.for('react.portal')`) and `isValidElement(portal)` is
+* false, so a naive check would mis-classify them.
+*/
+const reactForwardRefType = Symbol.for("react.forward_ref");
+const reactMemoType = Symbol.for("react.memo");
+const reactLazyType = Symbol.for("react.lazy");
+/**
+* True when `value` can be passed as the `type` argument to `createElement`.
+*
+* Functions always qualify. Object wrappers qualify only for the forwardRef /
+* memo / lazy tags above — not portals or other React nodes that happen to
+* carry `$$typeof`.
+*/
+function isRenderableComponentType(value) {
+	if (typeof value === "function") return true;
+	if (typeof value !== "object" || value === null || Array.isArray(value) || (0, react.isValidElement)(value) || !("$$typeof" in value)) return false;
+	const typeTag = value.$$typeof;
+	return typeTag === reactForwardRefType || typeTag === reactMemoType || typeTag === reactLazyType;
+}
+/**
+* If `render` returned a component type, mount it with `props`; otherwise
+* return the node as-is (elements, portals, null, etc.).
+*/
+function resolveScopedRenderResult(result, props = {}) {
+	if (isRenderableComponentType(result)) return (0, react.createElement)(result, props);
+	return result;
+}
+/**
+* Runtime counterpart of `ScopedComponentCompoundStaticKey` — keys that must
+* not be treated as compound component statics on a scoped wrapper.
+*/
+const reservedScopedCompoundStaticKeys = new Set([
+	"apply",
+	"arguments",
+	"bind",
+	"call",
+	"caller",
+	"childContextTypes",
+	"contextTypes",
+	"defaultProps",
+	"displayName",
+	"length",
+	"name",
+	"propTypes",
+	"prototype",
+	"toLocaleString",
+	"toString",
+	"valueOf",
+	"$$typeof"
+]);
+/**
+* Exposes compound statics (e.g. `DataTable.Loading`) on a scoped wrapper so
+* runtime matches `ScopedComponentCompoundStatics`.
+*
+* Why a Proxy: JSX reads `components.DataTable.Loading` while building the
+* element tree — before `DataTable` itself renders — so statics cannot be
+* copied only after the first `render` call. Property access lazily creates a
+* stable wrapper component that re-runs the scoped `render` under context and
+* mounts the matching static from the returned component type.
+*/
+function withScopedCompoundStatics(wrapper, createCompoundStatic) {
+	return new Proxy(wrapper, { get(target, property, receiver) {
+		if (typeof property === "symbol" || reservedScopedCompoundStaticKeys.has(property) || property in target) return Reflect.get(target, property, receiver);
+		const CompoundStatic = createCompoundStatic(property);
+		target[property] = CompoundStatic;
+		return CompoundStatic;
+	} });
+}
+
+//#endregion
+exports.isRenderableComponentType = isRenderableComponentType;
+exports.reservedScopedComponentNames = reservedScopedComponentNames;
+exports.resolveScopedRenderResult = resolveScopedRenderResult;
+exports.withScopedCompoundStatics = withScopedCompoundStatics;
+//# sourceMappingURL=scoped-render.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scoped-render.cjs","names":[],"sources":["../../../src/create-config/for-resources/scoped-render.ts"],"sourcesContent":["import {\n  createElement,\n  isValidElement,\n  type ComponentType,\n  type JSX,\n  type ReactNode,\n} from 'react';\n\n/**\n * Names a scoped component cannot use. Scoped components are attached to\n * function objects, so they collide with the component's own statics and with\n * non-writable `Function.prototype` properties. `__proto__` is reserved so\n * assignment cannot hit the prototype setter on a normal object.\n */\nexport const reservedScopedComponentNames = new Set([\n  '__proto__',\n  'apply',\n  'arguments',\n  'bind',\n  'call',\n  'caller',\n  'displayName',\n  'length',\n  'name',\n  'props',\n  'prototype',\n  'resource',\n]);\n\n/**\n * Values a createComponent / scoped-component `render` may return.\n *\n * Alongside rendered nodes, a component type is allowed — the type constituent\n * of a React element — so factories like `createDataTable(columns)` can be\n * returned directly and mounted with the call-site props.\n *\n * At runtime, `resolveScopedRenderResult` distinguishes component types from\n * nodes (including portals). Getting that wrong mounts a portal via\n * `createElement` and blows up with an invalid-element-type error.\n */\n// Returned components declare their own props; a concrete props parameter would\n// be contravariant and reject the factories callers actually return.\n// eslint-disable-next-line @typescript-eslint/no-explicit-any -- see above\nexport type ScopedRenderResult = ReactNode | ComponentType<any>;\n\n/**\n * `$$typeof` tags for object component wrappers that `createElement` accepts\n * as `type` (forwardRef, memo, lazy).\n *\n * Do not treat \"any object with `$$typeof`\" as a component: portals also have\n * `$$typeof` (`Symbol.for('react.portal')`) and `isValidElement(portal)` is\n * false, so a naive check would mis-classify them.\n */\nconst reactForwardRefType = Symbol.for('react.forward_ref');\nconst reactMemoType = Symbol.for('react.memo');\nconst reactLazyType = Symbol.for('react.lazy');\n\n/**\n * True when `value` can be passed as the `type` argument to `createElement`.\n *\n * Functions always qualify. Object wrappers qualify only for the forwardRef /\n * memo / lazy tags above — not portals or other React nodes that happen to\n * carry `$$typeof`.\n */\nexport function isRenderableComponentType(\n  value: unknown,\n): value is ComponentType<Record<string, unknown>> {\n  if (typeof value === 'function') {\n    return true;\n  }\n\n  if (\n    typeof value !== 'object' ||\n    value === null ||\n    Array.isArray(value) ||\n    isValidElement(value) ||\n    !('$$typeof' in value)\n  ) {\n    return false;\n  }\n\n  const typeTag = (value as { $$typeof: unknown }).$$typeof;\n\n  return (\n    typeTag === reactForwardRefType ||\n    typeTag === reactMemoType ||\n    typeTag === reactLazyType\n  );\n}\n\n/**\n * If `render` returned a component type, mount it with `props`; otherwise\n * return the node as-is (elements, portals, null, etc.).\n */\nexport function resolveScopedRenderResult(\n  result: ScopedRenderResult,\n  props: Record<string, unknown> = {},\n): JSX.Element {\n  if (isRenderableComponentType(result)) {\n    return createElement(result, props);\n  }\n\n  return result as JSX.Element;\n}\n\n/**\n * Runtime counterpart of `ScopedComponentCompoundStaticKey` — keys that must\n * not be treated as compound component statics on a scoped wrapper.\n */\nconst reservedScopedCompoundStaticKeys = new Set<PropertyKey>([\n  'apply',\n  'arguments',\n  'bind',\n  'call',\n  'caller',\n  'childContextTypes',\n  'contextTypes',\n  'defaultProps',\n  'displayName',\n  'length',\n  'name',\n  'propTypes',\n  'prototype',\n  'toLocaleString',\n  'toString',\n  'valueOf',\n  '$$typeof',\n]);\n\ntype ScopedComponentWrapper = ((\n  props?: Record<string, unknown>,\n) => JSX.Element) &\n  Record<string, unknown>;\n\n/**\n * Exposes compound statics (e.g. `DataTable.Loading`) on a scoped wrapper so\n * runtime matches `ScopedComponentCompoundStatics`.\n *\n * Why a Proxy: JSX reads `components.DataTable.Loading` while building the\n * element tree — before `DataTable` itself renders — so statics cannot be\n * copied only after the first `render` call. Property access lazily creates a\n * stable wrapper component that re-runs the scoped `render` under context and\n * mounts the matching static from the returned component type.\n */\nexport function withScopedCompoundStatics(\n  wrapper: (props?: Record<string, unknown>) => JSX.Element,\n  createCompoundStatic: (\n    staticName: string,\n  ) => (ownProps?: Record<string, unknown>) => JSX.Element,\n): ScopedComponentWrapper {\n  return new Proxy(wrapper as ScopedComponentWrapper, {\n    get(target, property, receiver) {\n      if (\n        typeof property === 'symbol' ||\n        reservedScopedCompoundStaticKeys.has(property) ||\n        property in target\n      ) {\n        return Reflect.get(target, property, receiver);\n      }\n\n      // Cache on the target so repeated `.Loading` access keeps one identity.\n      const CompoundStatic = createCompoundStatic(property);\n      target[property] = CompoundStatic;\n      return CompoundStatic;\n    },\n  });\n}\n"],"mappings":";;;;;;;;;AAcA,MAAa,+BAA+B,IAAI,IAAI;CAClD;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;;;;;;;;;AA0BD,MAAM,sBAAsB,OAAO,IAAI,mBAAmB;AAC1D,MAAM,gBAAgB,OAAO,IAAI,YAAY;AAC7C,MAAM,gBAAgB,OAAO,IAAI,YAAY;;;;;;;;AAS7C,SAAgB,0BACd,OACiD;CACjD,IAAI,OAAO,UAAU,YACnB,OAAO;CAGT,IACE,OAAO,UAAU,YACjB,UAAU,QACV,MAAM,QAAQ,KAAK,+BACJ,KAAK,KACpB,EAAE,cAAc,QAEhB,OAAO;CAGT,MAAM,UAAW,MAAgC;CAEjD,OACE,YAAY,uBACZ,YAAY,iBACZ,YAAY;AAEhB;;;;;AAMA,SAAgB,0BACd,QACA,QAAiC,CAAC,GACrB;CACb,IAAI,0BAA0B,MAAM,GAClC,gCAAqB,QAAQ,KAAK;CAGpC,OAAO;AACT;;;;;AAMA,MAAM,mCAAmC,IAAI,IAAiB;CAC5D;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;;;;;;;;;;;AAiBD,SAAgB,0BACd,SACA,sBAGwB;CACxB,OAAO,IAAI,MAAM,SAAmC,EAClD,IAAI,QAAQ,UAAU,UAAU;EAC9B,IACE,OAAO,aAAa,YACpB,iCAAiC,IAAI,QAAQ,KAC7C,YAAY,QAEZ,OAAO,QAAQ,IAAI,QAAQ,UAAU,QAAQ;EAI/C,MAAM,iBAAiB,qBAAqB,QAAQ;EACpD,OAAO,YAAY;EACnB,OAAO;CACT,EACF,CAAC;AACH"}

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

@@ -0,0 +1,18 @@
+import { ComponentType, JSX, ReactNode } from "react";
+
+//#region src/create-config/for-resources/scoped-render.d.ts
+/**
+ * Values a createComponent / scoped-component `render` may return.
+ *
+ * Alongside rendered nodes, a component type is allowed — the type constituent
+ * of a React element — so factories like `createDataTable(columns)` can be
+ * returned directly and mounted with the call-site props.
+ *
+ * At runtime, `resolveScopedRenderResult` distinguishes component types from
+ * nodes (including portals). Getting that wrong mounts a portal via
+ * `createElement` and blows up with an invalid-element-type error.
+ */
+type ScopedRenderResult = ReactNode | ComponentType<any>;
+//#endregion
+export { ScopedRenderResult };
+//# sourceMappingURL=scoped-render.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scoped-render.d.cts","names":[],"sources":["../../../src/create-config/for-resources/scoped-render.ts"],"mappings":";;;;;;;;;;;;;;KA2CY,kBAAA,GAAqB,SAAA,GAAY,aAAa"}

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

@@ -0,0 +1,18 @@
+import { ComponentType, JSX, ReactNode } from "react";
+
+//#region src/create-config/for-resources/scoped-render.d.ts
+/**
+ * Values a createComponent / scoped-component `render` may return.
+ *
+ * Alongside rendered nodes, a component type is allowed — the type constituent
+ * of a React element — so factories like `createDataTable(columns)` can be
+ * returned directly and mounted with the call-site props.
+ *
+ * At runtime, `resolveScopedRenderResult` distinguishes component types from
+ * nodes (including portals). Getting that wrong mounts a portal via
+ * `createElement` and blows up with an invalid-element-type error.
+ */
+type ScopedRenderResult = ReactNode | ComponentType<any>;
+//#endregion
+export { ScopedRenderResult };
+//# sourceMappingURL=scoped-render.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scoped-render.d.mts","names":[],"sources":["../../../src/create-config/for-resources/scoped-render.ts"],"mappings":";;;;;;;;;;;;;;KA2CY,kBAAA,GAAqB,SAAA,GAAY,aAAa"}