@jfdevelops/react-layout 0.24.2 → 0.24.3

package/dist/create-config/create-resource-links.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"create-resource-links.cjs","names":["LayoutConfigurationError","createIsValidResourceFn"],"sources":["../../src/create-config/create-resource-links.ts"],"sourcesContent":["import type { ElementType, ReactNode } from 'react';\nimport type { NonEmptyReadonlyArray } from '@jfdevelops/react-layout-validator';\nimport {\n  createIsValidResourceFn,\n  type LayoutResourceKey,\n  type ResourceDefinition,\n} from '../resource';\nimport { LayoutConfigurationError } from '../errors';\nimport type {\n  LayoutRenderResourcesAccessor,\n  ResourceSelection,\n} from './define-layout';\n\nexport type ResourceAnchorLinkFn<Resource extends string> = (\n  resource: Resource,\n) => string;\n\nexport type ResourceLinkHref<Resource extends string> =\n  | string\n  | ResourceAnchorLinkFn<Resource>;\n\nexport type ResourceLinkConfigResource<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = LayoutResourceKey<Resources> | (string & {});\n\nexport type ResourceIconFn<Resource = any> = (resource: Resource) => ReactNode;\n\nexport type ResourceIcon<Resource = any> = ReactNode | ResourceIconFn<Resource>;\n\ndeclare const resourceIconInputMarker: unique symbol;\ndeclare const resourceIconComponentInputMarker: unique symbol;\n\ntype ResourceIconInputMarker<Value> = {\n  readonly [resourceIconInputMarker]: Value;\n};\n\ntype ResourceIconComponentInputMarker<Icon extends ElementType> = {\n  readonly [resourceIconComponentInputMarker]: Icon;\n};\n\nexport type ResolveResourceIconInput<Definition> =\n  Definition extends ResourceIconComponentInputMarker<infer Icon>\n    ? Icon\n    : Definition extends ResourceIconInputMarker<infer Value>\n      ? Value\n      : Definition extends ReadonlyArray<unknown>\n        ? { [Index in keyof Definition]: ResolveResourceIconInput<Definition[Index]> }\n        : Definition extends object\n          ? { [Key in keyof Definition]: ResolveResourceIconInput<Definition[Key]> }\n          : Definition;\n\nexport interface DefineResourceIconInputHelpers<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> {\n  resource(): ResourceIconInputMarker<LayoutResourceKey<Resources>>;\n  icon<Icon extends ElementType = ElementType>(): ResourceIconComponentInputMarker<Icon>;\n}\n\nexport interface DefineResourceIconInputResult<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Definition,\n> {\n  render(\n    render: (options: {\n      resource: LayoutRenderResourcesAccessor<Resources>;\n      input: ResolveResourceIconInput<Definition>;\n    }) => ReactNode,\n  ): (\n    input: ResolveResourceIconInput<Definition>,\n  ) => ResourceIconFn<LayoutRenderResourcesAccessor<Resources>>;\n}\n\nexport interface DefineResourceIconFn<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> {\n  <Icon extends ElementType = ElementType>(\n    render: (options: {\n      resource: LayoutRenderResourcesAccessor<Resources>;\n      Icon: Icon;\n    }) => ReactNode,\n  ): (Icon: Icon) => ResourceIconFn<LayoutRenderResourcesAccessor<Resources>>;\n  input<Definition>(\n    defineInput: (\n      helpers: DefineResourceIconInputHelpers<Resources>,\n    ) => Definition,\n  ): DefineResourceIconInputResult<Resources, Definition>;\n}\nexport interface CreateResourceLinkOptions<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends ResourceLinkConfigResource<Resources>,\n> {\n  /**\n   * The label of the link. This is the text that will be displayed in the link.\n   */\n  label: string;\n  /**\n   * An optional icon to render when the link is active.\n   */\n  activeIcon?: ReactNode;\n  /**\n   * An optional icon to register with the link. This is a headless approach, meaning you have full control\n   * over the icon's rendering.\n   */\n  icon?: ResourceIcon<LayoutRenderResourcesAccessor<Resources>>;\n  /**\n   * The href of the link. By default, the href will be `\"/\"`. While you **don't** need to include a hash,\n   * if you do, it will override the `hash` property (if provided).\n   */\n  href?: ResourceLinkHref<Resource>;\n  /**\n   * The hash of the link. By default, the hash will be the resource name. If you need to customize it, you can provide\n   * a string or a function that returns a string.\n   *\n   * @remarks A `\"#\"` is not required. The generated href will include it automatically.\n   */\n  hash?: ResourceLinkHref<Resource>;\n}\n\nexport type CreateResourceLinkConfig<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends ResourceLinkConfigResource<Resources> = ResourceLinkConfigResource<Resources>,\n> = {\n  [Key in Resource]?: CreateResourceLinkOptions<\n    Resources,\n    Key\n  >;\n};\n\nexport type InferHashFromResourceLinkHref<\n  Resource extends string,\n  Hash extends ResourceLinkHref<Resource>,\n> = Hash extends string\n  ? Hash\n  : Hash extends ResourceAnchorLinkFn<Resource>\n    ? ReturnType<Hash>\n    : never;\n\nexport type CreatedResourceHref = {\n  /**\n   * The full generated href with the `hash` if provided.\n   */\n  full: string;\n  /**\n   * The given href. This is the same value as the `href` property of the config.\n   */\n  given: string;\n};\n\nexport type CreatedResourceLinkBase<Resource extends string> = {\n  activeIcon?: ReactNode;\n  href: CreatedResourceHref;\n  label: string;\n  resource: Resource;\n  icon: ResourceIcon;\n};\nexport type CreateResourceLinkWithHash<\n  Resource extends string,\n  Hash extends ResourceLinkHref<Resource>,\n> = Omit<CreatedResourceLinkBase<Resource>, 'href'> & {\n  href: CreatedResourceHref & {\n    hash: InferHashFromResourceLinkHref<Resource, Hash>;\n  };\n};\n\nexport type CreatedResourceLink<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Config,\n> = {\n  [Resource in keyof Config]-?: Resource extends ResourceLinkConfigResource<Resources>\n    ? Config[Resource] extends {\n        hash: infer hash extends ResourceLinkHref<Resource>;\n      }\n      ? CreateResourceLinkWithHash<Resource, hash>\n      : CreatedResourceLinkBase<Resource>\n    : never;\n}[keyof Config];\n\nexport interface CreateResourceLinksFn<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> {\n  <const Resource extends ResourceLinkConfigResource<Resources>>(\n    config: CreateResourceLinkConfig<Resources, Resource>,\n  ): Array<\n    CreatedResourceLink<\n      Resources,\n      CreateResourceLinkConfig<Resources, Resource>\n    >\n  >;\n  createResourceMap: CreateResourceMapFn<Resources>;\n  defineIcon: DefineResourceIconFn<Resources>;\n  withGroups: CreateResourceLinksWithGroupsFn<Resources>;\n}\n\nexport interface CreateResourceLinkGroupOptions<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Links extends object =\n    CreateResourceLinkConfig<Resources>,\n> {\n  /**\n   * An optional, caller-provided identity for the group. Provide this when you\n   * combine groups from more than one `withGroups()` call into one list (e.g.\n   * a module-owned nav section alongside a feature-owned one) — without it,\n   * the id is derived from the group's `label` and its link resources, which\n   * is enough to keep groups from a single call apart but can't distinguish\n   * two independently-defined groups that happen to look identical.\n   */\n  id?: string;\n  /**\n   * The label of the group. This is the text that will be displayed for the group.\n   */\n  label?: string;\n  /**\n   * An optional icon to render when the group is active.\n   */\n  activeIcon?: ReactNode;\n  /**\n   * An optional icon to register with the group. This is a headless approach, meaning you have full control\n   * over the icon's rendering.\n   */\n  icon?: ResourceIcon<LayoutRenderResourcesAccessor<Resources>>;\n  /**\n   * The resource links in this group.\n   */\n  links: Links;\n}\n\nexport type CreateResourceLinkGroupInput<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends ResourceLinkConfigResource<Resources> = ResourceLinkConfigResource<Resources>,\n> = CreateResourceLinkGroupOptions<\n  Resources,\n  CreateResourceLinkConfig<Resources, Resource>\n>;\n\nexport type AnyCreatedResourceLink<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = {\n  [Resource in LayoutResourceKey<Resources>]:\n    | CreatedResourceLinkBase<Resource>\n    | CreateResourceLinkWithHash<Resource, string>;\n}[LayoutResourceKey<Resources>];\n\nexport type CreateResourceLinksWithGroups<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = {\n  activeIcon?: ReactNode;\n  id: string;\n  label: string | null;\n  icon: ResourceIcon<LayoutRenderResourcesAccessor<Resources>>;\n  links: Array<AnyCreatedResourceLink<Resources>>;\n};\n\nexport type ResolvedResourceLinksWithGroups<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = Omit<CreateResourceLinksWithGroups<Resources>, 'icon' | 'links'> & {\n  icon: ReactNode;\n  links: Array<\n    Omit<AnyCreatedResourceLink<Resources>, 'icon'> & { icon: ReactNode }\n  >;\n};\n\nexport type CreateResourceMap<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Value,\n> = Partial<Record<LayoutResourceKey<Resources>, Value>>;\n\nexport type ValidateResource<\n  Resource extends string,\n  Map extends object,\n> = Resource extends Extract<keyof Map, string> ? Resource : never;\n\nexport type CreatedResourceMap<Map extends object> = Map & {\n  isValidResource(value: unknown): value is Extract<keyof Map, string>;\n  get<const Resource extends string>(\n    resource: ValidateResource<Resource, Map>,\n  ): Map[typeof resource];\n};\n\nexport interface CreateResourceMapFn<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> {\n  /**\n   * Creates a resource map for this layout.\n   *\n   * @param map Values keyed by this layout's resources. An unknown resource,\n   * or a key that collides with a map helper, is rejected.\n   */\n  <const Map extends CreateResourceMap<Resources, unknown>>(\n    map: Map,\n  ): CreatedResourceMap<Map>;\n}\n\nexport interface CreateResourceLinksWithGroupsFn<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> {\n  /**\n   * Groups resource links into sections.\n   *\n   * @param groups The sections to create. At least one is required. The link\n   * keys in those sections are the resources `findResource` can resolve.\n   */\n  <const Resource extends ResourceLinkConfigResource<Resources>>(\n    groups: NonEmptyReadonlyArray<\n      CreateResourceLinkGroupInput<Resources, Resource>\n    >,\n  ): CreateResourceLinksWithGroupsResult<Resources, Resource>;\n}\n\nexport type CreateResourceLinksWithGroupsResult<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends ResourceLinkConfigResource<Resources> = ResourceLinkConfigResource<Resources>,\n> = Array<CreateResourceLinksWithGroups<Resources>> & {\n  /**\n   * Resolves each group's icon and its link icons for the active resource.\n   *\n   * Functional icons receive the resources accessor for `resource`. Read the\n   * groups value directly when you do not need to resolve icons.\n   *\n   * @param resource The active resource key.\n   */\n  (\n    resource: LayoutResourceKey<Resources>,\n  ): ResolvedResourceLinksWithGroupsResult<Resources, Resource>;\n  /**\n   * Creates a resource map for this layout. Same helper as\n   * `createResourceLinks.createResourceMap`.\n   *\n   * @param map Values keyed by this layout's resources. An unknown resource,\n   * or a key that collides with a map helper, is rejected.\n   */\n  createResourceMap: CreateResourceMapFn<Resources>;\n  /**\n   * Returns the group whose links include `resource`.\n   *\n   * The result is `undefined` when that resource was not configured in any\n   * group. A resource outside this layout is rejected by the type.\n   *\n   * @param resource The resource whose group should be returned.\n   */\n  findResource<\n    const RequestedResource extends LayoutResourceKey<Resources> | Resource,\n  >(\n    resource: RequestedResource,\n  ): FindResourceGroupResult<Resources, Resource, RequestedResource>;\n};\n\nexport type ResolvedResourceLinksWithGroupsResult<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends ResourceLinkConfigResource<Resources> = ResourceLinkConfigResource<Resources>,\n> = Array<ResolvedResourceLinksWithGroups<Resources>> & {\n  /** Returns the resolved group whose links include `resource`. */\n  findResource<\n    const RequestedResource extends LayoutResourceKey<Resources> | Resource,\n  >(\n    resource: RequestedResource,\n  ): FindResolvedResourceGroupResult<Resources, Resource, RequestedResource>;\n};\n\nexport type FindResourceGroupResult<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  IncludedResource extends string,\n  RequestedResource extends string,\n> = RequestedResource extends unknown\n  ? RequestedResource extends IncludedResource\n    ? CreateResourceLinksWithGroups<Resources>\n    : undefined\n  : never;\n\nexport type FindResolvedResourceGroupResult<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  IncludedResource extends string,\n  RequestedResource extends string,\n> = RequestedResource extends unknown\n  ? RequestedResource extends IncludedResource\n    ? ResolvedResourceLinksWithGroups<Resources>\n    : undefined\n  : never;\n\nfunction resolveResourceLinkHref<Resource extends string>(\n  value: ResourceLinkHref<Resource> | undefined,\n  resource: Resource,\n  fallback: string,\n) {\n  return typeof value === 'function' ? value(resource) : (value ?? fallback);\n}\n\nfunction normalizeResourceLinkHash(hash: string) {\n  return hash.replace(/^#+/, '');\n}\n\nfunction createFullResourceLinkHref(href: string, hash: string) {\n  if (href.includes('#')) {\n    return href;\n  }\n\n  return `${href}#${normalizeResourceLinkHash(hash)}`;\n}\n\nfunction createResourceLinksFromConfig<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends ResourceLinkConfigResource<Resources>,\n>(config: CreateResourceLinkConfig<Resources, Resource>) {\n  return Object.entries(config).map(([resource, config]) => {\n    if (!config) {\n      throw new LayoutConfigurationError(\n        `[createResourceLinks]: \"config\" is required for the ${resource} resource.`,\n      );\n    }\n\n    if (typeof config !== 'object') {\n      throw new LayoutConfigurationError(\n        `[createResourceLinks]: \"config\" must be an object for the ${resource} resource. Received ${typeof config}`,\n      );\n    }\n\n    if (!('label' in config)) {\n      throw new LayoutConfigurationError(\n        `[createResourceLinks]: \"label\" is required for the ${resource} resource.`,\n      );\n    }\n\n    if (typeof config.label !== 'string') {\n      throw new LayoutConfigurationError(\n        `[createResourceLinks]: \"label\" must be a string for the ${resource} resource. Received ${typeof config.label}`,\n      );\n    }\n\n    const linkConfig = config as CreateResourceLinkOptions<\n      Resources,\n      typeof resource\n    >;\n\n    if (\n      'href' in linkConfig &&\n      linkConfig.href !== undefined &&\n      typeof linkConfig.href !== 'string' &&\n      typeof linkConfig.href !== 'function'\n    ) {\n      throw new LayoutConfigurationError(\n        `[createResourceLinks]: \"href\" must be a string or function for the ${resource} resource. Received ${typeof linkConfig.href}`,\n      );\n    }\n\n    if (\n      'hash' in linkConfig &&\n      linkConfig.hash !== undefined &&\n      typeof linkConfig.hash !== 'string' &&\n      typeof linkConfig.hash !== 'function'\n    ) {\n      throw new LayoutConfigurationError(\n        `[createResourceLinks]: \"hash\" must be a string or function for the ${resource} resource. Received ${typeof linkConfig.hash}`,\n      );\n    }\n\n    const givenHref = resolveResourceLinkHref(linkConfig.href, resource, '/');\n    const givenHash = resolveResourceLinkHref(\n      linkConfig.hash,\n      resource,\n      resource,\n    );\n    const href = {\n      given: givenHref,\n      full: createFullResourceLinkHref(givenHref, givenHash),\n      ...(linkConfig.hash !== undefined && !givenHref.includes('#')\n        ? { hash: normalizeResourceLinkHash(givenHash) }\n        : {}),\n    };\n\n    return {\n      ...(linkConfig.activeIcon !== undefined\n        ? { activeIcon: linkConfig.activeIcon }\n        : {}),\n      href,\n      label: config.label,\n      resource,\n      icon: 'icon' in config ? config.icon : null,\n    };\n  });\n}\n\n/**\n * Deterministic, not random: a random id (the previous implementation used\n * `crypto.randomUUID()` / `Math.random()`) would make `withGroups()` unsafe to\n * call from module scope — some runtimes (e.g. Cloudflare Workers) disallow\n * generating random values outside a request handler, and config arrays like\n * this are routinely defined as top-level constants.\n *\n * Falls back to the group's own shape — its `label` and its link resource\n * keys — rather than just the array index, so groups from *separate*\n * `withGroups()` calls that get concatenated into one list (a module-owned nav\n * section next to a feature-owned one, say) don't collide just because they're\n * both first in their own call. Two groups that are genuinely identical in\n * shape will still collide; pass an explicit `id` on the group to rule that\n * out entirely.\n */\nfunction createResourceLinkGroupId(\n  group: { id?: unknown; label?: unknown; links: object },\n  index: number,\n) {\n  if (typeof group.id === 'string' && group.id.length > 0) {\n    return group.id;\n  }\n\n  const label = typeof group.label === 'string' ? group.label : '';\n  const linkKeys = Object.keys(group.links).join(',');\n  return `group-${index}-${label}-${linkKeys}`;\n}\n\nfunction readResourceValue(resource: ResourceDefinition) {\n  return typeof resource === 'string' ? resource : resource.value;\n}\n\nfunction createResourceSelection(\n  definitions: ReadonlyArray<ResourceDefinition>,\n): ResourceSelection<ReadonlyArray<ResourceDefinition>> {\n  const selection = (() => definitions) as ResourceSelection<\n    ReadonlyArray<ResourceDefinition>\n  >;\n\n  selection.isResource = createIsValidResourceFn(definitions);\n\n  return selection;\n}\n\nfunction createRenderResourcesAccessor<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n>(resources: Resources, current: LayoutResourceKey<Resources>) {\n  const accessor = Object.assign(() => resources, {\n    current,\n  }) as LayoutRenderResourcesAccessor<Resources>;\n\n  accessor.isResource = createIsValidResourceFn(resources);\n  accessor.omit = ((...keys: string[]) =>\n    createResourceSelection(\n      resources.filter((resource) => !keys.includes(readResourceValue(resource))),\n    )) as LayoutRenderResourcesAccessor<Resources>['omit'];\n  accessor.pick = ((...keys: string[]) =>\n    createResourceSelection(\n      resources.filter((resource) => keys.includes(readResourceValue(resource))),\n    )) as LayoutRenderResourcesAccessor<Resources>['pick'];\n\n  return accessor;\n}\n\nfunction createResourceMapFn<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n>(resources: Resources): CreateResourceMapFn<Resources> {\n  const helperNames = new Set(['get', 'isValidResource']);\n  const resourceKeys = new Set(\n    resources.map((resource) =>\n      typeof resource === 'string' ? resource : resource.value,\n    ),\n  );\n\n  return function createResourceMap<\n    const Map extends CreateResourceMap<Resources, unknown>,\n  >(map: Map) {\n    const configuredResources = Object.keys(map);\n\n    for (const resource of configuredResources) {\n      if (!resourceKeys.has(resource)) {\n        throw new LayoutConfigurationError(\n          `[createResourceLinks.createResourceMap]: unknown resource \"${resource}\".`,\n        );\n      }\n\n      if (helperNames.has(resource)) {\n        throw new LayoutConfigurationError(\n          `[createResourceLinks.createResourceMap]: resource \"${resource}\" conflicts with a map helper.`,\n        );\n      }\n    }\n\n    const configuredResourceKeys = new Set(configuredResources);\n    const resourceValues = new Map(\n      configuredResources.map((resource) => [\n        resource,\n        (map as Record<string, unknown>)[resource],\n      ]),\n    );\n\n    Object.defineProperties(map, {\n      get: {\n        value(resource: string) {\n          return resourceValues.get(resource);\n        },\n      },\n      isValidResource: {\n        value(value: unknown): value is Extract<keyof Map, string> {\n          return (\n            typeof value === 'string' && configuredResourceKeys.has(value)\n          );\n        },\n      },\n    });\n\n    return map as CreatedResourceMap<Map>;\n  };\n}\n\nfunction createResourceLinksWithGroups<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends ResourceLinkConfigResource<Resources>,\n>(\n  resources: Resources,\n  createResourceMap: CreateResourceMapFn<Resources>,\n  groups: ReadonlyArray<CreateResourceLinkGroupInput<Resources, Resource>>,\n): CreateResourceLinksWithGroupsResult<Resources, Resource> {\n  if (!Array.isArray(groups)) {\n    throw new LayoutConfigurationError(\n      '[createResourceLinks.withGroups]: \"groups\" must be an array.',\n    );\n  }\n\n  if (groups.length === 0) {\n    throw new LayoutConfigurationError(\n      '[createResourceLinks.withGroups]: \"groups\" must include at least one group.',\n    );\n  }\n\n  const createdGroups = groups.map((group, index) => {\n    if (!group) {\n      throw new LayoutConfigurationError(\n        `[createResourceLinks.withGroups]: group at index ${index} is required.`,\n      );\n    }\n\n    if (typeof group !== 'object') {\n      throw new LayoutConfigurationError(\n        `[createResourceLinks.withGroups]: group at index ${index} must be an object. Received ${typeof group}`,\n      );\n    }\n\n    if (\n      'label' in group &&\n      group.label !== undefined &&\n      typeof group.label !== 'string'\n    ) {\n      throw new LayoutConfigurationError(\n        `[createResourceLinks.withGroups]: \"label\" must be a string for group at index ${index}. Received ${typeof group.label}`,\n      );\n    }\n\n    if ('id' in group && group.id !== undefined && typeof group.id !== 'string') {\n      throw new LayoutConfigurationError(\n        `[createResourceLinks.withGroups]: \"id\" must be a string for group at index ${index}. Received ${typeof group.id}`,\n      );\n    }\n\n    if (!('links' in group)) {\n      throw new LayoutConfigurationError(\n        `[createResourceLinks.withGroups]: \"links\" is required for group at index ${index}.`,\n      );\n    }\n\n    if (\n      typeof group.links !== 'object' ||\n      group.links === null ||\n      Array.isArray(group.links)\n    ) {\n      throw new LayoutConfigurationError(\n        `[createResourceLinks.withGroups]: \"links\" must be an object for group at index ${index}. Received ${Array.isArray(group.links) ? 'array' : typeof group.links}`,\n      );\n    }\n\n    return {\n      ...(group.activeIcon !== undefined\n        ? { activeIcon: group.activeIcon }\n        : {}),\n      id: createResourceLinkGroupId(group, index),\n      label: 'label' in group ? (group.label ?? null) : null,\n      icon: 'icon' in group ? group.icon : null,\n      links: createResourceLinksFromConfig(group.links),\n    };\n  }) as Array<CreateResourceLinksWithGroups<Resources>>;\n\n  function resolveGroups(resource?: LayoutResourceKey<Resources>) {\n    if (resource === undefined) {\n      throw new LayoutConfigurationError(\n        '[createResourceLinks.withGroups]: \"resource\" is required.',\n      );\n    }\n\n    const currentResources = createRenderResourcesAccessor(resources, resource);\n\n    const resolvedGroups = createdGroups.map((group) => ({\n      ...group,\n      icon:\n        typeof group.icon === 'function'\n          ? group.icon(currentResources)\n          : group.icon,\n      links: group.links.map((link) => ({\n        ...link,\n        icon:\n          typeof link.icon === 'function'\n            ? link.icon(currentResources)\n            : link.icon,\n      })),\n    }));\n\n    Object.defineProperty(resolvedGroups, 'findResource', {\n      value(requestedResource: ResourceLinkConfigResource<Resources>) {\n        return resolvedGroups.find((group) =>\n          group.links.some((link) => link.resource === requestedResource),\n        );\n      },\n    });\n\n    return resolvedGroups as ResolvedResourceLinksWithGroupsResult<\n      Resources,\n      Resource\n    >;\n  }\n\n  const callableGroups = new Proxy(resolveGroups, {\n    get(target, property, receiver) {\n      if (property === 'createResourceMap') {\n        return createResourceMap;\n      }\n\n      if (property === Symbol.iterator) {\n        return createdGroups[Symbol.iterator].bind(createdGroups);\n      }\n\n      if (property === 'toJSON') {\n        return () => createdGroups;\n      }\n\n      if (property in createdGroups) {\n        const value = Reflect.get(createdGroups, property);\n        return typeof value === 'function' ? value.bind(createdGroups) : value;\n      }\n\n      return Reflect.get(target, property, receiver);\n    },\n    getOwnPropertyDescriptor(target, property) {\n      return (\n        Reflect.getOwnPropertyDescriptor(createdGroups, property) ??\n        Reflect.getOwnPropertyDescriptor(target, property)\n      );\n    },\n    getPrototypeOf() {\n      return Array.prototype;\n    },\n    ownKeys(target) {\n      return [\n        ...new Set([\n          ...Reflect.ownKeys(target),\n          ...Reflect.ownKeys(createdGroups),\n        ]),\n      ];\n    },\n    set(target, property, value, receiver) {\n      if (property in createdGroups || /^\\d+$/.test(String(property))) {\n        return Reflect.set(createdGroups, property, value);\n      }\n\n      return Reflect.set(target, property, value, receiver);\n    },\n  });\n  Object.defineProperty(createdGroups, 'findResource', {\n    value(resource: ResourceLinkConfigResource<Resources>) {\n      return createdGroups.find((group) =>\n        group.links.some((link) => link.resource === resource),\n      );\n    },\n  });\n\n  return callableGroups as CreateResourceLinksWithGroupsResult<\n    Resources,\n    Resource\n  >;\n}\n\nfunction createDefineIcon<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n>(): DefineResourceIconFn<Resources> {\n  function defineIcon<Icon extends ElementType = ElementType>(\n    render: (options: {\n      resource: LayoutRenderResourcesAccessor<Resources>;\n      Icon: Icon;\n    }) => ReactNode,\n  ) {\n    return function createIcon(Icon: Icon) {\n      return function renderIcon(\n        resource: LayoutRenderResourcesAccessor<Resources>,\n      ) {\n        return render({ resource, Icon });\n      };\n    };\n  }\n\n  defineIcon.input = function defineIconInput<Definition>(\n    defineInput: (\n      helpers: DefineResourceIconInputHelpers<Resources>,\n    ) => Definition,\n  ): DefineResourceIconInputResult<Resources, Definition> {\n    const resourceMarker = {} as ResourceIconInputMarker<never>;\n    const componentMarker = {} as ResourceIconComponentInputMarker<ElementType>;\n\n    defineInput({\n      resource() {\n        return resourceMarker;\n      },\n      icon<Icon extends ElementType = ElementType>() {\n        return componentMarker as ResourceIconComponentInputMarker<Icon>;\n      },\n    });\n\n    return {\n      render(\n        render: (options: {\n          resource: LayoutRenderResourcesAccessor<Resources>;\n          input: ResolveResourceIconInput<Definition>;\n        }) => ReactNode,\n      ) {\n        return function createIcon(\n          input: ResolveResourceIconInput<Definition>,\n        ) {\n          return function renderIcon(\n            resource: LayoutRenderResourcesAccessor<Resources>,\n          ) {\n            return render({ resource, input });\n          };\n        };\n      },\n    };\n  };\n\n  return defineIcon;\n}\n\nexport function createResourceLinksFn<\n  const Resources extends ReadonlyArray<ResourceDefinition>,\n>(_resources: Resources): CreateResourceLinksFn<Resources> {\n  const createResourceMap = createResourceMapFn(_resources);\n  const defineIcon = createDefineIcon<Resources>();\n\n  function createResourceLinks<\n    const Resource extends ResourceLinkConfigResource<Resources>,\n  >(config: CreateResourceLinkConfig<Resources, Resource>) {\n    return createResourceLinksFromConfig(config);\n  }\n\n  function withGroups<\n    const Resource extends ResourceLinkConfigResource<Resources>,\n  >(\n    groups: NonEmptyReadonlyArray<\n      CreateResourceLinkGroupInput<Resources, Resource>\n    >,\n  ) {\n    return createResourceLinksWithGroups(_resources, createResourceMap, groups);\n  }\n\n  return Object.assign(createResourceLinks, {\n    createResourceMap,\n    defineIcon,\n    withGroups,\n  }) as CreateResourceLinksFn<Resources>;\n}\n"],"mappings":"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"}
+{"version":3,"file":"create-resource-links.cjs","names":["LayoutConfigurationError","createIsValidResourceFn"],"sources":["../../src/create-config/create-resource-links.ts"],"sourcesContent":["import type { ElementType, ReactNode } from 'react';\nimport type { NonEmptyReadonlyArray } from '@jfdevelops/react-layout-validator';\nimport {\n  createIsValidResourceFn,\n  type LayoutResourceKey,\n  type ResourceDefinition,\n} from '../resource';\nimport { LayoutConfigurationError } from '../errors';\nimport type {\n  LayoutRenderResourcesAccessor,\n  ResourceSelection,\n} from './define-layout';\n\nexport type ResourceAnchorLinkFn<Resource extends string> = (\n  resource: Resource,\n) => string;\n\nexport type ResourceLinkHref<Resource extends string> =\n  | string\n  | ResourceAnchorLinkFn<Resource>;\n\nexport type ResourceLinkConfigResource<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = LayoutResourceKey<Resources> | (string & {});\n\nexport type ResourceIconFn<Resource = any> = (resource: Resource) => ReactNode;\n\nexport type ResourceIcon<Resource = any> = ReactNode | ResourceIconFn<Resource>;\n\ndeclare const resourceIconInputMarker: unique symbol;\ndeclare const resourceIconComponentInputMarker: unique symbol;\n\ntype ResourceIconInputMarker<Value> = {\n  readonly [resourceIconInputMarker]: Value;\n};\n\ntype ResourceIconComponentInputMarker<Icon extends ElementType> = {\n  readonly [resourceIconComponentInputMarker]: Icon;\n};\n\nexport type ResolveResourceIconInput<Definition> =\n  Definition extends ResourceIconComponentInputMarker<infer Icon>\n    ? Icon\n    : Definition extends ResourceIconInputMarker<infer Value>\n      ? Value\n      : Definition extends ReadonlyArray<unknown>\n        ? { [Index in keyof Definition]: ResolveResourceIconInput<Definition[Index]> }\n        : Definition extends object\n          ? { [Key in keyof Definition]: ResolveResourceIconInput<Definition[Key]> }\n          : Definition;\n\nexport interface DefineResourceIconInputHelpers<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> {\n  resource(): ResourceIconInputMarker<LayoutResourceKey<Resources>>;\n  icon<Icon extends ElementType = ElementType>(): ResourceIconComponentInputMarker<Icon>;\n}\n\nexport interface DefineResourceIconInputResult<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Definition,\n> {\n  render(\n    render: (options: {\n      resource: LayoutRenderResourcesAccessor<Resources>;\n      input: ResolveResourceIconInput<Definition>;\n    }) => ReactNode,\n  ): (\n    input: ResolveResourceIconInput<Definition>,\n  ) => ResourceIconFn<LayoutRenderResourcesAccessor<Resources>>;\n}\n\nexport interface DefineResourceIconFn<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> {\n  <Icon extends ElementType = ElementType>(\n    render: (options: {\n      resource: LayoutRenderResourcesAccessor<Resources>;\n      Icon: Icon;\n    }) => ReactNode,\n  ): (Icon: Icon) => ResourceIconFn<LayoutRenderResourcesAccessor<Resources>>;\n  input<Definition>(\n    defineInput: (\n      helpers: DefineResourceIconInputHelpers<Resources>,\n    ) => Definition,\n  ): DefineResourceIconInputResult<Resources, Definition>;\n}\nexport interface CreateResourceLinkOptions<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends ResourceLinkConfigResource<Resources>,\n  Icon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>,\n> {\n  /**\n   * The label of the link. This is the text that will be displayed in the link.\n   */\n  label: string;\n  /**\n   * An optional icon to render when the link is active.\n   */\n  activeIcon?: ReactNode;\n  /**\n   * An optional icon to register with the link. This is a headless approach, meaning you have full control\n   * over the icon's rendering.\n   */\n  icon?: Icon;\n  /**\n   * The href of the link. By default, the href will be `\"/\"`. While you **don't** need to include a hash,\n   * if you do, it will override the `hash` property (if provided).\n   */\n  href?: ResourceLinkHref<Resource>;\n  /**\n   * The hash of the link. By default, the hash will be the resource name. If you need to customize it, you can provide\n   * a string or a function that returns a string.\n   *\n   * @remarks A `\"#\"` is not required. The generated href will include it automatically.\n   */\n  hash?: ResourceLinkHref<Resource>;\n}\n\nexport type CreateResourceLinkConfig<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends ResourceLinkConfigResource<Resources> = ResourceLinkConfigResource<Resources>,\n  Icon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>,\n> = {\n  [Key in Resource]?: CreateResourceLinkOptions<\n    Resources,\n    Key,\n    Icon\n  >;\n};\n\nexport type InferHashFromResourceLinkHref<\n  Resource extends string,\n  Hash extends ResourceLinkHref<Resource>,\n> = Hash extends string\n  ? Hash\n  : Hash extends ResourceAnchorLinkFn<Resource>\n    ? ReturnType<Hash>\n    : never;\n\nexport type CreatedResourceHref = {\n  /**\n   * The full generated href with the `hash` if provided.\n   */\n  full: string;\n  /**\n   * The given href. This is the same value as the `href` property of the config.\n   */\n  given: string;\n};\n\nexport type CreatedResourceLinkBase<\n  Resource extends string,\n  Icon = ResourceIcon,\n> = {\n  activeIcon?: ReactNode;\n  href: CreatedResourceHref;\n  label: string;\n  resource: Resource;\n  icon: Icon | null;\n};\nexport type CreateResourceLinkWithHash<\n  Resource extends string,\n  Hash extends ResourceLinkHref<Resource>,\n  Icon = ResourceIcon,\n> = Omit<CreatedResourceLinkBase<Resource, Icon>, 'href'> & {\n  href: CreatedResourceHref & {\n    hash: InferHashFromResourceLinkHref<Resource, Hash>;\n  };\n};\n\nexport type CreatedResourceLink<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Config,\n  Icon = ResourceIcon,\n> = {\n  [Resource in keyof Config]-?: Resource extends ResourceLinkConfigResource<Resources>\n    ? Config[Resource] extends {\n        hash: infer hash extends ResourceLinkHref<Resource>;\n      }\n      ? CreateResourceLinkWithHash<Resource, hash, Icon>\n      : CreatedResourceLinkBase<Resource, Icon>\n    : never;\n}[keyof Config];\n\ntype ResourceLinkConfigIcon<Config> = {\n  [Resource in keyof Config]-?: 'icon' extends keyof NonNullable<\n    Config[Resource]\n  >\n    ? NonNullable<Config[Resource]> extends { icon?: infer Icon }\n      ? Icon\n      : never\n    : never;\n}[keyof Config];\n\nexport interface CreateResourceLinksFn<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> {\n  <\n    const Resource extends ResourceLinkConfigResource<Resources>,\n    const Config extends object,\n  >(\n    config: CreateResourceLinkConfig<Resources, Resource> & Config,\n  ): Array<\n    CreatedResourceLink<\n      Resources,\n      Config,\n      ResourceLinkConfigIcon<Config>\n    >\n  >;\n  createResourceMap: CreateResourceMapFn<Resources>;\n  defineIcon: DefineResourceIconFn<Resources>;\n  withGroups: CreateResourceLinksWithGroupsFn<Resources>;\n}\n\nexport interface CreateResourceLinkGroupOptions<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Links extends object =\n    CreateResourceLinkConfig<Resources>,\n  Icon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>,\n> {\n  /**\n   * An optional, caller-provided identity for the group. Provide this when you\n   * combine groups from more than one `withGroups()` call into one list (e.g.\n   * a module-owned nav section alongside a feature-owned one) — without it,\n   * the id is derived from the group's `label` and its link resources, which\n   * is enough to keep groups from a single call apart but can't distinguish\n   * two independently-defined groups that happen to look identical.\n   */\n  id?: string;\n  /**\n   * The label of the group. This is the text that will be displayed for the group.\n   */\n  label?: string;\n  /**\n   * An optional icon to render when the group is active.\n   */\n  activeIcon?: ReactNode;\n  /**\n   * An optional icon to register with the group. This is a headless approach, meaning you have full control\n   * over the icon's rendering.\n   */\n  icon?: Icon;\n  /**\n   * The resource links in this group.\n   */\n  links: Links;\n}\n\nexport type CreateResourceLinkGroupInput<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends ResourceLinkConfigResource<Resources> = ResourceLinkConfigResource<Resources>,\n  Icon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>,\n> = CreateResourceLinkGroupOptions<\n  Resources,\n  CreateResourceLinkConfig<Resources, Resource, Icon>,\n  Icon\n>;\n\ntype ResourceLinkGroupResource<Groups extends ReadonlyArray<unknown>> =\n  Groups[number] extends infer Group\n    ? Group extends { links: infer Links }\n      ? Extract<keyof Links, string>\n      : never\n    : never;\n\ntype ResourceLinkGroupIcon<Groups extends ReadonlyArray<unknown>> =\n  Groups[number] extends infer Group\n    ? 'icon' extends keyof Group\n      ? Group extends { icon?: infer Icon }\n        ? Icon\n        : never\n      : never\n    : never;\n\ntype ResourceLinkGroupLinkIcon<Groups extends ReadonlyArray<unknown>> =\n  Groups[number] extends infer Group\n    ? Group extends { links: infer Links }\n      ? ResourceLinkConfigIcon<Links>\n      : never\n    : never;\n\nexport type AnyCreatedResourceLink<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Icon = ResourceIcon,\n> = {\n  [Resource in LayoutResourceKey<Resources>]:\n    | CreatedResourceLinkBase<Resource, Icon>\n    | CreateResourceLinkWithHash<Resource, string, Icon>;\n}[LayoutResourceKey<Resources>];\n\nexport type CreateResourceLinksWithGroups<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  GroupIcon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>,\n  LinkIcon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>,\n> = {\n  activeIcon?: ReactNode;\n  id: string;\n  label: string | null;\n  icon: GroupIcon | null;\n  links: Array<AnyCreatedResourceLink<Resources, LinkIcon>>;\n};\n\ntype ResolveResourceIcon<Icon> = Icon extends (...args: any[]) => infer Result\n  ? Result\n  : Icon;\n\nexport type ResolvedResourceLinksWithGroups<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  GroupIcon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>,\n  LinkIcon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>,\n> = Omit<\n  CreateResourceLinksWithGroups<Resources, GroupIcon, LinkIcon>,\n  'icon' | 'links'\n> & {\n  icon: ResolveResourceIcon<GroupIcon> | null;\n  links: Array<\n    Omit<AnyCreatedResourceLink<Resources, LinkIcon>, 'icon'> & {\n      icon: ResolveResourceIcon<LinkIcon> | null;\n    }\n  >;\n};\n\nexport type CreateResourceMap<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Value,\n> = Partial<Record<LayoutResourceKey<Resources>, Value>>;\n\nexport type ValidateResource<\n  Resource extends string,\n  Map extends object,\n> = Resource extends Extract<keyof Map, string> ? Resource : never;\n\nexport type CreatedResourceMap<Map extends object> = Map & {\n  isValidResource(value: unknown): value is Extract<keyof Map, string>;\n  get<const Resource extends string>(\n    resource: ValidateResource<Resource, Map>,\n  ): Map[typeof resource];\n};\n\nexport interface CreateResourceMapFn<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> {\n  /**\n   * Creates a resource map for this layout.\n   *\n   * @param map Values keyed by this layout's resources. An unknown resource,\n   * or a key that collides with a map helper, is rejected.\n   */\n  <const Map extends CreateResourceMap<Resources, unknown>>(\n    map: Map,\n  ): CreatedResourceMap<Map>;\n}\n\nexport interface CreateResourceLinksWithGroupsFn<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> {\n  /**\n   * Groups resource links into sections.\n   *\n   * @param groups The sections to create. At least one is required. The link\n   * keys in those sections are the resources `findResource` can resolve.\n   */\n  <\n    const Resource extends ResourceLinkConfigResource<Resources>,\n    const Groups extends ReadonlyArray<unknown>,\n  >(\n    groups: NonEmptyReadonlyArray<\n      CreateResourceLinkGroupInput<Resources, Resource>\n    > &\n      Groups,\n  ): CreateResourceLinksWithGroupsResult<\n    Resources,\n    ResourceLinkGroupResource<Groups>,\n    ResourceLinkGroupIcon<Groups>,\n    ResourceLinkGroupLinkIcon<Groups>\n  >;\n}\n\nexport type CreateResourceLinksWithGroupsResult<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends ResourceLinkConfigResource<Resources> = ResourceLinkConfigResource<Resources>,\n  GroupIcon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>,\n  LinkIcon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>,\n> = Array<CreateResourceLinksWithGroups<Resources, GroupIcon, LinkIcon>> & {\n  /**\n   * Resolves each group's icon and its link icons for the active resource.\n   *\n   * Functional icons receive the resources accessor for `resource`. Read the\n   * groups value directly when you do not need to resolve icons.\n   *\n   * @param resource The active resource key.\n   */\n  (\n    resource: LayoutResourceKey<Resources>,\n  ): ResolvedResourceLinksWithGroupsResult<\n    Resources,\n    Resource,\n    GroupIcon,\n    LinkIcon\n  >;\n  /**\n   * Creates a resource map for this layout. Same helper as\n   * `createResourceLinks.createResourceMap`.\n   *\n   * @param map Values keyed by this layout's resources. An unknown resource,\n   * or a key that collides with a map helper, is rejected.\n   */\n  createResourceMap: CreateResourceMapFn<Resources>;\n  /**\n   * Returns the group whose links include `resource`.\n   *\n   * The result is `undefined` when that resource was not configured in any\n   * group. A resource outside this layout is rejected by the type.\n   *\n   * @param resource The resource whose group should be returned.\n   */\n  findResource<\n    const RequestedResource extends LayoutResourceKey<Resources> | Resource,\n  >(\n    resource: RequestedResource,\n  ): FindResourceGroupResult<\n    Resources,\n    Resource,\n    RequestedResource,\n    GroupIcon,\n    LinkIcon\n  >;\n};\n\nexport type ResolvedResourceLinksWithGroupsResult<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends ResourceLinkConfigResource<Resources> = ResourceLinkConfigResource<Resources>,\n  GroupIcon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>,\n  LinkIcon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>,\n> = Array<\n  ResolvedResourceLinksWithGroups<Resources, GroupIcon, LinkIcon>\n> & {\n  /** Returns the resolved group whose links include `resource`. */\n  findResource<\n    const RequestedResource extends LayoutResourceKey<Resources> | Resource,\n  >(\n    resource: RequestedResource,\n  ): FindResolvedResourceGroupResult<\n    Resources,\n    Resource,\n    RequestedResource,\n    GroupIcon,\n    LinkIcon\n  >;\n};\n\nexport type FindResourceGroupResult<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  IncludedResource extends string,\n  RequestedResource extends string,\n  GroupIcon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>,\n  LinkIcon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>,\n> = RequestedResource extends unknown\n  ? RequestedResource extends IncludedResource\n    ? CreateResourceLinksWithGroups<Resources, GroupIcon, LinkIcon>\n    : undefined\n  : never;\n\nexport type FindResolvedResourceGroupResult<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  IncludedResource extends string,\n  RequestedResource extends string,\n  GroupIcon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>,\n  LinkIcon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>,\n> = RequestedResource extends unknown\n  ? RequestedResource extends IncludedResource\n    ? ResolvedResourceLinksWithGroups<Resources, GroupIcon, LinkIcon>\n    : undefined\n  : never;\n\nfunction resolveResourceLinkHref<Resource extends string>(\n  value: ResourceLinkHref<Resource> | undefined,\n  resource: Resource,\n  fallback: string,\n) {\n  return typeof value === 'function' ? value(resource) : (value ?? fallback);\n}\n\nfunction normalizeResourceLinkHash(hash: string) {\n  return hash.replace(/^#+/, '');\n}\n\nfunction createFullResourceLinkHref(href: string, hash: string) {\n  if (href.includes('#')) {\n    return href;\n  }\n\n  return `${href}#${normalizeResourceLinkHash(hash)}`;\n}\n\nfunction createResourceLinksFromConfig<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends ResourceLinkConfigResource<Resources>,\n>(config: CreateResourceLinkConfig<Resources, Resource>) {\n  return Object.entries(config).map(([resource, config]) => {\n    if (!config) {\n      throw new LayoutConfigurationError(\n        `[createResourceLinks]: \"config\" is required for the ${resource} resource.`,\n      );\n    }\n\n    if (typeof config !== 'object') {\n      throw new LayoutConfigurationError(\n        `[createResourceLinks]: \"config\" must be an object for the ${resource} resource. Received ${typeof config}`,\n      );\n    }\n\n    if (!('label' in config)) {\n      throw new LayoutConfigurationError(\n        `[createResourceLinks]: \"label\" is required for the ${resource} resource.`,\n      );\n    }\n\n    if (typeof config.label !== 'string') {\n      throw new LayoutConfigurationError(\n        `[createResourceLinks]: \"label\" must be a string for the ${resource} resource. Received ${typeof config.label}`,\n      );\n    }\n\n    const linkConfig = config as CreateResourceLinkOptions<\n      Resources,\n      typeof resource,\n      ResourceIcon<LayoutRenderResourcesAccessor<Resources>>\n    >;\n\n    if (\n      'href' in linkConfig &&\n      linkConfig.href !== undefined &&\n      typeof linkConfig.href !== 'string' &&\n      typeof linkConfig.href !== 'function'\n    ) {\n      throw new LayoutConfigurationError(\n        `[createResourceLinks]: \"href\" must be a string or function for the ${resource} resource. Received ${typeof linkConfig.href}`,\n      );\n    }\n\n    if (\n      'hash' in linkConfig &&\n      linkConfig.hash !== undefined &&\n      typeof linkConfig.hash !== 'string' &&\n      typeof linkConfig.hash !== 'function'\n    ) {\n      throw new LayoutConfigurationError(\n        `[createResourceLinks]: \"hash\" must be a string or function for the ${resource} resource. Received ${typeof linkConfig.hash}`,\n      );\n    }\n\n    const givenHref = resolveResourceLinkHref(linkConfig.href, resource, '/');\n    const givenHash = resolveResourceLinkHref(\n      linkConfig.hash,\n      resource,\n      resource,\n    );\n    const href = {\n      given: givenHref,\n      full: createFullResourceLinkHref(givenHref, givenHash),\n      ...(linkConfig.hash !== undefined && !givenHref.includes('#')\n        ? { hash: normalizeResourceLinkHash(givenHash) }\n        : {}),\n    };\n\n    return {\n      ...(linkConfig.activeIcon !== undefined\n        ? { activeIcon: linkConfig.activeIcon }\n        : {}),\n      href,\n      label: config.label,\n      resource,\n      icon: 'icon' in config ? config.icon : null,\n    };\n  });\n}\n\n/**\n * Deterministic, not random: a random id (the previous implementation used\n * `crypto.randomUUID()` / `Math.random()`) would make `withGroups()` unsafe to\n * call from module scope — some runtimes (e.g. Cloudflare Workers) disallow\n * generating random values outside a request handler, and config arrays like\n * this are routinely defined as top-level constants.\n *\n * Falls back to the group's own shape — its `label` and its link resource\n * keys — rather than just the array index, so groups from *separate*\n * `withGroups()` calls that get concatenated into one list (a module-owned nav\n * section next to a feature-owned one, say) don't collide just because they're\n * both first in their own call. Two groups that are genuinely identical in\n * shape will still collide; pass an explicit `id` on the group to rule that\n * out entirely.\n */\nfunction createResourceLinkGroupId(\n  group: { id?: unknown; label?: unknown; links: object },\n  index: number,\n) {\n  if (typeof group.id === 'string' && group.id.length > 0) {\n    return group.id;\n  }\n\n  const label = typeof group.label === 'string' ? group.label : '';\n  const linkKeys = Object.keys(group.links).join(',');\n  return `group-${index}-${label}-${linkKeys}`;\n}\n\nfunction readResourceValue(resource: ResourceDefinition) {\n  return typeof resource === 'string' ? resource : resource.value;\n}\n\nfunction createResourceSelection(\n  definitions: ReadonlyArray<ResourceDefinition>,\n): ResourceSelection<ReadonlyArray<ResourceDefinition>> {\n  const selection = (() => definitions) as ResourceSelection<\n    ReadonlyArray<ResourceDefinition>\n  >;\n\n  selection.isResource = createIsValidResourceFn(definitions);\n\n  return selection;\n}\n\nfunction createRenderResourcesAccessor<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n>(resources: Resources, current: LayoutResourceKey<Resources>) {\n  const accessor = Object.assign(() => resources, {\n    current,\n  }) as LayoutRenderResourcesAccessor<Resources>;\n\n  accessor.isResource = createIsValidResourceFn(resources);\n  accessor.omit = ((...keys: string[]) =>\n    createResourceSelection(\n      resources.filter((resource) => !keys.includes(readResourceValue(resource))),\n    )) as LayoutRenderResourcesAccessor<Resources>['omit'];\n  accessor.pick = ((...keys: string[]) =>\n    createResourceSelection(\n      resources.filter((resource) => keys.includes(readResourceValue(resource))),\n    )) as LayoutRenderResourcesAccessor<Resources>['pick'];\n\n  return accessor;\n}\n\nfunction createResourceMapFn<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n>(resources: Resources): CreateResourceMapFn<Resources> {\n  const helperNames = new Set(['get', 'isValidResource']);\n  const resourceKeys = new Set(\n    resources.map((resource) =>\n      typeof resource === 'string' ? resource : resource.value,\n    ),\n  );\n\n  return function createResourceMap<\n    const Map extends CreateResourceMap<Resources, unknown>,\n  >(map: Map) {\n    const configuredResources = Object.keys(map);\n\n    for (const resource of configuredResources) {\n      if (!resourceKeys.has(resource)) {\n        throw new LayoutConfigurationError(\n          `[createResourceLinks.createResourceMap]: unknown resource \"${resource}\".`,\n        );\n      }\n\n      if (helperNames.has(resource)) {\n        throw new LayoutConfigurationError(\n          `[createResourceLinks.createResourceMap]: resource \"${resource}\" conflicts with a map helper.`,\n        );\n      }\n    }\n\n    const configuredResourceKeys = new Set(configuredResources);\n    const resourceValues = new Map(\n      configuredResources.map((resource) => [\n        resource,\n        (map as Record<string, unknown>)[resource],\n      ]),\n    );\n\n    Object.defineProperties(map, {\n      get: {\n        value(resource: string) {\n          return resourceValues.get(resource);\n        },\n      },\n      isValidResource: {\n        value(value: unknown): value is Extract<keyof Map, string> {\n          return (\n            typeof value === 'string' && configuredResourceKeys.has(value)\n          );\n        },\n      },\n    });\n\n    return map as CreatedResourceMap<Map>;\n  };\n}\n\nfunction createResourceLinksWithGroups<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends ResourceLinkConfigResource<Resources>,\n  const Groups extends ReadonlyArray<unknown>,\n>(\n  resources: Resources,\n  createResourceMap: CreateResourceMapFn<Resources>,\n  groups: ReadonlyArray<CreateResourceLinkGroupInput<Resources, Resource>> &\n    Groups,\n): CreateResourceLinksWithGroupsResult<\n  Resources,\n  ResourceLinkGroupResource<Groups>,\n  ResourceLinkGroupIcon<Groups>,\n  ResourceLinkGroupLinkIcon<Groups>\n> {\n  if (!Array.isArray(groups)) {\n    throw new LayoutConfigurationError(\n      '[createResourceLinks.withGroups]: \"groups\" must be an array.',\n    );\n  }\n\n  if (groups.length === 0) {\n    throw new LayoutConfigurationError(\n      '[createResourceLinks.withGroups]: \"groups\" must include at least one group.',\n    );\n  }\n\n  const createdGroups = groups.map((group, index) => {\n    if (!group) {\n      throw new LayoutConfigurationError(\n        `[createResourceLinks.withGroups]: group at index ${index} is required.`,\n      );\n    }\n\n    if (typeof group !== 'object') {\n      throw new LayoutConfigurationError(\n        `[createResourceLinks.withGroups]: group at index ${index} must be an object. Received ${typeof group}`,\n      );\n    }\n\n    if (\n      'label' in group &&\n      group.label !== undefined &&\n      typeof group.label !== 'string'\n    ) {\n      throw new LayoutConfigurationError(\n        `[createResourceLinks.withGroups]: \"label\" must be a string for group at index ${index}. Received ${typeof group.label}`,\n      );\n    }\n\n    if ('id' in group && group.id !== undefined && typeof group.id !== 'string') {\n      throw new LayoutConfigurationError(\n        `[createResourceLinks.withGroups]: \"id\" must be a string for group at index ${index}. Received ${typeof group.id}`,\n      );\n    }\n\n    if (!('links' in group)) {\n      throw new LayoutConfigurationError(\n        `[createResourceLinks.withGroups]: \"links\" is required for group at index ${index}.`,\n      );\n    }\n\n    if (\n      typeof group.links !== 'object' ||\n      group.links === null ||\n      Array.isArray(group.links)\n    ) {\n      throw new LayoutConfigurationError(\n        `[createResourceLinks.withGroups]: \"links\" must be an object for group at index ${index}. Received ${Array.isArray(group.links) ? 'array' : typeof group.links}`,\n      );\n    }\n\n    return {\n      ...(group.activeIcon !== undefined\n        ? { activeIcon: group.activeIcon }\n        : {}),\n      id: createResourceLinkGroupId(group, index),\n      label: 'label' in group ? (group.label ?? null) : null,\n      icon: 'icon' in group ? group.icon : null,\n      links: createResourceLinksFromConfig(group.links),\n    };\n  }) as Array<CreateResourceLinksWithGroups<Resources>>;\n\n  function resolveGroups(resource?: LayoutResourceKey<Resources>) {\n    if (resource === undefined) {\n      throw new LayoutConfigurationError(\n        '[createResourceLinks.withGroups]: \"resource\" is required.',\n      );\n    }\n\n    const currentResources = createRenderResourcesAccessor(resources, resource);\n\n    const resolvedGroups = createdGroups.map((group) => ({\n      ...group,\n      icon:\n        typeof group.icon === 'function'\n          ? group.icon(currentResources)\n          : group.icon,\n      links: group.links.map((link) => ({\n        ...link,\n        icon:\n          typeof link.icon === 'function'\n            ? link.icon(currentResources)\n            : link.icon,\n      })),\n    }));\n\n    Object.defineProperty(resolvedGroups, 'findResource', {\n      value(requestedResource: ResourceLinkConfigResource<Resources>) {\n        return resolvedGroups.find((group) =>\n          group.links.some((link) => link.resource === requestedResource),\n        );\n      },\n    });\n\n    return resolvedGroups as ResolvedResourceLinksWithGroupsResult<\n      Resources,\n      ResourceLinkGroupResource<Groups>,\n      ResourceLinkGroupIcon<Groups>,\n      ResourceLinkGroupLinkIcon<Groups>\n    >;\n  }\n\n  const callableGroups = new Proxy(resolveGroups, {\n    get(target, property, receiver) {\n      if (property === 'createResourceMap') {\n        return createResourceMap;\n      }\n\n      if (property === Symbol.iterator) {\n        return createdGroups[Symbol.iterator].bind(createdGroups);\n      }\n\n      if (property === 'toJSON') {\n        return () => createdGroups;\n      }\n\n      if (property in createdGroups) {\n        const value = Reflect.get(createdGroups, property);\n        return typeof value === 'function' ? value.bind(createdGroups) : value;\n      }\n\n      return Reflect.get(target, property, receiver);\n    },\n    getOwnPropertyDescriptor(target, property) {\n      return (\n        Reflect.getOwnPropertyDescriptor(createdGroups, property) ??\n        Reflect.getOwnPropertyDescriptor(target, property)\n      );\n    },\n    getPrototypeOf() {\n      return Array.prototype;\n    },\n    ownKeys(target) {\n      return [\n        ...new Set([\n          ...Reflect.ownKeys(target),\n          ...Reflect.ownKeys(createdGroups),\n        ]),\n      ];\n    },\n    set(target, property, value, receiver) {\n      if (property in createdGroups || /^\\d+$/.test(String(property))) {\n        return Reflect.set(createdGroups, property, value);\n      }\n\n      return Reflect.set(target, property, value, receiver);\n    },\n  });\n  Object.defineProperty(createdGroups, 'findResource', {\n    value(resource: ResourceLinkConfigResource<Resources>) {\n      return createdGroups.find((group) =>\n        group.links.some((link) => link.resource === resource),\n      );\n    },\n  });\n\n  return callableGroups as CreateResourceLinksWithGroupsResult<\n    Resources,\n    ResourceLinkGroupResource<Groups>,\n    ResourceLinkGroupIcon<Groups>,\n    ResourceLinkGroupLinkIcon<Groups>\n  >;\n}\n\nfunction createDefineIcon<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n>(): DefineResourceIconFn<Resources> {\n  function defineIcon<Icon extends ElementType = ElementType>(\n    render: (options: {\n      resource: LayoutRenderResourcesAccessor<Resources>;\n      Icon: Icon;\n    }) => ReactNode,\n  ) {\n    return function createIcon(Icon: Icon) {\n      return function renderIcon(\n        resource: LayoutRenderResourcesAccessor<Resources>,\n      ) {\n        return render({ resource, Icon });\n      };\n    };\n  }\n\n  defineIcon.input = function defineIconInput<Definition>(\n    defineInput: (\n      helpers: DefineResourceIconInputHelpers<Resources>,\n    ) => Definition,\n  ): DefineResourceIconInputResult<Resources, Definition> {\n    const resourceMarker = {} as ResourceIconInputMarker<never>;\n    const componentMarker = {} as ResourceIconComponentInputMarker<ElementType>;\n\n    defineInput({\n      resource() {\n        return resourceMarker;\n      },\n      icon<Icon extends ElementType = ElementType>() {\n        return componentMarker as ResourceIconComponentInputMarker<Icon>;\n      },\n    });\n\n    return {\n      render(\n        render: (options: {\n          resource: LayoutRenderResourcesAccessor<Resources>;\n          input: ResolveResourceIconInput<Definition>;\n        }) => ReactNode,\n      ) {\n        return function createIcon(\n          input: ResolveResourceIconInput<Definition>,\n        ) {\n          return function renderIcon(\n            resource: LayoutRenderResourcesAccessor<Resources>,\n          ) {\n            return render({ resource, input });\n          };\n        };\n      },\n    };\n  };\n\n  return defineIcon;\n}\n\nexport function createResourceLinksFn<\n  const Resources extends ReadonlyArray<ResourceDefinition>,\n>(_resources: Resources): CreateResourceLinksFn<Resources> {\n  const createResourceMap = createResourceMapFn(_resources);\n  const defineIcon = createDefineIcon<Resources>();\n\n  function createResourceLinks<\n    const Resource extends ResourceLinkConfigResource<Resources>,\n    const Config extends object,\n  >(config: CreateResourceLinkConfig<Resources, Resource> & Config) {\n    return createResourceLinksFromConfig(config);\n  }\n\n  function withGroups<\n    const Resource extends ResourceLinkConfigResource<Resources>,\n    const Groups extends ReadonlyArray<unknown>,\n  >(\n    groups: NonEmptyReadonlyArray<\n      CreateResourceLinkGroupInput<Resources, Resource>\n    > &\n      Groups,\n  ) {\n    return createResourceLinksWithGroups(_resources, createResourceMap, groups);\n  }\n\n  return Object.assign(createResourceLinks, {\n    createResourceMap,\n    defineIcon,\n    withGroups,\n  }) as CreateResourceLinksFn<Resources>;\n}\n"],"mappings":"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"}

