@hraness/design-kit 0.31.1

package/dist/chunk-mr1vdcjq.js

@@ -0,0 +1,404 @@
+import {
+  platformInstallClassName
+} from "./chunk-h4k7yv6x.js";
+import {
+  detectPlatform,
+  isKnownPlatformId,
+  isPlatformId,
+  matchDetectedPlatform,
+  platformLabel,
+  platformMark
+} from "./chunk-wzvdn8ey.js";
+
+// src/react/platform-install.tsx
+import { useCallback, useEffect, useId, useRef, useState } from "react";
+import { jsx, jsxs, Fragment } from "react/jsx-runtime";
+var copyResetMilliseconds = 2000;
+function assertTargets(platforms, defaultPlatform) {
+  if (platforms.length === 0)
+    throw new RangeError("PlatformInstall needs at least one platform.");
+  const seen = new Set;
+  for (const target of platforms) {
+    if (!isPlatformId(target.id))
+      throw new RangeError(`Platform ids are lowercase slugs; received ${JSON.stringify(target.id)}.`);
+    if (seen.has(target.id))
+      throw new RangeError(`Duplicate platform id: ${target.id}.`);
+    seen.add(target.id);
+    if (target.label !== undefined ? target.label.trim() === "" : !isKnownPlatformId(target.id)) {
+      throw new RangeError(`Platform ${target.id} needs a label.`);
+    }
+    if (target.unavailable === true) {
+      if (target.unavailableNote === undefined || target.unavailableNote === null || target.unavailableNote === "") {
+        throw new RangeError(`Unavailable platform ${target.id} needs an unavailableNote.`);
+      }
+      if (target.command !== undefined && target.command.trim() === "")
+        throw new RangeError(`Platform ${target.id} has a blank command.`);
+    } else {
+      if (typeof target.command !== "string" || target.command.trim() === "")
+        throw new RangeError(`Platform ${target.id} needs a command.`);
+    }
+    for (const alternative of target.alternatives ?? []) {
+      if (alternative.label.trim() === "" || alternative.command.trim() === "") {
+        throw new RangeError(`Platform ${target.id} has an alternative without a label or command.`);
+      }
+    }
+  }
+  if (defaultPlatform !== undefined && !seen.has(defaultPlatform)) {
+    throw new RangeError(`defaultPlatform ${JSON.stringify(defaultPlatform)} is not one of the listed platforms.`);
+  }
+}
+function labelOf(target) {
+  return target.label ?? platformLabel(target.id);
+}
+function selectContents(element) {
+  if (element === null)
+    return;
+  try {
+    const selection = element.ownerDocument.defaultView?.getSelection();
+    if (selection === null || selection === undefined)
+      return;
+    const range = element.ownerDocument.createRange();
+    range.selectNodeContents(element);
+    selection.removeAllRanges();
+    selection.addRange(range);
+  } catch {}
+}
+async function writeClipboard(text, fallback) {
+  try {
+    if (typeof navigator !== "undefined" && navigator.clipboard !== undefined) {
+      await navigator.clipboard.writeText(text);
+      return true;
+    }
+  } catch {}
+  selectContents(fallback);
+  try {
+    return fallback?.ownerDocument.execCommand("copy") === true;
+  } catch {
+    return false;
+  }
+}
+function PlatformMarkSymbols({
+  ids,
+  symbolId
+}) {
+  return /* @__PURE__ */ jsx("svg", {
+    "aria-hidden": "true",
+    className: platformInstallClassName(["markSymbols"]),
+    focusable: "false",
+    xmlns: "http://www.w3.org/2000/svg",
+    children: ids.map((id) => {
+      const mark = platformMark(id);
+      return /* @__PURE__ */ jsx("symbol", {
+        id: symbolId(id),
+        viewBox: mark.viewBox,
+        children: /* @__PURE__ */ jsx("path", {
+          d: mark.path
+        })
+      }, id);
+    })
+  });
+}
+function PlatformMarkUse({
+  platform,
+  symbolId
+}) {
+  return /* @__PURE__ */ jsx("svg", {
+    "aria-hidden": "true",
+    className: platformInstallClassName(["icon"]),
+    "data-platform": platform,
+    fill: "currentColor",
+    focusable: "false",
+    viewBox: platformMark(platform).viewBox,
+    xmlns: "http://www.w3.org/2000/svg",
+    children: /* @__PURE__ */ jsx("use", {
+      href: `#${symbolId}`
+    })
+  });
+}
+function CopyGlyph({
+  copied
+}) {
+  return /* @__PURE__ */ jsx("svg", {
+    "aria-hidden": "true",
+    className: platformInstallClassName(["copyIcon"]),
+    fill: "none",
+    focusable: "false",
+    stroke: "currentColor",
+    strokeLinecap: "round",
+    strokeLinejoin: "round",
+    strokeWidth: 2,
+    viewBox: "0 0 24 24",
+    children: copied ? /* @__PURE__ */ jsx("path", {
+      d: "M5 12.5l4.5 4.5L19 7.5"
+    }) : /* @__PURE__ */ jsxs(Fragment, {
+      children: [
+        /* @__PURE__ */ jsx("rect", {
+          height: "12",
+          rx: "2",
+          width: "12",
+          x: "8",
+          y: "8"
+        }),
+        /* @__PURE__ */ jsx("path", {
+          d: "M16 8V6a2 2 0 0 0-2-2H6a2 2 0 0 0-2 2v8a2 2 0 0 0 2 2h2"
+        })
+      ]
+    })
+  });
+}
+function CommandBlock({
+  caption,
+  command,
+  copyKey,
+  onCopy,
+  status,
+  subject
+}) {
+  const preRef = useRef(null);
+  const state = status?.key === copyKey ? status.ok ? "copied" : "failed" : "idle";
+  return /* @__PURE__ */ jsxs("div", {
+    className: platformInstallClassName(["command"]),
+    "data-copy-state": state,
+    children: [
+      /* @__PURE__ */ jsxs("div", {
+        className: platformInstallClassName(["commandBar", (caption === undefined || caption === "") && "commandBarEmpty"]),
+        children: [
+          /* @__PURE__ */ jsx("span", {
+            className: platformInstallClassName(["shell"]),
+            children: caption
+          }),
+          /* @__PURE__ */ jsxs("button", {
+            className: platformInstallClassName(["copy"]),
+            "data-copy-state": state,
+            onClick: () => onCopy(copyKey, command, subject, preRef.current),
+            type: "button",
+            children: [
+              /* @__PURE__ */ jsx(CopyGlyph, {
+                copied: state === "copied"
+              }),
+              /* @__PURE__ */ jsx("span", {
+                children: state === "copied" ? "Copied" : state === "failed" ? "Select to copy" : "Copy"
+              }),
+              /* @__PURE__ */ jsxs("span", {
+                className: platformInstallClassName(["status"]),
+                children: [
+                  " ",
+                  subject
+                ]
+              })
+            ]
+          })
+        ]
+      }),
+      /* @__PURE__ */ jsx("pre", {
+        "aria-label": subject,
+        className: platformInstallClassName(["pre"]),
+        ref: preRef,
+        tabIndex: 0,
+        children: /* @__PURE__ */ jsx("code", {
+          className: platformInstallClassName(["code"]),
+          children: command
+        })
+      })
+    ]
+  });
+}
+function PlatformInstall({
+  className,
+  defaultPlatform,
+  detect = true,
+  id,
+  label = "Platform",
+  platforms
+}) {
+  assertTargets(platforms, defaultPlatform);
+  const [firstTarget] = platforms;
+  if (firstTarget === undefined)
+    throw new RangeError("PlatformInstall needs at least one platform.");
+  const generatedId = useId();
+  const baseId = id ?? `hraness-platform-install${generatedId.replaceAll(/[^A-Za-z0-9_-]/gu, "")}`;
+  const initial = defaultPlatform ?? firstTarget.id;
+  const [selected, setSelected] = useState(initial);
+  const [source, setSource] = useState("default");
+  const [status, setStatus] = useState(null);
+  const chosen = useRef(false);
+  const tabs = useRef(new Map);
+  const ids = platforms.map((target) => target.id);
+  const idKey = ids.join(`
+`);
+  const symbolId = (platform) => `${baseId}-mark-${platform}`;
+  const current = ids.includes(selected) ? selected : initial;
+  useEffect(() => {
+    if (!detect || chosen.current)
+      return;
+    const match = matchDetectedPlatform(detectPlatform(globalThis.navigator), idKey.split(`
+`));
+    if (match === null)
+      return;
+    setSelected(match);
+    setSource("detected");
+  }, [detect, idKey]);
+  useEffect(() => {
+    if (status === null)
+      return;
+    const timer = setTimeout(() => setStatus(null), copyResetMilliseconds);
+    return () => clearTimeout(timer);
+  }, [status]);
+  const choose = useCallback((next, focus) => {
+    chosen.current = true;
+    setSelected(next);
+    setSource("chosen");
+    if (focus)
+      tabs.current.get(next)?.focus();
+  }, []);
+  const copy = useCallback((key, command, subject, pre) => {
+    writeClipboard(command, pre).then((ok) => setStatus({
+      key,
+      ok,
+      subject
+    }));
+  }, []);
+  const onKeyDown = (event) => {
+    const index = ids.indexOf(current);
+    let next;
+    switch (event.key) {
+      case "ArrowRight":
+        next = (index + 1) % ids.length;
+        break;
+      case "ArrowLeft":
+        next = (index - 1 + ids.length) % ids.length;
+        break;
+      case "Home":
+        next = 0;
+        break;
+      case "End":
+        next = ids.length - 1;
+        break;
+      default:
+        return;
+    }
+    const target = ids[next];
+    if (target === undefined)
+      return;
+    event.preventDefault();
+    choose(target, true);
+  };
+  return /* @__PURE__ */ jsxs("div", {
+    className: platformInstallClassName(["root"], className),
+    "data-hraness-platform-install": "",
+    "data-selected-platform": current,
+    "data-selection-source": source,
+    id,
+    children: [
+      /* @__PURE__ */ jsx(PlatformMarkSymbols, {
+        ids,
+        symbolId
+      }),
+      /* @__PURE__ */ jsx("div", {
+        "aria-label": label,
+        className: platformInstallClassName(["tablist"]),
+        onKeyDown,
+        role: "tablist",
+        children: platforms.map((target) => {
+          const isSelected = target.id === current;
+          return /* @__PURE__ */ jsxs("button", {
+            "aria-controls": `${baseId}-panel-${target.id}`,
+            "aria-selected": isSelected,
+            className: platformInstallClassName(["tab", isSelected && "tabSelected"]),
+            "data-availability": target.unavailable === true ? "unavailable" : "available",
+            "data-platform": target.id,
+            id: `${baseId}-tab-${target.id}`,
+            onClick: () => choose(target.id, false),
+            ref: (element) => {
+              if (element === null)
+                tabs.current.delete(target.id);
+              else
+                tabs.current.set(target.id, element);
+            },
+            role: "tab",
+            tabIndex: isSelected ? 0 : -1,
+            type: "button",
+            children: [
+              /* @__PURE__ */ jsx(PlatformMarkUse, {
+                platform: target.id,
+                symbolId: symbolId(target.id)
+              }),
+              /* @__PURE__ */ jsx("span", {
+                className: platformInstallClassName(["tabLabel"]),
+                children: labelOf(target)
+              })
+            ]
+          }, target.id);
+        })
+      }),
+      platforms.map((target) => {
+        const name = labelOf(target);
+        const alternatives = target.alternatives ?? [];
+        return /* @__PURE__ */ jsx("div", {
+          "aria-labelledby": `${baseId}-tab-${target.id}`,
+          className: platformInstallClassName(["panel"]),
+          "data-availability": target.unavailable === true ? "unavailable" : "available",
+          "data-platform": target.id,
+          hidden: target.id !== current,
+          id: `${baseId}-panel-${target.id}`,
+          role: "tabpanel",
+          children: /* @__PURE__ */ jsxs("div", {
+            className: platformInstallClassName(["panelBody"]),
+            children: [
+              /* @__PURE__ */ jsxs("p", {
+                className: platformInstallClassName(["panelLabel"]),
+                children: [
+                  /* @__PURE__ */ jsx(PlatformMarkUse, {
+                    platform: target.id,
+                    symbolId: symbolId(target.id)
+                  }),
+                  /* @__PURE__ */ jsx("span", {
+                    children: name
+                  })
+                ]
+              }),
+              target.unavailable === true ? /* @__PURE__ */ jsx("div", {
+                className: platformInstallClassName(["unavailable"]),
+                children: target.unavailableNote
+              }) : null,
+              target.command === undefined ? null : /* @__PURE__ */ jsx(CommandBlock, {
+                caption: target.shell,
+                command: target.command,
+                copyKey: `${target.id}:primary`,
+                onCopy: copy,
+                status,
+                subject: `${name} install command`
+              }),
+              alternatives.length === 0 ? null : /* @__PURE__ */ jsx("ul", {
+                "aria-label": `Other ways to install on ${name}`,
+                className: platformInstallClassName(["alternatives"]),
+                children: alternatives.map((alternative, index) => /* @__PURE__ */ jsx("li", {
+                  children: /* @__PURE__ */ jsx(CommandBlock, {
+                    caption: [alternative.label, alternative.shell].filter(Boolean).join(" · "),
+                    command: alternative.command,
+                    copyKey: `${target.id}:${index}`,
+                    onCopy: copy,
+                    status,
+                    subject: `${name} ${alternative.label} command`
+                  })
+                }, `${alternative.label}-${index}`))
+              }),
+              target.note === undefined ? null : /* @__PURE__ */ jsx("div", {
+                className: platformInstallClassName(["note"]),
+                children: target.note
+              })
+            ]
+          })
+        }, target.id);
+      }),
+      /* @__PURE__ */ jsx("p", {
+        "aria-live": "polite",
+        className: platformInstallClassName(["status"]),
+        role: "status",
+        children: status === null ? "" : status.ok ? `Copied the ${status.subject}.` : `Copying failed. The ${status.subject} is selected; copy it with your keyboard.`
+      })
+    ]
+  });
+}
+
+export { PlatformInstall };

