feat(hint): add numeric label generator helper

The function is only a few lines, but we can help out users by providing
a stock implementation. Note that we ignore hint_chars here!

You might think that we could provide just a "sequential" generator that
would turn an alphabet like "abc" into:

  a, b, c, aa, ab, ac, ba, bb, bc, ca, cb, cc, aaa, ...

and then feed it the numeric digits via hint_chars. But that is not
quite how numbers work. If the alphabet is "1234567890", then we get "0"
instead of "10" as the tenth label, and "10" as the twentieth. If you
instead use "0123456789", then we start with "0" and get "01", "02",
etc, instead of the teens. You'd have to be smart about how zeroes are
handled, at which point it is easier to just have a custom generator
that simply counts.

Author: peff

src/glide/browser/base/content/browser.mts

@@ -1901,6 +1901,14 @@ function make_glide_api(): typeof glide {
       label_prefix_free(hints): string[] {
         return GlideHints.hint_label_prefix_free(hints.length);
       },
+
+      label_numeric(hints): string[] {
+        var ret = [];
+        for (var i = 1; i <= hints.length; i++) {
+          ret.push(i.toString());
+        }
+        return ret;
+      },
     },
 
     addons: {

src/glide/browser/base/content/glide.d.ts

@@ -934,6 +934,9 @@ declare global {
        *  - `glide.hints.label_prefix_free`: Generate prefix-free
        *    combinations of the characters in [hint_chars](#glide.o.hint_chars).
        *    This is the default.
+       *
+       *  - `glide.hints.label_numeric`: Generate sequential numeric labels,
+       *    starting at `1` and counting up. Ignores [hint_chars](#glide.o.hint_chars).
        */
       hint_label_generator: (GlideResolvedHint[]) => string[];
     };

src/glide/browser/base/content/test/hints/browser_hints.ts

@@ -295,3 +295,20 @@ add_task(async function test_hint_generator_config() {
     await keys("<esc>");
   });
 });
+
+add_task(async function test_numeric_hint_generator() {
+  await GlideTestUtils.reload_config(function _() {
+    glide.o.hint_label_generator = glide.hints.label_numeric;
+  });
+
+  await BrowserTestUtils.withNewTab(FILE, async _browser => {
+    await keys("f");
+    await wait_for_hints();
+
+    const hints = GlideHints.get_active_hints();
+    is(hints[0]?.label, "1");
+    is(hints[1]?.label, "2");
+    is(hints[9]?.label, "10");
+    await keys("<esc>");
+  });
+});

src/glide/docs/api.md

@@ -227,6 +227,9 @@ your own function or use an included one:
   combinations of the characters in [hint_chars](#glide.o.hint_chars).
   This is the default.
 
+- `glide.hints.label_numeric`: Generate sequential numeric labels,
+  starting at `1` and counting up. Ignores [hint_chars](#glide.o.hint_chars).
+
 ## • `glide.bo: Partial<glide.Options>` {% id="glide.bo" %}
 
 Set buffer specific options.