@amazon-devices/kepler-a11y-settings-interface-turbo 1.0.0-rn-83

package/dist/src/UiScaleSettingContextProvider.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Copyright (c) 2025 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ *
+ * PROPRIETARY/CONFIDENTIAL
+ *
+ * Use is subject to license terms.
+ *
+ */
+import * as React from 'react';
+import { ScalingProps, UiScaleSetting } from './KeplerA11ySettingsInterface';
+/**
+ * Props for UiScaleSettingProvider component
+ */
+interface UiScaleSettingProviderProps {
+    children: React.ReactNode;
+}
+/**
+ * Provider component that supplies UI scale setting context to child components
+ */
+export declare function UiScaleSettingContextProvider({ children }: UiScaleSettingProviderProps): JSX.Element;
+/**
+ * Hook to access the current UI scale setting.
+ * @returns The current UI scale setting
+ */
+export declare const useUiScaleSetting: () => UiScaleSetting;
+/**
+ * Hook to check whether we're still fetching the UI scale setting.
+ * @returns whether we're still loading the UI scale setting
+ */
+export declare const useUiScaleSettingLoading: () => boolean;
+/**
+ * Hook to retrieve the UI scaled size value based on original size and scaling properties.
+ *
+ * @param originalSize The original size to scale (in DIP if PLATFORM_DENSITY_INDEPENDENT_PIXEL
+ *   is enabled, or in physical pixels otherwise)
+ * @param scalingProps Properties that define how scaling should be applied
+ * @returns The scaled size
+ */
+export declare const useScaledSize: (originalSize: number, scalingProps: ScalingProps) => number;
+/**
+ * Hook to retrieve the UI scaling multiplier value based on original size and scaling properties.
+ *
+ * The scaling multiplier can be applied to values that have different scaling properties, but
+ * should be scaled at the same rate, like the height and width of an image.  In most cases,
+ * developers should prefer the useScaledSize hook.
+ *
+ * @param originalSize The original size to scale (in DIP if PLATFORM_DENSITY_INDEPENDENT_PIXEL
+ *   is enabled, or in physical pixels otherwise)
+ * @param scalingProps Properties that define how scaling should be applied
+ * @returns The scaling multiplier
+ */
+export declare const useScalingMultiplier: (originalSize: number, scalingProps: ScalingProps) => number;
+export {};

package/dist/src/UiScaleSettingContextProvider.js

