@jfdevelops/react-layout 0.24.2 → 0.25.0

package/dist/errors/resource-state-error.cjs

@@ -0,0 +1,29 @@
+
+//#region src/errors/resource-state-error.ts
+/** Identifies a failed dynamic import for a resource layout or render state. */
+var ResourceModuleLoadError = class extends Error {
+	resource;
+	code = "resourceModuleLoad";
+	constructor(resource, cause) {
+		super(`Unable to load resource module "${resource}"`, { cause });
+		this.resource = resource;
+		this.name = "ResourceModuleLoadError";
+	}
+};
+/** Wraps an exception thrown while rendering a named resource state. */
+var ResourceRenderError = class extends Error {
+	resource;
+	state;
+	code = "resourceRender";
+	constructor(resource, state, cause) {
+		super(`Unable to render resource "${resource}" state "${state}"`, { cause });
+		this.resource = resource;
+		this.state = state;
+		this.name = "ResourceRenderError";
+	}
+};
+
+//#endregion
+exports.ResourceModuleLoadError = ResourceModuleLoadError;
+exports.ResourceRenderError = ResourceRenderError;
+//# sourceMappingURL=resource-state-error.cjs.map

package/dist/errors/resource-state-error.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-state-error.cjs","names":[],"sources":["../../src/errors/resource-state-error.ts"],"sourcesContent":["/** Identifies a failed dynamic import for a resource layout or render state. */\nexport class ResourceModuleLoadError extends Error {\n  readonly code = 'resourceModuleLoad';\n\n  constructor(\n    readonly resource: string,\n    cause: unknown,\n  ) {\n    super(`Unable to load resource module \"${resource}\"`, { cause });\n    this.name = 'ResourceModuleLoadError';\n  }\n}\n\n/** Wraps an exception thrown while rendering a named resource state. */\nexport class ResourceRenderError extends Error {\n  readonly code = 'resourceRender';\n\n  constructor(\n    readonly resource: string,\n    readonly state: string,\n    cause: unknown,\n  ) {\n    super(`Unable to render resource \"${resource}\" state \"${state}\"`, {\n      cause,\n    });\n    this.name = 'ResourceRenderError';\n  }\n}\n\n/** Library errors that can trigger a configured resource `Error` state. */\nexport type ResourceStateError =\n  | ResourceModuleLoadError\n  | ResourceRenderError;\n"],"mappings":";;;AACA,IAAa,0BAAb,cAA6C,MAAM;CAItC;CAHX,AAAS,OAAO;CAEhB,YACE,AAAS,UACT,OACA;EACA,MAAM,mCAAmC,SAAS,IAAI,EAAE,MAAM,CAAC;EAHtD;EAIT,KAAK,OAAO;CACd;AACF;;AAGA,IAAa,sBAAb,cAAyC,MAAM;CAIlC;CACA;CAJX,AAAS,OAAO;CAEhB,YACE,AAAS,UACT,AAAS,OACT,OACA;EACA,MAAM,8BAA8B,SAAS,WAAW,MAAM,IAAI,EAChE,MACF,CAAC;EANQ;EACA;EAMT,KAAK,OAAO;CACd;AACF"}

package/dist/errors/resource-state-error.d.cts

@@ -0,0 +1,19 @@
+//#region src/errors/resource-state-error.d.ts
+/** Identifies a failed dynamic import for a resource layout or render state. */
+declare class ResourceModuleLoadError extends Error {
+  readonly resource: string;
+  readonly code = "resourceModuleLoad";
+  constructor(resource: string, cause: unknown);
+}
+/** Wraps an exception thrown while rendering a named resource state. */
+declare class ResourceRenderError extends Error {
+  readonly resource: string;
+  readonly state: string;
+  readonly code = "resourceRender";
+  constructor(resource: string, state: string, cause: unknown);
+}
+/** Library errors that can trigger a configured resource `Error` state. */
+type ResourceStateError = ResourceModuleLoadError | ResourceRenderError;
+//#endregion
+export { ResourceModuleLoadError, ResourceRenderError, ResourceStateError };
+//# sourceMappingURL=resource-state-error.d.cts.map

package/dist/errors/resource-state-error.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-state-error.d.cts","names":[],"sources":["../../src/errors/resource-state-error.ts"],"mappings":";;cACa,uBAAA,SAAgC,KAAK;EAAA,SAIrC,QAAA;EAAA,SAHF,IAAA;cAGE,QAAA,UACT,KAAA;AAAA;;cAQS,mBAAA,SAA4B,KAAK;EAAA,SAIjC,QAAA;EAAA,SACA,KAAA;EAAA,SAJF,IAAA;cAGE,QAAA,UACA,KAAA,UACT,KAAA;AAAA;AANJ;AAAA,KAgBY,kBAAA,GACR,uBAAA,GACA,mBAAmB"}

package/dist/errors/resource-state-error.d.mts

@@ -0,0 +1,19 @@
+//#region src/errors/resource-state-error.d.ts
+/** Identifies a failed dynamic import for a resource layout or render state. */
+declare class ResourceModuleLoadError extends Error {
+  readonly resource: string;
+  readonly code = "resourceModuleLoad";
+  constructor(resource: string, cause: unknown);
+}
+/** Wraps an exception thrown while rendering a named resource state. */
+declare class ResourceRenderError extends Error {
+  readonly resource: string;
+  readonly state: string;
+  readonly code = "resourceRender";
+  constructor(resource: string, state: string, cause: unknown);
+}
+/** Library errors that can trigger a configured resource `Error` state. */
+type ResourceStateError = ResourceModuleLoadError | ResourceRenderError;
+//#endregion
+export { ResourceModuleLoadError, ResourceRenderError, ResourceStateError };
+//# sourceMappingURL=resource-state-error.d.mts.map

package/dist/errors/resource-state-error.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-state-error.d.mts","names":[],"sources":["../../src/errors/resource-state-error.ts"],"mappings":";;cACa,uBAAA,SAAgC,KAAK;EAAA,SAIrC,QAAA;EAAA,SAHF,IAAA;cAGE,QAAA,UACT,KAAA;AAAA;;cAQS,mBAAA,SAA4B,KAAK;EAAA,SAIjC,QAAA;EAAA,SACA,KAAA;EAAA,SAJF,IAAA;cAGE,QAAA,UACA,KAAA,UACT,KAAA;AAAA;AANJ;AAAA,KAgBY,kBAAA,GACR,uBAAA,GACA,mBAAmB"}

package/dist/errors/resource-state-error.mjs

@@ -0,0 +1,27 @@
+//#region src/errors/resource-state-error.ts
+/** Identifies a failed dynamic import for a resource layout or render state. */
+var ResourceModuleLoadError = class extends Error {
+	resource;
+	code = "resourceModuleLoad";
+	constructor(resource, cause) {
+		super(`Unable to load resource module "${resource}"`, { cause });
+		this.resource = resource;
+		this.name = "ResourceModuleLoadError";
+	}
+};
+/** Wraps an exception thrown while rendering a named resource state. */
+var ResourceRenderError = class extends Error {
+	resource;
+	state;
+	code = "resourceRender";
+	constructor(resource, state, cause) {
+		super(`Unable to render resource "${resource}" state "${state}"`, { cause });
+		this.resource = resource;
+		this.state = state;
+		this.name = "ResourceRenderError";
+	}
+};
+
+//#endregion
+export { ResourceModuleLoadError, ResourceRenderError };
+//# sourceMappingURL=resource-state-error.mjs.map

package/dist/errors/resource-state-error.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-state-error.mjs","names":[],"sources":["../../src/errors/resource-state-error.ts"],"sourcesContent":["/** Identifies a failed dynamic import for a resource layout or render state. */\nexport class ResourceModuleLoadError extends Error {\n  readonly code = 'resourceModuleLoad';\n\n  constructor(\n    readonly resource: string,\n    cause: unknown,\n  ) {\n    super(`Unable to load resource module \"${resource}\"`, { cause });\n    this.name = 'ResourceModuleLoadError';\n  }\n}\n\n/** Wraps an exception thrown while rendering a named resource state. */\nexport class ResourceRenderError extends Error {\n  readonly code = 'resourceRender';\n\n  constructor(\n    readonly resource: string,\n    readonly state: string,\n    cause: unknown,\n  ) {\n    super(`Unable to render resource \"${resource}\" state \"${state}\"`, {\n      cause,\n    });\n    this.name = 'ResourceRenderError';\n  }\n}\n\n/** Library errors that can trigger a configured resource `Error` state. */\nexport type ResourceStateError =\n  | ResourceModuleLoadError\n  | ResourceRenderError;\n"],"mappings":";;AACA,IAAa,0BAAb,cAA6C,MAAM;CAItC;CAHX,AAAS,OAAO;CAEhB,YACE,AAAS,UACT,OACA;EACA,MAAM,mCAAmC,SAAS,IAAI,EAAE,MAAM,CAAC;EAHtD;EAIT,KAAK,OAAO;CACd;AACF;;AAGA,IAAa,sBAAb,cAAyC,MAAM;CAIlC;CACA;CAJX,AAAS,OAAO;CAEhB,YACE,AAAS,UACT,AAAS,OACT,OACA;EACA,MAAM,8BAA8B,SAAS,WAAW,MAAM,IAAI,EAChE,MACF,CAAC;EANQ;EACA;EAMT,KAAK,OAAO;CACd;AACF"}

package/dist/index.cjs

@@ -8,9 +8,11 @@ const require_invalid_component = require('./errors/invalid-component.cjs');
 const require_missing_path_variable = require('./errors/missing-path-variable.cjs');
 const require_missing_resource_provider = require('./errors/missing-resource-provider.cjs');
 const require_layout_configuration_error = require('./errors/layout-configuration-error.cjs');
+const require_resource_state_error = require('./errors/resource-state-error.cjs');
 const require_resource = require('./resource.cjs');
 const require_utils = require('./utils.cjs');
 const require_define_layout = require('./create-config/define-layout.cjs');
+const require_create_defined_resource_layout = require('./create-config/create-defined-resource-layout.cjs');
 let _jfdevelops_react_layout_composables = require("@jfdevelops/react-layout-composables");
 let _jfdevelops_react_layout_validator = require("@jfdevelops/react-layout-validator");
 
@@ -35,6 +37,8 @@ Object.defineProperty(exports, 'PropError', {
   }
 });
 exports.ReactLayoutError = require_react_layout_error.ReactLayoutError;
