@excom/detect-browser 0.1.0

package/.rush/temp/chunked-rush-logs/detect-browser.apply-exports.chunks.jsonl

@@ -0,0 +1 @@
+{"kind":"O","text":"Invoking: cd \"$RUSH_PROJECT_FOLDER\" && node ../heft-rig/scripts/apply-exports.mjs \n"}

package/.rush/temp/chunked-rush-logs/detect-browser.build_docs.chunks.jsonl

@@ -0,0 +1 @@
+{"kind":"O","text":"Invoking: node node_modules/@excom/heft-rig/scripts/build-docs.mjs \n"}

package/.rush/temp/chunked-rush-logs/detect-browser.build_package-metas.chunks.jsonl

@@ -0,0 +1 @@
+{"kind":"O","text":"Invoking: node node_modules/@excom/heft-rig/scripts/build-package-metas.mjs \n"}

package/.rush/temp/operation/apply-exports/all.log

@@ -0,0 +1 @@
+Invoking: cd "$RUSH_PROJECT_FOLDER" && node ../heft-rig/scripts/apply-exports.mjs 

package/.rush/temp/operation/apply-exports/log-chunks.jsonl

@@ -0,0 +1 @@
+{"kind":"O","text":"Invoking: cd \"$RUSH_PROJECT_FOLDER\" && node ../heft-rig/scripts/apply-exports.mjs \n"}

package/.rush/temp/operation/apply-exports/state.json

@@ -0,0 +1,3 @@
+{
+  "nonCachedDurationMs": 35.62659099999996
+}

package/.rush/temp/operation/build_docs/all.log

@@ -0,0 +1 @@
+Invoking: node node_modules/@excom/heft-rig/scripts/build-docs.mjs 

package/.rush/temp/operation/build_docs/log-chunks.jsonl

@@ -0,0 +1 @@
+{"kind":"O","text":"Invoking: node node_modules/@excom/heft-rig/scripts/build-docs.mjs \n"}

package/.rush/temp/operation/build_docs/state.json

@@ -0,0 +1,3 @@
+{
+  "nonCachedDurationMs": 50.80209999999988
+}

package/.rush/temp/operation/build_package-metas/all.log

@@ -0,0 +1 @@
+Invoking: node node_modules/@excom/heft-rig/scripts/build-package-metas.mjs 

package/.rush/temp/operation/build_package-metas/log-chunks.jsonl

@@ -0,0 +1 @@
+{"kind":"O","text":"Invoking: node node_modules/@excom/heft-rig/scripts/build-package-metas.mjs \n"}

package/.rush/temp/operation/build_package-metas/state.json

@@ -0,0 +1,3 @@
+{
+  "nonCachedDurationMs": 100.0922770000002
+}

package/.rush/temp/shrinkwrap-deps.json

@@ -0,0 +1,3 @@
+{
+  "../../packages/detect-browser": "../../packages/detect-browser:YAC8G8l1nkKknuTXH370JI0/DynCPkP81MNQcvbO6fA=:"
+}

package/config/rig.json

@@ -0,0 +1,5 @@
+{
+  "$schema": "https://developer.microsoft.com/json-schemas/rig-package/rig.schema.json",
+  "rigPackageName": "@excom/heft-rig",
+  "rigProfile": "default"
+}

package/detect-browser.ts

