@grimoire-rs/indexer 0.5.1 → 0.5.3

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

@@ -1,6 +1,6 @@
-import { type CatalogPackage } from "../lib/catalog.js";
+import { type CardPackage } from "../lib/catalog.js";
 export interface PackageCardProps {
-    pkg: CatalogPackage;
+    pkg: CardPackage;
     /**
      * `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

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

@@ -38,7 +38,7 @@ export function PackageCard({ pkg: p, vscodeExtension, activeKeywords, onToggleK
                             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)
+                        })(), _jsxs("p", { class: "namespace", children: [_jsx("span", { class: "kind", "data-slot": "package-kind", children: p.kind }), _jsx("span", { "aria-hidden": "true", children: " \u00B7 " }), _jsx("span", { class: "address", title: p.namespace, children: 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);

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

@@ -22,11 +22,11 @@ import {
   timeAgo,
   vscodeUrl,
   vscodeVoteUrl,
-  type CatalogPackage,
+  type CardPackage,
 } from "../lib/catalog.js";
 
 export interface PackageCardProps {
-  pkg: CatalogPackage;
+  pkg: CardPackage;
   /**
    * `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
@@ -175,7 +175,15 @@ export function PackageCard({
               {p.kind}
             </span>
             <span aria-hidden="true"> · </span>
-            {p.namespace}
+            {/* Its own element so the row can give the address the slack and
+                nothing else: the kind is one short word and keeps its width,
+                and what does not fit is dropped off the FRONT — a registry
+                host is the least distinguishing part of an address and the
+                repository is the most. `title` keeps the whole of it
+                reachable, since the ellipsis hides the head. */}
+            <span class="address" title={p.namespace}>
+              {p.namespace}
+            </span>
           </p>
         </div>
         {/* Under the head, above the description: what the package

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

@@ -1,6 +1,6 @@
-import { type CatalogPackage } from "../lib/catalog.js";
+import { type CardPackage } from "../lib/catalog.js";
 export interface PackageRowProps {
-    pkg: CatalogPackage;
+    pkg: CardPackage;
     /** Whether this index publishes ratings at all — decided once, not per row. */
     hasRatings: boolean;
     /** The catalog's own arrow-key navigation. */

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

@@ -13,10 +13,10 @@ import { ArrowBigUp } from "lucide-preact";
 import { CardLogo } from "./CardLogo.js";
 import { DEPRECATED_MARK, KIND_MARKS, KindMark } from "./KindMark.js";
 import { withBase } from "../lib/base.js";
-import { lastUpdated, timeAgo, type CatalogPackage } from "../lib/catalog.js";
+import { lastUpdated, timeAgo, type CardPackage } from "../lib/catalog.js";
 
 export interface PackageRowProps {
-  pkg: CatalogPackage;
+  pkg: CardPackage;
   /** Whether this index publishes ratings at all — decided once, not per row. */
   hasRatings: boolean;
   /** The catalog's own arrow-key navigation. */

package/dist/renderer/astro/layouts/Base.astro

@@ -62,16 +62,18 @@ const { title, description, image = config.logo ?? config.favicon } = Astro.prop
 
       // Also before first paint: a deep link (a keyword chip on a package
       // page) or a stored preference means the catalog the server rendered —
-      // every package, empty search box, name order, deprecated hidden — is
-      // the wrong one. Flag it so CSS holds the catalog back rather than
-      // showing the full list and rearranging it a moment later. The island
-      // drops the flag once it has applied the view — which is the render
-      // after hydration, never the hydrating one itself; the timeout is the
-      // failsafe for an island that never hydrates, where a flash beats a
-      // blank page.
+      // every package, empty search box, name order, deprecated hidden, as
+      // cards — is the wrong one. Flag it so CSS holds the catalog back
+      // rather than showing the full list and rearranging it a moment
+      // later. The island drops the flag once it has applied the view —
+      // which is the render after hydration, never the hydrating one
+      // itself; the timeout is the failsafe for an island that never
+      // hydrates, where a flash beats a blank page.
       const view = new URLSearchParams(location.search);
-      const arranged = ["sort", "dir", "deprecated"].some((k) => pref("grim.catalog." + k));
-      if (view.get("q") || view.get("kind") || arranged) {
+      const arranged = ["sort", "dir", "deprecated", "view"].some((k) =>
+        pref("grim.catalog." + k),
+      );
+      if (view.get("q") || view.get("kind") || view.get("kw") || arranged) {
         document.documentElement.dataset.query = "";
         setTimeout(() => delete document.documentElement.dataset.query, 3000);
       }
@@ -849,20 +851,16 @@ const { title, description, image = config.logo ?? config.favicon } = Astro.prop
           font-size: var(--grim-text-md);
           min-width: 0;
         }
-        .controls input[type="search"]:focus-visible {
-          outline: 2px solid var(--grim-color-accent);
-          outline-offset: 1px;
-        }
         /* The `/` shortcut, shown as the key it is. It is a hint for a field
            that is not yet in use, so it withdraws the moment the field is
            focused or holds a query — at which point it would only be
            sitting on top of what is being typed. */
-        .search-hint {
+        .search-hint,
+        .search-clear {
           position: absolute;
           right: 0.5rem;
           top: 50%;
           translate: 0 -50%;
-          pointer-events: none;
           border: var(--grim-border-width) solid var(--grim-color-border);
           border-bottom-width: 2px;
           border-radius: var(--grim-radius-inset);
@@ -873,10 +871,33 @@ const { title, description, image = config.logo ?? config.favicon } = Astro.prop
           line-height: 1;
           padding: var(--grim-space-2) var(--grim-space-3);
         }
+        .search-hint {
+          pointer-events: none;
+        }
+        /* The two never coexist — the hint withdraws exactly when a query
+           appears, which is when the clear button is rendered — so they share
+           one corner rather than sitting beside each other. */
         .search-field:focus-within .search-hint,
         .search-field:has(input:not(:placeholder-shown)) .search-hint {
           display: none;
         }
+        /* Sized to the glyph rather than to a text line, so the box matches
+           the hint's height instead of growing around an SVG on a baseline. */
+        .search-clear {
+          display: grid;
+          place-items: center;
+          cursor: pointer;
+        }
+        .search-clear:hover {
+          color: var(--grim-color-fg);
+        }
+        /* The UA's own clear button, gone: it renders in this same corner in
+           Chromium and Safari, in a style that answers to no token here, and
+           it cannot be restyled beyond hiding. Ours replaces it. */
+        .controls input[type="search"]::-webkit-search-cancel-button {
+          appearance: none;
+          display: none;
+        }
         /* One line, always. Wrapping was the defect: at a narrow width the
            row dropped `deprecated` onto a second line, because no chip can
            shrink below its own longest word and the rail's chip count is a
@@ -1026,11 +1047,6 @@ const { title, description, image = config.logo ?? config.favicon } = Astro.prop
         .sort-field:focus-visible {
           z-index: 1;
         }
-        .sort-dir:focus-visible,
-        .sort-field:focus-visible {
-          outline: 2px solid var(--grim-color-accent);
-          outline-offset: 1px;
-        }
         /* One box for every chip in the filter row — the kinds, the keywords,
            the deprecated toggle and the overflow menu's trigger alike. The
            line-height is stated rather than inherited because a `<summary>`
@@ -1062,21 +1078,13 @@ const { title, description, image = config.logo ?? config.favicon } = Astro.prop
           background: var(--grim-color-accent-soft);
         }
         /* The keyword rail reorders on every click — it is rescored against
-           what is on screen — and the chips slide rather than jump. The FLIP
-           effect in `Catalog.tsx` sets an inline `translate` back to where
-           each chip was and drops it on the next frame; this transition is
-           what plays that back. Without a declared duration the invert would
-           simply stick. */
-        .chip.kw {
-          transition:
-            border-color var(--grim-duration-base) ease,
-            translate var(--grim-duration-slow) ease-out;
-        }
-        @media (prefers-reduced-motion: reduce) {
-          .chip.kw {
-            transition: border-color var(--grim-duration-base) ease;
-          }
-        }
+           what is on screen — and the chips slide rather than jump. There is
+           deliberately no `translate` transition here: the FLIP effect in
+           `Catalog.tsx` runs each slide as a Web Animation instead, reading
+           `--grim-duration-slow` for its length and honouring
+           `prefers-reduced-motion` itself. A transition needs an inline style
+           to drive it, and an inline style is what a superseded pass used to
+           leave behind on a chip stopped off its seat. */
         /* The overflow menu. A popover, and it has to be one: `.filter-row`
            above is a scroll container, and an absolutely-positioned panel
            inside a scroll container is cropped to the row AND stretches the
@@ -1143,10 +1151,6 @@ const { title, description, image = config.logo ?? config.favicon } = Astro.prop
           font: inherit;
           font-size: var(--grim-text-sm);
         }
-        .kw-menu-search:focus-visible {
-          outline: 2px solid var(--grim-color-accent);
-          outline-offset: 1px;
-        }
         .kw-menu-list {
           display: flex;
           flex-direction: column;
@@ -1240,9 +1244,38 @@ const { title, description, image = config.logo ?? config.favicon } = Astro.prop
         .view-pick.active {
           z-index: 1;
         }
+
+        /* One focus ring for every bordered control in the toolbar, and it is
+           the card's: the border takes the accent and the outline sits
+           directly on it, so the two merge into one thicker edge.
+
+           An offset ring is what put two borders on the sort combo. Hover
+           already tints the border, so a ring standing 1px clear of it drew a
+           second line in the same colour — one state reading as two. Every
+           control here tints its border on hover or while active, so the
+           offset had to go from all of them together rather than from the one
+           that was reported. */
+        .chip:focus-visible,
+        .controls input[type="search"]:focus-visible,
+        .kw-menu-search:focus-visible,
+        .sort-dir:focus-visible,
+        .sort-field:focus-visible,
         .view-pick:focus-visible {
           outline: 2px solid var(--grim-color-accent);
-          outline-offset: 1px;
+          outline-offset: 0;
+          border-color: var(--grim-color-accent);
+        }
+        /* The sort combo, while a POINTER is driving it. Chromium hands a
+           `<select>` `:focus-visible` on an ordinary click, so this control
+           alone would wear the keyboard ring for a mouse interaction — around
+           a closed box sitting behind its own open dropdown, which already
+           says everything the ring would. `data-pointer` is set by the
+           element's own `pointerdown` and cleared by a keypress or a blur, so
+           the ring is only ever suppressed for the interaction that did not
+           need it; every keyboard focus keeps it. */
+        .sort-field[data-pointer]:focus-visible {
+          outline: none;
+          border-color: var(--grim-color-accent);
         }
 
         .grid {
@@ -1508,13 +1541,20 @@ const { title, description, image = config.logo ?? config.favicon } = Astro.prop
            the container rather than cutting square across it. */
         .table {
           display: grid;
-          /* logo | kind | name | description | updated. The two fixed-width
-             marks lead, so the names start on one line down the whole list
-             and the eye runs the column it actually reads. The name is
-             capped rather than `max-content`: an unbounded name ate the
-             description's space, and past the cap both clip instead. The
-             description is the only track that grows. */
-          grid-template-columns: auto auto minmax(8rem, 14rem) 1fr auto;
+          /* logo | kind | name | description | updated. The two marks lead,
+             so the names start on one line down the whole list and the eye
+             runs the column it actually reads.
+
+             Every track is sized to give the description whatever is left.
+             The marks are `min-content` — a 20px tile and a 16px glyph, and
+             nothing about them should reserve more than they draw. The name
+             is `fit-content(14rem)`: as wide as the longest name in the list
+             and no wider, capped, past which it clips. It was
+             `minmax(8rem, 14rem)`, and that 8rem floor was a hole — a list of
+             short names paid a fixed 8rem for them, so the description read
+             as pushed away from a column of empty space. */
+          grid-template-columns:
+            min-content min-content fit-content(14rem) 1fr auto;
           background: var(--grim-color-card);
           border: var(--grim-border-width) solid var(--grim-color-border);
           /* `xl`, the content-surface step — the same one the card wears.
@@ -1528,20 +1568,45 @@ const { title, description, image = config.logo ?? config.favicon } = Astro.prop
         /* One more track when the index publishes ratings. Decided once per
            index, never per filter — see `PackageTable`. */
         .table.rated {
-          grid-template-columns: auto auto minmax(8rem, 14rem) 1fr auto auto;
+          grid-template-columns:
+            min-content min-content fit-content(14rem) 1fr auto auto;
         }
         .table .row {
           grid-column: 1 / -1;
           display: grid;
           grid-template-columns: subgrid;
           align-items: center;
-          gap: var(--grim-space-5);
+          /* One step tighter than the row's own padding. A 12px gutter either
+             side of a 16px glyph reads as a hole rather than as spacing. */
+          gap: var(--grim-space-4);
           padding: var(--grim-space-3) var(--grim-space-5);
           color: inherit;
           text-decoration: none;
           font-size: var(--grim-text-sm);
           transition: background-color var(--grim-duration-base) ease;
         }
+        /* NO `content-visibility` on a row, and the reason is load-bearing.
+           `content-visibility: auto` applies SIZE CONTAINMENT, and a
+           size-contained element cannot be a subgrid — the `subgrid` above
+           degrades to `none`, silently. Measured in Chromium 152 against a
+           real build: with it, `getComputedStyle(row).gridTemplateColumns`
+           reads `none` and every cell is one sixth of the table (181px each
+           at a 1280px viewport); without it the parent's tracks apply and the
+           description gets the 832px the `1fr` exists to give it.
+
+           It shipped in 2a77c15 as a paint bound, and the check made at the
+           time — first and last rows' cells at identical offsets, before and
+           after scrolling — could not have caught this: when EVERY row is the
+           same independently-computed grid, the offsets match perfectly and
+           the alignment is fake. Any check here must read the row's own
+           `gridTemplateColumns`, or a cell's width against its content, never
+           two rows against each other. `style_contract.test.ts` holds the
+           text form of the invariant.
+
+           What that commit bought is not lost. The logo fetches it was aimed
+           at are held off by `loading="lazy"` on the image itself, and the
+           list's real cost — building every row — is bounded by the window in
+           `Catalog.tsx`, which is that same commit's other half. */
         /* The rule belongs between rows, not under the last one — which the
            container's own border already draws. */
         .table .row + .row {
@@ -1687,10 +1752,11 @@ const { title, description, image = config.logo ?? config.favicon } = Astro.prop
         @media (max-width: 40rem) {
           .table,
           .table.rated {
-            grid-template-columns: auto auto minmax(6rem, 1fr) auto;
+            grid-template-columns: min-content min-content minmax(6rem, 1fr) auto;
           }
           .table.rated {
-            grid-template-columns: auto auto minmax(6rem, 1fr) auto auto;
+            grid-template-columns:
+              min-content min-content minmax(6rem, 1fr) auto auto;
           }
           .t-desc {
             display: none;
@@ -1745,6 +1811,34 @@ const { title, description, image = config.logo ?? config.favicon } = Astro.prop
           font-size: var(--grim-text-xs);
           line-height: 1.3;
           font-family: ui-monospace, "SFMono-Regular", monospace;
+          /* One line, whatever the address is. A namespace breaks at its own
+             slashes and dots, so left to itself a long one wrapped to a second
+             line and made the card's head taller than its neighbours'. */
+          display: flex;
+          min-width: 0;
+          white-space: nowrap;
+        }
+        /* Trimmed from the FRONT: `github.com/` is on every address in an
+           index and the repository at the tail is what tells two apart, so the
+           head is what to spend.
+
+           `direction: rtl` is the mechanism — `text-overflow` ellipsises at
+           the line's inline END, which in an RTL box is its left edge, and
+           `text-align: left` keeps a short address sitting under the name
+           rather than flung to the right. The address itself still reads
+           left-to-right: it is one run of Latin characters, so the bidi
+           algorithm lays it out LTR inside the RTL box. That holds because a
+           namespace neither starts nor ends with punctuation — one that did
+           would have that character reordered to the far end.
+
+           The two-value `text-overflow: ellipsis ""` would say this directly
+           and is Firefox-only. */
+        .namespace .address {
+          min-width: 0;
+          overflow: hidden;
+          text-overflow: ellipsis;
+          direction: rtl;
+          text-align: left;
         }
         /* The rating is one control with two halves — the count, which opens
            the forge thread, and the vote, which casts one — joined the way

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

@@ -1,5 +1,35 @@
 import type { CatalogPackage } from "../../types.js";
 export type { CatalogPackage } from "../../types.js";
+/**
+ * The fields the CATALOG ISLAND may read — and, because the island's props
+ * are serialized into the page, the only fields that are worth shipping.
+ *
+ * `index.astro` projects every package through `cardPackage()` before handing
+ * the array to `<Catalog>`. Astro serializes island props into an HTML
+ * attribute on `<astro-island>`, so anything left in a record is paid for
+ * twice on the landing page: once in the server-rendered card markup, and
+ * again as escaped JSON the browser parses at hydration. At a corporate-sized
+ * catalog the untrimmed record set was 323 KB of that attribute, ~18% of the
+ * page, most of it fields no card or row ever looks at — `license`,
+ * `authors`, `vendor`, `documentation`, `compatibility`, `revision`,
+ * `support`, `repository`, and every unknown enrichment key riding
+ * `IndexRecord`'s index signature.
+ *
+ * This is a TYPE, not just a filter, and that is the point: a component that
+ * reaches for a field not listed here fails to compile, rather than silently
+ * rendering `undefined` in the browser while the server render — which reads
+ * the full record — looks correct. The detail pages are unaffected; they read
+ * `data` directly and hydrate nothing.
+ */
+export type CardPackage = Pick<CatalogPackage, "name" | "kind" | "ref" | "namespace" | "description" | "summary" | "version" | "keywords" | "created" | "updated" | "deprecated" | "replacedBy" | "logo" | "rating">;
+/**
+ * One package, trimmed to what the island renders.
+ *
+ * An absent key is omitted rather than set to `undefined`: `JSON.stringify`
+ * drops an undefined value anyway, and omitting it keeps the projection's
+ * output identical to what a hand-written object literal would produce.
+ */
+export declare function cardPackage(p: CatalogPackage): CardPackage;
 /**
  * When a package last moved, for sorting and for the "updated" stamp.
  *
@@ -9,7 +39,7 @@ export type { CatalogPackage } from "../../types.js";
  * existed: those records still date correctly instead of dropping into the
  * unknown bucket on the first build after an upgrade.
  */
-export declare function lastUpdated(p: CatalogPackage): string | undefined;
+export declare function lastUpdated(p: Pick<CatalogPackage, "updated" | "created">): string | undefined;
 /**
  * The deprecation sentence, or `null` for a package that is not deprecated.
  *

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

@@ -1,5 +1,37 @@
 // SPDX-License-Identifier: Apache-2.0
 // Copyright 2026 The Grimoire Authors
+/** The keys of `CardPackage`, as one list the projection actually iterates. */
+const CARD_FIELDS = [
+    "name",
+    "kind",
+    "ref",
+    "namespace",
+    "description",
+    "summary",
+    "version",
+    "keywords",
+    "created",
+    "updated",
+    "deprecated",
+    "replacedBy",
+    "logo",
+    "rating",
+];
+/**
+ * One package, trimmed to what the island renders.
+ *
+ * An absent key is omitted rather than set to `undefined`: `JSON.stringify`
+ * drops an undefined value anyway, and omitting it keeps the projection's
+ * output identical to what a hand-written object literal would produce.
+ */
+export function cardPackage(p) {
+    const out = {};
+    for (const key of CARD_FIELDS) {
+        if (p[key] !== undefined)
+            out[key] = p[key];
+    }
+    return out;
+}
 /**
  * When a package last moved, for sorting and for the "updated" stamp.
  *

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

@@ -9,6 +9,78 @@ import type { CatalogPackage } from "../../types.js";
 
 export type { CatalogPackage } from "../../types.js";
 
+/**
+ * The fields the CATALOG ISLAND may read — and, because the island's props
+ * are serialized into the page, the only fields that are worth shipping.
+ *
+ * `index.astro` projects every package through `cardPackage()` before handing
+ * the array to `<Catalog>`. Astro serializes island props into an HTML
+ * attribute on `<astro-island>`, so anything left in a record is paid for
+ * twice on the landing page: once in the server-rendered card markup, and
+ * again as escaped JSON the browser parses at hydration. At a corporate-sized
+ * catalog the untrimmed record set was 323 KB of that attribute, ~18% of the
+ * page, most of it fields no card or row ever looks at — `license`,
+ * `authors`, `vendor`, `documentation`, `compatibility`, `revision`,
+ * `support`, `repository`, and every unknown enrichment key riding
+ * `IndexRecord`'s index signature.
+ *
+ * This is a TYPE, not just a filter, and that is the point: a component that
+ * reaches for a field not listed here fails to compile, rather than silently
+ * rendering `undefined` in the browser while the server render — which reads
+ * the full record — looks correct. The detail pages are unaffected; they read
+ * `data` directly and hydrate nothing.
+ */
+export type CardPackage = Pick<
+  CatalogPackage,
+  | "name"
+  | "kind"
+  | "ref"
+  | "namespace"
+  | "description"
+  | "summary"
+  | "version"
+  | "keywords"
+  | "created"
+  | "updated"
+  | "deprecated"
+  | "replacedBy"
+  | "logo"
+  | "rating"
+>;
+
+/** The keys of `CardPackage`, as one list the projection actually iterates. */
+const CARD_FIELDS = [
+  "name",
+  "kind",
+  "ref",
+  "namespace",
+  "description",
+  "summary",
+  "version",
+  "keywords",
+  "created",
+  "updated",
+  "deprecated",
+  "replacedBy",
+  "logo",
+  "rating",
+] as const satisfies readonly (keyof CardPackage)[];
+
+/**
+ * One package, trimmed to what the island renders.
+ *
+ * An absent key is omitted rather than set to `undefined`: `JSON.stringify`
+ * drops an undefined value anyway, and omitting it keeps the projection's
+ * output identical to what a hand-written object literal would produce.
+ */
+export function cardPackage(p: CatalogPackage): CardPackage {
+  const out: Record<string, unknown> = {};
+  for (const key of CARD_FIELDS) {
+    if (p[key] !== undefined) out[key] = p[key];
+  }
+  return out as CardPackage;
+}
+
 /**
  * When a package last moved, for sorting and for the "updated" stamp.
  *
@@ -18,7 +90,7 @@ export type { CatalogPackage } from "../../types.js";
  * existed: those records still date correctly instead of dropping into the
  * unknown bucket on the first build after an upgrade.
  */
-export function lastUpdated(p: CatalogPackage): string | undefined {
+export function lastUpdated(p: Pick<CatalogPackage, "updated" | "created">): string | undefined {
   return p.updated ?? p.created;
 }
 

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

@@ -0,0 +1,17 @@
+/** Every package that matched, by `ref`, with its 0–1 score. */
+export type Scores = ReadonlyMap<string, number>;
+export interface SearchIndex {
+    /** Score one query against the whole catalog. Empty query, empty map. */
+    search(query: string): Scores;
+}
+/**
+ * Fetch the full catalog and build the matcher over it.
+ *
+ * Rejects rather than degrading quietly — the caller decides what a failure
+ * means, and for the island it means "keep the substring filter". Records
+ * without a string `ref` are dropped instead of failing the whole load: `ref`
+ * is how a hit is joined back onto the card the island already holds, so a
+ * record without one could never be shown even if it matched.
+ */
+export declare function loadSearchIndex(url: string): Promise<SearchIndex>;
+//# sourceMappingURL=search.d.ts.map