@ankhorage/zora 19.0.0 → 19.0.1

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';

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

@@ -1,12 +1,13 @@
 import React from 'react';
 
-import { resolveBadgeRecipe, resolveIconSize } from '../../../../internal/recipes';
-import { useZoraTheme } from '../../../../theme/useZoraTheme';
-import { withZoraThemeScope } from '../../../../theme/withZoraThemeScope';
 import type { MetricCardProps } from '../../../../types/metric-card';
 import { Badge } from '../../../badge/public';
+import { resolveBadgeRecipe } from '../../../badge/utils/resolveBadgeRecipe';
 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 { Heading } from '../../../typography/public';
 import { Text } from '../../../typography/public';
 import { Card } from '../../public';

package/src/features/card/adapters/inbound/PostCard.test.tsx

@@ -1,6 +1,6 @@
 import { describe, expect, test } from 'bun:test';
 
-import { ZORA_COMPONENT_META } from '../../../../metadata';
+import { ZORA_COMPONENT_META } from '../../../authoring';
 
 describe('PostCard', () => {
   test('is registered as a public ZORA pattern', () => {

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

@@ -1,8 +1,6 @@
 import React from 'react';
 import { Image as ReactNativeImage } from 'react-native';
 
-import { useZoraTheme } from '../../../../theme/useZoraTheme';
-import { withZoraThemeScope } from '../../../../theme/withZoraThemeScope';
 import type {
   PostAction,
   PostAuthor,
@@ -13,6 +11,8 @@ import type {
 import { Avatar } from '../../../avatar/public';
 import { Button } from '../../../button/public';
 import { Divider, View } from '../../../layout/public';
+import { withZoraThemeScope } from '../../../theme/adapters/inbound/withZoraThemeScope';
+import { useZoraTheme } from '../../../theme/composition/useZoraTheme';
 import { Text } from '../../../typography/public';
 import { Card } from '../../public';
 /***

package/src/features/card/adapters/inbound/ProductCard.test.tsx

@@ -1,6 +1,6 @@
 import { describe, expect, test } from 'bun:test';
 
-import { ZORA_COMPONENT_META } from '../../../../metadata';
+import { ZORA_COMPONENT_META } from '../../../authoring';
 
 describe('ProductCard', () => {
   test('is registered as a public ZORA pattern', () => {

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

@@ -1,12 +1,12 @@
 import React from 'react';
 
-import { withZoraThemeScope } from '../../../../theme/withZoraThemeScope';
-import type { ZoraBaseProps } from '../../../../theme/ZoraBaseProps';
+import type { ZoraBaseProps } from '../../../../types/base';
 import type { ProductCardProps } from '../../../../types/product-card';
 import { Badge } from '../../../badge/public';
 import { Button } from '../../../button/public';
 import { Image } from '../../../image/public';
 import { Divider, View } from '../../../layout/public';
+import { withZoraThemeScope } from '../../../theme/adapters/inbound/withZoraThemeScope';
 import { Heading } from '../../../typography/public';
 import { Text } from '../../../typography/public';
 import { Card } from '../../public';

package/src/features/card/cardMeta.ts

@@ -1,6 +1,6 @@
-import { COMPONENT_THEME_AUTHORING } from '../../constants';
-import type { ZoraComponentMeta } from '../../metadata';
-import { CONTAINER_ALLOWED_CHILDREN } from '../../metadata/allowedChildren';
+import type { ZoraComponentMeta } from '../authoring';
+import { CONTAINER_ALLOWED_CHILDREN } from '../authoring/allowedChildren';
+import { COMPONENT_THEME_AUTHORING } from '../authoring/constants';
 
 export const cardMeta = {
   name: 'Card',

package/src/features/card/mediaCardMeta.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 mediaCardMeta = {
   name: 'MediaCard',

package/src/features/card/metricCardMeta.ts

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

package/src/features/card/postCardMeta.ts

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

package/src/features/card/productCardMeta.ts

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

package/src/features/card/utils/resolveCardThemeRecipe.ts

@@ -1,6 +1,6 @@
 import type { ThemeRecipeOverrideValue } from '@ankhorage/contracts';
 
-import type { ZoraCardTone } from '../../../internal/recipes';
+import type { ZoraCardTone } from '../../../types/card';
 
 export function resolveCardThemeRecipe(input: {
   readonly tone?: ZoraCardTone;

package/src/features/card/utils/resolveCardVariant.test.ts

@@ -0,0 +1,11 @@
+import { describe, expect, test } from 'bun:test';
+
+import { resolveCardVariant } from './resolveCardVariant';
+
+describe('resolveCardVariant', () => {
+  test('maps card tones to Surface variants', () => {
+    expect(resolveCardVariant()).toBe('raised');
+    expect(resolveCardVariant('outline')).toBe('outline');
+    expect(resolveCardVariant('subtle')).toBe('subtle');
+  });
+});

package/src/features/card/utils/resolveCardVariant.ts

@@ -0,0 +1,15 @@
+import type { CardProps as SurfaceCardProps } from '@ankhorage/surface';
+
+import type { ZoraCardTone } from '../../../types/card';
+
+export function resolveCardVariant(tone: ZoraCardTone = 'default'): SurfaceCardProps['variant'] {
+  switch (tone) {
+    case 'outline':
+      return 'outline';
+    case 'subtle':
+      return 'subtle';
+    case 'default':
+    default:
+      return 'raised';
+  }
+}

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

@@ -1,4 +1,4 @@
-import type { ZoraThemeRecipeMeta } from '../../../metadata/themeRecipeTypes';
+import type { ZoraThemeRecipeMeta } from '../../../types/theme-recipe';
 
 export const cardThemeRecipeMeta = {
   name: 'Card',

package/src/features/chat/adapters/inbound/ChatListItem.test.tsx

@@ -1,6 +1,6 @@
 import { describe, expect, test } from 'bun:test';
 
-import { ZORA_COMPONENT_META } from '../../../../metadata';
+import { ZORA_COMPONENT_META } from '../../../authoring';
 
 describe('ChatListItem', () => {
   test('is registered as a public ZORA pattern', () => {