@grimoire-rs/indexer 0.4.4 → 0.5.0

package/dist/renderer/astro/components/CommandBar.astro

@@ -0,0 +1,66 @@
+---
+// One copyable command, optionally with a picker that swaps which command it
+// shows and a trailing action segment — the "install grim" and "add registry"
+// boxes on the landing page, and the "add this package" box on every detail
+// page. All three were the same twenty lines of markup written out three
+// times; this is that markup, once.
+//
+// It is also the component an index's own page most wants: a setup guide that
+// has to show `grim config registry add …` should draw the same bar the rest
+// of the site draws, not a code block that looks like one.
+//
+//   ---
+//   import CommandBar from "@grim/components/CommandBar.astro";
+//   import { installChoices } from "@grim/lib/commands";
+//   import { data } from "@grim/lib/data";
+//   ---
+//   <CommandBar choices={installChoices(data.config)} noun="install command"
+//               copyLabel="Copy the install command" pickerTitle="Platform"
+//               pickerLabel="Choose your platform" detect />
+//
+// The picker's behaviour — which glyph shows, what the field copies, what the
+// toast calls it — is the generic `[data-os-switch]` handler in `Base.astro`.
+// Nothing here ships a script.
+import PickerMenu from "./PickerMenu.astro";
+import CommandField from "./CommandField.astro";
+import type { Choice } from "../lib/commands";
+
+interface Props {
+  /**
+   * The commands this bar offers. One renders as a bare field; more than one
+   * adds the picker. **Empty is legal** — a bar can be nothing but its action
+   * segment, which is what the landing page shows when an index publishes a
+   * VS Code deep link but no copyable registry command.
+   */
+  choices: Choice[];
+  /**
+   * What the copy toast calls this, minus the choice's own name: `"install
+   * command"` becomes `"Linux install command"`. The picker rewrites it per
+   * pick, so it has to read as a noun phrase after any choice name.
+   */
+  noun: string;
+  /** Accessible name for the field, e.g. `"Copy the install command"`. */
+  copyLabel: string;
+  /** Picker tooltip, e.g. `"Platform"`. Unused with fewer than two choices. */
+  pickerTitle?: string;
+  /** Picker accessible name, e.g. `"Choose your platform"`. */
+  pickerLabel?: string;
+  /**
+   * Preselect the visitor's own platform before first paint. Only meaningful
+   * where the choices ARE platforms — see the inline script in `index.astro`,
+   * which is what reads this.
+   */
+  detect?: boolean;
+}
+const { choices, noun, copyLabel, pickerTitle = "", pickerLabel = "", detect = false } = Astro.props;
+const first = choices[0];
+---
+
+<div class="cmd-bar" data-os-switch data-os-detect={detect ? "" : undefined} data-os-noun={noun}>
+  {choices.length > 1 && <PickerMenu choices={choices} title={pickerTitle} label={pickerLabel} />}
+  {first && <CommandField value={first.command} name={`${first.name} ${noun}`} label={copyLabel} />}
+  {/* The trailing segment: a VS Code deep link on all three shipped bars, and
+      whatever an index's own page puts there. A slot rather than props, so
+      adding a second kind of action needs no change here. */}
+  <slot name="action" />
+</div>

package/dist/renderer/astro/components/CopyButton.d.ts

@@ -0,0 +1,7 @@
+export declare function CopyButton({ command, variant, name, }: {
+    command: string;
+    variant?: "default" | "global";
+    /** What the copy toast calls this, e.g. `"global install command"`. */
+    name?: string;
+}): import("preact").JSX.Element;
+//# sourceMappingURL=CopyButton.d.ts.map

package/dist/renderer/astro/components/CopyButton.js

@@ -0,0 +1,28 @@
+import { jsx as _jsx } from "preact/jsx-runtime";
+// SPDX-License-Identifier: Apache-2.0
+// Copyright 2026 The Grimoire Authors
+// The copy-to-clipboard button a card wears under its install commands.
+// Split out of `Catalog.tsx` with the card itself, so an index replacing
+// `PackageCard.tsx` still gets the toast behaviour rather than reimplementing
+// the custom event `Base.astro` listens for.
+import { useState } from "preact/hooks";
+import { Check, FolderRoot, Globe } from "lucide-preact";
+export function CopyButton({ command, variant = "default", name, }) {
+    const [copied, setCopied] = useState(false);
+    const copy = () => {
+        navigator.clipboard.writeText(command).then(() => {
+            setCopied(true);
+            // The toast lives in Base.astro's inline script, outside this island —
+            // an event is how a hydrated component reaches it without either side
+            // importing the other.
+            document.dispatchEvent(new CustomEvent("grimoire:copied", {
+                detail: { name, value: command },
+            }));
+            setTimeout(() => setCopied(false), 1500);
+        });
+    };
+    return (_jsx("button", { type: "button", class: copied ? "copy copied" : "copy", title: command, "aria-label": `Copy: ${command}`, 
+        // Out of the Tab sequence: the card is the stop, and the same command
+        // is copyable from the detail page Enter opens.
+        tabIndex: -1, onClick: copy, children: copied ? (_jsx(Check, { size: 14 })) : variant === "global" ? (_jsx(Globe, { size: 14 })) : (_jsx(FolderRoot, { size: 14 })) }));
+}

package/dist/renderer/astro/components/CopyButton.tsx

@@ -0,0 +1,56 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright 2026 The Grimoire Authors
+
+// The copy-to-clipboard button a card wears under its install commands.
+// Split out of `Catalog.tsx` with the card itself, so an index replacing
+// `PackageCard.tsx` still gets the toast behaviour rather than reimplementing
+// the custom event `Base.astro` listens for.
+import { useState } from "preact/hooks";
+import { Check, FolderRoot, Globe } from "lucide-preact";
+
+export function CopyButton({
+  command,
+  variant = "default",
+  name,
+}: {
+  command: string;
+  variant?: "default" | "global";
+  /** What the copy toast calls this, e.g. `"global install command"`. */
+  name?: string;
+}) {
+  const [copied, setCopied] = useState(false);
+  const copy = () => {
+    navigator.clipboard.writeText(command).then(() => {
+      setCopied(true);
+      // The toast lives in Base.astro's inline script, outside this island —
+      // an event is how a hydrated component reaches it without either side
+      // importing the other.
+      document.dispatchEvent(
+        new CustomEvent("grimoire:copied", {
+          detail: { name, value: command },
+        }),
+      );
+      setTimeout(() => setCopied(false), 1500);
+    });
+  };
+  return (
+    <button
+      type="button"
+      class={copied ? "copy copied" : "copy"}
+      title={command}
+      aria-label={`Copy: ${command}`}
+      // Out of the Tab sequence: the card is the stop, and the same command
+      // is copyable from the detail page Enter opens.
+      tabIndex={-1}
+      onClick={copy}
+    >
+      {copied ? (
+        <Check size={14} />
+      ) : variant === "global" ? (
+        <Globe size={14} />
+      ) : (
+        <FolderRoot size={14} />
+      )}
+    </button>
+  );
+}

