@jfdevelops/react-layout 2.3.0 → 2.5.0

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

@@ -1,41 +1,2 @@
-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
+import { ReusableResourcesAccessor, SingleResourceInput } from "./reusable-resource-input.cjs";
+import { CreateReusable, ReusableArguments, ReusableDefinition, ReusableFunction, ReusableInclude, ReusableInput, ReusableOptionSelection, ReusableOverlap, ReusableProps, ReusableResolved, ReusableSelected } from "./reusable-types.cjs";

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

@@ -1,41 +1,2 @@
-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
+import { ReusableResourcesAccessor, SingleResourceInput } from "./reusable-resource-input.mjs";
+import { CreateReusable, ReusableArguments, ReusableDefinition, ReusableFunction, ReusableInclude, ReusableInput, ReusableOptionSelection, ReusableOverlap, ReusableProps, ReusableResolved, ReusableSelected } from "./reusable-types.mjs";

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

@@ -1,44 +1,221 @@
 import { LayoutConfigurationError } from "../errors/layout-configuration-error.mjs";
+import { createLayoutResourcesAccessor } from "./define-layout.mjs";
+import { getResourcePaths, isSingleResourceInput, singleResourceInput } from "./reusable-resource-input.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];
+function objectPlan(children, optional = false, guards = [[]]) {
+	return {
+		kind: "object",
+		children,
+		optional,
+		guards
+	};
+}
+function optionPlan(definitions, selection, from, path = [], optionalPaths = []) {
+	const entries = selection === true ? Object.fromEntries(Object.keys(definitions).map((key) => [key, true])) : selection;
+	const children = {};
+	for (const [key, value] of Object.entries(entries ?? {})) {
 		if (!Object.hasOwn(definitions, key)) throw new LayoutConfigurationError(`Unknown reusable option "${key}".`);
-		if (include === true) {
-			selected[key] = definition;
+		const definition = definitions[key];
+		const location = {
+			from,
+			path: [...path, key]
+		};
+		if (typeof value === "function") children[key] = {
+			...location,
+			from: "options",
+			guards: optionalPaths.map((path) => ({
+				from: "options",
+				path
+			})),
+			kind: "value",
+			source: "option",
+			selector: value,
+			definition
+		};
+		else if ("properties" in definition && "type" in definition && definition.type === "object" && (value === true || value && typeof value === "object")) children[key] = {
+			...optionPlan(definition.properties, value, from, location.path, definition.visibility === "optional" ? [...optionalPaths, location.path] : optionalPaths),
+			optional: definition.visibility === "optional"
+		};
+		else if (value === true) children[key] = {
+			...location,
+			guards: optionalPaths.map((path) => ({
+				from,
+				path
+			})),
+			kind: "value",
+			source: "option",
+			definition
+		};
+		else throw new LayoutConfigurationError(`Invalid reusable selection for "${key}".`);
+	}
+	const origins = /* @__PURE__ */ new Set();
+	function collectOrigins(node) {
+		if (node.kind === "value") origins.add(node.from);
+		else Object.values(node.children).forEach(collectOrigins);
+	}
+	Object.values(children).forEach(collectOrigins);
+	if (!origins.size) origins.add(from);
+	return objectPlan(children, false, [...origins].map((origin) => optionalPaths.map((path) => ({
+		from: origin,
+		path
+	}))));
+}
+function sameSelection(left, right) {
+	return left.source === right.source && left.selector === right.selector && left.path.join(".") === right.path.join(".") && (left.source === "option" || left.from === right.from);
+}
+function mergePlans(left, right, overlap, path = []) {
+	const children = { ...left.children };
+	for (const [key, other] of Object.entries(right.children)) {
+		const current = children[key];
+		if (!current) {
+			children[key] = other;
 			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;
+		if (current.kind === "object" && other.kind === "object") children[key] = mergePlans(current, other, overlap, [...path, key]);
+		else if (current.kind === "value" && other.kind === "value" && sameSelection(current, other)) children[key] = other.from === "options" ? other : current;
+		else if (overlap) children[key] = overlap === "preferProps" ? current : other;
+		else throw new LayoutConfigurationError(`Ambiguous reusable property "${[...path, key].join(".")}". Rename one result or set overlap to "preferProps" or "preferSelect".`);
 	}
-	return selected;
+	return {
+		kind: "object",
+		children,
+		optional: left.optional && right.optional,
+		guards: [...left.guards, ...right.guards]
+	};
+}
+function withoutSharedCallerValues(left, right) {
+	const children = { ...left.children };
+	for (const [key, other] of Object.entries(right.children)) {
+		const current = children[key];
+		if (current?.kind === "object" && other.kind === "object") children[key] = withoutSharedCallerValues(current, other);
+		else if (current?.kind === "value" && other.kind === "value" && sameSelection(current, other) && other.from === "options") delete children[key];
+	}
+	return {
+		...left,
+		children
+	};
+}
+function planDefinitions(plan, from) {
+	const definitions = {};
+	for (const [key, value] of Object.entries(plan.children)) if (value.kind === "value") {
+		if (value.from === from && value.definition) definitions[key] = value.definition;
+	} else {
+		const nested = planDefinitions(value, from);
+		if (Object.keys(nested).length) {
+			const definition = createProp.object(nested);
+			definitions[key] = value.optional ? definition.optional() : definition;
+		}
+	}
+	return definitions;
+}
+function sourceSelection(selection, callbacksOnly) {
+	if (typeof selection === "function") return true;
+	if (selection === true) return callbacksOnly ? {} : true;
+	const source = {};
+	for (const [key, value] of Object.entries(selection ?? {})) {
+		const nested = sourceSelection(value, callbacksOnly);
+		if (nested === true || Object.keys(nested).length) source[key] = nested;
+	}
+	return source;
+}
+function mergeSelections(left, right) {
+	if (left === true || right === true) return true;
+	const merged = { ...left };
+	for (const [key, value] of Object.entries(right)) merged[key] = Object.hasOwn(left, key) ? mergeSelections(left[key], value) : value;
+	return merged;
+}
+function readLocation(location, props, options, resources) {
+	let value = location.from === "props" ? props : location.from === "options" ? options : resources;
+	for (const key of location.path) value = value?.[key];
+	return value;
+}
+function resolvePlan(plan, props, options, resources, resourceSelections) {
+	const result = {};
+	for (const [key, node] of Object.entries(plan.children)) if (node.kind === "object") {
+		if (node.guards.some((group) => group.every((location) => readLocation(location, props, options, resources) !== void 0))) result[key] = resolvePlan(node, props, options, resources, resourceSelections);
+	} else {
+		if (node.guards?.some((location) => readLocation(location, props, options, resources) === void 0)) continue;
+		const value = readLocation(node, props, options, resources);
+		if (node.selector) {
+			const selected = node.source === "resource" ? resourceSelections.get(node.selector) : node.selector(value);
+			result[key] = node.source === "resource" && isSingleResourceInput(selected) ? props.resources : selected;
+		} else if (value !== void 0 || node.definition?.visibility !== "optional") result[key] = value;
+	}
+	return result;
 }
 function createReusableBuilder(resources, options) {
 	const keys = resources.map((entry) => typeof entry === "string" ? entry : entry.value);
 	const resource = createProp.string.enum(keys);
+	const singleResource = createProp.string.enum(getResourcePaths(resources));
+	const resourcesAccessor = Object.assign(createLayoutResourcesAccessor(resources), { single() {
+		return { [singleResourceInput]: resources };
+	} });
 	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 select = definition.select ?? {};
+		if (definition.overlap !== void 0 && definition.overlap !== "preferProps" && definition.overlap !== "preferSelect") throw new LayoutConfigurationError("Unknown reusable overlap policy.");
 		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;
+		function compile(selection, from) {
+			let plan = objectPlan({});
+			for (const [key, value] of Object.entries(selection)) {
+				let next;
+				if (key === "options") {
+					if (value !== true && typeof value !== "function" && (!value || typeof value !== "object" || Array.isArray(value))) throw new LayoutConfigurationError("Invalid reusable options selection.");
+					next = typeof value === "function" ? objectPlan({ options: {
+						kind: "value",
+						source: "option",
+						from: "options",
+						path: [],
+						selector: value
+					} }) : optionPlan(optionDefinitions, value, from);
+				} else if (key === "resources" && (value === true || typeof value === "function")) next = objectPlan({ resources: {
+					kind: "value",
+					source: "resource",
+					from: value === true && from === "props" ? "props" : "resources",
+					path: value === true && from === "props" ? ["resources"] : [],
+					selector: typeof value === "function" ? value : void 0,
+					definition: value === true && from === "props" ? createProp.array(resource) : void 0
+				} });
+				else throw new LayoutConfigurationError(`Invalid reusable source "${key}".`);
+				plan = mergePlans(plan, next);
+			}
+			return plan;
 		}
+		let included = compile(include, "props");
+		const custom = objectPlan(Object.fromEntries(Object.entries(definition.props?.custom ?? {}).map(([key, value]) => [key, {
+			kind: "value",
+			source: "custom",
+			from: "props",
+			path: [key],
+			definition: value
+		}])));
+		included = mergePlans(included, custom);
+		const selected = compile(select, "options");
+		const plan = mergePlans(included, selected, definition.overlap);
+		const callerDefinitions = planDefinitions(withoutSharedCallerValues(included, selected), "props");
+		const effectiveCallerDefinitions = planDefinitions(plan, "props");
+		const sources = mergeSelections(sourceSelection(include.options, true), sourceSelection(select.options, false));
+		const sourceDefinitions = sources === true ? optionDefinitions : planDefinitions(optionPlan(optionDefinitions, sources, "options"), "options");
+		const resourceSelectors = new Set([include.resources, select.resources].filter((selector) => typeof selector === "function"));
+		const needsOptions = Object.keys(sourceDefinitions).length > 0;
+		if (needsOptions && Object.hasOwn(callerDefinitions, "options")) throw new LayoutConfigurationError("Reusable prop \"options\" is reserved for source values.");
 		return function reusable(props = {}) {
-			validateProps(definitions, props);
-			return definition.fn(props);
+			validateProps(definition.overlap ? callerDefinitions : effectiveCallerDefinitions, props);
+			if (needsOptions && props.options !== void 0 && (props.options === null || typeof props.options !== "object" || Array.isArray(props.options))) throw new LayoutConfigurationError("Reusable source options must be an object.");
+			const values = props.options ?? {};
+			validateProps(sourceDefinitions, values);
+			const resourceSelections = /* @__PURE__ */ new Map();
+			for (const selector of resourceSelectors) {
+				const selected = selector(resourcesAccessor);
+				if (isSingleResourceInput(selected)) validateProps({ resources: singleResource }, props);
+				resourceSelections.set(selector, selected);
+			}
+			return definition.fn(resolvePlan(plan, props, values, resourcesAccessor, resourceSelections));
 		};
 	}
 	return createReusable;

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

@@ -1 +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"}
+{"version":3,"file":"create-reusable.mjs","names":[],"sources":["../../src/create-config/create-reusable.ts"],"sourcesContent":["import {\n  createProp,\n  validateProps,\n  type AnyBuiltPropDefinition,\n} from '@jfdevelops/react-layout-validator';\nimport type { InPropsDefinition, InPropsObject, PropsContract } from '../props';\nimport type { ResourceDefinition } from '../resource';\nimport { LayoutConfigurationError } from '../errors';\nimport { createLayoutResourcesAccessor } from './define-layout';\nimport type { CreateReusable, ReusableOverlap } from './reusable-types';\nexport type * from './reusable-types';\nimport {\n  singleResourceInput,\n  isSingleResourceInput,\n  getResourcePaths,\n} from './reusable-resource-input';\n\ntype RuntimeSelection = Record<string, unknown>;\ntype PlanLocation = { from: 'props' | 'options' | 'resources'; path: string[] };\ntype ValuePlan = PlanLocation & {\n  kind: 'value';\n  // Optional ancestors remain tied to the value's original source after merging.\n  guards?: PlanLocation[];\n  source: 'option' | 'resource' | 'custom';\n  selector?: (value: any) => unknown;\n  definition?: AnyBuiltPropDefinition;\n};\ntype ResourceSelector = NonNullable<ValuePlan['selector']>;\ntype ResourceSelections = Map<ResourceSelector, unknown>;\n\ntype ObjectPlan = {\n  kind: 'object';\n  children: Record<string, Plan>;\n  optional: boolean;\n  guards: PlanLocation[][];\n};\ntype Plan = ValuePlan | ObjectPlan;\n\nfunction objectPlan(\n  children: Record<string, Plan>,\n  optional = false,\n  guards: PlanLocation[][] = [[]],\n): ObjectPlan {\n  return { kind: 'object', children, optional, guards };\n}\n\nfunction optionPlan(\n  definitions: InPropsObject,\n  selection: unknown,\n  from: 'props' | 'options',\n  path: string[] = [],\n  optionalPaths: string[][] = [],\n): ObjectPlan {\n  const entries =\n    selection === true\n      ? Object.fromEntries(Object.keys(definitions).map((key) => [key, true]))\n      : (selection as RuntimeSelection);\n  const children: Record<string, Plan> = {};\n  for (const [key, value] of Object.entries(entries ?? {})) {\n    if (!Object.hasOwn(definitions, key))\n      throw new LayoutConfigurationError(`Unknown reusable option \"${key}\".`);\n    const definition = definitions[key];\n    const location: PlanLocation = { from, path: [...path, key] };\n    if (typeof value === 'function') {\n      children[key] = {\n        ...location,\n        from: 'options',\n        guards: optionalPaths.map((path) => ({ from: 'options', path })),\n        kind: 'value',\n        source: 'option',\n        selector: value as ValuePlan['selector'],\n        definition,\n      };\n    } else if (\n      'properties' in definition &&\n      'type' in definition &&\n      definition.type === 'object' &&\n      (value === true || (value && typeof value === 'object'))\n    ) {\n      const nested = optionPlan(\n        definition.properties as InPropsObject,\n        value,\n        from,\n        location.path,\n        definition.visibility === 'optional'\n          ? [...optionalPaths, location.path]\n          : optionalPaths,\n      );\n      children[key] = {\n        ...nested,\n        optional: definition.visibility === 'optional',\n      };\n    } else if (value === true) {\n      children[key] = {\n        ...location,\n        guards: optionalPaths.map((path) => ({ from, path })),\n        kind: 'value',\n        source: 'option',\n        definition,\n      };\n    } else\n      throw new LayoutConfigurationError(\n        `Invalid reusable selection for \"${key}\".`,\n      );\n  }\n  const origins = new Set<PlanLocation['from']>();\n  function collectOrigins(node: Plan) {\n    if (node.kind === 'value') origins.add(node.from);\n    else Object.values(node.children).forEach(collectOrigins);\n  }\n  Object.values(children).forEach(collectOrigins);\n  if (!origins.size) origins.add(from);\n  return objectPlan(\n    children,\n    false,\n    [...origins].map((origin) =>\n      optionalPaths.map((path) => ({ from: origin, path })),\n    ),\n  );\n}\n\nfunction sameSelection(left: ValuePlan, right: ValuePlan) {\n  return (\n    left.source === right.source &&\n    left.selector === right.selector &&\n    left.path.join('.') === right.path.join('.') &&\n    (left.source === 'option' || left.from === right.from)\n  );\n}\n\nfunction mergePlans(\n  left: ObjectPlan,\n  right: ObjectPlan,\n  overlap?: ReusableOverlap,\n  path: string[] = [],\n): ObjectPlan {\n  const children = { ...left.children };\n  for (const [key, other] of Object.entries(right.children)) {\n    const current = children[key];\n    if (!current) {\n      children[key] = other;\n      continue;\n    }\n    if (current.kind === 'object' && other.kind === 'object') {\n      children[key] = mergePlans(current, other, overlap, [...path, key]);\n    } else if (\n      current.kind === 'value' &&\n      other.kind === 'value' &&\n      sameSelection(current, other)\n    ) {\n      // A shared option selection uses one source value and executes only once.\n      children[key] = other.from === 'options' ? other : current;\n    } else if (overlap)\n      children[key] = overlap === 'preferProps' ? current : other;\n    else\n      throw new LayoutConfigurationError(\n        `Ambiguous reusable property \"${[...path, key].join(\n          '.',\n        )}\". Rename one result or set overlap to \"preferProps\" or \"preferSelect\".`,\n      );\n  }\n  return {\n    kind: 'object',\n    children,\n    optional: left.optional && right.optional,\n    guards: [...left.guards, ...right.guards],\n  };\n}\n\nfunction withoutSharedCallerValues(\n  left: ObjectPlan,\n  right: ObjectPlan,\n): ObjectPlan {\n  const children = { ...left.children };\n  for (const [key, other] of Object.entries(right.children)) {\n    const current = children[key];\n    if (current?.kind === 'object' && other.kind === 'object')\n      children[key] = withoutSharedCallerValues(current, other);\n    else if (\n      current?.kind === 'value' &&\n      other.kind === 'value' &&\n      sameSelection(current, other) &&\n      other.from === 'options'\n    )\n      delete children[key];\n  }\n  return { ...left, children };\n}\n\nfunction planDefinitions(\n  plan: ObjectPlan,\n  from: 'props' | 'options',\n): InPropsObject {\n  const definitions: InPropsObject = {};\n  for (const [key, value] of Object.entries(plan.children)) {\n    if (value.kind === 'value') {\n      if (value.from === from && value.definition)\n        definitions[key] = value.definition;\n    } else {\n      const nested = planDefinitions(value, from);\n      if (Object.keys(nested).length) {\n        const definition = createProp.object(nested);\n        definitions[key] = value.optional ? definition.optional() : definition;\n      }\n    }\n  }\n  return definitions;\n}\n\nfunction sourceSelection(\n  selection: unknown,\n  callbacksOnly: boolean,\n): true | RuntimeSelection {\n  if (typeof selection === 'function') return true;\n  if (selection === true) return callbacksOnly ? {} : true;\n  const source: RuntimeSelection = {};\n  for (const [key, value] of Object.entries(\n    (selection ?? {}) as RuntimeSelection,\n  )) {\n    const nested = sourceSelection(value, callbacksOnly);\n    if (nested === true || Object.keys(nested).length) source[key] = nested;\n  }\n  return source;\n}\n\nfunction mergeSelections(\n  left: true | RuntimeSelection,\n  right: true | RuntimeSelection,\n): true | RuntimeSelection {\n  if (left === true || right === true) return true;\n  const merged = { ...left };\n  for (const [key, value] of Object.entries(right))\n    merged[key] = Object.hasOwn(left, key)\n      ? mergeSelections(\n          left[key] as true | RuntimeSelection,\n          value as true | RuntimeSelection,\n        )\n      : value;\n  return merged;\n}\n\nfunction readLocation(\n  location: PlanLocation,\n  props: Record<string, unknown>,\n  options: Record<string, unknown>,\n  resources: unknown,\n) {\n  let value: any =\n    location.from === 'props'\n      ? props\n      : location.from === 'options'\n      ? options\n      : resources;\n  for (const key of location.path) value = value?.[key];\n  return value;\n}\n\nfunction resolvePlan(\n  plan: ObjectPlan,\n  props: Record<string, unknown>,\n  options: Record<string, unknown>,\n  resources: unknown,\n  resourceSelections: ResourceSelections,\n) {\n  const result: Record<string, unknown> = {};\n  for (const [key, node] of Object.entries(plan.children)) {\n    if (node.kind === 'object') {\n      if (\n        node.guards.some((group) =>\n          group.every(\n            (location) =>\n              readLocation(location, props, options, resources) !== undefined,\n          ),\n        )\n      ) {\n        result[key] = resolvePlan(\n          node,\n          props,\n          options,\n          resources,\n          resourceSelections,\n        );\n      }\n    } else {\n      if (\n        node.guards?.some(\n          (location) =>\n            readLocation(location, props, options, resources) === undefined,\n        )\n      )\n        continue;\n      const value = readLocation(node, props, options, resources);\n      if (node.selector) {\n        const selected =\n          node.source === 'resource'\n            ? resourceSelections.get(node.selector)\n            : node.selector(value);\n        result[key] =\n          node.source === 'resource' && isSingleResourceInput(selected)\n            ? props.resources\n            : selected;\n      } else if (\n        value !== undefined ||\n        node.definition?.visibility !== 'optional'\n      )\n        result[key] = value;\n    }\n  }\n  return result;\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  const singleResource = createProp.string.enum(\n    getResourcePaths(resources) as [string, ...string[]],\n  );\n  const resourcesAccessor = Object.assign(\n    createLayoutResourcesAccessor(resources),\n    {\n      single() {\n        return { [singleResourceInput]: resources };\n      },\n    },\n  );\n\n  function createReusable(definition: {\n    props?: PropsContract<RuntimeSelection, InPropsObject>;\n    select?: RuntimeSelection;\n    overlap?: ReusableOverlap;\n    fn: (props: Record<string, unknown>) => unknown;\n  }) {\n    const include = definition.props?.include ?? {};\n    const select = definition.select ?? {};\n    if (\n      definition.overlap !== undefined &&\n      definition.overlap !== 'preferProps' &&\n      definition.overlap !== 'preferSelect'\n    ) {\n      throw new LayoutConfigurationError('Unknown reusable overlap policy.');\n    }\n    const optionDefinitions =\n      typeof options === 'function'\n        ? options({ name: createProp.string.literal('Reusable'), resource })\n        : options;\n\n    function compile(selection: RuntimeSelection, from: 'props' | 'options') {\n      let plan = objectPlan({});\n      for (const [key, value] of Object.entries(selection)) {\n        let next: ObjectPlan;\n        if (key === 'options') {\n          if (\n            value !== true &&\n            typeof value !== 'function' &&\n            (!value || typeof value !== 'object' || Array.isArray(value))\n          ) {\n            throw new LayoutConfigurationError(\n              'Invalid reusable options selection.',\n            );\n          }\n          next =\n            typeof value === 'function'\n              ? objectPlan({\n                  options: {\n                    kind: 'value',\n                    source: 'option',\n                    from: 'options',\n                    path: [],\n                    selector: value as ValuePlan['selector'],\n                  },\n                })\n              : optionPlan(optionDefinitions, value, from);\n        } else if (\n          key === 'resources' &&\n          (value === true || typeof value === 'function')\n        ) {\n          next = objectPlan({\n            resources: {\n              kind: 'value',\n              source: 'resource',\n              from: value === true && from === 'props' ? 'props' : 'resources',\n              path: value === true && from === 'props' ? ['resources'] : [],\n              selector:\n                typeof value === 'function'\n                  ? (value as ValuePlan['selector'])\n                  : undefined,\n              definition:\n                value === true && from === 'props'\n                  ? createProp.array(resource)\n                  : undefined,\n            },\n          });\n        } else\n          throw new LayoutConfigurationError(\n            `Invalid reusable source \"${key}\".`,\n          );\n        plan = mergePlans(plan, next);\n      }\n      return plan;\n    }\n\n    let included = compile(include, 'props');\n    const custom = objectPlan(\n      Object.fromEntries(\n        Object.entries(definition.props?.custom ?? {}).map(([key, value]) => [\n          key,\n          {\n            kind: 'value',\n            source: 'custom',\n            from: 'props',\n            path: [key],\n            definition: value,\n          } as ValuePlan,\n        ]),\n      ),\n    );\n    included = mergePlans(included, custom);\n    const selected = compile(select, 'options');\n    const plan = mergePlans(included, selected, definition.overlap);\n    const callerDefinitions = planDefinitions(\n      withoutSharedCallerValues(included, selected),\n      'props',\n    );\n    // Identical true selections supplied by select are removed from the caller props contract.\n    const effectiveCallerDefinitions = planDefinitions(plan, 'props');\n    const sources = mergeSelections(\n      sourceSelection(include.options, true),\n      sourceSelection(select.options, false),\n    );\n    const sourceDefinitions =\n      sources === true\n        ? optionDefinitions\n        : planDefinitions(\n            optionPlan(optionDefinitions, sources, 'options'),\n            'options',\n          );\n    const resourceSelectors = new Set(\n      [include.resources, select.resources].filter(\n        (selector): selector is ResourceSelector =>\n          typeof selector === 'function',\n      ),\n    );\n    const needsOptions = Object.keys(sourceDefinitions).length > 0;\n    if (needsOptions && Object.hasOwn(callerDefinitions, 'options')) {\n      throw new LayoutConfigurationError(\n        'Reusable prop \"options\" is reserved for source values.',\n      );\n    }\n\n    return function reusable(props: Record<string, unknown> = {}) {\n      // Validate configured caller props too when an explicit overlap policy discards their output.\n      const definitions = definition.overlap\n        ? callerDefinitions\n        : effectiveCallerDefinitions;\n      validateProps(definitions, props);\n      if (\n        needsOptions &&\n        props.options !== undefined &&\n        (props.options === null ||\n          typeof props.options !== 'object' ||\n          Array.isArray(props.options))\n      ) {\n        throw new LayoutConfigurationError(\n          'Reusable source options must be an object.',\n        );\n      }\n      const values = (props.options ?? {}) as Record<string, unknown>;\n      validateProps(sourceDefinitions, values);\n      // Resource callbacks also declare caller inputs, independently of overlap precedence.\n      const resourceSelections: ResourceSelections = new Map();\n      for (const selector of resourceSelectors) {\n        const selected = selector(resourcesAccessor);\n        if (isSingleResourceInput(selected))\n          validateProps({ resources: singleResource }, props);\n        resourceSelections.set(selector, selected);\n      }\n      return definition.fn(\n        resolvePlan(plan, props, values, resourcesAccessor, resourceSelections),\n      );\n    };\n  }\n  return createReusable as unknown;\n}\n"],"mappings":";;;;;;AAsCA,SAAS,WACP,UACA,WAAW,OACX,SAA2B,CAAC,CAAC,CAAC,GAClB;CACZ,OAAO;EAAE,MAAM;EAAU;EAAU;EAAU;CAAO;AACtD;AAEA,SAAS,WACP,aACA,WACA,MACA,OAAiB,CAAC,GAClB,gBAA4B,CAAC,GACjB;CACZ,MAAM,UACJ,cAAc,OACV,OAAO,YAAY,OAAO,KAAK,WAAW,EAAE,KAAK,QAAQ,CAAC,KAAK,IAAI,CAAC,CAAC,IACpE;CACP,MAAM,WAAiC,CAAC;CACxC,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,WAAW,CAAC,CAAC,GAAG;EACxD,IAAI,CAAC,OAAO,OAAO,aAAa,GAAG,GACjC,MAAM,IAAI,yBAAyB,4BAA4B,IAAI,GAAG;EACxE,MAAM,aAAa,YAAY;EAC/B,MAAM,WAAyB;GAAE;GAAM,MAAM,CAAC,GAAG,MAAM,GAAG;EAAE;EAC5D,IAAI,OAAO,UAAU,YACnB,SAAS,OAAO;GACd,GAAG;GACH,MAAM;GACN,QAAQ,cAAc,KAAK,UAAU;IAAE,MAAM;IAAW;GAAK,EAAE;GAC/D,MAAM;GACN,QAAQ;GACR,UAAU;GACV;EACF;OACK,IACL,gBAAgB,cAChB,UAAU,cACV,WAAW,SAAS,aACnB,UAAU,QAAS,SAAS,OAAO,UAAU,WAW9C,SAAS,OAAO;GACd,GAVa,WACb,WAAW,YACX,OACA,MACA,SAAS,MACT,WAAW,eAAe,aACtB,CAAC,GAAG,eAAe,SAAS,IAAI,IAChC,aAGI;GACR,UAAU,WAAW,eAAe;EACtC;OACK,IAAI,UAAU,MACnB,SAAS,OAAO;GACd,GAAG;GACH,QAAQ,cAAc,KAAK,UAAU;IAAE;IAAM;GAAK,EAAE;GACpD,MAAM;GACN,QAAQ;GACR;EACF;OAEA,MAAM,IAAI,yBACR,mCAAmC,IAAI,GACzC;CACJ;CACA,MAAM,0BAAU,IAAI,IAA0B;CAC9C,SAAS,eAAe,MAAY;EAClC,IAAI,KAAK,SAAS,SAAS,QAAQ,IAAI,KAAK,IAAI;OAC3C,OAAO,OAAO,KAAK,QAAQ,EAAE,QAAQ,cAAc;CAC1D;CACA,OAAO,OAAO,QAAQ,EAAE,QAAQ,cAAc;CAC9C,IAAI,CAAC,QAAQ,MAAM,QAAQ,IAAI,IAAI;CACnC,OAAO,WACL,UACA,OACA,CAAC,GAAG,OAAO,EAAE,KAAK,WAChB,cAAc,KAAK,UAAU;EAAE,MAAM;EAAQ;CAAK,EAAE,CACtD,CACF;AACF;AAEA,SAAS,cAAc,MAAiB,OAAkB;CACxD,OACE,KAAK,WAAW,MAAM,UACtB,KAAK,aAAa,MAAM,YACxB,KAAK,KAAK,KAAK,GAAG,MAAM,MAAM,KAAK,KAAK,GAAG,MAC1C,KAAK,WAAW,YAAY,KAAK,SAAS,MAAM;AAErD;AAEA,SAAS,WACP,MACA,OACA,SACA,OAAiB,CAAC,GACN;CACZ,MAAM,WAAW,EAAE,GAAG,KAAK,SAAS;CACpC,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,MAAM,QAAQ,GAAG;EACzD,MAAM,UAAU,SAAS;EACzB,IAAI,CAAC,SAAS;GACZ,SAAS,OAAO;GAChB;EACF;EACA,IAAI,QAAQ,SAAS,YAAY,MAAM,SAAS,UAC9C,SAAS,OAAO,WAAW,SAAS,OAAO,SAAS,CAAC,GAAG,MAAM,GAAG,CAAC;OAC7D,IACL,QAAQ,SAAS,WACjB,MAAM,SAAS,WACf,cAAc,SAAS,KAAK,GAG5B,SAAS,OAAO,MAAM,SAAS,YAAY,QAAQ;OAC9C,IAAI,SACT,SAAS,OAAO,YAAY,gBAAgB,UAAU;OAEtD,MAAM,IAAI,yBACR,gCAAgC,CAAC,GAAG,MAAM,GAAG,EAAE,KAC7C,GACF,EAAE,wEACJ;CACJ;CACA,OAAO;EACL,MAAM;EACN;EACA,UAAU,KAAK,YAAY,MAAM;EACjC,QAAQ,CAAC,GAAG,KAAK,QAAQ,GAAG,MAAM,MAAM;CAC1C;AACF;AAEA,SAAS,0BACP,MACA,OACY;CACZ,MAAM,WAAW,EAAE,GAAG,KAAK,SAAS;CACpC,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,MAAM,QAAQ,GAAG;EACzD,MAAM,UAAU,SAAS;EACzB,IAAI,SAAS,SAAS,YAAY,MAAM,SAAS,UAC/C,SAAS,OAAO,0BAA0B,SAAS,KAAK;OACrD,IACH,SAAS,SAAS,WAClB,MAAM,SAAS,WACf,cAAc,SAAS,KAAK,KAC5B,MAAM,SAAS,WAEf,OAAO,SAAS;CACpB;CACA,OAAO;EAAE,GAAG;EAAM;CAAS;AAC7B;AAEA,SAAS,gBACP,MACA,MACe;CACf,MAAM,cAA6B,CAAC;CACpC,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,KAAK,QAAQ,GACrD,IAAI,MAAM,SAAS,SACjB;MAAI,MAAM,SAAS,QAAQ,MAAM,YAC/B,YAAY,OAAO,MAAM;CAAU,OAChC;EACL,MAAM,SAAS,gBAAgB,OAAO,IAAI;EAC1C,IAAI,OAAO,KAAK,MAAM,EAAE,QAAQ;GAC9B,MAAM,aAAa,WAAW,OAAO,MAAM;GAC3C,YAAY,OAAO,MAAM,WAAW,WAAW,SAAS,IAAI;EAC9D;CACF;CAEF,OAAO;AACT;AAEA,SAAS,gBACP,WACA,eACyB;CACzB,IAAI,OAAO,cAAc,YAAY,OAAO;CAC5C,IAAI,cAAc,MAAM,OAAO,gBAAgB,CAAC,IAAI;CACpD,MAAM,SAA2B,CAAC;CAClC,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAC/B,aAAa,CAAC,CACjB,GAAG;EACD,MAAM,SAAS,gBAAgB,OAAO,aAAa;EACnD,IAAI,WAAW,QAAQ,OAAO,KAAK,MAAM,EAAE,QAAQ,OAAO,OAAO;CACnE;CACA,OAAO;AACT;AAEA,SAAS,gBACP,MACA,OACyB;CACzB,IAAI,SAAS,QAAQ,UAAU,MAAM,OAAO;CAC5C,MAAM,SAAS,EAAE,GAAG,KAAK;CACzB,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,KAAK,GAC7C,OAAO,OAAO,OAAO,OAAO,MAAM,GAAG,IACjC,gBACE,KAAK,MACL,KACF,IACA;CACN,OAAO;AACT;AAEA,SAAS,aACP,UACA,OACA,SACA,WACA;CACA,IAAI,QACF,SAAS,SAAS,UACd,QACA,SAAS,SAAS,YAClB,UACA;CACN,KAAK,MAAM,OAAO,SAAS,MAAM,QAAQ,QAAQ;CACjD,OAAO;AACT;AAEA,SAAS,YACP,MACA,OACA,SACA,WACA,oBACA;CACA,MAAM,SAAkC,CAAC;CACzC,KAAK,MAAM,CAAC,KAAK,SAAS,OAAO,QAAQ,KAAK,QAAQ,GACpD,IAAI,KAAK,SAAS,UAChB;MACE,KAAK,OAAO,MAAM,UAChB,MAAM,OACH,aACC,aAAa,UAAU,OAAO,SAAS,SAAS,MAAM,MAC1D,CACF,GAEA,OAAO,OAAO,YACZ,MACA,OACA,SACA,WACA,kBACF;CACF,OACK;EACL,IACE,KAAK,QAAQ,MACV,aACC,aAAa,UAAU,OAAO,SAAS,SAAS,MAAM,MAC1D,GAEA;EACF,MAAM,QAAQ,aAAa,MAAM,OAAO,SAAS,SAAS;EAC1D,IAAI,KAAK,UAAU;GACjB,MAAM,WACJ,KAAK,WAAW,aACZ,mBAAmB,IAAI,KAAK,QAAQ,IACpC,KAAK,SAAS,KAAK;GACzB,OAAO,OACL,KAAK,WAAW,cAAc,sBAAsB,QAAQ,IACxD,MAAM,YACN;EACR,OAAO,IACL,UAAU,UACV,KAAK,YAAY,eAAe,YAEhC,OAAO,OAAO;CAClB;CAEF,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;CACrE,MAAM,iBAAiB,WAAW,OAAO,KACvC,iBAAiB,SAAS,CAC5B;CACA,MAAM,oBAAoB,OAAO,OAC/B,8BAA8B,SAAS,GACvC,EACE,SAAS;EACP,OAAO,GAAG,sBAAsB,UAAU;CAC5C,EACF,CACF;CAEA,SAAS,eAAe,YAKrB;EACD,MAAM,UAAU,WAAW,OAAO,WAAW,CAAC;EAC9C,MAAM,SAAS,WAAW,UAAU,CAAC;EACrC,IACE,WAAW,YAAY,UACvB,WAAW,YAAY,iBACvB,WAAW,YAAY,gBAEvB,MAAM,IAAI,yBAAyB,kCAAkC;EAEvE,MAAM,oBACJ,OAAO,YAAY,aACf,QAAQ;GAAE,MAAM,WAAW,OAAO,QAAQ,UAAU;GAAG;EAAS,CAAC,IACjE;EAEN,SAAS,QAAQ,WAA6B,MAA2B;GACvE,IAAI,OAAO,WAAW,CAAC,CAAC;GACxB,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,SAAS,GAAG;IACpD,IAAI;IACJ,IAAI,QAAQ,WAAW;KACrB,IACE,UAAU,QACV,OAAO,UAAU,eAChB,CAAC,SAAS,OAAO,UAAU,YAAY,MAAM,QAAQ,KAAK,IAE3D,MAAM,IAAI,yBACR,qCACF;KAEF,OACE,OAAO,UAAU,aACb,WAAW,EACT,SAAS;MACP,MAAM;MACN,QAAQ;MACR,MAAM;MACN,MAAM,CAAC;MACP,UAAU;KACZ,EACF,CAAC,IACD,WAAW,mBAAmB,OAAO,IAAI;IACjD,OAAO,IACL,QAAQ,gBACP,UAAU,QAAQ,OAAO,UAAU,aAEpC,OAAO,WAAW,EAChB,WAAW;KACT,MAAM;KACN,QAAQ;KACR,MAAM,UAAU,QAAQ,SAAS,UAAU,UAAU;KACrD,MAAM,UAAU,QAAQ,SAAS,UAAU,CAAC,WAAW,IAAI,CAAC;KAC5D,UACE,OAAO,UAAU,aACZ,QACD;KACN,YACE,UAAU,QAAQ,SAAS,UACvB,WAAW,MAAM,QAAQ,IACzB;IACR,EACF,CAAC;SAED,MAAM,IAAI,yBACR,4BAA4B,IAAI,GAClC;IACF,OAAO,WAAW,MAAM,IAAI;GAC9B;GACA,OAAO;EACT;EAEA,IAAI,WAAW,QAAQ,SAAS,OAAO;EACvC,MAAM,SAAS,WACb,OAAO,YACL,OAAO,QAAQ,WAAW,OAAO,UAAU,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,WAAW,CACnE,KACA;GACE,MAAM;GACN,QAAQ;GACR,MAAM;GACN,MAAM,CAAC,GAAG;GACV,YAAY;EACd,CACF,CAAC,CACH,CACF;EACA,WAAW,WAAW,UAAU,MAAM;EACtC,MAAM,WAAW,QAAQ,QAAQ,SAAS;EAC1C,MAAM,OAAO,WAAW,UAAU,UAAU,WAAW,OAAO;EAC9D,MAAM,oBAAoB,gBACxB,0BAA0B,UAAU,QAAQ,GAC5C,OACF;EAEA,MAAM,6BAA6B,gBAAgB,MAAM,OAAO;EAChE,MAAM,UAAU,gBACd,gBAAgB,QAAQ,SAAS,IAAI,GACrC,gBAAgB,OAAO,SAAS,KAAK,CACvC;EACA,MAAM,oBACJ,YAAY,OACR,oBACA,gBACE,WAAW,mBAAmB,SAAS,SAAS,GAChD,SACF;EACN,MAAM,oBAAoB,IAAI,IAC5B,CAAC,QAAQ,WAAW,OAAO,SAAS,EAAE,QACnC,aACC,OAAO,aAAa,UACxB,CACF;EACA,MAAM,eAAe,OAAO,KAAK,iBAAiB,EAAE,SAAS;EAC7D,IAAI,gBAAgB,OAAO,OAAO,mBAAmB,SAAS,GAC5D,MAAM,IAAI,yBACR,0DACF;EAGF,OAAO,SAAS,SAAS,QAAiC,CAAC,GAAG;GAK5D,cAHoB,WAAW,UAC3B,oBACA,4BACuB,KAAK;GAChC,IACE,gBACA,MAAM,YAAY,WACjB,MAAM,YAAY,QACjB,OAAO,MAAM,YAAY,YACzB,MAAM,QAAQ,MAAM,OAAO,IAE7B,MAAM,IAAI,yBACR,4CACF;GAEF,MAAM,SAAU,MAAM,WAAW,CAAC;GAClC,cAAc,mBAAmB,MAAM;GAEvC,MAAM,qCAAyC,IAAI,IAAI;GACvD,KAAK,MAAM,YAAY,mBAAmB;IACxC,MAAM,WAAW,SAAS,iBAAiB;IAC3C,IAAI,sBAAsB,QAAQ,GAChC,cAAc,EAAE,WAAW,eAAe,GAAG,KAAK;IACpD,mBAAmB,IAAI,UAAU,QAAQ;GAC3C;GACA,OAAO,WAAW,GAChB,YAAY,MAAM,OAAO,QAAQ,mBAAmB,kBAAkB,CACxE;EACF;CACF;CACA,OAAO;AACT"}

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

@@ -10,7 +10,8 @@ import { IsSubResourceKey, IsSubResourceKeyOptions, IsSubResourceKeyResult } fro
 import { ComponentTypes, CreateResourceConfigFn, CreateResourceConfigForResource, CreatedResourceConfig, GetComponent, GetComponentAtBound, GetComponentForResource, GetComponentForResourceOptions, GetComponentOptions, GetComponentOptionsForResource, ResourceConfigFragment, ResourceConfigPath, ResourceFromGetComponentBound, SubResourceFromGetComponentBound, ValidateForResourceBound } from "./get-component.cjs";
 import { CreateResourceLinkConfig, CreateResourceLinkGroupInput, CreateResourceLinkGroupOptions, CreateResourceLinkOptions, CreateResourceLinksFn, CreateResourceLinksWithGroups, CreateResourceLinksWithGroupsFn, CreateResourceLinksWithGroupsResult, CreateResourceMap, CreateResourceMapFn, CreatedResourceHref, CreatedResourceLink, CreatedResourceLinkBase, CreatedResourceMap, DefineResourceIconFn, DefineResourceIconInputHelpers, DefineResourceIconInputResult, FindResolvedResourceGroupResult, FindResourceGroupResult, InferHashFromResourceLinkHref, ResolveResourceIconInput, ResolvedResourceLinksWithGroups, ResolvedResourceLinksWithGroupsResult, ResourceAnchorLinkFn, ResourceIcon, ResourceIconFn, ResourceLinkHref, ValidateResource } from "./create-resource-links.cjs";
 import { ContextualInlineRenderState, ContextualInlineRenderStates, CreateResourceLayoutFn, CreateResourceLayoutMakeComposableOptions, CreateResourceLayoutWithLayoutOptions, CreateViewMapBuiltInRenderStatesOptions, CreateViewMapFunctionRenderOptions, CreateViewMapInlineRenderStatesOptions, CreateViewMapOptions, CreateViewMapRenderStatesOptions, DefineResourceLayout, DefineResourceLayoutFn, DefineResourceLayoutForResources, DefineResourceLayoutForResourcesFactory, DefineResourceLayoutWithLayoutFn, DefineResourcesFn, DefinedResourceLayout, DefinedResourceLayoutWithShell, LayoutDefinition, LayoutIncludeProps, LayoutRenderResourcesAccessor, LayoutResourcesAccessor, ResourceLayoutProvider, ResourceLayoutProviderProps, ResourceLayoutShellComponent, ResourceLayoutShellProps, ResourceSelection, ShellLayoutDefinition, ShellRenderContext, TypedBuiltInRenderStates, TypedInlineRenderState, defineResourceLayout } from "./define-layout.cjs";
-import { CreateReusable, ReusableInclude, ReusableOptionSelection, ReusableProps } from "./create-reusable.cjs";
+import { ReusableResourcesAccessor, SingleResourceInput } from "./reusable-resource-input.cjs";
+import { CreateReusable, ReusableArguments, ReusableDefinition, ReusableFunction, ReusableInclude, ReusableInput, ReusableOptionSelection, ReusableOverlap, ReusableProps, ReusableResolved, ReusableSelected } from "./reusable-types.cjs";
 import { LazyResourceLayoutComponent, LazyResourceLayoutOptions } from "./lazy-resource-layout.cjs";
 import { BoundDefineResourceLayout, CreateDefinedResourceLayoutOptions, CreateDefinedResourceLayoutResult, DefineLazyDefaults, DefinedResourceLayoutInput, NonEmptyResources, createDefinedResourceLayout } from "./create-defined-resource-layout.cjs";
 import { ResourceLayoutShellPublisher } from "./shell-context.cjs";

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

@@ -10,7 +10,8 @@ import { IsSubResourceKey, IsSubResourceKeyOptions, IsSubResourceKeyResult } fro
 import { ComponentTypes, CreateResourceConfigFn, CreateResourceConfigForResource, CreatedResourceConfig, GetComponent, GetComponentAtBound, GetComponentForResource, GetComponentForResourceOptions, GetComponentOptions, GetComponentOptionsForResource, ResourceConfigFragment, ResourceConfigPath, ResourceFromGetComponentBound, SubResourceFromGetComponentBound, ValidateForResourceBound } from "./get-component.mjs";
 import { CreateResourceLinkConfig, CreateResourceLinkGroupInput, CreateResourceLinkGroupOptions, CreateResourceLinkOptions, CreateResourceLinksFn, CreateResourceLinksWithGroups, CreateResourceLinksWithGroupsFn, CreateResourceLinksWithGroupsResult, CreateResourceMap, CreateResourceMapFn, CreatedResourceHref, CreatedResourceLink, CreatedResourceLinkBase, CreatedResourceMap, DefineResourceIconFn, DefineResourceIconInputHelpers, DefineResourceIconInputResult, FindResolvedResourceGroupResult, FindResourceGroupResult, InferHashFromResourceLinkHref, ResolveResourceIconInput, ResolvedResourceLinksWithGroups, ResolvedResourceLinksWithGroupsResult, ResourceAnchorLinkFn, ResourceIcon, ResourceIconFn, ResourceLinkHref, ValidateResource } from "./create-resource-links.mjs";
 import { ContextualInlineRenderState, ContextualInlineRenderStates, CreateResourceLayoutFn, CreateResourceLayoutMakeComposableOptions, CreateResourceLayoutWithLayoutOptions, CreateViewMapBuiltInRenderStatesOptions, CreateViewMapFunctionRenderOptions, CreateViewMapInlineRenderStatesOptions, CreateViewMapOptions, CreateViewMapRenderStatesOptions, DefineResourceLayout, DefineResourceLayoutFn, DefineResourceLayoutForResources, DefineResourceLayoutForResourcesFactory, DefineResourceLayoutWithLayoutFn, DefineResourcesFn, DefinedResourceLayout, DefinedResourceLayoutWithShell, LayoutDefinition, LayoutIncludeProps, LayoutRenderResourcesAccessor, LayoutResourcesAccessor, ResourceLayoutProvider, ResourceLayoutProviderProps, ResourceLayoutShellComponent, ResourceLayoutShellProps, ResourceSelection, ShellLayoutDefinition, ShellRenderContext, TypedBuiltInRenderStates, TypedInlineRenderState, defineResourceLayout } from "./define-layout.mjs";
-import { CreateReusable, ReusableInclude, ReusableOptionSelection, ReusableProps } from "./create-reusable.mjs";
+import { ReusableResourcesAccessor, SingleResourceInput } from "./reusable-resource-input.mjs";
+import { CreateReusable, ReusableArguments, ReusableDefinition, ReusableFunction, ReusableInclude, ReusableInput, ReusableOptionSelection, ReusableOverlap, ReusableProps, ReusableResolved, ReusableSelected } from "./reusable-types.mjs";
 import { LazyResourceLayoutComponent, LazyResourceLayoutOptions } from "./lazy-resource-layout.mjs";
 import { BoundDefineResourceLayout, CreateDefinedResourceLayoutOptions, CreateDefinedResourceLayoutResult, DefineLazyDefaults, DefinedResourceLayoutInput, NonEmptyResources, createDefinedResourceLayout } from "./create-defined-resource-layout.mjs";
 import { ResourceLayoutShellPublisher } from "./shell-context.mjs";

package/dist/create-config/merge-layout-props.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"merge-layout-props.cjs","names":[],"sources":["../../src/create-config/merge-layout-props.ts"],"sourcesContent":["/** Merge contracts by section and prop key; the closest declaration wins. */\nexport function mergeLayoutProps<\n  A extends { include?: object; custom?: object } | undefined,\n  B extends { include?: object; custom?: object } | undefined\n>(base: A, local: B) {\n  if (!base && !local) return undefined;\n  return {\n    include: { ...base?.include, ...local?.include },\n    custom: { ...base?.custom, ...local?.custom },\n  } as {\n    include: NonNullable<A>['include'] & NonNullable<B>['include'];\n    custom: NonNullable<A>['custom'] & NonNullable<B>['custom'];\n  };\n}\n"],"mappings":";;;AACA,SAAgB,iBAGd,MAAS,OAAU;CACnB,IAAI,CAAC,QAAQ,CAAC,OAAO,OAAO;CAC5B,OAAO;EACL,SAAS;GAAE,GAAG,MAAM;GAAS,GAAG,OAAO;EAAQ;EAC/C,QAAQ;GAAE,GAAG,MAAM;GAAQ,GAAG,OAAO;EAAO;CAC9C;AAIF"}
+{"version":3,"file":"merge-layout-props.cjs","names":[],"sources":["../../src/create-config/merge-layout-props.ts"],"sourcesContent":["import type { PropsContract } from '../props';\n\n/** Merge contracts by section and prop key; the closest declaration wins. */\nexport function mergeLayoutProps<\n  A extends PropsContract | undefined,\n  B extends PropsContract | undefined\n>(base: A, local: B) {\n  if (!base && !local) return undefined;\n  return {\n    include: { ...base?.include, ...local?.include },\n    custom: { ...base?.custom, ...local?.custom },\n  } as {\n    include: NonNullable<A>['include'] & NonNullable<B>['include'];\n    custom: NonNullable<A>['custom'] & NonNullable<B>['custom'];\n  };\n}\n"],"mappings":";;;AAGA,SAAgB,iBAGd,MAAS,OAAU;CACnB,IAAI,CAAC,QAAQ,CAAC,OAAO,OAAO;CAC5B,OAAO;EACL,SAAS;GAAE,GAAG,MAAM;GAAS,GAAG,OAAO;EAAQ;EAC/C,QAAQ;GAAE,GAAG,MAAM;GAAQ,GAAG,OAAO;EAAO;CAC9C;AAIF"}

package/dist/create-config/merge-layout-props.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"merge-layout-props.mjs","names":[],"sources":["../../src/create-config/merge-layout-props.ts"],"sourcesContent":["/** Merge contracts by section and prop key; the closest declaration wins. */\nexport function mergeLayoutProps<\n  A extends { include?: object; custom?: object } | undefined,\n  B extends { include?: object; custom?: object } | undefined\n>(base: A, local: B) {\n  if (!base && !local) return undefined;\n  return {\n    include: { ...base?.include, ...local?.include },\n    custom: { ...base?.custom, ...local?.custom },\n  } as {\n    include: NonNullable<A>['include'] & NonNullable<B>['include'];\n    custom: NonNullable<A>['custom'] & NonNullable<B>['custom'];\n  };\n}\n"],"mappings":";;AACA,SAAgB,iBAGd,MAAS,OAAU;CACnB,IAAI,CAAC,QAAQ,CAAC,OAAO,OAAO;CAC5B,OAAO;EACL,SAAS;GAAE,GAAG,MAAM;GAAS,GAAG,OAAO;EAAQ;EAC/C,QAAQ;GAAE,GAAG,MAAM;GAAQ,GAAG,OAAO;EAAO;CAC9C;AAIF"}
+{"version":3,"file":"merge-layout-props.mjs","names":[],"sources":["../../src/create-config/merge-layout-props.ts"],"sourcesContent":["import type { PropsContract } from '../props';\n\n/** Merge contracts by section and prop key; the closest declaration wins. */\nexport function mergeLayoutProps<\n  A extends PropsContract | undefined,\n  B extends PropsContract | undefined\n>(base: A, local: B) {\n  if (!base && !local) return undefined;\n  return {\n    include: { ...base?.include, ...local?.include },\n    custom: { ...base?.custom, ...local?.custom },\n  } as {\n    include: NonNullable<A>['include'] & NonNullable<B>['include'];\n    custom: NonNullable<A>['custom'] & NonNullable<B>['custom'];\n  };\n}\n"],"mappings":";;AAGA,SAAgB,iBAGd,MAAS,OAAU;CACnB,IAAI,CAAC,QAAQ,CAAC,OAAO,OAAO;CAC5B,OAAO;EACL,SAAS;GAAE,GAAG,MAAM;GAAS,GAAG,OAAO;EAAQ;EAC/C,QAAQ;GAAE,GAAG,MAAM;GAAQ,GAAG,OAAO;EAAO;CAC9C;AAIF"}