@@ -0,0 +1,164 @@
+"use strict";
+/**
+ * Copyright (c) 2025 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ *
+ * PROPRIETARY/CONFIDENTIAL
+ *
+ * Use is subject to license terms.
+ *
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useScalingMultiplier = exports.useScaledSize = exports.useUiScaleSettingLoading = exports.useUiScaleSetting = exports.UiScaleSettingContextProvider = void 0;
+const React = __importStar(require("react"));
+const KeplerA11ySettingsInterfaceTurbo_1 = __importDefault(require("./turbo-modules/KeplerA11ySettingsInterfaceTurbo"));
+const react_native_1 = require("react-native");
+const constants_1 = require("./utils/constants");
+const dipUtils_1 = require("./utils/dipUtils");
+const DEFAULT_UI_SCALE_SETTING = 1.0;
+const DEFAULT_SCALING_MULTIPLIER = 1.0;
+/**
+ * Context for sharing UI scale setting data across components
+ */
+const UiScaleSettingContext = React.createContext({ uiScaleSetting: DEFAULT_UI_SCALE_SETTING, isLoading: true });
+/**
+ * Provider component that supplies UI scale setting context to child components
+ */
+function UiScaleSettingContextProvider({ children }) {
+    const [uiScaleSetting, setUiScaleSetting] = React.useState(DEFAULT_UI_SCALE_SETTING);
+    const [isLoading, setIsLoading] = React.useState(true);
+    React.useEffect(() => {
+        try {
+            setUiScaleSetting(KeplerA11ySettingsInterfaceTurbo_1.default.getUiScaleSettingSync());
+            setIsLoading(false);
+            KeplerA11ySettingsInterfaceTurbo_1.default.addUiScaleSettingListener();
+            const emitter = new react_native_1.NativeEventEmitter();
+            const listener = emitter.addListener(constants_1.UI_SCALE_SETTING_CHANGED_EVENT, (args) => {
+                setUiScaleSetting(args.intValue);
+            });
+            return () => {
+                try {
+                    KeplerA11ySettingsInterfaceTurbo_1.default.removeUiScaleSettingListener();
+                }
+                catch (e) {
+                    console.error(e);
+                }
+                listener.remove();
+            };
+        }
+        catch (e) {
+            setIsLoading(false);
+            console.error(e);
+        }
+    }, []);
+    const contextValue = React.useMemo(() => ({
+        uiScaleSetting,
+        isLoading,
+    }), [uiScaleSetting, isLoading]);
+    return React.createElement(UiScaleSettingContext.Provider, { value: contextValue }, children);
+}
+exports.UiScaleSettingContextProvider = UiScaleSettingContextProvider;
+/**
+ * Hook to access the current UI scale setting.
+ * @returns The current UI scale setting
+ */
+const useUiScaleSetting = () => {
+    const context = React.useContext(UiScaleSettingContext);
+    return context.uiScaleSetting;
+};
+exports.useUiScaleSetting = useUiScaleSetting;
+/**
+ * Hook to check whether we're still fetching the UI scale setting.
+ * @returns whether we're still loading the UI scale setting
+ */
+const useUiScaleSettingLoading = () => {
+    const context = React.useContext(UiScaleSettingContext);
+    return context.isLoading;
+};
+exports.useUiScaleSettingLoading = useUiScaleSettingLoading;
+/**
+ * Hook to retrieve the UI scaled size value based on original size and scaling properties.
+ *
+ * @param originalSize The original size to scale (in DIP if PLATFORM_DENSITY_INDEPENDENT_PIXEL
+ *   is enabled, or in physical pixels otherwise)
+ * @param scalingProps Properties that define how scaling should be applied
+ * @returns The scaled size
+ */
+const useScaledSize = (originalSize, scalingProps) => {
+    const uiScaleSetting = (0, exports.useUiScaleSetting)();
+    const scaledSize = React.useMemo(() => {
+        try {
+            if (uiScaleSetting === DEFAULT_UI_SCALE_SETTING) {
+                return originalSize;
+            }
+            const dipFactor = (0, dipUtils_1.getDipConversionFactor)();
+            let result = KeplerA11ySettingsInterfaceTurbo_1.default.getScaledSizeSync(originalSize / dipFactor, (0, dipUtils_1.convertScalingPropsToDip)(scalingProps, dipFactor)) * dipFactor;
+            if (scalingProps.maxSize != null)
+                result = Math.min(result, scalingProps.maxSize);
+            if (scalingProps.minSize != null)
+                result = Math.max(result, scalingProps.minSize);
+            return result;
+        }
+        catch (e) {
+            console.error(e);
+            return originalSize;
+        }
+    }, [originalSize, scalingProps.itemType, scalingProps.maxSize, scalingProps.minSize, uiScaleSetting]);
+    return scaledSize;
+};
+exports.useScaledSize = useScaledSize;
+/**
+ * Hook to retrieve the UI scaling multiplier value based on original size and scaling properties.
+ *
+ * The scaling multiplier can be applied to values that have different scaling properties, but
+ * should be scaled at the same rate, like the height and width of an image.  In most cases,
+ * developers should prefer the useScaledSize hook.
+ *
+ * @param originalSize The original size to scale (in DIP if PLATFORM_DENSITY_INDEPENDENT_PIXEL
+ *   is enabled, or in physical pixels otherwise)
+ * @param scalingProps Properties that define how scaling should be applied
+ * @returns The scaling multiplier
+ */
+const useScalingMultiplier = (originalSize, scalingProps) => {
+    const uiScaleSetting = (0, exports.useUiScaleSetting)();
+    const scalingMultiplier = React.useMemo(() => {
+        try {
+            if (uiScaleSetting === DEFAULT_UI_SCALE_SETTING) {
+                return DEFAULT_SCALING_MULTIPLIER;
+            }
+            const dipFactor = (0, dipUtils_1.getDipConversionFactor)();
+            return KeplerA11ySettingsInterfaceTurbo_1.default.getScalingMultiplierSync(originalSize / dipFactor, (0, dipUtils_1.convertScalingPropsToDip)(scalingProps, dipFactor));
+        }
+        catch (e) {
+            console.error(e);
+            return 1.0;
+        }
+    }, [originalSize, scalingProps.itemType, scalingProps.maxSize, scalingProps.minSize, uiScaleSetting]);
+    return scalingMultiplier;
+};
+exports.useScalingMultiplier = useScalingMultiplier;

