@readium/navigator 2.1.1 → 2.2.1

package/src/webpub/css/WebPubStylesheet.ts

@@ -0,0 +1,204 @@
+// WebPubCSS is equivalent to ReadiumCSS for WebPub
+
+export const webPubStylesheet = `
+/* FontFamily */
+
+:root[style*="--USER__fontFamily"] {
+  font-family: var(--USER__fontFamily) !important;
+}
+
+:root[style*="--USER__fontFamily"] * {
+  font-family: revert !important;
+}
+
+/* FontWeight */
+
+:root[style*="--USER__fontWeight"] body {
+  font-weight: var(--USER__fontWeight) !important;
+}
+
+/* Attempt to handle known bolds */
+:root[style*="--USER__fontWeight"] b,
+:root[style*="--USER__fontWeight"] strong {
+  font-weight: bolder;
+}
+
+/* Hyphens */
+
+:root[style*="--USER__bodyHyphens"] {
+  -webkit-hyphens: var(--USER__bodyHyphens) !important;
+  -moz-hyphens: var(--USER__bodyHyphens) !important;
+  -ms-hyphens: var(--USER__bodyHyphens) !important;
+  -epub-hyphens: var(--USER__bodyHyphens) !important;
+  hyphens: var(--USER__bodyHyphens) !important;
+}
+
+:root[style*="--USER__bodyHyphens"] body,
+:root[style*="--USER__bodyHyphens"] p,
+:root[style*="--USER__bodyHyphens"] li,
+:root[style*="--USER__bodyHyphens"] div,
+:root[style*="--USER__bodyHyphens"] dd {
+  -webkit-hyphens: inherit;
+  -moz-hyphens: inherit;
+  -ms-hyphens: inherit;
+  -epub-hyphens: inherit;
+  hyphens: inherit;
+}
+
+/* LetterSpacing */
+
+:root[style*="--USER__letterSpacing"] h1,
+:root[style*="--USER__letterSpacing"] h2,
+:root[style*="--USER__letterSpacing"] h3,
+:root[style*="--USER__letterSpacing"] h4,
+:root[style*="--USER__letterSpacing"] h5,
+:root[style*="--USER__letterSpacing"] h6,
+:root[style*="--USER__letterSpacing"] p,
+:root[style*="--USER__letterSpacing"] li,
+:root[style*="--USER__letterSpacing"] div,
+:root[style*="--USER__letterSpacing"] dt,
+:root[style*="--USER__letterSpacing"] dd {
+  letter-spacing: var(--USER__letterSpacing);
+  font-variant: none;
+}
+
+/* Ligatures */
+
+:root[style*="--USER__ligatures"] {
+  font-variant-ligatures: var(--USER__ligatures) !important;
+}
+
+:root[style*="--USER__ligatures"] * {
+  font-variant-ligatures: inherit !important;
+}
+
+/* LineHeight */
+
+:root[style*="--USER__lineHeight"] {
+  line-height: var(--USER__lineHeight) !important;
+}
+
+:root[style*="--USER__lineHeight"] body,
+:root[style*="--USER__lineHeight"] p,
+:root[style*="--USER__lineHeight"] li,
+:root[style*="--USER__lineHeight"] div {
+  line-height: inherit;
+}
+
+/* ParagraphIndent */
+
+:root[style*="--USER__paraIndent"] p {
+  text-indent: var(--USER__paraIndent) !important;
+}
+
+:root[style*="--USER__paraIndent"] p *,
+:root[style*="--USER__paraIndent"] p:first-letter {
+  text-indent: 0 !important;
+}
+
+/* ParagraphSpacing */
+
+:root[style*="--USER__paraSpacing"] p {
+  margin-block: var(--USER__paraSpacing) !important;
+}
+
+/* Ruby */
+
+:root[style*="readium-noRuby-on"] body rt,
+:root[style*="readium-noRuby-on"] body rp {
+  display: none;
+}
+
+/* TextAlign */
+
+:root[style*="--USER__textAlign"] {
+  text-align: var(--USER__textAlign);
+}
+
+:root[style*="--USER__textAlign"] body,
+:root[style*="--USER__textAlign"] p:not(blockquote p):not(figcaption p):not(hgroup p),
+:root[style*="--USER__textAlign"] li,
+:root[style*="--USER__textAlign"] dd {
+  text-align: var(--USER__textAlign) !important;
+  -moz-text-align-last: auto !important;
+  -epub-text-align-last: auto !important;
+  text-align-last: auto !important;
+}
+
+/* TextNormalize */
+
+:root[style*="readium-a11y-on"] {
+  font-weight: normal !important;
+  font-style: normal !important;
+}
+
+:root[style*="readium-a11y-on"] *:not(code):not(var):not(kbd):not(samp) {
+  font-family: inherit !important;
+  font-weight: inherit !important;
+  font-style: inherit !important;
+}
+
+:root[style*="readium-a11y-on"] * {
+  text-decoration: none !important;
+  font-variant-caps: normal !important;
+  font-variant-position: normal !important;
+  font-variant-numeric: normal !important;
+}
+
+:root[style*="readium-a11y-on"] sup,
+:root[style*="readium-a11y-on"] sub {
+  font-size: 1rem !important;
+  vertical-align: baseline !important;
+}
+
+/* Word Spacing */
+
+:root[style*="--USER__wordSpacing"] h1,
+:root[style*="--USER__wordSpacing"] h2,
+:root[style*="--USER__wordSpacing"] h3,
+:root[style*="--USER__wordSpacing"] h4,
+:root[style*="--USER__wordSpacing"] h5,
+:root[style*="--USER__wordSpacing"] h6,
+:root[style*="--USER__wordSpacing"] p,
+:root[style*="--USER__wordSpacing"] li,
+:root[style*="--USER__wordSpacing"] div,
+:root[style*="--USER__wordSpacing"] dt,
+:root[style*="--USER__wordSpacing"] dd {
+  word-spacing: var(--USER__wordSpacing);
+}
+
+/* Zoom */
+
+:root {
+  --USER__zoom: 1;
+}
+
+:root[style*="--USER__zoom"] body {
+  zoom: var(--USER__zoom) !important;
+}
+
+@supports selector(figure:has(> img)) {
+  :root[style*="--USER__zoom"] figure:has(> img),
+  :root[style*="--USER__zoom"] figure:has(> video),
+  :root[style*="--USER__zoom"] figure:has(> svg),
+  :root[style*="--USER__zoom"] figure:has(> canvas),
+  :root[style*="--USER__zoom"] figure:has(> iframe),
+  :root[style*="--USER__zoom"] figure:has(> audio),
+  :root[style*="--USER__zoom"] div:has(> img),
+  :root[style*="--USER__zoom"] div:has(> video),
+  :root[style*="--USER__zoom"] div:has(> svg),
+  :root[style*="--USER__zoom"] div:has(> canvas),
+  :root[style*="--USER__zoom"] div:has(> iframe),
+  :root[style*="--USER__zoom"] div:has(> audio),
+  :root[style*="--USER__zoom"] table {
+    zoom: calc(100% / var(--USER__zoom)) !important;
+  }
+
+  :root[style*="--USER__zoom"] figcaption,
+  :root[style*="--USER__zoom"] caption,
+  :root[style*="--USER__zoom"] td,
+  :root[style*="--USER__zoom"] th {
+    zoom: var(--USER__zoom) !important;
+  }
+}
+`;