+exports.ResourceModuleLoadError = require_resource_state_error.ResourceModuleLoadError;
+exports.ResourceRenderError = require_resource_state_error.ResourceRenderError;
 Object.defineProperty(exports, 'collectComposablePresetEntries', {
   enumerable: true,
   get: function () {
@@ -47,6 +51,7 @@ Object.defineProperty(exports, 'createComposableComponent', {
     return _jfdevelops_react_layout_composables.createComposableComponent;
   }
 });
+exports.createDefinedResourceLayout = require_create_defined_resource_layout.createDefinedResourceLayout;
 Object.defineProperty(exports, 'createLayoutComposableFactory', {
   enumerable: true,
   get: function () {

package/dist/index.d.cts

@@ -1,13 +1,16 @@
 import { BaseComponent, MergeIntersection, Show, UnionToIntersection, pick } from "./utils.cjs";
-import { LayoutResourceKey, NormalizeResource, NormalizeResources, ResourceDefinition, ResourceDefinitionValue, ResourceEnum, ResourceLayoutComponentProps, ResourceTree, normalizeResource, normalizeResources, toResourceEnum } from "./resource.cjs";
-import { InPropsDefinition, InPropsFunction, InPropsObject, InPropsOptions, IncludedPropBehavior, IncludedProps, InferredInProps, LayoutRenderProps, MergedLayoutInProps, PropsContextRender, PropsRenderDefinition, ResolvedIncludedComponentProps, ResolvedIncludedConfigProps, ResolvedIncludedProps, ResolvedIncludedPropsAsDefined } from "./props.cjs";
+import { LayoutResourceKey, NormalizeResource, NormalizeResources, ResourceDefinition, ResourceDefinitionValue, ResourceEnum, ResourceLayoutComponentProps, ResourcePath, ResourceTree, normalizeResource, normalizeResources, toResourceEnum } from "./resource.cjs";
+import { InPropsDefinition, InPropsFunction, InPropsObject, InPropsOptions, IncludedComponentPropDefinitions, IncludedPropBehavior, IncludedProps, InferredInProps, LayoutRenderProps, MergedLayoutInProps, PropsContextRender, PropsRenderDefinition, ResolvedIncludedComponentProps, ResolvedIncludedConfigProps, ResolvedIncludedProps, ResolvedIncludedPropsAsDefined } from "./props.cjs";
+import { AnyRenderStateDefinition, CreateLayoutBuildingBlocks, CreateLayoutBuildingBlocksArguments, CreateLayoutBuildingBlocksResult, CreateRenderState, CreateRenderStateBuilderArguments, CreateRenderStateBuilderResult, DeferredRenderState, DefineLayoutComposables, LayoutComposablesDefinition, LazyRenderState, RenderStateCallback, RenderStateComposablesDefinition, RenderStateContext, RenderStateFragment, RenderStateProps } from "./create-config/render-state.cjs";
 import { ParameterizedResourcePath, PathVariables } from "./create-config/paths/types.cjs";
 import { CreateGetComponentForPath, GetComponentForPath, ResolvedPathValue } from "./create-config/for-paths/get-component-for-path.cjs";
 import { ForPaths, ForPathsRenderContext, RenderedPathComponent, RenderedPathComponentHOF, TargetPathBuilder } from "./create-config/for-paths/builder.cjs";
 import { IsSubResourceKey } from "./create-config/is-sub-resource-key.cjs";
 import { ComponentTypes, CreatedResourceConfig } from "./create-config/get-component.cjs";
 import { CreateResourceMap, CreateResourceMapFn } from "./create-config/create-resource-links.cjs";
-import { CreateResourceLayoutWithLayoutOptions, DefineResourceLayoutWithLayoutFn, DefineResourcesFn, DefinedResourceLayoutWithShell, LayoutRenderResourcesAccessor, LayoutResourcesAccessor, ResourceLayoutProvider, ResourceLayoutProviderProps, ResourceLayoutShellComponent, ResourceLayoutShellProps, ResourceSelection, ShellLayoutDefinition, ShellRenderContext, defineResourceLayout } from "./create-config/define-layout.cjs";
+import { ContextualInlineRenderState, ContextualInlineRenderStates, CreateResourceLayoutWithLayoutOptions, CreateViewMapBuiltInRenderStatesOptions, CreateViewMapFunctionRenderOptions, CreateViewMapInlineRenderStatesOptions, CreateViewMapRenderStatesOptions, DefineResourceLayoutWithLayoutFn, DefineResourcesFn, DefinedResourceLayoutWithShell, LayoutRenderResourcesAccessor, LayoutResourcesAccessor, ResourceLayoutProvider, ResourceLayoutProviderProps, ResourceLayoutShellComponent, ResourceLayoutShellProps, ResourceSelection, ShellLayoutDefinition, ShellRenderContext, TypedBuiltInRenderStates, TypedInlineRenderState, defineResourceLayout } from "./create-config/define-layout.cjs";
+import { LazyResourceErrorComponent, LazyResourceLayoutComponent, LazyResourceLayoutOptions, LazyResourceLoadingComponent, LazyResourceStates } from "./create-config/lazy-resource-layout.cjs";
+import { BoundDefineResourceLayout, CreateDefinedResourceLayoutResult, DefineLazyDefaults, DefineOptions, DefinedResourceLayoutBuilder, DefinedResourceLayoutInput, NonEmptyResources, createDefinedResourceLayout } from "./create-config/create-defined-resource-layout.cjs";
 import { ResourceLayoutShellPublisher } from "./create-config/shell-context.cjs";
 import { ReactLayoutError } from "./errors/react-layout-error.cjs";
 import { InvalidConfigContext, InvalidConfigError } from "./errors/invalid-config.cjs";
@@ -18,6 +21,7 @@ import { InvalidComponentContext, InvalidComponentError } from "./errors/invalid
 import { MissingPathVariableContext, MissingPathVariableError } from "./errors/missing-path-variable.cjs";
 import { MissingResourceProviderError } from "./errors/missing-resource-provider.cjs";
 import { LayoutConfigurationError, LayoutConfigurationErrorContext } from "./errors/layout-configuration-error.cjs";
+import { ResourceModuleLoadError, ResourceRenderError, ResourceStateError } from "./errors/resource-state-error.cjs";
 import { AnyComposableComponent, ComposableComponent, ComposableComponentCallable, ComposableComponents, ComposableNameContext, ComposablePresetComponent, ComposablePresetComponentCallProps, ComposablePresetMeta, ComposablePresetProps, ComposableResourceLayout, CreateLayoutComposable, DefinedComposableComponentRecord, LayoutComposablePresetProvider, LayoutComposablesFactory, MakeComposable, MakeComposableOptions, MergePresetProps, PresetPropsFromComposable, RequiredPresetLayoutProps, RequiredPresetRenderProps, ResolveLayoutComposables, collectComposablePresetEntries, createComposableComponent, createLayoutComposableFactory, defineComposableComponent, makeComposable, resolveComposablePresetProps, resolveLayoutComposables } from "@jfdevelops/react-layout-composables";
 import { AnyBuiltPropDefinition, ExtractDefinitionValue, PropError, PropErrorOptions, ResolveLayoutProps, ResolveLayoutPropsAsDefined, ResolveProps, ResolvedBuiltPropShape, createPrimitivePropBuilder, createProp, isPropDefinitionShape, resolvePropDefinitionValues, validateProps } from "@jfdevelops/react-layout-validator";
-export { type AnyBuiltPropDefinition, type AnyComposableComponent, type BaseComponent, type ComponentTypes, type ComposableComponent, type ComposableComponentCallable, type ComposableComponents, type ComposableNameContext, type ComposablePresetComponent, type ComposablePresetComponentCallProps, type ComposablePresetMeta, type ComposablePresetProps, type ComposableResourceLayout, type CreateGetComponentForPath, type CreateLayoutComposable, type CreateResourceLayoutWithLayoutOptions, type CreateResourceMap, type CreateResourceMapFn, type CreatedResourceConfig, type DefineResourceLayoutWithLayoutFn, type DefineResourcesFn, type DefinedComposableComponentRecord, type DefinedResourceLayoutWithShell, type ExtractDefinitionValue, type ForPaths, type ForPathsRenderContext, type GetComponentForPath, type InPropsDefinition, type InPropsFunction, type InPropsObject, type InPropsOptions, type IncludedPropBehavior, type IncludedProps, type InferredInProps, type InvalidComponentContext, InvalidComponentError, type InvalidConfigContext, InvalidConfigError, type InvalidPathContext, InvalidPathError, type InvalidResourceContext, InvalidResourceError, type InvalidSubResourceContext, InvalidSubResourceError, type IsSubResourceKey, LayoutComposablePresetProvider, type LayoutComposablesFactory, LayoutConfigurationError, type LayoutConfigurationErrorContext, type LayoutRenderProps, type LayoutRenderResourcesAccessor, type LayoutResourceKey, type LayoutResourcesAccessor, type MakeComposable, type MakeComposableOptions, type MergeIntersection, type MergePresetProps, type MergedLayoutInProps, type MissingPathVariableContext, MissingPathVariableError, MissingResourceProviderError, type NormalizeResource, type NormalizeResources, type ParameterizedResourcePath, type PathVariables, type PresetPropsFromComposable, PropError, type PropErrorOptions, type PropsContextRender, type PropsRenderDefinition, ReactLayoutError, type RenderedPathComponent, type RenderedPathComponentHOF, type RequiredPresetLayoutProps, type RequiredPresetRenderProps, type ResolveLayoutComposables, type ResolveLayoutProps, type ResolveLayoutPropsAsDefined, type ResolveProps, type ResolvedBuiltPropShape, type ResolvedIncludedComponentProps, type ResolvedIncludedConfigProps, type ResolvedIncludedProps, type ResolvedIncludedPropsAsDefined, type ResolvedPathValue, type ResourceDefinition, type ResourceDefinitionValue, type ResourceEnum, type ResourceLayoutComponentProps, type ResourceLayoutProvider, type ResourceLayoutProviderProps, type ResourceLayoutShellComponent, type ResourceLayoutShellProps, type ResourceLayoutShellPublisher, type ResourceSelection, type ResourceTree, type ShellLayoutDefinition, type ShellRenderContext, type Show, type TargetPathBuilder, type UnionToIntersection, collectComposablePresetEntries, createComposableComponent, createLayoutComposableFactory, createPrimitivePropBuilder, createProp, defineComposableComponent, defineResourceLayout, isPropDefinitionShape, makeComposable, normalizeResource, normalizeResources, pick, resolveComposablePresetProps, resolveLayoutComposables, resolvePropDefinitionValues, toResourceEnum, validateProps };
+export { type AnyBuiltPropDefinition, type AnyComposableComponent, type AnyRenderStateDefinition, type BaseComponent, type BoundDefineResourceLayout, type ComponentTypes, type ComposableComponent, type ComposableComponentCallable, type ComposableComponents, type ComposableNameContext, type ComposablePresetComponent, type ComposablePresetComponentCallProps, type ComposablePresetMeta, type ComposablePresetProps, type ComposableResourceLayout, type ContextualInlineRenderState, type ContextualInlineRenderStates, type CreateDefinedResourceLayoutResult, type CreateGetComponentForPath, type CreateLayoutBuildingBlocks, type CreateLayoutBuildingBlocksArguments, type CreateLayoutBuildingBlocksResult, type CreateLayoutComposable, type CreateRenderState, type CreateRenderStateBuilderArguments, type CreateRenderStateBuilderResult, type CreateResourceLayoutWithLayoutOptions, type CreateResourceMap, type CreateResourceMapFn, type CreateViewMapBuiltInRenderStatesOptions, type CreateViewMapFunctionRenderOptions, type CreateViewMapInlineRenderStatesOptions, type CreateViewMapRenderStatesOptions, type CreatedResourceConfig, type DeferredRenderState, type DefineLayoutComposables, type DefineLazyDefaults, type DefineOptions, type DefineResourceLayoutWithLayoutFn, type DefineResourcesFn, type DefinedComposableComponentRecord, type DefinedResourceLayoutBuilder, type DefinedResourceLayoutInput, type DefinedResourceLayoutWithShell, type ExtractDefinitionValue, type ForPaths, type ForPathsRenderContext, type GetComponentForPath, type InPropsDefinition, type InPropsFunction, type InPropsObject, type InPropsOptions, type IncludedComponentPropDefinitions, type IncludedPropBehavior, type IncludedProps, type InferredInProps, type InvalidComponentContext, InvalidComponentError, type InvalidConfigContext, InvalidConfigError, type InvalidPathContext, InvalidPathError, type InvalidResourceContext, InvalidResourceError, type InvalidSubResourceContext, InvalidSubResourceError, type IsSubResourceKey, LayoutComposablePresetProvider, type LayoutComposablesDefinition, type LayoutComposablesFactory, LayoutConfigurationError, type LayoutConfigurationErrorContext, type LayoutRenderProps, type LayoutRenderResourcesAccessor, type LayoutResourceKey, type LayoutResourcesAccessor, type LazyRenderState, type LazyResourceErrorComponent, type LazyResourceLayoutComponent, type LazyResourceLayoutOptions, type LazyResourceLoadingComponent, type LazyResourceStates, type MakeComposable, type MakeComposableOptions, type MergeIntersection, type MergePresetProps, type MergedLayoutInProps, type MissingPathVariableContext, MissingPathVariableError, MissingResourceProviderError, type NonEmptyResources, type NormalizeResource, type NormalizeResources, type ParameterizedResourcePath, type PathVariables, type PresetPropsFromComposable, PropError, type PropErrorOptions, type PropsContextRender, type PropsRenderDefinition, ReactLayoutError, type RenderStateCallback, type RenderStateComposablesDefinition, type RenderStateContext, type RenderStateFragment, type RenderStateProps, type RenderedPathComponent, type RenderedPathComponentHOF, type RequiredPresetLayoutProps, type RequiredPresetRenderProps, type ResolveLayoutComposables, type ResolveLayoutProps, type ResolveLayoutPropsAsDefined, type ResolveProps, type ResolvedBuiltPropShape, type ResolvedIncludedComponentProps, type ResolvedIncludedConfigProps, type ResolvedIncludedProps, type ResolvedIncludedPropsAsDefined, type ResolvedPathValue, type ResourceDefinition, type ResourceDefinitionValue, type ResourceEnum, type ResourceLayoutComponentProps, type ResourceLayoutProvider, type ResourceLayoutProviderProps, type ResourceLayoutShellComponent, type ResourceLayoutShellProps, type ResourceLayoutShellPublisher, ResourceModuleLoadError, type ResourcePath, ResourceRenderError, type ResourceSelection, type ResourceStateError, type ResourceTree, type ShellLayoutDefinition, type ShellRenderContext, type Show, type TargetPathBuilder, type TypedBuiltInRenderStates, type TypedInlineRenderState, type UnionToIntersection, collectComposablePresetEntries, createComposableComponent, createDefinedResourceLayout, createLayoutComposableFactory, createPrimitivePropBuilder, createProp, defineComposableComponent, defineResourceLayout, isPropDefinitionShape, makeComposable, normalizeResource, normalizeResources, pick, resolveComposablePresetProps, resolveLayoutComposables, resolvePropDefinitionValues, toResourceEnum, validateProps };

package/dist/index.d.mts

@@ -1,13 +1,16 @@
 import { BaseComponent, MergeIntersection, Show, UnionToIntersection, pick } from "./utils.mjs";
-import { LayoutResourceKey, NormalizeResource, NormalizeResources, ResourceDefinition, ResourceDefinitionValue, ResourceEnum, ResourceLayoutComponentProps, ResourceTree, normalizeResource, normalizeResources, toResourceEnum } from "./resource.mjs";
-import { InPropsDefinition, InPropsFunction, InPropsObject, InPropsOptions, IncludedPropBehavior, IncludedProps, InferredInProps, LayoutRenderProps, MergedLayoutInProps, PropsContextRender, PropsRenderDefinition, ResolvedIncludedComponentProps, ResolvedIncludedConfigProps, ResolvedIncludedProps, ResolvedIncludedPropsAsDefined } from "./props.mjs";
+import { LayoutResourceKey, NormalizeResource, NormalizeResources, ResourceDefinition, ResourceDefinitionValue, ResourceEnum, ResourceLayoutComponentProps, ResourcePath, ResourceTree, normalizeResource, normalizeResources, toResourceEnum } from "./resource.mjs";
+import { InPropsDefinition, InPropsFunction, InPropsObject, InPropsOptions, IncludedComponentPropDefinitions, IncludedPropBehavior, IncludedProps, InferredInProps, LayoutRenderProps, MergedLayoutInProps, PropsContextRender, PropsRenderDefinition, ResolvedIncludedComponentProps, ResolvedIncludedConfigProps, ResolvedIncludedProps, ResolvedIncludedPropsAsDefined } from "./props.mjs";
+import { AnyRenderStateDefinition, CreateLayoutBuildingBlocks, CreateLayoutBuildingBlocksArguments, CreateLayoutBuildingBlocksResult, CreateRenderState, CreateRenderStateBuilderArguments, CreateRenderStateBuilderResult, DeferredRenderState, DefineLayoutComposables, LayoutComposablesDefinition, LazyRenderState, RenderStateCallback, RenderStateComposablesDefinition, RenderStateContext, RenderStateFragment, RenderStateProps } from "./create-config/render-state.mjs";
 import { ParameterizedResourcePath, PathVariables } from "./create-config/paths/types.mjs";
 import { CreateGetComponentForPath, GetComponentForPath, ResolvedPathValue } from "./create-config/for-paths/get-component-for-path.mjs";
 import { ForPaths, ForPathsRenderContext, RenderedPathComponent, RenderedPathComponentHOF, TargetPathBuilder } from "./create-config/for-paths/builder.mjs";
 import { IsSubResourceKey } from "./create-config/is-sub-resource-key.mjs";
 import { ComponentTypes, CreatedResourceConfig } from "./create-config/get-component.mjs";
 import { CreateResourceMap, CreateResourceMapFn } from "./create-config/create-resource-links.mjs";
-import { CreateResourceLayoutWithLayoutOptions, DefineResourceLayoutWithLayoutFn, DefineResourcesFn, DefinedResourceLayoutWithShell, LayoutRenderResourcesAccessor, LayoutResourcesAccessor, ResourceLayoutProvider, ResourceLayoutProviderProps, ResourceLayoutShellComponent, ResourceLayoutShellProps, ResourceSelection, ShellLayoutDefinition, ShellRenderContext, defineResourceLayout } from "./create-config/define-layout.mjs";
+import { ContextualInlineRenderState, ContextualInlineRenderStates, CreateResourceLayoutWithLayoutOptions, CreateViewMapBuiltInRenderStatesOptions, CreateViewMapFunctionRenderOptions, CreateViewMapInlineRenderStatesOptions, CreateViewMapRenderStatesOptions, DefineResourceLayoutWithLayoutFn, DefineResourcesFn, DefinedResourceLayoutWithShell, LayoutRenderResourcesAccessor, LayoutResourcesAccessor, ResourceLayoutProvider, ResourceLayoutProviderProps, ResourceLayoutShellComponent, ResourceLayoutShellProps, ResourceSelection, ShellLayoutDefinition, ShellRenderContext, TypedBuiltInRenderStates, TypedInlineRenderState, defineResourceLayout } from "./create-config/define-layout.mjs";
+import { LazyResourceErrorComponent, LazyResourceLayoutComponent, LazyResourceLayoutOptions, LazyResourceLoadingComponent, LazyResourceStates } from "./create-config/lazy-resource-layout.mjs";
+import { BoundDefineResourceLayout, CreateDefinedResourceLayoutResult, DefineLazyDefaults, DefineOptions, DefinedResourceLayoutBuilder, DefinedResourceLayoutInput, NonEmptyResources, createDefinedResourceLayout } from "./create-config/create-defined-resource-layout.mjs";
 import { ResourceLayoutShellPublisher } from "./create-config/shell-context.mjs";
 import { ReactLayoutError } from "./errors/react-layout-error.mjs";
 import { InvalidConfigContext, InvalidConfigError } from "./errors/invalid-config.mjs";
@@ -18,6 +21,7 @@ import { InvalidComponentContext, InvalidComponentError } from "./errors/invalid
 import { MissingPathVariableContext, MissingPathVariableError } from "./errors/missing-path-variable.mjs";
 import { MissingResourceProviderError } from "./errors/missing-resource-provider.mjs";
 import { LayoutConfigurationError, LayoutConfigurationErrorContext } from "./errors/layout-configuration-error.mjs";
+import { ResourceModuleLoadError, ResourceRenderError, ResourceStateError } from "./errors/resource-state-error.mjs";
 import { AnyComposableComponent, ComposableComponent, ComposableComponentCallable, ComposableComponents, ComposableNameContext, ComposablePresetComponent, ComposablePresetComponentCallProps, ComposablePresetMeta, ComposablePresetProps, ComposableResourceLayout, CreateLayoutComposable, DefinedComposableComponentRecord, LayoutComposablePresetProvider, LayoutComposablesFactory, MakeComposable, MakeComposableOptions, MergePresetProps, PresetPropsFromComposable, RequiredPresetLayoutProps, RequiredPresetRenderProps, ResolveLayoutComposables, collectComposablePresetEntries, createComposableComponent, createLayoutComposableFactory, defineComposableComponent, makeComposable, resolveComposablePresetProps, resolveLayoutComposables } from "@jfdevelops/react-layout-composables";
 import { AnyBuiltPropDefinition, ExtractDefinitionValue, PropError, PropErrorOptions, ResolveLayoutProps, ResolveLayoutPropsAsDefined, ResolveProps, ResolvedBuiltPropShape, createPrimitivePropBuilder, createProp, isPropDefinitionShape, resolvePropDefinitionValues, validateProps } from "@jfdevelops/react-layout-validator";
-export { type AnyBuiltPropDefinition, type AnyComposableComponent, type BaseComponent, type ComponentTypes, type ComposableComponent, type ComposableComponentCallable, type ComposableComponents, type ComposableNameContext, type ComposablePresetComponent, type ComposablePresetComponentCallProps, type ComposablePresetMeta, type ComposablePresetProps, type ComposableResourceLayout, type CreateGetComponentForPath, type CreateLayoutComposable, type CreateResourceLayoutWithLayoutOptions, type CreateResourceMap, type CreateResourceMapFn, type CreatedResourceConfig, type DefineResourceLayoutWithLayoutFn, type DefineResourcesFn, type DefinedComposableComponentRecord, type DefinedResourceLayoutWithShell, type ExtractDefinitionValue, type ForPaths, type ForPathsRenderContext, type GetComponentForPath, type InPropsDefinition, type InPropsFunction, type InPropsObject, type InPropsOptions, type IncludedPropBehavior, type IncludedProps, type InferredInProps, type InvalidComponentContext, InvalidComponentError, type InvalidConfigContext, InvalidConfigError, type InvalidPathContext, InvalidPathError, type InvalidResourceContext, InvalidResourceError, type InvalidSubResourceContext, InvalidSubResourceError, type IsSubResourceKey, LayoutComposablePresetProvider, type LayoutComposablesFactory, LayoutConfigurationError, type LayoutConfigurationErrorContext, type LayoutRenderProps, type LayoutRenderResourcesAccessor, type LayoutResourceKey, type LayoutResourcesAccessor, type MakeComposable, type MakeComposableOptions, type MergeIntersection, type MergePresetProps, type MergedLayoutInProps, type MissingPathVariableContext, MissingPathVariableError, MissingResourceProviderError, type NormalizeResource, type NormalizeResources, type ParameterizedResourcePath, type PathVariables, type PresetPropsFromComposable, PropError, type PropErrorOptions, type PropsContextRender, type PropsRenderDefinition, ReactLayoutError, type RenderedPathComponent, type RenderedPathComponentHOF, type RequiredPresetLayoutProps, type RequiredPresetRenderProps, type ResolveLayoutComposables, type ResolveLayoutProps, type ResolveLayoutPropsAsDefined, type ResolveProps, type ResolvedBuiltPropShape, type ResolvedIncludedComponentProps, type ResolvedIncludedConfigProps, type ResolvedIncludedProps, type ResolvedIncludedPropsAsDefined, type ResolvedPathValue, type ResourceDefinition, type ResourceDefinitionValue, type ResourceEnum, type ResourceLayoutComponentProps, type ResourceLayoutProvider, type ResourceLayoutProviderProps, type ResourceLayoutShellComponent, type ResourceLayoutShellProps, type ResourceLayoutShellPublisher, type ResourceSelection, type ResourceTree, type ShellLayoutDefinition, type ShellRenderContext, type Show, type TargetPathBuilder, type UnionToIntersection, collectComposablePresetEntries, createComposableComponent, createLayoutComposableFactory, createPrimitivePropBuilder, createProp, defineComposableComponent, defineResourceLayout, isPropDefinitionShape, makeComposable, normalizeResource, normalizeResources, pick, resolveComposablePresetProps, resolveLayoutComposables, resolvePropDefinitionValues, toResourceEnum, validateProps };
+export { type AnyBuiltPropDefinition, type AnyComposableComponent, type AnyRenderStateDefinition, type BaseComponent, type BoundDefineResourceLayout, type ComponentTypes, type ComposableComponent, type ComposableComponentCallable, type ComposableComponents, type ComposableNameContext, type ComposablePresetComponent, type ComposablePresetComponentCallProps, type ComposablePresetMeta, type ComposablePresetProps, type ComposableResourceLayout, type ContextualInlineRenderState, type ContextualInlineRenderStates, type CreateDefinedResourceLayoutResult, type CreateGetComponentForPath, type CreateLayoutBuildingBlocks, type CreateLayoutBuildingBlocksArguments, type CreateLayoutBuildingBlocksResult, type CreateLayoutComposable, type CreateRenderState, type CreateRenderStateBuilderArguments, type CreateRenderStateBuilderResult, type CreateResourceLayoutWithLayoutOptions, type CreateResourceMap, type CreateResourceMapFn, type CreateViewMapBuiltInRenderStatesOptions, type CreateViewMapFunctionRenderOptions, type CreateViewMapInlineRenderStatesOptions, type CreateViewMapRenderStatesOptions, type CreatedResourceConfig, type DeferredRenderState, type DefineLayoutComposables, type DefineLazyDefaults, type DefineOptions, type DefineResourceLayoutWithLayoutFn, type DefineResourcesFn, type DefinedComposableComponentRecord, type DefinedResourceLayoutBuilder, type DefinedResourceLayoutInput, type DefinedResourceLayoutWithShell, type ExtractDefinitionValue, type ForPaths, type ForPathsRenderContext, type GetComponentForPath, type InPropsDefinition, type InPropsFunction, type InPropsObject, type InPropsOptions, type IncludedComponentPropDefinitions, type IncludedPropBehavior, type IncludedProps, type InferredInProps, type InvalidComponentContext, InvalidComponentError, type InvalidConfigContext, InvalidConfigError, type InvalidPathContext, InvalidPathError, type InvalidResourceContext, InvalidResourceError, type InvalidSubResourceContext, InvalidSubResourceError, type IsSubResourceKey, LayoutComposablePresetProvider, type LayoutComposablesDefinition, type LayoutComposablesFactory, LayoutConfigurationError, type LayoutConfigurationErrorContext, type LayoutRenderProps, type LayoutRenderResourcesAccessor, type LayoutResourceKey, type LayoutResourcesAccessor, type LazyRenderState, type LazyResourceErrorComponent, type LazyResourceLayoutComponent, type LazyResourceLayoutOptions, type LazyResourceLoadingComponent, type LazyResourceStates, type MakeComposable, type MakeComposableOptions, type MergeIntersection, type MergePresetProps, type MergedLayoutInProps, type MissingPathVariableContext, MissingPathVariableError, MissingResourceProviderError, type NonEmptyResources, type NormalizeResource, type NormalizeResources, type ParameterizedResourcePath, type PathVariables, type PresetPropsFromComposable, PropError, type PropErrorOptions, type PropsContextRender, type PropsRenderDefinition, ReactLayoutError, type RenderStateCallback, type RenderStateComposablesDefinition, type RenderStateContext, type RenderStateFragment, type RenderStateProps, type RenderedPathComponent, type RenderedPathComponentHOF, type RequiredPresetLayoutProps, type RequiredPresetRenderProps, type ResolveLayoutComposables, type ResolveLayoutProps, type ResolveLayoutPropsAsDefined, type ResolveProps, type ResolvedBuiltPropShape, type ResolvedIncludedComponentProps, type ResolvedIncludedConfigProps, type ResolvedIncludedProps, type ResolvedIncludedPropsAsDefined, type ResolvedPathValue, type ResourceDefinition, type ResourceDefinitionValue, type ResourceEnum, type ResourceLayoutComponentProps, type ResourceLayoutProvider, type ResourceLayoutProviderProps, type ResourceLayoutShellComponent, type ResourceLayoutShellProps, type ResourceLayoutShellPublisher, ResourceModuleLoadError, type ResourcePath, ResourceRenderError, type ResourceSelection, type ResourceStateError, type ResourceTree, type ShellLayoutDefinition, type ShellRenderContext, type Show, type TargetPathBuilder, type TypedBuiltInRenderStates, type TypedInlineRenderState, type UnionToIntersection, collectComposablePresetEntries, createComposableComponent, createDefinedResourceLayout, createLayoutComposableFactory, createPrimitivePropBuilder, createProp, defineComposableComponent, defineResourceLayout, isPropDefinitionShape, makeComposable, normalizeResource, normalizeResources, pick, resolveComposablePresetProps, resolveLayoutComposables, resolvePropDefinitionValues, toResourceEnum, validateProps };

package/dist/index.mjs

@@ -7,10 +7,12 @@ import { InvalidComponentError } from "./errors/invalid-component.mjs";
 import { MissingPathVariableError } from "./errors/missing-path-variable.mjs";
 import { MissingResourceProviderError } from "./errors/missing-resource-provider.mjs";
 import { LayoutConfigurationError } from "./errors/layout-configuration-error.mjs";
+import { ResourceModuleLoadError, ResourceRenderError } from "./errors/resource-state-error.mjs";
 import { normalizeResource, normalizeResources, toResourceEnum } from "./resource.mjs";
 import { pick } from "./utils.mjs";
 import { defineResourceLayout } from "./create-config/define-layout.mjs";
+import { createDefinedResourceLayout } from "./create-config/create-defined-resource-layout.mjs";
 import { LayoutComposablePresetProvider, collectComposablePresetEntries, createComposableComponent, createLayoutComposableFactory, defineComposableComponent, makeComposable, resolveComposablePresetProps, resolveLayoutComposables } from "@jfdevelops/react-layout-composables";
 import { PropError, createPrimitivePropBuilder, createProp, isPropDefinitionShape, resolvePropDefinitionValues, validateProps } from "@jfdevelops/react-layout-validator";
 
-export { InvalidComponentError, InvalidConfigError, InvalidPathError, InvalidResourceError, InvalidSubResourceError, LayoutComposablePresetProvider, LayoutConfigurationError, MissingPathVariableError, MissingResourceProviderError, PropError, ReactLayoutError, collectComposablePresetEntries, createComposableComponent, createLayoutComposableFactory, createPrimitivePropBuilder, createProp, defineComposableComponent, defineResourceLayout, isPropDefinitionShape, makeComposable, normalizeResource, normalizeResources, pick, resolveComposablePresetProps, resolveLayoutComposables, resolvePropDefinitionValues, toResourceEnum, validateProps };
+export { InvalidComponentError, InvalidConfigError, InvalidPathError, InvalidResourceError, InvalidSubResourceError, LayoutComposablePresetProvider, LayoutConfigurationError, MissingPathVariableError, MissingResourceProviderError, PropError, ReactLayoutError, ResourceModuleLoadError, ResourceRenderError, collectComposablePresetEntries, createComposableComponent, createDefinedResourceLayout, createLayoutComposableFactory, createPrimitivePropBuilder, createProp, defineComposableComponent, defineResourceLayout, isPropDefinitionShape, makeComposable, normalizeResource, normalizeResources, pick, resolveComposablePresetProps, resolveLayoutComposables, resolvePropDefinitionValues, toResourceEnum, validateProps };

package/dist/props.d.cts

@@ -55,6 +55,11 @@ type IncludedPropVisibility<Value> = Value extends IncludedPropBehavior ? Value[
 type IncludedPropPassthrough<Value> = Value extends IncludedPropBehavior ? Value['passthrough'] extends 'component' ? Value['visibility'] extends 'optional' ? 'component' | 'config' : 'component' : Value['passthrough'] : Value extends true | 'required' ? 'config' : Value extends 'optional' ? 'component' | 'config' : never;
 type GetPropsKey<IncludeProps extends object, Visibility extends InternalPropsType, Passthrough extends IncludedPropBehavior['passthrough'] | 'render' = 'render'> = { [Key in keyof IncludeProps]: IncludedPropVisibility<IncludeProps[Key]> extends Visibility ? Passthrough extends 'render' ? Key : Passthrough extends IncludedPropPassthrough<IncludeProps[Key]> ? Key : never : never }[keyof IncludeProps];
 type SelectedIncludedProps<Props extends InPropsObject, IncludeProps extends IncludedProps<Props>, Visibility extends InternalPropsType, Passthrough extends IncludedPropBehavior['passthrough'] | 'render' = 'render'> = Pick<Props, PropsKeys<Props, GetPropsKey<IncludeProps, Visibility, Passthrough>>>;
+type OptionalPropDefinition<Definition> = Definition extends {
+  optional(): infer OptionalDefinition;
+} ? OptionalDefinition : Definition;
+/** Raw validator definitions accepted by a generated component call. */
+type IncludedComponentPropDefinitions<Props extends InPropsObject, IncludeProps extends IncludedProps<Props>> = SelectedIncludedProps<Props, IncludeProps, 'required', 'component'> & { [Key in keyof SelectedIncludedProps<Props, IncludeProps, 'optional', 'component'>]: OptionalPropDefinition<SelectedIncludedProps<Props, IncludeProps, 'optional', 'component'>[Key]> };
 type ResolvedIncludedProps<Props extends InPropsObject, IncludeProps extends IncludedProps<Props>> = ResolveLayoutProps<SelectedIncludedProps<Props, IncludeProps, 'required'>> & Partial<ResolveLayoutProps<SelectedIncludedProps<Props, IncludeProps, 'optional'>>>;
 type ResolvedIncludedConfigProps<Props extends InPropsObject, IncludeProps extends IncludedProps<Props>> = ResolveLayoutProps<SelectedIncludedProps<Props, IncludeProps, 'required', 'config'>> & Partial<ResolveLayoutProps<SelectedIncludedProps<Props, IncludeProps, 'optional', 'config'>>>;
 type ResolvedIncludedComponentProps<Props extends InPropsObject, IncludeProps extends IncludedProps<Props>> = ResolveLayoutProps<SelectedIncludedProps<Props, IncludeProps, 'required', 'component'>> & Partial<ResolveLayoutProps<SelectedIncludedProps<Props, IncludeProps, 'optional', 'component'>>>;
@@ -65,5 +70,5 @@ type ResolvedIncludedComponentProps<Props extends InPropsObject, IncludeProps ex
 type ResolvedIncludedPropsAsDefined<Props extends InPropsObject, IncludeProps extends IncludedProps<Props>> = ResolveLayoutPropsAsDefined<SelectedIncludedProps<Props, IncludeProps, 'required'>> & Partial<ResolveLayoutPropsAsDefined<SelectedIncludedProps<Props, IncludeProps, 'optional'>>>;
 type LayoutRenderProps<Resources extends ReadonlyArray<ResourceDefinition>, Options extends InPropsDefinition<Resources>, Composables extends ComposableComponents = {}, IncludeProps extends IncludedProps<MergedLayoutInProps<Resources, Options, Composables>> = {}, CustomProps extends InPropsObject = {}> = Show<ResolveProps<CustomProps> & ResolvedIncludedProps<MergedLayoutInProps<Resources, Options, Composables>, IncludeProps>>;
 //#endregion
-export { InPropsDefinition, InPropsFunction, type InPropsObject, InPropsOptions, IncludedPropBehavior, IncludedProps, InferredInProps, LayoutRenderProps, MergedLayoutInProps, PropsContextRender, PropsRenderDefinition, ResolvedIncludedComponentProps, ResolvedIncludedConfigProps, ResolvedIncludedProps, ResolvedIncludedPropsAsDefined };
+export { InPropsDefinition, InPropsFunction, type InPropsObject, InPropsOptions, IncludedComponentPropDefinitions, IncludedPropBehavior, IncludedProps, InferredInProps, LayoutRenderProps, MergedLayoutInProps, PropsContextRender, PropsRenderDefinition, ResolvedIncludedComponentProps, ResolvedIncludedConfigProps, ResolvedIncludedProps, ResolvedIncludedPropsAsDefined };
 //# sourceMappingURL=props.d.cts.map

package/dist/props.d.cts.map

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

package/dist/props.d.mts

@@ -55,6 +55,11 @@ type IncludedPropVisibility<Value> = Value extends IncludedPropBehavior ? Value[
 type IncludedPropPassthrough<Value> = Value extends IncludedPropBehavior ? Value['passthrough'] extends 'component' ? Value['visibility'] extends 'optional' ? 'component' | 'config' : 'component' : Value['passthrough'] : Value extends true | 'required' ? 'config' : Value extends 'optional' ? 'component' | 'config' : never;
 type GetPropsKey<IncludeProps extends object, Visibility extends InternalPropsType, Passthrough extends IncludedPropBehavior['passthrough'] | 'render' = 'render'> = { [Key in keyof IncludeProps]: IncludedPropVisibility<IncludeProps[Key]> extends Visibility ? Passthrough extends 'render' ? Key : Passthrough extends IncludedPropPassthrough<IncludeProps[Key]> ? Key : never : never }[keyof IncludeProps];
 type SelectedIncludedProps<Props extends InPropsObject, IncludeProps extends IncludedProps<Props>, Visibility extends InternalPropsType, Passthrough extends IncludedPropBehavior['passthrough'] | 'render' = 'render'> = Pick<Props, PropsKeys<Props, GetPropsKey<IncludeProps, Visibility, Passthrough>>>;
+type OptionalPropDefinition<Definition> = Definition extends {
+  optional(): infer OptionalDefinition;
+} ? OptionalDefinition : Definition;
+/** Raw validator definitions accepted by a generated component call. */
+type IncludedComponentPropDefinitions<Props extends InPropsObject, IncludeProps extends IncludedProps<Props>> = SelectedIncludedProps<Props, IncludeProps, 'required', 'component'> & { [Key in keyof SelectedIncludedProps<Props, IncludeProps, 'optional', 'component'>]: OptionalPropDefinition<SelectedIncludedProps<Props, IncludeProps, 'optional', 'component'>[Key]> };
 type ResolvedIncludedProps<Props extends InPropsObject, IncludeProps extends IncludedProps<Props>> = ResolveLayoutProps<SelectedIncludedProps<Props, IncludeProps, 'required'>> & Partial<ResolveLayoutProps<SelectedIncludedProps<Props, IncludeProps, 'optional'>>>;
 type ResolvedIncludedConfigProps<Props extends InPropsObject, IncludeProps extends IncludedProps<Props>> = ResolveLayoutProps<SelectedIncludedProps<Props, IncludeProps, 'required', 'config'>> & Partial<ResolveLayoutProps<SelectedIncludedProps<Props, IncludeProps, 'optional', 'config'>>>;
 type ResolvedIncludedComponentProps<Props extends InPropsObject, IncludeProps extends IncludedProps<Props>> = ResolveLayoutProps<SelectedIncludedProps<Props, IncludeProps, 'required', 'component'>> & Partial<ResolveLayoutProps<SelectedIncludedProps<Props, IncludeProps, 'optional', 'component'>>>;
@@ -65,5 +70,5 @@ type ResolvedIncludedComponentProps<Props extends InPropsObject, IncludeProps ex
 type ResolvedIncludedPropsAsDefined<Props extends InPropsObject, IncludeProps extends IncludedProps<Props>> = ResolveLayoutPropsAsDefined<SelectedIncludedProps<Props, IncludeProps, 'required'>> & Partial<ResolveLayoutPropsAsDefined<SelectedIncludedProps<Props, IncludeProps, 'optional'>>>;
 type LayoutRenderProps<Resources extends ReadonlyArray<ResourceDefinition>, Options extends InPropsDefinition<Resources>, Composables extends ComposableComponents = {}, IncludeProps extends IncludedProps<MergedLayoutInProps<Resources, Options, Composables>> = {}, CustomProps extends InPropsObject = {}> = Show<ResolveProps<CustomProps> & ResolvedIncludedProps<MergedLayoutInProps<Resources, Options, Composables>, IncludeProps>>;
 //#endregion
-export { InPropsDefinition, InPropsFunction, type InPropsObject, InPropsOptions, IncludedPropBehavior, IncludedProps, InferredInProps, LayoutRenderProps, MergedLayoutInProps, PropsContextRender, PropsRenderDefinition, ResolvedIncludedComponentProps, ResolvedIncludedConfigProps, ResolvedIncludedProps, ResolvedIncludedPropsAsDefined };
+export { InPropsDefinition, InPropsFunction, type InPropsObject, InPropsOptions, IncludedComponentPropDefinitions, IncludedPropBehavior, IncludedProps, InferredInProps, LayoutRenderProps, MergedLayoutInProps, PropsContextRender, PropsRenderDefinition, ResolvedIncludedComponentProps, ResolvedIncludedConfigProps, ResolvedIncludedProps, ResolvedIncludedPropsAsDefined };
 //# sourceMappingURL=props.d.mts.map

package/dist/props.d.mts.map

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

package/dist/resource.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"resource.cjs","names":["LayoutConfigurationError"],"sources":["../src/resource.ts"],"sourcesContent":["import { ReactNode } from 'react';\nimport { NonEmptyReadonlyArray } from '@jfdevelops/react-layout-validator';\nimport { MergeIntersection, UnionToIntersection } from './utils';\nimport { LayoutConfigurationError } from './errors';\n\nexport type ResourceDefinition =\n  | string\n  | {\n      value: string;\n      subResources: ReadonlyArray<\n        ResourceDefinition & {\n          /**\n           * Whether to allow any string as a sub resource.\n           *\n           * @default false\n           */\n          allowAnyString?: boolean;\n        }\n      >;\n    };\n\nexport type ResourceTree = Record<\n  string,\n  {\n    subResources: ResourceTree;\n  }\n>;\n\nexport type NormalizeResource<Resource extends ResourceDefinition> =\n  Resource extends string\n    ? {\n        [Key in Resource]: {\n          subResources: {};\n        };\n      }\n    : Resource extends {\n          value: infer Value extends string;\n          subResources: infer SubResources extends\n            ReadonlyArray<ResourceDefinition>;\n        }\n      ? {\n          [Key in Value]: {\n            subResources: NormalizeResources<SubResources>;\n          };\n        }\n      : never;\n\nexport type NormalizeResources<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = MergeIntersection<\n  UnionToIntersection<NormalizeResource<Resources[number]>>\n>;\nexport type ResourceLayoutComponentProps = {\n  children: ReactNode;\n};\n\nfunction normalizeResourceTree(resource: ResourceDefinition): ResourceTree {\n  if (typeof resource === 'string') {\n    return {\n      [resource]: {\n        subResources: {},\n      },\n    };\n  }\n\n  const { value, subResources } = resource;\n\n  return {\n    [value]: {\n      subResources: normalizeResourcesTree(subResources),\n    },\n  };\n}\n\nfunction normalizeResourcesTree(\n  resources: ReadonlyArray<ResourceDefinition>,\n): ResourceTree {\n  const normalizedResources: ResourceTree = {};\n\n  for (const resource of resources) {\n    Object.assign(normalizedResources, normalizeResourceTree(resource));\n  }\n\n  return normalizedResources;\n}\n\nexport function normalizeResource(resource: ResourceDefinition): ResourceTree {\n  return normalizeResourceTree(resource);\n}\n\nexport function normalizeResources<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n>(resources: Resources): NormalizeResources<Resources> {\n  return normalizeResourcesTree(resources) as NormalizeResources<Resources>;\n}\n\nexport function createIsValidResourceFn<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n>(resources: Resources) {\n  return (value: unknown): value is LayoutResourceKey<Resources> => {\n    return (\n      typeof value === 'string' &&\n      Object.keys(normalizeResources(resources)).includes(value)\n    );\n  };\n}\n\nexport type ResourceDefinitionValue<Resource extends ResourceDefinition> =\n  Resource extends string\n    ? Resource\n    : Resource extends { value: infer Value extends string }\n      ? Value\n      : never;\n\n/**\n * Top-level resource names declared in a `resources` array. Preserves string\n * literal unions for const resource definitions (unlike `keyof` on the\n * normalized resource tree, which tends to widen to `string` in hovers).\n */\nexport type LayoutResourceKey<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = ResourceDefinitionValue<Resources[number]>;\n\nexport type ResourceDefinitionForKey<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Key extends string,\n> = Extract<Resources[number], Key | { value: Key }>;\n\n/** `subResources` array declared on a layout resource. */\nexport type SubResourceDefinitionsFor<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends LayoutResourceKey<Resources>,\n> =\n  ResourceDefinitionForKey<Resources, Resource> extends {\n    subResources: infer SubResources extends ReadonlyArray<ResourceDefinition>;\n  }\n    ? SubResources\n    : readonly [];\n\ntype CanNestSubResourceParam<\n  MaxDepth extends number,\n  DepthAcc extends readonly unknown[],\n> = [...DepthAcc, unknown]['length'] extends MaxDepth ? false : true;\n\n/**\n * `subResource` route param: a slug at the current depth, or `{ value, subResource }`\n * when that slug has nested `subResources` in the layout tree and `MaxDepth` allows it.\n */\nexport type RecursiveSubResourceParam<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  SubDefs extends ReadonlyArray<ResourceDefinition>,\n  MaxDepth extends number = 6,\n  DepthAcc extends readonly unknown[] = readonly [],\n> =\n  LayoutResourceKey<SubDefs> extends infer Key\n    ? Key extends LayoutResourceKey<SubDefs>\n      ? CanNestSubResourceParam<MaxDepth, DepthAcc> extends true\n        ? ResourceDefinitionForKey<SubDefs, Key> extends {\n            subResources: infer Nested extends\n              ReadonlyArray<ResourceDefinition>;\n          }\n          ? [LayoutResourceKey<Nested>] extends [never]\n            ? Key\n            :\n                | Key\n                | {\n                    value: Key;\n                    subResource: RecursiveSubResourceParam<\n                      Resources,\n                      Nested,\n                      MaxDepth,\n                      readonly [...DepthAcc, unknown]\n                    >;\n                  }\n          : Key\n        : Key\n      : never\n    : never;\n\n/** Recursive `subResource` values for a layout resource (full tree depth). */\nexport type SubResourceParamForResource<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends LayoutResourceKey<Resources>,\n> = [SubResourceDefinitionsFor<Resources, Resource>] extends [readonly []]\n  ? never\n  : RecursiveSubResourceParam<\n      Resources,\n      SubResourceDefinitionsFor<Resources, Resource>\n    >;\n\nexport type GetSubResourceKeys<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends LayoutResourceKey<Resources>,\n> =\n  ResourceDefinitionForKey<Resources, Resource> extends {\n    subResources: infer SubResources extends ReadonlyArray<ResourceDefinition>;\n  }\n    ? LayoutResourceKey<SubResources>\n    : never;\nexport type ResourceEnum<Resources extends ReadonlyArray<ResourceDefinition>> =\n  NonEmptyReadonlyArray<LayoutResourceKey<Resources>>;\nexport function toResourceEnum<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n>(resources: NormalizeResources<Resources>) {\n  const keys = Object.keys(resources);\n\n  if (keys.length === 0) {\n    throw new LayoutConfigurationError('No resources provided');\n  }\n\n  return keys as unknown as ResourceEnum<Resources>;\n}\n"],"mappings":";;;AAwDA,SAAS,sBAAsB,UAA4C;CACzE,IAAI,OAAO,aAAa,UACtB,OAAO,GACJ,WAAW,EACV,cAAc,CAAC,EACjB,EACF;CAGF,MAAM,EAAE,OAAO,iBAAiB;CAEhC,OAAO,GACJ,QAAQ,EACP,cAAc,uBAAuB,YAAY,EACnD,EACF;AACF;AAEA,SAAS,uBACP,WACc;CACd,MAAM,sBAAoC,CAAC;CAE3C,KAAK,MAAM,YAAY,WACrB,OAAO,OAAO,qBAAqB,sBAAsB,QAAQ,CAAC;CAGpE,OAAO;AACT;AAEA,SAAgB,kBAAkB,UAA4C;CAC5E,OAAO,sBAAsB,QAAQ;AACvC;AAEA,SAAgB,mBAEd,WAAqD;CACrD,OAAO,uBAAuB,SAAS;AACzC;AAEA,SAAgB,wBAEd,WAAsB;CACtB,QAAQ,UAA0D;EAChE,OACE,OAAO,UAAU,YACjB,OAAO,KAAK,mBAAmB,SAAS,CAAC,EAAE,SAAS,KAAK;CAE7D;AACF;AAgGA,SAAgB,eAEd,WAA0C;CAC1C,MAAM,OAAO,OAAO,KAAK,SAAS;CAElC,IAAI,KAAK,WAAW,GAClB,MAAM,IAAIA,4DAAyB,uBAAuB;CAG5D,OAAO;AACT"}
+{"version":3,"file":"resource.cjs","names":["LayoutConfigurationError"],"sources":["../src/resource.ts"],"sourcesContent":["import { ReactNode } from 'react';\nimport { NonEmptyReadonlyArray } from '@jfdevelops/react-layout-validator';\nimport { MergeIntersection, UnionToIntersection } from './utils';\nimport { LayoutConfigurationError } from './errors';\n\nexport type ResourceDefinition =\n  | string\n  | {\n      value: string;\n      subResources: ReadonlyArray<\n        ResourceDefinition & {\n          /**\n           * Whether to allow any string as a sub resource.\n           *\n           * @default false\n           */\n          allowAnyString?: boolean;\n        }\n      >;\n    };\n\nexport type ResourceTree = Record<\n  string,\n  {\n    subResources: ResourceTree;\n  }\n>;\n\nexport type NormalizeResource<Resource extends ResourceDefinition> =\n  Resource extends string\n    ? {\n        [Key in Resource]: {\n          subResources: {};\n        };\n      }\n    : Resource extends {\n          value: infer Value extends string;\n          subResources: infer SubResources extends\n            ReadonlyArray<ResourceDefinition>;\n        }\n      ? {\n          [Key in Value]: {\n            subResources: NormalizeResources<SubResources>;\n          };\n        }\n      : never;\n\nexport type NormalizeResources<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = MergeIntersection<\n  UnionToIntersection<NormalizeResource<Resources[number]>>\n>;\nexport type ResourceLayoutComponentProps = {\n  children: ReactNode;\n};\n\nfunction normalizeResourceTree(resource: ResourceDefinition): ResourceTree {\n  if (typeof resource === 'string') {\n    return {\n      [resource]: {\n        subResources: {},\n      },\n    };\n  }\n\n  const { value, subResources } = resource;\n\n  return {\n    [value]: {\n      subResources: normalizeResourcesTree(subResources),\n    },\n  };\n}\n\nfunction normalizeResourcesTree(\n  resources: ReadonlyArray<ResourceDefinition>,\n): ResourceTree {\n  const normalizedResources: ResourceTree = {};\n\n  for (const resource of resources) {\n    Object.assign(normalizedResources, normalizeResourceTree(resource));\n  }\n\n  return normalizedResources;\n}\n\nexport function normalizeResource(resource: ResourceDefinition): ResourceTree {\n  return normalizeResourceTree(resource);\n}\n\nexport function normalizeResources<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n>(resources: Resources): NormalizeResources<Resources> {\n  return normalizeResourcesTree(resources) as NormalizeResources<Resources>;\n}\n\nexport function createIsValidResourceFn<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n>(resources: Resources) {\n  return (value: unknown): value is LayoutResourceKey<Resources> => {\n    return (\n      typeof value === 'string' &&\n      Object.keys(normalizeResources(resources)).includes(value)\n    );\n  };\n}\n\nexport type ResourceDefinitionValue<Resource extends ResourceDefinition> =\n  Resource extends string\n    ? Resource\n    : Resource extends { value: infer Value extends string }\n      ? Value\n      : never;\n\ntype NestedResourcePath<\n  Definition extends ResourceDefinition,\n  Prefix extends string = '',\n> = Definition extends string\n  ? Prefix extends ''\n    ? Definition\n    : `${Prefix}.${Definition}`\n  : Definition extends {\n        value: infer Value extends string;\n        subResources: infer SubResources extends ReadonlyArray<ResourceDefinition>;\n      }\n    ? | (Prefix extends '' ? Value : `${Prefix}.${Value}`)\n      | NestedResourcePath<\n          SubResources[number],\n          Prefix extends '' ? Value : `${Prefix}.${Value}`\n        >\n    : never;\n\n/** Dot-delimited paths for every resource and nested sub-resource. */\nexport type ResourcePath<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = NestedResourcePath<Resources[number]>;\n\n/**\n * Top-level resource names declared in a `resources` array. Preserves string\n * literal unions for const resource definitions (unlike `keyof` on the\n * normalized resource tree, which tends to widen to `string` in hovers).\n */\nexport type LayoutResourceKey<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = ResourceDefinitionValue<Resources[number]>;\n\nexport type ResourceDefinitionForKey<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Key extends string,\n> = Extract<Resources[number], Key | { value: Key }>;\n\n/** `subResources` array declared on a layout resource. */\nexport type SubResourceDefinitionsFor<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends LayoutResourceKey<Resources>,\n> =\n  ResourceDefinitionForKey<Resources, Resource> extends {\n    subResources: infer SubResources extends ReadonlyArray<ResourceDefinition>;\n  }\n    ? SubResources\n    : readonly [];\n\ntype CanNestSubResourceParam<\n  MaxDepth extends number,\n  DepthAcc extends readonly unknown[],\n> = [...DepthAcc, unknown]['length'] extends MaxDepth ? false : true;\n\n/**\n * `subResource` route param: a slug at the current depth, or `{ value, subResource }`\n * when that slug has nested `subResources` in the layout tree and `MaxDepth` allows it.\n */\nexport type RecursiveSubResourceParam<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  SubDefs extends ReadonlyArray<ResourceDefinition>,\n  MaxDepth extends number = 6,\n  DepthAcc extends readonly unknown[] = readonly [],\n> =\n  LayoutResourceKey<SubDefs> extends infer Key\n    ? Key extends LayoutResourceKey<SubDefs>\n      ? CanNestSubResourceParam<MaxDepth, DepthAcc> extends true\n        ? ResourceDefinitionForKey<SubDefs, Key> extends {\n            subResources: infer Nested extends\n              ReadonlyArray<ResourceDefinition>;\n          }\n          ? [LayoutResourceKey<Nested>] extends [never]\n            ? Key\n            :\n                | Key\n                | {\n                    value: Key;\n                    subResource: RecursiveSubResourceParam<\n                      Resources,\n                      Nested,\n                      MaxDepth,\n                      readonly [...DepthAcc, unknown]\n                    >;\n                  }\n          : Key\n        : Key\n      : never\n    : never;\n\n/** Recursive `subResource` values for a layout resource (full tree depth). */\nexport type SubResourceParamForResource<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends LayoutResourceKey<Resources>,\n> = [SubResourceDefinitionsFor<Resources, Resource>] extends [readonly []]\n  ? never\n  : RecursiveSubResourceParam<\n      Resources,\n      SubResourceDefinitionsFor<Resources, Resource>\n    >;\n\nexport type GetSubResourceKeys<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends LayoutResourceKey<Resources>,\n> =\n  ResourceDefinitionForKey<Resources, Resource> extends {\n    subResources: infer SubResources extends ReadonlyArray<ResourceDefinition>;\n  }\n    ? LayoutResourceKey<SubResources>\n    : never;\nexport type ResourceEnum<Resources extends ReadonlyArray<ResourceDefinition>> =\n  NonEmptyReadonlyArray<LayoutResourceKey<Resources>>;\nexport function toResourceEnum<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n>(resources: NormalizeResources<Resources>) {\n  const keys = Object.keys(resources);\n\n  if (keys.length === 0) {\n    throw new LayoutConfigurationError('No resources provided');\n  }\n\n  return keys as unknown as ResourceEnum<Resources>;\n}\n"],"mappings":";;;AAwDA,SAAS,sBAAsB,UAA4C;CACzE,IAAI,OAAO,aAAa,UACtB,OAAO,GACJ,WAAW,EACV,cAAc,CAAC,EACjB,EACF;CAGF,MAAM,EAAE,OAAO,iBAAiB;CAEhC,OAAO,GACJ,QAAQ,EACP,cAAc,uBAAuB,YAAY,EACnD,EACF;AACF;AAEA,SAAS,uBACP,WACc;CACd,MAAM,sBAAoC,CAAC;CAE3C,KAAK,MAAM,YAAY,WACrB,OAAO,OAAO,qBAAqB,sBAAsB,QAAQ,CAAC;CAGpE,OAAO;AACT;AAEA,SAAgB,kBAAkB,UAA4C;CAC5E,OAAO,sBAAsB,QAAQ;AACvC;AAEA,SAAgB,mBAEd,WAAqD;CACrD,OAAO,uBAAuB,SAAS;AACzC;AAEA,SAAgB,wBAEd,WAAsB;CACtB,QAAQ,UAA0D;EAChE,OACE,OAAO,UAAU,YACjB,OAAO,KAAK,mBAAmB,SAAS,CAAC,EAAE,SAAS,KAAK;CAE7D;AACF;AAuHA,SAAgB,eAEd,WAA0C;CAC1C,MAAM,OAAO,OAAO,KAAK,SAAS;CAElC,IAAI,KAAK,WAAW,GAClB,MAAM,IAAIA,4DAAyB,uBAAuB;CAG5D,OAAO;AACT"}

package/dist/resource.d.cts

@@ -34,6 +34,12 @@ declare function normalizeResources<Resources extends ReadonlyArray<ResourceDefi
 type ResourceDefinitionValue<Resource extends ResourceDefinition> = Resource extends string ? Resource : Resource extends {
   value: infer Value extends string;
 } ? Value : never;
+type NestedResourcePath<Definition extends ResourceDefinition, Prefix extends string = ''> = Definition extends string ? Prefix extends '' ? Definition : `${Prefix}.${Definition}` : Definition extends {
+  value: infer Value extends string;
+  subResources: infer SubResources extends ReadonlyArray<ResourceDefinition>;
+} ? (Prefix extends '' ? Value : `${Prefix}.${Value}`) | NestedResourcePath<SubResources[number], Prefix extends '' ? Value : `${Prefix}.${Value}`> : never;
+/** Dot-delimited paths for every resource and nested sub-resource. */
+type ResourcePath<Resources extends ReadonlyArray<ResourceDefinition>> = NestedResourcePath<Resources[number]>;
 /**
  * Top-level resource names declared in a `resources` array. Preserves string
  * literal unions for const resource definitions (unlike `keyof` on the
@@ -63,5 +69,5 @@ type SubResourceParamForResource<Resources extends ReadonlyArray<ResourceDefinit
 type ResourceEnum<Resources extends ReadonlyArray<ResourceDefinition>> = NonEmptyReadonlyArray<LayoutResourceKey<Resources>>;
 declare function toResourceEnum<Resources extends ReadonlyArray<ResourceDefinition>>(resources: NormalizeResources<Resources>): ResourceEnum<Resources>;
 //#endregion
-export { LayoutResourceKey, NormalizeResource, NormalizeResources, ResourceDefinition, ResourceDefinitionForKey, ResourceDefinitionValue, ResourceEnum, ResourceLayoutComponentProps, ResourceTree, SubResourceDefinitionsFor, SubResourceParamForResource, normalizeResource, normalizeResources, toResourceEnum };
+export { LayoutResourceKey, NormalizeResource, NormalizeResources, ResourceDefinition, ResourceDefinitionForKey, ResourceDefinitionValue, ResourceEnum, ResourceLayoutComponentProps, ResourcePath, ResourceTree, SubResourceDefinitionsFor, SubResourceParamForResource, normalizeResource, normalizeResources, toResourceEnum };
 //# sourceMappingURL=resource.d.cts.map

package/dist/resource.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"resource.d.cts","names":[],"sources":["../src/resource.ts"],"mappings":";;;;;KAKY,kBAAA;EAGN,KAAA;EACA,YAAA,EAAc,aAAa,CACzB,kBAAA;IALsB;;;;;IAWpB,cAAA;EAAA;AAAA;AAAA,KAKE,YAAA,GAAe,MAAM;EAG7B,YAAA,EAAc,YAAA;AAAA;AAAA,KAIN,iBAAA,kBAAmC,kBAAA,IAC7C,QAAA,4BAEc,QAAA;EACN,YAAA;AAAA,MAGJ,QAAA;EACI,KAAA;EACA,YAAA,6BACE,aAAA,CAAc,kBAAA;AAAA,cAGR,KAAA;EACN,YAAA,EAAc,kBAAA,CAAmB,YAAA;AAAA;AAAA,KAKjC,kBAAA,mBACQ,aAAA,CAAc,kBAAA,KAC9B,iBAAA,CACF,mBAAA,CAAoB,iBAAA,CAAkB,SAAA;AAAA,KAE5B,4BAAA;EACV,QAAA,EAAU,SAAS;AAAA;AAAA,iBAiCL,iBAAA,CAAkB,QAAA,EAAU,kBAAA,GAAqB,YAAY;AAAA,iBAI7D,kBAAA,mBACI,aAAA,CAAc,kBAAA,GAChC,SAAA,EAAW,SAAA,GAAY,kBAAA,CAAmB,SAAA;AAAA,KAehC,uBAAA,kBAAyC,kBAAA,IACnD,QAAA,kBACI,QAAA,GACA,QAAA;EAAmB,KAAA;AAAA,IACjB,KAAA;;;;;;KAQI,iBAAA,mBACQ,aAAA,CAAc,kBAAA,KAC9B,uBAAA,CAAwB,SAAA;AAAA,KAEhB,wBAAA,mBACQ,aAAA,CAAc,kBAAA,yBAE9B,OAAA,CAAQ,SAAA,UAAmB,GAAA;EAAQ,KAAA,EAAO,GAAA;AAAA;;KAGlC,yBAAA,mBACQ,aAAA,CAAc,kBAAA,oBACf,iBAAA,CAAkB,SAAA,KAEnC,wBAAA,CAAyB,SAAA,EAAW,QAAA;EAClC,YAAA,6BAAyC,aAAA,CAAc,kBAAA;AAAA,IAErD,YAAA;AAAA,KAGD,uBAAA,qEAGG,QAAA,6BAAqC,QAAQ;;;;;KAMzC,yBAAA,mBACQ,aAAA,CAAc,kBAAA,mBAChB,aAAA,CAAc,kBAAA,qFAI9B,iBAAA,CAAkB,OAAA,sBACd,GAAA,SAAY,iBAAA,CAAkB,OAAA,IAC5B,uBAAA,CAAwB,QAAA,EAAU,QAAA,iBAChC,wBAAA,CAAyB,OAAA,EAAS,GAAA;EAChC,YAAA,uBACE,aAAA,CAAc,kBAAA;AAAA,KAEf,iBAAA,CAAkB,MAAA,qBACjB,GAAA,GAEI,GAAA;EAEE,KAAA,EAAO,GAAA;EACP,WAAA,EAAa,yBAAA,CACX,SAAA,EACA,MAAA,EACA,QAAA,eACa,QAAA;AAAA,IAGvB,GAAA,GACF,GAAA;;KAKE,2BAAA,mBACQ,aAAA,CAAc,kBAAA,oBACf,iBAAA,CAAkB,SAAA,MAChC,yBAAA,CAA0B,SAAA,EAAW,QAAA,mCAEtC,yBAAA,CACE,SAAA,EACA,yBAAA,CAA0B,SAAA,EAAW,QAAA;AAAA,KAY/B,YAAA,mBAA+B,aAAA,CAAc,kBAAA,KACvD,qBAAA,CAAsB,iBAAA,CAAkB,SAAA;AAAA,iBAC1B,cAAA,mBACI,aAAA,CAAc,kBAAA,GAChC,SAAA,EAAW,kBAAA,CAAmB,SAAA,IAOJ,YAAA,CAAa,SAAA"}
+{"version":3,"file":"resource.d.cts","names":[],"sources":["../src/resource.ts"],"mappings":";;;;;KAKY,kBAAA;EAGN,KAAA;EACA,YAAA,EAAc,aAAa,CACzB,kBAAA;IALsB;;;;;IAWpB,cAAA;EAAA;AAAA;AAAA,KAKE,YAAA,GAAe,MAAM;EAG7B,YAAA,EAAc,YAAA;AAAA;AAAA,KAIN,iBAAA,kBAAmC,kBAAA,IAC7C,QAAA,4BAEc,QAAA;EACN,YAAA;AAAA,MAGJ,QAAA;EACI,KAAA;EACA,YAAA,6BACE,aAAA,CAAc,kBAAA;AAAA,cAGR,KAAA;EACN,YAAA,EAAc,kBAAA,CAAmB,YAAA;AAAA;AAAA,KAKjC,kBAAA,mBACQ,aAAA,CAAc,kBAAA,KAC9B,iBAAA,CACF,mBAAA,CAAoB,iBAAA,CAAkB,SAAA;AAAA,KAE5B,4BAAA;EACV,QAAA,EAAU,SAAS;AAAA;AAAA,iBAiCL,iBAAA,CAAkB,QAAA,EAAU,kBAAA,GAAqB,YAAY;AAAA,iBAI7D,kBAAA,mBACI,aAAA,CAAc,kBAAA,GAChC,SAAA,EAAW,SAAA,GAAY,kBAAA,CAAmB,SAAA;AAAA,KAehC,uBAAA,kBAAyC,kBAAA,IACnD,QAAA,kBACI,QAAA,GACA,QAAA;EAAmB,KAAA;AAAA,IACjB,KAAA;AAAA,KAGH,kBAAA,oBACgB,kBAAA,gCAEjB,UAAA,kBACA,MAAA,cACE,UAAA,MACG,MAAA,IAAU,UAAA,KACf,UAAA;EACI,KAAA;EACA,YAAA,6BAAyC,aAAA,CAAc,kBAAA;AAAA,KAEtD,MAAA,cAAoB,KAAA,MAAW,MAAA,IAAU,KAAA,MAC1C,kBAAA,CACE,YAAA,UACA,MAAA,cAAoB,KAAA,MAAW,MAAA,IAAU,KAAA;;KAKvC,YAAA,mBACQ,aAAA,CAAc,kBAAA,KAC9B,kBAAA,CAAmB,SAAA;;;;;;KAOX,iBAAA,mBACQ,aAAA,CAAc,kBAAA,KAC9B,uBAAA,CAAwB,SAAA;AAAA,KAEhB,wBAAA,mBACQ,aAAA,CAAc,kBAAA,yBAE9B,OAAA,CAAQ,SAAA,UAAmB,GAAA;EAAQ,KAAA,EAAO,GAAA;AAAA;;KAGlC,yBAAA,mBACQ,aAAA,CAAc,kBAAA,oBACf,iBAAA,CAAkB,SAAA,KAEnC,wBAAA,CAAyB,SAAA,EAAW,QAAA;EAClC,YAAA,6BAAyC,aAAA,CAAc,kBAAA;AAAA,IAErD,YAAA;AAAA,KAGD,uBAAA,qEAGG,QAAA,6BAAqC,QAAQ;AAtHrD;;;;AAAA,KA4HY,yBAAA,mBACQ,aAAA,CAAc,kBAAA,mBAChB,aAAA,CAAc,kBAAA,qFAI9B,iBAAA,CAAkB,OAAA,sBACd,GAAA,SAAY,iBAAA,CAAkB,OAAA,IAC5B,uBAAA,CAAwB,QAAA,EAAU,QAAA,iBAChC,wBAAA,CAAyB,OAAA,EAAS,GAAA;EAChC,YAAA,uBACE,aAAA,CAAc,kBAAA;AAAA,KAEf,iBAAA,CAAkB,MAAA,qBACjB,GAAA,GAEI,GAAA;EAEE,KAAA,EAAO,GAAA;EACP,WAAA,EAAa,yBAAA,CACX,SAAA,EACA,MAAA,EACA,QAAA,eACa,QAAA;AAAA,IAGvB,GAAA,GACF,GAAA;;KAKE,2BAAA,mBACQ,aAAA,CAAc,kBAAA,oBACf,iBAAA,CAAkB,SAAA,MAChC,yBAAA,CAA0B,SAAA,EAAW,QAAA,mCAEtC,yBAAA,CACE,SAAA,EACA,yBAAA,CAA0B,SAAA,EAAW,QAAA;AAAA,KAY/B,YAAA,mBAA+B,aAAA,CAAc,kBAAA,KACvD,qBAAA,CAAsB,iBAAA,CAAkB,SAAA;AAAA,iBAC1B,cAAA,mBACI,aAAA,CAAc,kBAAA,GAChC,SAAA,EAAW,kBAAA,CAAmB,SAAA,IAOJ,YAAA,CAAa,SAAA"}

package/dist/resource.d.mts

@@ -34,6 +34,12 @@ declare function normalizeResources<Resources extends ReadonlyArray<ResourceDefi
 type ResourceDefinitionValue<Resource extends ResourceDefinition> = Resource extends string ? Resource : Resource extends {
   value: infer Value extends string;
 } ? Value : never;
+type NestedResourcePath<Definition extends ResourceDefinition, Prefix extends string = ''> = Definition extends string ? Prefix extends '' ? Definition : `${Prefix}.${Definition}` : Definition extends {
+  value: infer Value extends string;
+  subResources: infer SubResources extends ReadonlyArray<ResourceDefinition>;
+} ? (Prefix extends '' ? Value : `${Prefix}.${Value}`) | NestedResourcePath<SubResources[number], Prefix extends '' ? Value : `${Prefix}.${Value}`> : never;
+/** Dot-delimited paths for every resource and nested sub-resource. */
+type ResourcePath<Resources extends ReadonlyArray<ResourceDefinition>> = NestedResourcePath<Resources[number]>;
 /**
  * Top-level resource names declared in a `resources` array. Preserves string
  * literal unions for const resource definitions (unlike `keyof` on the
@@ -63,5 +69,5 @@ type SubResourceParamForResource<Resources extends ReadonlyArray<ResourceDefinit
 type ResourceEnum<Resources extends ReadonlyArray<ResourceDefinition>> = NonEmptyReadonlyArray<LayoutResourceKey<Resources>>;
 declare function toResourceEnum<Resources extends ReadonlyArray<ResourceDefinition>>(resources: NormalizeResources<Resources>): ResourceEnum<Resources>;
 //#endregion
-export { LayoutResourceKey, NormalizeResource, NormalizeResources, ResourceDefinition, ResourceDefinitionForKey, ResourceDefinitionValue, ResourceEnum, ResourceLayoutComponentProps, ResourceTree, SubResourceDefinitionsFor, SubResourceParamForResource, normalizeResource, normalizeResources, toResourceEnum };
+export { LayoutResourceKey, NormalizeResource, NormalizeResources, ResourceDefinition, ResourceDefinitionForKey, ResourceDefinitionValue, ResourceEnum, ResourceLayoutComponentProps, ResourcePath, ResourceTree, SubResourceDefinitionsFor, SubResourceParamForResource, normalizeResource, normalizeResources, toResourceEnum };
 //# sourceMappingURL=resource.d.mts.map

package/dist/resource.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"resource.d.mts","names":[],"sources":["../src/resource.ts"],"mappings":";;;;;KAKY,kBAAA;EAGN,KAAA;EACA,YAAA,EAAc,aAAa,CACzB,kBAAA;IALsB;;;;;IAWpB,cAAA;EAAA;AAAA;AAAA,KAKE,YAAA,GAAe,MAAM;EAG7B,YAAA,EAAc,YAAA;AAAA;AAAA,KAIN,iBAAA,kBAAmC,kBAAA,IAC7C,QAAA,4BAEc,QAAA;EACN,YAAA;AAAA,MAGJ,QAAA;EACI,KAAA;EACA,YAAA,6BACE,aAAA,CAAc,kBAAA;AAAA,cAGR,KAAA;EACN,YAAA,EAAc,kBAAA,CAAmB,YAAA;AAAA;AAAA,KAKjC,kBAAA,mBACQ,aAAA,CAAc,kBAAA,KAC9B,iBAAA,CACF,mBAAA,CAAoB,iBAAA,CAAkB,SAAA;AAAA,KAE5B,4BAAA;EACV,QAAA,EAAU,SAAS;AAAA;AAAA,iBAiCL,iBAAA,CAAkB,QAAA,EAAU,kBAAA,GAAqB,YAAY;AAAA,iBAI7D,kBAAA,mBACI,aAAA,CAAc,kBAAA,GAChC,SAAA,EAAW,SAAA,GAAY,kBAAA,CAAmB,SAAA;AAAA,KAehC,uBAAA,kBAAyC,kBAAA,IACnD,QAAA,kBACI,QAAA,GACA,QAAA;EAAmB,KAAA;AAAA,IACjB,KAAA;;;;;;KAQI,iBAAA,mBACQ,aAAA,CAAc,kBAAA,KAC9B,uBAAA,CAAwB,SAAA;AAAA,KAEhB,wBAAA,mBACQ,aAAA,CAAc,kBAAA,yBAE9B,OAAA,CAAQ,SAAA,UAAmB,GAAA;EAAQ,KAAA,EAAO,GAAA;AAAA;;KAGlC,yBAAA,mBACQ,aAAA,CAAc,kBAAA,oBACf,iBAAA,CAAkB,SAAA,KAEnC,wBAAA,CAAyB,SAAA,EAAW,QAAA;EAClC,YAAA,6BAAyC,aAAA,CAAc,kBAAA;AAAA,IAErD,YAAA;AAAA,KAGD,uBAAA,qEAGG,QAAA,6BAAqC,QAAQ;;;;;KAMzC,yBAAA,mBACQ,aAAA,CAAc,kBAAA,mBAChB,aAAA,CAAc,kBAAA,qFAI9B,iBAAA,CAAkB,OAAA,sBACd,GAAA,SAAY,iBAAA,CAAkB,OAAA,IAC5B,uBAAA,CAAwB,QAAA,EAAU,QAAA,iBAChC,wBAAA,CAAyB,OAAA,EAAS,GAAA;EAChC,YAAA,uBACE,aAAA,CAAc,kBAAA;AAAA,KAEf,iBAAA,CAAkB,MAAA,qBACjB,GAAA,GAEI,GAAA;EAEE,KAAA,EAAO,GAAA;EACP,WAAA,EAAa,yBAAA,CACX,SAAA,EACA,MAAA,EACA,QAAA,eACa,QAAA;AAAA,IAGvB,GAAA,GACF,GAAA;;KAKE,2BAAA,mBACQ,aAAA,CAAc,kBAAA,oBACf,iBAAA,CAAkB,SAAA,MAChC,yBAAA,CAA0B,SAAA,EAAW,QAAA,mCAEtC,yBAAA,CACE,SAAA,EACA,yBAAA,CAA0B,SAAA,EAAW,QAAA;AAAA,KAY/B,YAAA,mBAA+B,aAAA,CAAc,kBAAA,KACvD,qBAAA,CAAsB,iBAAA,CAAkB,SAAA;AAAA,iBAC1B,cAAA,mBACI,aAAA,CAAc,kBAAA,GAChC,SAAA,EAAW,kBAAA,CAAmB,SAAA,IAOJ,YAAA,CAAa,SAAA"}
+{"version":3,"file":"resource.d.mts","names":[],"sources":["../src/resource.ts"],"mappings":";;;;;KAKY,kBAAA;EAGN,KAAA;EACA,YAAA,EAAc,aAAa,CACzB,kBAAA;IALsB;;;;;IAWpB,cAAA;EAAA;AAAA;AAAA,KAKE,YAAA,GAAe,MAAM;EAG7B,YAAA,EAAc,YAAA;AAAA;AAAA,KAIN,iBAAA,kBAAmC,kBAAA,IAC7C,QAAA,4BAEc,QAAA;EACN,YAAA;AAAA,MAGJ,QAAA;EACI,KAAA;EACA,YAAA,6BACE,aAAA,CAAc,kBAAA;AAAA,cAGR,KAAA;EACN,YAAA,EAAc,kBAAA,CAAmB,YAAA;AAAA;AAAA,KAKjC,kBAAA,mBACQ,aAAA,CAAc,kBAAA,KAC9B,iBAAA,CACF,mBAAA,CAAoB,iBAAA,CAAkB,SAAA;AAAA,KAE5B,4BAAA;EACV,QAAA,EAAU,SAAS;AAAA;AAAA,iBAiCL,iBAAA,CAAkB,QAAA,EAAU,kBAAA,GAAqB,YAAY;AAAA,iBAI7D,kBAAA,mBACI,aAAA,CAAc,kBAAA,GAChC,SAAA,EAAW,SAAA,GAAY,kBAAA,CAAmB,SAAA;AAAA,KAehC,uBAAA,kBAAyC,kBAAA,IACnD,QAAA,kBACI,QAAA,GACA,QAAA;EAAmB,KAAA;AAAA,IACjB,KAAA;AAAA,KAGH,kBAAA,oBACgB,kBAAA,gCAEjB,UAAA,kBACA,MAAA,cACE,UAAA,MACG,MAAA,IAAU,UAAA,KACf,UAAA;EACI,KAAA;EACA,YAAA,6BAAyC,aAAA,CAAc,kBAAA;AAAA,KAEtD,MAAA,cAAoB,KAAA,MAAW,MAAA,IAAU,KAAA,MAC1C,kBAAA,CACE,YAAA,UACA,MAAA,cAAoB,KAAA,MAAW,MAAA,IAAU,KAAA;;KAKvC,YAAA,mBACQ,aAAA,CAAc,kBAAA,KAC9B,kBAAA,CAAmB,SAAA;;;;;;KAOX,iBAAA,mBACQ,aAAA,CAAc,kBAAA,KAC9B,uBAAA,CAAwB,SAAA;AAAA,KAEhB,wBAAA,mBACQ,aAAA,CAAc,kBAAA,yBAE9B,OAAA,CAAQ,SAAA,UAAmB,GAAA;EAAQ,KAAA,EAAO,GAAA;AAAA;;KAGlC,yBAAA,mBACQ,aAAA,CAAc,kBAAA,oBACf,iBAAA,CAAkB,SAAA,KAEnC,wBAAA,CAAyB,SAAA,EAAW,QAAA;EAClC,YAAA,6BAAyC,aAAA,CAAc,kBAAA;AAAA,IAErD,YAAA;AAAA,KAGD,uBAAA,qEAGG,QAAA,6BAAqC,QAAQ;AAtHrD;;;;AAAA,KA4HY,yBAAA,mBACQ,aAAA,CAAc,kBAAA,mBAChB,aAAA,CAAc,kBAAA,qFAI9B,iBAAA,CAAkB,OAAA,sBACd,GAAA,SAAY,iBAAA,CAAkB,OAAA,IAC5B,uBAAA,CAAwB,QAAA,EAAU,QAAA,iBAChC,wBAAA,CAAyB,OAAA,EAAS,GAAA;EAChC,YAAA,uBACE,aAAA,CAAc,kBAAA;AAAA,KAEf,iBAAA,CAAkB,MAAA,qBACjB,GAAA,GAEI,GAAA;EAEE,KAAA,EAAO,GAAA;EACP,WAAA,EAAa,yBAAA,CACX,SAAA,EACA,MAAA,EACA,QAAA,eACa,QAAA;AAAA,IAGvB,GAAA,GACF,GAAA;;KAKE,2BAAA,mBACQ,aAAA,CAAc,kBAAA,oBACf,iBAAA,CAAkB,SAAA,MAChC,yBAAA,CAA0B,SAAA,EAAW,QAAA,mCAEtC,yBAAA,CACE,SAAA,EACA,yBAAA,CAA0B,SAAA,EAAW,QAAA;AAAA,KAY/B,YAAA,mBAA+B,aAAA,CAAc,kBAAA,KACvD,qBAAA,CAAsB,iBAAA,CAAkB,SAAA;AAAA,iBAC1B,cAAA,mBACI,aAAA,CAAc,kBAAA,GAChC,SAAA,EAAW,kBAAA,CAAmB,SAAA,IAOJ,YAAA,CAAa,SAAA"}

package/dist/resource.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"resource.mjs","names":[],"sources":["../src/resource.ts"],"sourcesContent":["import { ReactNode } from 'react';\nimport { NonEmptyReadonlyArray } from '@jfdevelops/react-layout-validator';\nimport { MergeIntersection, UnionToIntersection } from './utils';\nimport { LayoutConfigurationError } from './errors';\n\nexport type ResourceDefinition =\n  | string\n  | {\n      value: string;\n      subResources: ReadonlyArray<\n        ResourceDefinition & {\n          /**\n           * Whether to allow any string as a sub resource.\n           *\n           * @default false\n           */\n          allowAnyString?: boolean;\n        }\n      >;\n    };\n\nexport type ResourceTree = Record<\n  string,\n  {\n    subResources: ResourceTree;\n  }\n>;\n\nexport type NormalizeResource<Resource extends ResourceDefinition> =\n  Resource extends string\n    ? {\n        [Key in Resource]: {\n          subResources: {};\n        };\n      }\n    : Resource extends {\n          value: infer Value extends string;\n          subResources: infer SubResources extends\n            ReadonlyArray<ResourceDefinition>;\n        }\n      ? {\n          [Key in Value]: {\n            subResources: NormalizeResources<SubResources>;\n          };\n        }\n      : never;\n\nexport type NormalizeResources<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = MergeIntersection<\n  UnionToIntersection<NormalizeResource<Resources[number]>>\n>;\nexport type ResourceLayoutComponentProps = {\n  children: ReactNode;\n};\n\nfunction normalizeResourceTree(resource: ResourceDefinition): ResourceTree {\n  if (typeof resource === 'string') {\n    return {\n      [resource]: {\n        subResources: {},\n      },\n    };\n  }\n\n  const { value, subResources } = resource;\n\n  return {\n    [value]: {\n      subResources: normalizeResourcesTree(subResources),\n    },\n  };\n}\n\nfunction normalizeResourcesTree(\n  resources: ReadonlyArray<ResourceDefinition>,\n): ResourceTree {\n  const normalizedResources: ResourceTree = {};\n\n  for (const resource of resources) {\n    Object.assign(normalizedResources, normalizeResourceTree(resource));\n  }\n\n  return normalizedResources;\n}\n\nexport function normalizeResource(resource: ResourceDefinition): ResourceTree {\n  return normalizeResourceTree(resource);\n}\n\nexport function normalizeResources<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n>(resources: Resources): NormalizeResources<Resources> {\n  return normalizeResourcesTree(resources) as NormalizeResources<Resources>;\n}\n\nexport function createIsValidResourceFn<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n>(resources: Resources) {\n  return (value: unknown): value is LayoutResourceKey<Resources> => {\n    return (\n      typeof value === 'string' &&\n      Object.keys(normalizeResources(resources)).includes(value)\n    );\n  };\n}\n\nexport type ResourceDefinitionValue<Resource extends ResourceDefinition> =\n  Resource extends string\n    ? Resource\n    : Resource extends { value: infer Value extends string }\n      ? Value\n      : never;\n\n/**\n * Top-level resource names declared in a `resources` array. Preserves string\n * literal unions for const resource definitions (unlike `keyof` on the\n * normalized resource tree, which tends to widen to `string` in hovers).\n */\nexport type LayoutResourceKey<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = ResourceDefinitionValue<Resources[number]>;\n\nexport type ResourceDefinitionForKey<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Key extends string,\n> = Extract<Resources[number], Key | { value: Key }>;\n\n/** `subResources` array declared on a layout resource. */\nexport type SubResourceDefinitionsFor<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends LayoutResourceKey<Resources>,\n> =\n  ResourceDefinitionForKey<Resources, Resource> extends {\n    subResources: infer SubResources extends ReadonlyArray<ResourceDefinition>;\n  }\n    ? SubResources\n    : readonly [];\n\ntype CanNestSubResourceParam<\n  MaxDepth extends number,\n  DepthAcc extends readonly unknown[],\n> = [...DepthAcc, unknown]['length'] extends MaxDepth ? false : true;\n\n/**\n * `subResource` route param: a slug at the current depth, or `{ value, subResource }`\n * when that slug has nested `subResources` in the layout tree and `MaxDepth` allows it.\n */\nexport type RecursiveSubResourceParam<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  SubDefs extends ReadonlyArray<ResourceDefinition>,\n  MaxDepth extends number = 6,\n  DepthAcc extends readonly unknown[] = readonly [],\n> =\n  LayoutResourceKey<SubDefs> extends infer Key\n    ? Key extends LayoutResourceKey<SubDefs>\n      ? CanNestSubResourceParam<MaxDepth, DepthAcc> extends true\n        ? ResourceDefinitionForKey<SubDefs, Key> extends {\n            subResources: infer Nested extends\n              ReadonlyArray<ResourceDefinition>;\n          }\n          ? [LayoutResourceKey<Nested>] extends [never]\n            ? Key\n            :\n                | Key\n                | {\n                    value: Key;\n                    subResource: RecursiveSubResourceParam<\n                      Resources,\n                      Nested,\n                      MaxDepth,\n                      readonly [...DepthAcc, unknown]\n                    >;\n                  }\n          : Key\n        : Key\n      : never\n    : never;\n\n/** Recursive `subResource` values for a layout resource (full tree depth). */\nexport type SubResourceParamForResource<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends LayoutResourceKey<Resources>,\n> = [SubResourceDefinitionsFor<Resources, Resource>] extends [readonly []]\n  ? never\n  : RecursiveSubResourceParam<\n      Resources,\n      SubResourceDefinitionsFor<Resources, Resource>\n    >;\n\nexport type GetSubResourceKeys<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends LayoutResourceKey<Resources>,\n> =\n  ResourceDefinitionForKey<Resources, Resource> extends {\n    subResources: infer SubResources extends ReadonlyArray<ResourceDefinition>;\n  }\n    ? LayoutResourceKey<SubResources>\n    : never;\nexport type ResourceEnum<Resources extends ReadonlyArray<ResourceDefinition>> =\n  NonEmptyReadonlyArray<LayoutResourceKey<Resources>>;\nexport function toResourceEnum<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n>(resources: NormalizeResources<Resources>) {\n  const keys = Object.keys(resources);\n\n  if (keys.length === 0) {\n    throw new LayoutConfigurationError('No resources provided');\n  }\n\n  return keys as unknown as ResourceEnum<Resources>;\n}\n"],"mappings":";;;AAwDA,SAAS,sBAAsB,UAA4C;CACzE,IAAI,OAAO,aAAa,UACtB,OAAO,GACJ,WAAW,EACV,cAAc,CAAC,EACjB,EACF;CAGF,MAAM,EAAE,OAAO,iBAAiB;CAEhC,OAAO,GACJ,QAAQ,EACP,cAAc,uBAAuB,YAAY,EACnD,EACF;AACF;AAEA,SAAS,uBACP,WACc;CACd,MAAM,sBAAoC,CAAC;CAE3C,KAAK,MAAM,YAAY,WACrB,OAAO,OAAO,qBAAqB,sBAAsB,QAAQ,CAAC;CAGpE,OAAO;AACT;AAEA,SAAgB,kBAAkB,UAA4C;CAC5E,OAAO,sBAAsB,QAAQ;AACvC;AAEA,SAAgB,mBAEd,WAAqD;CACrD,OAAO,uBAAuB,SAAS;AACzC;AAEA,SAAgB,wBAEd,WAAsB;CACtB,QAAQ,UAA0D;EAChE,OACE,OAAO,UAAU,YACjB,OAAO,KAAK,mBAAmB,SAAS,CAAC,EAAE,SAAS,KAAK;CAE7D;AACF;AAgGA,SAAgB,eAEd,WAA0C;CAC1C,MAAM,OAAO,OAAO,KAAK,SAAS;CAElC,IAAI,KAAK,WAAW,GAClB,MAAM,IAAI,yBAAyB,uBAAuB;CAG5D,OAAO;AACT"}
+{"version":3,"file":"resource.mjs","names":[],"sources":["../src/resource.ts"],"sourcesContent":["import { ReactNode } from 'react';\nimport { NonEmptyReadonlyArray } from '@jfdevelops/react-layout-validator';\nimport { MergeIntersection, UnionToIntersection } from './utils';\nimport { LayoutConfigurationError } from './errors';\n\nexport type ResourceDefinition =\n  | string\n  | {\n      value: string;\n      subResources: ReadonlyArray<\n        ResourceDefinition & {\n          /**\n           * Whether to allow any string as a sub resource.\n           *\n           * @default false\n           */\n          allowAnyString?: boolean;\n        }\n      >;\n    };\n\nexport type ResourceTree = Record<\n  string,\n  {\n    subResources: ResourceTree;\n  }\n>;\n\nexport type NormalizeResource<Resource extends ResourceDefinition> =\n  Resource extends string\n    ? {\n        [Key in Resource]: {\n          subResources: {};\n        };\n      }\n    : Resource extends {\n          value: infer Value extends string;\n          subResources: infer SubResources extends\n            ReadonlyArray<ResourceDefinition>;\n        }\n      ? {\n          [Key in Value]: {\n            subResources: NormalizeResources<SubResources>;\n          };\n        }\n      : never;\n\nexport type NormalizeResources<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = MergeIntersection<\n  UnionToIntersection<NormalizeResource<Resources[number]>>\n>;\nexport type ResourceLayoutComponentProps = {\n  children: ReactNode;\n};\n\nfunction normalizeResourceTree(resource: ResourceDefinition): ResourceTree {\n  if (typeof resource === 'string') {\n    return {\n      [resource]: {\n        subResources: {},\n      },\n    };\n  }\n\n  const { value, subResources } = resource;\n\n  return {\n    [value]: {\n      subResources: normalizeResourcesTree(subResources),\n    },\n  };\n}\n\nfunction normalizeResourcesTree(\n  resources: ReadonlyArray<ResourceDefinition>,\n): ResourceTree {\n  const normalizedResources: ResourceTree = {};\n\n  for (const resource of resources) {\n    Object.assign(normalizedResources, normalizeResourceTree(resource));\n  }\n\n  return normalizedResources;\n}\n\nexport function normalizeResource(resource: ResourceDefinition): ResourceTree {\n  return normalizeResourceTree(resource);\n}\n\nexport function normalizeResources<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n>(resources: Resources): NormalizeResources<Resources> {\n  return normalizeResourcesTree(resources) as NormalizeResources<Resources>;\n}\n\nexport function createIsValidResourceFn<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n>(resources: Resources) {\n  return (value: unknown): value is LayoutResourceKey<Resources> => {\n    return (\n      typeof value === 'string' &&\n      Object.keys(normalizeResources(resources)).includes(value)\n    );\n  };\n}\n\nexport type ResourceDefinitionValue<Resource extends ResourceDefinition> =\n  Resource extends string\n    ? Resource\n    : Resource extends { value: infer Value extends string }\n      ? Value\n      : never;\n\ntype NestedResourcePath<\n  Definition extends ResourceDefinition,\n  Prefix extends string = '',\n> = Definition extends string\n  ? Prefix extends ''\n    ? Definition\n    : `${Prefix}.${Definition}`\n  : Definition extends {\n        value: infer Value extends string;\n        subResources: infer SubResources extends ReadonlyArray<ResourceDefinition>;\n      }\n    ? | (Prefix extends '' ? Value : `${Prefix}.${Value}`)\n      | NestedResourcePath<\n          SubResources[number],\n          Prefix extends '' ? Value : `${Prefix}.${Value}`\n        >\n    : never;\n\n/** Dot-delimited paths for every resource and nested sub-resource. */\nexport type ResourcePath<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = NestedResourcePath<Resources[number]>;\n\n/**\n * Top-level resource names declared in a `resources` array. Preserves string\n * literal unions for const resource definitions (unlike `keyof` on the\n * normalized resource tree, which tends to widen to `string` in hovers).\n */\nexport type LayoutResourceKey<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = ResourceDefinitionValue<Resources[number]>;\n\nexport type ResourceDefinitionForKey<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Key extends string,\n> = Extract<Resources[number], Key | { value: Key }>;\n\n/** `subResources` array declared on a layout resource. */\nexport type SubResourceDefinitionsFor<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends LayoutResourceKey<Resources>,\n> =\n  ResourceDefinitionForKey<Resources, Resource> extends {\n    subResources: infer SubResources extends ReadonlyArray<ResourceDefinition>;\n  }\n    ? SubResources\n    : readonly [];\n\ntype CanNestSubResourceParam<\n  MaxDepth extends number,\n  DepthAcc extends readonly unknown[],\n> = [...DepthAcc, unknown]['length'] extends MaxDepth ? false : true;\n\n/**\n * `subResource` route param: a slug at the current depth, or `{ value, subResource }`\n * when that slug has nested `subResources` in the layout tree and `MaxDepth` allows it.\n */\nexport type RecursiveSubResourceParam<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  SubDefs extends ReadonlyArray<ResourceDefinition>,\n  MaxDepth extends number = 6,\n  DepthAcc extends readonly unknown[] = readonly [],\n> =\n  LayoutResourceKey<SubDefs> extends infer Key\n    ? Key extends LayoutResourceKey<SubDefs>\n      ? CanNestSubResourceParam<MaxDepth, DepthAcc> extends true\n        ? ResourceDefinitionForKey<SubDefs, Key> extends {\n            subResources: infer Nested extends\n              ReadonlyArray<ResourceDefinition>;\n          }\n          ? [LayoutResourceKey<Nested>] extends [never]\n            ? Key\n            :\n                | Key\n                | {\n                    value: Key;\n                    subResource: RecursiveSubResourceParam<\n                      Resources,\n                      Nested,\n                      MaxDepth,\n                      readonly [...DepthAcc, unknown]\n                    >;\n                  }\n          : Key\n        : Key\n      : never\n    : never;\n\n/** Recursive `subResource` values for a layout resource (full tree depth). */\nexport type SubResourceParamForResource<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends LayoutResourceKey<Resources>,\n> = [SubResourceDefinitionsFor<Resources, Resource>] extends [readonly []]\n  ? never\n  : RecursiveSubResourceParam<\n      Resources,\n      SubResourceDefinitionsFor<Resources, Resource>\n    >;\n\nexport type GetSubResourceKeys<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends LayoutResourceKey<Resources>,\n> =\n  ResourceDefinitionForKey<Resources, Resource> extends {\n    subResources: infer SubResources extends ReadonlyArray<ResourceDefinition>;\n  }\n    ? LayoutResourceKey<SubResources>\n    : never;\nexport type ResourceEnum<Resources extends ReadonlyArray<ResourceDefinition>> =\n  NonEmptyReadonlyArray<LayoutResourceKey<Resources>>;\nexport function toResourceEnum<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n>(resources: NormalizeResources<Resources>) {\n  const keys = Object.keys(resources);\n\n  if (keys.length === 0) {\n    throw new LayoutConfigurationError('No resources provided');\n  }\n\n  return keys as unknown as ResourceEnum<Resources>;\n}\n"],"mappings":";;;AAwDA,SAAS,sBAAsB,UAA4C;CACzE,IAAI,OAAO,aAAa,UACtB,OAAO,GACJ,WAAW,EACV,cAAc,CAAC,EACjB,EACF;CAGF,MAAM,EAAE,OAAO,iBAAiB;CAEhC,OAAO,GACJ,QAAQ,EACP,cAAc,uBAAuB,YAAY,EACnD,EACF;AACF;AAEA,SAAS,uBACP,WACc;CACd,MAAM,sBAAoC,CAAC;CAE3C,KAAK,MAAM,YAAY,WACrB,OAAO,OAAO,qBAAqB,sBAAsB,QAAQ,CAAC;CAGpE,OAAO;AACT;AAEA,SAAgB,kBAAkB,UAA4C;CAC5E,OAAO,sBAAsB,QAAQ;AACvC;AAEA,SAAgB,mBAEd,WAAqD;CACrD,OAAO,uBAAuB,SAAS;AACzC;AAEA,SAAgB,wBAEd,WAAsB;CACtB,QAAQ,UAA0D;EAChE,OACE,OAAO,UAAU,YACjB,OAAO,KAAK,mBAAmB,SAAS,CAAC,EAAE,SAAS,KAAK;CAE7D;AACF;AAuHA,SAAgB,eAEd,WAA0C;CAC1C,MAAM,OAAO,OAAO,KAAK,SAAS;CAElC,IAAI,KAAK,WAAW,GAClB,MAAM,IAAI,yBAAyB,uBAAuB;CAG5D,OAAO;AACT"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jfdevelops/react-layout",
-  "version": "0.24.2",
+  "version": "0.25.0",
   "description": "A React library for creating layout components.",
   "repository": {
     "type": "git",
@@ -29,8 +29,8 @@
   "dependencies": {
     "@jfdevelops/create-error": "0.2.0",
     "arktype": "2.2.8",
-    "@jfdevelops/react-layout-composables": "0.2.7",
-    "@jfdevelops/react-layout-validator": "0.2.7"
+    "@jfdevelops/react-layout-composables": "0.2.8",
+    "@jfdevelops/react-layout-validator": "0.3.0"
   },
   "peerDependencies": {
     "react": ">=18",