@readium/navigator 2.4.0-beta.9 → 2.5.0-beta.1

package/src/protection/NavigatorProtector.ts

@@ -1,10 +1,10 @@
-import { AutomationDetector } from "./AutomationDetector";
-import { DevToolsDetector } from "./DevToolsDetector";
-import { IframeEmbeddingDetector } from "./IframeEmbeddingDetector";
-import { PrintProtector } from "./PrintProtector";
-import { ContextMenuProtector } from "./ContextMenuProtector";
+import { AutomationDetector } from "./AutomationDetector.ts";
+import { DevToolsDetector } from "./DevToolsDetector.ts";
+import { IframeEmbeddingDetector } from "./IframeEmbeddingDetector.ts";
+import { PrintProtector } from "./PrintProtector.ts";
+import { ContextMenuProtector } from "./ContextMenuProtector.ts";
 import { ContextMenuEvent } from "@readium/navigator-html-injectables";
-import { IContentProtectionConfig } from "../Navigator";
+import { IContentProtectionConfig } from "../Navigator.ts";
 
 export const NAVIGATOR_SUSPICIOUS_ACTIVITY_EVENT = "readium:navigator:suspiciousActivity";
 

package/src/webpub/WebPubBlobBuilder.ts

@@ -1,5 +1,5 @@
 import { Link, Publication } from "@readium/shared";
