@jomae/catalog 0.7.0 → 0.10.0

package/dist/rules/jquery.js

@@ -0,0 +1,37 @@
+export const jquery = {
+    id: "jquery",
+    title: "jQuery",
+    category: "async-data",
+    replaces: ["jquery"],
+    featureIds: ["dom", "events", "web-animations"],
+    native: "querySelectorAll(), classList and addEventListener()",
+    human: {
+        explainer: "jQuery smoothed over a decade of disagreement between browsers about selectors, events, animation and XMLHttpRequest. Each of those became one standard method that works everywhere: querySelectorAll for finding, classList for classes, closest for walking up, addEventListener for events, animate for motion and fetch for requests. What is left of the library is the chaining syntax and the plugin ecosystem built on top of it.",
+        snippet: `// $(".item").addClass("on") becomes:
+for (const el of document.querySelectorAll(".item")) {
+  el.classList.add("on");
+}
+
+// $(el).closest("form") becomes:
+el.closest("form");
+
+// $(el).fadeIn() becomes:
+el.animate({ opacity: [0, 1] }, { duration: 200, fill: "forwards" });`,
+        mdnUrl: "https://developer.mozilla.org/en-US/docs/Web/API/Document/querySelectorAll",
+    },
+    agent: {
+        when: "jQuery is used for selectors, class and attribute changes, events or simple animation",
+        unless: [
+            "Plugins are installed that require the global. Bootstrap 4, Select2, slick and DataTables all expect $ to exist, so the library stays until each of those goes, and that is usually the whole job rather than a step in it.",
+            "You depend on $.ajax behaviour with no fetch equivalent, JSONP most of all. fetch cannot do JSONP at all, and upload progress still needs XMLHttpRequest.",
+            "Event delegation and namespacing are used heavily. Delegation is a target.closest check inside one listener, which is fine once and tedious across a large codebase, and namespaced off() has no direct counterpart.",
+            "jQuery is loaded from a CDN that is already cached, or it arrives through a server-rendered template you do not control. Removing the import does not remove the request in either case.",
+            "The codebase leans on jQuery's quirks, such as its own event object, its data() store, or :visible and other selectors that are not valid CSS and that querySelectorAll will reject.",
+        ],
+        snippet: 'for (const el of document.querySelectorAll(".item")) el.classList.add("on");',
+        handRolled: [
+            "a $ or qs helper wrapping querySelectorAll to get chaining back after the library was removed",
+        ],
+    },
+};
+//# sourceMappingURL=jquery.js.map

package/dist/rules/jquery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jquery.js","sourceRoot":"","sources":["../../src/rules/jquery.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,MAAM,GAAS;IAC1B,EAAE,EAAE,QAAQ;IACZ,KAAK,EAAE,QAAQ;IACf,QAAQ,EAAE,YAAY;IACtB,QAAQ,EAAE,CAAC,QAAQ,CAAC;IACpB,UAAU,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,gBAAgB,CAAC;IAC/C,MAAM,EAAE,sDAAsD;IAC9D,KAAK,EAAE;QACL,SAAS,EACP,4aAA4a;QAC9a,OAAO,EAAE;;;;;;;;;sEASyD;QAClE,MAAM,EACJ,4EAA4E;KAC/E;IACD,KAAK,EAAE;QACL,IAAI,EAAE,uFAAuF;QAC7F,MAAM,EAAE;YACN,6NAA6N;YAC7N,2JAA2J;YAC3J,sNAAsN;YACtN,0LAA0L;YAC1L,sLAAsL;SACvL;QACD,OAAO,EACL,8EAA8E;QAChF,UAAU,EAAE;YACV,+FAA+F;SAChG;KACF;CACF,CAAC"}

package/dist/rules/lazy-loading.d.ts.map

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

package/dist/rules/lazy-loading.js

@@ -31,6 +31,10 @@ export const lazyLoading = {
         ],
         snippet: `<img src="/photo.jpg" alt="" loading="lazy" />
 <iframe src="/embed" loading="lazy"></iframe>`,
+        handRolled: [
+            "an IntersectionObserver that swaps a data-src attribute into src when an image nears the viewport",
+            "a scroll listener deciding which images are close enough to start loading",
+        ],
     },
     guides: ["optimize-image-priority"],
 };

package/dist/rules/lazy-loading.js.map

