@mark1russell7/site-pages 0.2.5 → 0.2.7

package/build/chunks/kpi.d.ts

@@ -127,6 +127,8 @@ interface KpiMeasure {
   id: string;
   value: number;
   unit?: string;
+  /** The ISO time of the data of this measure in UTC. Without it, the measure has the time of the file. */
+  at?: string;
 }
 /** One engine that made the data of `kpi.json`. */
 interface KpiEngine {

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

@@ -1 +1 @@
-{"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;;;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;;;cCtKK;;cAGA;;KAGD,WAAW,KAAK;;cAef,iBAAiB;WACnB;EAET,YAAY;;;;;;;;iBAqCE,YAAY,gBAAgB;;;;;;iBAiC5B,QAAQ,OAAO,UAAU,eAAe;;iBASxC,QAAQ,MAAM;;;;;;iBASd,QAAQ,cAAc,eAAe;;;;;;iBAkBrC,SAAS,aAAa,OAAO,UAAU"}
+{"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

@@ -66,6 +66,7 @@ function originRepository(repoDir) {
 * 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";
@@ -90,16 +91,22 @@ var KpiError = class extends Error {
 };
 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) {
+function measureProblems(value, index, seen, now) {
 	if (!isRecord(value)) return [`Measure ${index} is not an object.`];
-	const { id, value: amount, unit } = value;
+	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. */
@@ -120,26 +127,23 @@ function kpiProblems(value, now = Date.now()) {
 	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.");
-	if (typeof at !== "string" || !UTC_TIME.test(at) || Number.isNaN(Date.parse(at))) problems.push("The field at is not a time in UTC.");
-	else if (Date.parse(at) > now + CLOCK_MARGIN) problems.push(`The time of the data ${at} is after the time of the check.`);
+	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)));
+		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 }) {
-	return unit === void 0 ? {
-		id,
-		value
-	} : {
+function cleanMeasure({ id, value, unit, at }) {
+	return {
 		id,
 		value,
-		unit
+		...unit === void 0 ? {} : { unit },
+		...at === void 0 ? {} : { at }
 	};
 }
 /** This function gives a copy of an engine with only its known fields. */

package/build/chunks/kpi.js.map

@@ -1 +1 @@
-{"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 */\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 faults of one measure. */\nfunction measureProblems(value: unknown, index: number, seen: Set<string>): string[] {\n  if (!isRecord(value)) return [`Measure ${index} is not an object.`];\n  const { id, value: amount, unit } = 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  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  if (typeof at !== \"string\" || !UTC_TIME.test(at) || Number.isNaN(Date.parse(at))) problems.push(\"The field at is not a time in UTC.\");\n  else if (Date.parse(at) > now + CLOCK_MARGIN) problems.push(`The time of the data ${at} is after the time of the check.`);\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)));\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 }: KpiMeasure): KpiMeasure {\n  return unit === undefined ? { id, value } : { id, value, unit };\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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"}
+{"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/explorer/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/explorer/model.ts","../../src/explorer/view.ts"],"mappings":";;qBAkCa;;qBAEA;;;;;;qBAMA;;qBAEA;;qBAEA;;UASI;;WAEN;;WAEA;;WAEA;;WAEA;;WAEA,MAAM,SAAS,eAAe;;;KAI7B;;UAGK;WACN;WACA;WACA;;WAEA;;;UAIM;WACN,OAAO;WACP;WACA;WACA;;;UAIM;WACN;WACA;;WAEA;;WAEA;;WAEA;WACA,kBAAkB;WAClB,OAAO;;;UAID;WACN;WACA;WACA;WACA;;WAEA;;WAEA,iBAAiB;;;UAIlB;;WAEC;;WAEA,OAAO;;;UAID,mBAAmB;WACzB;WACA,OAAO;;;UAID,qBAAqB;WAC3B;WACA;WACA,SAAS;;;UAIH;WACN;;WAEA,aAAa;WACb;;;UAIM,oBAAoB;WAC1B;WACA,iBAAiB;;;KAIhB,gBAAgB,aAAa,eAAe;;UAGvC;WACN,SAAS;WACT,GAAG;WACH,GAAG;WACH,iBAAiB;;WAEjB;;WAEA,OAAO;;WAEP;;WAEA;;WAEA;;WAEA;;WAEA;;WAEA;;WAEA;;WAEA;;;UAIM;;WAEN;;WAEA;;WAEA;;;UAIM;WACN;WACA;;;;;;wBAcK,WAAW,iBAAiB;;;;;;wBA0K5B,OAAO,QAAQ,gBAAgB,SAAQ,QAAQ,iBAAsB;;wBAqBrE,YAAY,QAAQ,gBAAgB,OAAO,eAAe,MAAM,oBAAoB;;wBAQpF,aAAa,QAAQ,gBAAgB,OAAO,yBAAyB;;wBAQrE,aAAa,QAAQ,gBAAgB,OAAO,yBAAyB;;wBAmBrE,WAAW,QAAQ,gBAAgB,OAAO,eAAe,kBAAkB;;wBAK3E,QAAQ,QAAQ,gBAAgB,OAAO,eAAe,MAAM,UAAU,oBAAoB;;wBAO1F,SAAS,QAAQ,gBAAgB,OAAO,eAAe,oBAAoB;;wBAM3E,QAAQ,QAAQ,gBAAgB,OAAO,eAAe,YAAY,OAAO,gBAAgB;;;;;;;;;;;wBAiBzF,UAAU,gBAAgB,gBAAgB,oBAAoB,gBAAgB;;wBAO9E,aAAa,eAAe,mBAAmB;;;;;wBA4F/C,OAAO,QAAQ,gBAAgB,OAAO,eAAe,UAAS,cAAmB;;wBAmLjF,YAAY,MAAM,cAAc,OAAO,gBAAgB;;UCvrBtD;;WAEN,UAAU,QAAQ;;WAElB;;WAEA;;;UAIM;;EAEf,SAAS;;EAET;;;;;;;;;;wBAmZc,cAAc,MAAM,aAAa,qBAAqB,UAAS,kBAAuB"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/explorer/model.ts","../../src/explorer/view.ts"],"mappings":";;qBAkCa;;qBAEA;;;;;;qBAMA;;qBAEA;;qBAEA;;UAWI;;WAEN;;WAEA;;WAEA;;WAEA;;WAEA,MAAM,SAAS,eAAe;;;KAI7B;;UAGK;WACN;WACA;WACA;;WAEA;;;UAIM;WACN,OAAO;WACP;WACA;WACA;;;UAIM;WACN;WACA;;WAEA;;WAEA;;WAEA;WACA,kBAAkB;WAClB,OAAO;;;UAID;WACN;WACA;WACA;WACA;;WAEA;;WAEA,iBAAiB;;;UAIlB;;WAEC;;WAEA,OAAO;;;UAID,mBAAmB;WACzB;WACA,OAAO;;;UAID,qBAAqB;WAC3B;WACA;WACA,SAAS;;;UAIH;WACN;;WAEA,aAAa;WACb;;;UAIM,oBAAoB;WAC1B;WACA,iBAAiB;;;KAIhB,gBAAgB,aAAa,eAAe;;UAGvC;WACN,SAAS;WACT,GAAG;WACH,GAAG;WACH,iBAAiB;;WAEjB;;WAEA,OAAO;;WAEP;;WAEA;;WAEA;;WAEA;;WAEA;;WAEA;;WAEA;;WAEA;;;UAIM;;WAEN;;WAEA;;WAEA;;;UAIM;WACN;WACA;;;;;;wBAcK,WAAW,iBAAiB;;;;;;wBA0K5B,OAAO,QAAQ,gBAAgB,SAAQ,QAAQ,iBAAsB;;wBAqBrE,YAAY,QAAQ,gBAAgB,OAAO,eAAe,MAAM,oBAAoB;;wBAQpF,aAAa,QAAQ,gBAAgB,OAAO,yBAAyB;;wBAQrE,aAAa,QAAQ,gBAAgB,OAAO,yBAAyB;;wBAwBrE,WAAW,QAAQ,gBAAgB,OAAO,eAAe,kBAAkB;;wBAK3E,QAAQ,QAAQ,gBAAgB,OAAO,eAAe,MAAM,UAAU,oBAAoB;;wBAO1F,SAAS,QAAQ,gBAAgB,OAAO,eAAe,oBAAoB;;wBAM3E,QAAQ,QAAQ,gBAAgB,OAAO,eAAe,YAAY,OAAO,gBAAgB;;;;;;;;;;;wBAiBzF,UAAU,gBAAgB,gBAAgB,oBAAoB,gBAAgB;;wBAO9E,aAAa,eAAe,mBAAmB;;;;;wBA4F/C,OAAO,QAAQ,gBAAgB,OAAO,eAAe,UAAS,cAAmB;;wBAmLjF,YAAY,MAAM,cAAc,OAAO,gBAAgB;;UC7rBtD;;WAEN,UAAU,QAAQ;;WAElB;;WAEA;;;UAIM;;EAEf,SAAS;;EAET;;;;;;;;;;wBAyac,cAAc,MAAM,aAAa,qBAAqB,UAAS,kBAAuB"}

package/build/explorer/index.js

@@ -272,6 +272,10 @@ function holdControls(record, state) {
 		};
 	});
 }
