@jomae/catalog 0.4.0 → 0.7.0

package/dist/generated/support-claims.js

@@ -0,0 +1,69 @@
+// Generated by scripts/refresh-support.ts. Do not edit by hand.
+// Run `pnpm refresh:support` to update.
+/**
+ * Every browser version the catalog's prose cites, resolved from web-features
+ * and MDN's browser-compat-data. No rule writes a version number by hand.
+ */
+export const supportClaims = {
+    "generatedOn": "2026-09-06",
+    "webFeaturesVersion": "3.36.0",
+    "bcdVersion": "8.1.0",
+    "claims": {
+        "chrome:abortsignal-timeout": "124",
+        "chrome:api.Crypto.randomUUID": "92",
+        "chrome:api.ResizeObserverEntry.devicePixelContentBoxSize": "84",
+        "chrome:api.URLSearchParams": "49",
+        "chrome:css.properties.anchor-name": "125",
+        "chrome:css.properties.content-visibility.auto": "85",
+        "chrome:css.properties.overscroll-behavior.contain": "63",
+        "chrome:css.properties.resize.block": "118",
+        "chrome:css.properties.text-box": "133",
+        "chrome:field-sizing": "123",
+        "chrome:inert": "102",
+        "chrome:javascript.builtins.Intl.NumberFormat.NumberFormat.options_parameter.options_unit_parameter": "77",
+        "chrome:overscroll-behavior": "144",
+        "chrome:scroll-driven-animations": "115",
+        "chrome:speech-recognition": "139",
+        "chrome:url": "32",
+        "firefox:abortsignal-timeout": "100",
+        "firefox:api.Clipboard.writeText": "63",
+        "firefox:api.Crypto.randomUUID": "95",
+        "firefox:api.ResizeObserverEntry.devicePixelContentBoxSize": "108",
+        "firefox:api.URLSearchParams": "29",
+        "firefox:css.properties.anchor-name": "147",
+        "firefox:css.properties.content-visibility.auto": "125",
+        "firefox:css.properties.overscroll-behavior.contain": "59",
+        "firefox:css.properties.resize.block": "63",
+        "firefox:css.properties.text-box": "154",
+        "firefox:field-sizing": "152",
+        "firefox:highlight": "149",
+        "firefox:inert": "112",
+        "firefox:javascript.builtins.Intl.NumberFormat.NumberFormat.options_parameter.options_unit_parameter": "78",
+        "firefox:overscroll-behavior": "150",
+        "nodejs:api.EventTarget": "15.0.0",
+        "nodejs:api.fetch": "18.0.0",
+        "safari:abortsignal-timeout": "16",
+        "safari:api.Clipboard.writeText": "13.1",
+        "safari:api.Crypto.randomUUID": "15.4",
+        "safari:api.Element.requestFullscreen": "16.4",
+        "safari:api.EventTarget.EventTarget": "14",
+        "safari:api.EventTarget.addEventListener.options_parameter.options_signal_parameter": "15",
+        "safari:api.URLSearchParams": "10.1",
+        "safari:api.WakeLock": "16.4",
+        "safari:css.properties.anchor-name": "26",
+        "safari:css.properties.content-visibility.auto": "26",
+        "safari:css.properties.overscroll-behavior.contain": "16",
+        "safari:css.properties.resize.block": "16",
+        "safari:css.properties.text-box": "18.2",
+        "safari:events": "1",
+        "safari:field-sizing": "26.2",
+        "safari:highlight": "17.2",
+        "safari:inert": "15.5",
+        "safari:javascript.builtins.Intl.NumberFormat.NumberFormat.options_parameter.options_unit_parameter": "14.1",
+        "safari:scroll-driven-animations": "26",
+        "safari:url": "7",
+        "safari:web-cryptography": "11",
+        "safari_ios:api.WakeLock": "18.4"
+    }
+};
+//# sourceMappingURL=support-claims.js.map

