@jomae/catalog 0.3.0 → 0.6.0

package/dist/rules/server-sent-events.js

@@ -0,0 +1,38 @@
+export const serverSentEvents = {
+    id: "server-sent-events",
+    title: "Server-sent events",
+    category: "async-data",
+    replaces: ["eventsource", "event-source-polyfill"],
+    featureIds: ["server-sent-events"],
+    native: "EventSource",
+    human: {
+        explainer: "EventSource opens a one-way stream from the server and hands you each message as an event. The browser owns the reconnection: if the connection drops it backs off and reconnects on its own, and it replays the last event ID so the server can resume where it left off. Both packages are ports of this API, written for Node or for browsers that predate it.",
+        snippet: `const source = new EventSource("/api/updates", {
+  withCredentials: true,
+});
+
+source.addEventListener("price", (event) => {
+  update(JSON.parse(event.data));
+});
+
+source.addEventListener("error", () => {
+  // The browser is already retrying. Close only to stop for good.
+  if (source.readyState === EventSource.CLOSED) reportOffline();
+});`,
+        mdnUrl: "https://developer.mozilla.org/en-US/docs/Web/API/EventSource",
+    },
+    agent: {
+        when: "subscribing to a one-way stream of updates from a server",
+        unless: [
+            "You send an Authorization header on the connection. EventSource cannot set request headers at all, which is the single most common reason projects install the polyfill instead.",
+            "The stream needs a POST body or a method other than GET, in which case fetch with a ReadableStream is the platform answer rather than EventSource.",
+            "You need control over the reconnection: your own backoff, a retry cap, or a hard failure after N attempts. The browser's loop is not configurable from script.",
+            "The code runs in Node rather than a browser. A global EventSource arrived there only recently, and this package is the established client for older runtimes.",
+            "You need to inspect response status or headers on connect, for example to tell a 401 apart from a network drop. EventSource surfaces one opaque error event.",
+        ],
+        snippet: `const source = new EventSource("/api/updates");
+source.addEventListener("price", (e) => update(JSON.parse(e.data)));
+source.close();`,
+    },
+};
+//# sourceMappingURL=server-sent-events.js.map

package/dist/rules/server-sent-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-sent-events.js","sourceRoot":"","sources":["../../src/rules/server-sent-events.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,gBAAgB,GAAS;IACpC,EAAE,EAAE,oBAAoB;IACxB,KAAK,EAAE,oBAAoB;IAC3B,QAAQ,EAAE,YAAY;IACtB,QAAQ,EAAE,CAAC,aAAa,EAAE,uBAAuB,CAAC;IAClD,UAAU,EAAE,CAAC,oBAAoB,CAAC;IAClC,MAAM,EAAE,aAAa;IACrB,KAAK,EAAE;QACL,SAAS,EACP,mWAAmW;QACrW,OAAO,EAAE;;;;;;;;;;;IAWT;QACA,MAAM,EAAE,8DAA8D;KACvE;IACD,KAAK,EAAE;QACL,IAAI,EAAE,0DAA0D;QAChE,MAAM,EAAE;YACN,kLAAkL;YAClL,oJAAoJ;YACpJ,gKAAgK;YAChK,+JAA+J;YAC/J,8JAA8J;SAC/J;QACD,OAAO,EAAE;;gBAEG;KACb;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,IAyC1B,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,IA4C1B,CAAC"}

package/dist/rules/smooth-scroll.js

