@grimoire-rs/indexer 0.1.0

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

@@ -0,0 +1,69 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright 2026 The Grimoire Authors
+
+// Presentational helpers only — pure functions, safe to pull into the
+// client bundle. The build-time payload lives in `./data.ts`; the package
+// data itself is compiled by `src/data/` into `<outDir>/all.json`, so
+// nothing here walks the index tree.
+export type { CatalogPackage } from "../../types.js";
+
+// Publishing 0.10.0 also moves the rolling tags 0.10, 0 and latest, so the
+// full tag list is mostly history. Return just the current release's chain
+// (latest | 0 | 0.10 | 0.10.0). `tags` must already be sorted newest-first.
+export function versionCascade(version: string | undefined, tags: string[]): string[] {
+  const pinned = version ?? tags.find((t) => /^v?\d/.test(t));
+  // Split the raw string so a "v" prefix rides along into the rolling tags
+  // it was published under ("v1.2.3" -> "v1", "v1.2"), same as unprefixed.
+  const [major, minor] = (pinned ?? "").split(".");
+  const chain = [...new Set(["latest", major, `${major}.${minor}`, pinned])].filter(
+    (t): t is string => !!t && tags.includes(t),
+  );
+  // Tags nothing recognises as a version (["stable", "beta"]) yield no chain
+  // — front the newest few rather than an empty strip.
+  return chain.length > 0 ? chain : tags.slice(0, 4);
+}
+
+// Tags are published version strings (e.g. "v1.2.0"); sort latest first,
+// numeric-aware so "1.10.0" outranks "1.9.0".
+export function compareVersions(a: string, b: string): number {
+  const parts = (s: string) => s.replace(/^v/i, "").split(/[.-]/);
+  const pa = parts(a);
+  const pb = parts(b);
+  for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
+    const [na, nb] = [Number(pa[i]), Number(pb[i])];
+    if (!Number.isNaN(na) && !Number.isNaN(nb)) {
+      if (na !== nb) return nb - na;
+    } else if (pa[i] !== pb[i]) {
+      return (pb[i] ?? "").localeCompare(pa[i] ?? "");
+    }
+  }
+  return 0;
+}
+
+// MDN-standard Intl.RelativeTimeFormat rollup (no date library).
+const RTF = new Intl.RelativeTimeFormat("en", { numeric: "auto" });
+const TIME_DIVISIONS: [number, Intl.RelativeTimeFormatUnit][] = [
+  [60, "seconds"],
+  [60, "minutes"],
+  [24, "hours"],
+  [7, "days"],
+  [4.34524, "weeks"],
+  [12, "months"],
+  [Infinity, "years"],
+];
+
+export function timeAgo(iso: string): string {
+  const ms = new Date(iso).getTime();
+  if (!Number.isFinite(ms)) return ""; // unparseable: caller hides the element
+  let duration = (ms - Date.now()) / 1000;
+  for (const [amount, unit] of TIME_DIVISIONS) {
+    if (Math.abs(duration) < amount) return RTF.format(Math.round(duration), unit);
+    duration /= amount;
+  }
+  return RTF.format(Math.round(duration), "years");
+}
+
+/** `vscode://<publisher.extension>/open?repo=<ref>`, or null when disabled. */
+export function vscodeUrl(extension: string | null, ref: string): string | null {
+  return extension ? `vscode://${extension}/open?repo=${encodeURIComponent(ref)}` : null;
+}

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

@@ -0,0 +1,3 @@
+import type { GrimoireData } from "../../types.js";
+export declare const data: GrimoireData;
+//# sourceMappingURL=data.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"data.d.ts","sourceRoot":"","sources":["../../../../src/renderer/astro/lib/data.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAInD,eAAO,MAAM,IAAI,EAAE,YAAgC,CAAC"}

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

@@ -0,0 +1,4 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright 2026 The Grimoire Authors
+export const data = __GRIMOIRE_DATA__;
+//# sourceMappingURL=data.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"data.js","sourceRoot":"","sources":["../../../../src/renderer/astro/lib/data.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,sCAAsC;AAUtC,MAAM,CAAC,MAAM,IAAI,GAAiB,iBAAiB,CAAC"}

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

@@ -0,0 +1,12 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright 2026 The Grimoire Authors
+
+// The build-time bridge. `buildSite` replaces `__GRIMOIRE_DATA__` with a
+// JSON literal through Vite `define`, so this module is server-only by
+// construction — importing it from a hydrated island would inline the
+// whole catalog into the client bundle. Islands take what they need as props.
+import type { GrimoireData } from "../../types.js";
+
+declare const __GRIMOIRE_DATA__: GrimoireData;
+
+export const data: GrimoireData = __GRIMOIRE_DATA__;

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