package/dist/renderer/astro/components/KindMark.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Artifact-kind marks, drawn from Microsoft's codicons.
+ *
+ * These are the *same glyphs* the Grimoire VS Code extension puts on its own
+ * cards — its `KIND_ICONS` maps skill/rule/agent/mcp/bundle to
+ * sparkle/law/agent/mcp/package. The two surfaces show one catalogue, so an
+ * artifact wearing a different mark in each was the thing to fix; a Lucide
+ * look-alike per kind is close, not the same.
+ *
+ * The extension consumes codicons as a webfont. This site ships no icon font
+ * and never will — a 120 KB TTF for five glyphs — so the path data is inlined
+ * here, exactly as `BrandMark` inlines `@mdi/js` paths. `@vscode/codicons` is
+ * a devDependency purely for provenance: it pins the version these came from,
+ * so re-extracting them later is reproducible rather than archaeology.
+ *
+ * ---------------------------------------------------------------------------
+ * Path data below is from @vscode/codicons 0.0.45, © Microsoft Corporation,
+ * licensed CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/).
+ * Source: https://github.com/microsoft/vscode-codicons
+ * Unmodified apart from extraction from the per-icon SVG files.
+ * ---------------------------------------------------------------------------
+ */
+interface GlyphPath {
+    d: string;
+    /** codicons draw a few marks as one path with holes. */
+    evenOdd?: boolean;
+}
+interface Glyph {
+    /**
+     * The glyph's own square box — `[x, y, side]` — used as the viewBox in
+     * place of the shared `0 0 16 16`.
+     *
+     * Codicons are drawn to sit correctly at 16px in a row of text, not to
+     * fill their grid, and how much of it each uses varies a lot: `sparkle`
+     * spans 12 units, `mcp` spans 16.3. Rendered at one `size` on the shared
+     * box that is a third again in apparent size between the smallest mark and
+     * the largest — which is exactly what a wall of cards looked like.
+     * Framing each glyph on its own bounding box makes them all render to the
+     * same square.
+     *
+     * Measured from the path coordinates, so a curve's control points can push
+     * the box slightly wider than the ink actually goes. That errs toward a
+     * hair of extra margin rather than a clipped glyph, which is the safe
+     * direction to be wrong in.
+     */
+    box: [number, number, number];
+    paths: GlyphPath[];
+}
+/**
+ * Which mark each artifact kind wears. An unknown kind gets none rather than
+ * a stand-in: a wrong glyph on a future kind reads as a claim, and no glyph
+ * reads as what it is.
+ */
+export declare const KIND_MARKS: Record<string, Glyph>;
+/** What a retired artifact wears instead of its kind. */
+export declare const DEPRECATED_MARK: Glyph;
+/**
+ * One codicon, filled with `currentColor`, framed on its own box.
+ *
+ * Filled rather than stroked, which is what makes it usable at watermark
+ * scale: a stroked glyph's overlapping paths composite twice wherever they
+ * cross, so a translucent one comes out blotchy along its own joins.
+ */
+export declare function KindMark({ glyph, size, ...rest }: {
+    glyph: Glyph;
+    size?: number;
+} & Record<string, unknown>): import("preact").JSX.Element;
+export {};
+//# sourceMappingURL=KindMark.d.ts.map

package/dist/renderer/astro/components/KindMark.js

