@jomae/catalog 0.2.0 → 0.4.0

package/dist/rules/resizable-panels.js

@@ -0,0 +1,34 @@
+export const resizablePanels = {
+    id: "resizable-panels",
+    title: "Resizable panels",
+    replaces: [
+        "react-resizable-panels",
+        "re-resizable",
+        "react-split-pane",
+        "splitpanes",
+    ],
+    featureIds: ["resize"],
+    native: "resize",
+    human: {
+        explainer: "A resizable-panel library tracks pointer events on a drag handle, computes the new size, and writes it back to state on every move. The resize property gives one element a drag handle for free: the browser tracks the pointer and grows or shrinks the element, no JavaScript involved. It only resizes the element it is set on, so it covers a single sidebar or textarea, not a split view where dragging one panel has to shrink its neighbor.",
+        snippet: `.sidebar {
+  resize: horizontal;
+  overflow: auto;
+  min-width: 12rem;
+  max-width: 32rem;
+}`,
+        mdnUrl: "https://developer.mozilla.org/en-US/docs/Web/CSS/resize",
+    },
+    agent: {
+        when: "letting someone drag-resize a single panel, such as a sidebar or a textarea",
+        unless: [
+            "You need the block/inline logical values rather than horizontal/vertical/both. Those only reached Firefox in version 63 and Safari in 16; the classic physical-direction values have been supported everywhere for over a decade.",
+            "You need multiple panels to resize together, such as a split view where dragging one edge shrinks its neighbor. resize only affects the element it is set on.",
+            "You need to read back or persist the size someone chose. resize has no resize event; ResizeObserver still covers that, and it is a JavaScript API, not CSS.",
+            "You need to style the drag handle itself, or place it somewhere other than the element's edge or corner. The native handle's appearance is fixed.",
+            "You need a minimum of two resizable regions sharing the freed-up or reclaimed space, the way a split-pane library redistributes width between panels.",
+        ],
+        snippet: ".sidebar { resize: horizontal; overflow: auto; min-width: 12rem; max-width: 32rem; }",
+    },
+};
+//# sourceMappingURL=resizable-panels.js.map

package/dist/rules/resizable-panels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resizable-panels.js","sourceRoot":"","sources":["../../src/rules/resizable-panels.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,eAAe,GAAS;IACnC,EAAE,EAAE,kBAAkB;IACtB,KAAK,EAAE,kBAAkB;IACzB,QAAQ,EAAE;QACR,wBAAwB;QACxB,cAAc;QACd,kBAAkB;QAClB,YAAY;KACb;IACD,UAAU,EAAE,CAAC,QAAQ,CAAC;IACtB,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE;QACL,SAAS,EACP,ubAAub;QACzb,OAAO,EAAE;;;;;EAKX;QACE,MAAM,EAAE,yDAAyD;KAClE;IACD,KAAK,EAAE;QACL,IAAI,EAAE,6EAA6E;QACnF,MAAM,EAAE;YACN,mOAAmO;YACnO,+JAA+J;YAC/J,6JAA6J;YAC7J,mJAAmJ;YACnJ,uJAAuJ;SACxJ;QACD,OAAO,EACL,sFAAsF;KACzF;CACF,CAAC"}

package/dist/rules/resize-observer.d.ts

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

package/dist/rules/resize-observer.d.ts.map

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

package/dist/rules/resize-observer.js

@@ -0,0 +1,27 @@
+export const resizeObserver = {
+    id: "resize-observer",
+    title: "Element resize tracking",
+    replaces: ["resize-observer-polyfill", "@juggle/resize-observer"],
+    featureIds: ["resize-observer"],
+    native: "ResizeObserver",
+    human: {
+        explainer: "These polyfills exist because ResizeObserver had gaps in browser support. That gap closed years ago: every major engine ships it natively now. Calling it directly watches an element's box for size changes and calls you back, with no listener on window resize and no manual layout math.",
+        snippet: `const observer = new ResizeObserver((entries) => {
+  for (const entry of entries) {
+    console.log(entry.contentBoxSize);
+  }
+});
+observer.observe(document.querySelector("#panel"));`,
+        mdnUrl: "https://developer.mozilla.org/en-US/docs/Web/API/ResizeObserver",
+    },
+    agent: {
+        when: "running code when an element's own box changes size, not just the viewport",
+        unless: [
+            "You need a framework hook's ergonomics, such as a ref and a reactive size value, rather than managing an observer instance yourself.",
+            "You're targeting an engine old enough that the polyfill's manual measurement fallback is still doing real work.",
+            "You need devicePixelContentBoxSize specifically. That entry is still limited to Chromium engines.",
+        ],
+        snippet: "new ResizeObserver((entries) => { ... }).observe(el);",
+    },
+};
+//# sourceMappingURL=resize-observer.js.map

package/dist/rules/resize-observer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resize-observer.js","sourceRoot":"","sources":["../../src/rules/resize-observer.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,cAAc,GAAS;IAClC,EAAE,EAAE,iBAAiB;IACrB,KAAK,EAAE,yBAAyB;IAChC,QAAQ,EAAE,CAAC,0BAA0B,EAAE,yBAAyB,CAAC;IACjE,UAAU,EAAE,CAAC,iBAAiB,CAAC;IAC/B,MAAM,EAAE,gBAAgB;IACxB,KAAK,EAAE;QACL,SAAS,EACP,+RAA+R;QACjS,OAAO,EAAE;;;;;oDAKuC;QAChD,MAAM,EAAE,iEAAiE;KAC1E;IACD,KAAK,EAAE;QACL,IAAI,EAAE,4EAA4E;QAClF,MAAM,EAAE;YACN,sIAAsI;YACtI,iHAAiH;YACjH,mGAAmG;SACpG;QACD,OAAO,EAAE,uDAAuD;KACjE;CACF,CAAC"}

package/dist/rules/screen-wake-lock.d.ts

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

package/dist/rules/screen-wake-lock.d.ts.map

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

package/dist/rules/screen-wake-lock.js