package/src/webpub/css/index.ts

@@ -0,0 +1,3 @@
+export * from "./Properties";
+export * from "./WebPubCSS";
+export * from "./WebPubStylesheet";

package/src/webpub/index.ts

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

package/src/webpub/preferences/WebPubDefaults.ts

@@ -0,0 +1,61 @@
+import { 
+  fontWeightRangeConfig, 
+  TextAlignment, 
+  zoomRangeConfig 
+} from "../../preferences/Types";
+
+import {
+  ensureBoolean,
+  ensureEnumValue,
+  ensureNonNegative,
+  ensureValueInRange,
+  ensureString
+} from "../../preferences/guards";
+
+export interface IWebPubDefaults {
+  fontFamily?: string | null,
+  fontWeight?: number | null,
+  hyphens?: boolean | null,
+  letterSpacing?: number | null,
+  ligatures?: boolean | null,
+  lineHeight?: number | null,
+  noRuby?: boolean | null,
+  paragraphIndent?: number | null,
+  paragraphSpacing?: number | null,
+  textAlign?: TextAlignment | null,
+  textNormalization?: boolean | null,
+  wordSpacing?: number | null,
+  zoom?: number | null
+}
+
+export class WebPubDefaults {
+  fontFamily: string | null;
+  fontWeight: number | null;
+  hyphens: boolean | null;
+  letterSpacing: number | null;
+  ligatures: boolean | null;
+  lineHeight: number | null;
+  noRuby: boolean | null;
+  paragraphIndent: number | null;
+  paragraphSpacing: number | null;
+  textAlign: TextAlignment | null;
+  textNormalization: boolean | null;
+  wordSpacing: number | null;
+  zoom: number;
+
+  constructor(defaults: IWebPubDefaults) {
+    this.fontFamily = ensureString(defaults.fontFamily) || null;
+    this.fontWeight = ensureValueInRange(defaults.fontWeight, fontWeightRangeConfig.range) || null;
+    this.hyphens = ensureBoolean(defaults.hyphens) ?? null;
+    this.letterSpacing = ensureNonNegative(defaults.letterSpacing) || null;
+    this.ligatures = ensureBoolean(defaults.ligatures) ?? null;
+    this.lineHeight = ensureNonNegative(defaults.lineHeight) || null;
+    this.noRuby = ensureBoolean(defaults.noRuby) ?? false;
+    this.paragraphIndent = ensureNonNegative(defaults.paragraphIndent) ?? null;
+    this.paragraphSpacing = ensureNonNegative(defaults.paragraphSpacing) ?? null;
+    this.textAlign = ensureEnumValue<TextAlignment>(defaults.textAlign, TextAlignment) || null;
+    this.textNormalization = ensureBoolean(defaults.textNormalization) ?? false;
+    this.wordSpacing = ensureNonNegative(defaults.wordSpacing) || null;
+    this.zoom = ensureValueInRange(defaults.zoom, zoomRangeConfig.range) || 1;
+  }
+}

