@jfdevelops/react-layout 2.1.0 → 2.3.0

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

@@ -0,0 +1,41 @@
+import { ResourceDefinition, ResourceEnum } from "../resource.cjs";
+import { InPropsDefinition, InPropsObject, InferredInProps } from "../props.cjs";
+import { AnyBuiltPropDefinition, ExtractDefinitionValue, ResolvedBuiltPropShape } from "@jfdevelops/react-layout-validator";
+
+//#region src/create-config/create-reusable.d.ts
+/** Object definitions can be selected recursively; other definitions are leaves. */
+type ReusableOptionSelection<Props extends InPropsObject> = { [Key in keyof Props]?: Props[Key] extends {
+  type: 'object';
+  properties: infer Shape extends InPropsObject;
+} ? true | ReusableOptionSelection<Shape> : true };
+type OptionDefinitions<Resources extends readonly ResourceDefinition[], Options extends InPropsDefinition<Resources>> = InferredInProps<Resources, Options> extends infer Props extends InPropsObject ? Props : never;
+/** Only data sources declared by the factory are available for selection. */
+type ReusableInclude<Resources extends readonly ResourceDefinition[], Options extends InPropsDefinition<Resources>> = {
+  resources?: true;
+} & (keyof OptionDefinitions<Resources, Options> extends never ? {} : {
+  options?: true | ReusableOptionSelection<OptionDefinitions<Resources, Options>>;
+});
+type SelectedOptionValue<Definition extends AnyBuiltPropDefinition, Selection> = Selection extends true ? ExtractDefinitionValue<Definition> : Definition extends {
+  properties: infer Shape extends InPropsObject;
+} ? SelectedOptionProps<Shape, Selection> : never;
+type SelectedOptionProps<Props extends InPropsObject, Selection> = { [Key in keyof Props & keyof Selection as Props[Key]['visibility'] extends 'required' ? Key : never]: SelectedOptionValue<Props[Key], Selection[Key]> } & { [Key in keyof Props & keyof Selection as Props[Key]['visibility'] extends 'optional' ? Key : never]?: SelectedOptionValue<Props[Key], Selection[Key]> };
+/** Options are flattened one level, so `options: { meta: true }` supplies `meta`. */
+type ReusableProps<Resources extends readonly ResourceDefinition[], Options extends InPropsDefinition<Resources>, Include, Custom extends InPropsObject> = (Include extends {
+  resources: true;
+} ? {
+  resources: ResourceEnum<Resources>[number][];
+} : {}) & (Include extends {
+  options: infer Selection;
+} ? Selection extends true ? ResolvedBuiltPropShape<OptionDefinitions<Resources, Options>> : SelectedOptionProps<OptionDefinitions<Resources, Options>, Selection> : {}) & ResolvedBuiltPropShape<Custom>;
+type ExactSelection<Selection, Allowed> = { [Key in keyof Selection]: Key extends keyof Allowed ? Selection[Key] extends object ? ExactSelection<Selection[Key], Exclude<Allowed[Key], true | undefined>> : Allowed[Key] : never };
+/** Creates a validated ordinary function with the shared configuration's types. */
+type CreateReusable<Resources extends readonly ResourceDefinition[], Options extends InPropsDefinition<Resources>> = <const Include extends ReusableInclude<Resources, Options> = {}, const Custom extends InPropsObject = {}, Result = unknown>(definition: {
+  props?: {
+    include?: ReusableInclude<Resources, Options> & Include & ExactSelection<Include, ReusableInclude<Resources, Options>>;
+    custom?: Custom;
+  };
+  fn: (props: ReusableProps<Resources, Options, Include, Custom>) => Result;
+}) => (...args: {} extends ReusableProps<Resources, Options, Include, Custom> ? [props?: ReusableProps<Resources, Options, Include, Custom>] : [props: ReusableProps<Resources, Options, Include, Custom>]) => Result;
+//#endregion
+export { CreateReusable, ReusableInclude, ReusableOptionSelection, ReusableProps };
+//# sourceMappingURL=create-reusable.d.cts.map

