@ankhorage/zora 19.0.0 → 20.0.0

package/src/features/authoring/componentMeta.ts

@@ -0,0 +1,190 @@
+import type { ZoraComponentMetaRegistry } from '../../types/authoring';
+import { accordionItemMeta } from '../accordion/accordionItemMeta';
+import { accordionMeta } from '../accordion/accordionMeta';
+import { activityIndicatorMeta } from '../activity-indicator/activityIndicatorMeta';
+import { appBarMeta } from '../app-bar/appBarMeta';
+import { forgotPasswordFormMeta } from '../auth/forgotPasswordFormMeta';
+import { oauthProviderButtonMeta } from '../auth/oauthProviderButtonMeta';
+import { oauthProviderListMeta } from '../auth/oauthProviderListMeta';
+import { otpFormMeta } from '../auth/otpFormMeta';
+import { signInFormMeta } from '../auth/signInFormMeta';
+import { signUpFormMeta } from '../auth/signUpFormMeta';
+import { avatarGroupMeta } from '../avatar/avatarGroupMeta';
+import { avatarMeta } from '../avatar/avatarMeta';
+import { badgeMeta } from '../badge/badgeMeta';
+import { bottomSheetMeta } from '../bottom-sheet/bottomSheetMeta';
+import { breadcrumbsMeta } from '../breadcrumbs/breadcrumbsMeta';
+import { buttonGroupMeta } from '../button/buttonGroupMeta';
+import { buttonMeta } from '../button/buttonMeta';
+import { iconButtonMeta } from '../button/iconButtonMeta';
+import { cardMeta } from '../card/cardMeta';
+import { mediaCardMeta } from '../card/mediaCardMeta';
+import { metricCardMeta } from '../card/metricCardMeta';
+import { postCardMeta } from '../card/postCardMeta';
+import { productCardMeta } from '../card/productCardMeta';
+import { chatListItemMeta } from '../chat/chatListItemMeta';
+import { messageBubbleMeta } from '../chat/messageBubbleMeta';
+import { chipGroupMeta } from '../chip/chipGroupMeta';
+import { chipMeta } from '../chip/chipMeta';
+import { collectionEditorMeta } from '../collection-editor/meta';
+import { contentRailMeta } from '../content-rail/contentRailMeta';
+import { dataTableMeta } from '../data-table/dataTableMeta';
+import { datePickerMeta } from '../date-picker/datePickerMeta';
+import { dialogMeta } from '../dialog/dialogMeta';
+import { emptyStateMeta } from '../empty-state/emptyStateMeta';
+import { checkboxGroupMeta, checkboxMeta } from '../form/checkbox/checkboxMeta';
+import { fieldMeta } from '../form/field/meta';
+import { formActionsMeta } from '../form/formActionsMeta';
+import { formErrorMeta } from '../form/formErrorMeta';
+import { formMeta } from '../form/formMeta';
+import { radioGroupMeta, radioMeta } from '../form/radio/radioMeta';
+import { searchInputMeta } from '../form/search-input/searchInputMeta';
+import { selectMeta } from '../form/select/selectMeta';
+import { switchMeta } from '../form/switch/switchMeta';
+import { textInputMeta } from '../form/text-input/textInputMeta';
+import { gradientMeta } from '../gradient/gradientMeta';
+import { heroMeta } from '../hero/heroMeta';
+import { iconMeta } from '../icon/iconMeta';
+import { imageMeta } from '../image/imageMeta';
+import { keyboardAvoidingViewMeta } from '../keyboard-avoiding-view/keyboardAvoidingViewMeta';
+import { appShellMeta } from '../layout/appShellMeta';
+import { dividerMeta } from '../layout/dividerMeta';
+import { gridMeta } from '../layout/gridMeta';
+import { screenMeta } from '../layout/screenMeta';
+import { scrollViewMeta } from '../layout/scrollViewMeta';
+import { viewMeta } from '../layout/viewMeta';
+import { flatListMeta } from '../list/flatListMeta';
+import { listItemMeta, listMeta, listSectionMeta } from '../list/meta';
+import { sectionListMeta } from '../list/sectionListMeta';
+import { missingElementMeta } from '../missing-element/missingElementMeta';
+import { paginationMeta } from '../pagination/paginationMeta';
+import { paletteItemMeta } from '../palette-item/paletteItemMeta';
+import { popoverMenuMeta } from '../popover-menu/popoverMenuMeta';
+import { progressMeta, progressRingMeta } from '../progress/progressMeta';
+import { ratingMeta } from '../rating/ratingMeta';
+import { readerSurfaceMeta } from '../reader/meta';
+import { barcodeScannerViewMeta, cameraPermissionViewMeta, scanOverlayMeta } from '../scanner/meta';
+import { screenSectionMeta } from '../section/screenSectionMeta';
+import { sectionHeaderMeta } from '../section/sectionHeaderMeta';
+import { selectableItemMeta, selectionProviderMeta } from '../selection/meta';
+import {
+  skeletonCardMeta,
+  skeletonListMeta,
+  skeletonMeta,
+  skeletonTextMeta,
+} from '../skeleton/skeletonMeta';
+import { surfaceMeta } from '../surface/surfaceMeta';
+import { tabListMeta } from '../tabs/tabListMeta';
+import { tabMeta } from '../tabs/tabMeta';
+import { tabPanelMeta } from '../tabs/tabPanelMeta';
+import { tabsMeta } from '../tabs/tabsMeta';
+import { themeModeToggleMeta } from '../theme/ThemeModeToggle.meta';
+import { timePickerMeta } from '../time-picker/timePickerMeta';
+import { timelineMeta } from '../timeline/meta';
+import { toastMeta } from '../toast/toastMeta';
+import { toastProviderMeta } from '../toast/toastProviderMeta';
+import { toolbarMeta } from '../toolbar/toolbarMeta';
+import { treeItemMeta, treeViewMeta } from '../tree-view/meta';
+import { headingMeta } from '../typography/headingMeta';
+import { textMeta } from '../typography/textMeta';
+import { uploaderMeta } from '../uploader/uploaderMeta';
+import { finalizeFeatureMetadata } from './utils/finalizeFeatureMetadata';
+
+export const ZORA_COMPONENT_META: ZoraComponentMetaRegistry = finalizeFeatureMetadata({
+  Accordion: accordionMeta,
+  AccordionItem: accordionItemMeta,
+  ActivityIndicator: activityIndicatorMeta,
+  View: viewMeta,
+  ScrollView: scrollViewMeta,
+  Grid: gridMeta,
+  Divider: dividerMeta,
+  Surface: surfaceMeta,
+  AppBar: appBarMeta,
+  Avatar: avatarMeta,
+  AvatarGroup: avatarGroupMeta,
+  Badge: badgeMeta,
+  Breadcrumbs: breadcrumbsMeta,
+  Button: buttonMeta,
+  ButtonGroup: buttonGroupMeta,
+  Card: cardMeta,
+  Checkbox: checkboxMeta,
+  CheckboxGroup: checkboxGroupMeta,
+  Chip: chipMeta,
+  ChipGroup: chipGroupMeta,
+  DataTable: dataTableMeta,
+  DatePicker: datePickerMeta,
+  Dialog: dialogMeta,
+  Form: formMeta,
+  FormActions: formActionsMeta,
+  FormError: formErrorMeta,
+  Field: fieldMeta,
+  Gradient: gradientMeta,
+  Heading: headingMeta,
+  Icon: iconMeta,
+  IconButton: iconButtonMeta,
+  Image: imageMeta,
+  KeyboardAvoidingView: keyboardAvoidingViewMeta,
+  TextInput: textInputMeta,
+  MediaCard: mediaCardMeta,
+  MetricCard: metricCardMeta,
+  Pagination: paginationMeta,
+  PopoverMenu: popoverMenuMeta,
+  Progress: progressMeta,
+  ProgressRing: progressRingMeta,
+  Radio: radioMeta,
+  RadioGroup: radioGroupMeta,
+  Rating: ratingMeta,
+  SearchInput: searchInputMeta,
+  Select: selectMeta,
+  Switch: switchMeta,
+  Skeleton: skeletonMeta,
+  SkeletonCard: skeletonCardMeta,
+  SkeletonList: skeletonListMeta,
+  SkeletonText: skeletonTextMeta,
+  Tab: tabMeta,
+  TabList: tabListMeta,
+  TabPanel: tabPanelMeta,
+  Tabs: tabsMeta,
+  Text: textMeta,
+  TimePicker: timePickerMeta,
+  Toast: toastMeta,
+  ToastProvider: toastProviderMeta,
+  Toolbar: toolbarMeta,
+  Uploader: uploaderMeta,
+  BottomSheet: bottomSheetMeta,
+  FlatList: flatListMeta,
+  SectionList: sectionListMeta,
+  ThemeModeToggle: themeModeToggleMeta,
+  AppShell: appShellMeta,
+  Screen: screenMeta,
+  ScreenSection: screenSectionMeta,
+  ForgotPasswordForm: forgotPasswordFormMeta,
+  OAuthProviderButton: oauthProviderButtonMeta,
+  OAuthProviderList: oauthProviderListMeta,
+  OtpForm: otpFormMeta,
+  SignInForm: signInFormMeta,
+  SignUpForm: signUpFormMeta,
+  ChatListItem: chatListItemMeta,
+  CollectionEditor: collectionEditorMeta,
+  ContentRail: contentRailMeta,
+  EmptyState: emptyStateMeta,
+  Hero: heroMeta,
+  List: listMeta,
+  ListItem: listItemMeta,
+  ListSection: listSectionMeta,
+  MessageBubble: messageBubbleMeta,
+  MissingElement: missingElementMeta,
+  PostCard: postCardMeta,
+  ProductCard: productCardMeta,
+  ReaderSurface: readerSurfaceMeta,
+  BarcodeScannerView: barcodeScannerViewMeta,
+  CameraPermissionView: cameraPermissionViewMeta,
+  ScanOverlay: scanOverlayMeta,
+  SectionHeader: sectionHeaderMeta,
+  SelectableItem: selectableItemMeta,
+  SelectionProvider: selectionProviderMeta,
+  PaletteItem: paletteItemMeta,
+  Timeline: timelineMeta,
+  TreeItem: treeItemMeta,
+  TreeView: treeViewMeta,
+});