@@ -0,0 +1,66 @@
+import { jsx as _jsx } from "preact/jsx-runtime";
+const CODICONS = {
+    sparkle: {
+        box: [1.64, 1.64, 12.73],
+        paths: [
+            { d: "M5.46524 9.82962C5.62134 9.94037 5.80806 9.99974 5.99946 9.99948C6.19151 10.0003 6.37897 9.94082 6.53546 9.82948C6.69223 9.71378 6.81095 9.55398 6.87646 9.37048L7.22346 8.30348C7.3077 8.05191 7.44906 7.82327 7.63646 7.63548C7.82305 7.44851 8.05078 7.30776 8.30146 7.22448L9.38746 6.87148C9.56665 6.80759 9.72173 6.68989 9.83146 6.53448C9.94145 6.37908 10.0005 6.19337 10.0005 6.00298C10.0005 5.81259 9.94145 5.62689 9.83146 5.47148C9.71293 5.30613 9.54426 5.18339 9.35046 5.12148L8.28146 4.77548C8.02989 4.69238 7.80123 4.55163 7.61371 4.36447C7.4262 4.1773 7.28503 3.9489 7.20146 3.69748L6.84846 2.61348C6.78519 2.43423 6.66777 2.27908 6.51246 2.16948C6.35557 2.06133 6.16951 2.00342 5.97896 2.00342C5.78841 2.00342 5.60235 2.06133 5.44546 2.16948C5.28572 2.28196 5.16594 2.44237 5.10346 2.62748L4.74846 3.71748C4.66476 3.96155 4.52691 4.18351 4.34524 4.36673C4.16358 4.54996 3.9428 4.6897 3.69946 4.77548L2.61546 5.12648C2.43437 5.19048 2.27775 5.30937 2.16743 5.4666C2.05712 5.62383 1.99859 5.81155 2.00003 6.00361C2.00146 6.19568 2.06277 6.38251 2.17541 6.53808C2.28806 6.69364 2.44643 6.81019 2.62846 6.87148L3.69546 7.21848C3.94767 7.30297 4.17673 7.44506 4.36446 7.63348C4.41519 7.6837 4.46262 7.73715 4.50646 7.79348C4.62481 7.94615 4.71614 8.11797 4.77646 8.30148L5.12846 9.38148C5.19143 9.56222 5.30914 9.71886 5.46524 9.82962ZM4.00746 6.26448L3.15246 5.99948L4.01646 5.71848C4.41071 5.58184 4.76826 5.35637 5.06146 5.05948C5.35281 4.76039 5.57294 4.39943 5.70546 4.00348L5.97046 3.14448L6.25046 4.00648C6.38349 4.40638 6.60809 4.76969 6.90636 5.06744C7.20463 5.36519 7.56833 5.58915 7.96846 5.72148L8.84846 5.99048L7.98746 6.27048C7.58707 6.40272 7.22321 6.62691 6.92505 6.92507C6.62689 7.22324 6.4027 7.58709 6.27046 7.98748L6.00546 8.84448L5.72646 7.98548C5.63026 7.69329 5.48483 7.41968 5.29646 7.17648C5.22699 7.08766 5.15254 7.00286 5.07346 6.92248C4.7738 6.62366 4.4089 6.39842 4.00746 6.26448ZM10.5344 13.8515C10.6703 13.9477 10.8328 13.9994 10.9994 13.9995C11.1642 13.998 11.3245 13.9456 11.4584 13.8495C11.5979 13.751 11.7029 13.611 11.7584 13.4495L12.0064 12.6875C12.0595 12.529 12.1485 12.385 12.2664 12.2665C12.3837 12.148 12.5277 12.0592 12.6864 12.0075L13.4584 11.7555C13.6161 11.701 13.7528 11.5985 13.8494 11.4625C13.9227 11.3595 13.9706 11.2405 13.9891 11.1154C14.0076 10.9903 13.9962 10.8626 13.9558 10.7428C13.9154 10.623 13.8472 10.5144 13.7567 10.4261C13.6662 10.3377 13.5561 10.272 13.4354 10.2345L12.6714 9.98548C12.5132 9.93291 12.3695 9.8443 12.2514 9.72663C12.1334 9.60896 12.0444 9.46547 11.9914 9.30748L11.7394 8.53348C11.685 8.37623 11.5825 8.24011 11.4464 8.14448C11.3443 8.07153 11.2266 8.02359 11.1026 8.00453C10.9787 7.98547 10.8519 7.99582 10.7327 8.03475C10.6135 8.07369 10.5051 8.1401 10.4163 8.22865C10.3274 8.31719 10.2607 8.42538 10.2214 8.54448L9.97435 9.30648C9.92207 9.46413 9.83452 9.60777 9.71835 9.72648C9.60382 9.84272 9.46428 9.9313 9.31035 9.98548L8.53435 10.2385C8.41689 10.2793 8.31057 10.347 8.22382 10.4361C8.13708 10.5252 8.0723 10.6333 8.03464 10.7518C7.99698 10.8704 7.98746 10.996 8.00686 11.1189C8.02625 11.2417 8.07401 11.3583 8.14635 11.4595C8.24456 11.5993 8.38462 11.7044 8.54635 11.7595L9.30935 12.0065C9.46821 12.0599 9.61262 12.1492 9.73135 12.2675C9.84958 12.3857 9.93801 12.5304 9.98935 12.6895L10.2424 13.4635C10.2971 13.6199 10.3992 13.7555 10.5344 13.8515ZM9.62035 11.0585L9.44235 10.9995L9.62635 10.9355C9.92811 10.8305 10.2018 10.6578 10.4264 10.4305C10.6528 10.2015 10.8238 9.92374 10.9264 9.61848L10.9844 9.44048L11.0434 9.62148C11.1453 9.92819 11.3175 10.2069 11.5461 10.4353C11.7748 10.6638 12.0536 10.8357 12.3604 10.9375L12.5554 11.0005L12.3754 11.0595C12.068 11.1617 11.7888 11.3344 11.5601 11.5637C11.3314 11.7931 11.1596 12.0728 11.0584 12.3805L10.9994 12.5615L10.9414 12.3805C10.84 12.0721 10.6676 11.7919 10.4382 11.5623C10.2088 11.3326 9.92863 11.1601 9.62035 11.0585Z" },
+        ],
+    },
+    law: {
+        box: [1.61, 1.36, 13.78],
+        paths: [
+            { d: "M10.039 7.30702L10.036 7.31402C10.036 7.31402 10.033 7.32202 10.032 7.32602C10.028 7.33602 10.024 7.34702 10.021 7.35702C10.02 7.36102 10.019 7.36502 10.018 7.36902C10.015 7.38002 10.012 7.39202 10.01 7.40402C10.009 7.40902 10.008 7.41502 10.007 7.42102C10.005 7.43102 10.004 7.44102 10.003 7.45102C10.001 7.46702 10.001 7.48302 10.001 7.50002C10.001 8.87802 11.123 10 12.501 10C13.879 10 15.001 8.87802 15.001 7.50002C15.001 7.48402 15.001 7.46702 14.999 7.45102C14.998 7.44102 14.996 7.43102 14.995 7.42102C14.995 7.41502 14.994 7.41002 14.992 7.40402C14.99 7.39202 14.987 7.38102 14.984 7.36902C14.983 7.36502 14.982 7.36102 14.981 7.35702C14.978 7.34602 14.974 7.33602 14.97 7.32602C14.969 7.32202 14.967 7.31802 14.966 7.31402L14.963 7.30702C14.963 7.30702 14.963 7.30502 14.963 7.30402L13.241 2.99902H14.002C14.278 2.99902 14.502 2.77502 14.502 2.49902C14.502 2.22302 14.278 1.99902 14.002 1.99902H2.99998C2.72398 1.99902 2.49998 2.22302 2.49998 2.49902C2.49998 2.77502 2.72398 2.99902 2.99998 2.99902H3.76098L2.03898 7.30402C2.03898 7.30402 2.03898 7.30602 2.03898 7.30702L2.03598 7.31402C2.03598 7.31402 2.03298 7.32202 2.03198 7.32602C2.02798 7.33602 2.02398 7.34702 2.02098 7.35702C2.01998 7.36102 2.01898 7.36502 2.01798 7.36902C2.01498 7.38002 2.01198 7.39202 2.00998 7.40402C2.00898 7.40902 2.00798 7.41502 2.00698 7.42102C2.00498 7.43102 2.00398 7.44102 2.00298 7.45102C2.00098 7.46702 2.00098 7.48302 2.00098 7.50002C2.00098 8.87802 3.12298 10 4.50098 10C5.87898 10 7.00098 8.87802 7.00098 7.50002C7.00098 7.48402 7.00098 7.46702 6.99898 7.45102C6.99798 7.44102 6.99598 7.43102 6.99498 7.42102C6.99498 7.41502 6.99398 7.41002 6.99198 7.40402C6.98998 7.39202 6.98698 7.38102 6.98398 7.36902C6.98298 7.36502 6.98198 7.36102 6.98098 7.35702C6.97798 7.34602 6.97398 7.33602 6.96998 7.32602C6.96898 7.32202 6.96698 7.31802 6.96598 7.31402L6.96298 7.30702C6.96298 7.30702 6.96298 7.30502 6.96298 7.30402L5.24098 2.99902H8.00198V10.999H5.50198C4.67498 10.999 4.00198 11.672 4.00198 12.499C4.00198 13.326 4.67498 13.999 5.50198 13.999H11.502C12.329 13.999 13.002 13.326 13.002 12.499C13.002 11.672 12.329 10.999 11.502 10.999H9.00198V3.00002H11.763L10.041 7.30502C10.041 7.30502 10.041 7.30702 10.041 7.30802L10.039 7.30702ZM4.49998 3.84602L5.76198 7.00002H3.23898L4.49998 3.84602ZM4.49998 9.00002C3.84798 9.00002 3.29198 8.58202 3.08598 8.00002H5.91398C5.70698 8.58202 5.15198 9.00002 4.49998 9.00002ZM12 12.5C12 12.775 11.776 13 11.5 13H5.49998C5.22398 13 4.99998 12.775 4.99998 12.5C4.99998 12.225 5.22398 12 5.49998 12H11.5C11.776 12 12 12.225 12 12.5ZM12.5 9.00002C11.848 9.00002 11.292 8.58202 11.086 8.00002H13.914C13.707 8.58202 13.152 9.00002 12.5 9.00002ZM11.238 7.00002L12.5 3.84602L13.762 7.00002H11.239H11.238Z" },
+        ],
+    },
+    agent: {
+        box: [-0.33, -0.33, 16.67],
+        paths: [
+            { d: "M10.887 15H8.49998C8.22398 15 7.99998 14.776 7.99998 14.5C7.99998 14.224 8.22398 14 8.49998 14H10.887C11.243 14 11.575 13.809 11.752 13.5L14.64 8.5C14.819 8.191 14.819 7.809 14.64 7.5L11.705 2.416C11.557 2.16 11.28 2 10.983 2C10.616 2 10.296 2.236 10.188 2.587L6.76598 13.707C6.52898 14.48 5.82498 15 5.01598 15C4.36398 15 3.75498 14.649 3.42898 14.084L0.494984 9C0.137984 8.383 0.137984 7.617 0.494984 7L3.38198 2C3.73698 1.383 4.40098 1 5.11298 1H7.49998C7.77598 1 7.99998 1.224 7.99998 1.5C7.99998 1.776 7.77598 2 7.49998 2H5.11298C4.75698 2 4.42498 2.191 4.24798 2.5L1.35998 7.5C1.18098 7.809 1.18098 8.191 1.35998 8.5L4.29498 13.584C4.44298 13.841 4.71998 14 5.01698 14C5.38398 14 5.70398 13.764 5.81198 13.412L9.23398 2.293C9.47098 1.52 10.174 1 10.984 1C11.636 1 12.245 1.351 12.571 1.916L15.506 7C15.863 7.617 15.863 8.383 15.506 9.001L12.619 14C12.264 14.617 11.599 15 10.887 15Z" },
+        ],
+    },
+    mcp: {
+        box: [-0.54, -0.76, 17.31],
+        paths: [
+            { d: "M14.5565 7.87462C14.5385 7.89312 14.5205 7.91112 14.5025 7.92862L8.69849 13.6201C8.62599 13.6906 8.62449 13.8061 8.69499 13.8786C8.69599 13.8801 8.69749 13.8811 8.69849 13.8821L9.89049 15.0516C10.1075 15.2626 10.1125 15.6101 9.90149 15.8276C9.89799 15.8311 9.89449 15.8351 9.89049 15.8386C9.66699 16.0556 9.31199 16.0556 9.08849 15.8386L7.89649 14.6701C7.38949 14.1776 7.37799 13.3671 7.87049 12.8601C7.87899 12.8511 7.88749 12.8426 7.89649 12.8341L13.7005 7.14212C14.352 6.50762 14.3665 5.46512 13.732 4.81362C13.7215 4.80312 13.711 4.79262 13.7005 4.78212L13.667 4.74962C12.998 4.09862 11.9325 4.09762 11.2625 4.74762L6.48099 9.43712L6.47949 9.43862L6.41399 9.50312C6.19049 9.72062 5.83449 9.72062 5.61149 9.50312C5.39449 9.29162 5.38949 8.94462 5.60049 8.72712C5.60399 8.72362 5.60749 8.71962 5.61149 8.71612L10.46 3.96062C11.1105 3.32512 11.123 2.28262 10.4875 1.63212C10.478 1.62212 10.468 1.61262 10.458 1.60262C9.78799 0.950619 8.72099 0.950619 8.05149 1.60262L1.63499 7.89512C1.41149 8.11212 1.05649 8.11212 0.832987 7.89512C0.615987 7.68412 0.610987 7.33662 0.821987 7.11912C0.825487 7.11562 0.828987 7.11162 0.832987 7.10812L7.24999 0.815119C8.36599 -0.271381 10.1445 -0.271381 11.2605 0.815119C11.8905 1.42762 12.189 2.30512 12.063 3.17512C12.9435 3.05012 13.8325 3.34062 14.469 3.96162L14.5025 3.99512C15.5885 5.05162 15.613 6.78812 14.5565 7.87412V7.87462ZM12.8655 6.32212C13.083 6.11062 13.0875 5.76362 12.8765 5.54612C12.873 5.54262 12.8695 5.53862 12.8655 5.53512C12.642 5.31762 12.286 5.31762 12.063 5.53512L7.31699 10.1896C6.64699 10.8416 5.57999 10.8416 4.91049 10.1896C4.25899 9.55512 4.24449 8.51262 4.87899 7.86112C4.88949 7.85062 4.89999 7.84012 4.91049 7.82962L9.65699 3.17512C9.87399 2.96362 9.87899 2.61662 9.66799 2.39912C9.66449 2.39562 9.66099 2.39162 9.65699 2.38812C9.43349 2.17062 9.07749 2.17062 8.85449 2.38812L4.10849 7.04262C3.02249 8.09912 2.99799 9.83562 4.05449 10.9216C4.07249 10.9401 4.09049 10.9581 4.10849 10.9756C5.22499 12.0616 7.00299 12.0616 8.11899 10.9756L12.8655 6.32112V6.32212Z", evenOdd: true },
+        ],
+    },
+    package: {
+        box: [0.58, 0.58, 14.84],
+        paths: [
+            { d: "M6 8.63998C5.934 8.63998 5.867 8.62698 5.803 8.59898L3.303 7.52898C3.049 7.42098 2.931 7.12698 3.04 6.87298C3.149 6.61998 3.444 6.50098 3.696 6.60998L6.196 7.67998C6.45 7.78798 6.568 8.08198 6.459 8.33598C6.378 8.52498 6.193 8.63898 6 8.63898V8.63998Z" },
+            { d: "M4.80397 10.17C4.86797 10.197 4.93397 10.21 4.99997 10.21C5.19397 10.21 5.37897 10.096 5.45997 9.90599C5.56797 9.65199 5.44997 9.35799 5.19597 9.24999L3.69597 8.60999C3.44397 8.50199 3.14797 8.61999 3.03997 8.87399C2.93197 9.12799 3.04997 9.42199 3.30397 9.52999L4.80397 10.17Z" },
+            { d: "M14.039 3.28598L9.077 1.37798C8.384 1.11098 7.616 1.11098 6.923 1.37798L1.962 3.28598C1.383 3.50898 1 4.06498 1 4.68598V11.312C1 11.933 1.382 12.489 1.962 12.712L6.923 14.62C7.616 14.887 8.384 14.887 9.077 14.62L14.039 12.712C14.618 12.489 15 11.933 15 11.312V4.68598C15 4.06498 14.618 3.50898 14.039 3.28598ZM7.5 13.757C7.426 13.738 7.354 13.715 7.282 13.687L2.32 11.779C2.127 11.705 2 11.519 2 11.312V4.97098L7.5 7.32798V13.757ZM2.564 4.12598L7.282 2.31098C7.744 2.13298 8.256 2.13298 8.718 2.31098L13.436 4.12598L8 6.45598L2.564 4.12598ZM14 11.313C14 11.52 13.873 11.705 13.68 11.78L8.718 13.688C8.646 13.716 8.574 13.739 8.5 13.758V7.32998L14 4.97298V11.313Z", evenOdd: true },
+        ],
+    },
+    warning: {
+        box: [0.5, 0.58, 14.84],
+        paths: [
+            { d: "M14.831 11.965L9.206 1.714C8.965 1.274 8.503 1 8 1C7.497 1 7.035 1.274 6.794 1.714L1.169 11.965C1.059 12.167 1 12.395 1 12.625C1 13.383 1.617 14 2.375 14H13.625C14.383 14 15 13.383 15 12.625C15 12.395 14.941 12.167 14.831 11.965ZM13.625 13H2.375C2.168 13 2 12.832 2 12.625C2 12.561 2.016 12.5 2.046 12.445L7.671 2.195C7.736 2.075 7.863 2 8 2C8.137 2 8.264 2.075 8.329 2.195L13.954 12.445C13.984 12.501 14 12.561 14 12.625C14 12.832 13.832 13 13.625 13ZM8.75 11.25C8.75 11.664 8.414 12 8 12C7.586 12 7.25 11.664 7.25 11.25C7.25 10.836 7.586 10.5 8 10.5C8.414 10.5 8.75 10.836 8.75 11.25ZM7.5 9V5.5C7.5 5.224 7.724 5 8 5C8.276 5 8.5 5.224 8.5 5.5V9C8.5 9.276 8.276 9.5 8 9.5C7.724 9.5 7.5 9.276 7.5 9Z" },
+        ],
+    },
+};
+/**
+ * Which mark each artifact kind wears. An unknown kind gets none rather than
+ * a stand-in: a wrong glyph on a future kind reads as a claim, and no glyph
+ * reads as what it is.
+ */
+export const KIND_MARKS = {
+    skill: CODICONS.sparkle,
+    rule: CODICONS.law,
+    agent: CODICONS.agent,
+    mcp: CODICONS.mcp,
+    bundle: CODICONS.package,
+};
+/** What a retired artifact wears instead of its kind. */
+export const DEPRECATED_MARK = CODICONS.warning;
+/**
+ * One codicon, filled with `currentColor`, framed on its own box.
+ *
+ * Filled rather than stroked, which is what makes it usable at watermark
+ * scale: a stroked glyph's overlapping paths composite twice wherever they
+ * cross, so a translucent one comes out blotchy along its own joins.
+ */
+export function KindMark({ glyph, size = 16, ...rest }) {
+    const [x, y, side] = glyph.box;
+    return (_jsx("svg", { viewBox: `${x} ${y} ${side} ${side}`, width: size, height: size, ...rest, children: glyph.paths.map((p) => (_jsx("path", { d: p.d, fill: "currentColor", "fill-rule": p.evenOdd ? "evenodd" : undefined, "clip-rule": p.evenOdd ? "evenodd" : undefined }, p.d))) }));
+}

