@jfdevelops/react-layout 0.17.5 → 0.18.1

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

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

package/dist/create-config/is-sub-resource-key.cjs

@@ -0,0 +1,15 @@
+const require_introspect = require('./paths/introspect.cjs');
+
+//#region src/create-config/is-sub-resource-key.ts
+function createIsSubResourceKey(config) {
+	return (key, options) => {
+		if (typeof key !== "string") return false;
+		if (options.path !== void 0) return require_introspect.collectPathSubResourceKeys(config, options.path).includes(key);
+		if (options.resource !== void 0) return require_introspect.collectResourceSubResourceKeys(config, options.resource).includes(key);
+		return false;
+	};
+}
+
+//#endregion
+exports.createIsSubResourceKey = createIsSubResourceKey;
+//# sourceMappingURL=is-sub-resource-key.cjs.map

package/dist/create-config/is-sub-resource-key.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-sub-resource-key.cjs","names":["collectPathSubResourceKeys","collectResourceSubResourceKeys"],"sources":["../../src/create-config/is-sub-resource-key.ts"],"sourcesContent":["import type { ResourceDefinition } from '../resource';\nimport {\n  collectPathSubResourceKeys,\n  collectResourceSubResourceKeys,\n} from './paths';\nimport type {\n  ConfigResourceKeys,\n  PathSubResourceKeys,\n  ResourceSubResourceKeys,\n} from './paths';\n\n/** Either a path whose `$subResource` segment supplies the valid keys, or one resource. */\nexport type IsSubResourceKeyOptions<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Config,\n  AllowedPath extends string,\n> =\n  | { path: AllowedPath; resource?: never }\n  | { resource: ConfigResourceKeys<Resources, Config>; path?: never };\n\nexport type IsSubResourceKeyResult<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Config,\n  Options,\n> = Options extends { path: infer Path extends string }\n  ? PathSubResourceKeys<Resources, Config, Path>\n  : Options extends { resource: infer Resource }\n    ? ResourceSubResourceKeys<Config, Resource>\n    : never;\n\n/**\n * Narrows an unknown value to a configured sub-resource key.\n *\n * @example\n * ```ts\n * if (isSubResourceKey(slug, { resource: 'templates' })) {\n *   // slug is 'deleted' | 'expired'\n * }\n * ```\n */\nexport type IsSubResourceKey<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Config,\n  AllowedPath extends string,\n> = <\n  const Options extends IsSubResourceKeyOptions<Resources, Config, AllowedPath>,\n>(\n  key: unknown,\n  options: Options,\n) => key is IsSubResourceKeyResult<Resources, Config, Options>;\n\nexport function createIsSubResourceKey(config: Record<string, unknown>) {\n  return (\n    key: unknown,\n    options: { path?: string; resource?: string },\n  ): boolean => {\n    if (typeof key !== 'string') {\n      return false;\n    }\n\n    if (options.path !== undefined) {\n      return collectPathSubResourceKeys(config, options.path).includes(key);\n    }\n\n    if (options.resource !== undefined) {\n      return collectResourceSubResourceKeys(config, options.resource).includes(\n        key,\n      );\n    }\n\n    return false;\n  };\n}\n"],"mappings":";;;AAmDA,SAAgB,uBAAuB,QAAiC;CACtE,QACE,KACA,YACY;EACZ,IAAI,OAAO,QAAQ,UACjB,OAAO;EAGT,IAAI,QAAQ,SAAS,QACnB,OAAOA,8CAA2B,QAAQ,QAAQ,IAAI,EAAE,SAAS,GAAG;EAGtE,IAAI,QAAQ,aAAa,QACvB,OAAOC,kDAA+B,QAAQ,QAAQ,QAAQ,EAAE,SAC9D,GACF;EAGF,OAAO;CACT;AACF"}

package/dist/create-config/is-sub-resource-key.d.cts

