@jfdevelops/react-layout 0.22.0 → 0.23.0

package/dist/index.d.mts

@@ -6,15 +6,18 @@ import { CreateGetComponentForPath, GetComponentForPath, ResolvedPathValue } fro
 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 { CreateResourceLayoutWithLayoutOptions, DefineResourceLayoutWithLayoutFn, DefineResourcesFn, DefinedResourceLayoutWithShell, LayoutRenderResourcesAccessor, LayoutResourcesAccessor, ResourceLayoutShellComponent, ResourceLayoutShellProps, ResourceSelection, ShellLayoutDefinition, ShellRenderContext, defineResourceLayout } from "./create-config/define-layout.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 { ResourceLayoutShellPublisher } from "./create-config/shell-context.mjs";
-import { CreateReactLayoutErrorOptions, CreatedReactLayoutError, ErrorMessageRenderer, ReactLayoutError, ReactLayoutErrorContext, ReactLayoutErrorRendererFactory, createReactLayoutError } from "./errors/react-layout-error.mjs";
+import { ReactLayoutError } from "./errors/react-layout-error.mjs";
 import { InvalidConfigContext, InvalidConfigError } from "./errors/invalid-config.mjs";
 import { InvalidPathContext, InvalidPathError } from "./errors/invalid-path.mjs";
 import { InvalidResourceContext, InvalidResourceError } from "./errors/invalid-resource.mjs";
 import { InvalidSubResourceContext, InvalidSubResourceError } from "./errors/invalid-sub-resource.mjs";
 import { InvalidComponentContext, InvalidComponentError } from "./errors/invalid-component.mjs";
 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 { 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 CreateReactLayoutErrorOptions, type CreateResourceLayoutWithLayoutOptions, type CreatedReactLayoutError, type CreatedResourceConfig, type DefineResourceLayoutWithLayoutFn, type DefineResourcesFn, type DefinedComposableComponentRecord, type DefinedResourceLayoutWithShell, type ErrorMessageRenderer, 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, type LayoutRenderProps, type LayoutRenderResourcesAccessor, type LayoutResourceKey, type LayoutResourcesAccessor, type MakeComposable, type MakeComposableOptions, type MergeIntersection, type MergePresetProps, type MergedLayoutInProps, type MissingPathVariableContext, MissingPathVariableError, type NormalizeResource, type NormalizeResources, type ParameterizedResourcePath, type PathVariables, type PresetPropsFromComposable, PropError, type PropErrorOptions, type PropsContextRender, type PropsRenderDefinition, ReactLayoutError, type ReactLayoutErrorContext, type ReactLayoutErrorRendererFactory, 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 ResourceLayoutShellComponent, type ResourceLayoutShellProps, type ResourceLayoutShellPublisher, type ResourceSelection, type ResourceTree, type ShellLayoutDefinition, type ShellRenderContext, type Show, type TargetPathBuilder, type UnionToIntersection, collectComposablePresetEntries, createComposableComponent, createLayoutComposableFactory, createPrimitivePropBuilder, createProp, createReactLayoutError, defineComposableComponent, defineResourceLayout, isPropDefinitionShape, makeComposable, normalizeResource, normalizeResources, pick, resolveComposablePresetProps, resolveLayoutComposables, resolvePropDefinitionValues, toResourceEnum, validateProps };
+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 };

package/dist/index.mjs

@@ -1,14 +1,16 @@
-import { normalizeResource, normalizeResources, toResourceEnum } from "./resource.mjs";
-import { pick } from "./utils.mjs";
-import { ReactLayoutError, createReactLayoutError } from "./errors/react-layout-error.mjs";
+import { ReactLayoutError } from "./errors/react-layout-error.mjs";
 import { InvalidConfigError } from "./errors/invalid-config.mjs";
 import { InvalidPathError } from "./errors/invalid-path.mjs";
 import { InvalidResourceError } from "./errors/invalid-resource.mjs";
 import { InvalidSubResourceError } from "./errors/invalid-sub-resource.mjs";
 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 { normalizeResource, normalizeResources, toResourceEnum } from "./resource.mjs";
