feat(core): Abstract design data sources behind per-asset-type protocols (#75)

* feat(core): abstract design data sources behind per-asset-type protocols

Introduce ColorsSource, ComponentsSource, and TypographySource protocols
in ExFigCore to decouple the export pipeline from Figma-specific loaders.
This lays the foundation for supporting alternative design tools (Penpot,
Sketch, Tokens Studio) without modifying the export infrastructure.

- Add DesignSourceKind enum and ColorsSourceConfig protocol pattern
- Refactor ColorsSourceInput to use sourceKind + sourceConfig
- Extract FigmaColorsSource, TokensFileColorsSource, FigmaComponentsSource,
  FigmaTypographySource from context implementations
- Add SourceFactory for centralized source dispatch
- Add sourceKind field to PKL schemas (FrameSource, VariablesSource)
- Update all context impls, plugin exports, and entry bridges

* chore(openspec): archive design-source-abstraction, sync specs

Sync 4 delta specs to main: design-source-protocol (new),
source-dispatch (new), configuration (updated),
tokens-file-source (updated). Archive completed change.

* fix(core): wire SourceFactory into production path, restore lost warnings

ColorsExportContextImpl now uses per-call SourceFactory dispatch instead of
injected colorsSource, enabling per-entry sourceKind in multi-source configs.
Fixes tokens-file colors export which was broken by hardcoded FigmaColorsSource.

- Remove FigmaColorsSource injection from all 4 PluginColorsExport methods
- Add ignoredModeNames to TokensFileColorsConfig for dark mode field warnings
- Make unsupportedSourceKind error asset-type-aware with correct recovery hints
- Add spinnerLabel to ColorsSourceInput for informative progress messages
- Add 16 tests: SourceKindBridging, explicit override, ignoredModeNames, errors

Author: alexey1312

CLAUDE.md

@@ -14,6 +14,7 @@ public extension Android.IconsEntry {
     /// Returns an IconsSourceInput for use with IconsExportContext.
     func iconsSourceInput(darkFileId: String? = nil) -> IconsSourceInput {
         IconsSourceInput(
+            sourceKind: sourceKind?.coreSourceKind ?? .figma,
             figmaFileId: figmaFileId,
             darkFileId: darkFileId,
             frameName: figmaFrameName ?? "Icons",

Sources/ExFig-Android/Config/AndroidIconsEntry.swift

@@ -31,6 +31,7 @@ public extension Android.ImagesEntry {
     /// Returns an ImagesSourceInput for use with ImagesExportContext.
     func imagesSourceInput(darkFileId: String? = nil) -> ImagesSourceInput {
         ImagesSourceInput(
+            sourceKind: sourceKind?.coreSourceKind ?? .figma,
             figmaFileId: figmaFileId,
             darkFileId: darkFileId,
             frameName: figmaFrameName ?? "Images",

Sources/ExFig-Android/Config/AndroidImagesEntry.swift

@@ -63,7 +63,7 @@ public struct AndroidColorsExporter: ColorsExporter {
         // 1. Load colors from Figma
         let sourceInput = try entry.validatedColorsSourceInput()
         let colors = try await context.withSpinner(
-            "Fetching colors from Figma (\(sourceInput.tokensCollectionName))..."
+            "Fetching colors from \(sourceInput.spinnerLabel)..."
         ) {
             try await context.loadColors(from: sourceInput)
         }

Sources/ExFig-Android/Export/AndroidColorsExporter.swift

@@ -11,6 +11,7 @@ public extension Flutter.IconsEntry {
     /// Returns an IconsSourceInput for use with IconsExportContext.
     func iconsSourceInput(darkFileId: String? = nil) -> IconsSourceInput {
         IconsSourceInput(
+            sourceKind: sourceKind?.coreSourceKind ?? .figma,
             figmaFileId: figmaFileId,
             darkFileId: darkFileId,
             frameName: figmaFrameName ?? "Icons",

Sources/ExFig-Flutter/Config/FlutterIconsEntry.swift

@@ -14,6 +14,7 @@ public extension Flutter.ImagesEntry {
     /// Returns an ImagesSourceInput for use with ImagesExportContext.
     func imagesSourceInput(darkFileId: String? = nil) -> ImagesSourceInput {
         ImagesSourceInput(
+            sourceKind: sourceKind?.coreSourceKind ?? .figma,
             figmaFileId: figmaFileId,
             darkFileId: darkFileId,
             frameName: figmaFrameName ?? "Images",
@@ -43,6 +44,7 @@ public extension Flutter.ImagesEntry {
     /// Returns an ImagesSourceInput configured for SVG source.
     func svgSourceInput(darkFileId: String? = nil) -> ImagesSourceInput {
         ImagesSourceInput(
+            sourceKind: sourceKind?.coreSourceKind ?? .figma,
             figmaFileId: figmaFileId,
             darkFileId: darkFileId,
             frameName: figmaFrameName ?? "Images",

Sources/ExFig-Flutter/Config/FlutterImagesEntry.swift

@@ -52,7 +52,7 @@ public struct FlutterColorsExporter: ColorsExporter {
         // 1. Load colors from Figma
         let sourceInput = try entry.validatedColorsSourceInput()
         let colors = try await context.withSpinner(
-            "Fetching colors from Figma (\(sourceInput.tokensCollectionName))..."
+            "Fetching colors from \(sourceInput.spinnerLabel)..."
         ) {
             try await context.loadColors(from: sourceInput)
         }

Sources/ExFig-Flutter/Export/FlutterColorsExporter.swift

@@ -11,6 +11,7 @@ public extension Web.IconsEntry {
     /// Returns an IconsSourceInput for use with IconsExportContext.
     func iconsSourceInput(darkFileId: String? = nil) -> IconsSourceInput {
         IconsSourceInput(
+            sourceKind: sourceKind?.coreSourceKind ?? .figma,
             figmaFileId: figmaFileId,
             darkFileId: darkFileId,
             frameName: figmaFrameName ?? "Icons",

Sources/ExFig-Web/Config/WebIconsEntry.swift

@@ -11,6 +11,7 @@ public extension Web.ImagesEntry {
     /// Returns an ImagesSourceInput for use with ImagesExportContext.
     func imagesSourceInput(darkFileId: String? = nil) -> ImagesSourceInput {
         ImagesSourceInput(
+            sourceKind: sourceKind?.coreSourceKind ?? .figma,
             figmaFileId: figmaFileId,
             darkFileId: darkFileId,
             frameName: figmaFrameName ?? "Images",

Sources/ExFig-Web/Config/WebImagesEntry.swift

@@ -52,7 +52,7 @@ public struct WebColorsExporter: ColorsExporter {
         // 1. Load colors from Figma
         let sourceInput = try entry.validatedColorsSourceInput()
         let colors = try await context.withSpinner(
-            "Fetching colors from Figma (\(sourceInput.tokensCollectionName))..."
+            "Fetching colors from \(sourceInput.spinnerLabel)..."
         ) {
             try await context.loadColors(from: sourceInput)
         }