@jfdevelops/react-layout 1.6.1 → 2.1.0

package/dist/props.cjs.map

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

package/dist/props.d.cts

@@ -41,48 +41,11 @@ type RequiredVariant = true | 'required';
 type PropsType<Variant extends RequiredVariant = true> = Variant | 'optional';
 type InternalPropsType = PropsType<'required'>;
 type IncludedPropSource = 'component' | 'config';
-type IncludedPropRequirement = {
-  /**
-   * Whether the prop must be supplied. When both names are present,
-   * `required` takes precedence over the deprecated `visibility` setting.
-   */
+/** Controls whether an included prop is required and where it is supplied. */
+type IncludedPropBehavior = {
   required: boolean;
-} | {
-  /**
-   * Whether the prop must be supplied (`'required'`) or may be omitted
-   * (`'optional'`). The `required` setting takes precedence when both are present.
-   *
-   * @deprecated Use `required: true` instead of `visibility: 'required'`, or
-   * `required: false` instead of `visibility: 'optional'`.
-   * This property will be removed in the next major version.
-   */
-  visibility: 'optional' | 'required';
-};
-type IncludedPropSupply = {
-  /**
-   * Where the prop is supplied: at component render time (`'component'`)
-   * or through layout creation options (`'config'`). Optional component props
-   * also accept configuration-time defaults. This setting takes precedence
-   * over the deprecated `passthrough` setting.
-   */
   suppliedVia: IncludedPropSource;
-} | {
-  /**
-   * Where the prop is supplied: at component render time (`'component'`)
-   * or through layout creation options (`'config'`). Optional component props
-   * also accept configuration-time defaults. The `suppliedVia` setting takes
-   * precedence when both names are present.
-   *
-   * @deprecated Use `suppliedVia: 'component'` instead of
-   * `passthrough: 'component'`, or `suppliedVia: 'config'` instead of
-   * `passthrough: 'config'`. This property will be removed in the next major version.
-   */
-  passthrough: IncludedPropSource;
 };
-/**
- * Controls where an included layout prop is supplied and whether it is required there.
- */
-type IncludedPropBehavior = IncludedPropRequirement & IncludedPropSupply;
 type IncludedPropType = PropsType | IncludedPropBehavior;
 /**
  * A map of props to include in the layout.
@@ -91,16 +54,12 @@ type IncludedProps<T extends object> = { [K in keyof T & string]?: IncludedPropT
 type PropsKeys<Props extends InPropsObject, T> = T & keyof Props;
 type IncludedPropVisibility<Value> = Value extends {
   required: boolean;
-} ? Value['required'] extends true ? 'required' : 'optional' : Value extends {
-  visibility: 'required' | 'optional';
-} ? Value['visibility'] : Value extends true | 'required' ? 'required' : Value extends 'optional' ? 'optional' : never;
+} ? Value['required'] extends true ? 'required' : 'optional' : Value extends true | 'required' ? 'required' : Value extends 'optional' ? 'optional' : never;
 type IncludedPropSupplySource<Value> = Value extends {
   suppliedVia: IncludedPropSource;
-} ? Value['suppliedVia'] : Value extends {
-  passthrough: IncludedPropSource;
-} ? Value['passthrough'] : never;
+} ? Value['suppliedVia'] : never;
 /**
- * Canonical shape used internally for either spelling of an include behavior.
+ * Internal representation of the supported include behavior.
  */
 type NormalizedIncludedPropBehavior<Value> = Value extends {
   required: boolean;
@@ -114,10 +73,7 @@ type IncludedPropPassthrough<Value> = Value extends {
   required: boolean;
 } | {
   suppliedVia: IncludedPropSource;
-} ? IncludedPropSupplySource<Value> extends 'component' ? IncludedPropVisibility<Value> extends 'optional' ? 'component' | 'config' : 'component' : IncludedPropSupplySource<Value> : Value extends {
-  visibility: 'required' | 'optional';
-  passthrough: IncludedPropSource;
-} ? Value['passthrough'] extends 'component' ? Value['visibility'] extends 'optional' ? 'component' | 'config' : 'component' : Value['passthrough'] : Value extends true | 'required' ? 'config' : Value extends 'optional' ? 'component' | 'config' : never;
+} ? IncludedPropSupplySource<Value> extends 'component' ? IncludedPropVisibility<Value> extends 'optional' ? 'component' | 'config' : 'component' : IncludedPropSupplySource<Value> : Value extends true | 'required' ? 'config' : Value extends 'optional' ? 'component' | 'config' : never;
 type GetPropsKey<IncludeProps extends object, Visibility extends InternalPropsType, Passthrough extends IncludedPropSource | '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 IncludedPropSource | 'render' = 'render'> = Pick<Props, PropsKeys<Props, GetPropsKey<IncludeProps, Visibility, Passthrough>>>;
 type OptionalPropDefinition<Definition> = Definition extends {

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":";;;;;;AAuBA;;;;;AAAA,KAAY,kBAAA,4CACV,KAAA,EAAO,WAAA,EACP,OAAA,EAAS,OAAA,KACN,MAAA;;;;;;;;;;;;UAaY,qBAAA,SACP,aAAA,iBACM,KAAA,SAAc,aAAA,GAAgB,YAAA,CAAa,KAAA;EAIzD,KAAA,GAAQ,KAAA;EACR,MAAA,EAAQ,kBAAA,CAAmB,WAAA,EAAa,OAAA,EAAS,MAAA;AAAA;AAAA,KAGvC,cAAA,mBACQ,aAAA,CAAc,kBAAA;EAGhC,IAAA,EAAM,kBAAA,CAAmB,IAAA;EACzB,QAAA,EAAU,eAAA,CAAgB,YAAA,CAAa,SAAA;AAAA;AAAA,KAE7B,eAAA,mBACQ,aAAA,CAAc,kBAAA,2BAEhC,KAAA,EAAO,IAAA,CAAK,cAAA,CAAe,SAAA,EAAW,IAAA,OACnC,aAAA;AAAA,KACO,iBAAA,mBACQ,aAAA,CAAc,kBAAA,KAC9B,aAAA,GAAgB,eAAA,CAAgB,SAAA;AAAA,KACxB,eAAA,mBACQ,aAAA,CAAc,kBAAA,mBAChB,iBAAA,CAAkB,SAAA,KAChC,OAAA,SAAgB,eAAA,CAAgB,SAAA,IAAa,UAAA,CAAW,OAAA,IAAW,OAAA;AAAA,KAC3D,mBAAA,mBACQ,aAAA,CAAc,kBAAA,mBAChB,iBAAA,CAAkB,SAAA,uBACd,oBAAA,IAEpB,eAAA,CAAgB,SAAA,EAAW,OAAA,UAAiB,aAAA,GACxC,eAAA,CAAgB,SAAA,EAAW,OAAA,IAAW,gBAAA,CAAiB,WAAA;AAAA,KAEjD,eAAA;;;;;KAKP,SAAA,iBAA0B,eAAA,WAA0B,OAAO;AAAA,KAC3D,iBAAA,GAAoB,SAAS;AAAA,KAC7B,kBAAA;;KAEO,oBAAA;EACV,QAAA;EACA,WAAA,EAAa,kBAAkB;AAAA;AAAA,KAG5B,gBAAA,GAAmB,SAAA,GAAY,oBAAoB;;;;KAI5C,aAAA,mCACE,CAAA,aAAc,gBAAgB;AAAA,KAGvC,SAAA,eAAwB,aAAA,OAAoB,CAAA,SAAU,KAAA;AAAA,KAC/C,sBAAA,UAAgC,KAAA;EAAgB,QAAA;AAAA,IACxD,KAAA,sDAGA,KAAA,0CAEE,KAAA;AAAA,KAGM,wBAAA,UAAkC,KAAA;EAC5C,WAAA,EAAa,kBAAA;AAAA,IAEX,KAAA;;;;KAKQ,8BAAA,UAAwC,KAAA;EAC9C,QAAA;AAAA;EACA,WAAA,EAAa,kBAAA;AAAA;EAEb,UAAA,EAAY,sBAAA,CAAuB,KAAA;EACnC,WAAA,EAAa,wBAAA,CAAyB,KAAA;AAAA,IAExC,KAAA;AAAA,KAEQ,uBAAA,UAAiC,KAAA;EACvC,QAAA;AAAA;EACA,WAAA,EAAa,kBAAA;AAAA,IACf,wBAAA,CAAyB,KAAA,wBACvB,sBAAA,CAAuB,KAAA,8DAGvB,wBAAA,CAAyB,KAAA,IAC3B,KAAA,wCAEE,KAAA;AAAA,KAID,WAAA,iDAEgB,iBAAA,sBACC,kBAAA,0CAEN,YAAA,GAAe,sBAAA,CAC3B,YAAA,CAAa,GAAA,WACL,UAAA,GACN,WAAA,oBACE,GAAA,GACA,WAAA,SAAoB,uBAAA,CAAwB,YAAA,CAAa,GAAA,KACvD,GAAA,yBAGF,YAAA;AAAA,KACH,qBAAA,eACW,aAAA,uBACO,aAAA,CAAc,KAAA,sBAChB,iBAAA,sBACC,kBAAA,0BAClB,IAAA,CACF,KAAA,EACA,SAAA,CAAU,KAAA,EAAO,WAAA,CAAY,YAAA,EAAc,UAAA,EAAY,WAAA;AAAA,KAGpD,sBAAA,eAAqC,UAAA;EACxC,QAAA;AAAA,IAEE,kBAAA,GACA,UAAU;;KAGF,gCAAA,eACI,aAAA,uBACO,aAAA,CAAc,KAAA,KACjC,qBAAA,CAAsB,KAAA,EAAO,YAAA,6CACjB,qBAAA,CACZ,KAAA,EACA,YAAA,6BAGE,sBAAA,CACF,qBAAA,CAAsB,KAAA,EAAO,YAAA,2BAAuC,GAAA;AAAA,KAI5D,qBAAA,eACI,aAAA,uBACO,aAAA,CAAc,KAAA,KACjC,kBAAA,CAAmB,qBAAA,CAAsB,KAAA,EAAO,YAAA,iBAClD,OAAA,CACE,kBAAA,CAAmB,qBAAA,CAAsB,KAAA,EAAO,YAAA;AAAA,KAGxC,2BAAA,eACI,aAAA,uBACO,aAAA,CAAc,KAAA,KACjC,kBAAA,CACF,qBAAA,CAAsB,KAAA,EAAO,YAAA,2BAE7B,OAAA,CACE,kBAAA,CACE,qBAAA,CAAsB,KAAA,EAAO,YAAA;AAAA,KAIvB,8BAAA,eACI,aAAA,uBACO,aAAA,CAAc,KAAA,KACjC,kBAAA,CACF,qBAAA,CAAsB,KAAA,EAAO,YAAA,8BAE7B,OAAA,CACE,kBAAA,CACE,qBAAA,CAAsB,KAAA,EAAO,YAAA;;;;;KAQvB,8BAAA,eACI,aAAA,uBACO,aAAA,CAAc,KAAA,KACjC,2BAAA,CACF,qBAAA,CAAsB,KAAA,EAAO,YAAA,iBAE7B,OAAA,CACE,2BAAA,CACE,qBAAA,CAAsB,KAAA,EAAO,YAAA;AAAA,KAGvB,iBAAA,mBACQ,aAAA,CAAc,kBAAA,mBAChB,iBAAA,CAAkB,SAAA,uBACd,oBAAA,4BACC,aAAA,CACnB,mBAAA,CAAoB,SAAA,EAAW,OAAA,EAAS,WAAA,6BAEtB,aAAA,SAClB,IAAA,CACF,YAAA,CAAa,WAAA,IACX,qBAAA,CACE,mBAAA,CAAoB,SAAA,EAAW,OAAA,EAAS,WAAA,GACxC,YAAA"}

package/dist/props.d.mts

@@ -41,48 +41,11 @@ type RequiredVariant = true | 'required';
 type PropsType<Variant extends RequiredVariant = true> = Variant | 'optional';
 type InternalPropsType = PropsType<'required'>;
 type IncludedPropSource = 'component' | 'config';
-type IncludedPropRequirement = {
-  /**
-   * Whether the prop must be supplied. When both names are present,
-   * `required` takes precedence over the deprecated `visibility` setting.
-   */
+/** Controls whether an included prop is required and where it is supplied. */
+type IncludedPropBehavior = {
   required: boolean;
-} | {
-  /**
-   * Whether the prop must be supplied (`'required'`) or may be omitted
-   * (`'optional'`). The `required` setting takes precedence when both are present.
-   *
-   * @deprecated Use `required: true` instead of `visibility: 'required'`, or
-   * `required: false` instead of `visibility: 'optional'`.
-   * This property will be removed in the next major version.
-   */
-  visibility: 'optional' | 'required';
-};
-type IncludedPropSupply = {
-  /**
-   * Where the prop is supplied: at component render time (`'component'`)
-   * or through layout creation options (`'config'`). Optional component props
-   * also accept configuration-time defaults. This setting takes precedence
-   * over the deprecated `passthrough` setting.
-   */
   suppliedVia: IncludedPropSource;
-} | {
-  /**
-   * Where the prop is supplied: at component render time (`'component'`)
-   * or through layout creation options (`'config'`). Optional component props
-   * also accept configuration-time defaults. The `suppliedVia` setting takes
-   * precedence when both names are present.
-   *
-   * @deprecated Use `suppliedVia: 'component'` instead of
-   * `passthrough: 'component'`, or `suppliedVia: 'config'` instead of
-   * `passthrough: 'config'`. This property will be removed in the next major version.
-   */
-  passthrough: IncludedPropSource;
 };
-/**
- * Controls where an included layout prop is supplied and whether it is required there.
- */
-type IncludedPropBehavior = IncludedPropRequirement & IncludedPropSupply;
 type IncludedPropType = PropsType | IncludedPropBehavior;
 /**
  * A map of props to include in the layout.
@@ -91,16 +54,12 @@ type IncludedProps<T extends object> = { [K in keyof T & string]?: IncludedPropT
 type PropsKeys<Props extends InPropsObject, T> = T & keyof Props;
 type IncludedPropVisibility<Value> = Value extends {
   required: boolean;
-} ? Value['required'] extends true ? 'required' : 'optional' : Value extends {
-  visibility: 'required' | 'optional';
-} ? Value['visibility'] : Value extends true | 'required' ? 'required' : Value extends 'optional' ? 'optional' : never;
+} ? Value['required'] extends true ? 'required' : 'optional' : Value extends true | 'required' ? 'required' : Value extends 'optional' ? 'optional' : never;
 type IncludedPropSupplySource<Value> = Value extends {
   suppliedVia: IncludedPropSource;
-} ? Value['suppliedVia'] : Value extends {
-  passthrough: IncludedPropSource;
-} ? Value['passthrough'] : never;
+} ? Value['suppliedVia'] : never;
 /**
- * Canonical shape used internally for either spelling of an include behavior.
+ * Internal representation of the supported include behavior.
  */
 type NormalizedIncludedPropBehavior<Value> = Value extends {
   required: boolean;
@@ -114,10 +73,7 @@ type IncludedPropPassthrough<Value> = Value extends {
   required: boolean;
 } | {
   suppliedVia: IncludedPropSource;
-} ? IncludedPropSupplySource<Value> extends 'component' ? IncludedPropVisibility<Value> extends 'optional' ? 'component' | 'config' : 'component' : IncludedPropSupplySource<Value> : Value extends {
-  visibility: 'required' | 'optional';
-  passthrough: IncludedPropSource;
-} ? Value['passthrough'] extends 'component' ? Value['visibility'] extends 'optional' ? 'component' | 'config' : 'component' : Value['passthrough'] : Value extends true | 'required' ? 'config' : Value extends 'optional' ? 'component' | 'config' : never;
+} ? IncludedPropSupplySource<Value> extends 'component' ? IncludedPropVisibility<Value> extends 'optional' ? 'component' | 'config' : 'component' : IncludedPropSupplySource<Value> : Value extends true | 'required' ? 'config' : Value extends 'optional' ? 'component' | 'config' : never;
 type GetPropsKey<IncludeProps extends object, Visibility extends InternalPropsType, Passthrough extends IncludedPropSource | '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 IncludedPropSource | 'render' = 'render'> = Pick<Props, PropsKeys<Props, GetPropsKey<IncludeProps, Visibility, Passthrough>>>;
 type OptionalPropDefinition<Definition> = Definition extends {

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/props.mjs

@@ -1,8 +1,11 @@
+import { LayoutConfigurationError } from "./errors/layout-configuration-error.mjs";
+
 //#region src/props.ts
 function getIncludedPropBehavior(value) {
 	if (value === null || typeof value !== "object") return null;
-	const required = "required" in value && typeof value.required === "boolean" ? value.required : "visibility" in value ? value.visibility === "required" : void 0;
-	const suppliedVia = "suppliedVia" in value ? value.suppliedVia : "passthrough" in value ? value.passthrough : void 0;
+	if ("visibility" in value || "passthrough" in value) throw new LayoutConfigurationError("Include properties visibility and passthrough were removed; use required and suppliedVia.");
+	const required = "required" in value && typeof value.required === "boolean" ? value.required : void 0;
+	const suppliedVia = "suppliedVia" in value ? value.suppliedVia : void 0;
 	if (required === void 0 || suppliedVia !== "component" && suppliedVia !== "config") return null;
 	return {
 		visibility: required ? "required" : "optional",

package/dist/props.mjs.map

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

package/dist/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\n/**\n * A resource definition normalized to an object with a stable `value` key.\n * `subResources` is present only when it existed on the declared resource.\n */\nexport type NormalizedResourceDefinition<\n  Resource extends ResourceDefinition = ResourceDefinition,\n> = Resource extends string\n  ? { value: Resource }\n  : Resource extends {\n        value: infer Value extends string;\n        subResources: infer SubResources extends ReadonlyArray<ResourceDefinition>;\n      }\n    ? {\n        value: Value;\n        subResources: NormalizedResourceDefinitions<SubResources>;\n      }\n    : never;\n\n/**\n * A tuple of resource definitions with strings converted to `{ value }`\n * objects and nested sub-resources normalized recursively.\n */\nexport type NormalizedResourceDefinitions<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = {\n  readonly [Index in keyof Resources]: Resources[Index] extends ResourceDefinition\n    ? NormalizedResourceDefinition<Resources[Index]>\n    : never;\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\n/**\n * Normalizes public resource declarations to a consistent object shape while\n * preserving tuple positions and string literals in the returned type.\n *\n * @param resources - Resource definitions in their original declared form.\n * @returns A recursively normalized tuple whose entries always have `value`.\n */\nexport function normalizeResourceDefinitions<\n  const Resources extends ReadonlyArray<ResourceDefinition>,\n>(resources: Resources): NormalizedResourceDefinitions<Resources> {\n  return resources.map((resource) => {\n    if (typeof resource === 'string') {\n      return { value: resource };\n    }\n\n    return {\n      value: resource.value,\n      subResources: normalizeResourceDefinitions(resource.subResources),\n    };\n  }) as NormalizedResourceDefinitions<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":";;;AAsFA,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;;;;;;;;AASA,SAAgB,6BAEd,WAAgE;CAChE,OAAO,UAAU,KAAK,aAAa;EACjC,IAAI,OAAO,aAAa,UACtB,OAAO,EAAE,OAAO,SAAS;EAG3B,OAAO;GACL,OAAO,SAAS;GAChB,cAAc,6BAA6B,SAAS,YAAY;EAClE;CACF,CAAC;AACH;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"}
+{"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\n/**\n * A resource definition normalized to an object with a stable `value` key.\n * `subResources` is present only when it existed on the declared resource.\n */\nexport type NormalizedResourceDefinition<\n  Resource extends ResourceDefinition = ResourceDefinition,\n> = Resource extends string\n  ? { value: Resource }\n  : Resource extends {\n        value: infer Value extends string;\n        subResources: infer SubResources extends ReadonlyArray<ResourceDefinition>;\n      }\n    ? {\n        value: Value;\n        subResources: NormalizedResourceDefinitions<SubResources>;\n      }\n    : never;\n\n/**\n * A tuple of resource definitions with strings converted to `{ value }`\n * objects and nested sub-resources normalized recursively.\n */\nexport type NormalizedResourceDefinitions<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = {\n  readonly [Index in keyof Resources]: Resources[Index] extends ResourceDefinition\n    ? NormalizedResourceDefinition<Resources[Index]>\n    : never;\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\n/**\n * Normalizes public resource declarations to a consistent object shape while\n * preserving tuple positions and string literals in the returned type.\n *\n * @param resources - Resource definitions in their original declared form.\n * @returns A recursively normalized tuple whose entries always have `value`.\n */\nexport function normalizeResourceDefinitions<\n  const Resources extends ReadonlyArray<ResourceDefinition>,\n>(resources: Resources): NormalizedResourceDefinitions<Resources> {\n  return resources.map((resource) => {\n    if (typeof resource === 'string') {\n      return { value: resource };\n    }\n\n    return {\n      value: resource.value,\n      subResources: normalizeResourceDefinitions(resource.subResources),\n    };\n  }) as NormalizedResourceDefinitions<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> = ResourceDefinition extends Resources[number] ? string : 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":";;;AAsFA,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;;;;;;;;AASA,SAAgB,6BAEd,WAAgE;CAChE,OAAO,UAAU,KAAK,aAAa;EACjC,IAAI,OAAO,aAAa,UACtB,OAAO,EAAE,OAAO,SAAS;EAG3B,OAAO;GACL,OAAO,SAAS;GAChB,cAAc,6BAA6B,SAAS,YAAY;EAClE;CACF,CAAC;AACH;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

@@ -65,7 +65,7 @@ type NestedResourcePath<Definition extends ResourceDefinition, Prefix extends st
   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]>;
+type ResourcePath<Resources extends ReadonlyArray<ResourceDefinition>> = ResourceDefinition extends Resources[number] ? string : NestedResourcePath<Resources[number]>;
 /**
  * Top-level resource names declared in a `resources` array. Preserves string
  * literal unions for const resource definitions (unlike `keyof` on the

package/dist/resource.d.cts.map

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

package/dist/resource.d.mts

@@ -65,7 +65,7 @@ type NestedResourcePath<Definition extends ResourceDefinition, Prefix extends st
   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]>;
+type ResourcePath<Resources extends ReadonlyArray<ResourceDefinition>> = ResourceDefinition extends Resources[number] ? string : NestedResourcePath<Resources[number]>;
 /**
  * Top-level resource names declared in a `resources` array. Preserves string
  * literal unions for const resource definitions (unlike `keyof` on the

package/dist/resource.d.mts.map

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

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\n/**\n * A resource definition normalized to an object with a stable `value` key.\n * `subResources` is present only when it existed on the declared resource.\n */\nexport type NormalizedResourceDefinition<\n  Resource extends ResourceDefinition = ResourceDefinition,\n> = Resource extends string\n  ? { value: Resource }\n  : Resource extends {\n        value: infer Value extends string;\n        subResources: infer SubResources extends ReadonlyArray<ResourceDefinition>;\n      }\n    ? {\n        value: Value;\n        subResources: NormalizedResourceDefinitions<SubResources>;\n      }\n    : never;\n\n/**\n * A tuple of resource definitions with strings converted to `{ value }`\n * objects and nested sub-resources normalized recursively.\n */\nexport type NormalizedResourceDefinitions<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = {\n  readonly [Index in keyof Resources]: Resources[Index] extends ResourceDefinition\n    ? NormalizedResourceDefinition<Resources[Index]>\n    : never;\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\n/**\n * Normalizes public resource declarations to a consistent object shape while\n * preserving tuple positions and string literals in the returned type.\n *\n * @param resources - Resource definitions in their original declared form.\n * @returns A recursively normalized tuple whose entries always have `value`.\n */\nexport function normalizeResourceDefinitions<\n  const Resources extends ReadonlyArray<ResourceDefinition>,\n>(resources: Resources): NormalizedResourceDefinitions<Resources> {\n  return resources.map((resource) => {\n    if (typeof resource === 'string') {\n      return { value: resource };\n    }\n\n    return {\n      value: resource.value,\n      subResources: normalizeResourceDefinitions(resource.subResources),\n    };\n  }) as NormalizedResourceDefinitions<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":";;;AAsFA,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;;;;;;;;AASA,SAAgB,6BAEd,WAAgE;CAChE,OAAO,UAAU,KAAK,aAAa;EACjC,IAAI,OAAO,aAAa,UACtB,OAAO,EAAE,OAAO,SAAS;EAG3B,OAAO;GACL,OAAO,SAAS;GAChB,cAAc,6BAA6B,SAAS,YAAY;EAClE;CACF,CAAC;AACH;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"}
+{"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\n/**\n * A resource definition normalized to an object with a stable `value` key.\n * `subResources` is present only when it existed on the declared resource.\n */\nexport type NormalizedResourceDefinition<\n  Resource extends ResourceDefinition = ResourceDefinition,\n> = Resource extends string\n  ? { value: Resource }\n  : Resource extends {\n        value: infer Value extends string;\n        subResources: infer SubResources extends ReadonlyArray<ResourceDefinition>;\n      }\n    ? {\n        value: Value;\n        subResources: NormalizedResourceDefinitions<SubResources>;\n      }\n    : never;\n\n/**\n * A tuple of resource definitions with strings converted to `{ value }`\n * objects and nested sub-resources normalized recursively.\n */\nexport type NormalizedResourceDefinitions<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = {\n  readonly [Index in keyof Resources]: Resources[Index] extends ResourceDefinition\n    ? NormalizedResourceDefinition<Resources[Index]>\n    : never;\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\n/**\n * Normalizes public resource declarations to a consistent object shape while\n * preserving tuple positions and string literals in the returned type.\n *\n * @param resources - Resource definitions in their original declared form.\n * @returns A recursively normalized tuple whose entries always have `value`.\n */\nexport function normalizeResourceDefinitions<\n  const Resources extends ReadonlyArray<ResourceDefinition>,\n>(resources: Resources): NormalizedResourceDefinitions<Resources> {\n  return resources.map((resource) => {\n    if (typeof resource === 'string') {\n      return { value: resource };\n    }\n\n    return {\n      value: resource.value,\n      subResources: normalizeResourceDefinitions(resource.subResources),\n    };\n  }) as NormalizedResourceDefinitions<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> = ResourceDefinition extends Resources[number] ? string : 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":";;;AAsFA,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;;;;;;;;AASA,SAAgB,6BAEd,WAAgE;CAChE,OAAO,UAAU,KAAK,aAAa;EACjC,IAAI,OAAO,aAAa,UACtB,OAAO,EAAE,OAAO,SAAS;EAG3B,OAAO;GACL,OAAO,SAAS;GAChB,cAAc,6BAA6B,SAAS,YAAY;EAClE;CACF,CAAC;AACH;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": "1.6.1",
+  "version": "2.1.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-devtools-core": "0.2.0",
     "@jfdevelops/react-layout-composables": "0.3.1",
+    "@jfdevelops/react-layout-devtools-core": "0.3.0",
     "@jfdevelops/react-layout-validator": "0.3.1"
   },
   "peerDependencies": {