package/dist/create-config/reusable-resource-input.cjs

@@ -0,0 +1,22 @@
+
+//#region src/create-config/reusable-resource-input.ts
+const singleResourceInput = Symbol("react-layout.single-resource-input");
+function isSingleResourceInput(value) {
+	return value !== null && typeof value === "object" && singleResourceInput in value;
+}
+function getResourcePaths(resources, prefix = "") {
+	const paths = [];
+	for (const resource of resources) {
+		const key = typeof resource === "string" ? resource : resource.value;
+		const path = prefix ? `${prefix}.${key}` : key;
+		paths.push(path);
+		if (typeof resource !== "string") paths.push(...getResourcePaths(resource.subResources, path));
+	}
+	return paths;
+}
+
+//#endregion
+exports.getResourcePaths = getResourcePaths;
+exports.isSingleResourceInput = isSingleResourceInput;
+exports.singleResourceInput = singleResourceInput;
+//# sourceMappingURL=reusable-resource-input.cjs.map

package/dist/create-config/reusable-resource-input.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"reusable-resource-input.cjs","names":[],"sources":["../../src/create-config/reusable-resource-input.ts"],"sourcesContent":["import type { LayoutResourcesAccessor } from './define-layout';\nimport type { ResourceDefinition } from '../resource';\n\nexport const singleResourceInput = Symbol('react-layout.single-resource-input');\n\n/** Describes one configured resource path supplied by the reusable's caller. */\nexport type SingleResourceInput<\n  Resources extends readonly ResourceDefinition[],\n> = {\n  readonly [singleResourceInput]: Resources;\n};\n\n/** Resource selector capabilities available to reusable definitions. */\nexport type ReusableResourcesAccessor<\n  Resources extends readonly ResourceDefinition[],\n> = LayoutResourcesAccessor<Resources> & {\n  single(): SingleResourceInput<Resources>;\n};\n\nexport function isSingleResourceInput(\n  value: unknown,\n): value is SingleResourceInput<readonly ResourceDefinition[]> {\n  return (\n    value !== null && typeof value === 'object' && singleResourceInput in value\n  );\n}\n\nexport function getResourcePaths(\n  resources: readonly ResourceDefinition[],\n  prefix = '',\n) {\n  const paths: string[] = [];\n  for (const resource of resources) {\n    const key = typeof resource === 'string' ? resource : resource.value;\n    const path = prefix ? `${prefix}.${key}` : key;\n    paths.push(path);\n    if (typeof resource !== 'string')\n      paths.push(...getResourcePaths(resource.subResources, path));\n  }\n  return paths;\n}\n"],"mappings":";;AAGA,MAAa,sBAAsB,OAAO,oCAAoC;AAgB9E,SAAgB,sBACd,OAC6D;CAC7D,OACE,UAAU,QAAQ,OAAO,UAAU,YAAY,uBAAuB;AAE1E;AAEA,SAAgB,iBACd,WACA,SAAS,IACT;CACA,MAAM,QAAkB,CAAC;CACzB,KAAK,MAAM,YAAY,WAAW;EAChC,MAAM,MAAM,OAAO,aAAa,WAAW,WAAW,SAAS;EAC/D,MAAM,OAAO,SAAS,GAAG,OAAO,GAAG,QAAQ;EAC3C,MAAM,KAAK,IAAI;EACf,IAAI,OAAO,aAAa,UACtB,MAAM,KAAK,GAAG,iBAAiB,SAAS,cAAc,IAAI,CAAC;CAC/D;CACA,OAAO;AACT"}

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

