@jfdevelops/react-layout 0.17.5 → 0.18.1

package/dist/create-config/get-component.cjs

@@ -1,35 +1,75 @@
+const require_invalid_config = require('../errors/invalid-config.cjs');
+const require_invalid_path = require('../errors/invalid-path.cjs');
+const require_invalid_resource = require('../errors/invalid-resource.cjs');
+const require_invalid_sub_resource = require('../errors/invalid-sub-resource.cjs');
+const require_invalid_component = require('../errors/invalid-component.cjs');
+const require_component_keys = require('./component-keys.cjs');
+const require_introspect = require('./paths/introspect.cjs');
+const require_get_component_for_path = require('./for-paths/get-component-for-path.cjs');
+const require_builder = require('./for-paths/builder.cjs');
+const require_is_sub_resource_key = require('./is-sub-resource-key.cjs');
 
 //#region src/create-config/get-component.ts
+function isResourceConfigEntry(value) {
+	return typeof value === "object" && value !== null;
+}
 function resolveResourceConfigEntry(entry, subResource) {
-	if (typeof subResource === "string") {
-		const next = entry.subResources?.[subResource];
-		if (!next) throw new Error(`Sub-resource "${subResource}" is not configured`);
-		return next;
-	}
-	const next = entry.subResources?.[subResource.resource];
-	if (!next) throw new Error(`Sub-resource "${subResource.resource}" is not configured`);
+	const key = typeof subResource === "string" ? subResource : subResource.value;
+	const next = entry[key];
+	if (!isResourceConfigEntry(next)) throw new require_invalid_sub_resource.InvalidSubResourceError({
+		subResource: key,
+		validSubResources: require_component_keys.readSubResourceKeys(entry)
+	});
+	if (typeof subResource === "string") return next;
 	return resolveResourceConfigEntry(next, subResource.subResource);
 }
 function readResourceConfigComponent(entry, componentKey) {
 	if (componentKey === "new" || componentKey === "detail") {
 		const branch = entry[componentKey];
-		if (!branch?.component) throw new Error(`Missing "${componentKey}.component" configuration`);
+		if (!branch?.component) throw new require_invalid_component.InvalidComponentError({
+			component: `${componentKey}.component`,
+			validComponents: require_component_keys.readComponentKeys(entry)
+		});
 		return branch.component;
 	}
 	const value = entry[componentKey];
-	if (!value) throw new Error(`Missing "${componentKey}" configuration`);
+	if (!value) throw new require_invalid_component.InvalidComponentError({
+		component: componentKey,
+		validComponents: require_component_keys.readComponentKeys(entry)
+	});
 	return value;
 }
 function getComponentFromOptions(config, options) {
 	const { resource, component: componentKey = "component" } = options;
 	const resourceEntry = config[resource];
-	if (!resourceEntry) throw new Error(`Resource "${resource}" is not configured`);
+	if (!resourceEntry) throw new require_invalid_resource.InvalidResourceError({
+		resource,
+		validResources: require_introspect.collectConfigResources(config)
+	});
 	let entry = resourceEntry;
 	if ("subResource" in options && options.subResource !== void 0) entry = resolveResourceConfigEntry(entry, options.subResource);
 	return readResourceConfigComponent(entry, componentKey);
 }
