@jfdevelops/react-layout 0.2.0 → 0.3.0

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

@@ -0,0 +1,144 @@
+const require_utils = require('../utils.cjs');
+const require_composable = require('../composable.cjs');
+const require_builders = require('../validators/builders.cjs');
+const require_validate_props = require('../validators/validate-props.cjs');
+const require_resource = require('../resource.cjs');
+const require_capitalize = require('../utils/capitalize.cjs');
+const require_get_component = require('./get-component.cjs');
+let react_jsx_runtime = require("react/jsx-runtime");
+
+//#region src/create-config/define-layout.tsx
+function isBuiltPropDefinition(value) {
+	return typeof value === "function" && value !== null && "visibility" in value;
+}
+function isSplitLayoutInPropDefinition(value) {
+	return value !== null && typeof value === "object" && "render" in value && value.render !== void 0;
+}
+function isJSXElementDefinition(definition) {
+	return isBuiltPropDefinition(definition) && "type" in definition && definition.type === "JSX.Element";
+}
+function toLayoutRenderPropKey(includeKey, definition) {
+	return isJSXElementDefinition(definition) ? require_capitalize.capitalize(includeKey) : includeKey;
+}
+function readLayoutOptionValue(includeKey, definition, sources) {
+	const layoutOptionKeys = isJSXElementDefinition(definition) ? [require_capitalize.capitalize(includeKey), includeKey] : [includeKey, require_capitalize.capitalize(includeKey)];
+	for (const key of layoutOptionKeys) if (key in sources) return sources[key];
+}
+function splitLayoutInProps(inProps) {
+	const resolvedInProps = {};
+	const splitInProps = {};
+	for (const [key, value] of Object.entries(inProps)) {
+		if (isBuiltPropDefinition(value)) {
+			resolvedInProps[key] = value;
+			continue;
+		}
+		if (isSplitLayoutInPropDefinition(value)) {
+			splitInProps[key] = value.render;
+			if (value.props && typeof value.props === "object") Object.assign(resolvedInProps, value.props);
+		}
+	}
+	return {
+		resolvedInProps,
+		splitInProps
+	};
+}
+function resolveLayoutOptionDefaults(defaults, options) {
+	const resolved = { ...options };
+	for (const [key, defaultValue] of Object.entries(defaults)) if (key in options) if (typeof defaultValue === "function") resolved[key] = options[key];
+	else resolved[key] = require_utils.functionalUpdate(defaultValue, options[key]);
+	return resolved;
+}
+function defineResourceLayout(options) {
+	const { options: inProps, resources, layout } = options;
+	const normalizedResources = require_resource.normalizeResources(resources);
+	const resourcesEnum = require_builders.createPrimitivePropBuilder("string").enum(require_resource.toResourceEnum(normalizedResources));
+	const definedResourceLayout = (layoutOptions) => {
+		const { name, props: instancePropDefinitions, ...layoutOptionProps } = layoutOptions;
+		const createComposableLayout = require_composable.makeComposable();
+		const nameProp = require_builders.createProp.string().literal(name);
+		const { resolvedInProps, splitInProps } = splitLayoutInProps({
+			...typeof inProps === "function" ? inProps({
+				resource: resourcesEnum,
+				name: nameProp
+			}) : inProps,
+			...instancePropDefinitions,
+			...layoutOptionProps
+		});
+		const { composables, render, props: layoutProps } = layout;
+		const customLayoutProps = layoutProps?.custom;
+		const includeLayoutProps = layoutProps?.include;
+		const resolvedLayoutProps = { ...customLayoutProps };
+		const layoutContext = {
+			resource: layoutOptions.resource,
+			name,
+			capitalize: require_capitalize.capitalize
+		};
+		const resolvedComposables = composables ? require_composable.resolveLayoutComposables(composables, layoutContext) : void 0;
+		const mergedRenderContext = {
+			composables: resolvedComposables,
+			resource: layoutContext.resource,
+			name: layoutContext.name,
+			inProps: splitInProps
+		};
+		function Component(props) {
+			const validatedProps = require_validate_props.validateProps(resolvedLayoutProps, props);
+			const includedPropKeys = Object.keys(includeLayoutProps ?? {});
+			const includedPropDefinitions = require_utils.pick(resolvedInProps, includedPropKeys);
+			const includedPropValues = { ...require_utils.resolvePropDefinitionValues(includedPropDefinitions) };
+			for (const key of includedPropKeys) {
+				const definition = resolvedInProps[key];
+				const layoutOptionValue = readLayoutOptionValue(key, definition, layoutOptionProps);
+				const splitValue = key in splitInProps ? splitInProps[key] : void 0;
+				const value = layoutOptionValue ?? splitValue;
+				if (value !== void 0) includedPropValues[key] = value;
+			}
+			const validatedIncludedProps = require_validate_props.validateProps(includedPropDefinitions, includedPropValues);
+			const layoutRenderIncludedProps = Object.fromEntries(includedPropKeys.flatMap((key) => {
+				if (!(key in validatedIncludedProps)) return [];
+				return [[toLayoutRenderPropKey(key, resolvedInProps[key]), validatedIncludedProps[key]]];
+			}));
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_jsx_runtime.Fragment, { children: render({
+				...validatedProps,
+				...layoutRenderIncludedProps
+			}, mergedRenderContext) });
+		}
+		function createComposition(compositionOptions) {
+			if (!compositionOptions.components) return {};
+			return { makeComposable: createComposableLayout(compositionOptions) };
+		}
+		return Object.assign(Component, {
+			displayName: name,
+			props: void 0,
+			...createComposition({
+				components: resolvedComposables,
+				name
+			})
+		});
+	};
+	function createLayoutForResource(defaultName, resource, defaults) {
+		return (({ name, ...rest }) => definedResourceLayout({
+			...defaults,
+			name: name ?? defaultName,
+			resource,
+			...resolveLayoutOptionDefaults(defaults, rest)
+		}));
+	}
+	function createLayoutForResourceBuilder(defaultName, resource) {
+		const createLayout = createLayoutForResource(defaultName, resource, {});
+		const setDefaults = ((defaults) => createLayoutForResource(defaultName, resource, defaults));
+		return Object.assign(createLayout, { setDefaults });
+	}
+	const forResource = (options) => {
+		const { name: defaultName, resource } = options;
+		if (!resource) throw new Error("\"resource\" is required when calling \"forResource\"");
+		return createLayoutForResourceBuilder(defaultName, resource);
+	};
+	return {
+		createResourceConfig: require_get_component.createResourceConfig,
+		createResourceLayout: Object.assign(definedResourceLayout, { forResource })
+	};
+}
+
+//#endregion
+exports.defineResourceLayout = defineResourceLayout;
+//# sourceMappingURL=define-layout.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"define-layout.cjs","names":["capitalize","functionalUpdate","normalizeResources","createPrimitivePropBuilder","toResourceEnum","makeComposable","createProp","resolveLayoutComposables","validateProps","pick","resolvePropDefinitionValues"],"sources":["../../src/create-config/define-layout.tsx"],"sourcesContent":["import type { JSX } from 'react';\nimport {\n  type ComposableComponents,\n  type ComposableNameContext,\n  type CreateLayoutComposable,\n  MakeComposable,\n  makeComposable,\n  MakeComposableOptions,\n  resolveLayoutComposables,\n} from '../composable';\nimport {\n  type AnyBuiltPropDefinition,\n  createPrimitivePropBuilder,\n  createProp,\n  type ResolveLayoutProps,\n  type ResolveProps,\n  validateProps,\n} from '../validators';\nimport {\n  IncludedProps,\n  InferredInProps,\n  InPropsDefinition,\n  InPropsObject,\n  LayoutRenderProps,\n} from '../props';\nimport {\n  normalizeResources,\n  toResourceEnum,\n  type LayoutResourceKey,\n  type ResourceDefinition,\n} from '../resource';\nimport {\n  BaseComponent,\n  functionalUpdate,\n  pick,\n  resolvePropDefinitionValues,\n  Show,\n  Updater,\n} from '../utils';\nimport { capitalize } from '../utils/capitalize';\nimport {\n  type CreateResourceConfigFn,\n  createResourceConfig,\n} from './get-component';\n\ntype LayoutProps<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  IncludeProps extends IncludedProps<InferredInProps<Resources, Options>> = {},\n  CustomProps extends InPropsObject = {},\n> = {\n  /**\n   * Props to include in the layout.\n   */\n  include?: IncludeProps;\n  /**\n   * Custom props that the layout will receive.\n   */\n  custom?: CustomProps;\n};\n\ntype LayoutRenderContext<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Composables extends ComposableComponents,\n> = {\n  composables: LayoutRenderComposables<Composables>;\n  inProps: Record<string, unknown>;\n  resource: LayoutResourceKey<Resources>;\n  name: string;\n};\ntype LayoutRenderComposables<Composables extends ComposableComponents> = [\n  keyof Composables,\n] extends [never]\n  ? undefined\n  : Composables;\n\ntype SplitLayoutInPropDefinition<\n  Props extends InPropsObject = {},\n  Content = unknown,\n> = {\n  props?: Props;\n  render: ((props: ResolveProps<Props>) => Content) | Content;\n};\n\nfunction isBuiltPropDefinition(\n  value: unknown,\n): value is AnyBuiltPropDefinition {\n  return typeof value === 'function' && value !== null && 'visibility' in value;\n}\n\nfunction isSplitLayoutInPropDefinition(\n  value: unknown,\n): value is SplitLayoutInPropDefinition {\n  return (\n    value !== null &&\n    typeof value === 'object' &&\n    'render' in value &&\n    (value as { render?: unknown }).render !== undefined\n  );\n}\n\nfunction isJSXElementDefinition(\n  definition: unknown,\n): definition is AnyBuiltPropDefinition & { type: 'JSX.Element' } {\n  return (\n    isBuiltPropDefinition(definition) &&\n    'type' in definition &&\n    definition.type === 'JSX.Element'\n  );\n}\n\nfunction toLayoutRenderPropKey(\n  includeKey: string,\n  definition: unknown,\n) {\n  return isJSXElementDefinition(definition)\n    ? capitalize(includeKey)\n    : includeKey;\n}\n\nfunction readLayoutOptionValue(\n  includeKey: string,\n  definition: unknown,\n  sources: Record<string, unknown>,\n) {\n  const layoutOptionKeys = isJSXElementDefinition(definition)\n    ? [capitalize(includeKey), includeKey]\n    : [includeKey, capitalize(includeKey)];\n\n  for (const key of layoutOptionKeys) {\n    if (key in sources) {\n      return sources[key];\n    }\n  }\n\n  return undefined;\n}\n\nfunction splitLayoutInProps(inProps: Record<string, unknown>) {\n  const resolvedInProps: Record<string, AnyBuiltPropDefinition> = {};\n  const splitInProps: Record<string, unknown> = {};\n\n  for (const [key, value] of Object.entries(inProps)) {\n    if (isBuiltPropDefinition(value)) {\n      resolvedInProps[key] = value;\n      continue;\n    }\n\n    if (isSplitLayoutInPropDefinition(value)) {\n      splitInProps[key] = value.render;\n\n      if (value.props && typeof value.props === 'object') {\n        Object.assign(resolvedInProps, value.props);\n      }\n    }\n  }\n\n  return {\n    resolvedInProps,\n    splitInProps,\n  };\n}\n\nfunction resolveLayoutOptionDefaults(\n  defaults: Record<string, unknown>,\n  options: Record<string, unknown>,\n) {\n  const resolved = { ...options };\n\n  for (const [key, defaultValue] of Object.entries(defaults)) {\n    if (key in options) {\n      if (typeof defaultValue === 'function') {\n        resolved[key] = options[key];\n      } else {\n        resolved[key] = functionalUpdate(\n          defaultValue,\n          options[key] as Updater<unknown>,\n        );\n      }\n    }\n  }\n\n  return resolved;\n}\n\ntype CreateViewMapOptions<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  IncludeProps extends IncludedProps<InferredInProps<Resources, Options>> = {},\n  CustomProps extends InPropsObject = {},\n  Composables extends ComposableComponents = {},\n> = {\n  /**\n   * An array of valid resource names to support.\n   */\n  resources: Resources;\n  /**\n   * The options that are passed into the created resource layout.\n   */\n  options: Options;\n  layout: {\n    /**\n     * The props to pass to the layout.\n     */\n    props?: LayoutProps<Resources, Options, IncludeProps, CustomProps>;\n    /**\n     * Components used to compose the layout. Invoked per layout instance with\n     * a scoped `create` that resolves composable `name` callbacks using the\n     * layout's `resource` and `name`.\n     */\n    composables?: (\n      create: CreateLayoutComposable<LayoutResourceKey<Resources>>,\n    ) => Composables;\n    /**\n     * The render function for the layout.\n     */\n    render: (\n      props: LayoutRenderProps<Resources, Options, IncludeProps, CustomProps>,\n      context: LayoutRenderContext<Resources, Composables>,\n    ) => JSX.Element;\n  };\n};\n\ntype ResourceLayoutComposition<\n  Name extends string,\n  Composables extends ComposableComponents,\n> = [keyof Composables] extends [never]\n  ? {}\n  : {\n      makeComposable: MakeComposable<Composables, Name>;\n    };\ntype ResourceLayoutComponent<\n  Name extends string,\n  Props extends InPropsObject = {},\n  Composables extends ComposableComponents = {},\n> = ResourceLayoutComposition<Name, Composables> &\n  BaseComponent<Name, ResolveProps<Props>> & {\n    (props: Show<ResolveProps<Props>>): JSX.Element;\n  };\n\ntype LayoutPropDefaults = Record<string, unknown>;\n\ntype LayoutPropsForResource<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  InProps extends InPropsDefinition<Resources>,\n> = ResolveLayoutProps<InferredInProps<Resources, InProps>>;\n\ntype CreateTimeLayoutPropWithDefault<\n  LayoutProps extends LayoutPropDefaults,\n  K extends keyof LayoutProps,\n> = LayoutProps[K] extends (...args: unknown[]) => unknown\n  ? LayoutProps[K]\n  : Updater<LayoutProps[K]>;\n\ntype ResolveLayoutPropsWithDefaults<\n  LayoutProps extends LayoutPropDefaults,\n  Defaults extends LayoutPropDefaults,\n> = Omit<LayoutProps, keyof Defaults> & {\n  [K in keyof Defaults & keyof LayoutProps]?: CreateTimeLayoutPropWithDefault<\n    LayoutProps,\n    K\n  >;\n};\n\ntype CreateResourceLayoutOptions<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  InProps extends InPropsDefinition<Resources>,\n  Name extends string,\n  Resource extends LayoutResourceKey<Resources>,\n  Props extends InPropsObject = {},\n> = LayoutPropsForResource<Resources, InProps> & {\n  name: Name;\n  resource: Resource;\n  props?: Props;\n};\ntype CreateLayoutForResourceOptions<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Name extends string,\n  Resource extends LayoutResourceKey<Resources>,\n> = {\n  name?: Name;\n  resource: Resource;\n};\ntype CreatedLayoutForResourceOptions<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  InProps extends InPropsDefinition<Resources>,\n  Props extends InPropsObject = {},\n  Defaults extends LayoutPropDefaults = {},\n> = ResolveLayoutPropsWithDefaults<\n  LayoutPropsForResource<Resources, InProps>,\n  Defaults\n> & {\n  props?: Props;\n};\ntype CreatedLayoutForResource<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  InProps extends InPropsDefinition<Resources>,\n  Name extends string,\n  Resource extends LayoutResourceKey<Resources>,\n  CustomProps extends InPropsObject = {},\n  Composables extends ComposableComponents = {},\n  Defaults extends LayoutPropDefaults = {},\n> = <OverrideName extends string = Name, Props extends InPropsObject = {}>(\n  options: CreatedLayoutForResourceOptions<\n    Resources,\n    InProps,\n    Props,\n    Defaults\n  > & {\n    name?: OverrideName;\n  },\n) => ResourceLayoutComponent<OverrideName, CustomProps, Composables>;\n\ntype SetDefaultPropsForResource<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  InProps extends InPropsDefinition<Resources>,\n> = Partial<LayoutPropsForResource<Resources, InProps>>;\n\ntype ResolvedSetDefaultProps<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  InProps extends InPropsDefinition<Resources>,\n  Defaults extends SetDefaultPropsForResource<Resources, InProps>,\n> = {\n  [K in keyof Defaults &\n    keyof LayoutPropsForResource<Resources, InProps>]: LayoutPropsForResource<\n    Resources,\n    InProps\n  >[K];\n};\n\ntype SetDefaultPropForResourceFn<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  InProps extends InPropsDefinition<Resources>,\n  Name extends string,\n  Resource extends LayoutResourceKey<Resources>,\n  CustomProps extends InPropsObject = {},\n  Composables extends ComposableComponents = {},\n> = <const Defaults extends SetDefaultPropsForResource<Resources, InProps>>(\n  /**\n   * Default values for layout props. Each prop can only be set once.\n   */\n  defaults: Defaults,\n) => CreatedLayoutForResource<\n  Resources,\n  InProps,\n  Name,\n  Resource,\n  CustomProps,\n  Composables,\n  ResolvedSetDefaultProps<Resources, InProps, Defaults>\n>;\n\ntype CreateLayoutForResource<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  InProps extends InPropsDefinition<Resources>,\n  IncludeProps extends IncludedProps<InferredInProps<Resources, InProps>> = {},\n  CustomProps extends InPropsObject = {},\n  Composables extends ComposableComponents = {},\n> = <Name extends string, Resource extends LayoutResourceKey<Resources>>(\n  options: CreateLayoutForResourceOptions<Resources, Name, Resource>,\n) => CreatedLayoutForResource<\n  Resources,\n  InProps,\n  Name,\n  Resource,\n  CustomProps,\n  Composables\n> & {\n  /**\n   * Set default values for layout props in a single call.\n   */\n  setDefaults: SetDefaultPropForResourceFn<\n    Resources,\n    InProps,\n    Name,\n    Resource,\n    CustomProps,\n    Composables\n  >;\n};\ntype CreateResourceLayoutFnImpl<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  InProps extends InPropsDefinition<Resources>,\n  IncludeProps extends IncludedProps<InferredInProps<Resources, InProps>> = {},\n  CustomProps extends InPropsObject = {},\n  Composables extends ComposableComponents = {},\n> = <\n  Name extends string,\n  Resource extends LayoutResourceKey<Resources>,\n  Props extends InPropsObject = {},\n>(\n  options: CreateResourceLayoutOptions<\n    Resources,\n    InProps,\n    Name,\n    Resource,\n    Props\n  >,\n) => ResourceLayoutComponent<Name, CustomProps, Composables>;\nexport interface CreateResourceLayoutFn<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  InProps extends InPropsDefinition<Resources>,\n  IncludeProps extends IncludedProps<InferredInProps<Resources, InProps>> = {},\n  CustomProps extends InPropsObject = {},\n  Composables extends ComposableComponents = {},\n> extends CreateResourceLayoutFnImpl<\n  Resources,\n  InProps,\n  IncludeProps,\n  CustomProps,\n  Composables\n> {\n  /**\n   * A function to create a resource layout for a specific resource.\n   */\n  forResource: CreateLayoutForResource<\n    Resources,\n    InProps,\n    IncludeProps,\n    CustomProps,\n    Composables\n  >;\n}\n\ntype DefinedResourceLayout<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  InProps extends InPropsDefinition<Resources>,\n  IncludeProps extends IncludedProps<InferredInProps<Resources, InProps>> = {},\n  CustomProps extends InPropsObject = {},\n  Composables extends ComposableComponents = {},\n> = {\n  createResourceConfig: CreateResourceConfigFn<Resources>;\n  createResourceLayout: CreateResourceLayoutFn<\n    Resources,\n    InProps,\n    IncludeProps,\n    CustomProps,\n    Composables\n  >;\n};\n\nexport function defineResourceLayout<\n  const Resources extends ReadonlyArray<ResourceDefinition>,\n  InProps extends InPropsDefinition<Resources>,\n  IncludeProps extends IncludedProps<InferredInProps<Resources, InProps>> = {},\n  CustomProps extends InPropsObject = {},\n  Composables extends ComposableComponents = {},\n>(\n  options: CreateViewMapOptions<\n    Resources,\n    InProps,\n    IncludeProps,\n    CustomProps,\n    Composables\n  >,\n) {\n  const { options: inProps, resources, layout } = options;\n  const normalizedResources = normalizeResources(resources);\n  const resourcesEnum = createPrimitivePropBuilder('string').enum(\n    toResourceEnum(normalizedResources),\n  );\n  const definedResourceLayout: CreateResourceLayoutFnImpl<\n    Resources,\n    InProps,\n    IncludeProps,\n    CustomProps,\n    Composables\n  > = (layoutOptions) => {\n    const {\n      name,\n      props: instancePropDefinitions,\n      ...layoutOptionProps\n    } = layoutOptions;\n    const createComposableLayout =\n      makeComposable<\n        LayoutRenderProps<Resources, InProps, IncludeProps, CustomProps>\n      >();\n    const nameProp = createProp.string().literal(name);\n    const rawResolvedOptions =\n      typeof inProps === 'function'\n        ? inProps({\n            resource: resourcesEnum,\n            name: nameProp,\n          })\n        : inProps;\n    const { resolvedInProps, splitInProps } = splitLayoutInProps({\n      ...(rawResolvedOptions as Record<string, unknown>),\n      ...(instancePropDefinitions as Record<string, unknown> | undefined),\n      ...layoutOptionProps,\n    });\n    const { composables, render, props: layoutProps } = layout;\n    const customLayoutProps = layoutProps?.custom;\n    const includeLayoutProps = layoutProps?.include;\n    const resolvedLayoutProps = {\n      ...customLayoutProps,\n    };\n    const layoutContext: ComposableNameContext<\n      LayoutResourceKey<Resources>,\n      typeof name\n    > = {\n      resource: layoutOptions.resource,\n      name,\n      capitalize,\n    };\n    const resolvedComposables = composables\n      ? resolveLayoutComposables(composables, layoutContext)\n      : undefined;\n    const mergedRenderContext = {\n      composables: resolvedComposables as LayoutRenderComposables<Composables>,\n      resource: layoutContext.resource,\n      name: layoutContext.name,\n      inProps: splitInProps,\n    } as LayoutRenderContext<Resources, Composables>;\n\n    function Component(props: Show<ResolveProps<CustomProps>>) {\n      const validatedProps = validateProps(resolvedLayoutProps, props);\n      const includedPropKeys = Object.keys(includeLayoutProps ?? {});\n      const includedPropDefinitions = pick(\n        resolvedInProps,\n        includedPropKeys,\n      ) as Record<string, unknown>;\n      const includedPropValues = {\n        ...resolvePropDefinitionValues(includedPropDefinitions),\n      } as Record<string, unknown>;\n\n      for (const key of includedPropKeys) {\n        const definition = resolvedInProps[key];\n        const layoutOptionValue = readLayoutOptionValue(\n          key,\n          definition,\n          layoutOptionProps,\n        );\n        const splitValue = key in splitInProps ? splitInProps[key] : undefined;\n        const value = layoutOptionValue ?? splitValue;\n\n        if (value !== undefined) {\n          includedPropValues[key] = value;\n        }\n      }\n\n      const validatedIncludedProps = validateProps(\n        includedPropDefinitions as Record<string, AnyBuiltPropDefinition>,\n        includedPropValues,\n      );\n      const layoutRenderIncludedProps = Object.fromEntries(\n        includedPropKeys.flatMap((key) => {\n          if (!(key in validatedIncludedProps)) {\n            return [];\n          }\n\n          return [\n            [\n              toLayoutRenderPropKey(key, resolvedInProps[key]),\n              validatedIncludedProps[key as keyof typeof validatedIncludedProps],\n            ],\n          ];\n        }),\n      );\n      const layoutRenderProps = {\n        ...validatedProps,\n        ...layoutRenderIncludedProps,\n      } as unknown as LayoutRenderProps<\n        Resources,\n        InProps,\n        IncludeProps,\n        CustomProps\n      >;\n\n      return <>{render(layoutRenderProps, mergedRenderContext)}</>;\n    }\n\n    function createComposition<LayoutName extends string>(\n      compositionOptions: MakeComposableOptions<Composables, LayoutName>,\n    ) {\n      if (!compositionOptions.components) {\n        return {} as ResourceLayoutComposition<LayoutName, Composables>;\n      }\n\n      return {\n        makeComposable: createComposableLayout(compositionOptions),\n      };\n    }\n\n    return Object.assign(Component, {\n      displayName: name,\n      props: undefined as unknown as ResolveProps<CustomProps>,\n      ...createComposition({\n        components: resolvedComposables as Composables | undefined,\n        name,\n      }),\n    });\n  };\n  function createLayoutForResource<\n    Name extends string,\n    Resource extends LayoutResourceKey<Resources>,\n    Defaults extends LayoutPropDefaults,\n  >(\n    defaultName: Name | undefined,\n    resource: Resource,\n    defaults: Record<string, unknown>,\n  ) {\n    return (({ name, ...rest }) =>\n      definedResourceLayout({\n        ...defaults,\n        name: name ?? defaultName,\n        resource,\n        ...resolveLayoutOptionDefaults(defaults, rest),\n      } as never) as never) as CreatedLayoutForResource<\n      Resources,\n      InProps,\n      Name,\n      Resource,\n      CustomProps,\n      Composables,\n      Defaults\n    >;\n  }\n\n  function createLayoutForResourceBuilder<\n    Name extends string,\n    Resource extends LayoutResourceKey<Resources>,\n  >(\n    defaultName: Name | undefined,\n    resource: Resource,\n  ): CreatedLayoutForResource<\n    Resources,\n    InProps,\n    Name,\n    Resource,\n    CustomProps,\n    Composables\n  > & {\n    setDefaults: SetDefaultPropForResourceFn<\n      Resources,\n      InProps,\n      Name,\n      Resource,\n      CustomProps,\n      Composables\n    >;\n  } {\n    const createLayout = createLayoutForResource(defaultName, resource, {});\n\n    const setDefaults = ((defaults) =>\n      createLayoutForResource(defaultName, resource, defaults)) as SetDefaultPropForResourceFn<\n      Resources,\n      InProps,\n      Name,\n      Resource,\n      CustomProps,\n      Composables\n    >;\n\n    return Object.assign(createLayout, { setDefaults });\n  }\n  const forResource: CreateLayoutForResource<\n    Resources,\n    InProps,\n    IncludeProps,\n    CustomProps,\n    Composables\n  > = (options) => {\n    const { name: defaultName, resource } = options;\n\n    if (!resource) {\n      throw new Error('\"resource\" is required when calling \"forResource\"');\n    }\n\n    return createLayoutForResourceBuilder(defaultName, resource);\n  };\n  const createResourceLayout: CreateResourceLayoutFn<\n    Resources,\n    InProps,\n    IncludeProps,\n    CustomProps,\n    Composables\n  > = Object.assign(definedResourceLayout, {\n    forResource,\n  });\n\n  return {\n    createResourceConfig,\n    createResourceLayout,\n  } as DefinedResourceLayout<\n    Resources,\n    InProps,\n    IncludeProps,\n    CustomProps,\n    Composables\n  >;\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,106 @@
+import { ResolveLayoutProps, ResolveProps } from "../validators/types.cjs";
+import { BaseComponent, Show, Updater } from "../utils.cjs";
+import { LayoutResourceKey, ResourceDefinition } from "../resource.cjs";
+import { InPropsDefinition, InPropsObject, IncludedProps, InferredInProps, LayoutRenderProps } from "../props.cjs";
+import { ComposableComponents, CreateLayoutComposable, MakeComposable } from "../composable.cjs";
+import { CreateResourceConfigFn } from "./get-component.cjs";
+import { JSX } from "react";
+
+//#region src/create-config/define-layout.d.ts
+type LayoutProps<Resources extends ReadonlyArray<ResourceDefinition>, Options extends InPropsDefinition<Resources>, IncludeProps extends IncludedProps<InferredInProps<Resources, Options>> = {}, CustomProps extends InPropsObject = {}> = {
+  /**
+   * Props to include in the layout.
+   */
+  include?: IncludeProps;
+  /**
+   * Custom props that the layout will receive.
+   */
+  custom?: CustomProps;
+};
+type LayoutRenderContext<Resources extends ReadonlyArray<ResourceDefinition>, Composables extends ComposableComponents> = {
+  composables: LayoutRenderComposables<Composables>;
+  inProps: Record<string, unknown>;
+  resource: LayoutResourceKey<Resources>;
+  name: string;
+};
+type LayoutRenderComposables<Composables extends ComposableComponents> = [keyof Composables] extends [never] ? undefined : Composables;
+type CreateViewMapOptions<Resources extends ReadonlyArray<ResourceDefinition>, Options extends InPropsDefinition<Resources>, IncludeProps extends IncludedProps<InferredInProps<Resources, Options>> = {}, CustomProps extends InPropsObject = {}, Composables extends ComposableComponents = {}> = {
+  /**
+   * An array of valid resource names to support.
+   */
+  resources: Resources;
+  /**
+   * The options that are passed into the created resource layout.
+   */
+  options: Options;
+  layout: {
+    /**
+     * The props to pass to the layout.
+     */
+    props?: LayoutProps<Resources, Options, IncludeProps, CustomProps>;
+    /**
+     * Components used to compose the layout. Invoked per layout instance with
+     * a scoped `create` that resolves composable `name` callbacks using the
+     * layout's `resource` and `name`.
+     */
+    composables?: (create: CreateLayoutComposable<LayoutResourceKey<Resources>>) => Composables;
+    /**
+     * The render function for the layout.
+     */
+    render: (props: LayoutRenderProps<Resources, Options, IncludeProps, CustomProps>, context: LayoutRenderContext<Resources, Composables>) => JSX.Element;
+  };
+};
+type ResourceLayoutComposition<Name extends string, Composables extends ComposableComponents> = [keyof Composables] extends [never] ? {} : {
+  makeComposable: MakeComposable<Composables, Name>;
+};
+type ResourceLayoutComponent<Name extends string, Props extends InPropsObject = {}, Composables extends ComposableComponents = {}> = ResourceLayoutComposition<Name, Composables> & BaseComponent<Name, ResolveProps<Props>> & {
+  (props: Show<ResolveProps<Props>>): JSX.Element;
+};
+type LayoutPropDefaults = Record<string, unknown>;
+type LayoutPropsForResource<Resources extends ReadonlyArray<ResourceDefinition>, InProps extends InPropsDefinition<Resources>> = ResolveLayoutProps<InferredInProps<Resources, InProps>>;
+type CreateTimeLayoutPropWithDefault<LayoutProps extends LayoutPropDefaults, K extends keyof LayoutProps> = LayoutProps[K] extends ((...args: unknown[]) => unknown) ? LayoutProps[K] : Updater<LayoutProps[K]>;
+type ResolveLayoutPropsWithDefaults<LayoutProps extends LayoutPropDefaults, Defaults extends LayoutPropDefaults> = Omit<LayoutProps, keyof Defaults> & { [K in keyof Defaults & keyof LayoutProps]?: CreateTimeLayoutPropWithDefault<LayoutProps, K> };
+type CreateResourceLayoutOptions<Resources extends ReadonlyArray<ResourceDefinition>, InProps extends InPropsDefinition<Resources>, Name extends string, Resource extends LayoutResourceKey<Resources>, Props extends InPropsObject = {}> = LayoutPropsForResource<Resources, InProps> & {
+  name: Name;
+  resource: Resource;
+  props?: Props;
+};
+type CreateLayoutForResourceOptions<Resources extends ReadonlyArray<ResourceDefinition>, Name extends string, Resource extends LayoutResourceKey<Resources>> = {
+  name?: Name;
+  resource: Resource;
+};
+type CreatedLayoutForResourceOptions<Resources extends ReadonlyArray<ResourceDefinition>, InProps extends InPropsDefinition<Resources>, Props extends InPropsObject = {}, Defaults extends LayoutPropDefaults = {}> = ResolveLayoutPropsWithDefaults<LayoutPropsForResource<Resources, InProps>, Defaults> & {
+  props?: Props;
+};
+type CreatedLayoutForResource<Resources extends ReadonlyArray<ResourceDefinition>, InProps extends InPropsDefinition<Resources>, Name extends string, Resource extends LayoutResourceKey<Resources>, CustomProps extends InPropsObject = {}, Composables extends ComposableComponents = {}, Defaults extends LayoutPropDefaults = {}> = <OverrideName extends string = Name, Props extends InPropsObject = {}>(options: CreatedLayoutForResourceOptions<Resources, InProps, Props, Defaults> & {
+  name?: OverrideName;
+}) => ResourceLayoutComponent<OverrideName, CustomProps, Composables>;
+type SetDefaultPropsForResource<Resources extends ReadonlyArray<ResourceDefinition>, InProps extends InPropsDefinition<Resources>> = Partial<LayoutPropsForResource<Resources, InProps>>;
+type ResolvedSetDefaultProps<Resources extends ReadonlyArray<ResourceDefinition>, InProps extends InPropsDefinition<Resources>, Defaults extends SetDefaultPropsForResource<Resources, InProps>> = { [K in keyof Defaults & keyof LayoutPropsForResource<Resources, InProps>]: LayoutPropsForResource<Resources, InProps>[K] };
+type SetDefaultPropForResourceFn<Resources extends ReadonlyArray<ResourceDefinition>, InProps extends InPropsDefinition<Resources>, Name extends string, Resource extends LayoutResourceKey<Resources>, CustomProps extends InPropsObject = {}, Composables extends ComposableComponents = {}> = <const Defaults extends SetDefaultPropsForResource<Resources, InProps>>(
+/**
+ * Default values for layout props. Each prop can only be set once.
+ */
+
+defaults: Defaults) => CreatedLayoutForResource<Resources, InProps, Name, Resource, CustomProps, Composables, ResolvedSetDefaultProps<Resources, InProps, Defaults>>;
+type CreateLayoutForResource<Resources extends ReadonlyArray<ResourceDefinition>, InProps extends InPropsDefinition<Resources>, IncludeProps extends IncludedProps<InferredInProps<Resources, InProps>> = {}, CustomProps extends InPropsObject = {}, Composables extends ComposableComponents = {}> = <Name extends string, Resource extends LayoutResourceKey<Resources>>(options: CreateLayoutForResourceOptions<Resources, Name, Resource>) => CreatedLayoutForResource<Resources, InProps, Name, Resource, CustomProps, Composables> & {
+  /**
+   * Set default values for layout props in a single call.
+   */
+  setDefaults: SetDefaultPropForResourceFn<Resources, InProps, Name, Resource, CustomProps, Composables>;
+};
+type CreateResourceLayoutFnImpl<Resources extends ReadonlyArray<ResourceDefinition>, InProps extends InPropsDefinition<Resources>, IncludeProps extends IncludedProps<InferredInProps<Resources, InProps>> = {}, CustomProps extends InPropsObject = {}, Composables extends ComposableComponents = {}> = <Name extends string, Resource extends LayoutResourceKey<Resources>, Props extends InPropsObject = {}>(options: CreateResourceLayoutOptions<Resources, InProps, Name, Resource, Props>) => ResourceLayoutComponent<Name, CustomProps, Composables>;
+interface CreateResourceLayoutFn<Resources extends ReadonlyArray<ResourceDefinition>, InProps extends InPropsDefinition<Resources>, IncludeProps extends IncludedProps<InferredInProps<Resources, InProps>> = {}, CustomProps extends InPropsObject = {}, Composables extends ComposableComponents = {}> extends CreateResourceLayoutFnImpl<Resources, InProps, IncludeProps, CustomProps, Composables> {
+  /**
+   * A function to create a resource layout for a specific resource.
+   */
+  forResource: CreateLayoutForResource<Resources, InProps, IncludeProps, CustomProps, Composables>;
+}
+type DefinedResourceLayout<Resources extends ReadonlyArray<ResourceDefinition>, InProps extends InPropsDefinition<Resources>, IncludeProps extends IncludedProps<InferredInProps<Resources, InProps>> = {}, CustomProps extends InPropsObject = {}, Composables extends ComposableComponents = {}> = {
+  createResourceConfig: CreateResourceConfigFn<Resources>;
+  createResourceLayout: CreateResourceLayoutFn<Resources, InProps, IncludeProps, CustomProps, Composables>;
+};
+declare function defineResourceLayout<const Resources extends ReadonlyArray<ResourceDefinition>, InProps extends InPropsDefinition<Resources>, IncludeProps extends IncludedProps<InferredInProps<Resources, InProps>> = {}, CustomProps extends InPropsObject = {}, Composables extends ComposableComponents = {}>(options: CreateViewMapOptions<Resources, InProps, IncludeProps, CustomProps, Composables>): DefinedResourceLayout<Resources, InProps, IncludeProps, CustomProps, Composables>;
+//#endregion
+export { CreateResourceLayoutFn, defineResourceLayout };
+//# sourceMappingURL=define-layout.d.cts.map

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

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

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