package/dist/src/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Copyright (c) 2025 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ *
+ * PROPRIETARY/CONFIDENTIAL
+ *
+ * Use is subject to license terms.
+ *
+ */
+export { default as KeplerA11ySettingsInterface } from './KeplerA11ySettingsInterface';
+export type { ItemScalingType, UiScaleSetting, ScalingProps, ColorCorrectionMode, TimeoutMultiplier, CaptionTextSize, CaptionColor, CaptionFont, CaptionEdgeStyle, CaptionOpacity, CaptioningProps } from './turbo-modules/KeplerA11ySettingsInterfaceTurbo';
+export { UiScaleSettingMode, SCALING_PROP_IMAGE_TYPE, SCALING_PROP_LARGE_DOWNSCALE_TYPE, SCALING_PROP_LARGE_UPSCALE_TYPE, SCALING_PROP_LOW_DOWNSCALE_TYPE, SCALING_PROP_LOW_UPSCALE_TYPE, SCALING_PROP_MEDIUM_UPSCALE_TYPE, SCALING_PROP_TEXT_TYPE } from './turbo-modules/KeplerA11ySettingsInterfaceTurbo';
+export { useScaledSize, useScalingMultiplier, useUiScaleSetting, useUiScaleSettingLoading, UiScaleSettingContextProvider } from './UiScaleSettingContextProvider';

package/dist/src/index.js

