@jjlmoya/utils-hardware 1.26.0 → 1.28.0

package/src/tool/mobileSensorTest/i18n/tr.ts

@@ -0,0 +1,186 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { MobileSensorTestUI } from '../ui';
+import { bibliography } from '../bibliography';
+
+const slug = 'mobil-sensor-testi';
+const title = 'Mobil Sensör Testi';
+const description = 'Telefonunuzda jiroskop, ivmeölçer, hareket sensörü ve su terazisi testini çevrimiçi olarak çalıştırarak eğim, dönüş, sapma ve sensör kalibrasyon sorunlarını kontrol edin.';
+
+const faqData = [
+  {
+    question: 'Telefon jiroskopumu çevrimiçi olarak nasıl test edebilirim?',
+    answer: 'Testi telefonda açın, Kalibrasyonu Başlat\'a dokunun, istenirse hareket erişimine izin verin, ardından cihazı döndürün ve eğin. Çalışan bir jiroskop ve yön sensörü, alpha, beta ve gamma değerlerini donma veya ani sıçramalar olmadan düzgün bir şekilde güncellemelidir.',
+  },
+  {
+    question: 'İvmeölçeri bir su terazisi ile test edebilir miyim?',
+    answer: 'Evet. Testi başlattıktan sonra telefonu düz bir masaya koyun. Baloncuğun merkeze yakın bir yerde sabitlenmesi ve ivme değerlerinin sabit kalması gerekir. Telefon hareketsizken baloncuk ciddi şekilde kayıyorsa, ivmeölçerin kalibrasyona ihtiyacı olabilir veya kılıf, masa ya da cihaz donanımı müdahale ediyor olabilir.',
+  },
+  {
+    question: 'iPhone neden hareket izni istiyor?',
+    answer: 'iPhone ve iPad\'de Safari, web sitelerinin hareket ve yön sensörlerine erişmeden önce bir dokunuş gerektirir. İzin reddedilirse, siz hareket erişimine izin verene kadar test jiroskop veya ivmeölçer verilerini okuyamaz.',
+  },
+  {
+    question: 'Bu, bozuk bir pusulayı onarabilir veya kalibre edebilir mi?',
+    answer: 'Hiçbir tarayıcı aracı donanımı onaramaz veya sistem pusula kalibrasyonunu zorlayamaz. Bu test belirtileri tanımlamanıza yardımcı olur: donmuş okumalar, gürültülü hareket, sapma, eksik izin veya sensörleri sunmayan bir tarayıcı.',
+  },
+];
+
+const howToData = [
+  { name: 'Testi telefonunuzda açın', text: 'Teşhis etmek istediğiniz iPhone, iPad, Android telefon veya tabletin aynısını kullanın. Masaüstü tarayıcıların genellikle sunacak hareket sensörleri yoktur.' },
+  { name: 'Hareket erişimine izin verin', text: 'Kalibrasyonu Başlat\'a dokunun ve tarayıcınız gösteriyorsa hareket veya yön izin istemini kabul edin.' },
+  { name: 'Eğim ve dönüşü test edin', text: 'Telefonu öne eğin, sola ve sağa yatırın, ardından masanın üzerinde düz bir şekilde döndürün. Alpha, beta, gamma ve ivmedeki yumuşak değişiklikleri izleyin.' },
+  { name: 'Düz bir yüzeyde sapmayı kontrol edin', text: 'Telefonu birkaç saniye hareketsiz bırakın. Sağlıklı bir sensör, sürekli gezinmek, ani sıçramalar yapmak veya donmak yerine sabitlenmelidir.' },
+];
+
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faqData.map((item) => ({
+    '@type': 'Question',
+    name: item.question,
+    acceptedAnswer: { '@type': 'Answer', text: item.answer },
+  })),
+};
+
+const howToSchema: WithContext<HowTo> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: title,
+  description,
+  step: howToData.map((step, i) => ({
+    '@type': 'HowToStep',
+    position: i + 1,
+    name: step.name,
+    text: step.text,
+  })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: title,
+  description,
+  applicationCategory: 'UtilityApplication',
+  operatingSystem: 'All',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'USD' },
+  inLanguage: 'tr',
+};
+
+export const content: ToolLocaleContent<MobileSensorTestUI> = {
+  slug,
+  title,
+  description,
+  faq: faqData,
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  bibliography,
+  seo: [
+    { type: 'title', text: 'Telefonlar için çevrimiçi jiroskop ve ivmeölçer testi', level: 2 },
+    {
+      type: 'paragraph',
+      html: 'Bu mobil sensör testini, ekran döndürme yanlış geldiğinde, oyunlar veya AR uygulamaları kaydığında, bir su terazisi uygulaması hatalı göründüğünde, navigasyon yanlış yönü gösterdiğinde veya telefon eğime doğru tepki vermediğinde kullanın. Test, jiroskop, ivmeölçer, dönüş ve su terazisi davranışını canlı olarak gösterir, böylece tarayıcı izin sorununu gerçek bir sensör veya kalibrasyon sorunundan ayırt edebilirsiniz.',
+    },
+    {
+      type: 'stats',
+      items: [
+        { label: 'Ana arama amacı', value: 'jiroskopu çevrimiçi test et' },
+        { label: 'Ayrıca kontrol eder', value: 'ivmeölçer sapması' },
+        { label: 'En iyi cihaz', value: 'telefon veya tablet' },
+      ],
+    },
+    { type: 'title', text: 'Her sensör okuması size ne söyler', level: 3 },
+    {
+      type: 'table',
+      headers: ['Okuma', 'Kullanım alanı', 'Uyarı işaretleri'],
+      rows: [
+        ['Alpha', 'Dikey eksen etrafındaki dönüşü kontrol etme, pusula benzeri hareket ve yön değişiklikleri için kullanışlıdır.', 'Telefon düz döndürüldüğünde değişmez, büyük miktarlarda sıçrar veya sıfırda donar.'],
+        ['Beta', 'Ekran döndürme, oyunlar, kamera seviyeleme ve AR kontrolleri için ön-arka eğimi kontrol etme.', 'Yanlış yönde hareket eder, bir değerde takılı kalır veya telefon hareketsizken kaymaya devam eder.'],
+        ['Gamma', 'Yatay döndürme, yarış oyunları, su terazisi uygulamaları ve sabitleyiciler için sol-sağ yatışı kontrol etme.', 'Bir taraf farklı tepki verir, değerler gürültülüdür veya baloncuk düz bir masada asla merkeze dönmez.'],
+        ['İvme X/Y/Z', 'İvmeölçer tepkisini, sarsıntı algılamayı, yerçekimi yönünü ve hareket kararlılığını kontrol etme.', 'Hareketsizken büyük sıçramalar, harekete tepki yok veya kılıf çıkarıldıktan sonra dengesiz okumalar.'],
+      ],
+    },
+    {
+      type: 'diagnostic',
+      variant: 'warning',
+      title: 'Bu testin teşhis etmeye yardımcı olduğu belirtiler',
+      html: '<p>Canlı değerleri kullanarak çalışmayan otomatik döndürme, gecikmeli hissedilen jiroskop, ivmeölçer sapması, pusula kalibrasyon uyarıları, kayan AR takibi, kamera seviye hataları, bir tarafa çeken hareket kontrolleri veya yalnızca yerel uygulamalarda hareket bildiren ancak tarayıcıda bildirmeyen bir telefonu araştırın.</p>',
+    },
+    { type: 'title', text: 'Jiroskop vs ivmeölçer vs pusula', level: 3 },
+    {
+      type: 'comparative',
+      items: [
+        { title: 'Jiroskop', description: 'Dönüş hızını ölçer. AR, oyunlar, kamera sabitleme, hareket kontrolleri ve yumuşak yön değişiklikleri için önemlidir.' },
+        { title: 'İvmeölçer', description: 'İvmeyi ve yerçekimi yönünü ölçer. Eğim, sarsıntı algılama, adım algılama ve dijital su terazisi davranışını sağlar.' },
+        { title: 'Pusula / manyetometre', description: 'Yönü tahmin etmeye yardımcı olur, ancak mıknatıslar, metal nesneler, araç tutucuları, kılıflar, hoparlörler, dizüstü bilgisayarlar ve yakındaki elektronik cihazlar tarafından bozulabilir.' },
+      ],
+    },
+    { type: 'title', text: 'Sensör kalibrasyonu nasıl düzgün şekilde test edilir', level: 3 },
+    {
+      type: 'list',
+      items: [
+        'Test etmeden önce manyetik kılıfları, MagSafe cüzdanlarını, metal tutucuları, kontrolcü klipslerini ve aksesuarları çıkarın.',
+        'Telefonu sağlam, düz bir masaya koyun ve sapmayı değerlendirmeden önce birkaç saniye bekleyin.',
+        'Telefonu hemen sallamak yerine her eksende yavaşça döndürün.',
+        'Tarayıcı veri göstermiyorsa Safari veya Chrome\'u yerel bir sensör veya pusula uygulamasıyla karşılaştırın.',
+        'Okumalar birden fazla uygulamada donmuşsa cihazı yeniden başlatın ve testi tekrarlayın.',
+      ],
+    },
+    {
+      type: 'tip',
+      title: 'iPhone ve Android izin notu',
+      html: 'iPhone ve iPad\'de Safari, bir dokunuştan sonra hareket ve yön izni isteyebilir. Android\'de Chrome genellikle hareket sensörlerini daha doğrudan sunar, ancak gizlilik ayarları, tarayıcı bayrakları, pil tasarruf modları ve gömülü web görünümleri yine de sensör verilerini engelleyebilir veya azaltabilir.',
+    },
+    {
+      type: 'table',
+      headers: ['Sorun', 'Olası neden', 'Sonraki adım'],
+      rows: [
+        ['Hiçbir değer değişmiyor', 'İzin reddedildi, desteklenmeyen tarayıcı, masaüstü cihaz veya kısıtlı web görünümü.', 'Telefonun kendisinde açın, Safari veya Chrome kullanın, hareket erişimine izin verin ve sayfayı yeniden yükleyin.'],
+        ['Baloncuk masada kayıyor', 'Kalibrasyon sorunu, düz olmayan yüzey, kılıf müdahalesi veya ivmeölçer gürültüsü.', 'Kılıfı çıkarın, bilinen düz bir yüzey kullanın, yeniden başlatın ve yerel bir su terazisi uygulamasıyla karşılaştırın.'],
+        ['Pusula yönü yanlış', 'Manyetik müdahale veya sistem pusula kalibrasyonu.', 'Metal/elektronikten uzaklaşın ve işletim sisteminin pusula kalibrasyon akışını kullanın.'],
+        ['Değerler sıçrıyor veya ani yükseliyor', 'Sensör gürültüsü, hasarlı donanım, agresif tarayıcı kısıtlaması veya ani fiziksel hareket.', 'Hareketsizken test edin, ağır uygulamaları kapatın ve başka bir tarayıcı veya yerel uygulama ile karşılaştırın.'],
+      ],
+    },
+    {
+      type: 'summary',
+      title: 'Bu test ne işe yarar',
+      items: [
+        'Uygulama yüklemeden bir telefon jiroskopunu çevrimiçi test etme.',
+        'Canlı bir su terazisi ile ivmeölçer sapmasını kontrol etme.',
+        'Hareket kontrollerinin donanım, kalibrasyon, izin veya tarayıcı desteği nedeniyle başarısız olup olmadığını bulma.',
+        'Telefonu AR, oyunlar, kamera seviyeleme, navigasyon veya ekran döndürme sorun giderme için hazırlama.',
+      ],
+    },
+  ],
+  ui: {
+    startButton: 'Kalibrasyonu Başlat',
+    permissionHint: 'Hareket sensörlerinin kilidini açmak için bir kez dokunun',
+    privacyBadge: 'Yerel sensör verisi',
+    privacyCopy: 'Yön ve hareket okumaları bu tarayıcı oturumu içinde kalır.',
+    orientationPanel: 'Yön',
+    motionPanel: 'Hareket',
+    bubblePanel: 'Dijital su terazisi',
+    statusReady: 'Sensör izni için hazır',
+    statusWaiting: 'Tarayıcı izni bekleniyor',
+    statusDenied: 'Sensör erişimi reddedildi veya kullanılamıyor',
+    statusUnsupported: 'Hareket sensörleri bu tarayıcı tarafından sunulmuyor',
+    statusActive: 'Canlı sensör akışı aktif',
+    steadyLabel: 'Sabit',
+    movingLabel: 'Hareketli',
+    shakingLabel: 'Sallanıyor',
+    alphaLabel: 'Alpha',
+    betaLabel: 'Beta',
+    gammaLabel: 'Gamma',
+    accelXLabel: 'X',
+    accelYLabel: 'Y',
+    accelZLabel: 'Z',
+    rotationAlphaLabel: 'Rot A',
+    rotationBetaLabel: 'Rot B',
+    rotationGammaLabel: 'Rot G',
+    levelOffsetLabel: 'Seviye sapması',
+    motionMagnitudeLabel: 'Hareket büyüklüğü',
+    cubeLabel: '3D cihaz yön küpü',
+    bubbleLabel: 'Su terazisi göstergesi',
+    calibrationLabel: 'Canlı derece',
+  },
+};