package/src/{constants.ts → features/authoring/constants.ts}

@@ -1,3 +1,5 @@
+import type { ZoraThemeTokenFamily } from '../../types/theme-recipe';
+
 export const COMPONENT_THEME_AUTHORING = {
   authority: 'theme',
   scope: 'component',
@@ -41,3 +43,11 @@ export const FEATURE_MANIFEST_ELEMENTS = {
   uploader: ['Uploader'],
   'bottom-sheet': ['BottomSheet'],
 } as const;
+
+export const ZORA_THEME_TOKEN_FAMILIES = [
+  'colors',
+  'spacing',
+  'radii',
+  'typography',
+  'shadows',
+] as const satisfies readonly ZoraThemeTokenFamily[];

package/src/{featureManifest.test.ts → features/authoring/featureManifest.test.ts}

@@ -2,9 +2,9 @@ import { existsSync } from 'node:fs';
 
 import { expect, test } from 'bun:test';
 
+import { ZORA_CORE_PLUGIN_METADATA } from '../plugin/ZORA_CORE_PLUGIN_METADATA';
+import { ZORA_COMPONENT_META } from './componentMeta';
 import { FEATURE_MANIFEST_ELEMENTS } from './constants';
-import { ZORA_CORE_PLUGIN_METADATA } from './corePluginMetadata';
-import { ZORA_COMPONENT_META } from './metadata/componentMeta';
 
 test('every selected feature element is directly authorable through its canonical public facade', async () => {
   const catalog = new Map(Object.entries(ZORA_COMPONENT_META));

package/src/{metadata → features/authoring}/index.ts

@@ -1,25 +1,3 @@
-export { ZORA_CORE_PLUGIN_METADATA } from '../corePluginMetadata';
-export type {
-  ComposedZoraPluginMetadataCatalog,
-  ZoraPluginMetadata,
-  ZoraPluginPlacement,
-} from '../pluginComposition';
-export { composeZoraPluginMetadata, ZoraPluginCompositionError } from '../pluginComposition';
-export type { ZoraBindableComponentType } from './bindableComponentMeta';
-export { ZORA_BINDABLE_COMPONENT_META } from './bindableComponentMeta';
-export { ZORA_COMPONENT_META } from './componentMeta';
-export { ZORA_THEME_RECIPE_META } from './themeRecipeMeta';
-export type {
-  ZoraThemeRecipeBooleanFieldMeta,
-  ZoraThemeRecipeChoiceFieldMeta,
-  ZoraThemeRecipeFieldMeta,
-  ZoraThemeRecipeKind,
-  ZoraThemeRecipeMeta,
-  ZoraThemeRecipeMetaRegistry,
-  ZoraThemeRecipeTokenFieldMeta,
-  ZoraThemeTokenFamily,
-} from './themeRecipeTypes';
-export { ZORA_THEME_TOKEN_FAMILIES } from './themeRecipeTypes';
 export type {
   ZoraComponentBlueprint,
   ZoraComponentCategory,
@@ -37,4 +15,27 @@ export type {
   ZoraComponentPropType,
   ZoraComponentPropValue,
   ZoraComponentSlotMeta,
-} from './types';
+} from '../../types/authoring';
+export type {
+  ComposedZoraPluginMetadataCatalog,
+  ZoraPluginMetadata,
+  ZoraPluginPlacement,
+} from '../../types/plugin';
+export type {
+  ZoraThemeRecipeBooleanFieldMeta,
+  ZoraThemeRecipeChoiceFieldMeta,
+  ZoraThemeRecipeFieldMeta,
+  ZoraThemeRecipeKind,
+  ZoraThemeRecipeMeta,
+  ZoraThemeRecipeMetaRegistry,
+  ZoraThemeRecipeTokenFieldMeta,
+  ZoraThemeTokenFamily,
+} from '../../types/theme-recipe';
+export { composeZoraPluginMetadata } from '../plugin/application/use-cases/composeZoraPluginMetadata';
+export { ZoraPluginCompositionError } from '../plugin/domain/ZoraPluginCompositionError';
+export { ZORA_CORE_PLUGIN_METADATA } from '../plugin/ZORA_CORE_PLUGIN_METADATA';
+export type { ZoraBindableComponentType } from './bindableComponentMeta';
+export { ZORA_BINDABLE_COMPONENT_META } from './bindableComponentMeta';
+export { ZORA_COMPONENT_META } from './componentMeta';
+export { ZORA_THEME_TOKEN_FAMILIES } from './constants';
+export { ZORA_THEME_RECIPE_META } from './themeRecipeMeta';

package/src/features/authoring/themeRecipeMeta.ts

@@ -0,0 +1,14 @@
+import type { ZoraThemeRecipeMetaRegistry } from '../../types/theme-recipe';
+import { buttonThemeRecipeMeta } from '../button/utils/themeRecipeMeta';
+import { cardThemeRecipeMeta } from '../card/utils/themeRecipeMeta';
+import { radioGroupThemeRecipeMeta } from '../form/radio/themeRecipeMeta';
+import { headingThemeRecipeMeta } from '../typography/utils/headingThemeRecipeMeta';
+import { textThemeRecipeMeta } from '../typography/utils/textThemeRecipeMeta';
+
+export const ZORA_THEME_RECIPE_META: ZoraThemeRecipeMetaRegistry = {
+  Button: buttonThemeRecipeMeta,
+  Card: cardThemeRecipeMeta,
+  Heading: headingThemeRecipeMeta,
+  RadioGroup: radioGroupThemeRecipeMeta,
+  Text: textThemeRecipeMeta,
+};

package/src/{utils → features/authoring/utils}/createManifestBindings.ts

@@ -1,6 +1,6 @@
 import type { UiComponentBindingMeta } from '@ankhorage/contracts';
 
-import type { ZoraComponentMeta } from '../metadata/types';
+import type { ZoraComponentMeta } from '../../../types/authoring';
 
 /*** Derives scalar bindings and normalized events from explicit component authoring schemas. */
 export function createManifestBindings(

package/src/{utils → features/authoring/utils}/finalizeFeatureMetadata.ts

@@ -1,5 +1,5 @@
+import type { ZoraComponentMetaRegistry } from '../../../types/authoring';
 import { FEATURE_MANIFEST_ELEMENTS } from '../constants';
-import type { ZoraComponentMetaRegistry } from '../metadata/types';
 import { createManifestBindings } from './createManifestBindings';
 
 /*** Completes feature bindings while preserving each component's explicit value contracts. */

package/src/features/avatar/adapters/inbound/Avatar.tsx

@@ -2,12 +2,12 @@ import type { RoleSemantics, SurfaceTheme } from '@ankhorage/surface';
 import React from 'react';
 import { Image } from 'react-native';
 
-import type { ZoraColor } from '../../../../internal/recipes';
-import { useZoraTheme } from '../../../../theme/useZoraTheme';
-import { withZoraThemeScope } from '../../../../theme/withZoraThemeScope';
 import type { AvatarProps, AvatarShape, AvatarSize } from '../../../../types/avatar';
+import type { ZoraColor } from '../../../../types/theme';
 import { Icon } from '../../../icon/public';
 import { View } from '../../../layout/public';
+import { withZoraThemeScope } from '../../../theme/adapters/inbound/withZoraThemeScope';
+import { useZoraTheme } from '../../../theme/composition/useZoraTheme';
 import { Text, type TextVariant } from '../../../typography/public';
 import { resolveAvatarInitials } from '../../utils/resolveAvatarInitials';
 /***

package/src/features/avatar/adapters/inbound/AvatarGroup.tsx

@@ -1,9 +1,9 @@
 import React from 'react';
 
-import { useZoraTheme } from '../../../../theme/useZoraTheme';
-import { withZoraThemeScope } from '../../../../theme/withZoraThemeScope';
 import type { AvatarGroupItem, AvatarGroupProps } from '../../../../types/avatar-group';
 import { View } from '../../../layout/public';
+import { withZoraThemeScope } from '../../../theme/adapters/inbound/withZoraThemeScope';
+import { useZoraTheme } from '../../../theme/composition/useZoraTheme';
 import { Avatar } from '../../public';
 /***
  * Renders a compact group of avatars with optional overflow handling.

package/src/features/avatar/avatarGroupMeta.ts

@@ -1,4 +1,4 @@
-import type { ZoraComponentMeta } from '../../metadata/types';
+import type { ZoraComponentMeta } from '../../types/authoring';
 import { avatarMeta } from './avatarMeta';
 
 export const avatarGroupMeta = {

package/src/features/avatar/avatarMeta.ts

@@ -1,4 +1,4 @@
-import type { ZoraComponentMeta } from '../../metadata/types';
+import type { ZoraComponentMeta } from '../../types/authoring';
 
 export const avatarMeta = {
   name: 'Avatar',

package/src/features/badge/adapters/inbound/Badge.tsx

@@ -1,9 +1,9 @@
 import { Badge as SurfaceBadge } from '@ankhorage/surface';
 import React from 'react';
 
-import { resolveBadgeRecipe } from '../../../../internal/recipes';
-import { withZoraThemeScope } from '../../../../theme/withZoraThemeScope';
 import type { BadgeProps } from '../../../../types/badge';
+import { withZoraThemeScope } from '../../../theme/adapters/inbound/withZoraThemeScope';
+import { resolveBadgeRecipe } from '../../utils/resolveBadgeRecipe';
 /***
  * Shows a small status, label, or count indicator.
  */

package/src/features/badge/badgeMeta.ts

@@ -1,4 +1,4 @@
-import type { ZoraComponentMeta } from '../../metadata/types';
+import type { ZoraComponentMeta } from '../../types/authoring';
 
 export const badgeMeta = {
   name: 'Badge',

package/src/features/badge/utils/resolveBadgeRecipe.test.ts

@@ -0,0 +1,9 @@
+import { describe, expect, test } from 'bun:test';
+
+import { resolveBadgeRecipe } from './resolveBadgeRecipe';
+
+describe('resolveBadgeRecipe', () => {
+  test('maps defaults to a soft medium primary badge', () => {
+    expect(resolveBadgeRecipe({})).toEqual({ size: 'm', color: 'primary', variant: 'soft' });
+  });
+});

package/src/features/badge/utils/resolveBadgeRecipe.ts

@@ -0,0 +1,17 @@
+import type { BadgeProps as SurfaceBadgeProps } from '@ankhorage/surface';
+
+import type { ZoraBadgeVariant } from '../../../types/badge';
+import type { ZoraControlSize } from '../../../types/control';
+import type { ZoraColor } from '../../../types/theme';
+
+export function resolveBadgeRecipe({
+  color = 'primary',
+  variant = 'soft',
+  size = 'm',
+}: {
+  color?: ZoraColor;
+  variant?: ZoraBadgeVariant;
+  size?: ZoraControlSize;
+}): Pick<SurfaceBadgeProps, 'size' | 'color' | 'variant'> {
+  return { size, color, variant };
+}

package/src/features/bottom-sheet/adapters/inbound/BottomSheet.tsx

@@ -1,11 +1,11 @@
 import { useBottomSheet } from '@ankhorage/surface/bottom-sheet';
 import React from 'react';
 
-import { useZoraTheme } from '../../../../theme/useZoraTheme';
-import { withZoraThemeScope } from '../../../../theme/withZoraThemeScope';
-import { useZoraThemeRuntime } from '../../../../theme/ZoraThemeRuntimeContext';
 import type { BottomSheetProps } from '../../../../types/manifest-bottom-sheet';
 import { View } from '../../../layout/public';
+import { withZoraThemeScope } from '../../../theme/adapters/inbound/withZoraThemeScope';
+import { useZoraTheme } from '../../../theme/composition/useZoraTheme';
+import { useZoraThemeRuntime } from '../../../theme/composition/ZoraThemeRuntimeContext';
 
 /*** Presents declarative manifest children through the shared Surface sheet host. */
 export const BottomSheet = withZoraThemeScope(BottomSheetInner);

package/src/features/bottom-sheet/bottomSheetMeta.ts

@@ -1,5 +1,5 @@
-import { CONTAINER_ALLOWED_CHILDREN } from '../../metadata/allowedChildren';
-import type { ZoraComponentMeta } from '../../metadata/types';
+import type { ZoraComponentMeta } from '../../types/authoring';
+import { CONTAINER_ALLOWED_CHILDREN } from '../authoring/allowedChildren';
 
 export const bottomSheetMeta = {
   name: 'BottomSheet',

package/src/features/bottom-sheet/public.test.ts

@@ -34,9 +34,9 @@ describe('ZORA BottomSheet public contract', () => {
   test('installs BottomSheet only in the enabled native runtime capability host', async () => {
     const [provider, nativeCapabilities, webCapabilities, nativeDatePicker, nativeTimePicker] =
       await Promise.all([
-        Bun.file('src/theme/ZoraProvider.tsx').text(),
-        Bun.file('src/theme/ZoraRuntimeCapabilities.native.tsx').text(),
-        Bun.file('src/theme/ZoraRuntimeCapabilities.web.tsx').text(),
+        Bun.file('src/features/theme/adapters/inbound/ZoraProvider.tsx').text(),
+        Bun.file('src/features/theme/composition/ZoraRuntimeCapabilities.native.tsx').text(),
+        Bun.file('src/features/theme/composition/ZoraRuntimeCapabilities.web.tsx').text(),
         Bun.file('src/features/date-picker/adapters/inbound/DatePicker.native.tsx').text(),
         Bun.file('src/features/time-picker/adapters/inbound/TimePicker.native.tsx').text(),
       ]);

package/src/features/breadcrumbs/adapters/inbound/Breadcrumbs.tsx

@@ -1,8 +1,5 @@
 import React from 'react';
 
-import { resolveIconSize } from '../../../../internal/recipes';
-import { useZoraTheme } from '../../../../theme/useZoraTheme';
-import { withZoraThemeScope } from '../../../../theme/withZoraThemeScope';
 import type {
   BreadcrumbItem,
   BreadcrumbPressEvent,
@@ -10,7 +7,10 @@ import type {
 } from '../../../../types/breadcrumbs';
 import { Button } from '../../../button/public';
 import { Icon } from '../../../icon/public';
+import { resolveIconSize } from '../../../icon/utils/resolveIconSize';
 import { View } from '../../../layout/public';
+import { withZoraThemeScope } from '../../../theme/adapters/inbound/withZoraThemeScope';
+import { useZoraTheme } from '../../../theme/composition/useZoraTheme';
 import { Text } from '../../../typography/public';
 
 /*** Renders a breadcrumb trail whose final item represents the current location. */

package/src/features/breadcrumbs/breadcrumbsMeta.ts

@@ -1,4 +1,4 @@
-import type { ZoraComponentMeta } from '../../metadata';
+import type { ZoraComponentMeta } from '../authoring';
 
 export const breadcrumbsMeta = {
   name: 'Breadcrumbs',

package/src/features/button/adapters/inbound/Button.tsx

@@ -1,9 +1,9 @@
 import { Button as SurfaceButton } from '@ankhorage/surface';
 import React from 'react';
 
-import { useZoraThemeRecipe } from '../../../../theme/useZoraThemeRecipe';
-import { withZoraThemeScope } from '../../../../theme/withZoraThemeScope';
 import type { ButtonProps } from '../../../../types/button';
+import { withZoraThemeScope } from '../../../theme/adapters/inbound/withZoraThemeScope';
+import { useZoraThemeRecipe } from '../../../theme/composition/useZoraThemeRecipe';
 import { resolveButtonThemeRecipe } from '../../utils/resolveButtonThemeRecipe';
 /***
  * Theme-aware action control for primary, secondary, destructive, and neutral actions.

package/src/features/button/adapters/inbound/ButtonGroup.tsx

@@ -1,12 +1,12 @@
 import React from 'react';
 
-import { withZoraThemeScope } from '../../../../theme/withZoraThemeScope';
 import type {
   ButtonGroupAlign,
   ButtonGroupOrientation,
   ButtonGroupProps,
 } from '../../../../types/button-group';
 import { View } from '../../../layout/public';
+import { withZoraThemeScope } from '../../../theme/adapters/inbound/withZoraThemeScope';
 /***
  * Groups multiple `Button` elements with consistent spacing and alignment.
  */

package/src/features/button/adapters/inbound/IconButton.tsx

@@ -1,9 +1,9 @@
 import { IconButton as SurfaceIconButton } from '@ankhorage/surface';
 import React from 'react';
 
-import { resolveButtonRecipe } from '../../../../internal/recipes';
-import { withZoraThemeScope } from '../../../../theme/withZoraThemeScope';
 import type { IconButtonProps } from '../../../../types/icon-button';
+import { withZoraThemeScope } from '../../../theme/adapters/inbound/withZoraThemeScope';
+import { resolveButtonRecipe } from '../../utils/resolveButtonRecipe';
 /***
  * Icon-only button for compact actions; requires an accessible `label`.
  */

package/src/features/button/buttonGroupMeta.ts

@@ -1,4 +1,4 @@
-import type { ZoraComponentMeta } from '../../metadata';
+import type { ZoraComponentMeta } from '../authoring';
 
 export const buttonGroupMeta = {
   name: 'ButtonGroup',

package/src/features/button/buttonMeta.ts

@@ -1,6 +1,6 @@
-import { COMPONENT_THEME_AUTHORING } from '../../constants';
-import { ZORA_COLORS } from '../../internal/colorModel';
-import type { ZoraComponentMeta } from '../../metadata';
+import type { ZoraComponentMeta } from '../authoring';
+import { COMPONENT_THEME_AUTHORING } from '../authoring/constants';
+import { ZORA_COLORS } from '../theme/colorModel';
 
 export const buttonMeta = {
   name: 'Button',

package/src/features/button/iconButtonMeta.ts

@@ -1,4 +1,4 @@
-import type { ZoraComponentMeta } from '../../metadata/types';
+import type { ZoraComponentMeta } from '../../types/authoring';
 
 export const iconButtonMeta = {
   name: 'IconButton',

package/src/features/button/utils/resolveButtonRecipe.test.ts

@@ -0,0 +1,9 @@
+import { describe, expect, test } from 'bun:test';
+
+import { resolveButtonRecipe } from './resolveButtonRecipe';
+
+describe('resolveButtonRecipe', () => {
+  test('maps defaults to a large solid primary button', () => {
+    expect(resolveButtonRecipe({})).toEqual({ size: 'l', color: 'primary', variant: 'solid' });
+  });
+});

package/src/features/button/utils/resolveButtonRecipe.ts

@@ -0,0 +1,17 @@
+import type { ButtonProps as SurfaceButtonProps } from '@ankhorage/surface';
+
+import type { ZoraButtonVariant } from '../../../types/button';
+import type { ZoraControlSize } from '../../../types/control';
+import type { ZoraColor } from '../../../types/theme';
+
+export function resolveButtonRecipe({
+  color = 'primary',
+  variant = 'solid',
+  size = 'l',
+}: {
+  color?: ZoraColor;
+  variant?: ZoraButtonVariant;
+  size?: ZoraControlSize;
+}): Pick<SurfaceButtonProps, 'size' | 'color' | 'variant'> {
+  return { size, color, variant };
+}

package/src/features/button/utils/resolveButtonThemeRecipe.ts

@@ -1,11 +1,9 @@
 import type { ThemeRecipeOverrideValue } from '@ankhorage/contracts';
 
-import {
-  resolveButtonRecipe,
-  type ZoraButtonVariant,
-  type ZoraColor,
-  type ZoraControlSize,
-} from '../../../internal/recipes';
+import type { ZoraButtonVariant } from '../../../types/button';
+import type { ZoraControlSize } from '../../../types/control';
+import type { ZoraColor } from '../../../types/theme';
+import { resolveButtonRecipe } from './resolveButtonRecipe';
 
 export function resolveButtonThemeRecipe(input: {
   readonly color?: ZoraColor;

package/src/features/button/utils/themeRecipeMeta.ts

@@ -1,5 +1,5 @@
-import { ZORA_COLORS } from '../../../internal/colorModel';
-import type { ZoraThemeRecipeMeta } from '../../../metadata/themeRecipeTypes';
+import type { ZoraThemeRecipeMeta } from '../../../types/theme-recipe';
+import { ZORA_COLORS } from '../../theme/colorModel';
 
 export const buttonThemeRecipeMeta = {
   name: 'Button',

package/src/features/card/adapters/inbound/Card.tsx

@@ -1,14 +1,14 @@
 import { Card as SurfaceCard } from '@ankhorage/surface';
 import React from 'react';
 
-import { resolveCardVariant } from '../../../../internal/recipes';
-import { useZoraThemeRecipe } from '../../../../theme/useZoraThemeRecipe';
-import { withZoraThemeScope } from '../../../../theme/withZoraThemeScope';
 import type { CardProps } from '../../../../types/card';
 import { View } from '../../../layout/public';
+import { withZoraThemeScope } from '../../../theme/adapters/inbound/withZoraThemeScope';
+import { useZoraThemeRecipe } from '../../../theme/composition/useZoraThemeRecipe';
 import { Heading } from '../../../typography/public';
 import { Text } from '../../../typography/public';
 import { resolveCardThemeRecipe } from '../../utils/resolveCardThemeRecipe';
+import { resolveCardVariant } from '../../utils/resolveCardVariant';
 /***
  * Structured content container with built-in heading, description, actions, and footer slots.
  *

package/src/features/card/adapters/inbound/MediaCard.tsx

@@ -1,10 +1,10 @@
 import React from 'react';
 import { Image } from 'react-native';
 
-import { useZoraTheme } from '../../../../theme/useZoraTheme';
-import { withZoraThemeScope } from '../../../../theme/withZoraThemeScope';
 import type { MediaCardProps } from '../../../../types/media-card';
 import { View } from '../../../layout/public';
+import { withZoraThemeScope } from '../../../theme/adapters/inbound/withZoraThemeScope';
+import { useZoraTheme } from '../../../theme/composition/useZoraTheme';
 import { Heading } from '../../../typography/public';
 import { Text } from '../../../typography/public';
 import { Card } from '../../public';