package/dist/create-config/create-reusable.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-reusable.d.cts","names":[],"sources":["../../src/create-config/create-reusable.ts"],"mappings":";;;;;;KAgBY,uBAAA,eAAsC,aAAA,oBAClC,KAAA,IAAS,KAAA,CAAM,GAAA;EAC3B,IAAA;EACA,UAAA,sBAAgC,aAAA;AAAA,WAEvB,uBAAA,CAAwB,KAAA;AAAA,KAIhC,iBAAA,4BACwB,kBAAA,oBACX,iBAAA,CAAkB,SAAA,KAChC,eAAA,CACF,SAAA,EACA,OAAA,8BAC4B,aAAA,GAC1B,KAAA;;KAIQ,eAAA,4BACiB,kBAAA,oBACX,iBAAA,CAAkB,SAAA;EAC9B,SAAA;AAAA,WAA4B,iBAAA,CAChC,SAAA,EACA,OAAA;EAII,OAAA,UAEI,uBAAA,CAAwB,iBAAA,CAAkB,SAAA,EAAW,OAAA;AAAA;AAAA,KAG1D,mBAAA,oBACgB,sBAAA,eAEjB,SAAA,gBACA,sBAAA,CAAuB,UAAA,IACvB,UAAA;EAAqB,UAAA,sBAAgC,aAAA;AAAA,IACrD,mBAAA,CAAoB,KAAA,EAAO,SAAA;AAAA,KAG1B,mBAAA,eAAkC,aAAA,+BACvB,KAAA,SACN,SAAA,IAAa,KAAA,CAAM,GAAA,qCACvB,GAAA,WACQ,mBAAA,CAAoB,KAAA,CAAM,GAAA,GAAM,SAAA,CAAU,GAAA,uBAExC,KAAA,SACN,SAAA,IAAa,KAAA,CAAM,GAAA,qCACvB,GAAA,YACS,mBAAA,CAAoB,KAAA,CAAM,GAAA,GAAM,SAAA,CAAU,GAAA;;KAI7C,aAAA,4BACiB,kBAAA,oBACX,iBAAA,CAAkB,SAAA,2BAEnB,aAAA,KACZ,OAAA;EAAkB,SAAA;AAAA;EACjB,SAAA,EAAW,YAAA,CAAa,SAAA;AAAA,WAE3B,OAAA;EAAkB,OAAA;AAAA,IACf,SAAA,gBACE,sBAAA,CAAuB,iBAAA,CAAkB,SAAA,EAAW,OAAA,KACpD,mBAAA,CAAoB,iBAAA,CAAkB,SAAA,EAAW,OAAA,GAAU,SAAA,UAEjE,sBAAA,CAAuB,MAAA;AAAA,KAGpB,cAAA,uCACW,SAAA,GAAY,GAAA,eAAkB,OAAA,GACxC,SAAA,CAAU,GAAA,mBACR,cAAA,CAAe,SAAA,CAAU,GAAA,GAAM,OAAA,CAAQ,OAAA,CAAQ,GAAA,wBAC/C,OAAA,CAAQ,GAAA;;KAKJ,cAAA,4BACiB,kBAAA,oBACX,iBAAA,CAAkB,SAAA,4BAEZ,eAAA,CAAgB,SAAA,EAAW,OAAA,6BAC5B,aAAA,yBAErB,UAAA;EACA,KAAA;IACE,OAAA,GAAU,eAAA,CAAgB,SAAA,EAAW,OAAA,IACnC,OAAA,GACA,cAAA,CAAe,OAAA,EAAS,eAAA,CAAgB,SAAA,EAAW,OAAA;IACrD,MAAA,GAAS,MAAA;EAAA;EAEX,EAAA,GAAK,KAAA,EAAO,aAAA,CAAc,SAAA,EAAW,OAAA,EAAS,OAAA,EAAS,MAAA,MAAY,MAAA;AAAA,UAEhE,IAAA,aAAiB,aAAA,CAAc,SAAA,EAAW,OAAA,EAAS,OAAA,EAAS,MAAA,KAC1D,KAAA,GAAQ,aAAA,CAAc,SAAA,EAAW,OAAA,EAAS,OAAA,EAAS,MAAA,MACnD,KAAA,EAAO,aAAA,CAAc,SAAA,EAAW,OAAA,EAAS,OAAA,EAAS,MAAA,OACpD,MAAA"}

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