+function getComponentFromPath(config, path) {
+	let cursor = config;
+	for (const segment of path.split(".")) {
+		if (!isResourceConfigEntry(cursor)) throw new require_invalid_path.InvalidPathError({
+			path,
+			reason: `"${segment}" cannot be read because the value before it is not a config branch`
+		});
+		const next = cursor[segment];
+		if (next === void 0 || next === null) throw new require_invalid_path.InvalidPathError({
+			path,
+			reason: `"${segment}" is not configured`
+		});
+		cursor = next;
+	}
+	if (isResourceConfigEntry(cursor) && "component" in cursor) return readResourceConfigComponent(cursor, "component");
+	return cursor;
+}
 function createGetComponent(config) {
 	function getComponent(options) {
+		if (typeof options === "string") return getComponentFromPath(config, options);
 		return getComponentFromOptions(config, options);
 	}
 	const forResource = (bound) => {
@@ -41,9 +81,18 @@ function createGetComponent(config) {
 	return Object.assign(getComponent, { forResource });
 }
 function createResourceConfig(config) {
+	const configRecord = config;
+	if (require_introspect.collectConfigResources(configRecord).length === 0) throw new require_invalid_config.InvalidConfigError({
+		reason: "A resource config must configure at least one resource",
+		config
+	});
 	return {
 		config,
-		getComponent: createGetComponent(config)
+		getComponent: createGetComponent(config),
+		createGetComponent: ((path) => require_get_component_for_path.createGetComponentForPath(configRecord, path)),
+		forPaths: require_builder.createForPaths(configRecord),
+		isSubResourceKey: require_is_sub_resource_key.createIsSubResourceKey(configRecord),
+		subResources: require_introspect.collectAllSubResourceKeys(configRecord)
 	};
 }
 

package/dist/create-config/get-component.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"get-component.cjs","names":[],"sources":["../../src/create-config/get-component.ts"],"sourcesContent":["import type { JSX } from 'react';\nimport type {\n  LayoutResourceKey,\n  ResourceDefinition,\n  SubResourceDefinitionsFor,\n  SubResourceParamForResource,\n} from '../resource';\nimport type {\n  ResourceConfigComponentKey,\n  ResourceConfigComponents,\n  ResourceConfigEntry,\n  ResourceConfigMap,\n  ResourceConfigInput,\n} from './types';\n\ntype ResourceHasLayoutSubResources<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends LayoutResourceKey<Resources>,\n> = [SubResourceDefinitionsFor<Resources, Resource>] extends [readonly []]\n  ? false\n  : true;\n\ntype SubResourceOptionForGenerics<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends LayoutResourceKey<Resources>,\n  SubResource extends\n    | SubResourceParamForResource<Resources, Resource>\n    | undefined,\n> = [SubResource] extends [undefined]\n  ? ResourceHasLayoutSubResources<Resources, Resource> extends true\n    ? {\n        subResource?: SubResourceParamForResource<Resources, Resource>;\n      }\n    : {}\n  : ResourceHasLayoutSubResources<Resources, Resource> extends true\n    ? { subResource?: SubResource }\n    : {};\n\n/** Options for one layout resource passed to {@link GetComponent}. */\nexport type GetComponentOptionsForResource<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends LayoutResourceKey<Resources>,\n  SubResource extends\n    | SubResourceParamForResource<Resources, Resource>\n    | undefined = undefined,\n> = SubResourceOptionForGenerics<Resources, Resource, SubResource> & {\n  resource: Resource;\n  /**\n   * The component to get.\n   *\n   * @default 'component'\n   */\n  component?: ResourceConfigComponentKey;\n};\n\n/** Union of valid `getComponent` option shapes for each declared layout resource. */\nexport type GetComponentOptions<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> =\n  LayoutResourceKey<Resources> extends infer Resource\n    ? Resource extends LayoutResourceKey<Resources>\n      ? GetComponentOptionsForResource<Resources, Resource>\n      : never\n    : never;\n\n/** `subResource` bound by {@link GetComponentForResource}. */\nexport type SubResourceFromGetComponentBound<Bound> = Bound extends {\n  subResource: infer SubResource;\n}\n  ? SubResource\n  : undefined;\n\n/** Options for {@link GetComponentForResource} — binds `resource` and optional `subResource`. */\nexport type GetComponentForResourceOptions<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends LayoutResourceKey<Resources>,\n  SubResource extends\n    | SubResourceParamForResource<Resources, Resource>\n    | undefined = undefined,\n> = {\n  resource: Resource;\n} & SubResourceOptionForGenerics<Resources, Resource, SubResource>;\n\n/** Valid bind shapes for {@link GetComponentForResource}. */\nexport type GetComponentForResourceBound<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> =\n  LayoutResourceKey<Resources> extends infer Resource\n    ? Resource extends LayoutResourceKey<Resources>\n      ? GetComponentForResourceOptions<Resources, Resource>\n      : never\n    : never;\n\ntype GetComponentForResourceOptionsForBound<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Bound extends { resource: LayoutResourceKey<Resources> },\n> = GetComponentForResourceOptions<\n  Resources,\n  Bound['resource'],\n  SubResourceFromGetComponentBound<Bound>\n>;\n\n/**\n * Rejects bind objects with keys (e.g. `subResource`) that are invalid for the\n * given `resource`. Union assignability alone is too permissive for excess keys.\n */\nexport type ValidateForResourceBound<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Bound extends { resource: LayoutResourceKey<Resources> },\n> = Bound extends GetComponentForResourceOptionsForBound<Resources, Bound>\n  ? keyof Bound extends keyof GetComponentForResourceOptionsForBound<\n      Resources,\n      Bound\n    >\n    ? Bound\n    : never\n  : never;\n\n/** `resource` inferred from a {@link GetComponentForResource} bind argument. */\nexport type ResourceFromGetComponentBound<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Bound,\n> = Bound extends {\n  resource: infer Resource extends LayoutResourceKey<Resources>;\n}\n  ? Resource\n  : never;\n\n/** Reusable getter returned by {@link GetComponentForResource} (only `component` remains). */\nexport type GetComponentAtBound<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends LayoutResourceKey<Resources>,\n  SubResource extends\n    | SubResourceParamForResource<Resources, Resource>\n    | undefined = undefined,\n> = (\n  options?: Pick<\n    GetComponentOptionsForResource<Resources, Resource, SubResource>,\n    'component'\n  >,\n) => JSX.Element;\n\nexport type GetComponentForResource<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = <\n  const Bound extends {\n    resource: LayoutResourceKey<Resources>;\n  },\n>(\n  bound: ValidateForResourceBound<Resources, Bound>,\n) => GetComponentAtBound<\n  Resources,\n  ResourceFromGetComponentBound<Resources, Bound>,\n  SubResourceFromGetComponentBound<Bound>\n>;\n\nexport interface GetComponent<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> {\n  <const Options extends GetComponentOptions<Resources>>(\n    options: Options,\n  ): JSX.Element;\n  forResource: GetComponentForResource<Resources>;\n}\n\nexport interface CreatedResourceConfig<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> {\n  config: ResourceConfigMap<Resources>;\n  getComponent: GetComponent<Resources>;\n}\n\nexport type CreateResourceConfigFn<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = <const Config extends ResourceConfigMap<Resources>>(\n  config: ResourceConfigInput<Resources, Config>,\n) => CreatedResourceConfig<Resources>;\n\ntype SubResourceParam =\n  | string\n  | {\n      resource: string;\n      subResource: SubResourceParam;\n    };\n\nfunction resolveResourceConfigEntry(\n  entry: ResourceConfigEntry,\n  subResource: SubResourceParam,\n): ResourceConfigEntry {\n  if (typeof subResource === 'string') {\n    const next = entry.subResources?.[subResource];\n    if (!next) {\n      throw new Error(`Sub-resource \"${subResource}\" is not configured`);\n    }\n    return next;\n  }\n\n  const next = entry.subResources?.[subResource.resource];\n  if (!next) {\n    throw new Error(`Sub-resource \"${subResource.resource}\" is not configured`);\n  }\n\n  return resolveResourceConfigEntry(next, subResource.subResource);\n}\n\nfunction readResourceConfigComponent(\n  entry: ResourceConfigComponents,\n  componentKey: ResourceConfigComponentKey,\n): JSX.Element {\n  if (componentKey === 'new' || componentKey === 'detail') {\n    const branch = entry[componentKey];\n\n    if (!branch?.component) {\n      throw new Error(`Missing \"${componentKey}.component\" configuration`);\n    }\n\n    return branch.component;\n  }\n\n  const value = entry[componentKey];\n\n  if (!value) {\n    throw new Error(`Missing \"${componentKey}\" configuration`);\n  }\n\n  return value;\n}\n\nfunction getComponentFromOptions<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n>(\n  config: ResourceConfigMap<Resources>,\n  options: GetComponentOptions<Resources>,\n): JSX.Element {\n  const { resource, component: componentKey = 'component' } = options;\n  const resourceEntry = config[resource];\n\n  if (!resourceEntry) {\n    throw new Error(`Resource \"${resource}\" is not configured`);\n  }\n\n  let entry: ResourceConfigEntry = resourceEntry;\n\n  if ('subResource' in options && options.subResource !== undefined) {\n    entry = resolveResourceConfigEntry(entry, options.subResource);\n  }\n\n  return readResourceConfigComponent(entry, componentKey);\n}\n\nexport function createGetComponent<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n>(config: ResourceConfigMap<Resources>): GetComponent<Resources> {\n  function getComponent<const Options extends GetComponentOptions<Resources>>(\n    options: Options,\n  ) {\n    return getComponentFromOptions(config, options);\n  }\n\n  const forResource: GetComponentForResource<Resources> = (bound) => {\n    return (options) =>\n      getComponentFromOptions(config, {\n        ...bound,\n        ...options,\n      } as unknown as GetComponentOptions<Resources>);\n  };\n\n  return Object.assign(getComponent, { forResource });\n}\n\nexport function createResourceConfig<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n>(config: ResourceConfigMap<Resources>): CreatedResourceConfig<Resources> {\n  return {\n    config,\n    getComponent: createGetComponent(config),\n  };\n}\n"],"mappings":";;AAyLA,SAAS,2BACP,OACA,aACqB;CACrB,IAAI,OAAO,gBAAgB,UAAU;EACnC,MAAM,OAAO,MAAM,eAAe;EAClC,IAAI,CAAC,MACH,MAAM,IAAI,MAAM,iBAAiB,YAAY,oBAAoB;EAEnE,OAAO;CACT;CAEA,MAAM,OAAO,MAAM,eAAe,YAAY;CAC9C,IAAI,CAAC,MACH,MAAM,IAAI,MAAM,iBAAiB,YAAY,SAAS,oBAAoB;CAG5E,OAAO,2BAA2B,MAAM,YAAY,WAAW;AACjE;AAEA,SAAS,4BACP,OACA,cACa;CACb,IAAI,iBAAiB,SAAS,iBAAiB,UAAU;EACvD,MAAM,SAAS,MAAM;EAErB,IAAI,CAAC,QAAQ,WACX,MAAM,IAAI,MAAM,YAAY,aAAa,0BAA0B;EAGrE,OAAO,OAAO;CAChB;CAEA,MAAM,QAAQ,MAAM;CAEpB,IAAI,CAAC,OACH,MAAM,IAAI,MAAM,YAAY,aAAa,gBAAgB;CAG3D,OAAO;AACT;AAEA,SAAS,wBAGP,QACA,SACa;CACb,MAAM,EAAE,UAAU,WAAW,eAAe,gBAAgB;CAC5D,MAAM,gBAAgB,OAAO;CAE7B,IAAI,CAAC,eACH,MAAM,IAAI,MAAM,aAAa,SAAS,oBAAoB;CAG5D,IAAI,QAA6B;CAEjC,IAAI,iBAAiB,WAAW,QAAQ,gBAAgB,QACtD,QAAQ,2BAA2B,OAAO,QAAQ,WAAW;CAG/D,OAAO,4BAA4B,OAAO,YAAY;AACxD;AAEA,SAAgB,mBAEd,QAA+D;CAC/D,SAAS,aACP,SACA;EACA,OAAO,wBAAwB,QAAQ,OAAO;CAChD;CAEA,MAAM,eAAmD,UAAU;EACjE,QAAQ,YACN,wBAAwB,QAAQ;GAC9B,GAAG;GACH,GAAG;EACL,CAA8C;CAClD;CAEA,OAAO,OAAO,OAAO,cAAc,EAAE,YAAY,CAAC;AACpD;AAEA,SAAgB,qBAEd,QAAwE;CACxE,OAAO;EACL;EACA,cAAc,mBAAmB,MAAM;CACzC;AACF"}
+{"version":3,"file":"get-component.cjs","names":["InvalidSubResourceError","readSubResourceKeys","InvalidComponentError","readComponentKeys","InvalidResourceError","collectConfigResources","InvalidPathError","InvalidConfigError","createGetComponentForPath","createForPaths","createIsSubResourceKey","collectAllSubResourceKeys"],"sources":["../../src/create-config/get-component.ts"],"sourcesContent":["import type { JSX } from 'react';\nimport {\n  InvalidComponentError,\n  InvalidConfigError,\n  InvalidPathError,\n  InvalidResourceError,\n  InvalidSubResourceError,\n} from '../errors';\nimport type {\n  LayoutResourceKey,\n  ResourceDefinition,\n  ResourceDefinitionForKey,\n  SubResourceDefinitionsFor,\n  SubResourceParamForResource,\n} from '../resource';\nimport {\n  createForPaths,\n  createGetComponentForPath,\n  type CreateGetComponentForPath,\n  type ForPaths,\n} from './for-paths';\nimport {\n  createIsSubResourceKey,\n  type IsSubResourceKey,\n} from './is-sub-resource-key';\nimport {\n  readComponentKeys,\n  readSubResourceKeys,\n} from './component-keys';\nimport {\n  collectAllSubResourceKeys,\n  collectConfigResources,\n} from './paths';\nimport type {\n  ConfigSubResourceKeys,\n  ParameterizedResourcePath,\n} from './paths';\nimport type {\n  BaseResourceConfigComponents,\n  ResourceConfigComponentKey,\n  ResourceConfigComponents,\n  ResourceConfigEntry,\n  ResourceConfigMap,\n  ResourceConfigInput,\n  SharedResourceConfigOptions,\n} from './types';\n\ntype ResourceHasLayoutSubResources<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends LayoutResourceKey<Resources>,\n> = [SubResourceDefinitionsFor<Resources, Resource>] extends [readonly []]\n  ? false\n  : true;\n\ntype SubResourceOptionForGenerics<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends LayoutResourceKey<Resources>,\n  SubResource extends\n    | SubResourceParamForResource<Resources, Resource>\n    | undefined,\n> = [SubResource] extends [undefined]\n  ? ResourceHasLayoutSubResources<Resources, Resource> extends true\n    ? {\n        subResource?: SubResourceParamForResource<Resources, Resource>;\n      }\n    : {}\n  : ResourceHasLayoutSubResources<Resources, Resource> extends true\n    ? { subResource?: SubResource }\n    : {};\n\n/** Options for one layout resource passed to {@link GetComponent}. */\nexport type GetComponentOptionsForResource<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends LayoutResourceKey<Resources>,\n  SubResource extends\n    | SubResourceParamForResource<Resources, Resource>\n    | undefined = undefined,\n> = SubResourceOptionForGenerics<Resources, Resource, SubResource> & {\n  resource: Resource;\n  /**\n   * The component to get.\n   *\n   * @default 'component'\n   */\n  component?: ResourceConfigComponentKey;\n};\n\n/** Union of valid `getComponent` option shapes for each declared layout resource. */\nexport type GetComponentOptions<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> =\n  LayoutResourceKey<Resources> extends infer Resource\n    ? Resource extends LayoutResourceKey<Resources>\n      ? GetComponentOptionsForResource<Resources, Resource>\n      : never\n    : never;\n\ntype ComponentSlotPathKey = keyof BaseResourceConfigComponents;\n\n/** `detail.errorComponent`, `new.component`, … — component slots inside a shared branch. */\ntype SharedBranchPath = {\n  [Branch in keyof SharedResourceConfigOptions]: `${Branch}.${ComponentSlotPathKey}`;\n}[keyof SharedResourceConfigOptions];\n\ntype NestedSubResourceDefinitions<Def extends ResourceDefinition> = Def extends {\n  subResources: infer Nested extends ReadonlyArray<ResourceDefinition>;\n}\n  ? Nested\n  : readonly [];\n\ntype SubResourceEntryPaths<\n  SubDefs extends ReadonlyArray<ResourceDefinition>,\n  DepthAcc extends readonly unknown[],\n> =\n  LayoutResourceKey<SubDefs> extends infer Key extends string\n    ? Key extends LayoutResourceKey<SubDefs>\n      ?\n          | Key\n          | `${Key}.${ResourceConfigEntryPath<\n              NestedSubResourceDefinitions<\n                ResourceDefinitionForKey<SubDefs, Key>\n              >,\n              readonly [...DepthAcc, unknown]\n            >}`\n      : never\n    : never;\n\n/** Dot-separated keys below one config node: component slots and nested sub-resources. */\ntype ResourceConfigEntryPath<\n  SubDefs extends ReadonlyArray<ResourceDefinition>,\n  DepthAcc extends readonly unknown[] = readonly [],\n> =\n  | ComponentSlotPathKey\n  | SharedBranchPath\n  | ([SubDefs] extends [readonly []]\n      ? never\n      : DepthAcc['length'] extends 6\n        ? never\n        : SubResourceEntryPaths<SubDefs, DepthAcc>);\n\n/**\n * Deep config paths accepted by {@link GetComponent}, e.g.\n * `'templates.deleted.expired.errorComponent'`. Sub-resource segments come from the\n * layout tree, so only declared sub-resources are allowed at each depth.\n */\nexport type ResourceConfigPath<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> =\n  LayoutResourceKey<Resources> extends infer Resource extends string\n    ? Resource extends LayoutResourceKey<Resources>\n      ?\n          | Resource\n          | `${Resource}.${ResourceConfigEntryPath<\n              SubResourceDefinitionsFor<Resources, Resource>\n            >}`\n      : never\n    : never;\n\n/** `subResource` bound by {@link GetComponentForResource}. */\nexport type SubResourceFromGetComponentBound<Bound> = Bound extends {\n  subResource: infer SubResource;\n}\n  ? SubResource\n  : undefined;\n\n/** Options for {@link GetComponentForResource} — binds `resource` and optional `subResource`. */\nexport type GetComponentForResourceOptions<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends LayoutResourceKey<Resources>,\n  SubResource extends\n    | SubResourceParamForResource<Resources, Resource>\n    | undefined = undefined,\n> = {\n  resource: Resource;\n} & SubResourceOptionForGenerics<Resources, Resource, SubResource>;\n\n/** Valid bind shapes for {@link GetComponentForResource}. */\nexport type GetComponentForResourceBound<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> =\n  LayoutResourceKey<Resources> extends infer Resource\n    ? Resource extends LayoutResourceKey<Resources>\n      ? GetComponentForResourceOptions<Resources, Resource>\n      : never\n    : never;\n\ntype GetComponentForResourceOptionsForBound<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Bound extends { resource: LayoutResourceKey<Resources> },\n> = GetComponentForResourceOptions<\n  Resources,\n  Bound['resource'],\n  SubResourceFromGetComponentBound<Bound>\n>;\n\n/**\n * Rejects bind objects with keys (e.g. `subResource`) that are invalid for the\n * given `resource`. Union assignability alone is too permissive for excess keys.\n */\nexport type ValidateForResourceBound<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Bound extends { resource: LayoutResourceKey<Resources> },\n> = Bound extends GetComponentForResourceOptionsForBound<Resources, Bound>\n  ? keyof Bound extends keyof GetComponentForResourceOptionsForBound<\n      Resources,\n      Bound\n    >\n    ? Bound\n    : never\n  : never;\n\n/** `resource` inferred from a {@link GetComponentForResource} bind argument. */\nexport type ResourceFromGetComponentBound<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Bound,\n> = Bound extends {\n  resource: infer Resource extends LayoutResourceKey<Resources>;\n}\n  ? Resource\n  : never;\n\n/** Reusable getter returned by {@link GetComponentForResource} (only `component` remains). */\nexport type GetComponentAtBound<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends LayoutResourceKey<Resources>,\n  SubResource extends\n    | SubResourceParamForResource<Resources, Resource>\n    | undefined = undefined,\n> = (\n  options?: Pick<\n    GetComponentOptionsForResource<Resources, Resource, SubResource>,\n    'component'\n  >,\n) => JSX.Element;\n\nexport type GetComponentForResource<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = <\n  const Bound extends {\n    resource: LayoutResourceKey<Resources>;\n  },\n>(\n  bound: ValidateForResourceBound<Resources, Bound>,\n) => GetComponentAtBound<\n  Resources,\n  ResourceFromGetComponentBound<Resources, Bound>,\n  SubResourceFromGetComponentBound<Bound>\n>;\n\nexport interface GetComponent<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> {\n  /** Looks up a component by resource / optional sub-resource / optional component slot. */\n  <const Options extends GetComponentOptions<Resources>>(\n    options: Options,\n  ): JSX.Element;\n  /**\n   * Looks up a component by a deep config path.\n   * A path ending on a branch (e.g. `'templates.deleted.expired'`) returns that branch's\n   * `component`; a path ending on a slot returns that slot.\n   */\n  <const Path extends ResourceConfigPath<Resources>>(path: Path): JSX.Element;\n  forResource: GetComponentForResource<Resources>;\n}\n\nexport interface CreatedResourceConfig<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Config extends ResourceConfigMap<Resources> = ResourceConfigMap<Resources>,\n> {\n  config: Config;\n  getComponent: GetComponent<Resources>;\n  /**\n   * Creates a reusable getter bound to one path. Variables the path leaves open become\n   * the getter's arguments.\n   *\n   * @example\n   * ```ts\n   * const getDetail = createGetComponent('$resource.detail.$component');\n   *\n   * getDetail({ resource: 'templates', component: 'errorComponent' });\n   * ```\n   */\n  createGetComponent: CreateGetComponentForPath<\n    Resources,\n    Config,\n    ParameterizedResourcePath<Resources>\n  >;\n  /**\n   * Builds a component for one or more paths. Declare which params the component takes,\n   * then render it.\n   *\n   * @example\n   * ```ts\n   * const ResourceDetail = forPaths('$resource.detail.$component')\n   *   .addPathParams()\n   *   .render(({ params, getComponentForPath }) =>\n   *     getComponentForPath('$resource.detail.$component')(params),\n   *   );\n   * ```\n   */\n  forPaths: ForPaths<\n    Resources,\n    Config,\n    ParameterizedResourcePath<Resources>\n  >;\n  /** Narrows an unknown value to a sub-resource key configured for a path or resource. */\n  isSubResourceKey: IsSubResourceKey<\n    Resources,\n    Config,\n    ParameterizedResourcePath<Resources>\n  >;\n  /** Every sub-resource key configured in this config, at any depth. */\n  subResources: ReadonlyArray<ConfigSubResourceKeys<Resources, Config>>;\n}\n\ntype ComponentTypesFromEntry<Entry> = Entry extends JSX.Element\n  ? never\n  : Entry extends object\n    ?\n        | Extract<keyof Entry, ResourceConfigComponentKey>\n        | {\n            [Key in keyof Entry]: NonNullable<Entry[Key]> extends JSX.Element\n              ? never\n              : ComponentTypesFromEntry<NonNullable<Entry[Key]>>;\n          }[keyof Entry]\n    : never;\n\n/**\n * Component selector keys actually defined anywhere in a created resource config.\n *\n * @example\n * ```ts\n * ComponentTypes<typeof resourceConfig>\n * // ^? may resolve to:`'component' | 'errorComponent' | 'detail'`.\n * ```\n */\nexport type ComponentTypes<Created> = Created extends {\n  config: infer Config extends object;\n}\n  ? {\n      [Resource in keyof Config]: ComponentTypesFromEntry<\n        NonNullable<Config[Resource]>\n      >;\n    }[keyof Config]\n  : never;\n\nexport type CreateResourceConfigFn<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = <const Config extends ResourceConfigMap<Resources>>(\n  config: ResourceConfigInput<Resources, Config>,\n) => CreatedResourceConfig<Resources, Config>;\n\ntype SubResourceParam =\n  | string\n  | {\n      value: string;\n      subResource: SubResourceParam;\n    };\n\nfunction isResourceConfigEntry(value: unknown): value is ResourceConfigEntry {\n  return typeof value === 'object' && value !== null;\n}\n\nfunction resolveResourceConfigEntry(\n  entry: ResourceConfigEntry,\n  subResource: SubResourceParam,\n): ResourceConfigEntry {\n  const key = typeof subResource === 'string' ? subResource : subResource.value;\n  const next = entry[key];\n\n  if (!isResourceConfigEntry(next)) {\n    throw new InvalidSubResourceError({\n      subResource: key,\n      validSubResources: readSubResourceKeys(entry),\n    });\n  }\n\n  if (typeof subResource === 'string') {\n    return next;\n  }\n\n  return resolveResourceConfigEntry(next, subResource.subResource);\n}\n\nfunction readResourceConfigComponent(\n  entry: ResourceConfigComponents,\n  componentKey: ResourceConfigComponentKey,\n): JSX.Element {\n  if (componentKey === 'new' || componentKey === 'detail') {\n    const branch = entry[componentKey];\n\n    if (!branch?.component) {\n      throw new InvalidComponentError({\n        component: `${componentKey}.component`,\n        validComponents: readComponentKeys(entry),\n      });\n    }\n\n    return branch.component;\n  }\n\n  const value = entry[componentKey];\n\n  if (!value) {\n    throw new InvalidComponentError({\n      component: componentKey,\n      validComponents: readComponentKeys(entry),\n    });\n  }\n\n  return value;\n}\n\nfunction getComponentFromOptions<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n>(\n  config: ResourceConfigMap<Resources>,\n  options: GetComponentOptions<Resources>,\n): JSX.Element {\n  const { resource, component: componentKey = 'component' } = options;\n  const resourceEntry = config[resource];\n\n  if (!resourceEntry) {\n    throw new InvalidResourceError({\n      resource,\n      validResources: collectConfigResources(config as Record<string, unknown>),\n    });\n  }\n\n  let entry = resourceEntry as ResourceConfigEntry;\n\n  if ('subResource' in options && options.subResource !== undefined) {\n    entry = resolveResourceConfigEntry(entry, options.subResource);\n  }\n\n  return readResourceConfigComponent(entry, componentKey);\n}\n\nfunction getComponentFromPath<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n>(config: ResourceConfigMap<Resources>, path: string): JSX.Element {\n  let cursor: unknown = config;\n\n  for (const segment of path.split('.')) {\n    if (!isResourceConfigEntry(cursor)) {\n      throw new InvalidPathError({\n        path,\n        reason: `\"${segment}\" cannot be read because the value before it is not a config branch`,\n      });\n    }\n\n    const next: unknown = (cursor as Record<string, unknown>)[segment];\n\n    if (next === undefined || next === null) {\n      throw new InvalidPathError({\n        path,\n        reason: `\"${segment}\" is not configured`,\n      });\n    }\n\n    cursor = next;\n  }\n\n  if (isResourceConfigEntry(cursor) && 'component' in cursor) {\n    return readResourceConfigComponent(cursor, 'component');\n  }\n\n  return cursor as JSX.Element;\n}\n\nexport function createGetComponent<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n>(config: ResourceConfigMap<Resources>): GetComponent<Resources> {\n  function getComponent(options: GetComponentOptions<Resources>): JSX.Element;\n  function getComponent(path: ResourceConfigPath<Resources>): JSX.Element;\n  function getComponent(\n    options: GetComponentOptions<Resources> | ResourceConfigPath<Resources>,\n  ): JSX.Element {\n    if (typeof options === 'string') {\n      return getComponentFromPath(config, options);\n    }\n\n    return getComponentFromOptions(config, options);\n  }\n\n  const forResource: GetComponentForResource<Resources> = (bound) => {\n    return (options) =>\n      getComponentFromOptions(config, {\n        ...bound,\n        ...options,\n      } as unknown as GetComponentOptions<Resources>);\n  };\n\n  return Object.assign(getComponent, { forResource });\n}\n\nexport function createResourceConfig<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  const Config extends ResourceConfigMap<Resources>,\n>(\n  config: ResourceConfigInput<Resources, Config>,\n): CreatedResourceConfig<Resources, Config> {\n  const configRecord = config as Record<string, unknown>;\n\n  if (collectConfigResources(configRecord).length === 0) {\n    throw new InvalidConfigError({\n      reason: 'A resource config must configure at least one resource',\n      config,\n    });\n  }\n\n  type Created = CreatedResourceConfig<Resources, Config>;\n\n  return {\n    config,\n    getComponent: createGetComponent(config),\n    createGetComponent: ((path: string) =>\n      createGetComponentForPath(\n        configRecord,\n        path,\n      )) as unknown as Created['createGetComponent'],\n    forPaths: createForPaths(configRecord) as unknown as Created['forPaths'],\n    isSubResourceKey: createIsSubResourceKey(\n      configRecord,\n    ) as unknown as Created['isSubResourceKey'],\n    subResources: collectAllSubResourceKeys(\n      configRecord,\n    ) as unknown as Created['subResources'],\n  };\n}\n"],"mappings":";;;;;;;;;;;;AAuWA,SAAS,sBAAsB,OAA8C;CAC3E,OAAO,OAAO,UAAU,YAAY,UAAU;AAChD;AAEA,SAAS,2BACP,OACA,aACqB;CACrB,MAAM,MAAM,OAAO,gBAAgB,WAAW,cAAc,YAAY;CACxE,MAAM,OAAO,MAAM;CAEnB,IAAI,CAAC,sBAAsB,IAAI,GAC7B,MAAM,IAAIA,qDAAwB;EAChC,aAAa;EACb,mBAAmBC,2CAAoB,KAAK;CAC9C,CAAC;CAGH,IAAI,OAAO,gBAAgB,UACzB,OAAO;CAGT,OAAO,2BAA2B,MAAM,YAAY,WAAW;AACjE;AAEA,SAAS,4BACP,OACA,cACa;CACb,IAAI,iBAAiB,SAAS,iBAAiB,UAAU;EACvD,MAAM,SAAS,MAAM;EAErB,IAAI,CAAC,QAAQ,WACX,MAAM,IAAIC,gDAAsB;GAC9B,WAAW,GAAG,aAAa;GAC3B,iBAAiBC,yCAAkB,KAAK;EAC1C,CAAC;EAGH,OAAO,OAAO;CAChB;CAEA,MAAM,QAAQ,MAAM;CAEpB,IAAI,CAAC,OACH,MAAM,IAAID,gDAAsB;EAC9B,WAAW;EACX,iBAAiBC,yCAAkB,KAAK;CAC1C,CAAC;CAGH,OAAO;AACT;AAEA,SAAS,wBAGP,QACA,SACa;CACb,MAAM,EAAE,UAAU,WAAW,eAAe,gBAAgB;CAC5D,MAAM,gBAAgB,OAAO;CAE7B,IAAI,CAAC,eACH,MAAM,IAAIC,8CAAqB;EAC7B;EACA,gBAAgBC,0CAAuB,MAAiC;CAC1E,CAAC;CAGH,IAAI,QAAQ;CAEZ,IAAI,iBAAiB,WAAW,QAAQ,gBAAgB,QACtD,QAAQ,2BAA2B,OAAO,QAAQ,WAAW;CAG/D,OAAO,4BAA4B,OAAO,YAAY;AACxD;AAEA,SAAS,qBAEP,QAAsC,MAA2B;CACjE,IAAI,SAAkB;CAEtB,KAAK,MAAM,WAAW,KAAK,MAAM,GAAG,GAAG;EACrC,IAAI,CAAC,sBAAsB,MAAM,GAC/B,MAAM,IAAIC,sCAAiB;GACzB;GACA,QAAQ,IAAI,QAAQ;EACtB,CAAC;EAGH,MAAM,OAAiB,OAAmC;EAE1D,IAAI,SAAS,UAAa,SAAS,MACjC,MAAM,IAAIA,sCAAiB;GACzB;GACA,QAAQ,IAAI,QAAQ;EACtB,CAAC;EAGH,SAAS;CACX;CAEA,IAAI,sBAAsB,MAAM,KAAK,eAAe,QAClD,OAAO,4BAA4B,QAAQ,WAAW;CAGxD,OAAO;AACT;AAEA,SAAgB,mBAEd,QAA+D;CAG/D,SAAS,aACP,SACa;EACb,IAAI,OAAO,YAAY,UACrB,OAAO,qBAAqB,QAAQ,OAAO;EAG7C,OAAO,wBAAwB,QAAQ,OAAO;CAChD;CAEA,MAAM,eAAmD,UAAU;EACjE,QAAQ,YACN,wBAAwB,QAAQ;GAC9B,GAAG;GACH,GAAG;EACL,CAA8C;CAClD;CAEA,OAAO,OAAO,OAAO,cAAc,EAAE,YAAY,CAAC;AACpD;AAEA,SAAgB,qBAId,QAC0C;CAC1C,MAAM,eAAe;CAErB,IAAID,0CAAuB,YAAY,EAAE,WAAW,GAClD,MAAM,IAAIE,0CAAmB;EAC3B,QAAQ;EACR;CACF,CAAC;CAKH,OAAO;EACL;EACA,cAAc,mBAAmB,MAAM;EACvC,sBAAsB,SACpBC,yDACE,cACA,IACF;EACF,UAAUC,+BAAe,YAAY;EACrC,kBAAkBC,mDAChB,YACF;EACA,cAAcC,6CACZ,YACF;CACF;AACF"}

package/dist/create-config/get-component.d.cts

@@ -1,5 +1,9 @@
-import { LayoutResourceKey, ResourceDefinition, SubResourceDefinitionsFor, SubResourceParamForResource } from "../resource.cjs";
-import { ResourceConfigComponentKey, ResourceConfigInput, ResourceConfigMap } from "./types.cjs";
+import { LayoutResourceKey, ResourceDefinition, ResourceDefinitionForKey, SubResourceDefinitionsFor, SubResourceParamForResource } from "../resource.cjs";
+import { BaseResourceConfigComponents, ResourceConfigComponentKey, ResourceConfigInput, ResourceConfigMap, SharedResourceConfigOptions } from "./types.cjs";
+import { ConfigSubResourceKeys, ParameterizedResourcePath } from "./paths/types.cjs";
+import { CreateGetComponentForPath } from "./for-paths/get-component-for-path.cjs";
+import { ForPaths } from "./for-paths/builder.cjs";
+import { IsSubResourceKey } from "./is-sub-resource-key.cjs";
 import { JSX } from "react";
 
 //#region src/create-config/get-component.d.ts
@@ -21,6 +25,21 @@ type GetComponentOptionsForResource<Resources extends ReadonlyArray<ResourceDefi
 };
 /** Union of valid `getComponent` option shapes for each declared layout resource. */
 type GetComponentOptions<Resources extends ReadonlyArray<ResourceDefinition>> = LayoutResourceKey<Resources> extends infer Resource ? Resource extends LayoutResourceKey<Resources> ? GetComponentOptionsForResource<Resources, Resource> : never : never;
