@jomae/catalog 0.4.0 → 0.6.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,14 @@
  * 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 { rules, rulesById, rulesByPackage } from "./rules/index.ts";
 export { type BaselineStatus, baselineStatusSchema, type ManualBaseline, manualBaselineSchema, parseCatalog, type Rule, ruleSchema, SCHEMA_VERSION, } from "./schema.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,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"}

package/dist/index.js

@@ -4,10 +4,14 @@
  * 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 { rules, rulesById, rulesByPackage } from "./rules/index.js";
 export { baselineStatusSchema, manualBaselineSchema, parseCatalog, ruleSchema, SCHEMA_VERSION, } from "./schema.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,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"}

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"}

package/dist/rules/base64.d.ts

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

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

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

package/dist/rules/base64.js

@@ -0,0 +1,41 @@
+export const base64 = {
+    id: "base64",
+    title: "Base64 encoding",
+    category: "async-data",
+    replaces: ["js-base64", "base-64", "abab"],
+    featureIds: ["base64encodedecode", "text-encoding"],
+    native: "btoa() and atob(), with TextEncoder for text",
+    human: {
+        explainer: "btoa() and atob() have been in browsers since the beginning, and the reason people reach for a library instead is that btoa() throws on any character above U+00FF. Encoding through TextEncoder first fixes that: turn the string into UTF-8 bytes, map them to a binary string, then encode. That is four lines, and it is exactly what the libraries do.",
+        snippet: `function encode(text) {
+  const bytes = new TextEncoder().encode(text);
+  const binary = String.fromCharCode(...bytes);
+  return btoa(binary);
+}
+
+function decode(encoded) {
+  const binary = atob(encoded);
+  const bytes = Uint8Array.from(binary, (c) => c.charCodeAt(0));
+  return new TextDecoder().decode(bytes);
+}
+
+encode("caffè ☕"); // "Y2FmZsOoIOKYlQ=="`,
+        mdnUrl: "https://developer.mozilla.org/en-US/docs/Glossary/Base64",
+    },
+    agent: {
+        when: "encoding or decoding base64 in the browser",
+        unless: [
+            "You encode large binary payloads. String.fromCharCode(...bytes) spreads the whole array onto the stack and blows up past a few hundred thousand bytes, so a chunked loop is needed and the library already has one.",
+            "You need URL-safe base64 with the - and _ alphabet and no padding. btoa does not produce it, so the substitution is yours to write on both sides.",
+            "You want the encoding to be synchronous and allocation-light on a hot path, where a library tuned for it can beat the two-step conversion.",
+            "You are on a runtime where Buffer is available and simpler, such as server code that never runs in a browser.",
+            "You rely on the library accepting input types beyond a string, for example ArrayBuffers or streams.",
+        ],
+        snippet: `const bytes = new TextEncoder().encode(text);
+const encoded = btoa(String.fromCharCode(...bytes));
+const decoded = new TextDecoder().decode(
+  Uint8Array.from(atob(encoded), (c) => c.charCodeAt(0)),
+);`,
+    },
+};
+//# sourceMappingURL=base64.js.map

package/dist/rules/base64.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64.js","sourceRoot":"","sources":["../../src/rules/base64.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,MAAM,GAAS;IAC1B,EAAE,EAAE,QAAQ;IACZ,KAAK,EAAE,iBAAiB;IACxB,QAAQ,EAAE,YAAY;IACtB,QAAQ,EAAE,CAAC,WAAW,EAAE,SAAS,EAAE,MAAM,CAAC;IAC1C,UAAU,EAAE,CAAC,oBAAoB,EAAE,eAAe,CAAC;IACnD,MAAM,EAAE,8CAA8C;IACtD,KAAK,EAAE;QACL,SAAS,EACP,6VAA6V;QAC/V,OAAO,EAAE;;;;;;;;;;;;yCAY4B;QACrC,MAAM,EAAE,0DAA0D;KACnE;IACD,KAAK,EAAE;QACL,IAAI,EAAE,4CAA4C;QAClD,MAAM,EAAE;YACN,qNAAqN;YACrN,mJAAmJ;YACnJ,4IAA4I;YAC5I,+GAA+G;YAC/G,qGAAqG;SACtG;QACD,OAAO,EAAE;;;;GAIV;KACA;CACF,CAAC"}

