@ankhorage/surface 1.0.2 → 1.0.3

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @ankhorage/surface
 
+## 1.0.3
+
+### Patch Changes
+
+- c8c99de: Support canonical icon provider aliases for Expo vector icons.
+
+  Surface now resolves provider strings such as `material-community` and `material-community-icons` to Expo's `MaterialCommunityIcons` export, so serialized route icons can use stable provider identifiers without falling back to Ionicons.
+
 ## 1.0.2
 
 ### Patch Changes

package/dist/primitives/icon/resolveExpoIconComponent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolveExpoIconComponent.d.ts","sourceRoot":"","sources":["../../../src/primitives/icon/resolveExpoIconComponent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9D,MAAM,MAAM,iBAAiB,GAAG,KAAK,CAAC,WAAW,CAAC;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC,CAAC;AAEH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,CAO5E"}
+{"version":3,"file":"resolveExpoIconComponent.d.ts","sourceRoot":"","sources":["../../../src/primitives/icon/resolveExpoIconComponent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9D,MAAM,MAAM,iBAAiB,GAAG,KAAK,CAAC,WAAW,CAAC;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC,CAAC;AAMH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,CAQ5E"}

package/dist/primitives/icon/resolveExpoIconComponent.js

@@ -1,10 +1,20 @@
 import * as ExpoIcons from '@expo/vector-icons';
 import {} from 'react-native';
+const EXPO_ICON_PROVIDER_ALIASES = {
+    'material-community': 'MaterialCommunityIcons',
+};
 export function resolveExpoIconComponent(provider) {
-    const candidate = ExpoIcons[provider];
+    const normalizedProvider = resolveExpoIconProviderName(provider);
+    const candidate = ExpoIcons[normalizedProvider];
     if (typeof candidate === 'function') {
         return candidate;
     }
     return ExpoIcons.Ionicons;
 }
+function resolveExpoIconProviderName(provider) {
+    const normalizedProvider = provider.trim().toLowerCase();
+    return normalizedProvider in EXPO_ICON_PROVIDER_ALIASES
+        ? EXPO_ICON_PROVIDER_ALIASES[normalizedProvider]
+        : provider;
+}
 //# sourceMappingURL=resolveExpoIconComponent.js.map

package/dist/primitives/icon/resolveExpoIconComponent.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolveExpoIconComponent.js","sourceRoot":"","sources":["../../../src/primitives/icon/resolveExpoIconComponent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,oBAAoB,CAAC;AAEhD,OAAO,EAAkC,MAAM,cAAc,CAAC;AAU9D,MAAM,UAAU,wBAAwB,CAAC,QAAgB;IACvD,MAAM,SAAS,GAAI,SAAqC,CAAC,QAAQ,CAAC,CAAC;IACnE,IAAI,OAAO,SAAS,KAAK,UAAU,EAAE,CAAC;QACpC,OAAO,SAA8B,CAAC;IACxC,CAAC;IAED,OAAO,SAAS,CAAC,QAA6B,CAAC;AACjD,CAAC","sourcesContent":["import * as ExpoIcons from '@expo/vector-icons';\nimport type React from 'react';\nimport { type StyleProp, type TextStyle } from 'react-native';\n\nexport type ExpoIconComponent = React.ElementType<{\n  color?: string;\n  name?: string;\n  size?: number;\n  style?: StyleProp<TextStyle>;\n  testID?: string;\n}>;\n\nexport function resolveExpoIconComponent(provider: string): ExpoIconComponent {\n  const candidate = (ExpoIcons as Record<string, unknown>)[provider];\n  if (typeof candidate === 'function') {\n    return candidate as ExpoIconComponent;\n  }\n\n  return ExpoIcons.Ionicons as ExpoIconComponent;\n}\n"]}
+{"version":3,"file":"resolveExpoIconComponent.js","sourceRoot":"","sources":["../../../src/primitives/icon/resolveExpoIconComponent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,oBAAoB,CAAC;AAEhD,OAAO,EAAkC,MAAM,cAAc,CAAC;AAU9D,MAAM,0BAA0B,GAAG;IACjC,oBAAoB,EAAE,wBAAwB;CACtC,CAAC;AAEX,MAAM,UAAU,wBAAwB,CAAC,QAAgB;IACvD,MAAM,kBAAkB,GAAG,2BAA2B,CAAC,QAAQ,CAAC,CAAC;IACjE,MAAM,SAAS,GAAI,SAAqC,CAAC,kBAAkB,CAAC,CAAC;IAC7E,IAAI,OAAO,SAAS,KAAK,UAAU,EAAE,CAAC;QACpC,OAAO,SAA8B,CAAC;IACxC,CAAC;IAED,OAAO,SAAS,CAAC,QAA6B,CAAC;AACjD,CAAC;AAED,SAAS,2BAA2B,CAAC,QAAgB;IACnD,MAAM,kBAAkB,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAEzD,OAAO,kBAAkB,IAAI,0BAA0B;QACrD,CAAC,CAAC,0BAA0B,CAAC,kBAA6D,CAAC;QAC3F,CAAC,CAAC,QAAQ,CAAC;AACf,CAAC","sourcesContent":["import * as ExpoIcons from '@expo/vector-icons';\nimport type React from 'react';\nimport { type StyleProp, type TextStyle } from 'react-native';\n\nexport type ExpoIconComponent = React.ElementType<{\n  color?: string;\n  name?: string;\n  size?: number;\n  style?: StyleProp<TextStyle>;\n  testID?: string;\n}>;\n\nconst EXPO_ICON_PROVIDER_ALIASES = {\n  'material-community': 'MaterialCommunityIcons',\n} as const;\n\nexport function resolveExpoIconComponent(provider: string): ExpoIconComponent {\n  const normalizedProvider = resolveExpoIconProviderName(provider);\n  const candidate = (ExpoIcons as Record<string, unknown>)[normalizedProvider];\n  if (typeof candidate === 'function') {\n    return candidate as ExpoIconComponent;\n  }\n\n  return ExpoIcons.Ionicons as ExpoIconComponent;\n}\n\nfunction resolveExpoIconProviderName(provider: string): string {\n  const normalizedProvider = provider.trim().toLowerCase();\n\n  return normalizedProvider in EXPO_ICON_PROVIDER_ALIASES\n    ? EXPO_ICON_PROVIDER_ALIASES[normalizedProvider as keyof typeof EXPO_ICON_PROVIDER_ALIASES]\n    : provider;\n}\n"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ankhorage/surface",
   "type": "module",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "Stable UI foundation for React Native and React Native Web.",
   "homepage": "https://github.com/ankhorage/surface#readme",
   "bugs": {

package/src/primitives/icon/resolveExpoIconComponent.test.ts

@@ -2,11 +2,13 @@ import { describe, expect, mock, test } from 'bun:test';
 
 const Ionicons = () => null;
 const MaterialIcons = () => null;
+const MaterialCommunityIcons = () => null;
 
 describe('resolveExpoIconComponent', () => {
   test('returns the requested Expo icon family when it exists', async () => {
     await mock.module('@expo/vector-icons', () => ({
       Ionicons,
+      MaterialCommunityIcons,
       MaterialIcons,
     }));
 
@@ -14,11 +16,25 @@ describe('resolveExpoIconComponent', () => {
 
     expect(resolveExpoIconComponent('Ionicons')).toBe(Ionicons);
     expect(resolveExpoIconComponent('MaterialIcons')).toBe(MaterialIcons);
+    expect(resolveExpoIconComponent('MaterialCommunityIcons')).toBe(MaterialCommunityIcons);
+  });
+
+  test('resolves the canonical material-community provider id', async () => {
+    await mock.module('@expo/vector-icons', () => ({
+      Ionicons,
+      MaterialCommunityIcons,
+      MaterialIcons,
+    }));
+
+    const { resolveExpoIconComponent } = await import('./resolveExpoIconComponent');
+
+    expect(resolveExpoIconComponent('material-community')).toBe(MaterialCommunityIcons);
   });
 
   test('falls back to Ionicons when the provider is unknown', async () => {
     await mock.module('@expo/vector-icons', () => ({
       Ionicons,
+      MaterialCommunityIcons,
       MaterialIcons,
     }));
 

package/src/primitives/icon/resolveExpoIconComponent.ts

@@ -10,11 +10,24 @@ export type ExpoIconComponent = React.ElementType<{
   testID?: string;
 }>;
 
+const EXPO_ICON_PROVIDER_ALIASES = {
+  'material-community': 'MaterialCommunityIcons',
+} as const;
+
 export function resolveExpoIconComponent(provider: string): ExpoIconComponent {
-  const candidate = (ExpoIcons as Record<string, unknown>)[provider];
+  const normalizedProvider = resolveExpoIconProviderName(provider);
+  const candidate = (ExpoIcons as Record<string, unknown>)[normalizedProvider];
   if (typeof candidate === 'function') {
     return candidate as ExpoIconComponent;
   }
 
   return ExpoIcons.Ionicons as ExpoIconComponent;
 }
+
+function resolveExpoIconProviderName(provider: string): string {
+  const normalizedProvider = provider.trim().toLowerCase();
+
+  return normalizedProvider in EXPO_ICON_PROVIDER_ALIASES
+    ? EXPO_ICON_PROVIDER_ALIASES[normalizedProvider as keyof typeof EXPO_ICON_PROVIDER_ALIASES]
+    : provider;
+}