@@ -1,12 +1,14 @@
 export const smoothScroll = {
     id: "smooth-scroll",
     title: "Smooth scrolling and scroll-to-anchor",
+    category: "scrolling",
     replaces: [
         "react-scroll",
         "smoothscroll-polyfill",
         "scroll-behavior-polyfill",
         "smooth-scroll",
         "jump.js",
+        "vue-scrollto",
     ],
     featureIds: ["scroll-behavior"],
     native: "scroll-behavior: smooth with scroll-margin-top",
@@ -38,5 +40,6 @@ export const smoothScroll = {
 }
 [id] { scroll-margin-top: 5rem; }`,
     },
+    guides: ["scroll-target-on-load"],
 };
 //# sourceMappingURL=smooth-scroll.js.map

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;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"}
+{"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,WAAW;IACrB,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;IACD,MAAM,EAAE,CAAC,uBAAuB,CAAC;CAClC,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,IAoC/B,CAAC"}

package/dist/rules/speech-recognition.js

@@ -0,0 +1,36 @@
+export const speechRecognition = {
+    id: "speech-recognition",
+    title: "Voice input",
+    category: "device-apis",
+    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 hands back a transcript with confidence scores. The constructor is the one part worth copying carefully: the unprefixed name only arrived in Chrome {{chrome:speech-recognition}}, and Safari has exposed it as webkitSpeechRecognition for years, so read both off the window before calling it.",
+        snippet: `// Unprefixed is Chrome {{chrome:speech-recognition}} and up. Safari has only
+// the prefixed name,
+// and reading it off window avoids a ReferenceError everywhere else.
+const SpeechRecognitionCtor =
+  window.SpeechRecognition ?? window.webkitSpeechRecognition;
+
+if (SpeechRecognitionCtor) {
+  const recognition = new SpeechRecognitionCtor();
+  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 want one constructor name that works everywhere. The unprefixed SpeechRecognition is Chrome and Edge {{chrome:speech-recognition}} and up, Safari has only webkitSpeechRecognition, and Firefox ships neither, so the feature detection is yours to write.",
+            "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 recognition to stay on the device. Chrome sends audio to Google's servers by default, and on-device transcription is a separate opt-in rather than the behaviour you get for free.",
+        ],
+        snippet: `const Ctor = window.SpeechRecognition ?? window.webkitSpeechRecognition;
+if (Ctor) new Ctor().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,aAAa;IACvB,QAAQ,EAAE,CAAC,SAAS,EAAE,0BAA0B,CAAC;IACjD,UAAU,EAAE,CAAC,oBAAoB,CAAC;IAClC,MAAM,EAAE,mBAAmB;IAC3B,KAAK,EAAE;QACL,SAAS,EACP,0dAA0d;QAC5d,OAAO,EAAE;;;;;;;;;;;;EAYX;QACE,MAAM,EACJ,oEAAoE;KACvE;IACD,KAAK,EAAE;QACL,IAAI,EAAE,+DAA+D;QACrE,MAAM,EAAE;YACN,gQAAgQ;YAChQ,yKAAyK;YACzK,6LAA6L;SAC9L;QACD,OAAO,EAAE;8BACiB;KAC3B;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,IAwB7B,CAAC"}

package/dist/rules/speech-synthesis.js

@@ -0,0 +1,25 @@
+export const speechSynthesis = {
+    id: "speech-synthesis",
+    title: "Text to speech",
+    category: "device-apis",
+    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 the voice list on first paint. speechSynthesis.getVoices() returns an empty array until the voiceschanged event fires, so a voice picker has to wait for it, and that timing is most of what speak-tts wraps.",
+            "You speak long passages in Chrome, which cuts an utterance off after roughly fifteen seconds unless something keeps resuming it.",
+            "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,aAAa;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,wNAAwN;YACxN,kIAAkI;YAClI,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,IAuCpB,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,IA2CpB,CAAC"}

package/dist/rules/sticky.js

@@ -1,12 +1,15 @@
 export const sticky = {
     id: "sticky-positioning",
     title: "Sticky headers and sidebars",
+    category: "layout",
     replaces: [
         "sticky-js",
         "stickyfill",
         "react-sticky",
         "sticky-kit",
         "stickybits",
+        "vue-sticky-directive",
+        "vue-sticky",
     ],
     featureIds: ["sticky-positioning"],
     native: "position: sticky",
@@ -36,5 +39,6 @@ export const sticky = {
         snippet: `.header { position: sticky; top: 0; z-index: 10; }
 .sidebar { position: sticky; top: 5rem; align-self: start; }`,
     },
+    guides: ["state-aware-sticky-headers", "scroll-position-aware-elements"],
 };
 //# sourceMappingURL=sticky.js.map

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;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"}
+{"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,QAAQ;IAClB,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;IACD,MAAM,EAAE,CAAC,4BAA4B,EAAE,gCAAgC,CAAC;CACzE,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,IA+BjC,CAAC"}

package/dist/rules/structured-clone.js

@@ -0,0 +1,32 @@
+export const structuredCloneRule = {
+    id: "structured-clone",
+    title: "Deep cloning",
+    category: "async-data",
+    replaces: [
+        "lodash.clonedeep",
+        "rfdc",
+        "clone",
+        "klona",
+        "clone-deep",
+        "fast-copy",
+        "just-clone",
+    ],
+    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 or DOM nodes. structuredClone throws a DataCloneError on both, where lodash's version drops what it cannot handle and carries on.",
+            "You clone class instances and need the prototype back. structuredClone does not throw here, which is the trap: it returns a plain object with the same fields and no methods, so the failure shows up later at the first method call.",
+            "You need to clone something containing a value structuredClone doesn't support, such as an Error's custom properties beyond message and name.",
+            "You clone large objects on a hot path and measured the difference. Being faster than structuredClone on plain data is the whole pitch of rfdc and fast-copy, and a benchmark on your own shapes is the only way to settle it.",
+        ],
+        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,YAAY;IACtB,QAAQ,EAAE;QACR,kBAAkB;QAClB,MAAM;QACN,OAAO;QACP,OAAO;QACP,YAAY;QACZ,WAAW;QACX,YAAY;KACb;IACD,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,+JAA+J;YAC/J,uOAAuO;YACvO,+IAA+I;YAC/I,+NAA+N;SAChO;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,IAgCzB,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,IAkCzB,CAAC"}

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

@@ -1,6 +1,7 @@
 export const textBoxTrim = {
     id: "text-box-trim",
     title: "Trimming font leading",
+    category: "typography",
     replaces: ["capsize", "@capsizecss/core", "@capsizecss/metrics"],
     featureIds: ["text-box"],
     native: "text-box-trim and text-box-edge",
@@ -23,11 +24,12 @@ export const textBoxTrim = {
     agent: {
         when: "removing a font's built-in leading so text sits flush in its box",
         unless: [
-            "You are shipping to production outside Chromium. text-box is limited availability, and the fallback is the untrimmed spacing you started with, which shifts your vertical rhythm between browsers.",
+            "Your support target reaches below Chrome {{chrome:css.properties.text-box}}, Safari {{safari:css.properties.text-box}} or Firefox {{firefox:css.properties.text-box}}. Firefox was last to ship it, so on an older target the fallback is the untrimmed spacing you started with and your vertical rhythm shifts between browsers.",
             "You need the computed metrics as numbers at build time, for example to generate spacing tokens or to lay out text in a canvas or a PDF. Capsize gives you values; CSS only affects rendering.",
             "You need to support a font whose metrics are wrong or missing, which Capsize lets you override by hand.",
         ],
         snippet: "h1 { text-box: trim-both cap alphabetic; }",
     },
+    guides: ["precise-text-alignment"],
 };
 //# sourceMappingURL=text-box-trim.js.map

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;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"}
+{"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,YAAY;IACtB,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,oUAAoU;YACpU,+LAA+L;YAC/L,yGAAyG;SAC1G;QACD,OAAO,EAAE,4CAA4C;KACtD;IACD,MAAM,EAAE,CAAC,wBAAwB,CAAC;CACnC,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,IAkC7B,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,IAoC7B,CAAC"}

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

@@ -1,6 +1,7 @@
 export const textWrapBalance = {
     id: "text-wrap-balance",
     title: "Balanced headings",
+    category: "typography",
     replaces: ["react-wrap-balancer", "balance-text"],
     featureIds: ["text-wrap-balance"],
     native: "text-wrap: balance",
@@ -31,5 +32,6 @@ p {
         snippet: `h1, h2, h3 { text-wrap: balance; }
 p { text-wrap: pretty; }`,
     },
+    guides: ["improve-text-layout-and-legibility"],
 };
 //# sourceMappingURL=text-wrap-balance.js.map

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;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"}
+{"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,YAAY;IACtB,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;IACD,MAAM,EAAE,CAAC,oCAAoC,CAAC;CAC/C,CAAC"}

package/dist/rules/url-search-params.d.ts

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

package/dist/rules/url-search-params.d.ts.map

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

package/dist/rules/url-search-params.js

@@ -0,0 +1,42 @@
+export const urlSearchParams = {
+    id: "url-search-params",
+    title: "Query string parsing",
+    category: "async-data",
+    replaces: ["query-string", "qs", "querystringify", "url-parse"],
+    featureIds: [],
+    manualBaseline: {
+        status: "widely",
+        verifiedOn: "2026-09-06",
+        note: "web-features folds URLSearchParams into the 'url' feature, which reports Chrome {{chrome:url}} and Safari {{safari:url}} because the URL constructor landed first. URLSearchParams itself is Chrome {{chrome:api.URLSearchParams}}, Firefox {{firefox:api.URLSearchParams}} and Safari {{safari:api.URLSearchParams}}. Deriving from 'url' would understate the floor by three Safari majors. Widely available on its own dates since 2017.",
+    },
+    native: "URLSearchParams and the URL constructor",
+    human: {
+        explainer: "URLSearchParams reads and writes query strings, handles percent-encoding in both directions, and gives you get, getAll, set, append and delete. new URL() does the same job for a whole address, so the hostname, the pathname and the search params come apart without a regular expression. Both have been in every browser since 2017 and in Node for as long, and both are what these libraries call underneath once you strip the option handling.",
+        snippet: `const url = new URL("/search?tag=css&tag=html&page=2", location.origin);
+
+url.searchParams.getAll("tag"); // ["css", "html"]
+url.searchParams.get("page"); // "2", a string
+url.searchParams.set("page", "3");
+
+// Build one from scratch.
+new URLSearchParams({ q: "scroll snap", page: "1" }).toString();
+// "q=scroll+snap&page=1"`,
+        mdnUrl: "https://developer.mozilla.org/en-US/docs/Web/API/URLSearchParams",
+    },
+    agent: {
+        when: "reading or building a query string, or pulling a URL apart",
+        unless: [
+            "You parse nested objects or arrays from bracket syntax such as filter[status][]=open. That is the reason qs exists, and URLSearchParams has no equivalent.",
+            "You round-trip typed data through the query string. Every value comes back as a string, so numbers, booleans and null need converting at each read site.",
+            "You depend on the library's options: a custom array format, a configurable delimiter, sorted output, or comma-separated values parsed into arrays.",
+            "You parse untrusted input on a server and rely on qs's depth and parameterLimit guards against prototype pollution. URLSearchParams applies no limits of its own.",
+            "You need Node's legacy querystring semantics, where a repeated key gives an array rather than needing getAll().",
+            "Your support target reaches below Chrome {{chrome:api.URLSearchParams}}, Firefox {{firefox:api.URLSearchParams}} or Safari {{safari:api.URLSearchParams}}. The URL constructor arrived earlier than URLSearchParams, so a browser having one is not proof it has the other.",
+        ],
+        snippet: `const params = new URLSearchParams(location.search);
+params.get("page");
+params.getAll("tag");
+new URLSearchParams({ q: "css" }).toString();`,
+    },
+};
+//# sourceMappingURL=url-search-params.js.map