package/src/webpub/preferences/WebPubPreferences.ts

@@ -0,0 +1,88 @@
+import { ConfigurablePreferences } from "../../preferences/Configurable";
+
+import { 
+  fontWeightRangeConfig, 
+  TextAlignment, 
+  zoomRangeConfig 
+} from "../../preferences/Types";
+
+import {
+  ensureBoolean,
+  ensureEnumValue,
+  ensureNonNegative,
+  ensureString,
+  ensureValueInRange
+} from "../../preferences/guards";
+
+export interface IWebPubPreferences {
+  fontFamily?: string | null,
+  fontWeight?: number | null,
+  hyphens?: boolean | null,
+  letterSpacing?: number | null,
+  ligatures?: boolean | null,
+  lineHeight?: number | null,
+  noRuby?: boolean | null,
+  paragraphIndent?: number | null,
+  paragraphSpacing?: number | null,
+  textAlign?: TextAlignment | null,
+  textNormalization?: boolean | null,
+  wordSpacing?: number | null,
+  zoom?: number | null
+}
+
+export class WebPubPreferences implements ConfigurablePreferences {
+  fontFamily?: string | null;
+  fontWeight?: number | null;
+  hyphens?: boolean | null;
+  letterSpacing?: number | null;
+  ligatures?: boolean | null;
+  lineHeight?: number | null;
+  noRuby?: boolean | null;
+  paragraphIndent?: number | null;
+  paragraphSpacing?: number | null;
+  textAlign?: TextAlignment | null;
+  textNormalization?: boolean | null;
+  wordSpacing?: number | null;
+  zoom?: number | null;
+
+  constructor(preferences: IWebPubPreferences = {}) {
+    this.fontFamily = ensureString(preferences.fontFamily);
+    this.fontWeight = ensureValueInRange(preferences.fontWeight, fontWeightRangeConfig.range);
+    this.hyphens = ensureBoolean(preferences.hyphens);
+    this.letterSpacing = ensureNonNegative(preferences.letterSpacing);
+    this.ligatures = ensureBoolean(preferences.ligatures);
+    this.lineHeight = ensureNonNegative(preferences.lineHeight);
+    this.noRuby = ensureBoolean(preferences.noRuby);
+    this.paragraphIndent = ensureNonNegative(preferences.paragraphIndent);
+    this.paragraphSpacing = ensureNonNegative(preferences.paragraphSpacing);
+    this.textAlign = ensureEnumValue<TextAlignment>(preferences.textAlign, TextAlignment);
+    this.textNormalization = ensureBoolean(preferences.textNormalization);
+    this.wordSpacing = ensureNonNegative(preferences.wordSpacing);
+    this.zoom = ensureValueInRange(preferences.zoom, zoomRangeConfig.range);
+  }
+
+  static serialize(preferences: WebPubPreferences): string {
+    const { ...properties } = preferences;
+    return JSON.stringify(properties);
+  }
+
+  static deserialize(preferences: string): WebPubPreferences | null {
+    try {
+      const parsedPreferences = JSON.parse(preferences);
+      return new WebPubPreferences(parsedPreferences);
+    } catch (error) {
+      console.error("Failed to deserialize preferences:", error);
+      return null;
+    }
+  }
+
+  merging(other: ConfigurablePreferences): ConfigurablePreferences {
+    const merged: IWebPubPreferences = { ...this };
+    for (const key of Object.keys(other) as (keyof IWebPubPreferences)[]) {
+      if (other[key] !== undefined) {
+        merged[key] = other[key];
+      }
+    }
+    return new WebPubPreferences(merged);
+  }
+}