@@ -0,0 +1,30 @@
+import { ResourceDefinition } from "../resource.cjs";
+import { ConfigResourceKeys, PathSubResourceKeys, ResourceSubResourceKeys } from "./paths/types.cjs";
+//#region src/create-config/is-sub-resource-key.d.ts
+/** Either a path whose `$subResource` segment supplies the valid keys, or one resource. */
+type IsSubResourceKeyOptions<Resources extends ReadonlyArray<ResourceDefinition>, Config, AllowedPath extends string> = {
+  path: AllowedPath;
+  resource?: never;
+} | {
+  resource: ConfigResourceKeys<Resources, Config>;
+  path?: never;
+};
+type IsSubResourceKeyResult<Resources extends ReadonlyArray<ResourceDefinition>, Config, Options> = Options extends {
+  path: infer Path extends string;
+} ? PathSubResourceKeys<Resources, Config, Path> : Options extends {
+  resource: infer Resource;
+} ? ResourceSubResourceKeys<Config, Resource> : never;
+/**
+ * Narrows an unknown value to a configured sub-resource key.
+ *
+ * @example
+ * ```ts
+ * if (isSubResourceKey(slug, { resource: 'templates' })) {
+ *   // slug is 'deleted' | 'expired'
+ * }
+ * ```
+ */
+type IsSubResourceKey<Resources extends ReadonlyArray<ResourceDefinition>, Config, AllowedPath extends string> = <const Options extends IsSubResourceKeyOptions<Resources, Config, AllowedPath>>(key: unknown, options: Options) => key is IsSubResourceKeyResult<Resources, Config, Options>;
+//#endregion
+export { IsSubResourceKey, IsSubResourceKeyOptions, IsSubResourceKeyResult };
+//# sourceMappingURL=is-sub-resource-key.d.cts.map

package/dist/create-config/is-sub-resource-key.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-sub-resource-key.d.cts","names":[],"sources":["../../src/create-config/is-sub-resource-key.ts"],"mappings":";;;;KAYY,uBAAA,mBACQ,aAAA,CAAc,kBAAA;EAI5B,IAAA,EAAM,WAAA;EAAa,QAAA;AAAA;EACnB,QAAA,EAAU,kBAAA,CAAmB,SAAA,EAAW,MAAA;EAAS,IAAA;AAAA;AAAA,KAE3C,sBAAA,mBACQ,aAAA,CAAc,kBAAA,sBAG9B,OAAA;EAAkB,IAAA;AAAA,IAClB,mBAAA,CAAoB,SAAA,EAAW,MAAA,EAAQ,IAAA,IACvC,OAAA;EAAkB,QAAA;AAAA,IAChB,uBAAA,CAAwB,MAAA,EAAQ,QAAA;;;;;;;;;;;KAa1B,gBAAA,mBACQ,aAAA,CAAc,kBAAA,gEAIV,uBAAA,CAAwB,SAAA,EAAW,MAAA,EAAQ,WAAA,GAEjE,GAAA,WACA,OAAA,EAAS,OAAA,KACN,GAAA,IAAO,sBAAA,CAAuB,SAAA,EAAW,MAAA,EAAQ,OAAA"}

package/dist/create-config/is-sub-resource-key.d.mts