package/src/tool/mobileSensorTest/i18n/zh.ts

@@ -0,0 +1,186 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { MobileSensorTestUI } from '../ui';
+import { bibliography } from '../bibliography';
+
+const slug = 'mobile-sensor-test';
+const title = '手机传感器测试';
+const description = '在手机上运行陀螺仪、加速度计、运动传感器和水平仪在线测试，检查倾斜、旋转、漂移和传感器校准问题。';
+
+const faqData = [
+  {
+    question: '如何在线测试手机陀螺仪？',
+    answer: '在手机上打开测试，点击开始校准，如果出现提示则允许运动访问，然后旋转和倾斜设备。正常工作的陀螺仪和方向传感器应平滑更新 alpha、beta 和 gamma，不会冻结或剧烈跳动。',
+  },
+  {
+    question: '可以用水平仪测试加速度计吗？',
+    answer: '可以。开始测试后，将手机放在平坦的桌子上。气泡应稳定在中心附近，加速度值应保持稳定。如果手机静止时气泡严重漂移，加速度计可能需要校准，或者保护壳、桌子或设备硬件可能正在产生干扰。',
+  },
+  {
+    question: '为什么 iPhone 会要求运动权限？',
+    answer: 'iPhone 和 iPad 上的 Safari 需要用户在点击后才能让网站访问运动和方向传感器。如果权限被拒绝，测试将无法读取陀螺仪或加速度计数据，直到你允许运动访问。',
+  },
+  {
+    question: '这能修复或校准损坏的指南针吗？',
+    answer: '没有任何浏览器工具可以修复硬件或强制进行系统指南针校准。此测试可帮助你识别症状：读数卡住、运动嘈杂、漂移、权限缺失或浏览器不暴露传感器。',
+  },
+];
+
+const howToData = [
+  { name: '在手机上打开测试', text: '使用你想要诊断的同一部 iPhone、iPad、安卓手机或平板电脑。桌面浏览器通常没有运动传感器可供暴露。' },
+  { name: '允许运动访问', text: '点击开始校准，如果浏览器显示运动或方向权限提示，请接受。' },
+  { name: '测试倾斜和旋转', text: '将手机向前倾斜，左右滚动，然后在桌子上平放旋转。观察 alpha、beta、gamma 和加速度的平滑变化。' },
+  { name: '在平坦表面检查漂移', text: '让手机静置几秒钟。健康的传感器应该稳定下来，而不是不断漂移、出现尖峰或冻结。' },
+];
+
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faqData.map((item) => ({
+    '@type': 'Question',
+    name: item.question,
+    acceptedAnswer: { '@type': 'Answer', text: item.answer },
+  })),
+};
+
+const howToSchema: WithContext<HowTo> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: title,
+  description,
+  step: howToData.map((step, i) => ({
+    '@type': 'HowToStep',
+    position: i + 1,
+    name: step.name,
+    text: step.text,
+  })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: title,
+  description,
+  applicationCategory: 'UtilityApplication',
+  operatingSystem: 'All',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'USD' },
+  inLanguage: 'zh',
+};
+
+export const content: ToolLocaleContent<MobileSensorTestUI> = {
+  slug,
+  title,
+  description,
+  faq: faqData,
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  bibliography,
+  seo: [
+    { type: 'title', text: '手机在线陀螺仪和加速度计测试', level: 2 },
+    {
+      type: 'paragraph',
+      html: '当屏幕旋转感觉不对、游戏或 AR 应用出现漂移、水平仪应用看起来不准确、导航指向错误方向或手机对倾斜反应不正确时，使用此手机传感器测试。测试实时显示陀螺仪、加速度计、旋转和水平仪的行为，帮助你区分浏览器权限问题和真正的传感器或校准问题。',
+    },
+    {
+      type: 'stats',
+      items: [
+        { label: '主要搜索意图', value: '在线测试陀螺仪' },
+        { label: '同时检查', value: '加速度计漂移' },
+        { label: '最佳设备', value: '手机或平板电脑' },
+      ],
+    },
+    { type: 'title', text: '每个传感器读数告诉你什么', level: 3 },
+    {
+      type: 'table',
+      headers: ['读数', '用途', '警告信号'],
+      rows: [
+        ['Alpha', '检查绕垂直轴的旋转，用于类似指南针的运动和方向变化。', '手机平放旋转时不变化、大幅跳变或卡在零值。'],
+        ['Beta', '检查前后倾斜，用于屏幕旋转、游戏、相机水平和 AR 控制。', '方向错误、卡在一个值上或手机静止时持续漂移。'],
+        ['Gamma', '检查左右翻滚，用于横屏旋转、赛车游戏、水平仪应用和稳定器。', '一侧反应不同、数值嘈杂或气泡在平坦桌子上永远不归中。'],
+        ['加速度 X/Y/Z', '检查加速度计响应、震动检测、重力方向和运动稳定性。', '静止时出现大幅尖峰、对运动无响应或取下保护壳后读数不稳定。'],
+      ],
+    },
+    {
+      type: 'diagnostic',
+      variant: 'warning',
+      title: '此测试可帮助诊断的症状',
+      html: '<p>使用实时数值调查自动旋转不工作、陀螺仪感觉延迟、加速度计漂移、指南针校准警告、AR 跟踪偏移、相机水平错误、运动控制偏向一侧或手机仅在原生应用中报告运动但在浏览器中不报告等问题。</p>',
+    },
+    { type: 'title', text: '陀螺仪 vs 加速度计 vs 指南针', level: 3 },
+    {
+      type: 'comparative',
+      items: [
+        { title: '陀螺仪', description: '测量旋转速度。对 AR、游戏、相机稳定、运动控制和平滑方向变化至关重要。' },
+        { title: '加速度计', description: '测量加速度和重力方向。支持倾斜、震动检测、步数检测和数字水平仪行为。' },
+        { title: '指南针 / 磁力计', description: '帮助估计方向，但可能被磁铁、金属物体、车载支架、保护壳、扬声器、笔记本电脑和附近电子设备干扰。' },
+      ],
+    },
+    { type: 'title', text: '如何正确测试传感器校准', level: 3 },
+    {
+      type: 'list',
+      items: [
+        '测试前取下磁性保护壳、MagSafe 钱包、金属支架、手柄夹和其他配件。',
+        '将手机放在稳固的平坦桌子上，等待几秒钟后再判断漂移。',
+        '沿每个轴缓慢旋转手机，而不是立即摇晃。',
+        '如果浏览器不显示数据，将 Safari 或 Chrome 与原生传感器或指南针应用进行比较。',
+        '如果读数在多个应用中冻结，请重启设备并重复测试。',
+      ],
+    },
+    {
+      type: 'tip',
+      title: 'iPhone 和 Android 权限说明',
+      html: '在 iPhone 和 iPad 上，Safari 可能在点击后请求运动和方向权限。在 Android 上，Chrome 通常更直接地暴露运动传感器，但隐私设置、浏览器标志、省电模式和嵌入式 WebView 仍可能阻止或减少传感器数据。',
+    },
+    {
+      type: 'table',
+      headers: ['问题', '可能原因', '下一步'],
+      rows: [
+        ['没有任何值变化', '权限被拒绝、浏览器不受支持、桌面设备或受限 WebView。', '在手机上打开，使用 Safari 或 Chrome，允许运动访问并重新加载页面。'],
+        ['气泡在桌子上漂移', '校准问题、表面不平整、保护壳干扰或加速度计噪声。', '取下保护壳，使用已知的平坦表面，重启并与原生水平仪应用比较。'],
+        ['指南针方向错误', '磁干扰或系统指南针校准。', '远离金属和电子设备，使用操作系统的指南针校准流程。'],
+        ['数值跳动或出现尖峰', '传感器噪声、硬件损坏、浏览器激进限制或突然的物理运动。', '在静止状态下测试，关闭重度应用，并与另一个浏览器或原生应用比较。'],
+      ],
+    },
+    {
+      type: 'summary',
+      title: '此测试的用途',
+      items: [
+        '无需安装应用即可在线测试手机陀螺仪。',
+        '使用实时水平仪检查加速度计漂移。',
+        '查明运动控制是否因硬件、校准、权限或浏览器支持而失败。',
+        '为 AR、游戏、相机水平校正、导航或屏幕旋转故障排除准备手机。',
+      ],
+    },
+  ],
+  ui: {
+    startButton: '开始校准',
+    permissionHint: '点击一次以解锁运动传感器',
+    privacyBadge: '本地传感器数据',
+    privacyCopy: '方向和运动读数保留在此浏览器会话中。',
+    orientationPanel: '方向',
+    motionPanel: '运动',
+    bubblePanel: '数字水平仪',
+    statusReady: '准备获取传感器权限',
+    statusWaiting: '等待浏览器权限',
+    statusDenied: '传感器访问被拒绝或不可用',
+    statusUnsupported: '此浏览器未暴露运动传感器',
+    statusActive: '实时传感器流已激活',
+    steadyLabel: '稳定',
+    movingLabel: '移动中',
+    shakingLabel: '摇晃中',
+    alphaLabel: 'Alpha',
+    betaLabel: 'Beta',
+    gammaLabel: 'Gamma',
+    accelXLabel: 'X',
+    accelYLabel: 'Y',
+    accelZLabel: 'Z',
+    rotationAlphaLabel: 'Rot A',
+    rotationBetaLabel: 'Rot B',
+    rotationGammaLabel: 'Rot G',
+    levelOffsetLabel: '水平偏移',
+    motionMagnitudeLabel: '运动幅度',
+    cubeLabel: '3D 设备方向立方体',
+    bubbleLabel: '水平仪指示器',
+    calibrationLabel: '实时角度',
+  },
+};

