源码快照 @ 2026-09-01 (source-only, 剔除非源码素材)

scripts/generate-app-icons.test.mjs

@@ -0,0 +1,102 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+/**
+ * The shipped icon artwork has to stay reproducible from source.
+ *
+ * A directory of opaque PNGs cannot be audited: nobody reviewing a change can
+ * tell whether a tile was regenerated from the committed geometry, exported
+ * from a design tool, or pasted in from somewhere with an unclear licence.
+ * Keeping the generator in the tree only helps if something checks that it
+ * still produces exactly what is committed — otherwise the two drift and the
+ * script becomes decoration.
+ */
+import assert from 'node:assert/strict';
+import { spawnSync } from 'node:child_process';
+import { readdir } from 'node:fs/promises';
+import { fileURLToPath } from 'node:url';
+import { test } from 'node:test';
+import { APP_ICONS } from '@maka/core/settings';
+
+const SCRIPT = fileURLToPath(new URL('./generate-app-icons.py', import.meta.url));
+const ART = new URL('../apps/desktop/assets/app-icons/', import.meta.url);
+
+/** Ids whose artwork does not come from the generator. */
+const NOT_GENERATED = new Set([
+  // The brand mark lives at assets/icon.png, outside this directory.
+  'default',
+  // Its grayscale companion is a derived export of that same mark.
+  'mono',
+]);
+
+function python() {
+  for (const candidate of ['python3', 'python']) {
+    const probe = spawnSync(candidate, ['--version'], { encoding: 'utf8' });
+    if (probe.status === 0) return candidate;
+  }
+  return undefined;
+}
+
+test('every shipped id has artwork, and every file is claimed by an id', async () => {
+  // Pure bookkeeping, so it runs everywhere: adding an id without art, or art
+  // without an id, is the mistake that would otherwise surface as an icon the
+  // picker silently drops into the "imported" group.
+  const files = (await readdir(ART)).filter((name) => name.endsWith('.png'));
+  const onDisk = new Set(files.map((name) => name.slice(0, -'.png'.length)));
+  const expected = new Set(APP_ICONS.filter((id) => !NOT_GENERATED.has(id)));
+
+  for (const id of expected) {
+    assert.ok(onDisk.has(id), `APP_ICONS names ${id} but no artwork ships for it`);
+  }
+  for (const name of onDisk) {
+    if (NOT_GENERATED.has(name)) continue;
+    assert.ok(expected.has(name), `${name}.png ships but no id in APP_ICONS selects it`);
+  }
+});
+
+test('every committed icon is byte-identical to what the generator produces', (t) => {
+  const runner = python();
+  if (!runner) {
+    t.skip('no python3 on PATH; run scripts/generate-app-icons.py --check locally');
+    return;
+  }
+  // The WHOLE catalogue, not a sample. A sample only proves the sampled tiles:
+  // any of the other PNGs could be edited byte-wise, or a colourway constant
+  // could change without its artwork being regenerated, and the check would
+  // still pass. Since the claim being made is that every shipped tile comes
+  // out of this script, the check has to cover every shipped tile.
+  //
+  // The script renders across all cores for this reason — ~90s serial, ~16s
+  // parallel on an 8-core machine.
+  const result = spawnSync(runner, [SCRIPT, '--check'], { encoding: 'utf8' });
+
+  assert.equal(
+    result.status,
+    0,
+    `generator disagrees with the committed artwork:\n${result.stdout}${result.stderr}`,
+  );
+  // Guard against the check silently narrowing: the script reports how many it
+  // compared, and that number has to be the whole generated set.
+  const expected = APP_ICONS.filter((id) => !NOT_GENERATED.has(id)).length;
+  assert.match(
+    result.stdout,
+    new RegExp(`all ${expected} icons match`),
+    `expected the check to cover all ${expected} generated icons, got: ${result.stdout.trim()}`,
+  );
+});