@@ -0,0 +1,69 @@
+---
+import Base from "../layouts/Base.astro";
+import Catalog from "../components/Catalog.tsx";
+import CopyButton from "../components/CopyButton.astro";
+import { data } from "../lib/data";
+
+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
+  ? [
+      {
+        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",
+      },
+    ]
+  : [];
+---
+
+<Base title={config.brand} description={config.description}>
+  <div class="hero">
+    <h1>{config.brand}</h1>
+    <p>
+      {config.tagline}
+      {
+        config.installDocsUrl && (
+          <Fragment>
+            {" "}
+            Copy an <code>add</code> command below — or{" "}
+            <a href={config.installDocsUrl}>install grim</a> first.
+          </Fragment>
+        )
+      }
+    </p>
+    {
+      (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>
+          ))}
+        </div>
+      )
+    }
+  </div>
+
+  <Catalog client:load packages={packages} vscodeExtension={config.vscodeExtension} />
+</Base>

package/dist/renderer/astro/pages/p/[...slug].astro

@@ -0,0 +1,367 @@
+---
+// Frozen public URL: /p/<namespace>/<name>/. grim resolves against it, the
+// VS Code deep link points at it, and search engines index it — the route
+// shape is a contract, not an implementation detail.
+import Base from "../../layouts/Base.astro";
+import VersionMenu from "../../components/VersionMenu.astro";
+import CopyButton from "../../components/CopyButton.astro";
+import { compareVersions, versionCascade, vscodeUrl, type CatalogPackage } from "../../lib/catalog";
+import { data } from "../../lib/data";
+import { getEntry, render } from "astro:content";
+
+export function getStaticPaths() {
+  return data.packages.map((pkg) => ({
+    params: { slug: `${pkg.namespace}/${pkg.name}` },
+    props: { pkg },
+  }));
+}
+
+const { config } = data;
+const { pkg } = Astro.props as { pkg: CatalogPackage };
+const id = `${pkg.namespace}/${pkg.name}`;
+
+const readmeEntry = await getEntry("readmes", id);
+const changelogEntry = await getEntry("changelogs", id);
+const Readme = readmeEntry ? (await render(readmeEntry)).Content : null;
+const Changelog = changelogEntry ? (await render(changelogEntry)).Content : null;
+
+const tags = [...(pkg.tags ?? [])].sort(compareVersions);
+const cascade = versionCascade(pkg.version, tags);
+const older = tags.filter((t) => !cascade.includes(t));
+
+const title = pkg.title ?? pkg.name;
+const description = pkg.summary ?? pkg.description ?? `${pkg.kind} package: ${pkg.ref}`;
+const vscode = vscodeUrl(config.vscodeExtension, pkg.ref);
+const addCommand = `grim add ${pkg.ref}`;
+---
+
+<Base title={`${title} — ${config.brand}`} description={description} image={pkg.logo}>
+  <div class="detail">
+    <header class="detail-head">
+      {
+        pkg.logo ? (
+          <img class="tile logo" src={pkg.logo} alt="" />
+        ) : (
+          <div class="tile letter" style={`background: var(--kind-${pkg.kind}, var(--muted))`}>
+            {pkg.name[0]?.toUpperCase()}
+          </div>
+        )
+      }
+      <div class="detail-head-text">
+        <h1>
+          {pkg.name} <span class={`badge kind-${pkg.kind}`}>{pkg.kind}</span>
+        </h1>
+        {description && <p class="summary">{description}</p>}
+      </div>
+    </header>
+
+    {
+      pkg.deprecated && (
+        <p class="deprecated-banner">
+          ⚠️ deprecated{pkg.replacedBy ? ` — replaced by ${pkg.replacedBy}` : ""}
+        </p>
+      )
+    }
+
+    <div class="install-row">
+      <code>{addCommand}</code>
+      <CopyButton value={addCommand} label="Copy the install command" />
+    </div>
+
+    <div class="detail-body">
+      <main class="detail-main">
+        {Readme ? <Readme /> : <p class="empty">No README available.</p>}
+        {
+          Changelog && (
+            <details class="changelog">
+              <summary>Changelog</summary>
+              <Changelog />
+            </details>
+          )
+        }
+      </main>
+
+      <aside class="detail-rail">
+        {tags.length > 0 && (
+          <section>
+            <h2>Versions</h2>
+            <div class="cascade">
+              {cascade.map((tag) => (
+                <VersionMenu pkgRef={pkg.ref} tag={tag} current={tag === pkg.version} />
+              ))}
+            </div>
+            {older.length > 0 && (
+              <details class="older">
+                <summary>{older.length} older</summary>
+                <div class="cascade">
+                  {older.map((tag) => (
+                    <VersionMenu pkgRef={pkg.ref} tag={tag} />
+                  ))}
+                </div>
+              </details>
+            )}
+          </section>
+        )}
+
+        <section>
+          <h2>Details</h2>
+          <dl>
+            {pkg.license && (
+              <>
+                <dt>License</dt>
+                <dd>{pkg.license}</dd>
+              </>
+            )}
+            {pkg.repository && (
+              <>
+                <dt>Repository</dt>
+                <dd>
+                  <a href={pkg.repository} target="_blank" rel="noopener noreferrer">
+                    source
+                  </a>
+                </dd>
+              </>
+            )}
+            {pkg.owner?.github && (
+              <>
+                <dt>Owner</dt>
+                <dd>
+                  <a
+                    href={`https://github.com/${pkg.owner.github}`}
+                    target="_blank"
+                    rel="noopener noreferrer"
+                  >
+                    {pkg.owner.github}
+                  </a>
+                </dd>
+              </>
+            )}
+          </dl>
+          {pkg.keywords && pkg.keywords.length > 0 && (
+            <ul class="keywords">
+              {pkg.keywords.map((k) => (
+                <li>{k}</li>
+              ))}
+            </ul>
+          )}
+          {vscode && (
+            <a class="vscode-link" href={vscode}>
+              Open in VS Code
+            </a>
+          )}
+        </section>
+      </aside>
+    </div>
+  </div>
+</Base>
+
+<script>
+  // Right-click a version: open its command menu at the pointer. The menu is
+  // a `manual` popover (see VersionMenu.astro), so dismissal is ours.
+  // Copying itself rides the shared [data-copy] listener in Base.astro.
+  let openMenu: HTMLElement | null = null;
+  const closeMenu = () => {
+    openMenu?.hidePopover();
+    openMenu = null;
+  };
+  // A right-click fires no `click`, so this never eats the gesture that just
+  // opened the menu — but it does close on a command item, which is wanted.
+  document.addEventListener("click", closeMenu);
+  document.addEventListener("scroll", closeMenu, true);
+  document.addEventListener("keydown", (e) => {
+    if (e.key === "Escape") closeMenu();
+  });
+
+  for (const seg of document.querySelectorAll<HTMLElement>("[data-menu]")) {
+    const menu = document.getElementById(seg.dataset.menu ?? "");
+    if (!menu) continue;
+    seg.addEventListener("contextmenu", (e) => {
+      e.preventDefault();
+      closeMenu();
+      // The keyboard Menu key fires contextmenu at 0,0 — fall back to the
+      // segment itself so it doesn't land in the page corner.
+      const seat = seg.getBoundingClientRect();
+      menu.style.left = `${e.clientX || seat.left}px`;
+      menu.style.top = `${e.clientY || seat.bottom}px`;
+      menu.showPopover();
+      openMenu = menu;
+      // Nudge back inside once measured — the pointer can be within a menu's
+      // width of the right or bottom edge.
+      const box = menu.getBoundingClientRect();
+      if (box.right > innerWidth) menu.style.left = `${innerWidth - box.width - 8}px`;
+      if (box.bottom > innerHeight) menu.style.top = `${innerHeight - box.height - 8}px`;
+    });
+  }
+</script>
+
+<style>
+  .detail {
+    display: flex;
+    flex-direction: column;
+    gap: 1.25rem;
+  }
+  .detail-head {
+    display: flex;
+    align-items: center;
+    gap: 1rem;
+    background: var(--card);
+    border: 1px solid var(--border);
+    border-radius: 10px;
+    padding: 1rem 1.25rem;
+  }
+  .tile {
+    flex-shrink: 0;
+    width: 3.5rem;
+    height: 3.5rem;
+    border-radius: 10px;
+    object-fit: cover;
+  }
+  .tile.letter {
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    color: var(--on-accent);
+    font-size: 1.5rem;
+    font-weight: 700;
+    font-family: ui-monospace, "SFMono-Regular", monospace;
+  }
+  .detail-head-text h1 {
+    margin: 0;
+    display: flex;
+    align-items: center;
+    gap: 0.6rem;
+    font-size: 1.5rem;
+    font-family: ui-monospace, "SFMono-Regular", monospace;
+  }
+  .summary {
+    margin: 0.3rem 0 0;
+    color: var(--muted);
+  }
+  .deprecated-banner {
+    margin: 0;
+    background: var(--banner-bg);
+    color: var(--banner-fg);
+    border: 1px solid var(--banner-border);
+    border-radius: 8px;
+    padding: 0.6rem 0.9rem;
+    font-weight: 600;
+  }
+  .install-row {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    gap: 0.6rem;
+    background: var(--card);
+    border: 1px solid var(--border);
+    border-radius: 8px;
+    padding: 0.6rem 0.9rem;
+  }
+  .install-row code {
+    font-size: 0.9rem;
+    overflow-x: auto;
+  }
+  .detail-body {
+    display: grid;
+    grid-template-columns: 1fr 18rem;
+    gap: 2rem;
+    align-items: start;
+  }
+  @media (max-width: 55rem) {
+    .detail-body {
+      grid-template-columns: 1fr;
+    }
+  }
+  .detail-main {
+    min-width: 0;
+    background: var(--card);
+    border: 1px solid var(--border);
+    border-radius: 10px;
+    padding: 1.25rem 1.5rem;
+  }
+  .detail-main :global(img) {
+    max-width: 100%;
+  }
+  .detail-main :global(pre) {
+    overflow-x: auto;
+  }
+  .changelog {
+    margin-top: 1.5rem;
+    border-top: 1px solid var(--border);
+    padding-top: 1rem;
+  }
+  .changelog summary {
+    cursor: pointer;
+    font-weight: 600;
+  }
+  .detail-rail {
+    display: flex;
+    flex-direction: column;
+    gap: 1.25rem;
+  }
+  .detail-rail section {
+    background: var(--card);
+    border: 1px solid var(--border);
+    border-radius: 10px;
+    padding: 1rem;
+  }
+  .detail-rail h2 {
+    margin: 0 0 0.6rem;
+    font-size: 0.85rem;
+    text-transform: uppercase;
+    letter-spacing: 0.04em;
+    color: var(--muted);
+  }
+  /* Loose badges, both for the cascade and the older tags — VersionMenu owns
+     the pill itself, this only lays them out. */
+  .cascade {
+    display: flex;
+    flex-wrap: wrap;
+    gap: 0.3rem;
+  }
+  .older {
+    margin-top: 0.5rem;
+  }
+  .older[open] > summary {
+    margin-bottom: 0.5rem;
+  }
+  .older > summary {
+    cursor: pointer;
+    font-size: 0.8rem;
+    color: var(--muted);
+  }
+  .older > summary:hover {
+    color: var(--fg);
+  }
+  dl {
+    margin: 0;
+    display: grid;
+    grid-template-columns: auto 1fr;
+    gap: 0.3rem 0.6rem;
+  }
+  dt {
+    color: var(--muted);
+    font-size: 0.85rem;
+  }
+  dd {
+    margin: 0;
+  }
+  .keywords {
+    list-style: none;
+    margin: 0.75rem 0 0;
+    padding: 0;
+    display: flex;
+    flex-wrap: wrap;
+    gap: 0.35rem;
+  }
+  .keywords li {
+    background: var(--chip-bg);
+    border-radius: 999px;
+    padding: 0.15rem 0.6rem;
+    font-size: 0.78rem;
+  }
+  .vscode-link {
+    display: inline-block;
+    margin-top: 1rem;
+    font-size: 0.9rem;
+  }
+</style>

