@mark1russell7/site-pages 0.2.8 → 0.2.10

package/build/index.js

@@ -1,19 +1,4 @@
-import { $ as DEFAULT_CHANGELOGS, A as BASE_CSS, B as safeUrl, C as RELEASES_SCRIPT, D as oldestFirst, E as laneCenter, F as utcDay, G as linksOf, H as RoadmapParseError, I as escapeHtml, J as plainText, K as markdownTables, L as inlineMarkdown, M as dayRange, N as longDate, O as releaseSummary, P as shortDate, Q as statusClassOf, R as link, S as statusLead, T as renderReleasesPage, U as STATUS_CLASSES, V as OPEN_CLASSES, W as buildStatusBoard, X as roadmapItems, Y as readStatusBoard, Z as splitRow, _ as classCounts, _t as kindOf, a as runCli, at as NPM_REGISTRY, b as sectionsOf, c as MAX_MINORS_BEHIND, ct as GITHUB_GRAPHQL, d as minorsBehind, dt as githubReleases, et as ReleaseDataError, f as parseDataStamps, ft as firstSentence, g as STATUS_SCRIPT, gt as compareVersions, h as probeScript, ht as releaseBodyEntries, i as parseBuildArgs, it as globFiles, j as pageShell, k as timelineLayout, l as checkFreshness, lt as checkStateOf, m as TYPESCRIPT_PROBE, mt as parseChangelog, n as UsageError, nt as readChangelogs, o as DATA_STAMP_SCHEMA, ot as npmPublishTimes, pt as headingAnchor, q as parseRoadmap, r as build, rt as readReleases, s as MAX_DATA_AGE_DAYS, st as GITHUB_API, t as HELP, tt as mergeReleases, u as latestAt, ut as githubOpenWork, v as openGroups, vt as parseVersion, w as releasesLead, x as slugOf, y as renderStatusPage, yt as versionOfTag, z as listText } from "./chunks/build.js";
-import { a as kpiProblems, c as writeKpi, d as headingDate, f as isShallow, i as kpiFile, l as gitTagDates, n as KPI_FORMAT, o as kpiText, p as originRepository, r as KpiError, s as readKpi, t as KPI_FILE, u as headCommit } from "./chunks/kpi.js";
-// src/render/data-stamp.ts
-/** This function gives an engine and its version in the short form, without the npm scope. */
-function engineText(name, version) {
-	return `${name.slice(name.indexOf("/") + 1)} ${version}`;
-}
-/** This function gives the html of one run: a link to the run, the day of its start and each engine. */
-function runHtml(run) {
-	const engines = Object.entries(run.engines).map(([name, version]) => escapeHtml(engineText(name, version)));
-	return `run ${link(run.url, escapeHtml(run.id))} of ${escapeHtml(run.date.slice(0, 10))}, on ${listText(engines)}`;
-}
-/** This function gives the html line of the stamp of a page. A page shows this line with its data. */
-function renderDataStamp(stamp) {
-	return `<p class="data-stamp">${`<span>The data comes from ${listText(stamp.runs.map(runHtml))}.</span>`}${stamp.inFlight === void 0 ? "" : ` <span>A newer run is in flight: ${runHtml(stamp.inFlight)}.</span>`}</p>`;
-}
-export { BASE_CSS, DATA_STAMP_SCHEMA, DEFAULT_CHANGELOGS, GITHUB_API, GITHUB_GRAPHQL, HELP, KPI_FILE, KPI_FORMAT, KpiError, MAX_DATA_AGE_DAYS, MAX_MINORS_BEHIND, NPM_REGISTRY, OPEN_CLASSES, RELEASES_SCRIPT, ReleaseDataError, RoadmapParseError, STATUS_CLASSES, STATUS_SCRIPT, TYPESCRIPT_PROBE, UsageError, build, buildStatusBoard, checkFreshness, checkStateOf, classCounts, compareVersions, dayRange, escapeHtml, firstSentence, gitTagDates, githubOpenWork, githubReleases, globFiles, headCommit, headingAnchor, headingDate, inlineMarkdown, isShallow, kindOf, kpiFile, kpiProblems, kpiText, laneCenter, latestAt, linksOf, longDate, markdownTables, mergeReleases, minorsBehind, npmPublishTimes, oldestFirst, openGroups, originRepository, pageShell, parseBuildArgs, parseChangelog, parseDataStamps, parseRoadmap, parseVersion, plainText, probeScript, readChangelogs, readKpi, readReleases, readStatusBoard, releaseBodyEntries, releaseSummary, releasesLead, renderDataStamp, renderReleasesPage, renderStatusPage, roadmapItems, runCli, safeUrl, sectionsOf, shortDate, slugOf, splitRow, statusClassOf, statusLead, timelineLayout, utcDay, versionOfTag, writeKpi };
-
-//# sourceMappingURL=index.js.map
+import { A as npmPublishTimes, C as writeKpi, D as isShallow, E as headingDate, M as kindOf, N as parseVersion, O as originRepository, P as versionOfTag, S as readKpi, T as headCommit, _ as KPI_FORMAT, a as checkFreshness, b as kpiProblems, c as parseDataStamps, d as inlineMarkdown, g as KPI_FILE, h as safeUrl, i as MAX_MINORS_BEHIND, j as compareVersions, k as NPM_REGISTRY, n as MAX_DATA_AGE_DAYS, o as latestAt, r as MAX_LIMIT_DAYS_WITHOUT_RULING, s as minorsBehind, t as DATA_STAMP_SCHEMA, u as escapeHtml, v as KpiError, w as gitTagDates, x as kpiText, y as kpiFile } from "./chunks/freshness.js";
+import { $ as parseChangelog, A as STATUS_CLASSES, B as DEFAULT_CHANGELOGS, C as pageShell, D as utcDay, E as shortDate, F as plainText, G as globFiles, H as mergeReleases, I as readStatusBoard, J as checkStateOf, K as GITHUB_API, L as roadmapItems, M as linksOf, N as markdownTables, O as OPEN_CLASSES, P as parseRoadmap, Q as headingAnchor, R as splitRow, S as BASE_CSS, T as longDate, U as readChangelogs, V as ReleaseDataError, W as readReleases, X as githubReleases, Y as githubOpenWork, Z as firstSentence, _ as renderReleasesPage, a as runCli, b as releaseSummary, c as STATUS_SCRIPT, d as renderStatusPage, et as releaseBodyEntries, f as sectionsOf, g as releasesLead, h as RELEASES_SCRIPT, i as parseBuildArgs, j as buildStatusBoard, k as RoadmapParseError, l as classCounts, m as statusLead, n as UsageError, o as TYPESCRIPT_PROBE, p as slugOf, q as GITHUB_GRAPHQL, r as build, s as probeScript, t as HELP, u as openGroups, v as laneCenter, w as dayRange, x as timelineLayout, y as oldestFirst, z as statusClassOf } from "./chunks/build.js";
+import { t as renderDataStamp } from "./chunks/data-stamp.js";
+export { BASE_CSS, DATA_STAMP_SCHEMA, DEFAULT_CHANGELOGS, GITHUB_API, GITHUB_GRAPHQL, HELP, KPI_FILE, KPI_FORMAT, KpiError, MAX_DATA_AGE_DAYS, MAX_LIMIT_DAYS_WITHOUT_RULING, MAX_MINORS_BEHIND, NPM_REGISTRY, OPEN_CLASSES, RELEASES_SCRIPT, ReleaseDataError, RoadmapParseError, STATUS_CLASSES, STATUS_SCRIPT, TYPESCRIPT_PROBE, UsageError, build, buildStatusBoard, checkFreshness, checkStateOf, classCounts, compareVersions, dayRange, escapeHtml, firstSentence, gitTagDates, githubOpenWork, githubReleases, globFiles, headCommit, headingAnchor, headingDate, inlineMarkdown, isShallow, kindOf, kpiFile, kpiProblems, kpiText, laneCenter, latestAt, linksOf, longDate, markdownTables, mergeReleases, minorsBehind, npmPublishTimes, oldestFirst, openGroups, originRepository, pageShell, parseBuildArgs, parseChangelog, parseDataStamps, parseRoadmap, parseVersion, plainText, probeScript, readChangelogs, readKpi, readReleases, readStatusBoard, releaseBodyEntries, releaseSummary, releasesLead, renderDataStamp, renderReleasesPage, renderStatusPage, roadmapItems, runCli, safeUrl, sectionsOf, shortDate, slugOf, splitRow, statusClassOf, statusLead, timelineLayout, utcDay, versionOfTag, writeKpi };