package/dist/renderer/astro/components/KindMark.tsx

@@ -0,0 +1,141 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright 2026 The Grimoire Authors
+
+/**
+ * Artifact-kind marks, drawn from Microsoft's codicons.
+ *
+ * These are the *same glyphs* the Grimoire VS Code extension puts on its own
+ * cards — its `KIND_ICONS` maps skill/rule/agent/mcp/bundle to
+ * sparkle/law/agent/mcp/package. The two surfaces show one catalogue, so an
+ * artifact wearing a different mark in each was the thing to fix; a Lucide
+ * look-alike per kind is close, not the same.
+ *
+ * The extension consumes codicons as a webfont. This site ships no icon font
+ * and never will — a 120 KB TTF for five glyphs — so the path data is inlined
+ * here, exactly as `BrandMark` inlines `@mdi/js` paths. `@vscode/codicons` is
+ * a devDependency purely for provenance: it pins the version these came from,
+ * so re-extracting them later is reproducible rather than archaeology.
+ *
+ * ---------------------------------------------------------------------------
+ * Path data below is from @vscode/codicons 0.0.45, © Microsoft Corporation,
+ * licensed CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/).
+ * Source: https://github.com/microsoft/vscode-codicons
+ * Unmodified apart from extraction from the per-icon SVG files.
+ * ---------------------------------------------------------------------------
+ */
+
+interface GlyphPath {
+  d: string;
+  /** codicons draw a few marks as one path with holes. */
+  evenOdd?: boolean;
+}
+
+interface Glyph {
+  /**
+   * The glyph's own square box — `[x, y, side]` — used as the viewBox in
+   * place of the shared `0 0 16 16`.
+   *
+   * Codicons are drawn to sit correctly at 16px in a row of text, not to
+   * fill their grid, and how much of it each uses varies a lot: `sparkle`
+   * spans 12 units, `mcp` spans 16.3. Rendered at one `size` on the shared
+   * box that is a third again in apparent size between the smallest mark and
+   * the largest — which is exactly what a wall of cards looked like.
+   * Framing each glyph on its own bounding box makes them all render to the
+   * same square.
+   *
+   * Measured from the path coordinates, so a curve's control points can push
+   * the box slightly wider than the ink actually goes. That errs toward a
+   * hair of extra margin rather than a clipped glyph, which is the safe
+   * direction to be wrong in.
+   */
+  box: [number, number, number];
+  paths: GlyphPath[];
+}
+
+const CODICONS: Record<string, Glyph> = {
+  sparkle: {
+    box: [1.64, 1.64, 12.73],
+    paths: [
+      { d: "M5.46524 9.82962C5.62134 9.94037 5.80806 9.99974 5.99946 9.99948C6.19151 10.0003 6.37897 9.94082 6.53546 9.82948C6.69223 9.71378 6.81095 9.55398 6.87646 9.37048L7.22346 8.30348C7.3077 8.05191 7.44906 7.82327 7.63646 7.63548C7.82305 7.44851 8.05078 7.30776 8.30146 7.22448L9.38746 6.87148C9.56665 6.80759 9.72173 6.68989 9.83146 6.53448C9.94145 6.37908 10.0005 6.19337 10.0005 6.00298C10.0005 5.81259 9.94145 5.62689 9.83146 5.47148C9.71293 5.30613 9.54426 5.18339 9.35046 5.12148L8.28146 4.77548C8.02989 4.69238 7.80123 4.55163 7.61371 4.36447C7.4262 4.1773 7.28503 3.9489 7.20146 3.69748L6.84846 2.61348C6.78519 2.43423 6.66777 2.27908 6.51246 2.16948C6.35557 2.06133 6.16951 2.00342 5.97896 2.00342C5.78841 2.00342 5.60235 2.06133 5.44546 2.16948C5.28572 2.28196 5.16594 2.44237 5.10346 2.62748L4.74846 3.71748C4.66476 3.96155 4.52691 4.18351 4.34524 4.36673C4.16358 4.54996 3.9428 4.6897 3.69946 4.77548L2.61546 5.12648C2.43437 5.19048 2.27775 5.30937 2.16743 5.4666C2.05712 5.62383 1.99859 5.81155 2.00003 6.00361C2.00146 6.19568 2.06277 6.38251 2.17541 6.53808C2.28806 6.69364 2.44643 6.81019 2.62846 6.87148L3.69546 7.21848C3.94767 7.30297 4.17673 7.44506 4.36446 7.63348C4.41519 7.6837 4.46262 7.73715 4.50646 7.79348C4.62481 7.94615 4.71614 8.11797 4.77646 8.30148L5.12846 9.38148C5.19143 9.56222 5.30914 9.71886 5.46524 9.82962ZM4.00746 6.26448L3.15246 5.99948L4.01646 5.71848C4.41071 5.58184 4.76826 5.35637 5.06146 5.05948C5.35281 4.76039 5.57294 4.39943 5.70546 4.00348L5.97046 3.14448L6.25046 4.00648C6.38349 4.40638 6.60809 4.76969 6.90636 5.06744C7.20463 5.36519 7.56833 5.58915 7.96846 5.72148L8.84846 5.99048L7.98746 6.27048C7.58707 6.40272 7.22321 6.62691 6.92505 6.92507C6.62689 7.22324 6.4027 7.58709 6.27046 7.98748L6.00546 8.84448L5.72646 7.98548C5.63026 7.69329 5.48483 7.41968 5.29646 7.17648C5.22699 7.08766 5.15254 7.00286 5.07346 6.92248C4.7738 6.62366 4.4089 6.39842 4.00746 6.26448ZM10.5344 13.8515C10.6703 13.9477 10.8328 13.9994 10.9994 13.9995C11.1642 13.998 11.3245 13.9456 11.4584 13.8495C11.5979 13.751 11.7029 13.611 11.7584 13.4495L12.0064 12.6875C12.0595 12.529 12.1485 12.385 12.2664 12.2665C12.3837 12.148 12.5277 12.0592 12.6864 12.0075L13.4584 11.7555C13.6161 11.701 13.7528 11.5985 13.8494 11.4625C13.9227 11.3595 13.9706 11.2405 13.9891 11.1154C14.0076 10.9903 13.9962 10.8626 13.9558 10.7428C13.9154 10.623 13.8472 10.5144 13.7567 10.4261C13.6662 10.3377 13.5561 10.272 13.4354 10.2345L12.6714 9.98548C12.5132 9.93291 12.3695 9.8443 12.2514 9.72663C12.1334 9.60896 12.0444 9.46547 11.9914 9.30748L11.7394 8.53348C11.685 8.37623 11.5825 8.24011 11.4464 8.14448C11.3443 8.07153 11.2266 8.02359 11.1026 8.00453C10.9787 7.98547 10.8519 7.99582 10.7327 8.03475C10.6135 8.07369 10.5051 8.1401 10.4163 8.22865C10.3274 8.31719 10.2607 8.42538 10.2214 8.54448L9.97435 9.30648C9.92207 9.46413 9.83452 9.60777 9.71835 9.72648C9.60382 9.84272 9.46428 9.9313 9.31035 9.98548L8.53435 10.2385C8.41689 10.2793 8.31057 10.347 8.22382 10.4361C8.13708 10.5252 8.0723 10.6333 8.03464 10.7518C7.99698 10.8704 7.98746 10.996 8.00686 11.1189C8.02625 11.2417 8.07401 11.3583 8.14635 11.4595C8.24456 11.5993 8.38462 11.7044 8.54635 11.7595L9.30935 12.0065C9.46821 12.0599 9.61262 12.1492 9.73135 12.2675C9.84958 12.3857 9.93801 12.5304 9.98935 12.6895L10.2424 13.4635C10.2971 13.6199 10.3992 13.7555 10.5344 13.8515ZM9.62035 11.0585L9.44235 10.9995L9.62635 10.9355C9.92811 10.8305 10.2018 10.6578 10.4264 10.4305C10.6528 10.2015 10.8238 9.92374 10.9264 9.61848L10.9844 9.44048L11.0434 9.62148C11.1453 9.92819 11.3175 10.2069 11.5461 10.4353C11.7748 10.6638 12.0536 10.8357 12.3604 10.9375L12.5554 11.0005L12.3754 11.0595C12.068 11.1617 11.7888 11.3344 11.5601 11.5637C11.3314 11.7931 11.1596 12.0728 11.0584 12.3805L10.9994 12.5615L10.9414 12.3805C10.84 12.0721 10.6676 11.7919 10.4382 11.5623C10.2088 11.3326 9.92863 11.1601 9.62035 11.0585Z" },
+    ],
+  },
+  law: {
+    box: [1.61, 1.36, 13.78],
+    paths: [
+      { d: "M10.039 7.30702L10.036 7.31402C10.036 7.31402 10.033 7.32202 10.032 7.32602C10.028 7.33602 10.024 7.34702 10.021 7.35702C10.02 7.36102 10.019 7.36502 10.018 7.36902C10.015 7.38002 10.012 7.39202 10.01 7.40402C10.009 7.40902 10.008 7.41502 10.007 7.42102C10.005 7.43102 10.004 7.44102 10.003 7.45102C10.001 7.46702 10.001 7.48302 10.001 7.50002C10.001 8.87802 11.123 10 12.501 10C13.879 10 15.001 8.87802 15.001 7.50002C15.001 7.48402 15.001 7.46702 14.999 7.45102C14.998 7.44102 14.996 7.43102 14.995 7.42102C14.995 7.41502 14.994 7.41002 14.992 7.40402C14.99 7.39202 14.987 7.38102 14.984 7.36902C14.983 7.36502 14.982 7.36102 14.981 7.35702C14.978 7.34602 14.974 7.33602 14.97 7.32602C14.969 7.32202 14.967 7.31802 14.966 7.31402L14.963 7.30702C14.963 7.30702 14.963 7.30502 14.963 7.30402L13.241 2.99902H14.002C14.278 2.99902 14.502 2.77502 14.502 2.49902C14.502 2.22302 14.278 1.99902 14.002 1.99902H2.99998C2.72398 1.99902 2.49998 2.22302 2.49998 2.49902C2.49998 2.77502 2.72398 2.99902 2.99998 2.99902H3.76098L2.03898 7.30402C2.03898 7.30402 2.03898 7.30602 2.03898 7.30702L2.03598 7.31402C2.03598 7.31402 2.03298 7.32202 2.03198 7.32602C2.02798 7.33602 2.02398 7.34702 2.02098 7.35702C2.01998 7.36102 2.01898 7.36502 2.01798 7.36902C2.01498 7.38002 2.01198 7.39202 2.00998 7.40402C2.00898 7.40902 2.00798 7.41502 2.00698 7.42102C2.00498 7.43102 2.00398 7.44102 2.00298 7.45102C2.00098 7.46702 2.00098 7.48302 2.00098 7.50002C2.00098 8.87802 3.12298 10 4.50098 10C5.87898 10 7.00098 8.87802 7.00098 7.50002C7.00098 7.48402 7.00098 7.46702 6.99898 7.45102C6.99798 7.44102 6.99598 7.43102 6.99498 7.42102C6.99498 7.41502 6.99398 7.41002 6.99198 7.40402C6.98998 7.39202 6.98698 7.38102 6.98398 7.36902C6.98298 7.36502 6.98198 7.36102 6.98098 7.35702C6.97798 7.34602 6.97398 7.33602 6.96998 7.32602C6.96898 7.32202 6.96698 7.31802 6.96598 7.31402L6.96298 7.30702C6.96298 7.30702 6.96298 7.30502 6.96298 7.30402L5.24098 2.99902H8.00198V10.999H5.50198C4.67498 10.999 4.00198 11.672 4.00198 12.499C4.00198 13.326 4.67498 13.999 5.50198 13.999H11.502C12.329 13.999 13.002 13.326 13.002 12.499C13.002 11.672 12.329 10.999 11.502 10.999H9.00198V3.00002H11.763L10.041 7.30502C10.041 7.30502 10.041 7.30702 10.041 7.30802L10.039 7.30702ZM4.49998 3.84602L5.76198 7.00002H3.23898L4.49998 3.84602ZM4.49998 9.00002C3.84798 9.00002 3.29198 8.58202 3.08598 8.00002H5.91398C5.70698 8.58202 5.15198 9.00002 4.49998 9.00002ZM12 12.5C12 12.775 11.776 13 11.5 13H5.49998C5.22398 13 4.99998 12.775 4.99998 12.5C4.99998 12.225 5.22398 12 5.49998 12H11.5C11.776 12 12 12.225 12 12.5ZM12.5 9.00002C11.848 9.00002 11.292 8.58202 11.086 8.00002H13.914C13.707 8.58202 13.152 9.00002 12.5 9.00002ZM11.238 7.00002L12.5 3.84602L13.762 7.00002H11.239H11.238Z" },
+    ],
+  },
+  agent: {
+    box: [-0.33, -0.33, 16.67],
+    paths: [
+      { d: "M10.887 15H8.49998C8.22398 15 7.99998 14.776 7.99998 14.5C7.99998 14.224 8.22398 14 8.49998 14H10.887C11.243 14 11.575 13.809 11.752 13.5L14.64 8.5C14.819 8.191 14.819 7.809 14.64 7.5L11.705 2.416C11.557 2.16 11.28 2 10.983 2C10.616 2 10.296 2.236 10.188 2.587L6.76598 13.707C6.52898 14.48 5.82498 15 5.01598 15C4.36398 15 3.75498 14.649 3.42898 14.084L0.494984 9C0.137984 8.383 0.137984 7.617 0.494984 7L3.38198 2C3.73698 1.383 4.40098 1 5.11298 1H7.49998C7.77598 1 7.99998 1.224 7.99998 1.5C7.99998 1.776 7.77598 2 7.49998 2H5.11298C4.75698 2 4.42498 2.191 4.24798 2.5L1.35998 7.5C1.18098 7.809 1.18098 8.191 1.35998 8.5L4.29498 13.584C4.44298 13.841 4.71998 14 5.01698 14C5.38398 14 5.70398 13.764 5.81198 13.412L9.23398 2.293C9.47098 1.52 10.174 1 10.984 1C11.636 1 12.245 1.351 12.571 1.916L15.506 7C15.863 7.617 15.863 8.383 15.506 9.001L12.619 14C12.264 14.617 11.599 15 10.887 15Z" },
+    ],
+  },
+  mcp: {
+    box: [-0.54, -0.76, 17.31],
+    paths: [
+      { d: "M14.5565 7.87462C14.5385 7.89312 14.5205 7.91112 14.5025 7.92862L8.69849 13.6201C8.62599 13.6906 8.62449 13.8061 8.69499 13.8786C8.69599 13.8801 8.69749 13.8811 8.69849 13.8821L9.89049 15.0516C10.1075 15.2626 10.1125 15.6101 9.90149 15.8276C9.89799 15.8311 9.89449 15.8351 9.89049 15.8386C9.66699 16.0556 9.31199 16.0556 9.08849 15.8386L7.89649 14.6701C7.38949 14.1776 7.37799 13.3671 7.87049 12.8601C7.87899 12.8511 7.88749 12.8426 7.89649 12.8341L13.7005 7.14212C14.352 6.50762 14.3665 5.46512 13.732 4.81362C13.7215 4.80312 13.711 4.79262 13.7005 4.78212L13.667 4.74962C12.998 4.09862 11.9325 4.09762 11.2625 4.74762L6.48099 9.43712L6.47949 9.43862L6.41399 9.50312C6.19049 9.72062 5.83449 9.72062 5.61149 9.50312C5.39449 9.29162 5.38949 8.94462 5.60049 8.72712C5.60399 8.72362 5.60749 8.71962 5.61149 8.71612L10.46 3.96062C11.1105 3.32512 11.123 2.28262 10.4875 1.63212C10.478 1.62212 10.468 1.61262 10.458 1.60262C9.78799 0.950619 8.72099 0.950619 8.05149 1.60262L1.63499 7.89512C1.41149 8.11212 1.05649 8.11212 0.832987 7.89512C0.615987 7.68412 0.610987 7.33662 0.821987 7.11912C0.825487 7.11562 0.828987 7.11162 0.832987 7.10812L7.24999 0.815119C8.36599 -0.271381 10.1445 -0.271381 11.2605 0.815119C11.8905 1.42762 12.189 2.30512 12.063 3.17512C12.9435 3.05012 13.8325 3.34062 14.469 3.96162L14.5025 3.99512C15.5885 5.05162 15.613 6.78812 14.5565 7.87412V7.87462ZM12.8655 6.32212C13.083 6.11062 13.0875 5.76362 12.8765 5.54612C12.873 5.54262 12.8695 5.53862 12.8655 5.53512C12.642 5.31762 12.286 5.31762 12.063 5.53512L7.31699 10.1896C6.64699 10.8416 5.57999 10.8416 4.91049 10.1896C4.25899 9.55512 4.24449 8.51262 4.87899 7.86112C4.88949 7.85062 4.89999 7.84012 4.91049 7.82962L9.65699 3.17512C9.87399 2.96362 9.87899 2.61662 9.66799 2.39912C9.66449 2.39562 9.66099 2.39162 9.65699 2.38812C9.43349 2.17062 9.07749 2.17062 8.85449 2.38812L4.10849 7.04262C3.02249 8.09912 2.99799 9.83562 4.05449 10.9216C4.07249 10.9401 4.09049 10.9581 4.10849 10.9756C5.22499 12.0616 7.00299 12.0616 8.11899 10.9756L12.8655 6.32112V6.32212Z", evenOdd: true },
+    ],
+  },
+  package: {
+    box: [0.58, 0.58, 14.84],
+    paths: [
+      { d: "M6 8.63998C5.934 8.63998 5.867 8.62698 5.803 8.59898L3.303 7.52898C3.049 7.42098 2.931 7.12698 3.04 6.87298C3.149 6.61998 3.444 6.50098 3.696 6.60998L6.196 7.67998C6.45 7.78798 6.568 8.08198 6.459 8.33598C6.378 8.52498 6.193 8.63898 6 8.63898V8.63998Z" },
+      { d: "M4.80397 10.17C4.86797 10.197 4.93397 10.21 4.99997 10.21C5.19397 10.21 5.37897 10.096 5.45997 9.90599C5.56797 9.65199 5.44997 9.35799 5.19597 9.24999L3.69597 8.60999C3.44397 8.50199 3.14797 8.61999 3.03997 8.87399C2.93197 9.12799 3.04997 9.42199 3.30397 9.52999L4.80397 10.17Z" },
+      { d: "M14.039 3.28598L9.077 1.37798C8.384 1.11098 7.616 1.11098 6.923 1.37798L1.962 3.28598C1.383 3.50898 1 4.06498 1 4.68598V11.312C1 11.933 1.382 12.489 1.962 12.712L6.923 14.62C7.616 14.887 8.384 14.887 9.077 14.62L14.039 12.712C14.618 12.489 15 11.933 15 11.312V4.68598C15 4.06498 14.618 3.50898 14.039 3.28598ZM7.5 13.757C7.426 13.738 7.354 13.715 7.282 13.687L2.32 11.779C2.127 11.705 2 11.519 2 11.312V4.97098L7.5 7.32798V13.757ZM2.564 4.12598L7.282 2.31098C7.744 2.13298 8.256 2.13298 8.718 2.31098L13.436 4.12598L8 6.45598L2.564 4.12598ZM14 11.313C14 11.52 13.873 11.705 13.68 11.78L8.718 13.688C8.646 13.716 8.574 13.739 8.5 13.758V7.32998L14 4.97298V11.313Z", evenOdd: true },
+    ],
+  },
+  warning: {
+    box: [0.5, 0.58, 14.84],
+    paths: [
+      { d: "M14.831 11.965L9.206 1.714C8.965 1.274 8.503 1 8 1C7.497 1 7.035 1.274 6.794 1.714L1.169 11.965C1.059 12.167 1 12.395 1 12.625C1 13.383 1.617 14 2.375 14H13.625C14.383 14 15 13.383 15 12.625C15 12.395 14.941 12.167 14.831 11.965ZM13.625 13H2.375C2.168 13 2 12.832 2 12.625C2 12.561 2.016 12.5 2.046 12.445L7.671 2.195C7.736 2.075 7.863 2 8 2C8.137 2 8.264 2.075 8.329 2.195L13.954 12.445C13.984 12.501 14 12.561 14 12.625C14 12.832 13.832 13 13.625 13ZM8.75 11.25C8.75 11.664 8.414 12 8 12C7.586 12 7.25 11.664 7.25 11.25C7.25 10.836 7.586 10.5 8 10.5C8.414 10.5 8.75 10.836 8.75 11.25ZM7.5 9V5.5C7.5 5.224 7.724 5 8 5C8.276 5 8.5 5.224 8.5 5.5V9C8.5 9.276 8.276 9.5 8 9.5C7.724 9.5 7.5 9.276 7.5 9Z" },
+    ],
+  },
+};
+
+/**
+ * Which mark each artifact kind wears. An unknown kind gets none rather than
+ * a stand-in: a wrong glyph on a future kind reads as a claim, and no glyph
+ * reads as what it is.
+ */
+export const KIND_MARKS: Record<string, Glyph> = {
+  skill: CODICONS.sparkle!,
+  rule: CODICONS.law!,
+  agent: CODICONS.agent!,
+  mcp: CODICONS.mcp!,
+  bundle: CODICONS.package!,
+};
+
+/** What a retired artifact wears instead of its kind. */
+export const DEPRECATED_MARK = CODICONS.warning!;
+
+/**
+ * One codicon, filled with `currentColor`, framed on its own box.
+ *
+ * Filled rather than stroked, which is what makes it usable at watermark
+ * scale: a stroked glyph's overlapping paths composite twice wherever they
+ * cross, so a translucent one comes out blotchy along its own joins.
+ */
+export function KindMark({
+  glyph,
+  size = 16,
+  ...rest
+}: {
+  glyph: Glyph;
+  size?: number;
+} & Record<string, unknown>) {
+  const [x, y, side] = glyph.box;
+  return (
+    <svg viewBox={`${x} ${y} ${side} ${side}`} width={size} height={size} {...rest}>
+      {glyph.paths.map((p) => (
+        <path
+          key={p.d}
+          d={p.d}
+          fill="currentColor"
+          fill-rule={p.evenOdd ? "evenodd" : undefined}
+          clip-rule={p.evenOdd ? "evenodd" : undefined}
+        />
+      ))}
+    </svg>
+  );
+}

