app/lib/projects-page.mjs

Functions

Imports

It imports no other module of this repo. No module of this repo imports it.

Source

1/**
2 * Roster metrics for content/projects.json. The public Software pages are markdown in
3 * content/pages/, and their search records come from the content-page indexer. check:features
4 * computes a derived metric through metricValue, so the roster and the gate share one derivation.
5 */
6
7export const PROJECTS_URL = "/software";
8
9/**
10 * A derived metric carries no date: a date on a value recomputed every build would be a claim
11 * about when a human last looked.
12 *
13 * @type {Record<string, (inputs: any) => string>}
14 */
15export const METRIC_DERIVATIONS = {
16  "gate-count": (inputs) => String(inputs.stack.gates.length),
17};
18
19/**
20 * Called by the gate, so the gate never computes the expected value its own way.
21 *
22 * @param {any} metric
23 * @param {{ stack: any }} inputs
24 * @returns {string}
25 */
26export function metricValue(metric, inputs) {
27  if (!metric.derived) return metric.value;
28  const derive = METRIC_DERIVATIONS[metric.derived];
29  if (!derive) {
30    throw new Error(
31      `content/projects.json names the derivation "${metric.derived}", which ` +
32        `METRIC_DERIVATIONS in app/lib/projects-page.mjs does not implement. ` +
33        `Known: ${Object.keys(METRIC_DERIVATIONS).join(", ")}.`,
34    );
35  }
36  return derive(inputs);
37}