package/dist/create-config/create-resource-links.d.cts

@@ -35,7 +35,7 @@ interface DefineResourceIconFn<Resources extends ReadonlyArray<ResourceDefinitio
   }) => ReactNode): (Icon: Icon) => ResourceIconFn<LayoutRenderResourcesAccessor<Resources>>;
   input<Definition>(defineInput: (helpers: DefineResourceIconInputHelpers<Resources>) => Definition): DefineResourceIconInputResult<Resources, Definition>;
 }
-interface CreateResourceLinkOptions<Resources extends ReadonlyArray<ResourceDefinition>, Resource extends ResourceLinkConfigResource<Resources>> {
+interface CreateResourceLinkOptions<Resources extends ReadonlyArray<ResourceDefinition>, Resource extends ResourceLinkConfigResource<Resources>, Icon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>> {
   /**
    * The label of the link. This is the text that will be displayed in the link.
    */
@@ -48,7 +48,7 @@ interface CreateResourceLinkOptions<Resources extends ReadonlyArray<ResourceDefi
    * An optional icon to register with the link. This is a headless approach, meaning you have full control
    * over the icon's rendering.
    */
-  icon?: ResourceIcon<LayoutRenderResourcesAccessor<Resources>>;
+  icon?: Icon;
   /**
    * The href of the link. By default, the href will be `"/"`. While you **don't** need to include a hash,
    * if you do, it will override the `hash` property (if provided).
@@ -62,7 +62,7 @@ interface CreateResourceLinkOptions<Resources extends ReadonlyArray<ResourceDefi
    */
   hash?: ResourceLinkHref<Resource>;
 }
-type CreateResourceLinkConfig<Resources extends ReadonlyArray<ResourceDefinition>, Resource extends ResourceLinkConfigResource<Resources> = ResourceLinkConfigResource<Resources>> = { [Key in Resource]?: CreateResourceLinkOptions<Resources, Key> };
+type CreateResourceLinkConfig<Resources extends ReadonlyArray<ResourceDefinition>, Resource extends ResourceLinkConfigResource<Resources> = ResourceLinkConfigResource<Resources>, Icon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>> = { [Key in Resource]?: CreateResourceLinkOptions<Resources, Key, Icon> };
 type InferHashFromResourceLinkHref<Resource extends string, Hash extends ResourceLinkHref<Resource>> = Hash extends string ? Hash : Hash extends ResourceAnchorLinkFn<Resource> ? ReturnType<Hash> : never;
 type CreatedResourceHref = {
   /**
@@ -74,28 +74,31 @@ type CreatedResourceHref = {
    */
   given: string;
 };
-type CreatedResourceLinkBase<Resource extends string> = {
+type CreatedResourceLinkBase<Resource extends string, Icon = ResourceIcon> = {
   activeIcon?: ReactNode;
   href: CreatedResourceHref;
   label: string;
   resource: Resource;
-  icon: ResourceIcon;
+  icon: Icon | null;
 };
-type CreateResourceLinkWithHash<Resource extends string, Hash extends ResourceLinkHref<Resource>> = Omit<CreatedResourceLinkBase<Resource>, 'href'> & {
+type CreateResourceLinkWithHash<Resource extends string, Hash extends ResourceLinkHref<Resource>, Icon = ResourceIcon> = Omit<CreatedResourceLinkBase<Resource, Icon>, 'href'> & {
   href: CreatedResourceHref & {
     hash: InferHashFromResourceLinkHref<Resource, Hash>;
   };
 };
-type CreatedResourceLink<Resources extends ReadonlyArray<ResourceDefinition>, Config> = { [Resource in keyof Config]-?: Resource extends ResourceLinkConfigResource<Resources> ? Config[Resource] extends {
+type CreatedResourceLink<Resources extends ReadonlyArray<ResourceDefinition>, Config, Icon = ResourceIcon> = { [Resource in keyof Config]-?: Resource extends ResourceLinkConfigResource<Resources> ? Config[Resource] extends {
   hash: infer hash extends ResourceLinkHref<Resource>;
-} ? CreateResourceLinkWithHash<Resource, hash> : CreatedResourceLinkBase<Resource> : never }[keyof Config];
+} ? CreateResourceLinkWithHash<Resource, hash, Icon> : CreatedResourceLinkBase<Resource, Icon> : never }[keyof Config];
+type ResourceLinkConfigIcon<Config> = { [Resource in keyof Config]-?: 'icon' extends keyof NonNullable<Config[Resource]> ? NonNullable<Config[Resource]> extends {
+  icon?: infer Icon;
+} ? Icon : never : never }[keyof Config];
 interface CreateResourceLinksFn<Resources extends ReadonlyArray<ResourceDefinition>> {
-  <const Resource extends ResourceLinkConfigResource<Resources>>(config: CreateResourceLinkConfig<Resources, Resource>): Array<CreatedResourceLink<Resources, CreateResourceLinkConfig<Resources, Resource>>>;
+  <const Resource extends ResourceLinkConfigResource<Resources>, const Config extends object>(config: CreateResourceLinkConfig<Resources, Resource> & Config): Array<CreatedResourceLink<Resources, Config, ResourceLinkConfigIcon<Config>>>;
   createResourceMap: CreateResourceMapFn<Resources>;
   defineIcon: DefineResourceIconFn<Resources>;
   withGroups: CreateResourceLinksWithGroupsFn<Resources>;
 }
-interface CreateResourceLinkGroupOptions<Resources extends ReadonlyArray<ResourceDefinition>, Links extends object = CreateResourceLinkConfig<Resources>> {
+interface CreateResourceLinkGroupOptions<Resources extends ReadonlyArray<ResourceDefinition>, Links extends object = CreateResourceLinkConfig<Resources>, Icon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>> {
   /**
    * An optional, caller-provided identity for the group. Provide this when you
    * combine groups from more than one `withGroups()` call into one list (e.g.
@@ -117,25 +120,35 @@ interface CreateResourceLinkGroupOptions<Resources extends ReadonlyArray<Resourc
    * An optional icon to register with the group. This is a headless approach, meaning you have full control
    * over the icon's rendering.
    */
-  icon?: ResourceIcon<LayoutRenderResourcesAccessor<Resources>>;
+  icon?: Icon;
   /**
    * The resource links in this group.
    */
   links: Links;
 }
-type CreateResourceLinkGroupInput<Resources extends ReadonlyArray<ResourceDefinition>, Resource extends ResourceLinkConfigResource<Resources> = ResourceLinkConfigResource<Resources>> = CreateResourceLinkGroupOptions<Resources, CreateResourceLinkConfig<Resources, Resource>>;
-type AnyCreatedResourceLink<Resources extends ReadonlyArray<ResourceDefinition>> = { [Resource in LayoutResourceKey<Resources>]: CreatedResourceLinkBase<Resource> | CreateResourceLinkWithHash<Resource, string> }[LayoutResourceKey<Resources>];
-type CreateResourceLinksWithGroups<Resources extends ReadonlyArray<ResourceDefinition>> = {
+type CreateResourceLinkGroupInput<Resources extends ReadonlyArray<ResourceDefinition>, Resource extends ResourceLinkConfigResource<Resources> = ResourceLinkConfigResource<Resources>, Icon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>> = CreateResourceLinkGroupOptions<Resources, CreateResourceLinkConfig<Resources, Resource, Icon>, Icon>;
+type ResourceLinkGroupResource<Groups extends ReadonlyArray<unknown>> = Groups[number] extends infer Group ? Group extends {
+  links: infer Links;
+} ? Extract<keyof Links, string> : never : never;
+type ResourceLinkGroupIcon<Groups extends ReadonlyArray<unknown>> = Groups[number] extends infer Group ? 'icon' extends keyof Group ? Group extends {
+  icon?: infer Icon;
+} ? Icon : never : never : never;
+type ResourceLinkGroupLinkIcon<Groups extends ReadonlyArray<unknown>> = Groups[number] extends infer Group ? Group extends {
+  links: infer Links;
+} ? ResourceLinkConfigIcon<Links> : never : never;
+type AnyCreatedResourceLink<Resources extends ReadonlyArray<ResourceDefinition>, Icon = ResourceIcon> = { [Resource in LayoutResourceKey<Resources>]: CreatedResourceLinkBase<Resource, Icon> | CreateResourceLinkWithHash<Resource, string, Icon> }[LayoutResourceKey<Resources>];
+type CreateResourceLinksWithGroups<Resources extends ReadonlyArray<ResourceDefinition>, GroupIcon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>, LinkIcon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>> = {
   activeIcon?: ReactNode;
   id: string;
   label: string | null;
-  icon: ResourceIcon<LayoutRenderResourcesAccessor<Resources>>;
-  links: Array<AnyCreatedResourceLink<Resources>>;
+  icon: GroupIcon | null;
+  links: Array<AnyCreatedResourceLink<Resources, LinkIcon>>;
 };
-type ResolvedResourceLinksWithGroups<Resources extends ReadonlyArray<ResourceDefinition>> = Omit<CreateResourceLinksWithGroups<Resources>, 'icon' | 'links'> & {
-  icon: ReactNode;
-  links: Array<Omit<AnyCreatedResourceLink<Resources>, 'icon'> & {
-    icon: ReactNode;
+type ResolveResourceIcon<Icon> = Icon extends ((...args: any[]) => infer Result) ? Result : Icon;
+type ResolvedResourceLinksWithGroups<Resources extends ReadonlyArray<ResourceDefinition>, GroupIcon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>, LinkIcon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>> = Omit<CreateResourceLinksWithGroups<Resources, GroupIcon, LinkIcon>, 'icon' | 'links'> & {
+  icon: ResolveResourceIcon<GroupIcon> | null;
+  links: Array<Omit<AnyCreatedResourceLink<Resources, LinkIcon>, 'icon'> & {
+    icon: ResolveResourceIcon<LinkIcon> | null;
   }>;
 };
 type CreateResourceMap<Resources extends ReadonlyArray<ResourceDefinition>, Value> = Partial<Record<LayoutResourceKey<Resources>, Value>>;
@@ -160,9 +173,9 @@ interface CreateResourceLinksWithGroupsFn<Resources extends ReadonlyArray<Resour
    * @param groups The sections to create. At least one is required. The link
    * keys in those sections are the resources `findResource` can resolve.
    */
-  <const Resource extends ResourceLinkConfigResource<Resources>>(groups: NonEmptyReadonlyArray<CreateResourceLinkGroupInput<Resources, Resource>>): CreateResourceLinksWithGroupsResult<Resources, Resource>;
+  <const Resource extends ResourceLinkConfigResource<Resources>, const Groups extends ReadonlyArray<unknown>>(groups: NonEmptyReadonlyArray<CreateResourceLinkGroupInput<Resources, Resource>> & Groups): CreateResourceLinksWithGroupsResult<Resources, ResourceLinkGroupResource<Groups>, ResourceLinkGroupIcon<Groups>, ResourceLinkGroupLinkIcon<Groups>>;
 }
-type CreateResourceLinksWithGroupsResult<Resources extends ReadonlyArray<ResourceDefinition>, Resource extends ResourceLinkConfigResource<Resources> = ResourceLinkConfigResource<Resources>> = Array<CreateResourceLinksWithGroups<Resources>> & {
+type CreateResourceLinksWithGroupsResult<Resources extends ReadonlyArray<ResourceDefinition>, Resource extends ResourceLinkConfigResource<Resources> = ResourceLinkConfigResource<Resources>, GroupIcon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>, LinkIcon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>> = Array<CreateResourceLinksWithGroups<Resources, GroupIcon, LinkIcon>> & {
   /**
    * Resolves each group's icon and its link icons for the active resource.
    *
@@ -171,7 +184,7 @@ type CreateResourceLinksWithGroupsResult<Resources extends ReadonlyArray<Resourc
    *
    * @param resource The active resource key.
    */
-  (resource: LayoutResourceKey<Resources>): ResolvedResourceLinksWithGroupsResult<Resources, Resource>;
+  (resource: LayoutResourceKey<Resources>): ResolvedResourceLinksWithGroupsResult<Resources, Resource, GroupIcon, LinkIcon>;
   /**
    * Creates a resource map for this layout. Same helper as
    * `createResourceLinks.createResourceMap`.
@@ -188,13 +201,13 @@ type CreateResourceLinksWithGroupsResult<Resources extends ReadonlyArray<Resourc
    *
    * @param resource The resource whose group should be returned.
    */
-  findResource<const RequestedResource extends LayoutResourceKey<Resources> | Resource>(resource: RequestedResource): FindResourceGroupResult<Resources, Resource, RequestedResource>;
+  findResource<const RequestedResource extends LayoutResourceKey<Resources> | Resource>(resource: RequestedResource): FindResourceGroupResult<Resources, Resource, RequestedResource, GroupIcon, LinkIcon>;
 };
-type ResolvedResourceLinksWithGroupsResult<Resources extends ReadonlyArray<ResourceDefinition>, Resource extends ResourceLinkConfigResource<Resources> = ResourceLinkConfigResource<Resources>> = Array<ResolvedResourceLinksWithGroups<Resources>> & {
-  /** Returns the resolved group whose links include `resource`. */findResource<const RequestedResource extends LayoutResourceKey<Resources> | Resource>(resource: RequestedResource): FindResolvedResourceGroupResult<Resources, Resource, RequestedResource>;
+type ResolvedResourceLinksWithGroupsResult<Resources extends ReadonlyArray<ResourceDefinition>, Resource extends ResourceLinkConfigResource<Resources> = ResourceLinkConfigResource<Resources>, GroupIcon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>, LinkIcon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>> = Array<ResolvedResourceLinksWithGroups<Resources, GroupIcon, LinkIcon>> & {
+  /** Returns the resolved group whose links include `resource`. */findResource<const RequestedResource extends LayoutResourceKey<Resources> | Resource>(resource: RequestedResource): FindResolvedResourceGroupResult<Resources, Resource, RequestedResource, GroupIcon, LinkIcon>;
 };
-type FindResourceGroupResult<Resources extends ReadonlyArray<ResourceDefinition>, IncludedResource extends string, RequestedResource extends string> = RequestedResource extends unknown ? RequestedResource extends IncludedResource ? CreateResourceLinksWithGroups<Resources> : undefined : never;
-type FindResolvedResourceGroupResult<Resources extends ReadonlyArray<ResourceDefinition>, IncludedResource extends string, RequestedResource extends string> = RequestedResource extends unknown ? RequestedResource extends IncludedResource ? ResolvedResourceLinksWithGroups<Resources> : undefined : never;
+type FindResourceGroupResult<Resources extends ReadonlyArray<ResourceDefinition>, IncludedResource extends string, RequestedResource extends string, GroupIcon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>, LinkIcon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>> = RequestedResource extends unknown ? RequestedResource extends IncludedResource ? CreateResourceLinksWithGroups<Resources, GroupIcon, LinkIcon> : undefined : never;
+type FindResolvedResourceGroupResult<Resources extends ReadonlyArray<ResourceDefinition>, IncludedResource extends string, RequestedResource extends string, GroupIcon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>, LinkIcon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>> = RequestedResource extends unknown ? RequestedResource extends IncludedResource ? ResolvedResourceLinksWithGroups<Resources, GroupIcon, LinkIcon> : undefined : never;
 //#endregion
 export { CreateResourceLinkConfig, CreateResourceLinkGroupInput, CreateResourceLinkGroupOptions, CreateResourceLinkOptions, CreateResourceLinksFn, CreateResourceLinksWithGroups, CreateResourceLinksWithGroupsFn, CreateResourceLinksWithGroupsResult, CreateResourceMap, CreateResourceMapFn, CreatedResourceHref, CreatedResourceLink, CreatedResourceLinkBase, CreatedResourceMap, DefineResourceIconFn, DefineResourceIconInputHelpers, DefineResourceIconInputResult, FindResolvedResourceGroupResult, FindResourceGroupResult, InferHashFromResourceLinkHref, ResolveResourceIconInput, ResolvedResourceLinksWithGroups, ResolvedResourceLinksWithGroupsResult, ResourceAnchorLinkFn, ResourceIcon, ResourceIconFn, ResourceLinkHref, ValidateResource };
 //# sourceMappingURL=create-resource-links.d.cts.map

package/dist/create-config/create-resource-links.d.cts.map

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

package/dist/create-config/create-resource-links.d.mts

@@ -35,7 +35,7 @@ interface DefineResourceIconFn<Resources extends ReadonlyArray<ResourceDefinitio
   }) => ReactNode): (Icon: Icon) => ResourceIconFn<LayoutRenderResourcesAccessor<Resources>>;
   input<Definition>(defineInput: (helpers: DefineResourceIconInputHelpers<Resources>) => Definition): DefineResourceIconInputResult<Resources, Definition>;
 }
-interface CreateResourceLinkOptions<Resources extends ReadonlyArray<ResourceDefinition>, Resource extends ResourceLinkConfigResource<Resources>> {
+interface CreateResourceLinkOptions<Resources extends ReadonlyArray<ResourceDefinition>, Resource extends ResourceLinkConfigResource<Resources>, Icon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>> {
   /**
    * The label of the link. This is the text that will be displayed in the link.
    */
@@ -48,7 +48,7 @@ interface CreateResourceLinkOptions<Resources extends ReadonlyArray<ResourceDefi
    * An optional icon to register with the link. This is a headless approach, meaning you have full control
    * over the icon's rendering.
    */
-  icon?: ResourceIcon<LayoutRenderResourcesAccessor<Resources>>;
+  icon?: Icon;
   /**
    * The href of the link. By default, the href will be `"/"`. While you **don't** need to include a hash,
    * if you do, it will override the `hash` property (if provided).
@@ -62,7 +62,7 @@ interface CreateResourceLinkOptions<Resources extends ReadonlyArray<ResourceDefi
    */
   hash?: ResourceLinkHref<Resource>;
 }
-type CreateResourceLinkConfig<Resources extends ReadonlyArray<ResourceDefinition>, Resource extends ResourceLinkConfigResource<Resources> = ResourceLinkConfigResource<Resources>> = { [Key in Resource]?: CreateResourceLinkOptions<Resources, Key> };
+type CreateResourceLinkConfig<Resources extends ReadonlyArray<ResourceDefinition>, Resource extends ResourceLinkConfigResource<Resources> = ResourceLinkConfigResource<Resources>, Icon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>> = { [Key in Resource]?: CreateResourceLinkOptions<Resources, Key, Icon> };
 type InferHashFromResourceLinkHref<Resource extends string, Hash extends ResourceLinkHref<Resource>> = Hash extends string ? Hash : Hash extends ResourceAnchorLinkFn<Resource> ? ReturnType<Hash> : never;
 type CreatedResourceHref = {
   /**
@@ -74,28 +74,31 @@ type CreatedResourceHref = {
    */
   given: string;
 };
-type CreatedResourceLinkBase<Resource extends string> = {
+type CreatedResourceLinkBase<Resource extends string, Icon = ResourceIcon> = {
   activeIcon?: ReactNode;
   href: CreatedResourceHref;
   label: string;
   resource: Resource;
-  icon: ResourceIcon;
+  icon: Icon | null;
 };
-type CreateResourceLinkWithHash<Resource extends string, Hash extends ResourceLinkHref<Resource>> = Omit<CreatedResourceLinkBase<Resource>, 'href'> & {
+type CreateResourceLinkWithHash<Resource extends string, Hash extends ResourceLinkHref<Resource>, Icon = ResourceIcon> = Omit<CreatedResourceLinkBase<Resource, Icon>, 'href'> & {
   href: CreatedResourceHref & {
     hash: InferHashFromResourceLinkHref<Resource, Hash>;
   };
 };
-type CreatedResourceLink<Resources extends ReadonlyArray<ResourceDefinition>, Config> = { [Resource in keyof Config]-?: Resource extends ResourceLinkConfigResource<Resources> ? Config[Resource] extends {
+type CreatedResourceLink<Resources extends ReadonlyArray<ResourceDefinition>, Config, Icon = ResourceIcon> = { [Resource in keyof Config]-?: Resource extends ResourceLinkConfigResource<Resources> ? Config[Resource] extends {
   hash: infer hash extends ResourceLinkHref<Resource>;
-} ? CreateResourceLinkWithHash<Resource, hash> : CreatedResourceLinkBase<Resource> : never }[keyof Config];
+} ? CreateResourceLinkWithHash<Resource, hash, Icon> : CreatedResourceLinkBase<Resource, Icon> : never }[keyof Config];
+type ResourceLinkConfigIcon<Config> = { [Resource in keyof Config]-?: 'icon' extends keyof NonNullable<Config[Resource]> ? NonNullable<Config[Resource]> extends {
+  icon?: infer Icon;
+} ? Icon : never : never }[keyof Config];
 interface CreateResourceLinksFn<Resources extends ReadonlyArray<ResourceDefinition>> {
-  <const Resource extends ResourceLinkConfigResource<Resources>>(config: CreateResourceLinkConfig<Resources, Resource>): Array<CreatedResourceLink<Resources, CreateResourceLinkConfig<Resources, Resource>>>;
+  <const Resource extends ResourceLinkConfigResource<Resources>, const Config extends object>(config: CreateResourceLinkConfig<Resources, Resource> & Config): Array<CreatedResourceLink<Resources, Config, ResourceLinkConfigIcon<Config>>>;
   createResourceMap: CreateResourceMapFn<Resources>;
   defineIcon: DefineResourceIconFn<Resources>;
   withGroups: CreateResourceLinksWithGroupsFn<Resources>;
 }
-interface CreateResourceLinkGroupOptions<Resources extends ReadonlyArray<ResourceDefinition>, Links extends object = CreateResourceLinkConfig<Resources>> {
+interface CreateResourceLinkGroupOptions<Resources extends ReadonlyArray<ResourceDefinition>, Links extends object = CreateResourceLinkConfig<Resources>, Icon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>> {
   /**
    * An optional, caller-provided identity for the group. Provide this when you
    * combine groups from more than one `withGroups()` call into one list (e.g.
@@ -117,25 +120,35 @@ interface CreateResourceLinkGroupOptions<Resources extends ReadonlyArray<Resourc
    * An optional icon to register with the group. This is a headless approach, meaning you have full control
    * over the icon's rendering.
    */
-  icon?: ResourceIcon<LayoutRenderResourcesAccessor<Resources>>;
+  icon?: Icon;
   /**
    * The resource links in this group.
    */
   links: Links;
 }
-type CreateResourceLinkGroupInput<Resources extends ReadonlyArray<ResourceDefinition>, Resource extends ResourceLinkConfigResource<Resources> = ResourceLinkConfigResource<Resources>> = CreateResourceLinkGroupOptions<Resources, CreateResourceLinkConfig<Resources, Resource>>;
-type AnyCreatedResourceLink<Resources extends ReadonlyArray<ResourceDefinition>> = { [Resource in LayoutResourceKey<Resources>]: CreatedResourceLinkBase<Resource> | CreateResourceLinkWithHash<Resource, string> }[LayoutResourceKey<Resources>];
-type CreateResourceLinksWithGroups<Resources extends ReadonlyArray<ResourceDefinition>> = {
+type CreateResourceLinkGroupInput<Resources extends ReadonlyArray<ResourceDefinition>, Resource extends ResourceLinkConfigResource<Resources> = ResourceLinkConfigResource<Resources>, Icon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>> = CreateResourceLinkGroupOptions<Resources, CreateResourceLinkConfig<Resources, Resource, Icon>, Icon>;
+type ResourceLinkGroupResource<Groups extends ReadonlyArray<unknown>> = Groups[number] extends infer Group ? Group extends {
+  links: infer Links;
+} ? Extract<keyof Links, string> : never : never;
+type ResourceLinkGroupIcon<Groups extends ReadonlyArray<unknown>> = Groups[number] extends infer Group ? 'icon' extends keyof Group ? Group extends {
+  icon?: infer Icon;
+} ? Icon : never : never : never;
+type ResourceLinkGroupLinkIcon<Groups extends ReadonlyArray<unknown>> = Groups[number] extends infer Group ? Group extends {
+  links: infer Links;
+} ? ResourceLinkConfigIcon<Links> : never : never;
+type AnyCreatedResourceLink<Resources extends ReadonlyArray<ResourceDefinition>, Icon = ResourceIcon> = { [Resource in LayoutResourceKey<Resources>]: CreatedResourceLinkBase<Resource, Icon> | CreateResourceLinkWithHash<Resource, string, Icon> }[LayoutResourceKey<Resources>];
+type CreateResourceLinksWithGroups<Resources extends ReadonlyArray<ResourceDefinition>, GroupIcon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>, LinkIcon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>> = {
   activeIcon?: ReactNode;
   id: string;
   label: string | null;
-  icon: ResourceIcon<LayoutRenderResourcesAccessor<Resources>>;
-  links: Array<AnyCreatedResourceLink<Resources>>;
+  icon: GroupIcon | null;
+  links: Array<AnyCreatedResourceLink<Resources, LinkIcon>>;
 };
-type ResolvedResourceLinksWithGroups<Resources extends ReadonlyArray<ResourceDefinition>> = Omit<CreateResourceLinksWithGroups<Resources>, 'icon' | 'links'> & {
-  icon: ReactNode;
-  links: Array<Omit<AnyCreatedResourceLink<Resources>, 'icon'> & {
-    icon: ReactNode;
+type ResolveResourceIcon<Icon> = Icon extends ((...args: any[]) => infer Result) ? Result : Icon;
+type ResolvedResourceLinksWithGroups<Resources extends ReadonlyArray<ResourceDefinition>, GroupIcon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>, LinkIcon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>> = Omit<CreateResourceLinksWithGroups<Resources, GroupIcon, LinkIcon>, 'icon' | 'links'> & {
+  icon: ResolveResourceIcon<GroupIcon> | null;
+  links: Array<Omit<AnyCreatedResourceLink<Resources, LinkIcon>, 'icon'> & {
+    icon: ResolveResourceIcon<LinkIcon> | null;
   }>;
 };
 type CreateResourceMap<Resources extends ReadonlyArray<ResourceDefinition>, Value> = Partial<Record<LayoutResourceKey<Resources>, Value>>;
@@ -160,9 +173,9 @@ interface CreateResourceLinksWithGroupsFn<Resources extends ReadonlyArray<Resour
    * @param groups The sections to create. At least one is required. The link
    * keys in those sections are the resources `findResource` can resolve.
    */
-  <const Resource extends ResourceLinkConfigResource<Resources>>(groups: NonEmptyReadonlyArray<CreateResourceLinkGroupInput<Resources, Resource>>): CreateResourceLinksWithGroupsResult<Resources, Resource>;
+  <const Resource extends ResourceLinkConfigResource<Resources>, const Groups extends ReadonlyArray<unknown>>(groups: NonEmptyReadonlyArray<CreateResourceLinkGroupInput<Resources, Resource>> & Groups): CreateResourceLinksWithGroupsResult<Resources, ResourceLinkGroupResource<Groups>, ResourceLinkGroupIcon<Groups>, ResourceLinkGroupLinkIcon<Groups>>;
 }
-type CreateResourceLinksWithGroupsResult<Resources extends ReadonlyArray<ResourceDefinition>, Resource extends ResourceLinkConfigResource<Resources> = ResourceLinkConfigResource<Resources>> = Array<CreateResourceLinksWithGroups<Resources>> & {
+type CreateResourceLinksWithGroupsResult<Resources extends ReadonlyArray<ResourceDefinition>, Resource extends ResourceLinkConfigResource<Resources> = ResourceLinkConfigResource<Resources>, GroupIcon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>, LinkIcon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>> = Array<CreateResourceLinksWithGroups<Resources, GroupIcon, LinkIcon>> & {
   /**
    * Resolves each group's icon and its link icons for the active resource.
    *
@@ -171,7 +184,7 @@ type CreateResourceLinksWithGroupsResult<Resources extends ReadonlyArray<Resourc
    *
    * @param resource The active resource key.
    */
-  (resource: LayoutResourceKey<Resources>): ResolvedResourceLinksWithGroupsResult<Resources, Resource>;
+  (resource: LayoutResourceKey<Resources>): ResolvedResourceLinksWithGroupsResult<Resources, Resource, GroupIcon, LinkIcon>;
   /**
    * Creates a resource map for this layout. Same helper as
    * `createResourceLinks.createResourceMap`.
@@ -188,13 +201,13 @@ type CreateResourceLinksWithGroupsResult<Resources extends ReadonlyArray<Resourc
    *
    * @param resource The resource whose group should be returned.
    */
-  findResource<const RequestedResource extends LayoutResourceKey<Resources> | Resource>(resource: RequestedResource): FindResourceGroupResult<Resources, Resource, RequestedResource>;
+  findResource<const RequestedResource extends LayoutResourceKey<Resources> | Resource>(resource: RequestedResource): FindResourceGroupResult<Resources, Resource, RequestedResource, GroupIcon, LinkIcon>;
 };
-type ResolvedResourceLinksWithGroupsResult<Resources extends ReadonlyArray<ResourceDefinition>, Resource extends ResourceLinkConfigResource<Resources> = ResourceLinkConfigResource<Resources>> = Array<ResolvedResourceLinksWithGroups<Resources>> & {
-  /** Returns the resolved group whose links include `resource`. */findResource<const RequestedResource extends LayoutResourceKey<Resources> | Resource>(resource: RequestedResource): FindResolvedResourceGroupResult<Resources, Resource, RequestedResource>;
+type ResolvedResourceLinksWithGroupsResult<Resources extends ReadonlyArray<ResourceDefinition>, Resource extends ResourceLinkConfigResource<Resources> = ResourceLinkConfigResource<Resources>, GroupIcon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>, LinkIcon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>> = Array<ResolvedResourceLinksWithGroups<Resources, GroupIcon, LinkIcon>> & {
+  /** Returns the resolved group whose links include `resource`. */findResource<const RequestedResource extends LayoutResourceKey<Resources> | Resource>(resource: RequestedResource): FindResolvedResourceGroupResult<Resources, Resource, RequestedResource, GroupIcon, LinkIcon>;
 };
-type FindResourceGroupResult<Resources extends ReadonlyArray<ResourceDefinition>, IncludedResource extends string, RequestedResource extends string> = RequestedResource extends unknown ? RequestedResource extends IncludedResource ? CreateResourceLinksWithGroups<Resources> : undefined : never;
-type FindResolvedResourceGroupResult<Resources extends ReadonlyArray<ResourceDefinition>, IncludedResource extends string, RequestedResource extends string> = RequestedResource extends unknown ? RequestedResource extends IncludedResource ? ResolvedResourceLinksWithGroups<Resources> : undefined : never;
+type FindResourceGroupResult<Resources extends ReadonlyArray<ResourceDefinition>, IncludedResource extends string, RequestedResource extends string, GroupIcon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>, LinkIcon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>> = RequestedResource extends unknown ? RequestedResource extends IncludedResource ? CreateResourceLinksWithGroups<Resources, GroupIcon, LinkIcon> : undefined : never;
+type FindResolvedResourceGroupResult<Resources extends ReadonlyArray<ResourceDefinition>, IncludedResource extends string, RequestedResource extends string, GroupIcon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>, LinkIcon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>> = RequestedResource extends unknown ? RequestedResource extends IncludedResource ? ResolvedResourceLinksWithGroups<Resources, GroupIcon, LinkIcon> : undefined : never;
 //#endregion
 export { CreateResourceLinkConfig, CreateResourceLinkGroupInput, CreateResourceLinkGroupOptions, CreateResourceLinkOptions, CreateResourceLinksFn, CreateResourceLinksWithGroups, CreateResourceLinksWithGroupsFn, CreateResourceLinksWithGroupsResult, CreateResourceMap, CreateResourceMapFn, CreatedResourceHref, CreatedResourceLink, CreatedResourceLinkBase, CreatedResourceMap, DefineResourceIconFn, DefineResourceIconInputHelpers, DefineResourceIconInputResult, FindResolvedResourceGroupResult, FindResourceGroupResult, InferHashFromResourceLinkHref, ResolveResourceIconInput, ResolvedResourceLinksWithGroups, ResolvedResourceLinksWithGroupsResult, ResourceAnchorLinkFn, ResourceIcon, ResourceIconFn, ResourceLinkHref, ValidateResource };
 //# sourceMappingURL=create-resource-links.d.mts.map

package/dist/create-config/create-resource-links.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"create-resource-links.d.mts","names":[],"sources":["../../src/create-config/create-resource-links.ts"],"mappings":"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"}
+{"version":3,"file":"create-resource-links.d.mts","names":[],"sources":["../../src/create-config/create-resource-links.ts"],"mappings":";;;;;;KAaY,oBAAA,6BACV,QAAA,EAAU,QAAQ;AAAA,KAGR,gBAAA,qCAER,oBAAoB,CAAC,QAAA;AAAA,KAEb,0BAAA,mBACQ,aAAA,CAAc,kBAAA,KAC9B,iBAAA,CAAkB,SAAA;AAAA,KAEV,cAAA,oBAAkC,QAAA,EAAU,QAAA,KAAa,SAAS;AAAA,KAElE,YAAA,mBAA+B,SAAA,GAAY,cAAA,CAAe,QAAA;AAAA,cAExD,uBAAA;AAAA,cACA,gCAAA;AAAA,KAET,uBAAA;EAAA,UACO,uBAAuB,GAAG,KAAA;AAAA;AAAA,KAGjC,gCAAA,cAA8C,WAAA;EAAA,UACvC,gCAAA,GAAmC,IAAA;AAAA;AAAA,KAGnC,wBAAA,eACV,UAAA,SAAmB,gCAAA,eACf,IAAA,GACA,UAAA,SAAmB,uBAAA,gBACjB,KAAA,GACA,UAAA,SAAmB,aAAA,8BACC,UAAA,GAAa,wBAAA,CAAyB,UAAA,CAAW,KAAA,OACnE,UAAA,kCACkB,UAAA,GAAa,wBAAA,CAAyB,UAAA,CAAW,GAAA,OACjE,UAAA;AAAA,UAEK,8BAAA,mBACG,aAAA,CAAc,kBAAA;EAEhC,QAAA,IAAY,uBAAA,CAAwB,iBAAA,CAAkB,SAAA;EACtD,IAAA,cAAkB,WAAA,GAAc,WAAA,KAAgB,gCAAA,CAAiC,IAAA;AAAA;AAAA,UAGlE,6BAAA,mBACG,aAAA,CAAc,kBAAA;EAGhC,MAAA,CACE,MAAA,GAAS,OAAA;IACP,QAAA,EAAU,6BAAA,CAA8B,SAAA;IACxC,KAAA,EAAO,wBAAA,CAAyB,UAAA;EAAA,MAC5B,SAAA,IAEN,KAAA,EAAO,wBAAA,CAAyB,UAAA,MAC7B,cAAA,CAAe,6BAAA,CAA8B,SAAA;AAAA;AAAA,UAGnC,oBAAA,mBACG,aAAA,CAAc,kBAAA;EAAA,cAElB,WAAA,GAAc,WAAA,EAC1B,MAAA,GAAS,OAAA;IACP,QAAA,EAAU,6BAAA,CAA8B,SAAA;IACxC,IAAA,EAAM,IAAA;EAAA,MACF,SAAA,IACJ,IAAA,EAAM,IAAA,KAAS,cAAA,CAAe,6BAAA,CAA8B,SAAA;EAChE,KAAA,aACE,WAAA,GACE,OAAA,EAAS,8BAAA,CAA+B,SAAA,MACrC,UAAA,GACJ,6BAAA,CAA8B,SAAA,EAAW,UAAA;AAAA;AAAA,UAE7B,yBAAA,mBACG,aAAA,CAAc,kBAAA,oBACf,0BAAA,CAA2B,SAAA,UACrC,YAAA,CAAa,6BAAA,CAA8B,SAAA;EAjExC;;;EAsEV,KAAA;EAtEyB;;;EA0EzB,UAAA,GAAa,SAAA;EA1E+D;AAAA;AAE9E;;EA6EE,IAAA,GAAO,IAAA;EA7EkC;;;;EAkFzC,IAAA,GAAO,gBAAA,CAAiB,QAAA;EAlFD;;;;;AAAqD;EAyF5E,IAAA,GAAO,gBAAA,CAAiB,QAAA;AAAA;AAAA,KAGd,wBAAA,mBACQ,aAAA,CAAc,kBAAA,oBACf,0BAAA,CAA2B,SAAA,IAAa,0BAAA,CAA2B,SAAA,UAC7E,YAAA,CAAa,6BAAA,CAA8B,SAAA,gBAE1C,QAAA,IAAY,yBAAA,CAClB,SAAA,EACA,GAAA,EACA,IAAA;AAAA,KAIQ,6BAAA,uCAEG,gBAAA,CAAiB,QAAA,KAC5B,IAAA,kBACA,IAAA,GACA,IAAA,SAAa,oBAAA,CAAqB,QAAA,IAChC,UAAA,CAAW,IAAA;AAAA,KAGL,mBAAA;;;AA9GiD;EAkH3D,IAAA;EAhH0B;;;EAoH1B,KAAK;AAAA;AAAA,KAGK,uBAAA,iCAEH,YAAA;EAEP,UAAA,GAAa,SAAA;EACb,IAAA,EAAM,mBAAA;EACN,KAAA;EACA,QAAA,EAAU,QAAA;EACV,IAAA,EAAM,IAAA;AAAA;AAAA,KAEI,0BAAA,uCAEG,gBAAA,CAAiB,QAAA,UACvB,YAAA,IACL,IAAA,CAAK,uBAAA,CAAwB,QAAA,EAAU,IAAA;EACzC,IAAA,EAAM,mBAAA;IACJ,IAAA,EAAM,6BAAA,CAA8B,QAAA,EAAU,IAAA;EAAA;AAAA;AAAA,KAItC,mBAAA,mBACQ,aAAA,CAAc,kBAAA,kBAEzB,YAAA,yBAEY,MAAA,KAAW,QAAA,SAAiB,0BAAA,CAA2B,SAAA,IACtE,MAAA,CAAO,QAAA;EACL,IAAA,qBAAyB,gBAAA,CAAiB,QAAA;AAAA,IAE1C,0BAAA,CAA2B,QAAA,EAAU,IAAA,EAAM,IAAA,IAC3C,uBAAA,CAAwB,QAAA,EAAU,IAAA,kBAElC,MAAA;AAAA,KAEH,sBAAA,gCACgB,MAAA,0BAAgC,WAAA,CACjD,MAAA,CAAO,QAAA,KAEL,WAAA,CAAY,MAAA,CAAO,QAAA;EAAqB,IAAA;AAAA,IACtC,IAAA,yBAGA,MAAA;AAAA,UAES,qBAAA,mBACG,aAAA,CAAc,kBAAA;EAAA,wBAGP,0BAAA,CAA2B,SAAA,gCAGlD,MAAA,EAAQ,wBAAA,CAAyB,SAAA,EAAW,QAAA,IAAY,MAAA,GACvD,KAAA,CACD,mBAAA,CACE,SAAA,EACA,MAAA,EACA,sBAAA,CAAuB,MAAA;EAG3B,iBAAA,EAAmB,mBAAA,CAAoB,SAAA;EACvC,UAAA,EAAY,oBAAA,CAAqB,SAAA;EACjC,UAAA,EAAY,+BAAA,CAAgC,SAAA;AAAA;AAAA,UAG7B,8BAAA,mBACG,aAAA,CAAc,kBAAA,0BAE9B,wBAAA,CAAyB,SAAA,UACpB,YAAA,CAAa,6BAAA,CAA8B,SAAA;EA7KX;;;;;;;;EAuLvC,EAAA;EA7LmC;;;EAiMnC,KAAA;EA/LI;;;EAmMJ,UAAA,GAAa,SAAA;EAjMP;;;;EAsMN,IAAA,GAAO,IAAA;EApMgC;;;EAwMvC,KAAA,EAAO,KAAA;AAAA;AAAA,KAGG,4BAAA,mBACQ,aAAA,CAAc,kBAAA,oBACf,0BAAA,CAA2B,SAAA,IAAa,0BAAA,CAA2B,SAAA,UAC7E,YAAA,CAAa,6BAAA,CAA8B,SAAA,MAChD,8BAAA,CACF,SAAA,EACA,wBAAA,CAAyB,SAAA,EAAW,QAAA,EAAU,IAAA,GAC9C,IAAA;AAAA,KAGG,yBAAA,gBAAyC,aAAA,aAC5C,MAAA,+BACI,KAAA;EAAgB,KAAA;AAAA,IACd,OAAA,OAAc,KAAA;AAAA,KAIjB,qBAAA,gBAAqC,aAAA,aACxC,MAAA,oDACyB,KAAA,GACnB,KAAA;EAAgB,IAAA;AAAA,IACd,IAAA;AAAA,KAKL,yBAAA,gBAAyC,aAAA,aAC5C,MAAA,+BACI,KAAA;EAAgB,KAAA;AAAA,IACd,sBAAA,CAAuB,KAAA;AAAA,KAInB,sBAAA,mBACQ,aAAA,CAAc,kBAAA,UACzB,YAAA,mBAEM,iBAAA,CAAkB,SAAA,IAC3B,uBAAA,CAAwB,QAAA,EAAU,IAAA,IAClC,0BAAA,CAA2B,QAAA,UAAkB,IAAA,IACjD,iBAAA,CAAkB,SAAA;AAAA,KAER,6BAAA,mBACQ,aAAA,CAAc,kBAAA,eACpB,YAAA,CAAa,6BAAA,CAA8B,SAAA,eAC5C,YAAA,CAAa,6BAAA,CAA8B,SAAA;EAEtD,UAAA,GAAa,SAAA;EACb,EAAA;EACA,KAAA;EACA,IAAA,EAAM,SAAA;EACN,KAAA,EAAO,KAAA,CAAM,sBAAA,CAAuB,SAAA,EAAW,QAAA;AAAA;AAAA,KAG5C,mBAAA,SAA4B,IAAA,cAAiB,IAAA,4BAC9C,MAAA,GACA,IAAI;AAAA,KAEI,+BAAA,mBACQ,aAAA,CAAc,kBAAA,eACpB,YAAA,CAAa,6BAAA,CAA8B,SAAA,eAC5C,YAAA,CAAa,6BAAA,CAA8B,SAAA,MACpD,IAAA,CACF,6BAAA,CAA8B,SAAA,EAAW,SAAA,EAAW,QAAA;EAGpD,IAAA,EAAM,mBAAA,CAAoB,SAAA;EAC1B,KAAA,EAAO,KAAA,CACL,IAAA,CAAK,sBAAA,CAAuB,SAAA,EAAW,QAAA;IACrC,IAAA,EAAM,mBAAA,CAAoB,QAAA;EAAA;AAAA;AAAA,KAKpB,iBAAA,mBACQ,aAAA,CAAc,kBAAA,YAE9B,OAAA,CAAQ,MAAA,CAAO,iBAAA,CAAkB,SAAA,GAAY,KAAA;AAAA,KAErC,gBAAA,gDAGR,QAAA,SAAiB,OAAA,OAAc,GAAA,YAAe,QAAA;AAAA,KAEtC,kBAAA,uBAAyC,GAAA;EACnD,eAAA,CAAgB,KAAA,YAAiB,KAAA,IAAS,OAAA,OAAc,GAAA;EACxD,GAAA,gCACE,QAAA,EAAU,gBAAA,CAAiB,QAAA,EAAU,GAAA,IACpC,GAAA,QAAW,QAAA;AAAA;AAAA,UAGC,mBAAA,mBACG,aAAA,CAAc,kBAAA;EA9RqD;AAAA;AAGvF;;;;EAHuF,mBAsSlE,iBAAA,CAAkB,SAAA,YACnC,GAAA,EAAK,GAAA,GACJ,kBAAA,CAAmB,GAAA;AAAA;AAAA,UAGP,+BAAA,mBACG,aAAA,CAAc,kBAAA;EAlSI;;;;;;EAAA,wBA2SX,0BAAA,CAA2B,SAAA,wBAC7B,aAAA,WAErB,MAAA,EAAQ,qBAAA,CACN,4BAAA,CAA6B,SAAA,EAAW,QAAA,KAExC,MAAA,GACD,mCAAA,CACD,SAAA,EACA,yBAAA,CAA0B,MAAA,GAC1B,qBAAA,CAAsB,MAAA,GACtB,yBAAA,CAA0B,MAAA;AAAA;AAAA,KAIlB,mCAAA,mBACQ,aAAA,CAAc,kBAAA,oBACf,0BAAA,CAA2B,SAAA,IAAa,0BAAA,CAA2B,SAAA,eACxE,YAAA,CAAa,6BAAA,CAA8B,SAAA,eAC5C,YAAA,CAAa,6BAAA,CAA8B,SAAA,MACpD,KAAA,CAAM,6BAAA,CAA8B,SAAA,EAAW,SAAA,EAAW,QAAA;EA3TzC;;;;;;;;EAAA,CAqUjB,QAAA,EAAU,iBAAA,CAAkB,SAAA,IAC3B,qCAAA,CACD,SAAA,EACA,QAAA,EACA,SAAA,EACA,QAAA;EA9UE;;;;;;;EAuVJ,iBAAA,EAAmB,mBAAA,CAAoB,SAAA;EApVrC;;;;;AACyD;AAG7D;;EAyVE,YAAA,iCACkC,iBAAA,CAAkB,SAAA,IAAa,QAAA,EAE/D,QAAA,EAAU,iBAAA,GACT,uBAAA,CACD,SAAA,EACA,QAAA,EACA,iBAAA,EACA,SAAA,EACA,QAAA;AAAA;AAAA,KAIQ,qCAAA,mBACQ,aAAA,CAAc,kBAAA,oBACf,0BAAA,CAA2B,SAAA,IAAa,0BAAA,CAA2B,SAAA,eACxE,YAAA,CAAa,6BAAA,CAA8B,SAAA,eAC5C,YAAA,CAAa,6BAAA,CAA8B,SAAA,MACpD,KAAA,CACF,+BAAA,CAAgC,SAAA,EAAW,SAAA,EAAW,QAAA;EAzWxC,iEA4Wd,YAAA,iCACkC,iBAAA,CAAkB,SAAA,IAAa,QAAA,EAE/D,QAAA,EAAU,iBAAA,GACT,+BAAA,CACD,SAAA,EACA,QAAA,EACA,iBAAA,EACA,SAAA,EACA,QAAA;AAAA;AAAA,KAIQ,uBAAA,mBACQ,aAAA,CAAc,kBAAA,kFAGpB,YAAA,CAAa,6BAAA,CAA8B,SAAA,eAC5C,YAAA,CAAa,6BAAA,CAA8B,SAAA,MACpD,iBAAA,mBACA,iBAAA,SAA0B,gBAAA,GACxB,6BAAA,CAA8B,SAAA,EAAW,SAAA,EAAW,QAAA;AAAA,KAI9C,+BAAA,mBACQ,aAAA,CAAc,kBAAA,kFAGpB,YAAA,CAAa,6BAAA,CAA8B,SAAA,eAC5C,YAAA,CAAa,6BAAA,CAA8B,SAAA,MACpD,iBAAA,mBACA,iBAAA,SAA0B,gBAAA,GACxB,+BAAA,CAAgC,SAAA,EAAW,SAAA,EAAW,QAAA"}

package/dist/create-config/create-resource-links.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"create-resource-links.mjs","names":[],"sources":["../../src/create-config/create-resource-links.ts"],"sourcesContent":["import type { ElementType, ReactNode } from 'react';\nimport type { NonEmptyReadonlyArray } from '@jfdevelops/react-layout-validator';\nimport {\n  createIsValidResourceFn,\n  type LayoutResourceKey,\n  type ResourceDefinition,\n} from '../resource';\nimport { LayoutConfigurationError } from '../errors';\nimport type {\n  LayoutRenderResourcesAccessor,\n  ResourceSelection,\n} from './define-layout';\n\nexport type ResourceAnchorLinkFn<Resource extends string> = (\n  resource: Resource,\n) => string;\n\nexport type ResourceLinkHref<Resource extends string> =\n  | string\n  | ResourceAnchorLinkFn<Resource>;\n\nexport type ResourceLinkConfigResource<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = LayoutResourceKey<Resources> | (string & {});\n\nexport type ResourceIconFn<Resource = any> = (resource: Resource) => ReactNode;\n\nexport type ResourceIcon<Resource = any> = ReactNode | ResourceIconFn<Resource>;\n\ndeclare const resourceIconInputMarker: unique symbol;\ndeclare const resourceIconComponentInputMarker: unique symbol;\n\ntype ResourceIconInputMarker<Value> = {\n  readonly [resourceIconInputMarker]: Value;\n};\n\ntype ResourceIconComponentInputMarker<Icon extends ElementType> = {\n  readonly [resourceIconComponentInputMarker]: Icon;\n};\n\nexport type ResolveResourceIconInput<Definition> =\n  Definition extends ResourceIconComponentInputMarker<infer Icon>\n    ? Icon\n    : Definition extends ResourceIconInputMarker<infer Value>\n      ? Value\n      : Definition extends ReadonlyArray<unknown>\n        ? { [Index in keyof Definition]: ResolveResourceIconInput<Definition[Index]> }\n        : Definition extends object\n          ? { [Key in keyof Definition]: ResolveResourceIconInput<Definition[Key]> }\n          : Definition;\n\nexport interface DefineResourceIconInputHelpers<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> {\n  resource(): ResourceIconInputMarker<LayoutResourceKey<Resources>>;\n  icon<Icon extends ElementType = ElementType>(): ResourceIconComponentInputMarker<Icon>;\n}\n\nexport interface DefineResourceIconInputResult<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Definition,\n> {\n  render(\n    render: (options: {\n      resource: LayoutRenderResourcesAccessor<Resources>;\n      input: ResolveResourceIconInput<Definition>;\n    }) => ReactNode,\n  ): (\n    input: ResolveResourceIconInput<Definition>,\n  ) => ResourceIconFn<LayoutRenderResourcesAccessor<Resources>>;\n}\n\nexport interface DefineResourceIconFn<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> {\n  <Icon extends ElementType = ElementType>(\n    render: (options: {\n      resource: LayoutRenderResourcesAccessor<Resources>;\n      Icon: Icon;\n    }) => ReactNode,\n  ): (Icon: Icon) => ResourceIconFn<LayoutRenderResourcesAccessor<Resources>>;\n  input<Definition>(\n    defineInput: (\n      helpers: DefineResourceIconInputHelpers<Resources>,\n    ) => Definition,\n  ): DefineResourceIconInputResult<Resources, Definition>;\n}\nexport interface CreateResourceLinkOptions<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends ResourceLinkConfigResource<Resources>,\n> {\n  /**\n   * The label of the link. This is the text that will be displayed in the link.\n   */\n  label: string;\n  /**\n   * An optional icon to render when the link is active.\n   */\n  activeIcon?: ReactNode;\n  /**\n   * An optional icon to register with the link. This is a headless approach, meaning you have full control\n   * over the icon's rendering.\n   */\n  icon?: ResourceIcon<LayoutRenderResourcesAccessor<Resources>>;\n  /**\n   * The href of the link. By default, the href will be `\"/\"`. While you **don't** need to include a hash,\n   * if you do, it will override the `hash` property (if provided).\n   */\n  href?: ResourceLinkHref<Resource>;\n  /**\n   * The hash of the link. By default, the hash will be the resource name. If you need to customize it, you can provide\n   * a string or a function that returns a string.\n   *\n   * @remarks A `\"#\"` is not required. The generated href will include it automatically.\n   */\n  hash?: ResourceLinkHref<Resource>;\n}\n\nexport type CreateResourceLinkConfig<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends ResourceLinkConfigResource<Resources> = ResourceLinkConfigResource<Resources>,\n> = {\n  [Key in Resource]?: CreateResourceLinkOptions<\n    Resources,\n    Key\n  >;\n};\n\nexport type InferHashFromResourceLinkHref<\n  Resource extends string,\n  Hash extends ResourceLinkHref<Resource>,\n> = Hash extends string\n  ? Hash\n  : Hash extends ResourceAnchorLinkFn<Resource>\n    ? ReturnType<Hash>\n    : never;\n\nexport type CreatedResourceHref = {\n  /**\n   * The full generated href with the `hash` if provided.\n   */\n  full: string;\n  /**\n   * The given href. This is the same value as the `href` property of the config.\n   */\n  given: string;\n};\n\nexport type CreatedResourceLinkBase<Resource extends string> = {\n  activeIcon?: ReactNode;\n  href: CreatedResourceHref;\n  label: string;\n  resource: Resource;\n  icon: ResourceIcon;\n};\nexport type CreateResourceLinkWithHash<\n  Resource extends string,\n  Hash extends ResourceLinkHref<Resource>,\n> = Omit<CreatedResourceLinkBase<Resource>, 'href'> & {\n  href: CreatedResourceHref & {\n    hash: InferHashFromResourceLinkHref<Resource, Hash>;\n  };\n};\n\nexport type CreatedResourceLink<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Config,\n> = {\n  [Resource in keyof Config]-?: Resource extends ResourceLinkConfigResource<Resources>\n    ? Config[Resource] extends {\n        hash: infer hash extends ResourceLinkHref<Resource>;\n      }\n      ? CreateResourceLinkWithHash<Resource, hash>\n      : CreatedResourceLinkBase<Resource>\n    : never;\n}[keyof Config];\n\nexport interface CreateResourceLinksFn<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> {\n  <const Resource extends ResourceLinkConfigResource<Resources>>(\n    config: CreateResourceLinkConfig<Resources, Resource>,\n  ): Array<\n    CreatedResourceLink<\n      Resources,\n      CreateResourceLinkConfig<Resources, Resource>\n    >\n  >;\n  createResourceMap: CreateResourceMapFn<Resources>;\n  defineIcon: DefineResourceIconFn<Resources>;\n  withGroups: CreateResourceLinksWithGroupsFn<Resources>;\n}\n\nexport interface CreateResourceLinkGroupOptions<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Links extends object =\n    CreateResourceLinkConfig<Resources>,\n> {\n  /**\n   * An optional, caller-provided identity for the group. Provide this when you\n   * combine groups from more than one `withGroups()` call into one list (e.g.\n   * a module-owned nav section alongside a feature-owned one) — without it,\n   * the id is derived from the group's `label` and its link resources, which\n   * is enough to keep groups from a single call apart but can't distinguish\n   * two independently-defined groups that happen to look identical.\n   */\n  id?: string;\n  /**\n   * The label of the group. This is the text that will be displayed for the group.\n   */\n  label?: string;\n  /**\n   * An optional icon to render when the group is active.\n   */\n  activeIcon?: ReactNode;\n  /**\n   * An optional icon to register with the group. This is a headless approach, meaning you have full control\n   * over the icon's rendering.\n   */\n  icon?: ResourceIcon<LayoutRenderResourcesAccessor<Resources>>;\n  /**\n   * The resource links in this group.\n   */\n  links: Links;\n}\n\nexport type CreateResourceLinkGroupInput<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends ResourceLinkConfigResource<Resources> = ResourceLinkConfigResource<Resources>,\n> = CreateResourceLinkGroupOptions<\n  Resources,\n  CreateResourceLinkConfig<Resources, Resource>\n>;\n\nexport type AnyCreatedResourceLink<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = {\n  [Resource in LayoutResourceKey<Resources>]:\n    | CreatedResourceLinkBase<Resource>\n    | CreateResourceLinkWithHash<Resource, string>;\n}[LayoutResourceKey<Resources>];\n\nexport type CreateResourceLinksWithGroups<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = {\n  activeIcon?: ReactNode;\n  id: string;\n  label: string | null;\n  icon: ResourceIcon<LayoutRenderResourcesAccessor<Resources>>;\n  links: Array<AnyCreatedResourceLink<Resources>>;\n};\n\nexport type ResolvedResourceLinksWithGroups<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = Omit<CreateResourceLinksWithGroups<Resources>, 'icon' | 'links'> & {\n  icon: ReactNode;\n  links: Array<\n    Omit<AnyCreatedResourceLink<Resources>, 'icon'> & { icon: ReactNode }\n  >;\n};\n\nexport type CreateResourceMap<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Value,\n> = Partial<Record<LayoutResourceKey<Resources>, Value>>;\n\nexport type ValidateResource<\n  Resource extends string,\n  Map extends object,\n> = Resource extends Extract<keyof Map, string> ? Resource : never;\n\nexport type CreatedResourceMap<Map extends object> = Map & {\n  isValidResource(value: unknown): value is Extract<keyof Map, string>;\n  get<const Resource extends string>(\n    resource: ValidateResource<Resource, Map>,\n  ): Map[typeof resource];\n};\n\nexport interface CreateResourceMapFn<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> {\n  /**\n   * Creates a resource map for this layout.\n   *\n   * @param map Values keyed by this layout's resources. An unknown resource,\n   * or a key that collides with a map helper, is rejected.\n   */\n  <const Map extends CreateResourceMap<Resources, unknown>>(\n    map: Map,\n  ): CreatedResourceMap<Map>;\n}\n\nexport interface CreateResourceLinksWithGroupsFn<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> {\n  /**\n   * Groups resource links into sections.\n   *\n   * @param groups The sections to create. At least one is required. The link\n   * keys in those sections are the resources `findResource` can resolve.\n   */\n  <const Resource extends ResourceLinkConfigResource<Resources>>(\n    groups: NonEmptyReadonlyArray<\n      CreateResourceLinkGroupInput<Resources, Resource>\n    >,\n  ): CreateResourceLinksWithGroupsResult<Resources, Resource>;\n}\n\nexport type CreateResourceLinksWithGroupsResult<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends ResourceLinkConfigResource<Resources> = ResourceLinkConfigResource<Resources>,\n> = Array<CreateResourceLinksWithGroups<Resources>> & {\n  /**\n   * Resolves each group's icon and its link icons for the active resource.\n   *\n   * Functional icons receive the resources accessor for `resource`. Read the\n   * groups value directly when you do not need to resolve icons.\n   *\n   * @param resource The active resource key.\n   */\n  (\n    resource: LayoutResourceKey<Resources>,\n  ): ResolvedResourceLinksWithGroupsResult<Resources, Resource>;\n  /**\n   * Creates a resource map for this layout. Same helper as\n   * `createResourceLinks.createResourceMap`.\n   *\n   * @param map Values keyed by this layout's resources. An unknown resource,\n   * or a key that collides with a map helper, is rejected.\n   */\n  createResourceMap: CreateResourceMapFn<Resources>;\n  /**\n   * Returns the group whose links include `resource`.\n   *\n   * The result is `undefined` when that resource was not configured in any\n   * group. A resource outside this layout is rejected by the type.\n   *\n   * @param resource The resource whose group should be returned.\n   */\n  findResource<\n    const RequestedResource extends LayoutResourceKey<Resources> | Resource,\n  >(\n    resource: RequestedResource,\n  ): FindResourceGroupResult<Resources, Resource, RequestedResource>;\n};\n\nexport type ResolvedResourceLinksWithGroupsResult<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends ResourceLinkConfigResource<Resources> = ResourceLinkConfigResource<Resources>,\n> = Array<ResolvedResourceLinksWithGroups<Resources>> & {\n  /** Returns the resolved group whose links include `resource`. */\n  findResource<\n    const RequestedResource extends LayoutResourceKey<Resources> | Resource,\n  >(\n    resource: RequestedResource,\n  ): FindResolvedResourceGroupResult<Resources, Resource, RequestedResource>;\n};\n\nexport type FindResourceGroupResult<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  IncludedResource extends string,\n  RequestedResource extends string,\n> = RequestedResource extends unknown\n  ? RequestedResource extends IncludedResource\n    ? CreateResourceLinksWithGroups<Resources>\n    : undefined\n  : never;\n\nexport type FindResolvedResourceGroupResult<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  IncludedResource extends string,\n  RequestedResource extends string,\n> = RequestedResource extends unknown\n  ? RequestedResource extends IncludedResource\n    ? ResolvedResourceLinksWithGroups<Resources>\n    : undefined\n  : never;\n\nfunction resolveResourceLinkHref<Resource extends string>(\n  value: ResourceLinkHref<Resource> | undefined,\n  resource: Resource,\n  fallback: string,\n) {\n  return typeof value === 'function' ? value(resource) : (value ?? fallback);\n}\n\nfunction normalizeResourceLinkHash(hash: string) {\n  return hash.replace(/^#+/, '');\n}\n\nfunction createFullResourceLinkHref(href: string, hash: string) {\n  if (href.includes('#')) {\n    return href;\n  }\n\n  return `${href}#${normalizeResourceLinkHash(hash)}`;\n}\n\nfunction createResourceLinksFromConfig<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends ResourceLinkConfigResource<Resources>,\n>(config: CreateResourceLinkConfig<Resources, Resource>) {\n  return Object.entries(config).map(([resource, config]) => {\n    if (!config) {\n      throw new LayoutConfigurationError(\n        `[createResourceLinks]: \"config\" is required for the ${resource} resource.`,\n      );\n    }\n\n    if (typeof config !== 'object') {\n      throw new LayoutConfigurationError(\n        `[createResourceLinks]: \"config\" must be an object for the ${resource} resource. Received ${typeof config}`,\n      );\n    }\n\n    if (!('label' in config)) {\n      throw new LayoutConfigurationError(\n        `[createResourceLinks]: \"label\" is required for the ${resource} resource.`,\n      );\n    }\n\n    if (typeof config.label !== 'string') {\n      throw new LayoutConfigurationError(\n        `[createResourceLinks]: \"label\" must be a string for the ${resource} resource. Received ${typeof config.label}`,\n      );\n    }\n\n    const linkConfig = config as CreateResourceLinkOptions<\n      Resources,\n      typeof resource\n    >;\n\n    if (\n      'href' in linkConfig &&\n      linkConfig.href !== undefined &&\n      typeof linkConfig.href !== 'string' &&\n      typeof linkConfig.href !== 'function'\n    ) {\n      throw new LayoutConfigurationError(\n        `[createResourceLinks]: \"href\" must be a string or function for the ${resource} resource. Received ${typeof linkConfig.href}`,\n      );\n    }\n\n    if (\n      'hash' in linkConfig &&\n      linkConfig.hash !== undefined &&\n      typeof linkConfig.hash !== 'string' &&\n      typeof linkConfig.hash !== 'function'\n    ) {\n      throw new LayoutConfigurationError(\n        `[createResourceLinks]: \"hash\" must be a string or function for the ${resource} resource. Received ${typeof linkConfig.hash}`,\n      );\n    }\n\n    const givenHref = resolveResourceLinkHref(linkConfig.href, resource, '/');\n    const givenHash = resolveResourceLinkHref(\n      linkConfig.hash,\n      resource,\n      resource,\n    );\n    const href = {\n      given: givenHref,\n      full: createFullResourceLinkHref(givenHref, givenHash),\n      ...(linkConfig.hash !== undefined && !givenHref.includes('#')\n        ? { hash: normalizeResourceLinkHash(givenHash) }\n        : {}),\n    };\n\n    return {\n      ...(linkConfig.activeIcon !== undefined\n        ? { activeIcon: linkConfig.activeIcon }\n        : {}),\n      href,\n      label: config.label,\n      resource,\n      icon: 'icon' in config ? config.icon : null,\n    };\n  });\n}\n\n/**\n * Deterministic, not random: a random id (the previous implementation used\n * `crypto.randomUUID()` / `Math.random()`) would make `withGroups()` unsafe to\n * call from module scope — some runtimes (e.g. Cloudflare Workers) disallow\n * generating random values outside a request handler, and config arrays like\n * this are routinely defined as top-level constants.\n *\n * Falls back to the group's own shape — its `label` and its link resource\n * keys — rather than just the array index, so groups from *separate*\n * `withGroups()` calls that get concatenated into one list (a module-owned nav\n * section next to a feature-owned one, say) don't collide just because they're\n * both first in their own call. Two groups that are genuinely identical in\n * shape will still collide; pass an explicit `id` on the group to rule that\n * out entirely.\n */\nfunction createResourceLinkGroupId(\n  group: { id?: unknown; label?: unknown; links: object },\n  index: number,\n) {\n  if (typeof group.id === 'string' && group.id.length > 0) {\n    return group.id;\n  }\n\n  const label = typeof group.label === 'string' ? group.label : '';\n  const linkKeys = Object.keys(group.links).join(',');\n  return `group-${index}-${label}-${linkKeys}`;\n}\n\nfunction readResourceValue(resource: ResourceDefinition) {\n  return typeof resource === 'string' ? resource : resource.value;\n}\n\nfunction createResourceSelection(\n  definitions: ReadonlyArray<ResourceDefinition>,\n): ResourceSelection<ReadonlyArray<ResourceDefinition>> {\n  const selection = (() => definitions) as ResourceSelection<\n    ReadonlyArray<ResourceDefinition>\n  >;\n\n  selection.isResource = createIsValidResourceFn(definitions);\n\n  return selection;\n}\n\nfunction createRenderResourcesAccessor<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n>(resources: Resources, current: LayoutResourceKey<Resources>) {\n  const accessor = Object.assign(() => resources, {\n    current,\n  }) as LayoutRenderResourcesAccessor<Resources>;\n\n  accessor.isResource = createIsValidResourceFn(resources);\n  accessor.omit = ((...keys: string[]) =>\n    createResourceSelection(\n      resources.filter((resource) => !keys.includes(readResourceValue(resource))),\n    )) as LayoutRenderResourcesAccessor<Resources>['omit'];\n  accessor.pick = ((...keys: string[]) =>\n    createResourceSelection(\n      resources.filter((resource) => keys.includes(readResourceValue(resource))),\n    )) as LayoutRenderResourcesAccessor<Resources>['pick'];\n\n  return accessor;\n}\n\nfunction createResourceMapFn<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n>(resources: Resources): CreateResourceMapFn<Resources> {\n  const helperNames = new Set(['get', 'isValidResource']);\n  const resourceKeys = new Set(\n    resources.map((resource) =>\n      typeof resource === 'string' ? resource : resource.value,\n    ),\n  );\n\n  return function createResourceMap<\n    const Map extends CreateResourceMap<Resources, unknown>,\n  >(map: Map) {\n    const configuredResources = Object.keys(map);\n\n    for (const resource of configuredResources) {\n      if (!resourceKeys.has(resource)) {\n        throw new LayoutConfigurationError(\n          `[createResourceLinks.createResourceMap]: unknown resource \"${resource}\".`,\n        );\n      }\n\n      if (helperNames.has(resource)) {\n        throw new LayoutConfigurationError(\n          `[createResourceLinks.createResourceMap]: resource \"${resource}\" conflicts with a map helper.`,\n        );\n      }\n    }\n\n    const configuredResourceKeys = new Set(configuredResources);\n    const resourceValues = new Map(\n      configuredResources.map((resource) => [\n        resource,\n        (map as Record<string, unknown>)[resource],\n      ]),\n    );\n\n    Object.defineProperties(map, {\n      get: {\n        value(resource: string) {\n          return resourceValues.get(resource);\n        },\n      },\n      isValidResource: {\n        value(value: unknown): value is Extract<keyof Map, string> {\n          return (\n            typeof value === 'string' && configuredResourceKeys.has(value)\n          );\n        },\n      },\n    });\n\n    return map as CreatedResourceMap<Map>;\n  };\n}\n\nfunction createResourceLinksWithGroups<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends ResourceLinkConfigResource<Resources>,\n>(\n  resources: Resources,\n  createResourceMap: CreateResourceMapFn<Resources>,\n  groups: ReadonlyArray<CreateResourceLinkGroupInput<Resources, Resource>>,\n): CreateResourceLinksWithGroupsResult<Resources, Resource> {\n  if (!Array.isArray(groups)) {\n    throw new LayoutConfigurationError(\n      '[createResourceLinks.withGroups]: \"groups\" must be an array.',\n    );\n  }\n\n  if (groups.length === 0) {\n    throw new LayoutConfigurationError(\n      '[createResourceLinks.withGroups]: \"groups\" must include at least one group.',\n    );\n  }\n\n  const createdGroups = groups.map((group, index) => {\n    if (!group) {\n      throw new LayoutConfigurationError(\n        `[createResourceLinks.withGroups]: group at index ${index} is required.`,\n      );\n    }\n\n    if (typeof group !== 'object') {\n      throw new LayoutConfigurationError(\n        `[createResourceLinks.withGroups]: group at index ${index} must be an object. Received ${typeof group}`,\n      );\n    }\n\n    if (\n      'label' in group &&\n      group.label !== undefined &&\n      typeof group.label !== 'string'\n    ) {\n      throw new LayoutConfigurationError(\n        `[createResourceLinks.withGroups]: \"label\" must be a string for group at index ${index}. Received ${typeof group.label}`,\n      );\n    }\n\n    if ('id' in group && group.id !== undefined && typeof group.id !== 'string') {\n      throw new LayoutConfigurationError(\n        `[createResourceLinks.withGroups]: \"id\" must be a string for group at index ${index}. Received ${typeof group.id}`,\n      );\n    }\n\n    if (!('links' in group)) {\n      throw new LayoutConfigurationError(\n        `[createResourceLinks.withGroups]: \"links\" is required for group at index ${index}.`,\n      );\n    }\n\n    if (\n      typeof group.links !== 'object' ||\n      group.links === null ||\n      Array.isArray(group.links)\n    ) {\n      throw new LayoutConfigurationError(\n        `[createResourceLinks.withGroups]: \"links\" must be an object for group at index ${index}. Received ${Array.isArray(group.links) ? 'array' : typeof group.links}`,\n      );\n    }\n\n    return {\n      ...(group.activeIcon !== undefined\n        ? { activeIcon: group.activeIcon }\n        : {}),\n      id: createResourceLinkGroupId(group, index),\n      label: 'label' in group ? (group.label ?? null) : null,\n      icon: 'icon' in group ? group.icon : null,\n      links: createResourceLinksFromConfig(group.links),\n    };\n  }) as Array<CreateResourceLinksWithGroups<Resources>>;\n\n  function resolveGroups(resource?: LayoutResourceKey<Resources>) {\n    if (resource === undefined) {\n      throw new LayoutConfigurationError(\n        '[createResourceLinks.withGroups]: \"resource\" is required.',\n      );\n    }\n\n    const currentResources = createRenderResourcesAccessor(resources, resource);\n\n    const resolvedGroups = createdGroups.map((group) => ({\n      ...group,\n      icon:\n        typeof group.icon === 'function'\n          ? group.icon(currentResources)\n          : group.icon,\n      links: group.links.map((link) => ({\n        ...link,\n        icon:\n          typeof link.icon === 'function'\n            ? link.icon(currentResources)\n            : link.icon,\n      })),\n    }));\n\n    Object.defineProperty(resolvedGroups, 'findResource', {\n      value(requestedResource: ResourceLinkConfigResource<Resources>) {\n        return resolvedGroups.find((group) =>\n          group.links.some((link) => link.resource === requestedResource),\n        );\n      },\n    });\n\n    return resolvedGroups as ResolvedResourceLinksWithGroupsResult<\n      Resources,\n      Resource\n    >;\n  }\n\n  const callableGroups = new Proxy(resolveGroups, {\n    get(target, property, receiver) {\n      if (property === 'createResourceMap') {\n        return createResourceMap;\n      }\n\n      if (property === Symbol.iterator) {\n        return createdGroups[Symbol.iterator].bind(createdGroups);\n      }\n\n      if (property === 'toJSON') {\n        return () => createdGroups;\n      }\n\n      if (property in createdGroups) {\n        const value = Reflect.get(createdGroups, property);\n        return typeof value === 'function' ? value.bind(createdGroups) : value;\n      }\n\n      return Reflect.get(target, property, receiver);\n    },\n    getOwnPropertyDescriptor(target, property) {\n      return (\n        Reflect.getOwnPropertyDescriptor(createdGroups, property) ??\n        Reflect.getOwnPropertyDescriptor(target, property)\n      );\n    },\n    getPrototypeOf() {\n      return Array.prototype;\n    },\n    ownKeys(target) {\n      return [\n        ...new Set([\n          ...Reflect.ownKeys(target),\n          ...Reflect.ownKeys(createdGroups),\n        ]),\n      ];\n    },\n    set(target, property, value, receiver) {\n      if (property in createdGroups || /^\\d+$/.test(String(property))) {\n        return Reflect.set(createdGroups, property, value);\n      }\n\n      return Reflect.set(target, property, value, receiver);\n    },\n  });\n  Object.defineProperty(createdGroups, 'findResource', {\n    value(resource: ResourceLinkConfigResource<Resources>) {\n      return createdGroups.find((group) =>\n        group.links.some((link) => link.resource === resource),\n      );\n    },\n  });\n\n  return callableGroups as CreateResourceLinksWithGroupsResult<\n    Resources,\n    Resource\n  >;\n}\n\nfunction createDefineIcon<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n>(): DefineResourceIconFn<Resources> {\n  function defineIcon<Icon extends ElementType = ElementType>(\n    render: (options: {\n      resource: LayoutRenderResourcesAccessor<Resources>;\n      Icon: Icon;\n    }) => ReactNode,\n  ) {\n    return function createIcon(Icon: Icon) {\n      return function renderIcon(\n        resource: LayoutRenderResourcesAccessor<Resources>,\n      ) {\n        return render({ resource, Icon });\n      };\n    };\n  }\n\n  defineIcon.input = function defineIconInput<Definition>(\n    defineInput: (\n      helpers: DefineResourceIconInputHelpers<Resources>,\n    ) => Definition,\n  ): DefineResourceIconInputResult<Resources, Definition> {\n    const resourceMarker = {} as ResourceIconInputMarker<never>;\n    const componentMarker = {} as ResourceIconComponentInputMarker<ElementType>;\n\n    defineInput({\n      resource() {\n        return resourceMarker;\n      },\n      icon<Icon extends ElementType = ElementType>() {\n        return componentMarker as ResourceIconComponentInputMarker<Icon>;\n      },\n    });\n\n    return {\n      render(\n        render: (options: {\n          resource: LayoutRenderResourcesAccessor<Resources>;\n          input: ResolveResourceIconInput<Definition>;\n        }) => ReactNode,\n      ) {\n        return function createIcon(\n          input: ResolveResourceIconInput<Definition>,\n        ) {\n          return function renderIcon(\n            resource: LayoutRenderResourcesAccessor<Resources>,\n          ) {\n            return render({ resource, input });\n          };\n        };\n      },\n    };\n  };\n\n  return defineIcon;\n}\n\nexport function createResourceLinksFn<\n  const Resources extends ReadonlyArray<ResourceDefinition>,\n>(_resources: Resources): CreateResourceLinksFn<Resources> {\n  const createResourceMap = createResourceMapFn(_resources);\n  const defineIcon = createDefineIcon<Resources>();\n\n  function createResourceLinks<\n    const Resource extends ResourceLinkConfigResource<Resources>,\n  >(config: CreateResourceLinkConfig<Resources, Resource>) {\n    return createResourceLinksFromConfig(config);\n  }\n\n  function withGroups<\n    const Resource extends ResourceLinkConfigResource<Resources>,\n  >(\n    groups: NonEmptyReadonlyArray<\n      CreateResourceLinkGroupInput<Resources, Resource>\n    >,\n  ) {\n    return createResourceLinksWithGroups(_resources, createResourceMap, groups);\n  }\n\n  return Object.assign(createResourceLinks, {\n    createResourceMap,\n    defineIcon,\n    withGroups,\n  }) as CreateResourceLinksFn<Resources>;\n}\n"],"mappings":"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"}
+{"version":3,"file":"create-resource-links.mjs","names":[],"sources":["../../src/create-config/create-resource-links.ts"],"sourcesContent":["import type { ElementType, ReactNode } from 'react';\nimport type { NonEmptyReadonlyArray } from '@jfdevelops/react-layout-validator';\nimport {\n  createIsValidResourceFn,\n  type LayoutResourceKey,\n  type ResourceDefinition,\n} from '../resource';\nimport { LayoutConfigurationError } from '../errors';\nimport type {\n  LayoutRenderResourcesAccessor,\n  ResourceSelection,\n} from './define-layout';\n\nexport type ResourceAnchorLinkFn<Resource extends string> = (\n  resource: Resource,\n) => string;\n\nexport type ResourceLinkHref<Resource extends string> =\n  | string\n  | ResourceAnchorLinkFn<Resource>;\n\nexport type ResourceLinkConfigResource<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = LayoutResourceKey<Resources> | (string & {});\n\nexport type ResourceIconFn<Resource = any> = (resource: Resource) => ReactNode;\n\nexport type ResourceIcon<Resource = any> = ReactNode | ResourceIconFn<Resource>;\n\ndeclare const resourceIconInputMarker: unique symbol;\ndeclare const resourceIconComponentInputMarker: unique symbol;\n\ntype ResourceIconInputMarker<Value> = {\n  readonly [resourceIconInputMarker]: Value;\n};\n\ntype ResourceIconComponentInputMarker<Icon extends ElementType> = {\n  readonly [resourceIconComponentInputMarker]: Icon;\n};\n\nexport type ResolveResourceIconInput<Definition> =\n  Definition extends ResourceIconComponentInputMarker<infer Icon>\n    ? Icon\n    : Definition extends ResourceIconInputMarker<infer Value>\n      ? Value\n      : Definition extends ReadonlyArray<unknown>\n        ? { [Index in keyof Definition]: ResolveResourceIconInput<Definition[Index]> }\n        : Definition extends object\n          ? { [Key in keyof Definition]: ResolveResourceIconInput<Definition[Key]> }\n          : Definition;\n\nexport interface DefineResourceIconInputHelpers<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> {\n  resource(): ResourceIconInputMarker<LayoutResourceKey<Resources>>;\n  icon<Icon extends ElementType = ElementType>(): ResourceIconComponentInputMarker<Icon>;\n}\n\nexport interface DefineResourceIconInputResult<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Definition,\n> {\n  render(\n    render: (options: {\n      resource: LayoutRenderResourcesAccessor<Resources>;\n      input: ResolveResourceIconInput<Definition>;\n    }) => ReactNode,\n  ): (\n    input: ResolveResourceIconInput<Definition>,\n  ) => ResourceIconFn<LayoutRenderResourcesAccessor<Resources>>;\n}\n\nexport interface DefineResourceIconFn<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> {\n  <Icon extends ElementType = ElementType>(\n    render: (options: {\n      resource: LayoutRenderResourcesAccessor<Resources>;\n      Icon: Icon;\n    }) => ReactNode,\n  ): (Icon: Icon) => ResourceIconFn<LayoutRenderResourcesAccessor<Resources>>;\n  input<Definition>(\n    defineInput: (\n      helpers: DefineResourceIconInputHelpers<Resources>,\n    ) => Definition,\n  ): DefineResourceIconInputResult<Resources, Definition>;\n}\nexport interface CreateResourceLinkOptions<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends ResourceLinkConfigResource<Resources>,\n  Icon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>,\n> {\n  /**\n   * The label of the link. This is the text that will be displayed in the link.\n   */\n  label: string;\n  /**\n   * An optional icon to render when the link is active.\n   */\n  activeIcon?: ReactNode;\n  /**\n   * An optional icon to register with the link. This is a headless approach, meaning you have full control\n   * over the icon's rendering.\n   */\n  icon?: Icon;\n  /**\n   * The href of the link. By default, the href will be `\"/\"`. While you **don't** need to include a hash,\n   * if you do, it will override the `hash` property (if provided).\n   */\n  href?: ResourceLinkHref<Resource>;\n  /**\n   * The hash of the link. By default, the hash will be the resource name. If you need to customize it, you can provide\n   * a string or a function that returns a string.\n   *\n   * @remarks A `\"#\"` is not required. The generated href will include it automatically.\n   */\n  hash?: ResourceLinkHref<Resource>;\n}\n\nexport type CreateResourceLinkConfig<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends ResourceLinkConfigResource<Resources> = ResourceLinkConfigResource<Resources>,\n  Icon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>,\n> = {\n  [Key in Resource]?: CreateResourceLinkOptions<\n    Resources,\n    Key,\n    Icon\n  >;\n};\n\nexport type InferHashFromResourceLinkHref<\n  Resource extends string,\n  Hash extends ResourceLinkHref<Resource>,\n> = Hash extends string\n  ? Hash\n  : Hash extends ResourceAnchorLinkFn<Resource>\n    ? ReturnType<Hash>\n    : never;\n\nexport type CreatedResourceHref = {\n  /**\n   * The full generated href with the `hash` if provided.\n   */\n  full: string;\n  /**\n   * The given href. This is the same value as the `href` property of the config.\n   */\n  given: string;\n};\n\nexport type CreatedResourceLinkBase<\n  Resource extends string,\n  Icon = ResourceIcon,\n> = {\n  activeIcon?: ReactNode;\n  href: CreatedResourceHref;\n  label: string;\n  resource: Resource;\n  icon: Icon | null;\n};\nexport type CreateResourceLinkWithHash<\n  Resource extends string,\n  Hash extends ResourceLinkHref<Resource>,\n  Icon = ResourceIcon,\n> = Omit<CreatedResourceLinkBase<Resource, Icon>, 'href'> & {\n  href: CreatedResourceHref & {\n    hash: InferHashFromResourceLinkHref<Resource, Hash>;\n  };\n};\n\nexport type CreatedResourceLink<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Config,\n  Icon = ResourceIcon,\n> = {\n  [Resource in keyof Config]-?: Resource extends ResourceLinkConfigResource<Resources>\n    ? Config[Resource] extends {\n        hash: infer hash extends ResourceLinkHref<Resource>;\n      }\n      ? CreateResourceLinkWithHash<Resource, hash, Icon>\n      : CreatedResourceLinkBase<Resource, Icon>\n    : never;\n}[keyof Config];\n\ntype ResourceLinkConfigIcon<Config> = {\n  [Resource in keyof Config]-?: 'icon' extends keyof NonNullable<\n    Config[Resource]\n  >\n    ? NonNullable<Config[Resource]> extends { icon?: infer Icon }\n      ? Icon\n      : never\n    : never;\n}[keyof Config];\n\nexport interface CreateResourceLinksFn<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> {\n  <\n    const Resource extends ResourceLinkConfigResource<Resources>,\n    const Config extends object,\n  >(\n    config: CreateResourceLinkConfig<Resources, Resource> & Config,\n  ): Array<\n    CreatedResourceLink<\n      Resources,\n      Config,\n      ResourceLinkConfigIcon<Config>\n    >\n  >;\n  createResourceMap: CreateResourceMapFn<Resources>;\n  defineIcon: DefineResourceIconFn<Resources>;\n  withGroups: CreateResourceLinksWithGroupsFn<Resources>;\n}\n\nexport interface CreateResourceLinkGroupOptions<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Links extends object =\n    CreateResourceLinkConfig<Resources>,\n  Icon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>,\n> {\n  /**\n   * An optional, caller-provided identity for the group. Provide this when you\n   * combine groups from more than one `withGroups()` call into one list (e.g.\n   * a module-owned nav section alongside a feature-owned one) — without it,\n   * the id is derived from the group's `label` and its link resources, which\n   * is enough to keep groups from a single call apart but can't distinguish\n   * two independently-defined groups that happen to look identical.\n   */\n  id?: string;\n  /**\n   * The label of the group. This is the text that will be displayed for the group.\n   */\n  label?: string;\n  /**\n   * An optional icon to render when the group is active.\n   */\n  activeIcon?: ReactNode;\n  /**\n   * An optional icon to register with the group. This is a headless approach, meaning you have full control\n   * over the icon's rendering.\n   */\n  icon?: Icon;\n  /**\n   * The resource links in this group.\n   */\n  links: Links;\n}\n\nexport type CreateResourceLinkGroupInput<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends ResourceLinkConfigResource<Resources> = ResourceLinkConfigResource<Resources>,\n  Icon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>,\n> = CreateResourceLinkGroupOptions<\n  Resources,\n  CreateResourceLinkConfig<Resources, Resource, Icon>,\n  Icon\n>;\n\ntype ResourceLinkGroupResource<Groups extends ReadonlyArray<unknown>> =\n  Groups[number] extends infer Group\n    ? Group extends { links: infer Links }\n      ? Extract<keyof Links, string>\n      : never\n    : never;\n\ntype ResourceLinkGroupIcon<Groups extends ReadonlyArray<unknown>> =\n  Groups[number] extends infer Group\n    ? 'icon' extends keyof Group\n      ? Group extends { icon?: infer Icon }\n        ? Icon\n        : never\n      : never\n    : never;\n\ntype ResourceLinkGroupLinkIcon<Groups extends ReadonlyArray<unknown>> =\n  Groups[number] extends infer Group\n    ? Group extends { links: infer Links }\n      ? ResourceLinkConfigIcon<Links>\n      : never\n    : never;\n\nexport type AnyCreatedResourceLink<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Icon = ResourceIcon,\n> = {\n  [Resource in LayoutResourceKey<Resources>]:\n    | CreatedResourceLinkBase<Resource, Icon>\n    | CreateResourceLinkWithHash<Resource, string, Icon>;\n}[LayoutResourceKey<Resources>];\n\nexport type CreateResourceLinksWithGroups<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  GroupIcon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>,\n  LinkIcon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>,\n> = {\n  activeIcon?: ReactNode;\n  id: string;\n  label: string | null;\n  icon: GroupIcon | null;\n  links: Array<AnyCreatedResourceLink<Resources, LinkIcon>>;\n};\n\ntype ResolveResourceIcon<Icon> = Icon extends (...args: any[]) => infer Result\n  ? Result\n  : Icon;\n\nexport type ResolvedResourceLinksWithGroups<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  GroupIcon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>,\n  LinkIcon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>,\n> = Omit<\n  CreateResourceLinksWithGroups<Resources, GroupIcon, LinkIcon>,\n  'icon' | 'links'\n> & {\n  icon: ResolveResourceIcon<GroupIcon> | null;\n  links: Array<\n    Omit<AnyCreatedResourceLink<Resources, LinkIcon>, 'icon'> & {\n      icon: ResolveResourceIcon<LinkIcon> | null;\n    }\n  >;\n};\n\nexport type CreateResourceMap<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Value,\n> = Partial<Record<LayoutResourceKey<Resources>, Value>>;\n\nexport type ValidateResource<\n  Resource extends string,\n  Map extends object,\n> = Resource extends Extract<keyof Map, string> ? Resource : never;\n\nexport type CreatedResourceMap<Map extends object> = Map & {\n  isValidResource(value: unknown): value is Extract<keyof Map, string>;\n  get<const Resource extends string>(\n    resource: ValidateResource<Resource, Map>,\n  ): Map[typeof resource];\n};\n\nexport interface CreateResourceMapFn<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> {\n  /**\n   * Creates a resource map for this layout.\n   *\n   * @param map Values keyed by this layout's resources. An unknown resource,\n   * or a key that collides with a map helper, is rejected.\n   */\n  <const Map extends CreateResourceMap<Resources, unknown>>(\n    map: Map,\n  ): CreatedResourceMap<Map>;\n}\n\nexport interface CreateResourceLinksWithGroupsFn<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> {\n  /**\n   * Groups resource links into sections.\n   *\n   * @param groups The sections to create. At least one is required. The link\n   * keys in those sections are the resources `findResource` can resolve.\n   */\n  <\n    const Resource extends ResourceLinkConfigResource<Resources>,\n    const Groups extends ReadonlyArray<unknown>,\n  >(\n    groups: NonEmptyReadonlyArray<\n      CreateResourceLinkGroupInput<Resources, Resource>\n    > &\n      Groups,\n  ): CreateResourceLinksWithGroupsResult<\n    Resources,\n    ResourceLinkGroupResource<Groups>,\n    ResourceLinkGroupIcon<Groups>,\n    ResourceLinkGroupLinkIcon<Groups>\n  >;\n}\n\nexport type CreateResourceLinksWithGroupsResult<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends ResourceLinkConfigResource<Resources> = ResourceLinkConfigResource<Resources>,\n  GroupIcon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>,\n  LinkIcon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>,\n> = Array<CreateResourceLinksWithGroups<Resources, GroupIcon, LinkIcon>> & {\n  /**\n   * Resolves each group's icon and its link icons for the active resource.\n   *\n   * Functional icons receive the resources accessor for `resource`. Read the\n   * groups value directly when you do not need to resolve icons.\n   *\n   * @param resource The active resource key.\n   */\n  (\n    resource: LayoutResourceKey<Resources>,\n  ): ResolvedResourceLinksWithGroupsResult<\n    Resources,\n    Resource,\n    GroupIcon,\n    LinkIcon\n  >;\n  /**\n   * Creates a resource map for this layout. Same helper as\n   * `createResourceLinks.createResourceMap`.\n   *\n   * @param map Values keyed by this layout's resources. An unknown resource,\n   * or a key that collides with a map helper, is rejected.\n   */\n  createResourceMap: CreateResourceMapFn<Resources>;\n  /**\n   * Returns the group whose links include `resource`.\n   *\n   * The result is `undefined` when that resource was not configured in any\n   * group. A resource outside this layout is rejected by the type.\n   *\n   * @param resource The resource whose group should be returned.\n   */\n  findResource<\n    const RequestedResource extends LayoutResourceKey<Resources> | Resource,\n  >(\n    resource: RequestedResource,\n  ): FindResourceGroupResult<\n    Resources,\n    Resource,\n    RequestedResource,\n    GroupIcon,\n    LinkIcon\n  >;\n};\n\nexport type ResolvedResourceLinksWithGroupsResult<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends ResourceLinkConfigResource<Resources> = ResourceLinkConfigResource<Resources>,\n  GroupIcon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>,\n  LinkIcon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>,\n> = Array<\n  ResolvedResourceLinksWithGroups<Resources, GroupIcon, LinkIcon>\n> & {\n  /** Returns the resolved group whose links include `resource`. */\n  findResource<\n    const RequestedResource extends LayoutResourceKey<Resources> | Resource,\n  >(\n    resource: RequestedResource,\n  ): FindResolvedResourceGroupResult<\n    Resources,\n    Resource,\n    RequestedResource,\n    GroupIcon,\n    LinkIcon\n  >;\n};\n\nexport type FindResourceGroupResult<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  IncludedResource extends string,\n  RequestedResource extends string,\n  GroupIcon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>,\n  LinkIcon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>,\n> = RequestedResource extends unknown\n  ? RequestedResource extends IncludedResource\n    ? CreateResourceLinksWithGroups<Resources, GroupIcon, LinkIcon>\n    : undefined\n  : never;\n\nexport type FindResolvedResourceGroupResult<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  IncludedResource extends string,\n  RequestedResource extends string,\n  GroupIcon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>,\n  LinkIcon = ResourceIcon<LayoutRenderResourcesAccessor<Resources>>,\n> = RequestedResource extends unknown\n  ? RequestedResource extends IncludedResource\n    ? ResolvedResourceLinksWithGroups<Resources, GroupIcon, LinkIcon>\n    : undefined\n  : never;\n\nfunction resolveResourceLinkHref<Resource extends string>(\n  value: ResourceLinkHref<Resource> | undefined,\n  resource: Resource,\n  fallback: string,\n) {\n  return typeof value === 'function' ? value(resource) : (value ?? fallback);\n}\n\nfunction normalizeResourceLinkHash(hash: string) {\n  return hash.replace(/^#+/, '');\n}\n\nfunction createFullResourceLinkHref(href: string, hash: string) {\n  if (href.includes('#')) {\n    return href;\n  }\n\n  return `${href}#${normalizeResourceLinkHash(hash)}`;\n}\n\nfunction createResourceLinksFromConfig<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends ResourceLinkConfigResource<Resources>,\n>(config: CreateResourceLinkConfig<Resources, Resource>) {\n  return Object.entries(config).map(([resource, config]) => {\n    if (!config) {\n      throw new LayoutConfigurationError(\n        `[createResourceLinks]: \"config\" is required for the ${resource} resource.`,\n      );\n    }\n\n    if (typeof config !== 'object') {\n      throw new LayoutConfigurationError(\n        `[createResourceLinks]: \"config\" must be an object for the ${resource} resource. Received ${typeof config}`,\n      );\n    }\n\n    if (!('label' in config)) {\n      throw new LayoutConfigurationError(\n        `[createResourceLinks]: \"label\" is required for the ${resource} resource.`,\n      );\n    }\n\n    if (typeof config.label !== 'string') {\n      throw new LayoutConfigurationError(\n        `[createResourceLinks]: \"label\" must be a string for the ${resource} resource. Received ${typeof config.label}`,\n      );\n    }\n\n    const linkConfig = config as CreateResourceLinkOptions<\n      Resources,\n      typeof resource,\n      ResourceIcon<LayoutRenderResourcesAccessor<Resources>>\n    >;\n\n    if (\n      'href' in linkConfig &&\n      linkConfig.href !== undefined &&\n      typeof linkConfig.href !== 'string' &&\n      typeof linkConfig.href !== 'function'\n    ) {\n      throw new LayoutConfigurationError(\n        `[createResourceLinks]: \"href\" must be a string or function for the ${resource} resource. Received ${typeof linkConfig.href}`,\n      );\n    }\n\n    if (\n      'hash' in linkConfig &&\n      linkConfig.hash !== undefined &&\n      typeof linkConfig.hash !== 'string' &&\n      typeof linkConfig.hash !== 'function'\n    ) {\n      throw new LayoutConfigurationError(\n        `[createResourceLinks]: \"hash\" must be a string or function for the ${resource} resource. Received ${typeof linkConfig.hash}`,\n      );\n    }\n\n    const givenHref = resolveResourceLinkHref(linkConfig.href, resource, '/');\n    const givenHash = resolveResourceLinkHref(\n      linkConfig.hash,\n      resource,\n      resource,\n    );\n    const href = {\n      given: givenHref,\n      full: createFullResourceLinkHref(givenHref, givenHash),\n      ...(linkConfig.hash !== undefined && !givenHref.includes('#')\n        ? { hash: normalizeResourceLinkHash(givenHash) }\n        : {}),\n    };\n\n    return {\n      ...(linkConfig.activeIcon !== undefined\n        ? { activeIcon: linkConfig.activeIcon }\n        : {}),\n      href,\n      label: config.label,\n      resource,\n      icon: 'icon' in config ? config.icon : null,\n    };\n  });\n}\n\n/**\n * Deterministic, not random: a random id (the previous implementation used\n * `crypto.randomUUID()` / `Math.random()`) would make `withGroups()` unsafe to\n * call from module scope — some runtimes (e.g. Cloudflare Workers) disallow\n * generating random values outside a request handler, and config arrays like\n * this are routinely defined as top-level constants.\n *\n * Falls back to the group's own shape — its `label` and its link resource\n * keys — rather than just the array index, so groups from *separate*\n * `withGroups()` calls that get concatenated into one list (a module-owned nav\n * section next to a feature-owned one, say) don't collide just because they're\n * both first in their own call. Two groups that are genuinely identical in\n * shape will still collide; pass an explicit `id` on the group to rule that\n * out entirely.\n */\nfunction createResourceLinkGroupId(\n  group: { id?: unknown; label?: unknown; links: object },\n  index: number,\n) {\n  if (typeof group.id === 'string' && group.id.length > 0) {\n    return group.id;\n  }\n\n  const label = typeof group.label === 'string' ? group.label : '';\n  const linkKeys = Object.keys(group.links).join(',');\n  return `group-${index}-${label}-${linkKeys}`;\n}\n\nfunction readResourceValue(resource: ResourceDefinition) {\n  return typeof resource === 'string' ? resource : resource.value;\n}\n\nfunction createResourceSelection(\n  definitions: ReadonlyArray<ResourceDefinition>,\n): ResourceSelection<ReadonlyArray<ResourceDefinition>> {\n  const selection = (() => definitions) as ResourceSelection<\n    ReadonlyArray<ResourceDefinition>\n  >;\n\n  selection.isResource = createIsValidResourceFn(definitions);\n\n  return selection;\n}\n\nfunction createRenderResourcesAccessor<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n>(resources: Resources, current: LayoutResourceKey<Resources>) {\n  const accessor = Object.assign(() => resources, {\n    current,\n  }) as LayoutRenderResourcesAccessor<Resources>;\n\n  accessor.isResource = createIsValidResourceFn(resources);\n  accessor.omit = ((...keys: string[]) =>\n    createResourceSelection(\n      resources.filter((resource) => !keys.includes(readResourceValue(resource))),\n    )) as LayoutRenderResourcesAccessor<Resources>['omit'];\n  accessor.pick = ((...keys: string[]) =>\n    createResourceSelection(\n      resources.filter((resource) => keys.includes(readResourceValue(resource))),\n    )) as LayoutRenderResourcesAccessor<Resources>['pick'];\n\n  return accessor;\n}\n\nfunction createResourceMapFn<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n>(resources: Resources): CreateResourceMapFn<Resources> {\n  const helperNames = new Set(['get', 'isValidResource']);\n  const resourceKeys = new Set(\n    resources.map((resource) =>\n      typeof resource === 'string' ? resource : resource.value,\n    ),\n  );\n\n  return function createResourceMap<\n    const Map extends CreateResourceMap<Resources, unknown>,\n  >(map: Map) {\n    const configuredResources = Object.keys(map);\n\n    for (const resource of configuredResources) {\n      if (!resourceKeys.has(resource)) {\n        throw new LayoutConfigurationError(\n          `[createResourceLinks.createResourceMap]: unknown resource \"${resource}\".`,\n        );\n      }\n\n      if (helperNames.has(resource)) {\n        throw new LayoutConfigurationError(\n          `[createResourceLinks.createResourceMap]: resource \"${resource}\" conflicts with a map helper.`,\n        );\n      }\n    }\n\n    const configuredResourceKeys = new Set(configuredResources);\n    const resourceValues = new Map(\n      configuredResources.map((resource) => [\n        resource,\n        (map as Record<string, unknown>)[resource],\n      ]),\n    );\n\n    Object.defineProperties(map, {\n      get: {\n        value(resource: string) {\n          return resourceValues.get(resource);\n        },\n      },\n      isValidResource: {\n        value(value: unknown): value is Extract<keyof Map, string> {\n          return (\n            typeof value === 'string' && configuredResourceKeys.has(value)\n          );\n        },\n      },\n    });\n\n    return map as CreatedResourceMap<Map>;\n  };\n}\n\nfunction createResourceLinksWithGroups<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends ResourceLinkConfigResource<Resources>,\n  const Groups extends ReadonlyArray<unknown>,\n>(\n  resources: Resources,\n  createResourceMap: CreateResourceMapFn<Resources>,\n  groups: ReadonlyArray<CreateResourceLinkGroupInput<Resources, Resource>> &\n    Groups,\n): CreateResourceLinksWithGroupsResult<\n  Resources,\n  ResourceLinkGroupResource<Groups>,\n  ResourceLinkGroupIcon<Groups>,\n  ResourceLinkGroupLinkIcon<Groups>\n> {\n  if (!Array.isArray(groups)) {\n    throw new LayoutConfigurationError(\n      '[createResourceLinks.withGroups]: \"groups\" must be an array.',\n    );\n  }\n\n  if (groups.length === 0) {\n    throw new LayoutConfigurationError(\n      '[createResourceLinks.withGroups]: \"groups\" must include at least one group.',\n    );\n  }\n\n  const createdGroups = groups.map((group, index) => {\n    if (!group) {\n      throw new LayoutConfigurationError(\n        `[createResourceLinks.withGroups]: group at index ${index} is required.`,\n      );\n    }\n\n    if (typeof group !== 'object') {\n      throw new LayoutConfigurationError(\n        `[createResourceLinks.withGroups]: group at index ${index} must be an object. Received ${typeof group}`,\n      );\n    }\n\n    if (\n      'label' in group &&\n      group.label !== undefined &&\n      typeof group.label !== 'string'\n    ) {\n      throw new LayoutConfigurationError(\n        `[createResourceLinks.withGroups]: \"label\" must be a string for group at index ${index}. Received ${typeof group.label}`,\n      );\n    }\n\n    if ('id' in group && group.id !== undefined && typeof group.id !== 'string') {\n      throw new LayoutConfigurationError(\n        `[createResourceLinks.withGroups]: \"id\" must be a string for group at index ${index}. Received ${typeof group.id}`,\n      );\n    }\n\n    if (!('links' in group)) {\n      throw new LayoutConfigurationError(\n        `[createResourceLinks.withGroups]: \"links\" is required for group at index ${index}.`,\n      );\n    }\n\n    if (\n      typeof group.links !== 'object' ||\n      group.links === null ||\n      Array.isArray(group.links)\n    ) {\n      throw new LayoutConfigurationError(\n        `[createResourceLinks.withGroups]: \"links\" must be an object for group at index ${index}. Received ${Array.isArray(group.links) ? 'array' : typeof group.links}`,\n      );\n    }\n\n    return {\n      ...(group.activeIcon !== undefined\n        ? { activeIcon: group.activeIcon }\n        : {}),\n      id: createResourceLinkGroupId(group, index),\n      label: 'label' in group ? (group.label ?? null) : null,\n      icon: 'icon' in group ? group.icon : null,\n      links: createResourceLinksFromConfig(group.links),\n    };\n  }) as Array<CreateResourceLinksWithGroups<Resources>>;\n\n  function resolveGroups(resource?: LayoutResourceKey<Resources>) {\n    if (resource === undefined) {\n      throw new LayoutConfigurationError(\n        '[createResourceLinks.withGroups]: \"resource\" is required.',\n      );\n    }\n\n    const currentResources = createRenderResourcesAccessor(resources, resource);\n\n    const resolvedGroups = createdGroups.map((group) => ({\n      ...group,\n      icon:\n        typeof group.icon === 'function'\n          ? group.icon(currentResources)\n          : group.icon,\n      links: group.links.map((link) => ({\n        ...link,\n        icon:\n          typeof link.icon === 'function'\n            ? link.icon(currentResources)\n            : link.icon,\n      })),\n    }));\n\n    Object.defineProperty(resolvedGroups, 'findResource', {\n      value(requestedResource: ResourceLinkConfigResource<Resources>) {\n        return resolvedGroups.find((group) =>\n          group.links.some((link) => link.resource === requestedResource),\n        );\n      },\n    });\n\n    return resolvedGroups as ResolvedResourceLinksWithGroupsResult<\n      Resources,\n      ResourceLinkGroupResource<Groups>,\n      ResourceLinkGroupIcon<Groups>,\n      ResourceLinkGroupLinkIcon<Groups>\n    >;\n  }\n\n  const callableGroups = new Proxy(resolveGroups, {\n    get(target, property, receiver) {\n      if (property === 'createResourceMap') {\n        return createResourceMap;\n      }\n\n      if (property === Symbol.iterator) {\n        return createdGroups[Symbol.iterator].bind(createdGroups);\n      }\n\n      if (property === 'toJSON') {\n        return () => createdGroups;\n      }\n\n      if (property in createdGroups) {\n        const value = Reflect.get(createdGroups, property);\n        return typeof value === 'function' ? value.bind(createdGroups) : value;\n      }\n\n      return Reflect.get(target, property, receiver);\n    },\n    getOwnPropertyDescriptor(target, property) {\n      return (\n        Reflect.getOwnPropertyDescriptor(createdGroups, property) ??\n        Reflect.getOwnPropertyDescriptor(target, property)\n      );\n    },\n    getPrototypeOf() {\n      return Array.prototype;\n    },\n    ownKeys(target) {\n      return [\n        ...new Set([\n          ...Reflect.ownKeys(target),\n          ...Reflect.ownKeys(createdGroups),\n        ]),\n      ];\n    },\n    set(target, property, value, receiver) {\n      if (property in createdGroups || /^\\d+$/.test(String(property))) {\n        return Reflect.set(createdGroups, property, value);\n      }\n\n      return Reflect.set(target, property, value, receiver);\n    },\n  });\n  Object.defineProperty(createdGroups, 'findResource', {\n    value(resource: ResourceLinkConfigResource<Resources>) {\n      return createdGroups.find((group) =>\n        group.links.some((link) => link.resource === resource),\n      );\n    },\n  });\n\n  return callableGroups as CreateResourceLinksWithGroupsResult<\n    Resources,\n    ResourceLinkGroupResource<Groups>,\n    ResourceLinkGroupIcon<Groups>,\n    ResourceLinkGroupLinkIcon<Groups>\n  >;\n}\n\nfunction createDefineIcon<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n>(): DefineResourceIconFn<Resources> {\n  function defineIcon<Icon extends ElementType = ElementType>(\n    render: (options: {\n      resource: LayoutRenderResourcesAccessor<Resources>;\n      Icon: Icon;\n    }) => ReactNode,\n  ) {\n    return function createIcon(Icon: Icon) {\n      return function renderIcon(\n        resource: LayoutRenderResourcesAccessor<Resources>,\n      ) {\n        return render({ resource, Icon });\n      };\n    };\n  }\n\n  defineIcon.input = function defineIconInput<Definition>(\n    defineInput: (\n      helpers: DefineResourceIconInputHelpers<Resources>,\n    ) => Definition,\n  ): DefineResourceIconInputResult<Resources, Definition> {\n    const resourceMarker = {} as ResourceIconInputMarker<never>;\n    const componentMarker = {} as ResourceIconComponentInputMarker<ElementType>;\n\n    defineInput({\n      resource() {\n        return resourceMarker;\n      },\n      icon<Icon extends ElementType = ElementType>() {\n        return componentMarker as ResourceIconComponentInputMarker<Icon>;\n      },\n    });\n\n    return {\n      render(\n        render: (options: {\n          resource: LayoutRenderResourcesAccessor<Resources>;\n          input: ResolveResourceIconInput<Definition>;\n        }) => ReactNode,\n      ) {\n        return function createIcon(\n          input: ResolveResourceIconInput<Definition>,\n        ) {\n          return function renderIcon(\n            resource: LayoutRenderResourcesAccessor<Resources>,\n          ) {\n            return render({ resource, input });\n          };\n        };\n      },\n    };\n  };\n\n  return defineIcon;\n}\n\nexport function createResourceLinksFn<\n  const Resources extends ReadonlyArray<ResourceDefinition>,\n>(_resources: Resources): CreateResourceLinksFn<Resources> {\n  const createResourceMap = createResourceMapFn(_resources);\n  const defineIcon = createDefineIcon<Resources>();\n\n  function createResourceLinks<\n    const Resource extends ResourceLinkConfigResource<Resources>,\n    const Config extends object,\n  >(config: CreateResourceLinkConfig<Resources, Resource> & Config) {\n    return createResourceLinksFromConfig(config);\n  }\n\n  function withGroups<\n    const Resource extends ResourceLinkConfigResource<Resources>,\n    const Groups extends ReadonlyArray<unknown>,\n  >(\n    groups: NonEmptyReadonlyArray<\n      CreateResourceLinkGroupInput<Resources, Resource>\n    > &\n      Groups,\n  ) {\n    return createResourceLinksWithGroups(_resources, createResourceMap, groups);\n  }\n\n  return Object.assign(createResourceLinks, {\n    createResourceMap,\n    defineIcon,\n    withGroups,\n  }) as CreateResourceLinksFn<Resources>;\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jfdevelops/react-layout",
-  "version": "0.24.2",
+  "version": "0.24.3",
   "description": "A React library for creating layout components.",
   "repository": {
     "type": "git",