@grimoire-rs/indexer 0.1.8 → 0.2.0

package/dist/renderer/astro/lib/catalog.d.ts

@@ -4,4 +4,28 @@ export declare function compareVersions(a: string, b: string): number;
 export declare function timeAgo(iso: string): string;
 /** `vscode://<publisher.extension>/open?repo=<ref>`, or null when disabled. */
 export declare function vscodeUrl(extension: string | null, ref: string): string | null;
+/**
+ * `vscode://<publisher.extension>/add-registry?index=<url>&alias=<name>` — the
+ * one-click counterpart of the `grim config registry add` line beside it.
+ *
+ * Null unless the link would actually work: the handler takes https only (an
+ * index locator is fetched with whatever credentials the user configures for
+ * it), refuses embedded credentials, and caps the URL at 2048 characters.
+ * Checking here keeps a broken button off the page rather than putting the
+ * failure in the user's hands.
+ */
+export declare function addRegistryUrl(extension: string | null, registry: {
+    alias: string;
+    index: string;
+} | null): string | null;
+/**
+ * A bundle member's `id` resolved to the reference the index stores.
+ *
+ * grim writes members relative to the bundle itself — `../skills/grim-usage:0`
+ * — so a member published alongside its bundle stays correct wherever the
+ * whole namespace is mirrored. The catalog keys on absolute, untagged refs,
+ * which is what this returns; an id that is already absolute passes through
+ * with only its tag or digest removed.
+ */
+export declare function resolveMemberRef(bundleRef: string, id: string): string;
 //# sourceMappingURL=catalog.d.ts.map

package/dist/renderer/astro/lib/catalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../../src/renderer/astro/lib/catalog.ts"],"names":[],"mappings":"AAOA,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAKrD,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAWpF;AAID,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAa5D;AAcD,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAS3C;AAED,+EAA+E;AAC/E,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE9E"}
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../../src/renderer/astro/lib/catalog.ts"],"names":[],"mappings":"AAOA,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAKrD,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAWpF;AAID,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAa5D;AAcD,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAS3C;AAED,+EAA+E;AAC/E,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE9E;AAUD;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,QAAQ,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,GAChD,MAAM,GAAG,IAAI,CAYf;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAgBtE"}

package/dist/renderer/astro/lib/catalog.js