+/** This function gives the form of a group of levels. */
+function levelForm(count) {
+	return count > 8 ? "select" : "chips";
+}
 /** This function gives the state with a new measure. */
 function setMeasure(record, state, measure) {
 	return settle(record, {
@@ -1145,8 +1149,24 @@ function dimensionSelect(label, key, choices, value, none, change) {
 	select.addEventListener("change", () => change(select.value === "" ? null : select.value));
 	return h("label", { class: "rx-field" }, h("span", {}, label), select);
 }
-/** This function makes a group of level buttons. They are radio inputs, so the keyboard works with no script. */
+/** This function makes a select of levels. A closed select shows the held value and takes one row. */
+function levelSelect(label, key, options, note) {
+	const items = options.map((option, i) => {
+		const text = option.disabled ? `${option.text}: ${option.reason}` : option.text;
+		return h("option", {
+			value: i,
+			disabled: option.disabled,
+			selected: option.checked
+		}, text);
+	});
+	const select = h("select", { "data-key": key }, ...items);
+	select.addEventListener("change", () => options[Number(select.value)]?.choose());
+	const field = h("label", { class: "rx-field" }, h("span", {}, label), select);
+	return h("div", { class: "rx-hold" }, field, note === "" ? null : h("p", { class: "rx-note" }, note));
+}
+/** This function makes a group of levels. Level buttons are radio inputs, so the keyboard works with no script. */
 function levelGroup(label, key, name, options, note) {
+	if (levelForm(options.length) === "select") return levelSelect(label, key, options, note);
 	const chips = options.map((option, i) => {
 		const input = h("input", {
 			class: "rx-radio",