@@ -0,0 +1,41 @@
+import { ResourceDefinition, ResourceEnum } from "../resource.mjs";
+import { InPropsDefinition, InPropsObject, InferredInProps } from "../props.mjs";
+import { AnyBuiltPropDefinition, ExtractDefinitionValue, ResolvedBuiltPropShape } from "@jfdevelops/react-layout-validator";
+
+//#region src/create-config/create-reusable.d.ts
+/** Object definitions can be selected recursively; other definitions are leaves. */
+type ReusableOptionSelection<Props extends InPropsObject> = { [Key in keyof Props]?: Props[Key] extends {
+  type: 'object';
+  properties: infer Shape extends InPropsObject;
+} ? true | ReusableOptionSelection<Shape> : true };
+type OptionDefinitions<Resources extends readonly ResourceDefinition[], Options extends InPropsDefinition<Resources>> = InferredInProps<Resources, Options> extends infer Props extends InPropsObject ? Props : never;
+/** Only data sources declared by the factory are available for selection. */
+type ReusableInclude<Resources extends readonly ResourceDefinition[], Options extends InPropsDefinition<Resources>> = {
+  resources?: true;
+} & (keyof OptionDefinitions<Resources, Options> extends never ? {} : {
+  options?: true | ReusableOptionSelection<OptionDefinitions<Resources, Options>>;
+});
+type SelectedOptionValue<Definition extends AnyBuiltPropDefinition, Selection> = Selection extends true ? ExtractDefinitionValue<Definition> : Definition extends {
+  properties: infer Shape extends InPropsObject;
+} ? SelectedOptionProps<Shape, Selection> : never;
+type SelectedOptionProps<Props extends InPropsObject, Selection> = { [Key in keyof Props & keyof Selection as Props[Key]['visibility'] extends 'required' ? Key : never]: SelectedOptionValue<Props[Key], Selection[Key]> } & { [Key in keyof Props & keyof Selection as Props[Key]['visibility'] extends 'optional' ? Key : never]?: SelectedOptionValue<Props[Key], Selection[Key]> };
+/** Options are flattened one level, so `options: { meta: true }` supplies `meta`. */
+type ReusableProps<Resources extends readonly ResourceDefinition[], Options extends InPropsDefinition<Resources>, Include, Custom extends InPropsObject> = (Include extends {
+  resources: true;
+} ? {
+  resources: ResourceEnum<Resources>[number][];
+} : {}) & (Include extends {
+  options: infer Selection;
+} ? Selection extends true ? ResolvedBuiltPropShape<OptionDefinitions<Resources, Options>> : SelectedOptionProps<OptionDefinitions<Resources, Options>, Selection> : {}) & ResolvedBuiltPropShape<Custom>;
+type ExactSelection<Selection, Allowed> = { [Key in keyof Selection]: Key extends keyof Allowed ? Selection[Key] extends object ? ExactSelection<Selection[Key], Exclude<Allowed[Key], true | undefined>> : Allowed[Key] : never };
+/** Creates a validated ordinary function with the shared configuration's types. */
+type CreateReusable<Resources extends readonly ResourceDefinition[], Options extends InPropsDefinition<Resources>> = <const Include extends ReusableInclude<Resources, Options> = {}, const Custom extends InPropsObject = {}, Result = unknown>(definition: {
+  props?: {
+    include?: ReusableInclude<Resources, Options> & Include & ExactSelection<Include, ReusableInclude<Resources, Options>>;
+    custom?: Custom;
+  };
+  fn: (props: ReusableProps<Resources, Options, Include, Custom>) => Result;
+}) => (...args: {} extends ReusableProps<Resources, Options, Include, Custom> ? [props?: ReusableProps<Resources, Options, Include, Custom>] : [props: ReusableProps<Resources, Options, Include, Custom>]) => Result;
+//#endregion
+export { CreateReusable, ReusableInclude, ReusableOptionSelection, ReusableProps };
+//# sourceMappingURL=create-reusable.d.mts.map