@@ -0,0 +1,106 @@
+import { ResolveLayoutProps, ResolveProps } from "../validators/types.mjs";
+import { BaseComponent, Show, Updater } from "../utils.mjs";
+import { LayoutResourceKey, ResourceDefinition } from "../resource.mjs";
+import { InPropsDefinition, InPropsObject, IncludedProps, InferredInProps, LayoutRenderProps } from "../props.mjs";
+import { ComposableComponents, CreateLayoutComposable, MakeComposable } from "../composable.mjs";
+import { CreateResourceConfigFn } from "./get-component.mjs";
+import { JSX } from "react";
+
+//#region src/create-config/define-layout.d.ts
+type LayoutProps<Resources extends ReadonlyArray<ResourceDefinition>, Options extends InPropsDefinition<Resources>, IncludeProps extends IncludedProps<InferredInProps<Resources, Options>> = {}, CustomProps extends InPropsObject = {}> = {
+  /**
+   * Props to include in the layout.
+   */
+  include?: IncludeProps;
+  /**
+   * Custom props that the layout will receive.
+   */
+  custom?: CustomProps;
+};
+type LayoutRenderContext<Resources extends ReadonlyArray<ResourceDefinition>, Composables extends ComposableComponents> = {
+  composables: LayoutRenderComposables<Composables>;
+  inProps: Record<string, unknown>;
+  resource: LayoutResourceKey<Resources>;
+  name: string;
+};
+type LayoutRenderComposables<Composables extends ComposableComponents> = [keyof Composables] extends [never] ? undefined : Composables;
+type CreateViewMapOptions<Resources extends ReadonlyArray<ResourceDefinition>, Options extends InPropsDefinition<Resources>, IncludeProps extends IncludedProps<InferredInProps<Resources, Options>> = {}, CustomProps extends InPropsObject = {}, Composables extends ComposableComponents = {}> = {
+  /**
+   * An array of valid resource names to support.
+   */
+  resources: Resources;
+  /**
+   * The options that are passed into the created resource layout.
+   */
+  options: Options;
+  layout: {
+    /**
+     * The props to pass to the layout.
+     */
+    props?: LayoutProps<Resources, Options, IncludeProps, CustomProps>;
+    /**
+     * Components used to compose the layout. Invoked per layout instance with
+     * a scoped `create` that resolves composable `name` callbacks using the
+     * layout's `resource` and `name`.
+     */
+    composables?: (create: CreateLayoutComposable<LayoutResourceKey<Resources>>) => Composables;
+    /**
+     * The render function for the layout.
+     */
+    render: (props: LayoutRenderProps<Resources, Options, IncludeProps, CustomProps>, context: LayoutRenderContext<Resources, Composables>) => JSX.Element;
+  };
+};
+type ResourceLayoutComposition<Name extends string, Composables extends ComposableComponents> = [keyof Composables] extends [never] ? {} : {
+  makeComposable: MakeComposable<Composables, Name>;
+};
+type ResourceLayoutComponent<Name extends string, Props extends InPropsObject = {}, Composables extends ComposableComponents = {}> = ResourceLayoutComposition<Name, Composables> & BaseComponent<Name, ResolveProps<Props>> & {
+  (props: Show<ResolveProps<Props>>): JSX.Element;
+};
+type LayoutPropDefaults = Record<string, unknown>;
+type LayoutPropsForResource<Resources extends ReadonlyArray<ResourceDefinition>, InProps extends InPropsDefinition<Resources>> = ResolveLayoutProps<InferredInProps<Resources, InProps>>;
+type CreateTimeLayoutPropWithDefault<LayoutProps extends LayoutPropDefaults, K extends keyof LayoutProps> = LayoutProps[K] extends ((...args: unknown[]) => unknown) ? LayoutProps[K] : Updater<LayoutProps[K]>;
+type ResolveLayoutPropsWithDefaults<LayoutProps extends LayoutPropDefaults, Defaults extends LayoutPropDefaults> = Omit<LayoutProps, keyof Defaults> & { [K in keyof Defaults & keyof LayoutProps]?: CreateTimeLayoutPropWithDefault<LayoutProps, K> };
+type CreateResourceLayoutOptions<Resources extends ReadonlyArray<ResourceDefinition>, InProps extends InPropsDefinition<Resources>, Name extends string, Resource extends LayoutResourceKey<Resources>, Props extends InPropsObject = {}> = LayoutPropsForResource<Resources, InProps> & {
+  name: Name;
+  resource: Resource;
+  props?: Props;
+};
+type CreateLayoutForResourceOptions<Resources extends ReadonlyArray<ResourceDefinition>, Name extends string, Resource extends LayoutResourceKey<Resources>> = {
+  name?: Name;
+  resource: Resource;
+};
+type CreatedLayoutForResourceOptions<Resources extends ReadonlyArray<ResourceDefinition>, InProps extends InPropsDefinition<Resources>, Props extends InPropsObject = {}, Defaults extends LayoutPropDefaults = {}> = ResolveLayoutPropsWithDefaults<LayoutPropsForResource<Resources, InProps>, Defaults> & {
+  props?: Props;
+};
+type CreatedLayoutForResource<Resources extends ReadonlyArray<ResourceDefinition>, InProps extends InPropsDefinition<Resources>, Name extends string, Resource extends LayoutResourceKey<Resources>, CustomProps extends InPropsObject = {}, Composables extends ComposableComponents = {}, Defaults extends LayoutPropDefaults = {}> = <OverrideName extends string = Name, Props extends InPropsObject = {}>(options: CreatedLayoutForResourceOptions<Resources, InProps, Props, Defaults> & {
+  name?: OverrideName;
+}) => ResourceLayoutComponent<OverrideName, CustomProps, Composables>;
+type SetDefaultPropsForResource<Resources extends ReadonlyArray<ResourceDefinition>, InProps extends InPropsDefinition<Resources>> = Partial<LayoutPropsForResource<Resources, InProps>>;
+type ResolvedSetDefaultProps<Resources extends ReadonlyArray<ResourceDefinition>, InProps extends InPropsDefinition<Resources>, Defaults extends SetDefaultPropsForResource<Resources, InProps>> = { [K in keyof Defaults & keyof LayoutPropsForResource<Resources, InProps>]: LayoutPropsForResource<Resources, InProps>[K] };
+type SetDefaultPropForResourceFn<Resources extends ReadonlyArray<ResourceDefinition>, InProps extends InPropsDefinition<Resources>, Name extends string, Resource extends LayoutResourceKey<Resources>, CustomProps extends InPropsObject = {}, Composables extends ComposableComponents = {}> = <const Defaults extends SetDefaultPropsForResource<Resources, InProps>>(
+/**
+ * Default values for layout props. Each prop can only be set once.
+ */
+
+defaults: Defaults) => CreatedLayoutForResource<Resources, InProps, Name, Resource, CustomProps, Composables, ResolvedSetDefaultProps<Resources, InProps, Defaults>>;
+type CreateLayoutForResource<Resources extends ReadonlyArray<ResourceDefinition>, InProps extends InPropsDefinition<Resources>, IncludeProps extends IncludedProps<InferredInProps<Resources, InProps>> = {}, CustomProps extends InPropsObject = {}, Composables extends ComposableComponents = {}> = <Name extends string, Resource extends LayoutResourceKey<Resources>>(options: CreateLayoutForResourceOptions<Resources, Name, Resource>) => CreatedLayoutForResource<Resources, InProps, Name, Resource, CustomProps, Composables> & {
+  /**
+   * Set default values for layout props in a single call.
+   */
+  setDefaults: SetDefaultPropForResourceFn<Resources, InProps, Name, Resource, CustomProps, Composables>;
+};
+type CreateResourceLayoutFnImpl<Resources extends ReadonlyArray<ResourceDefinition>, InProps extends InPropsDefinition<Resources>, IncludeProps extends IncludedProps<InferredInProps<Resources, InProps>> = {}, CustomProps extends InPropsObject = {}, Composables extends ComposableComponents = {}> = <Name extends string, Resource extends LayoutResourceKey<Resources>, Props extends InPropsObject = {}>(options: CreateResourceLayoutOptions<Resources, InProps, Name, Resource, Props>) => ResourceLayoutComponent<Name, CustomProps, Composables>;
+interface CreateResourceLayoutFn<Resources extends ReadonlyArray<ResourceDefinition>, InProps extends InPropsDefinition<Resources>, IncludeProps extends IncludedProps<InferredInProps<Resources, InProps>> = {}, CustomProps extends InPropsObject = {}, Composables extends ComposableComponents = {}> extends CreateResourceLayoutFnImpl<Resources, InProps, IncludeProps, CustomProps, Composables> {
+  /**
+   * A function to create a resource layout for a specific resource.
+   */
+  forResource: CreateLayoutForResource<Resources, InProps, IncludeProps, CustomProps, Composables>;
+}
+type DefinedResourceLayout<Resources extends ReadonlyArray<ResourceDefinition>, InProps extends InPropsDefinition<Resources>, IncludeProps extends IncludedProps<InferredInProps<Resources, InProps>> = {}, CustomProps extends InPropsObject = {}, Composables extends ComposableComponents = {}> = {
+  createResourceConfig: CreateResourceConfigFn<Resources>;
+  createResourceLayout: CreateResourceLayoutFn<Resources, InProps, IncludeProps, CustomProps, Composables>;
+};
+declare function defineResourceLayout<const Resources extends ReadonlyArray<ResourceDefinition>, InProps extends InPropsDefinition<Resources>, IncludeProps extends IncludedProps<InferredInProps<Resources, InProps>> = {}, CustomProps extends InPropsObject = {}, Composables extends ComposableComponents = {}>(options: CreateViewMapOptions<Resources, InProps, IncludeProps, CustomProps, Composables>): DefinedResourceLayout<Resources, InProps, IncludeProps, CustomProps, Composables>;
+//#endregion
+export { CreateResourceLayoutFn, defineResourceLayout };
+//# sourceMappingURL=define-layout.d.mts.map

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

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

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

