@jomae/catalog 0.6.0 → 0.7.0

package/README.md

@@ -1,6 +1,6 @@
 # @jomae/catalog
 
-The rule catalog behind [youmightnotneed](https://youmightnotneed-web.vercel.app).
+The rule catalog behind [youmightnotneed](https://youmightnotneed.dev).
 Maps npm packages to the CSS, HTML, or Web API that replaces them.
 
 ```

package/dist/index.d.ts

@@ -12,6 +12,8 @@ export { type BaselineHistory, type BaselineHistoryEntry, baselineHistory, } fro
 export { packageSizes, type SizeSnapshot } from "./generated/sizes.ts";
 export { GUIDE_SOURCE, type GuideSnapshot, guideCommand, guideSnapshot, isKnownGuide, type ResolvedGuide, resolveGuide, resolveGuides, } from "./guides.ts";
 export { type TierShare, tierShareOf } from "./history.ts";
+export { renderRuleMarkdown, renderUseCaseTable, ruleMarkdownUrl, } from "./markdown.ts";
 export { rules, rulesById, rulesByPackage } from "./rules/index.ts";
 export { type BaselineStatus, baselineStatusSchema, type ManualBaseline, manualBaselineSchema, parseCatalog, type Rule, ruleSchema, SCHEMA_VERSION, } from "./schema.ts";
+export { MIN_QUERY_LENGTH, type SearchOptions, type SearchResult, searchRules, } from "./search.ts";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,kBAAkB,EAClB,KAAK,YAAY,EACjB,aAAa,EACb,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,aAAa,EACb,KAAK,eAAe,EACpB,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,KAAK,cAAc,EACnB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,KAAK,UAAU,EACf,cAAc,GACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,OAAO,EACP,iBAAiB,EACjB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,MAAM,EACN,KAAK,OAAO,EACZ,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,MAAM,EACX,KAAK,OAAO,EACZ,YAAY,EACZ,SAAS,GACV,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,UAAU,GACX,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,eAAe,GAChB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EACL,YAAY,EACZ,KAAK,aAAa,EAClB,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,KAAK,aAAa,EAClB,YAAY,EACZ,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,KAAK,SAAS,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EACL,KAAK,cAAc,EACnB,oBAAoB,EACpB,KAAK,cAAc,EACnB,oBAAoB,EACpB,YAAY,EACZ,KAAK,IAAI,EACT,UAAU,EACV,cAAc,GACf,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,kBAAkB,EAClB,KAAK,YAAY,EACjB,aAAa,EACb,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,aAAa,EACb,KAAK,eAAe,EACpB,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,KAAK,cAAc,EACnB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,KAAK,UAAU,EACf,cAAc,GACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,OAAO,EACP,iBAAiB,EACjB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,MAAM,EACN,KAAK,OAAO,EACZ,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,MAAM,EACX,KAAK,OAAO,EACZ,YAAY,EACZ,SAAS,GACV,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,UAAU,GACX,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,eAAe,GAChB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EACL,YAAY,EACZ,KAAK,aAAa,EAClB,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,KAAK,aAAa,EAClB,YAAY,EACZ,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,KAAK,SAAS,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,GAChB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EACL,KAAK,cAAc,EACnB,oBAAoB,EACpB,KAAK,cAAc,EACnB,oBAAoB,EACpB,YAAY,EACZ,KAAK,IAAI,EACT,UAAU,EACV,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,gBAAgB,EAChB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,WAAW,GACZ,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -12,6 +12,8 @@ export { baselineHistory, } from "./generated/baseline-history.js";
 export { packageSizes } from "./generated/sizes.js";
 export { GUIDE_SOURCE, guideCommand, guideSnapshot, isKnownGuide, resolveGuide, resolveGuides, } from "./guides.js";
 export { tierShareOf } from "./history.js";
+export { renderRuleMarkdown, renderUseCaseTable, ruleMarkdownUrl, } from "./markdown.js";
 export { rules, rulesById, rulesByPackage } from "./rules/index.js";
 export { baselineStatusSchema, manualBaselineSchema, parseCatalog, ruleSchema, SCHEMA_VERSION, } from "./schema.js";
+export { MIN_QUERY_LENGTH, searchRules, } from "./search.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,kBAAkB,EAElB,aAAa,EACb,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,aAAa,EAEb,eAAe,EACf,cAAc,EACd,gBAAgB,EAEhB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,UAAU,EACV,gBAAgB,EAEhB,cAAc,GACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,OAAO,EACP,iBAAiB,EAGjB,MAAM,EAMN,YAAY,EACZ,SAAS,GACV,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,UAAU,GACX,MAAM,aAAa,CAAC;AACrB,OAAO,EAGL,eAAe,GAChB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,YAAY,EAAqB,MAAM,sBAAsB,CAAC;AACvE,OAAO,EACL,YAAY,EAEZ,YAAY,EACZ,aAAa,EACb,YAAY,EAEZ,YAAY,EACZ,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAkB,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAEL,oBAAoB,EAEpB,oBAAoB,EACpB,YAAY,EAEZ,UAAU,EACV,cAAc,GACf,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,kBAAkB,EAElB,aAAa,EACb,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,aAAa,EAEb,eAAe,EACf,cAAc,EACd,gBAAgB,EAEhB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,UAAU,EACV,gBAAgB,EAEhB,cAAc,GACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,OAAO,EACP,iBAAiB,EAGjB,MAAM,EAMN,YAAY,EACZ,SAAS,GACV,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,UAAU,GACX,MAAM,aAAa,CAAC;AACrB,OAAO,EAGL,eAAe,GAChB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,YAAY,EAAqB,MAAM,sBAAsB,CAAC;AACvE,OAAO,EACL,YAAY,EAEZ,YAAY,EACZ,aAAa,EACb,YAAY,EAEZ,YAAY,EACZ,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAkB,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,GAChB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAEL,oBAAoB,EAEpB,oBAAoB,EACpB,YAAY,EAEZ,UAAU,EACV,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,gBAAgB,EAGhB,WAAW,GACZ,MAAM,aAAa,CAAC"}

package/dist/markdown.d.ts

@@ -0,0 +1,24 @@
+import type { Rule } from "./schema.ts";
+/** The markdown URL for one rule. */
+export declare function ruleMarkdownUrl(id: string): string;
+/**
+ * The index that makes the catalog useful before a dependency exists. Keyed by
+ * `agent.when`, which is the use case rather than the package name, so an
+ * agent about to build a carousel can find the rule without knowing that
+ * swiper is the package it was reaching for.
+ */
+export declare function renderUseCaseTable(): string;
+/**
+ * One rule, in full. The `unless` conditions are the point of this: they are
+ * what stops a finding from overstating itself, and until this existed they
+ * were reachable only through the CLI's --verbose or the MCP server.
+ */
+export declare function renderRuleMarkdown(rule: Rule): string;
+/**
+ * The reference the agent skill loads on demand. Hybrid by design: the table
+ * works offline and with no network, and the per-rule detail is fetched, so
+ * the skill stops shipping a snapshot of prose that goes stale between
+ * releases.
+ */
+export declare function renderCatalogReference(): string;
+//# sourceMappingURL=markdown.d.ts.map

package/dist/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../src/markdown.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAWxC,qCAAqC;AACrC,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAElD;AAcD;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAa3C;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAmCrD;AAgDD;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAgD/C"}

package/dist/markdown.js

@@ -0,0 +1,194 @@
+/**
+ * The catalog rendered as markdown.
+ *
+ * Two consumers, one module. `scripts/build-skill.ts` writes the reference the
+ * agent skill ships, and `apps/web` serves a rule over HTTP so an agent that
+ * can only fetch a URL gets the same answer the CLI gives. Neither could
+ * import the other, and a second renderer would drift the first time a rule
+ * changed shape.
+ *
+ * Pure, and held to it: catalog.test.ts walks this module's imports the same
+ * way it walks detect()'s. No filesystem, no clock, so the file writing stays
+ * in the script.
+ */
+import { baselineShortLabel, resolveBaseline } from "./baseline.js";
+import { GUIDE_SOURCE, guideCommand, resolveGuides } from "./guides.js";
+import { rules } from "./rules/index.js";
+/**
+ * Where a rule is served as markdown.
+ *
+ * The second place the domain is written down, after apps/web/lib/site.ts.
+ * The catalog ships to npm and cannot import the website, so the two are tied
+ * together by a test in apps/web instead of by a shared constant.
+ */
+const RULE_MARKDOWN_BASE = "https://youmightnotneed.dev/rules";
+/** The markdown URL for one rule. */
+export function ruleMarkdownUrl(id) {
+    return `${RULE_MARKDOWN_BASE}/${id}.md`;
+}
+/**
+ * Codepoint order, not localeCompare: check-freshness byte-compares the
+ * generated reference, and collation differs by locale and by ICU build. A
+ * maintainer on lt_LT would otherwise regenerate a file that fails CI with no
+ * data change.
+ */
+function byText(a, b) {
+    if (a < b)
+        return -1;
+    if (a > b)
+        return 1;
+    return 0;
+}
+/**
+ * The index that makes the catalog useful before a dependency exists. Keyed by
+ * `agent.when`, which is the use case rather than the package name, so an
+ * agent about to build a carousel can find the rule without knowing that
+ * swiper is the package it was reaching for.
+ */
+export function renderUseCaseTable() {
+    const rows = [...rules]
+        .sort((a, b) => byText(a.agent.when, b.agent.when))
+        .map((rule) => {
+        const status = baselineShortLabel(resolveBaseline(rule).status);
+        return `| ${rule.agent.when} | ${rule.native} | ${status} | \`${rule.id}\` |`;
+    });
+    return [
+        "| Building | The platform does | Support | Rule |",
+        "| --- | --- | --- | --- |",
+        ...rows,
+    ].join("\n");
+}
+/**
+ * One rule, in full. The `unless` conditions are the point of this: they are
+ * what stops a finding from overstating itself, and until this existed they
+ * were reachable only through the CLI's --verbose or the MCP server.
+ */
+export function renderRuleMarkdown(rule) {
+    const baseline = resolveBaseline(rule);
+    const support = `${baselineShortLabel(baseline.status)}${baseline.limitedBy ? ` (capped by ${baseline.limitedBy.name})` : ""}`;
+    return `# ${rule.title}
+
+- **id**: \`${rule.id}\`
+- **native**: ${rule.native}
+- **support**: Baseline ${support}
+- **replaces**: ${rule.replaces.map((pkg) => `\`${pkg}\``).join(", ")}
+
+## When this applies
+
+${rule.agent.when}.
+
+A match is a starting point, not a verdict. A package in package.json is not
+evidence of what it is used for, so read the conditions below before changing
+anything.
+
+## Keep the dependency if any of these apply
+
+${rule.agent.unless.map((condition) => `- ${condition}`).join("\n")}
+
+## The swap
+
+\`\`\`
+${rule.agent.snippet}
+\`\`\`
+
+## How to implement it
+
+${renderGuides(rule)}
+`;
+}
+/**
+ * The hand-off from "which dependency can go" to "how to build the thing
+ * properly". IDs and links only: the catalog is a lookup table, so nothing
+ * here copies upstream prose. The attribution is what the licence asks for.
+ */
+function renderGuides(rule) {
+    const linkable = resolveGuides(rule).filter((guide) => guide.url !== null);
+    const source = `Guides come from ${GUIDE_SOURCE.owner}'s ${GUIDE_SOURCE.name} (${GUIDE_SOURCE.licence}), ${GUIDE_SOURCE.repo}.`;
+    if (linkable.length === 0) {
+        return `No guide covers this rule yet. ${source}`;
+    }
+    const links = linkable
+        .map((guide) => `- [${guide.id}](${guide.url}) (${guide.category})`)
+        .join("\n");
+    return `This catalog stops at the swap. These go through the implementation,
+the fallbacks and the platform quirks.
+
+${links}
+
+Pull them into context with:
+
+\`\`\`sh
+${guideCommand(linkable.map((guide) => guide.id))}
+\`\`\`
+
+${source}`;
+}
+/**
+ * Every rule with the packages it claims, one line each.
+ *
+ * The reference used to carry this inside a much longer per-rule listing.
+ * Dropping that listing took the package names with it, which left an agent
+ * holding a package.json and no network unable to answer the question the
+ * skill exists for. This is the same lookup in 1/8th of the lines.
+ */
+function renderPackageIndex() {
+    return [...rules]
+        .sort((a, b) => byText(a.id, b.id))
+        .map((rule) => `- \`${rule.id}\`: ${rule.replaces.join(", ")}`)
+        .join("\n");
+}
+/**
+ * The reference the agent skill loads on demand. Hybrid by design: the table
+ * works offline and with no network, and the per-rule detail is fetched, so
+ * the skill stops shipping a snapshot of prose that goes stale between
+ * releases.
+ */
+export function renderCatalogReference() {
+    const packageCount = new Set(rules.flatMap((rule) => rule.replaces)).size;
+    return `<!-- Generated by scripts/build-skill.ts. Do not edit by hand. -->
+<!-- Run \`pnpm refresh:skill\` to update. -->
+
+# The catalog
+
+Every rule, ${rules.length} of them, covering ${packageCount} npm packages.
+Support is the Baseline tier of the least-supported feature the replacement
+needs, so a rule reads as limited if any one part of it is.
+
+## By use case
+
+Read this before reaching for a package. The left column is the case the
+native approach covers, so it is searchable without knowing which library you
+were about to install.
+
+${renderUseCaseTable()}
+
+## Reading one rule
+
+A row is a starting point, not a verdict. Every rule also carries the
+conditions where the dependency is still right, the swap, and the guides that
+cover the implementation. Those are not in this file. Take the rule id from
+the table and fetch it:
+
+\`\`\`sh
+curl --fail-with-body -sS ${ruleMarkdownUrl("<id>")}
+\`\`\`
+
+That is always the live catalog, where this table is only as fresh as the
+version of the skill you have. The CLI answers the same question from a
+package name, sends nothing anywhere, and works offline once npx has fetched
+it:
+
+\`\`\`sh
+npx -y youmightnotneed@latest --package <name> --verbose
+\`\`\`
+
+## By package
+
+Which rule covers a package you already have. This is the only lookup here
+that needs no network. It gives the rule id and stops there: the conditions
+for keeping the dependency come from the URL or the CLI above.
+
+${renderPackageIndex()}
+`;
+}
+//# sourceMappingURL=markdown.js.map