package/dist/create-config/create-reusable.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-reusable.d.mts","names":[],"sources":["../../src/create-config/create-reusable.ts"],"mappings":";;;;;;KAgBY,uBAAA,eAAsC,aAAA,oBAClC,KAAA,IAAS,KAAA,CAAM,GAAA;EAC3B,IAAA;EACA,UAAA,sBAAgC,aAAA;AAAA,WAEvB,uBAAA,CAAwB,KAAA;AAAA,KAIhC,iBAAA,4BACwB,kBAAA,oBACX,iBAAA,CAAkB,SAAA,KAChC,eAAA,CACF,SAAA,EACA,OAAA,8BAC4B,aAAA,GAC1B,KAAA;;KAIQ,eAAA,4BACiB,kBAAA,oBACX,iBAAA,CAAkB,SAAA;EAC9B,SAAA;AAAA,WAA4B,iBAAA,CAChC,SAAA,EACA,OAAA;EAII,OAAA,UAEI,uBAAA,CAAwB,iBAAA,CAAkB,SAAA,EAAW,OAAA;AAAA;AAAA,KAG1D,mBAAA,oBACgB,sBAAA,eAEjB,SAAA,gBACA,sBAAA,CAAuB,UAAA,IACvB,UAAA;EAAqB,UAAA,sBAAgC,aAAA;AAAA,IACrD,mBAAA,CAAoB,KAAA,EAAO,SAAA;AAAA,KAG1B,mBAAA,eAAkC,aAAA,+BACvB,KAAA,SACN,SAAA,IAAa,KAAA,CAAM,GAAA,qCACvB,GAAA,WACQ,mBAAA,CAAoB,KAAA,CAAM,GAAA,GAAM,SAAA,CAAU,GAAA,uBAExC,KAAA,SACN,SAAA,IAAa,KAAA,CAAM,GAAA,qCACvB,GAAA,YACS,mBAAA,CAAoB,KAAA,CAAM,GAAA,GAAM,SAAA,CAAU,GAAA;;KAI7C,aAAA,4BACiB,kBAAA,oBACX,iBAAA,CAAkB,SAAA,2BAEnB,aAAA,KACZ,OAAA;EAAkB,SAAA;AAAA;EACjB,SAAA,EAAW,YAAA,CAAa,SAAA;AAAA,WAE3B,OAAA;EAAkB,OAAA;AAAA,IACf,SAAA,gBACE,sBAAA,CAAuB,iBAAA,CAAkB,SAAA,EAAW,OAAA,KACpD,mBAAA,CAAoB,iBAAA,CAAkB,SAAA,EAAW,OAAA,GAAU,SAAA,UAEjE,sBAAA,CAAuB,MAAA;AAAA,KAGpB,cAAA,uCACW,SAAA,GAAY,GAAA,eAAkB,OAAA,GACxC,SAAA,CAAU,GAAA,mBACR,cAAA,CAAe,SAAA,CAAU,GAAA,GAAM,OAAA,CAAQ,OAAA,CAAQ,GAAA,wBAC/C,OAAA,CAAQ,GAAA;;KAKJ,cAAA,4BACiB,kBAAA,oBACX,iBAAA,CAAkB,SAAA,4BAEZ,eAAA,CAAgB,SAAA,EAAW,OAAA,6BAC5B,aAAA,yBAErB,UAAA;EACA,KAAA;IACE,OAAA,GAAU,eAAA,CAAgB,SAAA,EAAW,OAAA,IACnC,OAAA,GACA,cAAA,CAAe,OAAA,EAAS,eAAA,CAAgB,SAAA,EAAW,OAAA;IACrD,MAAA,GAAS,MAAA;EAAA;EAEX,EAAA,GAAK,KAAA,EAAO,aAAA,CAAc,SAAA,EAAW,OAAA,EAAS,OAAA,EAAS,MAAA,MAAY,MAAA;AAAA,UAEhE,IAAA,aAAiB,aAAA,CAAc,SAAA,EAAW,OAAA,EAAS,OAAA,EAAS,MAAA,KAC1D,KAAA,GAAQ,aAAA,CAAc,SAAA,EAAW,OAAA,EAAS,OAAA,EAAS,MAAA,MACnD,KAAA,EAAO,aAAA,CAAc,SAAA,EAAW,OAAA,EAAS,OAAA,EAAS,MAAA,OACpD,MAAA"}

package/dist/create-config/create-reusable.mjs

@@ -0,0 +1,49 @@
+import { LayoutConfigurationError } from "../errors/layout-configuration-error.mjs";
+import { createProp, validateProps } from "@jfdevelops/react-layout-validator";
+
+//#region src/create-config/create-reusable.ts
+function selectOptions(definitions, selection) {
+	const selected = {};
+	for (const [key, include] of Object.entries(selection)) {
+		const definition = definitions[key];
+		if (!Object.hasOwn(definitions, key)) throw new LayoutConfigurationError(`Unknown reusable option "${key}".`);
+		if (include === true) {
+			selected[key] = definition;
+			continue;
+		}
+		if (!include || typeof include !== "object" || !("properties" in definition) || !("type" in definition) || definition.type !== "object") throw new LayoutConfigurationError(`Invalid reusable selection for "${key}".`);
+		const nested = createProp.object(selectOptions(definition.properties, include));
+		selected[key] = definition.visibility === "optional" ? nested.optional() : nested;
+	}
+	return selected;
+}
+function createReusableBuilder(resources, options) {
+	const keys = resources.map((entry) => typeof entry === "string" ? entry : entry.value);
+	const resource = createProp.string.enum(keys);
+	function createReusable(definition) {
+		const include = definition.props?.include ?? {};
+		for (const key of Object.keys(include)) if (key !== "resources" && key !== "options") throw new LayoutConfigurationError(`Unknown reusable source "${key}".`);
+		const optionDefinitions = typeof options === "function" ? options({
+			name: createProp.string.literal("Reusable"),
+			resource
+		}) : options;
+		const definitions = { ...include.options === true ? optionDefinitions : include.options ? selectOptions(optionDefinitions, include.options) : {} };
+		if (include.resources) {
+			if (Object.hasOwn(definitions, "resources")) throw new LayoutConfigurationError("Reusable prop \"resources\" is selected more than once.");
+			definitions.resources = createProp.array(resource);
+		}
+		for (const [key, custom] of Object.entries(definition.props?.custom ?? {})) {
+			if (Object.hasOwn(definitions, key)) throw new LayoutConfigurationError(`Reusable prop "${key}" is selected more than once.`);
+			definitions[key] = custom;
+		}
+		return function reusable(props = {}) {
+			validateProps(definitions, props);
+			return definition.fn(props);
+		};
+	}
+	return createReusable;
+}
+
+//#endregion
+export { createReusableBuilder };
+//# sourceMappingURL=create-reusable.mjs.map