@@ -0,0 +1,31 @@
+"use strict";
+/**
+ * Copyright (c) 2025 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ *
+ * PROPRIETARY/CONFIDENTIAL
+ *
+ * Use is subject to license terms.
+ *
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UiScaleSettingContextProvider = exports.useUiScaleSettingLoading = exports.useUiScaleSetting = exports.useScalingMultiplier = exports.useScaledSize = exports.SCALING_PROP_TEXT_TYPE = exports.SCALING_PROP_MEDIUM_UPSCALE_TYPE = exports.SCALING_PROP_LOW_UPSCALE_TYPE = exports.SCALING_PROP_LOW_DOWNSCALE_TYPE = exports.SCALING_PROP_LARGE_UPSCALE_TYPE = exports.SCALING_PROP_LARGE_DOWNSCALE_TYPE = exports.SCALING_PROP_IMAGE_TYPE = exports.UiScaleSettingMode = exports.KeplerA11ySettingsInterface = void 0;
+var KeplerA11ySettingsInterface_1 = require("./KeplerA11ySettingsInterface");
+Object.defineProperty(exports, "KeplerA11ySettingsInterface", { enumerable: true, get: function () { return __importDefault(KeplerA11ySettingsInterface_1).default; } });
+var KeplerA11ySettingsInterfaceTurbo_1 = require("./turbo-modules/KeplerA11ySettingsInterfaceTurbo");
+Object.defineProperty(exports, "UiScaleSettingMode", { enumerable: true, get: function () { return KeplerA11ySettingsInterfaceTurbo_1.UiScaleSettingMode; } });
+Object.defineProperty(exports, "SCALING_PROP_IMAGE_TYPE", { enumerable: true, get: function () { return KeplerA11ySettingsInterfaceTurbo_1.SCALING_PROP_IMAGE_TYPE; } });
+Object.defineProperty(exports, "SCALING_PROP_LARGE_DOWNSCALE_TYPE", { enumerable: true, get: function () { return KeplerA11ySettingsInterfaceTurbo_1.SCALING_PROP_LARGE_DOWNSCALE_TYPE; } });
+Object.defineProperty(exports, "SCALING_PROP_LARGE_UPSCALE_TYPE", { enumerable: true, get: function () { return KeplerA11ySettingsInterfaceTurbo_1.SCALING_PROP_LARGE_UPSCALE_TYPE; } });
+Object.defineProperty(exports, "SCALING_PROP_LOW_DOWNSCALE_TYPE", { enumerable: true, get: function () { return KeplerA11ySettingsInterfaceTurbo_1.SCALING_PROP_LOW_DOWNSCALE_TYPE; } });
+Object.defineProperty(exports, "SCALING_PROP_LOW_UPSCALE_TYPE", { enumerable: true, get: function () { return KeplerA11ySettingsInterfaceTurbo_1.SCALING_PROP_LOW_UPSCALE_TYPE; } });
+Object.defineProperty(exports, "SCALING_PROP_MEDIUM_UPSCALE_TYPE", { enumerable: true, get: function () { return KeplerA11ySettingsInterfaceTurbo_1.SCALING_PROP_MEDIUM_UPSCALE_TYPE; } });
+Object.defineProperty(exports, "SCALING_PROP_TEXT_TYPE", { enumerable: true, get: function () { return KeplerA11ySettingsInterfaceTurbo_1.SCALING_PROP_TEXT_TYPE; } });
+var UiScaleSettingContextProvider_1 = require("./UiScaleSettingContextProvider");
+Object.defineProperty(exports, "useScaledSize", { enumerable: true, get: function () { return UiScaleSettingContextProvider_1.useScaledSize; } });
+Object.defineProperty(exports, "useScalingMultiplier", { enumerable: true, get: function () { return UiScaleSettingContextProvider_1.useScalingMultiplier; } });
+Object.defineProperty(exports, "useUiScaleSetting", { enumerable: true, get: function () { return UiScaleSettingContextProvider_1.useUiScaleSetting; } });
+Object.defineProperty(exports, "useUiScaleSettingLoading", { enumerable: true, get: function () { return UiScaleSettingContextProvider_1.useUiScaleSettingLoading; } });
+Object.defineProperty(exports, "UiScaleSettingContextProvider", { enumerable: true, get: function () { return UiScaleSettingContextProvider_1.UiScaleSettingContextProvider; } });

package/dist/src/turbo-modules/KeplerA11ySettingsInterfaceTurbo.d.ts

@@ -0,0 +1,214 @@
+/**
+ * Copyright (c) 2025 - 2026 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ *
+ * PROPRIETARY/CONFIDENTIAL
+ *
+ * Use is subject to license terms.
+ *
+ */
+import type { KeplerTurboModule } from '@amazon-devices/keplerscript-turbomodule-api';
+/**
+ * This enum defines scale settings for applications and UI frameworks
+ * to adjust their element sizes.
+ */
+export declare type UiScaleSetting = 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9;
+/**
+ * Mapping from public-facing level name to numerical UiScaleSetting value
+ */
+export declare const UiScaleSettingMode: {
+    DEFAULT: UiScaleSetting;
+};
+/**
+ * Color correction modes for addressing color vision deficiencies.
+ */
+export declare type ColorCorrectionMode = 'off' | 'deuteranomaly' | 'protanomaly' | 'tritanomaly';
+/**
+ * Timeout multiplier values for adjusting timeout durations.
+ */
+export declare type TimeoutMultiplier = 'no_timeout' | 'default' | 'double_timeout' | 'triple_timeout' | 'quadruple_timeout';
+/**
+ * Text size values for captioning.
+ */
+export declare type CaptionTextSize = 'very_small' | 'small' | 'normal' | 'large' | 'very_large';
+/**
+ * Color values for captioning.
+ */
+export declare type CaptionColor = 'default' | 'white' | 'black' | 'red' | 'green' | 'blue' | 'yellow' | 'magenta' | 'cyan';
+/**
+ * Font values for captioning.
+ */
+export declare type CaptionFont = 'default' | 'casual' | 'cursive' | 'monospace_sans' | 'monospace_serif' | 'sans_serif' | 'serif' | 'small_capitals';
+/**
+ * Edge style values for captioning.
+ */
+export declare type CaptionEdgeStyle = 'none' | 'uniform' | 'drop_shadowed' | 'raised' | 'depressed';
+/**
+ * Opacity values for captioning.
+ */
+export declare type CaptionOpacity = 'percent_25' | 'percent_50' | 'percent_75' | 'percent_100';
+/**
+ * Types of items that can be scaled.  Different types of objects scale at different rates.
+ */
+export declare type ItemScalingType = 
+/**
+ * The item being scaled is already very large and takes up a high percentage of the screen.
+ * The item will not be scaled up very much at higher ScaleFactorSettings.
+ * Examples include UI cards which are already very large and readable by default.
+ */
+'low_upscale'
+/**
+ * The item being scaled is somewhat readable or understandable at the default
+ */
+ | 'medium_upscale'
+/**
+ * The item being scaled is difficult to read or understand at smaller sizes, and has room to grow on the screen.
+ * Examples include navigation buttons or switches.
+ */
+ | 'large_upscale'
+/**
+ * The item being scaled should be reduced in size at higher scale settings.
+ * This is used for whitespace and padding, to allow more space for larger visual elements on screen.
+ */
+ | 'low_downscale'
+/**
+ * The item being scaled should be reduced dramatically in size at higher scale settings.
+ * This is used for very large padding.
+ */
+ | 'large_downscale'
+/**
+ * The item being scaled is text or a line height.
+ */
+ | 'text'
+/**
+ * The item being scaled is an image.  Note that large images may not scale up.
+ */
+ | 'image';
+/** Convenience ScalingProps object for text scaling when maxSize/minSize are not needed */
+export declare const SCALING_PROP_TEXT_TYPE: ScalingProps;
+/** Convenience ScalingProps object for image scaling when maxSize/minSize are not needed */
+export declare const SCALING_PROP_IMAGE_TYPE: ScalingProps;
+/** Convenience ScalingProps object for low upscale items when maxSize/minSize are not needed */
+export declare const SCALING_PROP_LOW_UPSCALE_TYPE: ScalingProps;
+/** Convenience ScalingProps object for medium upscale items when maxSize/minSize are not needed */
+export declare const SCALING_PROP_MEDIUM_UPSCALE_TYPE: ScalingProps;
+/** Convenience ScalingProps object for large upscale items when maxSize/minSize are not needed */
+export declare const SCALING_PROP_LARGE_UPSCALE_TYPE: ScalingProps;
+/** Convenience ScalingProps object for low downscale items when maxSize/minSize are not needed */
+export declare const SCALING_PROP_LOW_DOWNSCALE_TYPE: ScalingProps;
+/** Convenience ScalingProps object for large downscale items when maxSize/minSize are not needed */
+export declare const SCALING_PROP_LARGE_DOWNSCALE_TYPE: ScalingProps;
+/**
+ * Scaling properties to describe an item that will be scaled.
+ */
+export interface ScalingProps {
+    /**
+     * The type of item being scaled
+     */
+    itemType: ItemScalingType;
+    /**
+     * The maximum size that the object being scaled should become. Application should use this parameter
+     * when the item's scaled size is too large to be usable at the maximum scale level.
+     * @default Number.MAX_VALUE
+     */
+    maxSize?: number;
+    /**
+    * The minimum size that the object being scaled should become. This parameter only needs to be
+    * set for items of type 'low_downscale' or 'large_downscale', which will be scaled down.
+    * @default 0
+    */
+    minSize?: number;
+}
+/**
+ * Captioning properties to describe captioning preferences.
+ */
+export interface CaptioningProps {
+    /**
+     * The caption text size.
+     */
+    textSize?: CaptionTextSize;
+    /**
+     * The caption text color.
+     */
+    textColor?: CaptionColor;
+    /**
+     * The caption text font.
+     */
+    textFont?: CaptionFont;
+    /**
+     * The caption text edge style.
+     */
+    textEdgeStyle?: CaptionEdgeStyle;
+    /**
+     * The caption text opacity.
+     */
+    textOpacity?: CaptionOpacity;
+    /**
+     * The color of the background behind the caption text.
+     */
+    textBackgroundColor?: CaptionColor;
+    /**
+     * The opacity of the background behind the caption text.
+     */
+    textBackgroundOpacity?: CaptionOpacity;
+    /**
+     * The color of the caption window background.
+     */
+    windowBackgroundColor?: CaptionColor;
+    /**
+     * The opacity of the caption window background.
+     */
+    windowBackgroundOpacity?: CaptionOpacity;
+}
+export interface KeplerA11ySettingsInterfaceTurbo extends KeplerTurboModule {
+    getScalingMultiplierSync: (originalSize: number, scalingProps: ScalingProps) => number;
+    getScaledSizeSync: (originalSize: number, scalingProps: ScalingProps) => number;
+    getUiScaleSettingSync: () => UiScaleSetting;
+    getScalingMultiplier: (originalSize: number, scalingProps: ScalingProps) => Promise<number>;
+    getScaledSize: (originalSize: number, scalingProps: ScalingProps) => Promise<number>;
+    getUiScaleSetting: () => Promise<UiScaleSetting>;
+    isScreenReaderEnabled: () => Promise<boolean>;
+    isScreenMagnifierEnabled: () => Promise<boolean>;
+    isTextBannerEnabled: () => Promise<boolean>;
+    isColorInversionEnabled: () => Promise<boolean>;
+    getColorCorrectionMode: () => Promise<string>;
+    isHighContrastTextEnabled: () => Promise<boolean>;
+    isAudioDescriptionPreferred: () => Promise<boolean>;
+    getTimeToTakeAction: () => Promise<string>;
+    isClosedCaptioningEnabled: () => Promise<boolean>;
+    getCaptionPreferences: () => Promise<CaptioningProps>;
+    setScreenReaderEnabled: (enabled: boolean) => Promise<void>;
+    setScreenMagnifierEnabled: (enabled: boolean) => Promise<void>;
+    setTextBannerEnabled: (enabled: boolean) => Promise<void>;
+    setColorInversionEnabled: (enabled: boolean) => Promise<void>;
+    setColorCorrectionMode: (mode: string) => Promise<void>;
+    setHighContrastTextEnabled: (enabled: boolean) => Promise<void>;
+    setAudioDescriptionPreferred: (enabled: boolean) => Promise<void>;
+    setTimeToTakeAction: (multiplier: string) => Promise<void>;
+    setUiScaleSetting: (setting: UiScaleSetting) => Promise<void>;
+    setClosedCaptioningEnabled: (enabled: boolean) => Promise<void>;
+    setCaptionPreferences: (prefs: CaptioningProps) => Promise<void>;
+    addScreenReaderStateListener: () => Promise<boolean>;
+    addScreenMagnifierStateListener: () => Promise<boolean>;
+    addTextBannerStateListener: () => Promise<boolean>;
+    addColorInversionStateListener: () => Promise<boolean>;
+    addColorCorrectionModeListener: () => Promise<boolean>;
+    addHighContrastTextStateListener: () => Promise<boolean>;
+    addAudioDescriptionStateListener: () => Promise<boolean>;
+    addTimeToTakeActionListener: () => Promise<boolean>;
+    addUiScaleSettingListener: () => Promise<boolean>;
+    addClosedCaptioningStateListener: () => Promise<boolean>;
+    addCaptioningPreferencesListener: () => Promise<boolean>;
+    removeCaptioningPreferencesListener: () => Promise<void>;
+    removeScreenReaderStateListener: () => Promise<void>;
+    removeScreenMagnifierStateListener: () => Promise<void>;
+    removeTextBannerStateListener: () => Promise<void>;
+    removeColorInversionStateListener: () => Promise<void>;
+    removeColorCorrectionModeListener: () => Promise<void>;
+    removeHighContrastTextStateListener: () => Promise<void>;
+    removeAudioDescriptionStateListener: () => Promise<void>;
+    removeTimeToTakeActionListener: () => Promise<void>;
+    removeUiScaleSettingListener: () => Promise<void>;
+    removeClosedCaptioningStateListener: () => Promise<void>;
+}
+declare const _default: KeplerA11ySettingsInterfaceTurbo;
+export default _default;

