yukey

drop references to where the code came from; small doc fixes

commit 99937793125b652f7c557c6b5b9e020b0ad0b5c8 · parent 3bee2a2df8 · browse this tree
Ximianth, 2026-10-10 05:56:31 UTC

The four scenario headers and four token descriptions pointed at a repo
and an app a reader of this repo cannot see; the lines carried nothing
for them.  Makefile's check-e2e estimate was ~10s; it's ~30s.  The hacking
README notes --no-sandbox.
diff --git a/Makefile b/Makefile
index bec6fbc..d44ecc4 100644
--- a/Makefile
+++ b/Makefile
@@ -35,7 +35,7 @@ test: ## Run the unit tests.
 	npm run test
 
 .PHONY: check-e2e
-check-e2e: build ## Drive the gallery in a headless Chrome with trusted input (~10s).  Not part of check.
+check-e2e: build ## Drive the gallery in a headless Chrome with trusted input (~30s).  Not part of check.
 	npm run test:e2e --workspace packages/e2e
 
 .PHONY: clean
diff --git a/docs/hacking/README.md b/docs/hacking/README.md
index d2c2669..32fd096 100644
--- a/docs/hacking/README.md
+++ b/docs/hacking/README.md
@@ -45,3 +45,4 @@ Things worth knowing
   so typechecking and running the suite never require a testkit build.
   The default condition still resolves to `dist/`, which is what every outside consumer gets.
 - The e2e suite needs a Chromium.  It defaults to `/headless-shell/headless-shell`; `YUKEY_E2E_CHROME` overrides.
+  Chrome is launched with `--no-sandbox` (fine for headless-shell in a container; worth knowing if you point it at a desktop Chrome).
diff --git a/packages/e2e/scenarios/ip-drive.ts b/packages/e2e/scenarios/ip-drive.ts
index 7f6f764..6dae682 100644
--- a/packages/e2e/scenarios/ip-drive.ts
+++ b/packages/e2e/scenarios/ip-drive.ts
@@ -7,7 +7,6 @@
 // i upgrading a hover popup to pinned), dismissal (nav keys close AND navigate,
 // pointerdown closes, no resurrect), aria reflection wiring, edge clamping,
 // and the bottom flip (short-viewport emulation).
-// Ported from the Python original (demoscene.meta screenshots, stage-infopop).
 
 import { type Scenario, type ScenarioContext, shot } from "yukey-testkit/checks";
 import { sleep } from "yukey-testkit/sleep";
diff --git a/packages/e2e/scenarios/lc-drive.ts b/packages/e2e/scenarios/lc-drive.ts
index 5b2eb68..0168db7 100644
--- a/packages/e2e/scenarios/lc-drive.ts
+++ b/packages/e2e/scenarios/lc-drive.ts
@@ -25,8 +25,6 @@
 // and answered with megacolumn-focus-request; outside the list's rows the
 // letters are nobody's.  Structural row ids are name-prefixed by sw-list
 // (name="queue": queue-header, queue-add).
-// Ported from the Python original (demoscene.meta screenshots, stage-livecolumn,
-// updated in place by stage-list-component).
 
 import { type Scenario, type ScenarioContext, shot } from "yukey-testkit/checks";
 import { sleep } from "yukey-testkit/sleep";
diff --git a/packages/e2e/scenarios/mc-drive.ts b/packages/e2e/scenarios/mc-drive.ts
index 619e060..a0a7cb4 100644
--- a/packages/e2e/scenarios/mc-drive.ts
+++ b/packages/e2e/scenarios/mc-drive.ts
@@ -1,7 +1,6 @@
 // Drives the megacolumn gallery demo with TRUSTED key events via CDP,
 // reading focus/aria state between steps.  Synthetic JS KeyboardEvents can't
 // exercise real Tab traversal or real typing; these can.
-// Ported from the Python original (demoscene.meta screenshots, stage-focus-model).
 
 import type { Scenario, ScenarioContext } from "yukey-testkit/checks";
 import { sleep } from "yukey-testkit/sleep";
diff --git a/packages/e2e/scenarios/sw-drive.ts b/packages/e2e/scenarios/sw-drive.ts
index 76ac4e7..c7c85fe 100644
--- a/packages/e2e/scenarios/sw-drive.ts
+++ b/packages/e2e/scenarios/sw-drive.ts
@@ -5,7 +5,6 @@
 // claim-and-decline), the two-column scoping proof, and activation feedback
 // (the sw-held / sw-pressed classes; the 120ms flash is caught with a
 // MutationObserver installed before the keystroke, not with a screenshot race).
-// Ported from the Python original (demoscene.meta screenshots, stage-button).
 
 import { type Scenario, type ScenarioContext, shot } from "yukey-testkit/checks";
 import { sleep } from "yukey-testkit/sleep";
diff --git a/packages/yukey/src/tokens.ts b/packages/yukey/src/tokens.ts
index 42ecbce..5d9fa1d 100644
--- a/packages/yukey/src/tokens.ts
+++ b/packages/yukey/src/tokens.ts
@@ -47,7 +47,7 @@ export const tokenGroups: TokenGroup[] = [
 				name: "--sw-bg-void",
 				value: "#05080f",
 				kind: "color",
-				about: "the deepest layer: the map background, the page behind everything",
+				about: "the deepest layer: the page behind everything",
 			},
 			{
 				name: "--sw-bg-panel-solid",
@@ -59,7 +59,7 @@ export const tokenGroups: TokenGroup[] = [
 				name: "--sw-bg-panel",
 				value: "color-mix(in srgb, var(--sw-bg-panel-solid) 94%, transparent)",
 				kind: "color",
-				about: "translucent panel surface: big workspace panels floating over the map",
+				about: "translucent panel surface: big workspace panels floating over the page",
 			},
 			{
 				name: "--sw-bg-well",
@@ -192,7 +192,7 @@ export const tokenGroups: TokenGroup[] = [
 				name: "--sw-good",
 				value: "#8fd4c0",
 				kind: "color",
-				about: "the working-economy teal: producing, positive flow, and the map's route system (promises of movement)",
+				about: "the working-economy teal: producing, positive flow, promises of movement",
 			},
 			{
 				name: "--sw-warn",
@@ -255,7 +255,7 @@ export const tokenGroups: TokenGroup[] = [
 				name: "--sw-selection",
 				value: "#d8ecff",
 				kind: "color",
-				about: "the selection marker: the map's dashed ring around the selected entity",
+				about: "the selection marker: a dashed ring around the selected entity",
 			},
 			{
 				name: "--sw-focus-ring-color",