@@ -0,0 +1,23 @@
+export const screenWakeLock = {
+    id: "screen-wake-lock",
+    title: "Keeping the screen awake",
+    replaces: ["nosleep.js", "react-use-wake-lock"],
+    featureIds: ["screen-wake-lock"],
+    native: 'navigator.wakeLock.request("screen")',
+    human: {
+        explainer: "nosleep.js kept the screen on with a trick: playing a silent, invisible video, because there was no direct way to ask for this. The Wake Lock API asks directly, and releases automatically when the tab is backgrounded rather than needing you to remember to stop the video yourself.",
+        snippet: `const lock = await navigator.wakeLock.request("screen");
+// later, or automatically when the tab backgrounds
+await lock.release();`,
+        mdnUrl: "https://developer.mozilla.org/en-US/docs/Web/API/Screen_Wake_Lock_API",
+    },
+    agent: {
+        when: "keeping the screen from sleeping while a page is active, such as during a recipe, presentation, or workout",
+        unless: [
+            "You support Safari before version 16.4, or need the lock to survive the tab losing focus. The platform releases it automatically the moment the tab backgrounds, with no way to opt out.",
+            "You need this in a non-secure (non-HTTPS) context, where the API isn't available at all.",
+        ],
+        snippet: `const lock = await navigator.wakeLock.request("screen");`,
+    },
+};
+//# sourceMappingURL=screen-wake-lock.js.map

package/dist/rules/screen-wake-lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screen-wake-lock.js","sourceRoot":"","sources":["../../src/rules/screen-wake-lock.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,cAAc,GAAS;IAClC,EAAE,EAAE,kBAAkB;IACtB,KAAK,EAAE,0BAA0B;IACjC,QAAQ,EAAE,CAAC,YAAY,EAAE,qBAAqB,CAAC;IAC/C,UAAU,EAAE,CAAC,kBAAkB,CAAC;IAChC,MAAM,EAAE,sCAAsC;IAC9C,KAAK,EAAE;QACL,SAAS,EACP,0RAA0R;QAC5R,OAAO,EAAE;;sBAES;QAClB,MAAM,EACJ,uEAAuE;KAC1E;IACD,KAAK,EAAE;QACL,IAAI,EAAE,4GAA4G;QAClH,MAAM,EAAE;YACN,0LAA0L;YAC1L,0FAA0F;SAC3F;QACD,OAAO,EAAE,0DAA0D;KACpE;CACF,CAAC"}

package/dist/rules/scroll-animations.d.ts.map

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

package/dist/rules/scroll-animations.js

@@ -35,6 +35,7 @@ export const scrollAnimations = {
   animation-timeline: scroll(root block);
   transform-origin: left;
 }`,
+        mdnUrl: "https://developer.mozilla.org/en-US/docs/Web/CSS/animation-timeline",
     },
     agent: {
         when: "fading or moving elements in as they scroll into view, or driving a reading-progress bar",

package/dist/rules/scroll-animations.js.map

@@ -1 +1 @@
-{"version":3,"file":"scroll-animations.js","sourceRoot":"","sources":["../../src/rules/scroll-animations.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,gBAAgB,GAAS;IACpC,EAAE,EAAE,0BAA0B;IAC9B,KAAK,EAAE,6BAA6B;IACpC,QAAQ,EAAE,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,QAAQ,CAAC;IAC7E,UAAU,EAAE,CAAC,0BAA0B,CAAC;IACxC,MAAM,EAAE,yCAAyC;IACjD,KAAK,EAAE;QACL,SAAS,EACP,ugBAAugB;QACzgB,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4BX;KACC;IACD,KAAK,EAAE;QACL,IAAI,EAAE,0FAA0F;QAChG,MAAM,EAAE;YACN,0KAA0K;YAC1K,sLAAsL;YACtL,2IAA2I;YAC3I,sHAAsH;YACtH,4IAA4I;SAC7I;QACD,OAAO,EAAE;;;;;;;EAOX;KACC;CACF,CAAC"}
+{"version":3,"file":"scroll-animations.js","sourceRoot":"","sources":["../../src/rules/scroll-animations.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,gBAAgB,GAAS;IACpC,EAAE,EAAE,0BAA0B;IAC9B,KAAK,EAAE,6BAA6B;IACpC,QAAQ,EAAE,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,QAAQ,CAAC;IAC7E,UAAU,EAAE,CAAC,0BAA0B,CAAC;IACxC,MAAM,EAAE,yCAAyC;IACjD,KAAK,EAAE;QACL,SAAS,EACP,ugBAAugB;QACzgB,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4BX;QACE,MAAM,EACJ,qEAAqE;KACxE;IACD,KAAK,EAAE;QACL,IAAI,EAAE,0FAA0F;QAChG,MAAM,EAAE;YACN,0KAA0K;YAC1K,sLAAsL;YACtL,2IAA2I;YAC3I,sHAAsH;YACtH,4IAA4I;SAC7I;QACD,OAAO,EAAE;;;;;;;EAOX;KACC;CACF,CAAC"}

package/dist/rules/scroll-lock.d.ts.map

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

package/dist/rules/scroll-lock.js

@@ -22,6 +22,7 @@ export const scrollLock = {
 body {
   overscroll-behavior-y: contain;
 }`,
