@jfdevelops/react-layout 0.17.4 → 0.18.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"generate.mjs","names":[],"sources":["../../../src/create-config/paths/generate.ts"],"sourcesContent":["import {\n  COMPONENT_SLOT_KEYS,\n  isConfigNode,\n  readComponentKeys,\n  readSubResourceKeys,\n  SHARED_BRANCH_KEYS,\n} from '../component-keys';\nimport {\n  createPathVariable,\n  type ComponentPathVariable,\n  type ResourcePathVariable,\n  type SubResourcePathVariable,\n} from './variables';\n\n/** Recursion cap for generated paths. Must stay aligned with `MaxPathDepth` in `./types`. */\nexport const MAX_PATH_DEPTH = 6;\n\nconst RESOURCE_VARIABLE: ResourcePathVariable = createPathVariable('resource');\nconst SUB_RESOURCE_VARIABLE: SubResourcePathVariable =\n  createPathVariable('subResource');\nconst COMPONENT_VARIABLE: ComponentPathVariable =\n  createPathVariable('component');\n\n/** Component tails on one node: its slots, its shared branches, and `$component`. */\nfunction collectComponentTails(node: Record<string, unknown>): string[] {\n  const tails: string[] = [];\n\n  for (const key of COMPONENT_SLOT_KEYS) {\n    if (node[key] !== undefined) {\n      tails.push(key);\n    }\n  }\n\n  if (readComponentKeys(node).length > 0) {\n    tails.push(COMPONENT_VARIABLE);\n  }\n\n  for (const branch of SHARED_BRANCH_KEYS) {\n    const branchNode = node[branch];\n\n    if (!isConfigNode(branchNode)) {\n      continue;\n    }\n\n    tails.push(branch);\n\n    for (const key of COMPONENT_SLOT_KEYS) {\n      if (branchNode[key] !== undefined) {\n        tails.push(`${branch}.${key}`);\n      }\n    }\n\n    if (readComponentKeys(branchNode).length > 0) {\n      tails.push(`${branch}.${COMPONENT_VARIABLE}`);\n    }\n  }\n\n  return tails;\n}\n\n/**\n * Component tails valid after a `$subResource` segment: one variable stands for the whole\n * sub-resource chain, so every descendant's tails are reachable.\n */\nfunction collectDescendantComponentTails(\n  node: Record<string, unknown>,\n  depth: number,\n): string[] {\n  if (depth === 0) {\n    return [];\n  }\n\n  const tails = new Set<string>();\n\n  for (const key of readSubResourceKeys(node)) {\n    const subNode = node[key];\n\n    if (!isConfigNode(subNode)) {\n      continue;\n    }\n\n    for (const tail of collectComponentTails(subNode)) {\n      tails.add(tail);\n    }\n\n    for (const tail of collectDescendantComponentTails(subNode, depth - 1)) {\n      tails.add(tail);\n    }\n  }\n\n  return [...tails];\n}\n\n/** Every path tail valid below one config node. */\nfunction collectEntryPaths(\n  node: Record<string, unknown>,\n  depth: number,\n): string[] {\n  if (depth === 0) {\n    return [];\n  }\n\n  const paths = new Set<string>(collectComponentTails(node));\n  const subResourceKeys = readSubResourceKeys(node);\n\n  if (subResourceKeys.length > 0) {\n    paths.add(SUB_RESOURCE_VARIABLE);\n\n    for (const tail of collectDescendantComponentTails(node, depth)) {\n      paths.add(`${SUB_RESOURCE_VARIABLE}.${tail}`);\n    }\n  }\n\n  for (const key of subResourceKeys) {\n    const subNode = node[key];\n\n    paths.add(key);\n\n    if (!isConfigNode(subNode)) {\n      continue;\n    }\n\n    for (const nested of collectEntryPaths(subNode, depth - 1)) {\n      paths.add(`${key}.${nested}`);\n    }\n  }\n\n  return [...paths];\n}\n\n/**\n * Paths a config accepts, with resource and sub-resource segments available both as\n * literals and as variables. Runtime twin of `ParameterizedResourcePath`.\n */\nexport function generateResourceConfigPaths(\n  config: Record<string, unknown>,\n): string[] {\n  const paths = new Set<string>();\n\n  for (const resource of Object.keys(config)) {\n    const resourceNode = config[resource];\n\n    if (!isConfigNode(resourceNode)) {\n      continue;\n    }\n\n    paths.add(resource);\n    paths.add(RESOURCE_VARIABLE);\n\n    for (const tail of collectEntryPaths(resourceNode, MAX_PATH_DEPTH)) {\n      paths.add(`${resource}.${tail}`);\n      paths.add(`${RESOURCE_VARIABLE}.${tail}`);\n    }\n  }\n\n  return [...paths];\n}\n"],"mappings":";;;;;AAeA,MAAa,iBAAiB;AAE9B,MAAM,oBAA0C,mBAAmB,UAAU;AAC7E,MAAM,wBACJ,mBAAmB,aAAa;AAClC,MAAM,qBACJ,mBAAmB,WAAW;;AAGhC,SAAS,sBAAsB,MAAyC;CACtE,MAAM,QAAkB,CAAC;CAEzB,KAAK,MAAM,OAAO,qBAChB,IAAI,KAAK,SAAS,QAChB,MAAM,KAAK,GAAG;CAIlB,IAAI,kBAAkB,IAAI,EAAE,SAAS,GACnC,MAAM,KAAK,kBAAkB;CAG/B,KAAK,MAAM,UAAU,oBAAoB;EACvC,MAAM,aAAa,KAAK;EAExB,IAAI,CAAC,aAAa,UAAU,GAC1B;EAGF,MAAM,KAAK,MAAM;EAEjB,KAAK,MAAM,OAAO,qBAChB,IAAI,WAAW,SAAS,QACtB,MAAM,KAAK,GAAG,OAAO,GAAG,KAAK;EAIjC,IAAI,kBAAkB,UAAU,EAAE,SAAS,GACzC,MAAM,KAAK,GAAG,OAAO,GAAG,oBAAoB;CAEhD;CAEA,OAAO;AACT;;;;;AAMA,SAAS,gCACP,MACA,OACU;CACV,IAAI,UAAU,GACZ,OAAO,CAAC;CAGV,MAAM,wBAAQ,IAAI,IAAY;CAE9B,KAAK,MAAM,OAAO,oBAAoB,IAAI,GAAG;EAC3C,MAAM,UAAU,KAAK;EAErB,IAAI,CAAC,aAAa,OAAO,GACvB;EAGF,KAAK,MAAM,QAAQ,sBAAsB,OAAO,GAC9C,MAAM,IAAI,IAAI;EAGhB,KAAK,MAAM,QAAQ,gCAAgC,SAAS,QAAQ,CAAC,GACnE,MAAM,IAAI,IAAI;CAElB;CAEA,OAAO,CAAC,GAAG,KAAK;AAClB;;AAGA,SAAS,kBACP,MACA,OACU;CACV,IAAI,UAAU,GACZ,OAAO,CAAC;CAGV,MAAM,QAAQ,IAAI,IAAY,sBAAsB,IAAI,CAAC;CACzD,MAAM,kBAAkB,oBAAoB,IAAI;CAEhD,IAAI,gBAAgB,SAAS,GAAG;EAC9B,MAAM,IAAI,qBAAqB;EAE/B,KAAK,MAAM,QAAQ,gCAAgC,MAAM,KAAK,GAC5D,MAAM,IAAI,GAAG,sBAAsB,GAAG,MAAM;CAEhD;CAEA,KAAK,MAAM,OAAO,iBAAiB;EACjC,MAAM,UAAU,KAAK;EAErB,MAAM,IAAI,GAAG;EAEb,IAAI,CAAC,aAAa,OAAO,GACvB;EAGF,KAAK,MAAM,UAAU,kBAAkB,SAAS,QAAQ,CAAC,GACvD,MAAM,IAAI,GAAG,IAAI,GAAG,QAAQ;CAEhC;CAEA,OAAO,CAAC,GAAG,KAAK;AAClB;;;;;AAMA,SAAgB,4BACd,QACU;CACV,MAAM,wBAAQ,IAAI,IAAY;CAE9B,KAAK,MAAM,YAAY,OAAO,KAAK,MAAM,GAAG;EAC1C,MAAM,eAAe,OAAO;EAE5B,IAAI,CAAC,aAAa,YAAY,GAC5B;EAGF,MAAM,IAAI,QAAQ;EAClB,MAAM,IAAI,iBAAiB;EAE3B,KAAK,MAAM,QAAQ,kBAAkB,eAA4B,GAAG;GAClE,MAAM,IAAI,GAAG,SAAS,GAAG,MAAM;GAC/B,MAAM,IAAI,GAAG,kBAAkB,GAAG,MAAM;EAC1C;CACF;CAEA,OAAO,CAAC,GAAG,KAAK;AAClB"}

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