+import { pick } from "./utils.mjs";
 import { defineResourceLayout } from "./create-config/define-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, MissingPathVariableError, PropError, ReactLayoutError, collectComposablePresetEntries, createComposableComponent, createLayoutComposableFactory, createPrimitivePropBuilder, createProp, createReactLayoutError, defineComposableComponent, defineResourceLayout, isPropDefinitionShape, makeComposable, normalizeResource, normalizeResources, pick, resolveComposablePresetProps, resolveLayoutComposables, resolvePropDefinitionValues, toResourceEnum, validateProps };
+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 };

package/dist/node_modules/.pnpm/@jfdevelops_create-error@0.2.0_patch_hash_afc71b16c3f866f54416d30f467784ddc31736feb04f281a5fc4772ea422f4a9/node_modules/@jfdevelops/create-error/dist/types.d.cts

@@ -0,0 +1,107 @@
+//#region ../../node_modules/.pnpm/@jfdevelops+create-error@0.2.0_patch_hash=afc71b16c3f866f54416d30f467784ddc31736feb04f281a5fc4772ea422f4a9/node_modules/@jfdevelops/create-error/dist/types.d.mts
+//#region src/types.d.ts
+declare const typeSlot: unique symbol;
+/** Marks a blueprint value that is resolved by a later builder stage. */
+type TypeSlot<Kind extends string, Payload = never> = {
+  readonly [typeSlot]: {
+    readonly kind: Kind;
+    readonly payload: Payload;
+  };
+};
+type DataSlot = TypeSlot<'data'>;
+type ResolveTemplate<Config> = Config extends {
+  data: {
+    resolve: (...arguments_: infer _Arguments) => infer Resolved;
+  };
+} ? Resolved : never;
+type InjectedDefinitionKeys<Template> = { [Key in keyof Template]: Template[Key] extends TypeSlot<'definition', PropertyKey> ? Key : never }[keyof Template];
+type ConstructorInput<Config, Data> = Data extends readonly unknown[] | ((...arguments_: never[]) => unknown) ? Data : Data extends object ? Omit<Data, Extract<InjectedDefinitionKeys<ResolveTemplate<Config>>, keyof Data>> : Data;
+type ReplaceTuple<Values extends readonly unknown[], Definition, Data, Implementation> = { [Index in keyof Values]: ReplaceTemplate<Values[Index], Definition, Data, Implementation> };
+/**
+ * Built-in class instances that are never plain objects. Templates are not
+ * expanded inside them, and they never receive definition fields.
+ */
+type OpaqueObject = Date | RegExp | ReadonlyMap<unknown, unknown> | ReadonlySet<unknown> | WeakMap<object, unknown> | WeakSet<object> | PromiseLike<unknown> | ArrayBuffer | ArrayBufferView;
+type ReplaceTemplate<Type, Definition, Data, Implementation> = Type extends TypeSlot<'definition', infer Key> ? Key extends keyof Definition ? Definition[Key] : never : Type extends TypeSlot<'data'> ? Data : Type extends TypeSlot<'implementation'> ? Implementation : Type extends OpaqueObject ? Type : Type extends ((...arguments_: infer Arguments) => infer Result) ? (...arguments_: ReplaceTuple<Arguments, Definition, Data, Implementation>) => ReplaceTemplate<Result, Definition, Data, Implementation> : Type extends readonly unknown[] ? ReplaceTuple<Type, Definition, Data, Implementation> : Type extends object ? { [Key in keyof Type]: ReplaceTemplate<Type[Key], Definition, Data, Implementation> } : Type;
+type PropertiesTemplate<Config> = Config extends {
+  properties: (...arguments_: infer _Arguments) => infer Properties;
+} ? Properties : object;
+type DataPropertyTemplate<Config> = Config extends {
+  data: {
+    property: infer Property extends string;
+  };
+} ? { [Key in Property]: DataSlot } : object;
+/**
+ * The error shape visible to a blueprint's `toJSON` callback.
+ *
+ * It contains native `Error` fields, the configured data property, and every
+ * member returned by `properties`.
+ */
+type InstanceProperties<Config, Definition, Data, Implementation> = ReplaceTemplate<PropertiesTemplate<Config>, Definition, Data, Implementation> & ReplaceTemplate<DataPropertyTemplate<Config>, Definition, Data, Implementation> & Error & (Config extends {
+  toJSON: (...arguments_: infer _Arguments) => infer Json;
+} ? {
+  toJSON(): ReplaceTemplate<Json, Definition, Data, Implementation>;
+} : object);
+type MessageTemplate<Config> = Config extends {
+  message: (...arguments_: infer _Arguments) => infer Message;
+} ? Message : string;
+type PassedImplementationArgument<Config, Definition, Data> = MessageTemplate<Config> extends TypeSlot<'implementationArgument', infer Argument> ? Argument extends TypeSlot<'data'> ? Data : ReplaceTemplate<Argument, Definition, Data, never> : never;
+type PassedImplementationCallback<Config, Definition, Data> = (argument: PassedImplementationArgument<Config, Definition, Data>) => string;
+/**
+ * Input accepted by `invariant`: the constructor input, or a function that
+ * returns it. When the constructor input can itself be a function, only the
+ * wrapped form is accepted so a callback is never mistaken for a lazy input.
+ */
+type InvariantInput<Input> = ExtendsNever<Extract<Input, (...arguments_: never[]) => unknown>, Input | (() => Input), () => Input>;
+interface ErrorClassStatics {
+  /**
+   * Throws this error class when `condition` is falsy.
+   *
+   * A function can be supplied as `input` to avoid constructing error data
+   * unless the invariant fails. TypeScript narrows `condition` after a
+   * successful call.
+   *
+   * TypeScript only allows assertion calls through explicitly typed names, so
+   * call this on a `class` declaration. For a class stored in a `const`, use
+   * the standalone {@link invariant} function instead.
+   *
+   * @example
+   * ```ts
+   * MissingUserError.invariant(
+   *   user,
+   *   () => ({ userId }),
+   *   { cause },
+   * );
+   *
+   * user.id; // narrowed to the truthy branch
+   * ```
+   */
+  invariant<Condition, Input>(this: new (input: Input, options?: ErrorOptions) => Error, condition: Condition, input: InvariantInput<Input>, options?: ErrorOptions): asserts condition;
+}
+/**
+ * The instance type shared by every error in one family.
+ *
+ * Definition-derived fields use the schema's general output type, and the data
+ * property is `unknown` because each concrete error types its own data.
+ */
+/**
+ * The shared native `Error` base created for one blueprint.
+ *
+ * Use `factory.Error` for family-wide `instanceof` checks or as a public base
+ * type for errors created by the same blueprint.
+ */
+type FamilyErrorClass<Instance extends Error = Error> = (abstract new (...arguments_: never[]) => Instance) & ErrorClassStatics;
+/** An extendable concrete error class produced by a configured factory. */
+interface ConcreteErrorClass<Input, Instance> extends ErrorClassStatics {
+  /**
+   * Creates an error from family-specific input.
+   *
+   * Pass native `ErrorOptions` as the second argument to preserve a `cause`.
+   */
+  new (input: Input, options?: ErrorOptions): Instance;
+}
+type ImplementedErrorClass<Config, Definition, Input, Data> = ConcreteErrorClass<ConstructorInput<Config, Input>, InstanceProperties<Config, Definition, Data, PassedImplementationCallback<Config, Definition, Data>>>;
+type ExtendsNever<Value, OnTrue, OnFalse> = [Value] extends [never] ? OnTrue : OnFalse;
+//#endregion
+export { FamilyErrorClass, ImplementedErrorClass };
+//# sourceMappingURL=types.d.cts.map