@@ -1 +1 @@
-{"version":3,"file":"lazy-loading.js","sourceRoot":"","sources":["../../src/rules/lazy-loading.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,WAAW,GAAS;IAC/B,EAAE,EAAE,cAAc;IAClB,KAAK,EAAE,gCAAgC;IACvC,QAAQ,EAAE,YAAY;IACtB,QAAQ,EAAE;QACR,OAAO;QACP,WAAW;QACX,kBAAkB;QAClB,gBAAgB;QAChB,iCAAiC;QACjC,SAAS;QACT,cAAc;QACd,cAAc;KACf;IACD,UAAU,EAAE,CAAC,cAAc,CAAC;IAC5B,MAAM,EAAE,gBAAgB;IACxB,KAAK,EAAE;QACL,SAAS,EACP,4XAA4X;QAC9X,OAAO,EAAE;iEACoD;QAC7D,MAAM,EACJ,uEAAuE;KAC1E;IACD,KAAK,EAAE;QACL,IAAI,EAAE,gFAAgF;QACtF,MAAM,EAAE;YACN,gJAAgJ;YAChJ,6GAA6G;YAC7G,0IAA0I;YAC1I,4HAA4H;YAC5H,4GAA4G;SAC7G;QACD,OAAO,EAAE;8CACiC;KAC3C;IACD,MAAM,EAAE,CAAC,yBAAyB,CAAC;CACpC,CAAC"}
+{"version":3,"file":"lazy-loading.js","sourceRoot":"","sources":["../../src/rules/lazy-loading.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,WAAW,GAAS;IAC/B,EAAE,EAAE,cAAc;IAClB,KAAK,EAAE,gCAAgC;IACvC,QAAQ,EAAE,YAAY;IACtB,QAAQ,EAAE;QACR,OAAO;QACP,WAAW;QACX,kBAAkB;QAClB,gBAAgB;QAChB,iCAAiC;QACjC,SAAS;QACT,cAAc;QACd,cAAc;KACf;IACD,UAAU,EAAE,CAAC,cAAc,CAAC;IAC5B,MAAM,EAAE,gBAAgB;IACxB,KAAK,EAAE;QACL,SAAS,EACP,4XAA4X;QAC9X,OAAO,EAAE;iEACoD;QAC7D,MAAM,EACJ,uEAAuE;KAC1E;IACD,KAAK,EAAE;QACL,IAAI,EAAE,gFAAgF;QACtF,MAAM,EAAE;YACN,gJAAgJ;YAChJ,6GAA6G;YAC7G,0IAA0I;YAC1I,4HAA4H;YAC5H,4GAA4G;SAC7G;QACD,OAAO,EAAE;8CACiC;QAC1C,UAAU,EAAE;YACV,mGAAmG;YACnG,2EAA2E;SAC5E;KACF;IACD,MAAM,EAAE,CAAC,yBAAyB,CAAC;CACpC,CAAC"}

package/dist/rules/light-dark.d.ts

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

package/dist/rules/light-dark.d.ts.map

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

package/dist/rules/light-dark.js

@@ -0,0 +1,37 @@
+export const lightDark = {
+    id: "light-dark",
+    title: "Light and dark theming",
+    category: "typography",
+    replaces: ["next-themes", "use-dark-mode", "theme-change"],
+    featureIds: ["light-dark", "color-scheme"],
+    native: "light-dark() with color-scheme",
+    human: {
+        explainer: "The usual setup declares every colour twice, once under a .dark class and once outside it, and ships JavaScript to move that class onto the html element before the first paint. light-dark() takes both values in one declaration and picks between them from the element's color-scheme, so a theme is one property rather than a class that has to be applied everywhere. Setting color-scheme on a subtree flips that subtree, which is how a manual toggle works without class plumbing.",
+        snippet: `:root {
+  /* Which of the two values below applies, and what the browser
+     paints for form controls and scrollbars. */
+  color-scheme: light dark;
+  --bg: light-dark(#ffffff, #111111);
+  --fg: light-dark(#111111, #f5f5f5);
+}
+
+/* A manual toggle sets color-scheme, and every token follows. */
+[data-theme="dark"] { color-scheme: dark; }`,
+        mdnUrl: "https://developer.mozilla.org/en-US/docs/Web/CSS/color_value/light-dark",
+    },
+    agent: {
+        when: "a site offers a light and a dark appearance",
+        unless: [
+            "You remember the choice across visits and cannot accept a flash of the wrong theme on first paint. Reading storage still needs a blocking inline script before the first paint, which is the part these libraries exist to get right.",
+            "You offer more than two themes, or themes that are not light and dark. light-dark() takes exactly two values, so a sepia or high-contrast option needs custom properties swapped per theme instead.",
+            "You read the resolved theme in JavaScript, for example to pick a chart palette or swap an image. CSS knows which branch applied and does not expose it, so that still needs matchMedia and your own state.",
+            "Your support target reaches below Chrome {{chrome:light-dark}}, Firefox {{firefox:light-dark}} or Safari {{safari:light-dark}}. light-dark() is newer than color-scheme by some years, so the surrounding property being safe is not proof this function is.",
+        ],
+        snippet: "color-scheme: light dark;\ncolor: light-dark(#111, #eee);",
+        handRolled: [
+            "every colour token declared twice, once at the root and again under a .dark or [data-theme] selector",
+            "a prefers-color-scheme media query listener in JavaScript that toggles a class on documentElement",
+        ],
+    },
+};
+//# sourceMappingURL=light-dark.js.map

package/dist/rules/light-dark.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"light-dark.js","sourceRoot":"","sources":["../../src/rules/light-dark.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,SAAS,GAAS;IAC7B,EAAE,EAAE,YAAY;IAChB,KAAK,EAAE,wBAAwB;IAC/B,QAAQ,EAAE,YAAY;IACtB,QAAQ,EAAE,CAAC,aAAa,EAAE,eAAe,EAAE,cAAc,CAAC;IAC1D,UAAU,EAAE,CAAC,YAAY,EAAE,cAAc,CAAC;IAC1C,MAAM,EAAE,gCAAgC;IACxC,KAAK,EAAE;QACL,SAAS,EACP,+dAA+d;QACje,OAAO,EAAE;;;;;;;;;4CAS+B;QACxC,MAAM,EACJ,yEAAyE;KAC5E;IACD,KAAK,EAAE;QACL,IAAI,EAAE,6CAA6C;QACnD,MAAM,EAAE;YACN,uOAAuO;YACvO,qMAAqM;YACrM,4MAA4M;YAC5M,8PAA8P;SAC/P;QACD,OAAO,EAAE,2DAA2D;QACpE,UAAU,EAAE;YACV,sGAAsG;YACtG,mGAAmG;SACpG;KACF;CACF,CAAC"}

package/dist/rules/line-clamp.d.ts.map

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

package/dist/rules/line-clamp.js

@@ -34,6 +34,10 @@ export const lineClamp = {
             "You're relying on a build tool to add this prefix for you and it doesn't; -webkit-line-clamp still needs to be written by hand, autoprefixer tools do not treat it as one they add automatically in every configuration.",
         ],
         snippet: ".excerpt { display: -webkit-box; -webkit-box-orient: vertical; -webkit-line-clamp: 3; overflow: hidden; }",
+        handRolled: [
+            "measuring rendered text in a hidden element or on a canvas to decide where a line should visually end",
+            "slicing a string by character count before rendering it, so a card title fits its two lines",
+        ],
     },
 };
 //# sourceMappingURL=line-clamp.js.map

package/dist/rules/line-clamp.js.map