@@ -0,0 +1,16 @@
+import { ResourceDefinition } from "../resource.cjs";
+import { LayoutResourcesAccessor } from "./define-layout.cjs";
+
+//#region src/create-config/reusable-resource-input.d.ts
+declare const singleResourceInput: unique symbol;
+/** Describes one configured resource path supplied by the reusable's caller. */
+type SingleResourceInput<Resources extends readonly ResourceDefinition[]> = {
+  readonly [singleResourceInput]: Resources;
+};
+/** Resource selector capabilities available to reusable definitions. */
+type ReusableResourcesAccessor<Resources extends readonly ResourceDefinition[]> = LayoutResourcesAccessor<Resources> & {
+  single(): SingleResourceInput<Resources>;
+};
+//#endregion
+export { ReusableResourcesAccessor, SingleResourceInput };
+//# sourceMappingURL=reusable-resource-input.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reusable-resource-input.d.cts","names":[],"sources":["../../src/create-config/reusable-resource-input.ts"],"mappings":";;;;cAGa,mBAAA;;KAGD,mBAAA,4BACiB,kBAAA;EAAA,UAEjB,mBAAA,GAAsB,SAAA;AAAA;;KAItB,yBAAA,4BACiB,kBAAA,MACzB,uBAAA,CAAwB,SAAA;EAC1B,MAAA,IAAU,mBAAA,CAAoB,SAAA;AAAA"}

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