package/dist/node_modules/.pnpm/@jfdevelops_create-error@0.2.0_patch_hash_afc71b16c3f866f54416d30f467784ddc31736feb04f281a5fc4772ea422f4a9/node_modules/@jfdevelops/create-error/dist/types.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.cts","names":["Kind","Payload","typeSlot","kind","payload","Schema","StandardSchemaV1","InferInput","InferOutput","Input","Definition","Record","Exclude","DefinitionOutput","Key","TypeSlot","Argument$1","argument","definition","DefinitionTemplate","data","DataSlot","implementation","ImplementationSlot","input","property","resolve","ResolveContext","context","message","BlueprintContext","properties","toJSON","Error","error","Config","arguments_","_Arguments","Resolved","Template","PropertyKey","Data","Omit","Extract","InjectedDefinitionKeys","ResolveTemplate","Values","Implementation","Index","ReplaceTemplate","Date","RegExp","ReadonlyMap","ReadonlySet","WeakMap","WeakSet","PromiseLike","ArrayBuffer","ArrayBufferView","Type","OpaqueObject","Arguments","Result","ReplaceTuple","Properties","Property","DataPropertyTemplate","PropertiesTemplate","Json","Message","MessageTemplate","Argument","ImplementationArgumentWithDefinition","ImplementationArgument","PassedImplementationArgument","ExtendsNever","invariant","Condition","ErrorOptions","options","this","condition","InvariantInput","InstanceProperties","ConcreteDefinition","Instance","ErrorClassStatics","ConcreteErrorClass","ConstructorInput","PassedImplementationCallback","Value","OnTrue","OnFalse","InferredData","name","implement","DefaultBuilderData","Expand","ImplementationCallback","BuilderData","ImplementOptions","ImplementedErrorClass","BuilderInput","ImplementationBuilder","defineContext","ContextSchema","DefinitionInput","ExactDefinition","ErrorDefinitionBuilder","FamilyErrorClass","FamilyError","is","value"],"sources":["../../../../../../../../../../node_modules/.pnpm/@jfdevelops+create-error@0.2.0_patch_hash=afc71b16c3f866f54416d30f467784ddc31736feb04f281a5fc4772ea422f4a9/node_modules/@jfdevelops/create-error/dist/types.d.mts"],"x_google_ignoreList":[0],"mappings":"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"}

