@ankhorage/surface 8.0.0 → 9.0.1

package/src/features/theme/runtime.test.ts

@@ -0,0 +1,13 @@
+import { readFileSync } from 'node:fs';
+
+import { describe, expect, it } from 'bun:test';
+
+describe('theme runtime ownership', () => {
+  it('keeps nested scopes on the Surface runtime boundary without exposing raw context', () => {
+    const root = readFileSync(new URL('../../index.ts', import.meta.url), 'utf8');
+    const runtime = readFileSync(new URL('./runtime.ts', import.meta.url), 'utf8');
+    expect(root).toContain('ThemeProvider, ThemeScope, useTheme');
+    expect(root).not.toContain('ThemeContext');
+    expect(runtime).not.toContain('ThemeRuntimeContext');
+  });
+});

package/src/features/theme/runtime.ts

@@ -0,0 +1,4 @@
+export type { ThemeProviderProps, ThemeRuntime, ThemeScopeProps } from '../../types/theme';
+export { ThemeProvider } from './adapters/inbound/ThemeProvider';
+export { ThemeScope } from './adapters/inbound/ThemeScope';
+export { useTheme } from './adapters/inbound/useTheme';

package/src/{theme → features/theme/utils}/resolveGlobalTokens.ts

@@ -1,10 +1,10 @@
 import type { ThemeGlobalTokenOverrides } from '@ankhorage/contracts';
 
-import { DEFAULT_TOKENS } from './defaultTokens';
+import type { ThemeTokens } from '../../../types/theme';
+import { DEFAULT_TOKENS } from '../constants';
 import { resolveHeadingTokenOverrides } from './resolveHeadingTokenOverrides';
 import { resolveNumericTokenOverrides } from './resolveNumericTokenOverrides';
 import { resolveWeightTokenOverrides } from './resolveWeightTokenOverrides';
-import type { ThemeTokens } from './types';
 
 type GlobalThemeTokens = Omit<
   ThemeTokens,

package/src/{theme → features/theme/utils}/resolveHeadingTokenOverrides.ts

@@ -1,6 +1,6 @@
 import type { ThemeTypographyHeadingOverrides } from '@ankhorage/contracts';
 
-import type { ThemeTokens } from './types';
+import type { ThemeTokens } from '../../../types/theme';
 
 type HeadingTokens = ThemeTokens['typography']['headings'];
 type HeadingToken = HeadingTokens[1];

package/src/features/theme/utils/resolveToken.ts

@@ -0,0 +1,16 @@
+/*** Resolve a theme token key through its map while preserving raw values. */
+type ResolvedToken<TMap, TValue> = TValue extends keyof TMap ? TMap[TValue] : TValue;
+
+/*** Resolve a mapped theme token or return the supplied raw value unchanged. */
+export function resolveToken<
+  TMap extends Record<string | number, unknown>,
+  TValue extends string | number | undefined,
+>(map: TMap, value: TValue): ResolvedToken<TMap, TValue> {
+  if (value === undefined) return undefined as ResolvedToken<TMap, TValue>;
+
+  if (Object.prototype.hasOwnProperty.call(map, value)) {
+    return map[value as keyof TMap] as ResolvedToken<TMap, TValue>;
+  }
+
+  return value as ResolvedToken<TMap, TValue>;
+}

package/src/{theme → features/theme/utils}/resolveWeightTokenOverrides.ts

