@idle-screens/capabilities 0.1.0 → 0.2.0

package/dist/index.d.ts

@@ -10,6 +10,7 @@ interface BackendSupport {
     canvas2d: boolean;
     webgl2: boolean;
     webgpu: boolean;
+    offscreenCanvas: boolean;
 }
 /**
  * A snapshot of device capabilities. `backends` is always probed; EVERYTHING ELSE is

package/dist/index.js

@@ -114,13 +114,14 @@ function detectBackendsSync() {
     // if a DOM exists at all, CSS is available
     canvas2d: probeContext("2d"),
     webgl2: probeContext("webgl2"),
-    webgpu: false
+    webgpu: false,
     // resolved asynchronously by detectCapabilities()
+    offscreenCanvas: hasDoc && typeof HTMLCanvasElement.prototype.transferControlToOffscreen === "function"
   };
 }
 async function detectCapabilities() {
   if (!hasDoc) {
-    return { backends: { css: true, canvas2d: false, webgl2: false, webgpu: false } };
+    return { backends: { css: true, canvas2d: false, webgl2: false, webgpu: false, offscreenCanvas: false } };
   }
   const backends = detectBackendsSync();
   backends.webgpu = await probeWebGpu();

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/tier.ts","../src/detect.ts"],"sourcesContent":["import type {\n  Backend,\n  Capabilities,\n  CapabilityTier,\n  CostTier,\n  SaverEligibility,\n  SaverInfo,\n} from './types';\n\nconst BACKEND_RANK: Record<Backend, number> = { css: 0, canvas2d: 1, webgl2: 2, webgpu: 3 };\nconst COST_RANK: Record<CostTier, number> = { idle: 0, low: 1, medium: 2, high: 3 };\nconst TIER_ORDER: CapabilityTier[] = ['minimal', 'basic', 'standard', 'high'];\n\n/** Does the device provide `min` (or any higher backend, which implies the lower ones)? */\nexport function backendSupported(caps: Capabilities, min: Backend = 'css'): boolean {\n  const need = BACKEND_RANK[min];\n  return (Object.keys(caps.backends) as Backend[]).some(\n    (b) => caps.backends[b] && BACKEND_RANK[b] >= need,\n  );\n}\n\n/** The best backend the device has. */\nfunction topBackend(caps: Capabilities): Backend {\n  let best: Backend = 'css';\n  for (const b of Object.keys(caps.backends) as Backend[]) {\n    if (caps.backends[b] && BACKEND_RANK[b] > BACKEND_RANK[best]) best = b;\n  }\n  return best;\n}\n\nfunction step(tier: CapabilityTier, by: number): CapabilityTier {\n  const i = Math.max(0, Math.min(TIER_ORDER.length - 1, TIER_ORDER.indexOf(tier) + by));\n  return TIER_ORDER[i];\n}\n\n/**\n * Compute a compute-capability tier. The BASE comes from the best available backend\n * (the reliable, cross-browser signal). Optional refinements (save-data, low memory,\n * few cores, a small coarse-pointer screen) can only LOWER it — never raise it, and\n * their ABSENCE never lowers it. This keeps non-Chromium devices from being mis-tiered.\n */\nexport function computeTier(caps: Capabilities): CapabilityTier {\n  const base: CapabilityTier =\n    topBackend(caps) === 'webgpu'\n      ? 'high'\n      : topBackend(caps) === 'webgl2'\n        ? 'standard'\n        : topBackend(caps) === 'canvas2d'\n          ? 'basic'\n          : 'minimal';\n\n  let tier = base;\n  if (caps.saveData === true) tier = step(tier, -1);\n  if (caps.deviceMemoryGb !== undefined && caps.deviceMemoryGb < 4) tier = step(tier, -1);\n  if (caps.hardwareConcurrency !== undefined && caps.hardwareConcurrency <= 2) tier = step(tier, -1);\n  // Small mobile screens (coarse pointer + little area) tend to have weaker GPUs.\n  if (caps.coarsePointer === true && caps.screen && caps.screen.w * caps.screen.h <= 640 * 960) {\n    tier = step(tier, -1);\n  }\n  // Never exceed what the backend can actually do.\n  if (TIER_ORDER.indexOf(tier) > TIER_ORDER.indexOf(base)) tier = base;\n  return tier;\n}\n\n/** Max cost tier a device of this capability tier should run. */\nexport function costBudget(tier: CapabilityTier): CostTier {\n  switch (tier) {\n    case 'high':\n      return 'high';\n    case 'standard':\n      return 'medium';\n    case 'basic':\n      return 'low';\n    case 'minimal':\n    default:\n      return 'idle';\n  }\n}\n\nfunction affordable(cost: CostTier, budget: CostTier): boolean {\n  return COST_RANK[cost] <= COST_RANK[budget];\n}\n\n/**\n * Evaluate one saver against a device:\n *  - blocked: the device lacks the required backend, the cost exceeds the budget, or\n *    reduced-motion is on AND the saver's fallback is 'hide'.\n *  - degraded: reduced-motion is on and the saver has a non-hide fallback (it still\n *    runs, but statically/slowly) — this RESPECTS the manifest's declared a11y intent\n *    rather than blanket-blocking energetic savers.\n *  - ok: runs at full fidelity.\n */\nexport function evaluateSaver(saver: SaverInfo, caps: Capabilities): SaverEligibility {\n  const reasons: string[] = [];\n  let status: SaverEligibility['status'] = 'ok';\n  const block = (r: string): void => {\n    status = 'blocked';\n    reasons.push(r);\n  };\n  const degrade = (r: string): void => {\n    if (status !== 'blocked') status = 'degraded';\n    reasons.push(r);\n  };\n\n  const min = saver.minBackend ?? 'css';\n  if (!backendSupported(caps, min)) block(`needs ${min}, which this device lacks`);\n\n  if (saver.costTier) {\n    const budget = costBudget(computeTier(caps));\n    if (!affordable(saver.costTier, budget)) {\n      block(`cost \"${saver.costTier}\" exceeds the device budget \"${budget}\"`);\n    }\n  }\n\n  if (caps.reducedMotion) {\n    const fallback = saver.reducedMotionFallback;\n    const movesALot = saver.motionIntensity === 'moderate' || saver.motionIntensity === 'energetic';\n    if (fallback === 'hide') {\n      block('reduced-motion: this saver hides');\n    } else if (movesALot) {\n      // moderate/energetic savers run, but in their reduced form — calm savers are\n      // left fully eligible even if they declare a (no-op) fallback.\n      degrade(`reduced-motion: uses \"${fallback ?? 'static'}\" fallback`);\n    }\n  }\n\n  return { id: saver.id, status, reasons };\n}\n\nexport function eligibleSavers(savers: SaverInfo[], caps: Capabilities): SaverEligibility[] {\n  return savers.map((s) => evaluateSaver(s, caps));\n}\n\n/** The savers that are not blocked (ok or degraded). */\nexport function playableSavers(savers: SaverInfo[], caps: Capabilities): SaverInfo[] {\n  return savers.filter((s) => evaluateSaver(s, caps).status !== 'blocked');\n}\n","import type { BackendSupport, Capabilities } from './types';\n\nconst hasDoc = typeof document !== 'undefined';\nconst hasNav = typeof navigator !== 'undefined';\n\nfunction mm(query: string): boolean {\n  return typeof matchMedia === 'function' ? matchMedia(query).matches : false;\n}\n\nfunction probeContext(type: '2d' | 'webgl2'): boolean {\n  if (!hasDoc) return false;\n  try {\n    // A canvas can only ever hold ONE context type, so probe each on a FRESH canvas.\n    const canvas = document.createElement('canvas');\n    return canvas.getContext(type) != null;\n  } catch {\n    return false;\n  }\n}\n\nasync function probeWebGpu(): Promise<boolean> {\n  // `'gpu' in navigator` is a false positive — an adapter can still be null/blocklisted.\n  const gpu = (hasNav ? (navigator as unknown as { gpu?: { requestAdapter?: () => Promise<unknown> } }).gpu : undefined);\n  if (!gpu?.requestAdapter) return false;\n  try {\n    return (await gpu.requestAdapter()) != null;\n  } catch {\n    return false;\n  }\n}\n\nfunction detectBackendsSync(): BackendSupport {\n  return {\n    css: true, // if a DOM exists at all, CSS is available\n    canvas2d: probeContext('2d'),\n    webgl2: probeContext('webgl2'),\n    webgpu: false, // resolved asynchronously by detectCapabilities()\n  };\n}\n\n/**\n * Probe real device capabilities. Async so it can `await` the WebGPU adapter (the only\n * honest webgpu check). SSR-safe: with no DOM it returns a minimal css-only snapshot.\n * Every optional field is left `undefined` when the platform doesn't expose it.\n */\nexport async function detectCapabilities(): Promise<Capabilities> {\n  if (!hasDoc) {\n    return { backends: { css: true, canvas2d: false, webgl2: false, webgpu: false } };\n  }\n  const backends = detectBackendsSync();\n  backends.webgpu = await probeWebGpu();\n\n  const nav = hasNav ? (navigator as unknown as {\n    hardwareConcurrency?: number;\n    deviceMemory?: number;\n    connection?: { saveData?: boolean; effectiveType?: string };\n  }) : undefined;\n\n  const colorScheme = mm('(prefers-color-scheme: dark)')\n    ? 'dark'\n    : mm('(prefers-color-scheme: light)')\n      ? 'light'\n      : 'no-preference';\n\n  return {\n    backends,\n    reducedMotion: mm('(prefers-reduced-motion: reduce)'),\n    dpr: typeof devicePixelRatio === 'number' ? devicePixelRatio : undefined,\n    coarsePointer: mm('(pointer: coarse)'),\n    screen: typeof screen !== 'undefined' ? { w: screen.width, h: screen.height } : undefined,\n    hardwareConcurrency: nav?.hardwareConcurrency,\n    deviceMemoryGb: nav?.deviceMemory,\n    saveData: nav?.connection?.saveData,\n    effectiveType: nav?.connection?.effectiveType,\n    colorScheme,\n  };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/tier.ts","../src/detect.ts"],"sourcesContent":["import type {\n  Backend,\n  Capabilities,\n  CapabilityTier,\n  CostTier,\n  SaverEligibility,\n  SaverInfo,\n} from './types';\n\nconst BACKEND_RANK: Record<Backend, number> = { css: 0, canvas2d: 1, webgl2: 2, webgpu: 3 };\nconst COST_RANK: Record<CostTier, number> = { idle: 0, low: 1, medium: 2, high: 3 };\nconst TIER_ORDER: CapabilityTier[] = ['minimal', 'basic', 'standard', 'high'];\n\n/** Does the device provide `min` (or any higher backend, which implies the lower ones)? */\nexport function backendSupported(caps: Capabilities, min: Backend = 'css'): boolean {\n  const need = BACKEND_RANK[min];\n  return (Object.keys(caps.backends) as Backend[]).some(\n    (b) => caps.backends[b] && BACKEND_RANK[b] >= need,\n  );\n}\n\n/** The best backend the device has. */\nfunction topBackend(caps: Capabilities): Backend {\n  let best: Backend = 'css';\n  for (const b of Object.keys(caps.backends) as Backend[]) {\n    if (caps.backends[b] && BACKEND_RANK[b] > BACKEND_RANK[best]) best = b;\n  }\n  return best;\n}\n\nfunction step(tier: CapabilityTier, by: number): CapabilityTier {\n  const i = Math.max(0, Math.min(TIER_ORDER.length - 1, TIER_ORDER.indexOf(tier) + by));\n  return TIER_ORDER[i];\n}\n\n/**\n * Compute a compute-capability tier. The BASE comes from the best available backend\n * (the reliable, cross-browser signal). Optional refinements (save-data, low memory,\n * few cores, a small coarse-pointer screen) can only LOWER it — never raise it, and\n * their ABSENCE never lowers it. This keeps non-Chromium devices from being mis-tiered.\n */\nexport function computeTier(caps: Capabilities): CapabilityTier {\n  const base: CapabilityTier =\n    topBackend(caps) === 'webgpu'\n      ? 'high'\n      : topBackend(caps) === 'webgl2'\n        ? 'standard'\n        : topBackend(caps) === 'canvas2d'\n          ? 'basic'\n          : 'minimal';\n\n  let tier = base;\n  if (caps.saveData === true) tier = step(tier, -1);\n  if (caps.deviceMemoryGb !== undefined && caps.deviceMemoryGb < 4) tier = step(tier, -1);\n  if (caps.hardwareConcurrency !== undefined && caps.hardwareConcurrency <= 2) tier = step(tier, -1);\n  // Small mobile screens (coarse pointer + little area) tend to have weaker GPUs.\n  if (caps.coarsePointer === true && caps.screen && caps.screen.w * caps.screen.h <= 640 * 960) {\n    tier = step(tier, -1);\n  }\n  // Never exceed what the backend can actually do.\n  if (TIER_ORDER.indexOf(tier) > TIER_ORDER.indexOf(base)) tier = base;\n  return tier;\n}\n\n/** Max cost tier a device of this capability tier should run. */\nexport function costBudget(tier: CapabilityTier): CostTier {\n  switch (tier) {\n    case 'high':\n      return 'high';\n    case 'standard':\n      return 'medium';\n    case 'basic':\n      return 'low';\n    case 'minimal':\n    default:\n      return 'idle';\n  }\n}\n\nfunction affordable(cost: CostTier, budget: CostTier): boolean {\n  return COST_RANK[cost] <= COST_RANK[budget];\n}\n\n/**\n * Evaluate one saver against a device:\n *  - blocked: the device lacks the required backend, the cost exceeds the budget, or\n *    reduced-motion is on AND the saver's fallback is 'hide'.\n *  - degraded: reduced-motion is on and the saver has a non-hide fallback (it still\n *    runs, but statically/slowly) — this RESPECTS the manifest's declared a11y intent\n *    rather than blanket-blocking energetic savers.\n *  - ok: runs at full fidelity.\n */\nexport function evaluateSaver(saver: SaverInfo, caps: Capabilities): SaverEligibility {\n  const reasons: string[] = [];\n  let status: SaverEligibility['status'] = 'ok';\n  const block = (r: string): void => {\n    status = 'blocked';\n    reasons.push(r);\n  };\n  const degrade = (r: string): void => {\n    if (status !== 'blocked') status = 'degraded';\n    reasons.push(r);\n  };\n\n  const min = saver.minBackend ?? 'css';\n  if (!backendSupported(caps, min)) block(`needs ${min}, which this device lacks`);\n\n  if (saver.costTier) {\n    const budget = costBudget(computeTier(caps));\n    if (!affordable(saver.costTier, budget)) {\n      block(`cost \"${saver.costTier}\" exceeds the device budget \"${budget}\"`);\n    }\n  }\n\n  if (caps.reducedMotion) {\n    const fallback = saver.reducedMotionFallback;\n    const movesALot = saver.motionIntensity === 'moderate' || saver.motionIntensity === 'energetic';\n    if (fallback === 'hide') {\n      block('reduced-motion: this saver hides');\n    } else if (movesALot) {\n      // moderate/energetic savers run, but in their reduced form — calm savers are\n      // left fully eligible even if they declare a (no-op) fallback.\n      degrade(`reduced-motion: uses \"${fallback ?? 'static'}\" fallback`);\n    }\n  }\n\n  return { id: saver.id, status, reasons };\n}\n\nexport function eligibleSavers(savers: SaverInfo[], caps: Capabilities): SaverEligibility[] {\n  return savers.map((s) => evaluateSaver(s, caps));\n}\n\n/** The savers that are not blocked (ok or degraded). */\nexport function playableSavers(savers: SaverInfo[], caps: Capabilities): SaverInfo[] {\n  return savers.filter((s) => evaluateSaver(s, caps).status !== 'blocked');\n}\n","import type { BackendSupport, Capabilities } from './types';\n\nconst hasDoc = typeof document !== 'undefined';\nconst hasNav = typeof navigator !== 'undefined';\n\nfunction mm(query: string): boolean {\n  return typeof matchMedia === 'function' ? matchMedia(query).matches : false;\n}\n\nfunction probeContext(type: '2d' | 'webgl2'): boolean {\n  if (!hasDoc) return false;\n  try {\n    // A canvas can only ever hold ONE context type, so probe each on a FRESH canvas.\n    const canvas = document.createElement('canvas');\n    return canvas.getContext(type) != null;\n  } catch {\n    return false;\n  }\n}\n\nasync function probeWebGpu(): Promise<boolean> {\n  // `'gpu' in navigator` is a false positive — an adapter can still be null/blocklisted.\n  const gpu = (hasNav ? (navigator as unknown as { gpu?: { requestAdapter?: () => Promise<unknown> } }).gpu : undefined);\n  if (!gpu?.requestAdapter) return false;\n  try {\n    return (await gpu.requestAdapter()) != null;\n  } catch {\n    return false;\n  }\n}\n\nfunction detectBackendsSync(): BackendSupport {\n  return {\n    css: true, // if a DOM exists at all, CSS is available\n    canvas2d: probeContext('2d'),\n    webgl2: probeContext('webgl2'),\n    webgpu: false, // resolved asynchronously by detectCapabilities()\n    offscreenCanvas: hasDoc && typeof HTMLCanvasElement.prototype.transferControlToOffscreen === 'function',\n  };\n}\n\n/**\n * Probe real device capabilities. Async so it can `await` the WebGPU adapter (the only\n * honest webgpu check). SSR-safe: with no DOM it returns a minimal css-only snapshot.\n * Every optional field is left `undefined` when the platform doesn't expose it.\n */\nexport async function detectCapabilities(): Promise<Capabilities> {\n  if (!hasDoc) {\n    return { backends: { css: true, canvas2d: false, webgl2: false, webgpu: false, offscreenCanvas: false } };\n  }\n  const backends = detectBackendsSync();\n  backends.webgpu = await probeWebGpu();\n\n  const nav = hasNav ? (navigator as unknown as {\n    hardwareConcurrency?: number;\n    deviceMemory?: number;\n    connection?: { saveData?: boolean; effectiveType?: string };\n  }) : undefined;\n\n  const colorScheme = mm('(prefers-color-scheme: dark)')\n    ? 'dark'\n    : mm('(prefers-color-scheme: light)')\n      ? 'light'\n      : 'no-preference';\n\n  return {\n    backends,\n    reducedMotion: mm('(prefers-reduced-motion: reduce)'),\n    dpr: typeof devicePixelRatio === 'number' ? devicePixelRatio : undefined,\n    coarsePointer: mm('(pointer: coarse)'),\n    screen: typeof screen !== 'undefined' ? { w: screen.width, h: screen.height } : undefined,\n    hardwareConcurrency: nav?.hardwareConcurrency,\n    deviceMemoryGb: nav?.deviceMemory,\n    saveData: nav?.connection?.saveData,\n    effectiveType: nav?.connection?.effectiveType,\n    colorScheme,\n  };\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@idle-screens/capabilities",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Device & capability detection + saver eligibility tiering for idle-screens. Pure decide (Node-testable) + a thin browser detector.",
   "license": "MIT",
   "author": "Shawn Partridge",