@jfdevelops/react-layout 0.24.1 → 0.24.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (12) hide show
  1. package/dist/create-config/create-resource-links.cjs +5 -1
  2. package/dist/create-config/create-resource-links.cjs.map +1 -1
  3. package/dist/create-config/create-resource-links.d.cts +6 -2
  4. package/dist/create-config/create-resource-links.d.cts.map +1 -1
  5. package/dist/create-config/create-resource-links.d.mts +6 -2
  6. package/dist/create-config/create-resource-links.d.mts.map +1 -1
  7. package/dist/create-config/create-resource-links.mjs +5 -1
  8. package/dist/create-config/create-resource-links.mjs.map +1 -1
  9. package/dist/create-config/index.d.cts +1 -1
  10. package/dist/create-config/index.d.mts +1 -1
  11. package/package.json +1 -1
  12. package/skills/build-react-layouts/references/routing-and-navigation.md +1 -0
package/dist/create-config/create-resource-links.cjs CHANGED
@@ -114,7 +114,7 @@ function createResourceLinksWithGroups(resources, createResourceMap, groups) {
114
114
  function resolveGroups(resource) {
115
115
  if (resource === void 0) throw new require_layout_configuration_error.LayoutConfigurationError("[createResourceLinks.withGroups]: \"resource\" is required.");
116
116
  const currentResources = createRenderResourcesAccessor(resources, resource);
117
- return createdGroups.map((group) => ({
117
+ const resolvedGroups = createdGroups.map((group) => ({
118
118
  ...group,
119
119
  icon: typeof group.icon === "function" ? group.icon(currentResources) : group.icon,
120
120
  links: group.links.map((link) => ({
@@ -122,6 +122,10 @@ function createResourceLinksWithGroups(resources, createResourceMap, groups) {
122
122
  icon: typeof link.icon === "function" ? link.icon(currentResources) : link.icon
123
123
  }))
124
124
  }));
125
+ Object.defineProperty(resolvedGroups, "findResource", { value(requestedResource) {
126
+ return resolvedGroups.find((group) => group.links.some((link) => link.resource === requestedResource));
127
+ } });
128
+ return resolvedGroups;
125
129
  }
126
130
  const callableGroups = new Proxy(resolveGroups, {
127
131
  get(target, property, receiver) {
package/dist/create-config/create-resource-links.cjs.map CHANGED
@@ -1 +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 ): Array<ResolvedResourceLinksWithGroups<Resources>>;\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 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\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 return 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\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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"}
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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"}
package/dist/create-config/create-resource-links.d.cts CHANGED
@@ -171,7 +171,7 @@ type CreateResourceLinksWithGroupsResult<Resources extends ReadonlyArray<Resourc
171
171
  *
172
172
  * @param resource The active resource key.
173
173
  */
174
- (resource: LayoutResourceKey<Resources>): Array<ResolvedResourceLinksWithGroups<Resources>>;
174
+ (resource: LayoutResourceKey<Resources>): ResolvedResourceLinksWithGroupsResult<Resources, Resource>;
175
175
  /**
176
176
  * Creates a resource map for this layout. Same helper as
177
177
  * `createResourceLinks.createResourceMap`.
@@ -190,7 +190,11 @@ type CreateResourceLinksWithGroupsResult<Resources extends ReadonlyArray<Resourc
190
190
  */
191
191
  findResource<const RequestedResource extends LayoutResourceKey<Resources> | Resource>(resource: RequestedResource): FindResourceGroupResult<Resources, Resource, RequestedResource>;
192
192
  };
193
+ type ResolvedResourceLinksWithGroupsResult<Resources extends ReadonlyArray<ResourceDefinition>, Resource extends ResourceLinkConfigResource<Resources> = ResourceLinkConfigResource<Resources>> = Array<ResolvedResourceLinksWithGroups<Resources>> & {
194
+ /** Returns the resolved group whose links include `resource`. */findResource<const RequestedResource extends LayoutResourceKey<Resources> | Resource>(resource: RequestedResource): FindResolvedResourceGroupResult<Resources, Resource, RequestedResource>;
195
+ };
193
196
  type FindResourceGroupResult<Resources extends ReadonlyArray<ResourceDefinition>, IncludedResource extends string, RequestedResource extends string> = RequestedResource extends unknown ? RequestedResource extends IncludedResource ? CreateResourceLinksWithGroups<Resources> : undefined : never;
197
+ type FindResolvedResourceGroupResult<Resources extends ReadonlyArray<ResourceDefinition>, IncludedResource extends string, RequestedResource extends string> = RequestedResource extends unknown ? RequestedResource extends IncludedResource ? ResolvedResourceLinksWithGroups<Resources> : undefined : never;
194
198
  //#endregion
195
- export { CreateResourceLinkConfig, CreateResourceLinkGroupInput, CreateResourceLinkGroupOptions, CreateResourceLinkOptions, CreateResourceLinksFn, CreateResourceLinksWithGroups, CreateResourceLinksWithGroupsFn, CreateResourceLinksWithGroupsResult, CreateResourceMap, CreateResourceMapFn, CreatedResourceHref, CreatedResourceLink, CreatedResourceLinkBase, CreatedResourceMap, DefineResourceIconFn, DefineResourceIconInputHelpers, DefineResourceIconInputResult, FindResourceGroupResult, InferHashFromResourceLinkHref, ResolveResourceIconInput, ResolvedResourceLinksWithGroups, ResourceAnchorLinkFn, ResourceIcon, ResourceIconFn, ResourceLinkHref, ValidateResource };
199
+ 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 };
196
200
  //# sourceMappingURL=create-resource-links.d.cts.map
package/dist/create-config/create-resource-links.d.cts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"create-resource-links.d.cts","names":[],"sources":["../../src/create-config/create-resource-links.ts"],"mappings":"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"}
1
+ {"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 CHANGED
@@ -171,7 +171,7 @@ type CreateResourceLinksWithGroupsResult<Resources extends ReadonlyArray<Resourc
171
171
  *
172
172
  * @param resource The active resource key.
173
173
  */
174
- (resource: LayoutResourceKey<Resources>): Array<ResolvedResourceLinksWithGroups<Resources>>;
174
+ (resource: LayoutResourceKey<Resources>): ResolvedResourceLinksWithGroupsResult<Resources, Resource>;
175
175
  /**
176
176
  * Creates a resource map for this layout. Same helper as
177
177
  * `createResourceLinks.createResourceMap`.
@@ -190,7 +190,11 @@ type CreateResourceLinksWithGroupsResult<Resources extends ReadonlyArray<Resourc
190
190
  */
191
191
  findResource<const RequestedResource extends LayoutResourceKey<Resources> | Resource>(resource: RequestedResource): FindResourceGroupResult<Resources, Resource, RequestedResource>;
192
192
  };
193
+ type ResolvedResourceLinksWithGroupsResult<Resources extends ReadonlyArray<ResourceDefinition>, Resource extends ResourceLinkConfigResource<Resources> = ResourceLinkConfigResource<Resources>> = Array<ResolvedResourceLinksWithGroups<Resources>> & {
194
+ /** Returns the resolved group whose links include `resource`. */findResource<const RequestedResource extends LayoutResourceKey<Resources> | Resource>(resource: RequestedResource): FindResolvedResourceGroupResult<Resources, Resource, RequestedResource>;
195
+ };
193
196
  type FindResourceGroupResult<Resources extends ReadonlyArray<ResourceDefinition>, IncludedResource extends string, RequestedResource extends string> = RequestedResource extends unknown ? RequestedResource extends IncludedResource ? CreateResourceLinksWithGroups<Resources> : undefined : never;
197
+ type FindResolvedResourceGroupResult<Resources extends ReadonlyArray<ResourceDefinition>, IncludedResource extends string, RequestedResource extends string> = RequestedResource extends unknown ? RequestedResource extends IncludedResource ? ResolvedResourceLinksWithGroups<Resources> : undefined : never;
194
198
  //#endregion
195
- export { CreateResourceLinkConfig, CreateResourceLinkGroupInput, CreateResourceLinkGroupOptions, CreateResourceLinkOptions, CreateResourceLinksFn, CreateResourceLinksWithGroups, CreateResourceLinksWithGroupsFn, CreateResourceLinksWithGroupsResult, CreateResourceMap, CreateResourceMapFn, CreatedResourceHref, CreatedResourceLink, CreatedResourceLinkBase, CreatedResourceMap, DefineResourceIconFn, DefineResourceIconInputHelpers, DefineResourceIconInputResult, FindResourceGroupResult, InferHashFromResourceLinkHref, ResolveResourceIconInput, ResolvedResourceLinksWithGroups, ResourceAnchorLinkFn, ResourceIcon, ResourceIconFn, ResourceLinkHref, ValidateResource };
199
+ 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 };
196
200
  //# sourceMappingURL=create-resource-links.d.mts.map
package/dist/create-config/create-resource-links.d.mts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"create-resource-links.d.mts","names":[],"sources":["../../src/create-config/create-resource-links.ts"],"mappings":"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"}
1
+ {"version":3,"file":"create-resource-links.d.mts","names":[],"sources":["../../src/create-config/create-resource-links.ts"],"mappings":"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"}
package/dist/create-config/create-resource-links.mjs CHANGED
@@ -114,7 +114,7 @@ function createResourceLinksWithGroups(resources, createResourceMap, groups) {
114
114
  function resolveGroups(resource) {
115
115
  if (resource === void 0) throw new LayoutConfigurationError("[createResourceLinks.withGroups]: \"resource\" is required.");
116
116
  const currentResources = createRenderResourcesAccessor(resources, resource);
117
- return createdGroups.map((group) => ({
117
+ const resolvedGroups = createdGroups.map((group) => ({
118
118
  ...group,
119
119
  icon: typeof group.icon === "function" ? group.icon(currentResources) : group.icon,
120
120
  links: group.links.map((link) => ({
@@ -122,6 +122,10 @@ function createResourceLinksWithGroups(resources, createResourceMap, groups) {
122
122
  icon: typeof link.icon === "function" ? link.icon(currentResources) : link.icon
123
123
  }))
124
124
  }));
125
+ Object.defineProperty(resolvedGroups, "findResource", { value(requestedResource) {
126
+ return resolvedGroups.find((group) => group.links.some((link) => link.resource === requestedResource));
127
+ } });
128
+ return resolvedGroups;
125
129
  }
126
130
  const callableGroups = new Proxy(resolveGroups, {
127
131
  get(target, property, receiver) {
package/dist/create-config/create-resource-links.mjs.map CHANGED
@@ -1 +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 ): Array<ResolvedResourceLinksWithGroups<Resources>>;\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 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\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 return 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\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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"}
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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"}
package/dist/create-config/index.d.cts CHANGED
@@ -5,6 +5,6 @@ import { CreateGetComponentForPath, GetComponentForPath, GetComponentForPathApi,
5
5
  import { ForPaths, ForPathsRenderContext, RenderedPathComponent, RenderedPathComponentHOF, TargetPathBuilder } from "./for-paths/builder.cjs";
6
6
  import { IsSubResourceKey, IsSubResourceKeyOptions, IsSubResourceKeyResult } from "./is-sub-resource-key.cjs";
7
7
  import { ComponentTypes, CreateResourceConfigFn, CreatedResourceConfig, GetComponent, GetComponentAtBound, GetComponentForResource, GetComponentForResourceOptions, GetComponentOptions, GetComponentOptionsForResource, ResourceConfigPath, ResourceFromGetComponentBound, SubResourceFromGetComponentBound, ValidateForResourceBound } from "./get-component.cjs";
8
- import { CreateResourceLinkConfig, CreateResourceLinkGroupInput, CreateResourceLinkGroupOptions, CreateResourceLinkOptions, CreateResourceLinksFn, CreateResourceLinksWithGroups, CreateResourceLinksWithGroupsFn, CreateResourceLinksWithGroupsResult, CreateResourceMap, CreateResourceMapFn, CreatedResourceHref, CreatedResourceLink, CreatedResourceLinkBase, CreatedResourceMap, DefineResourceIconFn, DefineResourceIconInputHelpers, DefineResourceIconInputResult, FindResourceGroupResult, InferHashFromResourceLinkHref, ResolveResourceIconInput, ResolvedResourceLinksWithGroups, ResourceAnchorLinkFn, ResourceIcon, ResourceIconFn, ResourceLinkHref, ValidateResource } from "./create-resource-links.cjs";
8
+ import { 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 } from "./create-resource-links.cjs";
9
9
  import { CreateResourceLayoutFn, CreateResourceLayoutMakeComposableOptions, CreateResourceLayoutWithLayoutOptions, DefineResourceLayout, DefineResourceLayoutFn, DefineResourceLayoutForResources, DefineResourceLayoutForResourcesFactory, DefineResourceLayoutWithLayoutFn, DefineResourcesFn, DefinedResourceLayoutWithShell, LayoutRenderResourcesAccessor, LayoutResourcesAccessor, ResourceLayoutProvider, ResourceLayoutProviderProps, ResourceLayoutShellComponent, ResourceLayoutShellProps, ResourceSelection, ShellLayoutDefinition, ShellRenderContext, defineResourceLayout } from "./define-layout.cjs";
10
10
  import { ResourceLayoutShellPublisher } from "./shell-context.cjs";
package/dist/create-config/index.d.mts CHANGED
@@ -5,6 +5,6 @@ import { CreateGetComponentForPath, GetComponentForPath, GetComponentForPathApi,
5
5
  import { ForPaths, ForPathsRenderContext, RenderedPathComponent, RenderedPathComponentHOF, TargetPathBuilder } from "./for-paths/builder.mjs";
6
6
  import { IsSubResourceKey, IsSubResourceKeyOptions, IsSubResourceKeyResult } from "./is-sub-resource-key.mjs";
7
7
  import { ComponentTypes, CreateResourceConfigFn, CreatedResourceConfig, GetComponent, GetComponentAtBound, GetComponentForResource, GetComponentForResourceOptions, GetComponentOptions, GetComponentOptionsForResource, ResourceConfigPath, ResourceFromGetComponentBound, SubResourceFromGetComponentBound, ValidateForResourceBound } from "./get-component.mjs";
8
- import { CreateResourceLinkConfig, CreateResourceLinkGroupInput, CreateResourceLinkGroupOptions, CreateResourceLinkOptions, CreateResourceLinksFn, CreateResourceLinksWithGroups, CreateResourceLinksWithGroupsFn, CreateResourceLinksWithGroupsResult, CreateResourceMap, CreateResourceMapFn, CreatedResourceHref, CreatedResourceLink, CreatedResourceLinkBase, CreatedResourceMap, DefineResourceIconFn, DefineResourceIconInputHelpers, DefineResourceIconInputResult, FindResourceGroupResult, InferHashFromResourceLinkHref, ResolveResourceIconInput, ResolvedResourceLinksWithGroups, ResourceAnchorLinkFn, ResourceIcon, ResourceIconFn, ResourceLinkHref, ValidateResource } from "./create-resource-links.mjs";
8
+ import { 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 } from "./create-resource-links.mjs";
9
9
  import { CreateResourceLayoutFn, CreateResourceLayoutMakeComposableOptions, CreateResourceLayoutWithLayoutOptions, DefineResourceLayout, DefineResourceLayoutFn, DefineResourceLayoutForResources, DefineResourceLayoutForResourcesFactory, DefineResourceLayoutWithLayoutFn, DefineResourcesFn, DefinedResourceLayoutWithShell, LayoutRenderResourcesAccessor, LayoutResourcesAccessor, ResourceLayoutProvider, ResourceLayoutProviderProps, ResourceLayoutShellComponent, ResourceLayoutShellProps, ResourceSelection, ShellLayoutDefinition, ShellRenderContext, defineResourceLayout } from "./define-layout.mjs";
10
10
  import { ResourceLayoutShellPublisher } from "./shell-context.mjs";
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@jfdevelops/react-layout",
3
- "version": "0.24.1",
3
+ "version": "0.24.2",
4
4
  "description": "A React library for creating layout components.",
5
5
  "repository": {
6
6
  "type": "git",
package/skills/build-react-layouts/references/routing-and-navigation.md CHANGED
@@ -148,6 +148,7 @@ methods such as `filter` and `map` are still available directly.
148
148
 
149
149
  ```tsx
150
150
  const resolvedNavigation = navigation(currentResource);
151
+ const currentGroup = resolvedNavigation.findResource(currentResource);
151
152
  const visibleGroups = navigation.filter(Boolean);
152
153
  ```
153
154