@@ -1 +1 @@
-{"version":3,"file":"line-clamp.js","sourceRoot":"","sources":["../../src/rules/line-clamp.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,SAAS,GAAS;IAC7B,EAAE,EAAE,YAAY;IAChB,KAAK,EAAE,4BAA4B;IACnC,QAAQ,EAAE,YAAY;IACtB,QAAQ,EAAE;QACR,mBAAmB;QACnB,kBAAkB;QAClB,UAAU;QACV,YAAY;QACZ,WAAW;KACZ;IACD,UAAU,EAAE,EAAE;IACd,cAAc,EAAE;QACd,MAAM,EAAE,QAAQ;QAChB,UAAU,EAAE,YAAY;QACxB,IAAI,EAAE,maAAma;KAC1a;IACD,MAAM,EAAE,oBAAoB;IAC5B,KAAK,EAAE;QACL,SAAS,EACP,yVAAyV;QAC3V,OAAO,EAAE;;;;;EAKX;QACE,MAAM,EACJ,qEAAqE;KACxE;IACD,KAAK,EAAE;QACL,IAAI,EAAE,wEAAwE;QAC9E,MAAM,EAAE;YACN,oIAAoI;YACpI,4IAA4I;YAC5I,0NAA0N;SAC3N;QACD,OAAO,EACL,2GAA2G;KAC9G;CACF,CAAC"}
+{"version":3,"file":"line-clamp.js","sourceRoot":"","sources":["../../src/rules/line-clamp.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,SAAS,GAAS;IAC7B,EAAE,EAAE,YAAY;IAChB,KAAK,EAAE,4BAA4B;IACnC,QAAQ,EAAE,YAAY;IACtB,QAAQ,EAAE;QACR,mBAAmB;QACnB,kBAAkB;QAClB,UAAU;QACV,YAAY;QACZ,WAAW;KACZ;IACD,UAAU,EAAE,EAAE;IACd,cAAc,EAAE;QACd,MAAM,EAAE,QAAQ;QAChB,UAAU,EAAE,YAAY;QACxB,IAAI,EAAE,maAAma;KAC1a;IACD,MAAM,EAAE,oBAAoB;IAC5B,KAAK,EAAE;QACL,SAAS,EACP,yVAAyV;QAC3V,OAAO,EAAE;;;;;EAKX;QACE,MAAM,EACJ,qEAAqE;KACxE;IACD,KAAK,EAAE;QACL,IAAI,EAAE,wEAAwE;QAC9E,MAAM,EAAE;YACN,oIAAoI;YACpI,4IAA4I;YAC5I,0NAA0N;SAC3N;QACD,OAAO,EACL,2GAA2G;QAC7G,UAAU,EAAE;YACV,uGAAuG;YACvG,6FAA6F;SAC9F;KACF;CACF,CAAC"}

package/dist/rules/list-format.d.ts

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

package/dist/rules/list-format.d.ts.map

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

package/dist/rules/list-format.js

@@ -0,0 +1,40 @@
+export const listFormat = {
+    id: "intl-list-format",
+    title: "Joining a list into a sentence",
+    category: "formatting",
+    replaces: ["humanize-list"],
+    featureIds: ["intl-list-format"],
+    native: "Intl.ListFormat",
+    human: {
+        explainer: 'Commas between the items and an "and" before the last one looks like string work until there is a second language. Intl.ListFormat renders the list with the separators and the conjunction the locale actually uses, so English gets its serial comma and German gets "und" without either being written down. It also handles disjunctions, where the joining word is "or", and plain unit lists with no conjunction at all.',
+        snippet: `const fmt = new Intl.ListFormat("en", { type: "conjunction" });
+fmt.format(["apples", "pears", "plums"]);
+// "apples, pears, and plums"
+
+new Intl.ListFormat("de").format(["Äpfel", "Birnen", "Pflaumen"]);
+// "Äpfel, Birnen und Pflaumen"
+
+new Intl.ListFormat("en", { type: "disjunction" }).format(["red", "blue"]);
+// "red or blue"`,
+        mdnUrl: "https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/ListFormat",
+    },
+    agent: {
+        when: 'joining several items into one phrase, such as "apples, pears, and plums"',
+        unless: [
+            'You truncate long lists, as in "Ana, Ben and 4 others". Intl.ListFormat renders every item it is given, so deciding how many to show and building the "and N more" item stays your code.',
+            "You need a separator the locale does not use, such as joining with a slash or a bullet for a breadcrumb. That is Array.prototype.join, and neither the library nor Intl is involved.",
+            "The items are not already strings. format() throws a TypeError on anything else, where humanize-list coerces, so numbers and nulls that used to render now break.",
+            "You depend on humanize-list's exact output, including its oxfordComma option. Intl follows the locale's own convention, so switching changes visible text in English.",
+            "You need each item wrapped in markup. formatToParts() gives you the pieces and their types, but reassembling them into elements is work the plain format() call does not do.",
+        ],
+        snippet: `new Intl.ListFormat("en", { type: "conjunction" }).format([
+  "apples",
+  "pears",
+  "plums",
+]);`,
+        handRolled: [
+            'slice(0, -1).join(", ") joined to the last item with " and ", plus length checks for the one and two item cases',
+        ],
+    },
+};
+//# sourceMappingURL=list-format.js.map

package/dist/rules/list-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-format.js","sourceRoot":"","sources":["../../src/rules/list-format.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,UAAU,GAAS;IAC9B,EAAE,EAAE,kBAAkB;IACtB,KAAK,EAAE,gCAAgC;IACvC,QAAQ,EAAE,YAAY;IACtB,QAAQ,EAAE,CAAC,eAAe,CAAC;IAC3B,UAAU,EAAE,CAAC,kBAAkB,CAAC;IAChC,MAAM,EAAE,iBAAiB;IACzB,KAAK,EAAE;QACL,SAAS,EACP,gaAAga;QACla,OAAO,EAAE;;;;;;;;iBAQI;QACb,MAAM,EACJ,kGAAkG;KACrG;IACD,KAAK,EAAE;QACL,IAAI,EAAE,2EAA2E;QACjF,MAAM,EAAE;YACN,0LAA0L;YAC1L,sLAAsL;YACtL,mKAAmK;YACnK,uKAAuK;YACvK,8KAA8K;SAC/K;QACD,OAAO,EAAE;;;;IAIT;QACA,UAAU,EAAE;YACV,iHAAiH;SAClH;KACF;CACF,CAAC"}

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

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

package/dist/rules/masonry.js

@@ -55,6 +55,10 @@ export const masonry = {
   .gallery { columns: 16rem; }
   .gallery > * { break-inside: avoid; }
 }`,
+        handRolled: [
+            "distributing items into column arrays in JavaScript by tracking each column's running height",
+            "absolutely positioning items after measuring them so the gaps between rows close up",
+        ],
     },
 };
 //# sourceMappingURL=masonry.js.map

package/dist/rules/masonry.js.map

@@ -1 +1 @@
-{"version":3,"file":"masonry.js","sourceRoot":"","sources":["../../src/rules/masonry.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,OAAO,GAAS;IAC3B,EAAE,EAAE,aAAa;IACjB,KAAK,EAAE,iBAAiB;IACxB,QAAQ,EAAE,QAAQ;IAClB,QAAQ,EAAE;QACR,mBAAmB;QACnB,gBAAgB;QAChB,yBAAyB;QACzB,OAAO;QACP,qBAAqB;QACrB,aAAa;QACb,iBAAiB;KAClB;IACD,UAAU,EAAE,CAAC,SAAS,CAAC;IACvB,MAAM,EAAE,4BAA4B;IACpC,KAAK,EAAE;QACL,SAAS,EACP,wiBAAwiB;QAC1iB,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;EAoBX;QACE,MAAM,EACJ,iFAAiF;KACpF;IACD,KAAK,EAAE;QACL,IAAI,EAAE,uFAAuF;QAC7F,MAAM,EAAE;YACN,8LAA8L;YAC9L,6EAA6E;YAC7E,iEAAiE;YACjE,yHAAyH;SAC1H;QACD,OAAO,EAAE;;;;;;;;EAQX;KACC;CACF,CAAC"}
+{"version":3,"file":"masonry.js","sourceRoot":"","sources":["../../src/rules/masonry.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,OAAO,GAAS;IAC3B,EAAE,EAAE,aAAa;IACjB,KAAK,EAAE,iBAAiB;IACxB,QAAQ,EAAE,QAAQ;IAClB,QAAQ,EAAE;QACR,mBAAmB;QACnB,gBAAgB;QAChB,yBAAyB;QACzB,OAAO;QACP,qBAAqB;QACrB,aAAa;QACb,iBAAiB;KAClB;IACD,UAAU,EAAE,CAAC,SAAS,CAAC;IACvB,MAAM,EAAE,4BAA4B;IACpC,KAAK,EAAE;QACL,SAAS,EACP,wiBAAwiB;QAC1iB,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;EAoBX;QACE,MAAM,EACJ,iFAAiF;KACpF;IACD,KAAK,EAAE;QACL,IAAI,EAAE,uFAAuF;QAC7F,MAAM,EAAE;YACN,8LAA8L;YAC9L,6EAA6E;YAC7E,iEAAiE;YACjE,yHAAyH;SAC1H;QACD,OAAO,EAAE;;;;;;;;EAQX;QACE,UAAU,EAAE;YACV,8FAA8F;YAC9F,qFAAqF;SACtF;KACF;CACF,CAAC"}

package/dist/rules/match-media.d.ts

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

package/dist/rules/match-media.d.ts.map

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

package/dist/rules/match-media.js

@@ -0,0 +1,36 @@
+export const matchMedia = {
+    id: "match-media",
+    title: "Reacting to a breakpoint",
+    category: "layout",
+    replaces: ["react-responsive", "react-media", "use-media", "enquire.js"],
+    featureIds: ["matchmedia"],
+    native: "matchMedia()",
+    human: {
+        explainer: "These libraries wrap one method. matchMedia() takes the same query string a stylesheet would, reports whether it matches now, and fires an event when that changes, with no resize listener and no width arithmetic. Most uses of them are styling rather than logic, and a media or container query in CSS handles those without JavaScript running at all.",
+        snippet: `const wide = matchMedia("(min-width: 48rem)");
+
+function apply(event) {
+  // Same shape for the initial read and every later change.
+  setColumns(event.matches ? 3 : 1);
+}
+
+apply(wide);
+wide.addEventListener("change", apply);`,
+        mdnUrl: "https://developer.mozilla.org/en-US/docs/Web/API/Window/matchMedia",
+    },
+    agent: {
+        when: "JavaScript needs to know whether a media query currently matches",
+        unless: [
+            "You server-render and need the first paint to be right. matchMedia does not exist on the server and the client's first read happens after hydration, so a wrong first frame or a mismatch warning is the failure mode these libraries put real work into avoiding.",
+            "You are changing appearance rather than behaviour. A media query or a container query does that in CSS, which is fewer moving parts than either the library or this API.",
+            "You query an element's size rather than the viewport's. matchMedia only answers about the viewport and the device, so a component that responds to its own box needs a container query or ResizeObserver.",
+            "The library's other features are in use, such as react-responsive's device-property shorthands or its context-based overriding for tests.",
+        ],
+        snippet: 'matchMedia("(min-width: 48rem)").matches;',
+        handRolled: [
+            "a resize listener comparing window.innerWidth against a breakpoint number kept in JavaScript",
+            "an isMobile flag held in state and recomputed from innerWidth inside a debounced resize handler",
+        ],
+    },
+};
+//# sourceMappingURL=match-media.js.map

package/dist/rules/match-media.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"match-media.js","sourceRoot":"","sources":["../../src/rules/match-media.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,UAAU,GAAS;IAC9B,EAAE,EAAE,aAAa;IACjB,KAAK,EAAE,0BAA0B;IACjC,QAAQ,EAAE,QAAQ;IAClB,QAAQ,EAAE,CAAC,kBAAkB,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,CAAC;IACxE,UAAU,EAAE,CAAC,YAAY,CAAC;IAC1B,MAAM,EAAE,cAAc;IACtB,KAAK,EAAE;QACL,SAAS,EACP,8VAA8V;QAChW,OAAO,EAAE;;;;;;;;wCAQ2B;QACpC,MAAM,EACJ,oEAAoE;KACvE;IACD,KAAK,EAAE;QACL,IAAI,EAAE,kEAAkE;QACxE,MAAM,EAAE;YACN,oQAAoQ;YACpQ,0KAA0K;YAC1K,2MAA2M;YAC3M,2IAA2I;SAC5I;QACD,OAAO,EAAE,2CAA2C;QACpD,UAAU,EAAE;YACV,8FAA8F;YAC9F,iGAAiG;SAClG;KACF;CACF,CAAC"}

package/dist/rules/natural-sort.d.ts.map

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

package/dist/rules/natural-sort.js

@@ -36,6 +36,10 @@ export const naturalSort = {
         ],
         snippet: `const collator = new Intl.Collator(undefined, { numeric: true });
 list.sort(collator.compare);`,
+        handRolled: [
+            "a comparator pulling digits out of strings with a regex and comparing them as numbers",
+            "zero-padding numbers inside strings so a plain sort puts item10 after item9",
+        ],
     },
 };
 //# sourceMappingURL=natural-sort.js.map

package/dist/rules/natural-sort.js.map

@@ -1 +1 @@
-{"version":3,"file":"natural-sort.js","sourceRoot":"","sources":["../../src/rules/natural-sort.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,WAAW,GAAS;IAC/B,EAAE,EAAE,cAAc;IAClB,KAAK,EAAE,kCAAkC;IACzC,QAAQ,EAAE,YAAY;IACtB,QAAQ,EAAE;QACR,iBAAiB;QACjB,sBAAsB;QACtB,iBAAiB;QACjB,wBAAwB;KACzB;IACD,UAAU,EAAE,CAAC,MAAM,CAAC;IACpB,MAAM,EAAE,kCAAkC;IAC1C,KAAK,EAAE;QACL,SAAS,EACP,kYAAkY;QACpY,OAAO,EAAE;;;;;;;;;;2BAUc;QACvB,MAAM,EACJ,gGAAgG;KACnG;IACD,KAAK,EAAE;QACL,IAAI,EAAE,qEAAqE;QAC3E,MAAM,EAAE;YACN,uMAAuM;YACvM,kKAAkK;YAClK,mKAAmK;YACnK,6IAA6I;YAC7I,6IAA6I;SAC9I;QACD,OAAO,EAAE;6BACgB;KAC1B;CACF,CAAC"}
+{"version":3,"file":"natural-sort.js","sourceRoot":"","sources":["../../src/rules/natural-sort.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,WAAW,GAAS;IAC/B,EAAE,EAAE,cAAc;IAClB,KAAK,EAAE,kCAAkC;IACzC,QAAQ,EAAE,YAAY;IACtB,QAAQ,EAAE;QACR,iBAAiB;QACjB,sBAAsB;QACtB,iBAAiB;QACjB,wBAAwB;KACzB;IACD,UAAU,EAAE,CAAC,MAAM,CAAC;IACpB,MAAM,EAAE,kCAAkC;IAC1C,KAAK,EAAE;QACL,SAAS,EACP,kYAAkY;QACpY,OAAO,EAAE;;;;;;;;;;2BAUc;QACvB,MAAM,EACJ,gGAAgG;KACnG;IACD,KAAK,EAAE;QACL,IAAI,EAAE,qEAAqE;QAC3E,MAAM,EAAE;YACN,uMAAuM;YACvM,kKAAkK;YAClK,mKAAmK;YACnK,6IAA6I;YAC7I,6IAA6I;SAC9I;QACD,OAAO,EAAE;6BACgB;QACzB,UAAU,EAAE;YACV,uFAAuF;YACvF,6EAA6E;SAC9E;KACF;CACF,CAAC"}

package/dist/rules/number-format.d.ts.map

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

package/dist/rules/number-format.js

@@ -2,7 +2,14 @@ export const numberFormat = {
     id: "number-format",
     title: "Locale-aware number and currency formatting",
     category: "formatting",
-    replaces: ["numeral", "accounting", "currency.js", "format-number"],
+    replaces: [
+        "numeral",
+        "accounting",
+        "currency.js",
+        "format-number",
+        "pretty-bytes",
+        "filesize",
+    ],
     featureIds: ["intl"],
     native: "Intl.NumberFormat",
     human: {
@@ -19,9 +26,15 @@ export const numberFormat = {
             'You format units or compact notation. style: "unit" and notation: "compact" arrived long after the rest of Intl.NumberFormat, in Chrome {{chrome:javascript.builtins.Intl.NumberFormat.NumberFormat.options_parameter.options_unit_parameter}}, Firefox {{firefox:javascript.builtins.Intl.NumberFormat.NumberFormat.options_parameter.options_unit_parameter}} and Safari {{safari:javascript.builtins.Intl.NumberFormat.NumberFormat.options_parameter.options_unit_parameter}}, so an older target does not get them.',
             "You need safe decimal arithmetic, such as adding money values without floating-point rounding errors. currency.js and accounting.js do that math for you; Intl.NumberFormat only formats a number you already computed correctly.",
             "You need to parse a formatted string back into a number. Intl.NumberFormat is format-only; these libraries often provide the reverse direction too.",
+            'You format byte sizes and need the unit chosen for you. Intl.NumberFormat formats a magnitude you already picked, so "kilobyte" on 1200 prints 1,200 kB rather than 1.2 MB, and dividing down to the right unit first is the part pretty-bytes and filesize actually do.',
+            "You need binary units. The sanctioned unit list has no kibibyte, mebibyte or gibibyte, and asking for one throws a RangeError rather than falling back, so anything reporting KiB or MiB keeps its library.",
             "You need a custom format pattern, such as a specific abbreviation style, that the options Intl.NumberFormat exposes cannot express.",
         ],
         snippet: 'new Intl.NumberFormat("en-US", { style: "currency", currency: "USD" }).format(value);',
+        handRolled: [
+            "a regex inserting thousands separators into a number's string form",
+            "toFixed followed by string surgery to add a currency symbol and group the digits",
+        ],
     },
 };
 //# sourceMappingURL=number-format.js.map

package/dist/rules/number-format.js.map

@@ -1 +1 @@
-{"version":3,"file":"number-format.js","sourceRoot":"","sources":["../../src/rules/number-format.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,YAAY,GAAS;IAChC,EAAE,EAAE,eAAe;IACnB,KAAK,EAAE,6CAA6C;IACpD,QAAQ,EAAE,YAAY;IACtB,QAAQ,EAAE,CAAC,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,eAAe,CAAC;IACnE,UAAU,EAAE,CAAC,MAAM,CAAC;IACpB,MAAM,EAAE,mBAAmB;IAC3B,KAAK,EAAE;QACL,SAAS,EACP,wZAAwZ;QAC1Z,OAAO,EAAE;;;kCAGqB;QAC9B,MAAM,EACJ,oGAAoG;KACvG;IACD,KAAK,EAAE;QACL,IAAI,EAAE,yGAAyG;QAC/G,MAAM,EAAE;YACN,0fAA0f;YAC1f,mOAAmO;YACnO,qJAAqJ;YACrJ,qIAAqI;SACtI;QACD,OAAO,EACL,uFAAuF;KAC1F;CACF,CAAC"}
+{"version":3,"file":"number-format.js","sourceRoot":"","sources":["../../src/rules/number-format.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,YAAY,GAAS;IAChC,EAAE,EAAE,eAAe;IACnB,KAAK,EAAE,6CAA6C;IACpD,QAAQ,EAAE,YAAY;IACtB,QAAQ,EAAE;QACR,SAAS;QACT,YAAY;QACZ,aAAa;QACb,eAAe;QACf,cAAc;QACd,UAAU;KACX;IACD,UAAU,EAAE,CAAC,MAAM,CAAC;IACpB,MAAM,EAAE,mBAAmB;IAC3B,KAAK,EAAE;QACL,SAAS,EACP,wZAAwZ;QAC1Z,OAAO,EAAE;;;kCAGqB;QAC9B,MAAM,EACJ,oGAAoG;KACvG;IACD,KAAK,EAAE;QACL,IAAI,EAAE,yGAAyG;QAC/G,MAAM,EAAE;YACN,0fAA0f;YAC1f,mOAAmO;YACnO,qJAAqJ;YACrJ,0QAA0Q;YAC1Q,6MAA6M;YAC7M,qIAAqI;SACtI;QACD,OAAO,EACL,uFAAuF;QACzF,UAAU,EAAE;YACV,oEAAoE;YACpE,kFAAkF;SACnF;KACF;CACF,CAAC"}

package/dist/rules/page-visibility.d.ts.map

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

package/dist/rules/page-visibility.js

@@ -20,6 +20,9 @@ export const pageVisibility = {
             "You need to distinguish a window occluded by another window from a genuinely backgrounded tab. visibilityState only reports the latter.",
         ],
         snippet: `document.addEventListener("visibilitychange", () => { ... });`,
+        handRolled: [
+            "a blur handler standing in for the tab being backgrounded, pausing a poll that a focus handler resumes",
+        ],
     },
     guides: [
         "detect-initial-visibility-state",

package/dist/rules/page-visibility.js.map

@@ -1 +1 @@
-{"version":3,"file":"page-visibility.js","sourceRoot":"","sources":["../../src/rules/page-visibility.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,cAAc,GAAS;IAClC,EAAE,EAAE,iBAAiB;IACrB,KAAK,EAAE,gBAAgB;IACvB,QAAQ,EAAE,YAAY;IACtB,QAAQ,EAAE,CAAC,uBAAuB,EAAE,cAAc,CAAC;IACnD,UAAU,EAAE,CAAC,iBAAiB,CAAC;IAC/B,MAAM,EAAE,yDAAyD;IACjE,KAAK,EAAE;QACL,SAAS,EACP,wRAAwR;QAC1R,OAAO,EAAE;;;IAGT;QACA,MAAM,EACJ,kFAAkF;KACrF;IACD,KAAK,EAAE;QACL,IAAI,EAAE,kGAAkG;QACxG,MAAM,EAAE;YACN,+GAA+G;YAC/G,yIAAyI;SAC1I;QACD,OAAO,EAAE,+DAA+D;KACzE;IACD,MAAM,EAAE;QACN,iCAAiC;QACjC,iCAAiC;KAClC;CACF,CAAC"}
+{"version":3,"file":"page-visibility.js","sourceRoot":"","sources":["../../src/rules/page-visibility.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,cAAc,GAAS;IAClC,EAAE,EAAE,iBAAiB;IACrB,KAAK,EAAE,gBAAgB;IACvB,QAAQ,EAAE,YAAY;IACtB,QAAQ,EAAE,CAAC,uBAAuB,EAAE,cAAc,CAAC;IACnD,UAAU,EAAE,CAAC,iBAAiB,CAAC;IAC/B,MAAM,EAAE,yDAAyD;IACjE,KAAK,EAAE;QACL,SAAS,EACP,wRAAwR;QAC1R,OAAO,EAAE;;;IAGT;QACA,MAAM,EACJ,kFAAkF;KACrF;IACD,KAAK,EAAE;QACL,IAAI,EAAE,kGAAkG;QACxG,MAAM,EAAE;YACN,+GAA+G;YAC/G,yIAAyI;SAC1I;QACD,OAAO,EAAE,+DAA+D;QACxE,UAAU,EAAE;YACV,wGAAwG;SACzG;KACF;IACD,MAAM,EAAE;QACN,iCAAiC;QACjC,iCAAiC;KAClC;CACF,CAAC"}

package/dist/rules/passkeys.d.ts

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

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

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

package/dist/rules/passkeys.js

@@ -0,0 +1,44 @@
+export const passkeys = {
+    id: "passkeys",
+    title: "Passkeys in the browser",
+    category: "device-apis",
+    replaces: ["@simplewebauthn/browser"],
+    featureIds: [],
+    manualBaseline: {
+        status: "newly",
+        verifiedOn: "2026-09-20",
+        note: "web-features has no ID for the JSON helpers this rule turns on, and they sit inside the 'webauthn' feature's own compat data rather than beside it. Deriving from that ID would badge this widely available on the ceremony's dates, Safari {{safari:webauthn}}, while the parseCreationOptionsFromJSON and toJSON calls that remove the need for a wrapper arrived in Safari {{safari:api.PublicKeyCredential.parseCreationOptionsFromJSON_static}}, Chrome {{chrome:api.PublicKeyCredential.parseCreationOptionsFromJSON_static}} and Firefox {{firefox:api.PublicKeyCredential.parseCreationOptionsFromJSON_static}}. Newly available on the helpers' own dates: the last engine shipped them in March 2025.",
+    },
+    native: "navigator.credentials with PublicKeyCredential",
+    human: {
+        explainer: "The browser half of a passkey flow is two calls: create() to register a credential and get() to sign a challenge. The reason a wrapper existed is that both used to need every challenge and id field converted to and from base64url by hand. parseCreationOptionsFromJSON and toJSON now do that conversion in the browser, so the server's JSON goes in and the response comes back out in the same shape.",
+        snippet: `// The server sends JSON; the browser parses it into the
+// ArrayBuffer-shaped options the call expects.
+const options = PublicKeyCredential.parseCreationOptionsFromJSON(fromServer);
+const credential = await navigator.credentials.create({
+  publicKey: options,
+});
+
+// And back to JSON for the response, without hand-rolled base64url.
+await fetch("/register", {
+  method: "POST",
+  body: JSON.stringify(credential.toJSON()),
+});`,
+        mdnUrl: "https://developer.mozilla.org/en-US/docs/Web/API/Web_Authentication_API",
+    },
+    agent: {
+        when: "registering or authenticating a passkey from the browser",
+        unless: [
+            "Your support target reaches below Chrome {{chrome:api.PublicKeyCredential.parseCreationOptionsFromJSON_static}}, Firefox {{firefox:api.PublicKeyCredential.parseCreationOptionsFromJSON_static}} or Safari {{safari:api.PublicKeyCredential.parseCreationOptionsFromJSON_static}}. The ceremony itself is years older than those, so the credential calls work while the JSON helpers that make the wrapper unnecessary do not, and the base64url conversion comes back.",
+            "You use the library's server package as well. @simplewebauthn/server generates and verifies the challenge, and the platform has no counterpart for that: this covers the browser side only.",
+            "You rely on the library's browser-capability helpers, such as its checks for a platform authenticator or for conditional UI, which are feature detection it has already written.",
+            "You need the same code path on a browser where conditional mediation behaves differently, which the library smooths over and the raw call does not.",
+        ],
+        snippet: "const credential = await navigator.credentials.get({ publicKey: options });",
+        handRolled: [
+            "base64url encode and decode helpers written next to a credentials.create call to convert challenge and id fields",
+            "a Uint8Array built by looping over atob output to turn a server challenge into bytes",
+        ],
+    },
+};
+//# sourceMappingURL=passkeys.js.map

package/dist/rules/passkeys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"passkeys.js","sourceRoot":"","sources":["../../src/rules/passkeys.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,QAAQ,GAAS;IAC5B,EAAE,EAAE,UAAU;IACd,KAAK,EAAE,yBAAyB;IAChC,QAAQ,EAAE,aAAa;IACvB,QAAQ,EAAE,CAAC,yBAAyB,CAAC;IACrC,UAAU,EAAE,EAAE;IACd,cAAc,EAAE;QACd,MAAM,EAAE,OAAO;QACf,UAAU,EAAE,YAAY;QACxB,IAAI,EAAE,irBAAirB;KACxrB;IACD,MAAM,EAAE,gDAAgD;IACxD,KAAK,EAAE;QACL,SAAS,EACP,+YAA+Y;QACjZ,OAAO,EAAE;;;;;;;;;;;IAWT;QACA,MAAM,EACJ,yEAAyE;KAC5E;IACD,KAAK,EAAE;QACL,IAAI,EAAE,0DAA0D;QAChE,MAAM,EAAE;YACN,0cAA0c;YAC1c,6LAA6L;YAC7L,kLAAkL;YAClL,qJAAqJ;SACtJ;QACD,OAAO,EACL,6EAA6E;QAC/E,UAAU,EAAE;YACV,kHAAkH;YAClH,sFAAsF;SACvF;KACF;CACF,CAAC"}

package/dist/rules/plural-rules.d.ts

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

package/dist/rules/plural-rules.d.ts.map

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

package/dist/rules/plural-rules.js

@@ -0,0 +1,33 @@
+export const pluralRules = {
+    id: "plural-rules",
+    title: "Choosing a plural form",
+    category: "formatting",
+    replaces: ["pluralize"],
+    featureIds: ["intl-plural-rules"],
+    native: "Intl.PluralRules",
+    human: {
+        explainer: 'Picking between "1 file" and "2 files" by testing count === 1 is only correct in English, and barely. Russian needs one form for 3 and another for 5, and Polish and Arabic have more. Intl.PluralRules answers which category a number falls into for a locale, so the branching stops being a guess. It returns the category rather than the word, which is the part worth knowing before reaching for it.',
+        snippet: `const pr = new Intl.PluralRules("en-US");
+const forms = { one: "file", other: "files" };
+\`\${count} \${forms[pr.select(count)]}\`; // "1 file", "2 files"
+
+// Ordinals are the same API with a different type.
+new Intl.PluralRules("en-US", { type: "ordinal" }).select(22); // "two"`,
+        mdnUrl: "https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/PluralRules",
+    },
+    agent: {
+        when: "choosing between singular and plural wording for a count",
+        unless: [
+            'You need the plural word itself. Intl.PluralRules returns a category such as "one" or "other" and never inflects anything, so "person" to "people" and "index" to "indices" still need pluralize or a table of your own. This is the difference that decides most cases.',
+            "You pluralise arbitrary nouns you do not control, such as user-supplied or database-driven labels. A category is only useful when you already hold both forms, which you cannot if the noun is unknown at build time.",
+            "You singularise as well as pluralise. pluralize goes both directions and this API goes neither.",
+            "Your strings already run through an ICU message catalogue. It has plural selection built in and doing it twice is how the two disagree.",
+        ],
+        snippet: 'new Intl.PluralRules(locale).select(count); // "one" | "other" | ...',
+        handRolled: [
+            'a count === 1 ternary picking between two words, or a bare + "s" appended to a noun',
+            "a lookup of irregular plurals kept next to the component that renders them",
+        ],
+    },
+};
+//# sourceMappingURL=plural-rules.js.map