@@ -0,0 +1,30 @@
+import { ResourceDefinition } from "../resource.mjs";
+import { ConfigResourceKeys, PathSubResourceKeys, ResourceSubResourceKeys } from "./paths/types.mjs";
+//#region src/create-config/is-sub-resource-key.d.ts
+/** Either a path whose `$subResource` segment supplies the valid keys, or one resource. */
+type IsSubResourceKeyOptions<Resources extends ReadonlyArray<ResourceDefinition>, Config, AllowedPath extends string> = {
+  path: AllowedPath;
+  resource?: never;
+} | {
+  resource: ConfigResourceKeys<Resources, Config>;
+  path?: never;
+};
+type IsSubResourceKeyResult<Resources extends ReadonlyArray<ResourceDefinition>, Config, Options> = Options extends {
+  path: infer Path extends string;
+} ? PathSubResourceKeys<Resources, Config, Path> : Options extends {
+  resource: infer Resource;
+} ? ResourceSubResourceKeys<Config, Resource> : never;
+/**
+ * Narrows an unknown value to a configured sub-resource key.
+ *
+ * @example
+ * ```ts
+ * if (isSubResourceKey(slug, { resource: 'templates' })) {
+ *   // slug is 'deleted' | 'expired'
+ * }
+ * ```
+ */
+type IsSubResourceKey<Resources extends ReadonlyArray<ResourceDefinition>, Config, AllowedPath extends string> = <const Options extends IsSubResourceKeyOptions<Resources, Config, AllowedPath>>(key: unknown, options: Options) => key is IsSubResourceKeyResult<Resources, Config, Options>;
+//#endregion
+export { IsSubResourceKey, IsSubResourceKeyOptions, IsSubResourceKeyResult };
+//# sourceMappingURL=is-sub-resource-key.d.mts.map

package/dist/create-config/is-sub-resource-key.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-sub-resource-key.d.mts","names":[],"sources":["../../src/create-config/is-sub-resource-key.ts"],"mappings":";;;;KAYY,uBAAA,mBACQ,aAAA,CAAc,kBAAA;EAI5B,IAAA,EAAM,WAAA;EAAa,QAAA;AAAA;EACnB,QAAA,EAAU,kBAAA,CAAmB,SAAA,EAAW,MAAA;EAAS,IAAA;AAAA;AAAA,KAE3C,sBAAA,mBACQ,aAAA,CAAc,kBAAA,sBAG9B,OAAA;EAAkB,IAAA;AAAA,IAClB,mBAAA,CAAoB,SAAA,EAAW,MAAA,EAAQ,IAAA,IACvC,OAAA;EAAkB,QAAA;AAAA,IAChB,uBAAA,CAAwB,MAAA,EAAQ,QAAA;;;;;;;;;;;KAa1B,gBAAA,mBACQ,aAAA,CAAc,kBAAA,gEAIV,uBAAA,CAAwB,SAAA,EAAW,MAAA,EAAQ,WAAA,GAEjE,GAAA,WACA,OAAA,EAAS,OAAA,KACN,GAAA,IAAO,sBAAA,CAAuB,SAAA,EAAW,MAAA,EAAQ,OAAA"}

package/dist/create-config/is-sub-resource-key.mjs

@@ -0,0 +1,15 @@
+import { collectPathSubResourceKeys, collectResourceSubResourceKeys } from "./paths/introspect.mjs";
+
+//#region src/create-config/is-sub-resource-key.ts
+function createIsSubResourceKey(config) {
+	return (key, options) => {
+		if (typeof key !== "string") return false;
+		if (options.path !== void 0) return collectPathSubResourceKeys(config, options.path).includes(key);
+		if (options.resource !== void 0) return collectResourceSubResourceKeys(config, options.resource).includes(key);
+		return false;
+	};
+}
+
+//#endregion
+export { createIsSubResourceKey };
+//# sourceMappingURL=is-sub-resource-key.mjs.map