package/dist/src/turbo-modules/KeplerA11ySettingsInterfaceTurbo.js

@@ -0,0 +1,33 @@
+"use strict";
+/**
+ * Copyright (c) 2025 - 2026 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ *
+ * PROPRIETARY/CONFIDENTIAL
+ *
+ * Use is subject to license terms.
+ *
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SCALING_PROP_LARGE_DOWNSCALE_TYPE = exports.SCALING_PROP_LOW_DOWNSCALE_TYPE = exports.SCALING_PROP_LARGE_UPSCALE_TYPE = exports.SCALING_PROP_MEDIUM_UPSCALE_TYPE = exports.SCALING_PROP_LOW_UPSCALE_TYPE = exports.SCALING_PROP_IMAGE_TYPE = exports.SCALING_PROP_TEXT_TYPE = exports.UiScaleSettingMode = void 0;
+const keplerscript_turbomodule_api_1 = require("@amazon-devices/keplerscript-turbomodule-api");
+/**
+ * Mapping from public-facing level name to numerical UiScaleSetting value
+ */
+exports.UiScaleSettingMode = {
+    DEFAULT: 1,
+};
+/** Convenience ScalingProps object for text scaling when maxSize/minSize are not needed */
+exports.SCALING_PROP_TEXT_TYPE = { itemType: 'text' };
+/** Convenience ScalingProps object for image scaling when maxSize/minSize are not needed */
+exports.SCALING_PROP_IMAGE_TYPE = { itemType: 'image' };
+/** Convenience ScalingProps object for low upscale items when maxSize/minSize are not needed */
+exports.SCALING_PROP_LOW_UPSCALE_TYPE = { itemType: 'low_upscale' };
+/** Convenience ScalingProps object for medium upscale items when maxSize/minSize are not needed */
+exports.SCALING_PROP_MEDIUM_UPSCALE_TYPE = { itemType: 'medium_upscale' };
+/** Convenience ScalingProps object for large upscale items when maxSize/minSize are not needed */
+exports.SCALING_PROP_LARGE_UPSCALE_TYPE = { itemType: 'large_upscale' };
+/** Convenience ScalingProps object for low downscale items when maxSize/minSize are not needed */
+exports.SCALING_PROP_LOW_DOWNSCALE_TYPE = { itemType: 'low_downscale' };
+/** Convenience ScalingProps object for large downscale items when maxSize/minSize are not needed */
+exports.SCALING_PROP_LARGE_DOWNSCALE_TYPE = { itemType: 'large_downscale' };
+exports.default = keplerscript_turbomodule_api_1.TurboModuleRegistry.getEnforcing('KeplerA11ySettingsInterfaceTurbo');

