feat(android): add theme attributes export for colors

Generate attrs.xml and styles.xml content from color exports with
marker-based file updates. Supports batch mode via shared collector.

- Add AndroidThemeAttributesExporter for generating XML content
- Add ThemeAttributeNameTransformer for snake_case to PascalCase
- Add MarkerFileUpdater for marker-based section replacement
- Add SharedThemeAttributesCollector for batch mode coordination
- Support configurable name transformation and prefix stripping
- Include collision detection for duplicate attribute names

Author: alexey1312

.claude/EXFIG.toon

@@ -267,8 +267,9 @@ buildCommands:
   docsPreview: mise run docs:preview
   run: .build/debug/exfig
 
-dependencies[11]{name,version,purpose}:
+dependencies[12]{name,version,purpose}:
   swift-argument-parser,1.5.0+,CLI framework
+  swift-collections,1.2.x,Ordered collections
   Yams,5.3.0+,YAML parsing
   Stencil,0.15.1+,Template engine
   StencilSwiftKit,2.10.1+,Swift Stencil extensions

CLAUDE.md

@@ -306,6 +306,7 @@ RetryLogger.formatRetryMessage(context)
 | Asset Discovery | `noAssetsFound`                                                                                                                      |
 | Xcode           | `xcodeProjectUpdateFailed`                                                                                                           |
 | Batch           | `noConfigsFound`, `invalidConfigsSkipped`, `noValidConfigs`, `checkpointExpired`, `checkpointPathMismatch`, `preFetchPartialFailure` |
+| Theme Attrs     | `themeAttributesFileNotFound`, `themeAttributesMarkerNotFound`, `themeAttributesNameCollision`                                       |
 | Retry           | `retrying(attempt:maxAttempts:error:delay:)`                                                                                         |
 
 **Adding new warnings:**
@@ -733,6 +734,7 @@ exfig init -p android
 | Package               | Version | Purpose                    |
 | --------------------- | ------- | -------------------------- |
 | swift-argument-parser | 1.5.0+  | CLI framework              |
+| swift-collections     | 1.2.x   | Ordered collections        |
 | Yams                  | 5.3.0+  | YAML parsing               |
 | Stencil               | 0.15.1+ | Template engine            |
 | StencilSwiftKit       | 2.10.1+ | Swift Stencil extensions   |

CONFIG.md

@@ -226,6 +226,32 @@ android:
   colors:
     # [optional] The package to export the Jetpack Compose color code to. Note: To export Jetpack Compose code, also `mainSrc` and `resourcePackage` above must be set
     composePackageName: "com.example"
+    # [optional] Theme attributes configuration for generating attrs.xml and styles.xml
+    themeAttributes:
+      # Enable theme attributes export
+      enabled: true
+      # Path to attrs.xml (relative to mainRes)
+      attrsFile: "../../../values/attrs.xml"
+      # Path to styles.xml for light mode (relative to mainRes)
+      stylesFile: "../../../values/styles.xml"
+      # [optional] Path to styles-night.xml for dark mode (relative to mainRes)
+      stylesNightFile: "../../../values-night/styles.xml"
+      # Theme name used in markers (e.g., "Theme.BaseTheme.inDrive")
+      themeName: "Theme.BaseTheme.inDrive"
+      # [optional] Custom marker start text. Default: "FIGMA COLORS MARKER START"
+      markerStart: "FIGMA COLORS MARKER START"
+      # [optional] Custom marker end text. Default: "FIGMA COLORS MARKER END"
+      markerEnd: "FIGMA COLORS MARKER END"
+      # [optional] Auto-create files with markers if missing. Default: false
+      autoCreateMarkers: false
+      # [optional] Name transformation settings
+      nameTransform:
+        # Target case style: camelCase, PascalCase, snake_case, etc. Default: PascalCase
+        style: PascalCase
+        # Prefix to add to attribute names. Default: "color"
+        prefix: "color"
+        # [optional] Prefixes to strip from color names before transformation
+        stripPrefixes: ["extensions_", "information_", "statement_", "additional_"]
   # Parameters for exporting icons
   # Can be a single object (legacy format) or an array of objects (new format)
   # Legacy format (single icons configuration):
@@ -688,6 +714,156 @@ If `figmaFrameName` is not specified in an entry, it falls back to:
 1. `common.images.figmaFrameName` (if defined)
 2. `"Illustrations"` (default)
 
