@wtf/project-config 1.1.0 → 1.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -110,7 +110,10 @@ const format = await resolveNamed<Format>(configured.format, {
110
110
 
111
111
  A name of no entry throws a `NamedError` of `UNKNOWN_NAME`, which lists the names there are; a
112
112
  module that fails to load, `UNLOADABLE_MODULE`; an export it has not, `MISSING_EXPORT`; and a value
113
- of the wrong shape, or one the `check` you pass refuses, `INVALID_NAMED_VALUE`. `nodeLoadModule`
113
+ of the wrong shape, or one the `check` you pass refuses, `INVALID_NAMED_VALUE`. Each names where
114
+ it failed: its `at` path, from the `at` you pass, the index of the `set` and the name of the
115
+ `entry`, and the `module` and `export` a value came from. With `checkResults: true`, `check` also
116
+ checks what each function entry gives. `nodeLoadModule`
114
117
  loads a path from the root, and a package the root installs, else one installed beside your tool.
115
118
  `namedSchema('format', { names, options })` and `namedSetSchema({ entry })` give the schema of a
116
119
  reference and of the sets, so an editor completes the names.
package/dist/env.js CHANGED
@@ -48,16 +48,52 @@ function schemasOf(node, root, seen = new Set()) {
48
48
  const propertyOf = (node, root, key) => schemasOf(node, root).flatMap((schema) => isNode(schema.properties) && Object.hasOwn(schema.properties, key)
49
49
  ? [schema.properties[key]]
50
50
  : []);
51
- /** Whether a value of the schemas `nodes` is only ever a string: of a `type` `string`, a `const`
52
- * or an `enum` of strings, each branch of it so. */
53
- function onlyString(nodes, root) {
51
+ /** Whether the schemas `nodes`, of the document `root`, take a string: one of them, or a branch of
52
+ * one, of a `type` `string`, a `const` or an `enum` of strings, or a union of such branches. */
53
+ function takesString(nodes, root) {
54
54
  const schemas = nodes.flatMap((node) => schemasOf(node, root));
55
55
  return schemas.some((schema) => schema.type === 'string' ||
56
56
  typeof schema.const === 'string' ||
57
57
  (Array.isArray(schema.enum) && schema.enum.every((value) => typeof value === 'string')) ||
58
58
  ['anyOf', 'oneOf'].some((key) => Array.isArray(schema[key]) &&
59
- schema[key].every((branch) => onlyString([branch], root))));
59
+ schema[key].every((branch) => takesString([branch], root))));
60
60
  }
61
+ /** The types of JSON `value` is of: `integer` beside `number` of a whole number. */
62
+ const typesOf = (value) => value === null
63
+ ? ['null']
64
+ : Array.isArray(value)
65
+ ? ['array']
66
+ : typeof value === 'number'
67
+ ? Number.isInteger(value)
68
+ ? ['number', 'integer']
69
+ : ['number']
70
+ : [typeof value];
71
+ /**
72
+ * Whether the schema `node`, of the document `root`, takes a value of the type of `value`: of its
73
+ * `type`, `const` and `enum`, each of its `allOf`, and some branch of its `anyOf` and `oneOf`, each
74
+ * by its `$ref`; a schema that says none of those takes any value.
75
+ */
76
+ function takes(node, value, root, seen = new Set()) {
77
+ const schema = derefOf(node, root);
78
+ if (typeof schema === 'boolean')
79
+ return schema;
80
+ if (!isNode(schema) || seen.has(schema))
81
+ return true;
82
+ const within = new Set(seen).add(schema);
83
+ const { type } = schema;
84
+ const types = typeof type === 'string' ? [type] : Array.isArray(type) ? type : undefined;
85
+ const text = JSON.stringify(value);
86
+ const branches = (key) => Array.isArray(schema[key]) ? schema[key] : [];
87
+ return ((types === undefined || typesOf(value).some((each) => types.includes(each))) &&
88
+ (!('const' in schema) || JSON.stringify(schema.const) === text) &&
89
+ (!Array.isArray(schema.enum) || schema.enum.some((each) => JSON.stringify(each) === text)) &&
90
+ branches('allOf').every((branch) => takes(branch, value, root, within)) &&
91
+ ['anyOf', 'oneOf'].every((key) => branches(key).length === 0 ||
92
+ branches(key).some((branch) => takes(branch, value, root, within))));
93
+ }
94
+ /** Whether each of the schemas `nodes`, of the document `root`, takes a value of the type of
95
+ * `value` ({@link takes}). */
96
+ const takenBy = (nodes, value, root) => nodes.every((node) => takes(node, value, root));
61
97
  /** The keys a value can have, as the value `value` and the schemas `nodes` name them, the
62
98
  * longest of them as a variable names it first, so `API_KEY` is `apiKey` before it is `api.key`. */
63
99
  function keysOf(value, nodes, root) {
@@ -86,17 +122,23 @@ function pathOf(rest, value, nodes, root) {
86
122
  }
87
123
  return undefined;
88
124
  }
89
- /** The value of a variable's text: the text of a value that is only ever a string, else its JSON,
90
- * else the text. */
125
+ /**
126
+ * The value of a variable's text, of the schemas `nodes`: its JSON, of a value of a type they take
127
+ * other than a string, so `2` is a number and `[2, "newest"]` a list where a value may be a name,
128
+ * a number or a list; else the text where they take a string, so a name stays a name, and JSON
129
+ * that is no value they take is the text; else its JSON, else the text.
130
+ */
91
131
  function parsedOf(text, nodes, root) {
92
- if (onlyString(nodes, root))
93
- return text;
132
+ let parsed;
94
133
  try {
95
- return JSON.parse(text);
134
+ parsed = JSON.parse(text);
96
135
  }
97
136
  catch {
98
137
  return text;
99
138
  }
139
+ if (typeof parsed !== 'string' && takenBy(nodes, parsed, root))
140
+ return parsed;
141
+ return takesString(nodes, root) ? text : parsed;
100
142
  }
101
143
  /** `value` with `over` at `path`, merged over what is there ({@link mergeSection}). */
102
144
  function withValueAt(value, path, over) {
package/dist/env.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The configuration of a project, as the environment overrides it: a variable of the prefix of its\n * names, of the key of package.json by default, as `WTF_` of the key `wtf` ({@link envPrefixOf}),\n * followed by the path of a value, each key as a variable names it ({@link envNameOf}):\n * `WTF_VITE_COMPRESS` sets `wtf.vite.compress`. A key is one a value under it already has, or one\n * the schema of its section names, so `apiKey` is `API_KEY` and no `_` is ever taken for a key it\n * is not. A value is JSON, else the text as it is, and the text always of a value the schema takes\n * only as a string. {@link variablesOf} gives the variables of a prefix, and\n * {@link withEnvironment} a value with them over it, as `sectionOf` of ./section reads a section.\n * The variables are what a caller gives, as `loadConfig` of ./load takes them: nothing here reads\n * the environment of a process.\n *\n * ```ts\n * withEnvironment({ compress: { threshold: 1024 } }, { WTF_VITE_COMPRESS_THRESHOLD: '512' }, 'WTF_VITE_')\n * // { value: { compress: { threshold: 512 } }, set: [{ variable: 'WTF_VITE_COMPRESS_THRESHOLD', path: ['compress', 'threshold'] }] }\n * ```\n *\n * @packageDocumentation\n */\nimport type { StandardJSONSchemaV1 } from '@standard-schema/spec'\n\nimport type { ConfigPath, JsonSchema } from './index.ts'\nimport { mergeSection } from './merge.ts'\n\n/** The variables of an environment, by their names, as a process's environment holds them. */\nexport type Environment = Readonly<Record<string, string | undefined>>\n\n/** A variable of the environment that set a value of the configuration: its name, and the path\n * of the value. */\nexport type EnvironmentValue = {\n readonly variable: string\n readonly path: ConfigPath\n}\n\n/** A value with the environment over it: the value, and each variable that set some of it. */\nexport type WithEnvironment = {\n readonly value: unknown\n readonly set: readonly EnvironmentValue[]\n}\n\n/**\n * A name as a variable of the environment writes it: its words in capitals, joined by `_`, a word\n * of camelCase its own, as `apiKey` is `API_KEY`, and any other character a `_`.\n */\nexport const envNameOf = (name: string): string =>\n name\n .replaceAll(/([a-z\\d])([A-Z])/g, '$1_$2')\n .replaceAll(/[^A-Za-z\\d]+/g, '_')\n .replaceAll(/^_|_$/g, '')\n .toUpperCase()\n\n/** The prefix of the variables of the environment of `name`, the key of package.json by default:\n * {@link envNameOf} it, and `_`, as `wtf` is `WTF_` and `wtf-vite` `WTF_VITE_`. */\nexport const envPrefixOf = (name: string): string => `${envNameOf(name)}_`\n\n/** The variables of `environment` of `prefix`, as {@link envPrefixOf} gives it, each set and not\n * empty, by their names. */\nexport function variablesOf(environment: Environment, prefix: string): Record<string, string> {\n const variables: Record<string, string> = {}\n for (const [name, value] of Object.entries(environment))\n if (\n name.startsWith(prefix) &&\n name.length > prefix.length &&\n value !== undefined &&\n value !== ''\n )\n variables[name] = value\n return variables\n}\n\ntype Node = Readonly<Record<string, unknown>>\n\nconst isNode = (value: unknown): value is Node =>\n typeof value === 'object' && value !== null && !Array.isArray(value)\n\n/** The node a `$ref` of the document `root` names, as `#/$defs/api`; the node itself of none. */\nfunction derefOf(node: unknown, root: unknown): unknown {\n if (!isNode(node) || typeof node.$ref !== 'string' || !node.$ref.startsWith('#')) return node\n let at: unknown = root\n for (const part of node.$ref.slice(1).split('/').filter(Boolean))\n at = isNode(at) ? at[part.replaceAll('~1', '/').replaceAll('~0', '~')] : undefined\n return at\n}\n\n/** The schemas `node` is, of the document `root`: itself, and each of its `allOf`, `anyOf` and\n * `oneOf`, each by its `$ref`. */\nfunction schemasOf(node: unknown, root: unknown, seen = new Set<unknown>()): Node[] {\n const schema = derefOf(node, root)\n if (!isNode(schema) || seen.has(schema)) return []\n seen.add(schema)\n const branches = ['allOf', 'anyOf', 'oneOf'].flatMap((key) =>\n Array.isArray(schema[key]) ? (schema[key] as unknown[]) : []\n )\n return [schema, ...branches.flatMap((branch) => schemasOf(branch, root, seen))]\n}\n\n/** The schema of the key `key` of a value of the schema `node`: of each of its `properties` that\n * names it. */\nconst propertyOf = (node: unknown, root: unknown, key: string): unknown[] =>\n schemasOf(node, root).flatMap((schema) =>\n isNode(schema.properties) && Object.hasOwn(schema.properties, key)\n ? [schema.properties[key]]\n : []\n )\n\n/** Whether a value of the schemas `nodes` is only ever a string: of a `type` `string`, a `const`\n * or an `enum` of strings, each branch of it so. */\nfunction onlyString(nodes: readonly unknown[], root: unknown): boolean {\n const schemas = nodes.flatMap((node) => schemasOf(node, root))\n return schemas.some(\n (schema) =>\n schema.type === 'string' ||\n typeof schema.const === 'string' ||\n (Array.isArray(schema.enum) && schema.enum.every((value) => typeof value === 'string')) ||\n (['anyOf', 'oneOf'] as const).some(\n (key) =>\n Array.isArray(schema[key]) &&\n (schema[key] as unknown[]).every((branch) => onlyString([branch], root))\n )\n )\n}\n\n/** The keys a value can have, as the value `value` and the schemas `nodes` name them, the\n * longest of them as a variable names it first, so `API_KEY` is `apiKey` before it is `api.key`. */\nfunction keysOf(value: unknown, nodes: readonly unknown[], root: unknown): string[] {\n const keys = new Set(isNode(value) ? Object.keys(value) : [])\n for (const schema of nodes.flatMap((node) => schemasOf(node, root)))\n if (isNode(schema.properties)) for (const key of Object.keys(schema.properties)) keys.add(key)\n return [...keys].toSorted((a, b) => envNameOf(b).length - envNameOf(a).length)\n}\n\n/** The path the rest of a variable's name, `rest`, names in `value`, of the schemas `nodes`, and\n * the schemas of the value there; `undefined` when it names no key there is. */\nfunction pathOf(\n rest: string,\n value: unknown,\n nodes: readonly unknown[],\n root: unknown\n): { readonly path: string[]; readonly nodes: readonly unknown[] } | undefined {\n for (const key of keysOf(value, nodes, root)) {\n const name = envNameOf(key)\n if (name === '') continue\n const under = nodes.flatMap((node) => propertyOf(node, root, key))\n if (rest === name) return { path: [key], nodes: under }\n if (rest.startsWith(`${name}_`)) {\n const found = pathOf(\n rest.slice(name.length + 1),\n isNode(value) ? value[key] : undefined,\n under,\n root\n )\n if (found !== undefined) return { path: [key, ...found.path], nodes: found.nodes }\n }\n }\n return undefined\n}\n\n/** The value of a variable's text: the text of a value that is only ever a string, else its JSON,\n * else the text. */\nfunction parsedOf(text: string, nodes: readonly unknown[], root: unknown): unknown {\n if (onlyString(nodes, root)) return text\n try {\n return JSON.parse(text) as unknown\n } catch {\n return text\n }\n}\n\n/** `value` with `over` at `path`, merged over what is there ({@link mergeSection}). */\nfunction withValueAt(value: unknown, path: ConfigPath, over: unknown): unknown {\n const [key, ...rest] = path\n if (key === undefined) return mergeSection(value, over)\n const object = isNode(value) ? value : {}\n return { ...object, [key]: withValueAt(object[key], rest, over) }\n}\n\n/**\n * The JSON Schema of `schema`, as a tool checks its section by it: the schema itself, of a JSON\n * Schema; of a Standard Schema that gives one, as zod's does, the JSON Schema of its input; else\n * none, of a function, or a schema that gives none.\n */\nexport function jsonSchemaOf(schema: unknown): JsonSchema | undefined {\n if (typeof schema === 'boolean') return schema\n if (!isNode(schema)) return undefined\n if (!('~standard' in schema)) return schema\n const converter = (schema as Partial<StandardJSONSchemaV1>)['~standard']?.jsonSchema\n if (converter === undefined) return undefined\n try {\n return converter.input({ target: 'draft-2020-12' })\n } catch {\n return undefined\n }\n}\n\n/**\n * `value` with the variables `variables` of `prefix` over it: each variable that names a path of\n * a key there is, in `value` or in `schema`, a JSON Schema of it, sets the value at that path,\n * merged over what is there ({@link mergeSection}), and the variable of the prefix itself, without\n * its last `_`, the whole value, a variable of a shorter path first, so `WTF_VITE_COMPRESS_THRESHOLD`\n * is over what `WTF_VITE` sets, of the prefix `WTF_VITE_`. A variable that names no key there\n * is is passed over.\n */\nexport function withEnvironment(\n value: unknown,\n variables: Readonly<Record<string, string>>,\n prefix: string,\n schema?: JsonSchema\n): WithEnvironment {\n const nodes = schema === undefined ? [] : [schema]\n const whole = prefix.slice(0, -1)\n const found = Object.entries(variables).flatMap(([variable, text]) => {\n const at =\n variable === whole\n ? { path: [], nodes }\n : variable.startsWith(prefix)\n ? pathOf(variable.slice(prefix.length), value, nodes, schema)\n : undefined\n return at === undefined\n ? []\n : [{ variable, path: at.path, value: parsedOf(text, at.nodes, schema) }]\n })\n let result = value\n const set: EnvironmentValue[] = []\n for (const { variable, path, value: over } of found.toSorted(\n (a, b) => a.path.length - b.path.length || a.variable.localeCompare(b.variable)\n )) {\n result = withValueAt(result, path, over)\n set.push({ variable, path })\n }\n return { value: result, set }\n}\n"]}
1
+ {"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The configuration of a project, as the environment overrides it: a variable of the prefix of its\n * names, of the key of package.json by default, as `WTF_` of the key `wtf` ({@link envPrefixOf}),\n * followed by the path of a value, each key as a variable names it ({@link envNameOf}):\n * `WTF_VITE_COMPRESS` sets `wtf.vite.compress`. A key is one a value under it already has, or one\n * the schema of its section names, so `apiKey` is `API_KEY` and no `_` is ever taken for a key it\n * is not. A value is JSON of a type the schema takes other than a string, else the text as it is\n * where the schema takes a string, so `2` is a number and a name stays a name where a value is\n * either; of no schema, JSON, else the text. {@link variablesOf} gives the variables of a prefix, and\n * {@link withEnvironment} a value with them over it, as `sectionOf` of ./section reads a section.\n * The variables are what a caller gives, as `loadConfig` of ./load takes them: nothing here reads\n * the environment of a process.\n *\n * ```ts\n * withEnvironment({ compress: { threshold: 1024 } }, { WTF_VITE_COMPRESS_THRESHOLD: '512' }, 'WTF_VITE_')\n * // { value: { compress: { threshold: 512 } }, set: [{ variable: 'WTF_VITE_COMPRESS_THRESHOLD', path: ['compress', 'threshold'] }] }\n * ```\n *\n * @packageDocumentation\n */\nimport type { StandardJSONSchemaV1 } from '@standard-schema/spec'\n\nimport type { ConfigPath, JsonSchema } from './index.ts'\nimport { mergeSection } from './merge.ts'\n\n/** The variables of an environment, by their names, as a process's environment holds them. */\nexport type Environment = Readonly<Record<string, string | undefined>>\n\n/** A variable of the environment that set a value of the configuration: its name, and the path\n * of the value. */\nexport type EnvironmentValue = {\n readonly variable: string\n readonly path: ConfigPath\n}\n\n/** A value with the environment over it: the value, and each variable that set some of it. */\nexport type WithEnvironment = {\n readonly value: unknown\n readonly set: readonly EnvironmentValue[]\n}\n\n/**\n * A name as a variable of the environment writes it: its words in capitals, joined by `_`, a word\n * of camelCase its own, as `apiKey` is `API_KEY`, and any other character a `_`.\n */\nexport const envNameOf = (name: string): string =>\n name\n .replaceAll(/([a-z\\d])([A-Z])/g, '$1_$2')\n .replaceAll(/[^A-Za-z\\d]+/g, '_')\n .replaceAll(/^_|_$/g, '')\n .toUpperCase()\n\n/** The prefix of the variables of the environment of `name`, the key of package.json by default:\n * {@link envNameOf} it, and `_`, as `wtf` is `WTF_` and `wtf-vite` `WTF_VITE_`. */\nexport const envPrefixOf = (name: string): string => `${envNameOf(name)}_`\n\n/** The variables of `environment` of `prefix`, as {@link envPrefixOf} gives it, each set and not\n * empty, by their names. */\nexport function variablesOf(environment: Environment, prefix: string): Record<string, string> {\n const variables: Record<string, string> = {}\n for (const [name, value] of Object.entries(environment))\n if (\n name.startsWith(prefix) &&\n name.length > prefix.length &&\n value !== undefined &&\n value !== ''\n )\n variables[name] = value\n return variables\n}\n\ntype Node = Readonly<Record<string, unknown>>\n\nconst isNode = (value: unknown): value is Node =>\n typeof value === 'object' && value !== null && !Array.isArray(value)\n\n/** The node a `$ref` of the document `root` names, as `#/$defs/api`; the node itself of none. */\nfunction derefOf(node: unknown, root: unknown): unknown {\n if (!isNode(node) || typeof node.$ref !== 'string' || !node.$ref.startsWith('#')) return node\n let at: unknown = root\n for (const part of node.$ref.slice(1).split('/').filter(Boolean))\n at = isNode(at) ? at[part.replaceAll('~1', '/').replaceAll('~0', '~')] : undefined\n return at\n}\n\n/** The schemas `node` is, of the document `root`: itself, and each of its `allOf`, `anyOf` and\n * `oneOf`, each by its `$ref`. */\nfunction schemasOf(node: unknown, root: unknown, seen = new Set<unknown>()): Node[] {\n const schema = derefOf(node, root)\n if (!isNode(schema) || seen.has(schema)) return []\n seen.add(schema)\n const branches = ['allOf', 'anyOf', 'oneOf'].flatMap((key) =>\n Array.isArray(schema[key]) ? (schema[key] as unknown[]) : []\n )\n return [schema, ...branches.flatMap((branch) => schemasOf(branch, root, seen))]\n}\n\n/** The schema of the key `key` of a value of the schema `node`: of each of its `properties` that\n * names it. */\nconst propertyOf = (node: unknown, root: unknown, key: string): unknown[] =>\n schemasOf(node, root).flatMap((schema) =>\n isNode(schema.properties) && Object.hasOwn(schema.properties, key)\n ? [schema.properties[key]]\n : []\n )\n\n/** Whether the schemas `nodes`, of the document `root`, take a string: one of them, or a branch of\n * one, of a `type` `string`, a `const` or an `enum` of strings, or a union of such branches. */\nfunction takesString(nodes: readonly unknown[], root: unknown): boolean {\n const schemas = nodes.flatMap((node) => schemasOf(node, root))\n return schemas.some(\n (schema) =>\n schema.type === 'string' ||\n typeof schema.const === 'string' ||\n (Array.isArray(schema.enum) && schema.enum.every((value) => typeof value === 'string')) ||\n (['anyOf', 'oneOf'] as const).some(\n (key) =>\n Array.isArray(schema[key]) &&\n (schema[key] as unknown[]).every((branch) => takesString([branch], root))\n )\n )\n}\n\n/** The types of JSON `value` is of: `integer` beside `number` of a whole number. */\nconst typesOf = (value: unknown): readonly string[] =>\n value === null\n ? ['null']\n : Array.isArray(value)\n ? ['array']\n : typeof value === 'number'\n ? Number.isInteger(value)\n ? ['number', 'integer']\n : ['number']\n : [typeof value]\n\n/**\n * Whether the schema `node`, of the document `root`, takes a value of the type of `value`: of its\n * `type`, `const` and `enum`, each of its `allOf`, and some branch of its `anyOf` and `oneOf`, each\n * by its `$ref`; a schema that says none of those takes any value.\n */\nfunction takes(node: unknown, value: unknown, root: unknown, seen = new Set<unknown>()): boolean {\n const schema = derefOf(node, root)\n if (typeof schema === 'boolean') return schema\n if (!isNode(schema) || seen.has(schema)) return true\n const within = new Set(seen).add(schema)\n const { type } = schema\n const types = typeof type === 'string' ? [type] : Array.isArray(type) ? type : undefined\n const text = JSON.stringify(value)\n const branches = (key: string): unknown[] =>\n Array.isArray(schema[key]) ? (schema[key] as unknown[]) : []\n return (\n (types === undefined || typesOf(value).some((each) => types.includes(each))) &&\n (!('const' in schema) || JSON.stringify(schema.const) === text) &&\n (!Array.isArray(schema.enum) || schema.enum.some((each) => JSON.stringify(each) === text)) &&\n branches('allOf').every((branch) => takes(branch, value, root, within)) &&\n (['anyOf', 'oneOf'] as const).every(\n (key) =>\n branches(key).length === 0 ||\n branches(key).some((branch) => takes(branch, value, root, within))\n )\n )\n}\n\n/** Whether each of the schemas `nodes`, of the document `root`, takes a value of the type of\n * `value` ({@link takes}). */\nconst takenBy = (nodes: readonly unknown[], value: unknown, root: unknown): boolean =>\n nodes.every((node) => takes(node, value, root))\n\n/** The keys a value can have, as the value `value` and the schemas `nodes` name them, the\n * longest of them as a variable names it first, so `API_KEY` is `apiKey` before it is `api.key`. */\nfunction keysOf(value: unknown, nodes: readonly unknown[], root: unknown): string[] {\n const keys = new Set(isNode(value) ? Object.keys(value) : [])\n for (const schema of nodes.flatMap((node) => schemasOf(node, root)))\n if (isNode(schema.properties)) for (const key of Object.keys(schema.properties)) keys.add(key)\n return [...keys].toSorted((a, b) => envNameOf(b).length - envNameOf(a).length)\n}\n\n/** The path the rest of a variable's name, `rest`, names in `value`, of the schemas `nodes`, and\n * the schemas of the value there; `undefined` when it names no key there is. */\nfunction pathOf(\n rest: string,\n value: unknown,\n nodes: readonly unknown[],\n root: unknown\n): { readonly path: string[]; readonly nodes: readonly unknown[] } | undefined {\n for (const key of keysOf(value, nodes, root)) {\n const name = envNameOf(key)\n if (name === '') continue\n const under = nodes.flatMap((node) => propertyOf(node, root, key))\n if (rest === name) return { path: [key], nodes: under }\n if (rest.startsWith(`${name}_`)) {\n const found = pathOf(\n rest.slice(name.length + 1),\n isNode(value) ? value[key] : undefined,\n under,\n root\n )\n if (found !== undefined) return { path: [key, ...found.path], nodes: found.nodes }\n }\n }\n return undefined\n}\n\n/**\n * The value of a variable's text, of the schemas `nodes`: its JSON, of a value of a type they take\n * other than a string, so `2` is a number and `[2, \"newest\"]` a list where a value may be a name,\n * a number or a list; else the text where they take a string, so a name stays a name, and JSON\n * that is no value they take is the text; else its JSON, else the text.\n */\nfunction parsedOf(text: string, nodes: readonly unknown[], root: unknown): unknown {\n let parsed: unknown\n try {\n parsed = JSON.parse(text) as unknown\n } catch {\n return text\n }\n if (typeof parsed !== 'string' && takenBy(nodes, parsed, root)) return parsed\n return takesString(nodes, root) ? text : parsed\n}\n\n/** `value` with `over` at `path`, merged over what is there ({@link mergeSection}). */\nfunction withValueAt(value: unknown, path: ConfigPath, over: unknown): unknown {\n const [key, ...rest] = path\n if (key === undefined) return mergeSection(value, over)\n const object = isNode(value) ? value : {}\n return { ...object, [key]: withValueAt(object[key], rest, over) }\n}\n\n/**\n * The JSON Schema of `schema`, as a tool checks its section by it: the schema itself, of a JSON\n * Schema; of a Standard Schema that gives one, as zod's does, the JSON Schema of its input; else\n * none, of a function, or a schema that gives none.\n */\nexport function jsonSchemaOf(schema: unknown): JsonSchema | undefined {\n if (typeof schema === 'boolean') return schema\n if (!isNode(schema)) return undefined\n if (!('~standard' in schema)) return schema\n const converter = (schema as Partial<StandardJSONSchemaV1>)['~standard']?.jsonSchema\n if (converter === undefined) return undefined\n try {\n return converter.input({ target: 'draft-2020-12' })\n } catch {\n return undefined\n }\n}\n\n/**\n * `value` with the variables `variables` of `prefix` over it: each variable that names a path of\n * a key there is, in `value` or in `schema`, a JSON Schema of it, sets the value at that path,\n * merged over what is there ({@link mergeSection}), and the variable of the prefix itself, without\n * its last `_`, the whole value, a variable of a shorter path first, so `WTF_VITE_COMPRESS_THRESHOLD`\n * is over what `WTF_VITE` sets, of the prefix `WTF_VITE_`. A variable that names no key there\n * is is passed over.\n */\nexport function withEnvironment(\n value: unknown,\n variables: Readonly<Record<string, string>>,\n prefix: string,\n schema?: JsonSchema\n): WithEnvironment {\n const nodes = schema === undefined ? [] : [schema]\n const whole = prefix.slice(0, -1)\n const found = Object.entries(variables).flatMap(([variable, text]) => {\n const at =\n variable === whole\n ? { path: [], nodes }\n : variable.startsWith(prefix)\n ? pathOf(variable.slice(prefix.length), value, nodes, schema)\n : undefined\n return at === undefined\n ? []\n : [{ variable, path: at.path, value: parsedOf(text, at.nodes, schema) }]\n })\n let result = value\n const set: EnvironmentValue[] = []\n for (const { variable, path, value: over } of found.toSorted(\n (a, b) => a.path.length - b.path.length || a.variable.localeCompare(b.variable)\n )) {\n result = withValueAt(result, path, over)\n set.push({ variable, path })\n }\n return { value: result, set }\n}\n"]}
package/dist/errors.d.ts CHANGED
@@ -157,16 +157,22 @@ export declare class SyncSchemaError extends ConfigError {
157
157
  * of its shape, or that its check refuses.
158
158
  */
159
159
  export type NamedErrorCode = 'UNKNOWN_NAME' | 'UNLOADABLE_MODULE' | 'MISSING_EXPORT' | 'INVALID_NAMED_VALUE';
160
- /** What a {@link NamedError} names, of its code: the name and those there are, the module and its
161
- * export, or the issues of a check. */
160
+ /** What a {@link NamedError} names, of its code: where it failed, the name and those there are,
161
+ * the module and its export, or the issues of a check. */
162
162
  export type NamedErrorDetails = {
163
+ /** Where the value that failed is, by its path from what the caller gave, of any code. */
164
+ readonly at?: ConfigPath;
165
+ /** The index of the set that failed in the array of sets, of any code. */
166
+ readonly set?: number;
167
+ /** The name of the entry that failed, of a set or of a reference, of any code. */
168
+ readonly entry?: string;
163
169
  /** The name of no entry, of `UNKNOWN_NAME`. */
164
170
  readonly name?: string;
165
171
  /** The names of the entries there are, of `UNKNOWN_NAME`. */
166
172
  readonly names?: readonly string[];
167
- /** The module, of `UNLOADABLE_MODULE` and `MISSING_EXPORT`. */
173
+ /** The module, of `UNLOADABLE_MODULE` and `MISSING_EXPORT`, and of a value it exports. */
168
174
  readonly module?: string;
169
- /** The name of its export, of `UNLOADABLE_MODULE` and `MISSING_EXPORT`. */
175
+ /** The name of its export, of `UNLOADABLE_MODULE` and `MISSING_EXPORT`, and of a value it exports. */
170
176
  readonly export?: string;
171
177
  /** What the check found wrong, of `INVALID_NAMED_VALUE`. */
172
178
  readonly issues?: readonly ConfigIssue[];
@@ -174,18 +180,30 @@ export type NamedErrorDetails = {
174
180
  /**
175
181
  * A reference of ./named that cannot be resolved, of a stable code of {@link NamedErrorCode}: a
176
182
  * name of no entry, whose message lists the names there are; a module that fails to load; an
177
- * export it has not; or a reference, a set or a value of no shape it takes. A tool maps each code
178
- * to its own, as it chooses.
183
+ * export it has not; or a reference, a set or a value of no shape it takes. Of any code, it names
184
+ * where it failed: its path, `at`, the index of its `set` and the name of its `entry`, and the
185
+ * `module` and `export` a value came from. A tool maps each code to its own, as it chooses.
179
186
  */
180
187
  export declare class NamedError extends ConfigError {
181
188
  readonly code: NamedErrorCode;
189
+ /**
190
+ * Where the value that failed is, by its path from what the caller gave: the path the caller
191
+ * gives as `at`, the index of the set in an array of sets, and the name of the entry, as
192
+ * `['formatters', '1', 'wide']`; empty when nothing narrows it.
193
+ */
194
+ readonly at: ConfigPath;
195
+ /** The index of the set that failed in the array of sets: none of one set alone, or of a reference. */
196
+ readonly set: number | undefined;
197
+ /** The name of the entry that failed, of a set or of the one a reference names: none of others. */
198
+ readonly entry: string | undefined;
182
199
  /** The name of no entry, of `UNKNOWN_NAME`. */
183
200
  readonly unknown: string | undefined;
184
201
  /** The names of the entries there are, of `UNKNOWN_NAME`; none of any other code. */
185
202
  readonly names: readonly string[];
186
- /** The module, of `UNLOADABLE_MODULE` and `MISSING_EXPORT`. */
203
+ /** The module, of `UNLOADABLE_MODULE` and `MISSING_EXPORT`, and of a value it exports. */
187
204
  readonly module: string | undefined;
188
- /** The name of the export of the module, of `UNLOADABLE_MODULE` and `MISSING_EXPORT`. */
205
+ /** The name of the export of the module, of `UNLOADABLE_MODULE` and `MISSING_EXPORT`, and of a
206
+ * value it exports. */
189
207
  readonly export: string | undefined;
190
208
  /** What the check found wrong, of `INVALID_NAMED_VALUE` of a value it refuses; none of others. */
191
209
  readonly issues: readonly ConfigIssue[];
package/dist/errors.js CHANGED
@@ -175,22 +175,37 @@ export class SyncSchemaError extends ConfigError {
175
175
  /**
176
176
  * A reference of ./named that cannot be resolved, of a stable code of {@link NamedErrorCode}: a
177
177
  * name of no entry, whose message lists the names there are; a module that fails to load; an
178
- * export it has not; or a reference, a set or a value of no shape it takes. A tool maps each code
179
- * to its own, as it chooses.
178
+ * export it has not; or a reference, a set or a value of no shape it takes. Of any code, it names
179
+ * where it failed: its path, `at`, the index of its `set` and the name of its `entry`, and the
180
+ * `module` and `export` a value came from. A tool maps each code to its own, as it chooses.
180
181
  */
181
182
  export class NamedError extends ConfigError {
183
+ /**
184
+ * Where the value that failed is, by its path from what the caller gave: the path the caller
185
+ * gives as `at`, the index of the set in an array of sets, and the name of the entry, as
186
+ * `['formatters', '1', 'wide']`; empty when nothing narrows it.
187
+ */
188
+ at;
189
+ /** The index of the set that failed in the array of sets: none of one set alone, or of a reference. */
190
+ set;
191
+ /** The name of the entry that failed, of a set or of the one a reference names: none of others. */
192
+ entry;
182
193
  /** The name of no entry, of `UNKNOWN_NAME`. */
183
194
  unknown;
184
195
  /** The names of the entries there are, of `UNKNOWN_NAME`; none of any other code. */
185
196
  names;
186
- /** The module, of `UNLOADABLE_MODULE` and `MISSING_EXPORT`. */
197
+ /** The module, of `UNLOADABLE_MODULE` and `MISSING_EXPORT`, and of a value it exports. */
187
198
  module;
188
- /** The name of the export of the module, of `UNLOADABLE_MODULE` and `MISSING_EXPORT`. */
199
+ /** The name of the export of the module, of `UNLOADABLE_MODULE` and `MISSING_EXPORT`, and of a
200
+ * value it exports. */
189
201
  export;
190
202
  /** What the check found wrong, of `INVALID_NAMED_VALUE` of a value it refuses; none of others. */
191
203
  issues;
192
204
  constructor(code, message, details = {}, options) {
193
205
  super(code, message, options);
206
+ this.at = details.at ?? [];
207
+ this.set = details.set;
208
+ this.entry = details.entry;
194
209
  this.unknown = details.name;
195
210
  this.names = details.names ?? [];
196
211
  this.module = details.module;
@@ -1 +1 @@
1
- {"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * What `@wtf/project-config` throws, each a {@link ConfigError} of a stable `code`:\n * {@link InvalidConfigFileError}, a file of the configuration that holds no object;\n * {@link InvalidSectionError}, a section its tool's schema refuses; {@link ConfigPathError}, a path\n * that names no value; {@link ConfigInCodeError}, a write to a configuration of code;\n * {@link NoConfigFileError}, a write with no package.json to hold it;\n * {@link ConfigFileMismatchError}, a write to a file that is not the one in use;\n * {@link UnwritableConfigFileError}, a write to a file that is never written;\n * {@link NoConfigValueError}, a value asked for that is not set; and\n * {@link EnvPlaceholderUnsetError}, a value that points at a variable of the environment that is\n * not set; {@link SyncConfigInCodeError}, a configuration of code loaded synchronously; and\n * {@link SyncSchemaError}, a section checked synchronously by a schema that checks asynchronously;\n * and {@link NamedError}, a reference of ./named that names no entry, or a module, an export or a\n * value that is not what it says. One that the arguments of a person cause exits 2.\n *\n * @packageDocumentation\n */\nimport type { ConfigIssue, ConfigPath } from './index.ts'\nimport { textOfPath } from './text.ts'\n\n/** What this package throws: an Error with a stable SCREAMING_SNAKE `code`, and the `exitCode` a\n * command that fails by it exits with, 1 by default. */\nexport class ConfigError extends Error {\n readonly code: string\n /** What a command that fails by it exits with. */\n readonly exitCode: number = 1\n\n constructor(code: string, message: string, options?: ErrorOptions) {\n super(message, options)\n this.code = code\n this.name = new.target.name\n }\n}\n\n/**\n * A file of the configuration that holds no configuration: no JSON, no object, or a module that\n * fails to load, or exports no object.\n */\nexport class InvalidConfigFileError extends ConfigError {\n /** The file, by its absolute path. */\n readonly file: string\n\n constructor(file: string, reason: string, options?: ErrorOptions) {\n super('INVALID_CONFIG_FILE', `${file}: ${reason}`, options)\n this.file = file\n }\n}\n\n/**\n * A section of the configuration that the schema of its tool refuses: each issue, by the file and\n * the path of the value, from the key that names the configuration, the namespace by default.\n */\nexport class InvalidSectionError extends ConfigError {\n /** The file of the configuration, by its absolute path. */\n readonly file: string\n /** The section, by its name. */\n readonly section: string\n /** What is wrong, each by its path in the section. */\n readonly issues: readonly ConfigIssue[]\n\n constructor(\n file: string,\n namespace: string,\n section: string,\n issues: readonly ConfigIssue[],\n key: string = namespace\n ) {\n super(\n 'INVALID_CONFIG_SECTION',\n [\n `${file}: the ${section} section of the ${namespace} configuration is not valid:`,\n ...issues.map(({ path, message }) => ` ${textOfPath([key, section, ...path])}: ${message}`)\n ].join('\\n')\n )\n this.file = file\n this.section = section\n this.issues = issues\n }\n}\n\n/**\n * A path of the configuration that names no value to read or write: an empty one, or one that\n * goes into a value that is no object or list. A usage failure: it exits 2.\n */\nexport class ConfigPathError extends ConfigError {\n /** The path, as it was given. */\n readonly path: string\n override readonly exitCode: number = 2\n\n constructor(path: string, reason: string) {\n super('INVALID_CONFIG_PATH', `${path === '' ? 'The path' : path} ${reason}`)\n this.path = path\n }\n}\n\n/**\n * A write to a configuration of code, as `wtf.config.mjs`, `wtf.config.js` or `wtf.config.ts`: code\n * is changed by a person, and not by a tool. Its message names what is written: the JSON files, and\n * the key of package.json.\n */\nexport class ConfigInCodeError extends ConfigError {\n /** The file of code, by its absolute path. */\n readonly file: string\n\n constructor(file: string, written: { readonly files: readonly string[]; readonly key: string }) {\n const names = [...written.files, `the \"${written.key}\" key of package.json`]\n super(\n 'CONFIG_IN_CODE',\n `The configuration is code, in ${file}: change it there. Only ${names.join(' and ')} ${names.length === 1 ? 'is' : 'are'} written.`\n )\n this.file = file\n }\n}\n\n/**\n * A write to the configuration of a project that has none, in the key of package.json, the\n * default, where the root has no package.json. Its message names the key, and the JSON file to make\n * it in instead, if there is one. A usage failure: it exits 2.\n */\nexport class NoConfigFileError extends ConfigError {\n /** The root of the project. */\n readonly root: string\n override readonly exitCode: number = 2\n\n constructor(\n root: string,\n {\n namespace,\n key = namespace,\n json\n }: { readonly namespace: string; readonly key?: string; readonly json?: string | undefined }\n ) {\n super(\n 'NO_CONFIG_FILE',\n `No package.json is in ${root} to hold the ${namespace} configuration in its \"${key}\" key: make one there${json === undefined ? '' : `, or name ${json} to make the configuration in`}.`\n )\n this.root = root\n }\n}\n\n/**\n * A write to a file of the configuration that is not the one in use, as its JSON file named where\n * package.json holds it. A usage failure: it exits 2.\n */\nexport class ConfigFileMismatchError extends ConfigError {\n /** The file that holds the configuration, by its absolute path. */\n readonly file: string\n /** The file named. */\n readonly named: string\n override readonly exitCode: number = 2\n\n constructor(file: string, named: string) {\n super(\n 'CONFIG_FILE_MISMATCH',\n `The configuration is in ${file}, and not in ${named}: write it there, or move it.`\n )\n this.file = file\n this.named = named\n }\n}\n\n/**\n * A write to a file that is no JSON file of the names of the configuration, nor package.json: one\n * of code, or one its names do not hold. Its message names those that are written. A usage\n * failure: it exits 2.\n */\nexport class UnwritableConfigFileError extends ConfigError {\n /** The file named. */\n readonly named: string\n override readonly exitCode: number = 2\n\n constructor(named: string, written: readonly string[]) {\n super(\n 'UNWRITABLE_CONFIG_FILE',\n `${named} is no file the configuration is written to: name ${[...written, 'package.json'].join(' or ')}.`\n )\n this.named = named\n }\n}\n\n/** A value of the configuration that is not set, which was asked for. */\nexport class NoConfigValueError extends ConfigError {\n /** The path, as it was given. */\n readonly path: string\n /** The file of the configuration, by its absolute path, or `undefined` when there is none. */\n readonly file: string | undefined\n\n constructor(path: string, file: string | undefined) {\n super(\n 'NO_CONFIG_VALUE',\n file === undefined\n ? `${path} is not set: the project has no configuration.`\n : `${path} is not set in ${file}.`\n )\n this.path = path\n this.file = file\n }\n}\n\n/**\n * A value of the configuration that points at a variable of the environment, by a placeholder\n * `${env:NAME}`, which is not set, or is empty. Its message names the path of the value, from the\n * key that names the configuration, and the variable, and holds no value.\n */\nexport class EnvPlaceholderUnsetError extends ConfigError {\n /** The path of the value that holds the placeholder. */\n readonly path: ConfigPath\n /** The name of the variable of the environment. */\n readonly variable: string\n\n constructor(path: ConfigPath, variable: string) {\n super(\n 'CONFIG_ENV_PLACEHOLDER_UNSET',\n `${textOfPath(path)}: points at the variable ${variable} of the environment by \\${env:${variable}}, which is not set, or is empty.`\n )\n this.path = path\n this.variable = variable\n }\n}\n\n/**\n * A configuration of code, as `wtf.config.ts`, loaded synchronously, as `loadConfigSync` of ./load\n * loads it for a tool that reads its config synchronously: code is imported, which is\n * asynchronous. Its message names the files a synchronous load reads, JSON and package.json's key.\n */\nexport class SyncConfigInCodeError extends ConfigError {\n /** The file of code, by its absolute path. */\n readonly file: string\n\n constructor(file: string, read: { readonly files: readonly string[]; readonly key: string }) {\n const names = [...read.files, `the \"${read.key}\" key of package.json`]\n super(\n 'CONFIG_IN_CODE_SYNC',\n `The configuration is code, in ${file}, which a synchronous load cannot import: write it in ${names.join(' or ')}, or load it with loadConfig.`\n )\n this.file = file\n }\n}\n\n/**\n * A section checked synchronously, as `sectionOfSync` of ./section checks it, by a schema that\n * checks asynchronously: a Standard Schema whose `validate` gives a promise, or a function that\n * does.\n */\nexport class SyncSchemaError extends ConfigError {\n /** The section, by its name. */\n readonly section: string\n\n constructor(section: string) {\n super(\n 'SCHEMA_NOT_SYNC',\n `The schema of the ${section} section checks it asynchronously: read it with sectionOf.`\n )\n this.section = section\n }\n}\n\n/**\n * The codes of a {@link NamedError}: `UNKNOWN_NAME`, a reference of a name of no entry;\n * `UNLOADABLE_MODULE`, a module that fails to load, or of no loader given; `MISSING_EXPORT`, an\n * export the module has not; and `INVALID_NAMED_VALUE`, a reference, a set or a value that is not\n * of its shape, or that its check refuses.\n */\nexport type NamedErrorCode =\n | 'UNKNOWN_NAME'\n | 'UNLOADABLE_MODULE'\n | 'MISSING_EXPORT'\n | 'INVALID_NAMED_VALUE'\n\n/** What a {@link NamedError} names, of its code: the name and those there are, the module and its\n * export, or the issues of a check. */\nexport type NamedErrorDetails = {\n /** The name of no entry, of `UNKNOWN_NAME`. */\n readonly name?: string\n /** The names of the entries there are, of `UNKNOWN_NAME`. */\n readonly names?: readonly string[]\n /** The module, of `UNLOADABLE_MODULE` and `MISSING_EXPORT`. */\n readonly module?: string\n /** The name of its export, of `UNLOADABLE_MODULE` and `MISSING_EXPORT`. */\n readonly export?: string\n /** What the check found wrong, of `INVALID_NAMED_VALUE`. */\n readonly issues?: readonly ConfigIssue[]\n}\n\n/**\n * A reference of ./named that cannot be resolved, of a stable code of {@link NamedErrorCode}: a\n * name of no entry, whose message lists the names there are; a module that fails to load; an\n * export it has not; or a reference, a set or a value of no shape it takes. A tool maps each code\n * to its own, as it chooses.\n */\nexport class NamedError extends ConfigError {\n declare readonly code: NamedErrorCode\n /** The name of no entry, of `UNKNOWN_NAME`. */\n readonly unknown: string | undefined\n /** The names of the entries there are, of `UNKNOWN_NAME`; none of any other code. */\n readonly names: readonly string[]\n /** The module, of `UNLOADABLE_MODULE` and `MISSING_EXPORT`. */\n readonly module: string | undefined\n /** The name of the export of the module, of `UNLOADABLE_MODULE` and `MISSING_EXPORT`. */\n readonly export: string | undefined\n /** What the check found wrong, of `INVALID_NAMED_VALUE` of a value it refuses; none of others. */\n readonly issues: readonly ConfigIssue[]\n\n constructor(\n code: NamedErrorCode,\n message: string,\n details: NamedErrorDetails = {},\n options?: ErrorOptions\n ) {\n super(code, message, options)\n this.unknown = details.name\n this.names = details.names ?? []\n this.module = details.module\n this.export = details.export\n this.issues = details.issues ?? []\n }\n}\n"]}
1
+ {"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * What `@wtf/project-config` throws, each a {@link ConfigError} of a stable `code`:\n * {@link InvalidConfigFileError}, a file of the configuration that holds no object;\n * {@link InvalidSectionError}, a section its tool's schema refuses; {@link ConfigPathError}, a path\n * that names no value; {@link ConfigInCodeError}, a write to a configuration of code;\n * {@link NoConfigFileError}, a write with no package.json to hold it;\n * {@link ConfigFileMismatchError}, a write to a file that is not the one in use;\n * {@link UnwritableConfigFileError}, a write to a file that is never written;\n * {@link NoConfigValueError}, a value asked for that is not set; and\n * {@link EnvPlaceholderUnsetError}, a value that points at a variable of the environment that is\n * not set; {@link SyncConfigInCodeError}, a configuration of code loaded synchronously; and\n * {@link SyncSchemaError}, a section checked synchronously by a schema that checks asynchronously;\n * and {@link NamedError}, a reference of ./named that names no entry, or a module, an export or a\n * value that is not what it says. One that the arguments of a person cause exits 2.\n *\n * @packageDocumentation\n */\nimport type { ConfigIssue, ConfigPath } from './index.ts'\nimport { textOfPath } from './text.ts'\n\n/** What this package throws: an Error with a stable SCREAMING_SNAKE `code`, and the `exitCode` a\n * command that fails by it exits with, 1 by default. */\nexport class ConfigError extends Error {\n readonly code: string\n /** What a command that fails by it exits with. */\n readonly exitCode: number = 1\n\n constructor(code: string, message: string, options?: ErrorOptions) {\n super(message, options)\n this.code = code\n this.name = new.target.name\n }\n}\n\n/**\n * A file of the configuration that holds no configuration: no JSON, no object, or a module that\n * fails to load, or exports no object.\n */\nexport class InvalidConfigFileError extends ConfigError {\n /** The file, by its absolute path. */\n readonly file: string\n\n constructor(file: string, reason: string, options?: ErrorOptions) {\n super('INVALID_CONFIG_FILE', `${file}: ${reason}`, options)\n this.file = file\n }\n}\n\n/**\n * A section of the configuration that the schema of its tool refuses: each issue, by the file and\n * the path of the value, from the key that names the configuration, the namespace by default.\n */\nexport class InvalidSectionError extends ConfigError {\n /** The file of the configuration, by its absolute path. */\n readonly file: string\n /** The section, by its name. */\n readonly section: string\n /** What is wrong, each by its path in the section. */\n readonly issues: readonly ConfigIssue[]\n\n constructor(\n file: string,\n namespace: string,\n section: string,\n issues: readonly ConfigIssue[],\n key: string = namespace\n ) {\n super(\n 'INVALID_CONFIG_SECTION',\n [\n `${file}: the ${section} section of the ${namespace} configuration is not valid:`,\n ...issues.map(({ path, message }) => ` ${textOfPath([key, section, ...path])}: ${message}`)\n ].join('\\n')\n )\n this.file = file\n this.section = section\n this.issues = issues\n }\n}\n\n/**\n * A path of the configuration that names no value to read or write: an empty one, or one that\n * goes into a value that is no object or list. A usage failure: it exits 2.\n */\nexport class ConfigPathError extends ConfigError {\n /** The path, as it was given. */\n readonly path: string\n override readonly exitCode: number = 2\n\n constructor(path: string, reason: string) {\n super('INVALID_CONFIG_PATH', `${path === '' ? 'The path' : path} ${reason}`)\n this.path = path\n }\n}\n\n/**\n * A write to a configuration of code, as `wtf.config.mjs`, `wtf.config.js` or `wtf.config.ts`: code\n * is changed by a person, and not by a tool. Its message names what is written: the JSON files, and\n * the key of package.json.\n */\nexport class ConfigInCodeError extends ConfigError {\n /** The file of code, by its absolute path. */\n readonly file: string\n\n constructor(file: string, written: { readonly files: readonly string[]; readonly key: string }) {\n const names = [...written.files, `the \"${written.key}\" key of package.json`]\n super(\n 'CONFIG_IN_CODE',\n `The configuration is code, in ${file}: change it there. Only ${names.join(' and ')} ${names.length === 1 ? 'is' : 'are'} written.`\n )\n this.file = file\n }\n}\n\n/**\n * A write to the configuration of a project that has none, in the key of package.json, the\n * default, where the root has no package.json. Its message names the key, and the JSON file to make\n * it in instead, if there is one. A usage failure: it exits 2.\n */\nexport class NoConfigFileError extends ConfigError {\n /** The root of the project. */\n readonly root: string\n override readonly exitCode: number = 2\n\n constructor(\n root: string,\n {\n namespace,\n key = namespace,\n json\n }: { readonly namespace: string; readonly key?: string; readonly json?: string | undefined }\n ) {\n super(\n 'NO_CONFIG_FILE',\n `No package.json is in ${root} to hold the ${namespace} configuration in its \"${key}\" key: make one there${json === undefined ? '' : `, or name ${json} to make the configuration in`}.`\n )\n this.root = root\n }\n}\n\n/**\n * A write to a file of the configuration that is not the one in use, as its JSON file named where\n * package.json holds it. A usage failure: it exits 2.\n */\nexport class ConfigFileMismatchError extends ConfigError {\n /** The file that holds the configuration, by its absolute path. */\n readonly file: string\n /** The file named. */\n readonly named: string\n override readonly exitCode: number = 2\n\n constructor(file: string, named: string) {\n super(\n 'CONFIG_FILE_MISMATCH',\n `The configuration is in ${file}, and not in ${named}: write it there, or move it.`\n )\n this.file = file\n this.named = named\n }\n}\n\n/**\n * A write to a file that is no JSON file of the names of the configuration, nor package.json: one\n * of code, or one its names do not hold. Its message names those that are written. A usage\n * failure: it exits 2.\n */\nexport class UnwritableConfigFileError extends ConfigError {\n /** The file named. */\n readonly named: string\n override readonly exitCode: number = 2\n\n constructor(named: string, written: readonly string[]) {\n super(\n 'UNWRITABLE_CONFIG_FILE',\n `${named} is no file the configuration is written to: name ${[...written, 'package.json'].join(' or ')}.`\n )\n this.named = named\n }\n}\n\n/** A value of the configuration that is not set, which was asked for. */\nexport class NoConfigValueError extends ConfigError {\n /** The path, as it was given. */\n readonly path: string\n /** The file of the configuration, by its absolute path, or `undefined` when there is none. */\n readonly file: string | undefined\n\n constructor(path: string, file: string | undefined) {\n super(\n 'NO_CONFIG_VALUE',\n file === undefined\n ? `${path} is not set: the project has no configuration.`\n : `${path} is not set in ${file}.`\n )\n this.path = path\n this.file = file\n }\n}\n\n/**\n * A value of the configuration that points at a variable of the environment, by a placeholder\n * `${env:NAME}`, which is not set, or is empty. Its message names the path of the value, from the\n * key that names the configuration, and the variable, and holds no value.\n */\nexport class EnvPlaceholderUnsetError extends ConfigError {\n /** The path of the value that holds the placeholder. */\n readonly path: ConfigPath\n /** The name of the variable of the environment. */\n readonly variable: string\n\n constructor(path: ConfigPath, variable: string) {\n super(\n 'CONFIG_ENV_PLACEHOLDER_UNSET',\n `${textOfPath(path)}: points at the variable ${variable} of the environment by \\${env:${variable}}, which is not set, or is empty.`\n )\n this.path = path\n this.variable = variable\n }\n}\n\n/**\n * A configuration of code, as `wtf.config.ts`, loaded synchronously, as `loadConfigSync` of ./load\n * loads it for a tool that reads its config synchronously: code is imported, which is\n * asynchronous. Its message names the files a synchronous load reads, JSON and package.json's key.\n */\nexport class SyncConfigInCodeError extends ConfigError {\n /** The file of code, by its absolute path. */\n readonly file: string\n\n constructor(file: string, read: { readonly files: readonly string[]; readonly key: string }) {\n const names = [...read.files, `the \"${read.key}\" key of package.json`]\n super(\n 'CONFIG_IN_CODE_SYNC',\n `The configuration is code, in ${file}, which a synchronous load cannot import: write it in ${names.join(' or ')}, or load it with loadConfig.`\n )\n this.file = file\n }\n}\n\n/**\n * A section checked synchronously, as `sectionOfSync` of ./section checks it, by a schema that\n * checks asynchronously: a Standard Schema whose `validate` gives a promise, or a function that\n * does.\n */\nexport class SyncSchemaError extends ConfigError {\n /** The section, by its name. */\n readonly section: string\n\n constructor(section: string) {\n super(\n 'SCHEMA_NOT_SYNC',\n `The schema of the ${section} section checks it asynchronously: read it with sectionOf.`\n )\n this.section = section\n }\n}\n\n/**\n * The codes of a {@link NamedError}: `UNKNOWN_NAME`, a reference of a name of no entry;\n * `UNLOADABLE_MODULE`, a module that fails to load, or of no loader given; `MISSING_EXPORT`, an\n * export the module has not; and `INVALID_NAMED_VALUE`, a reference, a set or a value that is not\n * of its shape, or that its check refuses.\n */\nexport type NamedErrorCode =\n | 'UNKNOWN_NAME'\n | 'UNLOADABLE_MODULE'\n | 'MISSING_EXPORT'\n | 'INVALID_NAMED_VALUE'\n\n/** What a {@link NamedError} names, of its code: where it failed, the name and those there are,\n * the module and its export, or the issues of a check. */\nexport type NamedErrorDetails = {\n /** Where the value that failed is, by its path from what the caller gave, of any code. */\n readonly at?: ConfigPath\n /** The index of the set that failed in the array of sets, of any code. */\n readonly set?: number\n /** The name of the entry that failed, of a set or of a reference, of any code. */\n readonly entry?: string\n /** The name of no entry, of `UNKNOWN_NAME`. */\n readonly name?: string\n /** The names of the entries there are, of `UNKNOWN_NAME`. */\n readonly names?: readonly string[]\n /** The module, of `UNLOADABLE_MODULE` and `MISSING_EXPORT`, and of a value it exports. */\n readonly module?: string\n /** The name of its export, of `UNLOADABLE_MODULE` and `MISSING_EXPORT`, and of a value it exports. */\n readonly export?: string\n /** What the check found wrong, of `INVALID_NAMED_VALUE`. */\n readonly issues?: readonly ConfigIssue[]\n}\n\n/**\n * A reference of ./named that cannot be resolved, of a stable code of {@link NamedErrorCode}: a\n * name of no entry, whose message lists the names there are; a module that fails to load; an\n * export it has not; or a reference, a set or a value of no shape it takes. Of any code, it names\n * where it failed: its path, `at`, the index of its `set` and the name of its `entry`, and the\n * `module` and `export` a value came from. A tool maps each code to its own, as it chooses.\n */\nexport class NamedError extends ConfigError {\n declare readonly code: NamedErrorCode\n /**\n * Where the value that failed is, by its path from what the caller gave: the path the caller\n * gives as `at`, the index of the set in an array of sets, and the name of the entry, as\n * `['formatters', '1', 'wide']`; empty when nothing narrows it.\n */\n readonly at: ConfigPath\n /** The index of the set that failed in the array of sets: none of one set alone, or of a reference. */\n readonly set: number | undefined\n /** The name of the entry that failed, of a set or of the one a reference names: none of others. */\n readonly entry: string | undefined\n /** The name of no entry, of `UNKNOWN_NAME`. */\n readonly unknown: string | undefined\n /** The names of the entries there are, of `UNKNOWN_NAME`; none of any other code. */\n readonly names: readonly string[]\n /** The module, of `UNLOADABLE_MODULE` and `MISSING_EXPORT`, and of a value it exports. */\n readonly module: string | undefined\n /** The name of the export of the module, of `UNLOADABLE_MODULE` and `MISSING_EXPORT`, and of a\n * value it exports. */\n readonly export: string | undefined\n /** What the check found wrong, of `INVALID_NAMED_VALUE` of a value it refuses; none of others. */\n readonly issues: readonly ConfigIssue[]\n\n constructor(\n code: NamedErrorCode,\n message: string,\n details: NamedErrorDetails = {},\n options?: ErrorOptions\n ) {\n super(code, message, options)\n this.at = details.at ?? []\n this.set = details.set\n this.entry = details.entry\n this.unknown = details.name\n this.names = details.names ?? []\n this.module = details.module\n this.export = details.export\n this.issues = details.issues ?? []\n }\n}\n"]}
package/dist/named.d.ts CHANGED
@@ -19,7 +19,9 @@
19
19
  * as it chooses, or a plain value, whose options are merged over it ({@link factoryOf}). A set is
20
20
  * a map of entries by name, the export of a module that is one, or an array of those, a later set
21
21
  * over an earlier one by name. A module is loaded by what the caller gives, `nodeLoadModule` of
22
- * ./node of Node's, so this module runs on any platform. What fails is a `NamedError` of ./errors.
22
+ * ./node of Node's, so this module runs on any platform. What fails is a `NamedError` of ./errors,
23
+ * which names where: the path, from where the caller says the sets or the reference are, the index
24
+ * of the set and the name of the entry, and the module and the export.
23
25
  *
24
26
  * ```ts
25
27
  * import { factoryOf, resolveNamed, resolveNamedSet } from '@wtf/project-config/named'
@@ -40,7 +42,7 @@
40
42
  * @packageDocumentation
41
43
  */
42
44
  import type { StandardJSONSchemaV1, StandardSchemaV1 } from '@standard-schema/spec';
43
- import type { SectionSchema } from './index.ts';
45
+ import type { ConfigPath, SectionSchema } from './index.ts';
44
46
  /**
45
47
  * The export of a module, as a configuration of JSON names it: the module, by what the loader
46
48
  * resolves, as a path from the root of the project or the name of a package, and the name of its
@@ -84,20 +86,39 @@ export type NamedSets<T> = NamedSet<T> | readonly NamedSet<T>[];
84
86
  * of its exports, or a failure, which a `NamedError` of `UNLOADABLE_MODULE` holds as its cause.
85
87
  */
86
88
  export type LoadModule = (module: string) => Promise<unknown>;
87
- /** How a set is resolved: the loader of its modules, the check of its values, and their kind. */
88
- export type NamedSetOptions<T> = {
89
- /** What loads each module a set names: none by default, of which a module is unloadable. */
89
+ /**
90
+ * What a set and a reference are resolved by alike: the loader of their modules, the check of
91
+ * their values, their kind, and where they are in the configuration.
92
+ */
93
+ export type NamedCheckOptions<T> = {
94
+ /** What loads each module named: none by default, of which a module is unloadable. */
90
95
  readonly load?: LoadModule | undefined;
91
96
  /**
92
- * What checks each value an entry is, of a map or of a module, but a function: a Standard
93
- * Schema, a JSON Schema or a function, as `issuesOf` of ./section takes it.
97
+ * What checks a value: a Standard Schema, a JSON Schema or a function, as `issuesOf` of
98
+ * ./section takes it. Of a set, each value an entry is, of a map or of a module, but a function,
99
+ * whose results it checks too of `checkResults`; of a reference, the value it resolves to.
94
100
  */
95
101
  readonly check?: SectionSchema<T> | undefined;
96
102
  /** What the entries are, which an error names: `entry` by default, as `formatter`. */
97
103
  readonly kind?: string | undefined;
104
+ /**
105
+ * Where the sets, or the reference, are in the configuration, which the `at` of an error starts
106
+ * with, and its message names, as `['formatters']`: none by default.
107
+ */
108
+ readonly at?: ConfigPath | undefined;
109
+ };
110
+ /** How a set is resolved: as {@link NamedCheckOptions} say, and whether `check` checks what a
111
+ * function entry gives. */
112
+ export type NamedSetOptions<T> = NamedCheckOptions<T> & {
113
+ /**
114
+ * Whether `check` checks too what each function entry gives, each time it is called, as it
115
+ * checks a value entry once: no by default, of which a function entry is used as it is.
116
+ */
117
+ readonly checkResults?: boolean | undefined;
98
118
  };
99
- /** How a reference is resolved: the key of its names, its entries, and those of a set. */
100
- export type NamedResolveOptions<T> = NamedSetOptions<T> & {
119
+ /** How a reference is resolved: the key of its names, its entries, and what
120
+ * {@link NamedCheckOptions} say. */
121
+ export type NamedResolveOptions<T> = NamedCheckOptions<T> & {
101
122
  /** The key a reference of options names its entry by, as `format`: none takes a name alone. */
102
123
  readonly key?: string | undefined;
103
124
  /** The entries a reference names, by their names: none by default. */
@@ -119,10 +140,14 @@ export declare function factoryOf<T>(value: T): NamedFactory<T>;
119
140
  * name or the export of a module that is one, a later set over an earlier one by name, so a
120
141
  * project's own are over those of a package; none of `undefined`. Each entry is a function, a
121
142
  * factory as it is, or a plain value, checked by `check`, of {@link factoryOf}; or the export of
122
- * a module that is one of those, loaded by `load`. Each module is loaded at once, so a set that
143
+ * a module that is one of those, loaded by `load`. Of `checkResults`, `check` checks what each
144
+ * function entry gives too, each time it is called. Each module is loaded at once, so a set that
123
145
  * fails does before any entry is used. Fails with a `NamedError` of `UNLOADABLE_MODULE` or
124
146
  * `MISSING_EXPORT` of a module, and of `INVALID_NAMED_VALUE` of a set that is no map, or a value
125
- * `check` refuses.
147
+ * `check` refuses. The error names where it failed: its `at` is the path `at` gives, the index of
148
+ * the set in an array of sets, its `set`, and the name of the entry, its `entry`, as
149
+ * `['formatters', '1', 'wide']`, and its message starts with the path of the set; and its `module`
150
+ * and `export` are those of a set or an entry a module exports.
126
151
  */
127
152
  export declare function resolveNamedSet<T>(sets: NamedSets<T> | undefined, options?: NamedSetOptions<T>): Promise<NamedEntries<T>>;
128
153
  /**
@@ -132,9 +157,11 @@ export declare function resolveNamedSet<T>(sets: NamedSets<T> | undefined, optio
132
157
  * `load`. With a `check`, the value is checked by it. Fails with a `NamedError`: `UNKNOWN_NAME` of
133
158
  * a name of no entry, whose message lists the names there are; `UNLOADABLE_MODULE` and
134
159
  * `MISSING_EXPORT` of a module; and `INVALID_NAMED_VALUE` of a reference of none of the forms, or
135
- * a value `check` refuses.
160
+ * a value `check` refuses. The error names where it failed: its `at` is the path `at` gives, which
161
+ * its message starts with; its `entry` the name of the entry whose value fails, or which fails as
162
+ * it is given its options; and its `module` and `export` those of a reference to a module.
136
163
  */
137
- export declare function resolveNamed<T>(reference: NamedReference, { key, names, load, check, kind }?: NamedResolveOptions<T>): Promise<T>;
164
+ export declare function resolveNamed<T>(reference: NamedReference, { key, names, load, check, kind, at }?: NamedResolveOptions<T>): Promise<T>;
138
165
  /** What the schema of a reference says of it. */
139
166
  export type NamedSchemaOptions = {
140
167
  /** The names an editor completes: those of the entries there are. */
package/dist/named.js CHANGED
@@ -1,6 +1,7 @@
1
1
  import { jsonSchemaOf } from "./env.js";
2
2
  import { NamedError } from "./errors.js";
3
3
  import { issuesOf, issuesOfSync } from "./section.js";
4
+ import { textOfPath } from "./text.js";
4
5
  /** Whether `value` is an object of keys, as JSON's: no list, and no instance of a class. */
5
6
  const isPlain = (value) => {
6
7
  if (typeof value !== 'object' || value === null || Array.isArray(value))
@@ -40,77 +41,129 @@ export function factoryOf(value) {
40
41
  const issuesText = (issues) => issues
41
42
  .map(({ path, message }) => (path.length === 0 ? message : `${path.join('.')}: ${message}`))
42
43
  .join('; ');
43
- /** `value`, checked by `check`, else a `NamedError` of `INVALID_NAMED_VALUE` of what `what` is. */
44
- async function checked(value, check, what) {
44
+ /** The module and the export of `reference`, as a `NamedError` names them. */
45
+ const moduleDetails = (reference) => ({
46
+ module: reference.module,
47
+ export: reference.export ?? 'default'
48
+ });
49
+ /**
50
+ * A `NamedError` of `code` at `place`: its message after the path of its set or its reference, of
51
+ * one that is not empty, and the path, the set and the entry of the place beside `details`.
52
+ */
53
+ function namedError(code, message, { at, where, set, entry }, details = {}, options) {
54
+ return new NamedError(code, where.length === 0 ? message : `${textOfPath(where)}: ${message}`, {
55
+ ...details,
56
+ at,
57
+ ...(set === undefined ? {} : { set }),
58
+ ...(entry === undefined ? {} : { entry })
59
+ }, options);
60
+ }
61
+ /**
62
+ * `value`, checked by `check`, else a `NamedError` of `INVALID_NAMED_VALUE` at `place`, whose
63
+ * message is `failing` and the issues, and `details` beside it.
64
+ */
65
+ async function checked(value, check, failing, place, details = {}) {
45
66
  if (check === undefined)
46
67
  return value;
47
68
  const { issues, value: read } = await issuesOf(value, check);
48
69
  if (issues.length === 0)
49
70
  return read;
50
- throw new NamedError('INVALID_NAMED_VALUE', `${what} is not valid: ${issuesText(issues)}.`, {
71
+ throw namedError('INVALID_NAMED_VALUE', `${failing}: ${issuesText(issues)}.`, place, {
72
+ ...details,
51
73
  issues
52
74
  });
53
75
  }
54
76
  /**
55
77
  * The export `reference.export`, `default` by default, of the module `reference.module`, loaded by
56
- * `load`: a `NamedError` of `UNLOADABLE_MODULE` of a module that fails to load, or of no loader,
57
- * and of `MISSING_EXPORT` of an export it has not.
78
+ * `load`: a `NamedError` at `place` of `UNLOADABLE_MODULE` of a module that fails to load, or of no
79
+ * loader, and of `MISSING_EXPORT` of an export it has not, each of the module and the export.
58
80
  */
59
- async function exportOf(reference, load) {
81
+ async function exportOf(reference, load, place) {
60
82
  const { module } = reference;
61
83
  const name = reference.export ?? 'default';
62
- const details = { module, export: name };
84
+ const details = moduleDetails(reference);
85
+ const as = place.as === undefined ? '' : ` as ${place.as}`;
63
86
  if (load === undefined)
64
- throw new NamedError('UNLOADABLE_MODULE', `The module ${module} cannot be loaded, for its export ${name}: no loader of modules is given.`, details);
87
+ throw namedError('UNLOADABLE_MODULE', `The module ${module} cannot be loaded, for its export ${name}${as}: no loader of modules is given.`, place, details);
65
88
  let loaded;
66
89
  try {
67
90
  loaded = await load(module);
68
91
  }
69
92
  catch (error) {
70
- throw new NamedError('UNLOADABLE_MODULE', `The module ${module} cannot be loaded, for its export ${name}: ${error instanceof Error ? error.message : String(error)}`, details, { cause: error });
93
+ throw namedError('UNLOADABLE_MODULE', `The module ${module} cannot be loaded, for its export ${name}${as}: ${error instanceof Error ? error.message : String(error)}`, place, details, { cause: error });
71
94
  }
72
95
  const exports = loaded;
73
96
  const found = typeof exports === 'object' && exports !== null ? exports[name] : undefined;
74
97
  if (found === undefined)
75
- throw new NamedError('MISSING_EXPORT', `The module ${module} has no export ${name}.`, details);
98
+ throw namedError('MISSING_EXPORT', `The module ${module} has no export ${name}${as}.`, place, details);
76
99
  return found;
77
100
  }
78
101
  /** What a module's export is, as an error names it. */
79
102
  const exportText = ({ module, export: name = 'default' }) => `The export ${name} of ${module}`;
80
- /** The entry of `value` of the name `name`: a function as it is, else checked, of {@link factoryOf}. */
81
- async function entryOf(value, name, { load, check, kind = 'entry' }) {
82
- const at = isModule(value) ? await exportOf(value, load) : value;
83
- if (typeof at === 'function')
84
- return at;
85
- const what = isModule(value)
86
- ? `${exportText(value)}, the ${kind} ${name},`
87
- : `The ${kind} ${name}`;
88
- return factoryOf(await checked(at, check, what));
103
+ /**
104
+ * The entry of `value` of the name `name`, at `place`: a function as it is, or, of `checkResults`,
105
+ * one whose results `check` checks; else the value checked, of {@link factoryOf}.
106
+ */
107
+ async function entryOf(value, name, place, { load, check, checkResults, kind = 'entry' }) {
108
+ const reference = isModule(value) ? value : undefined;
109
+ const details = reference === undefined ? {} : moduleDetails(reference);
110
+ const found = reference === undefined
111
+ ? value
112
+ : await exportOf(reference, load, { ...place, as: `the ${kind} ${name}` });
113
+ const what = reference === undefined
114
+ ? `The ${kind} ${name}`
115
+ : `${exportText(reference)}, the ${kind} ${name},`;
116
+ if (typeof found === 'function') {
117
+ const factory = found;
118
+ if (checkResults !== true || check === undefined)
119
+ return factory;
120
+ return async (options) => checked(await factory(options), check, `${what} gives a value that is not valid`, place, details);
121
+ }
122
+ return factoryOf(await checked(found, check, `${what} is not valid`, place, details));
89
123
  }
90
124
  /**
91
125
  * The entries of `sets`, each a factory, by their names: of each set in order, a map of entries by
92
126
  * name or the export of a module that is one, a later set over an earlier one by name, so a
93
127
  * project's own are over those of a package; none of `undefined`. Each entry is a function, a
94
128
  * factory as it is, or a plain value, checked by `check`, of {@link factoryOf}; or the export of
95
- * a module that is one of those, loaded by `load`. Each module is loaded at once, so a set that
129
+ * a module that is one of those, loaded by `load`. Of `checkResults`, `check` checks what each
130
+ * function entry gives too, each time it is called. Each module is loaded at once, so a set that
96
131
  * fails does before any entry is used. Fails with a `NamedError` of `UNLOADABLE_MODULE` or
97
132
  * `MISSING_EXPORT` of a module, and of `INVALID_NAMED_VALUE` of a set that is no map, or a value
98
- * `check` refuses.
133
+ * `check` refuses. The error names where it failed: its `at` is the path `at` gives, the index of
134
+ * the set in an array of sets, its `set`, and the name of the entry, its `entry`, as
135
+ * `['formatters', '1', 'wide']`, and its message starts with the path of the set; and its `module`
136
+ * and `export` are those of a set or an entry a module exports.
99
137
  */
100
138
  export async function resolveNamedSet(sets, options = {}) {
101
- const list = sets === undefined ? [] : Array.isArray(sets) ? sets : [sets];
102
- const resolved = await Promise.all(list.map(async (set) => {
103
- const map = isModule(set) ? await exportOf(set, options.load) : set;
139
+ const { at = [], kind = 'entry' } = options;
140
+ const many = Array.isArray(sets);
141
+ const list = sets === undefined ? [] : many ? sets : [sets];
142
+ const resolved = await Promise.all(list.map(async (set, index) => {
143
+ const of = many ? [...at, String(index)] : at;
144
+ const place = { at: of, where: of, ...(many ? { set: index } : {}) };
145
+ const reference = isModule(set) ? set : undefined;
146
+ const map = reference === undefined
147
+ ? set
148
+ : await exportOf(reference, options.load, { ...place, as: `a set of ${kind}s` });
104
149
  if (!isPlain(map))
105
- throw new NamedError('INVALID_NAMED_VALUE', `${isModule(set) ? exportText(set) : textOf(set)} is no set: give an object of each ${options.kind ?? 'entry'} by its name.`);
150
+ throw namedError('INVALID_NAMED_VALUE', `${reference === undefined ? textOf(set) : exportText(reference)} is no set: give an object of each ${kind} by its name.`, place, reference === undefined ? {} : moduleDetails(reference));
106
151
  const entries = await Promise.all(Object.entries(map).map(async ([name, value]) => [
107
152
  name,
108
- await entryOf(value, name, options)
153
+ await entryOf(value, name, { ...place, at: [...place.at, name], entry: name }, options)
109
154
  ]));
110
155
  return Object.fromEntries(entries);
111
156
  }));
112
157
  return Object.assign({}, ...resolved);
113
158
  }
159
+ /** What `error` names but its place, as a `NamedError` that holds it gives it again. */
160
+ const detailsOf = (error) => ({
161
+ ...(error.unknown === undefined ? {} : { name: error.unknown }),
162
+ ...(error.module === undefined ? {} : { module: error.module }),
163
+ ...(error.export === undefined ? {} : { export: error.export }),
164
+ names: error.names,
165
+ issues: error.issues
166
+ });
114
167
  /**
115
168
  * The value `reference` is: of a name, the entry of that name of `names`, given no options; of an
116
169
  * object of the `key`, the entry of the name under it, given the options beside it but those of
@@ -118,12 +171,15 @@ export async function resolveNamedSet(sets, options = {}) {
118
171
  * `load`. With a `check`, the value is checked by it. Fails with a `NamedError`: `UNKNOWN_NAME` of
119
172
  * a name of no entry, whose message lists the names there are; `UNLOADABLE_MODULE` and
120
173
  * `MISSING_EXPORT` of a module; and `INVALID_NAMED_VALUE` of a reference of none of the forms, or
121
- * a value `check` refuses.
174
+ * a value `check` refuses. The error names where it failed: its `at` is the path `at` gives, which
175
+ * its message starts with; its `entry` the name of the entry whose value fails, or which fails as
176
+ * it is given its options; and its `module` and `export` those of a reference to a module.
122
177
  */
123
- export async function resolveNamed(reference, { key, names = {}, load, check, kind = 'entry' } = {}) {
178
+ export async function resolveNamed(reference, { key, names = {}, load, check, kind = 'entry', at = [] } = {}) {
179
+ const place = { at, where: at };
124
180
  const use = reference;
125
181
  if (isModule(use) && (key === undefined || !(key in use)))
126
- return checked(await exportOf(use, load), check, exportText(use));
182
+ return checked(await exportOf(use, load, place), check, `${exportText(use)} is not valid`, place, moduleDetails(use));
127
183
  const named = typeof use === 'string'
128
184
  ? { name: use, options: {} }
129
185
  : isPlain(use) && key !== undefined && typeof use[key] === 'string'
@@ -133,14 +189,24 @@ export async function resolveNamed(reference, { key, names = {}, load, check, ki
133
189
  })()
134
190
  : undefined;
135
191
  if (named === undefined)
136
- throw new NamedError('INVALID_NAMED_VALUE', `${textOf(use)} is no reference of ${article(kind)}: give its name${key === undefined ? '' : `, { "${key}": name, … }`} or { "module": …, "export": … }.`);
192
+ throw namedError('INVALID_NAMED_VALUE', `${textOf(use)} is no reference of ${article(kind)}: give its name${key === undefined ? '' : `, { "${key}": name, … }`} or { "module": …, "export": … }.`, place);
137
193
  const { name, options } = named;
138
194
  if (!Object.hasOwn(names, name)) {
139
195
  const known = Object.keys(names);
140
- throw new NamedError('UNKNOWN_NAME', `No ${kind} is named ${JSON.stringify(name)}: the names are ${known.length === 0 ? 'none' : known.join(', ')}.`, { name, names: known });
196
+ throw namedError('UNKNOWN_NAME', `No ${kind} is named ${JSON.stringify(name)}: the names are ${known.length === 0 ? 'none' : known.join(', ')}.`, place, { name, names: known });
141
197
  }
142
198
  const entry = names[name];
143
- return checked(await entry(options), check, `The ${kind} ${name}`);
199
+ const of = { ...place, entry: name };
200
+ let value;
201
+ try {
202
+ value = await entry(options);
203
+ }
204
+ catch (error) {
205
+ if (!(error instanceof NamedError) || error.entry !== undefined)
206
+ throw error;
207
+ throw namedError(error.code, `The ${kind} ${name} fails: ${error.message}`, of, detailsOf(error), { cause: error });
208
+ }
209
+ return checked(value, check, `The ${kind} ${name} is not valid`, of);
144
210
  }
145
211
  /** The JSON Schema of the export of a module. */
146
212
  const MODULE_SCHEMA = {
package/dist/named.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"named.js","sourceRoot":"","sources":["../src/named.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * A value or a function a configuration of JSON names, where JSON cannot hold it, and the code\n * that finds it: a set of named entries, as a tool gives some and a project adds its own, and a\n * reference to one of them, or to the export of a module. {@link resolveNamed} gives the value a\n * reference is; {@link resolveNamedSet} the entries of one set or of sets merged in order;\n * {@link factoryOf} the entry of a plain value, the options of a reference merged over it; and\n * {@link namedSchema} and {@link namedSetSchema} the schema of a reference and of a set, a\n * Standard Schema that checks it and gives its JSON Schema, so an editor completes the names.\n *\n * A reference is one of three forms:\n *\n * - `\"short\"`: the entry of that name;\n * - `{ \"format\": \"short\", \"width\": 60 }`: the entry of that name, by a key the caller chooses,\n * with the options beside it, which the entry is given;\n * - `{ \"module\": \"./formatters.mjs\", \"export\": \"wide\" }`: the export of a module, `default` by\n * default, as it is.\n *\n * Each entry is a factory of the value, `(options) => value`: a function, which takes the options\n * as it chooses, or a plain value, whose options are merged over it ({@link factoryOf}). A set is\n * a map of entries by name, the export of a module that is one, or an array of those, a later set\n * over an earlier one by name. A module is loaded by what the caller gives, `nodeLoadModule` of\n * ./node of Node's, so this module runs on any platform. What fails is a `NamedError` of ./errors.\n *\n * ```ts\n * import { factoryOf, resolveNamed, resolveNamedSet } from '@wtf/project-config/named'\n *\n * type Format = { readonly width: number; readonly ellipsis: string }\n *\n * const formatters = await resolveNamedSet<Format>([\n * { short: factoryOf({ width: 40, ellipsis: '…' }) },\n * { wide: { width: 120, ellipsis: '' } }\n * ])\n * const format = await resolveNamed<Format>(\n * { format: 'short', width: 60 },\n * { key: 'format', names: formatters, kind: 'formatter' }\n * )\n * // { width: 60, ellipsis: '…' }\n * ```\n *\n * @packageDocumentation\n */\nimport type { StandardJSONSchemaV1, StandardSchemaV1 } from '@standard-schema/spec'\n\nimport { jsonSchemaOf } from './env.ts'\nimport { NamedError } from './errors.ts'\nimport type { ConfigIssue, JsonSchema, SectionSchema } from './index.ts'\nimport { issuesOf, issuesOfSync } from './section.ts'\n\n/**\n * The export of a module, as a configuration of JSON names it: the module, by what the loader\n * resolves, as a path from the root of the project or the name of a package, and the name of its\n * export, `default` by default.\n */\nexport type ModuleReference = {\n /** The module, as the loader resolves it: `./formatters.mjs`, or a package. */\n readonly module: string\n /** The name of its export: `default` by default. */\n readonly export?: string | undefined\n}\n\n/**\n * A reference to an entry by its name under the key `K`, with the options beside it, which the\n * entry is given: `{ \"format\": \"short\", \"width\": 60 }` of the key `format`. Of a key not known, as\n * `string`, any object of options.\n */\nexport type NamedUse<K extends string = string> = string extends K\n ? NamedOptions\n : { readonly [P in K]: string } & NamedOptions\n\n/**\n * A reference, as a configuration of JSON gives it: the name of an entry; the name under the key\n * `K`, with options; or the export of a module.\n */\nexport type NamedReference<K extends string = string> = string | NamedUse<K> | ModuleReference\n\n/** The options a reference gives an entry: each beside its name, but the key and any `undefined`. */\nexport type NamedOptions = Readonly<Record<string, unknown>>\n\n/** An entry of a set: what makes the value of the options a reference gives, none of a name alone. */\nexport type NamedFactory<T> = (options: NamedOptions) => T | Promise<T>\n\n/** The entries of a set, each a factory, by their names, as {@link resolveNamedSet} gives them. */\nexport type NamedEntries<T> = Readonly<Record<string, NamedFactory<T>>>\n\n/**\n * A set of entries, as a configuration gives it: a map of each by its name, a factory, a plain\n * value or the export of a module that is one of those; or the export of a module that is such a\n * map.\n */\nexport type NamedSet<T> =\n | ModuleReference\n | Readonly<Record<string, NamedFactory<T> | ModuleReference | T>>\n\n/** The sets of a configuration: one, or an array of them, merged in order, each over those before. */\nexport type NamedSets<T> = NamedSet<T> | readonly NamedSet<T>[]\n\n/**\n * What loads a module of a {@link ModuleReference}: the module of the text it names, as an object\n * of its exports, or a failure, which a `NamedError` of `UNLOADABLE_MODULE` holds as its cause.\n */\nexport type LoadModule = (module: string) => Promise<unknown>\n\n/** How a set is resolved: the loader of its modules, the check of its values, and their kind. */\nexport type NamedSetOptions<T> = {\n /** What loads each module a set names: none by default, of which a module is unloadable. */\n readonly load?: LoadModule | undefined\n /**\n * What checks each value an entry is, of a map or of a module, but a function: a Standard\n * Schema, a JSON Schema or a function, as `issuesOf` of ./section takes it.\n */\n readonly check?: SectionSchema<T> | undefined\n /** What the entries are, which an error names: `entry` by default, as `formatter`. */\n readonly kind?: string | undefined\n}\n\n/** How a reference is resolved: the key of its names, its entries, and those of a set. */\nexport type NamedResolveOptions<T> = NamedSetOptions<T> & {\n /** The key a reference of options names its entry by, as `format`: none takes a name alone. */\n readonly key?: string | undefined\n /** The entries a reference names, by their names: none by default. */\n readonly names?: NamedEntries<T> | undefined\n}\n\n/** The schema of a reference or a set: a Standard Schema that checks it, and gives its JSON Schema. */\nexport type NamedSchema<T> = StandardSchemaV1<unknown, T> & StandardJSONSchemaV1<unknown, T>\n\n/** Whether `value` is an object of keys, as JSON's: no list, and no instance of a class. */\nconst isPlain = (value: unknown): value is Readonly<Record<string, unknown>> => {\n if (typeof value !== 'object' || value === null || Array.isArray(value)) return false\n const prototype: unknown = Object.getPrototypeOf(value)\n return prototype === Object.prototype || prototype === null\n}\n\n/** Whether `value` is the export of a module: an object whose `module` is a text. */\nconst isModule = (value: unknown): value is ModuleReference =>\n isPlain(value) && typeof value['module'] === 'string'\n\n/** `word` after its article, `a` or `an`, as `an entry`. */\nconst article = (word: string): string => `${/^[aeiou]/i.test(word) ? 'an' : 'a'} ${word}`\n\n/** `text` of a capital first. */\nconst capital = (text: string): string => `${text.charAt(0).toUpperCase()}${text.slice(1)}`\n\n/** `value` as an error names it. */\nconst textOf = (value: unknown): string =>\n typeof value === 'function' ? 'a function' : (JSON.stringify(value) ?? String(value))\n\n/** The options of `options` that are given: each but those of `undefined`. */\nconst givenOf = (options: NamedOptions): NamedOptions =>\n Object.fromEntries(Object.entries(options).filter(([, value]) => value !== undefined))\n\n/**\n * The entry of `value`: of a plain object, `value` with the options a reference gives beside the\n * name merged over it, key by key, and those of `undefined` left out, so\n * `{ format: 'short', width: 60 }` gives `{ width: 60, ellipsis: '…' }` of\n * `{ width: 40, ellipsis: '…' }`; of any other value, the value, which takes no options, so options\n * given are a `NamedError` of `INVALID_NAMED_VALUE`. {@link resolveNamedSet} makes each value of a\n * set that is no function an entry so.\n */\nexport function factoryOf<T>(value: T): NamedFactory<T> {\n return (options) => {\n const given = givenOf(options)\n if (isPlain(value)) return { ...value, ...given } as T\n if (Object.keys(given).length === 0) return value\n throw new NamedError(\n 'INVALID_NAMED_VALUE',\n `${textOf(value)} takes no options, and is given ${Object.keys(given).join(', ')}.`\n )\n }\n}\n\n/** The text of the issues a check found. */\nconst issuesText = (issues: readonly ConfigIssue[]): string =>\n issues\n .map(({ path, message }) => (path.length === 0 ? message : `${path.join('.')}: ${message}`))\n .join('; ')\n\n/** `value`, checked by `check`, else a `NamedError` of `INVALID_NAMED_VALUE` of what `what` is. */\nasync function checked<T>(value: unknown, check: SectionSchema<T> | undefined, what: string) {\n if (check === undefined) return value as T\n const { issues, value: read } = await issuesOf(value, check)\n if (issues.length === 0) return read\n throw new NamedError('INVALID_NAMED_VALUE', `${what} is not valid: ${issuesText(issues)}.`, {\n issues\n })\n}\n\n/**\n * The export `reference.export`, `default` by default, of the module `reference.module`, loaded by\n * `load`: a `NamedError` of `UNLOADABLE_MODULE` of a module that fails to load, or of no loader,\n * and of `MISSING_EXPORT` of an export it has not.\n */\nasync function exportOf(reference: ModuleReference, load: LoadModule | undefined) {\n const { module } = reference\n const name = reference.export ?? 'default'\n const details = { module, export: name }\n if (load === undefined)\n throw new NamedError(\n 'UNLOADABLE_MODULE',\n `The module ${module} cannot be loaded, for its export ${name}: no loader of modules is given.`,\n details\n )\n let loaded: unknown\n try {\n loaded = await load(module)\n } catch (error) {\n throw new NamedError(\n 'UNLOADABLE_MODULE',\n `The module ${module} cannot be loaded, for its export ${name}: ${error instanceof Error ? error.message : String(error)}`,\n details,\n { cause: error }\n )\n }\n const exports = loaded as Readonly<Record<string, unknown>> | null | undefined\n const found = typeof exports === 'object' && exports !== null ? exports[name] : undefined\n if (found === undefined)\n throw new NamedError('MISSING_EXPORT', `The module ${module} has no export ${name}.`, details)\n return found\n}\n\n/** What a module's export is, as an error names it. */\nconst exportText = ({ module, export: name = 'default' }: ModuleReference): string =>\n `The export ${name} of ${module}`\n\n/** The entry of `value` of the name `name`: a function as it is, else checked, of {@link factoryOf}. */\nasync function entryOf<T>(\n value: unknown,\n name: string,\n { load, check, kind = 'entry' }: NamedSetOptions<T>\n): Promise<NamedFactory<T>> {\n const at = isModule(value) ? await exportOf(value, load) : value\n if (typeof at === 'function') return at as NamedFactory<T>\n const what = isModule(value)\n ? `${exportText(value)}, the ${kind} ${name},`\n : `The ${kind} ${name}`\n return factoryOf(await checked(at, check, what))\n}\n\n/**\n * The entries of `sets`, each a factory, by their names: of each set in order, a map of entries by\n * name or the export of a module that is one, a later set over an earlier one by name, so a\n * project's own are over those of a package; none of `undefined`. Each entry is a function, a\n * factory as it is, or a plain value, checked by `check`, of {@link factoryOf}; or the export of\n * a module that is one of those, loaded by `load`. Each module is loaded at once, so a set that\n * fails does before any entry is used. Fails with a `NamedError` of `UNLOADABLE_MODULE` or\n * `MISSING_EXPORT` of a module, and of `INVALID_NAMED_VALUE` of a set that is no map, or a value\n * `check` refuses.\n */\nexport async function resolveNamedSet<T>(\n sets: NamedSets<T> | undefined,\n options: NamedSetOptions<T> = {}\n): Promise<NamedEntries<T>> {\n const list: readonly unknown[] = sets === undefined ? [] : Array.isArray(sets) ? sets : [sets]\n const resolved = await Promise.all(\n list.map(async (set) => {\n const map = isModule(set) ? await exportOf(set, options.load) : set\n if (!isPlain(map))\n throw new NamedError(\n 'INVALID_NAMED_VALUE',\n `${isModule(set) ? exportText(set) : textOf(set)} is no set: give an object of each ${options.kind ?? 'entry'} by its name.`\n )\n const entries = await Promise.all(\n Object.entries(map).map(async ([name, value]): Promise<[string, NamedFactory<T>]> => [\n name,\n await entryOf(value, name, options)\n ])\n )\n return Object.fromEntries(entries)\n })\n )\n return Object.assign({}, ...resolved) as NamedEntries<T>\n}\n\n/**\n * The value `reference` is: of a name, the entry of that name of `names`, given no options; of an\n * object of the `key`, the entry of the name under it, given the options beside it but those of\n * `undefined`; of the export of a module, `{ module, export }`, the export as it is, loaded by\n * `load`. With a `check`, the value is checked by it. Fails with a `NamedError`: `UNKNOWN_NAME` of\n * a name of no entry, whose message lists the names there are; `UNLOADABLE_MODULE` and\n * `MISSING_EXPORT` of a module; and `INVALID_NAMED_VALUE` of a reference of none of the forms, or\n * a value `check` refuses.\n */\nexport async function resolveNamed<T>(\n reference: NamedReference,\n { key, names = {}, load, check, kind = 'entry' }: NamedResolveOptions<T> = {}\n): Promise<T> {\n const use: unknown = reference\n if (isModule(use) && (key === undefined || !(key in use)))\n return checked(await exportOf(use, load), check, exportText(use))\n const named =\n typeof use === 'string'\n ? { name: use, options: {} }\n : isPlain(use) && key !== undefined && typeof use[key] === 'string'\n ? (() => {\n const { [key]: name, ...options } = use\n return { name: name as string, options: givenOf(options) }\n })()\n : undefined\n if (named === undefined)\n throw new NamedError(\n 'INVALID_NAMED_VALUE',\n `${textOf(use)} is no reference of ${article(kind)}: give its name${key === undefined ? '' : `, { \"${key}\": name, … }`} or { \"module\": …, \"export\": … }.`\n )\n const { name, options } = named\n if (!Object.hasOwn(names, name)) {\n const known = Object.keys(names)\n throw new NamedError(\n 'UNKNOWN_NAME',\n `No ${kind} is named ${JSON.stringify(name)}: the names are ${known.length === 0 ? 'none' : known.join(', ')}.`,\n { name, names: known }\n )\n }\n const entry = names[name] as NamedFactory<T>\n return checked(await entry(options), check, `The ${kind} ${name}`)\n}\n\n/** The JSON Schema of the export of a module. */\nconst MODULE_SCHEMA = {\n description: 'The export of a module: `default` by default.',\n type: 'object',\n properties: {\n module: {\n description: 'The module: a path from the root, or a package.',\n type: 'string',\n minLength: 1\n },\n export: {\n description: 'The name of its export: `default` by default.',\n type: 'string',\n minLength: 1\n }\n },\n required: ['module'],\n additionalProperties: false\n} as const\n\n/** The JSON Schema of a name: a text, of the `names` an editor completes. */\nconst nameSchema = (kind: string, names: readonly string[] | undefined): JsonSchema => ({\n description: `The name of ${article(kind)}.`,\n type: 'string',\n minLength: 1,\n ...(names === undefined || names.length === 0 ? {} : { examples: [...names] })\n})\n\n/** The JSON Schema of `schema`, as an object of its keywords: `{}`, any value, of none. */\nconst objectSchemaOf = (schema: SectionSchema | undefined): Readonly<Record<string, unknown>> => {\n const json = schema === undefined ? undefined : jsonSchemaOf(schema)\n if (json === undefined || json === true) return {}\n if (json === false) return { not: {} }\n const { $schema: _draft, $id: _id, ...rest } = json\n return rest\n}\n\n/**\n * The schema of `json`, of the type `T`: it checks a value by ajv, as `issuesOfSync` of ./section\n * checks a JSON Schema, and gives `json`, of draft 2020-12, as the JSON Schema of its input and\n * output alike.\n */\nfunction schemaOf<T>(json: Readonly<Record<string, unknown>>): NamedSchema<T> {\n const jsonSchema = (): Record<string, unknown> => ({ ...json })\n return {\n '~standard': {\n version: 1,\n vendor: '@wtf/project-config',\n validate: (value) => {\n const { issues } = issuesOfSync(value, json)\n return issues.length === 0\n ? { value: value as T }\n : { issues: issues.map(({ path, message }) => ({ path, message })) }\n },\n jsonSchema: { input: jsonSchema, output: jsonSchema }\n }\n }\n}\n\n/** What the schema of a reference says of it. */\nexport type NamedSchemaOptions = {\n /** The names an editor completes: those of the entries there are. */\n readonly names?: readonly string[] | undefined\n /**\n * The schema of the options beside a name, as each entry takes them: a JSON Schema, or a\n * Standard Schema that gives one, of an object, whose `properties` are each an option. Any by\n * default.\n */\n readonly options?: SectionSchema | undefined\n /** What the entries are, which the descriptions name: `entry` by default. */\n readonly kind?: string | undefined\n}\n\n/**\n * The schema of a reference of the key `key`: a name, of `names`, which an editor completes;\n * `{ [key]: name, … }`, with the options of `options` beside it, each optional, as they are over\n * the entry's own; or `{ module, export }`. Its JSON Schema, which `input()` of its\n * `~standard.jsonSchema` gives, holds no `$schema`, so it goes in a tool's own as it is.\n */\nexport function namedSchema<K extends string>(\n key: K,\n { names, options, kind = 'entry' }: NamedSchemaOptions = {}\n): NamedSchema<NamedReference<K>> {\n const name = nameSchema(kind, names)\n const { properties, required: _required, type: _type, ...rest } = objectSchemaOf(options)\n return schemaOf({\n description: `${capital(article(kind))}: its name, { \"${key}\": name, … } with options over its own, or the export of a module.`,\n anyOf: [\n name,\n {\n ...rest,\n description: `${capital(article(kind))} by its name, with options over its own.`,\n type: 'object',\n properties: { ...(isPlain(properties) ? properties : {}), [key]: name },\n required: [key]\n },\n MODULE_SCHEMA\n ]\n })\n}\n\n/** What the schema of a set says of it. */\nexport type NamedSetSchemaOptions = {\n /** The schema of the value of an entry: a JSON Schema, or a Standard Schema that gives one. Any by default. */\n readonly entry?: SectionSchema | undefined\n /** What the entries are, which the descriptions name: `entry` by default. */\n readonly kind?: string | undefined\n}\n\n/**\n * The schema of the sets of entries: a set, or an array of sets, merged in order; each set the\n * export of a module, or a map of each entry by its name, of `entry`, or the export of a module.\n * Its JSON Schema holds no `$schema`, as {@link namedSchema}'s.\n */\nexport function namedSetSchema({ entry, kind = 'entry' }: NamedSetSchemaOptions = {}): NamedSchema<\n NamedSets<unknown>\n> {\n const set = {\n description: `A set of ${kind}s: a map of each by its name, or the export of a module that is one.`,\n anyOf: [\n MODULE_SCHEMA,\n {\n type: 'object',\n additionalProperties: { anyOf: [MODULE_SCHEMA, objectSchemaOf(entry)] }\n }\n ]\n }\n return schemaOf({\n description: `The sets of ${kind}s: a set, or an array of sets merged in order, each over those before.`,\n anyOf: [set, { type: 'array', items: set }]\n })\n}\n"]}
1
+ {"version":3,"file":"named.js","sourceRoot":"","sources":["../src/named.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * A value or a function a configuration of JSON names, where JSON cannot hold it, and the code\n * that finds it: a set of named entries, as a tool gives some and a project adds its own, and a\n * reference to one of them, or to the export of a module. {@link resolveNamed} gives the value a\n * reference is; {@link resolveNamedSet} the entries of one set or of sets merged in order;\n * {@link factoryOf} the entry of a plain value, the options of a reference merged over it; and\n * {@link namedSchema} and {@link namedSetSchema} the schema of a reference and of a set, a\n * Standard Schema that checks it and gives its JSON Schema, so an editor completes the names.\n *\n * A reference is one of three forms:\n *\n * - `\"short\"`: the entry of that name;\n * - `{ \"format\": \"short\", \"width\": 60 }`: the entry of that name, by a key the caller chooses,\n * with the options beside it, which the entry is given;\n * - `{ \"module\": \"./formatters.mjs\", \"export\": \"wide\" }`: the export of a module, `default` by\n * default, as it is.\n *\n * Each entry is a factory of the value, `(options) => value`: a function, which takes the options\n * as it chooses, or a plain value, whose options are merged over it ({@link factoryOf}). A set is\n * a map of entries by name, the export of a module that is one, or an array of those, a later set\n * over an earlier one by name. A module is loaded by what the caller gives, `nodeLoadModule` of\n * ./node of Node's, so this module runs on any platform. What fails is a `NamedError` of ./errors,\n * which names where: the path, from where the caller says the sets or the reference are, the index\n * of the set and the name of the entry, and the module and the export.\n *\n * ```ts\n * import { factoryOf, resolveNamed, resolveNamedSet } from '@wtf/project-config/named'\n *\n * type Format = { readonly width: number; readonly ellipsis: string }\n *\n * const formatters = await resolveNamedSet<Format>([\n * { short: factoryOf({ width: 40, ellipsis: '…' }) },\n * { wide: { width: 120, ellipsis: '' } }\n * ])\n * const format = await resolveNamed<Format>(\n * { format: 'short', width: 60 },\n * { key: 'format', names: formatters, kind: 'formatter' }\n * )\n * // { width: 60, ellipsis: '…' }\n * ```\n *\n * @packageDocumentation\n */\nimport type { StandardJSONSchemaV1, StandardSchemaV1 } from '@standard-schema/spec'\n\nimport { jsonSchemaOf } from './env.ts'\nimport { NamedError, type NamedErrorCode, type NamedErrorDetails } from './errors.ts'\nimport type { ConfigIssue, ConfigPath, JsonSchema, SectionSchema } from './index.ts'\nimport { issuesOf, issuesOfSync } from './section.ts'\nimport { textOfPath } from './text.ts'\n\n/**\n * The export of a module, as a configuration of JSON names it: the module, by what the loader\n * resolves, as a path from the root of the project or the name of a package, and the name of its\n * export, `default` by default.\n */\nexport type ModuleReference = {\n /** The module, as the loader resolves it: `./formatters.mjs`, or a package. */\n readonly module: string\n /** The name of its export: `default` by default. */\n readonly export?: string | undefined\n}\n\n/**\n * A reference to an entry by its name under the key `K`, with the options beside it, which the\n * entry is given: `{ \"format\": \"short\", \"width\": 60 }` of the key `format`. Of a key not known, as\n * `string`, any object of options.\n */\nexport type NamedUse<K extends string = string> = string extends K\n ? NamedOptions\n : { readonly [P in K]: string } & NamedOptions\n\n/**\n * A reference, as a configuration of JSON gives it: the name of an entry; the name under the key\n * `K`, with options; or the export of a module.\n */\nexport type NamedReference<K extends string = string> = string | NamedUse<K> | ModuleReference\n\n/** The options a reference gives an entry: each beside its name, but the key and any `undefined`. */\nexport type NamedOptions = Readonly<Record<string, unknown>>\n\n/** An entry of a set: what makes the value of the options a reference gives, none of a name alone. */\nexport type NamedFactory<T> = (options: NamedOptions) => T | Promise<T>\n\n/** The entries of a set, each a factory, by their names, as {@link resolveNamedSet} gives them. */\nexport type NamedEntries<T> = Readonly<Record<string, NamedFactory<T>>>\n\n/**\n * A set of entries, as a configuration gives it: a map of each by its name, a factory, a plain\n * value or the export of a module that is one of those; or the export of a module that is such a\n * map.\n */\nexport type NamedSet<T> =\n | ModuleReference\n | Readonly<Record<string, NamedFactory<T> | ModuleReference | T>>\n\n/** The sets of a configuration: one, or an array of them, merged in order, each over those before. */\nexport type NamedSets<T> = NamedSet<T> | readonly NamedSet<T>[]\n\n/**\n * What loads a module of a {@link ModuleReference}: the module of the text it names, as an object\n * of its exports, or a failure, which a `NamedError` of `UNLOADABLE_MODULE` holds as its cause.\n */\nexport type LoadModule = (module: string) => Promise<unknown>\n\n/**\n * What a set and a reference are resolved by alike: the loader of their modules, the check of\n * their values, their kind, and where they are in the configuration.\n */\nexport type NamedCheckOptions<T> = {\n /** What loads each module named: none by default, of which a module is unloadable. */\n readonly load?: LoadModule | undefined\n /**\n * What checks a value: a Standard Schema, a JSON Schema or a function, as `issuesOf` of\n * ./section takes it. Of a set, each value an entry is, of a map or of a module, but a function,\n * whose results it checks too of `checkResults`; of a reference, the value it resolves to.\n */\n readonly check?: SectionSchema<T> | undefined\n /** What the entries are, which an error names: `entry` by default, as `formatter`. */\n readonly kind?: string | undefined\n /**\n * Where the sets, or the reference, are in the configuration, which the `at` of an error starts\n * with, and its message names, as `['formatters']`: none by default.\n */\n readonly at?: ConfigPath | undefined\n}\n\n/** How a set is resolved: as {@link NamedCheckOptions} say, and whether `check` checks what a\n * function entry gives. */\nexport type NamedSetOptions<T> = NamedCheckOptions<T> & {\n /**\n * Whether `check` checks too what each function entry gives, each time it is called, as it\n * checks a value entry once: no by default, of which a function entry is used as it is.\n */\n readonly checkResults?: boolean | undefined\n}\n\n/** How a reference is resolved: the key of its names, its entries, and what\n * {@link NamedCheckOptions} say. */\nexport type NamedResolveOptions<T> = NamedCheckOptions<T> & {\n /** The key a reference of options names its entry by, as `format`: none takes a name alone. */\n readonly key?: string | undefined\n /** The entries a reference names, by their names: none by default. */\n readonly names?: NamedEntries<T> | undefined\n}\n\n/** The schema of a reference or a set: a Standard Schema that checks it, and gives its JSON Schema. */\nexport type NamedSchema<T> = StandardSchemaV1<unknown, T> & StandardJSONSchemaV1<unknown, T>\n\n/** Whether `value` is an object of keys, as JSON's: no list, and no instance of a class. */\nconst isPlain = (value: unknown): value is Readonly<Record<string, unknown>> => {\n if (typeof value !== 'object' || value === null || Array.isArray(value)) return false\n const prototype: unknown = Object.getPrototypeOf(value)\n return prototype === Object.prototype || prototype === null\n}\n\n/** Whether `value` is the export of a module: an object whose `module` is a text. */\nconst isModule = (value: unknown): value is ModuleReference =>\n isPlain(value) && typeof value['module'] === 'string'\n\n/** `word` after its article, `a` or `an`, as `an entry`. */\nconst article = (word: string): string => `${/^[aeiou]/i.test(word) ? 'an' : 'a'} ${word}`\n\n/** `text` of a capital first. */\nconst capital = (text: string): string => `${text.charAt(0).toUpperCase()}${text.slice(1)}`\n\n/** `value` as an error names it. */\nconst textOf = (value: unknown): string =>\n typeof value === 'function' ? 'a function' : (JSON.stringify(value) ?? String(value))\n\n/** The options of `options` that are given: each but those of `undefined`. */\nconst givenOf = (options: NamedOptions): NamedOptions =>\n Object.fromEntries(Object.entries(options).filter(([, value]) => value !== undefined))\n\n/**\n * The entry of `value`: of a plain object, `value` with the options a reference gives beside the\n * name merged over it, key by key, and those of `undefined` left out, so\n * `{ format: 'short', width: 60 }` gives `{ width: 60, ellipsis: '…' }` of\n * `{ width: 40, ellipsis: '…' }`; of any other value, the value, which takes no options, so options\n * given are a `NamedError` of `INVALID_NAMED_VALUE`. {@link resolveNamedSet} makes each value of a\n * set that is no function an entry so.\n */\nexport function factoryOf<T>(value: T): NamedFactory<T> {\n return (options) => {\n const given = givenOf(options)\n if (isPlain(value)) return { ...value, ...given } as T\n if (Object.keys(given).length === 0) return value\n throw new NamedError(\n 'INVALID_NAMED_VALUE',\n `${textOf(value)} takes no options, and is given ${Object.keys(given).join(', ')}.`\n )\n }\n}\n\n/** The text of the issues a check found. */\nconst issuesText = (issues: readonly ConfigIssue[]): string =>\n issues\n .map(({ path, message }) => (path.length === 0 ? message : `${path.join('.')}: ${message}`))\n .join('; ')\n\n/**\n * Where a value of the sets or a reference is, as a `NamedError` names it: its path; the path of\n * its set or its reference, which the message starts with, as the message names the entry itself;\n * the index of its set and the name of its entry; and what it is to be, as `the formatter wide`.\n */\ntype Place = {\n readonly at: ConfigPath\n readonly where: ConfigPath\n readonly set?: number | undefined\n readonly entry?: string | undefined\n readonly as?: string | undefined\n}\n\n/** The module and the export of `reference`, as a `NamedError` names them. */\nconst moduleDetails = (reference: ModuleReference): NamedErrorDetails => ({\n module: reference.module,\n export: reference.export ?? 'default'\n})\n\n/**\n * A `NamedError` of `code` at `place`: its message after the path of its set or its reference, of\n * one that is not empty, and the path, the set and the entry of the place beside `details`.\n */\nfunction namedError(\n code: NamedErrorCode,\n message: string,\n { at, where, set, entry }: Place,\n details: NamedErrorDetails = {},\n options?: ErrorOptions\n): NamedError {\n return new NamedError(\n code,\n where.length === 0 ? message : `${textOfPath(where)}: ${message}`,\n {\n ...details,\n at,\n ...(set === undefined ? {} : { set }),\n ...(entry === undefined ? {} : { entry })\n },\n options\n )\n}\n\n/**\n * `value`, checked by `check`, else a `NamedError` of `INVALID_NAMED_VALUE` at `place`, whose\n * message is `failing` and the issues, and `details` beside it.\n */\nasync function checked<T>(\n value: unknown,\n check: SectionSchema<T> | undefined,\n failing: string,\n place: Place,\n details: NamedErrorDetails = {}\n): Promise<T> {\n if (check === undefined) return value as T\n const { issues, value: read } = await issuesOf(value, check)\n if (issues.length === 0) return read\n throw namedError('INVALID_NAMED_VALUE', `${failing}: ${issuesText(issues)}.`, place, {\n ...details,\n issues\n })\n}\n\n/**\n * The export `reference.export`, `default` by default, of the module `reference.module`, loaded by\n * `load`: a `NamedError` at `place` of `UNLOADABLE_MODULE` of a module that fails to load, or of no\n * loader, and of `MISSING_EXPORT` of an export it has not, each of the module and the export.\n */\nasync function exportOf(\n reference: ModuleReference,\n load: LoadModule | undefined,\n place: Place\n): Promise<unknown> {\n const { module } = reference\n const name = reference.export ?? 'default'\n const details = moduleDetails(reference)\n const as = place.as === undefined ? '' : ` as ${place.as}`\n if (load === undefined)\n throw namedError(\n 'UNLOADABLE_MODULE',\n `The module ${module} cannot be loaded, for its export ${name}${as}: no loader of modules is given.`,\n place,\n details\n )\n let loaded: unknown\n try {\n loaded = await load(module)\n } catch (error) {\n throw namedError(\n 'UNLOADABLE_MODULE',\n `The module ${module} cannot be loaded, for its export ${name}${as}: ${error instanceof Error ? error.message : String(error)}`,\n place,\n details,\n { cause: error }\n )\n }\n const exports = loaded as Readonly<Record<string, unknown>> | null | undefined\n const found = typeof exports === 'object' && exports !== null ? exports[name] : undefined\n if (found === undefined)\n throw namedError(\n 'MISSING_EXPORT',\n `The module ${module} has no export ${name}${as}.`,\n place,\n details\n )\n return found\n}\n\n/** What a module's export is, as an error names it. */\nconst exportText = ({ module, export: name = 'default' }: ModuleReference): string =>\n `The export ${name} of ${module}`\n\n/**\n * The entry of `value` of the name `name`, at `place`: a function as it is, or, of `checkResults`,\n * one whose results `check` checks; else the value checked, of {@link factoryOf}.\n */\nasync function entryOf<T>(\n value: unknown,\n name: string,\n place: Place,\n { load, check, checkResults, kind = 'entry' }: NamedSetOptions<T>\n): Promise<NamedFactory<T>> {\n const reference = isModule(value) ? value : undefined\n const details = reference === undefined ? {} : moduleDetails(reference)\n const found =\n reference === undefined\n ? value\n : await exportOf(reference, load, { ...place, as: `the ${kind} ${name}` })\n const what =\n reference === undefined\n ? `The ${kind} ${name}`\n : `${exportText(reference)}, the ${kind} ${name},`\n if (typeof found === 'function') {\n const factory = found as NamedFactory<T>\n if (checkResults !== true || check === undefined) return factory\n return async (options) =>\n checked(\n await factory(options),\n check,\n `${what} gives a value that is not valid`,\n place,\n details\n )\n }\n return factoryOf(await checked(found, check, `${what} is not valid`, place, details))\n}\n\n/**\n * The entries of `sets`, each a factory, by their names: of each set in order, a map of entries by\n * name or the export of a module that is one, a later set over an earlier one by name, so a\n * project's own are over those of a package; none of `undefined`. Each entry is a function, a\n * factory as it is, or a plain value, checked by `check`, of {@link factoryOf}; or the export of\n * a module that is one of those, loaded by `load`. Of `checkResults`, `check` checks what each\n * function entry gives too, each time it is called. Each module is loaded at once, so a set that\n * fails does before any entry is used. Fails with a `NamedError` of `UNLOADABLE_MODULE` or\n * `MISSING_EXPORT` of a module, and of `INVALID_NAMED_VALUE` of a set that is no map, or a value\n * `check` refuses. The error names where it failed: its `at` is the path `at` gives, the index of\n * the set in an array of sets, its `set`, and the name of the entry, its `entry`, as\n * `['formatters', '1', 'wide']`, and its message starts with the path of the set; and its `module`\n * and `export` are those of a set or an entry a module exports.\n */\nexport async function resolveNamedSet<T>(\n sets: NamedSets<T> | undefined,\n options: NamedSetOptions<T> = {}\n): Promise<NamedEntries<T>> {\n const { at = [], kind = 'entry' } = options\n const many = Array.isArray(sets)\n const list: readonly unknown[] = sets === undefined ? [] : many ? sets : [sets]\n const resolved = await Promise.all(\n list.map(async (set, index) => {\n const of = many ? [...at, String(index)] : at\n const place: Place = { at: of, where: of, ...(many ? { set: index } : {}) }\n const reference = isModule(set) ? set : undefined\n const map =\n reference === undefined\n ? set\n : await exportOf(reference, options.load, { ...place, as: `a set of ${kind}s` })\n if (!isPlain(map))\n throw namedError(\n 'INVALID_NAMED_VALUE',\n `${reference === undefined ? textOf(set) : exportText(reference)} is no set: give an object of each ${kind} by its name.`,\n place,\n reference === undefined ? {} : moduleDetails(reference)\n )\n const entries = await Promise.all(\n Object.entries(map).map(async ([name, value]): Promise<[string, NamedFactory<T>]> => [\n name,\n await entryOf(value, name, { ...place, at: [...place.at, name], entry: name }, options)\n ])\n )\n return Object.fromEntries(entries)\n })\n )\n return Object.assign({}, ...resolved) as NamedEntries<T>\n}\n\n/** What `error` names but its place, as a `NamedError` that holds it gives it again. */\nconst detailsOf = (error: NamedError): NamedErrorDetails => ({\n ...(error.unknown === undefined ? {} : { name: error.unknown }),\n ...(error.module === undefined ? {} : { module: error.module }),\n ...(error.export === undefined ? {} : { export: error.export }),\n names: error.names,\n issues: error.issues\n})\n\n/**\n * The value `reference` is: of a name, the entry of that name of `names`, given no options; of an\n * object of the `key`, the entry of the name under it, given the options beside it but those of\n * `undefined`; of the export of a module, `{ module, export }`, the export as it is, loaded by\n * `load`. With a `check`, the value is checked by it. Fails with a `NamedError`: `UNKNOWN_NAME` of\n * a name of no entry, whose message lists the names there are; `UNLOADABLE_MODULE` and\n * `MISSING_EXPORT` of a module; and `INVALID_NAMED_VALUE` of a reference of none of the forms, or\n * a value `check` refuses. The error names where it failed: its `at` is the path `at` gives, which\n * its message starts with; its `entry` the name of the entry whose value fails, or which fails as\n * it is given its options; and its `module` and `export` those of a reference to a module.\n */\nexport async function resolveNamed<T>(\n reference: NamedReference,\n { key, names = {}, load, check, kind = 'entry', at = [] }: NamedResolveOptions<T> = {}\n): Promise<T> {\n const place: Place = { at, where: at }\n const use: unknown = reference\n if (isModule(use) && (key === undefined || !(key in use)))\n return checked(\n await exportOf(use, load, place),\n check,\n `${exportText(use)} is not valid`,\n place,\n moduleDetails(use)\n )\n const named =\n typeof use === 'string'\n ? { name: use, options: {} }\n : isPlain(use) && key !== undefined && typeof use[key] === 'string'\n ? (() => {\n const { [key]: name, ...options } = use\n return { name: name as string, options: givenOf(options) }\n })()\n : undefined\n if (named === undefined)\n throw namedError(\n 'INVALID_NAMED_VALUE',\n `${textOf(use)} is no reference of ${article(kind)}: give its name${key === undefined ? '' : `, { \"${key}\": name, … }`} or { \"module\": …, \"export\": … }.`,\n place\n )\n const { name, options } = named\n if (!Object.hasOwn(names, name)) {\n const known = Object.keys(names)\n throw namedError(\n 'UNKNOWN_NAME',\n `No ${kind} is named ${JSON.stringify(name)}: the names are ${known.length === 0 ? 'none' : known.join(', ')}.`,\n place,\n { name, names: known }\n )\n }\n const entry = names[name] as NamedFactory<T>\n const of: Place = { ...place, entry: name }\n let value: unknown\n try {\n value = await entry(options)\n } catch (error) {\n if (!(error instanceof NamedError) || error.entry !== undefined) throw error\n throw namedError(\n error.code,\n `The ${kind} ${name} fails: ${error.message}`,\n of,\n detailsOf(error),\n { cause: error }\n )\n }\n return checked(value, check, `The ${kind} ${name} is not valid`, of)\n}\n\n/** The JSON Schema of the export of a module. */\nconst MODULE_SCHEMA = {\n description: 'The export of a module: `default` by default.',\n type: 'object',\n properties: {\n module: {\n description: 'The module: a path from the root, or a package.',\n type: 'string',\n minLength: 1\n },\n export: {\n description: 'The name of its export: `default` by default.',\n type: 'string',\n minLength: 1\n }\n },\n required: ['module'],\n additionalProperties: false\n} as const\n\n/** The JSON Schema of a name: a text, of the `names` an editor completes. */\nconst nameSchema = (kind: string, names: readonly string[] | undefined): JsonSchema => ({\n description: `The name of ${article(kind)}.`,\n type: 'string',\n minLength: 1,\n ...(names === undefined || names.length === 0 ? {} : { examples: [...names] })\n})\n\n/** The JSON Schema of `schema`, as an object of its keywords: `{}`, any value, of none. */\nconst objectSchemaOf = (schema: SectionSchema | undefined): Readonly<Record<string, unknown>> => {\n const json = schema === undefined ? undefined : jsonSchemaOf(schema)\n if (json === undefined || json === true) return {}\n if (json === false) return { not: {} }\n const { $schema: _draft, $id: _id, ...rest } = json\n return rest\n}\n\n/**\n * The schema of `json`, of the type `T`: it checks a value by ajv, as `issuesOfSync` of ./section\n * checks a JSON Schema, and gives `json`, of draft 2020-12, as the JSON Schema of its input and\n * output alike.\n */\nfunction schemaOf<T>(json: Readonly<Record<string, unknown>>): NamedSchema<T> {\n const jsonSchema = (): Record<string, unknown> => ({ ...json })\n return {\n '~standard': {\n version: 1,\n vendor: '@wtf/project-config',\n validate: (value) => {\n const { issues } = issuesOfSync(value, json)\n return issues.length === 0\n ? { value: value as T }\n : { issues: issues.map(({ path, message }) => ({ path, message })) }\n },\n jsonSchema: { input: jsonSchema, output: jsonSchema }\n }\n }\n}\n\n/** What the schema of a reference says of it. */\nexport type NamedSchemaOptions = {\n /** The names an editor completes: those of the entries there are. */\n readonly names?: readonly string[] | undefined\n /**\n * The schema of the options beside a name, as each entry takes them: a JSON Schema, or a\n * Standard Schema that gives one, of an object, whose `properties` are each an option. Any by\n * default.\n */\n readonly options?: SectionSchema | undefined\n /** What the entries are, which the descriptions name: `entry` by default. */\n readonly kind?: string | undefined\n}\n\n/**\n * The schema of a reference of the key `key`: a name, of `names`, which an editor completes;\n * `{ [key]: name, … }`, with the options of `options` beside it, each optional, as they are over\n * the entry's own; or `{ module, export }`. Its JSON Schema, which `input()` of its\n * `~standard.jsonSchema` gives, holds no `$schema`, so it goes in a tool's own as it is.\n */\nexport function namedSchema<K extends string>(\n key: K,\n { names, options, kind = 'entry' }: NamedSchemaOptions = {}\n): NamedSchema<NamedReference<K>> {\n const name = nameSchema(kind, names)\n const { properties, required: _required, type: _type, ...rest } = objectSchemaOf(options)\n return schemaOf({\n description: `${capital(article(kind))}: its name, { \"${key}\": name, … } with options over its own, or the export of a module.`,\n anyOf: [\n name,\n {\n ...rest,\n description: `${capital(article(kind))} by its name, with options over its own.`,\n type: 'object',\n properties: { ...(isPlain(properties) ? properties : {}), [key]: name },\n required: [key]\n },\n MODULE_SCHEMA\n ]\n })\n}\n\n/** What the schema of a set says of it. */\nexport type NamedSetSchemaOptions = {\n /** The schema of the value of an entry: a JSON Schema, or a Standard Schema that gives one. Any by default. */\n readonly entry?: SectionSchema | undefined\n /** What the entries are, which the descriptions name: `entry` by default. */\n readonly kind?: string | undefined\n}\n\n/**\n * The schema of the sets of entries: a set, or an array of sets, merged in order; each set the\n * export of a module, or a map of each entry by its name, of `entry`, or the export of a module.\n * Its JSON Schema holds no `$schema`, as {@link namedSchema}'s.\n */\nexport function namedSetSchema({ entry, kind = 'entry' }: NamedSetSchemaOptions = {}): NamedSchema<\n NamedSets<unknown>\n> {\n const set = {\n description: `A set of ${kind}s: a map of each by its name, or the export of a module that is one.`,\n anyOf: [\n MODULE_SCHEMA,\n {\n type: 'object',\n additionalProperties: { anyOf: [MODULE_SCHEMA, objectSchemaOf(entry)] }\n }\n ]\n }\n return schemaOf({\n description: `The sets of ${kind}s: a set, or an array of sets merged in order, each over those before.`,\n anyOf: [set, { type: 'array', items: set }]\n })\n}\n"]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@wtf/project-config",
3
- "version": "1.1.0",
3
+ "version": "1.1.1",
4
4
  "description": "Read and write a project's configuration of its tools: one object under a namespace, wtf by default, with a section for each tool, in wtf.config.{mjs,js,ts,json} or the wtf key of package.json, the first found. Find it (./locate); load it, asynchronously with code, or synchronously of JSON and package.json alone (./load); read a tool's section, checked by its Standard Schema, a JSON Schema or a function, with WTF_<SECTION>_<KEY> variables over it (./section, ./env); replace ${env:NAME} placeholders (./placeholder); get a value by its path (./path); write a value (./write); the JSON Schema of the whole (./schema); a code config, typed (./define); a value or a function named in JSON, by a name, a name with options or the export of a module, of sets merged in order (./named); Node's platform, loads and loader of modules (./node); and the errors (./errors).",
5
5
  "homepage": "https://gitlab.com/wetryfun/project/project/-/tree/main/packages/project-config",
6
6
  "bugs": {