@cassida/plugin-hover-fix 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 FSS contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,38 @@
+import { type CassPlugin } from '@cassida/compiler';
+export interface HoverFixOptions {
+    /**
+     * Media query body to wrap matching scopes in. Defaults to
+     * `(hover: hover)`. Override only if you have specific Houdini
+     * needs (e.g. `'(hover: hover) and (pointer: fine)'`).
+     */
+    readonly query?: string;
+    /**
+     * Pseudo selectors that should be gated by the media query. By
+     * default we wrap every `:hover` (and `&:hover`-compound forms);
+     * pass a custom set if you also want to gate `:focus-visible` etc.
+     */
+    readonly selectors?: readonly string[];
+}
+/**
+ * Builds an FSS plugin that wraps any matching pseudo scope inside a
+ * media-query gate. The default targets the iOS Safari "sticky hover"
+ * problem: a hover style remains "stuck" on a touched element until
+ * the user taps elsewhere, because the device reports `:hover` on tap
+ * even though it has no real cursor.
+ *
+ * Example:
+ *   cas().hover(c => c.color('red'))
+ *
+ * Without plugin → `.fss-X:hover { color: red }`
+ *   → on iOS, color stays red after tap until next tap
+ *
+ * With plugin → `@media (hover: hover) { .fss-X:hover { color: red } }`
+ *   → on iOS (which reports `(hover: none)`), the rule never applies
+ *   → on desktop, identical behavior to the unfixed version
+ *
+ * The hash changes when this plugin is enabled (different ScopeBag
+ * tree → different canonical key), so caches are invalidated cleanly
+ * when toggling the plugin.
+ */
+export default function hoverFix(options?: HoverFixOptions): CassPlugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,UAAU,EAEhB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAKD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,OAAO,GAAE,eAAoB,GAAG,UAAU,CAqB1E"}

package/dist/index.js

@@ -0,0 +1,49 @@
+import { mapScopeBag, wrapInMediaScope, } from '@cassida/compiler';
+const DEFAULT_QUERY = '(hover: hover)';
+const DEFAULT_SELECTORS = [':hover'];
+/**
+ * Builds an FSS plugin that wraps any matching pseudo scope inside a
+ * media-query gate. The default targets the iOS Safari "sticky hover"
+ * problem: a hover style remains "stuck" on a touched element until
+ * the user taps elsewhere, because the device reports `:hover` on tap
+ * even though it has no real cursor.
+ *
+ * Example:
+ *   cas().hover(c => c.color('red'))
+ *
+ * Without plugin → `.fss-X:hover { color: red }`
+ *   → on iOS, color stays red after tap until next tap
+ *
+ * With plugin → `@media (hover: hover) { .fss-X:hover { color: red } }`
+ *   → on iOS (which reports `(hover: none)`), the rule never applies
+ *   → on desktop, identical behavior to the unfixed version
+ *
+ * The hash changes when this plugin is enabled (different ScopeBag
+ * tree → different canonical key), so caches are invalidated cleanly
+ * when toggling the plugin.
+ */
+export default function hoverFix(options = {}) {
+    const query = options.query ?? DEFAULT_QUERY;
+    const selectors = new Set(options.selectors ?? DEFAULT_SELECTORS);
+    return {
+        name: '@cassida/plugin-hover-fix',
+        transform(tree) {
+            return mapScopeBag(tree, (node) => {
+                const scope = node.scope;
+                if (scope === null)
+                    return null; // root — never wrap
+                if (scope.kind !== 'pseudo')
+                    return null;
+                if (!selectors.has(scope.selector))
+                    return null;
+                // Don't double-wrap: if this :hover is already inside a
+                // (hover: hover) gate (hand-authored or earlier plugin
+                // pass), skip. We can't see ancestors from here, but the
+                // plugin runs once per compileOps, and recursion is
+                // bottom-up so the same node is visited only once.
+                return wrapInMediaScope(node, query);
+            });
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,gBAAgB,GAGjB,MAAM,mBAAmB,CAAC;AAiB3B,MAAM,aAAa,GAAG,gBAAgB,CAAC;AACvC,MAAM,iBAAiB,GAAsB,CAAC,QAAQ,CAAC,CAAC;AAExD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,UAA2B,EAAE;IAC5D,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,aAAa,CAAC;IAC7C,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,SAAS,IAAI,iBAAiB,CAAC,CAAC;IAElE,OAAO;QACL,IAAI,EAAE,2BAA2B;QACjC,SAAS,CAAC,IAAc;YACtB,OAAO,WAAW,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE;gBAChC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;gBACzB,IAAI,KAAK,KAAK,IAAI;oBAAE,OAAO,IAAI,CAAC,CAAC,oBAAoB;gBACrD,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;oBAAE,OAAO,IAAI,CAAC;gBACzC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC;oBAAE,OAAO,IAAI,CAAC;gBAChD,wDAAwD;gBACxD,uDAAuD;gBACvD,yDAAyD;gBACzD,oDAAoD;gBACpD,mDAAmD;gBACnD,OAAO,gBAAgB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YACvC,CAAC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@cassida/plugin-hover-fix",
+  "version": "0.1.0",
+  "description": "Cassida plugin: wraps :hover scopes in @media (hover: hover) to neutralize iOS Safari's sticky-hover artifact on touch devices.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@cassida/compiler": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.9.0",
+    "typescript": "^5.6.3",
+    "vitest": "^2.1.4"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pishio/cassida.git",
+    "directory": "packages/plugin-hover-fix"
+  },
+  "homepage": "https://github.com/pishio/cassida/tree/main/packages/plugin-hover-fix#readme",
+  "bugs": {
+    "url": "https://github.com/pishio/cassida/issues"
+  },
+  "author": "pishio",
+  "keywords": [
+    "cassida",
+    "css-in-js",
+    "compile-time",
+    "single-class",
+    "react"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}