package/dist/chunk-wzvdn8ey.js

@@ -0,0 +1,116 @@
+// src/platforms.ts
+var knownPlatformIds = ["macos", "linux", "windows"];
+var platformIdPattern = /^[a-z0-9](?:[a-z0-9-]{0,30}[a-z0-9])?$/u;
+function isPlatformId(value) {
+  return typeof value === "string" && platformIdPattern.test(value);
+}
+function isKnownPlatformId(value) {
+  return typeof value === "string" && knownPlatformIds.includes(value);
+}
+var platformLabels = {
+  linux: "Linux",
+  macos: "macOS",
+  windows: "Windows"
+};
+function platformLabel(id) {
+  return isKnownPlatformId(id) ? platformLabels[id] : id;
+}
+var marks = {
+  macos: {
+    viewBox: "0 0 24 24",
+    path: "M12.152 6.896c-.948 0-2.415-1.078-3.96-1.04-2.04.027-3.91 1.183-4.961 3.014-2.117 3.675-.546 9.103 1.519 12.09 1.013 1.454 2.208 3.09 3.792 3.039 1.52-.065 2.09-.987 3.935-.987 1.831 0 2.35.987 3.96.948 1.637-.026 2.676-1.48 3.676-2.948 1.156-1.688 1.636-3.325 1.662-3.415-.039-.013-3.182-1.221-3.22-4.857-.026-3.04 2.48-4.494 2.597-4.559-1.429-2.09-3.623-2.324-4.39-2.376-2-.156-3.675 1.09-4.61 1.09zM15.53 3.83c.843-1.012 1.4-2.427 1.245-3.83-1.207.052-2.662.805-3.532 1.818-.78.896-1.454 2.338-1.273 3.714 1.338.104 2.715-.688 3.559-1.701"
+  },
+  linux: {
+    viewBox: "0 0 24 24",
+    path: "M12.504 0c-.155 0-.315.008-.48.021-4.226.333-3.105 4.807-3.17 6.298-.076 1.092-.3 1.953-1.05 3.02-.885 1.051-2.127 2.75-2.716 4.521-.278.832-.41 1.684-.287 2.489a.424.424 0 00-.11.135c-.26.268-.45.6-.663.839-.199.199-.485.267-.797.4-.313.136-.658.269-.864.68-.09.189-.136.394-.132.602 0 .199.027.4.055.536.058.399.116.728.04.97-.249.68-.28 1.145-.106 1.484.174.334.535.47.94.601.81.2 1.91.135 2.774.6.926.466 1.866.67 2.616.47.526-.116.97-.464 1.208-.946.587-.003 1.23-.269 2.26-.334.699-.058 1.574.267 2.577.2.025.134.063.198.114.333l.003.003c.391.778 1.113 1.132 1.884 1.071.771-.06 1.592-.536 2.257-1.306.631-.765 1.683-1.084 2.378-1.503.348-.199.629-.469.649-.853.023-.4-.2-.811-.714-1.376v-.097l-.003-.003c-.17-.2-.25-.535-.338-.926-.085-.401-.182-.786-.492-1.046h-.003c-.059-.054-.123-.067-.188-.135a.357.357 0 00-.19-.064c.431-1.278.264-2.55-.173-3.694-.533-1.41-1.465-2.638-2.175-3.483-.796-1.005-1.576-1.957-1.56-3.368.026-2.152.236-6.133-3.544-6.139zm.529 3.405h.013c.213 0 .396.062.584.198.19.135.33.332.438.533.105.259.158.459.166.724 0-.02.006-.04.006-.06v.105a.086.086 0 01-.004-.021l-.004-.024a1.807 1.807 0 01-.15.706.953.953 0 01-.213.335.71.71 0 00-.088-.042c-.104-.045-.198-.064-.284-.133a1.312 1.312 0 00-.22-.066c.05-.06.146-.133.183-.198.053-.128.082-.264.088-.402v-.02a1.21 1.21 0 00-.061-.4c-.045-.134-.101-.2-.183-.333-.084-.066-.167-.132-.267-.132h-.016c-.093 0-.176.03-.262.132a.8.8 0 00-.205.334 1.18 1.18 0 00-.09.4v.019c.002.089.008.179.02.267-.193-.067-.438-.135-.607-.202a1.635 1.635 0 01-.018-.2v-.02a1.772 1.772 0 01.15-.768c.082-.22.232-.406.43-.533a.985.985 0 01.594-.2zm-2.962.059h.036c.142 0 .27.048.399.135.146.129.264.288.344.465.09.199.14.4.153.667v.004c.007.134.006.2-.002.266v.08c-.03.007-.056.018-.083.024-.152.055-.274.135-.393.2.012-.09.013-.18.003-.267v-.015c-.012-.133-.04-.2-.082-.333a.613.613 0 00-.166-.267.248.248 0 00-.183-.064h-.021c-.071.006-.13.04-.186.132a.552.552 0 00-.12.27.944.944 0 00-.023.33v.015c.012.135.037.2.08.334.046.134.098.2.166.268.01.009.02.018.034.024-.07.057-.117.07-.176.136a.304.304 0 01-.131.068 2.62 2.62 0 01-.275-.402 1.772 1.772 0 01-.155-.667 1.759 1.759 0 01.08-.668 1.43 1.43 0 01.283-.535c.128-.133.26-.2.418-.2zm1.37 1.706c.332 0 .733.065 1.216.399.293.2.523.269 1.052.468h.003c.255.136.405.266.478.399v-.131a.571.571 0 01.016.47c-.123.31-.516.643-1.063.842v.002c-.268.135-.501.333-.775.465-.276.135-.588.292-1.012.267a1.139 1.139 0 01-.448-.067 3.566 3.566 0 01-.322-.198c-.195-.135-.363-.332-.612-.465v-.005h-.005c-.4-.246-.616-.512-.686-.71-.07-.268-.005-.47.193-.6.224-.135.38-.271.483-.336.104-.074.143-.102.176-.131h.002v-.003c.169-.202.436-.47.839-.601.139-.036.294-.065.466-.065zm2.8 2.142c.358 1.417 1.196 3.475 1.735 4.473.286.534.855 1.659 1.102 3.024.156-.005.33.018.513.064.646-1.671-.546-3.467-1.089-3.966-.22-.2-.232-.335-.123-.335.59.534 1.365 1.572 1.646 2.757.13.535.16 1.104.021 1.67.067.028.135.06.205.067 1.032.534 1.413.938 1.23 1.537v-.043c-.06-.003-.12 0-.18 0h-.016c.151-.467-.182-.825-1.065-1.224-.915-.4-1.646-.336-1.77.465-.008.043-.013.066-.018.135-.068.023-.139.053-.209.064-.43.268-.662.669-.793 1.187-.13.533-.17 1.156-.205 1.869v.003c-.02.334-.17.838-.319 1.35-1.5 1.072-3.58 1.538-5.348.334a2.645 2.645 0 00-.402-.533 1.45 1.45 0 00-.275-.333c.182 0 .338-.03.465-.067a.615.615 0 00.314-.334c.108-.267 0-.697-.345-1.163-.345-.467-.931-.995-1.788-1.521-.63-.4-.986-.87-1.15-1.396-.165-.534-.143-1.085-.015-1.645.245-1.07.873-2.11 1.274-2.763.107-.065.037.135-.408.974-.396.751-1.14 2.497-.122 3.854a8.123 8.123 0 01.647-2.876c.564-1.278 1.743-3.504 1.836-5.268.048.036.217.135.289.202.218.133.38.333.59.465.21.201.477.335.876.335.039.003.075.006.11.006.412 0 .73-.134.997-.268.29-.134.52-.334.74-.4h.005c.467-.135.835-.402 1.044-.7zm2.185 8.958c.037.6.343 1.245.882 1.377.588.134 1.434-.333 1.791-.765l.211-.01c.315-.007.577.01.847.268l.003.003c.208.199.305.53.391.876.085.4.154.78.409 1.066.486.527.645.906.636 1.14l.003-.007v.018l-.003-.012c-.015.262-.185.396-.498.595-.63.401-1.746.712-2.457 1.57-.618.737-1.37 1.14-2.036 1.191-.664.053-1.237-.2-1.574-.898l-.005-.003c-.21-.4-.12-1.025.056-1.69.176-.668.428-1.344.463-1.897.037-.714.076-1.335.195-1.814.12-.465.308-.797.641-.984l.045-.022zm-10.814.049h.01c.053 0 .105.005.157.014.376.055.706.333 1.023.752l.91 1.664.003.003c.243.533.754 1.064 1.189 1.637.434.598.77 1.131.729 1.57v.006c-.057.744-.48 1.148-1.125 1.294-.645.135-1.52.002-2.395-.464-.968-.536-2.118-.469-2.857-.602-.369-.066-.61-.2-.723-.4-.11-.2-.113-.602.123-1.23v-.004l.002-.003c.117-.334.03-.752-.027-1.118-.055-.401-.083-.71.043-.94.16-.334.396-.4.69-.533.294-.135.64-.202.915-.47h.002v-.002c.256-.268.445-.601.668-.838.19-.201.38-.336.663-.336zm7.159-9.074c-.435.201-.945.535-1.488.535-.542 0-.97-.267-1.28-.466-.154-.134-.28-.268-.373-.335-.164-.134-.144-.333-.074-.333.109.016.129.134.199.2.096.066.215.2.36.333.292.2.68.467 1.167.467.485 0 1.053-.267 1.398-.466.195-.135.445-.334.648-.467.156-.136.149-.267.279-.267.128.016.034.134-.147.332a8.097 8.097 0 01-.69.468zm-1.082-1.583V5.64c-.006-.02.013-.042.029-.05.074-.043.18-.027.26.004.063 0 .16.067.15.135-.006.049-.085.066-.135.066-.055 0-.092-.043-.141-.068-.052-.018-.146-.008-.163-.065zm-.551 0c-.02.058-.113.049-.166.066-.047.025-.086.068-.14.068-.05 0-.13-.02-.136-.068-.01-.066.088-.133.15-.133.08-.031.184-.047.259-.005.019.009.036.03.03.05v.02h.003z"
+  },
+  windows: {
+    viewBox: "0 0 24 24",
+    path: "M1.5 1.5h10v10h-10zM12.5 1.5h10v10h-10zM1.5 12.5h10v10h-10zM12.5 12.5h10v10h-10z"
+  },
+  terminal: {
+    viewBox: "0 0 24 24",
+    path: "M4 3h16a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2zm0 2v14h16V5zm2.3 3.3 1.4-1.4 4.1 4.1-4.1 4.1-1.4-1.4 2.7-2.7zM12 15h6v2h-6z"
+  }
+};
+function platformMark(id) {
+  return isKnownPlatformId(id) ? marks[id] : marks.terminal;
+}
+function detectPlatform(navigatorLike) {
+  if (typeof navigatorLike !== "object" || navigatorLike === null)
+    return null;
+  const record = navigatorLike;
+  let hinted;
+  try {
+    const data = record.userAgentData;
+    if (typeof data === "object" && data !== null) {
+      const platform = data.platform;
+      if (typeof platform === "string")
+        hinted = platform;
+    }
+  } catch {
+    hinted = undefined;
+  }
+  const fromHint = hinted === undefined ? null : classifyHint(hinted);
+  if (fromHint !== null)
+    return fromHint;
+  const userAgent = stringField(record, "userAgent");
+  const fromAgent = userAgent === undefined ? null : classifyUserAgent(userAgent);
+  if (fromAgent !== null)
+    return fromAgent;
+  const legacy = stringField(record, "platform");
+  return legacy === undefined ? null : classifyUserAgent(legacy);
+}
+function stringField(record, key) {
+  try {
+    const value = record[key];
+    return typeof value === "string" ? value : undefined;
+  } catch {
+    return;
+  }
+}
+function classifyHint(platform) {
+  switch (platform.trim().toLowerCase()) {
+    case "macos":
+      return "macos";
+    case "windows":
+      return "windows";
+    case "linux":
+      return "linux";
+    case "chrome os":
+    case "chromeos":
+      return "chromeos";
+    case "android":
+      return "android";
+    case "ios":
+      return "ios";
+    default:
+      return null;
+  }
+}
+function classifyUserAgent(userAgent) {
+  if (/Windows|Win(?:32|64)\b/u.test(userAgent))
+    return "windows";
+  if (/iPhone|iPad|iPod/u.test(userAgent))
+    return "ios";
+  if (/Android/u.test(userAgent))
+    return "android";
+  if (/CrOS/u.test(userAgent))
+    return "chromeos";
+  if (/Mac OS X|Macintosh|MacIntel|\bMac\b/u.test(userAgent))
+    return "macos";
+  if (/Linux|X11/u.test(userAgent))
+    return "linux";
+  return null;
+}
+function matchDetectedPlatform(detected, available) {
+  if (detected === null)
+    return null;
+  if (available.includes(detected))
+    return detected;
+  if (detected === "chromeos" && available.includes("linux"))
+    return "linux";
+  return null;
+}
+
+export { knownPlatformIds, isPlatformId, isKnownPlatformId, platformLabel, platformMark, detectPlatform, matchDetectedPlatform };