package/dist/generated/support-claims.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"support-claims.js","sourceRoot":"","sources":["../../src/generated/support-claims.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,wCAAwC;AAYxC;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAkB;IAC1C,aAAa,EAAE,YAAY;IAC3B,oBAAoB,EAAE,QAAQ;IAC9B,YAAY,EAAE,OAAO;IACrB,QAAQ,EAAE;QACR,4BAA4B,EAAE,KAAK;QACnC,8BAA8B,EAAE,IAAI;QACpC,0DAA0D,EAAE,IAAI;QAChE,4BAA4B,EAAE,IAAI;QAClC,mCAAmC,EAAE,KAAK;QAC1C,+CAA+C,EAAE,IAAI;QACrD,mDAAmD,EAAE,IAAI;QACzD,oCAAoC,EAAE,KAAK;QAC3C,gCAAgC,EAAE,KAAK;QACvC,qBAAqB,EAAE,KAAK;QAC5B,cAAc,EAAE,KAAK;QACrB,oGAAoG,EAAE,IAAI;QAC1G,4BAA4B,EAAE,KAAK;QACnC,iCAAiC,EAAE,KAAK;QACxC,2BAA2B,EAAE,KAAK;QAClC,YAAY,EAAE,IAAI;QAClB,6BAA6B,EAAE,KAAK;QACpC,iCAAiC,EAAE,IAAI;QACvC,+BAA+B,EAAE,IAAI;QACrC,2DAA2D,EAAE,KAAK;QAClE,6BAA6B,EAAE,IAAI;QACnC,oCAAoC,EAAE,KAAK;QAC3C,gDAAgD,EAAE,KAAK;QACvD,oDAAoD,EAAE,IAAI;QAC1D,qCAAqC,EAAE,IAAI;QAC3C,iCAAiC,EAAE,KAAK;QACxC,sBAAsB,EAAE,KAAK;QAC7B,mBAAmB,EAAE,KAAK;QAC1B,eAAe,EAAE,KAAK;QACtB,qGAAqG,EAAE,IAAI;QAC3G,6BAA6B,EAAE,KAAK;QACpC,wBAAwB,EAAE,QAAQ;QAClC,kBAAkB,EAAE,QAAQ;QAC5B,4BAA4B,EAAE,IAAI;QAClC,gCAAgC,EAAE,MAAM;QACxC,8BAA8B,EAAE,MAAM;QACtC,sCAAsC,EAAE,MAAM;QAC9C,oCAAoC,EAAE,IAAI;QAC1C,oFAAoF,EAAE,IAAI;QAC1F,4BAA4B,EAAE,MAAM;QACpC,qBAAqB,EAAE,MAAM;QAC7B,mCAAmC,EAAE,IAAI;QACzC,+CAA+C,EAAE,IAAI;QACrD,mDAAmD,EAAE,IAAI;QACzD,oCAAoC,EAAE,IAAI;QAC1C,gCAAgC,EAAE,MAAM;QACxC,eAAe,EAAE,GAAG;QACpB,qBAAqB,EAAE,MAAM;QAC7B,kBAAkB,EAAE,MAAM;QAC1B,cAAc,EAAE,MAAM;QACtB,oGAAoG,EAAE,MAAM;QAC5G,iCAAiC,EAAE,IAAI;QACvC,YAAY,EAAE,GAAG;QACjB,yBAAyB,EAAE,IAAI;QAC/B,yBAAyB,EAAE,MAAM;KAClC;CACF,CAAC"}

package/dist/guides.d.ts