+type ComponentSlotPathKey = keyof BaseResourceConfigComponents;
+/** `detail.errorComponent`, `new.component`, … — component slots inside a shared branch. */
+type SharedBranchPath = { [Branch in keyof SharedResourceConfigOptions]: `${Branch}.${ComponentSlotPathKey}` }[keyof SharedResourceConfigOptions];
+type NestedSubResourceDefinitions<Def extends ResourceDefinition> = Def extends {
+  subResources: infer Nested extends ReadonlyArray<ResourceDefinition>;
+} ? Nested : readonly [];
+type SubResourceEntryPaths<SubDefs extends ReadonlyArray<ResourceDefinition>, DepthAcc extends readonly unknown[]> = LayoutResourceKey<SubDefs> extends infer Key extends string ? Key extends LayoutResourceKey<SubDefs> ? Key | `${Key}.${ResourceConfigEntryPath<NestedSubResourceDefinitions<ResourceDefinitionForKey<SubDefs, Key>>, readonly [...DepthAcc, unknown]>}` : never : never;
+/** Dot-separated keys below one config node: component slots and nested sub-resources. */
+type ResourceConfigEntryPath<SubDefs extends ReadonlyArray<ResourceDefinition>, DepthAcc extends readonly unknown[] = readonly []> = ComponentSlotPathKey | SharedBranchPath | ([SubDefs] extends [readonly []] ? never : DepthAcc['length'] extends 6 ? never : SubResourceEntryPaths<SubDefs, DepthAcc>);
+/**
+ * Deep config paths accepted by {@link GetComponent}, e.g.
+ * `'templates.deleted.expired.errorComponent'`. Sub-resource segments come from the
+ * layout tree, so only declared sub-resources are allowed at each depth.
+ */
+type ResourceConfigPath<Resources extends ReadonlyArray<ResourceDefinition>> = LayoutResourceKey<Resources> extends infer Resource extends string ? Resource extends LayoutResourceKey<Resources> ? Resource | `${Resource}.${ResourceConfigEntryPath<SubResourceDefinitionsFor<Resources, Resource>>}` : never : never;
 /** `subResource` bound by {@link GetComponentForResource}. */
 type SubResourceFromGetComponentBound<Bound> = Bound extends {
   subResource: infer SubResource;
@@ -49,14 +68,64 @@ type GetComponentForResource<Resources extends ReadonlyArray<ResourceDefinition>
   resource: LayoutResourceKey<Resources>;
 }>(bound: ValidateForResourceBound<Resources, Bound>) => GetComponentAtBound<Resources, ResourceFromGetComponentBound<Resources, Bound>, SubResourceFromGetComponentBound<Bound>>;
 interface GetComponent<Resources extends ReadonlyArray<ResourceDefinition>> {
+  /** Looks up a component by resource / optional sub-resource / optional component slot. */
   <const Options extends GetComponentOptions<Resources>>(options: Options): JSX.Element;
+  /**
+   * Looks up a component by a deep config path.
+   * A path ending on a branch (e.g. `'templates.deleted.expired'`) returns that branch's
+   * `component`; a path ending on a slot returns that slot.
+   */
+  <const Path extends ResourceConfigPath<Resources>>(path: Path): JSX.Element;
   forResource: GetComponentForResource<Resources>;
 }