package/src/webpub/preferences/WebPubPreferencesEditor.ts

@@ -0,0 +1,193 @@
+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";
+export class WebPubPreferencesEditor implements IPreferencesEditor {
+  preferences: WebPubPreferences;
+  private settings: WebPubSettings;
+  private metadata: Metadata | null;
+
+  constructor(initialPreferences: WebPubPreferences, settings: WebPubSettings, metadata: Metadata) {
+    this.preferences = initialPreferences;
+    this.settings = settings;
+    this.metadata = metadata;
+  }
+
+  clear() {
+    this.preferences = new WebPubPreferences({});
+  }
+
+  private updatePreference<K extends keyof WebPubPreferences>(key: K, value: WebPubPreferences[K]) {
+    this.preferences[key] = value;
+  }
+
+  get fontFamily(): Preference<string> {
+    return new Preference<string>({
+      initialValue: this.preferences.fontFamily,
+      effectiveValue: this.settings.fontFamily || null,
+      isEffective: this.metadata?.accessibility?.feature?.includes(Feature.DISPLAY_TRANSFORMABILITY) ?? false,
+      onChange: (newValue: string | null | undefined) => {
+        this.updatePreference("fontFamily", newValue || null);
+      }
+    });
+  }
+
+  get fontWeight(): RangePreference<number> {
+    return new RangePreference<number>({
+      initialValue: this.preferences.fontWeight,
+      effectiveValue: this.settings.fontWeight || 400,
+      isEffective: this.metadata?.accessibility?.feature?.includes(Feature.DISPLAY_TRANSFORMABILITY) ?? false,
+      onChange: (newValue: number | null | undefined) => {
+        this.updatePreference("fontWeight", newValue || null);
+      },
+      supportedRange: fontWeightRangeConfig.range,
+      step: fontWeightRangeConfig.step
+    });
+  }
+
+  get hyphens(): BooleanPreference {
+    return new BooleanPreference({
+      initialValue: this.preferences.hyphens,
+      effectiveValue: this.settings.hyphens || false,
+      isEffective: this.metadata?.accessibility?.feature?.includes(Feature.DISPLAY_TRANSFORMABILITY) ?? false,
+      onChange: (newValue: boolean | null | undefined) => {
+        this.updatePreference("hyphens", newValue || null);
+      }
+    });
+  }
+
+  get letterSpacing(): RangePreference<number> {
+    return new RangePreference<number>({
+      initialValue: this.preferences.letterSpacing,
+      effectiveValue: this.settings.letterSpacing || 0,
+      isEffective: this.metadata?.accessibility?.feature?.includes(Feature.DISPLAY_TRANSFORMABILITY) ?? false,
+      onChange: (newValue: number | null | undefined) => {
+        this.updatePreference("letterSpacing", newValue || null);
+      },
+      supportedRange: letterSpacingRangeConfig.range,
+      step: letterSpacingRangeConfig.step
+    });
+  }
+
+  get ligatures(): BooleanPreference {
+    return new BooleanPreference({
+      initialValue: this.preferences.ligatures,
+      effectiveValue: this.settings.ligatures || true,
+      isEffective: this.metadata?.accessibility?.feature?.includes(Feature.DISPLAY_TRANSFORMABILITY) ?? false,
+      onChange: (newValue: boolean | null | undefined) => {
+        this.updatePreference("ligatures", newValue || null);
+      }
+    });
+  }
+
+  get lineHeight(): RangePreference<number> {
+    return new RangePreference<number>({
+      initialValue: this.preferences.lineHeight,
+      effectiveValue: this.settings.lineHeight,
+      isEffective: this.metadata?.accessibility?.feature?.includes(Feature.DISPLAY_TRANSFORMABILITY) ?? false,
+      onChange: (newValue: number | null | undefined) => {
+        this.updatePreference("lineHeight", newValue || null);
+      },
+      supportedRange: lineHeightRangeConfig.range,
+      step: lineHeightRangeConfig.step
+    });
+  }
+
+  get noRuby(): BooleanPreference {
+    return new BooleanPreference({
+      initialValue: this.preferences.noRuby,
+      effectiveValue: this.settings.noRuby || false,
+      isEffective: this.metadata?.accessibility?.feature?.includes(Feature.DISPLAY_TRANSFORMABILITY) ?? false,
+      onChange: (newValue: boolean | null | undefined) => {
+        this.updatePreference("noRuby", newValue || null);
+      }
+    });
+  }
+
+  get paragraphIndent(): RangePreference<number> {
+    return new RangePreference<number>({
+      initialValue: this.preferences.paragraphIndent,
+      effectiveValue: this.settings.paragraphIndent || 0,
+      isEffective: this.metadata?.accessibility?.feature?.includes(Feature.DISPLAY_TRANSFORMABILITY) ?? false,
+      onChange: (newValue: number | null | undefined) => {
+        this.updatePreference("paragraphIndent", newValue || null);
+      },
+      supportedRange: paragraphIndentRangeConfig.range,
+      step: paragraphIndentRangeConfig.step
+    });
+  }
+
+  get paragraphSpacing(): RangePreference<number> {
+    return new RangePreference<number>({
+      initialValue: this.preferences.paragraphSpacing,
+      effectiveValue: this.settings.paragraphSpacing || 0,
+      isEffective: this.metadata?.accessibility?.feature?.includes(Feature.DISPLAY_TRANSFORMABILITY) ?? false,
+      onChange: (newValue: number | null | undefined) => {
+        this.updatePreference("paragraphSpacing", newValue || null);
+      },
+      supportedRange: paragraphSpacingRangeConfig.range,
+      step: paragraphSpacingRangeConfig.step
+    });
+  }
+
+  get textAlign(): EnumPreference<TextAlignment> {
+    return new EnumPreference<TextAlignment>({
+      initialValue: this.preferences.textAlign,
+      effectiveValue: this.settings.textAlign || TextAlignment.start,
+      isEffective: this.metadata?.accessibility?.feature?.includes(Feature.DISPLAY_TRANSFORMABILITY) ?? false,
+      onChange: (newValue: TextAlignment | null | undefined) => {
+        this.updatePreference("textAlign", newValue || null);
+      },
+      supportedValues: Object.values(TextAlignment)
+    });
+  }
+
+  get textNormalization(): BooleanPreference {
+    return new BooleanPreference({
+      initialValue: this.preferences.textNormalization,
+      effectiveValue: this.settings.textNormalization || false,
+      isEffective: this.metadata?.accessibility?.feature?.includes(Feature.DISPLAY_TRANSFORMABILITY) ?? false,
+      onChange: (newValue: boolean | null | undefined) => {
+        this.updatePreference("textNormalization", newValue || null);
+      }
+    });
+  }
+
+  get wordSpacing(): RangePreference<number> {
+    return new RangePreference<number>({
+      initialValue: this.preferences.wordSpacing,
+      effectiveValue: this.settings.wordSpacing || 0,
+      isEffective: this.metadata?.accessibility?.feature?.includes(Feature.DISPLAY_TRANSFORMABILITY) ?? false,
+      onChange: (newValue: number | null | undefined) => {
+        this.updatePreference("wordSpacing", newValue || null);
+      },
+      supportedRange: wordSpacingRangeConfig.range,
+      step: wordSpacingRangeConfig.step
+    });
+  }
+
+  get zoom(): RangePreference<number> {
+    return new RangePreference<number>({
+      initialValue: this.preferences.zoom,
+      effectiveValue: this.settings.zoom || 1,
+      isEffective: CSS.supports("zoom", "1") ?? false,
+      onChange: (newValue: number | null | undefined) => {
+        this.updatePreference("zoom", newValue || null);
+      },
+      supportedRange: zoomRangeConfig.range,
+      step: zoomRangeConfig.step
+    });
+  }
+}