@@ -0,0 +1,46 @@
+import { type GuideSnapshot, guideSnapshot } from "./generated/guides.ts";
+import type { Rule } from "./schema.ts";
+/**
+ * Resolution for the long-form guides a rule can point at.
+ *
+ * The catalog answers which dependency has a native equivalent. It does not
+ * try to be a tutorial, and the agent projection has a token budget that a
+ * tutorial would blow. GoogleChrome/modern-web-guidance already writes the
+ * long form, keyed by use case rather than by package, so a rule stores guide
+ * IDs and this resolves them into a URL and a retrieval command.
+ *
+ * Pure, like everything else the surfaces share. IDs are checked against a
+ * committed snapshot (`pnpm refresh:guides`), so a guide that moves upstream
+ * fails a test rather than shipping as a dead link.
+ */
+/** Where the guides come from, shown wherever they are linked. */
+export declare const GUIDE_SOURCE: {
+    readonly name: "modern-web-guidance";
+    readonly owner: "Google Chrome";
+    readonly licence: "Apache-2.0";
+    readonly repo: string;
+    readonly version: string;
+    readonly fetchedOn: string;
+};
+export interface ResolvedGuide {
+    id: string;
+    /** The category directory, e.g. "ui-behaviors". Empty when unresolved. */
+    category: string;
+    /** Permalink to the markdown, or null when the ID is not in the snapshot. */
+    url: string | null;
+    /** What to run to pull the guide into an agent's context. */
+    command: string;
+}
+/** The command their SKILL.md documents. Kept in one place. */
+export declare function guideCommand(ids: readonly string[]): string;
+/**
+ * Looks up one guide. Returns a `url` of null for an unknown ID rather than
+ * throwing, matching resolveFeature()'s behaviour for an unknown feature.
+ */
+export declare function resolveGuide(id: string): ResolvedGuide;
+/** Every guide a rule points at, in the order the rule lists them. */
+export declare function resolveGuides(rule: Rule): ResolvedGuide[];
+/** True when the snapshot knows this ID. Used by the tests and the scripts. */
+export declare function isKnownGuide(id: string): boolean;
+export { type GuideSnapshot, guideSnapshot };
+//# sourceMappingURL=guides.d.ts.map

package/dist/guides.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guides.d.ts","sourceRoot":"","sources":["../src/guides.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAExC;;;;;;;;;;;;GAYG;AAEH,kEAAkE;AAClE,eAAO,MAAM,YAAY;aACvB,IAAI,EAAE,qBAAqB;aAC3B,KAAK,EAAE,eAAe;aACtB,OAAO,EAAE,YAAY;aACrB,IAAI;aACJ,OAAO;aACP,SAAS;CACD,CAAC;AAEX,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,0EAA0E;IAC1E,QAAQ,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,+DAA+D;AAC/D,wBAAgB,YAAY,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAE3D;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,CAatD;AAED,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,aAAa,EAAE,CAEzD;AAED,+EAA+E;AAC/E,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED,OAAO,EAAE,KAAK,aAAa,EAAE,aAAa,EAAE,CAAC"}

package/dist/guides.js

@@ -0,0 +1,55 @@
+import { guideSnapshot } from "./generated/guides.js";
+/**
+ * Resolution for the long-form guides a rule can point at.
+ *
+ * The catalog answers which dependency has a native equivalent. It does not
+ * try to be a tutorial, and the agent projection has a token budget that a
+ * tutorial would blow. GoogleChrome/modern-web-guidance already writes the
+ * long form, keyed by use case rather than by package, so a rule stores guide
+ * IDs and this resolves them into a URL and a retrieval command.
+ *
+ * Pure, like everything else the surfaces share. IDs are checked against a
+ * committed snapshot (`pnpm refresh:guides`), so a guide that moves upstream
+ * fails a test rather than shipping as a dead link.
+ */
+/** Where the guides come from, shown wherever they are linked. */
+export const GUIDE_SOURCE = {
+    name: "modern-web-guidance",
+    owner: "Google Chrome",
+    licence: "Apache-2.0",
+    repo: guideSnapshot.repo,
+    version: guideSnapshot.version,
+    fetchedOn: guideSnapshot.fetchedOn,
+};
+/** The command their SKILL.md documents. Kept in one place. */
+export function guideCommand(ids) {
+    return `npx -y modern-web-guidance@latest retrieve "${ids.join(",")}"`;
+}
+/**
+ * Looks up one guide. Returns a `url` of null for an unknown ID rather than
+ * throwing, matching resolveFeature()'s behaviour for an unknown feature.
+ */
+export function resolveGuide(id) {
+    // Object.hasOwn, not `in` or a bare read: the snapshot is a plain object, so
+    // an id like "constructor" or "toString" would otherwise resolve to
+    // something off Object.prototype and build a nonsense URL from it.
+    const category = isKnownGuide(id) ? guideSnapshot.guides[id] : undefined;
+    return {
+        id,
+        category: category ?? "",
+        url: category
+            ? `${guideSnapshot.repo}/blob/main/skills/modern-web-guidance/guides/${category}/${id}.md`
+            : null,
+        command: guideCommand([id]),
+    };
+}
+/** Every guide a rule points at, in the order the rule lists them. */
+export function resolveGuides(rule) {
+    return (rule.guides ?? []).map(resolveGuide);
+}
+/** True when the snapshot knows this ID. Used by the tests and the scripts. */
+export function isKnownGuide(id) {
+    return Object.hasOwn(guideSnapshot.guides, id);
+}
+export { guideSnapshot };
+//# sourceMappingURL=guides.js.map