package/dist/renderer/astro/components/PackageCard.d.ts

@@ -0,0 +1,18 @@
+import { type CatalogPackage } from "../lib/catalog.js";
+export interface PackageCardProps {
+    pkg: CatalogPackage;
+    /**
+     * `publisher.extension` id behind the deep links, or `null`. A prop rather
+     * than a `lib/data` read: this island hydrates in the browser, and importing
+     * the build-time payload here would ship the whole catalog twice.
+     */
+    vscodeExtension: string | null;
+    /** Keyword facets currently applied, so a chip can render itself pressed. */
+    activeKeywords: string[];
+    /** Apply or clear one keyword facet. */
+    onToggleKeyword: (keyword: string) => void;
+    /** The catalog's own arrow-key navigation. */
+    onKeyDown: (event: KeyboardEvent) => void;
+}
+export declare function PackageCard({ pkg: p, vscodeExtension, activeKeywords, onToggleKeyword, onKeyDown, }: PackageCardProps): import("preact").JSX.Element;
+//# sourceMappingURL=PackageCard.d.ts.map

package/dist/renderer/astro/components/PackageCard.js

@@ -0,0 +1,50 @@
+import { jsx as _jsx, jsxs as _jsxs } from "preact/jsx-runtime";
+// SPDX-License-Identifier: Apache-2.0
+// Copyright 2026 The Grimoire Authors
+// One card of the grid view.
+//
+// Its own file so an index can replace the card without owning `Catalog.tsx`
+// and its sorting, filtering, keyboard and URL-state machinery. Unlike the
+// `.astro` components, this one takes props — a Preact component in a
+// hydrated island cannot read the build-time payload — so its props ARE a
+// contract, and they are the reason component overrides are documented as
+// unstable for now.
+import { ArrowBigUp } from "lucide-preact";
+import { mdiMicrosoftVisualStudioCode } from "@mdi/js";
+import { BrandMark } from "./BrandMark.js";
+import { CardLogo } from "./CardLogo.js";
+import { CopyButton } from "./CopyButton.js";
+import { DEPRECATED_MARK, KIND_MARKS, KindMark } from "./KindMark.js";
+import { withBase } from "../lib/base.js";
+import { externalUrl, lastUpdated, timeAgo, vscodeUrl, vscodeVoteUrl, } from "../lib/catalog.js";
+export function PackageCard({ pkg: p, vscodeExtension, activeKeywords, onToggleKeyword, onKeyDown, }) {
+    return (_jsxs("li", { class: "card", "data-slot": "package-card", tabIndex: 0, onKeyDown: onKeyDown, children: [(() => {
+                const mark = p.deprecated
+                    ? DEPRECATED_MARK
+                    : KIND_MARKS[p.kind];
+                if (!mark)
+                    return null;
+                return (_jsx(KindMark, { glyph: mark, class: "card-watermark", size: 112, role: p.deprecated ? "img" : undefined, "aria-label": p.deprecated ? "deprecated" : undefined, "aria-hidden": p.deprecated ? undefined : "true", style: {
+                        color: p.deprecated
+                            ? "var(--grim-color-deprecated)"
+                            : `var(--grim-color-kind-${p.kind}, var(--grim-color-muted))`,
+                    } }));
+            })(), _jsxs("div", { class: "card-head", children: [_jsx(CardLogo, { pkg: p }), _jsx("h2", { "data-slot": "package-name", children: _jsx("a", { href: withBase(`/p/${p.namespace}/${p.name}/`), tabIndex: -1, children: p.name }) }), p.rating &&
+                        (() => {
+                            const votes = `${p.rating.up} upvote${p.rating.up === 1 ? "" : "s"}`;
+                            // Registry-supplied, like every other outbound string
+                            // here: through the scheme allowlist before it is an
+                            // href, whatever the sidecar spelled.
+                            const thread = externalUrl(p.rating.url);
+                            const vote = vscodeVoteUrl(vscodeExtension, p.ref);
+                            return (_jsxs("span", { class: "rating-group", children: [thread ? (_jsxs("a", { class: "rating-count", href: thread, target: "_blank", rel: "noopener noreferrer", tabIndex: -1, title: `${votes} — open the thread to vote`, "aria-label": `${p.name}: ${votes}. Open the voting thread`, children: [_jsx(ArrowBigUp, { size: 13, "aria-hidden": "true" }), p.rating.up] })) : (_jsxs("span", { class: "rating-count", title: votes, children: [_jsx(ArrowBigUp, { size: 13, "aria-hidden": "true" }), p.rating.up] })), vote && (_jsx("a", { class: "rating-vote", href: vote, tabIndex: -1, title: "Upvote in VS Code", "aria-label": `Upvote ${p.name} in VS Code`, children: _jsx(BrandMark, { path: mdiMicrosoftVisualStudioCode, size: 12 }) }))] }));
+                        })(), _jsxs("p", { class: "namespace", children: [_jsx("span", { class: "kind", "data-slot": "package-kind", children: p.kind }), _jsx("span", { "aria-hidden": "true", children: " \u00B7 " }), p.namespace] })] }), p.keywords && p.keywords.length > 0 && (_jsx("div", { class: "keywords", "data-slot": "package-keywords", children: p.keywords.slice(0, 5).map((kw) => (_jsx("button", { type: "button", class: activeKeywords.includes(kw)
+                        ? "chip keyword active"
+                        : "chip keyword", "aria-pressed": activeKeywords.includes(kw), tabIndex: -1, onClick: () => onToggleKeyword(kw), children: kw }, kw))) })), p.description && _jsx("p", { class: "description", children: p.description }), _jsxs("div", { class: "card-foot", children: [_jsxs("div", { class: "copy-group", children: [_jsx(CopyButton, { command: `grim add --global ${p.ref}`, variant: "global", name: `global add for ${p.name}` }), _jsx(CopyButton, { command: `grim add ${p.ref}`, name: `project add for ${p.name}` }), vscodeUrl(vscodeExtension, p.ref) && (_jsx("a", { class: "copy vscode", href: vscodeUrl(vscodeExtension, p.ref), title: "Open in VS Code", "aria-label": `Open ${p.name} in VS Code`, tabIndex: -1, children: _jsx(BrandMark, { path: mdiMicrosoftVisualStudioCode }) }))] }), (() => {
+                        const at = lastUpdated(p);
+                        const ago = at && timeAgo(at) ? timeAgo(at) : null;
+                        if (!p.version && !ago)
+                            return null;
+                        return (_jsxs("p", { class: "card-meta", "data-slot": "package-meta", children: [p.version && (_jsxs("span", { class: "card-version", children: ["v", p.version] })), p.version && ago && _jsx("span", { "aria-hidden": "true", children: " \u00B7 " }), ago && at && (_jsxs("time", { datetime: at, title: at, children: ["updated ", ago] }))] }));
+                    })()] })] }));
+}