package/dist/renderer/index.d.ts

@@ -0,0 +1,20 @@
+import { type SiteConfig } from "../config.js";
+export interface BuildSiteOptions {
+    /** Index repo root. Astro's root; `enrich/` and `public/` resolve here. */
+    root: string;
+    /** Holds `all.json` on entry; holds the rendered site on return. */
+    outDir: string;
+    config: SiteConfig;
+}
+/** Thrown when `<outDir>/all.json` is missing or malformed. */
+export declare class RenderInputError extends Error {
+    constructor(message: string);
+}
+/** Astro `srcDir` — pages, layouts, components, content config. */
+export declare const ASTRO_SRC_DIR: string;
+/** Default `public/` layer; holds the fallback favicon. */
+export declare const DEFAULT_PUBLIC_DIR: string;
+/** Render the catalog site from `<outDir>/all.json` into `outDir`. */
+export declare function buildSite(opts: BuildSiteOptions): Promise<void>;
+export type { CatalogPackage, GrimoireData } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/renderer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/renderer/index.ts"],"names":[],"mappings":"AAWA,OAAO,EAAiB,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAG9D,MAAM,WAAW,gBAAgB;IAC/B,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,+DAA+D;AAC/D,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,OAAO,EAAE,MAAM;CAI5B;AA4BD,mEAAmE;AACnE,eAAO,MAAM,aAAa,QAA2B,CAAC;AACtD,2DAA2D;AAC3D,eAAO,MAAM,kBAAkB,QAA4B,CAAC;AAkH5D,sEAAsE;AACtE,wBAAsB,SAAS,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkCrE;AAED,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}