package/dist/guides.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guides.js","sourceRoot":"","sources":["../src/guides.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAG1E;;;;;;;;;;;;GAYG;AAEH,kEAAkE;AAClE,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,qBAAqB;IAC3B,KAAK,EAAE,eAAe;IACtB,OAAO,EAAE,YAAY;IACrB,IAAI,EAAE,aAAa,CAAC,IAAI;IACxB,OAAO,EAAE,aAAa,CAAC,OAAO;IAC9B,SAAS,EAAE,aAAa,CAAC,SAAS;CAC1B,CAAC;AAYX,+DAA+D;AAC/D,MAAM,UAAU,YAAY,CAAC,GAAsB;IACjD,OAAO,+CAA+C,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;AACzE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,EAAU;IACrC,6EAA6E;IAC7E,oEAAoE;IACpE,mEAAmE;IACnE,MAAM,QAAQ,GAAG,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACzE,OAAO;QACL,EAAE;QACF,QAAQ,EAAE,QAAQ,IAAI,EAAE;QACxB,GAAG,EAAE,QAAQ;YACX,CAAC,CAAC,GAAG,aAAa,CAAC,IAAI,gDAAgD,QAAQ,IAAI,EAAE,KAAK;YAC1F,CAAC,CAAC,IAAI;QACR,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC;KAC5B,CAAC;AACJ,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,aAAa,CAAC,IAAU;IACtC,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;AAC/C,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,YAAY,CAAC,EAAU;IACrC,OAAO,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACjD,CAAC;AAED,OAAO,EAAsB,aAAa,EAAE,CAAC"}

package/dist/history.d.ts

@@ -0,0 +1,11 @@
+import type { BaselineHistoryEntry } from "./generated/baseline-history.ts";
+export interface TierShare {
+    widely: number;
+    newly: number;
+    limited: number;
+    unknown: number;
+}
+/** Each tier's percentage share of the catalog at that point. Computed, not
+ * stored, so the chart isn't fooled by the catalog simply growing. */
+export declare function tierShareOf(entry: BaselineHistoryEntry): TierShare;
+//# sourceMappingURL=history.d.ts.map

package/dist/history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../src/history.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAE5E,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;sEACsE;AACtE,wBAAgB,WAAW,CAAC,KAAK,EAAE,oBAAoB,GAAG,SAAS,CASlE"}

package/dist/history.js

@@ -0,0 +1,14 @@
+/** Each tier's percentage share of the catalog at that point. Computed, not
+ * stored, so the chart isn't fooled by the catalog simply growing. */
+export function tierShareOf(entry) {
+    const { ruleCount, tally } = entry;
+    if (ruleCount === 0)
+        return { widely: 0, newly: 0, limited: 0, unknown: 0 };
+    return {
+        widely: (tally.widely / ruleCount) * 100,
+        newly: (tally.newly / ruleCount) * 100,
+        limited: (tally.limited / ruleCount) * 100,
+        unknown: (tally.unknown / ruleCount) * 100,
+    };
+}
+//# sourceMappingURL=history.js.map

package/dist/history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.js","sourceRoot":"","sources":["../src/history.ts"],"names":[],"mappings":"AASA;sEACsE;AACtE,MAAM,UAAU,WAAW,CAAC,KAA2B;IACrD,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;IACnC,IAAI,SAAS,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IAC5E,OAAO;QACL,MAAM,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,GAAG,GAAG;QACxC,KAAK,EAAE,CAAC,KAAK,CAAC,KAAK,GAAG,SAAS,CAAC,GAAG,GAAG;QACtC,OAAO,EAAE,CAAC,KAAK,CAAC,OAAO,GAAG,SAAS,CAAC,GAAG,GAAG;QAC1C,OAAO,EAAE,CAAC,KAAK,CAAC,OAAO,GAAG,SAAS,CAAC,GAAG,GAAG;KAC3C,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -4,10 +4,16 @@
  * The rule catalog, the pure detection function, and the Baseline resolution
  * that sits between them. Every surface is a thin adapter over this package.
  */