-interface CreatedResourceConfig<Resources extends ReadonlyArray<ResourceDefinition>> {
-  config: ResourceConfigMap<Resources>;
+interface CreatedResourceConfig<Resources extends ReadonlyArray<ResourceDefinition>, Config extends ResourceConfigMap<Resources> = ResourceConfigMap<Resources>> {
+  config: Config;
   getComponent: GetComponent<Resources>;
+  /**
+   * Creates a reusable getter bound to one path. Variables the path leaves open become
+   * the getter's arguments.
+   *
+   * @example
+   * ```ts
+   * const getDetail = createGetComponent('$resource.detail.$component');
+   *
+   * getDetail({ resource: 'templates', component: 'errorComponent' });
+   * ```
+   */
+  createGetComponent: CreateGetComponentForPath<Resources, Config, ParameterizedResourcePath<Resources>>;
+  /**
+   * Builds a component for one or more paths. Declare which params the component takes,
+   * then render it.
+   *
+   * @example
+   * ```ts
+   * const ResourceDetail = forPaths('$resource.detail.$component')
+   *   .addPathParams()
+   *   .render(({ params, getComponentForPath }) =>
+   *     getComponentForPath('$resource.detail.$component')(params),
+   *   );
+   * ```
+   */
+  forPaths: ForPaths<Resources, Config, ParameterizedResourcePath<Resources>>;
+  /** Narrows an unknown value to a sub-resource key configured for a path or resource. */
+  isSubResourceKey: IsSubResourceKey<Resources, Config, ParameterizedResourcePath<Resources>>;
+  /** Every sub-resource key configured in this config, at any depth. */
+  subResources: ReadonlyArray<ConfigSubResourceKeys<Resources, Config>>;
 }
-type CreateResourceConfigFn<Resources extends ReadonlyArray<ResourceDefinition>> = <const Config extends ResourceConfigMap<Resources>>(config: ResourceConfigInput<Resources, Config>) => CreatedResourceConfig<Resources>;
+type ComponentTypesFromEntry<Entry> = Entry extends JSX.Element ? never : Entry extends object ? Extract<keyof Entry, ResourceConfigComponentKey> | { [Key in keyof Entry]: NonNullable<Entry[Key]> extends JSX.Element ? never : ComponentTypesFromEntry<NonNullable<Entry[Key]>> }[keyof Entry] : never;
+/**
+ * Component selector keys actually defined anywhere in a created resource config.
+ *
+ * @example
+ * ```ts
+ * ComponentTypes<typeof resourceConfig>
+ * // ^? may resolve to:`'component' | 'errorComponent' | 'detail'`.
+ * ```
+ */
+type ComponentTypes<Created> = Created extends {
+  config: infer Config extends object;
+} ? { [Resource in keyof Config]: ComponentTypesFromEntry<NonNullable<Config[Resource]>> }[keyof Config] : never;
+type CreateResourceConfigFn<Resources extends ReadonlyArray<ResourceDefinition>> = <const Config extends ResourceConfigMap<Resources>>(config: ResourceConfigInput<Resources, Config>) => CreatedResourceConfig<Resources, Config>;
 //#endregion
-export { CreateResourceConfigFn, CreatedResourceConfig, GetComponent, GetComponentAtBound, GetComponentForResource, GetComponentForResourceOptions, GetComponentOptions, GetComponentOptionsForResource, ResourceFromGetComponentBound, SubResourceFromGetComponentBound, ValidateForResourceBound };
+export { ComponentTypes, CreateResourceConfigFn, CreatedResourceConfig, GetComponent, GetComponentAtBound, GetComponentForResource, GetComponentForResourceOptions, GetComponentOptions, GetComponentOptionsForResource, ResourceConfigPath, ResourceFromGetComponentBound, SubResourceFromGetComponentBound, ValidateForResourceBound };
 //# sourceMappingURL=get-component.d.cts.map

package/dist/create-config/get-component.d.cts.map

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

package/dist/create-config/get-component.d.mts

@@ -1,5 +1,9 @@
-import { LayoutResourceKey, ResourceDefinition, SubResourceDefinitionsFor, SubResourceParamForResource } from "../resource.mjs";
-import { ResourceConfigComponentKey, ResourceConfigInput, ResourceConfigMap } from "./types.mjs";
+import { LayoutResourceKey, ResourceDefinition, ResourceDefinitionForKey, SubResourceDefinitionsFor, SubResourceParamForResource } from "../resource.mjs";
+import { BaseResourceConfigComponents, ResourceConfigComponentKey, ResourceConfigInput, ResourceConfigMap, SharedResourceConfigOptions } from "./types.mjs";
+import { ConfigSubResourceKeys, ParameterizedResourcePath } from "./paths/types.mjs";
+import { CreateGetComponentForPath } from "./for-paths/get-component-for-path.mjs";
+import { ForPaths } from "./for-paths/builder.mjs";
+import { IsSubResourceKey } from "./is-sub-resource-key.mjs";
 import { JSX } from "react";
 
 //#region src/create-config/get-component.d.ts
@@ -21,6 +25,21 @@ type GetComponentOptionsForResource<Resources extends ReadonlyArray<ResourceDefi
 };
 /** Union of valid `getComponent` option shapes for each declared layout resource. */
 type GetComponentOptions<Resources extends ReadonlyArray<ResourceDefinition>> = LayoutResourceKey<Resources> extends infer Resource ? Resource extends LayoutResourceKey<Resources> ? GetComponentOptionsForResource<Resources, Resource> : never : never;