package/dist/create-config/create-reusable.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-reusable.mjs","names":[],"sources":["../../src/create-config/create-reusable.ts"],"sourcesContent":["import {\n  createProp,\n  validateProps,\n  type AnyBuiltPropDefinition,\n  type ExtractDefinitionValue,\n  type ResolvedBuiltPropShape,\n} from '@jfdevelops/react-layout-validator';\nimport type {\n  InferredInProps,\n  InPropsDefinition,\n  InPropsObject,\n} from '../props';\nimport type { ResourceDefinition, ResourceEnum } from '../resource';\nimport { LayoutConfigurationError } from '../errors';\n\n/** Object definitions can be selected recursively; other definitions are leaves. */\nexport type ReusableOptionSelection<Props extends InPropsObject> = {\n  [Key in keyof Props]?: Props[Key] extends {\n    type: 'object';\n    properties: infer Shape extends InPropsObject;\n  }\n    ? true | ReusableOptionSelection<Shape>\n    : true;\n};\n\ntype OptionDefinitions<\n  Resources extends readonly ResourceDefinition[],\n  Options extends InPropsDefinition<Resources>,\n> = InferredInProps<\n  Resources,\n  Options\n> extends infer Props extends InPropsObject\n  ? Props\n  : never;\n\n/** Only data sources declared by the factory are available for selection. */\nexport type ReusableInclude<\n  Resources extends readonly ResourceDefinition[],\n  Options extends InPropsDefinition<Resources>,\n> = { resources?: true } & (keyof OptionDefinitions<\n  Resources,\n  Options\n> extends never\n  ? {}\n  : {\n      options?:\n        | true\n        | ReusableOptionSelection<OptionDefinitions<Resources, Options>>;\n    });\n\ntype SelectedOptionValue<\n  Definition extends AnyBuiltPropDefinition,\n  Selection,\n> = Selection extends true\n  ? ExtractDefinitionValue<Definition>\n  : Definition extends { properties: infer Shape extends InPropsObject }\n  ? SelectedOptionProps<Shape, Selection>\n  : never;\n\ntype SelectedOptionProps<Props extends InPropsObject, Selection> = {\n  [Key in keyof Props &\n    keyof Selection as Props[Key]['visibility'] extends 'required'\n    ? Key\n    : never]: SelectedOptionValue<Props[Key], Selection[Key]>;\n} & {\n  [Key in keyof Props &\n    keyof Selection as Props[Key]['visibility'] extends 'optional'\n    ? Key\n    : never]?: SelectedOptionValue<Props[Key], Selection[Key]>;\n};\n\n/** Options are flattened one level, so `options: { meta: true }` supplies `meta`. */\nexport type ReusableProps<\n  Resources extends readonly ResourceDefinition[],\n  Options extends InPropsDefinition<Resources>,\n  Include,\n  Custom extends InPropsObject,\n> = (Include extends { resources: true }\n  ? { resources: ResourceEnum<Resources>[number][] }\n  : {}) &\n  (Include extends { options: infer Selection }\n    ? Selection extends true\n      ? ResolvedBuiltPropShape<OptionDefinitions<Resources, Options>>\n      : SelectedOptionProps<OptionDefinitions<Resources, Options>, Selection>\n    : {}) &\n  ResolvedBuiltPropShape<Custom>;\n\n// Generic constraints alone accept extra keys on structurally compatible objects.\ntype ExactSelection<Selection, Allowed> = {\n  [Key in keyof Selection]: Key extends keyof Allowed\n    ? Selection[Key] extends object\n      ? ExactSelection<Selection[Key], Exclude<Allowed[Key], true | undefined>>\n      : Allowed[Key]\n    : never;\n};\n\n/** Creates a validated ordinary function with the shared configuration's types. */\nexport type CreateReusable<\n  Resources extends readonly ResourceDefinition[],\n  Options extends InPropsDefinition<Resources>,\n> = <\n  const Include extends ReusableInclude<Resources, Options> = {},\n  const Custom extends InPropsObject = {},\n  Result = unknown,\n>(definition: {\n  props?: {\n    include?: ReusableInclude<Resources, Options> &\n      Include &\n      ExactSelection<Include, ReusableInclude<Resources, Options>>;\n    custom?: Custom;\n  };\n  fn: (props: ReusableProps<Resources, Options, Include, Custom>) => Result;\n}) => (\n  ...args: {} extends ReusableProps<Resources, Options, Include, Custom>\n    ? [props?: ReusableProps<Resources, Options, Include, Custom>]\n    : [props: ReusableProps<Resources, Options, Include, Custom>]\n) => Result;\n\nfunction selectOptions(\n  definitions: InPropsObject,\n  selection: Record<string, unknown>,\n) {\n  const selected: InPropsObject = {};\n  for (const [key, include] of Object.entries(selection)) {\n    const definition = definitions[key];\n    if (!Object.hasOwn(definitions, key)) {\n      throw new LayoutConfigurationError(`Unknown reusable option \"${key}\".`);\n    }\n    if (include === true) {\n      selected[key] = definition;\n      continue;\n    }\n    if (\n      !include ||\n      typeof include !== 'object' ||\n      !('properties' in definition) ||\n      !('type' in definition) ||\n      definition.type !== 'object'\n    ) {\n      throw new LayoutConfigurationError(\n        `Invalid reusable selection for \"${key}\".`,\n      );\n    }\n    const nested = createProp.object(\n      selectOptions(\n        definition.properties as InPropsObject,\n        include as Record<string, unknown>,\n      ),\n    );\n    selected[key] =\n      definition.visibility === 'optional' ? nested.optional() : nested;\n  }\n  return selected;\n}\n\nexport function createReusableBuilder<\n  const Resources extends readonly ResourceDefinition[],\n  Options extends InPropsDefinition<Resources>,\n>(resources: Resources, options: Options): CreateReusable<Resources, Options>;\nexport function createReusableBuilder(\n  resources: readonly ResourceDefinition[],\n  options: InPropsObject | ((...args: any[]) => InPropsObject),\n) {\n  const keys = resources.map((entry) =>\n    typeof entry === 'string' ? entry : entry.value,\n  );\n  const resource = createProp.string.enum(keys as [string, ...string[]]);\n\n  function createReusable(definition: {\n    props?: { include?: Record<string, unknown>; custom?: InPropsObject };\n    fn: (props: Record<string, unknown>) => unknown;\n  }) {\n    const include = definition.props?.include ?? {};\n    for (const key of Object.keys(include)) {\n      if (key !== 'resources' && key !== 'options') {\n        throw new LayoutConfigurationError(`Unknown reusable source \"${key}\".`);\n      }\n    }\n    const optionDefinitions =\n      typeof options === 'function'\n        ? options({ name: createProp.string.literal('Reusable'), resource })\n        : options;\n    const selected =\n      include.options === true\n        ? optionDefinitions\n        : include.options\n        ? selectOptions(\n            optionDefinitions,\n            include.options as Record<string, unknown>,\n          )\n        : {};\n    const definitions: InPropsObject = { ...selected };\n    if (include.resources) {\n      if (Object.hasOwn(definitions, 'resources')) {\n        throw new LayoutConfigurationError(\n          'Reusable prop \"resources\" is selected more than once.',\n        );\n      }\n      definitions.resources = createProp.array(resource);\n    }\n    for (const [key, custom] of Object.entries(\n      definition.props?.custom ?? {},\n    )) {\n      if (Object.hasOwn(definitions, key)) {\n        throw new LayoutConfigurationError(\n          `Reusable prop \"${key}\" is selected more than once.`,\n        );\n      }\n      definitions[key] = custom;\n    }\n\n    return function reusable(props: Record<string, unknown> = {}) {\n      validateProps(definitions, props);\n      return definition.fn(props);\n    };\n  }\n\n  return createReusable as unknown;\n}\n"],"mappings":";;;;AAsHA,SAAS,cACP,aACA,WACA;CACA,MAAM,WAA0B,CAAC;CACjC,KAAK,MAAM,CAAC,KAAK,YAAY,OAAO,QAAQ,SAAS,GAAG;EACtD,MAAM,aAAa,YAAY;EAC/B,IAAI,CAAC,OAAO,OAAO,aAAa,GAAG,GACjC,MAAM,IAAI,yBAAyB,4BAA4B,IAAI,GAAG;EAExE,IAAI,YAAY,MAAM;GACpB,SAAS,OAAO;GAChB;EACF;EACA,IACE,CAAC,WACD,OAAO,YAAY,YACnB,EAAE,gBAAgB,eAClB,EAAE,UAAU,eACZ,WAAW,SAAS,UAEpB,MAAM,IAAI,yBACR,mCAAmC,IAAI,GACzC;EAEF,MAAM,SAAS,WAAW,OACxB,cACE,WAAW,YACX,OACF,CACF;EACA,SAAS,OACP,WAAW,eAAe,aAAa,OAAO,SAAS,IAAI;CAC/D;CACA,OAAO;AACT;AAMA,SAAgB,sBACd,WACA,SACA;CACA,MAAM,OAAO,UAAU,KAAK,UAC1B,OAAO,UAAU,WAAW,QAAQ,MAAM,KAC5C;CACA,MAAM,WAAW,WAAW,OAAO,KAAK,IAA6B;CAErE,SAAS,eAAe,YAGrB;EACD,MAAM,UAAU,WAAW,OAAO,WAAW,CAAC;EAC9C,KAAK,MAAM,OAAO,OAAO,KAAK,OAAO,GACnC,IAAI,QAAQ,eAAe,QAAQ,WACjC,MAAM,IAAI,yBAAyB,4BAA4B,IAAI,GAAG;EAG1E,MAAM,oBACJ,OAAO,YAAY,aACf,QAAQ;GAAE,MAAM,WAAW,OAAO,QAAQ,UAAU;GAAG;EAAS,CAAC,IACjE;EAUN,MAAM,cAA6B,EAAE,GARnC,QAAQ,YAAY,OAChB,oBACA,QAAQ,UACR,cACE,mBACA,QAAQ,OACV,IACA,CAAC,EAC0C;EACjD,IAAI,QAAQ,WAAW;GACrB,IAAI,OAAO,OAAO,aAAa,WAAW,GACxC,MAAM,IAAI,yBACR,yDACF;GAEF,YAAY,YAAY,WAAW,MAAM,QAAQ;EACnD;EACA,KAAK,MAAM,CAAC,KAAK,WAAW,OAAO,QACjC,WAAW,OAAO,UAAU,CAAC,CAC/B,GAAG;GACD,IAAI,OAAO,OAAO,aAAa,GAAG,GAChC,MAAM,IAAI,yBACR,kBAAkB,IAAI,8BACxB;GAEF,YAAY,OAAO;EACrB;EAEA,OAAO,SAAS,SAAS,QAAiC,CAAC,GAAG;GAC5D,cAAc,aAAa,KAAK;GAChC,OAAO,WAAW,GAAG,KAAK;EAC5B;CACF;CAEA,OAAO;AACT"}

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