@@ -0,0 +1,196 @@
+import { ConstructorType, Neutron } from "@excom/neutron";
+
+export type BrowserInfo = {
+  browserName: string | null;
+  browserVersion: string | null;
+  browserEngine: string | null;
+  browserVendor: string | null;
+  operatingSystem: string | null;
+  operatingPlatform: string | null;
+  deviceType: string | null;
+  isStandalone: boolean | null;
+  languageId: string | null;
+  cookiesEnabled: boolean | null;
+  doNotTrack: string | null;
+  userAgent: string | null;
+  languageIds: string[] | null;
+  hardwareConcurrency: number | null;
+  deviceMemory: number | null;
+};
+
+/**
+ * Zero-JS browser / OS / device metadata provider. Sets attributes once on
+ * connect so plain CSS can target Safari, iOS, standalone (installed PWA)
+ * mode, and more — no app JavaScript required. Values with
+ * no CSS-friendly attribute form (full user agent, language list, hardware
+ * hints) live on the `.provision` property instead.
+ *
+ * @summary CSS-selectable browser, OS, and device metadata.
+ *
+ * @example
+ * <detect-browser></detect-browser>
+ * <!-- html:has(detect-browser[browser-name="safari"]) { ... } -->
+ */
+export const DetectBrowser = Neutron({
+  tag: "detect-browser",
+  props: {
+    /**
+     * @state
+     * Detected browser family.
+     * @values chrome | firefox | safari | edge | opera | internet explorer
+     */
+    browserName: String,
+    /**
+     * @state
+     * Browser version, as reported by the user agent string.
+     */
+    browserVersion: String,
+    /**
+     * @state
+     * Rendering engine.
+     * @values blink | gecko | webkit | trident
+     */
+    browserEngine: String,
+    /**
+     * @state
+     * `navigator.vendor`, lowercased.
+     */
+    browserVendor: String,
+    /**
+     * @state
+     * Detected OS and, where available, version.
+     * @values windows 10+ | windows 8.1 | windows 8 | windows 7 | macos <version> | android | ios | linux
+     */
+    operatingSystem: String,
+    /**
+     * @state
+     * `navigator.userAgentData.platform` (falls back to
+     * `navigator.platform`), lowercased.
+     */
+    operatingPlatform: String,
+    /**
+     * @state
+     * Coarse device class inferred from the user agent string.
+     * @values mobile | desktop
+     */
+    deviceType: String,
+    /**
+     * @state
+     * Present when running in standalone / installed PWA mode.
+     */
+    isStandalone: Boolean,
+    /**
+     * @state
+     * `navigator.language`, lowercased.
+     */
+    languageId: String,
+    /**
+     * @state
+     * Present when `navigator.cookieEnabled` is `true`.
+     */
+    cookiesEnabled: Boolean,
+    /**
+     * @state
+     * `navigator.doNotTrack`, as reported by the browser.
+     */
+    doNotTrack: String,
+    /**
+     * @provision
+     * Every field above, plus values with no CSS-friendly attribute
+     * form: full user agent string, `navigator.languages`, hardware
+     * concurrency, and device memory (GB, where supported).
+     * Not reflected as an attribute.
+     * @type BrowserInfo
+     */
+    provision: Object as unknown as ConstructorType<BrowserInfo>,
+  },
+})
+  .defineMethods({
+    setBrowserInfo: () => {
+      const nav = navigator;
+      const ua = nav.userAgent || "";
+      const platform = nav.userAgentData?.platform || nav.platform || undefined;
+
+      // --- Browser name and version ---
+      let name: string | undefined, version: string | undefined;
+      if (/edg/i.test(ua)) {
+        name = "Edge";
+        version = ua.match(/edg\/([\d\.]+)/i)?.[1];
+      } else if (/chrome|crios/i.test(ua)) {
+        name = "Chrome";
+        version = ua.match(/(?:chrome|crios)\/([\d\.]+)/i)?.[1];
+      } else if (/firefox|fxios/i.test(ua)) {
+        name = "Firefox";
+        version = ua.match(/(?:firefox|fxios)\/([\d\.]+)/i)?.[1];
+      } else if (/safari/i.test(ua) && !/chrome|crios|android/i.test(ua)) {
+        name = "Safari";
+        version = ua.match(/version\/([\d\.]+)/i)?.[1];
+      } else if (/opr|opera/i.test(ua)) {
+        name = "Opera";
+        version = ua.match(/(?:opera|opr)\/([\d\.]+)/i)?.[1];
+      } else if (/msie|trident/i.test(ua)) {
+        name = "Internet Explorer";
+        version = ua.match(/(?:msie |rv:)([\d\.]+)/i)?.[1];
+      }
+
+      // --- Engine detection ---
+      let engine: string | undefined;
+      if (/applewebkit/i.test(ua)) engine = "WebKit";
+      if (/chrome|edg|opr/i.test(ua)) engine = "Blink";
+      if (/gecko\//i.test(ua) && !/webkit/i.test(ua)) engine = "Gecko";
+      if (/trident/i.test(ua)) engine = "Trident";
+
+      // --- OS detection ---
+      let os: string | undefined;
+      if (/windows nt 10/i.test(ua)) os = "Windows 10+";
+      else if (/windows nt 6\.3/i.test(ua)) os = "Windows 8.1";
+      else if (/windows nt 6\.2/i.test(ua)) os = "Windows 8";
+      else if (/windows nt 6\.1/i.test(ua)) os = "Windows 7";
+      else if (/mac os x (\d+[\._]\d+)/i.test(ua))
+        os =
+          "macOS " + ua.match(/mac os x (\d+[\._]\d+)/i)?.[1].replace("_", ".");
+      else if (/android/i.test(ua)) os = "Android";
+      else if (/iphone|ipad|ipod/i.test(ua)) os = "iOS";
+      else if (/linux/i.test(ua)) os = "Linux";
+
+      // --- Device type ---
+      const isMobile = /mobi|android|iphone|ipad|ipod/i.test(ua);
+      const deviceType = isMobile ? "Mobile" : "Desktop";
+      const browserInfo = {
+        browserName: name?.toLowerCase() || null,
+        browserVersion: version?.toLowerCase() || null,
+        browserEngine: engine?.toLowerCase() || null,
+        browserVendor: nav.vendor?.toLowerCase() || null,
+        operatingSystem: os?.toLowerCase() || null,
+        operatingPlatform: platform?.toLowerCase() || null,
+        deviceType: deviceType?.toLowerCase() || null,
+        isStandalone:
+          window.matchMedia("(display-mode: standalone)").matches ||
+          //  ...for safari...
+          nav.standalone ||
+          null,
+        languageId: nav.language?.toLowerCase() || null,
+        cookiesEnabled: nav.cookieEnabled ?? null,
+        doNotTrack: nav.doNotTrack ?? null,
+      };
+      return {
+        ...browserInfo,
+        provision: {
+          ...browserInfo,
+          userAgent: ua || null,
+          languageIds: nav.languages || null,
+          hardwareConcurrency: nav.hardwareConcurrency || null,
+          deviceMemory: nav.deviceMemory ?? null,
+        },
+      };
+    },
+  })
+  .onConnected(
+    // Skip if we already ran this on a previous connection
+    ({ wasMounted }) => {
+      if (wasMounted) return;
+      return {
+        setBrowserInfo: [],
+      };
+    }
+  );

package/index.ts

@@ -0,0 +1,17 @@
+import { DetectBrowser } from "./detect-browser";
+
+DetectBrowser.define();
+
+export { DetectBrowser };
+
+type T_HTMLDetectBrowserElement = typeof DetectBrowser.CustomElement;
+declare global {
+  interface HTMLDetectBrowserElement extends T_HTMLDetectBrowserElement {}
+  interface Window {
+    HTMLDetectBrowserElement: HTMLDetectBrowserElement;
+  }
+  interface HTMLElementTagNameMap {
+    "detect-browser": HTMLDetectBrowserElement;
+  }
+}
+export type { HTMLDetectBrowserElement };

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@excom/detect-browser",
+  "version": "0.1.0",
+  "description": "<detect-browser> custom element",
+  "license": "MIT",
+  "engines": {
+    "node": ">=24.13.0"
+  },
+  "type": "module",
+  "dependencies": {
+    "@excom/neutron": "^0.1.0"
+  },
+  "peerDependencies": {},
+  "devDependencies": {
+    "@excom/heft-rig": "^0.1.0"
+  },
+  "repository": {
+    "url": "excom-dev/nucleus",
+    "directory": "packages/detect-browser"
+  },
+  "homepage": "https://github.com/excom-dev/nucleus/tree/main/packages/detect-browser/support/docs/README.md",
+  "bugs": "https://github.com/excom-dev/nucleus/issues",
+  "keywords": [
+    "detect-browser",
+    "neutron",
+    "custom-elements"
+  ],
+  "excom": {
+    "packageType": "kit-element"
+  },
+  "scripts": {
+    "build": "node node_modules/@excom/heft-rig/scripts/vite-build.mjs",
+    "build:watch": "node node_modules/@excom/heft-rig/scripts/vite-build-watch.mjs",
+    "format": "node node_modules/@excom/heft-rig/scripts/format.mjs",
+    "test": "node node_modules/@excom/heft-rig/scripts/vitest.mjs",
+    "coverage": "node node_modules/@excom/heft-rig/scripts/coverage.mjs",
+    "dev": "node node_modules/@excom/heft-rig/scripts/vite-dev.mjs",
+    "preview": "node node_modules/@excom/heft-rig/scripts/vite-preview.mjs",
+    "build:package-metas": "node node_modules/@excom/heft-rig/scripts/build-package-metas.mjs",
+    "build:docs": "node node_modules/@excom/heft-rig/scripts/build-docs.mjs"
+  }
+}