package/dist/rules/plural-rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plural-rules.js","sourceRoot":"","sources":["../../src/rules/plural-rules.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,WAAW,GAAS;IAC/B,EAAE,EAAE,cAAc;IAClB,KAAK,EAAE,wBAAwB;IAC/B,QAAQ,EAAE,YAAY;IACtB,QAAQ,EAAE,CAAC,WAAW,CAAC;IACvB,UAAU,EAAE,CAAC,mBAAmB,CAAC;IACjC,MAAM,EAAE,kBAAkB;IAC1B,KAAK,EAAE;QACL,SAAS,EACP,8YAA8Y;QAChZ,OAAO,EAAE;;;;;wEAK2D;QACpE,MAAM,EACJ,mGAAmG;KACtG;IACD,KAAK,EAAE;QACL,IAAI,EAAE,0DAA0D;QAChE,MAAM,EAAE;YACN,0QAA0Q;YAC1Q,uNAAuN;YACvN,iGAAiG;YACjG,yIAAyI;SAC1I;QACD,OAAO,EACL,sEAAsE;QACxE,UAAU,EAAE;YACV,qFAAqF;YACrF,4EAA4E;SAC7E;KACF;CACF,CAAC"}

package/dist/rules/pointer-events.d.ts

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

package/dist/rules/pointer-events.d.ts.map

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

