@biela.dev/core 1.5.0 → 1.6.0

package/dist/index.js

@@ -1,20 +1,25 @@
-import { useState, useEffect, useMemo, useRef, useCallback, Component } from 'react';
-import { getDeviceContract, scopeSVGIds, getDeviceMetadata } from '@biela.dev/devices';
+import { useState, useEffect, useMemo, Component, useRef, useCallback } from 'react';
+import { scopeSVGIds, getDeviceMetadata, getDeviceContract, IPHONE_17_PRO_MAX_FRAME, IPhone17ProMaxSVG, IPHONE_17_PRO_FRAME, IPhone17ProSVG, IPHONE_AIR_FRAME, IPhoneAirSVG, IPHONE_16_FRAME, IPhone16SVG, IPHONE_16E_FRAME, IPhone16eSVG, IPHONE_SE_3_FRAME, IPhoneSE3SVG, GALAXY_S25_ULTRA_FRAME, GalaxyS25UltraSVG, GALAXY_S25_FRAME, GalaxyS25SVG, GALAXY_S25_EDGE_FRAME, GalaxyS25EdgeSVG, PIXEL_9_PRO_XL_FRAME, Pixel9ProXLSVG, PIXEL_9_PRO_FRAME, Pixel9ProSVG } from '@biela.dev/devices';
 import { jsxs, jsx, Fragment } from 'react/jsx-runtime';
 
-// src/math/conversions.ts
-function ptsToPx(pts, dpr) {
-  return Math.round(pts * dpr);
-}
-function pxToPts(px, dpr) {
-  return px / dpr;
-}
-function ptsToPercent(pts, total) {
-  if (total === 0) return 0;
-  return pts / total * 100;
-}
-function scaleValue(value, scaleFactor) {
-  return value * scaleFactor;
+// src/components/DeviceFrame.tsx
+function useContainerSize(ref) {
+  const [size, setSize] = useState({ width: 0, height: 0 });
+  useEffect(() => {
+    const el = ref.current;
+    if (!el) return;
+    const observer = new ResizeObserver(([entry]) => {
+      if (!entry) return;
+      const { width, height } = entry.contentRect;
+      setSize((prev) => {
+        if (prev.width === width && prev.height === height) return prev;
+        return { width, height };
+      });
+    });
+    observer.observe(el);
+    return () => observer.disconnect();
+  }, [ref]);
+  return size;
 }
 
 // src/math/scale-engine.ts
@@ -69,24 +74,8 @@ function computeFullScale(deviceWidth, deviceHeight, containerWidth, containerHe
     scalePercent: `${Math.round(scale * 100)}%`
   };
 }