@@ -1,12 +1,13 @@
-const require_render_state_context = require('./render-state-context.cjs');
+const require_invalid_config = require('../errors/invalid-config.cjs');
+const require_missing_resource_provider = require('../errors/missing-resource-provider.cjs');
 const require_layout_configuration_error = require('../errors/layout-configuration-error.cjs');
 const require_resource_state_error = require('../errors/resource-state-error.cjs');
 const require_lazy_resource_error = require('../errors/lazy-resource-error.cjs');
+const require_custom_props = require('../custom-props.cjs');
+const require_render_state_context = require('./render-state-context.cjs');
 const require_lazy_boundary = require('../lazy/lazy-boundary.cjs');
 const require_fallback_props = require('../lazy/fallback-props.cjs');
 const require_types = require('../lazy/types.cjs');
-const require_invalid_config = require('../errors/invalid-config.cjs');
-const require_missing_resource_provider = require('../errors/missing-resource-provider.cjs');
 const require_capitalize = require('../utils/capitalize.cjs');
 const require_state_composable = require('./state-composable.cjs');
 const require_merge_layout_props = require('./merge-layout-props.cjs');
@@ -23,10 +24,10 @@ const require_render_state = require('./render-state.cjs');
 const require_create_for_resources = require('./for-resources/create-for-resources.cjs');
 const require_shell_context = require('./shell-context.cjs');
 let _jfdevelops_react_layout_composables = require("@jfdevelops/react-layout-composables");
