@jfdevelops/react-layout 1.1.0 → 1.3.0

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

@@ -0,0 +1,49 @@
+import { capitalize } from "../utils/capitalize.mjs";
+
+//#region src/create-config/layout-name.d.ts
+/** Literal placeholders allow a naming convention to retain resource-specific names. */
+declare const resourceNameToken: unique symbol;
+type ResourceToken = string & {
+  readonly [resourceNameToken]: true;
+};
+type CapitalizedToken = 'LayoutCapitalizedResourceToken';
+type PatternNameContext = Omit<LayoutNameContext<ResourceToken>, 'capitalize'> & {
+  capitalize: <T extends string>(value: T) => T extends ResourceToken ? CapitalizedToken : Capitalize<T>;
+};
+type PrefixToken = '__layout_prefix__';
+type BeforeToken = '__layout_before_suffix__';
+type AppendToken = '__layout_append__';
+interface LayoutNameContext<Resource extends string = string, State extends string = string> {
+  resource: Resource;
+  states: readonly State[];
+  capitalize: typeof capitalize;
+}
+interface LayoutNameParts {
+  prefix?: string;
+  beforeSuffix?: string;
+  append?: string;
+}
+type PatternParts = {
+  prefix: PrefixToken;
+  beforeSuffix: BeforeToken;
+  append: AppendToken;
+};
+type Replace<S extends string, From extends string, To extends string> = S extends `${infer A}${From}${infer B}` ? `${A}${To}${Replace<B, From, To>}` : S;
+type ReplaceResource<S extends string, Resource extends string> = S extends `${ResourceToken}${infer Rest}` ? `${Resource}${ReplaceResource<Rest, Resource>}` : S extends `${infer First}${infer Rest}` ? `${First}${ReplaceResource<Rest, Resource>}` : S;
+type Part<P, K extends keyof LayoutNameParts> = K extends keyof P ? Extract<P[K], string> : '';
+type ResolveNamePattern<Pattern extends string, Resource extends string, Parts = {}> = ReplaceResource<Replace<Replace<Replace<Replace<Pattern, PrefixToken, Part<Parts, 'prefix'>>, BeforeToken, Part<Parts, 'beforeSuffix'>>, AppendToken, Part<Parts, 'append'>>, CapitalizedToken, Capitalize<Resource>>, Resource>;
+declare const layoutNamePattern: unique symbol;
+interface LayoutNameResolver<Pattern extends string = string, Parts = {}> {
+  (context: LayoutNameContext): string;
+  readonly [layoutNamePattern]: {
+    pattern: Pattern;
+    parts: Parts;
+  };
+}
+type LayoutNameInput<Resource extends string = string, States extends string = string, Name extends string = string> = Name | ((context: LayoutNameContext<Resource, States>) => Name);
+type ResolvedLayoutName<Naming, Resource extends string> = Naming extends LayoutNameResolver<infer Pattern, infer Parts> ? ResolveNamePattern<Pattern, Resource, Parts> : Naming extends ((...args: any[]) => infer Result) ? Extract<Result, string> : Naming extends string ? Naming : string;
+/** Define the stable structure once; supply optional variations at each call site. */
+declare function defineLayoutName<const Pattern extends string>(pattern: (context: PatternNameContext, parts: PatternParts) => Pattern): <const Parts extends LayoutNameParts = {}>(parts?: Parts | ((context: PatternNameContext) => Parts)) => LayoutNameResolver<Pattern, Parts>;
+//#endregion
+export { LayoutNameContext, LayoutNameInput, LayoutNameParts, LayoutNameResolver, ResolvedLayoutName, defineLayoutName };
+//# sourceMappingURL=layout-name.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"layout-name.d.mts","names":[],"sources":["../../src/create-config/layout-name.ts"],"mappings":";;;;cAEc,iBAAA;AAAA,KACT,aAAA;EAAA,UAAqC,iBAAiB;AAAA;AAAA,KACtD,gBAAA;AAAA,KACA,kBAAA,GAAqB,IAAA,CACxB,iBAAA,CAAkB,aAAA;EAGlB,UAAA,qBACE,KAAA,EAAO,CAAA,KACJ,CAAA,SAAU,aAAA,GAAgB,gBAAA,GAAmB,UAAA,CAAW,CAAA;AAAA;AAAA,KAE1D,WAAA;AAAA,KACA,WAAA;AAAA,KACA,WAAA;AAAA,UACY,iBAAA;EAIf,QAAA,EAAU,QAAA;EACV,MAAA,WAAiB,KAAA;EACjB,UAAA,SAAmB,UAAA;AAAA;AAAA,UAEJ,eAAA;EACf,MAAA;EACA,YAAA;EACA,MAAA;AAAA;AAAA,KAEG,YAAA;EACH,MAAA,EAAQ,WAAA;EACR,YAAA,EAAc,WAAA;EACd,MAAA,EAAQ,WAAA;AAAA;AAAA,KAEL,OAAA,6DAID,CAAA,sBAAuB,IAAA,kBACpB,CAAA,GAAI,EAAA,GAAK,OAAA,CAAQ,CAAA,EAAG,IAAA,EAAM,EAAA,MAC7B,CAAA;AAAA,KACC,eAAA,8CAGD,CAAA,YAAa,aAAA,qBACV,QAAA,GAAW,eAAA,CAAgB,IAAA,EAAM,QAAA,MACpC,CAAA,4CACG,KAAA,GAAQ,eAAA,CAAgB,IAAA,EAAM,QAAA,MACjC,CAAA;AAAA,KACC,IAAA,oBAAwB,eAAA,IAAmB,CAAA,eAAgB,CAAA,GAC5D,OAAA,CAAQ,CAAA,CAAE,CAAA;AAAA,KAEF,kBAAA,gEAIR,eAAA,CACF,OAAA,CACE,OAAA,CACE,OAAA,CACE,OAAA,CAAQ,OAAA,EAAS,WAAA,EAAa,IAAA,CAAK,KAAA,cACnC,WAAA,EACA,IAAA,CAAK,KAAA,oBAEP,WAAA,EACA,IAAA,CAAK,KAAA,cAEP,gBAAA,EACA,UAAA,CAAW,QAAA,IAEb,QAAA;AAAA,cAEW,iBAAA;AAAA,UACI,kBAAA;EAAA,CAId,OAAA,EAAS,iBAAA;EAAA,UACA,iBAAA;IAAsB,OAAA,EAAS,OAAA;IAAS,KAAA,EAAO,KAAA;EAAA;AAAA;AAAA,KAE/C,eAAA,mGAIR,IAAA,KAAS,OAAA,EAAS,iBAAA,CAAkB,QAAA,EAAU,MAAA,MAAY,IAAA;AAAA,KAClD,kBAAA,oCAGR,MAAA,SAAe,kBAAA,+BACf,kBAAA,CAAmB,OAAA,EAAS,QAAA,EAAU,KAAA,IACtC,MAAA,cAAmB,IAAA,4BACnB,OAAA,CAAQ,MAAA,YACR,MAAA,kBACA,MAAA;;iBAGY,gBAAA,+BACd,OAAA,GAAU,OAAA,EAAS,kBAAA,EAAoB,KAAA,EAAO,YAAA,KAAiB,OAAA,wBAE7B,eAAA,OAAe,KAAA,GACvC,KAAA,KAAU,OAAA,EAAS,kBAAA,KAAuB,KAAA,MACjD,kBAAA,CAAmB,OAAA,EAAS,KAAA"}

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

@@ -0,0 +1,20 @@
+//#region src/create-config/layout-name.ts
+const layoutNamePattern = Symbol("layoutNamePattern");
+/** Define the stable structure once; supply optional variations at each call site. */
+function defineLayoutName(pattern) {
+	function name(parts) {
+		const resolver = ((context) => pattern(context, {
+			prefix: "",
+			beforeSuffix: "",
+			append: "",
+			...typeof parts === "function" ? parts(context) : parts
+		}));
+		Object.defineProperty(resolver, layoutNamePattern, { value: {} });
+		return resolver;
+	}
+	return name;
+}
+
+//#endregion
+export { defineLayoutName };
+//# sourceMappingURL=layout-name.mjs.map

package/dist/create-config/layout-name.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-name.mjs","names":[],"sources":["../../src/create-config/layout-name.ts"],"sourcesContent":["import { capitalize } from '../utils/capitalize';\n/** Literal placeholders allow a naming convention to retain resource-specific names. */\ndeclare const resourceNameToken: unique symbol;\ntype ResourceToken = string & { readonly [resourceNameToken]: true };\ntype CapitalizedToken = 'LayoutCapitalizedResourceToken';\ntype PatternNameContext = Omit<\n  LayoutNameContext<ResourceToken>,\n  'capitalize'\n> & {\n  capitalize: <T extends string>(\n    value: T\n  ) => T extends ResourceToken ? CapitalizedToken : Capitalize<T>;\n};\ntype PrefixToken = '__layout_prefix__';\ntype BeforeToken = '__layout_before_suffix__';\ntype AppendToken = '__layout_append__';\nexport interface LayoutNameContext<\n  Resource extends string = string,\n  State extends string = string\n> {\n  resource: Resource;\n  states: readonly State[];\n  capitalize: typeof capitalize;\n}\nexport interface LayoutNameParts {\n  prefix?: string;\n  beforeSuffix?: string;\n  append?: string;\n}\ntype PatternParts = {\n  prefix: PrefixToken;\n  beforeSuffix: BeforeToken;\n  append: AppendToken;\n};\ntype Replace<\n  S extends string,\n  From extends string,\n  To extends string\n> = S extends `${infer A}${From}${infer B}`\n  ? `${A}${To}${Replace<B, From, To>}`\n  : S;\ntype ReplaceResource<\n  S extends string,\n  Resource extends string\n> = S extends `${ResourceToken}${infer Rest}`\n  ? `${Resource}${ReplaceResource<Rest, Resource>}`\n  : S extends `${infer First}${infer Rest}`\n  ? `${First}${ReplaceResource<Rest, Resource>}`\n  : S;\ntype Part<P, K extends keyof LayoutNameParts> = K extends keyof P\n  ? Extract<P[K], string>\n  : '';\nexport type ResolveNamePattern<\n  Pattern extends string,\n  Resource extends string,\n  Parts = {}\n> = ReplaceResource<\n  Replace<\n    Replace<\n      Replace<\n        Replace<Pattern, PrefixToken, Part<Parts, 'prefix'>>,\n        BeforeToken,\n        Part<Parts, 'beforeSuffix'>\n      >,\n      AppendToken,\n      Part<Parts, 'append'>\n    >,\n    CapitalizedToken,\n    Capitalize<Resource>\n  >,\n  Resource\n>;\nexport const layoutNamePattern: unique symbol = Symbol('layoutNamePattern');\nexport interface LayoutNameResolver<\n  Pattern extends string = string,\n  Parts = {}\n> {\n  (context: LayoutNameContext): string;\n  readonly [layoutNamePattern]: { pattern: Pattern; parts: Parts };\n}\nexport type LayoutNameInput<\n  Resource extends string = string,\n  States extends string = string,\n  Name extends string = string\n> = Name | ((context: LayoutNameContext<Resource, States>) => Name);\nexport type ResolvedLayoutName<\n  Naming,\n  Resource extends string\n> = Naming extends LayoutNameResolver<infer Pattern, infer Parts>\n  ? ResolveNamePattern<Pattern, Resource, Parts>\n  : Naming extends (...args: any[]) => infer Result\n  ? Extract<Result, string>\n  : Naming extends string\n  ? Naming\n  : string;\n/** Define the stable structure once; supply optional variations at each call site. */\nexport function defineLayoutName<const Pattern extends string>(\n  pattern: (context: PatternNameContext, parts: PatternParts) => Pattern\n) {\n  function name<const Parts extends LayoutNameParts = {}>(\n    parts?: Parts | ((context: PatternNameContext) => Parts)\n  ): LayoutNameResolver<Pattern, Parts> {\n    const resolver = ((context: LayoutNameContext) =>\n      pattern(\n        context as unknown as PatternNameContext,\n        {\n          prefix: '',\n          beforeSuffix: '',\n          append: '',\n          ...(typeof parts === 'function'\n            ? parts(context as unknown as PatternNameContext)\n            : parts),\n        } as PatternParts\n      )) as unknown as LayoutNameResolver<Pattern, Parts>;\n    Object.defineProperty(resolver, layoutNamePattern, { value: {} });\n    return resolver;\n  }\n  return name;\n}\n"],"mappings":";AAwEA,MAAa,oBAAmC,OAAO,mBAAmB;;AAwB1E,SAAgB,iBACd,SACA;CACA,SAAS,KACP,OACoC;EACpC,MAAM,aAAa,YACjB,QACE,SACA;GACE,QAAQ;GACR,cAAc;GACd,QAAQ;GACR,GAAI,OAAO,UAAU,aACjB,MAAM,OAAwC,IAC9C;EACN,CACF;EACF,OAAO,eAAe,UAAU,mBAAmB,EAAE,OAAO,CAAC,EAAE,CAAC;EAChE,OAAO;CACT;CACA,OAAO;AACT"}

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

@@ -0,0 +1,20 @@
+
+//#region src/create-config/merge-layout-props.ts
+/** Merge contracts by section and prop key; the closest declaration wins. */
+function mergeLayoutProps(base, local) {
+	if (!base && !local) return void 0;
+	return {
+		include: {
+			...base?.include,
+			...local?.include
+		},
+		custom: {
+			...base?.custom,
+			...local?.custom
+		}
+	};
+}
+
+//#endregion
+exports.mergeLayoutProps = mergeLayoutProps;
+//# sourceMappingURL=merge-layout-props.cjs.map

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

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

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

@@ -0,0 +1,19 @@
+//#region src/create-config/merge-layout-props.ts
+/** Merge contracts by section and prop key; the closest declaration wins. */
+function mergeLayoutProps(base, local) {
+	if (!base && !local) return void 0;
+	return {
+		include: {
+			...base?.include,
+			...local?.include
+		},
+		custom: {
+			...base?.custom,
+			...local?.custom
+		}
+	};
+}
+
+//#endregion
+export { mergeLayoutProps };
+//# sourceMappingURL=merge-layout-props.mjs.map

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

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

package/dist/create-config/render-state.cjs

@@ -1,4 +1,6 @@
+const require_layout_configuration_error = require('../errors/layout-configuration-error.cjs');
 const require_state_composable = require('./state-composable.cjs');
+let _jfdevelops_react_layout_composables = require("@jfdevelops/react-layout-composables");
 
 //#region src/create-config/render-state.ts
 const deferredRenderStateSymbol = Symbol("deferredRenderState");