+        mdnUrl: "https://developer.mozilla.org/en-US/docs/Web/CSS/overscroll-behavior",
     },
     agent: {
         when: "stopping the page behind a modal or drawer from scrolling when the overlay reaches its end",

package/dist/rules/scroll-lock.js.map

@@ -1 +1 @@
-{"version":3,"file":"scroll-lock.js","sourceRoot":"","sources":["../../src/rules/scroll-lock.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,UAAU,GAAS;IAC9B,EAAE,EAAE,qBAAqB;IACzB,KAAK,EAAE,sCAAsC;IAC7C,QAAQ,EAAE;QACR,kBAAkB;QAClB,kBAAkB;QAClB,WAAW;QACX,aAAa;KACd;IACD,UAAU,EAAE,CAAC,qBAAqB,CAAC;IACnC,MAAM,EAAE,8BAA8B;IACtC,KAAK,EAAE;QACL,SAAS,EACP,mfAAmf;QACrf,OAAO,EAAE;;;;;;;;;;EAUX;KACC;IACD,KAAK,EAAE;QACL,IAAI,EAAE,4FAA4F;QAClG,MAAM,EAAE;YACN,0KAA0K;YAC1K,2MAA2M;YAC3M,0IAA0I;YAC1I,kFAAkF;SACnF;QACD,OAAO,EAAE;;;EAGX;KACC;CACF,CAAC"}
+{"version":3,"file":"scroll-lock.js","sourceRoot":"","sources":["../../src/rules/scroll-lock.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,UAAU,GAAS;IAC9B,EAAE,EAAE,qBAAqB;IACzB,KAAK,EAAE,sCAAsC;IAC7C,QAAQ,EAAE;QACR,kBAAkB;QAClB,kBAAkB;QAClB,WAAW;QACX,aAAa;KACd;IACD,UAAU,EAAE,CAAC,qBAAqB,CAAC;IACnC,MAAM,EAAE,8BAA8B;IACtC,KAAK,EAAE;QACL,SAAS,EACP,mfAAmf;QACrf,OAAO,EAAE;;;;;;;;;;EAUX;QACE,MAAM,EACJ,sEAAsE;KACzE;IACD,KAAK,EAAE;QACL,IAAI,EAAE,4FAA4F;QAClG,MAAM,EAAE;YACN,0KAA0K;YAC1K,2MAA2M;YAC3M,0IAA0I;YAC1I,kFAAkF;SACnF;QACD,OAAO,EAAE;;;EAGX;KACC;CACF,CAAC"}

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

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

package/dist/rules/scrollbars.js

@@ -9,6 +9,9 @@ export const scrollbars = {
         "overlayscrollbars",
         "overlayscrollbars-react",
         "perfect-scrollbar",
+        "vue-perfect-scrollbar",
+        "overlayscrollbars-vue",
+        "ngx-perfect-scrollbar",
     ],
     featureIds: ["scrollbar-width", "scrollbar-color", "scrollbar-gutter"],
     native: "scrollbar-width, scrollbar-color and scrollbar-gutter",
@@ -25,6 +28,7 @@ html {
   scrollbar-color: #666 transparent;
   overflow-y: auto;
 }`,
+        mdnUrl: "https://developer.mozilla.org/en-US/docs/Web/CSS/scrollbar-color",
     },
     agent: {
         when: "restyling a scrollbar to match a dark theme, or stopping layout shift when a scrollbar appears",

package/dist/rules/scrollbars.js.map

@@ -1 +1 @@
-{"version":3,"file":"scrollbars.js","sourceRoot":"","sources":["../../src/rules/scrollbars.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,UAAU,GAAS;IAC9B,EAAE,EAAE,mBAAmB;IACvB,KAAK,EAAE,mBAAmB;IAC1B,QAAQ,EAAE;QACR,yBAAyB;QACzB,2BAA2B;QAC3B,WAAW;QACX,iBAAiB;QACjB,mBAAmB;QACnB,yBAAyB;QACzB,mBAAmB;KACpB;IACD,UAAU,EAAE,CAAC,iBAAiB,EAAE,iBAAiB,EAAE,kBAAkB,CAAC;IACtE,MAAM,EAAE,uDAAuD;IAC/D,KAAK,EAAE;QACL,SAAS,EACP,wdAAwd;QAC1d,OAAO,EAAE;;;;;;;;;;EAUX;KACC;IACD,KAAK,EAAE;QACL,IAAI,EAAE,gGAAgG;QACtG,MAAM,EAAE;YACN,iMAAiM;YACjM,yGAAyG;YACzG,6HAA6H;YAC7H,iHAAiH;SAClH;QACD,OAAO,EAAE;;;;EAIX;KACC;CACF,CAAC"}
+{"version":3,"file":"scrollbars.js","sourceRoot":"","sources":["../../src/rules/scrollbars.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,UAAU,GAAS;IAC9B,EAAE,EAAE,mBAAmB;IACvB,KAAK,EAAE,mBAAmB;IAC1B,QAAQ,EAAE;QACR,yBAAyB;QACzB,2BAA2B;QAC3B,WAAW;QACX,iBAAiB;QACjB,mBAAmB;QACnB,yBAAyB;QACzB,mBAAmB;QACnB,uBAAuB;QACvB,uBAAuB;QACvB,uBAAuB;KACxB;IACD,UAAU,EAAE,CAAC,iBAAiB,EAAE,iBAAiB,EAAE,kBAAkB,CAAC;IACtE,MAAM,EAAE,uDAAuD;IAC/D,KAAK,EAAE;QACL,SAAS,EACP,wdAAwd;QAC1d,OAAO,EAAE;;;;;;;;;;EAUX;QACE,MAAM,EAAE,kEAAkE;KAC3E;IACD,KAAK,EAAE;QACL,IAAI,EAAE,gGAAgG;QACtG,MAAM,EAAE;YACN,iMAAiM;YACjM,yGAAyG;YACzG,6HAA6H;YAC7H,iHAAiH;SAClH;QACD,OAAO,EAAE;;;;EAIX;KACC;CACF,CAAC"}

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

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

package/dist/rules/select.js

@@ -1,7 +1,16 @@
 export const select = {
     id: "customizable-select",
     title: "Custom select menus",
-    replaces: ["react-select", "choices.js", "select2", "tom-select"],
+    replaces: [
+        "react-select",
+        "choices.js",
+        "select2",
+        "tom-select",
+        "vue-select",
+        "vue-multiselect",
+        "@ng-select/ng-select",
+        "svelte-select",
+    ],
     featureIds: ["customizable-select"],
     native: "appearance: base-select on <select>",
     human: {
@@ -33,6 +42,7 @@ export const select = {
     font-weight: 600;
   }
 </style>`,
+        mdnUrl: "https://developer.mozilla.org/en-US/docs/Web/CSS/appearance",
     },
     agent: {
         when: "styling a select's options with markup, such as a flag or a two-line label",

package/dist/rules/select.js.map

@@ -1 +1 @@
-{"version":3,"file":"select.js","sourceRoot":"","sources":["../../src/rules/select.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,MAAM,GAAS;IAC1B,EAAE,EAAE,qBAAqB;IACzB,KAAK,EAAE,qBAAqB;IAC5B,QAAQ,EAAE,CAAC,cAAc,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,CAAC;IACjE,UAAU,EAAE,CAAC,qBAAqB,CAAC;IACnC,MAAM,EAAE,qCAAqC;IAC7C,KAAK,EAAE;QACL,SAAS,EACP,+YAA+Y;QACjZ,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;SA0BJ;KACN;IACD,KAAK,EAAE;QACL,IAAI,EAAE,4EAA4E;QAClF,MAAM,EAAE;YACN,0LAA0L;YAC1L,qFAAqF;YACrF,gLAAgL;YAChL,qEAAqE;SACtE;QACD,OAAO,EAAE;;;;;;SAMJ;KACN;CACF,CAAC"}
+{"version":3,"file":"select.js","sourceRoot":"","sources":["../../src/rules/select.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,MAAM,GAAS;IAC1B,EAAE,EAAE,qBAAqB;IACzB,KAAK,EAAE,qBAAqB;IAC5B,QAAQ,EAAE;QACR,cAAc;QACd,YAAY;QACZ,SAAS;QACT,YAAY;QACZ,YAAY;QACZ,iBAAiB;QACjB,sBAAsB;QACtB,eAAe;KAChB;IACD,UAAU,EAAE,CAAC,qBAAqB,CAAC;IACnC,MAAM,EAAE,qCAAqC;IAC7C,KAAK,EAAE;QACL,SAAS,EACP,+YAA+Y;QACjZ,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;SA0BJ;QACL,MAAM,EAAE,6DAA6D;KACtE;IACD,KAAK,EAAE;QACL,IAAI,EAAE,4EAA4E;QAClF,MAAM,EAAE;YACN,0LAA0L;YAC1L,qFAAqF;YACrF,gLAAgL;YAChL,qEAAqE;SACtE;QACD,OAAO,EAAE;;;;;;SAMJ;KACN;CACF,CAAC"}

package/dist/rules/smooth-scroll.d.ts.map

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

package/dist/rules/smooth-scroll.js

@@ -7,6 +7,7 @@ export const smoothScroll = {
         "scroll-behavior-polyfill",
         "smooth-scroll",
         "jump.js",
+        "vue-scrollto",
     ],
     featureIds: ["scroll-behavior"],
     native: "scroll-behavior: smooth with scroll-margin-top",
@@ -23,6 +24,7 @@ export const smoothScroll = {
 [id] {
   scroll-margin-top: 5rem;
 }`,
+        mdnUrl: "https://developer.mozilla.org/en-US/docs/Web/CSS/scroll-behavior",
     },
     agent: {
         when: "making in-page anchor links scroll smoothly to their target",

package/dist/rules/smooth-scroll.js.map

@@ -1 +1 @@
-{"version":3,"file":"smooth-scroll.js","sourceRoot":"","sources":["../../src/rules/smooth-scroll.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,YAAY,GAAS;IAChC,EAAE,EAAE,eAAe;IACnB,KAAK,EAAE,uCAAuC;IAC9C,QAAQ,EAAE;QACR,cAAc;QACd,uBAAuB;QACvB,0BAA0B;QAC1B,eAAe;QACf,SAAS;KACV;IACD,UAAU,EAAE,CAAC,iBAAiB,CAAC;IAC/B,MAAM,EAAE,gDAAgD;IACxD,KAAK,EAAE;QACL,SAAS,EACP,mYAAmY;QACrY,OAAO,EAAE;;;;;;;;;;EAUX;KACC;IACD,KAAK,EAAE;QACL,IAAI,EAAE,6DAA6D;QACnE,MAAM,EAAE;YACN,mHAAmH;YACnH,6GAA6G;YAC7G,gFAAgF;YAChF,8KAA8K;SAC/K;QACD,OAAO,EAAE;;;kCAGqB;KAC/B;CACF,CAAC"}
+{"version":3,"file":"smooth-scroll.js","sourceRoot":"","sources":["../../src/rules/smooth-scroll.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,YAAY,GAAS;IAChC,EAAE,EAAE,eAAe;IACnB,KAAK,EAAE,uCAAuC;IAC9C,QAAQ,EAAE;QACR,cAAc;QACd,uBAAuB;QACvB,0BAA0B;QAC1B,eAAe;QACf,SAAS;QACT,cAAc;KACf;IACD,UAAU,EAAE,CAAC,iBAAiB,CAAC;IAC/B,MAAM,EAAE,gDAAgD;IACxD,KAAK,EAAE;QACL,SAAS,EACP,mYAAmY;QACrY,OAAO,EAAE;;;;;;;;;;EAUX;QACE,MAAM,EAAE,kEAAkE;KAC3E;IACD,KAAK,EAAE;QACL,IAAI,EAAE,6DAA6D;QACnE,MAAM,EAAE;YACN,mHAAmH;YACnH,6GAA6G;YAC7G,gFAAgF;YAChF,8KAA8K;SAC/K;QACD,OAAO,EAAE;;;kCAGqB;KAC/B;CACF,CAAC"}

package/dist/rules/speech-recognition.d.ts

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

package/dist/rules/speech-recognition.d.ts.map

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

package/dist/rules/speech-recognition.js

@@ -0,0 +1,27 @@
+export const speechRecognition = {
+    id: "speech-recognition",
+    title: "Voice input",
+    replaces: ["annyang", "react-speech-recognition"],
+    featureIds: ["speech-recognition"],
+    native: "SpeechRecognition",
+    human: {
+        explainer: "annyang and react-speech-recognition both wrap the same underlying API, adding phrase matching or restart-on-silence logic around it. The API itself lets a page listen for speech and get back a transcript, with no server round-trip for the recognition step in Chromium's implementation.",
+        snippet: `const recognition = new SpeechRecognition();
+recognition.onresult = (event) => {
+  console.log(event.results[0][0].transcript);
+};
+recognition.start();`,
+        mdnUrl: "https://developer.mozilla.org/en-US/docs/Web/API/SpeechRecognition",
+    },
+    agent: {
+        when: "capturing a speech-to-text transcript directly in the browser",
+        unless: [
+            "You need this outside Chrome or Edge. No other engine ships SpeechRecognition, so this is Chromium-only in practice today.",
+            "You need continuous recognition that automatically restarts after the browser's built-in silence timeout. That restart logic is exactly what these libraries still add.",
+            "You need offline recognition. Chrome's implementation sends audio to Google's servers for transcription.",
+        ],
+        snippet: `const recognition = new SpeechRecognition();
+recognition.start();`,
+    },
+};
+//# sourceMappingURL=speech-recognition.js.map

package/dist/rules/speech-recognition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"speech-recognition.js","sourceRoot":"","sources":["../../src/rules/speech-recognition.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,iBAAiB,GAAS;IACrC,EAAE,EAAE,oBAAoB;IACxB,KAAK,EAAE,aAAa;IACpB,QAAQ,EAAE,CAAC,SAAS,EAAE,0BAA0B,CAAC;IACjD,UAAU,EAAE,CAAC,oBAAoB,CAAC;IAClC,MAAM,EAAE,mBAAmB;IAC3B,KAAK,EAAE;QACL,SAAS,EACP,gSAAgS;QAClS,OAAO,EAAE;;;;qBAIQ;QACjB,MAAM,EACJ,oEAAoE;KACvE;IACD,KAAK,EAAE;QACL,IAAI,EAAE,+DAA+D;QACrE,MAAM,EAAE;YACN,4HAA4H;YAC5H,yKAAyK;YACzK,0GAA0G;SAC3G;QACD,OAAO,EAAE;qBACQ;KAClB;CACF,CAAC"}

package/dist/rules/speech-synthesis.d.ts

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

package/dist/rules/speech-synthesis.d.ts.map

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

package/dist/rules/speech-synthesis.js

@@ -0,0 +1,22 @@
+export const speechSynthesis = {
+    id: "speech-synthesis",
+    title: "Text to speech",
+    replaces: ["speak-tts", "react-text-to-speech"],
+    featureIds: ["speech-synthesis"],
+    native: "SpeechSynthesis and SpeechSynthesisUtterance",
+    human: {
+        explainer: "speak-tts is a queueing and promise layer over the browser's own SpeechSynthesis API. The browser already exposes every installed system voice and a speaking queue; the wrapper mostly makes calling it feel more like a promise.",
+        snippet: `const utterance = new SpeechSynthesisUtterance("Hello there");
+speechSynthesis.speak(utterance);`,
+        mdnUrl: "https://developer.mozilla.org/en-US/docs/Web/API/SpeechSynthesis",
+    },
+    agent: {
+        when: "reading text aloud with the browser's own text-to-speech engine",
+        unless: [
+            "You need a specific voice bundled with your app rather than whatever the person's operating system happens to have installed. Voice availability and quality vary by device.",
+            "You need the callback-based API wrapped in a promise, or queueing logic across multiple utterances. The library still saves real code there.",
+        ],
+        snippet: "speechSynthesis.speak(new SpeechSynthesisUtterance(text));",
+    },
+};
+//# sourceMappingURL=speech-synthesis.js.map

package/dist/rules/speech-synthesis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"speech-synthesis.js","sourceRoot":"","sources":["../../src/rules/speech-synthesis.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,eAAe,GAAS;IACnC,EAAE,EAAE,kBAAkB;IACtB,KAAK,EAAE,gBAAgB;IACvB,QAAQ,EAAE,CAAC,WAAW,EAAE,sBAAsB,CAAC;IAC/C,UAAU,EAAE,CAAC,kBAAkB,CAAC;IAChC,MAAM,EAAE,8CAA8C;IACtD,KAAK,EAAE;QACL,SAAS,EACP,oOAAoO;QACtO,OAAO,EAAE;kCACqB;QAC9B,MAAM,EAAE,kEAAkE;KAC3E;IACD,KAAK,EAAE;QACL,IAAI,EAAE,iEAAiE;QACvE,MAAM,EAAE;YACN,8KAA8K;YAC9K,8IAA8I;SAC/I;QACD,OAAO,EAAE,4DAA4D;KACtE;CACF,CAAC"}

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

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

package/dist/rules/sticky.js

@@ -7,6 +7,8 @@ export const sticky = {
         "react-sticky",
         "sticky-kit",
         "stickybits",
+        "vue-sticky-directive",
+        "vue-sticky",
     ],
     featureIds: ["sticky-positioning"],
     native: "position: sticky",
@@ -24,6 +26,7 @@ export const sticky = {
   top: 5rem;
   align-self: start;
 }`,
+        mdnUrl: "https://developer.mozilla.org/en-US/docs/Web/CSS/position#sticky",
     },
     agent: {
         when: "a header, sidebar or table head should stick while its container scrolls",

package/dist/rules/sticky.js.map

@@ -1 +1 @@
-{"version":3,"file":"sticky.js","sourceRoot":"","sources":["../../src/rules/sticky.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,MAAM,GAAS;IAC1B,EAAE,EAAE,oBAAoB;IACxB,KAAK,EAAE,6BAA6B;IACpC,QAAQ,EAAE;QACR,WAAW;QACX,YAAY;QACZ,cAAc;QACd,YAAY;QACZ,YAAY;KACb;IACD,UAAU,EAAE,CAAC,oBAAoB,CAAC;IAClC,MAAM,EAAE,kBAAkB;IAC1B,KAAK,EAAE;QACL,SAAS,EACP,iaAAia;QACna,OAAO,EAAE;;;;;;;;;;;EAWX;KACC;IACD,KAAK,EAAE;QACL,IAAI,EAAE,0EAA0E;QAChF,MAAM,EAAE;YACN,iLAAiL;YACjL,kLAAkL;YAClL,qFAAqF;SACtF;QACD,OAAO,EAAE;6DACgD;KAC1D;CACF,CAAC"}
+{"version":3,"file":"sticky.js","sourceRoot":"","sources":["../../src/rules/sticky.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,MAAM,GAAS;IAC1B,EAAE,EAAE,oBAAoB;IACxB,KAAK,EAAE,6BAA6B;IACpC,QAAQ,EAAE;QACR,WAAW;QACX,YAAY;QACZ,cAAc;QACd,YAAY;QACZ,YAAY;QACZ,sBAAsB;QACtB,YAAY;KACb;IACD,UAAU,EAAE,CAAC,oBAAoB,CAAC;IAClC,MAAM,EAAE,kBAAkB;IAC1B,KAAK,EAAE;QACL,SAAS,EACP,iaAAia;QACna,OAAO,EAAE;;;;;;;;;;;EAWX;QACE,MAAM,EAAE,kEAAkE;KAC3E;IACD,KAAK,EAAE;QACL,IAAI,EAAE,0EAA0E;QAChF,MAAM,EAAE;YACN,iLAAiL;YACjL,kLAAkL;YAClL,qFAAqF;SACtF;QACD,OAAO,EAAE;6DACgD;KAC1D;CACF,CAAC"}

package/dist/rules/structured-clone.d.ts

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

package/dist/rules/structured-clone.d.ts.map

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

package/dist/rules/structured-clone.js

@@ -0,0 +1,21 @@
+export const structuredCloneRule = {
+    id: "structured-clone",
+    title: "Deep cloning",
+    replaces: ["lodash.clonedeep", "rfdc", "clone", "klona"],
+    featureIds: ["structured-clone"],
+    native: "structuredClone()",
+    human: {
+        explainer: "These packages walk an object graph by hand, copying nested arrays and objects one property at a time so the copy shares no references with the original. A global function now does the same job: structuredClone() copies arrays, plain objects, Maps, Sets, and dates in one call, no walking required.",
+        snippet: "const copy = structuredClone(original);",
+        mdnUrl: "https://developer.mozilla.org/en-US/docs/Web/API/structuredClone",
+    },
+    agent: {
+        when: "deep-copying plain data such as arrays, objects, Maps, Sets, and dates",
+        unless: [
+            "You need to clone functions, DOM nodes, or class instances with prototypes. structuredClone throws on all three, where lodash's version silently drops what it can't handle instead.",
+            "You need to clone something containing a value structuredClone doesn't support, such as an Error's custom properties beyond message and name.",
+        ],
+        snippet: "const copy = structuredClone(original);",
+    },
+};
+//# sourceMappingURL=structured-clone.js.map

package/dist/rules/structured-clone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured-clone.js","sourceRoot":"","sources":["../../src/rules/structured-clone.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,mBAAmB,GAAS;IACvC,EAAE,EAAE,kBAAkB;IACtB,KAAK,EAAE,cAAc;IACrB,QAAQ,EAAE,CAAC,kBAAkB,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC;IACxD,UAAU,EAAE,CAAC,kBAAkB,CAAC;IAChC,MAAM,EAAE,mBAAmB;IAC3B,KAAK,EAAE;QACL,SAAS,EACP,4SAA4S;QAC9S,OAAO,EAAE,yCAAyC;QAClD,MAAM,EAAE,kEAAkE;KAC3E;IACD,KAAK,EAAE;QACL,IAAI,EAAE,wEAAwE;QAC9E,MAAM,EAAE;YACN,sLAAsL;YACtL,+IAA+I;SAChJ;QACD,OAAO,EAAE,yCAAyC;KACnD;CACF,CAAC"}

package/dist/rules/text-box-trim.d.ts.map

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

package/dist/rules/text-box-trim.js

@@ -18,6 +18,7 @@ export const textBoxTrim = {
   text-box-trim: trim-both;
   text-box-edge: cap alphabetic;
 }`,
+        mdnUrl: "https://developer.mozilla.org/en-US/docs/Web/CSS/text-box-trim",
     },
     agent: {
         when: "removing a font's built-in leading so text sits flush in its box",

package/dist/rules/text-box-trim.js.map

@@ -1 +1 @@
-{"version":3,"file":"text-box-trim.js","sourceRoot":"","sources":["../../src/rules/text-box-trim.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,WAAW,GAAS;IAC/B,EAAE,EAAE,eAAe;IACnB,KAAK,EAAE,uBAAuB;IAC9B,QAAQ,EAAE,CAAC,SAAS,EAAE,kBAAkB,EAAE,qBAAqB,CAAC;IAChE,UAAU,EAAE,CAAC,UAAU,CAAC;IACxB,MAAM,EAAE,iCAAiC;IACzC,KAAK,EAAE;QACL,SAAS,EACP,+bAA+b;QACjc,OAAO,EAAE;;;;;;;;;;;EAWX;KACC;IACD,KAAK,EAAE;QACL,IAAI,EAAE,kEAAkE;QACxE,MAAM,EAAE;YACN,oMAAoM;YACpM,+LAA+L;YAC/L,yGAAyG;SAC1G;QACD,OAAO,EAAE,4CAA4C;KACtD;CACF,CAAC"}
+{"version":3,"file":"text-box-trim.js","sourceRoot":"","sources":["../../src/rules/text-box-trim.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,WAAW,GAAS;IAC/B,EAAE,EAAE,eAAe;IACnB,KAAK,EAAE,uBAAuB;IAC9B,QAAQ,EAAE,CAAC,SAAS,EAAE,kBAAkB,EAAE,qBAAqB,CAAC;IAChE,UAAU,EAAE,CAAC,UAAU,CAAC;IACxB,MAAM,EAAE,iCAAiC;IACzC,KAAK,EAAE;QACL,SAAS,EACP,+bAA+b;QACjc,OAAO,EAAE;;;;;;;;;;;EAWX;QACE,MAAM,EAAE,gEAAgE;KACzE;IACD,KAAK,EAAE;QACL,IAAI,EAAE,kEAAkE;QACxE,MAAM,EAAE;YACN,oMAAoM;YACpM,+LAA+L;YAC/L,yGAAyG;SAC1G;QACD,OAAO,EAAE,4CAA4C;KACtD;CACF,CAAC"}

package/dist/rules/text-wrap-balance.d.ts.map

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

package/dist/rules/text-wrap-balance.js

@@ -18,6 +18,7 @@ blockquote {
 p {
   text-wrap: pretty;
 }`,
+        mdnUrl: "https://developer.mozilla.org/en-US/docs/Web/CSS/text-wrap",
     },
     agent: {
         when: "stopping a heading or short blurb from breaking with one word on the last line",

package/dist/rules/text-wrap-balance.js.map

@@ -1 +1 @@
-{"version":3,"file":"text-wrap-balance.js","sourceRoot":"","sources":["../../src/rules/text-wrap-balance.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,eAAe,GAAS;IACnC,EAAE,EAAE,mBAAmB;IACvB,KAAK,EAAE,mBAAmB;IAC1B,QAAQ,EAAE,CAAC,qBAAqB,EAAE,cAAc,CAAC;IACjD,UAAU,EAAE,CAAC,mBAAmB,CAAC;IACjC,MAAM,EAAE,oBAAoB;IAC5B,KAAK,EAAE;QACL,SAAS,EACP,qbAAqb;QACvb,OAAO,EAAE;;;;;;;;;;;EAWX;KACC;IACD,KAAK,EAAE;QACL,IAAI,EAAE,gFAAgF;QACtF,MAAM,EAAE;YACN,4JAA4J;YAC5J,mKAAmK;YACnK,gIAAgI;YAChI,gJAAgJ;SACjJ;QACD,OAAO,EAAE;yBACY;KACtB;CACF,CAAC"}
+{"version":3,"file":"text-wrap-balance.js","sourceRoot":"","sources":["../../src/rules/text-wrap-balance.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,eAAe,GAAS;IACnC,EAAE,EAAE,mBAAmB;IACvB,KAAK,EAAE,mBAAmB;IAC1B,QAAQ,EAAE,CAAC,qBAAqB,EAAE,cAAc,CAAC;IACjD,UAAU,EAAE,CAAC,mBAAmB,CAAC;IACjC,MAAM,EAAE,oBAAoB;IAC5B,KAAK,EAAE;QACL,SAAS,EACP,qbAAqb;QACvb,OAAO,EAAE;;;;;;;;;;;EAWX;QACE,MAAM,EAAE,4DAA4D;KACrE;IACD,KAAK,EAAE;QACL,IAAI,EAAE,gFAAgF;QACtF,MAAM,EAAE;YACN,4JAA4J;YAC5J,mKAAmK;YACnK,gIAAgI;YAChI,gJAAgJ;SACjJ;QACD,OAAO,EAAE;yBACY;KACtB;CACF,CAAC"}

package/dist/rules/view-transitions.d.ts.map

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

package/dist/rules/view-transitions.js

@@ -32,6 +32,7 @@ document.startViewTransition(() => {
     animation: none;
   }
 }`,
+        mdnUrl: "https://developer.mozilla.org/en-US/docs/Web/API/View_Transitions_API",
     },
     agent: {
         when: "cross-fading between two states, or growing a thumbnail into a hero image across a navigation",

package/dist/rules/view-transitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"view-transitions.js","sourceRoot":"","sources":["../../src/rules/view-transitions.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,eAAe,GAAS;IACnC,EAAE,EAAE,kBAAkB;IACtB,KAAK,EAAE,4BAA4B;IACnC,QAAQ,EAAE;QACR,uBAAuB;QACvB,uBAAuB;QACvB,UAAU;QACV,MAAM;KACP;IACD,UAAU,EAAE,CAAC,kBAAkB,CAAC;IAChC,MAAM,EAAE,0BAA0B;IAClC,KAAK,EAAE;QACL,SAAS,EACP,gcAAgc;QAClc,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;EAoBX;KACC;IACD,KAAK,EAAE;QACL,IAAI,EAAE,+FAA+F;QACrG,MAAM,EAAE;YACN,+LAA+L;YAC/L,4JAA4J;YAC5J,6HAA6H;YAC7H,oGAAoG;YACpG,2FAA2F;SAC5F;QACD,OAAO,EAAE;;;;;EAKX;KACC;CACF,CAAC"}
+{"version":3,"file":"view-transitions.js","sourceRoot":"","sources":["../../src/rules/view-transitions.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,eAAe,GAAS;IACnC,EAAE,EAAE,kBAAkB;IACtB,KAAK,EAAE,4BAA4B;IACnC,QAAQ,EAAE;QACR,uBAAuB;QACvB,uBAAuB;QACvB,UAAU;QACV,MAAM;KACP;IACD,UAAU,EAAE,CAAC,kBAAkB,CAAC;IAChC,MAAM,EAAE,0BAA0B;IAClC,KAAK,EAAE;QACL,SAAS,EACP,gcAAgc;QAClc,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;EAoBX;QACE,MAAM,EACJ,uEAAuE;KAC1E;IACD,KAAK,EAAE;QACL,IAAI,EAAE,+FAA+F;QACrG,MAAM,EAAE;YACN,+LAA+L;YAC/L,4JAA4J;YAC5J,6HAA6H;YAC7H,oGAAoG;YACpG,2FAA2F;SAC5F;QACD,OAAO,EAAE;;;;;EAKX;KACC;CACF,CAAC"}

package/dist/rules/web-bluetooth.d.ts

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

package/dist/rules/web-bluetooth.d.ts.map

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

package/dist/rules/web-bluetooth.js

@@ -0,0 +1,25 @@
+export const webBluetooth = {
+    id: "web-bluetooth",
+    title: "Bluetooth device access",
+    replaces: ["@capacitor-community/bluetooth-le", "cordova-plugin-ble-central"],
+    featureIds: ["web-bluetooth"],
+    native: "navigator.bluetooth.requestDevice()",
+    human: {
+        explainer: "Talking to a Bluetooth peripheral from a web app used to mean wrapping the page in a native shell such as Cordova or Capacitor and reaching for a plugin that called into the operating system's own Bluetooth stack. A page running directly in a supporting browser can request a device, connect to its GATT services, and read or write characteristics with no native wrapper at all. This is a narrower case than most of this catalog. It replaces the native-app packaging step these plugins exist for, rather than a JavaScript library doing work the browser could already do.",
+        snippet: `const device = await navigator.bluetooth.requestDevice({
+  acceptAllDevices: true,
+});
+const server = await device.gatt.connect();`,
+        mdnUrl: "https://developer.mozilla.org/en-US/docs/Web/API/Web_Bluetooth_API",
+    },
+    agent: {
+        when: "connecting to a Bluetooth Low Energy device directly from a web page",
+        unless: [
+            "You need to support iOS in any browser. Apple has stated it has no plans to implement Web Bluetooth. That gap is permanent for iPhone and iPad users.",
+            "You need background scanning or a connection that survives the tab closing. The API only works while the page is open.",
+            "You are already shipping a native app shell for other reasons. The plugin ecosystem is more mature for background operation and OS-level pairing UI.",
+        ],
+        snippet: "await navigator.bluetooth.requestDevice({ acceptAllDevices: true });",
+    },
+};
+//# sourceMappingURL=web-bluetooth.js.map

package/dist/rules/web-bluetooth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-bluetooth.js","sourceRoot":"","sources":["../../src/rules/web-bluetooth.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,YAAY,GAAS;IAChC,EAAE,EAAE,eAAe;IACnB,KAAK,EAAE,yBAAyB;IAChC,QAAQ,EAAE,CAAC,mCAAmC,EAAE,4BAA4B,CAAC;IAC7E,UAAU,EAAE,CAAC,eAAe,CAAC;IAC7B,MAAM,EAAE,qCAAqC;IAC7C,KAAK,EAAE;QACL,SAAS,EACP,4jBAA4jB;QAC9jB,OAAO,EAAE;;;4CAG+B;QACxC,MAAM,EACJ,oEAAoE;KACvE;IACD,KAAK,EAAE;QACL,IAAI,EAAE,sEAAsE;QAC5E,MAAM,EAAE;YACN,uJAAuJ;YACvJ,wHAAwH;YACxH,sJAAsJ;SACvJ;QACD,OAAO,EACL,sEAAsE;KACzE;CACF,CAAC"}

package/dist/rules/web-share.d.ts

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

package/dist/rules/web-share.d.ts.map

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

package/dist/rules/web-share.js

@@ -0,0 +1,27 @@
+export const webShare = {
+    id: "web-share",
+    title: "Sharing to other apps",
+    replaces: ["react-share", "vue-social-sharing", "ngx-sharebuttons"],
+    featureIds: ["share"],
+    native: "navigator.share()",
+    human: {
+        explainer: "A share library renders a row of buttons, each pointing at one network's own share-intent URL, so the page decides where the content can go. navigator.share() opens the operating system's own share sheet instead, the same one every native app uses, and lets the person pick where it goes.",
+        snippet: `async function share() {
+  await navigator.share({
+    title: document.title,
+    url: location.href,
+  });
+}`,
+        mdnUrl: "https://developer.mozilla.org/en-US/docs/Web/API/Navigator/share",
+    },
+    agent: {
+        when: "letting someone share the current page or a piece of content to whatever app they choose",
+        unless: [
+            "You need a button for one specific network, such as a fixed Twitter/X or LinkedIn share link. The OS share sheet lists whatever apps the person has installed, not a chosen set.",
+            "You support Firefox on desktop. It has never shipped the Web Share API outside Android.",
+            "You need to share a file the person doesn't already have a URL for. That needs the file-sharing variant of the API, which has narrower browser support again.",
+        ],
+        snippet: "await navigator.share({ title: document.title, url: location.href });",
+    },
+};
+//# sourceMappingURL=web-share.js.map

package/dist/rules/web-share.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-share.js","sourceRoot":"","sources":["../../src/rules/web-share.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,QAAQ,GAAS;IAC5B,EAAE,EAAE,WAAW;IACf,KAAK,EAAE,uBAAuB;IAC9B,QAAQ,EAAE,CAAC,aAAa,EAAE,oBAAoB,EAAE,kBAAkB,CAAC;IACnE,UAAU,EAAE,CAAC,OAAO,CAAC;IACrB,MAAM,EAAE,mBAAmB;IAC3B,KAAK,EAAE;QACL,SAAS,EACP,kSAAkS;QACpS,OAAO,EAAE;;;;;EAKX;QACE,MAAM,EAAE,kEAAkE;KAC3E;IACD,KAAK,EAAE;QACL,IAAI,EAAE,0FAA0F;QAChG,MAAM,EAAE;YACN,kLAAkL;YAClL,yFAAyF;YACzF,+JAA+J;SAChK;QACD,OAAO,EACL,uEAAuE;KAC1E;CACF,CAAC"}

package/dist/schema.d.ts

@@ -43,6 +43,7 @@ export declare const ruleSchema: z.ZodObject<{
         explainer: z.ZodString;
         snippet: z.ZodString;
         demoUrl: z.ZodOptional<z.ZodURL>;
+        mdnUrl: z.ZodOptional<z.ZodURL>;
     }, z.core.$strip>;
     agent: z.ZodObject<{
         when: z.ZodString;
@@ -70,6 +71,7 @@ export declare const catalogSchema: z.ZodArray<z.ZodObject<{
         explainer: z.ZodString;
         snippet: z.ZodString;
         demoUrl: z.ZodOptional<z.ZodURL>;
+        mdnUrl: z.ZodOptional<z.ZodURL>;
     }, z.core.$strip>;
     agent: z.ZodObject<{
         when: z.ZodString;

package/dist/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,eAAO,MAAM,cAAc,IAAI,CAAC;AAEhC;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB;;;;;EAK/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAkBlE;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;iBAK/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;iBA0DnB,CAAC;AAEL,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAE9C,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;kBA2BxB,CAAC;AAEH,8EAA8E;AAC9E,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,EAAE,CAEnD"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,eAAO,MAAM,cAAc,IAAI,CAAC;AAEhC;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB;;;;;EAK/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAkBlE;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;iBAK/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;iBA4DnB,CAAC;AAEL,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAE9C,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;kBA2BxB,CAAC;AAEH,8EAA8E;AAC9E,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,EAAE,CAEnD"}

package/dist/schema.js

@@ -60,10 +60,12 @@ export const ruleSchema = z
     human: z.object({
         /** 2 to 4 sentences of prose. */
         explainer: z.string().min(1),
-        /** Copy-pasteable CSS or HTML. */
+        /** Copy-pasteable CSS, HTML, or JavaScript. */
         snippet: z.string().min(1),
         /** A live demo or a post that walks through it. */
         demoUrl: z.url().optional(),
+        /** The MDN reference page for the native feature. */
+        mdnUrl: z.url().optional(),
     }),
     /** Terse projection for LLM surfaces. Budget roughly 200 tokens. */
     agent: z.object({