-export { BASELINE_DATA_DATE, type BaselineInfo, baselineLabel, baselineRank, baselineShortLabel, combinedSupport, compareBaseline, type ResolvedFeature, resolveBaseline, resolveFeature, TRACKED_BROWSERS, type TrackedBrowser, WEB_FEATURES_VERSION, } from "./baseline.ts";
+export { BASELINE_DATA_DATE, type BaselineInfo, baselineLabel, baselineRank, baselineShortLabel, combinedSupport, compareBaseline, hasNoVersions, type ResolvedFeature, resolveBaseline, resolveFeature, TRACKED_BROWSERS, type TrackedBrowser, unpublishedSupport, WEB_FEATURES_VERSION, } from "./baseline.ts";
+export { CATEGORIES, CATEGORIES_BY_ID, type CategoryId, categorySchema, } from "./categories.ts";
 export { analyze, DEPENDENCY_FIELDS, type DependencyField, type DetectOptions, detect, type Finding, type MatchedPackage, type PackageJsonLike, type Report, type Summary, sortFindings, summarize, } from "./detect.ts";
 export { formatBytes, formatConditional, formatHeadline, formatList, } from "./format.ts";
+export { type BaselineHistory, type BaselineHistoryEntry, baselineHistory, } from "./generated/baseline-history.ts";
 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,KAAK,eAAe,EACpB,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,KAAK,cAAc,EACnB,oBAAoB,GACrB,MAAM,eAAe,CAAC;AACvB,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,EAAE,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACvE,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

@@ -4,10 +4,16 @@
  * The rule catalog, the pure detection function, and the Baseline resolution
  * that sits between them. Every surface is a thin adapter over this package.
  */
-export { BASELINE_DATA_DATE, baselineLabel, baselineRank, baselineShortLabel, combinedSupport, compareBaseline, resolveBaseline, resolveFeature, TRACKED_BROWSERS, WEB_FEATURES_VERSION, } from "./baseline.js";
+export { BASELINE_DATA_DATE, baselineLabel, baselineRank, baselineShortLabel, combinedSupport, compareBaseline, hasNoVersions, resolveBaseline, resolveFeature, TRACKED_BROWSERS, unpublishedSupport, WEB_FEATURES_VERSION, } from "./baseline.js";
+export { CATEGORIES, CATEGORIES_BY_ID, categorySchema, } from "./categories.js";
 export { analyze, DEPENDENCY_FIELDS, detect, sortFindings, summarize, } from "./detect.js";
 export { formatBytes, formatConditional, formatHeadline, formatList, } from "./format.js";