-import { Injector } from "../injection/Injector";
+import { Injector } from "../injection/Injector.ts";
 
 export class WebPubBlobBuilder {
     private readonly item: Link;

package/src/webpub/WebPubFrameManager.ts

@@ -1,8 +1,8 @@
 import { Loader, ModuleName } from "@readium/navigator-html-injectables";
-import { FrameComms } from "../epub/frame/FrameComms";
-import { ReadiumWindow } from "../../../navigator-html-injectables/types/src/helpers/dom";
-import { sML } from "../helpers";
-import { IContentProtectionConfig, IKeyboardPeripheralsConfig } from "../Navigator";
+import { FrameComms } from "../epub/frame/FrameComms.ts";
+import type { ReadiumWindow } from "../../../navigator-html-injectables/types/src/helpers/dom";
+import { sML } from "../helpers/index.ts";
+import { IContentProtectionConfig, IKeyboardPeripheralsConfig } from "../Navigator.ts";
 
 export class WebPubFrameManager {
     private frame: HTMLIFrameElement;
@@ -31,7 +31,7 @@ export class WebPubFrameManager {
         // Protect against background color bleeding
         this.frame.style.backgroundColor = "#FFFFFF";
         this.source = source;
-        
+
         // Use the provided content protection config directly without overriding defaults
         this.contentProtectionConfig = { ...contentProtectionConfig };
         this.keyboardPeripheralsConfig = [...keyboardPeripheralsConfig];
@@ -68,10 +68,10 @@ export class WebPubFrameManager {
 
     private applyContentProtection() {
         if (!this.comms) this.comms!.resume();
-        
+
         // Send content protection config
         this.comms!.send("peripherals_protection", this.contentProtectionConfig);
-        
+
         // Send keyboard peripherals separately
         if (this.keyboardPeripheralsConfig && this.keyboardPeripheralsConfig.length > 0) {
             this.comms!.send("keyboard_peripherals", this.keyboardPeripheralsConfig);
@@ -186,4 +186,4 @@ export class WebPubFrameManager {
     get ldr() {
         return this.loader;
     }
-}
+}

package/src/webpub/WebPubFramePoolManager.ts

@@ -1,9 +1,9 @@
 import { ModuleName } from "@readium/navigator-html-injectables";
 import { Locator, Publication } from "@readium/shared";
-import { WebPubBlobBuilder } from "./WebPubBlobBuilder";
-import { WebPubFrameManager } from "./WebPubFrameManager";
-import { Injector } from "../injection/Injector";
-import { IContentProtectionConfig, IKeyboardPeripheralsConfig } from "../Navigator";
+import { WebPubBlobBuilder } from "./WebPubBlobBuilder.ts";
+import { WebPubFrameManager } from "./WebPubFrameManager.ts";
+import { Injector } from "../injection/Injector.ts";
+import { IContentProtectionConfig, IKeyboardPeripheralsConfig } from "../Navigator.ts";
 
 export class WebPubFramePoolManager {
     private readonly container: HTMLElement;
@@ -19,7 +19,7 @@ export class WebPubFramePoolManager {
     private readonly keyboardPeripheralsConfig: IKeyboardPeripheralsConfig;
 
     constructor(
-        container: HTMLElement, 
+        container: HTMLElement,
         cssProperties?: { [key: string]: string },
         injector?: Injector | null,
         contentProtectionConfig: IContentProtectionConfig = {},
@@ -142,7 +142,7 @@ export class WebPubFramePoolManager {
                 if(!itm) return;
                 if(!this.blobs.has(href)) {
                     const blobBuilder = new WebPubBlobBuilder(
-                        pub, 
+                        pub,
                         this.currentBaseURL || "",
                         itm,
                         {
@@ -250,4 +250,4 @@ export class WebPubFramePoolManager {
         });
         return ret as DOMRect;
     }
-}
+}

package/src/webpub/WebPubNavigator.ts

@@ -1,24 +1,24 @@
 import { Feature, Link, Locator, Publication, ReadingProgression, LocatorLocations } from "@readium/shared";
-import { VisualNavigator, VisualNavigatorViewport, ProgressionRange } from "../Navigator";
-import { Configurable } from "../preferences/Configurable";
-import { WebPubFramePoolManager } from "./WebPubFramePoolManager";
+import { VisualNavigator, VisualNavigatorViewport, ProgressionRange } from "../Navigator.ts";
+import { Configurable } from "../preferences/Configurable.ts";
+import { WebPubFramePoolManager } from "./WebPubFramePoolManager.ts";
 import { BasicTextSelection, CommsEventKey, ContextMenuEvent, FrameClickEvent, KeyboardEventData, ModuleLibrary, ModuleName, SuspiciousActivityEvent, WebPubModules } from "@readium/navigator-html-injectables";
 import * as path from "path-browserify";
-import { WebPubFrameManager } from "./WebPubFrameManager";
-
-import { ManagerEventKey } from "../epub/EpubNavigator";
-import { WebPubCSS } from "./css/WebPubCSS";
-import { WebUserProperties, WebRSProperties } from "./css/Properties";
-import { IWebPubPreferences, WebPubPreferences } from "./preferences/WebPubPreferences";
-import { IWebPubDefaults, WebPubDefaults } from "./preferences/WebPubDefaults";
-import { WebPubSettings } from "./preferences/WebPubSettings";
-import { WebPubPreferencesEditor } from "./preferences/WebPubPreferencesEditor";
-import { Injector } from "../injection/Injector";
-import { createReadiumWebPubRules } from "../injection/webpubInjectables";
-import { IInjectablesConfig } from "../injection/Injectable";
-import { IContentProtectionConfig, IKeyboardPeripheralsConfig } from "../Navigator";
-import { NavigatorProtector, NAVIGATOR_SUSPICIOUS_ACTIVITY_EVENT } from "../protection/NavigatorProtector";
-import { KeyboardPeripherals, NAVIGATOR_KEYBOARD_PERIPHERAL_EVENT } from "../peripherals/KeyboardPeripherals";
+import { WebPubFrameManager } from "./WebPubFrameManager.ts";
+
+import { ManagerEventKey } from "../epub/EpubNavigator.ts";
+import { WebPubCSS } from "./css/WebPubCSS.ts";
+import { WebUserProperties, WebRSProperties } from "./css/Properties.ts";
+import { IWebPubPreferences, WebPubPreferences } from "./preferences/WebPubPreferences.ts";
+import { IWebPubDefaults, WebPubDefaults } from "./preferences/WebPubDefaults.ts";
+import { WebPubSettings } from "./preferences/WebPubSettings.ts";
+import { WebPubPreferencesEditor } from "./preferences/WebPubPreferencesEditor.ts";
+import { Injector } from "../injection/Injector.ts";
+import { createReadiumWebPubRules } from "../injection/webpubInjectables.ts";
+import { IInjectablesConfig } from "../injection/Injectable.ts";
+import { IContentProtectionConfig, IKeyboardPeripheralsConfig } from "../Navigator.ts";
+import { NavigatorProtector, NAVIGATOR_SUSPICIOUS_ACTIVITY_EVENT } from "../protection/NavigatorProtector.ts";
+import { KeyboardPeripherals, NAVIGATOR_KEYBOARD_PERIPHERAL_EVENT } from "../peripherals/KeyboardPeripherals.ts";
 
 export interface WebPubNavigatorConfiguration {
     preferences: IWebPubPreferences;
@@ -78,7 +78,7 @@ export class WebPubNavigator extends VisualNavigator implements Configurable<Web
     private readonly _keyboardPeripheralsManager: KeyboardPeripherals | null = null;
     private readonly _suspiciousActivityListener: ((event: Event) => void) | null = null;
     private readonly _keyboardPeripheralListener: ((event: Event) => void) | null = null;
-    
+
     private webViewport: VisualNavigatorViewport = {
         readingOrder: [],
         progressions: new Map(),
@@ -103,7 +103,7 @@ export class WebPubNavigator extends VisualNavigator implements Configurable<Web
         // Combine WebPub rules with user-provided injectables
         const webpubRules = createReadiumWebPubRules(pub.readingOrder.items);
         const userConfig = configuration.injectables || { rules: [], allowedDomains: [] };
-        
+
         this._injector = new Injector({
             rules: [...webpubRules, ...userConfig.rules],
             allowedDomains: userConfig.allowedDomains
@@ -111,7 +111,7 @@ export class WebPubNavigator extends VisualNavigator implements Configurable<Web
 
         // Initialize content protection with provided config or default values
         this._contentProtection = configuration.contentProtection || {};
-        
+
         // Merge keyboard peripherals
         this._keyboardPeripherals = this.mergeKeyboardPeripherals(
             this._contentProtection,
@@ -125,7 +125,7 @@ export class WebPubNavigator extends VisualNavigator implements Configurable<Web
             this._contentProtection.monitorDevTools ||
             this._contentProtection.protectPrinting?.disable) {
             this._navigatorProtector = new NavigatorProtector(this._contentProtection);
-            
+
             // Listen for custom events from NavigatorProtector
             this._suspiciousActivityListener = (event: Event) => {
                 const { type, ...activity } = (event as CustomEvent).detail;
@@ -137,13 +137,13 @@ export class WebPubNavigator extends VisualNavigator implements Configurable<Web
             };
             window.addEventListener(NAVIGATOR_SUSPICIOUS_ACTIVITY_EVENT, this._suspiciousActivityListener);
         }
-        
+
         // Initialize keyboard peripherals separately (works independently of protection)
         if (this._keyboardPeripherals.length > 0) {
             this._keyboardPeripheralsManager = new KeyboardPeripherals({
                 keyboardPeripherals: this._keyboardPeripherals
             });
-            
+
             // Listen for keyboard peripheral events from main window
             this._keyboardPeripheralListener = (event: Event) => {
                 const activity = (event as CustomEvent).detail;
@@ -169,8 +169,8 @@ export class WebPubNavigator extends VisualNavigator implements Configurable<Web
         await this.updateCSS(false);
         const cssProperties = this.compileCSSProperties(this._css);
         this.framePool = new WebPubFramePoolManager(
-            this.container, 
-            cssProperties, 
+            this.container,
+            cssProperties,
             this._injector,
             this._contentProtection,
             this._keyboardPeripherals
@@ -611,4 +611,4 @@ export class WebPubNavigator extends VisualNavigator implements Configurable<Web
     }
 }
 
-export const ExperimentalWebPubNavigator = WebPubNavigator;
+export const ExperimentalWebPubNavigator = WebPubNavigator;

package/src/webpub/css/Properties.ts

@@ -1,5 +1,5 @@
-import { ExperimentKey, experiments, TextAlignment } from "../../preferences/Types";
-import { BodyHyphens, Ligatures, Properties } from "../../css/Properties";
+import { ExperimentKey, experiments, TextAlignment } from "../../preferences/Types.ts";
+import { BodyHyphens, Ligatures, Properties } from "../../css/Properties.ts";
 
 export interface IWebUserProperties {
   a11yNormalize?: boolean | null;
@@ -101,4 +101,4 @@ export class WebRSProperties extends Properties {
 
     return cssProperties;
   }
-}
+}

package/src/webpub/css/WebPubCSS.ts

@@ -1,5 +1,5 @@
-import { WebPubSettings } from "../preferences/WebPubSettings";
-import { IWebUserProperties, WebRSProperties, WebUserProperties } from "./Properties";
+import { WebPubSettings } from "../preferences/WebPubSettings.ts";
+import { IWebUserProperties, WebRSProperties, WebUserProperties } from "./Properties.ts";
 
 export interface IWebPubCSS {
   rsProperties: WebRSProperties;
@@ -22,20 +22,20 @@ export class WebPubCSS {
 
     const updated: IWebUserProperties = {
       a11yNormalize: settings.textNormalization,
-      bodyHyphens: typeof settings.hyphens !== "boolean" 
-        ? null 
-        : settings.hyphens 
-          ? "auto" 
+      bodyHyphens: typeof settings.hyphens !== "boolean"
+        ? null
+        : settings.hyphens
+          ? "auto"
           : "none",
       fontFamily: settings.fontFamily,
       fontWeight: settings.fontWeight,
       iOSPatch: settings.iOSPatch,
       iPadOSPatch: settings.iPadOSPatch,
       letterSpacing: settings.letterSpacing,
-      ligatures: typeof settings.ligatures !== "boolean" 
-        ? null 
-        : settings.ligatures 
-          ? "common-ligatures" 
+      ligatures: typeof settings.ligatures !== "boolean"
+        ? null
+        : settings.ligatures
+          ? "common-ligatures"
           : "none",
       lineHeight: settings.lineHeight,
       noRuby: settings.noRuby,
@@ -48,4 +48,4 @@ export class WebPubCSS {
 
     this.userProperties = new WebUserProperties(updated);
   }
-}
+}

package/src/webpub/css/index.ts

@@ -1,2 +1,2 @@
-export * from "./Properties";
-export * from "./WebPubCSS";
+export * from "./Properties.ts";
+export * from "./WebPubCSS.ts";

package/src/webpub/index.ts

@@ -1,6 +1,6 @@
-export * from "./WebPubNavigator";
-export * from "./WebPubBlobBuilder";
-export * from "./WebPubFrameManager";
-export * from "./WebPubFramePoolManager";
-export * from "./preferences";
-export * from "./css";
+export * from "./WebPubNavigator.ts";
+export * from "./WebPubBlobBuilder.ts";
+export * from "./WebPubFrameManager.ts";
+export * from "./WebPubFramePoolManager.ts";
+export * from "./preferences/index.ts";
+export * from "./css/index.ts";

package/src/webpub/preferences/WebPubDefaults.ts

@@ -1,9 +1,9 @@
-import { 
+import {
   ExperimentKey,
-  fontWeightRangeConfig, 
-  TextAlignment, 
-  zoomRangeConfig 
-} from "../../preferences/Types";
+  fontWeightRangeConfig,
+  TextAlignment,
+  zoomRangeConfig
+} from "../../preferences/Types.ts";
 
 import {
   ensureBoolean,
@@ -12,9 +12,9 @@ import {
   ensureValueInRange,
   ensureString,
   ensureExperiment
-} from "../../preferences/guards";
+} from "../../preferences/guards.ts";
 
-import { sMLWithRequest } from "../../helpers";
+import { sMLWithRequest } from "../../helpers/index.ts";
 
 export interface IWebPubDefaults {
   fontFamily?: string | null,
@@ -57,11 +57,11 @@ export class WebPubDefaults {
     this.fontFamily = ensureString(defaults.fontFamily) || null;
     this.fontWeight = ensureValueInRange(defaults.fontWeight, fontWeightRangeConfig.range) || null;
     this.hyphens = ensureBoolean(defaults.hyphens) ?? null;
-    this.iOSPatch = defaults.iOSPatch === false 
-        ? false 
+    this.iOSPatch = defaults.iOSPatch === false
+        ? false
         : ((sMLWithRequest.OS.iOS || sMLWithRequest.OS.iPadOS) && sMLWithRequest.iOSRequest === "mobile");
-    this.iPadOSPatch = defaults.iPadOSPatch === false 
-        ? false 
+    this.iPadOSPatch = defaults.iPadOSPatch === false
+        ? false
         : (sMLWithRequest.OS.iPadOS && sMLWithRequest.iOSRequest === "desktop");
     this.letterSpacing = ensureNonNegative(defaults.letterSpacing) || null;
     this.ligatures = ensureBoolean(defaults.ligatures) ?? null;
@@ -75,4 +75,4 @@ export class WebPubDefaults {
     this.zoom = ensureValueInRange(defaults.zoom, zoomRangeConfig.range) || 1;
     this.experiments = ensureExperiment(defaults.experiments) ?? null;
   }
-}
+}

package/src/webpub/preferences/WebPubPreferences.ts

@@ -1,10 +1,10 @@
-import { ConfigurablePreferences } from "../../preferences/Configurable";
+import { ConfigurablePreferences } from "../../preferences/Configurable.ts";
 
-import { 
-  fontWeightRangeConfig, 
-  TextAlignment, 
-  zoomRangeConfig 
-} from "../../preferences/Types";
+import {
+  fontWeightRangeConfig,
+  TextAlignment,
+  zoomRangeConfig
+} from "../../preferences/Types.ts";
 
 import {
   ensureBoolean,
@@ -12,7 +12,7 @@ import {
   ensureNonNegative,
   ensureString,
   ensureValueInRange
-} from "../../preferences/guards";
+} from "../../preferences/guards.ts";
 
 export interface IWebPubPreferences {
   fontFamily?: string | null,
@@ -91,4 +91,4 @@ export class WebPubPreferences implements ConfigurablePreferences<WebPubPreferen
     }
     return new WebPubPreferences(merged);
   }
-}
+}

package/src/webpub/preferences/WebPubPreferencesEditor.ts

@@ -1,19 +1,19 @@
 import { Feature, Metadata } from "@readium/shared";
 
-import { IPreferencesEditor } from "../../preferences/PreferencesEditor";
-import { WebPubPreferences } from "./WebPubPreferences";
-import { WebPubSettings } from "./WebPubSettings";
-import { BooleanPreference, EnumPreference, Preference, RangePreference } from "../../preferences/Preference";
-import { 
-  fontWeightRangeConfig, 
-  letterSpacingRangeConfig, 
-  lineHeightRangeConfig, 
-  paragraphIndentRangeConfig, 
-  paragraphSpacingRangeConfig, 
-  TextAlignment, 
-  wordSpacingRangeConfig, 
-  zoomRangeConfig 
-} from "../../preferences/Types";
+import { IPreferencesEditor } from "../../preferences/PreferencesEditor.ts";
+import { WebPubPreferences } from "./WebPubPreferences.ts";
+import { WebPubSettings } from "./WebPubSettings.ts";
+import { BooleanPreference, EnumPreference, Preference, RangePreference } from "../../preferences/Preference.ts";
+import {
+  fontWeightRangeConfig,
+  letterSpacingRangeConfig,
+  lineHeightRangeConfig,
+  paragraphIndentRangeConfig,
+  paragraphSpacingRangeConfig,
+  TextAlignment,
+  wordSpacingRangeConfig,
+  zoomRangeConfig
+} from "../../preferences/Types.ts";
 export class WebPubPreferencesEditor implements IPreferencesEditor {
   preferences: WebPubPreferences;
   private settings: WebPubSettings;
@@ -45,7 +45,7 @@ export class WebPubPreferencesEditor implements IPreferencesEditor {
       effectiveValue: this.settings.fontFamily || null,
       isEffective: this.isDisplayTransformable,
       onChange: (newValue: string | null | undefined) => {
-        this.updatePreference("fontFamily", newValue || null);
+        this.updatePreference("fontFamily", newValue ?? null);
       }
     });
   }
@@ -56,7 +56,7 @@ export class WebPubPreferencesEditor implements IPreferencesEditor {
       effectiveValue: this.settings.fontWeight || 400,
       isEffective: this.isDisplayTransformable,
       onChange: (newValue: number | null | undefined) => {
-        this.updatePreference("fontWeight", newValue || null);
+        this.updatePreference("fontWeight", newValue ?? null);
       },
       supportedRange: fontWeightRangeConfig.range,
       step: fontWeightRangeConfig.step
@@ -69,7 +69,7 @@ export class WebPubPreferencesEditor implements IPreferencesEditor {
       effectiveValue: this.settings.hyphens || false,
       isEffective: this.isDisplayTransformable,
       onChange: (newValue: boolean | null | undefined) => {
-        this.updatePreference("hyphens", newValue || null);
+        this.updatePreference("hyphens", newValue ?? null);
       }
     });
   }
@@ -80,18 +80,18 @@ export class WebPubPreferencesEditor implements IPreferencesEditor {
         effectiveValue: this.settings.iOSPatch || false,
         isEffective: true,
         onChange: (newValue: boolean | null | undefined) => {
-          this.updatePreference("iOSPatch", newValue || null);
+          this.updatePreference("iOSPatch", newValue ?? null);
         }
       });
     }
-  
+
     get iPadOSPatch(): BooleanPreference {
       return new BooleanPreference({
         initialValue: this.preferences.iPadOSPatch,
         effectiveValue: this.settings.iPadOSPatch || false,
         isEffective: true,
         onChange: (newValue: boolean | null | undefined) => {
-          this.updatePreference("iPadOSPatch", newValue || null);
+          this.updatePreference("iPadOSPatch", newValue ?? null);
         }
       });
     }
@@ -102,7 +102,7 @@ export class WebPubPreferencesEditor implements IPreferencesEditor {
       effectiveValue: this.settings.letterSpacing || 0,
       isEffective: this.isDisplayTransformable,
       onChange: (newValue: number | null | undefined) => {
-        this.updatePreference("letterSpacing", newValue || null);
+        this.updatePreference("letterSpacing", newValue ?? null);
       },
       supportedRange: letterSpacingRangeConfig.range,
       step: letterSpacingRangeConfig.step
@@ -115,7 +115,7 @@ export class WebPubPreferencesEditor implements IPreferencesEditor {
       effectiveValue: this.settings.ligatures || true,
       isEffective: this.isDisplayTransformable,
       onChange: (newValue: boolean | null | undefined) => {
-        this.updatePreference("ligatures", newValue || null);
+        this.updatePreference("ligatures", newValue ?? null);
       }
     });
   }
@@ -126,7 +126,7 @@ export class WebPubPreferencesEditor implements IPreferencesEditor {
       effectiveValue: this.settings.lineHeight,
       isEffective: this.isDisplayTransformable,
       onChange: (newValue: number | null | undefined) => {
-        this.updatePreference("lineHeight", newValue || null);
+        this.updatePreference("lineHeight", newValue ?? null);
       },
       supportedRange: lineHeightRangeConfig.range,
       step: lineHeightRangeConfig.step
@@ -139,7 +139,7 @@ export class WebPubPreferencesEditor implements IPreferencesEditor {
       effectiveValue: this.settings.noRuby || false,
       isEffective: this.isDisplayTransformable,
       onChange: (newValue: boolean | null | undefined) => {
-        this.updatePreference("noRuby", newValue || null);
+        this.updatePreference("noRuby", newValue ?? null);
       }
     });
   }
@@ -150,7 +150,7 @@ export class WebPubPreferencesEditor implements IPreferencesEditor {
       effectiveValue: this.settings.paragraphIndent || 0,
       isEffective: this.isDisplayTransformable,
       onChange: (newValue: number | null | undefined) => {
-        this.updatePreference("paragraphIndent", newValue || null);
+        this.updatePreference("paragraphIndent", newValue ?? null);
       },
       supportedRange: paragraphIndentRangeConfig.range,
       step: paragraphIndentRangeConfig.step
@@ -163,7 +163,7 @@ export class WebPubPreferencesEditor implements IPreferencesEditor {
       effectiveValue: this.settings.paragraphSpacing || 0,
       isEffective: this.isDisplayTransformable,
       onChange: (newValue: number | null | undefined) => {
-        this.updatePreference("paragraphSpacing", newValue || null);
+        this.updatePreference("paragraphSpacing", newValue ?? null);
       },
       supportedRange: paragraphSpacingRangeConfig.range,
       step: paragraphSpacingRangeConfig.step
@@ -176,7 +176,7 @@ export class WebPubPreferencesEditor implements IPreferencesEditor {
       effectiveValue: this.settings.textAlign || TextAlignment.start,
       isEffective: this.isDisplayTransformable,
       onChange: (newValue: TextAlignment | null | undefined) => {
-        this.updatePreference("textAlign", newValue || null);
+        this.updatePreference("textAlign", newValue ?? null);
       },
       supportedValues: Object.values(TextAlignment)
     });
@@ -188,7 +188,7 @@ export class WebPubPreferencesEditor implements IPreferencesEditor {
       effectiveValue: this.settings.textNormalization || false,
       isEffective: this.isDisplayTransformable,
       onChange: (newValue: boolean | null | undefined) => {
-        this.updatePreference("textNormalization", newValue || null);
+        this.updatePreference("textNormalization", newValue ?? null);
       }
     });
   }
@@ -199,7 +199,7 @@ export class WebPubPreferencesEditor implements IPreferencesEditor {
       effectiveValue: this.settings.wordSpacing || 0,
       isEffective: this.isDisplayTransformable,
       onChange: (newValue: number | null | undefined) => {
-        this.updatePreference("wordSpacing", newValue || null);
+        this.updatePreference("wordSpacing", newValue ?? null);
       },
       supportedRange: wordSpacingRangeConfig.range,
       step: wordSpacingRangeConfig.step
@@ -212,10 +212,10 @@ export class WebPubPreferencesEditor implements IPreferencesEditor {
       effectiveValue: this.settings.zoom || 1,
       isEffective: CSS.supports("zoom", "1") ?? false,
       onChange: (newValue: number | null | undefined) => {
-        this.updatePreference("zoom", newValue || null);
+        this.updatePreference("zoom", newValue ?? null);
       },
       supportedRange: zoomRangeConfig.range,
       step: zoomRangeConfig.step
     });
   }
-}
+}