package/build/vite.d.ts

@@ -1,5 +1,5 @@
 import { BuildInfo } from "./chrome.js";
-import { i as KpiInput } from "./chunks/kpi.js";
+import { i as DataStamps, y as KpiInput } from "./chunks/freshness.js";
 /** The environment variables that this module reads. */
 export type SiteEnv = Readonly<Record<string, string | undefined>>;
 /** The options of `siteShell`. */
@@ -67,6 +67,34 @@ export interface SiteKpiPlugin {
  * @param env - The environment variables. A test gives its own.
  */
 export declare function siteKpi(input: SiteKpiInput | (() => SiteKpiInput), env?: SiteEnv): SiteKpiPlugin;
+/** The file that `siteStamps` adds to the root of a built site. The input `data-stamps` of `reusable-pages.yml` names it. */
+export declare const STAMPS_FILE = "data-stamps.json";
+/** The mark in the HTML of a measured page. `siteStamps` replaces it with the stamp line of the page. */
+export declare const STAMP_MARK = "<!-- data-stamp -->";
+/** The part of the context of a page that `siteStamps` uses. */
+export interface SiteStampsPage {
+  /** The path of the page from the root of the site, with a `/` at the start. */
+  readonly path: string;
+}
+/** The Vite plugin that `siteStamps` gives. */
+export interface SiteStampsPlugin {
+  readonly name: string;
+  readonly apply: "build";
+  readonly transformIndexHtml: {
+    readonly order: "pre";
+    handler(html: string, page: SiteStampsPage): string;
+  };
+  generateBundle(this: SiteKpiContext): void;
+}
+/**
+ * This function gives the Vite plugin of the data stamps of a site. The plugin puts the stamp line in each measured page.
+ * It also adds `data-stamps.json` to the root of the site. So the page and the freshness gate read one record.
+ *
+ * A fault stops the build. A fault is a bad stamp, a mark with no stamp or a stamp with no mark. A stamp of a page that the build does not hold is also a fault.
+ *
+ * @param input - The stamps, or a function that reads them at the time of the build.
+ */
+export declare function siteStamps(input: DataStamps | (() => DataStamps)): SiteStampsPlugin;
 /**
  * This function gives the script that sets the saved theme before the first paint, so a dark page
  * does not show white for a moment. The script reads `storageKey`, as `applyTheme` writes it.

package/build/vite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vite.d.ts","names":[],"sources":["../src/vite.ts"],"mappings":";;;YAiBY,UAAU,SAAS;;iBAGd;;WAEN;;;;;WAKA;;;YAIC;;iBAGK;WACN;WACA;WACA;aAAmB,SAAS;;;;iBAItB;WACN;WACA;aAAkB,QAAQ;;WAC1B,QAAQ,SAAS;;;iBAIX;WACN;WACA;WACA;;;iBAIM;WACN;EACT,OAAO,QAAQ,uBAAuB;EACtC,sBAAsB;;;YAIZ,eAAe,KAAK;WAAiC;;;iBAGhD;EACf,SAAS;IAAQ;IAAe;IAAkB;;;;iBAInC;WACN;WACA;EACT,eAAA,MAAqB;;;;;;;;wBASP,QAAQ,OAAO,sBAAsB,eAAe,MAAK,UAAwB;;;;;;;;wBAmBjF,YAAY;;;;;wBASZ,SAAS,MAAK;;wBAMd,UAAU,kBAAkB,MAAK,SAAuB,MAAK,OAAoB;;;;;;;;;;;;wBAoBjF,UAAU,SAAS,mBAAmB"}
+{"version":3,"file":"vite.d.ts","names":[],"sources":["../src/vite.ts"],"mappings":";;;YAmBY,UAAU,SAAS;;iBAGd;;WAEN;;;;;WAKA;;;YAIC;;iBAGK;WACN;WACA;WACA;aAAmB,SAAS;;;;iBAItB;WACN;WACA;aAAkB,QAAQ;;WAC1B,QAAQ,SAAS;;;iBAIX;WACN;WACA;WACA;;;iBAIM;WACN;EACT,OAAO,QAAQ,uBAAuB;EACtC,sBAAsB;;;YAIZ,eAAe,KAAK;WAAiC;;;iBAGhD;EACf,SAAS;IAAQ;IAAe;IAAkB;;;;iBAInC;WACN;WACA;EACT,eAAA,MAAqB;;;;;;;;wBASP,QAAQ,OAAO,sBAAsB,eAAe,MAAK,UAAwB;;qBAapF;;qBAGA;;iBAGI;;WAEN;;;iBAIM;WACN;WACA;WACA;aAA+B;IAAc,QAAQ,cAAc,MAAM;;EAClF,eAAA,MAAqB;;;;;;;;;;wBAWP,WAAW,OAAO,oBAAoB,cAAc;;;;;;;;wBA2CpD,YAAY;;;;;wBASZ,SAAS,MAAK;;wBAMd,UAAU,kBAAkB,MAAK,SAAuB,MAAK,OAAoB;;;;;;;;;;;;wBAoBjF,UAAU,SAAS,mBAAmB"}

package/build/vite.js

@@ -1,4 +1,5 @@
-import { i as kpiFile, o as kpiText, t as KPI_FILE, u as headCommit } from "./chunks/kpi.js";
+import { T as headCommit, c as parseDataStamps, g as KPI_FILE, x as kpiText, y as kpiFile } from "./chunks/freshness.js";
+import { t as renderDataStamp } from "./chunks/data-stamp.js";
 import { readFileSync } from "node:fs";
 import { resolve } from "node:path";
 // src/vite.ts
@@ -33,6 +34,55 @@ function siteKpi(input, env = process.env) {
 		}
 	};
 }
+/** The file that `siteStamps` adds to the root of a built site. The input `data-stamps` of `reusable-pages.yml` names it. */
+const STAMPS_FILE = "data-stamps.json";
+/** The mark in the HTML of a measured page. `siteStamps` replaces it with the stamp line of the page. */
+const STAMP_MARK = "<!-- data-stamp -->";
+/**
+* This function gives the Vite plugin of the data stamps of a site. The plugin puts the stamp line in each measured page.
+* It also adds `data-stamps.json` to the root of the site. So the page and the freshness gate read one record.
+*
+* A fault stops the build. A fault is a bad stamp, a mark with no stamp or a stamp with no mark. A stamp of a page that the build does not hold is also a fault.
+*
+* @param input - The stamps, or a function that reads them at the time of the build.
+*/
+function siteStamps(input) {
+	let stamps;
+	const read = () => {
+		if (stamps !== void 0) return stamps;
+		const parsed = parseDataStamps(typeof input === "function" ? input() : input);
+		if (!parsed.ok) throw new Error(`The data stamps are not good:\n- ${parsed.faults.join("\n- ")}`);
+		stamps = parsed.stamps;
+		return stamps;
+	};
+	const seen = /* @__PURE__ */ new Set();
+	return {
+		name: "site-pages-stamps",
+		apply: "build",
+		transformIndexHtml: {
+			order: "pre",
+			handler(html, { path }) {
+				const name = path.replace(/^\//, "");
+				const stamp = read().pages.find((page) => page.page === name);
+				const marked = html.includes(STAMP_MARK);
+				if (stamp === void 0 && marked) throw new Error(`The page ${name} has the mark of a data stamp, and the stamps have no page ${name}.`);
+				if (stamp === void 0) return html;
+				if (!marked) throw new Error(`The stamps have the page ${name}, and the page has no mark ${STAMP_MARK}.`);
+				seen.add(name);
+				return html.replace(STAMP_MARK, renderDataStamp(stamp));
+			}
+		},
+		generateBundle() {
+			const missing = read().pages.map((page) => page.page).filter((page) => !seen.has(page));
+			if (missing.length > 0) throw new Error(`The stamps have pages that the build does not hold: ${missing.join(", ")}.`);
+			this.emitFile({
+				type: "asset",
+				fileName: STAMPS_FILE,
+				source: `${JSON.stringify(read(), null, 2)}\n`
+			});
+		}
+	};
+}
 /**
 * This function gives the script that sets the saved theme before the first paint, so a dark page
 * does not show white for a moment. The script reads `storageKey`, as `applyTheme` writes it.
@@ -95,6 +145,6 @@ function siteShell(options) {
 		}
 	};
 }
-export { buildInfo, siteBase, siteKpi, siteShell, themeScript };
+export { STAMPS_FILE, STAMP_MARK, buildInfo, siteBase, siteKpi, siteShell, siteStamps, themeScript };
 
 //# sourceMappingURL=vite.js.map

package/build/vite.js.map

@@ -1 +1 @@
-{"version":3,"file":"vite.js","names":[],"sources":["../src/vite.ts"],"sourcesContent":["/**\n * The build side of the shell of a site: a Vite plugin and its parts. Import this module from\n * `@mark1russell7/site-pages/vite`. It is for `vite.config.ts`, not for a browser.\n *\n * This module does not import Vite. The types of the plugin are the small part that it uses, so the\n * package keeps no dependency. A test examines that Vite accepts the plugin.\n */\n\nimport { readFileSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\nimport type { BuildInfo } from \"./chrome.ts\";\nimport { headCommit } from \"./data/git.ts\";\nimport { KPI_FILE, kpiFile, kpiText, type KpiInput } from \"./data/kpi.ts\";\n\nexport type { BuildInfo } from \"./chrome.ts\";\n\n/** The environment variables that this module reads. */\nexport type SiteEnv = Readonly<Record<string, string | undefined>>;\n\n/** The options of `siteShell`. */\nexport interface SiteShellOptions {\n  /** The `localStorage` key of the theme. Give the same key to `setupTheme` in the page. */\n  readonly themeKey: string;\n  /**\n   * The file with the version for `__BUILD__`, relative to the folder of the site. The default is\n   * `../package.json`. The value `false` gives a build with no version.\n   */\n  readonly packageFile?: string | false | undefined;\n}\n\n/** The value of `build.target` in a Vite config. */\nexport type SiteTarget = string | string[] | false;\n\n/** The part of the Vite config that `siteShell` reads. */\nexport interface SiteShellConfigInput {\n  readonly root?: string | undefined;\n  readonly base?: string | undefined;\n  readonly build?: { readonly target?: SiteTarget | undefined } | null | undefined;\n}\n\n/** The part of the Vite config that `siteShell` sets. Vite merges it into the config of the site. */\nexport interface SiteShellConfig {\n  readonly base: string;\n  readonly build: { readonly target: SiteTarget };\n  readonly define: Readonly<Record<string, string>>;\n}\n\n/** A tag for the `head` of each HTML page. */\nexport interface SiteShellTag {\n  readonly tag: \"script\";\n  readonly children: string;\n  readonly injectTo: \"head\";\n}\n\n/** The Vite plugin that `siteShell` gives. */\nexport interface SiteShellPlugin {\n  readonly name: string;\n  config(config: SiteShellConfigInput): SiteShellConfig;\n  transformIndexHtml(): SiteShellTag[];\n}\n\n/** The input of `siteKpi`. Without a commit, the plugin takes `GITHUB_SHA`, else the head of the repository. */\nexport type SiteKpiInput = Omit<KpiInput, \"commit\"> & { readonly commit?: string | undefined };\n\n/** The part of the context of a Rollup hook that `siteKpi` uses. */\nexport interface SiteKpiContext {\n  emitFile(file: { type: \"asset\"; fileName: string; source: string }): string;\n}\n\n/** The Vite plugin that `siteKpi` gives. */\nexport interface SiteKpiPlugin {\n  readonly name: string;\n  readonly apply: \"build\";\n  generateBundle(this: SiteKpiContext): void;\n}\n\n/**\n * This function gives the Vite plugin that adds `kpi.json` to the root of a built site. A fault in the data stops the build.\n *\n * @param input - The data, or a function that reads it at the time of the build.\n * @param env - The environment variables. A test gives its own.\n */\nexport function siteKpi(input: SiteKpiInput | (() => SiteKpiInput), env: SiteEnv = process.env): SiteKpiPlugin {\n  return {\n    name: \"site-pages-kpi\",\n    apply: \"build\",\n    generateBundle() {\n      const data = typeof input === \"function\" ? input() : input;\n      const commit = data.commit ?? env[\"GITHUB_SHA\"] ?? headCommit(process.cwd()) ?? \"\";\n      this.emitFile({ type: \"asset\", fileName: KPI_FILE, source: kpiText(kpiFile({ ...data, commit })) });\n    },\n  };\n}\n\n/**\n * This function gives the script that sets the saved theme before the first paint, so a dark page\n * does not show white for a moment. The script reads `storageKey`, as `applyTheme` writes it.\n *\n * @remarks The text goes in an inline `script` element. Thus the function escapes each `<` of the\n * key, so a key cannot close the element.\n */\nexport function themeScript(storageKey: string): string {\n  const key = JSON.stringify(storageKey).replaceAll(\"<\", \"\\\\u003c\");\n  return `try{const t=localStorage.getItem(${key});if(t===\"light\"||t===\"dark\")document.documentElement.dataset.theme=t}catch{}`;\n}\n\n/**\n * This function gives the `base` of Vite from `SITE_BASE`, with one `/` at the end. The Pages\n * workflow sets that variable to `/<name>`. A local build has no such variable, and gets `/`.\n */\nexport function siteBase(env: SiteEnv = process.env): string {\n  const base = env[\"SITE_BASE\"];\n  return base ? `${base.replace(/\\/$/, \"\")}/` : \"/\";\n}\n\n/** This function gives the data of a build. Outside CI, `GITHUB_SHA` is not set, and `sha` is `local`. */\nexport function buildInfo(version?: string, env: SiteEnv = process.env, now: Date = new Date()): BuildInfo {\n  return { sha: (env[\"GITHUB_SHA\"] ?? \"local\").slice(0, 7), date: now.toISOString().slice(0, 10), version };\n}\n\n/** This function reads the field `version` of a `package.json` file. */\nfunction versionIn(file: string): string | undefined {\n  return (JSON.parse(readFileSync(file, \"utf8\")) as { version?: string }).version;\n}\n\n/**\n * This function makes the Vite plugin of a site. The plugin does these four operations:\n *\n * - It sets `base` from `SITE_BASE`.\n * - It sets `build.target` to `es2022`.\n * - It defines `__BUILD__`, the value that `showBuild` shows.\n * - It adds `themeScript` to the `head` of each HTML page.\n *\n * A `base` or a `build.target` in the config of the site has priority. The other values of `build`\n * and `define` in that config stay, because Vite merges them.\n */\nexport function siteShell(options: SiteShellOptions): SiteShellPlugin {\n  return {\n    name: \"site-pages-shell\",\n    config(config) {\n      const packageFile = options.packageFile ?? \"../package.json\";\n      const version = packageFile === false ? undefined : versionIn(resolve(config.root ?? \".\", packageFile));\n      return {\n        base: config.base ?? siteBase(),\n        build: { target: config.build?.target ?? \"es2022\" },\n        define: { __BUILD__: JSON.stringify(buildInfo(version)) },\n      };\n    },\n    transformIndexHtml() {\n      return [{ tag: \"script\", children: themeScript(options.themeKey), injectTo: \"head\" }];\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAkFA,SAAgB,QAAQ,OAA4C,MAAe,QAAQ,KAAoB;CAC7G,OAAO;EACL,MAAM;EACN,OAAO;EACP,iBAAiB;GACf,MAAM,OAAO,OAAO,UAAU,aAAa,MAAM,IAAI;GACrD,MAAM,SAAS,KAAK,UAAU,IAAI,iBAAiB,WAAW,QAAQ,IAAI,CAAC,KAAK;GAChF,KAAK,SAAS;IAAE,MAAM;IAAS,UAAU;IAAU,QAAQ,QAAQ,QAAQ;KAAE,GAAG;KAAM;IAAO,CAAC,CAAC;GAAE,CAAC;EACpG;CACF;AACF;;;;;;;;AASA,SAAgB,YAAY,YAA4B;CAEtD,OAAO,oCADK,KAAK,UAAU,UAAU,CAAC,CAAC,WAAW,KAAK,SACV,EAAE;AACjD;;;;;AAMA,SAAgB,SAAS,MAAe,QAAQ,KAAa;CAC3D,MAAM,OAAO,IAAI;CACjB,OAAO,OAAO,GAAG,KAAK,QAAQ,OAAO,EAAE,EAAE,KAAK;AAChD;;AAGA,SAAgB,UAAU,SAAkB,MAAe,QAAQ,KAAK,sBAAY,IAAI,KAAK,GAAc;CACzG,OAAO;EAAE,MAAM,IAAI,iBAAiB,QAAA,CAAS,MAAM,GAAG,CAAC;EAAG,MAAM,IAAI,YAAY,CAAC,CAAC,MAAM,GAAG,EAAE;EAAG;CAAQ;AAC1G;;AAGA,SAAS,UAAU,MAAkC;CACnD,OAAQ,KAAK,MAAM,aAAa,MAAM,MAAM,CAAC,CAAC,CAA0B;AAC1E;;;;;;;;;;;;AAaA,SAAgB,UAAU,SAA4C;CACpE,OAAO;EACL,MAAM;EACN,OAAO,QAAQ;GACb,MAAM,cAAc,QAAQ,eAAe;GAC3C,MAAM,UAAU,gBAAgB,QAAQ,KAAA,IAAY,UAAU,QAAQ,OAAO,QAAQ,KAAK,WAAW,CAAC;GACtG,OAAO;IACL,MAAM,OAAO,QAAQ,SAAS;IAC9B,OAAO,EAAE,QAAQ,OAAO,OAAO,UAAU,SAAS;IAClD,QAAQ,EAAE,WAAW,KAAK,UAAU,UAAU,OAAO,CAAC,EAAE;GAC1D;EACF;EACA,qBAAqB;GACnB,OAAO,CAAC;IAAE,KAAK;IAAU,UAAU,YAAY,QAAQ,QAAQ;IAAG,UAAU;GAAO,CAAC;EACtF;CACF;AACF"}
+{"version":3,"file":"vite.js","names":[],"sources":["../src/vite.ts"],"sourcesContent":["/**\n * The build side of the shell of a site: a Vite plugin and its parts. Import this module from\n * `@mark1russell7/site-pages/vite`. It is for `vite.config.ts`, not for a browser.\n *\n * This module does not import Vite. The types of the plugin are the small part that it uses, so the\n * package keeps no dependency. A test examines that Vite accepts the plugin.\n */\n\nimport { readFileSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\nimport type { BuildInfo } from \"./chrome.ts\";\nimport { parseDataStamps, type DataStamps } from \"./check/freshness.ts\";\nimport { headCommit } from \"./data/git.ts\";\nimport { KPI_FILE, kpiFile, kpiText, type KpiInput } from \"./data/kpi.ts\";\nimport { renderDataStamp } from \"./render/data-stamp.ts\";\n\nexport type { BuildInfo } from \"./chrome.ts\";\n\n/** The environment variables that this module reads. */\nexport type SiteEnv = Readonly<Record<string, string | undefined>>;\n\n/** The options of `siteShell`. */\nexport interface SiteShellOptions {\n  /** The `localStorage` key of the theme. Give the same key to `setupTheme` in the page. */\n  readonly themeKey: string;\n  /**\n   * The file with the version for `__BUILD__`, relative to the folder of the site. The default is\n   * `../package.json`. The value `false` gives a build with no version.\n   */\n  readonly packageFile?: string | false | undefined;\n}\n\n/** The value of `build.target` in a Vite config. */\nexport type SiteTarget = string | string[] | false;\n\n/** The part of the Vite config that `siteShell` reads. */\nexport interface SiteShellConfigInput {\n  readonly root?: string | undefined;\n  readonly base?: string | undefined;\n  readonly build?: { readonly target?: SiteTarget | undefined } | null | undefined;\n}\n\n/** The part of the Vite config that `siteShell` sets. Vite merges it into the config of the site. */\nexport interface SiteShellConfig {\n  readonly base: string;\n  readonly build: { readonly target: SiteTarget };\n  readonly define: Readonly<Record<string, string>>;\n}\n\n/** A tag for the `head` of each HTML page. */\nexport interface SiteShellTag {\n  readonly tag: \"script\";\n  readonly children: string;\n  readonly injectTo: \"head\";\n}\n\n/** The Vite plugin that `siteShell` gives. */\nexport interface SiteShellPlugin {\n  readonly name: string;\n  config(config: SiteShellConfigInput): SiteShellConfig;\n  transformIndexHtml(): SiteShellTag[];\n}\n\n/** The input of `siteKpi`. Without a commit, the plugin takes `GITHUB_SHA`, else the head of the repository. */\nexport type SiteKpiInput = Omit<KpiInput, \"commit\"> & { readonly commit?: string | undefined };\n\n/** The part of the context of a Rollup hook that `siteKpi` uses. */\nexport interface SiteKpiContext {\n  emitFile(file: { type: \"asset\"; fileName: string; source: string }): string;\n}\n\n/** The Vite plugin that `siteKpi` gives. */\nexport interface SiteKpiPlugin {\n  readonly name: string;\n  readonly apply: \"build\";\n  generateBundle(this: SiteKpiContext): void;\n}\n\n/**\n * This function gives the Vite plugin that adds `kpi.json` to the root of a built site. A fault in the data stops the build.\n *\n * @param input - The data, or a function that reads it at the time of the build.\n * @param env - The environment variables. A test gives its own.\n */\nexport function siteKpi(input: SiteKpiInput | (() => SiteKpiInput), env: SiteEnv = process.env): SiteKpiPlugin {\n  return {\n    name: \"site-pages-kpi\",\n    apply: \"build\",\n    generateBundle() {\n      const data = typeof input === \"function\" ? input() : input;\n      const commit = data.commit ?? env[\"GITHUB_SHA\"] ?? headCommit(process.cwd()) ?? \"\";\n      this.emitFile({ type: \"asset\", fileName: KPI_FILE, source: kpiText(kpiFile({ ...data, commit })) });\n    },\n  };\n}\n\n/** The file that `siteStamps` adds to the root of a built site. The input `data-stamps` of `reusable-pages.yml` names it. */\nexport const STAMPS_FILE = \"data-stamps.json\";\n\n/** The mark in the HTML of a measured page. `siteStamps` replaces it with the stamp line of the page. */\nexport const STAMP_MARK = \"<!-- data-stamp -->\";\n\n/** The part of the context of a page that `siteStamps` uses. */\nexport interface SiteStampsPage {\n  /** The path of the page from the root of the site, with a `/` at the start. */\n  readonly path: string;\n}\n\n/** The Vite plugin that `siteStamps` gives. */\nexport interface SiteStampsPlugin {\n  readonly name: string;\n  readonly apply: \"build\";\n  readonly transformIndexHtml: { readonly order: \"pre\"; handler(html: string, page: SiteStampsPage): string };\n  generateBundle(this: SiteKpiContext): void;\n}\n\n/**\n * This function gives the Vite plugin of the data stamps of a site. The plugin puts the stamp line in each measured page.\n * It also adds `data-stamps.json` to the root of the site. So the page and the freshness gate read one record.\n *\n * A fault stops the build. A fault is a bad stamp, a mark with no stamp or a stamp with no mark. A stamp of a page that the build does not hold is also a fault.\n *\n * @param input - The stamps, or a function that reads them at the time of the build.\n */\nexport function siteStamps(input: DataStamps | (() => DataStamps)): SiteStampsPlugin {\n  let stamps: DataStamps | undefined;\n  const read = (): DataStamps => {\n    if (stamps !== undefined) return stamps;\n    const parsed = parseDataStamps(typeof input === \"function\" ? input() : input);\n    if (!parsed.ok) throw new Error(`The data stamps are not good:\\n- ${parsed.faults.join(\"\\n- \")}`);\n    stamps = parsed.stamps;\n    return stamps;\n  };\n  const seen = new Set<string>();\n  return {\n    name: \"site-pages-stamps\",\n    apply: \"build\",\n    transformIndexHtml: {\n      order: \"pre\",\n      handler(html, { path }) {\n        const name = path.replace(/^\\//, \"\");\n        const stamp = read().pages.find((page) => page.page === name);\n        const marked = html.includes(STAMP_MARK);\n        if (stamp === undefined && marked) throw new Error(`The page ${name} has the mark of a data stamp, and the stamps have no page ${name}.`);\n        if (stamp === undefined) return html;\n        if (!marked) throw new Error(`The stamps have the page ${name}, and the page has no mark ${STAMP_MARK}.`);\n        seen.add(name);\n        return html.replace(STAMP_MARK, renderDataStamp(stamp));\n      },\n    },\n    generateBundle() {\n      const missing = read()\n        .pages.map((page) => page.page)\n        .filter((page) => !seen.has(page));\n      if (missing.length > 0) throw new Error(`The stamps have pages that the build does not hold: ${missing.join(\", \")}.`);\n      this.emitFile({ type: \"asset\", fileName: STAMPS_FILE, source: `${JSON.stringify(read(), null, 2)}\\n` });\n    },\n  };\n}\n\n/**\n * This function gives the script that sets the saved theme before the first paint, so a dark page\n * does not show white for a moment. The script reads `storageKey`, as `applyTheme` writes it.\n *\n * @remarks The text goes in an inline `script` element. Thus the function escapes each `<` of the\n * key, so a key cannot close the element.\n */\nexport function themeScript(storageKey: string): string {\n  const key = JSON.stringify(storageKey).replaceAll(\"<\", \"\\\\u003c\");\n  return `try{const t=localStorage.getItem(${key});if(t===\"light\"||t===\"dark\")document.documentElement.dataset.theme=t}catch{}`;\n}\n\n/**\n * This function gives the `base` of Vite from `SITE_BASE`, with one `/` at the end. The Pages\n * workflow sets that variable to `/<name>`. A local build has no such variable, and gets `/`.\n */\nexport function siteBase(env: SiteEnv = process.env): string {\n  const base = env[\"SITE_BASE\"];\n  return base ? `${base.replace(/\\/$/, \"\")}/` : \"/\";\n}\n\n/** This function gives the data of a build. Outside CI, `GITHUB_SHA` is not set, and `sha` is `local`. */\nexport function buildInfo(version?: string, env: SiteEnv = process.env, now: Date = new Date()): BuildInfo {\n  return { sha: (env[\"GITHUB_SHA\"] ?? \"local\").slice(0, 7), date: now.toISOString().slice(0, 10), version };\n}\n\n/** This function reads the field `version` of a `package.json` file. */\nfunction versionIn(file: string): string | undefined {\n  return (JSON.parse(readFileSync(file, \"utf8\")) as { version?: string }).version;\n}\n\n/**\n * This function makes the Vite plugin of a site. The plugin does these four operations:\n *\n * - It sets `base` from `SITE_BASE`.\n * - It sets `build.target` to `es2022`.\n * - It defines `__BUILD__`, the value that `showBuild` shows.\n * - It adds `themeScript` to the `head` of each HTML page.\n *\n * A `base` or a `build.target` in the config of the site has priority. The other values of `build`\n * and `define` in that config stay, because Vite merges them.\n */\nexport function siteShell(options: SiteShellOptions): SiteShellPlugin {\n  return {\n    name: \"site-pages-shell\",\n    config(config) {\n      const packageFile = options.packageFile ?? \"../package.json\";\n      const version = packageFile === false ? undefined : versionIn(resolve(config.root ?? \".\", packageFile));\n      return {\n        base: config.base ?? siteBase(),\n        build: { target: config.build?.target ?? \"es2022\" },\n        define: { __BUILD__: JSON.stringify(buildInfo(version)) },\n      };\n    },\n    transformIndexHtml() {\n      return [{ tag: \"script\", children: themeScript(options.themeKey), injectTo: \"head\" }];\n    },\n  };\n}\n"],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package",
   "name": "@mark1russell7/site-pages",
-  "version": "0.2.8",
+  "version": "0.2.10",
   "description": "A release timeline page and a live status page for the site of a GitHub repository: JSON data and standalone HTML, made at deploy time.",
   "keywords": [
     "github-pages",

package/styles/scroll-cue.css

@@ -1,7 +1,9 @@
 /*
  * @mark1russell7/site-pages/scroll-cue.css: a cue on a box that scrolls sideways.
- * A shade shows at each edge that has more content. When the box is at an end, the shade of that end goes.
- * The cue uses only CSS: two covers scroll with the content, and two shades stay at the edges.
+ * The content fades at each edge that has more content. When the box is at an end, the fade of that end goes.
+ * The cue uses only CSS. The fade shows along all of the edge, also over cells with their own background color.
+ * A browser with no scroll timelines gets two covers that scroll with the content and two shades that stay at the edges.
+ * In such a browser, the shade shows only where the content has no background color.
  *
  * Use: give the class scroll-cue to the box, and set --scroll-cue-bg to the background color of the box.
  *   <pre class="scroll-cue">...</pre>
@@ -18,8 +20,8 @@
   background-image:
     linear-gradient(to right, var(--scroll-cue-bg) 40%, transparent),
     linear-gradient(to left, var(--scroll-cue-bg) 40%, transparent),
-    radial-gradient(farthest-side at 0 50%, var(--scroll-cue-shade), transparent),
-    radial-gradient(farthest-side at 100% 50%, var(--scroll-cue-shade), transparent);
+    linear-gradient(to right, var(--scroll-cue-shade), transparent),
+    linear-gradient(to left, var(--scroll-cue-shade), transparent);
   background-position: left center, right center, left center, right center;
   background-size:
     calc(var(--scroll-cue-size) * 2) 100%,
@@ -29,3 +31,43 @@
   background-repeat: no-repeat;
   background-attachment: local, local, scroll, scroll;
 }
+
+@property --scroll-cue-fade-left {
+  syntax: "<length>";
+  inherits: false;
+  initial-value: 0px;
+}
+
+@property --scroll-cue-fade-right {
+  syntax: "<length>";
+  inherits: false;
+  initial-value: 0px;
+}
+
+@keyframes scroll-cue-fades {
+  0% {
+    --scroll-cue-fade-left: 0px;
+    --scroll-cue-fade-right: calc(var(--scroll-cue-size) * 2);
+  }
+  4% {
+    --scroll-cue-fade-left: calc(var(--scroll-cue-size) * 2);
+  }
+  96% {
+    --scroll-cue-fade-right: calc(var(--scroll-cue-size) * 2);
+  }
+  100% {
+    --scroll-cue-fade-left: calc(var(--scroll-cue-size) * 2);
+    --scroll-cue-fade-right: 0px;
+  }
+}
+
+/* A box with no overflow has no active timeline, so its fades stay at 0 and the mask hides nothing. */
+@supports (animation-timeline: scroll()) {
+  .scroll-cue {
+    background-image: none;
+    -webkit-mask-image: linear-gradient(to right, transparent, #000 var(--scroll-cue-fade-left), #000 calc(100% - var(--scroll-cue-fade-right)), transparent);
+    mask-image: linear-gradient(to right, transparent, #000 var(--scroll-cue-fade-left), #000 calc(100% - var(--scroll-cue-fade-right)), transparent);
+    animation: scroll-cue-fades linear both;
+    animation-timeline: scroll(self inline);
+  }
+}

package/build/chunks/kpi.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"kpi.d.ts","names":[],"sources":["../../src/data/types.ts","../../src/data/kpi.ts"],"mappings":";;;;;UAMiB;EACf;EACA;;;;;;KAWU;;UAGK;;EAEf;;EAEA;;EAEA;;;UAIe;EACf;;EAEA;EACA,MAAM;;EAEN,SAAS;;EAET,OAAO;;;UAIQ;EACf;EACA;;EAEA;;EAEA;EACA;EACA;;;KAIU;EAAmB;EAAiB,UAAU;;EAAsB;EAAkB;;;UAGjF;EACf;EACA;EACA;;;UAIe;EACf,OAAO;EACP;;;KAQU;;UAGK;EACf;EACA;;EAEA;EACA,aAAa;EACb;EACA;;EAEA;;EAEA;;EAEA;EACA,OAAO;;;KAIG;;UAGK;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,QAAQ;;;UAIO;EACf;EACA;EACA;EACA;EACA;EACA;EACA;;;UAIe;EACf;EACA;;;KAIU;EACN;EAAiB,cAAc;EAAoB,QAAQ;EAAc,QAAQ;;EACjF;EAAkB;;;UAGP;;EAEf;EACA;EACA;;EAEA;;;UAIe;;EAEf;EACA;;;UAIe;EACf;;EAEA;;EAEA;;EAEA;EACA,UAAU;;EAEV,UAAU;;;UAIK;;EAEf;;EAEA;;EAEA;IAAU;IAAwB;;EAClC,OAAO;EACP,cAAc;EACd,QAAQ;;EAER;IAAU;IAAoB;IAAiB,SAAS;;;EAExD,MAAM;;;cCvKK;;cAGA;;KAGD,WAAW,KAAK;;cAef,iBAAiB;WACnB;EAET,YAAY;;;;;;;;iBA4CE,YAAY,gBAAgB;;;;;;iBAgC5B,QAAQ,OAAO,UAAU,eAAe;;iBASxC,QAAQ,MAAM;;;;;;iBASd,QAAQ,cAAc,eAAe;;;;;;iBAkBrC,SAAS,aAAa,OAAO,UAAU"}

package/build/chunks/kpi.js

@@ -1,226 +0,0 @@
-import { execFileSync } from "node:child_process";
-import { mkdirSync, writeFileSync } from "node:fs";
-import { join } from "node:path";
-// src/data/git.ts
-/**
-* The git source: the tags with their dates, the commit of the build and the GitHub remote. Each
-* function gives an empty result when git or the repository is not available.
-*/
-/** This function starts git in a folder and gives its output, or null when git fails. */
-function git(repoDir, ...args) {
-	try {
-		return execFileSync("git", args, {
-			cwd: repoDir,
-			encoding: "utf8",
-			stdio: [
-				"ignore",
-				"pipe",
-				"ignore"
-			],
-			windowsHide: true
-		});
-	} catch {
-		return null;
-	}
-}
-/** This function tells if the clone is shallow. A shallow clone has not all the tags and commits. */
-function isShallow(repoDir) {
-	return git(repoDir, "rev-parse", "--is-shallow-repository")?.trim() === "true";
-}
-/** This function gives each tag of the repository with its date. An annotated tag has its own date. */
-function gitTagDates(repoDir) {
-	const output = git(repoDir, "for-each-ref", "--format=%(refname:strip=2) %(creatordate:iso-strict)", "refs/tags");
-	if (!output) return [];
-	const tags = [];
-	for (const line of output.split(/\r?\n/)) {
-		const match = /^(\S+) (\S+)$/.exec(line.trim());
-		if (match?.[1] && match[2]) tags.push({
-			tag: match[1],
-			date: match[2]
-		});
-	}
-	return tags;
-}
-/**
-* This function gives the date of the oldest commit that added a version heading to a changelog,
-* or null. The path of the changelog starts at `repoDir`.
-*/
-function headingDate(repoDir, version, file) {
-	const dates = (git(repoDir, "log", "--format=%cI", `-S## ${version}`, "--", file) ?? "").trim().split(/\r?\n/).filter(Boolean);
-	return dates[dates.length - 1] ?? null;
-}
-/** This function gives the full SHA of `HEAD`, or null. */
-function headCommit(repoDir) {
-	const sha = git(repoDir, "rev-parse", "HEAD")?.trim();
-	return sha && /^[0-9a-f]{40}$/.test(sha) ? sha : null;
-}
-/** This function gives "owner/name" of the GitHub remote "origin", or null. */
-function originRepository(repoDir) {
-	const url = git(repoDir, "remote", "get-url", "origin")?.trim() ?? "";
-	const match = /github\.com[:/]([^/]+)\/(.+?)(?:\.git)?\/?$/.exec(url);
-	return match ? `${match[1]}/${match[2]}` : null;
-}
-// src/data/kpi.ts
-/**
-* The file `kpi.json` at the root of a site, format `kpi/1`. A reader outside the site takes the measures of the project
-* from this file. Thus a number on a progress page comes from a record and not from a person.
-*
-* The field `at` is the time of the data and not the time of the build. Thus the writer has no default for it.
-* A measure can have its own `at` when its data is from another time than the rest of the file.
-*/
-/** The name of the format. A new format gets a new name, so that an old reader refuses it. */
-const KPI_FORMAT = "kpi/1";
-/** The name of the file at the root of the built site. */
-const KPI_FILE = "kpi.json";
-/** The form of a project and a measure. A double hyphen separates fields in the file name of a reading. */
-const SLUG = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
-/** The form of a time in UTC, with or without seconds. */
-const UTC_TIME = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(?::\d{2}(?:\.\d+)?)?Z$/;
-/** The form of a full commit. */
-const COMMIT = /^[0-9a-f]{40}$/;
-/** The clock difference between two computers that the check accepts, in milliseconds. */
-const CLOCK_MARGIN = 3e5;
-/** An error in the data of `kpi.json`. The field `problems` has one line for each fault. */
-var KpiError = class extends Error {
-	problems;
-	constructor(problems) {
-		super(`${KPI_FILE} is not correct: ${problems.join(" ")}`);
-		this.name = "KpiError";
-		this.problems = problems;
-	}
-};
-const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
-const isText = (value) => typeof value === "string" && value.trim() !== "";
-/** This function gives the fault of a time of the data, or an empty list. The name tells which field it is. */
-function timeProblems(at, name, now) {
-	if (typeof at !== "string" || !UTC_TIME.test(at) || Number.isNaN(Date.parse(at))) return [`${name} is not a time in UTC.`];
-	return Date.parse(at) > now + CLOCK_MARGIN ? [`The time of the data ${at} is after the time of the check.`] : [];
-}
-/** This function gives the faults of one measure. */
-function measureProblems(value, index, seen, now) {
-	if (!isRecord(value)) return [`Measure ${index} is not an object.`];
-	const { id, value: amount, unit, at } = value;
-	const problems = [];
-	if (typeof id !== "string" || !SLUG.test(id)) problems.push(`Measure ${index} has no id of lowercase words with single hyphens.`);
-	else if (seen.has(id)) problems.push(`The id ${id} occurs two times.`);
-	else seen.add(id);
-	if (typeof amount !== "number" || !Number.isFinite(amount)) problems.push(`Measure ${index} has no finite number as its value.`);
-	if (unit !== void 0 && !isText(unit)) problems.push(`Measure ${index} has a unit that is not a text.`);
-	if (at !== void 0) problems.push(...timeProblems(at, `The field at of measure ${index}`, now));
-	return problems;
-}
-/** This function gives the faults of the list of engines. */
-function engineProblems(value) {
-	if (value === void 0) return [];
-	if (!Array.isArray(value)) return ["The field engines is not a list."];
-	return value.flatMap((engine, index) => isRecord(engine) && isText(engine["name"]) && isText(engine["version"]) ? [] : [`Engine ${index} has no name and version.`]);
-}
-/**
-* This function gives the faults of a parsed `kpi.json`, or an empty list.
-*
-* @param value - The parsed file.
-* @param now - The time of the check, in milliseconds. A time of the data after this time is a fault.
-*/
-function kpiProblems(value, now = Date.now()) {
-	if (!isRecord(value)) return ["The file is not an object."];
-	const problems = [];
-	if (value["format"] !== "kpi/1") problems.push(`The format is not ${KPI_FORMAT}.`);
-	const { project, at, commit, measures } = value;
-	if (typeof project !== "string" || !SLUG.test(project)) problems.push("The project is not lowercase words with single hyphens.");
-	problems.push(...timeProblems(at, "The field at", now));
-	if (typeof commit !== "string" || !COMMIT.test(commit)) problems.push("The commit is not a full commit.");
-	if (!Array.isArray(measures) || measures.length === 0) problems.push("The file has no measures.");
-	else {
-		const seen = /* @__PURE__ */ new Set();
-		problems.push(...measures.flatMap((measure, index) => measureProblems(measure, index, seen, now)));
-	}
-	problems.push(...engineProblems(value["engines"]));
-	return problems;
-}
-/** This function gives a copy of a measure with only its known fields. */
-function cleanMeasure({ id, value, unit, at }) {
-	return {
-		id,
-		value,
-		...unit === void 0 ? {} : { unit },
-		...at === void 0 ? {} : { at }
-	};
-}
-/** This function gives a copy of an engine with only its known fields. */
-function cleanEngine({ name, version }) {
-	return {
-		name,
-		version
-	};
-}
-/**
-* This function gives the checked content of `kpi.json`. The file has only its known fields, in a fixed order.
-*
-* @throws KpiError when the data is not correct
-*/
-function kpiFile(input, now) {
-	const problems = kpiProblems({
-		format: KPI_FORMAT,
-		...input
-	}, now);
-	if (problems.length > 0) throw new KpiError(problems);
-	const { project, at, commit, measures, engines } = input;
-	const file = {
-		format: KPI_FORMAT,
-		project,
-		at,
-		commit,
-		measures: measures.map(cleanMeasure)
-	};
-	return engines === void 0 ? file : {
-		...file,
-		engines: engines.map(cleanEngine)
-	};
-}
-/** This function gives the text of `kpi.json`. */
-function kpiText(file) {
-	return `${JSON.stringify(file, null, 2)}\n`;
-}
-/**
-* This function reads the text of a `kpi.json`.
-*
-* @throws KpiError when the text is not correct
-*/
-function readKpi(text, now) {
-	let value;
-	try {
-		value = JSON.parse(text);
-	} catch (error) {
-		throw new KpiError([`The file is not JSON: ${error instanceof Error ? error.message : String(error)}`]);
-	}
-	const problems = kpiProblems(value, now);
-	if (problems.length > 0) throw new KpiError(problems);
-	const { project, at, commit, measures, engines } = value;
-	return kpiFile(engines === void 0 ? {
-		project,
-		at,
-		commit,
-		measures
-	} : {
-		project,
-		at,
-		commit,
-		measures,
-		engines
-	}, now);
-}
-/**
-* This function writes `kpi.json` into the built output folder of a site, and gives the path of the file.
-*
-* @throws KpiError when the data is not correct
-*/
-function writeKpi(out, input, now) {
-	const text = kpiText(kpiFile(input, now));
-	mkdirSync(out, { recursive: true });
-	const file = join(out, KPI_FILE);
-	writeFileSync(file, text);
-	return file;
-}
-export { kpiProblems as a, writeKpi as c, headingDate as d, isShallow as f, kpiFile as i, gitTagDates as l, KPI_FORMAT as n, kpiText as o, originRepository as p, KpiError as r, readKpi as s, KPI_FILE as t, headCommit as u };
-
-//# sourceMappingURL=kpi.js.map

package/build/chunks/kpi.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"kpi.js","names":[],"sources":["../../src/data/git.ts","../../src/data/kpi.ts"],"sourcesContent":["/**\n * The git source: the tags with their dates, the commit of the build and the GitHub remote. Each\n * function gives an empty result when git or the repository is not available.\n */\n\nimport { execFileSync } from \"node:child_process\";\n\n/** A git tag and the ISO date of its creation. */\nexport interface TagDate {\n  tag: string;\n  date: string;\n}\n\n/** This function starts git in a folder and gives its output, or null when git fails. */\nexport function git(repoDir: string, ...args: string[]): string | null {\n  try {\n    return execFileSync(\"git\", args, { cwd: repoDir, encoding: \"utf8\", stdio: [\"ignore\", \"pipe\", \"ignore\"], windowsHide: true });\n  } catch {\n    return null;\n  }\n}\n\n/** This function tells if the clone is shallow. A shallow clone has not all the tags and commits. */\nexport function isShallow(repoDir: string): boolean {\n  return git(repoDir, \"rev-parse\", \"--is-shallow-repository\")?.trim() === \"true\";\n}\n\n/** This function gives each tag of the repository with its date. An annotated tag has its own date. */\nexport function gitTagDates(repoDir: string): TagDate[] {\n  const output = git(repoDir, \"for-each-ref\", \"--format=%(refname:strip=2) %(creatordate:iso-strict)\", \"refs/tags\");\n  if (!output) return [];\n  const tags: TagDate[] = [];\n  for (const line of output.split(/\\r?\\n/)) {\n    const match = /^(\\S+) (\\S+)$/.exec(line.trim());\n    if (match?.[1] && match[2]) tags.push({ tag: match[1], date: match[2] });\n  }\n  return tags;\n}\n\n/**\n * This function gives the date of the oldest commit that added a version heading to a changelog,\n * or null. The path of the changelog starts at `repoDir`.\n */\nexport function headingDate(repoDir: string, version: string, file: string): string | null {\n  const output = git(repoDir, \"log\", \"--format=%cI\", `-S## ${version}`, \"--\", file);\n  const dates = (output ?? \"\").trim().split(/\\r?\\n/).filter(Boolean);\n  return dates[dates.length - 1] ?? null;\n}\n\n/** This function gives the full SHA of `HEAD`, or null. */\nexport function headCommit(repoDir: string): string | null {\n  const sha = git(repoDir, \"rev-parse\", \"HEAD\")?.trim();\n  return sha && /^[0-9a-f]{40}$/.test(sha) ? sha : null;\n}\n\n/** This function gives \"owner/name\" of the GitHub remote \"origin\", or null. */\nexport function originRepository(repoDir: string): string | null {\n  const url = git(repoDir, \"remote\", \"get-url\", \"origin\")?.trim() ?? \"\";\n  const match = /github\\.com[:/]([^/]+)\\/(.+?)(?:\\.git)?\\/?$/.exec(url);\n  return match ? `${match[1]}/${match[2]}` : null;\n}\n","/**\n * The file `kpi.json` at the root of a site, format `kpi/1`. A reader outside the site takes the measures of the project\n * from this file. Thus a number on a progress page comes from a record and not from a person.\n *\n * The field `at` is the time of the data and not the time of the build. Thus the writer has no default for it.\n * A measure can have its own `at` when its data is from another time than the rest of the file.\n */\n\nimport { mkdirSync, writeFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport type { KpiEngine, KpiFile, KpiMeasure } from \"./types.ts\";\n\n/** The name of the format. A new format gets a new name, so that an old reader refuses it. */\nexport const KPI_FORMAT = \"kpi/1\";\n\n/** The name of the file at the root of the built site. */\nexport const KPI_FILE = \"kpi.json\";\n\n/** The data of `kpi.json`, without the name of the format. */\nexport type KpiInput = Omit<KpiFile, \"format\">;\n\n/** The form of a project and a measure. A double hyphen separates fields in the file name of a reading. */\nconst SLUG = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;\n\n/** The form of a time in UTC, with or without seconds. */\nconst UTC_TIME = /^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d+)?)?Z$/;\n\n/** The form of a full commit. */\nconst COMMIT = /^[0-9a-f]{40}$/;\n\n/** The clock difference between two computers that the check accepts, in milliseconds. */\nconst CLOCK_MARGIN = 5 * 60 * 1000;\n\n/** An error in the data of `kpi.json`. The field `problems` has one line for each fault. */\nexport class KpiError extends Error {\n  readonly problems: readonly string[];\n\n  constructor(problems: readonly string[]) {\n    super(`${KPI_FILE} is not correct: ${problems.join(\" \")}`);\n    this.name = \"KpiError\";\n    this.problems = problems;\n  }\n}\n\nconst isRecord = (value: unknown): value is Record<string, unknown> => typeof value === \"object\" && value !== null && !Array.isArray(value);\n\nconst isText = (value: unknown): value is string => typeof value === \"string\" && value.trim() !== \"\";\n\n/** This function gives the fault of a time of the data, or an empty list. The name tells which field it is. */\nfunction timeProblems(at: unknown, name: string, now: number): string[] {\n  if (typeof at !== \"string\" || !UTC_TIME.test(at) || Number.isNaN(Date.parse(at))) return [`${name} is not a time in UTC.`];\n  return Date.parse(at) > now + CLOCK_MARGIN ? [`The time of the data ${at} is after the time of the check.`] : [];\n}\n\n/** This function gives the faults of one measure. */\nfunction measureProblems(value: unknown, index: number, seen: Set<string>, now: number): string[] {\n  if (!isRecord(value)) return [`Measure ${index} is not an object.`];\n  const { id, value: amount, unit, at } = value;\n  const problems: string[] = [];\n  if (typeof id !== \"string\" || !SLUG.test(id)) problems.push(`Measure ${index} has no id of lowercase words with single hyphens.`);\n  else if (seen.has(id)) problems.push(`The id ${id} occurs two times.`);\n  else seen.add(id);\n  if (typeof amount !== \"number\" || !Number.isFinite(amount)) problems.push(`Measure ${index} has no finite number as its value.`);\n  if (unit !== undefined && !isText(unit)) problems.push(`Measure ${index} has a unit that is not a text.`);\n  if (at !== undefined) problems.push(...timeProblems(at, `The field at of measure ${index}`, now));\n  return problems;\n}\n\n/** This function gives the faults of the list of engines. */\nfunction engineProblems(value: unknown): string[] {\n  if (value === undefined) return [];\n  if (!Array.isArray(value)) return [\"The field engines is not a list.\"];\n  return value.flatMap((engine: unknown, index) => (isRecord(engine) && isText(engine[\"name\"]) && isText(engine[\"version\"]) ? [] : [`Engine ${index} has no name and version.`]));\n}\n\n/**\n * This function gives the faults of a parsed `kpi.json`, or an empty list.\n *\n * @param value - The parsed file.\n * @param now - The time of the check, in milliseconds. A time of the data after this time is a fault.\n */\nexport function kpiProblems(value: unknown, now: number = Date.now()): string[] {\n  if (!isRecord(value)) return [\"The file is not an object.\"];\n  const problems: string[] = [];\n  if (value[\"format\"] !== KPI_FORMAT) problems.push(`The format is not ${KPI_FORMAT}.`);\n  const { project, at, commit, measures } = value;\n  if (typeof project !== \"string\" || !SLUG.test(project)) problems.push(\"The project is not lowercase words with single hyphens.\");\n  problems.push(...timeProblems(at, \"The field at\", now));\n  if (typeof commit !== \"string\" || !COMMIT.test(commit)) problems.push(\"The commit is not a full commit.\");\n  if (!Array.isArray(measures) || measures.length === 0) problems.push(\"The file has no measures.\");\n  else {\n    const seen = new Set<string>();\n    problems.push(...measures.flatMap((measure: unknown, index) => measureProblems(measure, index, seen, now)));\n  }\n  problems.push(...engineProblems(value[\"engines\"]));\n  return problems;\n}\n\n/** This function gives a copy of a measure with only its known fields. */\nfunction cleanMeasure({ id, value, unit, at }: KpiMeasure): KpiMeasure {\n  return { id, value, ...(unit === undefined ? {} : { unit }), ...(at === undefined ? {} : { at }) };\n}\n\n/** This function gives a copy of an engine with only its known fields. */\nfunction cleanEngine({ name, version }: KpiEngine): KpiEngine {\n  return { name, version };\n}\n\n/**\n * This function gives the checked content of `kpi.json`. The file has only its known fields, in a fixed order.\n *\n * @throws KpiError when the data is not correct\n */\nexport function kpiFile(input: KpiInput, now?: number): KpiFile {\n  const problems = kpiProblems({ format: KPI_FORMAT, ...input }, now);\n  if (problems.length > 0) throw new KpiError(problems);\n  const { project, at, commit, measures, engines } = input;\n  const file: KpiFile = { format: KPI_FORMAT, project, at, commit, measures: measures.map(cleanMeasure) };\n  return engines === undefined ? file : { ...file, engines: engines.map(cleanEngine) };\n}\n\n/** This function gives the text of `kpi.json`. */\nexport function kpiText(file: KpiFile): string {\n  return `${JSON.stringify(file, null, 2)}\\n`;\n}\n\n/**\n * This function reads the text of a `kpi.json`.\n *\n * @throws KpiError when the text is not correct\n */\nexport function readKpi(text: string, now?: number): KpiFile {\n  let value: unknown;\n  try {\n    value = JSON.parse(text);\n  } catch (error) {\n    throw new KpiError([`The file is not JSON: ${error instanceof Error ? error.message : String(error)}`]);\n  }\n  const problems = kpiProblems(value, now);\n  if (problems.length > 0) throw new KpiError(problems);\n  const { project, at, commit, measures, engines } = value as KpiFile;\n  return kpiFile(engines === undefined ? { project, at, commit, measures } : { project, at, commit, measures, engines }, now);\n}\n\n/**\n * This function writes `kpi.json` into the built output folder of a site, and gives the path of the file.\n *\n * @throws KpiError when the data is not correct\n */\nexport function writeKpi(out: string, input: KpiInput, now?: number): string {\n  const text = kpiText(kpiFile(input, now));\n  mkdirSync(out, { recursive: true });\n  const file = join(out, KPI_FILE);\n  writeFileSync(file, text);\n  return file;\n}\n"],"mappings":"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"}

package/build/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/render/data-stamp.ts"],"sourcesContent":["/**\n * The line that a measured page shows for its data: the run, its date and its engine versions, and a run in flight.\n */\n\nimport type { DataRun, PageStamp } from \"../check/freshness.ts\";\nimport { escapeHtml, link, listText } from \"./html.ts\";\n\n/** This function gives an engine and its version in the short form, without the npm scope. */\nfunction engineText(name: string, version: string): string {\n  return `${name.slice(name.indexOf(\"/\") + 1)} ${version}`;\n}\n\n/** This function gives the html of one run: a link to the run, the day of its start and each engine. */\nfunction runHtml(run: DataRun): string {\n  const engines = Object.entries(run.engines).map(([name, version]) => escapeHtml(engineText(name, version)));\n  return `run ${link(run.url, escapeHtml(run.id))} of ${escapeHtml(run.date.slice(0, 10))}, on ${listText(engines)}`;\n}\n\n/** This function gives the html line of the stamp of a page. A page shows this line with its data. */\nexport function renderDataStamp(stamp: PageStamp): string {\n  const data = `<span>The data comes from ${listText(stamp.runs.map(runHtml))}.</span>`;\n  const flight = stamp.inFlight === undefined ? \"\" : ` <span>A newer run is in flight: ${runHtml(stamp.inFlight)}.</span>`;\n  return `<p class=\"data-stamp\">${data}${flight}</p>`;\n}\n"],"mappings":";;;;AAQA,SAAS,WAAW,MAAc,SAAyB;CACzD,OAAO,GAAG,KAAK,MAAM,KAAK,QAAQ,GAAG,IAAI,CAAC,EAAE,GAAG;AACjD;;AAGA,SAAS,QAAQ,KAAsB;CACrC,MAAM,UAAU,OAAO,QAAQ,IAAI,OAAO,CAAC,CAAC,KAAK,CAAC,MAAM,aAAa,WAAW,WAAW,MAAM,OAAO,CAAC,CAAC;CAC1G,OAAO,OAAO,KAAK,IAAI,KAAK,WAAW,IAAI,EAAE,CAAC,EAAE,MAAM,WAAW,IAAI,KAAK,MAAM,GAAG,EAAE,CAAC,EAAE,OAAO,SAAS,OAAO;AACjH;;AAGA,SAAgB,gBAAgB,OAA0B;CAGxD,OAAO,yBAAyB,6BAFU,SAAS,MAAM,KAAK,IAAI,OAAO,CAAC,EAAE,YAC7D,MAAM,aAAa,KAAA,IAAY,KAAK,oCAAoC,QAAQ,MAAM,QAAQ,EAAE,UACjE;AAChD"}