@@ -58,4 +58,66 @@ export function timeAgo(iso) {
 export function vscodeUrl(extension, ref) {
     return extension ? `vscode://${extension}/open?repo=${encodeURIComponent(ref)}` : null;
 }
+/**
+ * Alias charset the extension's `/add-registry` handler accepts. It has to be
+ * a TOML bare key and safe as a CLI argument, so it refuses a link rather
+ * than escaping one. Mirrored here so a config that cannot produce a working
+ * link renders no button at all, instead of one that silently does nothing.
+ */
+const REGISTRY_ALIAS = /^[A-Za-z0-9][A-Za-z0-9_-]{0,31}$/;
+/**
+ * `vscode://<publisher.extension>/add-registry?index=<url>&alias=<name>` — the
+ * one-click counterpart of the `grim config registry add` line beside it.
+ *
+ * Null unless the link would actually work: the handler takes https only (an
+ * index locator is fetched with whatever credentials the user configures for
+ * it), refuses embedded credentials, and caps the URL at 2048 characters.
+ * Checking here keeps a broken button off the page rather than putting the
+ * failure in the user's hands.
+ */
+export function addRegistryUrl(extension, registry) {
+    if (!extension || !registry || !REGISTRY_ALIAS.test(registry.alias))
+        return null;
+    let url;
+    try {
+        url = new URL(registry.index);
+    }
+    catch {
+        return null;
+    }
+    if (url.protocol !== "https:" || url.username !== "" || url.password !== "")
+        return null;
+    if (url.href.length > 2048)
+        return null;
+    const query = new URLSearchParams({ index: url.href, alias: registry.alias });
+    return `vscode://${extension}/add-registry?${query.toString()}`;
+}
+/**
+ * A bundle member's `id` resolved to the reference the index stores.
+ *
+ * grim writes members relative to the bundle itself — `../skills/grim-usage:0`
+ * — so a member published alongside its bundle stays correct wherever the
+ * whole namespace is mirrored. The catalog keys on absolute, untagged refs,
+ * which is what this returns; an id that is already absolute passes through
+ * with only its tag or digest removed.
+ */
+export function resolveMemberRef(bundleRef, id) {
+    const pinned = id.split("@")[0] ?? id;
+    // A tag is a colon *after* the last slash — `localhost:5000/x` is a host,
+    // not a tag.
+    const slash = pinned.lastIndexOf("/");
+    const colon = pinned.lastIndexOf(":");
+    const ref = colon > slash ? pinned.slice(0, colon) : pinned;
+    if (!ref.startsWith("."))
+        return ref;
+    // Relative: resolve against the directory the bundle itself lives in.
+    const segments = bundleRef.split("/").slice(0, -1);
+    for (const segment of ref.split("/")) {
+        if (segment === "..")
+            segments.pop();
+        else if (segment !== "." && segment !== "")
+            segments.push(segment);
+    }
+    return segments.join("/");
+}
 //# sourceMappingURL=catalog.js.map

package/dist/renderer/astro/lib/catalog.js.map

@@ -1 +1 @@
-{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../../../src/renderer/astro/lib/catalog.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../../../src/renderer/astro/lib/catalog.ts"],"names":[],"mappings":"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"}

package/dist/renderer/astro/lib/catalog.ts

@@ -67,3 +67,65 @@ export function timeAgo(iso: string): string {
 export function vscodeUrl(extension: string | null, ref: string): string | null {
   return extension ? `vscode://${extension}/open?repo=${encodeURIComponent(ref)}` : null;
 }
+
+/**
+ * Alias charset the extension's `/add-registry` handler accepts. It has to be
+ * a TOML bare key and safe as a CLI argument, so it refuses a link rather
+ * than escaping one. Mirrored here so a config that cannot produce a working
+ * link renders no button at all, instead of one that silently does nothing.
+ */
+const REGISTRY_ALIAS = /^[A-Za-z0-9][A-Za-z0-9_-]{0,31}$/;
+
+/**
+ * `vscode://<publisher.extension>/add-registry?index=<url>&alias=<name>` — the
+ * one-click counterpart of the `grim config registry add` line beside it.
+ *
+ * Null unless the link would actually work: the handler takes https only (an
+ * index locator is fetched with whatever credentials the user configures for
+ * it), refuses embedded credentials, and caps the URL at 2048 characters.
+ * Checking here keeps a broken button off the page rather than putting the
+ * failure in the user's hands.
+ */
+export function addRegistryUrl(
+  extension: string | null,
+  registry: { alias: string; index: string } | null,
+): string | null {
+  if (!extension || !registry || !REGISTRY_ALIAS.test(registry.alias)) return null;
+  let url: URL;
+  try {
+    url = new URL(registry.index);
+  } catch {
+    return null;
+  }
+  if (url.protocol !== "https:" || url.username !== "" || url.password !== "") return null;
+  if (url.href.length > 2048) return null;
+  const query = new URLSearchParams({ index: url.href, alias: registry.alias });
+  return `vscode://${extension}/add-registry?${query.toString()}`;
+}
+
+/**
+ * A bundle member's `id` resolved to the reference the index stores.
+ *
+ * grim writes members relative to the bundle itself — `../skills/grim-usage:0`
+ * — so a member published alongside its bundle stays correct wherever the
+ * whole namespace is mirrored. The catalog keys on absolute, untagged refs,
+ * which is what this returns; an id that is already absolute passes through
+ * with only its tag or digest removed.
+ */
+export function resolveMemberRef(bundleRef: string, id: string): string {
+  const pinned = id.split("@")[0] ?? id;
+  // A tag is a colon *after* the last slash — `localhost:5000/x` is a host,
+  // not a tag.
+  const slash = pinned.lastIndexOf("/");
+  const colon = pinned.lastIndexOf(":");
+  const ref = colon > slash ? pinned.slice(0, colon) : pinned;
+  if (!ref.startsWith(".")) return ref;
+
+  // Relative: resolve against the directory the bundle itself lives in.
+  const segments = bundleRef.split("/").slice(0, -1);
+  for (const segment of ref.split("/")) {
+    if (segment === "..") segments.pop();
+    else if (segment !== "." && segment !== "") segments.push(segment);
+  }
+  return segments.join("/");
+}

package/dist/renderer/astro/lib/code.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Light and dark code themes.
+ *
+ * Shiki is what Astro already ships — the same highlighter VS Code renders
+ * with — so nothing here adds a library; this only stops the two consumers
+ * drifting onto different themes. The markdown pipeline reads it through
+ * `astro.config`'s `shikiConfig`, and the `<Code>` component on the package
+ * page takes it as a prop.
+ *
+ * A *pair*, not one theme: with a single theme a block stays dark on a light
+ * page. Given two, Shiki writes the light colour as an inline style and the
+ * dark one as a `--shiki-dark` custom property on the same token, and
+ * `Base.astro` swaps between them with the rest of the palette.
+ *
+ * GitHub's pair, deliberately boring: Shiki's best-tested themes, and neutral
+ * enough to sit on this page without fighting the accent.
+ */
+export declare const SHIKI_THEMES: {
+    readonly light: "github-light";
+    readonly dark: "github-dark";
+};
+//# sourceMappingURL=code.d.ts.map

package/dist/renderer/astro/lib/code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code.d.ts","sourceRoot":"","sources":["../../../../src/renderer/astro/lib/code.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,YAAY;;;CAA0D,CAAC"}

package/dist/renderer/astro/lib/code.js

@@ -0,0 +1,21 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright 2026 The Grimoire Authors
+/**
+ * Light and dark code themes.
+ *
+ * Shiki is what Astro already ships — the same highlighter VS Code renders
+ * with — so nothing here adds a library; this only stops the two consumers
+ * drifting onto different themes. The markdown pipeline reads it through
+ * `astro.config`'s `shikiConfig`, and the `<Code>` component on the package
+ * page takes it as a prop.
+ *
+ * A *pair*, not one theme: with a single theme a block stays dark on a light
+ * page. Given two, Shiki writes the light colour as an inline style and the
+ * dark one as a `--shiki-dark` custom property on the same token, and
+ * `Base.astro` swaps between them with the rest of the palette.
+ *
+ * GitHub's pair, deliberately boring: Shiki's best-tested themes, and neutral
+ * enough to sit on this page without fighting the accent.
+ */
+export const SHIKI_THEMES = { light: "github-light", dark: "github-dark" };
+//# sourceMappingURL=code.js.map

package/dist/renderer/astro/lib/code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code.js","sourceRoot":"","sources":["../../../../src/renderer/astro/lib/code.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,sCAAsC;AAEtC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAW,CAAC"}

package/dist/renderer/astro/lib/code.ts

@@ -0,0 +1,21 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright 2026 The Grimoire Authors
+
+/**
+ * Light and dark code themes.
+ *
+ * Shiki is what Astro already ships — the same highlighter VS Code renders
+ * with — so nothing here adds a library; this only stops the two consumers
+ * drifting onto different themes. The markdown pipeline reads it through
+ * `astro.config`'s `shikiConfig`, and the `<Code>` component on the package
+ * page takes it as a prop.
+ *
+ * A *pair*, not one theme: with a single theme a block stays dark on a light
+ * page. Given two, Shiki writes the light colour as an inline style and the
+ * dark one as a `--shiki-dark` custom property on the same token, and
+ * `Base.astro` swaps between them with the rest of the palette.
+ *
+ * GitHub's pair, deliberately boring: Shiki's best-tested themes, and neutral
+ * enough to sit on this page without fighting the accent.
+ */
+export const SHIKI_THEMES = { light: "github-light", dark: "github-dark" } as const;

package/dist/renderer/astro/pages/index.astro

@@ -1,29 +1,75 @@
 ---
 import Base from "../layouts/Base.astro";
 import Catalog from "../components/Catalog.tsx";
-import CopyButton from "../components/CopyButton.astro";
+import CommandField from "../components/CommandField.astro";
+import PickerMenu from "../components/PickerMenu.astro";
+import { BrandMark } from "../components/BrandMark.tsx";
+import { FolderRoot, Globe } from "lucide-preact";
+import { addRegistryUrl } from "../lib/catalog";
 import { data } from "../lib/data";
+import {
+  mdiApple,
+  mdiConsole,
+  mdiMicrosoftVisualStudioCode,
+  mdiMicrosoftWindows,
+  mdiPenguin,
+} from "@mdi/js";
 
 const { config, packages } = data;
 
-// The "add this index" ergonomic (`helm repo add`): the command a visitor
-// needs to point their own grim at *this* index, plus the equivalent
-// hand-edit. Absent `registry` config means the index has no public URL to
-// hand out, so the block is omitted rather than guessed.
-const registryRows = config.registry
+// One-click counterpart of the `grim config registry add` line: the VS Code
+// extension registers a URI handler that writes the registry after a modal
+// confirmation. Null whenever the link would not work — see `addRegistryUrl`.
+const addRegistry = addRegistryUrl(config.vscodeExtension, config.registry);
+
+// The extension's own marketplace page — the one thing on this page that
+// helps a visitor who does not have it installed yet.
+const marketplace = config.vscodeExtension
+  ? `https://marketplace.visualstudio.com/items?itemName=${config.vscodeExtension}`
+  : null;
+
+// The "add this index" ergonomic (`helm repo add`): the one command a
+// visitor needs to point their own grim at *this* index. Absent `registry`
+// config means the index has no public URL to hand out, so the block is
+// omitted rather than guessed.
+const addCommand = config.registry
+  ? `grim config registry add ${config.registry.alias} --index ${config.registry.index}`
+  : null;
+
+// One installer row usually covers several platforms ("Linux / macOS"), and
+// the toggle reads better as the platforms themselves than as the config's
+// row labels — so a row expands into one button per platform it names, all
+// pointing at the same command. A row naming none (a custom label) keeps a
+// single generic button, so an unrecognized platform is never dropped.
+//
+// `mdiPenguin`, not `mdiLinux`: Tux's own silhouette is a solid mass that
+// reads as an indistinct blob at 16px, where the plainer penguin keeps its
+// outline. Still a brand mark from the same set, so it sits beside Apple
+// and Windows without a weight change.
+const PLATFORMS = [
+  { match: /linux/i, name: "Linux", path: mdiPenguin },
+  { match: /mac|darwin|osx|apple/i, name: "macOS", path: mdiApple },
+  { match: /win/i, name: "Windows", path: mdiMicrosoftWindows },
+];
+const installChoices = config.install.flatMap((row) => {
+  const hits = PLATFORMS.filter((p) => p.match.test(row.os));
+  return hits.length > 0
+    ? hits.map((p) => ({ name: p.name, path: p.path, command: row.command }))
+    : [{ name: row.os, path: mdiConsole, command: row.command }];
+});
+
+// Registry scope, the same two-way choice the package cards offer and drawn
+// with the same two Lucide glyphs. Global leads: someone arriving from an
+// index website wants this index available everywhere, not wired into
+// whichever directory happens to be open — and it is also the scope that
+// works with no project at all.
+// `--global` leads rather than trails: it is a top-level flag, and appended
+// after a long `--index <url>` it fell off the end of the line, so switching
+// scope looked like it changed nothing at all.
+const scopeChoices = addCommand
   ? [
-      {
-        os: "add index",
-        command: `grim config registry add ${config.registry.alias} --index ${config.registry.index}`,
-        block: false,
-        label: "Copy the registry add command",
-      },
-      {
-        os: "grimoire.toml",
-        command: `[[registries]]\nalias = "${config.registry.alias}"\nindex = "${config.registry.index}"`,
-        block: true,
-        label: "Copy the registries TOML entry",
-      },
+      { name: "Global", command: `grim --global ${addCommand.slice("grim ".length)}`, Icon: Globe },
+      { name: "Project", command: addCommand, Icon: FolderRoot },
     ]
   : [];
 ---
@@ -37,33 +83,95 @@ const registryRows = config.registry
         config.installDocsUrl && (
           <Fragment>
             {" "}
-            Copy an <code>add</code> command below — or{" "}
-            <a href={config.installDocsUrl}>install grim</a> first.
+            <a href={config.installDocsUrl}>Install grim</a>, add this index,
+            then <code>grim add</code> anything below.
           </Fragment>
         )
       }
     </p>
+    {/* Beside the description, not under it: getting set up is a sidebar to
+        reading what this index is. Two labelled rows of one shape — the
+        command, then the ways to act on it, inside a single border. */}
     {
-      (config.install.length > 0 || registryRows.length > 0) && (
-        <div class="install">
-          {config.install.map((row) => (
-            <div class="install-row">
-              <span class="os">{row.os}</span>
-              <code>{row.command}</code>
-              <CopyButton value={row.command} label={`Copy the ${row.os} install command`} />
-            </div>
-          ))}
-          {registryRows.map((row) => (
-            <div class="install-row">
-              <span class="os">{row.os}</span>
-              <code class:list={[{ block: row.block }]}>{row.command}</code>
-              <CopyButton value={row.command} label={row.label} />
-            </div>
-          ))}
+      (installChoices.length > 0 || addCommand || addRegistry) && (
+        <div class="hero-side">
+          {installChoices.length > 0 && (
+            <Fragment>
+              <span class="side-label">install grim</span>
+              <div class="cmd-bar" data-os-switch data-os-detect data-os-noun="install command">
+                {installChoices.length > 1 && (
+                  <PickerMenu
+                    choices={installChoices}
+                    title="Platform"
+                    label="Choose your platform"
+                  />
+                )}
+                <CommandField
+                  value={installChoices[0].command}
+                  name={`${installChoices[0].name} install command`}
+                  label="Copy the install command"
+                />
+                {marketplace && (
+                  <a
+                    class="seg brand-link"
+                    href={marketplace}
+                    target="_blank"
+                    rel="noopener noreferrer"
+                    title="Get the VS Code extension"
+                    aria-label="Get the VS Code extension from the marketplace"
+                  >
+                    <BrandMark path={mdiMicrosoftVisualStudioCode} />
+                  </a>
+                )}
+              </div>
+            </Fragment>
+          )}
+          {(addCommand || addRegistry) && (
+            <Fragment>
+              <span class="side-label">add registry</span>
+              <div class="cmd-bar" data-os-switch data-os-noun="registry add command">
+                {scopeChoices.length > 0 && (
+                  <PickerMenu choices={scopeChoices} title="Scope" label="Choose the scope" />
+                )}
+                {scopeChoices.length > 0 && (
+                  <CommandField
+                    value={scopeChoices[0].command}
+                    name={`${scopeChoices[0].name} registry add command`}
+                    label="Copy the registry add command"
+                  />
+                )}
+                {addRegistry && (
+                  <a
+                    class="seg brand-link"
+                    href={addRegistry}
+                    title="Add this index via VS Code"
+                    aria-label="Add this index via VS Code"
+                  >
+                    <BrandMark path={mdiMicrosoftVisualStudioCode} />
+                  </a>
+                )}
+              </div>
+            </Fragment>
+          )}
         </div>
       )
     }
   </div>
 
+  {/* Right after the bar, on purpose: the layout's picker script sits at the
+      end of the document, past the whole catalog, and the browser can paint
+      before it runs — long enough to show a Linux command to someone on
+      Windows. Here it lands in the same parse as the hero. A platform the
+      bar does not offer leaves the configured first choice alone. */}
+  <script is:inline>
+    for (const bar of document.querySelectorAll("[data-os-detect]")) {
+      const host = window.__grimHostOs();
+      const match = [...bar.querySelectorAll("[data-os-pick]")].find(
+        (p) => p.dataset.osName === host,
+      );
+      if (match) window.__grimPick(bar, match);
+    }
+  </script>
+
   <Catalog client:load packages={packages} vscodeExtension={config.vscodeExtension} />
 </Base>