package/dist/src/turbo-modules/__mocks__/KeplerA11ySettingsInterfaceTurbo.d.ts

@@ -0,0 +1,7 @@
+declare const _default: {
+    getMajorVersion: () => number;
+    getMinorVersion: () => number;
+    getPatchVersion: () => number;
+    getHelloString: () => string;
+};
+export default _default;

package/dist/src/turbo-modules/__mocks__/KeplerA11ySettingsInterfaceTurbo.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = {
+    getMajorVersion: () => 1,
+    getMinorVersion: () => 0,
+    getPatchVersion: () => 0,
+    getHelloString: () => 'hello',
+};

package/dist/src/utils/constants.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Copyright (c) 2025 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ *
+ * PROPRIETARY/CONFIDENTIAL
+ *
+ * Use is subject to license terms.
+ */
+export declare const UI_SCALE_SETTING_CHANGED_EVENT = "uiScaleSettingChanged";
+export declare const SCREEN_READER_STATE_CHANGED_EVENT = "screenReaderStateChanged";
+export declare const SCREEN_MAGNIFIER_STATE_CHANGED_EVENT = "screenMagnifierStateChanged";
+export declare const TEXT_BANNER_STATE_CHANGED_EVENT = "textBannerStateChanged";
+export declare const COLOR_INVERSION_STATE_CHANGED_EVENT = "colorInversionStateChanged";
+export declare const COLOR_CORRECTION_MODE_CHANGED_EVENT = "colorCorrectionModeChanged";
+export declare const HIGH_CONTRAST_TEXT_STATE_CHANGED_EVENT = "highContrastTextStateChanged";
+export declare const AUDIO_DESCRIPTION_STATE_CHANGED_EVENT = "audioDescriptionStateChanged";
+export declare const TIME_TO_TAKE_ACTION_CHANGED_EVENT = "timeToTakeActionChanged";
+export declare const CLOSED_CAPTIONING_STATE_CHANGED_EVENT = "closedCaptioningStateChanged";
+export declare const CAPTIONING_PREFERENCES_CHANGED_EVENT = "captioningPreferencesChanged";