package/dist/node_modules/.pnpm/@jfdevelops_create-error@0.2.0_patch_hash_afc71b16c3f866f54416d30f467784ddc31736feb04f281a5fc4772ea422f4a9/node_modules/@jfdevelops/create-error/dist/types.d.mts

@@ -0,0 +1,107 @@
+//#region ../../node_modules/.pnpm/@jfdevelops+create-error@0.2.0_patch_hash=afc71b16c3f866f54416d30f467784ddc31736feb04f281a5fc4772ea422f4a9/node_modules/@jfdevelops/create-error/dist/types.d.mts
+//#region src/types.d.ts
+declare const typeSlot: unique symbol;
+/** Marks a blueprint value that is resolved by a later builder stage. */
+type TypeSlot<Kind extends string, Payload = never> = {
+  readonly [typeSlot]: {
+    readonly kind: Kind;
+    readonly payload: Payload;
+  };
+};
+type DataSlot = TypeSlot<'data'>;
+type ResolveTemplate<Config> = Config extends {
+  data: {
+    resolve: (...arguments_: infer _Arguments) => infer Resolved;
+  };
+} ? Resolved : never;
+type InjectedDefinitionKeys<Template> = { [Key in keyof Template]: Template[Key] extends TypeSlot<'definition', PropertyKey> ? Key : never }[keyof Template];
+type ConstructorInput<Config, Data> = Data extends readonly unknown[] | ((...arguments_: never[]) => unknown) ? Data : Data extends object ? Omit<Data, Extract<InjectedDefinitionKeys<ResolveTemplate<Config>>, keyof Data>> : Data;
+type ReplaceTuple<Values extends readonly unknown[], Definition, Data, Implementation> = { [Index in keyof Values]: ReplaceTemplate<Values[Index], Definition, Data, Implementation> };
+/**
+ * Built-in class instances that are never plain objects. Templates are not
+ * expanded inside them, and they never receive definition fields.
+ */
+type OpaqueObject = Date | RegExp | ReadonlyMap<unknown, unknown> | ReadonlySet<unknown> | WeakMap<object, unknown> | WeakSet<object> | PromiseLike<unknown> | ArrayBuffer | ArrayBufferView;
+type ReplaceTemplate<Type, Definition, Data, Implementation> = Type extends TypeSlot<'definition', infer Key> ? Key extends keyof Definition ? Definition[Key] : never : Type extends TypeSlot<'data'> ? Data : Type extends TypeSlot<'implementation'> ? Implementation : Type extends OpaqueObject ? Type : Type extends ((...arguments_: infer Arguments) => infer Result) ? (...arguments_: ReplaceTuple<Arguments, Definition, Data, Implementation>) => ReplaceTemplate<Result, Definition, Data, Implementation> : Type extends readonly unknown[] ? ReplaceTuple<Type, Definition, Data, Implementation> : Type extends object ? { [Key in keyof Type]: ReplaceTemplate<Type[Key], Definition, Data, Implementation> } : Type;
+type PropertiesTemplate<Config> = Config extends {
+  properties: (...arguments_: infer _Arguments) => infer Properties;
+} ? Properties : object;
+type DataPropertyTemplate<Config> = Config extends {
+  data: {
+    property: infer Property extends string;
+  };
+} ? { [Key in Property]: DataSlot } : object;
+/**
+ * The error shape visible to a blueprint's `toJSON` callback.
+ *
+ * It contains native `Error` fields, the configured data property, and every
+ * member returned by `properties`.
+ */
+type InstanceProperties<Config, Definition, Data, Implementation> = ReplaceTemplate<PropertiesTemplate<Config>, Definition, Data, Implementation> & ReplaceTemplate<DataPropertyTemplate<Config>, Definition, Data, Implementation> & Error & (Config extends {
+  toJSON: (...arguments_: infer _Arguments) => infer Json;
+} ? {
+  toJSON(): ReplaceTemplate<Json, Definition, Data, Implementation>;
+} : object);
+type MessageTemplate<Config> = Config extends {
+  message: (...arguments_: infer _Arguments) => infer Message;
+} ? Message : string;
+type PassedImplementationArgument<Config, Definition, Data> = MessageTemplate<Config> extends TypeSlot<'implementationArgument', infer Argument> ? Argument extends TypeSlot<'data'> ? Data : ReplaceTemplate<Argument, Definition, Data, never> : never;
+type PassedImplementationCallback<Config, Definition, Data> = (argument: PassedImplementationArgument<Config, Definition, Data>) => string;
+/**
+ * Input accepted by `invariant`: the constructor input, or a function that
+ * returns it. When the constructor input can itself be a function, only the
+ * wrapped form is accepted so a callback is never mistaken for a lazy input.
+ */
+type InvariantInput<Input> = ExtendsNever<Extract<Input, (...arguments_: never[]) => unknown>, Input | (() => Input), () => Input>;
+interface ErrorClassStatics {
+  /**
+   * Throws this error class when `condition` is falsy.
+   *
+   * A function can be supplied as `input` to avoid constructing error data
+   * unless the invariant fails. TypeScript narrows `condition` after a
+   * successful call.
+   *
+   * TypeScript only allows assertion calls through explicitly typed names, so
+   * call this on a `class` declaration. For a class stored in a `const`, use
+   * the standalone {@link invariant} function instead.
+   *
+   * @example
+   * ```ts
+   * MissingUserError.invariant(
+   *   user,
+   *   () => ({ userId }),
+   *   { cause },
+   * );
+   *
+   * user.id; // narrowed to the truthy branch
+   * ```
+   */
+  invariant<Condition, Input>(this: new (input: Input, options?: ErrorOptions) => Error, condition: Condition, input: InvariantInput<Input>, options?: ErrorOptions): asserts condition;
+}
+/**
+ * The instance type shared by every error in one family.
+ *
+ * Definition-derived fields use the schema's general output type, and the data
+ * property is `unknown` because each concrete error types its own data.
+ */
+/**
+ * The shared native `Error` base created for one blueprint.
+ *
+ * Use `factory.Error` for family-wide `instanceof` checks or as a public base
+ * type for errors created by the same blueprint.
+ */
+type FamilyErrorClass<Instance extends Error = Error> = (abstract new (...arguments_: never[]) => Instance) & ErrorClassStatics;
+/** An extendable concrete error class produced by a configured factory. */
+interface ConcreteErrorClass<Input, Instance> extends ErrorClassStatics {
+  /**
+   * Creates an error from family-specific input.
+   *
+   * Pass native `ErrorOptions` as the second argument to preserve a `cause`.
+   */
+  new (input: Input, options?: ErrorOptions): Instance;
+}
+type ImplementedErrorClass<Config, Definition, Input, Data> = ConcreteErrorClass<ConstructorInput<Config, Input>, InstanceProperties<Config, Definition, Data, PassedImplementationCallback<Config, Definition, Data>>>;
+type ExtendsNever<Value, OnTrue, OnFalse> = [Value] extends [never] ? OnTrue : OnFalse;
+//#endregion
+export { FamilyErrorClass, ImplementedErrorClass };
+//# sourceMappingURL=types.d.mts.map

