wyvrnpm 2.11.0 → 2.12.2

package/src/options.js

@@ -1,303 +1,303 @@
-'use strict';
-
-/**
- * Recipe-declared options: `wyvrn.json` gains a top-level `options` block
- * that declares feature toggles the package exposes (shared/static,
- * `minizip` on zlib, FIPS on OpenSSL, etc.). Consumers override per-dep
- * via `dependencies.<name>.options` or on the CLI via `-o <name>:<key>=<value>`.
- *
- * Options fold into `profileHash` (via `hashProfile`), so every distinct
- * option combination gets its own artefact on the registry.
- *
- * Scope:
- *   - Recipe declares options with `default` + `allowed` per name.
- *   - Consumer can override any declared option to any `allowed` value.
- *   - No transitive propagation for MVP (see PLAN-OPTIONS §2).
- *   - Values are `boolean` or string-enum; no integers/lists.
- *
- * See claude/PLAN-OPTIONS.md for the full design and
- * claude/PLAN-OPTIONS-EXAMPLE.md for a worked zlib walkthrough.
- */
-
-// Option names are conservative — lower-case, start with a letter. Prevents
-// collisions with future reserved keywords (`options.schemaVersion` etc.)
-const OPTION_NAME_RE = /^[a-z][a-z0-9_-]*$/;
-
-/**
- * Validate and normalise a recipe's `options` block. Returns a canonical
- * form (a fresh object with the declared options preserved, `allowed`
- * arrays duplicated defensively), or null if the recipe has no options.
- *
- * Throws with a precise, user-facing message on any structural error.
- *
- * @param {object|null|undefined} rawOptions - the `options` field from a recipe wyvrn.json
- * @param {string} [pkgContext] - e.g. "zlib@1.3.0.0" — included in error messages
- * @returns {Record<string, { default: any, allowed: any[] }>|null}
- */
-function normalizeOptionsDeclaration(rawOptions, pkgContext = '') {
-  if (rawOptions === null || rawOptions === undefined) return null;
-  const where = pkgContext ? ` in ${pkgContext}` : '';
-
-  if (typeof rawOptions !== 'object' || Array.isArray(rawOptions)) {
-    throw new Error(`\`options\`${where} must be an object mapping option names to { default, allowed } specs`);
-  }
-
-  const result = {};
-  for (const [name, spec] of Object.entries(rawOptions)) {
-    if (!OPTION_NAME_RE.test(name)) {
-      throw new Error(
-        `option name "${name}"${where} is invalid — must match /^[a-z][a-z0-9_-]*$/`,
-      );
-    }
-    if (!spec || typeof spec !== 'object' || Array.isArray(spec)) {
-      throw new Error(`options.${name}${where} must be an object of the form { default: <value>, allowed: [<value>, ...] }`);
-    }
-    if (!('default' in spec) || !('allowed' in spec)) {
-      throw new Error(
-        `options.${name}${where} is missing the \`default\` or \`allowed\` field\n` +
-        `  shape expected: { "default": <value>, "allowed": [<value>, ...] }`,
-      );
-    }
-    if (!Array.isArray(spec.allowed) || spec.allowed.length === 0) {
-      throw new Error(`options.${name}.allowed${where} must be a non-empty array`);
-    }
-    for (const v of spec.allowed) {
-      const t = typeof v;
-      if (t !== 'boolean' && t !== 'string') {
-        throw new Error(
-          `options.${name}.allowed${where} values must be boolean or string (got ${t}: ${JSON.stringify(v)})`,
-        );
-      }
-    }
-    if (!spec.allowed.includes(spec.default)) {
-      throw new Error(
-        `options.${name}.default = ${JSON.stringify(spec.default)}${where} is not in allowed: ${JSON.stringify(spec.allowed)}`,
-      );
-    }
-    result[name] = { default: spec.default, allowed: spec.allowed.slice() };
-  }
-  return result;
-}
-
-/**
- * Compute the effective (resolved) options for a dep by starting from the
- * recipe's declared defaults, overlaying the consumer's wyvrn.json
- * overrides, then overlaying CLI `-o` overrides. Each override is
- * validated against the recipe's `allowed` list.
- *
- * Returns null when the recipe has no declared options. Returning null
- * (vs an empty object) is how `hashProfile` distinguishes "no options"
- * from "options declared but all at defaults" — the former produces the
- * pre-F1 hash for backward compatibility.
- *
- * @param {object|null} declaration — normalised recipe options (from `normalizeOptionsDeclaration`)
- * @param {object} [consumerOverrides] — dependencies.<name>.options from consumer wyvrn.json
- * @param {object} [cliOverrides] — scoped to this package, extracted from `-o` flags
- * @param {string} [pkgContext] — "zlib@1.3.0.0" style, for error messages
- * @returns {Record<string, any>|null}
- */
-function resolveEffectiveOptions(declaration, consumerOverrides = {}, cliOverrides = {}, pkgContext = '') {
-  if (!declaration) {
-    // Recipe didn't declare options → consumer must not supply any
-    const extra = new Set([
-      ...Object.keys(consumerOverrides ?? {}),
-      ...Object.keys(cliOverrides ?? {}),
-    ]);
-    if (extra.size > 0) {
-      throw new Error(
-        `${pkgContext || 'package'} has no declared options, but received overrides: ${[...extra].join(', ')}`,
-      );
-    }
-    return null;
-  }
-
-  const declaredNames = Object.keys(declaration);
-
-  const validateSource = (overrides, sourceLabel) => {
-    for (const [key, value] of Object.entries(overrides ?? {})) {
-      if (!(key in declaration)) {
-        const suggestion = findClosest(key, declaredNames);
-        const hint = suggestion ? `\n  Did you mean "${suggestion}"?` : '';
-        throw new Error(
-          `unknown option "${key}" for ${pkgContext || 'package'} (from ${sourceLabel})\n` +
-          `  declared options: ${declaredNames.join(', ')}${hint}`,
-        );
-      }
-      if (!declaration[key].allowed.includes(value)) {
-        throw new Error(
-          `option ${pkgContext ? pkgContext + '.' : ''}${key} = ${JSON.stringify(value)} is not allowed (from ${sourceLabel})\n` +
-          `  allowed values: ${declaration[key].allowed.map((v) => JSON.stringify(v)).join(', ')}`,
-        );
-      }
-    }
-  };
-  validateSource(consumerOverrides, 'wyvrn.json');
-  validateSource(cliOverrides, '--option CLI flag');
-
-  const effective = {};
-  for (const [name, spec] of Object.entries(declaration)) {
-    effective[name] = spec.default;
-    if (consumerOverrides && name in consumerOverrides) effective[name] = consumerOverrides[name];
-    if (cliOverrides      && name in cliOverrides)      effective[name] = cliOverrides[name];
-  }
-  return effective;
-}
-
-/**
- * Parse the `--option`/`-o` CLI flag values into a nested map.
- *
- *   ["zlib:minizip=false", "openssl:fips=true"]
- *     ↓
- *   { zlib: { minizip: false }, openssl: { fips: true } }
- *
- * Rules:
- *   - Split once on ":" (package name cannot contain ":", enforced by
- *     manifest validation elsewhere).
- *   - Split the right side once on "=" so string values may contain "=".
- *   - Coerce "true"/"false" (case-insensitive) to booleans; everything
- *     else stays a string. Downstream validation against the recipe's
- *     `allowed` list catches illegal values.
- *   - Empty package name, option name, or value → usage error.
- *
- * @param {string|string[]|undefined} rawFlags
- * @returns {Record<string, Record<string, any>>}
- */
-function parseCliOptions(rawFlags) {
-  if (!rawFlags) return {};
-  const arr = Array.isArray(rawFlags) ? rawFlags : [rawFlags];
-  const result = {};
-  for (const entry of arr) {
-    if (typeof entry !== 'string' || entry.length === 0) continue;
-    const colonIdx = entry.indexOf(':');
-    if (colonIdx <= 0) {
-      throw new Error(`--option "${entry}" is malformed — expected <pkg>:<name>=<value>`);
-    }
-    const pkg = entry.slice(0, colonIdx);
-    const rest = entry.slice(colonIdx + 1);
-    const eqIdx = rest.indexOf('=');
-    if (eqIdx <= 0 || eqIdx === rest.length - 1) {
-      throw new Error(`--option "${entry}" is malformed — expected <pkg>:<name>=<value>`);
-    }
-    const name  = rest.slice(0, eqIdx);
-    const value = rest.slice(eqIdx + 1);
-    if (!result[pkg]) result[pkg] = {};
-    result[pkg][name] = coerceCliValue(value);
-  }
-  return result;
-}
-
-function coerceCliValue(raw) {
-  const lc = raw.toLowerCase();
-  if (lc === 'true')  return true;
-  if (lc === 'false') return false;
-  return raw;
-}
-
-/**
- * Template-expand `${options.<name>}` occurrences in a single string using
- * the supplied `effective` options map. Bool values coerce to CMake's
- * `ON`/`OFF`; string values expand verbatim.
- *
- * A missing variable (`${options.fips}` with no `fips` in effective) is
- * a hard error — a typo in the recipe must fail fast at source-build
- * configure time, not silently reach cmake as a literal unexpanded
- * string. If the recipe declares no options at all, every template
- * reference fails for the same reason.
- *
- * @param {string} arg      a single argv element (e.g. `-DSHARED=${options.shared}`)
- * @param {Record<string, any>|null} effective
- * @param {string} [context] — for the error message (`build.configure`, `build.buildArgs`)
- * @returns {string}
- */
-function substituteTemplate(arg, effective, context = '') {
-  if (typeof arg !== 'string') return arg;
-  return arg.replace(/\$\{options\.([a-z][a-z0-9_-]*)\}/g, (_full, name) => {
-    if (!effective || !(name in effective)) {
-      const declared = effective ? Object.keys(effective) : [];
-      const declaredLine = declared.length > 0
-        ? `\n  declared options: ${declared.join(', ')}`
-        : '\n  (no options declared on this recipe)';
-      throw new Error(
-        `${context ? context + ' ' : ''}references \${options.${name}} but no such option is declared${declaredLine}`,
-      );
-    }
-    const v = effective[name];
-    if (v === true)  return 'ON';
-    if (v === false) return 'OFF';
-    return String(v);
-  });
-}
-
-/**
- * Apply `substituteTemplate` across an array of argv elements.
- *
- * @param {string[]} args
- * @param {Record<string, any>|null} effective
- * @param {string} [context]
- * @returns {string[]}
- */
-function substituteTemplateAll(args, effective, context = '') {
-  if (!Array.isArray(args)) return args;
-  return args.map((a) => substituteTemplate(a, effective, context));
-}
-
-/**
- * Return a new object with the same keys sorted alphabetically. Used as
- * the canonical form for hashing.
- *
- * @param {object|null} options
- * @returns {object|null}
- */
-function sortAndNormaliseOptions(options) {
-  if (!options) return null;
-  return Object.fromEntries(
-    Object.entries(options).sort(([a], [b]) => a.localeCompare(b)),
-  );
-}
-
-// ---------------------------------------------------------------------------
-// "Did you mean" suggestion helper — Levenshtein with a small-distance cap.
-// ---------------------------------------------------------------------------
-
-function findClosest(needle, haystack) {
-  if (!Array.isArray(haystack) || haystack.length === 0) return null;
-  const cap = Math.max(2, Math.floor(needle.length / 3));
-  let best = null;
-  let bestDist = Infinity;
-  for (const candidate of haystack) {
-    const d = levenshtein(needle.toLowerCase(), candidate.toLowerCase());
-    if (d < bestDist && d <= cap) {
-      best = candidate;
-      bestDist = d;
-    }
-  }
-  return best;
-}
-
-function levenshtein(a, b) {
-  const m = a.length;
-  const n = b.length;
-  if (m === 0) return n;
-  if (n === 0) return m;
-  let prev = new Array(n + 1);
-  for (let j = 0; j <= n; j++) prev[j] = j;
-  for (let i = 1; i <= m; i++) {
-    const curr = [i];
-    for (let j = 1; j <= n; j++) {
-      const cost = a[i - 1] === b[j - 1] ? 0 : 1;
-      curr.push(Math.min(prev[j] + 1, curr[j - 1] + 1, prev[j - 1] + cost));
-    }
-    prev = curr;
-  }
-  return prev[n];
-}
-
-module.exports = {
-  normalizeOptionsDeclaration,
-  resolveEffectiveOptions,
-  parseCliOptions,
-  sortAndNormaliseOptions,
-  substituteTemplate,
-  substituteTemplateAll,
-  OPTION_NAME_RE,
-};
+'use strict';
+
+/**
+ * Recipe-declared options: `wyvrn.json` gains a top-level `options` block
+ * that declares feature toggles the package exposes (shared/static,
+ * `minizip` on zlib, FIPS on OpenSSL, etc.). Consumers override per-dep
+ * via `dependencies.<name>.options` or on the CLI via `-o <name>:<key>=<value>`.
+ *
+ * Options fold into `profileHash` (via `hashProfile`), so every distinct
+ * option combination gets its own artefact on the registry.
+ *
+ * Scope:
+ *   - Recipe declares options with `default` + `allowed` per name.
+ *   - Consumer can override any declared option to any `allowed` value.
+ *   - No transitive propagation for MVP (see PLAN-OPTIONS §2).
+ *   - Values are `boolean` or string-enum; no integers/lists.
+ *
+ * See claude/PLAN-OPTIONS.md for the full design and
+ * claude/PLAN-OPTIONS-EXAMPLE.md for a worked zlib walkthrough.
+ */
+
+// Option names are conservative — lower-case, start with a letter. Prevents
+// collisions with future reserved keywords (`options.schemaVersion` etc.)
+const OPTION_NAME_RE = /^[a-z][a-z0-9_-]*$/;
+
+/**
+ * Validate and normalise a recipe's `options` block. Returns a canonical
+ * form (a fresh object with the declared options preserved, `allowed`
+ * arrays duplicated defensively), or null if the recipe has no options.
+ *
+ * Throws with a precise, user-facing message on any structural error.
+ *
+ * @param {object|null|undefined} rawOptions - the `options` field from a recipe wyvrn.json
+ * @param {string} [pkgContext] - e.g. "zlib@1.3.0.0" — included in error messages
+ * @returns {Record<string, { default: any, allowed: any[] }>|null}
+ */
+function normalizeOptionsDeclaration(rawOptions, pkgContext = '') {
+  if (rawOptions === null || rawOptions === undefined) return null;
+  const where = pkgContext ? ` in ${pkgContext}` : '';
+
+  if (typeof rawOptions !== 'object' || Array.isArray(rawOptions)) {
+    throw new Error(`\`options\`${where} must be an object mapping option names to { default, allowed } specs`);
+  }
+
+  const result = {};
+  for (const [name, spec] of Object.entries(rawOptions)) {
+    if (!OPTION_NAME_RE.test(name)) {
+      throw new Error(
+        `option name "${name}"${where} is invalid — must match /^[a-z][a-z0-9_-]*$/`,
+      );
+    }
+    if (!spec || typeof spec !== 'object' || Array.isArray(spec)) {
+      throw new Error(`options.${name}${where} must be an object of the form { default: <value>, allowed: [<value>, ...] }`);
+    }
+    if (!('default' in spec) || !('allowed' in spec)) {
+      throw new Error(
+        `options.${name}${where} is missing the \`default\` or \`allowed\` field\n` +
+        `  shape expected: { "default": <value>, "allowed": [<value>, ...] }`,
+      );
+    }
+    if (!Array.isArray(spec.allowed) || spec.allowed.length === 0) {
+      throw new Error(`options.${name}.allowed${where} must be a non-empty array`);
+    }
+    for (const v of spec.allowed) {
+      const t = typeof v;
+      if (t !== 'boolean' && t !== 'string') {
+        throw new Error(
+          `options.${name}.allowed${where} values must be boolean or string (got ${t}: ${JSON.stringify(v)})`,
+        );
+      }
+    }
+    if (!spec.allowed.includes(spec.default)) {
+      throw new Error(
+        `options.${name}.default = ${JSON.stringify(spec.default)}${where} is not in allowed: ${JSON.stringify(spec.allowed)}`,
+      );
+    }
+    result[name] = { default: spec.default, allowed: spec.allowed.slice() };
+  }
+  return result;
+}
+
+/**
+ * Compute the effective (resolved) options for a dep by starting from the
+ * recipe's declared defaults, overlaying the consumer's wyvrn.json
+ * overrides, then overlaying CLI `-o` overrides. Each override is
+ * validated against the recipe's `allowed` list.
+ *
+ * Returns null when the recipe has no declared options. Returning null
+ * (vs an empty object) is how `hashProfile` distinguishes "no options"
+ * from "options declared but all at defaults" — the former produces the
+ * pre-F1 hash for backward compatibility.
+ *
+ * @param {object|null} declaration — normalised recipe options (from `normalizeOptionsDeclaration`)
+ * @param {object} [consumerOverrides] — dependencies.<name>.options from consumer wyvrn.json
+ * @param {object} [cliOverrides] — scoped to this package, extracted from `-o` flags
+ * @param {string} [pkgContext] — "zlib@1.3.0.0" style, for error messages
+ * @returns {Record<string, any>|null}
+ */
+function resolveEffectiveOptions(declaration, consumerOverrides = {}, cliOverrides = {}, pkgContext = '') {
+  if (!declaration) {
+    // Recipe didn't declare options → consumer must not supply any
+    const extra = new Set([
+      ...Object.keys(consumerOverrides ?? {}),
+      ...Object.keys(cliOverrides ?? {}),
+    ]);
+    if (extra.size > 0) {
+      throw new Error(
+        `${pkgContext || 'package'} has no declared options, but received overrides: ${[...extra].join(', ')}`,
+      );
+    }
+    return null;
+  }
+
+  const declaredNames = Object.keys(declaration);
+
+  const validateSource = (overrides, sourceLabel) => {
+    for (const [key, value] of Object.entries(overrides ?? {})) {
+      if (!(key in declaration)) {
+        const suggestion = findClosest(key, declaredNames);
+        const hint = suggestion ? `\n  Did you mean "${suggestion}"?` : '';
+        throw new Error(
+          `unknown option "${key}" for ${pkgContext || 'package'} (from ${sourceLabel})\n` +
+          `  declared options: ${declaredNames.join(', ')}${hint}`,
+        );
+      }
+      if (!declaration[key].allowed.includes(value)) {
+        throw new Error(
+          `option ${pkgContext ? pkgContext + '.' : ''}${key} = ${JSON.stringify(value)} is not allowed (from ${sourceLabel})\n` +
+          `  allowed values: ${declaration[key].allowed.map((v) => JSON.stringify(v)).join(', ')}`,
+        );
+      }
+    }
+  };
+  validateSource(consumerOverrides, 'wyvrn.json');
+  validateSource(cliOverrides, '--option CLI flag');
+
+  const effective = {};
+  for (const [name, spec] of Object.entries(declaration)) {
+    effective[name] = spec.default;
+    if (consumerOverrides && name in consumerOverrides) effective[name] = consumerOverrides[name];
+    if (cliOverrides      && name in cliOverrides)      effective[name] = cliOverrides[name];
+  }
+  return effective;
+}
+
+/**
+ * Parse the `--option`/`-o` CLI flag values into a nested map.
+ *
+ *   ["zlib:minizip=false", "openssl:fips=true"]
+ *     ↓
+ *   { zlib: { minizip: false }, openssl: { fips: true } }
+ *
+ * Rules:
+ *   - Split once on ":" (package name cannot contain ":", enforced by
+ *     manifest validation elsewhere).
+ *   - Split the right side once on "=" so string values may contain "=".
+ *   - Coerce "true"/"false" (case-insensitive) to booleans; everything
+ *     else stays a string. Downstream validation against the recipe's
+ *     `allowed` list catches illegal values.
+ *   - Empty package name, option name, or value → usage error.
+ *
+ * @param {string|string[]|undefined} rawFlags
+ * @returns {Record<string, Record<string, any>>}
+ */
+function parseCliOptions(rawFlags) {
+  if (!rawFlags) return {};
+  const arr = Array.isArray(rawFlags) ? rawFlags : [rawFlags];
+  const result = {};
+  for (const entry of arr) {
+    if (typeof entry !== 'string' || entry.length === 0) continue;
+    const colonIdx = entry.indexOf(':');
+    if (colonIdx <= 0) {
+      throw new Error(`--option "${entry}" is malformed — expected <pkg>:<name>=<value>`);
+    }
+    const pkg = entry.slice(0, colonIdx);
+    const rest = entry.slice(colonIdx + 1);
+    const eqIdx = rest.indexOf('=');
+    if (eqIdx <= 0 || eqIdx === rest.length - 1) {
+      throw new Error(`--option "${entry}" is malformed — expected <pkg>:<name>=<value>`);
+    }
+    const name  = rest.slice(0, eqIdx);
+    const value = rest.slice(eqIdx + 1);
+    if (!result[pkg]) result[pkg] = {};
+    result[pkg][name] = coerceCliValue(value);
+  }
+  return result;
+}
+
+function coerceCliValue(raw) {
+  const lc = raw.toLowerCase();
+  if (lc === 'true')  return true;
+  if (lc === 'false') return false;
+  return raw;
+}
+
+/**
+ * Template-expand `${options.<name>}` occurrences in a single string using
+ * the supplied `effective` options map. Bool values coerce to CMake's
+ * `ON`/`OFF`; string values expand verbatim.
+ *
+ * A missing variable (`${options.fips}` with no `fips` in effective) is
+ * a hard error — a typo in the recipe must fail fast at source-build
+ * configure time, not silently reach cmake as a literal unexpanded
+ * string. If the recipe declares no options at all, every template
+ * reference fails for the same reason.
+ *
+ * @param {string} arg      a single argv element (e.g. `-DSHARED=${options.shared}`)
+ * @param {Record<string, any>|null} effective
+ * @param {string} [context] — for the error message (`build.configure`, `build.buildArgs`)
+ * @returns {string}
+ */
+function substituteTemplate(arg, effective, context = '') {
+  if (typeof arg !== 'string') return arg;
+  return arg.replace(/\$\{options\.([a-z][a-z0-9_-]*)\}/g, (_full, name) => {
+    if (!effective || !(name in effective)) {
+      const declared = effective ? Object.keys(effective) : [];
+      const declaredLine = declared.length > 0
+        ? `\n  declared options: ${declared.join(', ')}`
+        : '\n  (no options declared on this recipe)';
+      throw new Error(
+        `${context ? context + ' ' : ''}references \${options.${name}} but no such option is declared${declaredLine}`,
+      );
+    }
+    const v = effective[name];
+    if (v === true)  return 'ON';
+    if (v === false) return 'OFF';
+    return String(v);
+  });
+}
+
+/**
+ * Apply `substituteTemplate` across an array of argv elements.
+ *
+ * @param {string[]} args
+ * @param {Record<string, any>|null} effective
+ * @param {string} [context]
+ * @returns {string[]}
+ */
+function substituteTemplateAll(args, effective, context = '') {
+  if (!Array.isArray(args)) return args;
+  return args.map((a) => substituteTemplate(a, effective, context));
+}
+
+/**
+ * Return a new object with the same keys sorted alphabetically. Used as
+ * the canonical form for hashing.
+ *
+ * @param {object|null} options
+ * @returns {object|null}
+ */
+function sortAndNormaliseOptions(options) {
+  if (!options) return null;
+  return Object.fromEntries(
+    Object.entries(options).sort(([a], [b]) => a.localeCompare(b)),
+  );
+}
+
+// ---------------------------------------------------------------------------
+// "Did you mean" suggestion helper — Levenshtein with a small-distance cap.
+// ---------------------------------------------------------------------------
+
+function findClosest(needle, haystack) {
+  if (!Array.isArray(haystack) || haystack.length === 0) return null;
+  const cap = Math.max(2, Math.floor(needle.length / 3));
+  let best = null;
+  let bestDist = Infinity;
+  for (const candidate of haystack) {
+    const d = levenshtein(needle.toLowerCase(), candidate.toLowerCase());
+    if (d < bestDist && d <= cap) {
+      best = candidate;
+      bestDist = d;
+    }
+  }
+  return best;
+}
+
+function levenshtein(a, b) {
+  const m = a.length;
+  const n = b.length;
+  if (m === 0) return n;
+  if (n === 0) return m;
+  let prev = new Array(n + 1);
+  for (let j = 0; j <= n; j++) prev[j] = j;
+  for (let i = 1; i <= m; i++) {
+    const curr = [i];
+    for (let j = 1; j <= n; j++) {
+      const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+      curr.push(Math.min(prev[j] + 1, curr[j - 1] + 1, prev[j - 1] + cost));
+    }
+    prev = curr;
+  }
+  return prev[n];
+}
+
+module.exports = {
+  normalizeOptionsDeclaration,
+  resolveEffectiveOptions,
+  parseCliOptions,
+  sortAndNormaliseOptions,
+  substituteTemplate,
+  substituteTemplateAll,
+  OPTION_NAME_RE,
+};