package/rush-logs/detect-browser.apply-exports.cache.log

@@ -0,0 +1 @@
+Caching has been disabled for this project's "apply-exports" command.

package/rush-logs/detect-browser.apply-exports.log

@@ -0,0 +1 @@
+Invoking: cd "$RUSH_PROJECT_FOLDER" && node ../heft-rig/scripts/apply-exports.mjs 

package/rush-logs/detect-browser.build_docs.cache.log

@@ -0,0 +1 @@
+This project does not define the caching behavior of the "build:docs" command, so caching has been disabled.

package/rush-logs/detect-browser.build_docs.log

@@ -0,0 +1 @@
+Invoking: node node_modules/@excom/heft-rig/scripts/build-docs.mjs 

package/rush-logs/detect-browser.build_package-metas.cache.log

@@ -0,0 +1 @@
+This project does not define the caching behavior of the "build:package-metas" command, so caching has been disabled.

package/rush-logs/detect-browser.build_package-metas.log

@@ -0,0 +1 @@
+Invoking: node node_modules/@excom/heft-rig/scripts/build-package-metas.mjs 

package/support/custom-elements.json

@@ -0,0 +1,327 @@
+{
+  "schemaVersion": "1.0.0",
+  "modules": [
+    {
+      "kind": "javascript-module",
+      "path": "detect-browser.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "name": "DetectBrowser",
+          "customElement": true,
+          "tagName": "detect-browser",
+          "summary": "CSS-selectable browser, OS, and device metadata.",
+          "description": "Zero-JS browser / OS / device metadata provider. Sets attributes once on connect so plain CSS can target Safari, iOS, standalone (installed PWA) mode, and more — no app JavaScript required. Values with no CSS-friendly attribute form (full user agent, language list, hardware hints) live on the `.provision` property instead.",
+          "attributes": [
+            {
+              "name": "browser-name",
+              "type": {
+                "text": "string"
+              },
+              "description": "Detected browser family.",
+              "fieldName": "browserName",
+              "values": [
+                "chrome",
+                "firefox",
+                "safari",
+                "edge",
+                "opera",
+                "internet explorer"
+              ]
+            },
+            {
+              "name": "browser-version",
+              "type": {
+                "text": "string"
+              },
+              "description": "Browser version, as reported by the user agent string.",
+              "fieldName": "browserVersion"
+            },
+            {
+              "name": "browser-engine",
+              "type": {
+                "text": "string"
+              },
+              "description": "Rendering engine.",
+              "fieldName": "browserEngine",
+              "values": [
+                "blink",
+                "gecko",
+                "webkit",
+                "trident"
+              ]
+            },
+            {
+              "name": "browser-vendor",
+              "type": {
+                "text": "string"
+              },
+              "description": "`navigator.vendor`, lowercased.",
+              "fieldName": "browserVendor"
+            },
+            {
+              "name": "operating-system",
+              "type": {
+                "text": "string"
+              },
+              "description": "Detected OS and, where available, version.",
+              "fieldName": "operatingSystem",
+              "values": [
+                "windows 10+",
+                "windows 8.1",
+                "windows 8",
+                "windows 7",
+                "macos <version>",
+                "android",
+                "ios",
+                "linux"
+              ]
+            },
+            {
+              "name": "operating-platform",
+              "type": {
+                "text": "string"
+              },
+              "description": "`navigator.userAgentData.platform` (falls back to `navigator.platform`), lowercased.",
+              "fieldName": "operatingPlatform"
+            },
+            {
+              "name": "device-type",
+              "type": {
+                "text": "string"
+              },
+              "description": "Coarse device class inferred from the user agent string.",
+              "fieldName": "deviceType",
+              "values": [
+                "mobile",
+                "desktop"
+              ]
+            },
+            {
+              "name": "is-standalone",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Present when running in standalone / installed PWA mode.",
+              "fieldName": "isStandalone"
+            },
+            {
+              "name": "language-id",
+              "type": {
+                "text": "string"
+              },
+              "description": "`navigator.language`, lowercased.",
+              "fieldName": "languageId"
+            },
+            {
+              "name": "cookies-enabled",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Present when `navigator.cookieEnabled` is `true`.",
+              "fieldName": "cookiesEnabled"
+            },
+            {
+              "name": "do-not-track",
+              "type": {
+                "text": "string"
+              },
+              "description": "`navigator.doNotTrack`, as reported by the browser.",
+              "fieldName": "doNotTrack"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "browserName",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "public",
+              "readonly": true,
+              "description": "Detected browser family.",
+              "_neutron": {
+                "surface": "state"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "browserVersion",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "public",
+              "readonly": true,
+              "description": "Browser version, as reported by the user agent string.",
+              "_neutron": {
+                "surface": "state"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "browserEngine",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "public",
+              "readonly": true,
+              "description": "Rendering engine.",
+              "_neutron": {
+                "surface": "state"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "browserVendor",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "public",
+              "readonly": true,
+              "description": "`navigator.vendor`, lowercased.",
+              "_neutron": {
+                "surface": "state"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "operatingSystem",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "public",
+              "readonly": true,
+              "description": "Detected OS and, where available, version.",
+              "_neutron": {
+                "surface": "state"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "operatingPlatform",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "public",
+              "readonly": true,
+              "description": "`navigator.userAgentData.platform` (falls back to `navigator.platform`), lowercased.",
+              "_neutron": {
+                "surface": "state"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "deviceType",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "public",
+              "readonly": true,
+              "description": "Coarse device class inferred from the user agent string.",
+              "_neutron": {
+                "surface": "state"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "isStandalone",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "public",
+              "readonly": true,
+              "description": "Present when running in standalone / installed PWA mode.",
+              "_neutron": {
+                "surface": "state"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "languageId",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "public",
+              "readonly": true,
+              "description": "`navigator.language`, lowercased.",
+              "_neutron": {
+                "surface": "state"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "cookiesEnabled",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "public",
+              "readonly": true,
+              "description": "Present when `navigator.cookieEnabled` is `true`.",
+              "_neutron": {
+                "surface": "state"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "doNotTrack",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "public",
+              "readonly": true,
+              "description": "`navigator.doNotTrack`, as reported by the browser.",
+              "_neutron": {
+                "surface": "state"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "provision",
+              "type": {
+                "text": "BrowserInfo",
+                "expanded": "{ browserName: string | null; browserVersion: string | null; browserEngine: string | null; browserVendor: string | null; operatingSystem: string | null; operatingPlatform: string | null; deviceType: string | null; isStandalone: boolean | null; languageId: string | null; cookiesEnabled: boolean | null; doNotTrack: string | null; userAgent: string | null; languageIds: string[] | null; hardwareConcurrency: number | null; deviceMemory: number | null; }"
+              },
+              "privacy": "public",
+              "readonly": false,
+              "description": "Every field above, plus values with no CSS-friendly attribute form: full user agent string, `navigator.languages`, hardware concurrency, and device memory (GB, where supported). Not reflected as an attribute.",
+              "_neutron": {
+                "surface": "option"
+              }
+            }
+          ],
+          "_neutron": {
+            "provisions": [
+              {
+                "name": "provision",
+                "type": {
+                  "text": "BrowserInfo",
+                  "expanded": "{ browserName: string | null; browserVersion: string | null; browserEngine: string | null; browserVendor: string | null; operatingSystem: string | null; operatingPlatform: string | null; deviceType: string | null; isStandalone: boolean | null; languageId: string | null; cookiesEnabled: boolean | null; doNotTrack: string | null; userAgent: string | null; languageIds: string[] | null; hardwareConcurrency: number | null; deviceMemory: number | null; }"
+                },
+                "description": "Every field above, plus values with no CSS-friendly attribute form: full user agent string, `navigator.languages`, hardware concurrency, and device memory (GB, where supported). Not reflected as an attribute.",
+                "fieldName": "provision"
+              }
+            ]
+          }
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "DetectBrowser",
+          "declaration": {
+            "name": "DetectBrowser",
+            "module": "detect-browser.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "detect-browser",
+          "declaration": {
+            "name": "DetectBrowser",
+            "module": "detect-browser.ts"
+          }
+        }
+      ]
+    }
+  ]
+}