1 files changed, 106 insertions, 0 deletions
diff --git a/shared_config.py b/shared_config.py
new file mode 100644
index 0000000..46bfc84
--- /dev/null
+++ b/shared_config.py
@@ -0,0 +1,106 @@
+"""
+Shared configuration schema constants.
+
+This file contains the canonical configuration schema that should be used
+by both Python and TypeScript code. Any changes to the configuration
+structure should be made here first.
+"""
+
+from typing import Dict, Any, Union
+from enum import Enum
+
+
+class ConfigFieldType(str, Enum):
+    """Configuration field types - must match TypeScript enum"""
+    BOOLEAN = "boolean"
+    INTEGER = "integer"
+    FLOAT = "float"
+    STRING = "string"
+
+
+# Canonical configuration schema - source of truth
+CONFIG_SCHEMA_DEF = {
+    "dll": {
+        "name": "dll",
+        "fieldType": ConfigFieldType.STRING,
+        "default": "/games/Lossless Scaling/Lossless.dll",
+        "description": "specify where Lossless.dll is stored"
+    },
+    
+    "multiplier": {
+        "name": "multiplier",
+        "fieldType": ConfigFieldType.INTEGER,
+        "default": 1,
+        "description": "change the fps multiplier"
+    },
+    
+    "flow_scale": {
+        "name": "flow_scale",
+        "fieldType": ConfigFieldType.FLOAT,
+        "default": 0.8,
+        "description": "change the flow scale"
+    },
+    
+    "performance_mode": {
+        "name": "performance_mode",
+        "fieldType": ConfigFieldType.BOOLEAN,
+        "default": True,
+        "description": "use a lighter model for FG (recommended for most games)"
+    },
+    
+    "hdr_mode": {
+        "name": "hdr_mode",
+        "fieldType": ConfigFieldType.BOOLEAN,
+        "default": False,
+        "description": "enable HDR mode (only for games that support HDR)"
+    },
+    
+    "experimental_present_mode": {
+        "name": "experimental_present_mode",
+        "fieldType": ConfigFieldType.STRING,
+        "default": "fifo",
+        "description": "override Vulkan present mode (may cause crashes)"
+    },
+    
+    "dxvk_frame_rate": {
+        "name": "dxvk_frame_rate",
+        "fieldType": ConfigFieldType.INTEGER,
+        "default": 0,
+        "description": "base framerate cap for DirectX games before frame multiplier"
+    },
+    
+    "enable_wow64": {
+        "name": "enable_wow64",
+        "fieldType": ConfigFieldType.BOOLEAN,
+        "default": False,
+        "description": "enable PROTON_USE_WOW64=1 for 32-bit games (use with ProtonGE to fix crashing)"
+    },
+    
+    "disable_steamdeck_mode": {
+        "name": "disable_steamdeck_mode",
+        "fieldType": ConfigFieldType.BOOLEAN,
+        "default": False,
+        "description": "disable Steam Deck mode (unlocks hidden settings in some games)"
+    }
+}
+
+
+def get_field_names() -> list[str]:
+    """Get ordered list of configuration field names"""
+    return list(CONFIG_SCHEMA_DEF.keys())
+
+
+def get_defaults() -> Dict[str, Union[bool, int, float, str]]:
+    """Get default configuration values"""
+    return {
+        field_name: field_def["default"]
+        for field_name, field_def in CONFIG_SCHEMA_DEF.items()
+    }
+
+
+def get_field_types() -> Dict[str, str]:
+    """Get field type mapping"""
+    return {
+        field_name: field_def["fieldType"].value
+        for field_name, field_def in CONFIG_SCHEMA_DEF.items()
+    }