package/dist/node_modules/.pnpm/@jfdevelops_create-error@0.2.0_patch_hash_afc71b16c3f866f54416d30f467784ddc31736feb04f281a5fc4772ea422f4a9/node_modules/@jfdevelops/create-error/dist/types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","names":["Kind","Payload","typeSlot","kind","payload","Schema","StandardSchemaV1","InferInput","InferOutput","Input","Definition","Record","Exclude","DefinitionOutput","Key","TypeSlot","Argument$1","argument","definition","DefinitionTemplate","data","DataSlot","implementation","ImplementationSlot","input","property","resolve","ResolveContext","context","message","BlueprintContext","properties","toJSON","Error","error","Config","arguments_","_Arguments","Resolved","Template","PropertyKey","Data","Omit","Extract","InjectedDefinitionKeys","ResolveTemplate","Values","Implementation","Index","ReplaceTemplate","Date","RegExp","ReadonlyMap","ReadonlySet","WeakMap","WeakSet","PromiseLike","ArrayBuffer","ArrayBufferView","Type","OpaqueObject","Arguments","Result","ReplaceTuple","Properties","Property","DataPropertyTemplate","PropertiesTemplate","Json","Message","MessageTemplate","Argument","ImplementationArgumentWithDefinition","ImplementationArgument","PassedImplementationArgument","ExtendsNever","invariant","Condition","ErrorOptions","options","this","condition","InvariantInput","InstanceProperties","ConcreteDefinition","Instance","ErrorClassStatics","ConcreteErrorClass","ConstructorInput","PassedImplementationCallback","Value","OnTrue","OnFalse","InferredData","name","implement","DefaultBuilderData","Expand","ImplementationCallback","BuilderData","ImplementOptions","ImplementedErrorClass","BuilderInput","ImplementationBuilder","defineContext","ContextSchema","DefinitionInput","ExactDefinition","ErrorDefinitionBuilder","FamilyErrorClass","FamilyError","is","value"],"sources":["../../../../../../../../../../node_modules/.pnpm/@jfdevelops+create-error@0.2.0_patch_hash=afc71b16c3f866f54416d30f467784ddc31736feb04f281a5fc4772ea422f4a9/node_modules/@jfdevelops/create-error/dist/types.d.mts"],"x_google_ignoreList":[0],"mappings":";;cAGc,QAAA;;KAET,QAAA;EAAA,UACO,QAAA;IAAA,SACCG,IAAAA,EAAM,IAAA;IAAA,SACNC,OAAAA,EAAS,OAAA;EAAA;AAAA;AAAA,KAQjB,QAAA,GAAW,QAAQ;AAAA,KA8HnB,eAAA,WAA0B,MAAM;EACnCgB,IAAAA;IACEM,OAAAA,MAAaU,UAAAA;EAAAA;AAAAA,IAEbE,QAAAA;AAAAA,KACC,sBAAA,6BAAmD,QAAA,GAAW,QAAA,CAAS,GAAA,UAAa,QAAA,eAAuB,WAAA,IAAe,GAAA,iBAAoB,QAAA;AAAA,KAC9I,gBAAA,iBAAiC,IAAA,mCAAuCF,UAAAA,yBAAmC,IAAA,GAAO,IAAA,kBAAsB,IAAA,CAAK,IAAA,EAAM,OAAA,CAAQ,sBAAA,CAAuB,eAAA,CAAgB,MAAA,UAAgB,IAAA,KAAS,IAAA;AAAA,KAC3N,YAAA,0FAAsG,MAAA,GAAS,eAAA,CAAgB,MAAA,CAAO,KAAA,GAAQ,UAAA,EAAY,IAAA,EAAM,cAAA;;;;;KAKhK,YAAA,GAAe,IAAA,GAAO,MAAA,GAAS,WAAA,qBAAgC,WAAA,YAAuB,OAAA,oBAA2B,OAAA,WAAkB,WAAA,YAAuB,WAAA,GAAc,eAAA;AAAA,KACxK,eAAA,2CAA0D,IAAA,SAAa,QAAA,4BAAoCtB,GAAAA,eAAkB,UAAA,GAAa,UAAA,CAAW,GAAA,YAAe,IAAA,SAAa,QAAA,WAAmB,IAAA,GAAO,IAAA,SAAa,QAAA,qBAA6B,cAAA,GAAiB,IAAA,SAAa,YAAA,GAAe,IAAA,GAAO,IAAA,cAAkBsB,UAAAA,0CAAoDA,UAAAA,EAAY,YAAA,CAAa,SAAA,EAAW,UAAA,EAAY,IAAA,EAAM,cAAA,MAAoB,eAAA,CAAgB,MAAA,EAAQ,UAAA,EAAY,IAAA,EAAM,cAAA,IAAkB,IAAA,8BAAkC,YAAA,CAAa,IAAA,EAAM,UAAA,EAAY,IAAA,EAAM,cAAA,IAAkB,IAAA,kCAAsC,IAAA,GAAO,eAAA,CAAgB,IAAA,CAAK,GAAA,GAAM,UAAA,EAAY,IAAA,EAAM,cAAA,MAAoB,IAAA;AAAA,KAC5rB,kBAAA,WAA6B,MAAM;EACtCL,UAAAA,MAAgBK,UAAAA;AAAAA,IACd4B,UAAAA;AAAAA,KACC,oBAAA,WAA+B,MAAA;EAClC5C,IAAAA;IACEK,QAAAA;EAAAA;AAAAA,cAEU,QAAA,GAAW,QAAA;;;;;;;KAQpB,kBAAA,6CAA+D,eAAA,CAAgB,kBAAA,CAAmB,MAAA,GAAS,UAAA,EAAY,IAAA,EAAM,cAAA,IAAkB,eAAA,CAAgB,oBAAA,CAAqB,MAAA,GAAS,UAAA,EAAY,IAAA,EAAM,cAAA,IAAkB,KAAA,IAAS,MAAA;EAC7OO,MAAAA,MAAYI,UAAAA;AAAAA;EAEZJ,MAAAA,IAAU,eAAA,CAAgB,IAAA,EAAM,UAAA,EAAY,IAAA,EAAM,cAAA;AAAA;AAAA,KAE/C,eAAA,WAA0B,MAAM;EACnCH,OAAAA,MAAaO,UAAAA;AAAAA,IACXiC,OAAAA;AAAAA,KAIC,4BAAA,6BAAyD,eAAA,CAAgB,MAAA,UAAgB,QAAA,6CAAqDE,QAAAA,SAAiB,QAAA,WAAmB,IAAA,GAAO,eAAA,CAAgB,QAAA,EAAU,UAAA,EAAY,IAAA;AAAA,KAC/N,4BAAA,8BAA0DtD,QAAAA,EAAU,4BAAA,CAA6B,MAAA,EAAQ,UAAA,EAAY,IAAA;;;;;;KAMrH,cAAA,UAAwB,YAAA,CAAa,OAAA,CAAQ,KAAA,MAAWmB,UAAAA,wBAAkC,KAAA,UAAe,KAAA,SAAc,KAAA;AAAA,UAClH,iBAAA;EAnC2rB;;;;;;;;;;;;;;;;;;;;;;EA0DnsBwC,SAAAA,mBAA4BI,IAAAA,OAAWxD,KAAAA,EAAO,KAAA,EAAOuD,OAAAA,GAAU,YAAA,KAAiB,KAAA,EAAOE,SAAAA,EAAW,SAAA,EAAWzD,KAAAA,EAAO,cAAA,CAAe,KAAA,GAAQuD,OAAAA,GAAU,YAAA,WAAuBE,SAAAA;AAAAA;;;;;;;;;;;;;KAezK,gBAAA,kBAAkC,KAAA,GAAQ,KAAA,sBAA2B7C,UAAAA,cAAwB,QAAA,IAAY,iBAAA;;UAEpG,kBAAA,0BAA4C,iBAAA;EA3Eyf1B;;;;;EAAAA,KAiFxiBc,KAAAA,EAAO,KAAA,EAAOuD,OAAAA,GAAU,YAAA,GAAe,QAAA;AAAA;AAAA,KAEzC,qBAAA,oCAAyD,kBAAA,CAAmB,gBAAA,CAAiB,MAAA,EAAQ,KAAA,GAAQ,kBAAA,CAAmB,MAAA,EAAQ,UAAA,EAAY,IAAA,EAAM,4BAAA,CAA6B,MAAA,EAAQ,UAAA,EAAY,IAAA;AAAA,KAC3M,YAAA,4BAAwC,KAAA,oBAAyB,MAAA,GAAS,OAAA"}

