From 270abe2cc03c8c5b51c30f7511b41c6b2ec9457a Mon Sep 17 00:00:00 2001
From: Armin <armin@cherry>
Date: Wed, 15 Jul 2026 23:54:25 +0200
Subject: [PATCH] Add VERSION file, preset DTD, and .cfl version-compatibility
 check

---
 CMakeLists.txt       |  8 ++++++++
 ChromaFlockPatch.dtd | 30 ++++++++++++++++++++++++++++++
 Source/Version.h.in  |  3 +++
 VERSION              |  1 +
 4 files changed, 42 insertions(+)
 create mode 100644 ChromaFlockPatch.dtd
 create mode 100644 Source/Version.h.in
 create mode 100644 VERSION

diff --git a/CMakeLists.txt b/CMakeLists.txt
index fdd956e..658a95a 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -70,6 +70,14 @@ target_compile_definitions(ChromaFlock PUBLIC
     JUCE_MODAL_LOOPS_PERMITTED=0
 )
 
+# Inject the version from the VERSION file into a generated header.
+file(READ "${CMAKE_CURRENT_SOURCE_DIR}/VERSION" CHROMAFLOCK_VERSION_RAW)
+string(STRIP "${CHROMAFLOCK_VERSION_RAW}" CHROMAFLOCK_VERSION)
+configure_file("${CMAKE_CURRENT_SOURCE_DIR}/Source/Version.h.in"
+               "${CMAKE_CURRENT_BINARY_DIR}/Generated/Version.h" @ONLY)
+
+target_include_directories(ChromaFlock PRIVATE "${CMAKE_CURRENT_BINARY_DIR}/Generated")
+
 target_link_libraries(ChromaFlock PRIVATE
     ChromaFlockBinaryData
     juce::juce_audio_basics
diff --git a/ChromaFlockPatch.dtd b/ChromaFlockPatch.dtd
new file mode 100644
index 0000000..8a8beed
--- /dev/null
+++ b/ChromaFlockPatch.dtd
@@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  ChromaFlock Preset File Format DTD
+  ==================================
+  This DTD defines the structure of a ChromaFlock (.cfl) preset file.
+
+  Compatibility is governed by the "version" attribute on the root
+  <ChromaFlockPatch> element:
+
+    - version 1.0  : file-format version, compatible with ChromaFlock 0.1
+    - A .cfl whose version does NOT match the running ChromaFlock version
+      will still be loaded when possible, but the user is shown a warning
+      that the preset may not sound as intended.
+
+  Changelog:
+    1.0  (ChromaFlock 0.1)  Initial preset format.
+-->
+<!ELEMENT ChromaFlockPatch (PARAM*)>
+
+<!ATTLIST ChromaFlockPatch
+    version     CDATA #REQUIRED
+    generator   CDATA #IMPLIED
+>
+
+<!ELEMENT PARAM EMPTY>
+
+<!ATTLIST PARAM
+    id      CDATA #REQUIRED
+    value   CDATA #REQUIRED
+>
diff --git a/Source/Version.h.in b/Source/Version.h.in
new file mode 100644
index 0000000..feaf2e9
--- /dev/null
+++ b/Source/Version.h.in
@@ -0,0 +1,3 @@
+#pragma once
+// Generated by CMake from the VERSION file. Do not edit manually.
+#define CHROMAFLOCK_VERSION "@CHROMAFLOCK_VERSION@"
diff --git a/VERSION b/VERSION
new file mode 100644
index 0000000..49d5957
--- /dev/null
+++ b/VERSION
@@ -0,0 +1 @@
+0.1