@@ -0,0 +1,2 @@
+import { ComponentPathVariable, ExtractPathVariables, PATH_VARIABLE_IDENTIFIER, PathHasVariables, PathHead, PathTail, PathVariable, PathVariableIdentifier, ResourcePathVariable, SubResourcePathVariable } from "./variables.cjs";
+import { ConfigResourceKeys, ConfigSubResourceKeys, ParameterizedEntryPath, ParameterizedResourcePath, PathComponentKeys, PathResourceCandidates, PathSubResourceKeys, PathVariables, PathVariablesForResource, ResolveConfigNode, ResolveParameterizedPathValue, ResourceSubResourceKeys } from "./types.cjs";

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

@@ -0,0 +1,2 @@
+import { ComponentPathVariable, ExtractPathVariables, PATH_VARIABLE_IDENTIFIER, PathHasVariables, PathHead, PathTail, PathVariable, PathVariableIdentifier, ResourcePathVariable, SubResourcePathVariable } from "./variables.mjs";
+import { ConfigResourceKeys, ConfigSubResourceKeys, ParameterizedEntryPath, ParameterizedResourcePath, PathComponentKeys, PathResourceCandidates, PathSubResourceKeys, PathVariables, PathVariablesForResource, ResolveConfigNode, ResolveParameterizedPathValue, ResourceSubResourceKeys } from "./types.mjs";

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