package/dist/create-config/is-sub-resource-key.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-sub-resource-key.mjs","names":[],"sources":["../../src/create-config/is-sub-resource-key.ts"],"sourcesContent":["import type { ResourceDefinition } from '../resource';\nimport {\n  collectPathSubResourceKeys,\n  collectResourceSubResourceKeys,\n} from './paths';\nimport type {\n  ConfigResourceKeys,\n  PathSubResourceKeys,\n  ResourceSubResourceKeys,\n} from './paths';\n\n/** Either a path whose `$subResource` segment supplies the valid keys, or one resource. */\nexport type IsSubResourceKeyOptions<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Config,\n  AllowedPath extends string,\n> =\n  | { path: AllowedPath; resource?: never }\n  | { resource: ConfigResourceKeys<Resources, Config>; path?: never };\n\nexport type IsSubResourceKeyResult<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Config,\n  Options,\n> = Options extends { path: infer Path extends string }\n  ? PathSubResourceKeys<Resources, Config, Path>\n  : Options extends { resource: infer Resource }\n    ? ResourceSubResourceKeys<Config, Resource>\n    : never;\n\n/**\n * Narrows an unknown value to a configured sub-resource key.\n *\n * @example\n * ```ts\n * if (isSubResourceKey(slug, { resource: 'templates' })) {\n *   // slug is 'deleted' | 'expired'\n * }\n * ```\n */\nexport type IsSubResourceKey<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Config,\n  AllowedPath extends string,\n> = <\n  const Options extends IsSubResourceKeyOptions<Resources, Config, AllowedPath>,\n>(\n  key: unknown,\n  options: Options,\n) => key is IsSubResourceKeyResult<Resources, Config, Options>;\n\nexport function createIsSubResourceKey(config: Record<string, unknown>) {\n  return (\n    key: unknown,\n    options: { path?: string; resource?: string },\n  ): boolean => {\n    if (typeof key !== 'string') {\n      return false;\n    }\n\n    if (options.path !== undefined) {\n      return collectPathSubResourceKeys(config, options.path).includes(key);\n    }\n\n    if (options.resource !== undefined) {\n      return collectResourceSubResourceKeys(config, options.resource).includes(\n        key,\n      );\n    }\n\n    return false;\n  };\n}\n"],"mappings":";;;AAmDA,SAAgB,uBAAuB,QAAiC;CACtE,QACE,KACA,YACY;EACZ,IAAI,OAAO,QAAQ,UACjB,OAAO;EAGT,IAAI,QAAQ,SAAS,QACnB,OAAO,2BAA2B,QAAQ,QAAQ,IAAI,EAAE,SAAS,GAAG;EAGtE,IAAI,QAAQ,aAAa,QACvB,OAAO,+BAA+B,QAAQ,QAAQ,QAAQ,EAAE,SAC9D,GACF;EAGF,OAAO;CACT;AACF"}

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

