@jfdevelops/react-layout 2.3.0 → 2.5.0

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

@@ -0,0 +1,139 @@
+import { Show } from "../utils.cjs";
+import { ResourceDefinition, ResourceEnum, ResourcePath } from "../resource.cjs";
+import { InPropsDefinition, InPropsObject, InferredInProps, PropsContract } from "../props.cjs";
+import { LayoutResourcesAccessor } from "./define-layout.cjs";
+import { ReusableResourcesAccessor, SingleResourceInput } from "./reusable-resource-input.cjs";
+import { AnyBuiltPropDefinition, ExtractDefinitionValue, ResolvedBuiltPropShape } from "@jfdevelops/react-layout-validator";
+
+//#region src/create-config/reusable-types.d.ts
+type Selector<Source> = (source: Source) => unknown;
+type OptionValue<Definition extends AnyBuiltPropDefinition> = ExtractDefinitionValue<Definition> | (Definition['visibility'] extends 'optional' ? undefined : never);
+/** Select or transform resolved option values, or drill into object values. */
+type ReusableOptionSelection<Props extends InPropsObject> = { [Key in keyof Props]?: Props[Key] extends {
+  type: 'object';
+  properties: infer Shape extends InPropsObject;
+} ? true | Selector<OptionValue<Props[Key]>> | ReusableOptionSelection<Shape> : true | Selector<OptionValue<Props[Key]>> };
+type ResolvedResourceSelection<Resources extends readonly ResourceDefinition[], Result> = Result extends SingleResourceInput<readonly ResourceDefinition[]> ? ResourcePath<Resources> : Result;
+type ResourceCallerInput<Resources extends readonly ResourceDefinition[], Contract> = Contract extends {
+  resources: (...args: any[]) => infer Result;
+} ? Extract<Result, SingleResourceInput<readonly ResourceDefinition[]>> extends never ? {} : {
+  resources: ResourcePath<Resources>;
+} : {};
+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 | Selector<ReusableResourcesAccessor<Resources>>;
+} & (keyof OptionDefinitions<Resources, Options> extends never ? {} : {
+  options?: true | Selector<ResolvedBuiltPropShape<OptionDefinitions<Resources, Options>>> | ReusableOptionSelection<OptionDefinitions<Resources, Options>>;
+});
+type SelectedOptionValue<Definition extends AnyBuiltPropDefinition, Selection> = Selection extends true ? ExtractDefinitionValue<Definition> : Selection extends ((...args: any[]) => infer Result) ? Result : Definition extends {
+  properties: infer Shape extends InPropsObject;
+} ? SelectedOptionProps<Shape, Selection> : never;
+type SelectedOptionProps<Props extends InPropsObject, Selection> = { [Key in keyof Props & keyof Selection as Selection[Key] extends Selector<any> ? Key : Props[Key]['visibility'] extends 'required' ? Key : never]: SelectedOptionValue<Props[Key], Selection[Key]> } & { [Key in keyof Props & keyof Selection as Selection[Key] extends Selector<any> ? never : 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 {
+  resources: (...args: any[]) => infer Result;
+} ? {
+  resources: ResolvedResourceSelection<Resources, Result>;
+} : {}) & (Include extends {
+  options: infer Selection;
+} ? Selection extends ((...args: any[]) => infer Result) ? {
+  options: Result;
+} : Selection extends true ? ResolvedBuiltPropShape<OptionDefinitions<Resources, Options>> : SelectedOptionProps<OptionDefinitions<Resources, Options>, Selection> : {}) & ResolvedBuiltPropShape<Custom>;
+/** Data selected for the reusable's single callback argument. */
+type ReusableSelected<Resources extends readonly ResourceDefinition[], Options extends InPropsDefinition<Resources>, Selection> = (Selection extends {
+  resources: infer Value;
+} ? {
+  resources: Value extends ((...args: any[]) => infer Result) ? ResolvedResourceSelection<Resources, Result> : LayoutResourcesAccessor<Resources>;
+} : {}) & (Selection extends {
+  options: infer Value;
+} ? Value extends ((...args: any[]) => infer Result) ? {
+  options: Result;
+} : SelectedValues<OptionDefinitions<Resources, Options>, Value> : {});
+type ReusableOverlap = 'preferProps' | 'preferSelect';
+type SelectionShape<Props extends InPropsObject, Selection> = Selection extends Selector<any> ? 'value' : { [Key in keyof Props & (Selection extends true ? keyof Props : keyof Selection)]: SelectionAt<Selection, Key> extends Selector<any> ? 'value' : Props[Key] extends {
+  properties: infer Shape extends InPropsObject;
+} ? SelectionShape<Shape, SelectionAt<Selection, Key>> : 'value' };
+type ContractShape<Props extends InPropsObject, Contract, Custom> = (Contract extends {
+  resources: unknown;
+} ? {
+  resources: 'value';
+} : {}) & (Contract extends {
+  options: infer Selection;
+} ? Selection extends Selector<any> ? {
+  options: 'value';
+} : SelectionShape<Props, Selection> : {}) & { [Key in keyof Custom]: 'value' };
+type MergeValue<Left, Right, Overlap, LeftShape, RightShape> = LeftShape extends object ? RightShape extends object ? MergeValues<NonNullable<Left>, NonNullable<Right>, Overlap, LeftShape, RightShape> : Overlap extends 'preferSelect' ? Right : Left : Overlap extends 'preferSelect' ? Right : Left;
+type SharedKeys<Left, Right> = keyof Left & keyof Right;
+type OptionalSharedKeys<Left, Right, Overlap, LeftShape, RightShape> = { [Key in SharedKeys<Left, Right>]: Key extends keyof LeftShape ? Key extends keyof RightShape ? LeftShape[Key] extends object ? RightShape[Key] extends object ? {} extends Pick<Left, Key> ? {} extends Pick<Right, Key> ? Key : never : never : Overlap extends 'preferSelect' ? {} extends Pick<Right, Key> ? Key : never : {} extends Pick<Left, Key> ? Key : never : Overlap extends 'preferSelect' ? {} extends Pick<Right, Key> ? Key : never : {} extends Pick<Left, Key> ? Key : never : never : never }[SharedKeys<Left, Right>];
+type MergeValues<Left, Right, Overlap, LeftShape, RightShape> = Omit<Left, keyof Right> & Omit<Right, keyof Left> & { [Key in Exclude<SharedKeys<Left, Right>, OptionalSharedKeys<Left, Right, Overlap, LeftShape, RightShape>>]: MergeValue<Left[Key], Right[Key], Overlap, Key extends keyof LeftShape ? LeftShape[Key] : 'value', Key extends keyof RightShape ? RightShape[Key] : 'value'> } & { [Key in OptionalSharedKeys<Left, Right, Overlap, LeftShape, RightShape>]?: MergeValue<Left[Key], Right[Key], Overlap, Key extends keyof LeftShape ? LeftShape[Key] : 'value', Key extends keyof RightShape ? RightShape[Key] : 'value'> };
+type IndependentSources<Props extends InPropsObject, Include, Select> = keyof CallerOptions<Props, Include, Select> extends never ? false : keyof (SourceValues<Props, Include, true> & SourceValues<Props, Select, false>) extends never ? false : true;
+type BranchSelection<Selection> = Selection extends Selector<any> ? {} : Selection;
+type GuardedFields<Value, Props extends InPropsObject, Include, Select, Shape, Independent extends boolean> = { [Key in keyof Value]: Key extends keyof Props ? Key extends keyof Shape ? Shape[Key] extends object ? Props[Key] extends {
+  properties: infer Nested extends InPropsObject;
+} ? GuardedObject<NonNullable<Value[Key]>, Nested, BranchSelection<SelectionAt<Include, Key>>, BranchSelection<SelectionAt<Select, Key>>, Shape[Key], IndependentSources<Nested, BranchSelection<SelectionAt<Include, Key>>, BranchSelection<SelectionAt<Select, Key>>> extends true ? Independent extends true ? true : Props[Key]['visibility'] extends 'optional' ? true : false : false> | Extract<Value[Key], undefined> : Value[Key] : Value[Key] : Value[Key] : Value[Key] };
+type GuardedObject<Value, Props extends InPropsObject, Include, Select, Shape, Independent extends boolean = false> = Independent extends true ? Partial<GuardedFields<Value, Props, Include, Select, Shape, Independent>> : GuardedFields<Value, Props, Include, Select, Shape, Independent>;
+type MergedShape<Resources extends readonly ResourceDefinition[], Options extends InPropsDefinition<Resources>, Include, Custom, Select, Overlap> = MergeValues<ContractShape<OptionDefinitions<Resources, Options>, Include, Custom>, ContractShape<OptionDefinitions<Resources, Options>, Select, {}>, Overlap, ContractShape<OptionDefinitions<Resources, Options>, Include, Custom>, ContractShape<OptionDefinitions<Resources, Options>, Select, {}>>;
+type ReusableResolved<Resources extends readonly ResourceDefinition[], Options extends InPropsDefinition<Resources>, Include, Custom extends InPropsObject, Select, Overlap = undefined> = Expanded<GuardedObject<MergeValues<ReusableProps<Resources, Options, Include, Custom>, ReusableSelected<Resources, Options, Select>, Overlap, ContractShape<OptionDefinitions<Resources, Options>, Include, Custom>, ContractShape<OptionDefinitions<Resources, Options>, Select, {}>>, OptionDefinitions<Resources, Options>, Include extends {
+  options: infer Selection;
+} ? Selection : {}, Select extends {
+  options: infer Selection;
+} ? Selection : {}, MergedShape<Resources, Options, Include, Custom, Select, Overlap>>>;
+type SelectedValues<Props extends InPropsObject, Selection> = Selection extends ((...args: any[]) => infer Result) ? Result : Selection extends true ? ResolvedBuiltPropShape<Props> : SelectedOptionProps<Props, Selection>;
+/** Sources are derived against the finite definition tree, not arbitrary input keys. */
+type SourceValue<Definition extends AnyBuiltPropDefinition, Selection, CallbacksOnly extends boolean> = Selection extends Selector<any> ? OptionValue<Definition> : Selection extends true ? CallbacksOnly extends true ? never : OptionValue<Definition> : Definition extends {
+  properties: infer Shape extends InPropsObject;
+} ? SourceValues<Shape, Selection, CallbacksOnly> : never;
+type SourceKeys<Props extends InPropsObject, Selection, CallbacksOnly extends boolean> = { [Key in keyof Props & keyof Selection]: Selection[Key] extends Selector<any> ? Key : Selection[Key] extends true ? CallbacksOnly extends true ? never : Key : Props[Key] extends {
+  properties: infer Shape extends InPropsObject;
+} ? keyof SourceValues<Shape, Selection[Key], CallbacksOnly> extends never ? never : Key : never }[keyof Props & keyof Selection];
+type SourceValues<Props extends InPropsObject, Selection, CallbacksOnly extends boolean> = Selection extends Selector<any> ? ResolvedBuiltPropShape<Props> : Selection extends true ? CallbacksOnly extends true ? {} : ResolvedBuiltPropShape<Props> : { [Key in SourceKeys<Props, Selection, CallbacksOnly> as Props[Key]['visibility'] extends 'required' ? Key : never]: SourceValue<Props[Key], Selection[Key], CallbacksOnly> } & { [Key in SourceKeys<Props, Selection, CallbacksOnly> as Props[Key]['visibility'] extends 'optional' ? Key : never]?: SourceValue<Props[Key], Selection[Key], CallbacksOnly> };
+type OptionSource<Props extends InPropsObject, Contract, CallbacksOnly extends boolean> = Contract extends {
+  options: infer Selection;
+} ? SourceValues<Props, Selection, CallbacksOnly> : {};
+/** Expand object intersections for readable public helper signatures. */
+type Expanded<Value> = Value extends Promise<infer Result> ? Promise<Expanded<Result>> : Value extends ((...args: any[]) => any) ? Value : Value extends readonly unknown[] ? Value : Value extends object ? { [Key in keyof Value]: Expanded<Value[Key]> } : Value;
+type SourceInput<Values> = keyof Values extends never ? {} : {} extends Values ? {
+  options?: Values;
+} : {
+  options: Values;
+};
+type ReusableInput<Resources extends readonly ResourceDefinition[], Options extends InPropsDefinition<Resources>, Include, Custom extends InPropsObject, Select> = Expanded<ReusableProps<Resources, Options, CallerContract<Resources, Options, Include, Select>, Custom> & ResourceCallerInput<Resources, Include> & ResourceCallerInput<Resources, Select> & SourceInput<OptionSource<OptionDefinitions<Resources, Options>, Include, true> & OptionSource<OptionDefinitions<Resources, Options>, Select, false>>>;
+type SelectionAt<Selection, Key extends PropertyKey> = Selection extends true ? true : Key extends keyof Selection ? Selection[Key] : undefined;
+type CallerOptions<Props extends InPropsObject, Include, Select> = { [Key in keyof Props as SelectionAt<Include, Key> extends infer Value ? Value extends Selector<any> | undefined ? never : Value extends true ? SelectionAt<Select, Key> extends true ? never : Props[Key] extends {
+  properties: infer Shape extends InPropsObject;
+} ? SelectionAt<Select, Key> extends object ? keyof CallerOptions<Shape, true, SelectionAt<Select, Key>> extends never ? never : Key : Key : Key : Props[Key] extends {
+  properties: infer Shape extends InPropsObject;
+} ? keyof CallerOptions<Shape, Value, SelectionAt<Select, Key>> extends never ? never : Key : never : never]: Props[Key] extends {
+  properties: infer Shape extends InPropsObject;
+} ? SelectionAt<Include, Key> extends true ? SelectionAt<Select, Key> extends object ? CallerOptions<Shape, true, SelectionAt<Select, Key>> : true : CallerOptions<Shape, SelectionAt<Include, Key>, SelectionAt<Select, Key>> : true };
+type CallerContract<Resources extends readonly ResourceDefinition[], Options extends InPropsDefinition<Resources>, Include, Select> = (Include extends {
+  resources: true;
+} ? {
+  resources: true;
+} : {}) & (Include extends {
+  options: infer Value;
+} ? Value extends Selector<any> ? {} : {
+  options: CallerOptions<OptionDefinitions<Resources, Options>, Value, Select extends {
+    options: infer Other;
+  } ? Other : {}>;
+} : {});
+type ExactSelection<Selection, Allowed> = { [Key in keyof Selection]: Key extends keyof Allowed ? Selection[Key] extends Selector<any> ? Allowed[Key] : Selection[Key] extends object ? ExactSelection<Selection[Key], Exclude<Allowed[Key], true | undefined | Selector<any>>> : Allowed[Key] : never };
+/** Configuration accepted by the bound reusable factory. */
+type ReusableDefinition<Resources extends readonly ResourceDefinition[], Options extends InPropsDefinition<Resources>, Include extends ReusableInclude<Resources, Options>, Custom extends InPropsObject, Select extends ReusableInclude<Resources, Options>, Result, Overlap extends ReusableOverlap | undefined = undefined> = {
+  props?: PropsContract<ReusableInclude<Resources, Options> & Include & ExactSelection<Include, ReusableInclude<Resources, Options>>, Custom>;
+  select?: ReusableInclude<Resources, Options> & Select & ExactSelection<Select, ReusableInclude<Resources, Options>>; /** Resolve ambiguous leaf collisions explicitly; the default rejects them. */
+  overlap?: Overlap;
+  fn: (props: ReusableResolved<Resources, Options, Include, Custom, Select, Overlap>) => Result;
+};
+type ReusableArguments<Resources extends readonly ResourceDefinition[], Options extends InPropsDefinition<Resources>, Include, Custom extends InPropsObject, Select> = {} extends ReusableInput<Resources, Options, Include, Custom, Select> ? [props?: ReusableInput<Resources, Options, Include, Custom, Select>] : [props: ReusableInput<Resources, Options, Include, Custom, Select>];
+type ReusableFunction<Resources extends readonly ResourceDefinition[], Options extends InPropsDefinition<Resources>, Include, Custom extends InPropsObject, Select, Result> = (...args: ReusableArguments<Resources, Options, Include, Custom, Select>) => Expanded<Result>;
+/** Creates a validated function with one merged callback argument. */
+type CreateReusable<Resources extends readonly ResourceDefinition[], Options extends InPropsDefinition<Resources>> = <const Include extends ReusableInclude<Resources, Options> = {}, const Custom extends InPropsObject = {}, const Select extends ReusableInclude<Resources, Options> = {}, Result = unknown, const Overlap extends ReusableOverlap | undefined = undefined>(definition: ReusableDefinition<Resources, Options, Include, Custom, Select, Result, Overlap>) => Show<ReusableFunction<Resources, Options, Include, Custom, Select, Result>>;
+//#endregion
+export { CreateReusable, ReusableArguments, ReusableDefinition, ReusableFunction, ReusableInclude, ReusableInput, ReusableOptionSelection, ReusableOverlap, ReusableProps, ReusableResolved, ReusableSelected };
+//# sourceMappingURL=reusable-types.d.cts.map

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

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

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

@@ -0,0 +1,139 @@
+import { Show } from "../utils.mjs";
+import { ResourceDefinition, ResourceEnum, ResourcePath } from "../resource.mjs";
+import { InPropsDefinition, InPropsObject, InferredInProps, PropsContract } from "../props.mjs";
+import { LayoutResourcesAccessor } from "./define-layout.mjs";
+import { ReusableResourcesAccessor, SingleResourceInput } from "./reusable-resource-input.mjs";
+import { AnyBuiltPropDefinition, ExtractDefinitionValue, ResolvedBuiltPropShape } from "@jfdevelops/react-layout-validator";
+
+//#region src/create-config/reusable-types.d.ts
+type Selector<Source> = (source: Source) => unknown;
+type OptionValue<Definition extends AnyBuiltPropDefinition> = ExtractDefinitionValue<Definition> | (Definition['visibility'] extends 'optional' ? undefined : never);
+/** Select or transform resolved option values, or drill into object values. */
+type ReusableOptionSelection<Props extends InPropsObject> = { [Key in keyof Props]?: Props[Key] extends {
+  type: 'object';
+  properties: infer Shape extends InPropsObject;
+} ? true | Selector<OptionValue<Props[Key]>> | ReusableOptionSelection<Shape> : true | Selector<OptionValue<Props[Key]>> };
+type ResolvedResourceSelection<Resources extends readonly ResourceDefinition[], Result> = Result extends SingleResourceInput<readonly ResourceDefinition[]> ? ResourcePath<Resources> : Result;
+type ResourceCallerInput<Resources extends readonly ResourceDefinition[], Contract> = Contract extends {
+  resources: (...args: any[]) => infer Result;
+} ? Extract<Result, SingleResourceInput<readonly ResourceDefinition[]>> extends never ? {} : {
+  resources: ResourcePath<Resources>;
+} : {};
+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 | Selector<ReusableResourcesAccessor<Resources>>;
+} & (keyof OptionDefinitions<Resources, Options> extends never ? {} : {
+  options?: true | Selector<ResolvedBuiltPropShape<OptionDefinitions<Resources, Options>>> | ReusableOptionSelection<OptionDefinitions<Resources, Options>>;
+});
+type SelectedOptionValue<Definition extends AnyBuiltPropDefinition, Selection> = Selection extends true ? ExtractDefinitionValue<Definition> : Selection extends ((...args: any[]) => infer Result) ? Result : Definition extends {
+  properties: infer Shape extends InPropsObject;
+} ? SelectedOptionProps<Shape, Selection> : never;
+type SelectedOptionProps<Props extends InPropsObject, Selection> = { [Key in keyof Props & keyof Selection as Selection[Key] extends Selector<any> ? Key : Props[Key]['visibility'] extends 'required' ? Key : never]: SelectedOptionValue<Props[Key], Selection[Key]> } & { [Key in keyof Props & keyof Selection as Selection[Key] extends Selector<any> ? never : 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 {
+  resources: (...args: any[]) => infer Result;
+} ? {
+  resources: ResolvedResourceSelection<Resources, Result>;
+} : {}) & (Include extends {
+  options: infer Selection;
+} ? Selection extends ((...args: any[]) => infer Result) ? {
+  options: Result;
+} : Selection extends true ? ResolvedBuiltPropShape<OptionDefinitions<Resources, Options>> : SelectedOptionProps<OptionDefinitions<Resources, Options>, Selection> : {}) & ResolvedBuiltPropShape<Custom>;
+/** Data selected for the reusable's single callback argument. */
+type ReusableSelected<Resources extends readonly ResourceDefinition[], Options extends InPropsDefinition<Resources>, Selection> = (Selection extends {
+  resources: infer Value;
+} ? {
+  resources: Value extends ((...args: any[]) => infer Result) ? ResolvedResourceSelection<Resources, Result> : LayoutResourcesAccessor<Resources>;
+} : {}) & (Selection extends {
+  options: infer Value;
+} ? Value extends ((...args: any[]) => infer Result) ? {
+  options: Result;
+} : SelectedValues<OptionDefinitions<Resources, Options>, Value> : {});
+type ReusableOverlap = 'preferProps' | 'preferSelect';
+type SelectionShape<Props extends InPropsObject, Selection> = Selection extends Selector<any> ? 'value' : { [Key in keyof Props & (Selection extends true ? keyof Props : keyof Selection)]: SelectionAt<Selection, Key> extends Selector<any> ? 'value' : Props[Key] extends {
+  properties: infer Shape extends InPropsObject;
+} ? SelectionShape<Shape, SelectionAt<Selection, Key>> : 'value' };
+type ContractShape<Props extends InPropsObject, Contract, Custom> = (Contract extends {
+  resources: unknown;
+} ? {
+  resources: 'value';
+} : {}) & (Contract extends {
+  options: infer Selection;
+} ? Selection extends Selector<any> ? {
+  options: 'value';
+} : SelectionShape<Props, Selection> : {}) & { [Key in keyof Custom]: 'value' };
+type MergeValue<Left, Right, Overlap, LeftShape, RightShape> = LeftShape extends object ? RightShape extends object ? MergeValues<NonNullable<Left>, NonNullable<Right>, Overlap, LeftShape, RightShape> : Overlap extends 'preferSelect' ? Right : Left : Overlap extends 'preferSelect' ? Right : Left;
+type SharedKeys<Left, Right> = keyof Left & keyof Right;
+type OptionalSharedKeys<Left, Right, Overlap, LeftShape, RightShape> = { [Key in SharedKeys<Left, Right>]: Key extends keyof LeftShape ? Key extends keyof RightShape ? LeftShape[Key] extends object ? RightShape[Key] extends object ? {} extends Pick<Left, Key> ? {} extends Pick<Right, Key> ? Key : never : never : Overlap extends 'preferSelect' ? {} extends Pick<Right, Key> ? Key : never : {} extends Pick<Left, Key> ? Key : never : Overlap extends 'preferSelect' ? {} extends Pick<Right, Key> ? Key : never : {} extends Pick<Left, Key> ? Key : never : never : never }[SharedKeys<Left, Right>];
+type MergeValues<Left, Right, Overlap, LeftShape, RightShape> = Omit<Left, keyof Right> & Omit<Right, keyof Left> & { [Key in Exclude<SharedKeys<Left, Right>, OptionalSharedKeys<Left, Right, Overlap, LeftShape, RightShape>>]: MergeValue<Left[Key], Right[Key], Overlap, Key extends keyof LeftShape ? LeftShape[Key] : 'value', Key extends keyof RightShape ? RightShape[Key] : 'value'> } & { [Key in OptionalSharedKeys<Left, Right, Overlap, LeftShape, RightShape>]?: MergeValue<Left[Key], Right[Key], Overlap, Key extends keyof LeftShape ? LeftShape[Key] : 'value', Key extends keyof RightShape ? RightShape[Key] : 'value'> };
+type IndependentSources<Props extends InPropsObject, Include, Select> = keyof CallerOptions<Props, Include, Select> extends never ? false : keyof (SourceValues<Props, Include, true> & SourceValues<Props, Select, false>) extends never ? false : true;
+type BranchSelection<Selection> = Selection extends Selector<any> ? {} : Selection;
+type GuardedFields<Value, Props extends InPropsObject, Include, Select, Shape, Independent extends boolean> = { [Key in keyof Value]: Key extends keyof Props ? Key extends keyof Shape ? Shape[Key] extends object ? Props[Key] extends {
+  properties: infer Nested extends InPropsObject;
+} ? GuardedObject<NonNullable<Value[Key]>, Nested, BranchSelection<SelectionAt<Include, Key>>, BranchSelection<SelectionAt<Select, Key>>, Shape[Key], IndependentSources<Nested, BranchSelection<SelectionAt<Include, Key>>, BranchSelection<SelectionAt<Select, Key>>> extends true ? Independent extends true ? true : Props[Key]['visibility'] extends 'optional' ? true : false : false> | Extract<Value[Key], undefined> : Value[Key] : Value[Key] : Value[Key] : Value[Key] };
+type GuardedObject<Value, Props extends InPropsObject, Include, Select, Shape, Independent extends boolean = false> = Independent extends true ? Partial<GuardedFields<Value, Props, Include, Select, Shape, Independent>> : GuardedFields<Value, Props, Include, Select, Shape, Independent>;
+type MergedShape<Resources extends readonly ResourceDefinition[], Options extends InPropsDefinition<Resources>, Include, Custom, Select, Overlap> = MergeValues<ContractShape<OptionDefinitions<Resources, Options>, Include, Custom>, ContractShape<OptionDefinitions<Resources, Options>, Select, {}>, Overlap, ContractShape<OptionDefinitions<Resources, Options>, Include, Custom>, ContractShape<OptionDefinitions<Resources, Options>, Select, {}>>;
+type ReusableResolved<Resources extends readonly ResourceDefinition[], Options extends InPropsDefinition<Resources>, Include, Custom extends InPropsObject, Select, Overlap = undefined> = Expanded<GuardedObject<MergeValues<ReusableProps<Resources, Options, Include, Custom>, ReusableSelected<Resources, Options, Select>, Overlap, ContractShape<OptionDefinitions<Resources, Options>, Include, Custom>, ContractShape<OptionDefinitions<Resources, Options>, Select, {}>>, OptionDefinitions<Resources, Options>, Include extends {
+  options: infer Selection;
+} ? Selection : {}, Select extends {
+  options: infer Selection;
+} ? Selection : {}, MergedShape<Resources, Options, Include, Custom, Select, Overlap>>>;
+type SelectedValues<Props extends InPropsObject, Selection> = Selection extends ((...args: any[]) => infer Result) ? Result : Selection extends true ? ResolvedBuiltPropShape<Props> : SelectedOptionProps<Props, Selection>;
+/** Sources are derived against the finite definition tree, not arbitrary input keys. */
+type SourceValue<Definition extends AnyBuiltPropDefinition, Selection, CallbacksOnly extends boolean> = Selection extends Selector<any> ? OptionValue<Definition> : Selection extends true ? CallbacksOnly extends true ? never : OptionValue<Definition> : Definition extends {
+  properties: infer Shape extends InPropsObject;
+} ? SourceValues<Shape, Selection, CallbacksOnly> : never;
+type SourceKeys<Props extends InPropsObject, Selection, CallbacksOnly extends boolean> = { [Key in keyof Props & keyof Selection]: Selection[Key] extends Selector<any> ? Key : Selection[Key] extends true ? CallbacksOnly extends true ? never : Key : Props[Key] extends {
+  properties: infer Shape extends InPropsObject;
+} ? keyof SourceValues<Shape, Selection[Key], CallbacksOnly> extends never ? never : Key : never }[keyof Props & keyof Selection];
+type SourceValues<Props extends InPropsObject, Selection, CallbacksOnly extends boolean> = Selection extends Selector<any> ? ResolvedBuiltPropShape<Props> : Selection extends true ? CallbacksOnly extends true ? {} : ResolvedBuiltPropShape<Props> : { [Key in SourceKeys<Props, Selection, CallbacksOnly> as Props[Key]['visibility'] extends 'required' ? Key : never]: SourceValue<Props[Key], Selection[Key], CallbacksOnly> } & { [Key in SourceKeys<Props, Selection, CallbacksOnly> as Props[Key]['visibility'] extends 'optional' ? Key : never]?: SourceValue<Props[Key], Selection[Key], CallbacksOnly> };
+type OptionSource<Props extends InPropsObject, Contract, CallbacksOnly extends boolean> = Contract extends {
+  options: infer Selection;
+} ? SourceValues<Props, Selection, CallbacksOnly> : {};
+/** Expand object intersections for readable public helper signatures. */
+type Expanded<Value> = Value extends Promise<infer Result> ? Promise<Expanded<Result>> : Value extends ((...args: any[]) => any) ? Value : Value extends readonly unknown[] ? Value : Value extends object ? { [Key in keyof Value]: Expanded<Value[Key]> } : Value;
+type SourceInput<Values> = keyof Values extends never ? {} : {} extends Values ? {
+  options?: Values;
+} : {
+  options: Values;
+};
+type ReusableInput<Resources extends readonly ResourceDefinition[], Options extends InPropsDefinition<Resources>, Include, Custom extends InPropsObject, Select> = Expanded<ReusableProps<Resources, Options, CallerContract<Resources, Options, Include, Select>, Custom> & ResourceCallerInput<Resources, Include> & ResourceCallerInput<Resources, Select> & SourceInput<OptionSource<OptionDefinitions<Resources, Options>, Include, true> & OptionSource<OptionDefinitions<Resources, Options>, Select, false>>>;
+type SelectionAt<Selection, Key extends PropertyKey> = Selection extends true ? true : Key extends keyof Selection ? Selection[Key] : undefined;
+type CallerOptions<Props extends InPropsObject, Include, Select> = { [Key in keyof Props as SelectionAt<Include, Key> extends infer Value ? Value extends Selector<any> | undefined ? never : Value extends true ? SelectionAt<Select, Key> extends true ? never : Props[Key] extends {
+  properties: infer Shape extends InPropsObject;
+} ? SelectionAt<Select, Key> extends object ? keyof CallerOptions<Shape, true, SelectionAt<Select, Key>> extends never ? never : Key : Key : Key : Props[Key] extends {
+  properties: infer Shape extends InPropsObject;
+} ? keyof CallerOptions<Shape, Value, SelectionAt<Select, Key>> extends never ? never : Key : never : never]: Props[Key] extends {
+  properties: infer Shape extends InPropsObject;
+} ? SelectionAt<Include, Key> extends true ? SelectionAt<Select, Key> extends object ? CallerOptions<Shape, true, SelectionAt<Select, Key>> : true : CallerOptions<Shape, SelectionAt<Include, Key>, SelectionAt<Select, Key>> : true };
+type CallerContract<Resources extends readonly ResourceDefinition[], Options extends InPropsDefinition<Resources>, Include, Select> = (Include extends {
+  resources: true;
+} ? {
+  resources: true;
+} : {}) & (Include extends {
+  options: infer Value;
+} ? Value extends Selector<any> ? {} : {
+  options: CallerOptions<OptionDefinitions<Resources, Options>, Value, Select extends {
+    options: infer Other;
+  } ? Other : {}>;
+} : {});
+type ExactSelection<Selection, Allowed> = { [Key in keyof Selection]: Key extends keyof Allowed ? Selection[Key] extends Selector<any> ? Allowed[Key] : Selection[Key] extends object ? ExactSelection<Selection[Key], Exclude<Allowed[Key], true | undefined | Selector<any>>> : Allowed[Key] : never };
+/** Configuration accepted by the bound reusable factory. */
+type ReusableDefinition<Resources extends readonly ResourceDefinition[], Options extends InPropsDefinition<Resources>, Include extends ReusableInclude<Resources, Options>, Custom extends InPropsObject, Select extends ReusableInclude<Resources, Options>, Result, Overlap extends ReusableOverlap | undefined = undefined> = {
+  props?: PropsContract<ReusableInclude<Resources, Options> & Include & ExactSelection<Include, ReusableInclude<Resources, Options>>, Custom>;
+  select?: ReusableInclude<Resources, Options> & Select & ExactSelection<Select, ReusableInclude<Resources, Options>>; /** Resolve ambiguous leaf collisions explicitly; the default rejects them. */
+  overlap?: Overlap;
+  fn: (props: ReusableResolved<Resources, Options, Include, Custom, Select, Overlap>) => Result;
+};
+type ReusableArguments<Resources extends readonly ResourceDefinition[], Options extends InPropsDefinition<Resources>, Include, Custom extends InPropsObject, Select> = {} extends ReusableInput<Resources, Options, Include, Custom, Select> ? [props?: ReusableInput<Resources, Options, Include, Custom, Select>] : [props: ReusableInput<Resources, Options, Include, Custom, Select>];
+type ReusableFunction<Resources extends readonly ResourceDefinition[], Options extends InPropsDefinition<Resources>, Include, Custom extends InPropsObject, Select, Result> = (...args: ReusableArguments<Resources, Options, Include, Custom, Select>) => Expanded<Result>;
+/** Creates a validated function with one merged callback argument. */
+type CreateReusable<Resources extends readonly ResourceDefinition[], Options extends InPropsDefinition<Resources>> = <const Include extends ReusableInclude<Resources, Options> = {}, const Custom extends InPropsObject = {}, const Select extends ReusableInclude<Resources, Options> = {}, Result = unknown, const Overlap extends ReusableOverlap | undefined = undefined>(definition: ReusableDefinition<Resources, Options, Include, Custom, Select, Result, Overlap>) => Show<ReusableFunction<Resources, Options, Include, Custom, Select, Result>>;
+//#endregion
+export { CreateReusable, ReusableArguments, ReusableDefinition, ReusableFunction, ReusableInclude, ReusableInput, ReusableOptionSelection, ReusableOverlap, ReusableProps, ReusableResolved, ReusableSelected };
+//# sourceMappingURL=reusable-types.d.mts.map

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

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

package/dist/index.d.cts

@@ -5,7 +5,7 @@ import { LazyResourceError, LazyResourceErrorMap, LazyResourceModuleShapeError,
 import { CreateLazyErrorComponent, LazyErrorHandlers, LazyHandle, LazyOptions, LazyResourceErrorComponent, LazyResourceErrorProps, LazyResourceLoadingComponent, LazyResourceStates, LoadStatus } from "./lazy/types.cjs";
 import { BaseComponent, MergeIntersection, Show, UnionToIntersection, pick } from "./utils.cjs";
 import { LayoutResourceKey, NormalizeResource, NormalizeResources, NormalizedResourceDefinition, NormalizedResourceDefinitions, ResourceDefinition, ResourceDefinitionValue, ResourceEnum, ResourceLayoutComponentProps, ResourcePath, ResourceTree, normalizeResource, normalizeResourceDefinitions, normalizeResources, toResourceEnum } from "./resource.cjs";
-import { InPropsDefinition, InPropsFunction, InPropsObject, InPropsOptions, IncludedComponentPropDefinitions, IncludedPropBehavior, IncludedProps, InferredInProps, LayoutRenderProps, MergedLayoutInProps, PropsContextRender, PropsRenderDefinition, ResolvedIncludedComponentProps, ResolvedIncludedConfigProps, ResolvedIncludedProps, ResolvedIncludedPropsAsDefined } from "./props.cjs";
+import { InPropsDefinition, InPropsFunction, InPropsObject, InPropsOptions, IncludedComponentPropDefinitions, IncludedPropBehavior, IncludedProps, InferredInProps, LayoutRenderProps, MergedLayoutInProps, PropsContextRender, PropsContract, PropsRenderDefinition, ResolvedIncludedComponentProps, ResolvedIncludedConfigProps, ResolvedIncludedProps, ResolvedIncludedPropsAsDefined } from "./props.cjs";
 import { AsStateComposable, StateComposable, StateComposableOptions } from "./create-config/state-composable.cjs";
 import { AnyRenderStateDefinition, BuiltinRenderStateName, CreateLayoutBuildingBlocks, CreateLayoutBuildingBlocksArguments, CreateLayoutBuildingBlocksResult, CreateRenderState, CreateRenderStateBuilderArguments, CreateRenderStateBuilderResult, CreateRenderStateFromState, DeferredRenderState, DefineLayoutComposables, LayoutComposablesDefinition, LazyRenderState, RenderStateCallProps, RenderStateCallback, RenderStateComposablesDefinition, RenderStateContext, RenderStateFragment, RenderStateName, RenderStateOverloads, RenderStateProps, RenderStateReferences, TypedRenderStateCallback } from "./create-config/render-state.cjs";
 import { LayoutNameCallback, LayoutNameContext, LayoutNameFactory, LayoutNameInput, LayoutNameOptions, LayoutNamePartDefinitions, LayoutNamePartType, LayoutNamePartValues, LayoutNameParts, LayoutNameResolver, ResolvedLayoutName, defineLayoutName } from "./create-config/layout-name.cjs";
@@ -17,7 +17,8 @@ import { ComponentTypes, CreateResourceConfigFn, CreateResourceConfigForResource
 import { CreateResourceMap, CreateResourceMapFn } from "./create-config/create-resource-links.cjs";
 import { ScopedComponentRenderFn } from "./lazy/scoped-content.cjs";
 import { ContextualInlineRenderState, ContextualInlineRenderStates, CreateResourceLayoutWithLayoutOptions, CreateViewMapBuiltInRenderStatesOptions, CreateViewMapFunctionRenderOptions, CreateViewMapInlineRenderStatesOptions, CreateViewMapRenderStatesOptions, DefineResourceLayoutWithLayoutFn, DefineResourcesFn, DefinedResourceLayoutWithShell, LayoutRenderResourcesAccessor, LayoutResourcesAccessor, ResourceLayoutProvider, ResourceLayoutProviderProps, ResourceLayoutShellComponent, ResourceLayoutShellProps, ResourceSelection, ShellLayoutDefinition, ShellRenderContext, TypedBuiltInRenderStates, TypedInlineRenderState, defineResourceLayout } from "./create-config/define-layout.cjs";
-import { CreateReusable, ReusableInclude, ReusableOptionSelection, ReusableProps } from "./create-config/create-reusable.cjs";
+import { ReusableResourcesAccessor, SingleResourceInput } from "./create-config/reusable-resource-input.cjs";
+import { CreateReusable, ReusableArguments, ReusableDefinition, ReusableFunction, ReusableInclude, ReusableInput, ReusableOptionSelection, ReusableOverlap, ReusableProps, ReusableResolved, ReusableSelected } from "./create-config/reusable-types.cjs";
 import { CreateLazyRenderState, LazyDefaultState } from "./lazy/create-render-state.cjs";
 import { LazyResourceLayoutComponent, LazyResourceLayoutOptions } from "./create-config/lazy-resource-layout.cjs";
 import { BoundDefineResourceLayout, CreateDefinedResourceLayoutOptions, CreateDefinedResourceLayoutResult, DefineLazyDefaults, DefinedResourceLayoutInput, NonEmptyResources, createDefinedResourceLayout } from "./create-config/create-defined-resource-layout.cjs";
@@ -35,4 +36,4 @@ import { MissingPathVariableContext, MissingPathVariableError } from "./errors/m
 import { MissingResourceProviderError } from "./errors/missing-resource-provider.cjs";
 import { AnyComposableComponent, ComposableComponent, ComposableComponentCallable, ComposableComponents, ComposableNameContext, ComposablePresetComponent, ComposablePresetComponentCallProps, ComposablePresetMeta, ComposablePresetProps, ComposableResourceLayout, CreateLayoutComposable, DefinedComposableComponentRecord, LayoutComposablePresetProvider, LayoutComposablesFactory, MakeComposable, MakeComposableOptions, MergePresetProps, PresetPropsFromComposable, RequiredPresetLayoutProps, RequiredPresetRenderProps, ResolveLayoutComposables, collectComposablePresetEntries, createComposableComponent, createLayoutComposableFactory, defineComposableComponent, makeComposable, resolveComposablePresetProps, resolveLayoutComposables } from "@jfdevelops/react-layout-composables";
 import { AnyBuiltPropDefinition, ExtractDefinitionValue, PropError, PropErrorOptions, ResolveLayoutProps, ResolveLayoutPropsAsDefined, ResolveProps, ResolvedBuiltPropShape, createPrimitivePropBuilder, createProp, isPropDefinitionShape, resolvePropDefinitionValues, validateProps } from "@jfdevelops/react-layout-validator";
-export { type AnyBuiltPropDefinition, type AnyComposableComponent, type AnyRenderStateDefinition, type AsStateComposable, type BaseComponent, type BoundDefineResourceLayout, type BuiltinRenderStateName, type ChildrenRequirement, type ComponentTypes, type ComposableComponent, type ComposableComponentCallable, type ComposableComponents, type ComposableNameContext, type ComposablePresetComponent, type ComposablePresetComponentCallProps, type ComposablePresetMeta, type ComposablePresetProps, type ComposableResourceLayout, type ContextualInlineRenderState, type ContextualInlineRenderStates, type CreateDefinedResourceLayoutOptions, type CreateDefinedResourceLayoutResult, type CreateGetComponentForPath, type CreateLayoutBuildingBlocks, type CreateLayoutBuildingBlocksArguments, type CreateLayoutBuildingBlocksResult, type CreateLayoutComposable, type CreateLazyErrorComponent, type CreateLazyRenderState, type CreateRenderState, type CreateRenderStateBuilderArguments, type CreateRenderStateBuilderResult, type CreateRenderStateFromState, type CreateResourceConfigFn, type CreateResourceConfigForResource, type CreateResourceLayoutWithLayoutOptions, type CreateResourceMap, type CreateResourceMapFn, type CreateReusable, type CreateViewMapBuiltInRenderStatesOptions, type CreateViewMapFunctionRenderOptions, type CreateViewMapInlineRenderStatesOptions, type CreateViewMapRenderStatesOptions, type CreatedResourceConfig, type CustomPropsObject, type DeferredRenderState, type DefineLayoutComposables, type DefineLazyDefaults, type DefineResourceLayoutWithLayoutFn, type DefineResourcesFn, type DefinedComposableComponentRecord, type DefinedResourceLayoutInput, type DefinedResourceLayoutWithShell, type ExtractDefinitionValue, type ForPaths, type ForPathsRenderContext, type GetComponentForPath, type InPropsDefinition, type InPropsFunction, type InPropsObject, type InPropsOptions, type IncludedComponentPropDefinitions, type IncludedPropBehavior, type IncludedProps, type InferredInProps, type InvalidComponentContext, InvalidComponentError, type InvalidConfigContext, InvalidConfigError, type InvalidPartContext, InvalidPartError, type InvalidPartTypeContext, InvalidPartTypeError, type InvalidPathContext, InvalidPathError, type InvalidResourceContext, InvalidResourceError, type InvalidSubResourceContext, InvalidSubResourceError, type IsSubResourceKey, LayoutComposablePresetProvider, type LayoutComposablesDefinition, type LayoutComposablesFactory, LayoutConfigurationError, type LayoutConfigurationErrorContext, type LayoutNameCallback, type LayoutNameContext, type LayoutNameFactory, type LayoutNameInput, type LayoutNameOptions, type LayoutNamePartDefinitions, type LayoutNamePartType, type LayoutNamePartValues, type LayoutNameParts, type LayoutNameResolver, type LayoutPreviewProps, type LayoutRenderProps, type LayoutRenderResourcesAccessor, type LayoutResourceKey, type LayoutResourcesAccessor, type LazyDefaultState, type LazyErrorHandlers, type LazyHandle, type LazyOptions, type LazyRenderState, type LazyResourceError, type LazyResourceErrorComponent, type LazyResourceErrorMap, type LazyResourceErrorProps, type LazyResourceLayoutComponent, type LazyResourceLayoutOptions, type LazyResourceLoadingComponent, LazyResourceModuleShapeError, LazyResourceStateNotFoundError, type LazyResourceStates, type LoadStatus, type MakeComposable, type MakeComposableOptions, type MergeIntersection, type MergePresetProps, type MergedLayoutInProps, type MissingPathVariableContext, MissingPathVariableError, MissingResourceProviderError, type NonEmptyResources, type NormalizeResource, type NormalizeResources, type NormalizedResourceDefinition, type NormalizedResourceDefinitions, type ParameterizedResourcePath, type PathVariables, type PresetPropsFromComposable, PropError, type PropErrorOptions, type PropsContextRender, type PropsRenderDefinition, ReactLayoutError, type RenderStateCallProps, type RenderStateCallback, type RenderStateComposablesDefinition, type RenderStateContext, type RenderStateFragment, type RenderStateName, type RenderStateOverloads, type RenderStateProps, type RenderStateReferences, type RenderedPathComponent, type RenderedPathComponentHOF, type RequiredPresetLayoutProps, type RequiredPresetRenderProps, type ResolveLayoutComposables, type ResolveLayoutProps, type ResolveLayoutPropsAsDefined, type ResolveProps, type ResolvedBuiltPropShape, type ResolvedIncludedComponentProps, type ResolvedIncludedConfigProps, type ResolvedIncludedProps, type ResolvedIncludedPropsAsDefined, type ResolvedLayoutName, type ResolvedPathValue, type ResourceConfigFragment, type ResourceDefinition, type ResourceDefinitionValue, type ResourceEnum, type ResourceLayoutComponentProps, type ResourceLayoutProvider, type ResourceLayoutProviderProps, type ResourceLayoutShellComponent, type ResourceLayoutShellProps, type ResourceLayoutShellPublisher, ResourceModuleLoadError, type ResourcePath, ResourceRenderError, type ResourceSelection, type ResourceStateError, type ResourceTree, type ReusableInclude, type ReusableOptionSelection, type ReusableProps, type ScopedComponentRenderFn, type ShellLayoutDefinition, type ShellRenderContext, type Show, type StateComposable, type StateComposableOptions, type TargetPathBuilder, type TypedBuiltInRenderStates, type TypedInlineRenderState, type TypedRenderStateCallback, type UnionToIntersection, collectComposablePresetEntries, createComposableComponent, createDefinedResourceLayout, createLayoutComposableFactory, createPrimitivePropBuilder, createProp, defineComposableComponent, defineLayoutName, defineLayoutPreview, defineResourceLayout, isLazyResourceError, isPropDefinitionShape, makeComposable, normalizeResource, normalizeResourceDefinitions, normalizeResources, pick, resolveComposablePresetProps, resolveLayoutComposables, resolvePropDefinitionValues, toResourceEnum, validateProps };
+export { type AnyBuiltPropDefinition, type AnyComposableComponent, type AnyRenderStateDefinition, type AsStateComposable, type BaseComponent, type BoundDefineResourceLayout, type BuiltinRenderStateName, type ChildrenRequirement, type ComponentTypes, type ComposableComponent, type ComposableComponentCallable, type ComposableComponents, type ComposableNameContext, type ComposablePresetComponent, type ComposablePresetComponentCallProps, type ComposablePresetMeta, type ComposablePresetProps, type ComposableResourceLayout, type ContextualInlineRenderState, type ContextualInlineRenderStates, type CreateDefinedResourceLayoutOptions, type CreateDefinedResourceLayoutResult, type CreateGetComponentForPath, type CreateLayoutBuildingBlocks, type CreateLayoutBuildingBlocksArguments, type CreateLayoutBuildingBlocksResult, type CreateLayoutComposable, type CreateLazyErrorComponent, type CreateLazyRenderState, type CreateRenderState, type CreateRenderStateBuilderArguments, type CreateRenderStateBuilderResult, type CreateRenderStateFromState, type CreateResourceConfigFn, type CreateResourceConfigForResource, type CreateResourceLayoutWithLayoutOptions, type CreateResourceMap, type CreateResourceMapFn, type CreateReusable, type CreateViewMapBuiltInRenderStatesOptions, type CreateViewMapFunctionRenderOptions, type CreateViewMapInlineRenderStatesOptions, type CreateViewMapRenderStatesOptions, type CreatedResourceConfig, type CustomPropsObject, type DeferredRenderState, type DefineLayoutComposables, type DefineLazyDefaults, type DefineResourceLayoutWithLayoutFn, type DefineResourcesFn, type DefinedComposableComponentRecord, type DefinedResourceLayoutInput, type DefinedResourceLayoutWithShell, type ExtractDefinitionValue, type ForPaths, type ForPathsRenderContext, type GetComponentForPath, type InPropsDefinition, type InPropsFunction, type InPropsObject, type InPropsOptions, type IncludedComponentPropDefinitions, type IncludedPropBehavior, type IncludedProps, type InferredInProps, type InvalidComponentContext, InvalidComponentError, type InvalidConfigContext, InvalidConfigError, type InvalidPartContext, InvalidPartError, type InvalidPartTypeContext, InvalidPartTypeError, type InvalidPathContext, InvalidPathError, type InvalidResourceContext, InvalidResourceError, type InvalidSubResourceContext, InvalidSubResourceError, type IsSubResourceKey, LayoutComposablePresetProvider, type LayoutComposablesDefinition, type LayoutComposablesFactory, LayoutConfigurationError, type LayoutConfigurationErrorContext, type LayoutNameCallback, type LayoutNameContext, type LayoutNameFactory, type LayoutNameInput, type LayoutNameOptions, type LayoutNamePartDefinitions, type LayoutNamePartType, type LayoutNamePartValues, type LayoutNameParts, type LayoutNameResolver, type LayoutPreviewProps, type LayoutRenderProps, type LayoutRenderResourcesAccessor, type LayoutResourceKey, type LayoutResourcesAccessor, type LazyDefaultState, type LazyErrorHandlers, type LazyHandle, type LazyOptions, type LazyRenderState, type LazyResourceError, type LazyResourceErrorComponent, type LazyResourceErrorMap, type LazyResourceErrorProps, type LazyResourceLayoutComponent, type LazyResourceLayoutOptions, type LazyResourceLoadingComponent, LazyResourceModuleShapeError, LazyResourceStateNotFoundError, type LazyResourceStates, type LoadStatus, type MakeComposable, type MakeComposableOptions, type MergeIntersection, type MergePresetProps, type MergedLayoutInProps, type MissingPathVariableContext, MissingPathVariableError, MissingResourceProviderError, type NonEmptyResources, type NormalizeResource, type NormalizeResources, type NormalizedResourceDefinition, type NormalizedResourceDefinitions, type ParameterizedResourcePath, type PathVariables, type PresetPropsFromComposable, PropError, type PropErrorOptions, type PropsContextRender, type PropsContract, type PropsRenderDefinition, ReactLayoutError, type RenderStateCallProps, type RenderStateCallback, type RenderStateComposablesDefinition, type RenderStateContext, type RenderStateFragment, type RenderStateName, type RenderStateOverloads, type RenderStateProps, type RenderStateReferences, type RenderedPathComponent, type RenderedPathComponentHOF, type RequiredPresetLayoutProps, type RequiredPresetRenderProps, type ResolveLayoutComposables, type ResolveLayoutProps, type ResolveLayoutPropsAsDefined, type ResolveProps, type ResolvedBuiltPropShape, type ResolvedIncludedComponentProps, type ResolvedIncludedConfigProps, type ResolvedIncludedProps, type ResolvedIncludedPropsAsDefined, type ResolvedLayoutName, type ResolvedPathValue, type ResourceConfigFragment, type ResourceDefinition, type ResourceDefinitionValue, type ResourceEnum, type ResourceLayoutComponentProps, type ResourceLayoutProvider, type ResourceLayoutProviderProps, type ResourceLayoutShellComponent, type ResourceLayoutShellProps, type ResourceLayoutShellPublisher, ResourceModuleLoadError, type ResourcePath, ResourceRenderError, type ResourceSelection, type ResourceStateError, type ResourceTree, type ReusableArguments, type ReusableDefinition, type ReusableFunction, type ReusableInclude, type ReusableInput, type ReusableOptionSelection, type ReusableOverlap, type ReusableProps, type ReusableResolved, type ReusableResourcesAccessor, type ReusableSelected, type ScopedComponentRenderFn, type ShellLayoutDefinition, type ShellRenderContext, type Show, type SingleResourceInput, type StateComposable, type StateComposableOptions, type TargetPathBuilder, type TypedBuiltInRenderStates, type TypedInlineRenderState, type TypedRenderStateCallback, type UnionToIntersection, collectComposablePresetEntries, createComposableComponent, createDefinedResourceLayout, createLayoutComposableFactory, createPrimitivePropBuilder, createProp, defineComposableComponent, defineLayoutName, defineLayoutPreview, defineResourceLayout, isLazyResourceError, isPropDefinitionShape, makeComposable, normalizeResource, normalizeResourceDefinitions, normalizeResources, pick, resolveComposablePresetProps, resolveLayoutComposables, resolvePropDefinitionValues, toResourceEnum, validateProps };

package/dist/index.d.mts

@@ -5,7 +5,7 @@ import { LazyResourceError, LazyResourceErrorMap, LazyResourceModuleShapeError,
 import { CreateLazyErrorComponent, LazyErrorHandlers, LazyHandle, LazyOptions, LazyResourceErrorComponent, LazyResourceErrorProps, LazyResourceLoadingComponent, LazyResourceStates, LoadStatus } from "./lazy/types.mjs";
 import { BaseComponent, MergeIntersection, Show, UnionToIntersection, pick } from "./utils.mjs";
 import { LayoutResourceKey, NormalizeResource, NormalizeResources, NormalizedResourceDefinition, NormalizedResourceDefinitions, ResourceDefinition, ResourceDefinitionValue, ResourceEnum, ResourceLayoutComponentProps, ResourcePath, ResourceTree, normalizeResource, normalizeResourceDefinitions, normalizeResources, toResourceEnum } from "./resource.mjs";
-import { InPropsDefinition, InPropsFunction, InPropsObject, InPropsOptions, IncludedComponentPropDefinitions, IncludedPropBehavior, IncludedProps, InferredInProps, LayoutRenderProps, MergedLayoutInProps, PropsContextRender, PropsRenderDefinition, ResolvedIncludedComponentProps, ResolvedIncludedConfigProps, ResolvedIncludedProps, ResolvedIncludedPropsAsDefined } from "./props.mjs";
+import { InPropsDefinition, InPropsFunction, InPropsObject, InPropsOptions, IncludedComponentPropDefinitions, IncludedPropBehavior, IncludedProps, InferredInProps, LayoutRenderProps, MergedLayoutInProps, PropsContextRender, PropsContract, PropsRenderDefinition, ResolvedIncludedComponentProps, ResolvedIncludedConfigProps, ResolvedIncludedProps, ResolvedIncludedPropsAsDefined } from "./props.mjs";
 import { AsStateComposable, StateComposable, StateComposableOptions } from "./create-config/state-composable.mjs";
 import { AnyRenderStateDefinition, BuiltinRenderStateName, CreateLayoutBuildingBlocks, CreateLayoutBuildingBlocksArguments, CreateLayoutBuildingBlocksResult, CreateRenderState, CreateRenderStateBuilderArguments, CreateRenderStateBuilderResult, CreateRenderStateFromState, DeferredRenderState, DefineLayoutComposables, LayoutComposablesDefinition, LazyRenderState, RenderStateCallProps, RenderStateCallback, RenderStateComposablesDefinition, RenderStateContext, RenderStateFragment, RenderStateName, RenderStateOverloads, RenderStateProps, RenderStateReferences, TypedRenderStateCallback } from "./create-config/render-state.mjs";
 import { LayoutNameCallback, LayoutNameContext, LayoutNameFactory, LayoutNameInput, LayoutNameOptions, LayoutNamePartDefinitions, LayoutNamePartType, LayoutNamePartValues, LayoutNameParts, LayoutNameResolver, ResolvedLayoutName, defineLayoutName } from "./create-config/layout-name.mjs";
@@ -17,7 +17,8 @@ import { ComponentTypes, CreateResourceConfigFn, CreateResourceConfigForResource
 import { CreateResourceMap, CreateResourceMapFn } from "./create-config/create-resource-links.mjs";
 import { ScopedComponentRenderFn } from "./lazy/scoped-content.mjs";
 import { ContextualInlineRenderState, ContextualInlineRenderStates, CreateResourceLayoutWithLayoutOptions, CreateViewMapBuiltInRenderStatesOptions, CreateViewMapFunctionRenderOptions, CreateViewMapInlineRenderStatesOptions, CreateViewMapRenderStatesOptions, DefineResourceLayoutWithLayoutFn, DefineResourcesFn, DefinedResourceLayoutWithShell, LayoutRenderResourcesAccessor, LayoutResourcesAccessor, ResourceLayoutProvider, ResourceLayoutProviderProps, ResourceLayoutShellComponent, ResourceLayoutShellProps, ResourceSelection, ShellLayoutDefinition, ShellRenderContext, TypedBuiltInRenderStates, TypedInlineRenderState, defineResourceLayout } from "./create-config/define-layout.mjs";
-import { CreateReusable, ReusableInclude, ReusableOptionSelection, ReusableProps } from "./create-config/create-reusable.mjs";
+import { ReusableResourcesAccessor, SingleResourceInput } from "./create-config/reusable-resource-input.mjs";
+import { CreateReusable, ReusableArguments, ReusableDefinition, ReusableFunction, ReusableInclude, ReusableInput, ReusableOptionSelection, ReusableOverlap, ReusableProps, ReusableResolved, ReusableSelected } from "./create-config/reusable-types.mjs";
 import { CreateLazyRenderState, LazyDefaultState } from "./lazy/create-render-state.mjs";
 import { LazyResourceLayoutComponent, LazyResourceLayoutOptions } from "./create-config/lazy-resource-layout.mjs";
 import { BoundDefineResourceLayout, CreateDefinedResourceLayoutOptions, CreateDefinedResourceLayoutResult, DefineLazyDefaults, DefinedResourceLayoutInput, NonEmptyResources, createDefinedResourceLayout } from "./create-config/create-defined-resource-layout.mjs";
@@ -35,4 +36,4 @@ import { MissingPathVariableContext, MissingPathVariableError } from "./errors/m
 import { MissingResourceProviderError } from "./errors/missing-resource-provider.mjs";
 import { AnyComposableComponent, ComposableComponent, ComposableComponentCallable, ComposableComponents, ComposableNameContext, ComposablePresetComponent, ComposablePresetComponentCallProps, ComposablePresetMeta, ComposablePresetProps, ComposableResourceLayout, CreateLayoutComposable, DefinedComposableComponentRecord, LayoutComposablePresetProvider, LayoutComposablesFactory, MakeComposable, MakeComposableOptions, MergePresetProps, PresetPropsFromComposable, RequiredPresetLayoutProps, RequiredPresetRenderProps, ResolveLayoutComposables, collectComposablePresetEntries, createComposableComponent, createLayoutComposableFactory, defineComposableComponent, makeComposable, resolveComposablePresetProps, resolveLayoutComposables } from "@jfdevelops/react-layout-composables";
 import { AnyBuiltPropDefinition, ExtractDefinitionValue, PropError, PropErrorOptions, ResolveLayoutProps, ResolveLayoutPropsAsDefined, ResolveProps, ResolvedBuiltPropShape, createPrimitivePropBuilder, createProp, isPropDefinitionShape, resolvePropDefinitionValues, validateProps } from "@jfdevelops/react-layout-validator";
-export { type AnyBuiltPropDefinition, type AnyComposableComponent, type AnyRenderStateDefinition, type AsStateComposable, type BaseComponent, type BoundDefineResourceLayout, type BuiltinRenderStateName, type ChildrenRequirement, type ComponentTypes, type ComposableComponent, type ComposableComponentCallable, type ComposableComponents, type ComposableNameContext, type ComposablePresetComponent, type ComposablePresetComponentCallProps, type ComposablePresetMeta, type ComposablePresetProps, type ComposableResourceLayout, type ContextualInlineRenderState, type ContextualInlineRenderStates, type CreateDefinedResourceLayoutOptions, type CreateDefinedResourceLayoutResult, type CreateGetComponentForPath, type CreateLayoutBuildingBlocks, type CreateLayoutBuildingBlocksArguments, type CreateLayoutBuildingBlocksResult, type CreateLayoutComposable, type CreateLazyErrorComponent, type CreateLazyRenderState, type CreateRenderState, type CreateRenderStateBuilderArguments, type CreateRenderStateBuilderResult, type CreateRenderStateFromState, type CreateResourceConfigFn, type CreateResourceConfigForResource, type CreateResourceLayoutWithLayoutOptions, type CreateResourceMap, type CreateResourceMapFn, type CreateReusable, type CreateViewMapBuiltInRenderStatesOptions, type CreateViewMapFunctionRenderOptions, type CreateViewMapInlineRenderStatesOptions, type CreateViewMapRenderStatesOptions, type CreatedResourceConfig, type CustomPropsObject, type DeferredRenderState, type DefineLayoutComposables, type DefineLazyDefaults, type DefineResourceLayoutWithLayoutFn, type DefineResourcesFn, type DefinedComposableComponentRecord, type DefinedResourceLayoutInput, type DefinedResourceLayoutWithShell, type ExtractDefinitionValue, type ForPaths, type ForPathsRenderContext, type GetComponentForPath, type InPropsDefinition, type InPropsFunction, type InPropsObject, type InPropsOptions, type IncludedComponentPropDefinitions, type IncludedPropBehavior, type IncludedProps, type InferredInProps, type InvalidComponentContext, InvalidComponentError, type InvalidConfigContext, InvalidConfigError, type InvalidPartContext, InvalidPartError, type InvalidPartTypeContext, InvalidPartTypeError, type InvalidPathContext, InvalidPathError, type InvalidResourceContext, InvalidResourceError, type InvalidSubResourceContext, InvalidSubResourceError, type IsSubResourceKey, LayoutComposablePresetProvider, type LayoutComposablesDefinition, type LayoutComposablesFactory, LayoutConfigurationError, type LayoutConfigurationErrorContext, type LayoutNameCallback, type LayoutNameContext, type LayoutNameFactory, type LayoutNameInput, type LayoutNameOptions, type LayoutNamePartDefinitions, type LayoutNamePartType, type LayoutNamePartValues, type LayoutNameParts, type LayoutNameResolver, type LayoutPreviewProps, type LayoutRenderProps, type LayoutRenderResourcesAccessor, type LayoutResourceKey, type LayoutResourcesAccessor, type LazyDefaultState, type LazyErrorHandlers, type LazyHandle, type LazyOptions, type LazyRenderState, type LazyResourceError, type LazyResourceErrorComponent, type LazyResourceErrorMap, type LazyResourceErrorProps, type LazyResourceLayoutComponent, type LazyResourceLayoutOptions, type LazyResourceLoadingComponent, LazyResourceModuleShapeError, LazyResourceStateNotFoundError, type LazyResourceStates, type LoadStatus, type MakeComposable, type MakeComposableOptions, type MergeIntersection, type MergePresetProps, type MergedLayoutInProps, type MissingPathVariableContext, MissingPathVariableError, MissingResourceProviderError, type NonEmptyResources, type NormalizeResource, type NormalizeResources, type NormalizedResourceDefinition, type NormalizedResourceDefinitions, type ParameterizedResourcePath, type PathVariables, type PresetPropsFromComposable, PropError, type PropErrorOptions, type PropsContextRender, type PropsRenderDefinition, ReactLayoutError, type RenderStateCallProps, type RenderStateCallback, type RenderStateComposablesDefinition, type RenderStateContext, type RenderStateFragment, type RenderStateName, type RenderStateOverloads, type RenderStateProps, type RenderStateReferences, type RenderedPathComponent, type RenderedPathComponentHOF, type RequiredPresetLayoutProps, type RequiredPresetRenderProps, type ResolveLayoutComposables, type ResolveLayoutProps, type ResolveLayoutPropsAsDefined, type ResolveProps, type ResolvedBuiltPropShape, type ResolvedIncludedComponentProps, type ResolvedIncludedConfigProps, type ResolvedIncludedProps, type ResolvedIncludedPropsAsDefined, type ResolvedLayoutName, type ResolvedPathValue, type ResourceConfigFragment, type ResourceDefinition, type ResourceDefinitionValue, type ResourceEnum, type ResourceLayoutComponentProps, type ResourceLayoutProvider, type ResourceLayoutProviderProps, type ResourceLayoutShellComponent, type ResourceLayoutShellProps, type ResourceLayoutShellPublisher, ResourceModuleLoadError, type ResourcePath, ResourceRenderError, type ResourceSelection, type ResourceStateError, type ResourceTree, type ReusableInclude, type ReusableOptionSelection, type ReusableProps, type ScopedComponentRenderFn, type ShellLayoutDefinition, type ShellRenderContext, type Show, type StateComposable, type StateComposableOptions, type TargetPathBuilder, type TypedBuiltInRenderStates, type TypedInlineRenderState, type TypedRenderStateCallback, type UnionToIntersection, collectComposablePresetEntries, createComposableComponent, createDefinedResourceLayout, createLayoutComposableFactory, createPrimitivePropBuilder, createProp, defineComposableComponent, defineLayoutName, defineLayoutPreview, defineResourceLayout, isLazyResourceError, isPropDefinitionShape, makeComposable, normalizeResource, normalizeResourceDefinitions, normalizeResources, pick, resolveComposablePresetProps, resolveLayoutComposables, resolvePropDefinitionValues, toResourceEnum, validateProps };
+export { type AnyBuiltPropDefinition, type AnyComposableComponent, type AnyRenderStateDefinition, type AsStateComposable, type BaseComponent, type BoundDefineResourceLayout, type BuiltinRenderStateName, type ChildrenRequirement, type ComponentTypes, type ComposableComponent, type ComposableComponentCallable, type ComposableComponents, type ComposableNameContext, type ComposablePresetComponent, type ComposablePresetComponentCallProps, type ComposablePresetMeta, type ComposablePresetProps, type ComposableResourceLayout, type ContextualInlineRenderState, type ContextualInlineRenderStates, type CreateDefinedResourceLayoutOptions, type CreateDefinedResourceLayoutResult, type CreateGetComponentForPath, type CreateLayoutBuildingBlocks, type CreateLayoutBuildingBlocksArguments, type CreateLayoutBuildingBlocksResult, type CreateLayoutComposable, type CreateLazyErrorComponent, type CreateLazyRenderState, type CreateRenderState, type CreateRenderStateBuilderArguments, type CreateRenderStateBuilderResult, type CreateRenderStateFromState, type CreateResourceConfigFn, type CreateResourceConfigForResource, type CreateResourceLayoutWithLayoutOptions, type CreateResourceMap, type CreateResourceMapFn, type CreateReusable, type CreateViewMapBuiltInRenderStatesOptions, type CreateViewMapFunctionRenderOptions, type CreateViewMapInlineRenderStatesOptions, type CreateViewMapRenderStatesOptions, type CreatedResourceConfig, type CustomPropsObject, type DeferredRenderState, type DefineLayoutComposables, type DefineLazyDefaults, type DefineResourceLayoutWithLayoutFn, type DefineResourcesFn, type DefinedComposableComponentRecord, type DefinedResourceLayoutInput, type DefinedResourceLayoutWithShell, type ExtractDefinitionValue, type ForPaths, type ForPathsRenderContext, type GetComponentForPath, type InPropsDefinition, type InPropsFunction, type InPropsObject, type InPropsOptions, type IncludedComponentPropDefinitions, type IncludedPropBehavior, type IncludedProps, type InferredInProps, type InvalidComponentContext, InvalidComponentError, type InvalidConfigContext, InvalidConfigError, type InvalidPartContext, InvalidPartError, type InvalidPartTypeContext, InvalidPartTypeError, type InvalidPathContext, InvalidPathError, type InvalidResourceContext, InvalidResourceError, type InvalidSubResourceContext, InvalidSubResourceError, type IsSubResourceKey, LayoutComposablePresetProvider, type LayoutComposablesDefinition, type LayoutComposablesFactory, LayoutConfigurationError, type LayoutConfigurationErrorContext, type LayoutNameCallback, type LayoutNameContext, type LayoutNameFactory, type LayoutNameInput, type LayoutNameOptions, type LayoutNamePartDefinitions, type LayoutNamePartType, type LayoutNamePartValues, type LayoutNameParts, type LayoutNameResolver, type LayoutPreviewProps, type LayoutRenderProps, type LayoutRenderResourcesAccessor, type LayoutResourceKey, type LayoutResourcesAccessor, type LazyDefaultState, type LazyErrorHandlers, type LazyHandle, type LazyOptions, type LazyRenderState, type LazyResourceError, type LazyResourceErrorComponent, type LazyResourceErrorMap, type LazyResourceErrorProps, type LazyResourceLayoutComponent, type LazyResourceLayoutOptions, type LazyResourceLoadingComponent, LazyResourceModuleShapeError, LazyResourceStateNotFoundError, type LazyResourceStates, type LoadStatus, type MakeComposable, type MakeComposableOptions, type MergeIntersection, type MergePresetProps, type MergedLayoutInProps, type MissingPathVariableContext, MissingPathVariableError, MissingResourceProviderError, type NonEmptyResources, type NormalizeResource, type NormalizeResources, type NormalizedResourceDefinition, type NormalizedResourceDefinitions, type ParameterizedResourcePath, type PathVariables, type PresetPropsFromComposable, PropError, type PropErrorOptions, type PropsContextRender, type PropsContract, type PropsRenderDefinition, ReactLayoutError, type RenderStateCallProps, type RenderStateCallback, type RenderStateComposablesDefinition, type RenderStateContext, type RenderStateFragment, type RenderStateName, type RenderStateOverloads, type RenderStateProps, type RenderStateReferences, type RenderedPathComponent, type RenderedPathComponentHOF, type RequiredPresetLayoutProps, type RequiredPresetRenderProps, type ResolveLayoutComposables, type ResolveLayoutProps, type ResolveLayoutPropsAsDefined, type ResolveProps, type ResolvedBuiltPropShape, type ResolvedIncludedComponentProps, type ResolvedIncludedConfigProps, type ResolvedIncludedProps, type ResolvedIncludedPropsAsDefined, type ResolvedLayoutName, type ResolvedPathValue, type ResourceConfigFragment, type ResourceDefinition, type ResourceDefinitionValue, type ResourceEnum, type ResourceLayoutComponentProps, type ResourceLayoutProvider, type ResourceLayoutProviderProps, type ResourceLayoutShellComponent, type ResourceLayoutShellProps, type ResourceLayoutShellPublisher, ResourceModuleLoadError, type ResourcePath, ResourceRenderError, type ResourceSelection, type ResourceStateError, type ResourceTree, type ReusableArguments, type ReusableDefinition, type ReusableFunction, type ReusableInclude, type ReusableInput, type ReusableOptionSelection, type ReusableOverlap, type ReusableProps, type ReusableResolved, type ReusableResourcesAccessor, type ReusableSelected, type ScopedComponentRenderFn, type ShellLayoutDefinition, type ShellRenderContext, type Show, type SingleResourceInput, type StateComposable, type StateComposableOptions, type TargetPathBuilder, type TypedBuiltInRenderStates, type TypedInlineRenderState, type TypedRenderStateCallback, type UnionToIntersection, collectComposablePresetEntries, createComposableComponent, createDefinedResourceLayout, createLayoutComposableFactory, createPrimitivePropBuilder, createProp, defineComposableComponent, defineLayoutName, defineLayoutPreview, defineResourceLayout, isLazyResourceError, isPropDefinitionShape, makeComposable, normalizeResource, normalizeResourceDefinitions, normalizeResources, pick, resolveComposablePresetProps, resolveLayoutComposables, resolvePropDefinitionValues, toResourceEnum, validateProps };

package/dist/props.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"props.cjs","names":["LayoutConfigurationError"],"sources":["../src/props.ts"],"sourcesContent":["import type { WithChildren } from '@jfdevelops/react-layout-composables';\nimport type { CustomPropsObject, ResolveRenderProps } from './custom-props';\nimport { LayoutConfigurationError } from './errors';\nimport type {\n  ComposableComponents,\n  MergePresetProps,\n} from '@jfdevelops/react-layout-composables';\nimport type { InPropsObject } from '@jfdevelops/react-layout-composables';\nimport {\n  EnumWrappedProp,\n  LiteralWrappedProp,\n  ResolveLayoutProps,\n  ResolveLayoutPropsAsDefined,\n  ResolveProps,\n} from '@jfdevelops/react-layout-validator';\nimport { ResourceDefinition, ResourceEnum } from './resource';\nimport { Show } from './utils';\n\nexport type { InPropsObject };\n\n/**\n * Two-argument `render(props, context)` used by createComponent and scoped\n * resource components. `Context` is sibling components (scoped) or the\n * resource render context (top-level).\n */\nexport type PropsContextRender<RenderProps, Context, Result = unknown> = (\n  props: WithChildren<RenderProps>,\n  context: Context,\n) => Result;\n\n/**\n * Shared `{ props?, render }` shape used by createComponent, scoped\n * components, and anywhere else a value declares props and a two-arg render.\n *\n * @typeParam Props - Declared on the entry (`props`). Often an\n *   {@link InPropsObject}, or a layout include/custom bag.\n * @typeParam RenderProps - First argument to `render` (defaults to\n *   {@link ResolveProps}<Props> when Props is an {@link InPropsObject})\n * @typeParam Result - `render` return type\n * @typeParam Context - Second argument to `render`\n */\nexport interface PropsRenderDefinition<\n  Props = InPropsObject,\n  RenderProps = Props extends InPropsObject ? ResolveProps<Props> : unknown,\n  Result = unknown,\n  Context = unknown,\n> {\n  props?: Props;\n  render: PropsContextRender<RenderProps, Context, Result>;\n}\n\nexport type InPropsOptions<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Name extends string,\n> = {\n  name: LiteralWrappedProp<Name, 'string', 'required'>;\n  resource: EnumWrappedProp<ResourceEnum<Resources>, 'string', 'required'>;\n};\nexport type InPropsFunction<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = <Name extends string>(\n  props: Show<InPropsOptions<Resources, Name>>,\n) => InPropsObject;\nexport type InPropsDefinition<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = InPropsObject | InPropsFunction<Resources>;\nexport type InferredInProps<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n> = Options extends InPropsFunction<Resources> ? ReturnType<Options> : Options;\nexport type MergedLayoutInProps<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n> =\n  InferredInProps<Resources, Options> extends InPropsObject\n    ? InferredInProps<Resources, Options> & MergePresetProps<Composables>\n    : never;\nexport type RequiredVariant = true | 'required';\n/**\n * @typeParam RequiredVariant How the required props are selected. In application code,\n * it will always be `true`, but internally we need to support `'required'` as well.\n */\ntype PropsType<Variant extends RequiredVariant = true> = Variant | 'optional';\ntype InternalPropsType = PropsType<'required'>;\ntype IncludedPropSource = 'component' | 'config';\n/** Controls whether an included prop is required and where it is supplied. */\nexport type IncludedPropBehavior = {\n  required: boolean;\n  suppliedVia: IncludedPropSource;\n};\n\ntype IncludedPropType = PropsType | IncludedPropBehavior;\n/**\n * A map of props to include in the layout.\n */\nexport type IncludedProps<T extends object> = {\n  [K in keyof T & string]?: IncludedPropType;\n};\n\ntype PropsKeys<Props extends InPropsObject, T> = T & keyof Props;\nexport type IncludedPropVisibility<Value> = Value extends { required: boolean }\n  ? Value['required'] extends true\n    ? 'required'\n    : 'optional'\n  : Value extends true | 'required'\n    ? 'required'\n    : Value extends 'optional'\n      ? 'optional'\n      : never;\nexport type IncludedPropSupplySource<Value> = Value extends {\n  suppliedVia: IncludedPropSource;\n}\n  ? Value['suppliedVia']\n  : never;\n/**\n * Internal representation of the supported include behavior.\n */\nexport type NormalizedIncludedPropBehavior<Value> = Value extends\n  | { required: boolean }\n  | { suppliedVia: IncludedPropSource }\n  ? {\n      visibility: IncludedPropVisibility<Value>;\n      passthrough: IncludedPropSupplySource<Value>;\n    }\n  : Value;\n\nexport type IncludedPropPassthrough<Value> = Value extends\n  | { required: boolean }\n  | { suppliedVia: IncludedPropSource }\n  ? IncludedPropSupplySource<Value> extends 'component'\n    ? IncludedPropVisibility<Value> extends 'optional'\n      ? 'component' | 'config'\n      : 'component'\n    : IncludedPropSupplySource<Value>\n  : Value extends true | 'required'\n    ? 'config'\n    : Value extends 'optional'\n      ? 'component' | 'config'\n      : never;\n\ntype GetPropsKey<\n  IncludeProps extends object,\n  Visibility extends InternalPropsType,\n  Passthrough extends IncludedPropSource | 'render' = 'render',\n> = {\n  [Key in keyof IncludeProps]: IncludedPropVisibility<\n    IncludeProps[Key]\n  > extends Visibility\n    ? Passthrough extends 'render'\n      ? Key\n      : Passthrough extends IncludedPropPassthrough<IncludeProps[Key]>\n        ? Key\n        : never\n    : never;\n}[keyof IncludeProps];\ntype SelectedIncludedProps<\n  Props extends InPropsObject,\n  IncludeProps extends IncludedProps<Props>,\n  Visibility extends InternalPropsType,\n  Passthrough extends IncludedPropSource | 'render' = 'render',\n> = Pick<\n  Props,\n  PropsKeys<Props, GetPropsKey<IncludeProps, Visibility, Passthrough>>\n>;\n\ntype OptionalPropDefinition<Definition> = Definition extends {\n  optional(): infer OptionalDefinition;\n}\n  ? OptionalDefinition\n  : Definition;\n\n/** Raw validator definitions accepted by a generated component call. */\nexport type IncludedComponentPropDefinitions<\n  Props extends InPropsObject,\n  IncludeProps extends IncludedProps<Props>,\n> = SelectedIncludedProps<Props, IncludeProps, 'required', 'component'> & {\n  [Key in keyof SelectedIncludedProps<\n    Props,\n    IncludeProps,\n    'optional',\n    'component'\n  >]: OptionalPropDefinition<\n    SelectedIncludedProps<Props, IncludeProps, 'optional', 'component'>[Key]\n  >;\n};\n\nexport type ResolvedIncludedProps<\n  Props extends InPropsObject,\n  IncludeProps extends IncludedProps<Props>,\n> = ResolveLayoutProps<SelectedIncludedProps<Props, IncludeProps, 'required'>> &\n  Partial<\n    ResolveLayoutProps<SelectedIncludedProps<Props, IncludeProps, 'optional'>>\n  >;\n\nexport type ResolvedIncludedConfigProps<\n  Props extends InPropsObject,\n  IncludeProps extends IncludedProps<Props>,\n> = ResolveLayoutProps<\n  SelectedIncludedProps<Props, IncludeProps, 'required', 'config'>\n> &\n  Partial<\n    ResolveLayoutProps<\n      SelectedIncludedProps<Props, IncludeProps, 'optional', 'config'>\n    >\n  >;\n\nexport type ResolvedIncludedComponentProps<\n  Props extends InPropsObject,\n  IncludeProps extends IncludedProps<Props>,\n> = ResolveLayoutProps<\n  SelectedIncludedProps<Props, IncludeProps, 'required', 'component'>\n> &\n  Partial<\n    ResolveLayoutProps<\n      SelectedIncludedProps<Props, IncludeProps, 'optional', 'component'>\n    >\n  >;\n\n/**\n * Like {@link ResolvedIncludedProps}, but keeps included prop keys exactly as\n * declared (no `JSX.Element` capitalization).\n */\nexport type ResolvedIncludedPropsAsDefined<\n  Props extends InPropsObject,\n  IncludeProps extends IncludedProps<Props>,\n> = ResolveLayoutPropsAsDefined<\n  SelectedIncludedProps<Props, IncludeProps, 'required'>\n> &\n  Partial<\n    ResolveLayoutPropsAsDefined<\n      SelectedIncludedProps<Props, IncludeProps, 'optional'>\n    >\n  >;\nexport type LayoutRenderProps<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents = {},\n  IncludeProps extends IncludedProps<\n    MergedLayoutInProps<Resources, Options, Composables>\n  > = {},\n  CustomProps extends CustomPropsObject = {},\n> = Show<\n  ResolveRenderProps<CustomProps> &\n    ResolvedIncludedProps<\n      MergedLayoutInProps<Resources, Options, Composables>,\n      IncludeProps\n    >\n>;\n\nexport function getIncludedPropBehavior(value: unknown): {\n  visibility: 'required' | 'optional';\n  passthrough: 'component' | 'config';\n} | null {\n  if (value === null || typeof value !== 'object') {\n    return null;\n  }\n\n  if ('visibility' in value || 'passthrough' in value) {\n    throw new LayoutConfigurationError(\n      'Include properties visibility and passthrough were removed; use required and suppliedVia.',\n    );\n  }\n\n  const required =\n    'required' in value && typeof value.required === 'boolean'\n      ? value.required\n      : undefined;\n  const suppliedVia = 'suppliedVia' in value ? value.suppliedVia : undefined;\n\n  if (\n    required === undefined ||\n    (suppliedVia !== 'component' && suppliedVia !== 'config')\n  ) {\n    return null;\n  }\n\n  return {\n    visibility: required ? 'required' : 'optional',\n    passthrough: suppliedVia,\n  };\n}\n"],"mappings":";;;AA0PA,SAAgB,wBAAwB,OAG/B;CACP,IAAI,UAAU,QAAQ,OAAO,UAAU,UACrC,OAAO;CAGT,IAAI,gBAAgB,SAAS,iBAAiB,OAC5C,MAAM,IAAIA,4DACR,2FACF;CAGF,MAAM,WACJ,cAAc,SAAS,OAAO,MAAM,aAAa,YAC7C,MAAM,WACN;CACN,MAAM,cAAc,iBAAiB,QAAQ,MAAM,cAAc;CAEjE,IACE,aAAa,UACZ,gBAAgB,eAAe,gBAAgB,UAEhD,OAAO;CAGT,OAAO;EACL,YAAY,WAAW,aAAa;EACpC,aAAa;CACf;AACF"}
+{"version":3,"file":"props.cjs","names":["LayoutConfigurationError"],"sources":["../src/props.ts"],"sourcesContent":["import type { WithChildren } from '@jfdevelops/react-layout-composables';\nimport type { CustomPropsObject, ResolveRenderProps } from './custom-props';\nimport { LayoutConfigurationError } from './errors';\nimport type {\n  ComposableComponents,\n  MergePresetProps,\n} from '@jfdevelops/react-layout-composables';\nimport type { InPropsObject } from '@jfdevelops/react-layout-composables';\nimport {\n  EnumWrappedProp,\n  LiteralWrappedProp,\n  ResolveLayoutProps,\n  ResolveLayoutPropsAsDefined,\n  ResolveProps,\n} from '@jfdevelops/react-layout-validator';\nimport { ResourceDefinition, ResourceEnum } from './resource';\nimport { Show } from './utils';\n\nexport type { InPropsObject };\n\n/** Shared include/custom contract used by configurable layout helpers. */\nexport type PropsContract<Include extends object = object, Custom extends object = object> = {\n  include?: Include;\n  custom?: Custom;\n};\n\n/**\n * Two-argument `render(props, context)` used by createComponent and scoped\n * resource components. `Context` is sibling components (scoped) or the\n * resource render context (top-level).\n */\nexport type PropsContextRender<RenderProps, Context, Result = unknown> = (\n  props: WithChildren<RenderProps>,\n  context: Context,\n) => Result;\n\n/**\n * Shared `{ props?, render }` shape used by createComponent, scoped\n * components, and anywhere else a value declares props and a two-arg render.\n *\n * @typeParam Props - Declared on the entry (`props`). Often an\n *   {@link InPropsObject}, or a layout include/custom bag.\n * @typeParam RenderProps - First argument to `render` (defaults to\n *   {@link ResolveProps}<Props> when Props is an {@link InPropsObject})\n * @typeParam Result - `render` return type\n * @typeParam Context - Second argument to `render`\n */\nexport interface PropsRenderDefinition<\n  Props = InPropsObject,\n  RenderProps = Props extends InPropsObject ? ResolveProps<Props> : unknown,\n  Result = unknown,\n  Context = unknown,\n> {\n  props?: Props;\n  render: PropsContextRender<RenderProps, Context, Result>;\n}\n\nexport type InPropsOptions<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Name extends string,\n> = {\n  name: LiteralWrappedProp<Name, 'string', 'required'>;\n  resource: EnumWrappedProp<ResourceEnum<Resources>, 'string', 'required'>;\n};\nexport type InPropsFunction<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = <Name extends string>(\n  props: Show<InPropsOptions<Resources, Name>>,\n) => InPropsObject;\nexport type InPropsDefinition<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = InPropsObject | InPropsFunction<Resources>;\nexport type InferredInProps<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n> = Options extends InPropsFunction<Resources> ? ReturnType<Options> : Options;\nexport type MergedLayoutInProps<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n> =\n  InferredInProps<Resources, Options> extends InPropsObject\n    ? InferredInProps<Resources, Options> & MergePresetProps<Composables>\n    : never;\nexport type RequiredVariant = true | 'required';\n/**\n * @typeParam RequiredVariant How the required props are selected. In application code,\n * it will always be `true`, but internally we need to support `'required'` as well.\n */\ntype PropsType<Variant extends RequiredVariant = true> = Variant | 'optional';\ntype InternalPropsType = PropsType<'required'>;\ntype IncludedPropSource = 'component' | 'config';\n/** Controls whether an included prop is required and where it is supplied. */\nexport type IncludedPropBehavior = {\n  required: boolean;\n  suppliedVia: IncludedPropSource;\n};\n\ntype IncludedPropType = PropsType | IncludedPropBehavior;\n/**\n * A map of props to include in the layout.\n */\nexport type IncludedProps<T extends object> = {\n  [K in keyof T & string]?: IncludedPropType;\n};\n\ntype PropsKeys<Props extends InPropsObject, T> = T & keyof Props;\nexport type IncludedPropVisibility<Value> = Value extends { required: boolean }\n  ? Value['required'] extends true\n    ? 'required'\n    : 'optional'\n  : Value extends true | 'required'\n    ? 'required'\n    : Value extends 'optional'\n      ? 'optional'\n      : never;\nexport type IncludedPropSupplySource<Value> = Value extends {\n  suppliedVia: IncludedPropSource;\n}\n  ? Value['suppliedVia']\n  : never;\n/**\n * Internal representation of the supported include behavior.\n */\nexport type NormalizedIncludedPropBehavior<Value> = Value extends\n  | { required: boolean }\n  | { suppliedVia: IncludedPropSource }\n  ? {\n      visibility: IncludedPropVisibility<Value>;\n      passthrough: IncludedPropSupplySource<Value>;\n    }\n  : Value;\n\nexport type IncludedPropPassthrough<Value> = Value extends\n  | { required: boolean }\n  | { suppliedVia: IncludedPropSource }\n  ? IncludedPropSupplySource<Value> extends 'component'\n    ? IncludedPropVisibility<Value> extends 'optional'\n      ? 'component' | 'config'\n      : 'component'\n    : IncludedPropSupplySource<Value>\n  : Value extends true | 'required'\n    ? 'config'\n    : Value extends 'optional'\n      ? 'component' | 'config'\n      : never;\n\ntype GetPropsKey<\n  IncludeProps extends object,\n  Visibility extends InternalPropsType,\n  Passthrough extends IncludedPropSource | 'render' = 'render',\n> = {\n  [Key in keyof IncludeProps]: IncludedPropVisibility<\n    IncludeProps[Key]\n  > extends Visibility\n    ? Passthrough extends 'render'\n      ? Key\n      : Passthrough extends IncludedPropPassthrough<IncludeProps[Key]>\n        ? Key\n        : never\n    : never;\n}[keyof IncludeProps];\ntype SelectedIncludedProps<\n  Props extends InPropsObject,\n  IncludeProps extends IncludedProps<Props>,\n  Visibility extends InternalPropsType,\n  Passthrough extends IncludedPropSource | 'render' = 'render',\n> = Pick<\n  Props,\n  PropsKeys<Props, GetPropsKey<IncludeProps, Visibility, Passthrough>>\n>;\n\ntype OptionalPropDefinition<Definition> = Definition extends {\n  optional(): infer OptionalDefinition;\n}\n  ? OptionalDefinition\n  : Definition;\n\n/** Raw validator definitions accepted by a generated component call. */\nexport type IncludedComponentPropDefinitions<\n  Props extends InPropsObject,\n  IncludeProps extends IncludedProps<Props>,\n> = SelectedIncludedProps<Props, IncludeProps, 'required', 'component'> & {\n  [Key in keyof SelectedIncludedProps<\n    Props,\n    IncludeProps,\n    'optional',\n    'component'\n  >]: OptionalPropDefinition<\n    SelectedIncludedProps<Props, IncludeProps, 'optional', 'component'>[Key]\n  >;\n};\n\nexport type ResolvedIncludedProps<\n  Props extends InPropsObject,\n  IncludeProps extends IncludedProps<Props>,\n> = ResolveLayoutProps<SelectedIncludedProps<Props, IncludeProps, 'required'>> &\n  Partial<\n    ResolveLayoutProps<SelectedIncludedProps<Props, IncludeProps, 'optional'>>\n  >;\n\nexport type ResolvedIncludedConfigProps<\n  Props extends InPropsObject,\n  IncludeProps extends IncludedProps<Props>,\n> = ResolveLayoutProps<\n  SelectedIncludedProps<Props, IncludeProps, 'required', 'config'>\n> &\n  Partial<\n    ResolveLayoutProps<\n      SelectedIncludedProps<Props, IncludeProps, 'optional', 'config'>\n    >\n  >;\n\nexport type ResolvedIncludedComponentProps<\n  Props extends InPropsObject,\n  IncludeProps extends IncludedProps<Props>,\n> = ResolveLayoutProps<\n  SelectedIncludedProps<Props, IncludeProps, 'required', 'component'>\n> &\n  Partial<\n    ResolveLayoutProps<\n      SelectedIncludedProps<Props, IncludeProps, 'optional', 'component'>\n    >\n  >;\n\n/**\n * Like {@link ResolvedIncludedProps}, but keeps included prop keys exactly as\n * declared (no `JSX.Element` capitalization).\n */\nexport type ResolvedIncludedPropsAsDefined<\n  Props extends InPropsObject,\n  IncludeProps extends IncludedProps<Props>,\n> = ResolveLayoutPropsAsDefined<\n  SelectedIncludedProps<Props, IncludeProps, 'required'>\n> &\n  Partial<\n    ResolveLayoutPropsAsDefined<\n      SelectedIncludedProps<Props, IncludeProps, 'optional'>\n    >\n  >;\nexport type LayoutRenderProps<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents = {},\n  IncludeProps extends IncludedProps<\n    MergedLayoutInProps<Resources, Options, Composables>\n  > = {},\n  CustomProps extends CustomPropsObject = {},\n> = Show<\n  ResolveRenderProps<CustomProps> &\n    ResolvedIncludedProps<\n      MergedLayoutInProps<Resources, Options, Composables>,\n      IncludeProps\n    >\n>;\n\nexport function getIncludedPropBehavior(value: unknown): {\n  visibility: 'required' | 'optional';\n  passthrough: 'component' | 'config';\n} | null {\n  if (value === null || typeof value !== 'object') {\n    return null;\n  }\n\n  if ('visibility' in value || 'passthrough' in value) {\n    throw new LayoutConfigurationError(\n      'Include properties visibility and passthrough were removed; use required and suppliedVia.',\n    );\n  }\n\n  const required =\n    'required' in value && typeof value.required === 'boolean'\n      ? value.required\n      : undefined;\n  const suppliedVia = 'suppliedVia' in value ? value.suppliedVia : undefined;\n\n  if (\n    required === undefined ||\n    (suppliedVia !== 'component' && suppliedVia !== 'config')\n  ) {\n    return null;\n  }\n\n  return {\n    visibility: required ? 'required' : 'optional',\n    passthrough: suppliedVia,\n  };\n}\n"],"mappings":";;;AAgQA,SAAgB,wBAAwB,OAG/B;CACP,IAAI,UAAU,QAAQ,OAAO,UAAU,UACrC,OAAO;CAGT,IAAI,gBAAgB,SAAS,iBAAiB,OAC5C,MAAM,IAAIA,4DACR,2FACF;CAGF,MAAM,WACJ,cAAc,SAAS,OAAO,MAAM,aAAa,YAC7C,MAAM,WACN;CACN,MAAM,cAAc,iBAAiB,QAAQ,MAAM,cAAc;CAEjE,IACE,aAAa,UACZ,gBAAgB,eAAe,gBAAgB,UAEhD,OAAO;CAGT,OAAO;EACL,YAAY,WAAW,aAAa;EACpC,aAAa;CACf;AACF"}

package/dist/props.d.cts

@@ -5,6 +5,11 @@ import { ComposableComponents, InPropsObject, MergePresetProps, WithChildren } f
 import { EnumWrappedProp, LiteralWrappedProp, ResolveLayoutProps, ResolveLayoutPropsAsDefined, ResolveProps } from "@jfdevelops/react-layout-validator";
 
 //#region src/props.d.ts
+/** Shared include/custom contract used by configurable layout helpers. */
+type PropsContract<Include extends object = object, Custom extends object = object> = {
+  include?: Include;
+  custom?: Custom;
+};
 /**
  * Two-argument `render(props, context)` used by createComponent and scoped
  * resource components. `Context` is sibling components (scoped) or the
@@ -92,5 +97,5 @@ type ResolvedIncludedComponentProps<Props extends InPropsObject, IncludeProps ex
 type ResolvedIncludedPropsAsDefined<Props extends InPropsObject, IncludeProps extends IncludedProps<Props>> = ResolveLayoutPropsAsDefined<SelectedIncludedProps<Props, IncludeProps, 'required'>> & Partial<ResolveLayoutPropsAsDefined<SelectedIncludedProps<Props, IncludeProps, 'optional'>>>;
 type LayoutRenderProps<Resources extends ReadonlyArray<ResourceDefinition>, Options extends InPropsDefinition<Resources>, Composables extends ComposableComponents = {}, IncludeProps extends IncludedProps<MergedLayoutInProps<Resources, Options, Composables>> = {}, CustomProps extends CustomPropsObject = {}> = Show<ResolveRenderProps<CustomProps> & ResolvedIncludedProps<MergedLayoutInProps<Resources, Options, Composables>, IncludeProps>>;
 //#endregion
-export { InPropsDefinition, InPropsFunction, type InPropsObject, InPropsOptions, IncludedComponentPropDefinitions, IncludedPropBehavior, IncludedProps, InferredInProps, LayoutRenderProps, MergedLayoutInProps, NormalizedIncludedPropBehavior, PropsContextRender, PropsRenderDefinition, ResolvedIncludedComponentProps, ResolvedIncludedConfigProps, ResolvedIncludedProps, ResolvedIncludedPropsAsDefined };
+export { InPropsDefinition, InPropsFunction, type InPropsObject, InPropsOptions, IncludedComponentPropDefinitions, IncludedPropBehavior, IncludedProps, InferredInProps, LayoutRenderProps, MergedLayoutInProps, NormalizedIncludedPropBehavior, PropsContextRender, PropsContract, PropsRenderDefinition, ResolvedIncludedComponentProps, ResolvedIncludedConfigProps, ResolvedIncludedProps, ResolvedIncludedPropsAsDefined };
 //# sourceMappingURL=props.d.cts.map

package/dist/props.d.cts.map

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

package/dist/props.d.mts

@@ -5,6 +5,11 @@ import { ComposableComponents, InPropsObject, MergePresetProps, WithChildren } f
 import { EnumWrappedProp, LiteralWrappedProp, ResolveLayoutProps, ResolveLayoutPropsAsDefined, ResolveProps } from "@jfdevelops/react-layout-validator";
 
 //#region src/props.d.ts
+/** Shared include/custom contract used by configurable layout helpers. */
+type PropsContract<Include extends object = object, Custom extends object = object> = {
+  include?: Include;
+  custom?: Custom;
+};
 /**
  * Two-argument `render(props, context)` used by createComponent and scoped
  * resource components. `Context` is sibling components (scoped) or the
@@ -92,5 +97,5 @@ type ResolvedIncludedComponentProps<Props extends InPropsObject, IncludeProps ex
 type ResolvedIncludedPropsAsDefined<Props extends InPropsObject, IncludeProps extends IncludedProps<Props>> = ResolveLayoutPropsAsDefined<SelectedIncludedProps<Props, IncludeProps, 'required'>> & Partial<ResolveLayoutPropsAsDefined<SelectedIncludedProps<Props, IncludeProps, 'optional'>>>;
 type LayoutRenderProps<Resources extends ReadonlyArray<ResourceDefinition>, Options extends InPropsDefinition<Resources>, Composables extends ComposableComponents = {}, IncludeProps extends IncludedProps<MergedLayoutInProps<Resources, Options, Composables>> = {}, CustomProps extends CustomPropsObject = {}> = Show<ResolveRenderProps<CustomProps> & ResolvedIncludedProps<MergedLayoutInProps<Resources, Options, Composables>, IncludeProps>>;
 //#endregion
-export { InPropsDefinition, InPropsFunction, type InPropsObject, InPropsOptions, IncludedComponentPropDefinitions, IncludedPropBehavior, IncludedProps, InferredInProps, LayoutRenderProps, MergedLayoutInProps, NormalizedIncludedPropBehavior, PropsContextRender, PropsRenderDefinition, ResolvedIncludedComponentProps, ResolvedIncludedConfigProps, ResolvedIncludedProps, ResolvedIncludedPropsAsDefined };
+export { InPropsDefinition, InPropsFunction, type InPropsObject, InPropsOptions, IncludedComponentPropDefinitions, IncludedPropBehavior, IncludedProps, InferredInProps, LayoutRenderProps, MergedLayoutInProps, NormalizedIncludedPropBehavior, PropsContextRender, PropsContract, PropsRenderDefinition, ResolvedIncludedComponentProps, ResolvedIncludedConfigProps, ResolvedIncludedProps, ResolvedIncludedPropsAsDefined };
 //# sourceMappingURL=props.d.mts.map