@jfdevelops/react-layout 0.17.5 → 0.18.0

package/dist/create-config/paths/resolve.cjs

@@ -0,0 +1,130 @@
+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_missing_path_variable = require('../../errors/missing-path-variable.cjs');
+const require_component_keys = require('../component-keys.cjs');
+const require_variables = require('./variables.cjs');
+
+//#region src/create-config/paths/resolve.ts
+function readSubResourceParamKey(param) {
+	return typeof param === "string" ? param : param.value;
+}
+/** Sub-resource slugs a param walks through, outermost first. */
+function flattenSubResourceParam(param) {
+	if (typeof param === "string") return [param];
+	return [param.value, ...flattenSubResourceParam(param.subResource)];
+}
+function isSubResourceParamValue(value) {
+	if (typeof value === "string") return value.length > 0;
+	if (typeof value !== "object" || value === null) return false;
+	const { value: slug, subResource } = value;
+	return typeof slug === "string" && isSubResourceParamValue(subResource);
+}
+function resolveSubResourceParam(node, param, resource) {
+	const key = readSubResourceParamKey(param);
+	if (!require_component_keys.isConfigNode(node)) throw new require_invalid_sub_resource.InvalidSubResourceError({
+		subResource: key,
+		resource,
+		reason: `"${key}" cannot be read because its parent is not a configured resource`
+	});
+	const next = node[key];
+	if (!require_component_keys.isConfigNode(next)) throw new require_invalid_sub_resource.InvalidSubResourceError({
+		subResource: key,
+		resource,
+		validSubResources: require_component_keys.readSubResourceKeys(node)
+	});
+	if (typeof param === "string") return next;
+	return resolveSubResourceParam(next, param.subResource, resource);
+}
+function readVariable(variables, name, path) {
+	const value = variables[name];
+	if (value === void 0) throw new require_missing_path_variable.MissingPathVariableError({
+		variable: name,
+		path,
+		providedVariables: Object.keys(variables)
+	});
+	return value;
+}
+/**
+* Reads the value a path points at, substituting variable segments from `variables`.
+* Throws a typed error naming the segment that could not be resolved.
+*/
+function resolveParameterizedPath(config, path, variables = {}) {
+	const segments = path.split(".");
+	let cursor = config;
+	let resource;
+	for (const [index, segment] of segments.entries()) {
+		const isRoot = index === 0;
+		const variableName = require_variables.readPathVariableName(segment);
+		if (variableName === void 0) {
+			if (!require_component_keys.isConfigNode(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) {
+				if (isRoot) throw new require_invalid_resource.InvalidResourceError({
+					resource: segment,
+					validResources: Object.keys(config)
+				});
+				throw new require_invalid_path.InvalidPathError({
+					path,
+					reason: `"${segment}" is not configured`
+				});
+			}
+			if (isRoot) resource = segment;
+			cursor = next;
+			continue;
+		}
+		switch (variableName) {
+			case "resource": {
+				const value = readVariable(variables, "resource", path);
+				if (typeof value !== "string" || !require_component_keys.isConfigNode(config[value])) throw new require_invalid_resource.InvalidResourceError({
+					resource: value,
+					validResources: Object.keys(config)
+				});
+				resource = value;
+				cursor = config[value];
+				break;
+			}
+			case "subResource": {
+				const value = readVariable(variables, "subResource", path);
+				if (!isSubResourceParamValue(value)) throw new require_invalid_sub_resource.InvalidSubResourceError({
+					subResource: value,
+					resource,
+					reason: "A sub-resource must be a slug or an object with `value` and `subResource`"
+				});
+				cursor = resolveSubResourceParam(cursor, value, resource);
+				break;
+			}
+			case "component": {
+				const value = readVariable(variables, "component", path);
+				if (!require_component_keys.isConfigNode(cursor)) throw new require_invalid_component.InvalidComponentError({
+					component: value,
+					path,
+					resource,
+					reason: `"${String(value)}" cannot be read because the value before it is not a config branch`
+				});
+				if (typeof value !== "string" || cursor[value] === void 0) throw new require_invalid_component.InvalidComponentError({
+					component: value,
+					path,
+					resource,
+					validComponents: require_component_keys.readComponentKeys(cursor)
+				});
+				cursor = cursor[value];
+				break;
+			}
+			default: throw new require_invalid_path.InvalidPathError({
+				path,
+				reason: `"${segment}" is not a supported path variable`
+			});
+		}
+	}
+	return cursor;
+}
+
+//#endregion
+exports.flattenSubResourceParam = flattenSubResourceParam;
+exports.resolveParameterizedPath = resolveParameterizedPath;
+//# sourceMappingURL=resolve.cjs.map

package/dist/create-config/paths/resolve.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.cjs","names":["isConfigNode","InvalidSubResourceError","readSubResourceKeys","MissingPathVariableError","readPathVariableName","InvalidPathError","InvalidResourceError","InvalidComponentError","readComponentKeys"],"sources":["../../../src/create-config/paths/resolve.ts"],"sourcesContent":["import {\n  InvalidComponentError,\n  InvalidPathError,\n  InvalidResourceError,\n  InvalidSubResourceError,\n  MissingPathVariableError,\n} from '../../errors';\nimport {\n  isConfigNode,\n  readComponentKeys,\n  readSubResourceKeys,\n} from '../component-keys';\nimport { readPathVariableName } from './variables';\n\n/** A `$subResource` value: a slug, or a slug plus the next `subResource` below it. */\nexport type SubResourceParamValue =\n  | string\n  | { value: string; subResource: SubResourceParamValue };\n\n/** Values supplied for the variables a path leaves open. */\nexport type PathVariableValues = {\n  resource?: string;\n  subResource?: SubResourceParamValue;\n  component?: string;\n};\n\nfunction readSubResourceParamKey(param: SubResourceParamValue): string {\n  return typeof param === 'string' ? param : param.value;\n}\n\n/** Sub-resource slugs a param walks through, outermost first. */\nexport function flattenSubResourceParam(\n  param: SubResourceParamValue,\n): string[] {\n  if (typeof param === 'string') {\n    return [param];\n  }\n\n  return [param.value, ...flattenSubResourceParam(param.subResource)];\n}\n\nfunction isSubResourceParamValue(\n  value: unknown,\n): value is SubResourceParamValue {\n  if (typeof value === 'string') {\n    return value.length > 0;\n  }\n\n  if (typeof value !== 'object' || value === null) {\n    return false;\n  }\n\n  const { value: slug, subResource } = value as {\n    value?: unknown;\n    subResource?: unknown;\n  };\n\n  return typeof slug === 'string' && isSubResourceParamValue(subResource);\n}\n\nfunction resolveSubResourceParam(\n  node: unknown,\n  param: SubResourceParamValue,\n  resource: string | undefined,\n): unknown {\n  const key = readSubResourceParamKey(param);\n\n  if (!isConfigNode(node)) {\n    throw new InvalidSubResourceError({\n      subResource: key,\n      resource,\n      reason: `\"${key}\" cannot be read because its parent is not a configured resource`,\n    });\n  }\n\n  const next = node[key];\n\n  if (!isConfigNode(next)) {\n    throw new InvalidSubResourceError({\n      subResource: key,\n      resource,\n      validSubResources: readSubResourceKeys(node),\n    });\n  }\n\n  if (typeof param === 'string') {\n    return next;\n  }\n\n  return resolveSubResourceParam(next, param.subResource, resource);\n}\n\nfunction readVariable<Name extends keyof PathVariableValues>(\n  variables: PathVariableValues,\n  name: Name,\n  path: string,\n): NonNullable<PathVariableValues[Name]> {\n  const value = variables[name];\n\n  if (value === undefined) {\n    throw new MissingPathVariableError({\n      variable: name,\n      path,\n      providedVariables: Object.keys(variables),\n    });\n  }\n\n  return value as NonNullable<PathVariableValues[Name]>;\n}\n\n/**\n * Reads the value a path points at, substituting variable segments from `variables`.\n * Throws a typed error naming the segment that could not be resolved.\n */\nexport function resolveParameterizedPath(\n  config: Record<string, unknown>,\n  path: string,\n  variables: PathVariableValues = {},\n): unknown {\n  const segments = path.split('.');\n  let cursor: unknown = config;\n  let resource: string | undefined;\n\n  for (const [index, segment] of segments.entries()) {\n    const isRoot = index === 0;\n    const variableName = readPathVariableName(segment);\n\n    if (variableName === undefined) {\n      if (!isConfigNode(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 = cursor[segment];\n\n      if (next === undefined) {\n        if (isRoot) {\n          throw new InvalidResourceError({\n            resource: segment,\n            validResources: Object.keys(config),\n          });\n        }\n\n        throw new InvalidPathError({\n          path,\n          reason: `\"${segment}\" is not configured`,\n        });\n      }\n\n      if (isRoot) {\n        resource = segment;\n      }\n\n      cursor = next;\n      continue;\n    }\n\n    switch (variableName) {\n      case 'resource': {\n        const value = readVariable(variables, 'resource', path);\n\n        if (typeof value !== 'string' || !isConfigNode(config[value])) {\n          throw new InvalidResourceError({\n            resource: value,\n            validResources: Object.keys(config),\n          });\n        }\n\n        resource = value;\n        cursor = config[value];\n        break;\n      }\n      case 'subResource': {\n        const value = readVariable(variables, 'subResource', path);\n\n        if (!isSubResourceParamValue(value)) {\n          throw new InvalidSubResourceError({\n            subResource: value,\n            resource,\n            reason:\n              'A sub-resource must be a slug or an object with `value` and `subResource`',\n          });\n        }\n\n        cursor = resolveSubResourceParam(cursor, value, resource);\n        break;\n      }\n      case 'component': {\n        const value = readVariable(variables, 'component', path);\n\n        if (!isConfigNode(cursor)) {\n          throw new InvalidComponentError({\n            component: value,\n            path,\n            resource,\n            reason: `\"${String(value)}\" cannot be read because the value before it is not a config branch`,\n          });\n        }\n\n        if (typeof value !== 'string' || cursor[value] === undefined) {\n          throw new InvalidComponentError({\n            component: value,\n            path,\n            resource,\n            validComponents: readComponentKeys(cursor),\n          });\n        }\n\n        cursor = cursor[value];\n        break;\n      }\n      default: {\n        throw new InvalidPathError({\n          path,\n          reason: `\"${segment}\" is not a supported path variable`,\n        });\n      }\n    }\n  }\n\n  return cursor;\n}\n"],"mappings":";;;;;;;;;AA0BA,SAAS,wBAAwB,OAAsC;CACrE,OAAO,OAAO,UAAU,WAAW,QAAQ,MAAM;AACnD;;AAGA,SAAgB,wBACd,OACU;CACV,IAAI,OAAO,UAAU,UACnB,OAAO,CAAC,KAAK;CAGf,OAAO,CAAC,MAAM,OAAO,GAAG,wBAAwB,MAAM,WAAW,CAAC;AACpE;AAEA,SAAS,wBACP,OACgC;CAChC,IAAI,OAAO,UAAU,UACnB,OAAO,MAAM,SAAS;CAGxB,IAAI,OAAO,UAAU,YAAY,UAAU,MACzC,OAAO;CAGT,MAAM,EAAE,OAAO,MAAM,gBAAgB;CAKrC,OAAO,OAAO,SAAS,YAAY,wBAAwB,WAAW;AACxE;AAEA,SAAS,wBACP,MACA,OACA,UACS;CACT,MAAM,MAAM,wBAAwB,KAAK;CAEzC,IAAI,CAACA,oCAAa,IAAI,GACpB,MAAM,IAAIC,qDAAwB;EAChC,aAAa;EACb;EACA,QAAQ,IAAI,IAAI;CAClB,CAAC;CAGH,MAAM,OAAO,KAAK;CAElB,IAAI,CAACD,oCAAa,IAAI,GACpB,MAAM,IAAIC,qDAAwB;EAChC,aAAa;EACb;EACA,mBAAmBC,2CAAoB,IAAI;CAC7C,CAAC;CAGH,IAAI,OAAO,UAAU,UACnB,OAAO;CAGT,OAAO,wBAAwB,MAAM,MAAM,aAAa,QAAQ;AAClE;AAEA,SAAS,aACP,WACA,MACA,MACuC;CACvC,MAAM,QAAQ,UAAU;CAExB,IAAI,UAAU,QACZ,MAAM,IAAIC,uDAAyB;EACjC,UAAU;EACV;EACA,mBAAmB,OAAO,KAAK,SAAS;CAC1C,CAAC;CAGH,OAAO;AACT;;;;;AAMA,SAAgB,yBACd,QACA,MACA,YAAgC,CAAC,GACxB;CACT,MAAM,WAAW,KAAK,MAAM,GAAG;CAC/B,IAAI,SAAkB;CACtB,IAAI;CAEJ,KAAK,MAAM,CAAC,OAAO,YAAY,SAAS,QAAQ,GAAG;EACjD,MAAM,SAAS,UAAU;EACzB,MAAM,eAAeC,uCAAqB,OAAO;EAEjD,IAAI,iBAAiB,QAAW;GAC9B,IAAI,CAACJ,oCAAa,MAAM,GACtB,MAAM,IAAIK,sCAAiB;IACzB;IACA,QAAQ,IAAI,QAAQ;GACtB,CAAC;GAGH,MAAM,OAAO,OAAO;GAEpB,IAAI,SAAS,QAAW;IACtB,IAAI,QACF,MAAM,IAAIC,8CAAqB;KAC7B,UAAU;KACV,gBAAgB,OAAO,KAAK,MAAM;IACpC,CAAC;IAGH,MAAM,IAAID,sCAAiB;KACzB;KACA,QAAQ,IAAI,QAAQ;IACtB,CAAC;GACH;GAEA,IAAI,QACF,WAAW;GAGb,SAAS;GACT;EACF;EAEA,QAAQ,cAAR;GACE,KAAK,YAAY;IACf,MAAM,QAAQ,aAAa,WAAW,YAAY,IAAI;IAEtD,IAAI,OAAO,UAAU,YAAY,CAACL,oCAAa,OAAO,MAAM,GAC1D,MAAM,IAAIM,8CAAqB;KAC7B,UAAU;KACV,gBAAgB,OAAO,KAAK,MAAM;IACpC,CAAC;IAGH,WAAW;IACX,SAAS,OAAO;IAChB;GACF;GACA,KAAK,eAAe;IAClB,MAAM,QAAQ,aAAa,WAAW,eAAe,IAAI;IAEzD,IAAI,CAAC,wBAAwB,KAAK,GAChC,MAAM,IAAIL,qDAAwB;KAChC,aAAa;KACb;KACA,QACE;IACJ,CAAC;IAGH,SAAS,wBAAwB,QAAQ,OAAO,QAAQ;IACxD;GACF;GACA,KAAK,aAAa;IAChB,MAAM,QAAQ,aAAa,WAAW,aAAa,IAAI;IAEvD,IAAI,CAACD,oCAAa,MAAM,GACtB,MAAM,IAAIO,gDAAsB;KAC9B,WAAW;KACX;KACA;KACA,QAAQ,IAAI,OAAO,KAAK,EAAE;IAC5B,CAAC;IAGH,IAAI,OAAO,UAAU,YAAY,OAAO,WAAW,QACjD,MAAM,IAAIA,gDAAsB;KAC9B,WAAW;KACX;KACA;KACA,iBAAiBC,yCAAkB,MAAM;IAC3C,CAAC;IAGH,SAAS,OAAO;IAChB;GACF;GACA,SACE,MAAM,IAAIH,sCAAiB;IACzB;IACA,QAAQ,IAAI,QAAQ;GACtB,CAAC;EAEL;CACF;CAEA,OAAO;AACT"}

package/dist/create-config/paths/resolve.mjs

@@ -0,0 +1,129 @@
+import { InvalidPathError } from "../../errors/invalid-path.mjs";
+import { InvalidResourceError } from "../../errors/invalid-resource.mjs";
+import { InvalidSubResourceError } from "../../errors/invalid-sub-resource.mjs";
+import { InvalidComponentError } from "../../errors/invalid-component.mjs";
+import { MissingPathVariableError } from "../../errors/missing-path-variable.mjs";
+import { isConfigNode, readComponentKeys, readSubResourceKeys } from "../component-keys.mjs";
+import { readPathVariableName } from "./variables.mjs";
+
+//#region src/create-config/paths/resolve.ts
+function readSubResourceParamKey(param) {
+	return typeof param === "string" ? param : param.value;
+}
+/** Sub-resource slugs a param walks through, outermost first. */
+function flattenSubResourceParam(param) {
+	if (typeof param === "string") return [param];
+	return [param.value, ...flattenSubResourceParam(param.subResource)];
+}
+function isSubResourceParamValue(value) {
+	if (typeof value === "string") return value.length > 0;
+	if (typeof value !== "object" || value === null) return false;
+	const { value: slug, subResource } = value;
+	return typeof slug === "string" && isSubResourceParamValue(subResource);
+}
+function resolveSubResourceParam(node, param, resource) {
+	const key = readSubResourceParamKey(param);
+	if (!isConfigNode(node)) throw new InvalidSubResourceError({
+		subResource: key,
+		resource,
+		reason: `"${key}" cannot be read because its parent is not a configured resource`
+	});
+	const next = node[key];
+	if (!isConfigNode(next)) throw new InvalidSubResourceError({
+		subResource: key,
+		resource,
+		validSubResources: readSubResourceKeys(node)
+	});
+	if (typeof param === "string") return next;
+	return resolveSubResourceParam(next, param.subResource, resource);
+}
+function readVariable(variables, name, path) {
+	const value = variables[name];
+	if (value === void 0) throw new MissingPathVariableError({
+		variable: name,
+		path,
+		providedVariables: Object.keys(variables)
+	});
+	return value;
+}
+/**
+* Reads the value a path points at, substituting variable segments from `variables`.
+* Throws a typed error naming the segment that could not be resolved.
+*/
+function resolveParameterizedPath(config, path, variables = {}) {
+	const segments = path.split(".");
+	let cursor = config;
+	let resource;
+	for (const [index, segment] of segments.entries()) {
+		const isRoot = index === 0;
+		const variableName = readPathVariableName(segment);
+		if (variableName === void 0) {
+			if (!isConfigNode(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) {
+				if (isRoot) throw new InvalidResourceError({
+					resource: segment,
+					validResources: Object.keys(config)
+				});
+				throw new InvalidPathError({
+					path,
+					reason: `"${segment}" is not configured`
+				});
+			}
+			if (isRoot) resource = segment;
+			cursor = next;
+			continue;
+		}
+		switch (variableName) {
+			case "resource": {
+				const value = readVariable(variables, "resource", path);
+				if (typeof value !== "string" || !isConfigNode(config[value])) throw new InvalidResourceError({
+					resource: value,
+					validResources: Object.keys(config)
+				});
+				resource = value;
+				cursor = config[value];
+				break;
+			}
+			case "subResource": {
+				const value = readVariable(variables, "subResource", path);
+				if (!isSubResourceParamValue(value)) throw new InvalidSubResourceError({
+					subResource: value,
+					resource,
+					reason: "A sub-resource must be a slug or an object with `value` and `subResource`"
+				});
+				cursor = resolveSubResourceParam(cursor, value, resource);
+				break;
+			}
+			case "component": {
+				const value = readVariable(variables, "component", path);
+				if (!isConfigNode(cursor)) throw new InvalidComponentError({
+					component: value,
+					path,
+					resource,
+					reason: `"${String(value)}" cannot be read because the value before it is not a config branch`
+				});
+				if (typeof value !== "string" || cursor[value] === void 0) throw new InvalidComponentError({
+					component: value,
+					path,
+					resource,
+					validComponents: readComponentKeys(cursor)
+				});
+				cursor = cursor[value];
+				break;
+			}
+			default: throw new InvalidPathError({
+				path,
+				reason: `"${segment}" is not a supported path variable`
+			});
+		}
+	}
+	return cursor;
+}
+
+//#endregion
+export { flattenSubResourceParam, resolveParameterizedPath };
+//# sourceMappingURL=resolve.mjs.map

package/dist/create-config/paths/resolve.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.mjs","names":[],"sources":["../../../src/create-config/paths/resolve.ts"],"sourcesContent":["import {\n  InvalidComponentError,\n  InvalidPathError,\n  InvalidResourceError,\n  InvalidSubResourceError,\n  MissingPathVariableError,\n} from '../../errors';\nimport {\n  isConfigNode,\n  readComponentKeys,\n  readSubResourceKeys,\n} from '../component-keys';\nimport { readPathVariableName } from './variables';\n\n/** A `$subResource` value: a slug, or a slug plus the next `subResource` below it. */\nexport type SubResourceParamValue =\n  | string\n  | { value: string; subResource: SubResourceParamValue };\n\n/** Values supplied for the variables a path leaves open. */\nexport type PathVariableValues = {\n  resource?: string;\n  subResource?: SubResourceParamValue;\n  component?: string;\n};\n\nfunction readSubResourceParamKey(param: SubResourceParamValue): string {\n  return typeof param === 'string' ? param : param.value;\n}\n\n/** Sub-resource slugs a param walks through, outermost first. */\nexport function flattenSubResourceParam(\n  param: SubResourceParamValue,\n): string[] {\n  if (typeof param === 'string') {\n    return [param];\n  }\n\n  return [param.value, ...flattenSubResourceParam(param.subResource)];\n}\n\nfunction isSubResourceParamValue(\n  value: unknown,\n): value is SubResourceParamValue {\n  if (typeof value === 'string') {\n    return value.length > 0;\n  }\n\n  if (typeof value !== 'object' || value === null) {\n    return false;\n  }\n\n  const { value: slug, subResource } = value as {\n    value?: unknown;\n    subResource?: unknown;\n  };\n\n  return typeof slug === 'string' && isSubResourceParamValue(subResource);\n}\n\nfunction resolveSubResourceParam(\n  node: unknown,\n  param: SubResourceParamValue,\n  resource: string | undefined,\n): unknown {\n  const key = readSubResourceParamKey(param);\n\n  if (!isConfigNode(node)) {\n    throw new InvalidSubResourceError({\n      subResource: key,\n      resource,\n      reason: `\"${key}\" cannot be read because its parent is not a configured resource`,\n    });\n  }\n\n  const next = node[key];\n\n  if (!isConfigNode(next)) {\n    throw new InvalidSubResourceError({\n      subResource: key,\n      resource,\n      validSubResources: readSubResourceKeys(node),\n    });\n  }\n\n  if (typeof param === 'string') {\n    return next;\n  }\n\n  return resolveSubResourceParam(next, param.subResource, resource);\n}\n\nfunction readVariable<Name extends keyof PathVariableValues>(\n  variables: PathVariableValues,\n  name: Name,\n  path: string,\n): NonNullable<PathVariableValues[Name]> {\n  const value = variables[name];\n\n  if (value === undefined) {\n    throw new MissingPathVariableError({\n      variable: name,\n      path,\n      providedVariables: Object.keys(variables),\n    });\n  }\n\n  return value as NonNullable<PathVariableValues[Name]>;\n}\n\n/**\n * Reads the value a path points at, substituting variable segments from `variables`.\n * Throws a typed error naming the segment that could not be resolved.\n */\nexport function resolveParameterizedPath(\n  config: Record<string, unknown>,\n  path: string,\n  variables: PathVariableValues = {},\n): unknown {\n  const segments = path.split('.');\n  let cursor: unknown = config;\n  let resource: string | undefined;\n\n  for (const [index, segment] of segments.entries()) {\n    const isRoot = index === 0;\n    const variableName = readPathVariableName(segment);\n\n    if (variableName === undefined) {\n      if (!isConfigNode(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 = cursor[segment];\n\n      if (next === undefined) {\n        if (isRoot) {\n          throw new InvalidResourceError({\n            resource: segment,\n            validResources: Object.keys(config),\n          });\n        }\n\n        throw new InvalidPathError({\n          path,\n          reason: `\"${segment}\" is not configured`,\n        });\n      }\n\n      if (isRoot) {\n        resource = segment;\n      }\n\n      cursor = next;\n      continue;\n    }\n\n    switch (variableName) {\n      case 'resource': {\n        const value = readVariable(variables, 'resource', path);\n\n        if (typeof value !== 'string' || !isConfigNode(config[value])) {\n          throw new InvalidResourceError({\n            resource: value,\n            validResources: Object.keys(config),\n          });\n        }\n\n        resource = value;\n        cursor = config[value];\n        break;\n      }\n      case 'subResource': {\n        const value = readVariable(variables, 'subResource', path);\n\n        if (!isSubResourceParamValue(value)) {\n          throw new InvalidSubResourceError({\n            subResource: value,\n            resource,\n            reason:\n              'A sub-resource must be a slug or an object with `value` and `subResource`',\n          });\n        }\n\n        cursor = resolveSubResourceParam(cursor, value, resource);\n        break;\n      }\n      case 'component': {\n        const value = readVariable(variables, 'component', path);\n\n        if (!isConfigNode(cursor)) {\n          throw new InvalidComponentError({\n            component: value,\n            path,\n            resource,\n            reason: `\"${String(value)}\" cannot be read because the value before it is not a config branch`,\n          });\n        }\n\n        if (typeof value !== 'string' || cursor[value] === undefined) {\n          throw new InvalidComponentError({\n            component: value,\n            path,\n            resource,\n            validComponents: readComponentKeys(cursor),\n          });\n        }\n\n        cursor = cursor[value];\n        break;\n      }\n      default: {\n        throw new InvalidPathError({\n          path,\n          reason: `\"${segment}\" is not a supported path variable`,\n        });\n      }\n    }\n  }\n\n  return cursor;\n}\n"],"mappings":"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"}

package/dist/create-config/paths/types.d.cts

@@ -0,0 +1,104 @@
+import { Show } from "../../utils.cjs";
+import { LayoutResourceKey, ResourceDefinition, ResourceDefinitionForKey, SubResourceDefinitionsFor, SubResourceParamForResource } from "../../resource.cjs";
+import { BaseResourceConfigComponents, ResourceConfigComponentKey, SharedResourceConfigOptions } from "../types.cjs";
+import { ComponentPathVariable, ExtractPathVariables, PathHead, PathTail, ResourcePathVariable, SubResourcePathVariable } from "./variables.cjs";
+import { JSX } from "react";
+
+//#region src/create-config/paths/types.d.ts
+/** Recursion cap for path types. Must stay aligned with `MAX_PATH_DEPTH` in `./generate`. */
+type MaxPathDepth = 6;
+type ComponentSlotKey = keyof BaseResourceConfigComponents;
+type SharedBranchKey = keyof SharedResourceConfigOptions;
+/** A component slot segment: a fixed slot key, or the `$component` variable. */
+type ComponentSegment = ComponentSlotKey | ComponentPathVariable;
+/**
+ * Path tail selecting a component on the current node: a slot, a shared branch, or a
+ * slot inside a shared branch (`detail.errorComponent`, `new.$component`, …).
+ */
+type ComponentTailPath = ComponentSegment | SharedBranchKey | `${SharedBranchKey}.${ComponentSegment}`;
+type NestedSubResourceDefinitions<Def extends ResourceDefinition> = Def extends {
+  subResources: infer Nested extends ReadonlyArray<ResourceDefinition>;
+} ? Nested : readonly [];
+type SubResourceTailPaths<SubDefs extends ReadonlyArray<ResourceDefinition>, DepthAcc extends readonly unknown[]> = LayoutResourceKey<SubDefs> extends infer Key extends string ? Key extends LayoutResourceKey<SubDefs> ? Key | `${Key}.${ParameterizedEntryPath<NestedSubResourceDefinitions<ResourceDefinitionForKey<SubDefs, Key>>, readonly [...DepthAcc, unknown]>}` : never : never;
+/**
+ * Every path tail valid below one config node: component slots, declared sub-resource
+ * slugs, or a single `$subResource` variable. One `$subResource` segment stands for the
+ * whole remaining sub-resource chain, since its value may be `{ value, subResource }`.
+ */
+type ParameterizedEntryPath<SubDefs extends ReadonlyArray<ResourceDefinition>, DepthAcc extends readonly unknown[] = readonly []> = ComponentTailPath | ([SubDefs] extends [readonly []] ? never : DepthAcc['length'] extends MaxPathDepth ? never : SubResourceTailPaths<SubDefs, DepthAcc> | SubResourcePathVariable | `${SubResourcePathVariable}.${ComponentTailPath}`);
+type ParameterizedEntryPathForResource<Resources extends ReadonlyArray<ResourceDefinition>, Resource extends LayoutResourceKey<Resources>> = ParameterizedEntryPath<SubResourceDefinitionsFor<Resources, Resource>>;
+type AnyParameterizedEntryPath<Resources extends ReadonlyArray<ResourceDefinition>> = LayoutResourceKey<Resources> extends infer Resource ? Resource extends LayoutResourceKey<Resources> ? ParameterizedEntryPathForResource<Resources, Resource> : never : never;
+/**
+ * Paths accepted by `forPaths` and `createGetComponent`. Segments whose value depends on
+ * the config collapse into variables (`$resource`, `$subResource`, `$component`), and the
+ * fixed slots stay literal, so `'$resource.detail.$component'` leaves `resource` and
+ * `component` to the call site.
+ */
+type ParameterizedResourcePath<Resources extends ReadonlyArray<ResourceDefinition>> = LayoutResourceKey<Resources> | ResourcePathVariable | (LayoutResourceKey<Resources> extends infer Resource ? Resource extends LayoutResourceKey<Resources> ? `${Resource}.${ParameterizedEntryPathForResource<Resources, Resource>}` : never : never) | `${ResourcePathVariable}.${AnyParameterizedEntryPath<Resources>}`;
+type ConfigNodeOf<Node> = NonNullable<Node>;
+/**
+ * Element slots configured on a node (`component`, `errorComponent`, …). `detail` and
+ * `new` are path segments, not `$component` values.
+ */
+type ComponentKeysAtNode<Node> = ConfigNodeOf<Node> extends JSX.Element ? never : Extract<keyof ConfigNodeOf<Node>, ComponentSlotKey>;
+/** Sub-resource keys configured on a node: every key that is not a component slot. */
+type SubResourceKeysAtNode<Node> = ConfigNodeOf<Node> extends JSX.Element ? never : Exclude<keyof ConfigNodeOf<Node>, ResourceConfigComponentKey>;
+type IndexNode<Node, Key> = Key extends keyof ConfigNodeOf<Node> ? NonNullable<ConfigNodeOf<Node>[Key]> : never;
+type ComponentKeysAtNodes<Node> = Node extends unknown ? ComponentKeysAtNode<Node> : never;
+/** Sub-resource keys on a node and on every node below it, matching nested params. */
+type SubResourceKeysBelowNode<Node, DepthAcc extends readonly unknown[] = readonly []> = DepthAcc['length'] extends MaxPathDepth ? never : SubResourceKeysAtNode<Node> extends infer Key ? Key extends SubResourceKeysAtNode<Node> ? Key | SubResourceKeysBelowNode<IndexNode<Node, Key>, readonly [...DepthAcc, unknown]> : never : never;
+/** Every node reachable below `Node`, used when a `$subResource` value is not yet known. */
+type AnySubResourceNode<Node, DepthAcc extends readonly unknown[] = readonly []> = DepthAcc['length'] extends MaxPathDepth ? never : SubResourceKeysAtNode<Node> extends infer Key ? Key extends SubResourceKeysAtNode<Node> ? IndexNode<Node, Key> | AnySubResourceNode<IndexNode<Node, Key>, readonly [...DepthAcc, unknown]> : never : never;
+type ResolveConfigNodeSegment<Node, Segment extends string> = Node extends unknown ? Segment extends SubResourcePathVariable ? AnySubResourceNode<Node> : Segment extends ComponentPathVariable ? IndexNode<Node, ComponentKeysAtNode<Node>> : IndexNode<Node, Segment> : never;
+/**
+ * Walks `Path` on a config node. Open variables resolve to every value they could take,
+ * so `never` means the path cannot exist on that node.
+ */
+type ResolveConfigNode<Node, Path extends string> = [Node] extends [never] ? never : Path extends '' ? Node : Path extends `${infer Head}.${infer Rest}` ? ResolveConfigNode<ResolveConfigNodeSegment<Node, Head>, Rest> : ResolveConfigNodeSegment<Node, Path>;
+/** Resource keys present in a created config, falling back to every declared resource. */
+type ConfigResourceKeys<Resources extends ReadonlyArray<ResourceDefinition>, Config> = [Extract<LayoutResourceKey<Resources>, keyof Config>] extends [never] ? LayoutResourceKey<Resources> : Extract<LayoutResourceKey<Resources>, keyof Config>;
+type ResourceNode<Config, Resource> = Resource extends keyof Config ? NonNullable<Config[Resource]> : never;
+/**
+ * Resources a path can target: for `$resource` paths, only those whose config satisfies
+ * the path's fixed segments, so `'$resource.detail.$component'` excludes resources
+ * without a `detail`.
+ */
+type PathResourceCandidates<Resources extends ReadonlyArray<ResourceDefinition>, Config, Path extends string> = PathHead<Path> extends ResourcePathVariable ? ConfigResourceKeys<Resources, Config> extends infer Resource ? Resource extends ConfigResourceKeys<Resources, Config> ? [ResolveConfigNode<ResourceNode<Config, Resource>, PathTail<Path>>] extends [never] ? never : Resource : never : never : Extract<PathHead<Path>, ConfigResourceKeys<Resources, Config>>;
+type StripTrailingComponentVariable<Path extends string> = Path extends ComponentPathVariable ? '' : Path extends `${infer Head}.${ComponentPathVariable}` ? Head : Path;
+/** Component slot keys configured on the node a path resolves to. */
+type PathComponentKeys<Resources extends ReadonlyArray<ResourceDefinition>, Config, Path extends string> = PathResourceCandidates<Resources, Config, Path> extends infer Resource ? Resource extends PathResourceCandidates<Resources, Config, Path> ? ComponentKeysAtNodes<ResolveConfigNode<ResourceNode<Config, Resource>, StripTrailingComponentVariable<PathTail<Path>>>> : never : never;
+/** Sub-resource keys valid for the `$subResource` segment of a path. */
+type PathSubResourceKeys<Resources extends ReadonlyArray<ResourceDefinition>, Config, Path extends string> = PathResourceCandidates<Resources, Config, Path> extends infer Resource ? Resource extends PathResourceCandidates<Resources, Config, Path> ? SubResourceKeysBelowNode<ResourceNode<Config, Resource>> : never : never;
+/** Sub-resource keys configured for one resource, at any depth. */
+type ResourceSubResourceKeys<Config, Resource> = SubResourceKeysBelowNode<ResourceNode<Config, Resource>>;
+/** Every sub-resource key configured anywhere in a config map. */
+type ConfigSubResourceKeys<Resources extends ReadonlyArray<ResourceDefinition>, Config> = ConfigResourceKeys<Resources, Config> extends infer Resource ? Resource extends ConfigResourceKeys<Resources, Config> ? ResourceSubResourceKeys<Config, Resource> : never : never;
+type ComponentKeysForPath<Config, Resource, Tail extends string> = ComponentKeysAtNodes<ResolveConfigNode<ResourceNode<Config, Resource>, StripTrailingComponentVariable<Tail>>> extends infer Keys ? [Keys] extends [never] ? ComponentSlotKey : Keys : ComponentSlotKey;
+/** Params a path requires for one target resource. */
+type PathVariablesForResource<Resources extends ReadonlyArray<ResourceDefinition>, Config, Path extends string, Resource extends LayoutResourceKey<Resources>> = Show<('resource' extends ExtractPathVariables<Path> ? {
+  resource: Resource;
+} : {}) & ('subResource' extends ExtractPathVariables<Path> ? {
+  subResource: SubResourceParamForResource<Resources, Resource>;
+} : {}) & ('component' extends ExtractPathVariables<Path> ? {
+  component: ComponentKeysForPath<Config, Resource, PathTail<Path>>;
+} : {})>;
+/**
+ * Params a path requires, as one object per resource the path can target. A path with no
+ * variables resolves to `{}`.
+ */
+type PathVariables<Resources extends ReadonlyArray<ResourceDefinition>, Config, Path extends string> = PathResourceCandidates<Resources, Config, Path> extends infer Resource ? Resource extends LayoutResourceKey<Resources> ? PathVariablesForResource<Resources, Config, Path, Resource> : never : never;
+type VariableValue<Variables, Name extends string> = Name extends keyof Variables ? Variables[Name] : never;
+type ResolveSubResourceParamNode<Node, Param, DepthAcc extends readonly unknown[] = readonly []> = DepthAcc['length'] extends MaxPathDepth ? never : Param extends string ? IndexNode<Node, Param> : Param extends {
+  value: infer Value extends string;
+  subResource: infer Nested;
+} ? ResolveSubResourceParamNode<IndexNode<Node, Value>, Nested, readonly [...DepthAcc, unknown]> : never;
+type ResolveNodeSegmentWithVariables<Node, Segment extends string, Variables> = Node extends unknown ? Segment extends SubResourcePathVariable ? ResolveSubResourceParamNode<Node, VariableValue<Variables, 'subResource'>> : Segment extends ComponentPathVariable ? IndexNode<Node, Extract<VariableValue<Variables, 'component'>, string>> : IndexNode<Node, Segment> : never;
+type ResolveNodeWithVariables<Node, Path extends string, Variables> = [Node] extends [never] ? never : Path extends '' ? Node : Path extends `${infer Head}.${infer Rest}` ? ResolveNodeWithVariables<ResolveNodeSegmentWithVariables<Node, Head, Variables>, Rest, Variables> : ResolveNodeSegmentWithVariables<Node, Path, Variables>;
+/**
+ * Config value a path resolves to once its variables are supplied. Object nodes come back
+ * with a `getComponent` helper attached at runtime; component slots resolve to the element.
+ */
+type ResolveParameterizedPathValue<Resources extends ReadonlyArray<ResourceDefinition>, Config, Path extends string, Variables> = Variables extends unknown ? ResolveNodeWithVariables<PathHead<Path> extends ResourcePathVariable ? ResourceNode<Config, Extract<VariableValue<Variables, 'resource'>, LayoutResourceKey<Resources>>> : ResourceNode<Config, PathHead<Path>>, PathTail<Path>, Variables> : never;
+//#endregion
+export { ConfigResourceKeys, ConfigSubResourceKeys, ParameterizedEntryPath, ParameterizedResourcePath, PathComponentKeys, PathResourceCandidates, PathSubResourceKeys, PathVariables, PathVariablesForResource, ResolveConfigNode, ResolveParameterizedPathValue, ResourceSubResourceKeys };
+//# sourceMappingURL=types.d.cts.map

package/dist/create-config/paths/types.d.cts.map

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

package/dist/create-config/paths/types.d.mts

@@ -0,0 +1,104 @@
+import { Show } from "../../utils.mjs";
+import { LayoutResourceKey, ResourceDefinition, ResourceDefinitionForKey, SubResourceDefinitionsFor, SubResourceParamForResource } from "../../resource.mjs";
+import { BaseResourceConfigComponents, ResourceConfigComponentKey, SharedResourceConfigOptions } from "../types.mjs";
+import { ComponentPathVariable, ExtractPathVariables, PathHead, PathTail, ResourcePathVariable, SubResourcePathVariable } from "./variables.mjs";
+import { JSX } from "react";
+
+//#region src/create-config/paths/types.d.ts
+/** Recursion cap for path types. Must stay aligned with `MAX_PATH_DEPTH` in `./generate`. */
+type MaxPathDepth = 6;
+type ComponentSlotKey = keyof BaseResourceConfigComponents;
+type SharedBranchKey = keyof SharedResourceConfigOptions;
+/** A component slot segment: a fixed slot key, or the `$component` variable. */
+type ComponentSegment = ComponentSlotKey | ComponentPathVariable;
+/**
+ * Path tail selecting a component on the current node: a slot, a shared branch, or a
+ * slot inside a shared branch (`detail.errorComponent`, `new.$component`, …).
+ */
+type ComponentTailPath = ComponentSegment | SharedBranchKey | `${SharedBranchKey}.${ComponentSegment}`;
+type NestedSubResourceDefinitions<Def extends ResourceDefinition> = Def extends {
+  subResources: infer Nested extends ReadonlyArray<ResourceDefinition>;
+} ? Nested : readonly [];
+type SubResourceTailPaths<SubDefs extends ReadonlyArray<ResourceDefinition>, DepthAcc extends readonly unknown[]> = LayoutResourceKey<SubDefs> extends infer Key extends string ? Key extends LayoutResourceKey<SubDefs> ? Key | `${Key}.${ParameterizedEntryPath<NestedSubResourceDefinitions<ResourceDefinitionForKey<SubDefs, Key>>, readonly [...DepthAcc, unknown]>}` : never : never;
+/**
+ * Every path tail valid below one config node: component slots, declared sub-resource
+ * slugs, or a single `$subResource` variable. One `$subResource` segment stands for the
+ * whole remaining sub-resource chain, since its value may be `{ value, subResource }`.
+ */
+type ParameterizedEntryPath<SubDefs extends ReadonlyArray<ResourceDefinition>, DepthAcc extends readonly unknown[] = readonly []> = ComponentTailPath | ([SubDefs] extends [readonly []] ? never : DepthAcc['length'] extends MaxPathDepth ? never : SubResourceTailPaths<SubDefs, DepthAcc> | SubResourcePathVariable | `${SubResourcePathVariable}.${ComponentTailPath}`);
+type ParameterizedEntryPathForResource<Resources extends ReadonlyArray<ResourceDefinition>, Resource extends LayoutResourceKey<Resources>> = ParameterizedEntryPath<SubResourceDefinitionsFor<Resources, Resource>>;
+type AnyParameterizedEntryPath<Resources extends ReadonlyArray<ResourceDefinition>> = LayoutResourceKey<Resources> extends infer Resource ? Resource extends LayoutResourceKey<Resources> ? ParameterizedEntryPathForResource<Resources, Resource> : never : never;
+/**
+ * Paths accepted by `forPaths` and `createGetComponent`. Segments whose value depends on
+ * the config collapse into variables (`$resource`, `$subResource`, `$component`), and the
+ * fixed slots stay literal, so `'$resource.detail.$component'` leaves `resource` and
+ * `component` to the call site.
+ */
+type ParameterizedResourcePath<Resources extends ReadonlyArray<ResourceDefinition>> = LayoutResourceKey<Resources> | ResourcePathVariable | (LayoutResourceKey<Resources> extends infer Resource ? Resource extends LayoutResourceKey<Resources> ? `${Resource}.${ParameterizedEntryPathForResource<Resources, Resource>}` : never : never) | `${ResourcePathVariable}.${AnyParameterizedEntryPath<Resources>}`;
+type ConfigNodeOf<Node> = NonNullable<Node>;
+/**
+ * Element slots configured on a node (`component`, `errorComponent`, …). `detail` and
+ * `new` are path segments, not `$component` values.
+ */
+type ComponentKeysAtNode<Node> = ConfigNodeOf<Node> extends JSX.Element ? never : Extract<keyof ConfigNodeOf<Node>, ComponentSlotKey>;
+/** Sub-resource keys configured on a node: every key that is not a component slot. */
+type SubResourceKeysAtNode<Node> = ConfigNodeOf<Node> extends JSX.Element ? never : Exclude<keyof ConfigNodeOf<Node>, ResourceConfigComponentKey>;
+type IndexNode<Node, Key> = Key extends keyof ConfigNodeOf<Node> ? NonNullable<ConfigNodeOf<Node>[Key]> : never;
+type ComponentKeysAtNodes<Node> = Node extends unknown ? ComponentKeysAtNode<Node> : never;
+/** Sub-resource keys on a node and on every node below it, matching nested params. */
+type SubResourceKeysBelowNode<Node, DepthAcc extends readonly unknown[] = readonly []> = DepthAcc['length'] extends MaxPathDepth ? never : SubResourceKeysAtNode<Node> extends infer Key ? Key extends SubResourceKeysAtNode<Node> ? Key | SubResourceKeysBelowNode<IndexNode<Node, Key>, readonly [...DepthAcc, unknown]> : never : never;
+/** Every node reachable below `Node`, used when a `$subResource` value is not yet known. */
+type AnySubResourceNode<Node, DepthAcc extends readonly unknown[] = readonly []> = DepthAcc['length'] extends MaxPathDepth ? never : SubResourceKeysAtNode<Node> extends infer Key ? Key extends SubResourceKeysAtNode<Node> ? IndexNode<Node, Key> | AnySubResourceNode<IndexNode<Node, Key>, readonly [...DepthAcc, unknown]> : never : never;
+type ResolveConfigNodeSegment<Node, Segment extends string> = Node extends unknown ? Segment extends SubResourcePathVariable ? AnySubResourceNode<Node> : Segment extends ComponentPathVariable ? IndexNode<Node, ComponentKeysAtNode<Node>> : IndexNode<Node, Segment> : never;
+/**
+ * Walks `Path` on a config node. Open variables resolve to every value they could take,
+ * so `never` means the path cannot exist on that node.
+ */
+type ResolveConfigNode<Node, Path extends string> = [Node] extends [never] ? never : Path extends '' ? Node : Path extends `${infer Head}.${infer Rest}` ? ResolveConfigNode<ResolveConfigNodeSegment<Node, Head>, Rest> : ResolveConfigNodeSegment<Node, Path>;
+/** Resource keys present in a created config, falling back to every declared resource. */
+type ConfigResourceKeys<Resources extends ReadonlyArray<ResourceDefinition>, Config> = [Extract<LayoutResourceKey<Resources>, keyof Config>] extends [never] ? LayoutResourceKey<Resources> : Extract<LayoutResourceKey<Resources>, keyof Config>;
+type ResourceNode<Config, Resource> = Resource extends keyof Config ? NonNullable<Config[Resource]> : never;
+/**
+ * Resources a path can target: for `$resource` paths, only those whose config satisfies
+ * the path's fixed segments, so `'$resource.detail.$component'` excludes resources
+ * without a `detail`.
+ */
+type PathResourceCandidates<Resources extends ReadonlyArray<ResourceDefinition>, Config, Path extends string> = PathHead<Path> extends ResourcePathVariable ? ConfigResourceKeys<Resources, Config> extends infer Resource ? Resource extends ConfigResourceKeys<Resources, Config> ? [ResolveConfigNode<ResourceNode<Config, Resource>, PathTail<Path>>] extends [never] ? never : Resource : never : never : Extract<PathHead<Path>, ConfigResourceKeys<Resources, Config>>;
+type StripTrailingComponentVariable<Path extends string> = Path extends ComponentPathVariable ? '' : Path extends `${infer Head}.${ComponentPathVariable}` ? Head : Path;
+/** Component slot keys configured on the node a path resolves to. */
+type PathComponentKeys<Resources extends ReadonlyArray<ResourceDefinition>, Config, Path extends string> = PathResourceCandidates<Resources, Config, Path> extends infer Resource ? Resource extends PathResourceCandidates<Resources, Config, Path> ? ComponentKeysAtNodes<ResolveConfigNode<ResourceNode<Config, Resource>, StripTrailingComponentVariable<PathTail<Path>>>> : never : never;
+/** Sub-resource keys valid for the `$subResource` segment of a path. */
+type PathSubResourceKeys<Resources extends ReadonlyArray<ResourceDefinition>, Config, Path extends string> = PathResourceCandidates<Resources, Config, Path> extends infer Resource ? Resource extends PathResourceCandidates<Resources, Config, Path> ? SubResourceKeysBelowNode<ResourceNode<Config, Resource>> : never : never;
+/** Sub-resource keys configured for one resource, at any depth. */
+type ResourceSubResourceKeys<Config, Resource> = SubResourceKeysBelowNode<ResourceNode<Config, Resource>>;
+/** Every sub-resource key configured anywhere in a config map. */
+type ConfigSubResourceKeys<Resources extends ReadonlyArray<ResourceDefinition>, Config> = ConfigResourceKeys<Resources, Config> extends infer Resource ? Resource extends ConfigResourceKeys<Resources, Config> ? ResourceSubResourceKeys<Config, Resource> : never : never;
+type ComponentKeysForPath<Config, Resource, Tail extends string> = ComponentKeysAtNodes<ResolveConfigNode<ResourceNode<Config, Resource>, StripTrailingComponentVariable<Tail>>> extends infer Keys ? [Keys] extends [never] ? ComponentSlotKey : Keys : ComponentSlotKey;
+/** Params a path requires for one target resource. */
+type PathVariablesForResource<Resources extends ReadonlyArray<ResourceDefinition>, Config, Path extends string, Resource extends LayoutResourceKey<Resources>> = Show<('resource' extends ExtractPathVariables<Path> ? {
+  resource: Resource;
+} : {}) & ('subResource' extends ExtractPathVariables<Path> ? {
+  subResource: SubResourceParamForResource<Resources, Resource>;
+} : {}) & ('component' extends ExtractPathVariables<Path> ? {
+  component: ComponentKeysForPath<Config, Resource, PathTail<Path>>;
+} : {})>;
+/**
+ * Params a path requires, as one object per resource the path can target. A path with no
+ * variables resolves to `{}`.
+ */
+type PathVariables<Resources extends ReadonlyArray<ResourceDefinition>, Config, Path extends string> = PathResourceCandidates<Resources, Config, Path> extends infer Resource ? Resource extends LayoutResourceKey<Resources> ? PathVariablesForResource<Resources, Config, Path, Resource> : never : never;
+type VariableValue<Variables, Name extends string> = Name extends keyof Variables ? Variables[Name] : never;
+type ResolveSubResourceParamNode<Node, Param, DepthAcc extends readonly unknown[] = readonly []> = DepthAcc['length'] extends MaxPathDepth ? never : Param extends string ? IndexNode<Node, Param> : Param extends {
+  value: infer Value extends string;
+  subResource: infer Nested;
+} ? ResolveSubResourceParamNode<IndexNode<Node, Value>, Nested, readonly [...DepthAcc, unknown]> : never;
+type ResolveNodeSegmentWithVariables<Node, Segment extends string, Variables> = Node extends unknown ? Segment extends SubResourcePathVariable ? ResolveSubResourceParamNode<Node, VariableValue<Variables, 'subResource'>> : Segment extends ComponentPathVariable ? IndexNode<Node, Extract<VariableValue<Variables, 'component'>, string>> : IndexNode<Node, Segment> : never;
+type ResolveNodeWithVariables<Node, Path extends string, Variables> = [Node] extends [never] ? never : Path extends '' ? Node : Path extends `${infer Head}.${infer Rest}` ? ResolveNodeWithVariables<ResolveNodeSegmentWithVariables<Node, Head, Variables>, Rest, Variables> : ResolveNodeSegmentWithVariables<Node, Path, Variables>;
+/**
+ * Config value a path resolves to once its variables are supplied. Object nodes come back
+ * with a `getComponent` helper attached at runtime; component slots resolve to the element.
+ */
+type ResolveParameterizedPathValue<Resources extends ReadonlyArray<ResourceDefinition>, Config, Path extends string, Variables> = Variables extends unknown ? ResolveNodeWithVariables<PathHead<Path> extends ResourcePathVariable ? ResourceNode<Config, Extract<VariableValue<Variables, 'resource'>, LayoutResourceKey<Resources>>> : ResourceNode<Config, PathHead<Path>>, PathTail<Path>, Variables> : never;
+//#endregion
+export { ConfigResourceKeys, ConfigSubResourceKeys, ParameterizedEntryPath, ParameterizedResourcePath, PathComponentKeys, PathResourceCandidates, PathSubResourceKeys, PathVariables, PathVariablesForResource, ResolveConfigNode, ResolveParameterizedPathValue, ResourceSubResourceKeys };
+//# sourceMappingURL=types.d.mts.map

package/dist/create-config/paths/types.d.mts.map

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

package/dist/create-config/paths/variables.cjs

@@ -0,0 +1,32 @@
+
+//#region src/create-config/paths/variables.ts
+/**
+* Prefix marking a path segment as a caller-supplied variable. `'$resource.detail.$component'`
+* leaves `resource` and `component` open, while `detail` is fixed.
+*/
+const PATH_VARIABLE_IDENTIFIER = "$";
+function createPathVariable(name) {
+	return `${"$"}${name}`;
+}
+function isPathVariableSegment(segment) {
+	return segment.startsWith("$");
+}
+/** Variable name for a segment, or `undefined` when the segment is a fixed key. */
+function readPathVariableName(segment) {
+	return isPathVariableSegment(segment) ? segment.slice(1) : void 0;
+}
+/** Variable names declared by `path`, in order of appearance and without duplicates. */
+function extractPathVariables(path) {
+	const names = /* @__PURE__ */ new Set();
+	for (const segment of path.split(".")) {
+		const name = readPathVariableName(segment);
+		if (name !== void 0 && name.length > 0) names.add(name);
+	}
+	return [...names];
+}
+
+//#endregion
+exports.createPathVariable = createPathVariable;
+exports.extractPathVariables = extractPathVariables;
+exports.readPathVariableName = readPathVariableName;
+//# sourceMappingURL=variables.cjs.map

package/dist/create-config/paths/variables.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"variables.cjs","names":[],"sources":["../../../src/create-config/paths/variables.ts"],"sourcesContent":["/**\n * Prefix marking a path segment as a caller-supplied variable. `'$resource.detail.$component'`\n * leaves `resource` and `component` open, while `detail` is fixed.\n */\nexport const PATH_VARIABLE_IDENTIFIER = '$';\n\nexport type PathVariableIdentifier = typeof PATH_VARIABLE_IDENTIFIER;\n\n/** A single variable path segment, e.g. `PathVariable<'resource'>` is `'$resource'`. */\nexport type PathVariable<Name extends string> =\n  `${PathVariableIdentifier}${Name}`;\n\nexport type ResourcePathVariable = PathVariable<'resource'>;\nexport type SubResourcePathVariable = PathVariable<'subResource'>;\nexport type ComponentPathVariable = PathVariable<'component'>;\n\n/** Variable names a path may leave open. */\nexport type PathVariableName = 'resource' | 'subResource' | 'component';\n\nexport type RemovePathVariableIdentifier<Segment extends string> =\n  Segment extends PathVariable<infer Name> ? Name : Segment;\n\ntype ExtractSegmentVariable<Segment extends string> =\n  Segment extends PathVariable<infer Name> ? Name : never;\n\n/**\n * Variable names declared by a dot-separated path.\n *\n * @example\n * ```ts\n * ExtractPathVariables<'$resource.detail.$component'>\n * // ^? 'resource' | 'component'\n * ```\n */\nexport type ExtractPathVariables<Path extends string> =\n  Path extends `${infer Segment}.${infer Rest}`\n    ? ExtractSegmentVariable<Segment> | ExtractPathVariables<Rest>\n    : ExtractSegmentVariable<Path>;\n\n/** Whether `Path` leaves any variable open. */\nexport type PathHasVariables<Path extends string> = [\n  ExtractPathVariables<Path>,\n] extends [never]\n  ? false\n  : true;\n\n/** First segment of a dot-separated path. */\nexport type PathHead<Path extends string> =\n  Path extends `${infer Head}.${string}` ? Head : Path;\n\n/** Everything after the first segment of a dot-separated path (`''` when there is nothing left). */\nexport type PathTail<Path extends string> =\n  Path extends `${string}.${infer Rest}` ? Rest : '';\n\nexport function createPathVariable<Name extends string>(\n  name: Name,\n): PathVariable<Name> {\n  return `${PATH_VARIABLE_IDENTIFIER}${name}`;\n}\n\nexport function isPathVariableSegment(segment: string): boolean {\n  return segment.startsWith(PATH_VARIABLE_IDENTIFIER);\n}\n\n/** Variable name for a segment, or `undefined` when the segment is a fixed key. */\nexport function readPathVariableName(segment: string): string | undefined {\n  return isPathVariableSegment(segment)\n    ? segment.slice(PATH_VARIABLE_IDENTIFIER.length)\n    : undefined;\n}\n\n/** Variable names declared by `path`, in order of appearance and without duplicates. */\nexport function extractPathVariables(path: string): string[] {\n  const names = new Set<string>();\n\n  for (const segment of path.split('.')) {\n    const name = readPathVariableName(segment);\n\n    if (name !== undefined && name.length > 0) {\n      names.add(name);\n    }\n  }\n\n  return [...names];\n}\n\nexport function pathHasVariables(path: string): boolean {\n  return extractPathVariables(path).length > 0;\n}\n"],"mappings":";;;;;;AAIA,MAAa,2BAA2B;AAkDxC,SAAgB,mBACd,MACoB;CACpB,OAAO,SAA8B;AACvC;AAEA,SAAgB,sBAAsB,SAA0B;CAC9D,OAAO,QAAQ,cAAmC;AACpD;;AAGA,SAAgB,qBAAqB,SAAqC;CACxE,OAAO,sBAAsB,OAAO,IAChC,QAAQ,MAAM,CAA+B,IAC7C;AACN;;AAGA,SAAgB,qBAAqB,MAAwB;CAC3D,MAAM,wBAAQ,IAAI,IAAY;CAE9B,KAAK,MAAM,WAAW,KAAK,MAAM,GAAG,GAAG;EACrC,MAAM,OAAO,qBAAqB,OAAO;EAEzC,IAAI,SAAS,UAAa,KAAK,SAAS,GACtC,MAAM,IAAI,IAAI;CAElB;CAEA,OAAO,CAAC,GAAG,KAAK;AAClB"}

package/dist/create-config/paths/variables.d.cts

@@ -0,0 +1,32 @@
+//#region src/create-config/paths/variables.d.ts
+/**
+ * Prefix marking a path segment as a caller-supplied variable. `'$resource.detail.$component'`
+ * leaves `resource` and `component` open, while `detail` is fixed.
+ */
+declare const PATH_VARIABLE_IDENTIFIER = "$";
+type PathVariableIdentifier = typeof PATH_VARIABLE_IDENTIFIER;
+/** A single variable path segment, e.g. `PathVariable<'resource'>` is `'$resource'`. */
+type PathVariable<Name extends string> = `${PathVariableIdentifier}${Name}`;
+type ResourcePathVariable = PathVariable<'resource'>;
+type SubResourcePathVariable = PathVariable<'subResource'>;
+type ComponentPathVariable = PathVariable<'component'>;
+type ExtractSegmentVariable<Segment extends string> = Segment extends PathVariable<infer Name> ? Name : never;
+/**
+ * Variable names declared by a dot-separated path.
+ *
+ * @example
+ * ```ts
+ * ExtractPathVariables<'$resource.detail.$component'>
+ * // ^? 'resource' | 'component'
+ * ```
+ */
+type ExtractPathVariables<Path extends string> = Path extends `${infer Segment}.${infer Rest}` ? ExtractSegmentVariable<Segment> | ExtractPathVariables<Rest> : ExtractSegmentVariable<Path>;
+/** Whether `Path` leaves any variable open. */
+type PathHasVariables<Path extends string> = [ExtractPathVariables<Path>] extends [never] ? false : true;
+/** First segment of a dot-separated path. */
+type PathHead<Path extends string> = Path extends `${infer Head}.${string}` ? Head : Path;
+/** Everything after the first segment of a dot-separated path (`''` when there is nothing left). */
+type PathTail<Path extends string> = Path extends `${string}.${infer Rest}` ? Rest : '';
+//#endregion
+export { ComponentPathVariable, ExtractPathVariables, PATH_VARIABLE_IDENTIFIER, PathHasVariables, PathHead, PathTail, PathVariable, PathVariableIdentifier, ResourcePathVariable, SubResourcePathVariable };
+//# sourceMappingURL=variables.d.cts.map