package/dist/src/utils/constants.js

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * Copyright (c) 2025 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ *
+ * PROPRIETARY/CONFIDENTIAL
+ *
+ * Use is subject to license terms.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CAPTIONING_PREFERENCES_CHANGED_EVENT = exports.CLOSED_CAPTIONING_STATE_CHANGED_EVENT = exports.TIME_TO_TAKE_ACTION_CHANGED_EVENT = exports.AUDIO_DESCRIPTION_STATE_CHANGED_EVENT = exports.HIGH_CONTRAST_TEXT_STATE_CHANGED_EVENT = exports.COLOR_CORRECTION_MODE_CHANGED_EVENT = exports.COLOR_INVERSION_STATE_CHANGED_EVENT = exports.TEXT_BANNER_STATE_CHANGED_EVENT = exports.SCREEN_MAGNIFIER_STATE_CHANGED_EVENT = exports.SCREEN_READER_STATE_CHANGED_EVENT = exports.UI_SCALE_SETTING_CHANGED_EVENT = void 0;
+exports.UI_SCALE_SETTING_CHANGED_EVENT = 'uiScaleSettingChanged';
+exports.SCREEN_READER_STATE_CHANGED_EVENT = 'screenReaderStateChanged';
+exports.SCREEN_MAGNIFIER_STATE_CHANGED_EVENT = 'screenMagnifierStateChanged';
+exports.TEXT_BANNER_STATE_CHANGED_EVENT = 'textBannerStateChanged';
+exports.COLOR_INVERSION_STATE_CHANGED_EVENT = 'colorInversionStateChanged';
+exports.COLOR_CORRECTION_MODE_CHANGED_EVENT = 'colorCorrectionModeChanged';
+exports.HIGH_CONTRAST_TEXT_STATE_CHANGED_EVENT = 'highContrastTextStateChanged';
+exports.AUDIO_DESCRIPTION_STATE_CHANGED_EVENT = 'audioDescriptionStateChanged';
+exports.TIME_TO_TAKE_ACTION_CHANGED_EVENT = 'timeToTakeActionChanged';
+exports.CLOSED_CAPTIONING_STATE_CHANGED_EVENT = 'closedCaptioningStateChanged';
+exports.CAPTIONING_PREFERENCES_CHANGED_EVENT = 'captioningPreferencesChanged';