@@ -0,0 +1,77 @@
+const require_component_keys = require('../component-keys.cjs');
+const require_variables = require('./variables.cjs');
+
+//#region src/create-config/paths/generate.ts
+/** Recursion cap for generated paths. Must stay aligned with `MaxPathDepth` in `./types`. */
+const MAX_PATH_DEPTH = 6;
+const RESOURCE_VARIABLE = require_variables.createPathVariable("resource");
+const SUB_RESOURCE_VARIABLE = require_variables.createPathVariable("subResource");
+const COMPONENT_VARIABLE = require_variables.createPathVariable("component");
+/** Component tails on one node: its slots, its shared branches, and `$component`. */
+function collectComponentTails(node) {
+	const tails = [];
+	for (const key of require_component_keys.COMPONENT_SLOT_KEYS) if (node[key] !== void 0) tails.push(key);
+	if (require_component_keys.readComponentKeys(node).length > 0) tails.push(COMPONENT_VARIABLE);
+	for (const branch of require_component_keys.SHARED_BRANCH_KEYS) {
+		const branchNode = node[branch];
+		if (!require_component_keys.isConfigNode(branchNode)) continue;
+		tails.push(branch);
+		for (const key of require_component_keys.COMPONENT_SLOT_KEYS) if (branchNode[key] !== void 0) tails.push(`${branch}.${key}`);
+		if (require_component_keys.readComponentKeys(branchNode).length > 0) tails.push(`${branch}.${COMPONENT_VARIABLE}`);
+	}
+	return tails;
+}
+/**
+* Component tails valid after a `$subResource` segment: one variable stands for the whole
+* sub-resource chain, so every descendant's tails are reachable.
+*/
+function collectDescendantComponentTails(node, depth) {
+	if (depth === 0) return [];
+	const tails = /* @__PURE__ */ new Set();
+	for (const key of require_component_keys.readSubResourceKeys(node)) {
+		const subNode = node[key];
+		if (!require_component_keys.isConfigNode(subNode)) continue;
+		for (const tail of collectComponentTails(subNode)) tails.add(tail);
+		for (const tail of collectDescendantComponentTails(subNode, depth - 1)) tails.add(tail);
+	}
+	return [...tails];
+}
+/** Every path tail valid below one config node. */
+function collectEntryPaths(node, depth) {
+	if (depth === 0) return [];
+	const paths = new Set(collectComponentTails(node));
+	const subResourceKeys = require_component_keys.readSubResourceKeys(node);
+	if (subResourceKeys.length > 0) {
+		paths.add(SUB_RESOURCE_VARIABLE);
+		for (const tail of collectDescendantComponentTails(node, depth)) paths.add(`${SUB_RESOURCE_VARIABLE}.${tail}`);
+	}
+	for (const key of subResourceKeys) {
+		const subNode = node[key];
+		paths.add(key);
+		if (!require_component_keys.isConfigNode(subNode)) continue;
+		for (const nested of collectEntryPaths(subNode, depth - 1)) paths.add(`${key}.${nested}`);
+	}
+	return [...paths];
+}
+/**
+* Paths a config accepts, with resource and sub-resource segments available both as
+* literals and as variables. Runtime twin of `ParameterizedResourcePath`.
+*/
+function generateResourceConfigPaths(config) {
+	const paths = /* @__PURE__ */ new Set();
+	for (const resource of Object.keys(config)) {
+		const resourceNode = config[resource];
+		if (!require_component_keys.isConfigNode(resourceNode)) continue;
+		paths.add(resource);
+		paths.add(RESOURCE_VARIABLE);
+		for (const tail of collectEntryPaths(resourceNode, 6)) {
+			paths.add(`${resource}.${tail}`);
+			paths.add(`${RESOURCE_VARIABLE}.${tail}`);
+		}
+	}
+	return [...paths];
+}
+
+//#endregion
+exports.generateResourceConfigPaths = generateResourceConfigPaths;
+//# sourceMappingURL=generate.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generate.cjs","names":["createPathVariable","COMPONENT_SLOT_KEYS","readComponentKeys","SHARED_BRANCH_KEYS","isConfigNode","readSubResourceKeys"],"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,oBAA0CA,qCAAmB,UAAU;AAC7E,MAAM,wBACJA,qCAAmB,aAAa;AAClC,MAAM,qBACJA,qCAAmB,WAAW;;AAGhC,SAAS,sBAAsB,MAAyC;CACtE,MAAM,QAAkB,CAAC;CAEzB,KAAK,MAAM,OAAOC,4CAChB,IAAI,KAAK,SAAS,QAChB,MAAM,KAAK,GAAG;CAIlB,IAAIC,yCAAkB,IAAI,EAAE,SAAS,GACnC,MAAM,KAAK,kBAAkB;CAG/B,KAAK,MAAM,UAAUC,2CAAoB;EACvC,MAAM,aAAa,KAAK;EAExB,IAAI,CAACC,oCAAa,UAAU,GAC1B;EAGF,MAAM,KAAK,MAAM;EAEjB,KAAK,MAAM,OAAOH,4CAChB,IAAI,WAAW,SAAS,QACtB,MAAM,KAAK,GAAG,OAAO,GAAG,KAAK;EAIjC,IAAIC,yCAAkB,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,OAAOG,2CAAoB,IAAI,GAAG;EAC3C,MAAM,UAAU,KAAK;EAErB,IAAI,CAACD,oCAAa,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,kBAAkBC,2CAAoB,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,CAACD,oCAAa,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,CAACA,oCAAa,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/generate.mjs