@@ -0,0 +1,16 @@
+import { ResourceDefinition } from "../resource.mjs";
+import { LayoutResourcesAccessor } from "./define-layout.mjs";
+
+//#region src/create-config/reusable-resource-input.d.ts
+declare const singleResourceInput: unique symbol;
+/** Describes one configured resource path supplied by the reusable's caller. */
+type SingleResourceInput<Resources extends readonly ResourceDefinition[]> = {
+  readonly [singleResourceInput]: Resources;
+};
+/** Resource selector capabilities available to reusable definitions. */
+type ReusableResourcesAccessor<Resources extends readonly ResourceDefinition[]> = LayoutResourcesAccessor<Resources> & {
+  single(): SingleResourceInput<Resources>;
+};
+//#endregion
+export { ReusableResourcesAccessor, SingleResourceInput };
+//# sourceMappingURL=reusable-resource-input.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reusable-resource-input.d.mts","names":[],"sources":["../../src/create-config/reusable-resource-input.ts"],"mappings":";;;;cAGa,mBAAA;;KAGD,mBAAA,4BACiB,kBAAA;EAAA,UAEjB,mBAAA,GAAsB,SAAA;AAAA;;KAItB,yBAAA,4BACiB,kBAAA,MACzB,uBAAA,CAAwB,SAAA;EAC1B,MAAA,IAAU,mBAAA,CAAoB,SAAA;AAAA"}

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

