@mmtitanl/tablets 0.1.1

package/dist/index.d.ts

@@ -0,0 +1,383 @@
+import { D as DeviceMeta, a as DeviceLayoutData, b as DeviceLayoutContract, S as SafeAreaInsets, c as DeviceCSSVariables, C as ContentRect, R as RegisteredDevice, H as HardwareOverlayType, O as OverlayRect, d as DeviceFrameInfo, e as SVGScreenRect } from './contract-types-Ch_kM--q.js';
+export { f as SVGCropRect } from './contract-types-Ch_kM--q.js';
+export { IPAD_PRO_13_FRAME, IPAD_PRO_13_LAYOUT, IPAD_PRO_13_META, IPAD_PRO_13_SCREEN_RECT, IPadPro13SVG } from './ios/index.js';
+import * as react from 'react';
+import { CSSProperties } from 'react';
+export { GALAXY_TAB_S10_FRAME, GALAXY_TAB_S10_LAYOUT, GALAXY_TAB_S10_META, GALAXY_TAB_S10_SCREEN_RECT, GalaxyTabS10SVG } from './android/index.js';
+
+declare function deriveContentZone(screenWidth: number, screenHeight: number, safeArea: SafeAreaInsets): ContentRect;
+declare function buildCSSVariables(screen: DeviceMeta["screen"], safeArea: SafeAreaInsets, statusBar: DeviceLayoutContract["statusBar"], homeIndicator: DeviceLayoutContract["homeIndicator"], hardwareOverlays: DeviceLayoutContract["hardwareOverlays"]): DeviceCSSVariables;
+declare function buildAIPromptConstraints(contract: Omit<DeviceLayoutContract, "aiPromptConstraints">): string;
+declare const BUILTIN_DEVICES: Record<string, DeviceMeta>;
+declare const DEVICE_LAYOUTS: Record<string, DeviceLayoutData>;
+declare function getDeviceMetadata(deviceId: string): DeviceMeta;
+declare function getAllDeviceIds(): string[];
+declare function getDeviceContract(deviceId: string, orientation?: "portrait" | "landscape"): DeviceLayoutContract;
+
+declare class DeviceRegistry {
+    private devices;
+    private storage;
+    constructor(storage?: Storage | null);
+    register(device: RegisteredDevice): void;
+    get(deviceId: string): RegisteredDevice | undefined;
+    getMeta(deviceId: string): DeviceMeta | undefined;
+    getContract(deviceId: string): DeviceLayoutContract | undefined;
+    list(): RegisteredDevice[];
+    listIds(): string[];
+    has(deviceId: string): boolean;
+    remove(deviceId: string): boolean;
+    clear(): void;
+    get size(): number;
+    exportAll(): string;
+    importAll(json: string): {
+        imported: number;
+        skipped: string[];
+    };
+    importAllOverwrite(json: string): number;
+    private load;
+    private save;
+}
+declare function getDeviceRegistry(): DeviceRegistry;
+declare function resetDeviceRegistry(): void;
+
+interface SVGNativeDimensions {
+    width: number;
+    height: number;
+    hasViewBox: boolean;
+    source: "viewBox" | "widthHeight" | "fallback";
+}
+declare function parseSVGNativeDimensions(svgString: string): SVGNativeDimensions;
+
+interface NormalizationResult {
+    normalizedSVG: string;
+    scaleFactors: {
+        x: number;
+        y: number;
+    };
+    aspectRatioWarning: string | null;
+    wasAlreadyNormalized: boolean;
+    nativeDimensions: {
+        width: number;
+        height: number;
+    };
+}
+declare function normalizeSVGToLogicalPoints(svgString: string, targetWidth: number, targetHeight: number): NormalizationResult;
+
+interface ParsedZone {
+    zone: string;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+declare function extractZones(svgString: string): ParsedZone[];
+interface ParseSVGContractOptions {
+    meta: DeviceMeta;
+    overlayType?: HardwareOverlayType;
+    overlayShape?: OverlayRect["shape"];
+    statusBarStyle?: DeviceLayoutContract["statusBar"]["style"];
+    homeIndicatorType?: DeviceLayoutContract["homeIndicator"]["type"];
+}
+declare function parseSVGToContract(normalizedSVG: string, options: ParseSVGContractOptions): DeviceLayoutContract;
+
+interface ValidationResult {
+    passed: boolean;
+    warnings: string[];
+    errors: string[];
+}
+declare function validateNormalizedSVG(result: NormalizationResult, targetWidth: number, targetHeight: number): ValidationResult;
+
+declare function scopeSVGIds(svgString: string, deviceId: string): string;
+
+type ZoneType = "screen-area" | "hardware-overlay" | "safe-area-top" | "safe-area-bottom" | "safe-area-left" | "safe-area-right" | "status-bar" | "home-indicator" | "hardware-button";
+interface DetectedZone {
+    id: string;
+    type: ZoneType;
+    sourceLabel: string;
+    matchedKeyword: string;
+    confidence: "high" | "medium";
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    rx?: number;
+}
+interface RectInfo {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    rx: number;
+    fill: string | null;
+    id: string | null;
+}
+interface SVGAnalysis {
+    zones: DetectedZone[];
+    phoneBody: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+        rx: number;
+    } | null;
+    sideButtons: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }[];
+    allRects: RectInfo[];
+}
+declare function autoDetectZones(svgString: string): DetectedZone[];
+declare function analyzeSVGGeometry(svgString: string): SVGAnalysis;
+interface ClassifiedButton {
+    type: "volume-up" | "volume-down" | "power" | "action" | "camera";
+    side: "left" | "right";
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+declare function classifySideButtons(sideButtons: {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}[], phoneBody: {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+} | null): ClassifiedButton[];
+declare function listSVGLayerNames(svgString: string): {
+    tag: string;
+    name: string;
+}[];
+
+/**
+ * iPad Pro 11" (M4, 2024)
+ * Screen: 834×1194pt @ 2x (physical 1668×2388)
+ * Display: 11" Ultra Retina XDR OLED Tandem, 264 PPI
+ * Hardware: TrueDepth camera (landscape edge), Dynamic Island, no home button
+ */
+declare const IPAD_PRO_11_META: DeviceMeta;
+declare const IPAD_PRO_11_LAYOUT: DeviceLayoutData;
+interface DeviceSVGProps$i {
+    colorScheme?: "light" | "dark";
+    style?: CSSProperties;
+}
+declare function IPadPro11SVG({ colorScheme, style }: DeviceSVGProps$i): react.JSX.Element;
+declare const IPAD_PRO_11_FRAME: DeviceFrameInfo;
+declare const IPAD_PRO_11_SCREEN_RECT: SVGScreenRect;
+
+/**
+ * iPad Air 13" (M3, 2024)
+ * Screen: 1024×1366pt @ 2x (physical 2048×2732)
+ * Display: 13" Liquid Retina IPS, 264 PPI
+ * Hardware: Front camera (landscape edge), no notch, no home button, Touch ID in top button
+ */
+declare const IPAD_AIR_13_META: DeviceMeta;
+declare const IPAD_AIR_13_LAYOUT: DeviceLayoutData;
+interface DeviceSVGProps$h {
+    colorScheme?: "light" | "dark";
+    style?: CSSProperties;
+}
+declare function IPadAir13SVG({ colorScheme, style }: DeviceSVGProps$h): react.JSX.Element;
+declare const IPAD_AIR_13_FRAME: DeviceFrameInfo;
+declare const IPAD_AIR_13_SCREEN_RECT: SVGScreenRect;
+
+/**
+ * iPad Air 11" (M3, 2024)
+ * Screen: 820×1180pt @ 2x (physical 1640×2360)
+ * Display: 11" Liquid Retina IPS, 264 PPI
+ * Hardware: Front camera (landscape edge), no notch, no home button, Touch ID in top button
+ */
+declare const IPAD_AIR_11_META: DeviceMeta;
+declare const IPAD_AIR_11_LAYOUT: DeviceLayoutData;
+interface DeviceSVGProps$g {
+    colorScheme?: "light" | "dark";
+    style?: CSSProperties;
+}
+declare function IPadAir11SVG({ colorScheme, style }: DeviceSVGProps$g): react.JSX.Element;
+declare const IPAD_AIR_11_FRAME: DeviceFrameInfo;
+declare const IPAD_AIR_11_SCREEN_RECT: SVGScreenRect;
+
+/**
+ * iPad mini 7 (A17 Pro, 2024)
+ * Screen: 744×1133pt @ 2x (physical 1488×2266)
+ * Display: 8.3" Liquid Retina IPS, 326 PPI
+ * Hardware: Front camera (landscape edge), no notch, no home button, Touch ID in top button
+ */
+declare const IPAD_MINI_7_META: DeviceMeta;
+declare const IPAD_MINI_7_LAYOUT: DeviceLayoutData;
+interface DeviceSVGProps$f {
+    colorScheme?: "light" | "dark";
+    style?: CSSProperties;
+}
+declare function IPadMini7SVG({ colorScheme, style }: DeviceSVGProps$f): react.JSX.Element;
+declare const IPAD_MINI_7_FRAME: DeviceFrameInfo;
+declare const IPAD_MINI_7_SCREEN_RECT: SVGScreenRect;
+
+/**
+ * Galaxy Tab S10 Ultra (2024)
+ * Screen: 924×1480dp @ 2x (physical 1848×2960)
+ * Display: 14.6" Dynamic AMOLED 2X, 240 PPI
+ * Hardware: Punch-hole front camera in landscape top bezel, no home button
+ * Note: S Pen included, large productivity-focused tablet
+ */
+declare const GALAXY_TAB_S10_ULTRA_META: DeviceMeta;
+declare const GALAXY_TAB_S10_ULTRA_LAYOUT: DeviceLayoutData;
+interface DeviceSVGProps$e {
+    colorScheme?: "light" | "dark";
+    style?: CSSProperties;
+}
+declare function GalaxyTabS10UltraSVG({ colorScheme, style }: DeviceSVGProps$e): react.JSX.Element;
+declare const GALAXY_TAB_S10_ULTRA_FRAME: DeviceFrameInfo;
+declare const GALAXY_TAB_S10_ULTRA_SCREEN_RECT: SVGScreenRect;
+
+/**
+ * Galaxy Tab S10 FE (Fan Edition, 2024)
+ * Screen: 960×1536dp @ 1.5x (physical 1440×2304)
+ * Display: 10.9" TFT LCD, 240 PPI
+ * Hardware: Front camera in portrait top bezel, no home button, side-mounted fingerprint
+ */
+declare const GALAXY_TAB_S10_FE_META: DeviceMeta;
+declare const GALAXY_TAB_S10_FE_LAYOUT: DeviceLayoutData;
+interface DeviceSVGProps$d {
+    colorScheme?: "light" | "dark";
+    style?: CSSProperties;
+}
+declare function GalaxyTabS10FeSVG({ colorScheme, style }: DeviceSVGProps$d): react.JSX.Element;
+declare const GALAXY_TAB_S10_FE_FRAME: DeviceFrameInfo;
+declare const GALAXY_TAB_S10_FE_SCREEN_RECT: SVGScreenRect;
+
+interface DeviceSVGProps$c {
+    colorScheme?: "light" | "dark";
+    style?: CSSProperties;
+}
+declare const IPHONE_17_PRO_MAX_META: DeviceMeta;
+declare const IPHONE_17_PRO_MAX_LAYOUT: DeviceLayoutData;
+declare function IPhone17ProMaxSVG({ style }: DeviceSVGProps$c): react.JSX.Element;
+declare const IPHONE_17_PRO_MAX_FRAME: DeviceFrameInfo;
+declare const IPHONE_17_PRO_MAX_SCREEN_RECT: SVGScreenRect;
+
+interface DeviceSVGProps$b {
+    colorScheme?: "light" | "dark";
+    style?: CSSProperties;
+}
+declare const IPHONE_17_PRO_META: DeviceMeta;
+declare const IPHONE_17_PRO_LAYOUT: DeviceLayoutData;
+declare function IPhone17ProSVG({ style }: DeviceSVGProps$b): react.JSX.Element;
+declare const IPHONE_17_PRO_FRAME: DeviceFrameInfo;
+declare const IPHONE_17_PRO_SCREEN_RECT: SVGScreenRect;
+
+interface DeviceSVGProps$a {
+    colorScheme?: "light" | "dark";
+    style?: CSSProperties;
+}
+declare const IPHONE_AIR_META: DeviceMeta;
+declare const IPHONE_AIR_LAYOUT: DeviceLayoutData;
+declare function IPhoneAirSVG({ style }: DeviceSVGProps$a): react.JSX.Element;
+declare const IPHONE_AIR_FRAME: DeviceFrameInfo;
+declare const IPHONE_AIR_SCREEN_RECT: SVGScreenRect;
+
+interface DeviceSVGProps$9 {
+    colorScheme?: "light" | "dark";
+    style?: CSSProperties;
+}
+declare const IPHONE_16_META: DeviceMeta;
+declare const IPHONE_16_LAYOUT: DeviceLayoutData;
+declare function IPhone16SVG({ style }: DeviceSVGProps$9): react.JSX.Element;
+declare const IPHONE_16_FRAME: DeviceFrameInfo;
+declare const IPHONE_16_SCREEN_RECT: SVGScreenRect;
+
+interface DeviceSVGProps$8 {
+    colorScheme?: "light" | "dark";
+    style?: CSSProperties;
+}
+declare const IPHONE_16E_META: DeviceMeta;
+declare const IPHONE_16E_LAYOUT: DeviceLayoutData;
+declare function IPhone16eSVG({ style }: DeviceSVGProps$8): react.JSX.Element;
+declare const IPHONE_16E_FRAME: DeviceFrameInfo;
+declare const IPHONE_16E_SCREEN_RECT: SVGScreenRect;
+
+interface DeviceSVGProps$7 {
+    colorScheme?: "light" | "dark";
+    style?: CSSProperties;
+}
+declare const IPHONE_SE_3_META: DeviceMeta;
+declare const IPHONE_SE_3_LAYOUT: DeviceLayoutData;
+declare function IPhoneSE3SVG({ style }: DeviceSVGProps$7): react.JSX.Element;
+declare const IPHONE_SE_3_FRAME: DeviceFrameInfo;
+declare const IPHONE_SE_3_SCREEN_RECT: SVGScreenRect;
+
+interface DeviceSVGProps$6 {
+    colorScheme?: "light" | "dark";
+    style?: CSSProperties;
+}
+declare const GALAXY_S25_META: DeviceMeta;
+declare const GALAXY_S25_LAYOUT: DeviceLayoutData;
+declare function GalaxyS25SVG({ style }: DeviceSVGProps$6): react.JSX.Element;
+declare const GALAXY_S25_FRAME: DeviceFrameInfo;
+declare const GALAXY_S25_SCREEN_RECT: SVGScreenRect;
+
+interface DeviceSVGProps$5 {
+    colorScheme?: "light" | "dark";
+    style?: CSSProperties;
+}
+declare const GALAXY_S25_EDGE_META: DeviceMeta;
+declare const GALAXY_S25_EDGE_LAYOUT: DeviceLayoutData;
+declare function GalaxyS25EdgeSVG({ colorScheme, style }: DeviceSVGProps$5): react.ReactElement<any, string | react.JSXElementConstructor<any>>;
+declare const GALAXY_S25_EDGE_FRAME: DeviceFrameInfo;
+
+interface DeviceSVGProps$4 {
+    colorScheme?: "light" | "dark";
+    style?: CSSProperties;
+}
+declare const GALAXY_S25_ULTRA_META: DeviceMeta;
+declare const GALAXY_S25_ULTRA_LAYOUT: DeviceLayoutData;
+declare function GalaxyS25UltraSVG({ style }: DeviceSVGProps$4): react.JSX.Element;
+declare const GALAXY_S25_ULTRA_FRAME: DeviceFrameInfo;
+declare const GALAXY_S25_ULTRA_SCREEN_RECT: SVGScreenRect;
+
+interface DeviceSVGProps$3 {
+    colorScheme?: "light" | "dark";
+    style?: CSSProperties;
+}
+declare const PIXEL_9_PRO_META: DeviceMeta;
+declare const PIXEL_9_PRO_LAYOUT: DeviceLayoutData;
+declare function Pixel9ProSVG({ style }: DeviceSVGProps$3): react.JSX.Element;
+declare const PIXEL_9_PRO_FRAME: DeviceFrameInfo;
+declare const PIXEL_9_PRO_SCREEN_RECT: SVGScreenRect;
+
+interface DeviceSVGProps$2 {
+    colorScheme?: "light" | "dark";
+    style?: CSSProperties;
+}
+declare const PIXEL_9_PRO_XL_META: DeviceMeta;
+declare const PIXEL_9_PRO_XL_LAYOUT: DeviceLayoutData;
+declare function Pixel9ProXLSVG({ style }: DeviceSVGProps$2): react.JSX.Element;
+declare const PIXEL_9_PRO_XL_FRAME: DeviceFrameInfo;
+declare const PIXEL_9_PRO_XL_SCREEN_RECT: SVGScreenRect;
+
+interface DeviceSVGProps$1 {
+    colorScheme?: "light" | "dark";
+    style?: CSSProperties;
+}
+declare const GALAXY_Z_FOLD_7_META: DeviceMeta;
+declare const GALAXY_Z_FOLD_7_LAYOUT: DeviceLayoutData;
+declare function GalaxyZFold7SVG({ style }: DeviceSVGProps$1): react.JSX.Element;
+declare const GALAXY_Z_FOLD_7_FRAME: DeviceFrameInfo;
+declare const GALAXY_Z_FOLD_7_SCREEN_RECT: SVGScreenRect;
+
+interface DeviceSVGProps {
+    colorScheme?: "light" | "dark";
+    style?: CSSProperties;
+}
+declare const GALAXY_Z_FOLD_7_OPEN_META: DeviceMeta;
+declare const GALAXY_Z_FOLD_7_OPEN_LAYOUT: DeviceLayoutData;
+declare function GalaxyZFold7OpenSVG({ style }: DeviceSVGProps): react.JSX.Element;
+declare const GALAXY_Z_FOLD_7_OPEN_FRAME: DeviceFrameInfo;
+declare const GALAXY_Z_FOLD_7_OPEN_SCREEN_RECT: SVGScreenRect;
+
+export { BUILTIN_DEVICES, type ClassifiedButton, ContentRect, DEVICE_LAYOUTS, type DetectedZone, DeviceCSSVariables, DeviceFrameInfo, DeviceLayoutContract, DeviceLayoutData, DeviceMeta, DeviceRegistry, GALAXY_S25_EDGE_FRAME, GALAXY_S25_EDGE_LAYOUT, GALAXY_S25_EDGE_META, GALAXY_S25_FRAME, GALAXY_S25_LAYOUT, GALAXY_S25_META, GALAXY_S25_SCREEN_RECT, GALAXY_S25_ULTRA_FRAME, GALAXY_S25_ULTRA_LAYOUT, GALAXY_S25_ULTRA_META, GALAXY_S25_ULTRA_SCREEN_RECT, GALAXY_TAB_S10_FE_FRAME, GALAXY_TAB_S10_FE_LAYOUT, GALAXY_TAB_S10_FE_META, GALAXY_TAB_S10_FE_SCREEN_RECT, GALAXY_TAB_S10_ULTRA_FRAME, GALAXY_TAB_S10_ULTRA_LAYOUT, GALAXY_TAB_S10_ULTRA_META, GALAXY_TAB_S10_ULTRA_SCREEN_RECT, GALAXY_Z_FOLD_7_FRAME, GALAXY_Z_FOLD_7_LAYOUT, GALAXY_Z_FOLD_7_META, GALAXY_Z_FOLD_7_OPEN_FRAME, GALAXY_Z_FOLD_7_OPEN_LAYOUT, GALAXY_Z_FOLD_7_OPEN_META, GALAXY_Z_FOLD_7_OPEN_SCREEN_RECT, GALAXY_Z_FOLD_7_SCREEN_RECT, GalaxyS25EdgeSVG, GalaxyS25SVG, GalaxyS25UltraSVG, GalaxyTabS10FeSVG, GalaxyTabS10UltraSVG, GalaxyZFold7OpenSVG, GalaxyZFold7SVG, HardwareOverlayType, IPAD_AIR_11_FRAME, IPAD_AIR_11_LAYOUT, IPAD_AIR_11_META, IPAD_AIR_11_SCREEN_RECT, IPAD_AIR_13_FRAME, IPAD_AIR_13_LAYOUT, IPAD_AIR_13_META, IPAD_AIR_13_SCREEN_RECT, IPAD_MINI_7_FRAME, IPAD_MINI_7_LAYOUT, IPAD_MINI_7_META, IPAD_MINI_7_SCREEN_RECT, IPAD_PRO_11_FRAME, IPAD_PRO_11_LAYOUT, IPAD_PRO_11_META, IPAD_PRO_11_SCREEN_RECT, IPHONE_16E_FRAME, IPHONE_16E_LAYOUT, IPHONE_16E_META, IPHONE_16E_SCREEN_RECT, IPHONE_16_FRAME, IPHONE_16_LAYOUT, IPHONE_16_META, IPHONE_16_SCREEN_RECT, IPHONE_17_PRO_FRAME, IPHONE_17_PRO_LAYOUT, IPHONE_17_PRO_MAX_FRAME, IPHONE_17_PRO_MAX_LAYOUT, IPHONE_17_PRO_MAX_META, IPHONE_17_PRO_MAX_SCREEN_RECT, IPHONE_17_PRO_META, IPHONE_17_PRO_SCREEN_RECT, IPHONE_AIR_FRAME, IPHONE_AIR_LAYOUT, IPHONE_AIR_META, IPHONE_AIR_SCREEN_RECT, IPHONE_SE_3_FRAME, IPHONE_SE_3_LAYOUT, IPHONE_SE_3_META, IPHONE_SE_3_SCREEN_RECT, IPadAir11SVG, IPadAir13SVG, IPadMini7SVG, IPadPro11SVG, IPhone16SVG, IPhone16eSVG, IPhone17ProMaxSVG, IPhone17ProSVG, IPhoneAirSVG, IPhoneSE3SVG, type NormalizationResult, OverlayRect, PIXEL_9_PRO_FRAME, PIXEL_9_PRO_LAYOUT, PIXEL_9_PRO_META, PIXEL_9_PRO_SCREEN_RECT, PIXEL_9_PRO_XL_FRAME, PIXEL_9_PRO_XL_LAYOUT, PIXEL_9_PRO_XL_META, PIXEL_9_PRO_XL_SCREEN_RECT, type ParseSVGContractOptions, type ParsedZone, Pixel9ProSVG, Pixel9ProXLSVG, RegisteredDevice, type SVGAnalysis, type SVGNativeDimensions, SVGScreenRect, SafeAreaInsets, type ValidationResult, type ZoneType, analyzeSVGGeometry, autoDetectZones, buildAIPromptConstraints, buildCSSVariables, classifySideButtons, deriveContentZone, extractZones, getAllDeviceIds, getDeviceContract, getDeviceMetadata, getDeviceRegistry, listSVGLayerNames, normalizeSVGToLogicalPoints, parseSVGNativeDimensions, parseSVGToContract, resetDeviceRegistry, scopeSVGIds, validateNormalizedSVG };