package/src/tool/mobileSensorTest/index.ts

@@ -0,0 +1,11 @@
+import { mobileSensorTest } from './entry';
+import type { ToolDefinition } from '../../types';
+
+export * from './entry';
+
+export const MOBILE_SENSOR_TEST_TOOL: ToolDefinition = {
+  entry: mobileSensorTest,
+  Component: () => import('./component.astro'),
+  SEOComponent: () => import('./seo.astro'),
+  BibliographyComponent: () => import('./bibliography.astro'),
+};

package/src/tool/mobileSensorTest/logic.ts

@@ -0,0 +1,39 @@
+export interface MobileSensorSnapshot {
+  alpha: number;
+  beta: number;
+  gamma: number;
+  accelerationX: number;
+  accelerationY: number;
+  accelerationZ: number;
+  rotationAlpha: number;
+  rotationBeta: number;
+  rotationGamma: number;
+}
+
+export interface MobileSensorAssessment {
+  levelOffset: number;
+  motionMagnitude: number;
+  stability: 'steady' | 'moving' | 'shaking';
+}
+
+export function clamp(value: number, min: number, max: number): number {
+  return Math.min(max, Math.max(min, value));
+}
+
+export function safeNumber(value: number | null | undefined): number {
+  return Number.isFinite(value) ? Number(value) : 0;
+}
+
+export function assessMobileSensors(snapshot: MobileSensorSnapshot): MobileSensorAssessment {
+  const levelOffset = Math.hypot(snapshot.beta, snapshot.gamma);
+  const motionMagnitude = Math.hypot(snapshot.accelerationX, snapshot.accelerationY, snapshot.accelerationZ);
+  let stability: MobileSensorAssessment['stability'] = 'steady';
+
+  if (motionMagnitude > 18) {
+    stability = 'shaking';
+  } else if (motionMagnitude > 3 || levelOffset > 12) {
+    stability = 'moving';
+  }
+
+  return { levelOffset, motionMagnitude, stability };
+}