@@ -0,0 +1,19 @@
+//#region src/create-config/reusable-resource-input.ts
+const singleResourceInput = Symbol("react-layout.single-resource-input");
+function isSingleResourceInput(value) {
+	return value !== null && typeof value === "object" && singleResourceInput in value;
+}
+function getResourcePaths(resources, prefix = "") {
+	const paths = [];
+	for (const resource of resources) {
+		const key = typeof resource === "string" ? resource : resource.value;
+		const path = prefix ? `${prefix}.${key}` : key;
+		paths.push(path);
+		if (typeof resource !== "string") paths.push(...getResourcePaths(resource.subResources, path));
+	}
+	return paths;
+}
+
+//#endregion
+export { getResourcePaths, isSingleResourceInput, singleResourceInput };
+//# sourceMappingURL=reusable-resource-input.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reusable-resource-input.mjs","names":[],"sources":["../../src/create-config/reusable-resource-input.ts"],"sourcesContent":["import type { LayoutResourcesAccessor } from './define-layout';\nimport type { ResourceDefinition } from '../resource';\n\nexport const singleResourceInput = Symbol('react-layout.single-resource-input');\n\n/** Describes one configured resource path supplied by the reusable's caller. */\nexport type SingleResourceInput<\n  Resources extends readonly ResourceDefinition[],\n> = {\n  readonly [singleResourceInput]: Resources;\n};\n\n/** Resource selector capabilities available to reusable definitions. */\nexport type ReusableResourcesAccessor<\n  Resources extends readonly ResourceDefinition[],\n> = LayoutResourcesAccessor<Resources> & {\n  single(): SingleResourceInput<Resources>;\n};\n\nexport function isSingleResourceInput(\n  value: unknown,\n): value is SingleResourceInput<readonly ResourceDefinition[]> {\n  return (\n    value !== null && typeof value === 'object' && singleResourceInput in value\n  );\n}\n\nexport function getResourcePaths(\n  resources: readonly ResourceDefinition[],\n  prefix = '',\n) {\n  const paths: string[] = [];\n  for (const resource of resources) {\n    const key = typeof resource === 'string' ? resource : resource.value;\n    const path = prefix ? `${prefix}.${key}` : key;\n    paths.push(path);\n    if (typeof resource !== 'string')\n      paths.push(...getResourcePaths(resource.subResources, path));\n  }\n  return paths;\n}\n"],"mappings":";AAGA,MAAa,sBAAsB,OAAO,oCAAoC;AAgB9E,SAAgB,sBACd,OAC6D;CAC7D,OACE,UAAU,QAAQ,OAAO,UAAU,YAAY,uBAAuB;AAE1E;AAEA,SAAgB,iBACd,WACA,SAAS,IACT;CACA,MAAM,QAAkB,CAAC;CACzB,KAAK,MAAM,YAAY,WAAW;EAChC,MAAM,MAAM,OAAO,aAAa,WAAW,WAAW,SAAS;EAC/D,MAAM,OAAO,SAAS,GAAG,OAAO,GAAG,QAAQ;EAC3C,MAAM,KAAK,IAAI;EACf,IAAI,OAAO,aAAa,UACtB,MAAM,KAAK,GAAG,iBAAiB,SAAS,cAAc,IAAI,CAAC;CAC/D;CACA,OAAO;AACT"}