@@ -30,10 +32,82 @@ function createRenderStateBuilder(_arguments) {
 	function createRenderState(input) {
 		return toFragment(normalizeDefinition(input));
 	}
+	createRenderState.fromState = (input) => {
+		const entry = isLazyRenderState(input.ref) ? input.ref : Object.values(input.ref)[0];
+		if (isLazyRenderState(entry)) {
+			const lazyState = { [lazyRenderStateSymbol]: async () => {
+				const source = await findDefinedRenderState(await entry[lazyRenderStateSymbol]());
+				return { Derived: createRenderState.fromState({
+					...input,
+					ref: toFragment(source)
+				}) };
+			} };
+			const name = input.state ?? "default";
+			const fragment = { [name]: lazyState };
+			Object.defineProperty(fragment, definedRenderStateSymbol, { value: lazyState });
+			return require_state_composable.withStateComposable(fragment, {
+				input: lazyState,
+				name
+			});
+		}
+		const source = isDeferredRenderState(entry) ? entry[deferredRenderStateSymbol] : definedRenderStateSymbol in input.ref ? input.ref[definedRenderStateSymbol] : void 0;
+		if (!source || typeof source.render !== "function") throw new require_layout_configuration_error.LayoutConfigurationError("fromState requires a created render state");
+		const custom = input.props?.custom ?? {};
+		const includes = input.props?.include ?? Object.fromEntries(Object.entries({
+			...source.props?.include,
+			...Object.fromEntries(Object.entries(source.props?.custom ?? {}).map(([key, prop]) => [key, {
+				visibility: prop.visibility,
+				passthrough: "component"
+			}]))
+		}).filter(([key]) => !(key in custom)));
+		return toFragment({
+			state: input.state ?? "default",
+			props: {
+				custom,
+				include: includes
+			},
+			composables: (create, states) => {
+				const inherited = source.composables?.(create, states) ?? {};
+				const local = input.composables?.(create, states) ?? {};
+				if (Object.prototype.hasOwnProperty.call(local, "Ref")) throw new require_layout_configuration_error.LayoutConfigurationError("Composable name \"Ref\" is reserved by fromState");
+				const schemas = Object.assign({}, ...(0, _jfdevelops_react_layout_composables.collectComposablePresetEntries)(inherited).map(({ props }) => props), source.props?.custom);
+				const selected = Object.fromEntries(Object.entries(schemas).filter(([key]) => key in includes));
+				const referenceSource = {
+					...source,
+					props: {
+						...source.props,
+						include: Object.fromEntries(Object.entries(source.props?.include ?? {}).map(([key, behavior]) => [key, {
+							visibility: behavior === "optional" || typeof behavior === "object" && behavior !== null && "visibility" in behavior && behavior.visibility === "optional" ? "optional" : "required",
+							passthrough: "component"
+						}]))
+					}
+				};
+				const Ref = require_state_composable.createStateComposable({
+					input: input.lazy || isDeferredRenderState(entry) ? { [deferredRenderStateSymbol]: referenceSource } : referenceSource,
+					name: source.state ?? "default",
+					fallbackStateName: input.state
+				}, {
+					props: { include: Object.fromEntries(Object.keys(includes).map((key) => [key, true])) },
+					normalizeIncludedKeys: true
+				});
+				Object.defineProperty(Ref, _jfdevelops_react_layout_composables.composablePresetMetaKey, { value: {
+					key: "Ref",
+					props: selected
+				} });
+				return {
+					...local,
+					Ref
+				};
+			},
+			render: input.render
+		});
+	};
 	createRenderState.defer = (input) => {
 		const definition = normalizeDefinition(input);
 		const deferred = { [deferredRenderStateSymbol]: definition };
-		return require_state_composable.withStateComposable({ [definition.state ?? "default"]: deferred }, {
+		const fragment = { [definition.state ?? "default"]: deferred };
+		Object.defineProperty(fragment, definedRenderStateSymbol, { value: definition });
+		return require_state_composable.withStateComposable(fragment, {
 			input: deferred,
 			name: definition.state ?? "default"
 		});
@@ -56,13 +130,14 @@ function isLazyRenderState(value) {
 	return typeof value === "object" && value !== null && lazyRenderStateSymbol in value;
 }
 /**
-* Selects the single state definition exported by a lazy module. Throws when
-* the module exports none or more than one, avoiding ambiguous selection.
+* Resolves the single state exported by a lazy module, including derived lazy
+* states. Throws when a module exports none or more than one.
 */
-function findDefinedRenderState(module) {
+async function findDefinedRenderState(module) {
 	const definitions = Object.values(module).filter((value) => typeof value === "object" && value !== null && definedRenderStateSymbol in value);
 	if (definitions.length !== 1) throw new Error(`A lazy render-state module must export exactly one defined render state; received ${definitions.length}.`);
-	return definitions[0][definedRenderStateSymbol];
+	const definition = definitions[0][definedRenderStateSymbol];
+	return isLazyRenderState(definition) ? findDefinedRenderState(await definition[lazyRenderStateSymbol]()) : definition;
 }
 
 //#endregion

package/dist/create-config/render-state.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"render-state.cjs","names":["withStateComposable"],"sources":["../../src/create-config/render-state.ts"],"sourcesContent":["import type { JSX } from 'react';\nimport { withStateComposable, type StateComposable, type StateComposableHandle } from './state-composable';\nimport type { ResolveProps } from '@jfdevelops/react-layout-validator';\nimport type {\n  ComposableComponents,\n  CreateLayoutComposable,\n} from '@jfdevelops/react-layout-composables';\nimport type { InPropsObject } from '../props';\nimport type {\n  IncludedProps,\n  InPropsDefinition,\n  LayoutRenderProps,\n  MergedLayoutInProps,\n  ResolvedIncludedComponentProps,\n} from '../props';\nimport type { LayoutResourceKey, ResourceDefinition } from '../resource';\n\nexport const deferredRenderStateSymbol: unique symbol = Symbol(\n  'deferredRenderState',\n) as never;\nexport const lazyRenderStateSymbol: unique symbol = Symbol(\n  'lazyRenderState',\n) as never;\nexport const definedRenderStateSymbol: unique symbol = Symbol.for(\n  '@jfdevelops/react-layout/render-state',\n) as never;\nexport const definedResourceLayoutComponentSymbol: unique symbol = Symbol.for(\n  '@jfdevelops/react-layout/resource-layout-component',\n) as never;\n\n/** Runtime-compatible render-state shape used when inspecting lazy modules. */\nexport type AnyRenderStateDefinition = {\n  composables?: (create: CreateLayoutComposable<any>, states: any) => ComposableComponents;\n  props?: {\n    include?: Record<string, unknown>;\n    custom?: InPropsObject;\n  };\n  render: (props: any, context: any) => JSX.Element;\n  state?: string;\n};\n\n/** An inline state whose first render is scheduled through `React.lazy`. */\nexport type DeferredRenderState<Definition extends AnyRenderStateDefinition> = {\n  readonly [deferredRenderStateSymbol]: Definition;\n};\n\n/** A state definition supplied by a separately imported module. */\nexport type LazyRenderState<Definition extends AnyRenderStateDefinition> = {\n  readonly [lazyRenderStateSymbol]: () => Promise<Record<string, unknown>>;\n  readonly definition?: Definition;\n};\n\n/**\n * State names accepted by `createRenderState`. Built-in states are suggested by\n * autocomplete while any other string still creates a custom compound state.\n */\nexport type RenderStateName =\n  | 'default'\n  | 'Loading'\n  | 'Error'\n  | 'NotFound'\n  | (string & {});\n\n/** Callback shorthand for a render state with no local configuration. */\nexport type RenderStateCallback = (props: any, context: any) => JSX.Element;\n\n/**\n * Defines state-local composable components with a `create` helper narrowed to\n * the resources bound to the surrounding builder.\n */\nexport type RenderStateComposablesDefinition<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Composables extends ComposableComponents,\n  States = {},\n> = (\n  create: CreateLayoutComposable<LayoutResourceKey<Resources>>,\n  states: States,\n) => Composables;\n\n/**\n * Defines reusable layout-level composables while preserving their inferred\n * names, props, and bound resource union.\n */\nexport type LayoutComposablesDefinition<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Composables extends ComposableComponents,\n> = RenderStateComposablesDefinition<Resources, Composables>;\n\ntype BuilderRenderComposables<Composables extends ComposableComponents> = [\n  keyof Composables,\n] extends [never]\n  ? undefined\n  : Composables;\n\n/** Values available as the second argument of a created state's `render`. */\nexport type RenderStateContext<\n  Composables extends ComposableComponents,\n> = {\n  composables: BuilderRenderComposables<Composables>;\n  retry?: () => void;\n};\n\n/**\n * Resolves one state's custom props and explicitly included option/composable\n * props to the values received by its render callback.\n */\nexport type RenderStateProps<\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 InPropsObject,\n> = LayoutRenderProps<\n  Resources,\n  Options,\n  Composables,\n  IncludeProps,\n  CustomProps\n>;\n\ntype TypedRenderStateDefinition<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  State extends string,\n  CustomProps extends InPropsObject,\n  SharedComposables extends ComposableComponents,\n  StateComposables extends ComposableComponents,\n  IncludeProps extends IncludedProps<\n    MergedLayoutInProps<\n      Resources,\n      Options,\n      SharedComposables & StateComposables\n    >\n  >,\n> = {\n  composables?: RenderStateComposablesDefinition<Resources, StateComposables>;\n  props?: {\n    include?: IncludeProps;\n    custom?: CustomProps;\n  };\n  render: (\n    props: RenderStateProps<\n      Resources,\n      Options,\n      SharedComposables & StateComposables,\n      IncludeProps,\n      CustomProps\n    >,\n    context: RenderStateContext<SharedComposables & StateComposables>,\n  ) => JSX.Element;\n  state: State;\n};\n\n/**\n * Callback shorthand for a created state, typed with the bound resources,\n * options, and shared composables.\n */\nexport type TypedRenderStateCallback<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  SharedComposables extends ComposableComponents,\n> = (\n  props: RenderStateProps<Resources, Options, SharedComposables, {}, {}>,\n  context: RenderStateContext<SharedComposables>,\n) => JSX.Element;\n\ntype NormalizeRenderStateDefinition<Input> =\n  Input extends DeferredRenderState<infer Definition>\n    ? Definition\n    : Input extends RenderStateCallback\n      ? { render: Input; state: 'default' }\n      : Input extends AnyRenderStateDefinition\n        ? Input\n        : never;\n\ntype StateName<Definition> = Definition extends DeferredRenderState<\n  infer DeferredDefinition\n>\n  ? StateName<DeferredDefinition>\n  : Definition extends { state?: infer State extends string }\n    ? State\n    : 'default';\n\n/**\n * A spreadable state entry keyed by its literal state name. Spreading this into\n * `layout.render` is what creates compound members such as `Users.Loading`.\n */\nexport type RenderStateFragment<Definition, CallProps extends object = ResolveProps<StateCustomProps<Definition>>> = {\n  [State in StateName<NormalizeRenderStateDefinition<Definition>>]: Definition;\n} & {\n  readonly [definedRenderStateSymbol]: NormalizeRenderStateDefinition<Definition>;\n} & StateComposableHandle<CallProps>;\n\ntype StateCustomProps<Input> = NormalizeStateInput<Input> extends {\n  props?: { custom?: infer Props extends InPropsObject };\n} ? Props : {};\n\ntype StateIncludes<Input> = NormalizeStateInput<Input> extends {\n  props?: { include?: infer Includes };\n} ? Includes : {};\n\ntype NormalizeStateInput<Input> = Input extends DeferredRenderState<infer Definition>\n  ? Definition\n  : Input extends LazyRenderState<infer Definition> ? Definition : Input;\n\ntype StateLocalComposables<Input> = NormalizeStateInput<Input> extends {\n  composables?: (...args: any[]) => infer Components extends ComposableComponents;\n} ? Components : {};\n\n/**\n * A composables callback cannot infer its own return value into its arguments.\n * Preserve the declared call-site contract for props supplied by local presets,\n * even when their value types are not yet available in the callback context.\n */\ntype UnresolvedStateComponentProps<Props, Includes> = {\n  [Key in Exclude<keyof Includes, keyof Props> as Includes[Key] extends {\n    visibility: 'required'; passthrough: 'component';\n  } ? Key : never]: unknown;\n} & {\n  [Key in Exclude<keyof Includes, keyof Props> as Includes[Key] extends\n    | 'optional'\n    | { visibility: 'optional'; passthrough: 'component' }\n    ? Key : never]?: unknown;\n};\n\ntype StateComponentProps<Props extends InPropsObject, Includes> =\n  ResolvedIncludedComponentProps<Props,\n    Pick<Includes, Extract<keyof Includes, keyof Props>> extends infer Known extends IncludedProps<Props>\n      ? Known : {}\n  > & UnresolvedStateComponentProps<Props, Includes>;\n\n/** Call-site props of a referenced state; creation-time options stay bound. */\nexport type RenderStateCallProps<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  Input,\n> = ResolveProps<StateCustomProps<Input>> & StateComponentProps<\n  MergedLayoutInProps<Resources, Options, Composables & StateLocalComposables<Input>>,\n  StateIncludes<Input>\n>;\n\n/** Typed references to all the states declared in an inline render map. */\nexport type RenderStateReferences<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  States,\n> = {\n  readonly [State in keyof States & string]: StateComposable<\n    RenderStateCallProps<Resources, Options, Composables, States[State]>\n  >;\n};\n\ntype BoundRenderStateFragment<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  Definition,\n> = RenderStateFragment<Definition, RenderStateCallProps<\n  Resources, Options, Composables, Definition\n>>;\n\ntype DefinedRenderStateFromModule<Module> = Extract<\n  Module[keyof Module],\n  { readonly [definedRenderStateSymbol]: AnyRenderStateDefinition }\n>[typeof definedRenderStateSymbol];\n\n/** Wraps a state definition in the deferred marker when `Deferred` is `true`. */\ntype RenderStateEntry<Definition, Deferred extends boolean> = Deferred extends true\n  ? DeferredRenderState<NormalizeRenderStateDefinition<Definition>>\n  : Definition;\n\n/**\n * Overloads shared by `createRenderState` and `createRenderState.defer`. Each\n * accepts a full definition, a definition without `state`, or a render\n * callback; `Deferred` decides whether the returned entry is deferred.\n */\nexport interface RenderStateOverloads<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  SharedComposables extends ComposableComponents,\n  Deferred extends boolean,\n> {\n  <\n    const State extends RenderStateName,\n    const CustomProps extends InPropsObject = {},\n    const StateComposables extends ComposableComponents = {},\n    const IncludeProps extends IncludedProps<\n      MergedLayoutInProps<\n        Resources,\n        Options,\n        SharedComposables & StateComposables\n      >\n    > = {},\n  >(\n    definition: TypedRenderStateDefinition<\n      Resources,\n      Options,\n      State,\n      CustomProps,\n      SharedComposables,\n      StateComposables,\n      IncludeProps\n    >,\n  ): BoundRenderStateFragment<Resources, Options, SharedComposables,\n    RenderStateEntry<\n      TypedRenderStateDefinition<\n        Resources,\n        Options,\n        State,\n        CustomProps,\n        SharedComposables,\n        StateComposables,\n        IncludeProps\n      >,\n      Deferred\n    >\n  >;\n  <\n    const CustomProps extends InPropsObject = {},\n    const StateComposables extends ComposableComponents = {},\n    const IncludeProps extends IncludedProps<\n      MergedLayoutInProps<\n        Resources,\n        Options,\n        SharedComposables & StateComposables\n      >\n    > = {},\n  >(\n    definition: Omit<\n      TypedRenderStateDefinition<\n        Resources,\n        Options,\n        'default',\n        CustomProps,\n        SharedComposables,\n        StateComposables,\n        IncludeProps\n      >,\n      'state'\n    >,\n  ): BoundRenderStateFragment<Resources, Options, SharedComposables,\n    RenderStateEntry<\n      TypedRenderStateDefinition<\n        Resources,\n        Options,\n        'default',\n        CustomProps,\n        SharedComposables,\n        StateComposables,\n        IncludeProps\n      >,\n      Deferred\n    >\n  >;\n  (\n    render: TypedRenderStateCallback<Resources, Options, SharedComposables>,\n  ): BoundRenderStateFragment<Resources, Options, SharedComposables,\n    RenderStateEntry<\n      TypedRenderStateCallback<Resources, Options, SharedComposables>,\n      Deferred\n    >\n  >;\n}\n\n/**\n * Creates independently typed render-state fragments.\n *\n * - Calling it directly creates an eager state.\n * - `.defer(...)` schedules an inline definition through `React.lazy`, but\n *   does not create a separate JavaScript chunk.\n * - `.lazy(() => import(...))` imports a complete named state definition as a\n *   separate chunk.\n */\nexport interface CreateRenderState<\n  Resources extends ReadonlyArray<ResourceDefinition> = ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources> = {},\n  SharedComposables extends ComposableComponents = {},\n> extends RenderStateOverloads<Resources, Options, SharedComposables, false> {\n  defer: RenderStateOverloads<Resources, Options, SharedComposables, true>;\n  lazy<Module extends Record<string, unknown>>(\n    load: () => Promise<Module>,\n  ): LazyRenderState<DefinedRenderStateFromModule<Module>> & StateComposableHandle<\n    RenderStateCallProps<Resources, Options, SharedComposables, DefinedRenderStateFromModule<Module>>\n  >;\n}\n\nfunction normalizeDefinition(\n  input: AnyRenderStateDefinition | RenderStateCallback,\n): AnyRenderStateDefinition {\n  return typeof input === 'function'\n    ? { render: input, state: 'default' }\n    : input;\n}\n\nfunction toFragment<Definition extends AnyRenderStateDefinition>(\n  definition: Definition,\n) {\n  const fragment = {\n    [definition.state ?? 'default']: definition,\n  } as RenderStateFragment<Definition>;\n\n  Object.defineProperty(fragment, definedRenderStateSymbol, {\n    enumerable: false,\n    value: definition,\n  });\n\n  return withStateComposable(fragment, { input: definition, name: definition.state ?? 'default' });\n}\n\n/** Inputs used internally to bind resource and option types to a state builder. */\nexport type CreateRenderStateBuilderArguments<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  SharedComposables extends ComposableComponents = {},\n> = {\n  /** Shared composables whose components and preset props every state can use. */\n  composables?: LayoutComposablesDefinition<Resources, SharedComposables>;\n  /** Option props that individual states can expose through `props.include`. */\n  options: Options;\n  /** Resources used to constrain composable names and resource-specific props. */\n  resources: Resources;\n};\n\n/** The state factory produced for a particular resource and option definition. */\nexport type CreateRenderStateBuilderResult<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  SharedComposables extends ComposableComponents = {},\n> = CreateRenderState<Resources, Options, SharedComposables>;\n\n/**\n * Creates a state factory whose `props.include` keys are constrained by the\n * supplied resources and options.\n */\nexport function createRenderStateBuilder<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  SharedComposables extends ComposableComponents = {},\n>(\n  _arguments: CreateRenderStateBuilderArguments<\n    Resources,\n    Options,\n    SharedComposables\n  >,\n): CreateRenderStateBuilderResult<Resources, Options, SharedComposables> {\n  function createRenderState(\n    input: AnyRenderStateDefinition | RenderStateCallback,\n  ) {\n    return toFragment(normalizeDefinition(input));\n  }\n\n  createRenderState.defer = (\n    input: AnyRenderStateDefinition | RenderStateCallback,\n  ) => {\n    const definition = normalizeDefinition(input);\n\n    const deferred = { [deferredRenderStateSymbol]: definition };\n    return withStateComposable({ [definition.state ?? 'default']: deferred }, {\n      input: deferred, name: definition.state ?? 'default',\n    });\n  };\n  createRenderState.lazy = (\n    load: () => Promise<Record<string, unknown>>,\n  ) => {\n    const lazyState = { [lazyRenderStateSymbol]: load };\n    return withStateComposable(lazyState, { input: lazyState, name: 'lazy' });\n  };\n\n  return createRenderState as unknown as CreateRenderStateBuilderResult<\n    Resources,\n    Options,\n    SharedComposables\n  >;\n}\n\n/** Type guard for states created with `createRenderState.defer(...)`. */\nexport function isDeferredRenderState(\n  value: unknown,\n): value is DeferredRenderState<AnyRenderStateDefinition> {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    deferredRenderStateSymbol in value\n  );\n}\n\n/** Type guard for states created with `createRenderState.lazy(...)`. */\nexport function isLazyRenderState(\n  value: unknown,\n): value is LazyRenderState<AnyRenderStateDefinition> {\n  return (\n    typeof value === 'object' && value !== null && lazyRenderStateSymbol in value\n  );\n}\n\n/**\n * Selects the single state definition exported by a lazy module. Throws when\n * the module exports none or more than one, avoiding ambiguous selection.\n */\nexport function findDefinedRenderState(\n  module: Record<string, unknown>,\n): AnyRenderStateDefinition {\n  const definitions = Object.values(module).filter(\n    (value) =>\n      typeof value === 'object' && value !== null && definedRenderStateSymbol in value,\n  ) as Array<Record<typeof definedRenderStateSymbol, AnyRenderStateDefinition>>;\n\n  if (definitions.length !== 1) {\n    throw new Error(\n      `A lazy render-state module must export exactly one defined render state; received ${definitions.length}.`,\n    );\n  }\n\n  return definitions[0][definedRenderStateSymbol];\n}\n\n/** Identity helper that contextually types a reusable composables callback. */\nexport type DefineLayoutComposables<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = <const Composables extends ComposableComponents>(\n  definition: LayoutComposablesDefinition<Resources, Composables>,\n) => LayoutComposablesDefinition<Resources, Composables>;\n\n/** Public cross-file building blocks returned by a defined layout builder. */\nexport type CreateLayoutBuildingBlocks<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n> = {\n  composables: DefineLayoutComposables<Resources>;\n  createRenderState: CreateRenderState<Resources, Options>;\n};\n\n/** Resource and option bindings used to create layout building blocks. */\nexport type CreateLayoutBuildingBlocksArguments<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n> = CreateRenderStateBuilderArguments<Resources, Options>;\n\n/** Layout helpers produced for the supplied resource and option bindings. */\nexport type CreateLayoutBuildingBlocksResult<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n> = CreateLayoutBuildingBlocks<Resources, Options>;\n\n/**\n * Creates the reusable `composables` and `createRenderState` helpers without\n * introducing an identity wrapper around the layout object itself.\n */\nexport function createLayoutBuildingBlocks<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n>(\n  arguments_: CreateLayoutBuildingBlocksArguments<Resources, Options>,\n): CreateLayoutBuildingBlocksResult<Resources, Options> {\n  function composables<const Composables extends ComposableComponents>(\n    definition: LayoutComposablesDefinition<Resources, Composables>,\n  ): LayoutComposablesDefinition<Resources, Composables> {\n    return definition;\n  }\n\n  return {\n    composables,\n    createRenderState: createRenderStateBuilder(arguments_),\n  };\n}\n\n/** Preserves a bound resource tuple for consumers that need to re-export it. */\nexport type BoundResources<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = Resources;\n"],"mappings":";;;AAiBA,MAAa,4BAA2C,OACtD,qBACF;AACA,MAAa,wBAAuC,OAClD,iBACF;AACA,MAAa,2BAA0C,OAAO,IAC5D,uCACF;AACA,MAAa,uCAAsD,OAAO,IACxE,oDACF;AA0WA,SAAS,oBACP,OAC0B;CAC1B,OAAO,OAAO,UAAU,aACpB;EAAE,QAAQ;EAAO,OAAO;CAAU,IAClC;AACN;AAEA,SAAS,WACP,YACA;CACA,MAAM,WAAW,GACd,WAAW,SAAS,YAAY,WACnC;CAEA,OAAO,eAAe,UAAU,0BAA0B;EACxD,YAAY;EACZ,OAAO;CACT,CAAC;CAED,OAAOA,6CAAoB,UAAU;EAAE,OAAO;EAAY,MAAM,WAAW,SAAS;CAAU,CAAC;AACjG;;;;;AA2BA,SAAgB,yBAKd,YAKuE;CACvE,SAAS,kBACP,OACA;EACA,OAAO,WAAW,oBAAoB,KAAK,CAAC;CAC9C;CAEA,kBAAkB,SAChB,UACG;EACH,MAAM,aAAa,oBAAoB,KAAK;EAE5C,MAAM,WAAW,GAAG,4BAA4B,WAAW;EAC3D,OAAOA,6CAAoB,GAAG,WAAW,SAAS,YAAY,SAAS,GAAG;GACxE,OAAO;GAAU,MAAM,WAAW,SAAS;EAC7C,CAAC;CACH;CACA,kBAAkB,QAChB,SACG;EACH,MAAM,YAAY,GAAG,wBAAwB,KAAK;EAClD,OAAOA,6CAAoB,WAAW;GAAE,OAAO;GAAW,MAAM;EAAO,CAAC;CAC1E;CAEA,OAAO;AAKT;;AAGA,SAAgB,sBACd,OACwD;CACxD,OACE,OAAO,UAAU,YACjB,UAAU,QACV,6BAA6B;AAEjC;;AAGA,SAAgB,kBACd,OACoD;CACpD,OACE,OAAO,UAAU,YAAY,UAAU,QAAQ,yBAAyB;AAE5E;;;;;AAMA,SAAgB,uBACd,QAC0B;CAC1B,MAAM,cAAc,OAAO,OAAO,MAAM,EAAE,QACvC,UACC,OAAO,UAAU,YAAY,UAAU,QAAQ,4BAA4B,KAC/E;CAEA,IAAI,YAAY,WAAW,GACzB,MAAM,IAAI,MACR,qFAAqF,YAAY,OAAO,EAC1G;CAGF,OAAO,YAAY,GAAG;AACxB"}
+{"version":3,"file":"render-state.cjs","names":["withStateComposable","LayoutConfigurationError","createStateComposable","composablePresetMetaKey"],"sources":["../../src/create-config/render-state.ts"],"sourcesContent":["import type { MergeContract } from './define-layout';\nimport type { JSX } from 'react';\nimport { collectComposablePresetEntries, composablePresetMetaKey, type MergePresetProps, type ComposablePresetMeta } from '@jfdevelops/react-layout-composables';\nimport { LayoutConfigurationError } from '../errors';\nimport { createStateComposable, withStateComposable, type StateComposable, type StateComposableHandle } from './state-composable';\nimport type { ResolveProps } from '@jfdevelops/react-layout-validator';\nimport type {\n  ComposableComponents,\n  CreateLayoutComposable,\n} from '@jfdevelops/react-layout-composables';\nimport type { InPropsObject } from '../props';\nimport type {\n  IncludedProps,\n  InPropsDefinition,\n  LayoutRenderProps,\n  MergedLayoutInProps,\n  ResolvedIncludedComponentProps,\n  ResolvedIncludedProps,\n} from '../props';\nimport type { LayoutResourceKey, ResourceDefinition } from '../resource';\nimport type { LayoutRenderResourcesAccessor } from './define-layout';\n\nexport const deferredRenderStateSymbol: unique symbol = Symbol(\n  'deferredRenderState',\n) as never;\nexport const lazyRenderStateSymbol: unique symbol = Symbol(\n  'lazyRenderState',\n) as never;\nexport const definedRenderStateSymbol: unique symbol = Symbol.for(\n  '@jfdevelops/react-layout/render-state',\n) as never;\nexport const definedResourceLayoutComponentSymbol: unique symbol = Symbol.for(\n  '@jfdevelops/react-layout/resource-layout-component',\n) as never;\n\n/** Runtime-compatible render-state shape used when inspecting lazy modules. */\nexport type AnyRenderStateDefinition = {\n  composables?: (create: CreateLayoutComposable<any>, states: any) => ComposableComponents;\n  props?: {\n    include?: Record<string, unknown>;\n    custom?: InPropsObject;\n  };\n  render: (props: any, context: any) => JSX.Element;\n  state?: string;\n};\n\n/** An inline state whose first render is scheduled through `React.lazy`. */\nexport type DeferredRenderState<Definition extends AnyRenderStateDefinition> = {\n  readonly [deferredRenderStateSymbol]: Definition;\n};\n\n/** A state definition supplied by a separately imported module. */\nexport type LazyRenderState<Definition extends AnyRenderStateDefinition> = {\n  readonly [lazyRenderStateSymbol]: () => Promise<Record<string, unknown>>;\n  readonly definition?: Definition;\n};\n\n/**\n * State names accepted by `createRenderState`. Built-in states are suggested by\n * autocomplete while any other string still creates a custom compound state.\n */\nexport type RenderStateName =\n  | 'default'\n  | 'Loading'\n  | 'Error'\n  | 'NotFound'\n  | (string & {});\n\n/** Callback shorthand for a render state with no local configuration. */\nexport type RenderStateCallback = (props: any, context: any) => JSX.Element;\n\n/**\n * Defines state-local composable components with a `create` helper narrowed to\n * the resources bound to the surrounding builder.\n */\nexport type RenderStateComposablesDefinition<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Composables extends ComposableComponents,\n  States = {},\n> = (\n  create: CreateLayoutComposable<LayoutResourceKey<Resources>>,\n  states: States,\n) => Composables;\n\n/**\n * Defines reusable layout-level composables while preserving their inferred\n * names, props, and bound resource union.\n */\nexport type LayoutComposablesDefinition<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Composables extends ComposableComponents,\n> = RenderStateComposablesDefinition<Resources, Composables>;\n\ntype BuilderRenderComposables<Composables extends ComposableComponents> = [\n  keyof Composables,\n] extends [never]\n  ? undefined\n  : Composables;\n\n/** Values available as the second argument of a created state's `render`. */\nexport type RenderStateContext<\n  Composables extends ComposableComponents,\n  Resources extends ReadonlyArray<ResourceDefinition> = ReadonlyArray<ResourceDefinition>,\n> = {\n  resources: LayoutRenderResourcesAccessor<Resources>;\n  composables: BuilderRenderComposables<Composables>;\n  retry?: () => void;\n};\n\n/**\n * Resolves one state's custom props and explicitly included option/composable\n * props to the values received by its render callback.\n */\nexport type RenderStateProps<\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 InPropsObject,\n> = LayoutRenderProps<\n  Resources,\n  Options,\n  Composables,\n  IncludeProps,\n  CustomProps\n>;\n\ntype TypedRenderStateDefinition<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  State extends string,\n  CustomProps extends InPropsObject,\n  SharedComposables extends ComposableComponents,\n  StateComposables extends ComposableComponents,\n  IncludeProps extends IncludedProps<\n    MergedLayoutInProps<\n      Resources,\n      Options,\n      SharedComposables & StateComposables\n    >\n  >,\n  SharedInclude extends IncludedProps<MergedLayoutInProps<Resources, Options, SharedComposables>> = {},\n  SharedCustom extends InPropsObject = {},\n> = {\n  composables?: RenderStateComposablesDefinition<Resources, StateComposables>;\n  props?: {\n    include?: IncludeProps;\n    custom?: CustomProps;\n  };\n  render: (\n    props: RenderStateProps<\n      Resources,\n      Options,\n      SharedComposables & StateComposables,\n      MergeContract<SharedInclude, IncludeProps>,\n      MergeContract<SharedCustom, CustomProps>\n    >,\n    context: RenderStateContext<SharedComposables & StateComposables, Resources>,\n  ) => JSX.Element;\n  state: State;\n};\n\n/**\n * Callback shorthand for a created state, typed with the bound resources,\n * options, and shared composables.\n */\nexport type TypedRenderStateCallback<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  SharedComposables extends ComposableComponents,\n  SharedInclude extends IncludedProps<MergedLayoutInProps<Resources, Options, SharedComposables>> = {},\n  SharedCustom extends InPropsObject = {},\n> = (\n  props: RenderStateProps<Resources, Options, SharedComposables, SharedInclude, SharedCustom>,\n  context: RenderStateContext<SharedComposables, Resources>,\n) => JSX.Element;\n\ntype NormalizeRenderStateDefinition<Input> =\n  Input extends LazyRenderState<infer Definition>\n    ? Definition\n    : Input extends DeferredRenderState<infer Definition>\n    ? Definition\n    : Input extends RenderStateCallback\n      ? { render: Input; state: 'default' }\n      : Input extends AnyRenderStateDefinition\n        ? Input\n        : never;\n\ntype StateName<Definition> = Definition extends DeferredRenderState<\n  infer DeferredDefinition\n>\n  ? StateName<DeferredDefinition>\n  : Definition extends { state?: infer State extends string }\n    ? State\n    : 'default';\n\n/**\n * A spreadable state entry keyed by its literal state name. Spreading this into\n * `layout.render` is what creates compound members such as `Users.Loading`.\n */\nexport type RenderStateFragment<Definition, CallProps extends object = ResolveProps<StateCustomProps<Definition>>> = {\n  [State in StateName<NormalizeRenderStateDefinition<Definition>>]: Definition;\n} & {\n  readonly [definedRenderStateSymbol]: NormalizeRenderStateDefinition<Definition>;\n} & StateComposableHandle<CallProps>;\n\ntype StateCustomProps<Input> = NormalizeStateInput<Input> extends {\n  props?: { custom?: infer Props extends InPropsObject };\n} ? Props : {};\n\ntype StateIncludes<Input> = NormalizeStateInput<Input> extends {\n  props?: { include?: infer Includes };\n} ? Includes : {};\n\ntype NormalizeStateInput<Input> = Input extends DeferredRenderState<infer Definition>\n  ? Definition\n  : Input extends LazyRenderState<infer Definition> ? Definition : Input;\n\ntype StateLocalComposables<Input> = NormalizeStateInput<Input> extends {\n  composables?: (...args: any[]) => infer Components extends ComposableComponents;\n} ? Components : {};\n\n/**\n * A composables callback cannot infer its own return value into its arguments.\n * Preserve the declared call-site contract for props supplied by local presets,\n * even when their value types are not yet available in the callback context.\n */\ntype UnresolvedStateComponentProps<Props, Includes> = {\n  [Key in Exclude<keyof Includes, keyof Props> as Includes[Key] extends {\n    visibility: 'required'; passthrough: 'component';\n  } ? Key : never]: unknown;\n} & {\n  [Key in Exclude<keyof Includes, keyof Props> as Includes[Key] extends\n    | 'optional'\n    | { visibility: 'optional'; passthrough: 'component' }\n    ? Key : never]?: unknown;\n};\n\ntype StateComponentProps<Props extends InPropsObject, Includes> =\n  ResolvedIncludedComponentProps<Props,\n    Pick<Includes, Extract<keyof Includes, keyof Props>> extends infer Known extends IncludedProps<Props>\n      ? Known : {}\n  > & UnresolvedStateComponentProps<Props, Includes>;\n\n/** Call-site props of a referenced state; creation-time options stay bound. */\nexport type RenderStateCallProps<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  Input,\n> = ResolveProps<StateCustomProps<Input>> & StateComponentProps<\n  MergedLayoutInProps<Resources, Options, Composables & StateLocalComposables<Input>>,\n  StateIncludes<Input>\n>;\n\n/** Typed references to all the states declared in an inline render map. */\nexport type RenderStateReferences<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  States,\n> = {\n  readonly [State in keyof States & string]: StateComposable<\n    RenderStateCallProps<Resources, Options, Composables, States[State]>\n  >;\n};\n\ntype BoundRenderStateFragment<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  Definition,\n> = RenderStateFragment<Definition, RenderStateCallProps<\n  Resources, Options, Composables, Definition\n>>;\n\ntype DefinedRenderStateFromModule<Module> = Extract<\n  Module[keyof Module],\n  { readonly [definedRenderStateSymbol]: AnyRenderStateDefinition }\n>[typeof definedRenderStateSymbol];\n\n/** Wraps a state definition in the deferred marker when `Deferred` is `true`. */\ntype RenderStateEntry<Definition, Deferred extends boolean> = Deferred extends true\n  ? DeferredRenderState<NormalizeRenderStateDefinition<Definition>>\n  : Definition;\n\n/**\n * Overloads shared by `createRenderState` and `createRenderState.defer`. Each\n * accepts a full definition, a definition without `state`, or a render\n * callback; `Deferred` decides whether the returned entry is deferred.\n */\nexport interface RenderStateOverloads<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  SharedComposables extends ComposableComponents,\n  Deferred extends boolean,\n  SharedInclude extends IncludedProps<MergedLayoutInProps<Resources, Options, SharedComposables>> = {},\n  SharedCustom extends InPropsObject = {},\n> {\n  <\n    const State extends RenderStateName,\n    const CustomProps extends InPropsObject = {},\n    const StateComposables extends ComposableComponents = {},\n    const IncludeProps extends IncludedProps<\n      MergedLayoutInProps<\n        Resources,\n        Options,\n        SharedComposables & StateComposables\n      >\n    > = {},\n  >(\n    definition: TypedRenderStateDefinition<\n      Resources,\n      Options,\n      State,\n      CustomProps,\n      SharedComposables,\n      StateComposables,\n      IncludeProps,\n      SharedInclude,\n      SharedCustom\n    >,\n  ): BoundRenderStateFragment<Resources, Options, SharedComposables,\n    RenderStateEntry<\n      TypedRenderStateDefinition<\n        Resources,\n        Options,\n        State,\n        CustomProps,\n        SharedComposables,\n        StateComposables,\n        IncludeProps,\n      SharedInclude,\n      SharedCustom\n      >,\n      Deferred\n    >\n  >;\n  <\n    const CustomProps extends InPropsObject = {},\n    const StateComposables extends ComposableComponents = {},\n    const IncludeProps extends IncludedProps<\n      MergedLayoutInProps<\n        Resources,\n        Options,\n        SharedComposables & StateComposables\n      >\n    > = {},\n  >(\n    definition: Omit<\n      TypedRenderStateDefinition<\n        Resources,\n        Options,\n        'default',\n        CustomProps,\n        SharedComposables,\n        StateComposables,\n        IncludeProps,\n      SharedInclude,\n      SharedCustom\n      >,\n      'state'\n    >,\n  ): BoundRenderStateFragment<Resources, Options, SharedComposables,\n    RenderStateEntry<\n      TypedRenderStateDefinition<\n        Resources,\n        Options,\n        'default',\n        CustomProps,\n        SharedComposables,\n        StateComposables,\n        IncludeProps,\n      SharedInclude,\n      SharedCustom\n      >,\n      Deferred\n    >\n  >;\n  (\n    render: TypedRenderStateCallback<Resources, Options, SharedComposables, SharedInclude, SharedCustom>,\n  ): BoundRenderStateFragment<Resources, Options, SharedComposables,\n    RenderStateEntry<\n      TypedRenderStateCallback<Resources, Options, SharedComposables, SharedInclude, SharedCustom>,\n      Deferred\n    >\n  >;\n}\n\ntype RenderStateReference = (\n  | { readonly [definedRenderStateSymbol]: AnyRenderStateDefinition }\n  | LazyRenderState<AnyRenderStateDefinition>\n) & StateComposableHandle<any>;\n\ntype ReferenceDefinition<Ref extends RenderStateReference> =\n  Ref extends LazyRenderState<infer Definition> ? Definition\n    : Ref extends { readonly [definedRenderStateSymbol]: infer Definition extends AnyRenderStateDefinition }\n      ? Definition : never;\n\ntype FromStateEntry<Ref extends RenderStateReference, Definition extends AnyRenderStateDefinition> =\n  Ref extends LazyRenderState<AnyRenderStateDefinition> ? LazyRenderState<Definition>\n    : Extract<Ref[Exclude<keyof Ref, 'asComposable' | typeof definedRenderStateSymbol>], LazyRenderState<AnyRenderStateDefinition>> extends never\n      ? Definition : LazyRenderState<Definition>;\ntype ReferenceSchemas<Ref extends RenderStateReference> =\n  StateCustomProps<ReferenceDefinition<Ref>> & MergePresetProps<StateLocalComposables<ReferenceDefinition<Ref>>>;\n\ntype DefaultReferenceIncludes<Ref extends RenderStateReference, CustomProps> =\n  Omit<StateIncludes<ReferenceDefinition<Ref>>, keyof CustomProps | keyof StateCustomProps<ReferenceDefinition<Ref>>> & {\n    [Key in Exclude<keyof StateCustomProps<ReferenceDefinition<Ref>>, keyof CustomProps>]: {\n      visibility: StateCustomProps<ReferenceDefinition<Ref>>[Key] extends { visibility: infer Visibility }\n        ? Visibility : 'required';\n      passthrough: 'component';\n    };\n  };\n\ntype ReferenceIncludes<Ref extends RenderStateReference, CustomProps, Include> =\n  Include extends object ? Include : DefaultReferenceIncludes<Ref, CustomProps>;\n\ntype FromStateInProps<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Shared extends ComposableComponents,\n  Ref extends RenderStateReference,\n  Local extends ComposableComponents,\n> = (MergedLayoutInProps<Resources, Options, Shared & StateLocalComposables<ReferenceDefinition<Ref>> & Local> &\n  StateCustomProps<ReferenceDefinition<Ref>>) extends infer Props extends InPropsObject ? Props : {};\n\ntype SelectedReferenceSchemas<Ref extends RenderStateReference, Include> =\n  Pick<ReferenceSchemas<Ref>, Extract<keyof Include, keyof ReferenceSchemas<Ref>>> extends infer Selected extends InPropsObject\n    ? Selected : {};\n\ntype ReferenceCarriedProps<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Shared extends ComposableComponents,\n  Ref extends RenderStateReference,\n  Include,\n> = Pick<FromStateInProps<Resources, Options, Shared, Ref, {}>,\n  Extract<keyof Include, keyof FromStateInProps<Resources, Options, Shared, Ref, {}>>\n> extends infer Selected extends InPropsObject ? ResolveProps<Selected> : {};\n\ntype ReferenceRenderProps<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Shared extends ComposableComponents,\n  Ref extends RenderStateReference,\n> = RenderStateProps<Resources, Options, Shared & StateLocalComposables<ReferenceDefinition<Ref>>,\n  StateIncludes<ReferenceDefinition<Ref>> extends infer Include extends IncludedProps<MergedLayoutInProps<Resources, Options, Shared & StateLocalComposables<ReferenceDefinition<Ref>>>> ? Include : {},\n  StateCustomProps<ReferenceDefinition<Ref>>>;\n\ntype FromStateComposables<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Shared extends ComposableComponents,\n  Ref extends RenderStateReference,\n  Local extends ComposableComponents,\n  Include,\n> = Local & {\n  Ref: StateComposable<\n    ReferenceRenderProps<Resources, Options, Shared, Ref>,\n    Extract<keyof ReferenceCarriedProps<Resources, Options, Shared, Ref, Include>, keyof ReferenceRenderProps<Resources, Options, Shared, Ref>>\n  > & { [composablePresetMetaKey]: ComposablePresetMeta<SelectedReferenceSchemas<Ref, Include>> };\n};\n\ntype FromStateDefinition<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Shared extends ComposableComponents,\n  Ref extends RenderStateReference,\n  State extends string,\n  CustomProps extends InPropsObject,\n  Local extends ComposableComponents,\n  Include,\n> = {\n  state: State;\n  props?: { custom?: CustomProps; include?: ReferenceIncludes<Ref, CustomProps, Include> };\n  composables: RenderStateComposablesDefinition<Resources,\n    FromStateComposables<Resources, Options, Shared, Ref, Local, ReferenceIncludes<Ref, CustomProps, Include>>>;\n  render: (\n    props: ResolveProps<CustomProps> & ResolvedIncludedProps<FromStateInProps<Resources, Options, Shared, Ref, Local>,\n      ReferenceIncludes<Ref, CustomProps, Include> extends infer Selected extends IncludedProps<FromStateInProps<Resources, Options, Shared, Ref, Local>> ? Selected : {}>,\n    context: RenderStateContext<Shared & FromStateComposables<Resources, Options, Shared, Ref, Local, ReferenceIncludes<Ref, CustomProps, Include>>, Resources>,\n  ) => JSX.Element;\n};\n\n/** Creates a state with inherited props and a composable reference to its source. */\nexport type CreateRenderStateFromState<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Shared extends ComposableComponents,\n> = <\n  const Ref extends RenderStateReference,\n  const State extends RenderStateName = 'default',\n  const CustomProps extends InPropsObject = {},\n  const Local extends ComposableComponents = {},\n  const Include extends IncludedProps<FromStateInProps<Resources, Options, Shared, Ref, Local>> | undefined = undefined,\n>(definition: {\n  ref: Ref;\n  /** Defer Ref rendering through React.lazy. Defaults to false. */\n  lazy?: boolean;\n  state?: State;\n  props?: {\n    custom?: CustomProps;\n    include?: Include & Record<Exclude<keyof Include, keyof FromStateInProps<Resources, Options, Shared, Ref, Local>>, never>;\n  };\n  composables?: (create: CreateLayoutComposable<LayoutResourceKey<Resources>>, states: {}) => Local & { Ref?: never };\n  render: FromStateDefinition<Resources, Options, Shared, Ref, State, CustomProps, Local, Include>['render'];\n}) => BoundRenderStateFragment<Resources, Options, Shared,\n  FromStateEntry<Ref, FromStateDefinition<Resources, Options, Shared, Ref, State, CustomProps, Local, Include>>>;\n\n/**\n * Creates independently typed render-state fragments.\n *\n * - Calling it directly creates an eager state.\n * - `.defer(...)` schedules an inline definition through `React.lazy`, but\n *   does not create a separate JavaScript chunk.\n * - `.lazy(() => import(...))` imports a complete named state definition as a\n *   separate chunk.\n * - `.fromState({ ref, ... })` inherits a state's props and exposes it as `Ref`.\n */\nexport interface CreateRenderState<\n  Resources extends ReadonlyArray<ResourceDefinition> = ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources> = {},\n  SharedComposables extends ComposableComponents = {},\n  SharedInclude extends IncludedProps<MergedLayoutInProps<Resources, Options, SharedComposables>> = {},\n  SharedCustom extends InPropsObject = {},\n> extends RenderStateOverloads<Resources, Options, SharedComposables, false, SharedInclude, SharedCustom> {\n  fromState: CreateRenderStateFromState<Resources, Options, SharedComposables>;\n  defer: RenderStateOverloads<Resources, Options, SharedComposables, true, SharedInclude, SharedCustom>;\n  lazy<Module extends Record<string, unknown>>(\n    load: () => Promise<Module>,\n  ): LazyRenderState<DefinedRenderStateFromModule<Module>> & StateComposableHandle<\n    RenderStateCallProps<Resources, Options, SharedComposables, DefinedRenderStateFromModule<Module>>\n  >;\n}\n\nfunction normalizeDefinition(\n  input: AnyRenderStateDefinition | RenderStateCallback,\n): AnyRenderStateDefinition {\n  return typeof input === 'function'\n    ? { render: input, state: 'default' }\n    : input;\n}\n\nfunction toFragment<Definition extends AnyRenderStateDefinition>(\n  definition: Definition,\n) {\n  const fragment = {\n    [definition.state ?? 'default']: definition,\n  } as RenderStateFragment<Definition>;\n\n  Object.defineProperty(fragment, definedRenderStateSymbol, {\n    enumerable: false,\n    value: definition,\n  });\n\n  return withStateComposable(fragment, { input: definition, name: definition.state ?? 'default' });\n}\n\n/** Inputs used internally to bind resource and option types to a state builder. */\nexport type CreateRenderStateBuilderArguments<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  SharedComposables extends ComposableComponents = {},\n  SharedInclude extends IncludedProps<MergedLayoutInProps<Resources, Options, SharedComposables>> = {},\n  SharedCustom extends InPropsObject = {},\n> = {\n  props?: { include?: SharedInclude; custom?: SharedCustom };\n  /** Shared composables whose components and preset props every state can use. */\n  composables?: LayoutComposablesDefinition<Resources, SharedComposables>;\n  /** Option props that individual states can expose through `props.include`. */\n  options: Options;\n  /** Resources used to constrain composable names and resource-specific props. */\n  resources: Resources;\n};\n\n/** The state factory produced for a particular resource and option definition. */\nexport type CreateRenderStateBuilderResult<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  SharedComposables extends ComposableComponents = {},\n  SharedInclude extends IncludedProps<MergedLayoutInProps<Resources, Options, SharedComposables>> = {},\n  SharedCustom extends InPropsObject = {},\n> = CreateRenderState<Resources, Options, SharedComposables, SharedInclude, SharedCustom>;\n\n/**\n * Creates a state factory whose `props.include` keys are constrained by the\n * supplied resources and options.\n */\nexport function createRenderStateBuilder<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  SharedComposables extends ComposableComponents = {},\n  SharedInclude extends IncludedProps<MergedLayoutInProps<Resources, Options, SharedComposables>> = {},\n  SharedCustom extends InPropsObject = {},\n>(\n  _arguments: CreateRenderStateBuilderArguments<\n    Resources,\n    Options,\n    SharedComposables,\n    SharedInclude,\n    SharedCustom\n  >,\n): CreateRenderStateBuilderResult<Resources, Options, SharedComposables, SharedInclude, SharedCustom> {\n  function createRenderState(\n    input: AnyRenderStateDefinition | RenderStateCallback,\n  ) {\n    return toFragment(normalizeDefinition(input));\n  }\n\n  createRenderState.fromState = (input: {\n    ref: RenderStateReference;\n    lazy?: boolean;\n    state?: string;\n    props?: AnyRenderStateDefinition['props'];\n    composables?: AnyRenderStateDefinition['composables'];\n    render: AnyRenderStateDefinition['render'];\n  }): object => {\n    const entry = isLazyRenderState(input.ref) ? input.ref : Object.values(input.ref)[0];\n    if (isLazyRenderState(entry)) {\n      const lazyState = {\n        [lazyRenderStateSymbol]: async () => {\n          const source = await findDefinedRenderState(await entry[lazyRenderStateSymbol]());\n          return { Derived: createRenderState.fromState({ ...input, ref: toFragment(source) }) };\n        },\n      };\n      const name = input.state ?? 'default';\n      const fragment = { [name]: lazyState };\n      Object.defineProperty(fragment, definedRenderStateSymbol, { value: lazyState });\n      return withStateComposable(fragment, { input: lazyState, name });\n    }\n    const source = isDeferredRenderState(entry)\n      ? entry[deferredRenderStateSymbol]\n      : definedRenderStateSymbol in input.ref ? input.ref[definedRenderStateSymbol] : undefined;\n    if (!source || typeof source.render !== 'function') {\n      throw new LayoutConfigurationError('fromState requires a created render state');\n    }\n    const custom = input.props?.custom ?? {};\n    const includes = input.props?.include ?? Object.fromEntries(\n      Object.entries({\n        ...source.props?.include,\n        ...Object.fromEntries(Object.entries(source.props?.custom ?? {}).map(([key, prop]) => [\n          key, { visibility: prop.visibility, passthrough: 'component' },\n        ])),\n      }).filter(([key]) => !(key in custom)),\n    );\n    return toFragment({\n      state: input.state ?? 'default',\n      props: { custom, include: includes },\n      composables: (create, states) => {\n        const inherited = source.composables?.(create, states) ?? {};\n        const local = input.composables?.(create, states) ?? {};\n        if (Object.prototype.hasOwnProperty.call(local, 'Ref')) {\n          throw new LayoutConfigurationError('Composable name \"Ref\" is reserved by fromState');\n        }\n        const schemas = Object.assign({},\n          ...collectComposablePresetEntries(inherited).map(({ props }) => props),\n          source.props?.custom,\n        ) as InPropsObject;\n        const selected = Object.fromEntries(Object.entries(schemas).filter(([key]) => key in includes));\n        const referenceSource = {\n          ...source,\n          props: {\n            ...source.props,\n            include: Object.fromEntries(Object.entries(source.props?.include ?? {}).map(([key, behavior]) => [\n              key, {\n                visibility: behavior === 'optional' || (typeof behavior === 'object' && behavior !== null && 'visibility' in behavior && behavior.visibility === 'optional')\n                  ? 'optional' : 'required',\n                passthrough: 'component',\n              },\n            ])),\n          },\n        };\n        const Ref = createStateComposable({\n          input: input.lazy || isDeferredRenderState(entry) ? { [deferredRenderStateSymbol]: referenceSource } : referenceSource,\n          name: source.state ?? 'default',\n          fallbackStateName: input.state,\n        }, {\n          props: { include: Object.fromEntries(Object.keys(includes).map((key) => [key, true as const])) },\n          normalizeIncludedKeys: true,\n        });\n        Object.defineProperty(Ref, composablePresetMetaKey, {\n          value: { key: 'Ref', props: selected },\n        });\n        return { ...local, Ref };\n      },\n      render: input.render,\n    });\n  };\n\n  createRenderState.defer = (\n    input: AnyRenderStateDefinition | RenderStateCallback,\n  ) => {\n    const definition = normalizeDefinition(input);\n\n    const deferred = { [deferredRenderStateSymbol]: definition };\n    const fragment = { [definition.state ?? 'default']: deferred };\n    Object.defineProperty(fragment, definedRenderStateSymbol, { value: definition });\n    return withStateComposable(fragment, {\n      input: deferred, name: definition.state ?? 'default',\n    });\n  };\n  createRenderState.lazy = (\n    load: () => Promise<Record<string, unknown>>,\n  ) => {\n    const lazyState = { [lazyRenderStateSymbol]: load };\n    return withStateComposable(lazyState, { input: lazyState, name: 'lazy' });\n  };\n\n  return createRenderState as unknown as CreateRenderStateBuilderResult<\n    Resources,\n    Options,\n    SharedComposables,\n    SharedInclude,\n    SharedCustom\n  >;\n}\n\n/** Type guard for states created with `createRenderState.defer(...)`. */\nexport function isDeferredRenderState(\n  value: unknown,\n): value is DeferredRenderState<AnyRenderStateDefinition> {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    deferredRenderStateSymbol in value\n  );\n}\n\n/** Type guard for states created with `createRenderState.lazy(...)`. */\nexport function isLazyRenderState(\n  value: unknown,\n): value is LazyRenderState<AnyRenderStateDefinition> {\n  return (\n    typeof value === 'object' && value !== null && lazyRenderStateSymbol in value\n  );\n}\n\n/**\n * Resolves the single state exported by a lazy module, including derived lazy\n * states. Throws when a module exports none or more than one.\n */\nexport async function findDefinedRenderState(\n  module: Record<string, unknown>,\n): Promise<AnyRenderStateDefinition> {\n  const definitions = Object.values(module).filter(\n    (value) =>\n      typeof value === 'object' && value !== null && definedRenderStateSymbol in value,\n  ) as Array<Record<typeof definedRenderStateSymbol, AnyRenderStateDefinition>>;\n\n  if (definitions.length !== 1) {\n    throw new Error(\n      `A lazy render-state module must export exactly one defined render state; received ${definitions.length}.`,\n    );\n  }\n\n  const definition = definitions[0][definedRenderStateSymbol];\n  return isLazyRenderState(definition)\n    ? findDefinedRenderState(await definition[lazyRenderStateSymbol]())\n    : definition;\n}\n\n/** Identity helper that contextually types a reusable composables callback. */\nexport type DefineLayoutComposables<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = <const Composables extends ComposableComponents>(\n  definition: LayoutComposablesDefinition<Resources, Composables>,\n) => LayoutComposablesDefinition<Resources, Composables>;\n\n/** Public cross-file building blocks returned by a defined layout builder. */\nexport type CreateLayoutBuildingBlocks<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n> = {\n  composables: DefineLayoutComposables<Resources>;\n  createRenderState: CreateRenderState<Resources, Options>;\n};\n\n/** Resource and option bindings used to create layout building blocks. */\nexport type CreateLayoutBuildingBlocksArguments<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n> = CreateRenderStateBuilderArguments<Resources, Options>;\n\n/** Layout helpers produced for the supplied resource and option bindings. */\nexport type CreateLayoutBuildingBlocksResult<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n> = CreateLayoutBuildingBlocks<Resources, Options>;\n\n/**\n * Creates the reusable `composables` and `createRenderState` helpers without\n * introducing an identity wrapper around the layout object itself.\n */\nexport function createLayoutBuildingBlocks<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n>(\n  arguments_: CreateLayoutBuildingBlocksArguments<Resources, Options>,\n): CreateLayoutBuildingBlocksResult<Resources, Options> {\n  function composables<const Composables extends ComposableComponents>(\n    definition: LayoutComposablesDefinition<Resources, Composables>,\n  ): LayoutComposablesDefinition<Resources, Composables> {\n    return definition;\n  }\n\n  return {\n    composables,\n    createRenderState: createRenderStateBuilder(arguments_),\n  };\n}\n\n/** Preserves a bound resource tuple for consumers that need to re-export it. */\nexport type BoundResources<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = Resources;\n"],"mappings":"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"}

package/dist/create-config/render-state.d.cts

@@ -1,7 +1,8 @@
 import { LayoutResourceKey, ResourceDefinition } from "../resource.cjs";
-import { InPropsDefinition, InPropsObject, IncludedProps, LayoutRenderProps, MergedLayoutInProps, ResolvedIncludedComponentProps } from "../props.cjs";
+import { InPropsDefinition, InPropsObject, IncludedProps, LayoutRenderProps, MergedLayoutInProps, ResolvedIncludedComponentProps, ResolvedIncludedProps } from "../props.cjs";
 import { StateComposable, StateComposableHandle } from "./state-composable.cjs";
-import { ComposableComponents, CreateLayoutComposable } from "@jfdevelops/react-layout-composables";
+import { LayoutRenderResourcesAccessor, MergeContract } from "./define-layout.cjs";
+import { ComposableComponents, ComposablePresetMeta, CreateLayoutComposable, MergePresetProps, composablePresetMetaKey } from "@jfdevelops/react-layout-composables";
 import { JSX } from "react";
 import { ResolveProps } from "@jfdevelops/react-layout-validator";
 
@@ -48,7 +49,8 @@ type RenderStateComposablesDefinition<Resources extends ReadonlyArray<ResourceDe
 type LayoutComposablesDefinition<Resources extends ReadonlyArray<ResourceDefinition>, Composables extends ComposableComponents> = RenderStateComposablesDefinition<Resources, Composables>;
 type BuilderRenderComposables<Composables extends ComposableComponents> = [keyof Composables] extends [never] ? undefined : Composables;
 /** Values available as the second argument of a created state's `render`. */
-type RenderStateContext<Composables extends ComposableComponents> = {
+type RenderStateContext<Composables extends ComposableComponents, Resources extends ReadonlyArray<ResourceDefinition> = ReadonlyArray<ResourceDefinition>> = {
+  resources: LayoutRenderResourcesAccessor<Resources>;
   composables: BuilderRenderComposables<Composables>;
   retry?: () => void;
 };
@@ -57,21 +59,21 @@ type RenderStateContext<Composables extends ComposableComponents> = {
  * props to the values received by its render callback.
  */
 type RenderStateProps<Resources extends ReadonlyArray<ResourceDefinition>, Options extends InPropsDefinition<Resources>, Composables extends ComposableComponents, IncludeProps extends IncludedProps<MergedLayoutInProps<Resources, Options, Composables>>, CustomProps extends InPropsObject> = LayoutRenderProps<Resources, Options, Composables, IncludeProps, CustomProps>;
-type TypedRenderStateDefinition<Resources extends ReadonlyArray<ResourceDefinition>, Options extends InPropsDefinition<Resources>, State extends string, CustomProps extends InPropsObject, SharedComposables extends ComposableComponents, StateComposables extends ComposableComponents, IncludeProps extends IncludedProps<MergedLayoutInProps<Resources, Options, SharedComposables & StateComposables>>> = {
+type TypedRenderStateDefinition<Resources extends ReadonlyArray<ResourceDefinition>, Options extends InPropsDefinition<Resources>, State extends string, CustomProps extends InPropsObject, SharedComposables extends ComposableComponents, StateComposables extends ComposableComponents, IncludeProps extends IncludedProps<MergedLayoutInProps<Resources, Options, SharedComposables & StateComposables>>, SharedInclude extends IncludedProps<MergedLayoutInProps<Resources, Options, SharedComposables>> = {}, SharedCustom extends InPropsObject = {}> = {
   composables?: RenderStateComposablesDefinition<Resources, StateComposables>;
   props?: {
     include?: IncludeProps;
     custom?: CustomProps;
   };
-  render: (props: RenderStateProps<Resources, Options, SharedComposables & StateComposables, IncludeProps, CustomProps>, context: RenderStateContext<SharedComposables & StateComposables>) => JSX.Element;
+  render: (props: RenderStateProps<Resources, Options, SharedComposables & StateComposables, MergeContract<SharedInclude, IncludeProps>, MergeContract<SharedCustom, CustomProps>>, context: RenderStateContext<SharedComposables & StateComposables, Resources>) => JSX.Element;
   state: State;
 };
 /**
  * Callback shorthand for a created state, typed with the bound resources,
  * options, and shared composables.
  */
-type TypedRenderStateCallback<Resources extends ReadonlyArray<ResourceDefinition>, Options extends InPropsDefinition<Resources>, SharedComposables extends ComposableComponents> = (props: RenderStateProps<Resources, Options, SharedComposables, {}, {}>, context: RenderStateContext<SharedComposables>) => JSX.Element;
-type NormalizeRenderStateDefinition<Input> = Input extends DeferredRenderState<infer Definition> ? Definition : Input extends RenderStateCallback ? {
+type TypedRenderStateCallback<Resources extends ReadonlyArray<ResourceDefinition>, Options extends InPropsDefinition<Resources>, SharedComposables extends ComposableComponents, SharedInclude extends IncludedProps<MergedLayoutInProps<Resources, Options, SharedComposables>> = {}, SharedCustom extends InPropsObject = {}> = (props: RenderStateProps<Resources, Options, SharedComposables, SharedInclude, SharedCustom>, context: RenderStateContext<SharedComposables, Resources>) => JSX.Element;
+type NormalizeRenderStateDefinition<Input> = Input extends LazyRenderState<infer Definition> ? Definition : Input extends DeferredRenderState<infer Definition> ? Definition : Input extends RenderStateCallback ? {
   render: Input;
   state: 'default';
 } : Input extends AnyRenderStateDefinition ? Input : never;
@@ -127,11 +129,58 @@ type RenderStateEntry<Definition, Deferred extends boolean> = Deferred extends t
  * accepts a full definition, a definition without `state`, or a render
  * callback; `Deferred` decides whether the returned entry is deferred.
  */
-interface RenderStateOverloads<Resources extends ReadonlyArray<ResourceDefinition>, Options extends InPropsDefinition<Resources>, SharedComposables extends ComposableComponents, Deferred extends boolean> {
-  <const State extends RenderStateName, const CustomProps extends InPropsObject = {}, const StateComposables extends ComposableComponents = {}, const IncludeProps extends IncludedProps<MergedLayoutInProps<Resources, Options, SharedComposables & StateComposables>> = {}>(definition: TypedRenderStateDefinition<Resources, Options, State, CustomProps, SharedComposables, StateComposables, IncludeProps>): BoundRenderStateFragment<Resources, Options, SharedComposables, RenderStateEntry<TypedRenderStateDefinition<Resources, Options, State, CustomProps, SharedComposables, StateComposables, IncludeProps>, Deferred>>;
-  <const CustomProps extends InPropsObject = {}, const StateComposables extends ComposableComponents = {}, const IncludeProps extends IncludedProps<MergedLayoutInProps<Resources, Options, SharedComposables & StateComposables>> = {}>(definition: Omit<TypedRenderStateDefinition<Resources, Options, 'default', CustomProps, SharedComposables, StateComposables, IncludeProps>, 'state'>): BoundRenderStateFragment<Resources, Options, SharedComposables, RenderStateEntry<TypedRenderStateDefinition<Resources, Options, 'default', CustomProps, SharedComposables, StateComposables, IncludeProps>, Deferred>>;
-  (render: TypedRenderStateCallback<Resources, Options, SharedComposables>): BoundRenderStateFragment<Resources, Options, SharedComposables, RenderStateEntry<TypedRenderStateCallback<Resources, Options, SharedComposables>, Deferred>>;
+interface RenderStateOverloads<Resources extends ReadonlyArray<ResourceDefinition>, Options extends InPropsDefinition<Resources>, SharedComposables extends ComposableComponents, Deferred extends boolean, SharedInclude extends IncludedProps<MergedLayoutInProps<Resources, Options, SharedComposables>> = {}, SharedCustom extends InPropsObject = {}> {
+  <const State extends RenderStateName, const CustomProps extends InPropsObject = {}, const StateComposables extends ComposableComponents = {}, const IncludeProps extends IncludedProps<MergedLayoutInProps<Resources, Options, SharedComposables & StateComposables>> = {}>(definition: TypedRenderStateDefinition<Resources, Options, State, CustomProps, SharedComposables, StateComposables, IncludeProps, SharedInclude, SharedCustom>): BoundRenderStateFragment<Resources, Options, SharedComposables, RenderStateEntry<TypedRenderStateDefinition<Resources, Options, State, CustomProps, SharedComposables, StateComposables, IncludeProps, SharedInclude, SharedCustom>, Deferred>>;
+  <const CustomProps extends InPropsObject = {}, const StateComposables extends ComposableComponents = {}, const IncludeProps extends IncludedProps<MergedLayoutInProps<Resources, Options, SharedComposables & StateComposables>> = {}>(definition: Omit<TypedRenderStateDefinition<Resources, Options, 'default', CustomProps, SharedComposables, StateComposables, IncludeProps, SharedInclude, SharedCustom>, 'state'>): BoundRenderStateFragment<Resources, Options, SharedComposables, RenderStateEntry<TypedRenderStateDefinition<Resources, Options, 'default', CustomProps, SharedComposables, StateComposables, IncludeProps, SharedInclude, SharedCustom>, Deferred>>;
+  (render: TypedRenderStateCallback<Resources, Options, SharedComposables, SharedInclude, SharedCustom>): BoundRenderStateFragment<Resources, Options, SharedComposables, RenderStateEntry<TypedRenderStateCallback<Resources, Options, SharedComposables, SharedInclude, SharedCustom>, Deferred>>;
 }
+type RenderStateReference = ({
+  readonly [definedRenderStateSymbol]: AnyRenderStateDefinition;
+} | LazyRenderState<AnyRenderStateDefinition>) & StateComposableHandle<any>;
+type ReferenceDefinition<Ref extends RenderStateReference> = Ref extends LazyRenderState<infer Definition> ? Definition : Ref extends {
+  readonly [definedRenderStateSymbol]: infer Definition extends AnyRenderStateDefinition;
+} ? Definition : never;
+type FromStateEntry<Ref extends RenderStateReference, Definition extends AnyRenderStateDefinition> = Ref extends LazyRenderState<AnyRenderStateDefinition> ? LazyRenderState<Definition> : Extract<Ref[Exclude<keyof Ref, 'asComposable' | typeof definedRenderStateSymbol>], LazyRenderState<AnyRenderStateDefinition>> extends never ? Definition : LazyRenderState<Definition>;
+type ReferenceSchemas<Ref extends RenderStateReference> = StateCustomProps<ReferenceDefinition<Ref>> & MergePresetProps<StateLocalComposables<ReferenceDefinition<Ref>>>;
+type DefaultReferenceIncludes<Ref extends RenderStateReference, CustomProps> = Omit<StateIncludes<ReferenceDefinition<Ref>>, keyof CustomProps | keyof StateCustomProps<ReferenceDefinition<Ref>>> & { [Key in Exclude<keyof StateCustomProps<ReferenceDefinition<Ref>>, keyof CustomProps>]: {
+  visibility: StateCustomProps<ReferenceDefinition<Ref>>[Key] extends {
+    visibility: infer Visibility;
+  } ? Visibility : 'required';
+  passthrough: 'component';
+} };
+type ReferenceIncludes<Ref extends RenderStateReference, CustomProps, Include> = Include extends object ? Include : DefaultReferenceIncludes<Ref, CustomProps>;
+type FromStateInProps<Resources extends ReadonlyArray<ResourceDefinition>, Options extends InPropsDefinition<Resources>, Shared extends ComposableComponents, Ref extends RenderStateReference, Local extends ComposableComponents> = (MergedLayoutInProps<Resources, Options, Shared & StateLocalComposables<ReferenceDefinition<Ref>> & Local> & StateCustomProps<ReferenceDefinition<Ref>>) extends infer Props extends InPropsObject ? Props : {};
+type SelectedReferenceSchemas<Ref extends RenderStateReference, Include> = Pick<ReferenceSchemas<Ref>, Extract<keyof Include, keyof ReferenceSchemas<Ref>>> extends infer Selected extends InPropsObject ? Selected : {};
+type ReferenceCarriedProps<Resources extends ReadonlyArray<ResourceDefinition>, Options extends InPropsDefinition<Resources>, Shared extends ComposableComponents, Ref extends RenderStateReference, Include> = Pick<FromStateInProps<Resources, Options, Shared, Ref, {}>, Extract<keyof Include, keyof FromStateInProps<Resources, Options, Shared, Ref, {}>>> extends infer Selected extends InPropsObject ? ResolveProps<Selected> : {};
+type ReferenceRenderProps<Resources extends ReadonlyArray<ResourceDefinition>, Options extends InPropsDefinition<Resources>, Shared extends ComposableComponents, Ref extends RenderStateReference> = RenderStateProps<Resources, Options, Shared & StateLocalComposables<ReferenceDefinition<Ref>>, StateIncludes<ReferenceDefinition<Ref>> extends infer Include extends IncludedProps<MergedLayoutInProps<Resources, Options, Shared & StateLocalComposables<ReferenceDefinition<Ref>>>> ? Include : {}, StateCustomProps<ReferenceDefinition<Ref>>>;
+type FromStateComposables<Resources extends ReadonlyArray<ResourceDefinition>, Options extends InPropsDefinition<Resources>, Shared extends ComposableComponents, Ref extends RenderStateReference, Local extends ComposableComponents, Include> = Local & {
+  Ref: StateComposable<ReferenceRenderProps<Resources, Options, Shared, Ref>, Extract<keyof ReferenceCarriedProps<Resources, Options, Shared, Ref, Include>, keyof ReferenceRenderProps<Resources, Options, Shared, Ref>>> & {
+    [composablePresetMetaKey]: ComposablePresetMeta<SelectedReferenceSchemas<Ref, Include>>;
+  };
+};
+type FromStateDefinition<Resources extends ReadonlyArray<ResourceDefinition>, Options extends InPropsDefinition<Resources>, Shared extends ComposableComponents, Ref extends RenderStateReference, State extends string, CustomProps extends InPropsObject, Local extends ComposableComponents, Include> = {
+  state: State;
+  props?: {
+    custom?: CustomProps;
+    include?: ReferenceIncludes<Ref, CustomProps, Include>;
+  };
+  composables: RenderStateComposablesDefinition<Resources, FromStateComposables<Resources, Options, Shared, Ref, Local, ReferenceIncludes<Ref, CustomProps, Include>>>;
+  render: (props: ResolveProps<CustomProps> & ResolvedIncludedProps<FromStateInProps<Resources, Options, Shared, Ref, Local>, ReferenceIncludes<Ref, CustomProps, Include> extends infer Selected extends IncludedProps<FromStateInProps<Resources, Options, Shared, Ref, Local>> ? Selected : {}>, context: RenderStateContext<Shared & FromStateComposables<Resources, Options, Shared, Ref, Local, ReferenceIncludes<Ref, CustomProps, Include>>, Resources>) => JSX.Element;
+};
+/** Creates a state with inherited props and a composable reference to its source. */
+type CreateRenderStateFromState<Resources extends ReadonlyArray<ResourceDefinition>, Options extends InPropsDefinition<Resources>, Shared extends ComposableComponents> = <const Ref extends RenderStateReference, const State extends RenderStateName = 'default', const CustomProps extends InPropsObject = {}, const Local extends ComposableComponents = {}, const Include extends IncludedProps<FromStateInProps<Resources, Options, Shared, Ref, Local>> | undefined = undefined>(definition: {
+  ref: Ref; /** Defer Ref rendering through React.lazy. Defaults to false. */
+  lazy?: boolean;
+  state?: State;
+  props?: {
+    custom?: CustomProps;
+    include?: Include & Record<Exclude<keyof Include, keyof FromStateInProps<Resources, Options, Shared, Ref, Local>>, never>;
+  };
+  composables?: (create: CreateLayoutComposable<LayoutResourceKey<Resources>>, states: {}) => Local & {
+    Ref?: never;
+  };
+  render: FromStateDefinition<Resources, Options, Shared, Ref, State, CustomProps, Local, Include>['render'];
+}) => BoundRenderStateFragment<Resources, Options, Shared, FromStateEntry<Ref, FromStateDefinition<Resources, Options, Shared, Ref, State, CustomProps, Local, Include>>>;
 /**
  * Creates independently typed render-state fragments.
  *
@@ -140,19 +189,25 @@ interface RenderStateOverloads<Resources extends ReadonlyArray<ResourceDefinitio
  *   does not create a separate JavaScript chunk.
  * - `.lazy(() => import(...))` imports a complete named state definition as a
  *   separate chunk.
+ * - `.fromState({ ref, ... })` inherits a state's props and exposes it as `Ref`.
  */
-interface CreateRenderState<Resources extends ReadonlyArray<ResourceDefinition> = ReadonlyArray<ResourceDefinition>, Options extends InPropsDefinition<Resources> = {}, SharedComposables extends ComposableComponents = {}> extends RenderStateOverloads<Resources, Options, SharedComposables, false> {
-  defer: RenderStateOverloads<Resources, Options, SharedComposables, true>;
+interface CreateRenderState<Resources extends ReadonlyArray<ResourceDefinition> = ReadonlyArray<ResourceDefinition>, Options extends InPropsDefinition<Resources> = {}, SharedComposables extends ComposableComponents = {}, SharedInclude extends IncludedProps<MergedLayoutInProps<Resources, Options, SharedComposables>> = {}, SharedCustom extends InPropsObject = {}> extends RenderStateOverloads<Resources, Options, SharedComposables, false, SharedInclude, SharedCustom> {
+  fromState: CreateRenderStateFromState<Resources, Options, SharedComposables>;
+  defer: RenderStateOverloads<Resources, Options, SharedComposables, true, SharedInclude, SharedCustom>;
   lazy<Module extends Record<string, unknown>>(load: () => Promise<Module>): LazyRenderState<DefinedRenderStateFromModule<Module>> & StateComposableHandle<RenderStateCallProps<Resources, Options, SharedComposables, DefinedRenderStateFromModule<Module>>>;
 }
 /** Inputs used internally to bind resource and option types to a state builder. */
-type CreateRenderStateBuilderArguments<Resources extends ReadonlyArray<ResourceDefinition>, Options extends InPropsDefinition<Resources>, SharedComposables extends ComposableComponents = {}> = {
-  /** Shared composables whose components and preset props every state can use. */composables?: LayoutComposablesDefinition<Resources, SharedComposables>; /** Option props that individual states can expose through `props.include`. */
+type CreateRenderStateBuilderArguments<Resources extends ReadonlyArray<ResourceDefinition>, Options extends InPropsDefinition<Resources>, SharedComposables extends ComposableComponents = {}, SharedInclude extends IncludedProps<MergedLayoutInProps<Resources, Options, SharedComposables>> = {}, SharedCustom extends InPropsObject = {}> = {
+  props?: {
+    include?: SharedInclude;
+    custom?: SharedCustom;
+  }; /** Shared composables whose components and preset props every state can use. */
+  composables?: LayoutComposablesDefinition<Resources, SharedComposables>; /** Option props that individual states can expose through `props.include`. */
   options: Options; /** Resources used to constrain composable names and resource-specific props. */
   resources: Resources;
 };
 /** The state factory produced for a particular resource and option definition. */
-type CreateRenderStateBuilderResult<Resources extends ReadonlyArray<ResourceDefinition>, Options extends InPropsDefinition<Resources>, SharedComposables extends ComposableComponents = {}> = CreateRenderState<Resources, Options, SharedComposables>;
+type CreateRenderStateBuilderResult<Resources extends ReadonlyArray<ResourceDefinition>, Options extends InPropsDefinition<Resources>, SharedComposables extends ComposableComponents = {}, SharedInclude extends IncludedProps<MergedLayoutInProps<Resources, Options, SharedComposables>> = {}, SharedCustom extends InPropsObject = {}> = CreateRenderState<Resources, Options, SharedComposables, SharedInclude, SharedCustom>;
 /** Identity helper that contextually types a reusable composables callback. */
 type DefineLayoutComposables<Resources extends ReadonlyArray<ResourceDefinition>> = <const Composables extends ComposableComponents>(definition: LayoutComposablesDefinition<Resources, Composables>) => LayoutComposablesDefinition<Resources, Composables>;
 /** Public cross-file building blocks returned by a defined layout builder. */
@@ -165,5 +220,5 @@ type CreateLayoutBuildingBlocksArguments<Resources extends ReadonlyArray<Resourc
 /** Layout helpers produced for the supplied resource and option bindings. */
 type CreateLayoutBuildingBlocksResult<Resources extends ReadonlyArray<ResourceDefinition>, Options extends InPropsDefinition<Resources>> = CreateLayoutBuildingBlocks<Resources, Options>;
 //#endregion
-export { AnyRenderStateDefinition, CreateLayoutBuildingBlocks, CreateLayoutBuildingBlocksArguments, CreateLayoutBuildingBlocksResult, CreateRenderState, CreateRenderStateBuilderArguments, CreateRenderStateBuilderResult, DeferredRenderState, DefineLayoutComposables, LayoutComposablesDefinition, LazyRenderState, RenderStateCallProps, RenderStateCallback, RenderStateComposablesDefinition, RenderStateContext, RenderStateFragment, RenderStateName, RenderStateOverloads, RenderStateProps, RenderStateReferences, TypedRenderStateCallback, definedResourceLayoutComponentSymbol };
+export { AnyRenderStateDefinition, CreateLayoutBuildingBlocks, CreateLayoutBuildingBlocksArguments, CreateLayoutBuildingBlocksResult, CreateRenderState, CreateRenderStateBuilderArguments, CreateRenderStateBuilderResult, CreateRenderStateFromState, DeferredRenderState, DefineLayoutComposables, LayoutComposablesDefinition, LazyRenderState, RenderStateCallProps, RenderStateCallback, RenderStateComposablesDefinition, RenderStateContext, RenderStateFragment, RenderStateName, RenderStateOverloads, RenderStateProps, RenderStateReferences, TypedRenderStateCallback, definedResourceLayoutComponentSymbol };
 //# sourceMappingURL=render-state.d.cts.map

package/dist/create-config/render-state.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"render-state.d.cts","names":[],"sources":["../../src/create-config/render-state.ts"],"mappings":"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"}
+{"version":3,"file":"render-state.d.cts","names":[],"sources":["../../src/create-config/render-state.ts"],"mappings":";;;;;;;;;cAsBa,yBAAA;AAAA,cAGA,qBAAA;AAAA,cAGA,wBAAA;AAAA,cAGA,oCAAA;AANb;AAAA,KAWY,wBAAA;EACV,WAAA,IAAe,MAAA,EAAQ,sBAAA,OAA6B,MAAA,UAAgB,oBAAA;EACpE,KAAA;IACE,OAAA,GAAU,MAAA;IACV,MAAA,GAAS,aAAA;EAAA;EAEX,MAAA,GAAS,KAAA,OAAY,OAAA,UAAiB,GAAA,CAAI,OAAA;EAC1C,KAAA;AAAA;AAZF;AAAA,KAgBY,mBAAA,oBAAuC,wBAAA;EAAA,UACvC,yBAAA,GAA4B,UAAA;AAAA;AAf9B;AAAA,KAmBE,eAAA,oBAAmC,wBAAA;EAAA,UACnC,qBAAA,SAA8B,OAAA,CAAQ,MAAA;EAAA,SACvC,UAAA,GAAa,UAAA;AAAA;;;;;KAOZ,eAAA;;KAQA,mBAAA,IAAuB,KAAA,OAAY,OAAA,UAAiB,GAAA,CAAI,OAAO;;;;;KAM/D,gCAAA,mBACQ,aAAA,CAAc,kBAAA,uBACZ,oBAAA,kBAGpB,MAAA,EAAQ,sBAAA,CAAuB,iBAAA,CAAkB,SAAA,IACjD,MAAA,EAAQ,MAAA,KACL,WAAA;;;;;KAMO,2BAAA,mBACQ,aAAA,CAAc,kBAAA,uBACZ,oBAAA,IAClB,gCAAA,CAAiC,SAAA,EAAW,WAAA;AAAA,KAE3C,wBAAA,qBAA6C,oBAAA,WAC1C,WAAA,gCAGJ,WAAA;;KAGQ,kBAAA,qBACU,oBAAA,oBACF,aAAA,CAAc,kBAAA,IAAsB,aAAA,CAAc,kBAAA;EAEpE,SAAA,EAAW,6BAAA,CAA8B,SAAA;EACzC,WAAA,EAAa,wBAAA,CAAyB,WAAA;EACtC,KAAA;AAAA;;;;;KAOU,gBAAA,mBACQ,aAAA,CAAc,kBAAA,mBAChB,iBAAA,CAAkB,SAAA,uBACd,oBAAA,uBACC,aAAA,CACnB,mBAAA,CAAoB,SAAA,EAAW,OAAA,EAAS,WAAA,wBAEtB,aAAA,IAClB,iBAAA,CACF,SAAA,EACA,OAAA,EACA,WAAA,EACA,YAAA,EACA,WAAA;AAAA,KAGG,0BAAA,mBACe,aAAA,CAAc,kBAAA,mBAChB,iBAAA,CAAkB,SAAA,6CAEd,aAAA,4BACM,oBAAA,2BACD,oBAAA,uBACJ,aAAA,CACnB,mBAAA,CACE,SAAA,EACA,OAAA,EACA,iBAAA,GAAoB,gBAAA,0BAGF,aAAA,CAAc,mBAAA,CAAoB,SAAA,EAAW,OAAA,EAAS,iBAAA,8BACvD,aAAA;EAErB,WAAA,GAAc,gCAAA,CAAiC,SAAA,EAAW,gBAAA;EAC1D,KAAA;IACE,OAAA,GAAU,YAAA;IACV,MAAA,GAAS,WAAA;EAAA;EAEX,MAAA,GACE,KAAA,EAAO,gBAAA,CACL,SAAA,EACA,OAAA,EACA,iBAAA,GAAoB,gBAAA,EACpB,aAAA,CAAc,aAAA,EAAe,YAAA,GAC7B,aAAA,CAAc,YAAA,EAAc,WAAA,IAE9B,OAAA,EAAS,kBAAA,CAAmB,iBAAA,GAAoB,gBAAA,EAAkB,SAAA,MAC/D,GAAA,CAAI,OAAA;EACT,KAAA,EAAO,KAAA;AAAA;;;;;KAOG,wBAAA,mBACQ,aAAA,CAAc,kBAAA,mBAChB,iBAAA,CAAkB,SAAA,6BACR,oBAAA,wBACJ,aAAA,CAAc,mBAAA,CAAoB,SAAA,EAAW,OAAA,EAAS,iBAAA,8BACvD,aAAA,UAErB,KAAA,EAAO,gBAAA,CAAiB,SAAA,EAAW,OAAA,EAAS,iBAAA,EAAmB,aAAA,EAAe,YAAA,GAC9E,OAAA,EAAS,kBAAA,CAAmB,iBAAA,EAAmB,SAAA,MAC5C,GAAA,CAAI,OAAA;AAAA,KAEJ,8BAAA,UACH,KAAA,SAAc,eAAA,qBACV,UAAA,GACA,KAAA,SAAc,mBAAA,qBACd,UAAA,GACA,KAAA,SAAc,mBAAA;EACV,MAAA,EAAQ,KAAA;EAAO,KAAA;AAAA,IACjB,KAAA,SAAc,wBAAA,GACZ,KAAA;AAAA,KAGL,SAAA,eAAwB,UAAA,SAAmB,mBAAA,6BAG5C,SAAA,CAAU,kBAAA,IACV,UAAA;EAAqB,KAAA;AAAA,IACnB,KAAA;;;;;KAOM,mBAAA,wCAA2D,YAAA,CAAa,gBAAA,CAAiB,UAAA,kBACzF,SAAA,CAAU,8BAAA,CAA+B,UAAA,KAAe,UAAA;EAAA,UAExD,wBAAA,GAA2B,8BAAA,CAA+B,UAAA;AAAA,IAClE,qBAAA,CAAsB,SAAA;AAAA,KAErB,gBAAA,UAA0B,mBAAA,CAAoB,KAAA;EACjD,KAAA;IAAU,MAAA,uBAA6B,aAAA;EAAA;AAAA,IACrC,KAAA;AAAA,KAEC,aAAA,UAAuB,mBAAmB,CAAC,KAAA;EAC9C,KAAA;IAAU,OAAA;EAAA;AAAA,IACR,QAAA;AAAA,KAEC,mBAAA,UAA6B,KAAA,SAAc,mBAAA,qBAC5C,UAAA,GACA,KAAA,SAAc,eAAA,qBAAoC,UAAA,GAAa,KAAA;AAAA,KAE9D,qBAAA,UAA+B,mBAAA,CAAoB,KAAA;EACtD,WAAA,OAAkB,IAAA,qCAAyC,oBAAA;AAAA,IACzD,UAAA;;;;;;KAOC,6BAAA,8BACK,OAAA,OAAc,QAAA,QAAgB,KAAA,KAAU,QAAA,CAAS,GAAA;EACvD,UAAA;EAAwB,WAAA;AAAA,IACtB,GAAA,iCAEI,OAAA,OAAc,QAAA,QAAgB,KAAA,KAAU,QAAA,CAAS,GAAA;EAEnD,UAAA;EAAwB,WAAA;AAAA,IAC1B,GAAA;AAAA,KAGD,mBAAA,eAAkC,aAAA,cACrC,8BAAA,CAA+B,KAAA,EAC7B,IAAA,CAAK,QAAA,EAAU,OAAA,OAAc,QAAA,QAAgB,KAAA,+BAAoC,aAAA,CAAc,KAAA,IAC3F,KAAA,SACF,6BAAA,CAA8B,KAAA,EAAO,QAAA;;KAG/B,oBAAA,mBACQ,aAAA,CAAc,kBAAA,mBAChB,iBAAA,CAAkB,SAAA,uBACd,oBAAA,WAElB,YAAA,CAAa,gBAAA,CAAiB,KAAA,KAAU,mBAAA,CAC1C,mBAAA,CAAoB,SAAA,EAAW,OAAA,EAAS,WAAA,GAAc,qBAAA,CAAsB,KAAA,IAC5E,aAAA,CAAc,KAAA;;KAIJ,qBAAA,mBACQ,aAAA,CAAc,kBAAA,mBAChB,iBAAA,CAAkB,SAAA,uBACd,oBAAA,uCAGK,MAAA,YAAkB,eAAA,CACzC,oBAAA,CAAqB,SAAA,EAAW,OAAA,EAAS,WAAA,EAAa,MAAA,CAAO,KAAA;AAAA,KAI5D,wBAAA,mBACe,aAAA,CAAc,kBAAA,mBAChB,iBAAA,CAAkB,SAAA,uBACd,oBAAA,gBAElB,mBAAA,CAAoB,UAAA,EAAY,oBAAA,CAClC,SAAA,EAAW,OAAA,EAAS,WAAA,EAAa,UAAA;AAAA,KAG9B,4BAAA,WAAuC,OAAA,CAC1C,MAAA,OAAa,MAAA;EAAA,UACD,wBAAA,GAA2B,wBAAA;AAAA,UAChC,wBAAA;;KAGJ,gBAAA,yCAAyD,QAAA,gBAC1D,mBAAA,CAAoB,8BAAA,CAA+B,UAAA,KACnD,UAAA;;;;;;UAOa,oBAAA,mBACG,aAAA,CAAc,kBAAA,mBAChB,iBAAA,CAAkB,SAAA,6BACR,oBAAA,kDAEJ,aAAA,CAAc,mBAAA,CAAoB,SAAA,EAAW,OAAA,EAAS,iBAAA,8BACvD,aAAA;EAAA,qBAGC,eAAA,4BACM,aAAA,sCACK,oBAAA,kCACJ,aAAA,CACzB,mBAAA,CACE,SAAA,EACA,OAAA,EACA,iBAAA,GAAoB,gBAAA,SAIxB,UAAA,EAAY,0BAAA,CACV,SAAA,EACA,OAAA,EACA,KAAA,EACA,WAAA,EACA,iBAAA,EACA,gBAAA,EACA,YAAA,EACA,aAAA,EACA,YAAA,IAED,wBAAA,CAAyB,SAAA,EAAW,OAAA,EAAS,iBAAA,EAC9C,gBAAA,CACE,0BAAA,CACE,SAAA,EACA,OAAA,EACA,KAAA,EACA,WAAA,EACA,iBAAA,EACA,gBAAA,EACA,YAAA,EACF,aAAA,EACA,YAAA,GAEA,QAAA;EAAA,2BAIwB,aAAA,sCACK,oBAAA,kCACJ,aAAA,CACzB,mBAAA,CACE,SAAA,EACA,OAAA,EACA,iBAAA,GAAoB,gBAAA,SAIxB,UAAA,EAAY,IAAA,CACV,0BAAA,CACE,SAAA,EACA,OAAA,aAEA,WAAA,EACA,iBAAA,EACA,gBAAA,EACA,YAAA,EACF,aAAA,EACA,YAAA,cAID,wBAAA,CAAyB,SAAA,EAAW,OAAA,EAAS,iBAAA,EAC9C,gBAAA,CACE,0BAAA,CACE,SAAA,EACA,OAAA,aAEA,WAAA,EACA,iBAAA,EACA,gBAAA,EACA,YAAA,EACF,aAAA,EACA,YAAA,GAEA,QAAA;EAAA,CAIF,MAAA,EAAQ,wBAAA,CAAyB,SAAA,EAAW,OAAA,EAAS,iBAAA,EAAmB,aAAA,EAAe,YAAA,IACtF,wBAAA,CAAyB,SAAA,EAAW,OAAA,EAAS,iBAAA,EAC9C,gBAAA,CACE,wBAAA,CAAyB,SAAA,EAAW,OAAA,EAAS,iBAAA,EAAmB,aAAA,EAAe,YAAA,GAC/E,QAAA;AAAA;AAAA,KAKD,oBAAA;EAAA,UACW,wBAAA,GAA2B,wBAAA;AAAA,IACvC,eAAA,CAAgB,wBAAA,KAChB,qBAAA;AAAA,KAEC,mBAAA,aAAgC,oBAAA,IACnC,GAAA,SAAY,eAAA,qBAAoC,UAAA,GAC5C,GAAA;EAAA,UAAwB,wBAAA,4BAAoD,wBAAA;AAAA,IAC1E,UAAA;AAAA,KAEH,cAAA,aAA2B,oBAAA,qBAAyC,wBAAA,IACvE,GAAA,SAAY,eAAA,CAAgB,wBAAA,IAA4B,eAAA,CAAgB,UAAA,IACpE,OAAA,CAAQ,GAAA,CAAI,OAAA,OAAc,GAAA,0BAA6B,wBAAA,IAA4B,eAAA,CAAgB,wBAAA,mBACjG,UAAA,GAAa,eAAA,CAAgB,UAAA;AAAA,KAChC,gBAAA,aAA6B,oBAAA,IAChC,gBAAA,CAAiB,mBAAA,CAAoB,GAAA,KAAQ,gBAAA,CAAiB,qBAAA,CAAsB,mBAAA,CAAoB,GAAA;AAAA,KAErG,wBAAA,aAAqC,oBAAA,iBACxC,IAAA,CAAK,aAAA,CAAc,mBAAA,CAAoB,GAAA,UAAa,WAAA,SAAoB,gBAAA,CAAiB,mBAAA,CAAoB,GAAA,gBACnG,OAAA,OAAc,gBAAA,CAAiB,mBAAA,CAAoB,GAAA,UAAa,WAAA;EACtE,UAAA,EAAY,gBAAA,CAAiB,mBAAA,CAAoB,GAAA,GAAM,GAAA;IAAe,UAAA;EAAA,IAClE,UAAA;EACJ,WAAA;AAAA;AAAA,KAID,iBAAA,aAA8B,oBAAA,0BACjC,OAAA,kBAAyB,OAAA,GAAU,wBAAA,CAAyB,GAAA,EAAK,WAAA;AAAA,KAE9D,gBAAA,mBACe,aAAA,CAAc,kBAAA,mBAChB,iBAAA,CAAkB,SAAA,kBACnB,oBAAA,cACH,oBAAA,gBACE,oBAAA,KACX,mBAAA,CAAoB,SAAA,EAAW,OAAA,EAAS,MAAA,GAAS,qBAAA,CAAsB,mBAAA,CAAoB,GAAA,KAAQ,KAAA,IACtG,gBAAA,CAAiB,mBAAA,CAAoB,GAAA,gCAAmC,aAAA,GAAgB,KAAA;AAAA,KAErF,wBAAA,aAAqC,oBAAA,aACxC,IAAA,CAAK,gBAAA,CAAiB,GAAA,GAAM,OAAA,OAAc,OAAA,QAAe,gBAAA,CAAiB,GAAA,mCAAsC,aAAA,GAC5G,QAAA;AAAA,KAED,qBAAA,mBACe,aAAA,CAAc,kBAAA,mBAChB,iBAAA,CAAkB,SAAA,kBACnB,oBAAA,cACH,oBAAA,aAEV,IAAA,CAAK,gBAAA,CAAiB,SAAA,EAAW,OAAA,EAAS,MAAA,EAAQ,GAAA,OACpD,OAAA,OAAc,OAAA,QAAe,gBAAA,CAAiB,SAAA,EAAW,OAAA,EAAS,MAAA,EAAQ,GAAA,uCAC3C,aAAA,GAAgB,YAAA,CAAa,QAAA;AAAA,KAEzD,oBAAA,mBACe,aAAA,CAAc,kBAAA,mBAChB,iBAAA,CAAkB,SAAA,kBACnB,oBAAA,cACH,oBAAA,IACV,gBAAA,CAAiB,SAAA,EAAW,OAAA,EAAS,MAAA,GAAS,qBAAA,CAAsB,mBAAA,CAAoB,GAAA,IAC1F,aAAA,CAAc,mBAAA,CAAoB,GAAA,iCAAoC,aAAA,CAAc,mBAAA,CAAoB,SAAA,EAAW,OAAA,EAAS,MAAA,GAAS,qBAAA,CAAsB,mBAAA,CAAoB,GAAA,OAAU,OAAA,OACzL,gBAAA,CAAiB,mBAAA,CAAoB,GAAA;AAAA,KAElC,oBAAA,mBACe,aAAA,CAAc,kBAAA,mBAChB,iBAAA,CAAkB,SAAA,kBACnB,oBAAA,cACH,oBAAA,gBACE,oBAAA,aAEZ,KAAA;EACF,GAAA,EAAK,eAAA,CACH,oBAAA,CAAqB,SAAA,EAAW,OAAA,EAAS,MAAA,EAAQ,GAAA,GACjD,OAAA,OAAc,qBAAA,CAAsB,SAAA,EAAW,OAAA,EAAS,MAAA,EAAQ,GAAA,EAAK,OAAA,SAAgB,oBAAA,CAAqB,SAAA,EAAW,OAAA,EAAS,MAAA,EAAQ,GAAA;IAAA,CACjI,uBAAA,GAA0B,oBAAA,CAAqB,wBAAA,CAAyB,GAAA,EAAK,OAAA;EAAA;AAAA;AAAA,KAGjF,mBAAA,mBACe,aAAA,CAAc,kBAAA,mBAChB,iBAAA,CAAkB,SAAA,kBACnB,oBAAA,cACH,oBAAA,4CAEQ,aAAA,gBACN,oBAAA;EAGd,KAAA,EAAO,KAAA;EACP,KAAA;IAAU,MAAA,GAAS,WAAA;IAAa,OAAA,GAAU,iBAAA,CAAkB,GAAA,EAAK,WAAA,EAAa,OAAA;EAAA;EAC9E,WAAA,EAAa,gCAAA,CAAiC,SAAA,EAC5C,oBAAA,CAAqB,SAAA,EAAW,OAAA,EAAS,MAAA,EAAQ,GAAA,EAAK,KAAA,EAAO,iBAAA,CAAkB,GAAA,EAAK,WAAA,EAAa,OAAA;EACnG,MAAA,GACE,KAAA,EAAO,YAAA,CAAa,WAAA,IAAe,qBAAA,CAAsB,gBAAA,CAAiB,SAAA,EAAW,OAAA,EAAS,MAAA,EAAQ,GAAA,EAAK,KAAA,GACzG,iBAAA,CAAkB,GAAA,EAAK,WAAA,EAAa,OAAA,iCAAwC,aAAA,CAAc,gBAAA,CAAiB,SAAA,EAAW,OAAA,EAAS,MAAA,EAAQ,GAAA,EAAK,KAAA,KAAU,QAAA,QACxJ,OAAA,EAAS,kBAAA,CAAmB,MAAA,GAAS,oBAAA,CAAqB,SAAA,EAAW,OAAA,EAAS,MAAA,EAAQ,GAAA,EAAK,KAAA,EAAO,iBAAA,CAAkB,GAAA,EAAK,WAAA,EAAa,OAAA,IAAW,SAAA,MAC9I,GAAA,CAAI,OAAA;AAAA;;KAIC,0BAAA,mBACQ,aAAA,CAAc,kBAAA,mBAChB,iBAAA,CAAkB,SAAA,kBACnB,oBAAA,uBAEG,oBAAA,sBACE,eAAA,wCACM,aAAA,2BACN,oBAAA,6BACE,aAAA,CAAc,gBAAA,CAAiB,SAAA,EAAW,OAAA,EAAS,MAAA,EAAQ,GAAA,EAAK,KAAA,4BACtF,UAAA;EACA,GAAA,EAAK,GAAA,EA7Ya;EA+YlB,IAAA;EACA,KAAA,GAAQ,KAAA;EACR,KAAA;IACE,MAAA,GAAS,WAAA;IACT,OAAA,GAAU,OAAA,GAAU,MAAA,CAAO,OAAA,OAAc,OAAA,QAAe,gBAAA,CAAiB,SAAA,EAAW,OAAA,EAAS,MAAA,EAAQ,GAAA,EAAK,KAAA;EAAA;EAE5G,WAAA,IAAe,MAAA,EAAQ,sBAAA,CAAuB,iBAAA,CAAkB,SAAA,IAAa,MAAA,SAAe,KAAA;IAAU,GAAA;EAAA;EACtG,MAAA,EAAQ,mBAAA,CAAoB,SAAA,EAAW,OAAA,EAAS,MAAA,EAAQ,GAAA,EAAK,KAAA,EAAO,WAAA,EAAa,KAAA,EAAO,OAAA;AAAA,MACpF,wBAAA,CAAyB,SAAA,EAAW,OAAA,EAAS,MAAA,EACjD,cAAA,CAAe,GAAA,EAAK,mBAAA,CAAoB,SAAA,EAAW,OAAA,EAAS,MAAA,EAAQ,GAAA,EAAK,KAAA,EAAO,WAAA,EAAa,KAAA,EAAO,OAAA;AApZ/F;AAOP;;;;;;;;;AAPO,UAgaU,iBAAA,mBACG,aAAA,CAAc,kBAAA,IAAsB,aAAA,CAAc,kBAAA,mBACpD,iBAAA,CAAkB,SAAA,kCACR,oBAAA,6BACJ,aAAA,CAAc,mBAAA,CAAoB,SAAA,EAAW,OAAA,EAAS,iBAAA,8BACvD,aAAA,eACb,oBAAA,CAAqB,SAAA,EAAW,OAAA,EAAS,iBAAA,SAA0B,aAAA,EAAe,YAAA;EAC1F,SAAA,EAAW,0BAAA,CAA2B,SAAA,EAAW,OAAA,EAAS,iBAAA;EAC1D,KAAA,EAAO,oBAAA,CAAqB,SAAA,EAAW,OAAA,EAAS,iBAAA,QAAyB,aAAA,EAAe,YAAA;EACxF,IAAA,gBAAoB,MAAA,mBAClB,IAAA,QAAY,OAAA,CAAQ,MAAA,IACnB,eAAA,CAAgB,4BAAA,CAA6B,MAAA,KAAW,qBAAA,CACzD,oBAAA,CAAqB,SAAA,EAAW,OAAA,EAAS,iBAAA,EAAmB,4BAAA,CAA6B,MAAA;AAAA;;KA4BjF,iCAAA,mBACQ,aAAA,CAAc,kBAAA,mBAChB,iBAAA,CAAkB,SAAA,6BACR,oBAAA,6BACJ,aAAA,CAAc,mBAAA,CAAoB,SAAA,EAAW,OAAA,EAAS,iBAAA,8BACvD,aAAA;EAErB,KAAA;IAAU,OAAA,GAAU,aAAA;IAAe,MAAA,GAAS,YAAA;EAAA,GAhczB;EAkcnB,WAAA,GAAc,2BAAA,CAA4B,SAAA,EAAW,iBAAA,GAzcrD;EA2cA,OAAA,EAAS,OAAA,EA3cuB;EA6chC,SAAA,EAAW,SAAA;AAAA;;KAID,8BAAA,mBACQ,aAAA,CAAc,kBAAA,mBAChB,iBAAA,CAAkB,SAAA,6BACR,oBAAA,6BACJ,aAAA,CAAc,mBAAA,CAAoB,SAAA,EAAW,OAAA,EAAS,iBAAA,8BACvD,aAAA,SACnB,iBAAA,CAAkB,SAAA,EAAW,OAAA,EAAS,iBAAA,EAAmB,aAAA,EAAe,YAAA;;KAoLhE,uBAAA,mBACQ,aAAA,CAAc,kBAAA,gCACH,oBAAA,EAC7B,UAAA,EAAY,2BAAA,CAA4B,SAAA,EAAW,WAAA,MAChD,2BAAA,CAA4B,SAAA,EAAW,WAAA;AAnoB/B;AAAA,KAsoBD,0BAAA,mBACQ,aAAA,CAAc,kBAAA,mBAChB,iBAAA,CAAkB,SAAA;EAElC,WAAA,EAAa,uBAAA,CAAwB,SAAA;EACrC,iBAAA,EAAmB,iBAAA,CAAkB,SAAA,EAAW,OAAA;AAAA;;KAItC,mCAAA,mBACQ,aAAA,CAAc,kBAAA,mBAChB,iBAAA,CAAkB,SAAA,KAChC,iCAAA,CAAkC,SAAA,EAAW,OAAA;;KAGrC,gCAAA,mBACQ,aAAA,CAAc,kBAAA,mBAChB,iBAAA,CAAkB,SAAA,KAChC,0BAAA,CAA2B,SAAA,EAAW,OAAA"}