+## Android Theme Attributes
+
+ExFig supports generating Android theme attributes (`attrs.xml` and `styles.xml`) that reference exported color
+resources. This is useful for creating theme-aware apps where colors are accessed via theme attributes rather than direct
+resource references.
+
+### Overview
+
+Theme attributes allow your app to reference colors like `?attr/colorBackgroundPrimary` instead of
+`@color/background_primary`. This enables:
+
+- Theme switching at runtime
+- Centralized color management through themes
+- Separation between design tokens and theme-specific values
+
+### Generated Output
+
+**attrs.xml** (attribute declarations):
+
+```xml
+<resources>
+    <!-- FIGMA COLORS MARKER START: Theme.BaseTheme.inDrive -->
+    <attr name="colorBackgroundPrimary" format="color" />
+    <attr name="colorBackgroundSecondary" format="color" />
+    <attr name="colorTextPrimary" format="color" />
+    <!-- FIGMA COLORS MARKER END: Theme.BaseTheme.inDrive -->
+</resources>
+```
+
+**styles.xml** (theme values):
+
+```xml
+<resources>
+    <style name="Theme.BaseTheme.inDrive" parent="Theme.MaterialComponents.DayNight">
+        <!-- FIGMA COLORS MARKER START: Theme.BaseTheme.inDrive -->
+        <item name="colorBackgroundPrimary">@color/background_primary</item>
+        <item name="colorBackgroundSecondary">@color/background_secondary</item>
+        <item name="colorTextPrimary">@color/text_primary</item>
+        <!-- FIGMA COLORS MARKER END: Theme.BaseTheme.inDrive -->
+    </style>
+</resources>
+```
+
+### Configuration
+
+```yaml
+android:
+  mainRes: "./main/res/figma/color/base"
+  colors:
+    themeAttributes:
+      enabled: true
+      attrsFile: "../../../values/attrs.xml"
+      stylesFile: "../../../values/styles.xml"
+      stylesNightFile: "../../../values-night/styles.xml"
+      themeName: "Theme.BaseTheme.inDrive"
+      markerStart: "FIGMA COLORS MARKER START"
+      markerEnd: "FIGMA COLORS MARKER END"
+      autoCreateMarkers: false
+      nameTransform:
+        style: PascalCase
+        prefix: "color"
+        stripPrefixes: ["extensions_", "information_", "statement_", "additional_"]
+```
+
+### Configuration Options
+
+| Field               | Required | Default                       | Description                                |
+| ------------------- | -------- | ----------------------------- | ------------------------------------------ |
+| `enabled`           | No       | `false`                       | Enable theme attributes export             |
+| `attrsFile`         | Yes\*    | —                             | Path to attrs.xml (relative to `mainRes`)  |
+| `stylesFile`        | Yes\*    | —                             | Path to styles.xml (relative to `mainRes`) |
+| `stylesNightFile`   | No       | —                             | Path to styles-night.xml for dark mode     |
+| `themeName`         | Yes      | —                             | Theme name used in markers                 |
+| `markerStart`       | No       | `"FIGMA COLORS MARKER START"` | Custom marker start text                   |
+| `markerEnd`         | No       | `"FIGMA COLORS MARKER END"`   | Custom marker end text                     |
+| `autoCreateMarkers` | No       | `false`                       | Auto-create files with markers if missing  |
+| `nameTransform`     | No       | —                             | Name transformation settings               |
+
+\* Required when `enabled: true`
+
+### Name Transformation
+
+The `nameTransform` section controls how color names are converted to theme attribute names:
+
+| Setting         | Default      | Description                                     |
+| --------------- | ------------ | ----------------------------------------------- |
+| `style`         | `PascalCase` | Target case style (camelCase, PascalCase, etc.) |
+| `prefix`        | `"color"`    | Prefix added to all attribute names             |
+| `stripPrefixes` | `[]`         | Prefixes to remove from color names             |
+
+**Examples:**
+
+| Original Name                 | With `stripPrefixes: ["extensions_"]` | Result                    |
+| ----------------------------- | ------------------------------------- | ------------------------- |
+| `background_primary`          | No strip                              | `colorBackgroundPrimary`  |
+| `extensions_background_error` | Strips `extensions_`                  | `colorBackgroundError`    |
+| `text_and_icon_primary`       | No strip                              | `colorTextAndIconPrimary` |
+
+### Marker-Based Updates
+
+ExFig uses XML comment markers to update only specific sections of your files. This allows you to:
+
+- Keep manual content outside markers
+- Have multiple themes in the same file (each with its own markers)
+- Safely run exports without losing custom code
+
+**Marker format:**
+
+```xml
+<!-- MARKER_START: ThemeName -->
+... generated content ...
+<!-- MARKER_END: ThemeName -->
+```
+
+**Multiple themes in one file:**
+
+```xml
+<resources>
+    <!-- FIGMA COLORS MARKER START: Theme.Light -->
+    <attr name="colorBackground" format="color" />
+    <!-- FIGMA COLORS MARKER END: Theme.Light -->
+
+    <!-- FIGMA COLORS MARKER START: Theme.Dark -->
+    <attr name="colorBackground" format="color" />
+    <!-- FIGMA COLORS MARKER END: Theme.Dark -->
+</resources>
+```
+
+### Batch Mode
+
+When running `exfig batch`, theme attributes from multiple configs can target the same `attrs.xml` and `styles.xml`
+files. ExFig automatically:
+
+1. Collects all theme attributes during batch processing
+2. Groups by target file
+3. Updates each theme's marker section separately
+4. Writes merged results after all configs complete
+
+This ensures no race conditions and proper merging of contributions from different configs.
+
+### Error Handling
+
+| Error                | Cause                                  | Solution                                        |
+| -------------------- | -------------------------------------- | ----------------------------------------------- |
+| File not found       | Target file doesn't exist              | Create file manually or use `autoCreateMarkers` |
+| Marker not found     | Markers missing in target file         | Add markers manually or use `autoCreateMarkers` |
+| Markers out of order | End marker appears before start marker | Fix marker order in file                        |
+
+When `autoCreateMarkers: true`, ExFig creates missing files with a minimal template containing the markers.
+
 ## CLI Options for Version Tracking
 
 In addition to the YAML configuration, you can control version tracking via CLI flags. Version tracking works for all