package/dist/rules/broadcast-channel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"broadcast-channel.d.ts","sourceRoot":"","sources":["../../src/rules/broadcast-channel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEzC,eAAO,MAAM,gBAAgB,EAAE,IAwB9B,CAAC"}
+{"version":3,"file":"broadcast-channel.d.ts","sourceRoot":"","sources":["../../src/rules/broadcast-channel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEzC,eAAO,MAAM,gBAAgB,EAAE,IAyB9B,CAAC"}

package/dist/rules/broadcast-channel.js

@@ -1,6 +1,7 @@
 export const broadcastChannel = {
     id: "broadcast-channel",
     title: "Cross-tab messaging",
+    category: "device-apis",
     replaces: ["broadcast-channel"],
     featureIds: ["broadcast-channel"],
     native: "BroadcastChannel",

package/dist/rules/broadcast-channel.js.map

@@ -1 +1 @@
-{"version":3,"file":"broadcast-channel.js","sourceRoot":"","sources":["../../src/rules/broadcast-channel.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,gBAAgB,GAAS;IACpC,EAAE,EAAE,mBAAmB;IACvB,KAAK,EAAE,qBAAqB;IAC5B,QAAQ,EAAE,CAAC,mBAAmB,CAAC;IAC/B,UAAU,EAAE,CAAC,mBAAmB,CAAC;IACjC,MAAM,EAAE,kBAAkB;IAC1B,KAAK,EAAE;QACL,SAAS,EACP,oTAAoT;QACtT,OAAO,EAAE;;wDAE2C;QACpD,MAAM,EAAE,mEAAmE;KAC5E;IACD,KAAK,EAAE;QACL,IAAI,EAAE,oEAAoE;QAC1E,MAAM,EAAE;YACN,wIAAwI;YACxI,0GAA0G;YAC1G,0HAA0H;SAC3H;QACD,OAAO,EAAE;uCAC0B;KACpC;CACF,CAAC"}
+{"version":3,"file":"broadcast-channel.js","sourceRoot":"","sources":["../../src/rules/broadcast-channel.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,gBAAgB,GAAS;IACpC,EAAE,EAAE,mBAAmB;IACvB,KAAK,EAAE,qBAAqB;IAC5B,QAAQ,EAAE,aAAa;IACvB,QAAQ,EAAE,CAAC,mBAAmB,CAAC;IAC/B,UAAU,EAAE,CAAC,mBAAmB,CAAC;IACjC,MAAM,EAAE,kBAAkB;IAC1B,KAAK,EAAE;QACL,SAAS,EACP,oTAAoT;QACtT,OAAO,EAAE;;wDAE2C;QACpD,MAAM,EAAE,mEAAmE;KAC5E;IACD,KAAK,EAAE;QACL,IAAI,EAAE,oEAAoE;QAC1E,MAAM,EAAE;YACN,wIAAwI;YACxI,0GAA0G;YAC1G,0HAA0H;SAC3H;QACD,OAAO,EAAE;uCAC0B;KACpC;CACF,CAAC"}

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

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

package/dist/rules/carousel.js

@@ -1,6 +1,7 @@
 export const carousel = {
     id: "carousel-scroll-markers",
     title: "Carousels",
+    category: "scrolling",
     replaces: [
         "swiper",
         "embla-carousel",
@@ -78,5 +79,11 @@ export const carousel = {
 .carousel > *::scroll-marker { content: ""; }
 .carousel > *::scroll-marker:target-current { opacity: 1; }`,
     },
+    guides: [
+        "carousel-snap-highlights",
+        "carousel-slide-effects",
+        "scroll-snap-state-sync",
+        "scroll-snap-realtime-feedback",
+    ],
 };
 //# sourceMappingURL=carousel.js.map

package/dist/rules/carousel.js.map

@@ -1 +1 @@
-{"version":3,"file":"carousel.js","sourceRoot":"","sources":["../../src/rules/carousel.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,QAAQ,GAAS;IAC5B,EAAE,EAAE,yBAAyB;IAC7B,KAAK,EAAE,WAAW;IAClB,QAAQ,EAAE;QACR,QAAQ;QACR,gBAAgB;QAChB,sBAAsB;QACtB,aAAa;QACb,gBAAgB;QAChB,aAAa;QACb,UAAU;QACV,eAAe;QACf,oBAAoB;QACpB,oBAAoB;KACrB;IACD,UAAU,EAAE,CAAC,aAAa,EAAE,gBAAgB,EAAE,gBAAgB,CAAC;IAC/D,MAAM,EAAE,8DAA8D;IACtE,KAAK,EAAE;QACL,SAAS,EACP,2eAA2e;QAC7e,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsCX;QACE,OAAO,EAAE,6CAA6C;QACtD,MAAM,EAAE,kEAAkE;KAC3E;IACD,KAAK,EAAE;QACL,IAAI,EAAE,yEAAyE;QAC/E,MAAM,EAAE;YACN,2LAA2L;YAC3L,2GAA2G;YAC3G,2EAA2E;YAC3E,kGAAkG;YAClG,gIAAgI;SACjI;QACD,OAAO,EAAE;;;;;;;;4DAQ+C;KACzD;CACF,CAAC"}
+{"version":3,"file":"carousel.js","sourceRoot":"","sources":["../../src/rules/carousel.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,QAAQ,GAAS;IAC5B,EAAE,EAAE,yBAAyB;IAC7B,KAAK,EAAE,WAAW;IAClB,QAAQ,EAAE,WAAW;IACrB,QAAQ,EAAE;QACR,QAAQ;QACR,gBAAgB;QAChB,sBAAsB;QACtB,aAAa;QACb,gBAAgB;QAChB,aAAa;QACb,UAAU;QACV,eAAe;QACf,oBAAoB;QACpB,oBAAoB;KACrB;IACD,UAAU,EAAE,CAAC,aAAa,EAAE,gBAAgB,EAAE,gBAAgB,CAAC;IAC/D,MAAM,EAAE,8DAA8D;IACtE,KAAK,EAAE;QACL,SAAS,EACP,2eAA2e;QAC7e,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsCX;QACE,OAAO,EAAE,6CAA6C;QACtD,MAAM,EAAE,kEAAkE;KAC3E;IACD,KAAK,EAAE;QACL,IAAI,EAAE,yEAAyE;QAC/E,MAAM,EAAE;YACN,2LAA2L;YAC3L,2GAA2G;YAC3G,2EAA2E;YAC3E,kGAAkG;YAClG,gIAAgI;SACjI;QACD,OAAO,EAAE;;;;;;;;4DAQ+C;KACzD;IACD,MAAM,EAAE;QACN,0BAA0B;QAC1B,wBAAwB;QACxB,wBAAwB;QACxB,+BAA+B;KAChC;CACF,CAAC"}

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

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

package/dist/rules/clipboard.js

@@ -1,6 +1,7 @@
 export const clipboard = {
     id: "clipboard",
     title: "Copy and paste",
+    category: "device-apis",
     replaces: [
         "copy-to-clipboard",
         "clipboard-copy",
@@ -9,6 +10,7 @@ export const clipboard = {
         "vue-clipboard3",
         "vue-clipboard2",
         "ngx-clipboard",
+        "clipboard-polyfill",
     ],
     featureIds: ["async-clipboard"],
     native: "navigator.clipboard.writeText()",
@@ -22,7 +24,8 @@ export const clipboard = {
     agent: {
         when: "copying text to the clipboard on a button click or similar user action",
         unless: [
-            "You need to support Firefox before version 127 or Safari before 13.1, where this API landed later than Chrome.",
+            "You support Firefox below {{firefox:api.Clipboard.writeText}} or Safari below {{safari:api.Clipboard.writeText}}, where writeText landed later than in Chrome.",
+            "You read from the clipboard as well as writing to it. navigator.clipboard.read() and ClipboardItem arrived years after writeText and are still the part with the thinner support.",
             "You need to read arbitrary clipboard formats rather than plain text. Reading needs a permission prompt in some browsers and is more restricted than writing.",
             "You're running without focus or without a secure origin (HTTPS). The API rejects in both cases, so you still need a fallback path for that error.",
         ],

package/dist/rules/clipboard.js.map

@@ -1 +1 @@
-{"version":3,"file":"clipboard.js","sourceRoot":"","sources":["../../src/rules/clipboard.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,SAAS,GAAS;IAC7B,EAAE,EAAE,WAAW;IACf,KAAK,EAAE,gBAAgB;IACvB,QAAQ,EAAE;QACR,mBAAmB;QACnB,gBAAgB;QAChB,cAAc;QACd,yBAAyB;QACzB,gBAAgB;QAChB,gBAAgB;QAChB,eAAe;KAChB;IACD,UAAU,EAAE,CAAC,iBAAiB,CAAC;IAC/B,MAAM,EAAE,iCAAiC;IACzC,KAAK,EAAE;QACL,SAAS,EACP,+QAA+Q;QACjR,OAAO,EAAE;;EAEX;QACE,MAAM,EACJ,sEAAsE;KACzE;IACD,KAAK,EAAE;QACL,IAAI,EAAE,wEAAwE;QAC9E,MAAM,EAAE;YACN,gHAAgH;YAChH,8JAA8J;YAC9J,mJAAmJ;SACpJ;QACD,OAAO,EAAE,4CAA4C;KACtD;CACF,CAAC"}
+{"version":3,"file":"clipboard.js","sourceRoot":"","sources":["../../src/rules/clipboard.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,SAAS,GAAS;IAC7B,EAAE,EAAE,WAAW;IACf,KAAK,EAAE,gBAAgB;IACvB,QAAQ,EAAE,aAAa;IACvB,QAAQ,EAAE;QACR,mBAAmB;QACnB,gBAAgB;QAChB,cAAc;QACd,yBAAyB;QACzB,gBAAgB;QAChB,gBAAgB;QAChB,eAAe;QACf,oBAAoB;KACrB;IACD,UAAU,EAAE,CAAC,iBAAiB,CAAC;IAC/B,MAAM,EAAE,iCAAiC;IACzC,KAAK,EAAE;QACL,SAAS,EACP,+QAA+Q;QACjR,OAAO,EAAE;;EAEX;QACE,MAAM,EACJ,sEAAsE;KACzE;IACD,KAAK,EAAE;QACL,IAAI,EAAE,wEAAwE;QAC9E,MAAM,EAAE;YACN,gKAAgK;YAChK,mLAAmL;YACnL,8JAA8J;YAC9J,mJAAmJ;SACpJ;QACD,OAAO,EAAE,4CAA4C;KACtD;CACF,CAAC"}

package/dist/rules/color-functions.d.ts.map

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

package/dist/rules/color-functions.js

@@ -1,6 +1,7 @@
 export const colorFunctions = {
     id: "css-color-functions",
     title: "Colour manipulation",
+    category: "typography",
     replaces: [
         "polished",
         "color2k",

package/dist/rules/color-functions.js.map

@@ -1 +1 @@
-{"version":3,"file":"color-functions.js","sourceRoot":"","sources":["../../src/rules/color-functions.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,cAAc,GAAS;IAClC,EAAE,EAAE,qBAAqB;IACzB,KAAK,EAAE,qBAAqB;IAC5B,QAAQ,EAAE;QACR,UAAU;QACV,SAAS;QACT,WAAW;QACX,YAAY;QACZ,OAAO;QACP,QAAQ;KACT;IACD,UAAU,EAAE,CAAC,WAAW,EAAE,OAAO,CAAC;IAClC,MAAM,EAAE,iDAAiD;IACzD,KAAK,EAAE;QACL,SAAS,EACP,qjBAAqjB;QACvjB,OAAO,EAAE;;;;;;;;;;;;;;;;;EAiBX;QACE,MAAM,EACJ,oEAAoE;KACvE;IACD,KAAK,EAAE;QACL,IAAI,EAAE,mEAAmE;QACzE,MAAM,EAAE;YACN,+KAA+K;YAC/K,6FAA6F;YAC7F,uGAAuG;YACvG,8EAA8E;YAC9E,gNAAgN;SACjN;QACD,OAAO,EAAE;;8DAEiD;KAC3D;CACF,CAAC"}
+{"version":3,"file":"color-functions.js","sourceRoot":"","sources":["../../src/rules/color-functions.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,cAAc,GAAS;IAClC,EAAE,EAAE,qBAAqB;IACzB,KAAK,EAAE,qBAAqB;IAC5B,QAAQ,EAAE,YAAY;IACtB,QAAQ,EAAE;QACR,UAAU;QACV,SAAS;QACT,WAAW;QACX,YAAY;QACZ,OAAO;QACP,QAAQ;KACT;IACD,UAAU,EAAE,CAAC,WAAW,EAAE,OAAO,CAAC;IAClC,MAAM,EAAE,iDAAiD;IACzD,KAAK,EAAE;QACL,SAAS,EACP,qjBAAqjB;QACvjB,OAAO,EAAE;;;;;;;;;;;;;;;;;EAiBX;QACE,MAAM,EACJ,oEAAoE;KACvE;IACD,KAAK,EAAE;QACL,IAAI,EAAE,mEAAmE;QACzE,MAAM,EAAE;YACN,+KAA+K;YAC/K,6FAA6F;YAC7F,uGAAuG;YACvG,8EAA8E;YAC9E,gNAAgN;SACjN;QACD,OAAO,EAAE;;8DAEiD;KAC3D;CACF,CAAC"}

package/dist/rules/compression-streams.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compression-streams.d.ts","sourceRoot":"","sources":["../../src/rules/compression-streams.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEzC,eAAO,MAAM,kBAAkB,EAAE,IA0BhC,CAAC"}
+{"version":3,"file":"compression-streams.d.ts","sourceRoot":"","sources":["../../src/rules/compression-streams.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEzC,eAAO,MAAM,kBAAkB,EAAE,IA2BhC,CAAC"}

package/dist/rules/compression-streams.js

@@ -1,6 +1,7 @@
 export const compressionStreams = {
     id: "compression-streams",
     title: "Gzip and deflate in the browser",
+    category: "async-data",
     replaces: ["pako", "lz-string"],
     featureIds: ["compression-streams"],
     native: "CompressionStream and DecompressionStream",
@@ -15,7 +16,7 @@ const bytes = await compressed.arrayBuffer();`,
     agent: {
         when: "compressing or decompressing bytes with gzip or deflate before sending or storing them",
         unless: [
-            "You need brotli. Only the newest browser versions expose it, so a library is still the safer choice for that format today.",
+            "You need brotli. CompressionStream takes gzip, deflate and deflate-raw and nothing else, so brotli is a library either way.",
             "You need lz-string's specific format, such as its base64 or UTF-16 encodings meant for squeezing compressed data into localStorage or a URL. CompressionStream only speaks gzip, deflate, and raw deflate.",
             "You need synchronous compression of a small string with no stream setup. CompressionStream is stream-based, so a few lines of glue code are still required at the call site.",
         ],

package/dist/rules/compression-streams.js.map

@@ -1 +1 @@
-{"version":3,"file":"compression-streams.js","sourceRoot":"","sources":["../../src/rules/compression-streams.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,kBAAkB,GAAS;IACtC,EAAE,EAAE,qBAAqB;IACzB,KAAK,EAAE,iCAAiC;IACxC,QAAQ,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC;IAC/B,UAAU,EAAE,CAAC,qBAAqB,CAAC;IACnC,MAAM,EAAE,2CAA2C;IACnD,KAAK,EAAE;QACL,SAAS,EACP,4UAA4U;QAC9U,OAAO,EAAE;;;8CAGiC;QAC1C,MAAM,EACJ,oEAAoE;KACvE;IACD,KAAK,EAAE;QACL,IAAI,EAAE,wFAAwF;QAC9F,MAAM,EAAE;YACN,4HAA4H;YAC5H,4MAA4M;YAC5M,8KAA8K;SAC/K;QACD,OAAO,EACL,uEAAuE;KAC1E;CACF,CAAC"}
+{"version":3,"file":"compression-streams.js","sourceRoot":"","sources":["../../src/rules/compression-streams.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,kBAAkB,GAAS;IACtC,EAAE,EAAE,qBAAqB;IACzB,KAAK,EAAE,iCAAiC;IACxC,QAAQ,EAAE,YAAY;IACtB,QAAQ,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC;IAC/B,UAAU,EAAE,CAAC,qBAAqB,CAAC;IACnC,MAAM,EAAE,2CAA2C;IACnD,KAAK,EAAE;QACL,SAAS,EACP,4UAA4U;QAC9U,OAAO,EAAE;;;8CAGiC;QAC1C,MAAM,EACJ,oEAAoE;KACvE;IACD,KAAK,EAAE;QACL,IAAI,EAAE,wFAAwF;QAC9F,MAAM,EAAE;YACN,6HAA6H;YAC7H,4MAA4M;YAC5M,8KAA8K;SAC/K;QACD,OAAO,EACL,uEAAuE;KAC1E;CACF,CAAC"}

package/dist/rules/container-queries.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"container-queries.d.ts","sourceRoot":"","sources":["../../src/rules/container-queries.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEzC,eAAO,MAAM,gBAAgB,EAAE,IAuD9B,CAAC"}
+{"version":3,"file":"container-queries.d.ts","sourceRoot":"","sources":["../../src/rules/container-queries.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEzC,eAAO,MAAM,gBAAgB,EAAE,IAyD9B,CAAC"}