@@ -0,0 +1,144 @@
+import { functionalUpdate, pick, resolvePropDefinitionValues } from "../utils.mjs";
+import { makeComposable, resolveLayoutComposables } from "../composable.mjs";
+import { createPrimitivePropBuilder, createProp } from "../validators/builders.mjs";
+import { validateProps } from "../validators/validate-props.mjs";
+import { normalizeResources, toResourceEnum } from "../resource.mjs";
+import { capitalize } from "../utils/capitalize.mjs";
+import { createResourceConfig } from "./get-component.mjs";
+import { Fragment, jsx } from "react/jsx-runtime";
+
+//#region src/create-config/define-layout.tsx
+function isBuiltPropDefinition(value) {
+	return typeof value === "function" && value !== null && "visibility" in value;
+}
+function isSplitLayoutInPropDefinition(value) {
+	return value !== null && typeof value === "object" && "render" in value && value.render !== void 0;
+}
+function isJSXElementDefinition(definition) {
+	return isBuiltPropDefinition(definition) && "type" in definition && definition.type === "JSX.Element";
+}
+function toLayoutRenderPropKey(includeKey, definition) {
+	return isJSXElementDefinition(definition) ? capitalize(includeKey) : includeKey;
+}
+function readLayoutOptionValue(includeKey, definition, sources) {
+	const layoutOptionKeys = isJSXElementDefinition(definition) ? [capitalize(includeKey), includeKey] : [includeKey, capitalize(includeKey)];
+	for (const key of layoutOptionKeys) if (key in sources) return sources[key];
+}
+function splitLayoutInProps(inProps) {
+	const resolvedInProps = {};
+	const splitInProps = {};
+	for (const [key, value] of Object.entries(inProps)) {
+		if (isBuiltPropDefinition(value)) {
+			resolvedInProps[key] = value;
+			continue;
+		}
+		if (isSplitLayoutInPropDefinition(value)) {
+			splitInProps[key] = value.render;
+			if (value.props && typeof value.props === "object") Object.assign(resolvedInProps, value.props);
+		}
+	}
+	return {
+		resolvedInProps,
+		splitInProps
+	};
+}
+function resolveLayoutOptionDefaults(defaults, options) {
+	const resolved = { ...options };
+	for (const [key, defaultValue] of Object.entries(defaults)) if (key in options) if (typeof defaultValue === "function") resolved[key] = options[key];
+	else resolved[key] = functionalUpdate(defaultValue, options[key]);
+	return resolved;
+}
+function defineResourceLayout(options) {
+	const { options: inProps, resources, layout } = options;
+	const normalizedResources = normalizeResources(resources);
+	const resourcesEnum = createPrimitivePropBuilder("string").enum(toResourceEnum(normalizedResources));
+	const definedResourceLayout = (layoutOptions) => {
+		const { name, props: instancePropDefinitions, ...layoutOptionProps } = layoutOptions;
+		const createComposableLayout = makeComposable();
+		const nameProp = createProp.string().literal(name);
+		const { resolvedInProps, splitInProps } = splitLayoutInProps({
+			...typeof inProps === "function" ? inProps({
+				resource: resourcesEnum,
+				name: nameProp
+			}) : inProps,
+			...instancePropDefinitions,
+			...layoutOptionProps
+		});
+		const { composables, render, props: layoutProps } = layout;
+		const customLayoutProps = layoutProps?.custom;
+		const includeLayoutProps = layoutProps?.include;
+		const resolvedLayoutProps = { ...customLayoutProps };
+		const layoutContext = {
+			resource: layoutOptions.resource,
+			name,
+			capitalize
+		};
+		const resolvedComposables = composables ? resolveLayoutComposables(composables, layoutContext) : void 0;
+		const mergedRenderContext = {
+			composables: resolvedComposables,
+			resource: layoutContext.resource,
+			name: layoutContext.name,
+			inProps: splitInProps
+		};
+		function Component(props) {
+			const validatedProps = validateProps(resolvedLayoutProps, props);
+			const includedPropKeys = Object.keys(includeLayoutProps ?? {});
+			const includedPropDefinitions = pick(resolvedInProps, includedPropKeys);
+			const includedPropValues = { ...resolvePropDefinitionValues(includedPropDefinitions) };
+			for (const key of includedPropKeys) {
+				const definition = resolvedInProps[key];
+				const layoutOptionValue = readLayoutOptionValue(key, definition, layoutOptionProps);
+				const splitValue = key in splitInProps ? splitInProps[key] : void 0;
+				const value = layoutOptionValue ?? splitValue;
+				if (value !== void 0) includedPropValues[key] = value;
+			}
+			const validatedIncludedProps = validateProps(includedPropDefinitions, includedPropValues);
+			const layoutRenderIncludedProps = Object.fromEntries(includedPropKeys.flatMap((key) => {
+				if (!(key in validatedIncludedProps)) return [];
+				return [[toLayoutRenderPropKey(key, resolvedInProps[key]), validatedIncludedProps[key]]];
+			}));
+			return /* @__PURE__ */ jsx(Fragment, { children: render({
+				...validatedProps,
+				...layoutRenderIncludedProps
+			}, mergedRenderContext) });
+		}
+		function createComposition(compositionOptions) {
+			if (!compositionOptions.components) return {};
+			return { makeComposable: createComposableLayout(compositionOptions) };
+		}
+		return Object.assign(Component, {
+			displayName: name,
+			props: void 0,
+			...createComposition({
+				components: resolvedComposables,
+				name
+			})
+		});
+	};
+	function createLayoutForResource(defaultName, resource, defaults) {
+		return (({ name, ...rest }) => definedResourceLayout({
+			...defaults,
+			name: name ?? defaultName,
+			resource,
+			...resolveLayoutOptionDefaults(defaults, rest)
+		}));
+	}
+	function createLayoutForResourceBuilder(defaultName, resource) {
+		const createLayout = createLayoutForResource(defaultName, resource, {});
+		const setDefaults = ((defaults) => createLayoutForResource(defaultName, resource, defaults));
+		return Object.assign(createLayout, { setDefaults });
+	}
+	const forResource = (options) => {
+		const { name: defaultName, resource } = options;
+		if (!resource) throw new Error("\"resource\" is required when calling \"forResource\"");
+		return createLayoutForResourceBuilder(defaultName, resource);
+	};
+	return {
+		createResourceConfig,
+		createResourceLayout: Object.assign(definedResourceLayout, { forResource })
+	};
+}
+
+//#endregion
+export { defineResourceLayout };
+//# sourceMappingURL=define-layout.mjs.map