@ankhorage/zora 22.0.72 → 22.0.74

package/src/features/graph-view/adapters/inbound/web-artifact/syncGraphElements.ts

@@ -1,8 +1,8 @@
 import { isRecord } from '@ankhorage/utility/object';
 import type { Core } from 'cytoscape';
 
+import type { GraphViewEdge, GraphViewNode } from '../../../../../types/graph-view';
 import { createRenderableGraphElements } from './createRenderableGraphElements';
-import type { GraphViewEdge, GraphViewNode } from './GraphView';
 
 /***
  * Reconciles graph data in one batch while retaining positions, selection and element identity.

package/src/features/graph-view/public.ts

@@ -1,18 +1,18 @@
-export {
-  GraphView,
-  type GraphViewCallbacks,
-  type GraphViewController,
-  type GraphViewEdge,
-  type GraphViewElementEvent,
-  type GraphViewElementEventType,
-  type GraphViewFitOptions,
-  type GraphViewLayoutName,
-  type GraphViewNode,
-  type GraphViewNodeRenderContext,
-  type GraphViewPoint,
-  type GraphViewProps,
-  type GraphViewRenderedNode,
-  type GraphViewSize,
-  type GraphViewStyleRule,
-  type GraphViewViewport,
-} from './adapters/inbound/web-artifact/GraphView';
+export type {
+  GraphViewCallbacks,
+  GraphViewController,
+  GraphViewEdge,
+  GraphViewElementEvent,
+  GraphViewElementEventType,
+  GraphViewFitOptions,
+  GraphViewLayoutName,
+  GraphViewNode,
+  GraphViewNodeRenderContext,
+  GraphViewPoint,
+  GraphViewProps,
+  GraphViewRenderedNode,
+  GraphViewSize,
+  GraphViewStyleRule,
+  GraphViewViewport,
+} from '../../types/graph-view';
+export { GraphView } from './adapters/inbound/web-artifact/GraphView';

package/src/features/hero/heroMeta.ts

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

package/src/features/icon/iconMeta.ts

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

package/src/features/icon/utils/meta.test.ts

@@ -1,21 +1,12 @@
 import { expect, test } from 'bun:test';
 
-import { ZORA_COMPONENT_META } from '../../authoring/componentMeta';
+import { CONTAINER_ALLOWED_CHILDREN } from '../../../constants/authoring';
+import { iconMeta } from '../iconMeta';
 
-test('permits media-backed Icon and Image content in ordinary screen containers', () => {
-  const icon = ZORA_COMPONENT_META.Icon;
-  expect(icon.directManifestNode).toBe(true);
-  expect(icon.allowedChildren).toEqual([]);
-  expect(icon.props.source).toMatchObject({ type: 'media', mediaKinds: ['image'] });
-  for (const container of [
-    ZORA_COMPONENT_META.View,
-    ZORA_COMPONENT_META.ScrollView,
-    ZORA_COMPONENT_META.Grid,
-    ZORA_COMPONENT_META.Card,
-    ZORA_COMPONENT_META.Screen,
-    ZORA_COMPONENT_META.ScreenSection,
-  ]) {
-    expect(container.allowedChildren).toContain('Icon');
-    expect(container.allowedChildren).toContain('Image');
-  }
+test('permits media-backed Icon and Image content in ordinary containers', () => {
+  expect(iconMeta.directManifestNode).toBe(true);
+  expect(iconMeta.allowedChildren).toEqual([]);
+  expect(iconMeta.props.source).toMatchObject({ type: 'media', mediaKinds: ['image'] });
+  expect(CONTAINER_ALLOWED_CHILDREN).toContain('Icon');
+  expect(CONTAINER_ALLOWED_CHILDREN).toContain('Image');
 });

package/src/features/image/imageMeta.ts

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

package/src/features/keyboard-avoiding-view/keyboardAvoidingViewMeta.ts

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

package/src/features/layout/appShellMeta.ts

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

package/src/features/layout/gridMeta.ts

@@ -1,10 +1,10 @@
-import type { ZoraComponentMeta } from '../../types/authoring';
 import {
   CHESS_ALLOWED_CHILDREN,
   CONTAINER_ALLOWED_CHILDREN,
   GAME_ALLOWED_CHILDREN,
   TABLETOP_ALLOWED_CHILDREN,
-} from '../authoring/allowedChildren';
+} from '../../constants/authoring';
+import type { ZoraComponentMeta } from '../../types/authoring';
 import { LAYOUT_PROPS } from './constants';
 
 export const gridMeta = {

package/src/features/layout/screenMeta.ts

@@ -1,5 +1,5 @@
-import type { ZoraComponentMeta } from '../authoring';
-import { SCREEN_ALLOWED_CHILDREN } from '../authoring/allowedChildren';
+import { SCREEN_ALLOWED_CHILDREN } from '../../constants/authoring';
+import type { ZoraComponentMeta } from '../../types/authoring';
 
 export const screenMeta = {
   name: 'Screen',

package/src/features/layout/scrollViewMeta.ts

@@ -1,5 +1,5 @@
+import { CONTAINER_ALLOWED_CHILDREN } from '../../constants/authoring';
 import type { ZoraComponentMeta } from '../../types/authoring';
-import { CONTAINER_ALLOWED_CHILDREN } from '../authoring/allowedChildren';
 import { LAYOUT_PROPS } from './constants';
 
 export const scrollViewMeta = {

package/src/features/layout/viewMeta.ts

@@ -1,9 +1,9 @@
-import type { ZoraComponentMeta } from '../../types/authoring';
 import {
   CHESS_ALLOWED_CHILDREN,
   CONTAINER_ALLOWED_CHILDREN,
   GAME_ALLOWED_CHILDREN,
-} from '../authoring/allowedChildren';
+} from '../../constants/authoring';
+import type { ZoraComponentMeta } from '../../types/authoring';
 import { LAYOUT_PROPS } from './constants';
 
 export const viewMeta = {

package/src/features/list/flatListMeta.ts

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

package/src/features/list/meta.ts

@@ -1,4 +1,4 @@
-import type { ZoraComponentMeta } from '../authoring';
+import type { ZoraComponentMeta } from '../../types/authoring';
 
 const LIST_NOTE =
   'List feature component; collection authoring is represented through List metadata.';

package/src/features/missing-element/MissingElement.test.ts

@@ -1,11 +1,11 @@
 import { describe, expect, test } from 'bun:test';
 
-import { ZORA_BINDABLE_COMPONENT_META, ZORA_COMPONENT_META } from '../authoring';
+import { cardMeta } from '../card/cardMeta';
+import { emptyStateMeta } from '../empty-state/emptyStateMeta';
 import { missingElementMeta } from './missingElementMeta';
 
 describe('MissingElement draft contract', () => {
   test('is a release-blocking manifest leaf distinct from completed states', () => {
-    expect(ZORA_COMPONENT_META.MissingElement).toBe(missingElementMeta);
     expect(missingElementMeta.directManifestNode).toBe(true);
     expect(missingElementMeta.allowedChildren).toEqual([]);
     expect(missingElementMeta.manifestPolicy).toEqual({
@@ -13,8 +13,8 @@ describe('MissingElement draft contract', () => {
       availability: 'draft-only',
       releaseGate: 'blocked',
     });
-    expect(ZORA_COMPONENT_META.Card.manifestPolicy).toBeUndefined();
-    expect(ZORA_COMPONENT_META.EmptyState.manifestPolicy).toBeUndefined();
+    expect(cardMeta.manifestPolicy).toBeUndefined();
+    expect(emptyStateMeta.manifestPolicy).toBeUndefined();
   });
 
   test('captures only stable serializable gap and layout data', () => {
@@ -34,10 +34,11 @@ describe('MissingElement draft contract', () => {
     expect(() => JSON.stringify(missingElementMeta)).not.toThrow();
   });
 
-  test('has no event, data-binding, runtime-requirement, or fallback contract', () => {
+  test('has no event, data-binding, runtime-requirement, or fallback contract', async () => {
     expect(missingElementMeta.events).toBeUndefined();
     expect(missingElementMeta.requirements).toBeUndefined();
-    expect(ZORA_BINDABLE_COMPONENT_META).not.toHaveProperty('MissingElement');
+    const bindableSource = await Bun.file('src/features/registry/bindableComponentMeta.ts').text();
+    expect(bindableSource).not.toContain('MissingElement');
   });
 
   test('visibly and accessibly identifies the gap while preserving its minimum dimensions', async () => {

package/src/features/missing-element/missingElementMeta.ts

@@ -1,4 +1,4 @@
-import type { ZoraComponentMeta } from '../authoring';
+import type { ZoraComponentMeta } from '../../types/authoring';
 
 const instanceAuthoring = { authority: 'instance' } as const;
 

package/src/features/palette-item/paletteItemMeta.ts

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

package/src/features/popover-menu/popoverMenuMeta.ts

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

package/src/features/progress/progressMeta.ts

@@ -1,4 +1,4 @@
-import type { ZoraComponentMeta } from '../authoring';
+import type { ZoraComponentMeta } from '../../types/authoring';
 import { ZORA_COLORS } from '../theme/colorModel';
 
 export const progressMeta = {

package/src/features/reader/meta.ts

@@ -1,5 +1,5 @@
-import type { ZoraComponentMeta } from '../authoring';
-import { CONTAINER_ALLOWED_CHILDREN } from '../authoring/allowedChildren';
+import { CONTAINER_ALLOWED_CHILDREN } from '../../constants/authoring';
+import type { ZoraComponentMeta } from '../../types/authoring';
 
 const EMPTY_EVENT_FIELDS = [] as const;
 

package/src/features/{authoring → registry}/componentMeta.ts

@@ -102,7 +102,7 @@ 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';
+import { finalizeFeatureMetadata } from './finalizeFeatureMetadata';
 
 export const ZORA_COMPONENT_META: ZoraComponentMetaRegistry = finalizeFeatureMetadata({
   Accordion: accordionMeta,

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

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

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

@@ -2,8 +2,8 @@ import { existsSync } from 'node:fs';
 
 import { expect, test } from 'bun:test';
 
+import { FEATURE_MANIFEST_ELEMENTS } from '../../constants/authoring';
 import { ZORA_COMPONENT_META } from './componentMeta';
-import { FEATURE_MANIFEST_ELEMENTS } from './constants';
 
 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/features/{authoring/utils → registry}/finalizeFeatureMetadata.ts

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

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

@@ -1,3 +1,4 @@
+export { ZORA_THEME_TOKEN_FAMILIES } from '../../constants/authoring';
 export type {
   ZoraComponentBlueprint,
   ZoraComponentCategory,
@@ -29,5 +30,4 @@ export type {
 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/scanner/meta.ts

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

package/src/features/section/screenSectionMeta.ts

@@ -1,5 +1,5 @@
-import type { ZoraComponentMeta } from '../authoring';
-import { SCREEN_SECTION_ALLOWED_CHILDREN } from '../authoring/allowedChildren';
+import { SCREEN_SECTION_ALLOWED_CHILDREN } from '../../constants/authoring';
+import type { ZoraComponentMeta } from '../../types/authoring';
 
 export const screenSectionMeta = {
   name: 'ScreenSection',

package/src/features/section/sectionHeaderMeta.ts

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

package/src/features/selection/meta.ts

@@ -1,4 +1,4 @@
-import type { ZoraComponentMeta } from '../authoring';
+import type { ZoraComponentMeta } from '../../types/authoring';
 
 const SELECTION_NOTE = 'Selection pattern component; not represented as a manifest node in v1.';
 

package/src/features/skeleton/public.test.ts

@@ -1,6 +1,6 @@
 import { expect, test } from 'bun:test';
 
-import { ZORA_COMPONENT_META } from '../authoring/componentMeta';
+import { skeletonCardMeta, skeletonListMeta, skeletonMeta, skeletonTextMeta } from './skeletonMeta';
 
 test('skeletons support direct authoring and automatic feature loading states', async () => {
   const [dataTableSource, publicSource] = await Promise.all([
@@ -8,15 +8,15 @@ test('skeletons support direct authoring and automatic feature loading states',
     Bun.file('src/features/skeleton/public.ts').text(),
   ]);
 
-  expect(ZORA_COMPONENT_META.Skeleton.directManifestNode).toBe(true);
-  expect(ZORA_COMPONENT_META.SkeletonCard.directManifestNode).toBe(true);
-  expect(ZORA_COMPONENT_META.SkeletonList.directManifestNode).toBe(true);
-  expect(ZORA_COMPONENT_META.SkeletonText.directManifestNode).toBe(true);
+  expect(skeletonMeta.directManifestNode).toBe(true);
+  expect(skeletonCardMeta.directManifestNode).toBe(true);
+  expect(skeletonListMeta.directManifestNode).toBe(true);
+  expect(skeletonTextMeta.directManifestNode).toBe(true);
   expect(publicSource).toContain('Skeleton');
   expect(publicSource).toContain('SkeletonCard');
   expect(publicSource).toContain('SkeletonList');
   expect(publicSource).toContain('SkeletonText');
-  expect(ZORA_COMPONENT_META.SkeletonList.bindings?.props?.rows?.value.type).toBe('number');
+  expect(skeletonListMeta.props.rows.type).toBe('number');
 
   expect(dataTableSource).toContain("from '../../../skeleton/public'");
   expect(dataTableSource).toContain('if (loading)');

package/src/features/skeleton/skeletonMeta.ts

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

package/src/features/surface/surfaceMeta.ts

@@ -1,5 +1,5 @@
+import { CONTAINER_ALLOWED_CHILDREN } from '../../constants/authoring';
 import type { ZoraComponentMeta } from '../../types/authoring';
-import { CONTAINER_ALLOWED_CHILDREN } from '../authoring/allowedChildren';
 import { LAYOUT_PROPS } from '../layout/constants';
 
 export const surfaceMeta = {

package/src/features/tabs/tabPanelMeta.ts

@@ -1,5 +1,5 @@
+import { CONTAINER_ALLOWED_CHILDREN } from '../../constants/authoring';
 import type { ZoraComponentMeta } from '../../types/authoring';
-import { CONTAINER_ALLOWED_CHILDREN } from '../authoring/allowedChildren';
 import { LAYOUT_PROPS } from '../layout/constants';
 
 export const tabPanelMeta = {

package/src/features/theme/ThemeModeToggle.meta.ts

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

package/src/features/theme/composition/useZoraThemeRecipe.ts

@@ -1,7 +1,9 @@
+import type { ZoraThemeRecipeMeta } from '../../../types/theme-recipe';
 import { resolveZoraThemeRecipe } from '../utils/resolveZoraThemeRecipe';
 import { useZoraTheme } from './useZoraTheme';
 
-export function useZoraThemeRecipe(recipeName: string) {
+/*** Resolve one feature-owned theme recipe against the active ZORA theme. */
+export function useZoraThemeRecipe(meta: ZoraThemeRecipeMeta) {
   const { theme } = useZoraTheme();
-  return resolveZoraThemeRecipe(theme, recipeName);
+  return resolveZoraThemeRecipe(theme, meta);
 }