+type ComponentSlotPathKey = keyof BaseResourceConfigComponents;
+/** `detail.errorComponent`, `new.component`, … — component slots inside a shared branch. */
+type SharedBranchPath = { [Branch in keyof SharedResourceConfigOptions]: `${Branch}.${ComponentSlotPathKey}` }[keyof SharedResourceConfigOptions];
+type NestedSubResourceDefinitions<Def extends ResourceDefinition> = Def extends {
+  subResources: infer Nested extends ReadonlyArray<ResourceDefinition>;
+} ? Nested : readonly [];
+type SubResourceEntryPaths<SubDefs extends ReadonlyArray<ResourceDefinition>, DepthAcc extends readonly unknown[]> = LayoutResourceKey<SubDefs> extends infer Key extends string ? Key extends LayoutResourceKey<SubDefs> ? Key | `${Key}.${ResourceConfigEntryPath<NestedSubResourceDefinitions<ResourceDefinitionForKey<SubDefs, Key>>, readonly [...DepthAcc, unknown]>}` : never : never;
+/** Dot-separated keys below one config node: component slots and nested sub-resources. */
+type ResourceConfigEntryPath<SubDefs extends ReadonlyArray<ResourceDefinition>, DepthAcc extends readonly unknown[] = readonly []> = ComponentSlotPathKey | SharedBranchPath | ([SubDefs] extends [readonly []] ? never : DepthAcc['length'] extends 6 ? never : SubResourceEntryPaths<SubDefs, DepthAcc>);
+/**
+ * Deep config paths accepted by {@link GetComponent}, e.g.
+ * `'templates.deleted.expired.errorComponent'`. Sub-resource segments come from the
+ * layout tree, so only declared sub-resources are allowed at each depth.
+ */
+type ResourceConfigPath<Resources extends ReadonlyArray<ResourceDefinition>> = LayoutResourceKey<Resources> extends infer Resource extends string ? Resource extends LayoutResourceKey<Resources> ? Resource | `${Resource}.${ResourceConfigEntryPath<SubResourceDefinitionsFor<Resources, Resource>>}` : never : never;
 /** `subResource` bound by {@link GetComponentForResource}. */
 type SubResourceFromGetComponentBound<Bound> = Bound extends {
   subResource: infer SubResource;
@@ -49,14 +68,64 @@ type GetComponentForResource<Resources extends ReadonlyArray<ResourceDefinition>
   resource: LayoutResourceKey<Resources>;
 }>(bound: ValidateForResourceBound<Resources, Bound>) => GetComponentAtBound<Resources, ResourceFromGetComponentBound<Resources, Bound>, SubResourceFromGetComponentBound<Bound>>;
 interface GetComponent<Resources extends ReadonlyArray<ResourceDefinition>> {
+  /** Looks up a component by resource / optional sub-resource / optional component slot. */
   <const Options extends GetComponentOptions<Resources>>(options: Options): JSX.Element;
+  /**
+   * Looks up a component by a deep config path.
+   * A path ending on a branch (e.g. `'templates.deleted.expired'`) returns that branch's
+   * `component`; a path ending on a slot returns that slot.
+   */
+  <const Path extends ResourceConfigPath<Resources>>(path: Path): JSX.Element;
   forResource: GetComponentForResource<Resources>;
 }