package/dist/resource.cjs

@@ -1,3 +1,4 @@
+const require_layout_configuration_error = require('./errors/layout-configuration-error.cjs');
 
 //#region src/resource.ts
 function normalizeResourceTree(resource) {
@@ -23,7 +24,7 @@ function createIsValidResourceFn(resources) {
 }
 function toResourceEnum(resources) {
 	const keys = Object.keys(resources);
-	if (keys.length === 0) throw new Error("No resources provided");
+	if (keys.length === 0) throw new require_layout_configuration_error.LayoutConfigurationError("No resources provided");
 	return keys;
 }
 

package/dist/resource.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"resource.cjs","names":[],"sources":["../src/resource.ts"],"sourcesContent":["import { ReactNode } from 'react';\nimport { NonEmptyReadonlyArray } from '@jfdevelops/react-layout-validator';\nimport { MergeIntersection, UnionToIntersection } from './utils';\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 Error('No resources provided');\n  }\n\n  return keys as unknown as ResourceEnum<Resources>;\n}\n"],"mappings":";;AAuDA,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,MAAM,uBAAuB;CAGzC,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\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"}

package/dist/resource.d.cts.map

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

package/dist/resource.d.mts.map

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

package/dist/resource.mjs

@@ -1,3 +1,5 @@
+import { LayoutConfigurationError } from "./errors/layout-configuration-error.mjs";
+
 //#region src/resource.ts
 function normalizeResourceTree(resource) {
 	if (typeof resource === "string") return { [resource]: { subResources: {} } };
@@ -22,7 +24,7 @@ function createIsValidResourceFn(resources) {
 }
 function toResourceEnum(resources) {
 	const keys = Object.keys(resources);
-	if (keys.length === 0) throw new Error("No resources provided");
+	if (keys.length === 0) throw new LayoutConfigurationError("No resources provided");
 	return keys;
 }
 

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';\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 Error('No resources provided');\n  }\n\n  return keys as unknown as ResourceEnum<Resources>;\n}\n"],"mappings":";AAuDA,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,MAAM,uBAAuB;CAGzC,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\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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jfdevelops/react-layout",
-  "version": "0.22.0",
+  "version": "0.23.0",
   "description": "A React library for creating layout components.",
   "repository": {
     "type": "git",
@@ -27,8 +27,10 @@
     "node": "^20.19.0 || >=22.12.0"
   },
   "dependencies": {
-    "@jfdevelops/react-layout-composables": "0.2.6",
-    "@jfdevelops/react-layout-validator": "0.2.6"
+    "@jfdevelops/create-error": "0.2.0",
+    "arktype": "2.2.8",
+    "@jfdevelops/react-layout-composables": "0.2.7",
+    "@jfdevelops/react-layout-validator": "0.2.7"
   },
   "peerDependencies": {
     "react": ">=18",
@@ -39,20 +41,20 @@
     "provenance": true
   },
   "devDependencies": {
-    "@vitest/coverage-v8": "4.1.5",
-    "@vitest/ui": "4.1.5",
     "@testing-library/jest-dom": "6.9.1",
     "@testing-library/react": "16.3.2",
     "@types/node": "24.10.1",
     "@types/react": "18.3.28",
     "@types/react-dom": "18.3.7",
     "@vitejs/plugin-react": "6.0.1",
+    "@vitest/coverage-v8": "4.1.5",
+    "@vitest/ui": "4.1.5",
     "jsdom": "29.0.2",
     "react": "18.3.1",
     "react-dom": "18.3.1",
     "tsdown": "0.22.1",
-    "unrun": "0.3.0",
     "typescript": "6.0.3",
+    "unrun": "0.3.0",
     "vite": "8.0.10",
     "vitest": "4.1.5"
   },