package/dist/rules/pointer-events.js

@@ -0,0 +1,43 @@
+export const pointerEvents = {
+    id: "pointer-events",
+    title: "Touch and pointer gestures",
+    category: "device-apis",
+    replaces: ["hammerjs", "react-swipeable", "swiped-events"],
+    featureIds: ["pointer-events-api"],
+    native: "pointer events with touch-action",
+    human: {
+        explainer: "hammerjs was written when mouse and touch were separate event streams that had to be normalised, and it has not been maintained since 2016. Pointer events deliver both through one set of handlers, with pointerId to tell fingers apart and setPointerCapture so a drag keeps reporting after the pointer leaves the element. A swipe is a pointerdown coordinate, a pointerup coordinate, and a threshold.",
+        snippet: `let startX = 0;
+
+el.addEventListener("pointerdown", (event) => {
+  startX = event.clientX;
+  // Keeps events coming even if the pointer leaves the element.
+  el.setPointerCapture(event.pointerId);
+});
+
+el.addEventListener("pointerup", (event) => {
+  const dx = event.clientX - startX;
+  if (Math.abs(dx) > 50) onSwipe(dx > 0 ? "right" : "left");
+});
+
+// Tell the browser which direction you are handling, so it keeps
+// vertical scrolling for itself. In CSS: touch-action: pan-y.
+el.style.touchAction = "pan-y";`,
+        mdnUrl: "https://developer.mozilla.org/en-US/docs/Web/API/Pointer_events",
+    },
+    agent: {
+        when: "handling swipes, drags or other pointer gestures",
+        unless: [
+            "You need multi-touch recognisers such as pinch to zoom or two-finger rotate. Tracking several pointerIds and deriving the transform between them is real geometry, and it is most of what hammerjs is.",
+            "You need velocity, direction and threshold tuning that already feels right. A naive distance check fires on a slow drag that was never meant as a swipe, and the tuned version is the library's actual value.",
+            "You rely on hammerjs recognisers with conflict resolution between them, such as pan and swipe on the same element, where the ordering is configured rather than written.",
+            "Your support target reaches below Chrome {{chrome:pointer-events-api}}, Firefox {{firefox:pointer-events-api}} or Safari {{safari:pointer-events-api}}, which came to pointer events considerably later than the others.",
+        ],
+        snippet: 'el.addEventListener("pointerdown", (e) => el.setPointerCapture(e.pointerId));',
+        handRolled: [
+            "paired touchstart and touchend listeners reading changedTouches[0].clientX to work out a swipe direction",
+            "separate mousedown and touchstart branches doing the same thing, written because the two event streams disagree",
+        ],
+    },
+};
+//# sourceMappingURL=pointer-events.js.map