-interface CreatedResourceConfig<Resources extends ReadonlyArray<ResourceDefinition>> {
-  config: ResourceConfigMap<Resources>;
+interface CreatedResourceConfig<Resources extends ReadonlyArray<ResourceDefinition>, Config extends ResourceConfigMap<Resources> = ResourceConfigMap<Resources>> {
+  config: Config;
   getComponent: GetComponent<Resources>;
+  /**
+   * Creates a reusable getter bound to one path. Variables the path leaves open become
+   * the getter's arguments.
+   *
+   * @example
+   * ```ts
+   * const getDetail = createGetComponent('$resource.detail.$component');
+   *
+   * getDetail({ resource: 'templates', component: 'errorComponent' });
+   * ```
+   */
+  createGetComponent: CreateGetComponentForPath<Resources, Config, ParameterizedResourcePath<Resources>>;
+  /**
+   * Builds a component for one or more paths. Declare which params the component takes,
+   * then render it.
+   *
+   * @example
+   * ```ts
+   * const ResourceDetail = forPaths('$resource.detail.$component')
+   *   .addPathParams()
+   *   .render(({ params, getComponentForPath }) =>
+   *     getComponentForPath('$resource.detail.$component')(params),
+   *   );
+   * ```
+   */
+  forPaths: ForPaths<Resources, Config, ParameterizedResourcePath<Resources>>;
+  /** Narrows an unknown value to a sub-resource key configured for a path or resource. */
+  isSubResourceKey: IsSubResourceKey<Resources, Config, ParameterizedResourcePath<Resources>>;
+  /** Every sub-resource key configured in this config, at any depth. */
+  subResources: ReadonlyArray<ConfigSubResourceKeys<Resources, Config>>;
 }
-type CreateResourceConfigFn<Resources extends ReadonlyArray<ResourceDefinition>> = <const Config extends ResourceConfigMap<Resources>>(config: ResourceConfigInput<Resources, Config>) => CreatedResourceConfig<Resources>;
+type ComponentTypesFromEntry<Entry> = Entry extends JSX.Element ? never : Entry extends object ? Extract<keyof Entry, ResourceConfigComponentKey> | { [Key in keyof Entry]: NonNullable<Entry[Key]> extends JSX.Element ? never : ComponentTypesFromEntry<NonNullable<Entry[Key]>> }[keyof Entry] : never;
+/**
+ * Component selector keys actually defined anywhere in a created resource config.
+ *
+ * @example
+ * ```ts
+ * ComponentTypes<typeof resourceConfig>
+ * // ^? may resolve to:`'component' | 'errorComponent' | 'detail'`.
+ * ```
+ */
+type ComponentTypes<Created> = Created extends {
+  config: infer Config extends object;
+} ? { [Resource in keyof Config]: ComponentTypesFromEntry<NonNullable<Config[Resource]>> }[keyof Config] : never;
+type CreateResourceConfigFn<Resources extends ReadonlyArray<ResourceDefinition>> = <const Config extends ResourceConfigMap<Resources>>(config: ResourceConfigInput<Resources, Config>) => CreatedResourceConfig<Resources, Config>;
 //#endregion
-export { CreateResourceConfigFn, CreatedResourceConfig, GetComponent, GetComponentAtBound, GetComponentForResource, GetComponentForResourceOptions, GetComponentOptions, GetComponentOptionsForResource, ResourceFromGetComponentBound, SubResourceFromGetComponentBound, ValidateForResourceBound };
+export { ComponentTypes, CreateResourceConfigFn, CreatedResourceConfig, GetComponent, GetComponentAtBound, GetComponentForResource, GetComponentForResourceOptions, GetComponentOptions, GetComponentOptionsForResource, ResourceConfigPath, ResourceFromGetComponentBound, SubResourceFromGetComponentBound, ValidateForResourceBound };
 //# sourceMappingURL=get-component.d.mts.map

package/dist/create-config/get-component.d.mts.map

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

package/dist/create-config/get-component.mjs

@@ -1,34 +1,75 @@
+import { InvalidConfigError } from "../errors/invalid-config.mjs";
+import { InvalidPathError } from "../errors/invalid-path.mjs";
+import { InvalidResourceError } from "../errors/invalid-resource.mjs";
+import { InvalidSubResourceError } from "../errors/invalid-sub-resource.mjs";
+import { InvalidComponentError } from "../errors/invalid-component.mjs";
+import { readComponentKeys, readSubResourceKeys } from "./component-keys.mjs";
+import { collectAllSubResourceKeys, collectConfigResources } from "./paths/introspect.mjs";
+import { createGetComponentForPath } from "./for-paths/get-component-for-path.mjs";
+import { createForPaths } from "./for-paths/builder.mjs";
+import { createIsSubResourceKey } from "./is-sub-resource-key.mjs";
+
 //#region src/create-config/get-component.ts
+function isResourceConfigEntry(value) {
+	return typeof value === "object" && value !== null;
+}
 function resolveResourceConfigEntry(entry, subResource) {
-	if (typeof subResource === "string") {
-		const next = entry.subResources?.[subResource];
-		if (!next) throw new Error(`Sub-resource "${subResource}" is not configured`);
-		return next;
-	}
-	const next = entry.subResources?.[subResource.resource];
-	if (!next) throw new Error(`Sub-resource "${subResource.resource}" is not configured`);
+	const key = typeof subResource === "string" ? subResource : subResource.value;
+	const next = entry[key];
+	if (!isResourceConfigEntry(next)) throw new InvalidSubResourceError({
+		subResource: key,
+		validSubResources: readSubResourceKeys(entry)
+	});
+	if (typeof subResource === "string") return next;
 	return resolveResourceConfigEntry(next, subResource.subResource);
 }
 function readResourceConfigComponent(entry, componentKey) {
 	if (componentKey === "new" || componentKey === "detail") {
 		const branch = entry[componentKey];
-		if (!branch?.component) throw new Error(`Missing "${componentKey}.component" configuration`);
+		if (!branch?.component) throw new InvalidComponentError({
+			component: `${componentKey}.component`,
+			validComponents: readComponentKeys(entry)
+		});
 		return branch.component;
 	}
 	const value = entry[componentKey];
-	if (!value) throw new Error(`Missing "${componentKey}" configuration`);
+	if (!value) throw new InvalidComponentError({
+		component: componentKey,
+		validComponents: readComponentKeys(entry)
+	});
 	return value;
 }
 function getComponentFromOptions(config, options) {
 	const { resource, component: componentKey = "component" } = options;
 	const resourceEntry = config[resource];
-	if (!resourceEntry) throw new Error(`Resource "${resource}" is not configured`);
+	if (!resourceEntry) throw new InvalidResourceError({
+		resource,
+		validResources: collectConfigResources(config)
+	});
 	let entry = resourceEntry;
 	if ("subResource" in options && options.subResource !== void 0) entry = resolveResourceConfigEntry(entry, options.subResource);
 	return readResourceConfigComponent(entry, componentKey);
 }
+function getComponentFromPath(config, path) {
+	let cursor = config;
+	for (const segment of path.split(".")) {
+		if (!isResourceConfigEntry(cursor)) throw new InvalidPathError({
+			path,
+			reason: `"${segment}" cannot be read because the value before it is not a config branch`
+		});
+		const next = cursor[segment];
+		if (next === void 0 || next === null) throw new InvalidPathError({
+			path,
+			reason: `"${segment}" is not configured`
+		});
+		cursor = next;
+	}
+	if (isResourceConfigEntry(cursor) && "component" in cursor) return readResourceConfigComponent(cursor, "component");
+	return cursor;
+}
 function createGetComponent(config) {
 	function getComponent(options) {
+		if (typeof options === "string") return getComponentFromPath(config, options);
 		return getComponentFromOptions(config, options);
 	}
 	const forResource = (bound) => {
@@ -40,9 +81,18 @@ function createGetComponent(config) {
 	return Object.assign(getComponent, { forResource });
 }
 function createResourceConfig(config) {
+	const configRecord = config;
+	if (collectConfigResources(configRecord).length === 0) throw new InvalidConfigError({
+		reason: "A resource config must configure at least one resource",
+		config
+	});
 	return {
 		config,
-		getComponent: createGetComponent(config)
+		getComponent: createGetComponent(config),
+		createGetComponent: ((path) => createGetComponentForPath(configRecord, path)),
+		forPaths: createForPaths(configRecord),
+		isSubResourceKey: createIsSubResourceKey(configRecord),
+		subResources: collectAllSubResourceKeys(configRecord)
 	};
 }
 

package/dist/create-config/get-component.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"get-component.mjs","names":[],"sources":["../../src/create-config/get-component.ts"],"sourcesContent":["import type { JSX } from 'react';\nimport type {\n  LayoutResourceKey,\n  ResourceDefinition,\n  SubResourceDefinitionsFor,\n  SubResourceParamForResource,\n} from '../resource';\nimport type {\n  ResourceConfigComponentKey,\n  ResourceConfigComponents,\n  ResourceConfigEntry,\n  ResourceConfigMap,\n  ResourceConfigInput,\n} from './types';\n\ntype ResourceHasLayoutSubResources<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends LayoutResourceKey<Resources>,\n> = [SubResourceDefinitionsFor<Resources, Resource>] extends [readonly []]\n  ? false\n  : true;\n\ntype SubResourceOptionForGenerics<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends LayoutResourceKey<Resources>,\n  SubResource extends\n    | SubResourceParamForResource<Resources, Resource>\n    | undefined,\n> = [SubResource] extends [undefined]\n  ? ResourceHasLayoutSubResources<Resources, Resource> extends true\n    ? {\n        subResource?: SubResourceParamForResource<Resources, Resource>;\n      }\n    : {}\n  : ResourceHasLayoutSubResources<Resources, Resource> extends true\n    ? { subResource?: SubResource }\n    : {};\n\n/** Options for one layout resource passed to {@link GetComponent}. */\nexport type GetComponentOptionsForResource<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends LayoutResourceKey<Resources>,\n  SubResource extends\n    | SubResourceParamForResource<Resources, Resource>\n    | undefined = undefined,\n> = SubResourceOptionForGenerics<Resources, Resource, SubResource> & {\n  resource: Resource;\n  /**\n   * The component to get.\n   *\n   * @default 'component'\n   */\n  component?: ResourceConfigComponentKey;\n};\n\n/** Union of valid `getComponent` option shapes for each declared layout resource. */\nexport type GetComponentOptions<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> =\n  LayoutResourceKey<Resources> extends infer Resource\n    ? Resource extends LayoutResourceKey<Resources>\n      ? GetComponentOptionsForResource<Resources, Resource>\n      : never\n    : never;\n\n/** `subResource` bound by {@link GetComponentForResource}. */\nexport type SubResourceFromGetComponentBound<Bound> = Bound extends {\n  subResource: infer SubResource;\n}\n  ? SubResource\n  : undefined;\n\n/** Options for {@link GetComponentForResource} — binds `resource` and optional `subResource`. */\nexport type GetComponentForResourceOptions<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends LayoutResourceKey<Resources>,\n  SubResource extends\n    | SubResourceParamForResource<Resources, Resource>\n    | undefined = undefined,\n> = {\n  resource: Resource;\n} & SubResourceOptionForGenerics<Resources, Resource, SubResource>;\n\n/** Valid bind shapes for {@link GetComponentForResource}. */\nexport type GetComponentForResourceBound<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> =\n  LayoutResourceKey<Resources> extends infer Resource\n    ? Resource extends LayoutResourceKey<Resources>\n      ? GetComponentForResourceOptions<Resources, Resource>\n      : never\n    : never;\n\ntype GetComponentForResourceOptionsForBound<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Bound extends { resource: LayoutResourceKey<Resources> },\n> = GetComponentForResourceOptions<\n  Resources,\n  Bound['resource'],\n  SubResourceFromGetComponentBound<Bound>\n>;\n\n/**\n * Rejects bind objects with keys (e.g. `subResource`) that are invalid for the\n * given `resource`. Union assignability alone is too permissive for excess keys.\n */\nexport type ValidateForResourceBound<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Bound extends { resource: LayoutResourceKey<Resources> },\n> = Bound extends GetComponentForResourceOptionsForBound<Resources, Bound>\n  ? keyof Bound extends keyof GetComponentForResourceOptionsForBound<\n      Resources,\n      Bound\n    >\n    ? Bound\n    : never\n  : never;\n\n/** `resource` inferred from a {@link GetComponentForResource} bind argument. */\nexport type ResourceFromGetComponentBound<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Bound,\n> = Bound extends {\n  resource: infer Resource extends LayoutResourceKey<Resources>;\n}\n  ? Resource\n  : never;\n\n/** Reusable getter returned by {@link GetComponentForResource} (only `component` remains). */\nexport type GetComponentAtBound<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends LayoutResourceKey<Resources>,\n  SubResource extends\n    | SubResourceParamForResource<Resources, Resource>\n    | undefined = undefined,\n> = (\n  options?: Pick<\n    GetComponentOptionsForResource<Resources, Resource, SubResource>,\n    'component'\n  >,\n) => JSX.Element;\n\nexport type GetComponentForResource<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = <\n  const Bound extends {\n    resource: LayoutResourceKey<Resources>;\n  },\n>(\n  bound: ValidateForResourceBound<Resources, Bound>,\n) => GetComponentAtBound<\n  Resources,\n  ResourceFromGetComponentBound<Resources, Bound>,\n  SubResourceFromGetComponentBound<Bound>\n>;\n\nexport interface GetComponent<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> {\n  <const Options extends GetComponentOptions<Resources>>(\n    options: Options,\n  ): JSX.Element;\n  forResource: GetComponentForResource<Resources>;\n}\n\nexport interface CreatedResourceConfig<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> {\n  config: ResourceConfigMap<Resources>;\n  getComponent: GetComponent<Resources>;\n}\n\nexport type CreateResourceConfigFn<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = <const Config extends ResourceConfigMap<Resources>>(\n  config: ResourceConfigInput<Resources, Config>,\n) => CreatedResourceConfig<Resources>;\n\ntype SubResourceParam =\n  | string\n  | {\n      resource: string;\n      subResource: SubResourceParam;\n    };\n\nfunction resolveResourceConfigEntry(\n  entry: ResourceConfigEntry,\n  subResource: SubResourceParam,\n): ResourceConfigEntry {\n  if (typeof subResource === 'string') {\n    const next = entry.subResources?.[subResource];\n    if (!next) {\n      throw new Error(`Sub-resource \"${subResource}\" is not configured`);\n    }\n    return next;\n  }\n\n  const next = entry.subResources?.[subResource.resource];\n  if (!next) {\n    throw new Error(`Sub-resource \"${subResource.resource}\" is not configured`);\n  }\n\n  return resolveResourceConfigEntry(next, subResource.subResource);\n}\n\nfunction readResourceConfigComponent(\n  entry: ResourceConfigComponents,\n  componentKey: ResourceConfigComponentKey,\n): JSX.Element {\n  if (componentKey === 'new' || componentKey === 'detail') {\n    const branch = entry[componentKey];\n\n    if (!branch?.component) {\n      throw new Error(`Missing \"${componentKey}.component\" configuration`);\n    }\n\n    return branch.component;\n  }\n\n  const value = entry[componentKey];\n\n  if (!value) {\n    throw new Error(`Missing \"${componentKey}\" configuration`);\n  }\n\n  return value;\n}\n\nfunction getComponentFromOptions<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n>(\n  config: ResourceConfigMap<Resources>,\n  options: GetComponentOptions<Resources>,\n): JSX.Element {\n  const { resource, component: componentKey = 'component' } = options;\n  const resourceEntry = config[resource];\n\n  if (!resourceEntry) {\n    throw new Error(`Resource \"${resource}\" is not configured`);\n  }\n\n  let entry: ResourceConfigEntry = resourceEntry;\n\n  if ('subResource' in options && options.subResource !== undefined) {\n    entry = resolveResourceConfigEntry(entry, options.subResource);\n  }\n\n  return readResourceConfigComponent(entry, componentKey);\n}\n\nexport function createGetComponent<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n>(config: ResourceConfigMap<Resources>): GetComponent<Resources> {\n  function getComponent<const Options extends GetComponentOptions<Resources>>(\n    options: Options,\n  ) {\n    return getComponentFromOptions(config, options);\n  }\n\n  const forResource: GetComponentForResource<Resources> = (bound) => {\n    return (options) =>\n      getComponentFromOptions(config, {\n        ...bound,\n        ...options,\n      } as unknown as GetComponentOptions<Resources>);\n  };\n\n  return Object.assign(getComponent, { forResource });\n}\n\nexport function createResourceConfig<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n>(config: ResourceConfigMap<Resources>): CreatedResourceConfig<Resources> {\n  return {\n    config,\n    getComponent: createGetComponent(config),\n  };\n}\n"],"mappings":";AAyLA,SAAS,2BACP,OACA,aACqB;CACrB,IAAI,OAAO,gBAAgB,UAAU;EACnC,MAAM,OAAO,MAAM,eAAe;EAClC,IAAI,CAAC,MACH,MAAM,IAAI,MAAM,iBAAiB,YAAY,oBAAoB;EAEnE,OAAO;CACT;CAEA,MAAM,OAAO,MAAM,eAAe,YAAY;CAC9C,IAAI,CAAC,MACH,MAAM,IAAI,MAAM,iBAAiB,YAAY,SAAS,oBAAoB;CAG5E,OAAO,2BAA2B,MAAM,YAAY,WAAW;AACjE;AAEA,SAAS,4BACP,OACA,cACa;CACb,IAAI,iBAAiB,SAAS,iBAAiB,UAAU;EACvD,MAAM,SAAS,MAAM;EAErB,IAAI,CAAC,QAAQ,WACX,MAAM,IAAI,MAAM,YAAY,aAAa,0BAA0B;EAGrE,OAAO,OAAO;CAChB;CAEA,MAAM,QAAQ,MAAM;CAEpB,IAAI,CAAC,OACH,MAAM,IAAI,MAAM,YAAY,aAAa,gBAAgB;CAG3D,OAAO;AACT;AAEA,SAAS,wBAGP,QACA,SACa;CACb,MAAM,EAAE,UAAU,WAAW,eAAe,gBAAgB;CAC5D,MAAM,gBAAgB,OAAO;CAE7B,IAAI,CAAC,eACH,MAAM,IAAI,MAAM,aAAa,SAAS,oBAAoB;CAG5D,IAAI,QAA6B;CAEjC,IAAI,iBAAiB,WAAW,QAAQ,gBAAgB,QACtD,QAAQ,2BAA2B,OAAO,QAAQ,WAAW;CAG/D,OAAO,4BAA4B,OAAO,YAAY;AACxD;AAEA,SAAgB,mBAEd,QAA+D;CAC/D,SAAS,aACP,SACA;EACA,OAAO,wBAAwB,QAAQ,OAAO;CAChD;CAEA,MAAM,eAAmD,UAAU;EACjE,QAAQ,YACN,wBAAwB,QAAQ;GAC9B,GAAG;GACH,GAAG;EACL,CAA8C;CAClD;CAEA,OAAO,OAAO,OAAO,cAAc,EAAE,YAAY,CAAC;AACpD;AAEA,SAAgB,qBAEd,QAAwE;CACxE,OAAO;EACL;EACA,cAAc,mBAAmB,MAAM;CACzC;AACF"}
+{"version":3,"file":"get-component.mjs","names":[],"sources":["../../src/create-config/get-component.ts"],"sourcesContent":["import type { JSX } from 'react';\nimport {\n  InvalidComponentError,\n  InvalidConfigError,\n  InvalidPathError,\n  InvalidResourceError,\n  InvalidSubResourceError,\n} from '../errors';\nimport type {\n  LayoutResourceKey,\n  ResourceDefinition,\n  ResourceDefinitionForKey,\n  SubResourceDefinitionsFor,\n  SubResourceParamForResource,\n} from '../resource';\nimport {\n  createForPaths,\n  createGetComponentForPath,\n  type CreateGetComponentForPath,\n  type ForPaths,\n} from './for-paths';\nimport {\n  createIsSubResourceKey,\n  type IsSubResourceKey,\n} from './is-sub-resource-key';\nimport {\n  readComponentKeys,\n  readSubResourceKeys,\n} from './component-keys';\nimport {\n  collectAllSubResourceKeys,\n  collectConfigResources,\n} from './paths';\nimport type {\n  ConfigSubResourceKeys,\n  ParameterizedResourcePath,\n} from './paths';\nimport type {\n  BaseResourceConfigComponents,\n  ResourceConfigComponentKey,\n  ResourceConfigComponents,\n  ResourceConfigEntry,\n  ResourceConfigMap,\n  ResourceConfigInput,\n  SharedResourceConfigOptions,\n} from './types';\n\ntype ResourceHasLayoutSubResources<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends LayoutResourceKey<Resources>,\n> = [SubResourceDefinitionsFor<Resources, Resource>] extends [readonly []]\n  ? false\n  : true;\n\ntype SubResourceOptionForGenerics<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends LayoutResourceKey<Resources>,\n  SubResource extends\n    | SubResourceParamForResource<Resources, Resource>\n    | undefined,\n> = [SubResource] extends [undefined]\n  ? ResourceHasLayoutSubResources<Resources, Resource> extends true\n    ? {\n        subResource?: SubResourceParamForResource<Resources, Resource>;\n      }\n    : {}\n  : ResourceHasLayoutSubResources<Resources, Resource> extends true\n    ? { subResource?: SubResource }\n    : {};\n\n/** Options for one layout resource passed to {@link GetComponent}. */\nexport type GetComponentOptionsForResource<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends LayoutResourceKey<Resources>,\n  SubResource extends\n    | SubResourceParamForResource<Resources, Resource>\n    | undefined = undefined,\n> = SubResourceOptionForGenerics<Resources, Resource, SubResource> & {\n  resource: Resource;\n  /**\n   * The component to get.\n   *\n   * @default 'component'\n   */\n  component?: ResourceConfigComponentKey;\n};\n\n/** Union of valid `getComponent` option shapes for each declared layout resource. */\nexport type GetComponentOptions<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> =\n  LayoutResourceKey<Resources> extends infer Resource\n    ? Resource extends LayoutResourceKey<Resources>\n      ? GetComponentOptionsForResource<Resources, Resource>\n      : never\n    : never;\n\ntype ComponentSlotPathKey = keyof BaseResourceConfigComponents;\n\n/** `detail.errorComponent`, `new.component`, … — component slots inside a shared branch. */\ntype SharedBranchPath = {\n  [Branch in keyof SharedResourceConfigOptions]: `${Branch}.${ComponentSlotPathKey}`;\n}[keyof SharedResourceConfigOptions];\n\ntype NestedSubResourceDefinitions<Def extends ResourceDefinition> = Def extends {\n  subResources: infer Nested extends ReadonlyArray<ResourceDefinition>;\n}\n  ? Nested\n  : readonly [];\n\ntype SubResourceEntryPaths<\n  SubDefs extends ReadonlyArray<ResourceDefinition>,\n  DepthAcc extends readonly unknown[],\n> =\n  LayoutResourceKey<SubDefs> extends infer Key extends string\n    ? Key extends LayoutResourceKey<SubDefs>\n      ?\n          | Key\n          | `${Key}.${ResourceConfigEntryPath<\n              NestedSubResourceDefinitions<\n                ResourceDefinitionForKey<SubDefs, Key>\n              >,\n              readonly [...DepthAcc, unknown]\n            >}`\n      : never\n    : never;\n\n/** Dot-separated keys below one config node: component slots and nested sub-resources. */\ntype ResourceConfigEntryPath<\n  SubDefs extends ReadonlyArray<ResourceDefinition>,\n  DepthAcc extends readonly unknown[] = readonly [],\n> =\n  | ComponentSlotPathKey\n  | SharedBranchPath\n  | ([SubDefs] extends [readonly []]\n      ? never\n      : DepthAcc['length'] extends 6\n        ? never\n        : SubResourceEntryPaths<SubDefs, DepthAcc>);\n\n/**\n * Deep config paths accepted by {@link GetComponent}, e.g.\n * `'templates.deleted.expired.errorComponent'`. Sub-resource segments come from the\n * layout tree, so only declared sub-resources are allowed at each depth.\n */\nexport type ResourceConfigPath<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> =\n  LayoutResourceKey<Resources> extends infer Resource extends string\n    ? Resource extends LayoutResourceKey<Resources>\n      ?\n          | Resource\n          | `${Resource}.${ResourceConfigEntryPath<\n              SubResourceDefinitionsFor<Resources, Resource>\n            >}`\n      : never\n    : never;\n\n/** `subResource` bound by {@link GetComponentForResource}. */\nexport type SubResourceFromGetComponentBound<Bound> = Bound extends {\n  subResource: infer SubResource;\n}\n  ? SubResource\n  : undefined;\n\n/** Options for {@link GetComponentForResource} — binds `resource` and optional `subResource`. */\nexport type GetComponentForResourceOptions<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends LayoutResourceKey<Resources>,\n  SubResource extends\n    | SubResourceParamForResource<Resources, Resource>\n    | undefined = undefined,\n> = {\n  resource: Resource;\n} & SubResourceOptionForGenerics<Resources, Resource, SubResource>;\n\n/** Valid bind shapes for {@link GetComponentForResource}. */\nexport type GetComponentForResourceBound<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> =\n  LayoutResourceKey<Resources> extends infer Resource\n    ? Resource extends LayoutResourceKey<Resources>\n      ? GetComponentForResourceOptions<Resources, Resource>\n      : never\n    : never;\n\ntype GetComponentForResourceOptionsForBound<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Bound extends { resource: LayoutResourceKey<Resources> },\n> = GetComponentForResourceOptions<\n  Resources,\n  Bound['resource'],\n  SubResourceFromGetComponentBound<Bound>\n>;\n\n/**\n * Rejects bind objects with keys (e.g. `subResource`) that are invalid for the\n * given `resource`. Union assignability alone is too permissive for excess keys.\n */\nexport type ValidateForResourceBound<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Bound extends { resource: LayoutResourceKey<Resources> },\n> = Bound extends GetComponentForResourceOptionsForBound<Resources, Bound>\n  ? keyof Bound extends keyof GetComponentForResourceOptionsForBound<\n      Resources,\n      Bound\n    >\n    ? Bound\n    : never\n  : never;\n\n/** `resource` inferred from a {@link GetComponentForResource} bind argument. */\nexport type ResourceFromGetComponentBound<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Bound,\n> = Bound extends {\n  resource: infer Resource extends LayoutResourceKey<Resources>;\n}\n  ? Resource\n  : never;\n\n/** Reusable getter returned by {@link GetComponentForResource} (only `component` remains). */\nexport type GetComponentAtBound<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Resource extends LayoutResourceKey<Resources>,\n  SubResource extends\n    | SubResourceParamForResource<Resources, Resource>\n    | undefined = undefined,\n> = (\n  options?: Pick<\n    GetComponentOptionsForResource<Resources, Resource, SubResource>,\n    'component'\n  >,\n) => JSX.Element;\n\nexport type GetComponentForResource<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = <\n  const Bound extends {\n    resource: LayoutResourceKey<Resources>;\n  },\n>(\n  bound: ValidateForResourceBound<Resources, Bound>,\n) => GetComponentAtBound<\n  Resources,\n  ResourceFromGetComponentBound<Resources, Bound>,\n  SubResourceFromGetComponentBound<Bound>\n>;\n\nexport interface GetComponent<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> {\n  /** Looks up a component by resource / optional sub-resource / optional component slot. */\n  <const Options extends GetComponentOptions<Resources>>(\n    options: Options,\n  ): JSX.Element;\n  /**\n   * Looks up a component by a deep config path.\n   * A path ending on a branch (e.g. `'templates.deleted.expired'`) returns that branch's\n   * `component`; a path ending on a slot returns that slot.\n   */\n  <const Path extends ResourceConfigPath<Resources>>(path: Path): JSX.Element;\n  forResource: GetComponentForResource<Resources>;\n}\n\nexport interface CreatedResourceConfig<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Config extends ResourceConfigMap<Resources> = ResourceConfigMap<Resources>,\n> {\n  config: Config;\n  getComponent: GetComponent<Resources>;\n  /**\n   * Creates a reusable getter bound to one path. Variables the path leaves open become\n   * the getter's arguments.\n   *\n   * @example\n   * ```ts\n   * const getDetail = createGetComponent('$resource.detail.$component');\n   *\n   * getDetail({ resource: 'templates', component: 'errorComponent' });\n   * ```\n   */\n  createGetComponent: CreateGetComponentForPath<\n    Resources,\n    Config,\n    ParameterizedResourcePath<Resources>\n  >;\n  /**\n   * Builds a component for one or more paths. Declare which params the component takes,\n   * then render it.\n   *\n   * @example\n   * ```ts\n   * const ResourceDetail = forPaths('$resource.detail.$component')\n   *   .addPathParams()\n   *   .render(({ params, getComponentForPath }) =>\n   *     getComponentForPath('$resource.detail.$component')(params),\n   *   );\n   * ```\n   */\n  forPaths: ForPaths<\n    Resources,\n    Config,\n    ParameterizedResourcePath<Resources>\n  >;\n  /** Narrows an unknown value to a sub-resource key configured for a path or resource. */\n  isSubResourceKey: IsSubResourceKey<\n    Resources,\n    Config,\n    ParameterizedResourcePath<Resources>\n  >;\n  /** Every sub-resource key configured in this config, at any depth. */\n  subResources: ReadonlyArray<ConfigSubResourceKeys<Resources, Config>>;\n}\n\ntype ComponentTypesFromEntry<Entry> = Entry extends JSX.Element\n  ? never\n  : Entry extends object\n    ?\n        | Extract<keyof Entry, ResourceConfigComponentKey>\n        | {\n            [Key in keyof Entry]: NonNullable<Entry[Key]> extends JSX.Element\n              ? never\n              : ComponentTypesFromEntry<NonNullable<Entry[Key]>>;\n          }[keyof Entry]\n    : never;\n\n/**\n * Component selector keys actually defined anywhere in a created resource config.\n *\n * @example\n * ```ts\n * ComponentTypes<typeof resourceConfig>\n * // ^? may resolve to:`'component' | 'errorComponent' | 'detail'`.\n * ```\n */\nexport type ComponentTypes<Created> = Created extends {\n  config: infer Config extends object;\n}\n  ? {\n      [Resource in keyof Config]: ComponentTypesFromEntry<\n        NonNullable<Config[Resource]>\n      >;\n    }[keyof Config]\n  : never;\n\nexport type CreateResourceConfigFn<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = <const Config extends ResourceConfigMap<Resources>>(\n  config: ResourceConfigInput<Resources, Config>,\n) => CreatedResourceConfig<Resources, Config>;\n\ntype SubResourceParam =\n  | string\n  | {\n      value: string;\n      subResource: SubResourceParam;\n    };\n\nfunction isResourceConfigEntry(value: unknown): value is ResourceConfigEntry {\n  return typeof value === 'object' && value !== null;\n}\n\nfunction resolveResourceConfigEntry(\n  entry: ResourceConfigEntry,\n  subResource: SubResourceParam,\n): ResourceConfigEntry {\n  const key = typeof subResource === 'string' ? subResource : subResource.value;\n  const next = entry[key];\n\n  if (!isResourceConfigEntry(next)) {\n    throw new InvalidSubResourceError({\n      subResource: key,\n      validSubResources: readSubResourceKeys(entry),\n    });\n  }\n\n  if (typeof subResource === 'string') {\n    return next;\n  }\n\n  return resolveResourceConfigEntry(next, subResource.subResource);\n}\n\nfunction readResourceConfigComponent(\n  entry: ResourceConfigComponents,\n  componentKey: ResourceConfigComponentKey,\n): JSX.Element {\n  if (componentKey === 'new' || componentKey === 'detail') {\n    const branch = entry[componentKey];\n\n    if (!branch?.component) {\n      throw new InvalidComponentError({\n        component: `${componentKey}.component`,\n        validComponents: readComponentKeys(entry),\n      });\n    }\n\n    return branch.component;\n  }\n\n  const value = entry[componentKey];\n\n  if (!value) {\n    throw new InvalidComponentError({\n      component: componentKey,\n      validComponents: readComponentKeys(entry),\n    });\n  }\n\n  return value;\n}\n\nfunction getComponentFromOptions<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n>(\n  config: ResourceConfigMap<Resources>,\n  options: GetComponentOptions<Resources>,\n): JSX.Element {\n  const { resource, component: componentKey = 'component' } = options;\n  const resourceEntry = config[resource];\n\n  if (!resourceEntry) {\n    throw new InvalidResourceError({\n      resource,\n      validResources: collectConfigResources(config as Record<string, unknown>),\n    });\n  }\n\n  let entry = resourceEntry as ResourceConfigEntry;\n\n  if ('subResource' in options && options.subResource !== undefined) {\n    entry = resolveResourceConfigEntry(entry, options.subResource);\n  }\n\n  return readResourceConfigComponent(entry, componentKey);\n}\n\nfunction getComponentFromPath<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n>(config: ResourceConfigMap<Resources>, path: string): JSX.Element {\n  let cursor: unknown = config;\n\n  for (const segment of path.split('.')) {\n    if (!isResourceConfigEntry(cursor)) {\n      throw new InvalidPathError({\n        path,\n        reason: `\"${segment}\" cannot be read because the value before it is not a config branch`,\n      });\n    }\n\n    const next: unknown = (cursor as Record<string, unknown>)[segment];\n\n    if (next === undefined || next === null) {\n      throw new InvalidPathError({\n        path,\n        reason: `\"${segment}\" is not configured`,\n      });\n    }\n\n    cursor = next;\n  }\n\n  if (isResourceConfigEntry(cursor) && 'component' in cursor) {\n    return readResourceConfigComponent(cursor, 'component');\n  }\n\n  return cursor as JSX.Element;\n}\n\nexport function createGetComponent<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n>(config: ResourceConfigMap<Resources>): GetComponent<Resources> {\n  function getComponent(options: GetComponentOptions<Resources>): JSX.Element;\n  function getComponent(path: ResourceConfigPath<Resources>): JSX.Element;\n  function getComponent(\n    options: GetComponentOptions<Resources> | ResourceConfigPath<Resources>,\n  ): JSX.Element {\n    if (typeof options === 'string') {\n      return getComponentFromPath(config, options);\n    }\n\n    return getComponentFromOptions(config, options);\n  }\n\n  const forResource: GetComponentForResource<Resources> = (bound) => {\n    return (options) =>\n      getComponentFromOptions(config, {\n        ...bound,\n        ...options,\n      } as unknown as GetComponentOptions<Resources>);\n  };\n\n  return Object.assign(getComponent, { forResource });\n}\n\nexport function createResourceConfig<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  const Config extends ResourceConfigMap<Resources>,\n>(\n  config: ResourceConfigInput<Resources, Config>,\n): CreatedResourceConfig<Resources, Config> {\n  const configRecord = config as Record<string, unknown>;\n\n  if (collectConfigResources(configRecord).length === 0) {\n    throw new InvalidConfigError({\n      reason: 'A resource config must configure at least one resource',\n      config,\n    });\n  }\n\n  type Created = CreatedResourceConfig<Resources, Config>;\n\n  return {\n    config,\n    getComponent: createGetComponent(config),\n    createGetComponent: ((path: string) =>\n      createGetComponentForPath(\n        configRecord,\n        path,\n      )) as unknown as Created['createGetComponent'],\n    forPaths: createForPaths(configRecord) as unknown as Created['forPaths'],\n    isSubResourceKey: createIsSubResourceKey(\n      configRecord,\n    ) as unknown as Created['isSubResourceKey'],\n    subResources: collectAllSubResourceKeys(\n      configRecord,\n    ) as unknown as Created['subResources'],\n  };\n}\n"],"mappings":";;;;;;;;;;;;AAuWA,SAAS,sBAAsB,OAA8C;CAC3E,OAAO,OAAO,UAAU,YAAY,UAAU;AAChD;AAEA,SAAS,2BACP,OACA,aACqB;CACrB,MAAM,MAAM,OAAO,gBAAgB,WAAW,cAAc,YAAY;CACxE,MAAM,OAAO,MAAM;CAEnB,IAAI,CAAC,sBAAsB,IAAI,GAC7B,MAAM,IAAI,wBAAwB;EAChC,aAAa;EACb,mBAAmB,oBAAoB,KAAK;CAC9C,CAAC;CAGH,IAAI,OAAO,gBAAgB,UACzB,OAAO;CAGT,OAAO,2BAA2B,MAAM,YAAY,WAAW;AACjE;AAEA,SAAS,4BACP,OACA,cACa;CACb,IAAI,iBAAiB,SAAS,iBAAiB,UAAU;EACvD,MAAM,SAAS,MAAM;EAErB,IAAI,CAAC,QAAQ,WACX,MAAM,IAAI,sBAAsB;GAC9B,WAAW,GAAG,aAAa;GAC3B,iBAAiB,kBAAkB,KAAK;EAC1C,CAAC;EAGH,OAAO,OAAO;CAChB;CAEA,MAAM,QAAQ,MAAM;CAEpB,IAAI,CAAC,OACH,MAAM,IAAI,sBAAsB;EAC9B,WAAW;EACX,iBAAiB,kBAAkB,KAAK;CAC1C,CAAC;CAGH,OAAO;AACT;AAEA,SAAS,wBAGP,QACA,SACa;CACb,MAAM,EAAE,UAAU,WAAW,eAAe,gBAAgB;CAC5D,MAAM,gBAAgB,OAAO;CAE7B,IAAI,CAAC,eACH,MAAM,IAAI,qBAAqB;EAC7B;EACA,gBAAgB,uBAAuB,MAAiC;CAC1E,CAAC;CAGH,IAAI,QAAQ;CAEZ,IAAI,iBAAiB,WAAW,QAAQ,gBAAgB,QACtD,QAAQ,2BAA2B,OAAO,QAAQ,WAAW;CAG/D,OAAO,4BAA4B,OAAO,YAAY;AACxD;AAEA,SAAS,qBAEP,QAAsC,MAA2B;CACjE,IAAI,SAAkB;CAEtB,KAAK,MAAM,WAAW,KAAK,MAAM,GAAG,GAAG;EACrC,IAAI,CAAC,sBAAsB,MAAM,GAC/B,MAAM,IAAI,iBAAiB;GACzB;GACA,QAAQ,IAAI,QAAQ;EACtB,CAAC;EAGH,MAAM,OAAiB,OAAmC;EAE1D,IAAI,SAAS,UAAa,SAAS,MACjC,MAAM,IAAI,iBAAiB;GACzB;GACA,QAAQ,IAAI,QAAQ;EACtB,CAAC;EAGH,SAAS;CACX;CAEA,IAAI,sBAAsB,MAAM,KAAK,eAAe,QAClD,OAAO,4BAA4B,QAAQ,WAAW;CAGxD,OAAO;AACT;AAEA,SAAgB,mBAEd,QAA+D;CAG/D,SAAS,aACP,SACa;EACb,IAAI,OAAO,YAAY,UACrB,OAAO,qBAAqB,QAAQ,OAAO;EAG7C,OAAO,wBAAwB,QAAQ,OAAO;CAChD;CAEA,MAAM,eAAmD,UAAU;EACjE,QAAQ,YACN,wBAAwB,QAAQ;GAC9B,GAAG;GACH,GAAG;EACL,CAA8C;CAClD;CAEA,OAAO,OAAO,OAAO,cAAc,EAAE,YAAY,CAAC;AACpD;AAEA,SAAgB,qBAId,QAC0C;CAC1C,MAAM,eAAe;CAErB,IAAI,uBAAuB,YAAY,EAAE,WAAW,GAClD,MAAM,IAAI,mBAAmB;EAC3B,QAAQ;EACR;CACF,CAAC;CAKH,OAAO;EACL;EACA,cAAc,mBAAmB,MAAM;EACvC,sBAAsB,SACpB,0BACE,cACA,IACF;EACF,UAAU,eAAe,YAAY;EACrC,kBAAkB,uBAChB,YACF;EACA,cAAc,0BACZ,YACF;CACF;AACF"}

package/dist/create-config/index.d.cts

@@ -1,4 +1,9 @@
 import { BaseResourceConfigComponents, ResourceConfig, ResourceConfigComponentKey, ResourceConfigComponents, ResourceConfigInput, ResourceConfigMap, SharedResourceConfigOptions, SubResourceConfig, SubResourceConfigComponentsFor } from "./types.cjs";
-import { CreateResourceConfigFn, CreatedResourceConfig, GetComponent, GetComponentAtBound, GetComponentForResource, GetComponentForResourceOptions, GetComponentOptions, GetComponentOptionsForResource, ResourceFromGetComponentBound, SubResourceFromGetComponentBound, ValidateForResourceBound } from "./get-component.cjs";
+import { ComponentPathVariable, ExtractPathVariables, PATH_VARIABLE_IDENTIFIER, PathHasVariables, PathVariable, ResourcePathVariable, SubResourcePathVariable } from "./paths/variables.cjs";
+import { ConfigResourceKeys, ConfigSubResourceKeys, ParameterizedEntryPath, ParameterizedResourcePath, PathComponentKeys, PathResourceCandidates, PathSubResourceKeys, PathVariables, PathVariablesForResource, ResolveParameterizedPathValue, ResourceSubResourceKeys } from "./paths/types.cjs";
+import { CreateGetComponentForPath, GetComponentForPath, GetComponentForPathApi, PathValueComponentGetter, PathVariableGuards, ResolvedPathValue } from "./for-paths/get-component-for-path.cjs";
+import { ForPaths, ForPathsRenderContext, RenderedPathComponent, RenderedPathComponentHOF, TargetPathBuilder } from "./for-paths/builder.cjs";
+import { IsSubResourceKey, IsSubResourceKeyOptions, IsSubResourceKeyResult } from "./is-sub-resource-key.cjs";
+import { ComponentTypes, CreateResourceConfigFn, CreatedResourceConfig, GetComponent, GetComponentAtBound, GetComponentForResource, GetComponentForResourceOptions, GetComponentOptions, GetComponentOptionsForResource, ResourceConfigPath, ResourceFromGetComponentBound, SubResourceFromGetComponentBound, ValidateForResourceBound } from "./get-component.cjs";
 import { CreateResourceLinkConfig, CreateResourceLinkGroupInput, CreateResourceLinkGroupOptions, CreateResourceLinkOptions, CreateResourceLinksFn, CreateResourceLinksWithGroups, CreateResourceLinksWithGroupsFn, CreatedResourceHref, CreatedResourceLink, CreatedResourceLinkBase, InferHashFromResourceLinkHref, ResourceAnchorLinkFn, ResourceLinkHref } from "./create-resource-links.cjs";
 import { CreateResourceLayoutFn, CreateResourceLayoutMakeComposableOptions, DefineResourceLayout, DefineResourceLayoutFn, DefineResourceLayoutForResources, DefineResourceLayoutForResourcesFactory, defineResourceLayout } from "./define-layout.cjs";