package/src/features/theme/utils/resolveZoraThemeRecipe.test.ts

@@ -1,6 +1,7 @@
 import type { ThemeConfig } from '@ankhorage/contracts';
 import { describe, expect, test } from 'bun:test';
 
+import type { ZoraThemeRecipeMeta } from '../../../types/theme-recipe';
 import { resolveZoraThemeRecipe } from './resolveZoraThemeRecipe';
 
 const baseConfig: ThemeConfig = {
@@ -11,6 +12,32 @@ const baseConfig: ThemeConfig = {
   tokens: { spacing: { hero: 64 } },
 };
 
+const buttonRecipeMeta = {
+  name: 'Button',
+  kind: 'component',
+  fields: {
+    color: { type: 'choice', label: 'Color', options: ['primary', 'danger'], default: 'primary' },
+    variant: { type: 'choice', label: 'Variant', options: ['solid', 'soft'], default: 'solid' },
+    size: { type: 'choice', label: 'Size', options: ['s', 'm', 'l'], default: 'l' },
+  },
+} as const satisfies ZoraThemeRecipeMeta;
+
+const cardRecipeMeta = {
+  name: 'Card',
+  kind: 'component',
+  fields: {
+    tone: {
+      type: 'choice',
+      label: 'Tone',
+      options: ['default', 'outline'],
+      default: 'default',
+    },
+    padding: { type: 'token', label: 'Padding', tokenFamily: 'spacing' },
+    radius: { type: 'token', label: 'Radius', tokenFamily: 'radii', default: 'l' },
+    compact: { type: 'boolean', label: 'Compact', default: false },
+  },
+} as const satisfies ZoraThemeRecipeMeta;
+
 function runtimeTheme(config: ThemeConfig) {
   return {
     config,
@@ -26,6 +53,7 @@ function runtimeTheme(config: ThemeConfig) {
   };
 }
 
+/*** Add persisted recipes to the reusable test theme config. */
 function withRecipes(recipes: ThemeConfig['recipes']): ThemeConfig {
   return { ...baseConfig, recipes };
 }
@@ -35,7 +63,7 @@ describe('resolveZoraThemeRecipe', () => {
     const theme = runtimeTheme(
       withRecipes({ components: { Card: { tone: 'outline', padding: 'hero' } } }),
     );
-    expect(resolveZoraThemeRecipe(theme, 'Card')).toEqual({
+    expect(resolveZoraThemeRecipe(theme, cardRecipeMeta)).toEqual({
       tone: 'outline',
       padding: 'hero',
       radius: 'l',
@@ -47,7 +75,7 @@ describe('resolveZoraThemeRecipe', () => {
     const theme = runtimeTheme(
       withRecipes({ components: { Button: { variant: 'soft', retiredField: 'legacy' } } }),
     );
-    expect(resolveZoraThemeRecipe(theme, 'Button')).toEqual({
+    expect(resolveZoraThemeRecipe(theme, buttonRecipeMeta)).toEqual({
       color: 'primary',
       variant: 'soft',
       size: 'l',
@@ -56,17 +84,26 @@ describe('resolveZoraThemeRecipe', () => {
 
   test('rejects invalid known choices and token references', () => {
     const choiceTheme = runtimeTheme(withRecipes({ components: { Button: { variant: 'neon' } } }));
-    expect(() => resolveZoraThemeRecipe(choiceTheme, 'Button')).toThrow(
+    expect(() => resolveZoraThemeRecipe(choiceTheme, buttonRecipeMeta)).toThrow(
       'Invalid theme recipe choice',
     );
 
     const tokenTheme = runtimeTheme(withRecipes({ components: { Card: { padding: 'missing' } } }));
-    expect(() => resolveZoraThemeRecipe(tokenTheme, 'Card')).toThrow('Unknown spacing token');
+    expect(() => resolveZoraThemeRecipe(tokenTheme, cardRecipeMeta)).toThrow(
+      'Unknown spacing token',
+    );
   });
 
-  test('rejects code requests for unknown recipe names', () => {
-    expect(() => resolveZoraThemeRecipe(runtimeTheme(baseConfig), 'Missing')).toThrow(
-      'Unknown ZORA theme recipe',
-    );
+  test('resolves pattern recipes from the pattern namespace', () => {
+    const patternMeta = {
+      name: 'Hero',
+      kind: 'pattern',
+      fields: {
+        compact: { type: 'boolean', label: 'Compact', default: false },
+      },
+    } as const satisfies ZoraThemeRecipeMeta;
+    const theme = runtimeTheme(withRecipes({ patterns: { Hero: { compact: true } } }));
+
+    expect(resolveZoraThemeRecipe(theme, patternMeta)).toEqual({ compact: true });
   });
 });

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

@@ -1,7 +1,10 @@
 import type { ThemeConfig, ThemeRecipeOverrideValue } from '@ankhorage/contracts';
 
-import type { ZoraThemeRecipeFieldMeta, ZoraThemeTokenFamily } from '../../../types/theme-recipe';
-import { ZORA_THEME_RECIPE_META } from '../../authoring/themeRecipeMeta';
+import type {
+  ZoraThemeRecipeFieldMeta,
+  ZoraThemeRecipeMeta,
+  ZoraThemeTokenFamily,
+} from '../../../types/theme-recipe';
 
 interface ZoraThemeRecipeRuntimeTheme {
   readonly config: ThemeConfig;
@@ -16,15 +19,12 @@ interface ZoraThemeRecipeRuntimeTheme {
   };
 }
 
-const recipeMetaByName = new Map(Object.entries(ZORA_THEME_RECIPE_META));
-
+/*** Resolve one feature-owned theme recipe against persisted theme overrides. */
 export function resolveZoraThemeRecipe(
   theme: ZoraThemeRecipeRuntimeTheme,
-  recipeName: string,
+  meta: ZoraThemeRecipeMeta,
 ): Readonly<Record<string, ThemeRecipeOverrideValue>> {
-  const meta = recipeMetaByName.get(recipeName);
-  if (!meta) throw new RangeError(`Unknown ZORA theme recipe: ${recipeName}.`);
-
+  const recipeName = meta.name;
   const recipes =
     meta.kind === 'component' ? theme.config.recipes?.components : theme.config.recipes?.patterns;
   const overrides = new Map(Object.entries(recipes ?? {})).get(recipeName);
@@ -44,6 +44,7 @@ export function resolveZoraThemeRecipe(
   return Object.fromEntries(resolved);
 }
 
+/*** Validate one persisted recipe value against its feature-owned metadata. */
 function validateFieldValue(
   theme: ZoraThemeRecipeRuntimeTheme,
   recipeName: string,
@@ -70,6 +71,7 @@ function validateFieldValue(
   }
 }
 
+/*** Check whether one runtime theme exposes the referenced token. */
 function hasThemeToken(
   theme: ZoraThemeRecipeRuntimeTheme,
   family: ZoraThemeTokenFamily,
@@ -86,6 +88,7 @@ function hasThemeToken(
   );
 }
 
+/*** Check an own property without traversing the prototype chain. */
 function hasOwn(value: object, key: PropertyKey): boolean {
   return Object.prototype.hasOwnProperty.call(value, key);
 }

package/src/features/time-picker/public.test.ts

@@ -1,6 +1,6 @@
 import { expect, test } from 'bun:test';
 
-import { ZORA_COMPONENT_META } from '../authoring/componentMeta';
+import { timePickerMeta } from './timePickerMeta';
 
 test('TimePicker keeps one manifest contract across native and web presentation hosts', async () => {
   const nativeSource = await Bun.file(
@@ -12,12 +12,10 @@ test('TimePicker keeps one manifest contract across native and web presentation
   const contentSource = await Bun.file(
     'src/features/time-picker/composition/TimePickerContent.tsx',
   ).text();
-  const meta = ZORA_COMPONENT_META.TimePicker;
 
-  expect(meta.directManifestNode).toBe(true);
-  expect(meta.props.value?.type).toBe('string');
-  expect(meta.events?.valueChange?.eventType).toBe('timePicker.valueChange');
-  expect(meta.bindings?.props?.value?.value.type).toBe('string');
+  expect(timePickerMeta.directManifestNode).toBe(true);
+  expect(timePickerMeta.props.value.type).toBe('string');
+  expect(timePickerMeta.events.valueChange.eventType).toBe('timePicker.valueChange');
   expect(nativeSource).toContain('useBottomSheet()');
   expect(webSource).toContain('<Popover');
   expect(webSource).not.toContain('useBottomSheet');

package/src/features/time-picker/timePickerMeta.ts

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

package/src/features/timeline/meta.ts

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

package/src/features/toast/public.test.ts

@@ -1,6 +1,7 @@
 import { expect, test } from 'bun:test';
 
-import { ZORA_COMPONENT_META } from '../authoring/componentMeta';
+import { toastMeta } from './toastMeta';
+import { toastProviderMeta } from './toastProviderMeta';
 
 test('Toast stays imperative and installs its host only when the ZoraProvider capability is enabled', async () => {
   const [publicSource, providerSource, webCapabilities, nativeCapabilities] = await Promise.all([
@@ -10,8 +11,8 @@ test('Toast stays imperative and installs its host only when the ZoraProvider ca
     Bun.file('src/features/theme/composition/ZoraRuntimeCapabilities.native.tsx').text(),
   ]);
 
-  expect(ZORA_COMPONENT_META.Toast?.directManifestNode).toBe(false);
-  expect(ZORA_COMPONENT_META.ToastProvider?.directManifestNode).toBe(false);
+  expect(toastMeta.directManifestNode).toBe(false);
+  expect(toastProviderMeta.directManifestNode).toBe(false);
   expect(publicSource).toContain("useToast } from '@ankhorage/surface'");
   expect(providerSource).toContain('toast = false');
   expect(webCapabilities).toContain('if (!toast)');