Package.resolved

@@ -12,6 +12,7 @@ let package = Package(
         .executable(name: "exfig", targets: ["ExFig"]),
     ],
     dependencies: [
+        .package(url: "https://github.com/apple/swift-collections", "1.2.0" ..< "1.3.0"),
         .package(url: "https://github.com/apple/swift-argument-parser", from: "1.5.0"),
         .package(url: "https://github.com/jpsim/Yams.git", from: "5.3.0"),
         .package(url: "https://github.com/apple/swift-log.git", from: "1.6.0"),
@@ -81,7 +82,13 @@ let package = Package(
         // Exports resources to Android project
         .target(
             name: "AndroidExport",
-            dependencies: ["ExFigCore", "SVGKit", "Stencil", "StencilSwiftKit"],
+            dependencies: [
+                "ExFigCore",
+                "SVGKit",
+                "Stencil",
+                "StencilSwiftKit",
+                .product(name: "OrderedCollections", package: "swift-collections"),
+            ],
             resources: [
                 .copy("Resources/"),
             ]
@@ -143,7 +150,9 @@ let package = Package(
         .testTarget(
             name: "AndroidExportTests",
             dependencies: [
-                "AndroidExport", .product(name: "CustomDump", package: "swift-custom-dump"),
+                "AndroidExport",
+                .product(name: "CustomDump", package: "swift-custom-dump"),
+                .product(name: "OrderedCollections", package: "swift-collections"),
             ]
         ),
         .testTarget(

Package.swift

@@ -5,7 +5,7 @@
 [![CI](https://github.com/alexey1312/ExFig/actions/workflows/ci.yml/badge.svg)](https://github.com/alexey1312/ExFig/actions/workflows/ci.yml)
 [![Release](https://github.com/alexey1312/ExFig/actions/workflows/release.yml/badge.svg)](https://github.com/alexey1312/ExFig/actions/workflows/release.yml)
 [![Docs](https://github.com/alexey1312/ExFig/actions/workflows/deploy-docc.yml/badge.svg)](https://alexey1312.github.io/ExFig/documentation/exfig)
-![Coverage](https://img.shields.io/badge/coverage-49.56%25-yellow)
+![Coverage](https://img.shields.io/badge/coverage-49.33%25-yellow)
 [![License](https://img.shields.io/github/license/alexey1312/ExFig.svg)](LICENSE)
 
 Command-line utility to export colors, typography, icons, and images from Figma to Xcode, Android Studio, Flutter, and