+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,EAEf,eAAe,EACf,cAAc,EACd,gBAAgB,EAEhB,oBAAoB,GACrB,MAAM,eAAe,CAAC;AACvB,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,EAAE,YAAY,EAAqB,MAAM,sBAAsB,CAAC;AACvE,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/abort-controller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"abort-controller.d.ts","sourceRoot":"","sources":["../../src/rules/abort-controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEzC,eAAO,MAAM,eAAe,EAAE,IAwB7B,CAAC"}
+{"version":3,"file":"abort-controller.d.ts","sourceRoot":"","sources":["../../src/rules/abort-controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEzC,eAAO,MAAM,eAAe,EAAE,IAyB7B,CAAC"}

package/dist/rules/abort-controller.js

@@ -1,7 +1,8 @@
 export const abortController = {
     id: "abort-controller",
     title: "Cancelling async work",
-    replaces: ["p-cancelable", "cancelable-promise"],
+    category: "async-data",
+    replaces: ["p-cancelable", "cancelable-promise", "abortcontroller-polyfill"],
     featureIds: ["aborting"],
     native: "AbortController and AbortSignal",
     human: {

package/dist/rules/abort-controller.js.map

@@ -1 +1 @@
-{"version":3,"file":"abort-controller.js","sourceRoot":"","sources":["../../src/rules/abort-controller.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,eAAe,GAAS;IACnC,EAAE,EAAE,kBAAkB;IACtB,KAAK,EAAE,uBAAuB;IAC9B,QAAQ,EAAE,CAAC,cAAc,EAAE,oBAAoB,CAAC;IAChD,UAAU,EAAE,CAAC,UAAU,CAAC;IACxB,MAAM,EAAE,iCAAiC;IACzC,KAAK,EAAE;QACL,SAAS,EACP,6TAA6T;QAC/T,OAAO,EAAE;;;oBAGO;QAChB,MAAM,EAAE,kEAAkE;KAC3E;IACD,KAAK,EAAE;QACL,IAAI,EAAE,qEAAqE;QAC3E,MAAM,EAAE;YACN,iNAAiN;YACjN,8IAA8I;SAC/I;QACD,OAAO,EAAE;2CAC8B;KACxC;CACF,CAAC"}
+{"version":3,"file":"abort-controller.js","sourceRoot":"","sources":["../../src/rules/abort-controller.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,eAAe,GAAS;IACnC,EAAE,EAAE,kBAAkB;IACtB,KAAK,EAAE,uBAAuB;IAC9B,QAAQ,EAAE,YAAY;IACtB,QAAQ,EAAE,CAAC,cAAc,EAAE,oBAAoB,EAAE,0BAA0B,CAAC;IAC5E,UAAU,EAAE,CAAC,UAAU,CAAC;IACxB,MAAM,EAAE,iCAAiC;IACzC,KAAK,EAAE;QACL,SAAS,EACP,6TAA6T;QAC/T,OAAO,EAAE;;;oBAGO;QAChB,MAAM,EAAE,kEAAkE;KAC3E;IACD,KAAK,EAAE;QACL,IAAI,EAAE,qEAAqE;QAC3E,MAAM,EAAE;YACN,iNAAiN;YACjN,8IAA8I;SAC/I;QACD,OAAO,EAAE;2CAC8B;KACxC;CACF,CAAC"}

package/dist/rules/accordion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"accordion.d.ts","sourceRoot":"","sources":["../../src/rules/accordion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEzC,eAAO,MAAM,SAAS,EAAE,IAmDvB,CAAC"}
+{"version":3,"file":"accordion.d.ts","sourceRoot":"","sources":["../../src/rules/accordion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEzC,eAAO,MAAM,SAAS,EAAE,IAsDvB,CAAC"}

package/dist/rules/accordion.js

@@ -1,6 +1,7 @@
 export const accordion = {
     id: "exclusive-accordion",
     title: "Accordions",
+    category: "forms",
     replaces: ["react-accessible-accordion", "react-collapsible", "accordion-js"],
     featureIds: ["details-name"],
     native: "<details name> for an exclusive accordion",
@@ -33,6 +34,7 @@ export const accordion = {
     agent: {
         when: "building an FAQ or accordion where opening one panel should close the others",
         unless: [
+            "Your support target predates the name attribute on <details>. Older browsers ignore it silently rather than failing, so every panel opens independently and the one behaviour this rule promises is the one that quietly does not happen.",
             "You need to animate the panel height. That needs interpolate-size or calc-size(), which is Chromium-only today.",
             "You need several panels open at once with a controlled open state driven by application logic. Drop the name attribute for independent panels, but co-ordinated state still needs JavaScript.",
             "You need the header to be something other than a summary element, for example a heading that also holds a separate action button.",
@@ -47,5 +49,6 @@ export const accordion = {
   <p>Body</p>
 </details>`,
     },
+    guides: ["search-hidden-content"],
 };
 //# sourceMappingURL=accordion.js.map

package/dist/rules/accordion.js.map

@@ -1 +1 @@
-{"version":3,"file":"accordion.js","sourceRoot":"","sources":["../../src/rules/accordion.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,SAAS,GAAS;IAC7B,EAAE,EAAE,qBAAqB;IACzB,KAAK,EAAE,YAAY;IACnB,QAAQ,EAAE,CAAC,4BAA4B,EAAE,mBAAmB,EAAE,cAAc,CAAC;IAC7E,UAAU,EAAE,CAAC,cAAc,CAAC;IAC5B,MAAM,EAAE,2CAA2C;IACnD,KAAK,EAAE;QACL,SAAS,EACP,2WAA2W;QAC7W,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;SAqBJ;QACL,MAAM,EACJ,wEAAwE;KAC3E;IACD,KAAK,EAAE;QACL,IAAI,EAAE,8EAA8E;QACpF,MAAM,EAAE;YACN,iHAAiH;YACjH,+LAA+L;YAC/L,mIAAmI;YACnI,kHAAkH;SACnH;QACD,OAAO,EAAE;;;;;;;WAOF;KACR;CACF,CAAC"}
+{"version":3,"file":"accordion.js","sourceRoot":"","sources":["../../src/rules/accordion.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,SAAS,GAAS;IAC7B,EAAE,EAAE,qBAAqB;IACzB,KAAK,EAAE,YAAY;IACnB,QAAQ,EAAE,OAAO;IACjB,QAAQ,EAAE,CAAC,4BAA4B,EAAE,mBAAmB,EAAE,cAAc,CAAC;IAC7E,UAAU,EAAE,CAAC,cAAc,CAAC;IAC5B,MAAM,EAAE,2CAA2C;IACnD,KAAK,EAAE;QACL,SAAS,EACP,2WAA2W;QAC7W,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;SAqBJ;QACL,MAAM,EACJ,wEAAwE;KAC3E;IACD,KAAK,EAAE;QACL,IAAI,EAAE,8EAA8E;QACpF,MAAM,EAAE;YACN,2OAA2O;YAC3O,iHAAiH;YACjH,+LAA+L;YAC/L,mIAAmI;YACnI,kHAAkH;SACnH;QACD,OAAO,EAAE;;;;;;;WAOF;KACR;IACD,MAAM,EAAE,CAAC,uBAAuB,CAAC;CAClC,CAAC"}

package/dist/rules/array-grouping.d.ts

@@ -0,0 +1,3 @@
+import type { Rule } from "../schema.ts";
+export declare const arrayGrouping: Rule;
+//# sourceMappingURL=array-grouping.d.ts.map

package/dist/rules/array-grouping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"array-grouping.d.ts","sourceRoot":"","sources":["../../src/rules/array-grouping.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEzC,eAAO,MAAM,aAAa,EAAE,IA6B3B,CAAC"}

package/dist/rules/array-grouping.js

@@ -0,0 +1,29 @@
+export const arrayGrouping = {
+    id: "array-grouping",
+    title: "Grouping a list by key",
+    category: "async-data",
+    replaces: ["lodash.groupby", "just-group-by", "group-array"],
+    featureIds: ["array-group"],
+    native: "Object.groupBy() and Map.groupBy()",
+    human: {
+        explainer: 'Grouping a list by some property of each item is one reduce call people would rather not write twice, which is why the single-purpose packages exist. Object.groupBy() does it directly and returns a null-prototype object, so a key like "constructor" cannot collide with anything inherited. Map.groupBy() is the same for keys that are objects or anything else a plain object would stringify.',
+        snippet: `const byStatus = Object.groupBy(orders, (order) => order.status);
+// { open: [...], shipped: [...] }
+
+// Keys that are not strings keep their identity in a Map.
+const byCustomer = Map.groupBy(orders, (order) => order.customer);`,
+        mdnUrl: "https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/groupBy",
+    },
+    agent: {
+        when: "bucketing an array into groups keyed by a property of each item",
+        unless: [
+            "Your support target predates Array grouping becoming Baseline newly available in March 2024, in which case a reduce call or the library is the fallback.",
+            "You pass lodash a property name string rather than a function. Object.groupBy always takes a callback, so every call site gains an arrow function.",
+            "You depend on the result having Object.prototype. Object.groupBy returns a null-prototype object, so hasOwnProperty, toString and a plain {...spread} into a class all behave differently.",
+            "The package is a lodash.* module already shared with other code you are keeping, where removing one of them changes nothing about what ships.",
+            "You need the grouping to preserve a specific key order or to sort as it goes, which neither method offers.",
+        ],
+        snippet: "const byStatus = Object.groupBy(items, (item) => item.status);",
+    },
+};
+//# sourceMappingURL=array-grouping.js.map

package/dist/rules/array-grouping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"array-grouping.js","sourceRoot":"","sources":["../../src/rules/array-grouping.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,aAAa,GAAS;IACjC,EAAE,EAAE,gBAAgB;IACpB,KAAK,EAAE,wBAAwB;IAC/B,QAAQ,EAAE,YAAY;IACtB,QAAQ,EAAE,CAAC,gBAAgB,EAAE,eAAe,EAAE,aAAa,CAAC;IAC5D,UAAU,EAAE,CAAC,aAAa,CAAC;IAC3B,MAAM,EAAE,oCAAoC;IAC5C,KAAK,EAAE;QACL,SAAS,EACP,uYAAuY;QACzY,OAAO,EAAE;;;;mEAIsD;QAC/D,MAAM,EACJ,iGAAiG;KACpG;IACD,KAAK,EAAE;QACL,IAAI,EAAE,iEAAiE;QACvE,MAAM,EAAE;YACN,0JAA0J;YAC1J,oJAAoJ;YACpJ,4LAA4L;YAC5L,+IAA+I;YAC/I,4GAA4G;SAC7G;QACD,OAAO,EAAE,gEAAgE;KAC1E;CACF,CAAC"}

package/dist/rules/aspect-ratio.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"aspect-ratio.d.ts","sourceRoot":"","sources":["../../src/rules/aspect-ratio.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEzC,eAAO,MAAM,WAAW,EAAE,IAiCzB,CAAC"}
+{"version":3,"file":"aspect-ratio.d.ts","sourceRoot":"","sources":["../../src/rules/aspect-ratio.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEzC,eAAO,MAAM,WAAW,EAAE,IAkCzB,CAAC"}

package/dist/rules/aspect-ratio.js

@@ -1,6 +1,7 @@
 export const aspectRatio = {
     id: "aspect-ratio",
     title: "Fixed aspect ratios",
+    category: "layout",
     replaces: ["react-aspect-ratio"],
     featureIds: ["aspect-ratio"],
     native: "aspect-ratio",

package/dist/rules/aspect-ratio.js.map

@@ -1 +1 @@
-{"version":3,"file":"aspect-ratio.js","sourceRoot":"","sources":["../../src/rules/aspect-ratio.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,WAAW,GAAS;IAC/B,EAAE,EAAE,cAAc;IAClB,KAAK,EAAE,qBAAqB;IAC5B,QAAQ,EAAE,CAAC,oBAAoB,CAAC;IAChC,UAAU,EAAE,CAAC,cAAc,CAAC;IAC5B,MAAM,EAAE,cAAc;IACtB,KAAK,EAAE;QACL,SAAS,EACP,0SAA0S;QAC5S,OAAO,EAAE;;;;;;;;;;;EAWX;QACE,MAAM,EAAE,+DAA+D;KACxE;IACD,KAAK,EAAE;QACL,IAAI,EAAE,oFAAoF;QAC1F,MAAM,EAAE;YACN,0FAA0F;YAC1F,8JAA8J;YAC9J,mEAAmE;SACpE;QACD,OAAO,EAAE;+CACkC;KAC5C;CACF,CAAC"}
+{"version":3,"file":"aspect-ratio.js","sourceRoot":"","sources":["../../src/rules/aspect-ratio.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,WAAW,GAAS;IAC/B,EAAE,EAAE,cAAc;IAClB,KAAK,EAAE,qBAAqB;IAC5B,QAAQ,EAAE,QAAQ;IAClB,QAAQ,EAAE,CAAC,oBAAoB,CAAC;IAChC,UAAU,EAAE,CAAC,cAAc,CAAC;IAC5B,MAAM,EAAE,cAAc;IACtB,KAAK,EAAE;QACL,SAAS,EACP,0SAA0S;QAC5S,OAAO,EAAE;;;;;;;;;;;EAWX;QACE,MAAM,EAAE,+DAA+D;KACxE;IACD,KAAK,EAAE;QACL,IAAI,EAAE,oFAAoF;QAC1F,MAAM,EAAE;YACN,0FAA0F;YAC1F,8JAA8J;YAC9J,mEAAmE;SACpE;QACD,OAAO,EAAE;+CACkC;KAC5C;CACF,CAAC"}