package/dist/src/utils/dipUtils.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Copyright (c) 2026 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ *
+ * PROPRIETARY/CONFIDENTIAL
+ *
+ * Use is subject to license terms.
+ */
+import type { ScalingProps } from '../turbo-modules/KeplerA11ySettingsInterfaceTurbo';
+/**
+ * Returns the factor to convert between the app's pixel space and DIP.
+ *
+ * If DIP is enabled (PixelRatio > 1), returns 1 (no conversion needed,
+ * the app is already passing DIP values).
+ *
+ * If DIP is not enabled, the app works in physical pixels. The conversion
+ * factor is calculated as physicalHeight / DIP_HEIGHT. For example:
+ * - 1080p device: 1080 / 540 = 2
+ * - 1440p device: 1440 / 540 = 2.66
+ * - 4K device: 2160 / 540 = 4
+ *
+ * The result is cached after the first call since the resolution does not
+ * change during the lifetime of the application.
+ */
+export declare function getDipConversionFactor(): number;
+/**
+ * Converts ScalingProps minSize and maxSize from physical pixels to DIP
+ * when the DIP feature is not enabled. Returns the original props if
+ * no conversion is needed or if the dipFactor is invalid.
+ */
+export declare function convertScalingPropsToDip(scalingProps: ScalingProps, dipFactor: number): ScalingProps;

package/dist/src/utils/dipUtils.js

@@ -0,0 +1,63 @@
+"use strict";
+/**
+ * Copyright (c) 2026 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ *
+ * PROPRIETARY/CONFIDENTIAL
+ *
+ * Use is subject to license terms.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.convertScalingPropsToDip = exports.getDipConversionFactor = void 0;
+const react_native_1 = require("react-native");
+/** The DIP height for TV devices. */
+const DIP_HEIGHT_TV = 540;
+let cachedDipConversionFactor = null;
+/**
+ * Returns the factor to convert between the app's pixel space and DIP.
+ *
+ * If DIP is enabled (PixelRatio > 1), returns 1 (no conversion needed,
+ * the app is already passing DIP values).
+ *
+ * If DIP is not enabled, the app works in physical pixels. The conversion
+ * factor is calculated as physicalHeight / DIP_HEIGHT. For example:
+ * - 1080p device: 1080 / 540 = 2
+ * - 1440p device: 1440 / 540 = 2.66
+ * - 4K device: 2160 / 540 = 4
+ *
+ * The result is cached after the first call since the resolution does not
+ * change during the lifetime of the application.
+ */
+function getDipConversionFactor() {
+    if (cachedDipConversionFactor === null) {
+        const pixelRatio = react_native_1.PixelRatio.get();
+        if (pixelRatio > 1) {
+            cachedDipConversionFactor = 1;
+        }
+        else {
+            const screen = react_native_1.Dimensions.get('screen');
+            const screenHeight = screen?.height ?? DIP_HEIGHT_TV;
+            cachedDipConversionFactor = screenHeight / DIP_HEIGHT_TV;
+        }
+    }
+    return cachedDipConversionFactor;
+}
+exports.getDipConversionFactor = getDipConversionFactor;
+/**
+ * Converts ScalingProps minSize and maxSize from physical pixels to DIP
+ * when the DIP feature is not enabled. Returns the original props if
+ * no conversion is needed or if the dipFactor is invalid.
+ */
+function convertScalingPropsToDip(scalingProps, dipFactor) {
+    if (dipFactor <= 0 || dipFactor === 1) {
+        return scalingProps;
+    }
+    const converted = { ...scalingProps };
+    if (converted.minSize != null) {
+        converted.minSize = converted.minSize / dipFactor;
+    }
+    if (converted.maxSize != null) {
+        converted.maxSize = converted.maxSize / dipFactor;
+    }
+    return converted;
+}
+exports.convertScalingPropsToDip = convertScalingPropsToDip;