+let _jfdevelops_react_layout_validator = require("@jfdevelops/react-layout-validator");
 let react = require("react");
 let react_jsx_runtime = require("react/jsx-runtime");
 let _jfdevelops_react_layout_devtools_core = require("@jfdevelops/react-layout-devtools-core");
-let _jfdevelops_react_layout_validator = require("@jfdevelops/react-layout-validator");
 
 //#region src/create-config/define-layout.tsx
 const RenderStateRetryContext = (0, react.createContext)(void 0);
@@ -131,6 +132,7 @@ function resolveLayoutOptionDefaults(defaults, options) {
 function optionalStateChildren(props) {
 	if (!props) return props;
 	const children = props.custom?.children;
+	const stateChildren = children && typeof children !== "string" && children.visibility === "required" && "optional" in children && typeof children.optional === "function" ? children.optional() : children;
 	const childrenInclude = props.include?.children;
 	return {
 		...props,
@@ -146,7 +148,7 @@ function optionalStateChildren(props) {
 		},
 		custom: props.custom && {
 			...props.custom,
-			...children ? { children: children.visibility === "required" ? children.optional?.() ?? children : children } : {}
+			...children ? { children: stateChildren } : {}
 		}
 	};
 }
@@ -301,7 +303,7 @@ function defineResourceLayoutImpl(options, inheritedStateScope, inheritedInspect
 		});
 		const render = defaultState.render;
 		const layoutProps = require_merge_layout_props.mergeLayoutProps(legacyLayoutProps, defaultState.props);