package/dist/rules/url-search-params.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-search-params.js","sourceRoot":"","sources":["../../src/rules/url-search-params.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,eAAe,GAAS;IACnC,EAAE,EAAE,mBAAmB;IACvB,KAAK,EAAE,sBAAsB;IAC7B,QAAQ,EAAE,YAAY;IACtB,QAAQ,EAAE,CAAC,cAAc,EAAE,IAAI,EAAE,gBAAgB,EAAE,WAAW,CAAC;IAC/D,UAAU,EAAE,EAAE;IACd,cAAc,EAAE;QACd,MAAM,EAAE,QAAQ;QAChB,UAAU,EAAE,YAAY;QACxB,IAAI,EAAE,6aAA6a;KACpb;IACD,MAAM,EAAE,yCAAyC;IACjD,KAAK,EAAE;QACL,SAAS,EACP,ybAAyb;QAC3b,OAAO,EAAE;;;;;;;;0BAQa;QACtB,MAAM,EAAE,kEAAkE;KAC3E;IACD,KAAK,EAAE;QACL,IAAI,EAAE,4DAA4D;QAClE,MAAM,EAAE;YACN,4JAA4J;YAC5J,0JAA0J;YAC1J,oJAAoJ;YACpJ,mKAAmK;YACnK,iHAAiH;YACjH,6QAA6Q;SAC9Q;QACD,OAAO,EAAE;;;8CAGiC;KAC3C;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,IAsD7B,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,IA+D7B,CAAC"}

