@escape-game-over/atlas 0.1.111 → 0.1.112

package/docs/checks.md

@@ -132,7 +132,7 @@ dependencies at all. Vitest type-checks them itself when it runs them.
 | `money.test.ts`            | a bare count widened to a band, the span of a table, the gaps and overlaps that throw, and an audience priced twice                                                                                  |
 | `url.test.ts`              | joining an origin to a path exactly once, and normalising the origin an `@id` is built from                                                                                                          |
 | `warn.test.ts`             | the shared prefix, and reducing a URL to its path                                                                                                                                                    |
-| `filters.test.ts`          | folding both sides of a query, how each kind narrows, the four URL decisions, and attach/detach                                                                                                      |
+| `filters.test.ts`          | folding both sides of a query, how each kind narrows, the four URL decisions, values no item holds, and attach/detach                                                                                |
 | `filters-view.test.ts`     | the write-back into the input and that it is skipped when unchanged, clear taking focus, and the nesting order                                                                                       |
 | `build-cache.test.ts`      | that an unset `CI_ASTRO_CACHE` yields nothing, so Astro's own `cacheDir` default survives                                                                                                            |
 

package/docs/client-scripts.md

@@ -241,6 +241,12 @@ instead of flashing the whole list back. Nothing writes to the URL before
 `attach`, because `attach` is what reads it — a `set` on an unattached instance
 would overwrite state nobody had loaded.
 
+A choice no item holds, or a flag no item carries, is a stale or mistyped link:
+reading it — on `attach` and on the back button — takes it as no choice, and
+replaces the URL without it. Otherwise `?category=castle` showed an empty list
+with nothing pressed, not even "All". A `text` query is left alone: it matches
+words, not values, and finding nothing is a fair answer to it.
+
 A flag is on by being there, as an HTML boolean attribute is: written as the bare
 `?featured`, and **absent** when off. Reading asks only whether the name is
 present, so `?featured=1` from an older link still reads as on — and so does a

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@escape-game-over/atlas",
-    "version": "0.1.111",
+    "version": "0.1.112",
     "type": "module",
     "description": "Typed, data-driven machinery for static multi-locale, multi-deployment Astro sites.",
     "private": false,

package/src/astro/filters.ts

@@ -199,6 +199,18 @@ export function filters<const F extends FieldMap, T>(
         return { item, values, haystacks };
     });
 
+    // What the items hold, per choice and flag: a link asking for anything
+    // else is stale or mistyped, and is read as no choice rather than an empty
+    // list with nothing pressed.
+    const held = new Map<string, ReadonlySet<unknown>>();
+    for (const name of names) {
+        if (kindOf(name) === "text") continue;
+        held.set(
+            name,
+            new Set(entries.flatMap((entry) => entry.values[name] as unknown))
+        );
+    }
+
     const empty = (name: keyof F & string): StateValue<F[typeof name]> =>
         (kindOf(name) === "flag" ? false : "") as StateValue<F[typeof name]>;
 
@@ -287,9 +299,11 @@ export function filters<const F extends FieldMap, T>(
         matched = next;
     }
 
-    function readUrl(): void {
+    /** Applies the URL; says whether it asked for anything no item holds. */
+    function readUrl(): boolean {
         const search = new URLSearchParams(window.location.search);
         const next: Record<string, string | boolean> = {};
+        let dropped = false;
         for (const name of names) {
             if (!inUrl.includes(name)) {
                 // A state-only field is not in the URL, so the URL has nothing
@@ -300,12 +314,17 @@ export function filters<const F extends FieldMap, T>(
             }
             // A flag is on by being there, as an HTML boolean attribute is:
             // `?featured`, and `?featured=1` from an older link, alike.
-            next[name] =
+            const value =
                 kindOf(name) === "flag"
                     ? search.has(name)
                     : (search.get(name) ?? "");
+            const unheld =
+                value !== empty(name) && held.get(name)?.has(value) === false;
+            next[name] = unheld ? empty(name) : value;
+            if (unheld) dropped = true;
         }
         state = next as FilterState<F>;
+        return dropped;
     }
 
     function writeUrl(history: "push" | "replace"): void {
@@ -424,8 +443,9 @@ export function filters<const F extends FieldMap, T>(
             window.addEventListener(
                 "popstate",
                 () => {
-                    readUrl();
+                    const dropped = readUrl();
                     recompute();
+                    if (dropped) writeUrl("replace");
                     announce();
                 },
                 { signal: events.signal }
@@ -435,8 +455,11 @@ export function filters<const F extends FieldMap, T>(
             // Read before the first announcement: the URL may already carry a
             // state, and announcing the empty one first flashes the unfiltered
             // list over it.
-            readUrl();
+            // A value no item holds leaves the address bar as well, replaced
+            // rather than pushed: it is a correction, not a step to go back to.
+            const dropped = readUrl();
             recompute();
+            if (dropped) writeUrl("replace");
             announce();
 
             return () => {