package/src/webpub/preferences/WebPubSettings.ts

@@ -0,0 +1,88 @@
+import { ConfigurableSettings } from "../../preferences/Configurable";
+import { TextAlignment } from "../../preferences/Types";
+import { WebPubDefaults } from "./WebPubDefaults";
+import { WebPubPreferences } from "./WebPubPreferences";
+
+export interface IWebPubSettings {
+  fontFamily?: string | null,
+  fontWeight?: number | null,
+  hyphens?: boolean | null,
+  letterSpacing?: number | null,
+  ligatures?: boolean | null,
+  lineHeight?: number | null,
+  noRuby?: boolean | null,
+  paragraphIndent?: number | null,
+  paragraphSpacing?: number | null,
+  textAlign?: TextAlignment | null,
+  textNormalization?: boolean | null,
+  wordSpacing?: number | null,
+  zoom?: number | null;
+}
+
+export class WebPubSettings implements ConfigurableSettings {
+  fontFamily: string | null;
+  fontWeight: number | null;
+  hyphens: boolean | null;
+  letterSpacing: number | null;
+  ligatures: boolean | null;
+  lineHeight: number | null;
+  noRuby: boolean | null;
+  paragraphIndent: number | null;
+  paragraphSpacing: number | null;
+  textAlign: TextAlignment | null;
+  textNormalization: boolean | null;
+  wordSpacing: number | null;
+  zoom: number | null;
+
+  constructor(preferences: WebPubPreferences, defaults: WebPubDefaults) {
+    this.fontFamily = preferences.fontFamily || defaults.fontFamily || null;
+    this.fontWeight = preferences.fontWeight !== undefined 
+      ? preferences.fontWeight 
+      : defaults.fontWeight !== undefined 
+        ? defaults.fontWeight 
+        : null;
+    this.hyphens = typeof preferences.hyphens === "boolean" 
+      ? preferences.hyphens 
+      : defaults.hyphens ?? null;
+    this.letterSpacing = preferences.letterSpacing !== undefined 
+      ? preferences.letterSpacing 
+      : defaults.letterSpacing !== undefined 
+        ? defaults.letterSpacing 
+        : null;
+    this.ligatures = typeof preferences.ligatures === "boolean"
+      ? preferences.ligatures 
+      : defaults.ligatures ?? null;
+    this.lineHeight = preferences.lineHeight !== undefined 
+      ? preferences.lineHeight 
+      : defaults.lineHeight !== undefined 
+        ? defaults.lineHeight 
+        : null;
+    this.noRuby = typeof preferences.noRuby === "boolean" 
+      ? preferences.noRuby 
+      : defaults.noRuby ?? null;
+    this.paragraphIndent = preferences.paragraphIndent !== undefined 
+      ? preferences.paragraphIndent 
+      : defaults.paragraphIndent !== undefined 
+        ? defaults.paragraphIndent 
+        : null;
+    this.paragraphSpacing = preferences.paragraphSpacing !== undefined 
+      ? preferences.paragraphSpacing 
+      : defaults.paragraphSpacing !== undefined 
+        ? defaults.paragraphSpacing 
+        : null;
+    this.textAlign = preferences.textAlign || defaults.textAlign || null;
+    this.textNormalization = typeof preferences.textNormalization === "boolean" 
+      ? preferences.textNormalization 
+      : defaults.textNormalization ?? null;
+    this.wordSpacing = preferences.wordSpacing !== undefined 
+      ? preferences.wordSpacing 
+      : defaults.wordSpacing !== undefined 
+        ? defaults.wordSpacing 
+        : null;
+    this.zoom = preferences.zoom !== undefined
+      ? preferences.zoom
+      : defaults.zoom !== undefined
+        ? defaults.zoom
+        : null;
+  }
+}

