feat(BrandLogo): Add file validation to logo files

`logo.image` is now a dict of file paths, no internal reference allowed (#22)

examples/brand-logo-full.yml

@@ -1,14 +1,13 @@
 logo:
   images:
-    primary: full-color.png
-    primary-svg: full-color.svg
-    reverse: full-color-reverse.png
-    black: black.png
-    white: white.png
-    icon: favicon.png
-    both:
-      light: primary
-      dark: reverse
-  small: icon
-  medium: both
-  large: primary-svg
+    mark: logos/pandas/pandas_mark.svg
+    mark-white: logos/pandas/pandas_mark_white.svg
+    secondary: logos/pandas/pandas_secondary.svg
+    secondary-white: logos/pandas/pandas_secondary_white.svg
+    pandas: logos/pandas/pandas.svg
+    pandas-white: logos/pandas/pandas_white.svg
+  small: mark
+  medium:
+    light: logos/pandas/pandas_secondary.svg
+    dark: secondary-white
+  large: pandas

examples/brand-logo-light-dark.yml

@@ -1,6 +1,6 @@
 logo:
-  small: icon.png
+  small: logos/pandas/pandas_mark.svg
   medium: 
-    light: logo-light.png
-    dark: logo-dark.png
-  large: display.svg
+    light: logos/pandas/pandas_secondary.svg
+    dark: logos/pandas/pandas_secondary_white.svg
+  large: logos/pandas/pandas.svg

examples/brand-logo-simple.yml

@@ -1,4 +1,4 @@
 logo:
-  small: icon.png
-  medium: logo.png
-  large: display.svg
+  small: logos/pandas/pandas_mark.svg
+  medium: logos/pandas/pandas_secondary.svg
+  large: logos/pandas/pandas.svg

pkg-py/src/brand_yaml/__init__.py

@@ -72,8 +72,6 @@ def from_yaml(cls, path: str | Path):
         """
         return cls.model_validate(read_brand_yaml(path, as_data=True))
 
-    # TODO: resolve paths relative to `brand.path`
-
     @model_validator(mode="after")
     def resolve_typography_colors(self):
         if self.typography is None or self.color is None:

pkg-py/src/brand_yaml/_path.py

@@ -23,6 +23,9 @@ def __call__(self) -> Path | HttpUrl:
 
         return self.root
 
+    def __str__(self) -> str:
+        return str(self.root)
+
     def set_root_dir(self, root_dir: Path, validate_path: bool = False) -> None:
         self._root_dir = root_dir