@@ -0,0 +1,77 @@
+import { COMPONENT_SLOT_KEYS, SHARED_BRANCH_KEYS, isConfigNode, readComponentKeys, readSubResourceKeys } from "../component-keys.mjs";
+import { createPathVariable } from "./variables.mjs";
+
+//#region src/create-config/paths/generate.ts
+/** Recursion cap for generated paths. Must stay aligned with `MaxPathDepth` in `./types`. */
+const MAX_PATH_DEPTH = 6;
+const RESOURCE_VARIABLE = createPathVariable("resource");
+const SUB_RESOURCE_VARIABLE = createPathVariable("subResource");
+const COMPONENT_VARIABLE = createPathVariable("component");
+/** Component tails on one node: its slots, its shared branches, and `$component`. */
+function collectComponentTails(node) {
+	const tails = [];
+	for (const key of COMPONENT_SLOT_KEYS) if (node[key] !== void 0) tails.push(key);
+	if (readComponentKeys(node).length > 0) tails.push(COMPONENT_VARIABLE);
+	for (const branch of SHARED_BRANCH_KEYS) {
+		const branchNode = node[branch];
+		if (!isConfigNode(branchNode)) continue;
+		tails.push(branch);
+		for (const key of COMPONENT_SLOT_KEYS) if (branchNode[key] !== void 0) tails.push(`${branch}.${key}`);
+		if (readComponentKeys(branchNode).length > 0) tails.push(`${branch}.${COMPONENT_VARIABLE}`);
+	}
+	return tails;
+}
+/**
+* Component tails valid after a `$subResource` segment: one variable stands for the whole
+* sub-resource chain, so every descendant's tails are reachable.
+*/
+function collectDescendantComponentTails(node, depth) {
+	if (depth === 0) return [];
+	const tails = /* @__PURE__ */ new Set();
+	for (const key of readSubResourceKeys(node)) {
+		const subNode = node[key];
+		if (!isConfigNode(subNode)) continue;
+		for (const tail of collectComponentTails(subNode)) tails.add(tail);
+		for (const tail of collectDescendantComponentTails(subNode, depth - 1)) tails.add(tail);
+	}
+	return [...tails];
+}
+/** Every path tail valid below one config node. */
+function collectEntryPaths(node, depth) {
+	if (depth === 0) return [];
+	const paths = new Set(collectComponentTails(node));
+	const subResourceKeys = readSubResourceKeys(node);
+	if (subResourceKeys.length > 0) {
+		paths.add(SUB_RESOURCE_VARIABLE);
+		for (const tail of collectDescendantComponentTails(node, depth)) paths.add(`${SUB_RESOURCE_VARIABLE}.${tail}`);
+	}
+	for (const key of subResourceKeys) {
+		const subNode = node[key];
+		paths.add(key);
+		if (!isConfigNode(subNode)) continue;
+		for (const nested of collectEntryPaths(subNode, depth - 1)) paths.add(`${key}.${nested}`);
+	}
+	return [...paths];
+}
+/**
+* Paths a config accepts, with resource and sub-resource segments available both as
+* literals and as variables. Runtime twin of `ParameterizedResourcePath`.
+*/
+function generateResourceConfigPaths(config) {
+	const paths = /* @__PURE__ */ new Set();
+	for (const resource of Object.keys(config)) {
+		const resourceNode = config[resource];
+		if (!isConfigNode(resourceNode)) continue;
+		paths.add(resource);
+		paths.add(RESOURCE_VARIABLE);
+		for (const tail of collectEntryPaths(resourceNode, 6)) {
+			paths.add(`${resource}.${tail}`);
+			paths.add(`${RESOURCE_VARIABLE}.${tail}`);
+		}
+	}
+	return [...paths];
+}
+
+//#endregion
+export { generateResourceConfigPaths };
+//# sourceMappingURL=generate.mjs.map

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