package/dist/rules/view-transitions.js

@@ -1,6 +1,7 @@
 export const viewTransitions = {
     id: "view-transitions",
     title: "Page and state transitions",
+    category: "animation",
     replaces: [
         "next-view-transitions",
         "react-page-transition",
@@ -50,5 +51,13 @@ document.startViewTransition(() => {
   ::view-transition-group(*) { animation: none; }
 }`,
     },
+    guides: [
+        "same-document-transitions",
+        "cross-document-transitions",
+        "faster-spa-view-transitions",
+        "consistent-cross-document-transitions",
+        "directional-navigation-transitions",
+        "group-element-transitions",
+    ],
 };
 //# sourceMappingURL=view-transitions.js.map

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;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"}
+{"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,WAAW;IACrB,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;IACD,MAAM,EAAE;QACN,2BAA2B;QAC3B,4BAA4B;QAC5B,6BAA6B;QAC7B,uCAAuC;QACvC,oCAAoC;QACpC,2BAA2B;KAC5B;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,IA2B1B,CAAC"}

package/dist/rules/web-bluetooth.js

@@ -0,0 +1,26 @@
+export const webBluetooth = {
+    id: "web-bluetooth",
+    title: "Bluetooth device access",
+    category: "device-apis",
+    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,aAAa;IACvB,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-crypto.d.ts

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

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

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

package/dist/rules/web-crypto.js

@@ -0,0 +1,32 @@
+export const webCrypto = {
+    id: "web-crypto",
+    title: "Hashing and encryption",
+    category: "async-data",
+    replaces: ["crypto-js", "js-sha256", "crypto-hash"],
+    featureIds: ["web-cryptography"],
+    native: "crypto.subtle",
+    human: {
+        explainer: "crypto-js ships its own implementations of SHA-256, AES and HMAC as JavaScript, which is both a large download and slower than the same primitives compiled into the browser. crypto.subtle exposes those primitives natively, with key material held as CryptoKey objects the page cannot read out unless you mark them extractable. The API is asynchronous and takes bytes rather than strings, so a call site grows a TextEncoder and an await.",
+        snippet: `async function sha256(text) {
+  const bytes = new TextEncoder().encode(text);
+  const digest = await crypto.subtle.digest("SHA-256", bytes);
+  return [...new Uint8Array(digest)]
+    .map((b) => b.toString(16).padStart(2, "0"))
+    .join("");
+}`,
+        mdnUrl: "https://developer.mozilla.org/en-US/docs/Web/API/SubtleCrypto",
+    },
+    agent: {
+        when: "hashing, signing, or encrypting with SHA-2, HMAC, AES or RSA",
+        unless: [
+            "You need MD5, SHA-1 signing, or another legacy algorithm. crypto.subtle leaves those out deliberately, so a format that requires one keeps its library.",
+            "The call has to be synchronous. Everything on crypto.subtle returns a promise, which changes any function that hashes inside a render pass or a sort comparator.",
+            "The code runs on plain http somewhere other than localhost. crypto.subtle is undefined outside a secure context.",
+            "You interoperate with crypto-js output that uses its own defaults, such as its OpenSSL-style key derivation for AES, where matching the format by hand is the harder job.",
+            "You need password hashing. Neither the library nor crypto.subtle gives you bcrypt, scrypt or Argon2, and PBKDF2 is the only stretching primitive here.",
+        ],
+        snippet: `const bytes = new TextEncoder().encode(text);
+const digest = await crypto.subtle.digest("SHA-256", bytes);`,
+    },
+};
+//# sourceMappingURL=web-crypto.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"web-crypto.js","sourceRoot":"","sources":["../../src/rules/web-crypto.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,WAAW,EAAE,WAAW,EAAE,aAAa,CAAC;IACnD,UAAU,EAAE,CAAC,kBAAkB,CAAC;IAChC,MAAM,EAAE,eAAe;IACvB,KAAK,EAAE;QACL,SAAS,EACP,qbAAqb;QACvb,OAAO,EAAE;;;;;;EAMX;QACE,MAAM,EAAE,+DAA+D;KACxE;IACD,KAAK,EAAE;QACL,IAAI,EAAE,8DAA8D;QACpE,MAAM,EAAE;YACN,yJAAyJ;YACzJ,kKAAkK;YAClK,kHAAkH;YAClH,2KAA2K;YAC3K,wJAAwJ;SACzJ;QACD,OAAO,EAAE;6DACgD;KAC1D;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,IA4BtB,CAAC"}

package/dist/rules/web-share.js

@@ -0,0 +1,28 @@
+export const webShare = {
+    id: "web-share",
+    title: "Sharing to other apps",
+    category: "device-apis",
+    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,aAAa;IACvB,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

@@ -36,6 +36,16 @@ export type ManualBaseline = z.infer<typeof manualBaselineSchema>;
 export declare const ruleSchema: z.ZodObject<{
     id: z.ZodString;
     title: z.ZodString;
+    category: z.ZodEnum<{
+        animation: "animation";
+        "async-data": "async-data";
+        "device-apis": "device-apis";
+        formatting: "formatting";
+        forms: "forms";
+        layout: "layout";
+        scrolling: "scrolling";
+        typography: "typography";
+    }>;
     replaces: z.ZodArray<z.ZodString>;
     featureIds: z.ZodArray<z.ZodString>;
     native: z.ZodString;
@@ -50,6 +60,7 @@ export declare const ruleSchema: z.ZodObject<{
         unless: z.ZodArray<z.ZodString>;
         snippet: z.ZodString;
     }, z.core.$strip>;
+    guides: z.ZodOptional<z.ZodArray<z.ZodString>>;
     manualBaseline: z.ZodOptional<z.ZodObject<{
         status: z.ZodEnum<{
             limited: "limited";
@@ -64,6 +75,16 @@ export type Rule = z.infer<typeof ruleSchema>;
 export declare const catalogSchema: z.ZodArray<z.ZodObject<{
     id: z.ZodString;
     title: z.ZodString;
+    category: z.ZodEnum<{
+        animation: "animation";
+        "async-data": "async-data";
+        "device-apis": "device-apis";
+        formatting: "formatting";
+        forms: "forms";
+        layout: "layout";
+        scrolling: "scrolling";
+        typography: "typography";
+    }>;
     replaces: z.ZodArray<z.ZodString>;
     featureIds: z.ZodArray<z.ZodString>;
     native: z.ZodString;
@@ -78,6 +99,7 @@ export declare const catalogSchema: z.ZodArray<z.ZodObject<{
         unless: z.ZodArray<z.ZodString>;
         snippet: z.ZodString;
     }, z.core.$strip>;
+    guides: z.ZodOptional<z.ZodArray<z.ZodString>>;
     manualBaseline: z.ZodOptional<z.ZodObject<{
         status: z.ZodEnum<{
             limited: "limited";

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;;;;;;;;;;;;;;;;;;;;;;;;;;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"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;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;AAmDlE;;;;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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA+FnB,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"}