-		const customLayoutProps = layoutProps?.custom;
+		const customLayoutProps = require_custom_props.normalizeCustomProps(layoutProps?.custom ?? {});
 		const includeLayoutProps = layoutProps?.include;
 		const layoutOptionValues = layoutOptionProps;
 		const resolvedLayoutProps = { ...customLayoutProps };
@@ -367,10 +369,14 @@ function defineResourceLayoutImpl(options, inheritedStateScope, inheritedInspect
 				value: state,
 				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CreatedDefaultStateComponent, { ...renderProps })
 			});
-			return render(renderProps, {
+			return require_inspection.markInspectionRoots(render(renderProps, {
 				...mergedRenderContext,
 				state
-			});
+			}), [
+				activeInspection.layout,
+				activeInspection.state,
+				...resourceId ? [resourceId] : []
+			]);
 		}
 		function Component(props) {
 			const state = (0, react.useContext)(require_render_state_context.ReferencedRenderStateContext) ?? renderStateName;
@@ -525,10 +531,10 @@ function defineResourceLayoutImpl(options, inheritedStateScope, inheritedInspect
 				...composables?.(create, stateScope.states) ?? {},
 				...definition.composables?.(create, stateScope.states)
 			}) : void 0;
-			const stateRender = stateName === "Error" ? (props, context) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(RenderStateRetryContext.Consumer, { children: (retry) => definition.render(props, {
+			const stateRender = stateName === "Error" ? (props, context) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(RenderStateRetryContext.Consumer, { children: (retry) => require_inspection.markInspectionRoots(definition.render(props, {
 				...context,
 				retry
-			}) }) : definition.render;
+			}), [activeInspection.layout, ...inspectedState ? [inspectedState] : []]) }) : definition.render;
 			const StateComponent = defineResourceLayoutImpl({
 				resources,
 				options: inProps,
@@ -662,7 +668,7 @@ function defineResourceLayoutImpl(options, inheritedStateScope, inheritedInspect
 		for (const { props: presetPropDefinitions } of (0, _jfdevelops_react_layout_composables.collectComposablePresetEntries)(resolvedComposables)) Object.assign(resolvedInProps, presetPropDefinitions);
 		return {
 			...resolvedInProps,
-			...require_merge_layout_props.mergeLayoutProps(layout.props, defaultState?.props)?.custom
+			...require_custom_props.normalizeCustomProps(require_merge_layout_props.mergeLayoutProps(layout.props, defaultState?.props)?.custom ?? {})
 		};
 	}
 	const { createLayoutForResourceBuilder, forResource } = require_for_resource.createForResource({
@@ -743,7 +749,7 @@ function createResourceLayoutShellComponent(resources, inProps, shell, shellId)
 	}) : inProps);
 	const includeShellProps = shell.props?.include;
 	const includeShellPropKeys = Object.keys(includeShellProps ?? {});
-	const shellCustomDefinitions = { ...shell.props?.custom ?? {} };
+	const shellCustomDefinitions = require_custom_props.normalizeCustomProps(shell.props?.custom ?? {});
 	function syncShellComposableDisplayNames(stable, resource) {
 		if (!shell.composables) return;
 		const named = (0, _jfdevelops_react_layout_composables.resolveLayoutComposables)(shell.composables, {
@@ -830,6 +836,7 @@ function createResourceLayoutShellComponent(resources, inProps, shell, shellId)
 			...validatedCustomProps,
 			...renderIncludedProps
 		};
+		if (typeof shell.props?.custom?.children !== "function") renderProps.children = outlet == null ? outlet : shellChildren;
 		const renderContext = {
 			composables: resolvedComposables,
 			resource,