package/dist/rules/pointer-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pointer-events.js","sourceRoot":"","sources":["../../src/rules/pointer-events.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,aAAa,GAAS;IACjC,EAAE,EAAE,gBAAgB;IACpB,KAAK,EAAE,4BAA4B;IACnC,QAAQ,EAAE,aAAa;IACvB,QAAQ,EAAE,CAAC,UAAU,EAAE,iBAAiB,EAAE,eAAe,CAAC;IAC1D,UAAU,EAAE,CAAC,oBAAoB,CAAC;IAClC,MAAM,EAAE,kCAAkC;IAC1C,KAAK,EAAE;QACL,SAAS,EACP,+YAA+Y;QACjZ,OAAO,EAAE;;;;;;;;;;;;;;;gCAemB;QAC5B,MAAM,EAAE,iEAAiE;KAC1E;IACD,KAAK,EAAE;QACL,IAAI,EAAE,kDAAkD;QACxD,MAAM,EAAE;YACN,wMAAwM;YACxM,+MAA+M;YAC/M,0KAA0K;YAC1K,0NAA0N;SAC3N;QACD,OAAO,EACL,+EAA+E;QACjF,UAAU,EAAE;YACV,0GAA0G;YAC1G,iHAAiH;SAClH;KACF;CACF,CAAC"}

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

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