-function useContainerSize(ref) {
-  const [size, setSize] = useState({ width: 0, height: 0 });
-  useEffect(() => {
-    const el = ref.current;
-    if (!el) return;
-    const observer = new ResizeObserver(([entry]) => {
-      if (!entry) return;
-      const { width, height } = entry.contentRect;
-      setSize((prev) => {
-        if (prev.width === width && prev.height === height) return prev;
-        return { width, height };
-      });
-    });
-    observer.observe(el);
-    return () => observer.disconnect();
-  }, [ref]);
-  return size;
-}
+
+// src/hooks/useAdaptiveScale.ts
 function useAdaptiveScale(options) {
   const {
     device,
@@ -107,72 +96,6 @@ function useAdaptiveScale(options) {
     [device.screen.width, device.screen.height, containerWidth, containerHeight, padding, maxScale, minScale, snapToSteps]
   );
 }
-function useDeviceContract(deviceId, orientation = "portrait") {
-  return useMemo(() => {
-    const contract = getDeviceContract(deviceId, orientation);
-    return {
-      contract,
-      cssVariables: contract.cssVariables,
-      contentZone: contract.contentZone[orientation]
-    };
-  }, [deviceId, orientation]);
-}
-var STEPS = 16;
-var STEP_SIZE = 1 / STEPS;
-var HUD_DISPLAY_MS = 1500;
-function useVolumeControl(initialVolume = 1) {
-  const [level, setLevel] = useState(initialVolume);
-  const [muted, setMuted] = useState(false);
-  const [hudVisible, setHudVisible] = useState(false);
-  const hudTimerRef = useRef(null);
-  const showHud = useCallback(() => {
-    setHudVisible(true);
-    if (hudTimerRef.current) clearTimeout(hudTimerRef.current);
-    hudTimerRef.current = setTimeout(() => setHudVisible(false), HUD_DISPLAY_MS);
-  }, []);
-  const volumeUp = useCallback(() => {
-    setLevel((prev) => {
-      const next = Math.min(1, Math.round((prev + STEP_SIZE) * STEPS) / STEPS);
-      return next;
-    });
-    setMuted(false);
-    showHud();
-  }, [showHud]);
-  const volumeDown = useCallback(() => {
-    setLevel((prev) => {
-      const next = Math.max(0, Math.round((prev - STEP_SIZE) * STEPS) / STEPS);
-      return next;
-    });
-    setMuted(false);
-    showHud();
-  }, [showHud]);
-  const toggleMute = useCallback(() => {
-    setMuted((prev) => !prev);
-    showHud();
-  }, [showHud]);
-  const effectiveVolume = muted ? 0 : level;
-  useEffect(() => {
-    const container = document.querySelector(".bielaframe-content");
-    if (!container) return;
-    const mediaEls = container.querySelectorAll("audio, video");
-    mediaEls.forEach((el) => {
-      el.volume = effectiveVolume;
-    });
-  }, [effectiveVolume]);
-  useEffect(() => {
-    return () => {
-      if (hudTimerRef.current) clearTimeout(hudTimerRef.current);
-    };
-  }, []);
-  return { level, muted, hudVisible, volumeUp, volumeDown, toggleMute };
-}
-function useScreenPower() {
-  const [isOff, setIsOff] = useState(false);
-  const toggle = useCallback(() => {
-    setIsOff((prev) => !prev);
-  }, []);
-  return { isOff, toggle };
-}
 var DeviceErrorBoundary = class extends Component {
   constructor(props) {
     super(props);
@@ -557,7 +480,8 @@ function registerCustomDeviceSVG(deviceId, svgString, frame, cropViewBox, screen
   SVG_REGISTRY[deviceId] = { component: CustomSVGComponent, frame };
 }
 function DeviceFrame({
-  device,
+  device: deviceProp,
+  deviceId,
   orientation = "portrait",
   scaleMode = "fit",
   manualScale,
@@ -568,23 +492,28 @@ function DeviceFrame({
   onScaleChange,
   children
 }) {
+  const device = deviceProp ?? deviceId ?? "";
   const sentinelRef = useRef(null);
   const frameOverlayRef = useRef(null);
   const hostRef = useRef(null);
   const scalerRef = useRef(null);
   const { width: containerW, height: containerH } = useContainerSize(sentinelRef);
   const deviceLookup = useMemo(() => {
+    if (!device) {
+      return { meta: null, contract: null, error: "(no device specified)" };
+    }
     try {
-      return {
-        meta: getDeviceMetadata(device),
-        contract: getDeviceContract(device, orientation),
-        error: null
-      };
+      const meta = getDeviceMetadata(device);
+      const contract2 = getDeviceContract(device, orientation);
+      if (!meta || !meta.screen) {
+        return { meta: null, contract: null, error: device };
+      }
+      return { meta, contract: contract2, error: null };
     } catch {
       return { meta: null, contract: null, error: device };
     }
   }, [device, orientation]);
-  if (deviceLookup.error) {
+  if (deviceLookup.error || !deviceLookup.meta || !deviceLookup.contract) {
     return /* @__PURE__ */ jsxs(
       "div",
       {
@@ -601,7 +530,7 @@ function DeviceFrame({
         },
         children: [
           'Device not found: "',
-          deviceLookup.error,
+          deviceLookup.error || "(unknown)",
           '"'
         ]
       }
@@ -783,6 +712,303 @@ function DeviceFrame({
     }
   );
 }
+var SVG_OVERRIDES_KEY = "bielaframe-svg-overrides";
+var CustomSVGStore = class {
+  storage;
+  constructor(storage) {
+    if (storage !== void 0) {
+      this.storage = storage;
+    } else {
+      this.storage = typeof localStorage !== "undefined" ? localStorage : null;
+    }
+  }
+  /** Load all stored overrides */
+  getAll() {
+    if (!this.storage) return {};
+    try {
+      const raw = this.storage.getItem(SVG_OVERRIDES_KEY);
+      if (raw) return JSON.parse(raw);
+    } catch {
+    }
+    return {};
+  }
+  /** Save an override and register it in the SVG registry */
+  save(entry) {
+    const all = this.getAll();
+    all[entry.deviceId] = entry;
+    this.persist(all);
+    this.applyEntry(entry);
+  }
+  /** Remove an override (revert to built-in) */
+  remove(deviceId) {
+    const all = this.getAll();
+    delete all[deviceId];
+    this.persist(all);
+  }
+  /** Check if a device has a custom override */
+  has(deviceId) {
+    return this.getAll()[deviceId] !== void 0;
+  }
+  /** Get a single override by device ID */
+  get(deviceId) {
+    return this.getAll()[deviceId];
+  }
+  /**
+   * Apply all stored overrides to the SVG registry.
+   * Called during auto-registration to restore user customizations.
+   */
+  applyAll() {
+    const all = this.getAll();
+    for (const entry of Object.values(all)) {
+      this.applyEntry(entry);
+    }
+  }
+  applyEntry(entry) {
+    let screenW = 402;
+    let screenH = 874;
+    let screenR = 0;
+    try {
+      const meta = getDeviceMetadata(entry.deviceId);
+      screenW = meta.screen.width;
+      screenH = meta.screen.height;
+      screenR = meta.screen.cornerRadius;
+    } catch {
+      if (entry.screenRect) {
+        screenW = entry.screenRect.width;
+        screenH = entry.screenRect.height;
+      }
+    }
+    const frame = {
+      bezelTop: entry.bezelTop,
+      bezelBottom: entry.bezelBottom,
+      bezelLeft: entry.bezelLeft,
+      bezelRight: entry.bezelRight,
+      totalWidth: entry.bezelLeft + entry.bezelRight + screenW,
+      totalHeight: entry.bezelTop + entry.bezelBottom + screenH,
+      screenWidth: screenW,
+      screenHeight: screenH,
+      screenRadius: screenR
+    };
+    try {
+      registerCustomDeviceSVG(
+        entry.deviceId,
+        entry.svgString,
+        frame,
+        void 0,
+        entry.screenRect
+      );
+    } catch {
+    }
+  }
+  persist(all) {
+    if (!this.storage) return;
+    const json = JSON.stringify(all);
+    try {
+      this.storage.setItem(SVG_OVERRIDES_KEY, json);
+    } catch {
+    }
+  }
+};
+var _store = null;
+function getCustomSVGStore() {
+  if (!_store) {
+    _store = new CustomSVGStore();
+  }
+  return _store;
+}
+
+// src/registration.ts
+registerDeviceSVG("iphone-17-pro-max", IPhone17ProMaxSVG, IPHONE_17_PRO_MAX_FRAME);
+registerDeviceSVG("iphone-17-pro", IPhone17ProSVG, IPHONE_17_PRO_FRAME);
+registerDeviceSVG("iphone-air", IPhoneAirSVG, IPHONE_AIR_FRAME);
+registerDeviceSVG("iphone-16", IPhone16SVG, IPHONE_16_FRAME);
+registerDeviceSVG("iphone-16e", IPhone16eSVG, IPHONE_16E_FRAME);
+registerDeviceSVG("iphone-se-3", IPhoneSE3SVG, IPHONE_SE_3_FRAME);
+registerDeviceSVG("galaxy-s25-ultra", GalaxyS25UltraSVG, GALAXY_S25_ULTRA_FRAME);
+registerDeviceSVG("galaxy-s25", GalaxyS25SVG, GALAXY_S25_FRAME);
+registerDeviceSVG("galaxy-s25-edge", GalaxyS25EdgeSVG, GALAXY_S25_EDGE_FRAME);
+registerDeviceSVG("pixel-9-pro-xl", Pixel9ProXLSVG, PIXEL_9_PRO_XL_FRAME);
+registerDeviceSVG("pixel-9-pro", Pixel9ProSVG, PIXEL_9_PRO_FRAME);
+getCustomSVGStore().applyAll();
+
+// src/math/conversions.ts
+function ptsToPx(pts, dpr) {
+  return Math.round(pts * dpr);
+}
+function pxToPts(px, dpr) {
+  return px / dpr;
+}
+function ptsToPercent(pts, total) {
+  if (total === 0) return 0;
+  return pts / total * 100;
+}
+function scaleValue(value, scaleFactor) {
+  return value * scaleFactor;
+}
+function useDeviceContract(deviceId, orientation = "portrait") {
+  return useMemo(() => {
+    const contract = getDeviceContract(deviceId, orientation);
+    return {
+      contract,
+      cssVariables: contract.cssVariables,
+      contentZone: contract.contentZone[orientation]
+    };
+  }, [deviceId, orientation]);
+}
+var STEPS = 16;
+var STEP_SIZE = 1 / STEPS;
+var HUD_DISPLAY_MS = 1500;
+function useVolumeControl(initialVolume = 1) {
+  const [level, setLevel] = useState(initialVolume);
+  const [muted, setMuted] = useState(false);
+  const [hudVisible, setHudVisible] = useState(false);
+  const hudTimerRef = useRef(null);
+  const showHud = useCallback(() => {
+    setHudVisible(true);
+    if (hudTimerRef.current) clearTimeout(hudTimerRef.current);
+    hudTimerRef.current = setTimeout(() => setHudVisible(false), HUD_DISPLAY_MS);
+  }, []);
+  const volumeUp = useCallback(() => {
+    setLevel((prev) => {
+      const next = Math.min(1, Math.round((prev + STEP_SIZE) * STEPS) / STEPS);
+      return next;
+    });
+    setMuted(false);
+    showHud();
+  }, [showHud]);
+  const volumeDown = useCallback(() => {
+    setLevel((prev) => {
+      const next = Math.max(0, Math.round((prev - STEP_SIZE) * STEPS) / STEPS);
+      return next;
+    });
+    setMuted(false);
+    showHud();
+  }, [showHud]);
+  const toggleMute = useCallback(() => {
+    setMuted((prev) => !prev);
+    showHud();
+  }, [showHud]);
+  const effectiveVolume = muted ? 0 : level;
+  useEffect(() => {
+    const container = document.querySelector(".bielaframe-content");
+    if (!container) return;
+    const mediaEls = container.querySelectorAll("audio, video");
+    mediaEls.forEach((el) => {
+      el.volume = effectiveVolume;
+    });
+  }, [effectiveVolume]);
+  useEffect(() => {
+    return () => {
+      if (hudTimerRef.current) clearTimeout(hudTimerRef.current);
+    };
+  }, []);
+  return { level, muted, hudVisible, volumeUp, volumeDown, toggleMute };
+}
+function useScreenPower() {
+  const [isOff, setIsOff] = useState(false);
+  const toggle = useCallback(() => {
+    setIsOff((prev) => !prev);
+  }, []);
+  return { isOff, toggle };
+}
+function useOrientation(initial = "portrait") {
+  const [orientation, setOrientation] = useState(initial);
+  const toggle = useCallback(
+    () => setOrientation((o) => o === "portrait" ? "landscape" : "portrait"),
+    []
+  );
+  return {
+    orientation,
+    isLandscape: orientation === "landscape",
+    toggle,
+    setOrientation
+  };
+}
+function DeviceCompare({
+  deviceA,
+  deviceB,
+  orientation = "portrait",
+  colorScheme = "dark",
+  showSafeAreaOverlay = false,
+  showScaleBar = false,
+  layout = "auto",
+  gap = 24,
+  children,
+  childrenA,
+  childrenB,
+  onContractReadyA,
+  onContractReadyB
+}) {
+  const isLandscape = orientation === "landscape";
+  const effectiveLayout = layout === "auto" ? isLandscape ? "vertical" : "horizontal" : layout;
+  const flexDirection = effectiveLayout === "horizontal" ? "row" : "column";
+  return /* @__PURE__ */ jsxs(
+    "div",
+    {
+      className: "bielaframe-compare",
+      style: {
+        width: "100%",
+        height: "100%",
+        display: "flex",
+        flexDirection,
+        alignItems: "center",
+        justifyContent: "center",
+        gap,
+        overflow: "hidden"
+      },
+      children: [
+        /* @__PURE__ */ jsx(
+          "div",
+          {
+            style: {
+              flex: 1,
+              width: effectiveLayout === "horizontal" ? 0 : "100%",
+              height: effectiveLayout === "vertical" ? 0 : "100%",
+              minWidth: 0,
+              minHeight: 0
+            },
+            children: /* @__PURE__ */ jsx(
+              DeviceFrame,
+              {
+                device: deviceA,
+                orientation,
+                colorScheme,
+                showSafeAreaOverlay,
+                showScaleBar,
+                onContractReady: onContractReadyA,
+                children: childrenA ?? children
+              }
+            )
+          }
+        ),
+        /* @__PURE__ */ jsx(
+          "div",
+          {
+            style: {
+              flex: 1,
+              width: effectiveLayout === "horizontal" ? 0 : "100%",
+              height: effectiveLayout === "vertical" ? 0 : "100%",
+              minWidth: 0,
+              minHeight: 0
+            },
+            children: /* @__PURE__ */ jsx(
+              DeviceFrame,
+              {
+                device: deviceB,
+                orientation,
+                colorScheme,
+                showSafeAreaOverlay,
+                showScaleBar,
+                onContractReady: onContractReadyB,
+                children: childrenB ?? children
+              }
+            )
+          }
+        )
+      ]
+    }
+  );
+}
 function SafeAreaView({ edges, children, style }) {
   const allEdges = !edges || edges.length === 0;
   const padding = {
@@ -1170,6 +1396,6 @@ var styles = {
   }
 };
 
-export { DeviceErrorBoundary, DeviceFrame, DynamicStatusBar, HardwareButtons, SCALE_STEPS, SafeAreaOverlay, SafeAreaView, ScaleBar, StatusBarIndicators, VolumeHUD, computeAdaptiveScale, computeFullScale, computeHostSize, ptsToPercent, ptsToPx, pxToPts, registerCustomDeviceSVG, registerDeviceSVG, scaleValue, snapToStep, useAdaptiveScale, useContainerSize, useDeviceContract, useScreenPower, useVolumeControl };
+export { CustomSVGStore, DeviceCompare, DeviceErrorBoundary, DeviceFrame, DynamicStatusBar, HardwareButtons, SCALE_STEPS, SafeAreaOverlay, SafeAreaView, ScaleBar, StatusBarIndicators, VolumeHUD, computeAdaptiveScale, computeFullScale, computeHostSize, getCustomSVGStore, ptsToPercent, ptsToPx, pxToPts, registerCustomDeviceSVG, registerDeviceSVG, scaleValue, snapToStep, useAdaptiveScale, useContainerSize, useDeviceContract, useOrientation, useScreenPower, useVolumeControl };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map