package/src/webpub/preferences/index.ts

@@ -0,0 +1,4 @@
+export * from "./WebPubDefaults";
+export * from "./WebPubPreferencesEditor";
+export * from "./WebPubPreferences";
+export * from "./WebPubSettings";

package/types/src/css/Properties.d.ts

@@ -0,0 +1,20 @@
+export type BodyHyphens = "auto" | "none";
+export type BoxSizing = "content-box" | "border-box";
+export type FontOpticalSizing = "auto" | "none";
+export type FontWidth = "ultra-condensed" | "extra-condensed" | "condensed" | "semi-condensed" | "normal" | "semi-expanded" | "expanded" | "extra-expanded" | "ultra-expanded" | number;
+export type Ligatures = "common-ligatures" | "none";
+export type TypeScale = 1 | 1.067 | 1.125 | 1.2 | 1.25 | 1.333 | 1.414 | 1.5 | 1.618;
+export type View = "paged" | "scroll";
+export declare abstract class Properties {
+    constructor();
+    protected toFlag(name: string): string;
+    protected toUnitless(value: number): string;
+    protected toPercentage(value: number, ratio?: boolean): string;
+    protected toVw(value: number): string;
+    protected toVh(value: number): string;
+    protected toPx(value: number): string;
+    protected toRem(value: number): string;
+    abstract toCSSProperties(): {
+        [key: string]: string;
+    };
+}

package/types/src/css/index.d.ts

@@ -0,0 +1 @@
+export * from "./Properties";