@@ -0,0 +1,123 @@
+const require_component_keys = require('../component-keys.cjs');
+const require_variables = require('./variables.cjs');
+
+//#region src/create-config/paths/introspect.ts
+/** Every branch below `node`, at any depth within the path depth cap. */
+function collectDescendantNodes(node, depth = 6) {
+	if (depth === 0) return [];
+	const nodes = [];
+	for (const key of require_component_keys.readSubResourceKeys(node)) {
+		const subNode = node[key];
+		if (!require_component_keys.isConfigNode(subNode)) continue;
+		nodes.push(subNode, ...collectDescendantNodes(subNode, depth - 1));
+	}
+	return nodes;
+}
+/** Sub-resource keys on `node` and below it, matching the values a nested param accepts. */
+function collectSubResourceKeysBelow(node, depth = 6) {
+	const keys = new Set(require_component_keys.readSubResourceKeys(node));
+	for (const descendant of collectDescendantNodes(node, depth)) for (const key of require_component_keys.readSubResourceKeys(descendant)) keys.add(key);
+	return [...keys];
+}
+/**
+* Whether the segments can be walked from `node`, treating variables as wildcards.
+* Used to narrow which resources a `$resource` path can target.
+*/
+function pathExistsOnNode(node, segments) {
+	if (segments.length === 0) return true;
+	if (!require_component_keys.isConfigNode(node)) return false;
+	const [segment, ...rest] = segments;
+	if (segment === void 0) return true;
+	const variableName = require_variables.readPathVariableName(segment);
+	if (variableName === "subResource") return collectDescendantNodes(node).some((descendant) => pathExistsOnNode(descendant, rest));
+	if (variableName === "component") return require_component_keys.readComponentKeys(node).some((key) => pathExistsOnNode(node[key], rest));
+	if (variableName !== void 0) return false;
+	const next = node[segment];
+	return next !== void 0 && pathExistsOnNode(next, rest);
+}
+/** Resource keys configured in a config map. */
+function collectConfigResources(config) {
+	return Object.keys(config).filter((key) => require_component_keys.isConfigNode(config[key]));
+}
+/**
+* Resources a path can target. A `$resource` path keeps only the resources whose config
+* satisfies the path's fixed segments; a literal path keeps just that resource.
+*/
+function collectPathResources(config, path) {
+	const [head, ...rest] = path.split(".");
+	const resources = collectConfigResources(config);
+	if (head === void 0) return [];
+	if (require_variables.readPathVariableName(head) === "resource") return resources.filter((resource) => pathExistsOnNode(config[resource], rest));
+	return resources.filter((resource) => resource === head && pathExistsOnNode(config[resource], rest));
+}
+/** Nodes a path's fixed prefix resolves to, stopping before `segments` runs out. */
+function collectNodesForSegments(node, segments) {
+	let frontier = [node];
+	for (const segment of segments) {
+		const next = [];
+		const variableName = require_variables.readPathVariableName(segment);
+		for (const current of frontier) {
+			if (variableName === "subResource") {
+				next.push(...collectDescendantNodes(current));
+				continue;
+			}
+			if (variableName === "component") {
+				for (const key of require_component_keys.readComponentKeys(current)) {
+					const value = current[key];
+					if (require_component_keys.isConfigNode(value)) next.push(value);
+				}
+				continue;
+			}
+			if (variableName !== void 0) continue;
+			const value = current[segment];
+			if (require_component_keys.isConfigNode(value)) next.push(value);
+		}
+		frontier = next;
+	}
+	return frontier;
+}
+/** Sub-resource keys valid for the `$subResource` segment of a path. */
+function collectPathSubResourceKeys(config, path) {
+	const segments = path.split(".");
+	const subResourceIndex = segments.findIndex((segment) => require_variables.readPathVariableName(segment) === "subResource");
+	const keys = /* @__PURE__ */ new Set();
+	for (const resource of collectPathResources(config, path)) {
+		const resourceNode = config[resource];
+		if (!require_component_keys.isConfigNode(resourceNode)) continue;
+		const prefix = subResourceIndex === -1 ? [] : segments.slice(1, subResourceIndex);
+		for (const node of collectNodesForSegments(resourceNode, prefix)) for (const key of collectSubResourceKeysBelow(node)) keys.add(key);
+	}
+	return [...keys];
+}
+/** Component slot keys configured on the node a path resolves to. */
+function collectPathComponentKeys(config, path) {
+	const tail = path.split(".").slice(1);
+	const withoutTrailingComponent = require_variables.readPathVariableName(tail.at(-1) ?? "") === "component" ? tail.slice(0, -1) : tail;
+	const keys = /* @__PURE__ */ new Set();
+	for (const resource of collectPathResources(config, path)) {
+		const resourceNode = config[resource];
+		if (!require_component_keys.isConfigNode(resourceNode)) continue;
+		for (const node of collectNodesForSegments(resourceNode, withoutTrailingComponent)) for (const key of require_component_keys.readComponentKeys(node)) keys.add(key);
+	}
+	return [...keys];
+}
+/** Sub-resource keys configured for one resource, at any depth. */
+function collectResourceSubResourceKeys(config, resource) {
+	const resourceNode = config[resource];
+	return require_component_keys.isConfigNode(resourceNode) ? collectSubResourceKeysBelow(resourceNode) : [];
+}
+/** All sub-resource keys configured anywhere in a config map. */
+function collectAllSubResourceKeys(config) {
+	const keys = /* @__PURE__ */ new Set();
+	for (const resource of collectConfigResources(config)) for (const key of collectResourceSubResourceKeys(config, resource)) keys.add(key);
+	return [...keys];
+}
+
+//#endregion
+exports.collectAllSubResourceKeys = collectAllSubResourceKeys;
+exports.collectConfigResources = collectConfigResources;
+exports.collectPathComponentKeys = collectPathComponentKeys;
+exports.collectPathResources = collectPathResources;
+exports.collectPathSubResourceKeys = collectPathSubResourceKeys;
+exports.collectResourceSubResourceKeys = collectResourceSubResourceKeys;
+//# sourceMappingURL=introspect.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"introspect.cjs","names":["readSubResourceKeys","isConfigNode","readPathVariableName","readComponentKeys"],"sources":["../../../src/create-config/paths/introspect.ts"],"sourcesContent":["import {\n  isConfigNode,\n  readComponentKeys,\n  readSubResourceKeys,\n} from '../component-keys';\nimport { MAX_PATH_DEPTH } from './generate';\nimport { readPathVariableName } from './variables';\n\n/** Every branch below `node`, at any depth within the path depth cap. */\nexport function collectDescendantNodes(\n  node: Record<string, unknown>,\n  depth = MAX_PATH_DEPTH,\n): Record<string, unknown>[] {\n  if (depth === 0) {\n    return [];\n  }\n\n  const nodes: Record<string, unknown>[] = [];\n\n  for (const key of readSubResourceKeys(node)) {\n    const subNode = node[key];\n\n    if (!isConfigNode(subNode)) {\n      continue;\n    }\n\n    nodes.push(subNode, ...collectDescendantNodes(subNode, depth - 1));\n  }\n\n  return nodes;\n}\n\n/** Sub-resource keys on `node` and below it, matching the values a nested param accepts. */\nexport function collectSubResourceKeysBelow(\n  node: Record<string, unknown>,\n  depth = MAX_PATH_DEPTH,\n): string[] {\n  const keys = new Set<string>(readSubResourceKeys(node));\n\n  for (const descendant of collectDescendantNodes(node, depth)) {\n    for (const key of readSubResourceKeys(descendant)) {\n      keys.add(key);\n    }\n  }\n\n  return [...keys];\n}\n\n/**\n * Whether the segments can be walked from `node`, treating variables as wildcards.\n * Used to narrow which resources a `$resource` path can target.\n */\nexport function pathExistsOnNode(\n  node: unknown,\n  segments: readonly string[],\n): boolean {\n  if (segments.length === 0) {\n    return true;\n  }\n\n  if (!isConfigNode(node)) {\n    return false;\n  }\n\n  const [segment, ...rest] = segments;\n\n  if (segment === undefined) {\n    return true;\n  }\n\n  const variableName = readPathVariableName(segment);\n\n  if (variableName === 'subResource') {\n    return collectDescendantNodes(node).some((descendant) =>\n      pathExistsOnNode(descendant, rest),\n    );\n  }\n\n  if (variableName === 'component') {\n    return readComponentKeys(node).some((key) =>\n      pathExistsOnNode(node[key], rest),\n    );\n  }\n\n  if (variableName !== undefined) {\n    return false;\n  }\n\n  const next = node[segment];\n\n  return next !== undefined && pathExistsOnNode(next, rest);\n}\n\n/** Resource keys configured in a config map. */\nexport function collectConfigResources(\n  config: Record<string, unknown>,\n): string[] {\n  return Object.keys(config).filter((key) => isConfigNode(config[key]));\n}\n\n/**\n * Resources a path can target. A `$resource` path keeps only the resources whose config\n * satisfies the path's fixed segments; a literal path keeps just that resource.\n */\nexport function collectPathResources(\n  config: Record<string, unknown>,\n  path: string,\n): string[] {\n  const [head, ...rest] = path.split('.');\n  const resources = collectConfigResources(config);\n\n  if (head === undefined) {\n    return [];\n  }\n\n  if (readPathVariableName(head) === 'resource') {\n    return resources.filter((resource) =>\n      pathExistsOnNode(config[resource], rest),\n    );\n  }\n\n  return resources.filter(\n    (resource) => resource === head && pathExistsOnNode(config[resource], rest),\n  );\n}\n\n/** Nodes a path's fixed prefix resolves to, stopping before `segments` runs out. */\nfunction collectNodesForSegments(\n  node: Record<string, unknown>,\n  segments: readonly string[],\n): Record<string, unknown>[] {\n  let frontier: Record<string, unknown>[] = [node];\n\n  for (const segment of segments) {\n    const next: Record<string, unknown>[] = [];\n    const variableName = readPathVariableName(segment);\n\n    for (const current of frontier) {\n      if (variableName === 'subResource') {\n        next.push(...collectDescendantNodes(current));\n        continue;\n      }\n\n      if (variableName === 'component') {\n        for (const key of readComponentKeys(current)) {\n          const value = current[key];\n\n          if (isConfigNode(value)) {\n            next.push(value);\n          }\n        }\n        continue;\n      }\n\n      if (variableName !== undefined) {\n        continue;\n      }\n\n      const value = current[segment];\n\n      if (isConfigNode(value)) {\n        next.push(value);\n      }\n    }\n\n    frontier = next;\n  }\n\n  return frontier;\n}\n\n/** Sub-resource keys valid for the `$subResource` segment of a path. */\nexport function collectPathSubResourceKeys(\n  config: Record<string, unknown>,\n  path: string,\n): string[] {\n  const segments = path.split('.');\n  const subResourceIndex = segments.findIndex(\n    (segment) => readPathVariableName(segment) === 'subResource',\n  );\n  const keys = new Set<string>();\n\n  for (const resource of collectPathResources(config, path)) {\n    const resourceNode = config[resource];\n\n    if (!isConfigNode(resourceNode)) {\n      continue;\n    }\n\n    const prefix =\n      subResourceIndex === -1 ? [] : segments.slice(1, subResourceIndex);\n\n    for (const node of collectNodesForSegments(resourceNode, prefix)) {\n      for (const key of collectSubResourceKeysBelow(node)) {\n        keys.add(key);\n      }\n    }\n  }\n\n  return [...keys];\n}\n\n/** Component slot keys configured on the node a path resolves to. */\nexport function collectPathComponentKeys(\n  config: Record<string, unknown>,\n  path: string,\n): string[] {\n  const segments = path.split('.');\n  const tail = segments.slice(1);\n  const withoutTrailingComponent =\n    readPathVariableName(tail.at(-1) ?? '') === 'component'\n      ? tail.slice(0, -1)\n      : tail;\n  const keys = new Set<string>();\n\n  for (const resource of collectPathResources(config, path)) {\n    const resourceNode = config[resource];\n\n    if (!isConfigNode(resourceNode)) {\n      continue;\n    }\n\n    for (const node of collectNodesForSegments(\n      resourceNode,\n      withoutTrailingComponent,\n    )) {\n      for (const key of readComponentKeys(node)) {\n        keys.add(key);\n      }\n    }\n  }\n\n  return [...keys];\n}\n\n/** Sub-resource keys configured for one resource, at any depth. */\nexport function collectResourceSubResourceKeys(\n  config: Record<string, unknown>,\n  resource: string,\n): string[] {\n  const resourceNode = config[resource];\n\n  return isConfigNode(resourceNode)\n    ? collectSubResourceKeysBelow(resourceNode)\n    : [];\n}\n\n/** All sub-resource keys configured anywhere in a config map. */\nexport function collectAllSubResourceKeys(\n  config: Record<string, unknown>,\n): string[] {\n  const keys = new Set<string>();\n\n  for (const resource of collectConfigResources(config)) {\n    for (const key of collectResourceSubResourceKeys(config, resource)) {\n      keys.add(key);\n    }\n  }\n\n  return [...keys];\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,118 @@
+import { isConfigNode, readComponentKeys, readSubResourceKeys } from "../component-keys.mjs";
+import { readPathVariableName } from "./variables.mjs";
+
+//#region src/create-config/paths/introspect.ts
+/** Every branch below `node`, at any depth within the path depth cap. */
+function collectDescendantNodes(node, depth = 6) {
+	if (depth === 0) return [];
+	const nodes = [];
+	for (const key of readSubResourceKeys(node)) {
+		const subNode = node[key];
+		if (!isConfigNode(subNode)) continue;
+		nodes.push(subNode, ...collectDescendantNodes(subNode, depth - 1));
+	}
+	return nodes;
+}
+/** Sub-resource keys on `node` and below it, matching the values a nested param accepts. */
+function collectSubResourceKeysBelow(node, depth = 6) {
+	const keys = new Set(readSubResourceKeys(node));
+	for (const descendant of collectDescendantNodes(node, depth)) for (const key of readSubResourceKeys(descendant)) keys.add(key);
+	return [...keys];
+}
+/**
+* Whether the segments can be walked from `node`, treating variables as wildcards.
+* Used to narrow which resources a `$resource` path can target.
+*/
+function pathExistsOnNode(node, segments) {
+	if (segments.length === 0) return true;
+	if (!isConfigNode(node)) return false;
+	const [segment, ...rest] = segments;
+	if (segment === void 0) return true;
+	const variableName = readPathVariableName(segment);
+	if (variableName === "subResource") return collectDescendantNodes(node).some((descendant) => pathExistsOnNode(descendant, rest));
+	if (variableName === "component") return readComponentKeys(node).some((key) => pathExistsOnNode(node[key], rest));
+	if (variableName !== void 0) return false;
+	const next = node[segment];
+	return next !== void 0 && pathExistsOnNode(next, rest);
+}
+/** Resource keys configured in a config map. */
+function collectConfigResources(config) {
+	return Object.keys(config).filter((key) => isConfigNode(config[key]));
+}
+/**
+* Resources a path can target. A `$resource` path keeps only the resources whose config
+* satisfies the path's fixed segments; a literal path keeps just that resource.
+*/
+function collectPathResources(config, path) {
+	const [head, ...rest] = path.split(".");
+	const resources = collectConfigResources(config);
+	if (head === void 0) return [];
+	if (readPathVariableName(head) === "resource") return resources.filter((resource) => pathExistsOnNode(config[resource], rest));
+	return resources.filter((resource) => resource === head && pathExistsOnNode(config[resource], rest));
+}
+/** Nodes a path's fixed prefix resolves to, stopping before `segments` runs out. */
+function collectNodesForSegments(node, segments) {
+	let frontier = [node];
+	for (const segment of segments) {
+		const next = [];
+		const variableName = readPathVariableName(segment);
+		for (const current of frontier) {
+			if (variableName === "subResource") {
+				next.push(...collectDescendantNodes(current));
+				continue;
+			}
+			if (variableName === "component") {
+				for (const key of readComponentKeys(current)) {
+					const value = current[key];
+					if (isConfigNode(value)) next.push(value);
+				}
+				continue;
+			}
+			if (variableName !== void 0) continue;
+			const value = current[segment];
+			if (isConfigNode(value)) next.push(value);
+		}
+		frontier = next;
+	}
+	return frontier;
+}
+/** Sub-resource keys valid for the `$subResource` segment of a path. */
+function collectPathSubResourceKeys(config, path) {
+	const segments = path.split(".");
+	const subResourceIndex = segments.findIndex((segment) => readPathVariableName(segment) === "subResource");
+	const keys = /* @__PURE__ */ new Set();
+	for (const resource of collectPathResources(config, path)) {
+		const resourceNode = config[resource];
+		if (!isConfigNode(resourceNode)) continue;
+		const prefix = subResourceIndex === -1 ? [] : segments.slice(1, subResourceIndex);
+		for (const node of collectNodesForSegments(resourceNode, prefix)) for (const key of collectSubResourceKeysBelow(node)) keys.add(key);
+	}
+	return [...keys];
+}
+/** Component slot keys configured on the node a path resolves to. */
+function collectPathComponentKeys(config, path) {
+	const tail = path.split(".").slice(1);
+	const withoutTrailingComponent = readPathVariableName(tail.at(-1) ?? "") === "component" ? tail.slice(0, -1) : tail;
+	const keys = /* @__PURE__ */ new Set();
+	for (const resource of collectPathResources(config, path)) {
+		const resourceNode = config[resource];
+		if (!isConfigNode(resourceNode)) continue;
+		for (const node of collectNodesForSegments(resourceNode, withoutTrailingComponent)) for (const key of readComponentKeys(node)) keys.add(key);
+	}
+	return [...keys];
+}
+/** Sub-resource keys configured for one resource, at any depth. */
+function collectResourceSubResourceKeys(config, resource) {
+	const resourceNode = config[resource];
+	return isConfigNode(resourceNode) ? collectSubResourceKeysBelow(resourceNode) : [];
+}
+/** All sub-resource keys configured anywhere in a config map. */
+function collectAllSubResourceKeys(config) {
+	const keys = /* @__PURE__ */ new Set();
+	for (const resource of collectConfigResources(config)) for (const key of collectResourceSubResourceKeys(config, resource)) keys.add(key);
+	return [...keys];
+}
+
+//#endregion
+export { collectAllSubResourceKeys, collectConfigResources, collectPathComponentKeys, collectPathResources, collectPathSubResourceKeys, collectResourceSubResourceKeys };
+//# sourceMappingURL=introspect.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"introspect.mjs","names":[],"sources":["../../../src/create-config/paths/introspect.ts"],"sourcesContent":["import {\n  isConfigNode,\n  readComponentKeys,\n  readSubResourceKeys,\n} from '../component-keys';\nimport { MAX_PATH_DEPTH } from './generate';\nimport { readPathVariableName } from './variables';\n\n/** Every branch below `node`, at any depth within the path depth cap. */\nexport function collectDescendantNodes(\n  node: Record<string, unknown>,\n  depth = MAX_PATH_DEPTH,\n): Record<string, unknown>[] {\n  if (depth === 0) {\n    return [];\n  }\n\n  const nodes: Record<string, unknown>[] = [];\n\n  for (const key of readSubResourceKeys(node)) {\n    const subNode = node[key];\n\n    if (!isConfigNode(subNode)) {\n      continue;\n    }\n\n    nodes.push(subNode, ...collectDescendantNodes(subNode, depth - 1));\n  }\n\n  return nodes;\n}\n\n/** Sub-resource keys on `node` and below it, matching the values a nested param accepts. */\nexport function collectSubResourceKeysBelow(\n  node: Record<string, unknown>,\n  depth = MAX_PATH_DEPTH,\n): string[] {\n  const keys = new Set<string>(readSubResourceKeys(node));\n\n  for (const descendant of collectDescendantNodes(node, depth)) {\n    for (const key of readSubResourceKeys(descendant)) {\n      keys.add(key);\n    }\n  }\n\n  return [...keys];\n}\n\n/**\n * Whether the segments can be walked from `node`, treating variables as wildcards.\n * Used to narrow which resources a `$resource` path can target.\n */\nexport function pathExistsOnNode(\n  node: unknown,\n  segments: readonly string[],\n): boolean {\n  if (segments.length === 0) {\n    return true;\n  }\n\n  if (!isConfigNode(node)) {\n    return false;\n  }\n\n  const [segment, ...rest] = segments;\n\n  if (segment === undefined) {\n    return true;\n  }\n\n  const variableName = readPathVariableName(segment);\n\n  if (variableName === 'subResource') {\n    return collectDescendantNodes(node).some((descendant) =>\n      pathExistsOnNode(descendant, rest),\n    );\n  }\n\n  if (variableName === 'component') {\n    return readComponentKeys(node).some((key) =>\n      pathExistsOnNode(node[key], rest),\n    );\n  }\n\n  if (variableName !== undefined) {\n    return false;\n  }\n\n  const next = node[segment];\n\n  return next !== undefined && pathExistsOnNode(next, rest);\n}\n\n/** Resource keys configured in a config map. */\nexport function collectConfigResources(\n  config: Record<string, unknown>,\n): string[] {\n  return Object.keys(config).filter((key) => isConfigNode(config[key]));\n}\n\n/**\n * Resources a path can target. A `$resource` path keeps only the resources whose config\n * satisfies the path's fixed segments; a literal path keeps just that resource.\n */\nexport function collectPathResources(\n  config: Record<string, unknown>,\n  path: string,\n): string[] {\n  const [head, ...rest] = path.split('.');\n  const resources = collectConfigResources(config);\n\n  if (head === undefined) {\n    return [];\n  }\n\n  if (readPathVariableName(head) === 'resource') {\n    return resources.filter((resource) =>\n      pathExistsOnNode(config[resource], rest),\n    );\n  }\n\n  return resources.filter(\n    (resource) => resource === head && pathExistsOnNode(config[resource], rest),\n  );\n}\n\n/** Nodes a path's fixed prefix resolves to, stopping before `segments` runs out. */\nfunction collectNodesForSegments(\n  node: Record<string, unknown>,\n  segments: readonly string[],\n): Record<string, unknown>[] {\n  let frontier: Record<string, unknown>[] = [node];\n\n  for (const segment of segments) {\n    const next: Record<string, unknown>[] = [];\n    const variableName = readPathVariableName(segment);\n\n    for (const current of frontier) {\n      if (variableName === 'subResource') {\n        next.push(...collectDescendantNodes(current));\n        continue;\n      }\n\n      if (variableName === 'component') {\n        for (const key of readComponentKeys(current)) {\n          const value = current[key];\n\n          if (isConfigNode(value)) {\n            next.push(value);\n          }\n        }\n        continue;\n      }\n\n      if (variableName !== undefined) {\n        continue;\n      }\n\n      const value = current[segment];\n\n      if (isConfigNode(value)) {\n        next.push(value);\n      }\n    }\n\n    frontier = next;\n  }\n\n  return frontier;\n}\n\n/** Sub-resource keys valid for the `$subResource` segment of a path. */\nexport function collectPathSubResourceKeys(\n  config: Record<string, unknown>,\n  path: string,\n): string[] {\n  const segments = path.split('.');\n  const subResourceIndex = segments.findIndex(\n    (segment) => readPathVariableName(segment) === 'subResource',\n  );\n  const keys = new Set<string>();\n\n  for (const resource of collectPathResources(config, path)) {\n    const resourceNode = config[resource];\n\n    if (!isConfigNode(resourceNode)) {\n      continue;\n    }\n\n    const prefix =\n      subResourceIndex === -1 ? [] : segments.slice(1, subResourceIndex);\n\n    for (const node of collectNodesForSegments(resourceNode, prefix)) {\n      for (const key of collectSubResourceKeysBelow(node)) {\n        keys.add(key);\n      }\n    }\n  }\n\n  return [...keys];\n}\n\n/** Component slot keys configured on the node a path resolves to. */\nexport function collectPathComponentKeys(\n  config: Record<string, unknown>,\n  path: string,\n): string[] {\n  const segments = path.split('.');\n  const tail = segments.slice(1);\n  const withoutTrailingComponent =\n    readPathVariableName(tail.at(-1) ?? '') === 'component'\n      ? tail.slice(0, -1)\n      : tail;\n  const keys = new Set<string>();\n\n  for (const resource of collectPathResources(config, path)) {\n    const resourceNode = config[resource];\n\n    if (!isConfigNode(resourceNode)) {\n      continue;\n    }\n\n    for (const node of collectNodesForSegments(\n      resourceNode,\n      withoutTrailingComponent,\n    )) {\n      for (const key of readComponentKeys(node)) {\n        keys.add(key);\n      }\n    }\n  }\n\n  return [...keys];\n}\n\n/** Sub-resource keys configured for one resource, at any depth. */\nexport function collectResourceSubResourceKeys(\n  config: Record<string, unknown>,\n  resource: string,\n): string[] {\n  const resourceNode = config[resource];\n\n  return isConfigNode(resourceNode)\n    ? collectSubResourceKeysBelow(resourceNode)\n    : [];\n}\n\n/** All sub-resource keys configured anywhere in a config map. */\nexport function collectAllSubResourceKeys(\n  config: Record<string, unknown>,\n): string[] {\n  const keys = new Set<string>();\n\n  for (const resource of collectConfigResources(config)) {\n    for (const key of collectResourceSubResourceKeys(config, resource)) {\n      keys.add(key);\n    }\n  }\n\n  return [...keys];\n}\n"],"mappings":"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"}

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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"}