@aelionsdk/capability 0.1.0-beta.1 → 1.1.0-rc.1

package/README.md

@@ -1,7 +1,28 @@
-# @aelionsdk/capability
+# `@aelionsdk/capability`
 
-Browser media capability probing for AelionSDK
+Browser media, graphics, storage and execution capability probing for
+AelionSDK.
 
-Install with `npm install @aelionsdk/capability@next`.
+## Install
 
-Version 0.1.0-beta.1 is a prerelease and its API may change before the first stable release. This package is part of [AelionSDK](https://github.com/FoyonaCZY/AelionSDK); see the repository README for supported browsers, examples and deployment requirements.
+```bash
+npm install @aelionsdk/capability@next
+```
+
+`next` currently resolves to `1.1.0-rc.1`. Product applications should normally
+use the capability APIs exposed by `@aelionsdk/sdk`; this package is for custom
+preflight screens and execution hosts.
+
+## Public surface
+
+- browser capability probes;
+- capability reports and typed results;
+- fail-closed gates for required features and export profiles.
+
+A declared browser API is not proof that a codec configuration works. Run the
+relevant gate with the actual dimensions, frame rate, sample rate and channel
+count before starting a job.
+
+See the [capability preflight guide](https://foyonaczy.github.io/AelionSDK/production/capability-preflight/)
+and [API reference](https://foyonaczy.github.io/AelionSDK/api/aelionsdk/capability/overview/).
+Licensed under MIT.

package/dist/fallback.d.ts

@@ -0,0 +1,62 @@
+import type { Diagnostic } from '@aelionsdk/core';
+/** Whether the codec operation is a decode or an encode. */
+export type CodecOperation = 'decode' | 'encode';
+/** Whether the codec path is video or audio. */
+export type CodecClass = 'video' | 'audio';
+/** The codec execution the SDK is being asked to perform. */
+export interface CodecIdentity {
+    readonly class: CodecClass;
+    readonly operation: CodecOperation;
+    /** WebCodecs codec string, e.g. `avc1.64001f` or `mp4a.40.2`. */
+    readonly codec: string;
+}
+/**
+ * Contract for a software codec fallback backend (e.g. a WASM decoder).
+ *
+ * The engine negotiates through this interface but ships no backend in 1.1:
+ * an application registers one after the codec strategy is chosen. The
+ * interface intentionally mirrors the WebCodecs lifecycle so a future WASM
+ * adapter can implement it without reshaping the negotiation path.
+ */
+export interface CodecFallbackProvider {
+    /** Stable provider id, e.g. `wasm-h264`. */
+    readonly id: string;
+    /** True when the backend is loaded and ready to accept work. */
+    readonly ready: boolean;
+    /** Whether this provider can execute the requested codec path. */
+    supports(identity: CodecIdentity): boolean;
+}
+/** Negotiated execution path for a single codec operation. */
+export type CodecExecutionPath = {
+    readonly path: 'hardware';
+} | {
+    readonly path: 'fallback';
+    readonly providerId: string;
+} | {
+    readonly path: 'unavailable';
+};
+/**
+ * Negotiated execution path for a single codec operation plus any diagnostics
+ * the negotiation produced (for example a `CAPABILITY_CODEC_FALLBACK_USED`
+ * warning or a `CAPABILITY_CODEC_NO_BACKEND` error).
+ */
+export type CodecExecutionDecision = CodecExecutionPath & {
+    readonly diagnostics: readonly Diagnostic[];
+};
+/**
+ * Negotiate how to execute a codec operation: hardware when the platform
+ * reports it, otherwise the first ready provider that supports the identity,
+ * otherwise fail closed with a diagnostic.
+ */
+export declare function selectCodecExecution(identity: CodecIdentity, hardwareSupported: boolean, providers: readonly CodecFallbackProvider[]): CodecExecutionDecision;
+/** Bounded registry of software codec fallback providers. */
+export declare class CodecFallbackRegistry {
+    #private;
+    register(provider: CodecFallbackProvider): void;
+    unregister(id: string): void;
+    clear(): void;
+    providers(): readonly CodecFallbackProvider[];
+}
+/** The default process-wide registry used when no application instance is passed. */
+export declare const codecFallbackRegistry: CodecFallbackRegistry;
+//# sourceMappingURL=fallback.d.ts.map

package/dist/fallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallback.d.ts","sourceRoot":"","sources":["../src/fallback.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,4DAA4D;AAC5D,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,CAAC;AACjD,gDAAgD;AAChD,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,OAAO,CAAC;AAE3C,6DAA6D;AAC7D,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IACnC,iEAAiE;IACjE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,qBAAqB;IACpC,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,kEAAkE;IAClE,QAAQ,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC;CAC5C;AAED,8DAA8D;AAC9D,MAAM,MAAM,kBAAkB,GAC1B;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;CAAE,GAC7B;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAC1D;IAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAA;CAAE,CAAC;AAErC;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG,kBAAkB,GAAG;IACxD,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;CAC7C,CAAC;AAWF;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,aAAa,EACvB,iBAAiB,EAAE,OAAO,EAC1B,SAAS,EAAE,SAAS,qBAAqB,EAAE,GAC1C,sBAAsB,CA4BxB;AAED,6DAA6D;AAC7D,qBAAa,qBAAqB;;IAGzB,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,GAAG,IAAI;IAO/C,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAK5B,KAAK,IAAI,IAAI;IAIb,SAAS,IAAI,SAAS,qBAAqB,EAAE;CAGrD;AAED,qFAAqF;AACrF,eAAO,MAAM,qBAAqB,uBAA8B,CAAC"}

package/dist/fallback.js

@@ -0,0 +1,57 @@
+function decisionDiagnostic(code, message, recoverable) {
+    return {
+        code,
+        severity: recoverable ? 'warning' : 'error',
+        message,
+        recoverable,
+    };
+}
+/**
+ * Negotiate how to execute a codec operation: hardware when the platform
+ * reports it, otherwise the first ready provider that supports the identity,
+ * otherwise fail closed with a diagnostic.
+ */
+export function selectCodecExecution(identity, hardwareSupported, providers) {
+    if (hardwareSupported) {
+        return { path: 'hardware', diagnostics: [] };
+    }
+    const provider = providers.find(candidate => candidate.ready && candidate.supports(identity));
+    if (provider !== undefined) {
+        return {
+            path: 'fallback',
+            providerId: provider.id,
+            diagnostics: [
+                decisionDiagnostic('CAPABILITY_CODEC_FALLBACK_USED', `${identity.class} ${identity.operation} for ${identity.codec} runs through the ${provider.id} software fallback`, true),
+            ],
+        };
+    }
+    return {
+        path: 'unavailable',
+        diagnostics: [
+            decisionDiagnostic('CAPABILITY_CODEC_NO_BACKEND', `${identity.class} ${identity.operation} for ${identity.codec} has no hardware support and no registered software fallback`, false),
+        ],
+    };
+}
+/** Bounded registry of software codec fallback providers. */
+export class CodecFallbackRegistry {
+    #providers = [];
+    register(provider) {
+        if (this.#providers.some(existing => existing.id === provider.id)) {
+            throw new TypeError(`Codec fallback ${provider.id} is already registered`);
+        }
+        this.#providers.push(provider);
+    }
+    unregister(id) {
+        const index = this.#providers.findIndex(provider => provider.id === id);
+        if (index !== -1)
+            this.#providers.splice(index, 1);
+    }
+    clear() {
+        this.#providers.length = 0;
+    }
+    providers() {
+        return [...this.#providers];
+    }
+}
+/** The default process-wide registry used when no application instance is passed. */
+export const codecFallbackRegistry = new CodecFallbackRegistry();

package/dist/gate.d.ts

@@ -0,0 +1,23 @@
+import type { Diagnostic } from '@aelionsdk/core';
+import type { CapabilityReport } from './types.js';
+export interface CapabilityGateRequirements {
+    /** Exact capability probe ids, for example `h264-decode-1080p30`. */
+    readonly codecIds?: readonly string[];
+    readonly gpu?: 'webgl2' | 'webgpu';
+    readonly audioWorklet?: boolean;
+    readonly opfs?: boolean;
+    readonly sharedArrayBuffer?: boolean;
+    readonly transferableStreams?: boolean;
+    readonly secureContext?: boolean;
+    readonly crossOriginIsolated?: boolean;
+}
+export interface CapabilityGateResult {
+    readonly ok: boolean;
+    readonly diagnostics: readonly Diagnostic[];
+}
+/**
+ * Evaluates product requirements only from observed capability probes.
+ * User-agent and platform strings are intentionally excluded from decisions.
+ */
+export declare function evaluateCapabilityGate(report: CapabilityReport, requirements: CapabilityGateRequirements): CapabilityGateResult;
+//# sourceMappingURL=gate.d.ts.map

package/dist/gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate.d.ts","sourceRoot":"","sources":["../src/gate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,MAAM,WAAW,0BAA0B;IACzC,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IACnC,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;CACxC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;CAC7C;AAWD;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,gBAAgB,EACxB,YAAY,EAAE,0BAA0B,GACvC,oBAAoB,CAwDtB"}

package/dist/gate.js

@@ -0,0 +1,52 @@
+function missing(code, message) {
+    return {
+        code,
+        severity: 'error',
+        message,
+        recoverable: true,
+    };
+}
+/**
+ * Evaluates product requirements only from observed capability probes.
+ * User-agent and platform strings are intentionally excluded from decisions.
+ */
+export function evaluateCapabilityGate(report, requirements) {
+    const diagnostics = [];
+    const codecs = new Map(report.codecs.map(codec => [codec.id, codec]));
+    for (const id of requirements.codecIds ?? []) {
+        const codec = codecs.get(id);
+        if (codec?.supported !== true) {
+            diagnostics.push(missing('CAPABILITY_GATE_CODEC_UNSUPPORTED', codec === undefined
+                ? `Required codec probe ${id} is absent`
+                : `Required codec probe ${id} is unsupported`));
+        }
+    }
+    if (requirements.gpu !== undefined && !report.gpu[requirements.gpu].available) {
+        diagnostics.push(missing('CAPABILITY_GATE_GPU_UNSUPPORTED', `Required ${requirements.gpu} backend is unavailable`));
+    }
+    const booleanRequirements = [
+        ['audioWorklet', requirements.audioWorklet, report.audio.audioWorklet.available],
+        ['opfs', requirements.opfs, report.storage.opfs.available],
+        ['sharedArrayBuffer', requirements.sharedArrayBuffer, report.audio.sharedArrayBuffer.available],
+        [
+            'transferableStreams',
+            requirements.transferableStreams,
+            report.storage.transferableStreams.available,
+        ],
+        ['secureContext', requirements.secureContext, report.environment.secureContext],
+        [
+            'crossOriginIsolated',
+            requirements.crossOriginIsolated,
+            report.environment.crossOriginIsolated,
+        ],
+    ];
+    for (const [name, required, available] of booleanRequirements) {
+        if (required === true && !available) {
+            diagnostics.push(missing('CAPABILITY_GATE_REQUIREMENT_UNSUPPORTED', `Required capability ${name} is unavailable`));
+        }
+    }
+    return Object.freeze({
+        ok: diagnostics.length === 0,
+        diagnostics: Object.freeze(diagnostics),
+    });
+}

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+export * from './fallback.js';
+export * from './gate.js';
 export * from './probe.js';
 export * from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -1,2 +1,4 @@
+export * from './fallback.js';
+export * from './gate.js';
 export * from './probe.js';
 export * from './types.js';

package/dist/probe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"probe.d.ts","sourceRoot":"","sources":["../src/probe.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAIV,sBAAsB,EACtB,gBAAgB,EAMjB,MAAM,YAAY,CAAC;AAmdpB,wBAAsB,iBAAiB,CACrC,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,gBAAgB,CAAC,CAkD3B"}
+{"version":3,"file":"probe.d.ts","sourceRoot":"","sources":["../src/probe.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAIV,sBAAsB,EACtB,gBAAgB,EAOjB,MAAM,YAAY,CAAC;AAghBpB,wBAAsB,iBAAiB,CACrC,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,gBAAgB,CAAC,CAwD3B"}

package/dist/probe.js

@@ -1,4 +1,7 @@
 import { throwIfAborted } from '@aelionsdk/core';
+function currentNavigator() {
+    return Reflect.get(globalThis, 'navigator');
+}
 function diagnostic(code, message, recoverable, cause) {
     return {
         code,
@@ -209,24 +212,33 @@ async function probeGpu(includeAdapterDetails) {
     try {
         const canvas = typeof OffscreenCanvas === 'function'
             ? new OffscreenCanvas(1, 1)
-            : document.createElement('canvas');
-        const context = canvas.getContext('webgl2');
-        webgl2 =
-            context === null
-                ? unsupported('CAPABILITY_WEBGL2_UNAVAILABLE', 'WebGL2 context creation failed')
-                : supported({
-                    renderer: context instanceof WebGL2RenderingContext
-                        ? context.getParameter(context.RENDERER)
-                        : 'offscreen-webgl2',
-                });
-        if (context instanceof WebGL2RenderingContext) {
-            context.getExtension('WEBGL_lose_context')?.loseContext();
+            : typeof document === 'object'
+                ? document.createElement('canvas')
+                : undefined;
+        if (canvas === undefined) {
+            webgl2 = unsupported('CAPABILITY_WEBGL2_UNAVAILABLE', 'WebGL2 is unavailable');
+        }
+        else {
+            const context = canvas.getContext('webgl2');
+            webgl2 =
+                context === null
+                    ? unsupported('CAPABILITY_WEBGL2_UNAVAILABLE', 'WebGL2 context creation failed')
+                    : supported({
+                        renderer: typeof WebGL2RenderingContext === 'function' &&
+                            context instanceof WebGL2RenderingContext
+                            ? context.getParameter(context.RENDERER)
+                            : 'offscreen-webgl2',
+                    });
+            if (typeof WebGL2RenderingContext === 'function' &&
+                context instanceof WebGL2RenderingContext) {
+                context.getExtension('WEBGL_lose_context')?.loseContext();
+            }
         }
     }
     catch (cause) {
         webgl2 = failed('CAPABILITY_WEBGL2_PROBE_FAILED', 'WebGL2 probe failed', cause);
     }
-    const gpu = navigator.gpu;
+    const gpu = currentNavigator()?.gpu;
     if (gpu === undefined) {
         return {
             worker,
@@ -294,7 +306,10 @@ function probeAudio() {
     return { audioContext, audioWorklet, sharedArrayBuffer };
 }
 function probeStorage() {
-    const storage = Reflect.get(navigator, 'storage');
+    const navigator = currentNavigator();
+    const storage = navigator === undefined
+        ? undefined
+        : Reflect.get(navigator, 'storage');
     const opfs = storage !== undefined && typeof storage.getDirectory === 'function'
         ? supported()
         : unsupported('CAPABILITY_OPFS_UNAVAILABLE', 'OPFS is unavailable');
@@ -307,19 +322,23 @@ function probeStorage() {
     return { opfs, fileSystemAccess, transferableStreams };
 }
 function environment() {
-    const navigatorWithMemory = navigator;
-    const userAgentData = Reflect.get(navigator, 'userAgentData');
+    const navigator = currentNavigator();
+    const userAgentData = navigator === undefined
+        ? undefined
+        : Reflect.get(navigator, 'userAgentData');
     return {
-        userAgent: navigator.userAgent,
+        userAgent: navigator?.userAgent ?? 'unavailable',
         platform: userAgentData?.platform ?? 'unknown',
-        language: navigator.language,
-        hardwareConcurrency: Number.isFinite(navigator.hardwareConcurrency) && navigator.hardwareConcurrency > 0
+        language: navigator?.language ?? 'unknown',
+        hardwareConcurrency: navigator !== undefined &&
+            Number.isFinite(navigator.hardwareConcurrency) &&
+            navigator.hardwareConcurrency > 0
             ? navigator.hardwareConcurrency
             : null,
-        deviceMemoryGiB: navigatorWithMemory.deviceMemory ?? null,
-        crossOriginIsolated: globalThis.crossOriginIsolated,
-        secureContext: globalThis.isSecureContext,
-        origin: globalThis.location.origin,
+        deviceMemoryGiB: navigator?.deviceMemory ?? null,
+        crossOriginIsolated: Boolean(globalThis.crossOriginIsolated),
+        secureContext: Boolean(globalThis.isSecureContext),
+        origin: typeof globalThis.location === 'undefined' ? 'unknown' : globalThis.location.origin,
     };
 }
 function probeColor() {
@@ -343,13 +362,48 @@ function probeColor() {
         // from display hardware. HDR/10-bit projects fail closed until the renderer
         // has a float/10-bit surface and matching encoder path.
         localExecution: {
-            workingColorSpaces: ['srgb-linear', 'display-p3-linear', 'rec2020-linear'],
-            transferFunctions: ['srgb', 'gamma22'],
+            workingColorSpaces: ['srgb-linear'],
+            colorPrimaries: ['bt709'],
+            transferFunctions: ['srgb'],
+            matrixCoefficients: ['rgb'],
+            colorRanges: ['full'],
+            chromaSubsamplings: ['rgb', '4:4:4'],
+            alphaModes: ['opaque', 'premultiplied'],
+            toneMappings: ['none'],
             bitDepths: [8],
             hdrPresentation: false,
         },
     };
 }
+async function probeImageFormat(format) {
+    const mime = `image/${format}`;
+    // ImageDecoder is typed as always-present by the DOM lib, but runtime
+    // availability varies; read it through globalThis so the guard is real.
+    const imageDecoder = globalThis.ImageDecoder;
+    if (imageDecoder === undefined) {
+        // No decoder-capability API: report unknown rather than guessing. The
+        // createImageBitmap path used by decodeStillImage may still support the
+        // format, so claiming unsupported here would be wrong.
+        return failed('CAPABILITY_IMAGE_FORMAT_UNKNOWN', `ImageDecoder is unavailable; ${mime} decode support is unknown`, undefined);
+    }
+    try {
+        return (await imageDecoder.isTypeSupported(mime))
+            ? supported({ mime })
+            : unsupported('CAPABILITY_IMAGE_FORMAT_UNSUPPORTED', `${mime} decode is unsupported`);
+    }
+    catch (cause) {
+        return failed('CAPABILITY_IMAGE_FORMAT_PROBE_FAILED', `Failed to probe ${mime}`, cause);
+    }
+}
+async function probeImages() {
+    const [avif, jpeg, png, webp] = await Promise.all([
+        probeImageFormat('avif'),
+        probeImageFormat('jpeg'),
+        probeImageFormat('png'),
+        probeImageFormat('webp'),
+    ]);
+    return { avif, jpeg, png, webp };
+}
 function tier(codecs, gpu, audio) {
     const hasVideoDecode = codecs.some(codec => codec.kind === 'video-decoder' && codec.supported);
     if (hasVideoDecode &&
@@ -374,6 +428,7 @@ export async function probeCapabilities(options = {}) {
     const audio = probeAudio();
     const storage = probeStorage();
     const color = probeColor();
+    const images = await probeImages();
     const diagnostics = [
         ...codecs.flatMap(codec => codec.diagnostics),
         ...(gpu.webgpu.diagnostics ?? []),
@@ -388,6 +443,10 @@ export async function probeCapabilities(options = {}) {
         ...(storage.transferableStreams.diagnostics ?? []),
         ...(color.displayP3Gamut.diagnostics ?? []),
         ...(color.highDynamicRange.diagnostics ?? []),
+        ...(images.avif.diagnostics ?? []),
+        ...(images.jpeg.diagnostics ?? []),
+        ...(images.png.diagnostics ?? []),
+        ...(images.webp.diagnostics ?? []),
     ];
     return {
         schemaVersion: '1.0.0',
@@ -399,6 +458,7 @@ export async function probeCapabilities(options = {}) {
         audio,
         storage,
         color,
+        images,
         wasm: typeof WebAssembly === 'object'
             ? { available: supported() }
             : {

package/dist/types.d.ts

@@ -35,13 +35,36 @@ export interface StorageCapability {
     readonly fileSystemAccess: CapabilityProbe;
     readonly transferableStreams: CapabilityProbe;
 }
+/**
+ * Still-image decode capability for the formats the SDK accepts through
+ * {@link ImageDecoder}/`createImageBitmap`. Probes report what the platform can
+ * deterministically signal; a probe with `status: 'unknown'` means the platform
+ * exposes no decoder-capability API (e.g. no `ImageDecoder`), not that the
+ * format is unsupported.
+ */
+export interface ImageFormatCapability {
+    /** AVIF still decode. */
+    readonly avif: CapabilityProbe;
+    /** JPEG still decode. */
+    readonly jpeg: CapabilityProbe;
+    /** PNG still decode. */
+    readonly png: CapabilityProbe;
+    /** WebP still decode. */
+    readonly webp: CapabilityProbe;
+}
 export interface ColorCapability {
     readonly displayP3Gamut: CapabilityProbe;
     readonly highDynamicRange: CapabilityProbe;
     /** The color contract implemented by the current local renderer/exporter. */
     readonly localExecution: {
         readonly workingColorSpaces: readonly string[];
+        readonly colorPrimaries: readonly ('bt709' | 'display-p3' | 'bt2020')[];
         readonly transferFunctions: readonly ('srgb' | 'gamma22' | 'pq' | 'hlg')[];
+        readonly matrixCoefficients: readonly ('rgb' | 'bt709' | 'bt2020-ncl')[];
+        readonly colorRanges: readonly ('full' | 'limited')[];
+        readonly chromaSubsamplings: readonly ('rgb' | '4:4:4' | '4:2:2' | '4:2:0')[];
+        readonly alphaModes: readonly ('opaque' | 'premultiplied')[];
+        readonly toneMappings: readonly ('none' | 'bt2390' | 'reinhard')[];
         readonly bitDepths: readonly (8 | 10)[];
         readonly hdrPresentation: boolean;
     };
@@ -66,6 +89,7 @@ export interface CapabilityReport {
     readonly audio: AudioCapability;
     readonly storage: StorageCapability;
     readonly color: ColorCapability;
+    readonly images: ImageFormatCapability;
     readonly wasm: {
         readonly available: CapabilityProbe;
     };

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aelionsdk/capability",
-  "version": "0.1.0-beta.1",
+  "version": "1.1.0-rc.1",
   "description": "Browser media capability probing for AelionSDK",
   "license": "MIT",
   "repository": {
@@ -27,14 +27,14 @@
     "!dist/.tsbuildinfo"
   ],
   "engines": {
-    "node": ">=20.19"
+    "node": ">=24 <25"
   },
   "publishConfig": {
     "access": "public",
     "provenance": true
   },
   "dependencies": {
-    "@aelionsdk/core": "0.1.0-beta.1"
+    "@aelionsdk/core": "1.1.0-rc.1"
   },
   "scripts": {
     "build": "tsc -b",