package/dist/rules/popover.js

@@ -62,6 +62,11 @@ export const popover = {
     position-try-fallbacks: flip-block;
   }
 </style>`,
+        handRolled: [
+            "calling getBoundingClientRect on a trigger inside scroll and resize listeners to place a floating panel",
+            "writing top and left onto a tooltip from a requestAnimationFrame loop",
+            "flip logic comparing a panel's rect against the viewport and moving it to the other side of its trigger",
+        ],
     },
     guides: [
         "position-aware-tooltips",

package/dist/rules/popover.js.map

@@ -1 +1 @@
-{"version":3,"file":"popover.js","sourceRoot":"","sources":["../../src/rules/popover.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,OAAO,GAAS;IAC3B,EAAE,EAAE,4BAA4B;IAChC,KAAK,EAAE,kCAAkC;IACzC,QAAQ,EAAE,OAAO;IACjB,QAAQ,EAAE;QACR,oBAAoB;QACpB,wBAAwB;QACxB,kBAAkB;QAClB,gBAAgB;QAChB,WAAW;QACX,UAAU;QACV,gBAAgB;QAChB,cAAc;QACd,eAAe;QACf,cAAc;QACd,WAAW;QACX,2BAA2B;KAC5B;IACD,UAAU,EAAE,CAAC,SAAS,EAAE,oBAAoB,CAAC;IAC7C,MAAM,EAAE,6CAA6C;IACrD,KAAK,EAAE;QACL,SAAS,EACP,ugBAAugB;QACzgB,OAAO,EAAE;;;;;;;;;;;;;;;;;;SAkBJ;QACL,OAAO,EAAE,6CAA6C;QACtD,MAAM,EAAE,8DAA8D;KACvE;IACD,KAAK,EAAE;QACL,IAAI,EAAE,oEAAoE;QAC1E,MAAM,EAAE;YACN,uUAAuU;YACvU,iIAAiI;YACjI,0DAA0D;YAC1D,iHAAiH;YACjH,uEAAuE;SACxE;QACD,OAAO,EAAE;;;;;;;;;;SAUJ;KACN;IACD,MAAM,EAAE;QACN,yBAAyB;QACzB,6BAA6B;QAC7B,8CAA8C;KAC/C;CACF,CAAC"}
+{"version":3,"file":"popover.js","sourceRoot":"","sources":["../../src/rules/popover.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,OAAO,GAAS;IAC3B,EAAE,EAAE,4BAA4B;IAChC,KAAK,EAAE,kCAAkC;IACzC,QAAQ,EAAE,OAAO;IACjB,QAAQ,EAAE;QACR,oBAAoB;QACpB,wBAAwB;QACxB,kBAAkB;QAClB,gBAAgB;QAChB,WAAW;QACX,UAAU;QACV,gBAAgB;QAChB,cAAc;QACd,eAAe;QACf,cAAc;QACd,WAAW;QACX,2BAA2B;KAC5B;IACD,UAAU,EAAE,CAAC,SAAS,EAAE,oBAAoB,CAAC;IAC7C,MAAM,EAAE,6CAA6C;IACrD,KAAK,EAAE;QACL,SAAS,EACP,ugBAAugB;QACzgB,OAAO,EAAE;;;;;;;;;;;;;;;;;;SAkBJ;QACL,OAAO,EAAE,6CAA6C;QACtD,MAAM,EAAE,8DAA8D;KACvE;IACD,KAAK,EAAE;QACL,IAAI,EAAE,oEAAoE;QAC1E,MAAM,EAAE;YACN,uUAAuU;YACvU,iIAAiI;YACjI,0DAA0D;YAC1D,iHAAiH;YACjH,uEAAuE;SACxE;QACD,OAAO,EAAE;;;;;;;;;;SAUJ;QACL,UAAU,EAAE;YACV,yGAAyG;YACzG,uEAAuE;YACvE,yGAAyG;SAC1G;KACF;IACD,MAAM,EAAE;QACN,yBAAyB;QACzB,6BAA6B;QAC7B,8CAA8C;KAC/C;CACF,CAAC"}

package/dist/rules/progress-indicator.d.ts

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

package/dist/rules/progress-indicator.d.ts.map

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