@@ -1,4 +1,4 @@
-import type { FontWeight } from './types';
+import type { FontWeight } from '../../../types/theme';
 
 const WEIGHT_TOKEN_KEYS = new Set<string>([
   'thin',
@@ -30,17 +30,17 @@ export function resolveWeightTokenOverrides(
 ): Readonly<Record<string, FontWeight>> {
   if (overrides === undefined) return {};
 
-  const resolved: Record<string, FontWeight> = {};
-  for (const [token, value] of Object.entries(overrides)) {
-    if (!WEIGHT_TOKEN_KEYS.has(token)) {
-      throw new RangeError(`Unknown typography weight token: ${token}.`);
-    }
-    if (!isFontWeight(value)) {
-      throw new RangeError(`Invalid font weight for typography.weights.${token}: ${value}.`);
-    }
-    resolved[token] = value;
-  }
-  return resolved;
+  return Object.fromEntries(
+    Object.entries(overrides).map(([token, value]) => {
+      if (!WEIGHT_TOKEN_KEYS.has(token)) {
+        throw new RangeError(`Unknown typography weight token: ${token}.`);
+      }
+      if (!isFontWeight(value)) {
+        throw new RangeError(`Invalid font weight for typography.weights.${token}: ${value}.`);
+      }
+      return [token, value] as const;
+    }),
+  );
 }
 
 function isFontWeight(value: string): value is FontWeight {

package/src/features/toast/adapters/inbound/Toast.tsx

@@ -1,12 +1,12 @@
 import React from 'react';
 import { Pressable, StyleSheet, type ViewStyle } from 'react-native';
 
-import type { SurfaceColor } from '../../../../surfaceColor';
-import { useTheme } from '../../../../theme/ThemeContext';
-import type { SurfaceTheme } from '../../../../theme/types';
+import type { SurfaceColor } from '../../../../types/surfaceColor';
+import type { SurfaceTheme } from '../../../../types/theme';
 import type { ToastProps } from '../../../../types/toast';
 import { View } from '../../../layout/public';
 import { Surface } from '../../../surface/public';
+import { useTheme } from '../../../theme/runtime';
 import { Text } from '../../../typography/public';
 
 /*** Renders one transient toast notification. */

package/src/features/tooltip/adapters/inbound/Tooltip.tsx

@@ -1,10 +1,10 @@
 import React from 'react';
 import { Platform, Pressable, View } from 'react-native';
 
-import { useTheme } from '../../../../theme/ThemeContext';
 import type { TooltipProps } from '../../../../types/tooltip';
 import { Popover } from '../../../popover/public';
 import { Surface } from '../../../surface/public';
+import { useTheme } from '../../../theme/runtime';
 import { Text } from '../../../typography/public';
 import { useTooltipVisibility } from '../../composition/useTooltipVisibility';
 

package/src/features/typography/adapters/inbound/Heading.tsx

@@ -1,12 +1,11 @@
 import React from 'react';
 import { Text as ReactNativeText } from 'react-native';
 
-import { useTranslationContext } from '../../../../context/TranslationContext';
-import { useTheme } from '../../../../theme/ThemeContext';
 import type { HeadingProps } from '../../../../types/typography';
+import { useTheme } from '../../../theme/runtime';
 import { resolveHeadingTextStyle } from '../../utils/resolveHeadingTextStyle';
 
-/*** Renders a semantic, translatable heading using Surface typography tokens. */
+/*** Renders a semantic heading using Surface typography tokens. */
 export function Heading({
   text,
   children,
@@ -15,12 +14,10 @@ export function Heading({
   color,
   emphasis = 'default',
   numberOfLines,
-  i18nKey,
   testID,
 }: HeadingProps) {
   const { theme } = useTheme();
-  const { t } = useTranslationContext();
-  const content = resolveHeadingContent({ text, children, i18nKey, translate: t });
+  const content = text ?? children;
 
   return (
     <ReactNativeText
@@ -33,27 +30,3 @@ export function Heading({
     </ReactNativeText>
   );
 }
-
-/*** Resolves authored or translated heading content without mutating source input. */
-function resolveHeadingContent({
-  text,
-  children,
-  i18nKey,
-  translate,
-}: {
-  text: HeadingProps['text'];
-  children: HeadingProps['children'];
-  i18nKey: HeadingProps['i18nKey'];
-  translate: (key: string) => string;
-}) {
-  const content = text ?? children;
-  if (!i18nKey) return content;
-
-  try {
-    const translated = translate(i18nKey);
-    return translated && translated !== i18nKey ? translated : content;
-  } catch (error) {
-    console.warn('[Heading] Translation error:', error);
-    return content;
-  }
-}

package/src/features/typography/adapters/inbound/Text.tsx

@@ -1,12 +1,11 @@
 import React from 'react';
 import { Text as ReactNativeText } from 'react-native';
 
-import { useTranslationContext } from '../../../../context/TranslationContext';
 import { resolveTextColor, resolveTextStyles } from '../../../../internal/resolvers';
-import { useTheme } from '../../../../theme/ThemeContext';
 import type { TextProps } from '../../../../types/typography';
+import { useTheme } from '../../../theme/runtime';
 
-/*** Renders translatable body text using Surface semantic typography. */
+/*** Renders body text using Surface semantic typography. */
 export function Text({
   children,
   i18nKey,
@@ -20,8 +19,7 @@ export function Text({
   testID,
 }: TextProps) {
   const { theme } = useTheme();
-  const { t } = useTranslationContext();
-  const content = resolveTextContent(children, i18nKey, t);
+  const content = children ?? i18nKey ?? null;
 
   return (
     <ReactNativeText
@@ -36,21 +34,3 @@ export function Text({
     </ReactNativeText>
   );
 }
-
-/*** Resolves authored or translated Text content with a stable fallback. */
-function resolveTextContent(
-  children: TextProps['children'],
-  i18nKey: TextProps['i18nKey'],
-  translate: (key: string) => string,
-) {
-  if (children !== undefined) return children;
-  if (!i18nKey) return null;
-
-  try {
-    const translated = translate(i18nKey);
-    return translated && translated !== i18nKey ? translated : i18nKey;
-  } catch (error) {
-    console.warn('[Text] Translation error:', error);
-    return i18nKey;
-  }
-}

package/src/features/typography/utils/resolveHeadingTextStyle.test.ts

@@ -1,6 +1,6 @@
 import { describe, expect, it } from 'bun:test';
 
-import { createTheme } from '../../../theme/createTheme';
+import { createTheme } from '../../theme/application/use-cases/createTheme';
 import { resolveHeadingTextStyle } from './resolveHeadingTextStyle';
 
 describe('resolveHeadingTextStyle', () => {

package/src/features/typography/utils/resolveHeadingTextStyle.ts

@@ -2,8 +2,8 @@ import type { TextStyle } from 'react-native';
 
 import { resolveTextColor } from '../../../internal/resolvers/resolveTextColor';
 import { resolveTextStyles } from '../../../internal/resolvers/resolveTextStyles';
-import type { SurfaceColor, SurfaceEmphasis } from '../../../surfaceColor';
-import type { SurfaceTheme } from '../../../theme/types';
+import type { SurfaceColor, SurfaceEmphasis } from '../../../types/surfaceColor';
+import type { SurfaceTheme } from '../../../types/theme';
 import type { HeadingLevel, HeadingProps } from '../../../types/typography';
 
 /*** Resolves theme-driven typography styles for one heading level. */

package/src/index.test.ts

@@ -2,8 +2,8 @@ import { readFileSync } from 'node:fs';
 
 import { describe, expect, it } from 'bun:test';
 
-import type { SelectionSemantics, SurfaceColorDiagnostics } from './index';
-import { createTheme } from './theme/createTheme';
+import type { SelectionSemantics, SurfaceColorDiagnostics } from './features/theme/public';
+import { createTheme } from './features/theme/public';
 
 const indexSource = readFileSync(new URL('./index.ts', import.meta.url), 'utf8');
 const packageJson = JSON.parse(
@@ -43,8 +43,10 @@ const expectedFeatureRootExports = [
 ] as const;
 
 const expectedCrossCuttingRootExports = [
-  "export type { InteractionPolicy, InteractionPolicyProps } from './interactionPolicy';",
+  "export type { InteractionPolicy, InteractionPolicyProps } from './types/interactionPolicy';",
   "export * from './core/responsive';",
+  "export { FontProvider } from './features/font/public';",
+  "export { ThemeProvider, ThemeScope, useTheme } from './features/theme/runtime';",
 ] as const;
 
 describe('feature-owned root barrel contract', () => {
@@ -127,13 +129,21 @@ describe('public package metadata contract', () => {
         import: './dist/features/bottom-sheet/public.js',
         types: './dist/features/bottom-sheet/public.d.ts',
       },
+      './color': {
+        bun: './src/constants/surfaceColor.ts',
+        'react-native': './src/constants/surfaceColor.ts',
+        browser: './src/constants/surfaceColor.ts',
+        default: './dist/constants/surfaceColor.js',
+        import: './dist/constants/surfaceColor.js',
+        types: './dist/constants/surfaceColor.d.ts',
+      },
       './theme': {
-        bun: './src/theme/public.ts',
-        'react-native': './src/theme/public.ts',
-        browser: './src/theme/public.ts',
-        default: './dist/theme/public.js',
-        import: './dist/theme/public.js',
-        types: './dist/theme/public.d.ts',
+        bun: './src/features/theme/public.ts',
+        'react-native': './src/features/theme/public.ts',
+        browser: './src/features/theme/public.ts',
+        default: './dist/features/theme/public.js',
+        import: './dist/features/theme/public.js',
+        types: './dist/features/theme/public.d.ts',
       },
       './package.json': './package.json',
     });

package/src/index.ts

@@ -1,7 +1,9 @@
-export type { FontRuntime } from './context/FontContext';
-export { FontProvider, useFontContext } from './context/FontContext';
-export type { I18nInstance, TranslationRuntime, Translator } from './context/TranslationContext';
-export { TranslationProvider, useTranslationContext } from './context/TranslationContext';
+export {
+  SURFACE_COLORS,
+  SURFACE_EMPHASES,
+  SURFACE_PALETTE_COLORS,
+  SURFACE_STATUS_COLORS,
+} from './constants/surfaceColor';
 export * from './core/responsive';
 export type {
   AccordionContentProps,
@@ -26,6 +28,8 @@ export type { ButtonIconSpec, ButtonProps, IconButtonProps } from './features/bu
 export { Button, IconButton } from './features/button/public';
 export type { CardProps } from './features/card/public';
 export { Card } from './features/card/public';
+export type { FontProviderProps, FontRuntime } from './features/font/public';
+export { FontProvider } from './features/font/public';
 export type { CheckboxProps } from './features/form/checkbox/public';
 export { Checkbox } from './features/form/checkbox/public';
 export type { FieldProps } from './features/form/field/public';
@@ -76,6 +80,26 @@ export type { SurfaceProps, SurfaceVariant } from './features/surface/public';
 export { Surface } from './features/surface/public';
 export type { TabListProps, TabPanelProps, TabProps, TabsProps } from './features/tabs/public';
 export { Tab, TabList, TabPanel, Tabs } from './features/tabs/public';
+export type {
+  ActionSemantics,
+  BorderSemantics,
+  ContentSemantics,
+  FontWeight,
+  NeutralSemantics,
+  RoleSemantics,
+  SelectionSemantics,
+  SurfaceColorDiagnostics,
+  SurfaceColorSelectionDiagnostic,
+  SurfaceContrastDiagnostic,
+  SurfaceSemantics,
+  SurfaceTheme,
+  ThemeMode,
+  ThemeSemantics,
+  ThemeTokens,
+} from './features/theme/public';
+export { createTheme } from './features/theme/public';
+export type { ThemeProviderProps, ThemeRuntime, ThemeScopeProps } from './features/theme/runtime';
+export { ThemeProvider, ThemeScope, useTheme } from './features/theme/runtime';
 export type {
   ToastController,
   ToastOptions,
@@ -88,19 +112,10 @@ export type { TooltipProps } from './features/tooltip/public';
 export { Tooltip } from './features/tooltip/public';
 export type { HeadingLevel, HeadingProps, TextProps } from './features/typography/public';
 export { Heading, Text } from './features/typography/public';
-export type { InteractionPolicy, InteractionPolicyProps } from './interactionPolicy';
+export type { InteractionPolicy, InteractionPolicyProps } from './types/interactionPolicy';
 export type {
   SurfaceColor,
   SurfaceEmphasis,
   SurfacePaletteColor,
   SurfaceStatusColor,
-} from './surfaceColor';
-export {
-  SURFACE_COLORS,
-  SURFACE_EMPHASES,
-  SURFACE_PALETTE_COLORS,
-  SURFACE_STATUS_COLORS,
-} from './surfaceColor';
-export * from './theme';
-export { isDeepEqual } from './utils/deepEqual';
-export { deepMerge } from './utils/deepMerge';
+} from './types/surfaceColor';

package/src/internal/resolvers/resolveControlSize.test.ts

@@ -1,6 +1,6 @@
 import { describe, expect, it } from 'bun:test';
 
-import { createTheme } from '../../theme/createTheme';
+import { createTheme } from '../../features/theme/application/use-cases/createTheme';
 import { resolveControlSize } from './resolveControlSize';
 
 describe('resolveControlSize', () => {

package/src/internal/resolvers/resolveControlSize.ts

@@ -1,4 +1,4 @@
-import type { SurfaceTheme } from '../../theme/types';
+import type { SurfaceTheme } from '../../types/theme';
 
 export type ControlSize = 's' | 'm' | 'l';
 

package/src/internal/resolvers/resolveFieldPresentation.ts

@@ -1,4 +1,4 @@
-import type { SurfaceColor, SurfaceEmphasis } from '../../surfaceColor';
+import type { SurfaceColor, SurfaceEmphasis } from '../../types/surfaceColor';
 import type { FieldState } from './resolveFieldState';
 
 export interface ResolvedFieldPresentation {

package/src/internal/resolvers/resolveIconSize.ts

@@ -1,4 +1,4 @@
-import type { SurfaceTheme } from '../../theme/types';
+import type { SurfaceTheme } from '../../types/theme';
 import { type ControlSize, resolveControlSize } from './resolveControlSize';
 
 export function resolveIconSize(theme: SurfaceTheme, size: ControlSize = 'm'): number {

package/src/internal/resolvers/resolveInteractiveColors.test.ts

@@ -1,6 +1,6 @@
 import { describe, expect, it } from 'bun:test';
 
-import { createTheme } from '../../theme/createTheme';
+import { createTheme } from '../../features/theme/application/use-cases/createTheme';
 import { resolveFieldState } from './resolveFieldState';
 import { resolveButtonColors, resolveInputColors } from './resolveInteractiveColors';
 

package/src/internal/resolvers/resolveInteractiveColors.ts

@@ -1,5 +1,5 @@
-import type { SurfaceColor } from '../../surfaceColor';
-import type { SurfaceTheme } from '../../theme/types';
+import type { SurfaceColor } from '../../types/surfaceColor';
+import type { SurfaceTheme } from '../../types/theme';
 import type { FieldState } from './resolveFieldState';
 import type { InteractionState } from './resolveInteractiveState';
 import { resolveSurfaceColor } from './resolveSurfaceColor';

package/src/internal/resolvers/resolveSelectionControlColors.test.ts

@@ -1,6 +1,6 @@
 import { describe, expect, it } from 'bun:test';
 
-import { createTheme } from '../../theme/createTheme';
+import { createTheme } from '../../features/theme/application/use-cases/createTheme';
 import { resolveFieldState } from './resolveFieldState';
 import { resolveSelectionControlColors } from './resolveSelectionControlColors';
 

package/src/internal/resolvers/resolveSelectionControlColors.ts

@@ -1,5 +1,5 @@
-import type { SurfaceColor } from '../../surfaceColor';
-import type { SurfaceTheme } from '../../theme/types';
+import type { SurfaceColor } from '../../types/surfaceColor';
+import type { SurfaceTheme } from '../../types/theme';
 import type { FieldState } from './resolveFieldState';
 import { resolveSurfaceColor } from './resolveSurfaceColor';
 

package/src/internal/resolvers/resolveSurfaceColor.test.ts

@@ -1,6 +1,6 @@
 import { describe, expect, it } from 'bun:test';
 
-import { createTheme } from '../../theme/createTheme';
+import { createTheme } from '../../features/theme/application/use-cases/createTheme';
 import { resolveSurfaceColor } from './resolveSurfaceColor';
 
 describe('resolveSurfaceColor', () => {

package/src/internal/resolvers/resolveSurfaceColor.ts

@@ -1,5 +1,5 @@
-import type { SurfaceColor } from '../../surfaceColor';
-import type { RoleSemantics, SurfaceTheme } from '../../theme/types';
+import type { SurfaceColor } from '../../types/surfaceColor';
+import type { RoleSemantics, SurfaceTheme } from '../../types/theme';
 
 export function resolveSurfaceColor(
   theme: SurfaceTheme,

package/src/internal/resolvers/resolveTextColor.test.ts

@@ -1,6 +1,6 @@
 import { describe, expect, it } from 'bun:test';
 
-import { createTheme } from '../../theme/createTheme';
+import { createTheme } from '../../features/theme/application/use-cases/createTheme';
 import { resolveTextColor } from './resolveTextColor';
 
 describe('resolveTextColor', () => {

package/src/internal/resolvers/resolveTextColor.ts

@@ -1,5 +1,5 @@
-import type { SurfaceColor, SurfaceEmphasis } from '../../surfaceColor';
-import type { SurfaceTheme } from '../../theme/types';
+import type { SurfaceColor, SurfaceEmphasis } from '../../types/surfaceColor';
+import type { SurfaceTheme } from '../../types/theme';
 import { resolveSurfaceColor } from './resolveSurfaceColor';
 
 export function resolveTextColor(

package/src/internal/resolvers/resolveTextStyles.test.ts

@@ -1,6 +1,6 @@
 import { describe, expect, it } from 'bun:test';
 
-import { createTheme } from '../../theme/createTheme';
+import { createTheme } from '../../features/theme/application/use-cases/createTheme';
 import { resolveTextStyles } from './resolveTextStyles';
 
 describe('resolveTextStyles', () => {

package/src/internal/resolvers/resolveTextStyles.ts

@@ -1,6 +1,6 @@
 import type { TextStyle } from 'react-native';
 
-import type { FontWeight, SurfaceTheme } from '../../theme/types';
+import type { FontWeight, SurfaceTheme } from '../../types/theme';
 
 export type TextVariant = 'body' | 'bodySmall' | 'caption' | 'label' | 'mono';
 export type TextWeight = keyof SurfaceTheme['typography']['weights'] | FontWeight;

package/src/structureOwnership.test.ts

@@ -0,0 +1,16 @@
+import { existsSync } from 'node:fs';
+
+import { describe, expect, it } from 'bun:test';
+
+describe('canonical Surface ownership', () => {
+  it('does not retain superseded technical roots or local generic deep utilities', () => {
+    const src = new URL('.', import.meta.url);
+    expect(existsSync(new URL('./context', src))).toBe(false);
+    expect(existsSync(new URL('./theme', src))).toBe(false);
+    expect(existsSync(new URL('./contracts', src))).toBe(false);
+    expect(existsSync(new URL('./interactionPolicy.ts', src))).toBe(false);
+    expect(existsSync(new URL('./surfaceColor.ts', src))).toBe(false);
+    expect(existsSync(new URL('./utils/deepEqual.ts', src))).toBe(false);
+    expect(existsSync(new URL('./utils/deepMerge.ts', src))).toBe(false);
+  });
+});

package/src/types/accordion.ts

@@ -1,7 +1,7 @@
 import type React from 'react';
 import type { PressableProps, ViewProps } from 'react-native';
 
-import type { InteractionPolicy, InteractionPolicyProps } from '../interactionPolicy';
+import type { InteractionPolicy, InteractionPolicyProps } from './interactionPolicy';
 
 export type AccordionMode = 'single' | 'multiple';
 

package/src/types/badge.ts

@@ -2,7 +2,7 @@ import type React from 'react';
 
 import type { ControlSize } from '../internal/resolvers/resolveControlSize';
 import type { ButtonVariant } from '../internal/resolvers/resolveInteractiveColors';
-import type { SurfaceColor } from '../surfaceColor';
+import type { SurfaceColor } from './surfaceColor';
 
 export interface BadgeProps {
   content?: React.ReactNode;

package/src/types/button.ts

@@ -2,9 +2,9 @@ import type React from 'react';
 
 import type { ControlSize } from '../internal/resolvers/resolveControlSize';
 import type { ButtonVariant } from '../internal/resolvers/resolveInteractiveColors';
-import type { SurfaceColor } from '../surfaceColor';
 import type { IconSource } from './icon';
 import type { PressableProps } from './pressable';
+import type { SurfaceColor } from './surfaceColor';
 
 export type ButtonIconSpec = IconSource;
 

package/src/types/checkbox.ts

@@ -1,8 +1,8 @@
 import type React from 'react';
 
 import type { ControlSize } from '../internal/resolvers/resolveControlSize';
-import type { SurfaceColor } from '../surfaceColor';
 import type { PressableProps } from './pressable';
+import type { SurfaceColor } from './surfaceColor';
 
 export interface CheckboxProps extends Omit<
   PressableProps,

package/src/types/font.ts

@@ -0,0 +1,14 @@
+import type { ReactNode } from 'react';
+
+export interface FontRuntime {
+  fontsLoaded: boolean;
+  activeFontId: string | null;
+  setActiveFontId: (id: string) => void;
+}
+
+export interface FontProviderProps {
+  fontsLoaded: boolean;
+  activeFontId?: string | null;
+  children: ReactNode;
+  onActiveFontChange?: (id: string) => void;
+}

package/src/types/icon.ts

@@ -13,8 +13,8 @@ import type { IoniconsIconName } from '@react-native-vector-icons/ionicons/stati
 import type { MaterialDesignIconsIconName } from '@react-native-vector-icons/material-design-icons/static';
 import type { StyleProp, TextStyle, ViewStyle } from 'react-native';
 
-import type { SurfaceTheme } from '../theme/types';
 import type { SurfaceImageSource } from './image';
+import type { SurfaceTheme } from './theme';
 
 export type IconProvider =
   'Ionicons' | 'FontAwesome' | 'FontAwesome5' | 'FontAwesome6' | 'MaterialDesignIcons';

package/src/types/image.ts

@@ -6,7 +6,7 @@ import type {
   StyleProp,
 } from 'react-native';
 
-import type { SurfaceTheme } from '../theme/types';
+import type { SurfaceTheme } from './theme';
 
 export type SurfaceImageSource = string | ImageSourcePropType;
 export type ImageFit = ImageResizeMode;

package/src/types/interactionPolicy.test.ts

@@ -0,0 +1,30 @@
+import { readFileSync } from 'node:fs';
+
+import { describe, expect, it } from 'bun:test';
+
+import type { PressableProps } from '../features/pressable/public';
+import type { InteractionPolicy, InteractionPolicyProps } from './interactionPolicy';
+
+const indexSource = readFileSync(new URL('../index.ts', import.meta.url), 'utf8');
+
+describe('InteractionPolicy ownership', () => {
+  it('exports the policy types from the public root', () => {
+    expect(indexSource).toContain(
+      "export type { InteractionPolicy, InteractionPolicyProps } from './types/interactionPolicy';",
+    );
+  });
+
+  it('keeps the allowed policy values explicit', () => {
+    const enabled: InteractionPolicy = 'enabled';
+    const passive: InteractionPolicy = 'passive';
+
+    expect([enabled, passive]).toEqual(['enabled', 'passive']);
+  });
+
+  it('shares the owned policy contract with PressableProps', () => {
+    const policyProps: InteractionPolicyProps = { interactionPolicy: 'passive' };
+    const pressableProps: PressableProps = policyProps;
+
+    expect(pressableProps.interactionPolicy).toBe('passive');
+  });
+});

package/src/types/layout.ts

@@ -7,7 +7,7 @@ import type {
 } from 'react-native';
 
 import type { Responsive } from '../core/responsive';
-import type { SurfaceTheme } from '../theme/types';
+import type { SurfaceTheme } from './theme';
 
 type SpaceToken = keyof SurfaceTheme['spacing'];
 type RadiusToken = keyof SurfaceTheme['radii'];