package/dist/markdown.js.map

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

package/dist/rules/height-animation.js

@@ -44,6 +44,6 @@ export const heightAnimation = {
 .panel { height: 0; overflow: hidden; transition: height 0.3s; }
 .panel[data-open] { height: auto; }`,
     },
-    guides: ["animate-to-intrinsic-sizes"],
+    guides: ["animate-to-intrinsic-sizes", "calculate-with-intrinsic-sizes"],
 };
 //# sourceMappingURL=height-animation.js.map

package/dist/rules/height-animation.js.map

@@ -1 +1 @@
-{"version":3,"file":"height-animation.js","sourceRoot":"","sources":["../../src/rules/height-animation.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,eAAe,GAAS;IACnC,EAAE,EAAE,uBAAuB;IAC3B,KAAK,EAAE,0BAA0B;IACjC,QAAQ,EAAE,WAAW;IACrB,QAAQ,EAAE,CAAC,gBAAgB,EAAE,sBAAsB,EAAE,uBAAuB,CAAC;IAC7E,UAAU,EAAE,CAAC,kBAAkB,EAAE,WAAW,CAAC;IAC7C,MAAM,EAAE,kDAAkD;IAC1D,KAAK,EAAE;QACL,SAAS,EACP,ybAAyb;QAC3b,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;EAsBX;QACE,MAAM,EAAE,4DAA4D;KACrE;IACD,KAAK,EAAE;QACL,IAAI,EAAE,qEAAqE;QAC3E,MAAM,EAAE;YACN,4NAA4N;YAC5N,6IAA6I;YAC7I,gGAAgG;YAChG,8GAA8G;SAC/G;QACD,OAAO,EAAE;;oCAEuB;KACjC;IACD,MAAM,EAAE,CAAC,4BAA4B,CAAC;CACvC,CAAC"}
+{"version":3,"file":"height-animation.js","sourceRoot":"","sources":["../../src/rules/height-animation.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,eAAe,GAAS;IACnC,EAAE,EAAE,uBAAuB;IAC3B,KAAK,EAAE,0BAA0B;IACjC,QAAQ,EAAE,WAAW;IACrB,QAAQ,EAAE,CAAC,gBAAgB,EAAE,sBAAsB,EAAE,uBAAuB,CAAC;IAC7E,UAAU,EAAE,CAAC,kBAAkB,EAAE,WAAW,CAAC;IAC7C,MAAM,EAAE,kDAAkD;IAC1D,KAAK,EAAE;QACL,SAAS,EACP,ybAAyb;QAC3b,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;EAsBX;QACE,MAAM,EAAE,4DAA4D;KACrE;IACD,KAAK,EAAE;QACL,IAAI,EAAE,qEAAqE;QAC3E,MAAM,EAAE;YACN,4NAA4N;YAC5N,6IAA6I;YAC7I,gGAAgG;YAChG,8GAA8G;SAC/G;QACD,OAAO,EAAE;;oCAEuB;KACjC;IACD,MAAM,EAAE,CAAC,4BAA4B,EAAE,gCAAgC,CAAC;CACzE,CAAC"}

package/dist/search.d.ts

@@ -0,0 +1,29 @@
+import type { Rule } from "./schema.ts";
+export interface SearchResult {
+    rule: Rule;
+    /**
+     * The packages from `rule.replaces` the query matched, in the order the rule
+     * lists them. Empty when the rule matched by title or native feature alone,
+     * which is what tells a surface whether it has anything to show underneath.
+     */
+    packages: readonly string[];
+}
+export interface SearchOptions {
+    /** Defaults to the whole catalog. Present so tests can pass their own. */
+    rules?: readonly Rule[];
+}
+/**
+ * Two characters. One is a substring of most of the catalog, and a list of
+ * everything is what `/rules` is for.
+ *
+ * Exported because an empty result means two different things. A surface that
+ * cannot tell "no rule covers this" from "the search declined to run" tells
+ * the reader the catalog has nothing for a query it never ran.
+ */
+export declare const MIN_QUERY_LENGTH = 2;
+/**
+ * Ranks rules against a query. Returns an empty array for a query too short to
+ * narrow anything down.
+ */
+export declare function searchRules(query: string, options?: SearchOptions): SearchResult[];
+//# sourceMappingURL=search.d.ts.map

package/dist/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAqBxC,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,IAAI,CAAC;IACX;;;;OAIG;IACH,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,0EAA0E;IAC1E,KAAK,CAAC,EAAE,SAAS,IAAI,EAAE,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAsClC;;;GAGG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,aAAkB,GAC1B,YAAY,EAAE,CAyBhB"}

package/dist/search.js

@@ -0,0 +1,84 @@
+import { rules as defaultRules } from "./rules/index.js";
+/**
+ * Free-text lookup over the catalog.
+ *
+ * `detect()` answers "here is my package.json, what applies", which needs the
+ * whole file. This answers the question someone arrives with instead: one name
+ * they already have in their head. The catalog covers far more package names
+ * than it has rules, and a rule is titled after the native feature rather than
+ * after any package it replaces, so most of those names appear nowhere a
+ * reader can find them.
+ *
+ * Pure, like `detect()`. It reads nothing but the rules handed to it.
+ */
+/** Why a rule came back, strongest first. Also its sort key. */
+const EXACT_PACKAGE = 4;
+const PACKAGE_PREFIX = 3;
+const PACKAGE_SUBSTRING = 2;
+const RULE_TEXT = 1;
+/**
+ * Two characters. One is a substring of most of the catalog, and a list of
+ * everything is what `/rules` is for.
+ *
+ * Exported because an empty result means two different things. A surface that
+ * cannot tell "no rule covers this" from "the search declined to run" tells
+ * the reader the catalog has nothing for a query it never ran.
+ */
+export const MIN_QUERY_LENGTH = 2;
+function scorePackage(name, query) {
+    const lower = name.toLowerCase();
+    if (lower === query)
+        return EXACT_PACKAGE;
+    if (lower.startsWith(query))
+        return PACKAGE_PREFIX;
+    if (lower.includes(query))
+        return PACKAGE_SUBSTRING;
+    return 0;
+}
+/**
+ * Scores one rule. A rule that matches by package never falls back to its
+ * title, so the packages array stays a list of what the reader actually
+ * typed rather than everything the rule happens to replace.
+ */
+function scoreRule(rule, needle) {
+    const packages = [];
+    let score = 0;
+    for (const name of rule.replaces) {
+        const packageScore = scorePackage(name, needle);
+        if (packageScore === 0)
+            continue;
+        packages.push(name);
+        score = Math.max(score, packageScore);
+    }
+    if (score > 0)
+        return { packages, score };
+    const matchesText = rule.title.toLowerCase().includes(needle) ||
+        rule.native.toLowerCase().includes(needle);
+    return { packages, score: matchesText ? RULE_TEXT : 0 };
+}
+/**
+ * Ranks rules against a query. Returns an empty array for a query too short to
+ * narrow anything down.
+ */
+export function searchRules(query, options = {}) {
+    const needle = query.trim().toLowerCase();
+    if (needle.length < MIN_QUERY_LENGTH)
+        return [];
+    const scored = [];
+    for (const rule of options.rules ?? defaultRules) {
+        const { packages, score } = scoreRule(rule, needle);
+        if (score === 0)
+            continue;
+        scored.push({ result: { rule, packages }, score });
+    }
+    /*
+     * Ties break on how much of the rule the query hit, then on title, so the
+     * order is stable rather than dependent on the order rules/index.ts happens
+     * to list them in.
+     */
+    scored.sort((a, b) => b.score - a.score ||
+        b.result.packages.length - a.result.packages.length ||
+        a.result.rule.title.localeCompare(b.result.rule.title));
+    return scored.map((entry) => entry.result);
+}
+//# sourceMappingURL=search.js.map

package/dist/search.js.map

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

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@jomae/catalog",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "type": "module",
   "description": "The rule catalog behind youmightnotneed. Maps npm packages to the CSS, HTML, or Web API that replaces them.",
   "license": "MIT",
   "author": "Johannes Maendle",
-  "homepage": "https://youmightnotneed-web.vercel.app",
+  "homepage": "https://youmightnotneed.dev",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/jomaendle/youmightnotneed.git",