@ankhorage/zora 0.8.0 → 0.9.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 0.9.0
+
+### Minor Changes
+
+- 3745d82: Introduces the ZORA theme seed model with `ZoraTheme`, `ZoraComputedTheme`, and
+  `zoraDefaultTheme`, replacing public override/config terminology with app-facing
+  theme terminology.
+
+## 0.8.1
+
+### Patch Changes
+
+- f7e5fdc: Stop resolving localization internally in Text and Heading. Localization keys now remain passive fallback content so runtime integrations can resolve localized display props before rendering.
+
 ## 0.8.0
 
 ### Minor Changes

package/README.md

@@ -122,21 +122,21 @@ responsive for mobile and web layouts.
 
 ZORA props:
 
-| Prop            | Type                                        | Default     | Notes                                      |
-| --------------- | ------------------------------------------- | ----------- | ------------------------------------------ |
-| `children`      | `React.ReactNode`                           | -           | Primary content.                           |
-| `text`          | `string`                                    | -           | Manifest-friendly content prop.            |
-| `i18nKey`       | `string`                                    | -           | Translation key fallback.                  |
-| `level`         | `HeadingLevel`                              | `2`         | Semantic heading level from `1` through `6`. |
-| `size`          | `Responsive<HeadingSize>`                   | level size  | Visual scale: `display`, `h1` through `h6`. |
-| `tone`          | `Responsive<HeadingTone>`                   | `'default'` | Semantic text color.                       |
-| `align`         | `Responsive<HeadingAlign>`                  | -           | Text alignment.                            |
-| `weight`        | `Responsive<HeadingWeight>`                 | recipe      | Optional structured weight override.       |
-| `italic`        | `boolean`                                   | `false`     | Italic style.                              |
-| `numberOfLines` | `number`                                    | -           | Native/web truncation line count.          |
-| `ellipsizeMode` | `'head' \| 'middle' \| 'tail' \| 'clip'`    | -           | Truncation behavior.                       |
-| `selectable`    | `boolean`                                   | -           | Allows text selection where supported.     |
-| `testID`        | `string`                                    | -           | Test id.                                   |
+| Prop            | Type                                     | Default     | Notes                                        |
+| --------------- | ---------------------------------------- | ----------- | -------------------------------------------- |
+| `children`      | `React.ReactNode`                        | -           | Primary content.                             |
+| `text`          | `string`                                 | -           | Manifest-friendly content prop.              |
+| `i18nKey`       | `string`                                 | -           | Runtime-resolved fallback key when no content prop is provided.                    |
+| `level`         | `HeadingLevel`                           | `2`         | Semantic heading level from `1` through `6`. |
+| `size`          | `Responsive<HeadingSize>`                | level size  | Visual scale: `display`, `h1` through `h6`.  |
+| `tone`          | `Responsive<HeadingTone>`                | `'default'` | Semantic text color.                         |
+| `align`         | `Responsive<HeadingAlign>`               | -           | Text alignment.                              |
+| `weight`        | `Responsive<HeadingWeight>`              | recipe      | Optional structured weight override.         |
+| `italic`        | `boolean`                                | `false`     | Italic style.                                |
+| `numberOfLines` | `number`                                 | -           | Native/web truncation line count.            |
+| `ellipsizeMode` | `'head' \| 'middle' \| 'tail' \| 'clip'` | -           | Truncation behavior.                         |
+| `selectable`    | `boolean`                                | -           | Allows text selection where supported.       |
+| `testID`        | `string`                                 | -           | Test id.                                     |
 
 No inherited props. `HeadingProps` is declared directly by ZORA to keep heading
 usage structured and template-safe.
@@ -167,7 +167,7 @@ ZORA props:
 | --------------- | ---------------------------------------- | ----------- | -------------------------------------- |
 | `children`      | `React.ReactNode`                        | -           | Primary content.                       |
 | `text`          | `string`                                 | -           | Manifest-friendly content prop.        |
-| `i18nKey`       | `string`                                 | -           | Translation key fallback.              |
+| `i18nKey`       | `string`                                 | -           | Runtime-resolved fallback key when no content prop is provided.              |
 | `variant`       | `Responsive<TextVariant>`                | `'body'`    | Typography recipe.                     |
 | `tone`          | `Responsive<TextTone>`                   | `'default'` | Semantic text color.                   |
 | `align`         | `Responsive<TextAlign>`                  | -           | Text alignment.                        |
@@ -1310,16 +1310,33 @@ Theme provider that creates the ZORA theme and passes it to Surface
 </ZoraProvider>
 ```
 
+Pass a theme seed to define your app theme:
+
+```tsx
+<ZoraProvider
+  initialMode="dark"
+  theme={{
+    id: 'studio',
+    name: 'Studio',
+    primaryColor: '#0f766e',
+    harmony: 'analogous',
+    tone: 'jewel',
+  }}
+>
+  <App />
+</ZoraProvider>
+```
+
 <details>
 <summary>Props</summary>
 
 ZORA props:
 
-| Prop            | Type                | Default   | Notes                                                           |
-| --------------- | ------------------- | --------- | --------------------------------------------------------------- |
-| `children`      | `React.ReactNode`   | -         | Required app content.                                           |
-| `initialConfig` | `ZoraThemeOverride` | -         | Partial Surface `ThemeConfig` override merged into `zoraTheme`. |
-| `initialMode`   | `'light' \| 'dark'` | `'light'` | Initial theme mode passed to Surface.                           |
+| Prop          | Type                 | Default            | Notes                                  |
+| ------------- | -------------------- | ------------------ | -------------------------------------- |
+| `children`    | `React.ReactNode`    | -                  | Required app content.                  |
+| `theme`       | `ZoraTheme`          | `zoraDefaultTheme` | App-facing theme seed for ZORA.        |
+| `initialMode` | `'light' \| 'dark'`  | `'light'`          | Initial theme mode passed to Surface.  |
 
 Inherited props:
 
@@ -1327,15 +1344,17 @@ No inherited props. `ZoraProviderProps` is declared directly by ZORA.
 
 </details>
 
-### `createZoraTheme`
+### `createZoraThemeConfig`
 
-Creates a Surface `ThemeConfig` by deep-merging overrides into `zoraTheme`.
+Creates a Surface-compatible `ThemeConfig` from a ZORA theme seed.
 
 ```tsx
-const theme = createZoraTheme({
-  light: {
-    primaryColor: '#1d4ed8',
-  },
+const themeConfig = createZoraThemeConfig({
+  id: 'studio',
+  name: 'Studio',
+  primaryColor: '#0f766e',
+  harmony: 'analogous',
+  tone: 'jewel',
 });
 ```
 
@@ -1343,37 +1362,25 @@ const theme = createZoraTheme({
 <summary>API</summary>
 
 ```ts
-type ZoraThemeOverride = Partial<ThemeConfig>;
-
-function createZoraTheme(overrides?: ZoraThemeOverride): ThemeConfig;
+function createZoraThemeConfig(theme?: ZoraTheme): ThemeConfig;
 ```
 
-The returned theme keeps `id: 'zora'` unless explicitly changed by the merge
-input.
-
 </details>
 
-### `zoraTheme`
+### `zoraDefaultTheme`
 
-Default ZORA Surface theme preset.
+Default ZORA theme seed.
 
 <details>
 <summary>Value</summary>
 
 ```ts
-const zoraTheme: ThemeConfig = {
+const zoraDefaultTheme: ZoraTheme = {
   id: 'zora',
   name: 'ZORA',
-  light: {
-    primaryColor: '#0f766e',
-    harmony: 'analogous',
-    systemTone: 'jewel',
-  },
-  dark: {
-    primaryColor: '#2dd4bf',
-    harmony: 'analogous',
-    systemTone: 'jewel',
-  },
+  primaryColor: '#0f766e',
+  harmony: 'analogous',
+  tone: 'jewel',
 };
 ```
 

package/dist/components/heading/Heading.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Heading.d.ts","sourceRoot":"","sources":["../../../src/components/heading/Heading.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAK1B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAkC5C,wBAAgB,OAAO,CAAC,EACtB,QAAQ,EACR,IAAI,EACJ,OAAO,EACP,KAAS,EACT,IAAI,EACJ,IAAgB,EAChB,KAAK,EACL,MAAM,EACN,MAAc,EACd,aAAa,EACb,aAAa,EACb,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EACjB,iBAA4B,EAC5B,QAAQ,EACR,MAAM,GACP,EAAE,YAAY,4BAoCd"}
+{"version":3,"file":"Heading.d.ts","sourceRoot":"","sources":["../../../src/components/heading/Heading.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAK1B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AA0B5C,wBAAgB,OAAO,CAAC,EACtB,QAAQ,EACR,IAAI,EACJ,OAAO,EACP,KAAS,EACT,IAAI,EACJ,IAAgB,EAChB,KAAK,EACL,MAAM,EACN,MAAc,EACd,aAAa,EACb,aAAa,EACb,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EACjB,iBAA4B,EAC5B,QAAQ,EACR,MAAM,GACP,EAAE,YAAY,4BAmCd"}

package/dist/components/heading/Heading.js

@@ -1,9 +1,9 @@
-import { resolveResponsive, useResponsiveRuntime, useTranslationContext } from '@ankhorage/surface';
+import { resolveResponsive, useResponsiveRuntime } from '@ankhorage/surface';
 import React from 'react';
 import { Text as ReactNativeText } from 'react-native';
 import { useZoraTheme } from '../../theme/useZoraTheme';
 import { resolveHeadingRecipe, resolveHeadingSizeFromLevel } from './resolveHeadingRecipe';
-function resolveHeadingContent({ children, text, i18nKey, translate, }) {
+function resolveHeadingContent({ children, text, i18nKey, }) {
     if (children !== undefined) {
         return children;
     }
@@ -13,20 +13,12 @@ function resolveHeadingContent({ children, text, i18nKey, translate, }) {
     if (!i18nKey) {
         return null;
     }
-    try {
-        const translated = translate(i18nKey);
-        return translated && translated !== i18nKey ? translated : i18nKey;
-    }
-    catch (error) {
-        console.warn('[ZoraHeading] Translation error:', error);
-        return i18nKey;
-    }
+    return i18nKey;
 }
 export function Heading({ children, text, i18nKey, level = 2, size, tone = 'default', align, weight, italic = false, numberOfLines, ellipsizeMode, selectable, accessibilityLabel, accessibilityHint, accessibilityRole = 'header', nativeID, testID, }) {
     const { theme } = useZoraTheme();
     const { breakpoint } = useResponsiveRuntime();
-    const { t } = useTranslationContext();
-    const content = resolveHeadingContent({ children, text, i18nKey, translate: t });
+    const content = resolveHeadingContent({ children, text, i18nKey });
     const resolvedSize = resolveResponsive(size, breakpoint) ?? resolveHeadingSizeFromLevel(level);
     const resolvedTone = resolveResponsive(tone, breakpoint) ?? 'default';
     const resolvedAlign = resolveResponsive(align, breakpoint);

package/dist/components/heading/Heading.js.map

@@ -1 +1 @@
-{"version":3,"file":"Heading.js","sourceRoot":"","sources":["../../../src/components/heading/Heading.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AACpG,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,IAAI,IAAI,eAAe,EAAE,MAAM,cAAc,CAAC;AAEvD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAG3F,SAAS,qBAAqB,CAAC,EAC7B,QAAQ,EACR,IAAI,EACJ,OAAO,EACP,SAAS,GAMV;IACC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;QACtC,OAAO,UAAU,IAAI,UAAU,KAAK,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC;IACrE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,kCAAkC,EAAE,KAAK,CAAC,CAAC;QACxD,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,EACtB,QAAQ,EACR,IAAI,EACJ,OAAO,EACP,KAAK,GAAG,CAAC,EACT,IAAI,EACJ,IAAI,GAAG,SAAS,EAChB,KAAK,EACL,MAAM,EACN,MAAM,GAAG,KAAK,EACd,aAAa,EACb,aAAa,EACb,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,GAAG,QAAQ,EAC5B,QAAQ,EACR,MAAM,GACO;IACb,MAAM,EAAE,KAAK,EAAE,GAAG,YAAY,EAAE,CAAC;IACjC,MAAM,EAAE,UAAU,EAAE,GAAG,oBAAoB,EAAE,CAAC;IAC9C,MAAM,EAAE,CAAC,EAAE,GAAG,qBAAqB,EAAE,CAAC;IACtC,MAAM,OAAO,GAAG,qBAAqB,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC;IACjF,MAAM,YAAY,GAAG,iBAAiB,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,2BAA2B,CAAC,KAAK,CAAC,CAAC;IAC/F,MAAM,YAAY,GAAG,iBAAiB,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,SAAS,CAAC;IACtE,MAAM,aAAa,GAAG,iBAAiB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IAC3D,MAAM,cAAc,GAAG,iBAAiB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAE7D,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC9C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,CACL,CAAC,eAAe,CACd,iBAAiB,CAAC,CAAC,iBAAiB,CAAC,CACrC,kBAAkB,CAAC,CAAC,kBAAkB,CAAC,CACvC,iBAAiB,CAAC,CAAC,iBAAiB,CAAC,CACrC,aAAa,CAAC,CAAC,aAAa,CAAC,CAC7B,QAAQ,CAAC,CAAC,QAAQ,CAAC,CACnB,aAAa,CAAC,CAAC,aAAa,CAAC,CAC7B,UAAU,CAAC,CAAC,UAAU,CAAC,CACvB,MAAM,CAAC,CAAC,MAAM,CAAC,CACf,KAAK,CAAC,CAAC,oBAAoB,CAAC,KAAK,EAAE;YACjC,KAAK,EAAE,aAAa;YACpB,MAAM;YACN,KAAK;YACL,IAAI,EAAE,YAAY;YAClB,IAAI,EAAE,YAAY;YAClB,MAAM,EAAE,cAAc;SACvB,CAAC,CAAC,CAEH;MAAA,CAAC,OAAO,CACV;IAAA,EAAE,eAAe,CAAC,CACnB,CAAC;AACJ,CAAC","sourcesContent":["import { resolveResponsive, useResponsiveRuntime, useTranslationContext } from '@ankhorage/surface';\nimport React from 'react';\nimport { Text as ReactNativeText } from 'react-native';\n\nimport { useZoraTheme } from '../../theme/useZoraTheme';\nimport { resolveHeadingRecipe, resolveHeadingSizeFromLevel } from './resolveHeadingRecipe';\nimport type { HeadingProps } from './types';\n\nfunction resolveHeadingContent({\n  children,\n  text,\n  i18nKey,\n  translate,\n}: {\n  children: HeadingProps['children'];\n  text: HeadingProps['text'];\n  i18nKey: HeadingProps['i18nKey'];\n  translate: (key: string) => string;\n}): React.ReactNode {\n  if (children !== undefined) {\n    return children;\n  }\n\n  if (text !== undefined) {\n    return text;\n  }\n\n  if (!i18nKey) {\n    return null;\n  }\n\n  try {\n    const translated = translate(i18nKey);\n    return translated && translated !== i18nKey ? translated : i18nKey;\n  } catch (error) {\n    console.warn('[ZoraHeading] Translation error:', error);\n    return i18nKey;\n  }\n}\n\nexport function Heading({\n  children,\n  text,\n  i18nKey,\n  level = 2,\n  size,\n  tone = 'default',\n  align,\n  weight,\n  italic = false,\n  numberOfLines,\n  ellipsizeMode,\n  selectable,\n  accessibilityLabel,\n  accessibilityHint,\n  accessibilityRole = 'header',\n  nativeID,\n  testID,\n}: HeadingProps) {\n  const { theme } = useZoraTheme();\n  const { breakpoint } = useResponsiveRuntime();\n  const { t } = useTranslationContext();\n  const content = resolveHeadingContent({ children, text, i18nKey, translate: t });\n  const resolvedSize = resolveResponsive(size, breakpoint) ?? resolveHeadingSizeFromLevel(level);\n  const resolvedTone = resolveResponsive(tone, breakpoint) ?? 'default';\n  const resolvedAlign = resolveResponsive(align, breakpoint);\n  const resolvedWeight = resolveResponsive(weight, breakpoint);\n\n  if (content === null || content === undefined) {\n    return null;\n  }\n\n  return (\n    <ReactNativeText\n      accessibilityHint={accessibilityHint}\n      accessibilityLabel={accessibilityLabel}\n      accessibilityRole={accessibilityRole}\n      ellipsizeMode={ellipsizeMode}\n      nativeID={nativeID}\n      numberOfLines={numberOfLines}\n      selectable={selectable}\n      testID={testID}\n      style={resolveHeadingRecipe(theme, {\n        align: resolvedAlign,\n        italic,\n        level,\n        size: resolvedSize,\n        tone: resolvedTone,\n        weight: resolvedWeight,\n      })}\n    >\n      {content}\n    </ReactNativeText>\n  );\n}\n"]}
+{"version":3,"file":"Heading.js","sourceRoot":"","sources":["../../../src/components/heading/Heading.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,IAAI,IAAI,eAAe,EAAE,MAAM,cAAc,CAAC;AAEvD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAG3F,SAAS,qBAAqB,CAAC,EAC7B,QAAQ,EACR,IAAI,EACJ,OAAO,GAKR;IACC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,EACtB,QAAQ,EACR,IAAI,EACJ,OAAO,EACP,KAAK,GAAG,CAAC,EACT,IAAI,EACJ,IAAI,GAAG,SAAS,EAChB,KAAK,EACL,MAAM,EACN,MAAM,GAAG,KAAK,EACd,aAAa,EACb,aAAa,EACb,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,GAAG,QAAQ,EAC5B,QAAQ,EACR,MAAM,GACO;IACb,MAAM,EAAE,KAAK,EAAE,GAAG,YAAY,EAAE,CAAC;IACjC,MAAM,EAAE,UAAU,EAAE,GAAG,oBAAoB,EAAE,CAAC;IAC9C,MAAM,OAAO,GAAG,qBAAqB,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IACnE,MAAM,YAAY,GAAG,iBAAiB,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,2BAA2B,CAAC,KAAK,CAAC,CAAC;IAC/F,MAAM,YAAY,GAAG,iBAAiB,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,SAAS,CAAC;IACtE,MAAM,aAAa,GAAG,iBAAiB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IAC3D,MAAM,cAAc,GAAG,iBAAiB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAE7D,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC9C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,CACL,CAAC,eAAe,CACd,iBAAiB,CAAC,CAAC,iBAAiB,CAAC,CACrC,kBAAkB,CAAC,CAAC,kBAAkB,CAAC,CACvC,iBAAiB,CAAC,CAAC,iBAAiB,CAAC,CACrC,aAAa,CAAC,CAAC,aAAa,CAAC,CAC7B,QAAQ,CAAC,CAAC,QAAQ,CAAC,CACnB,aAAa,CAAC,CAAC,aAAa,CAAC,CAC7B,UAAU,CAAC,CAAC,UAAU,CAAC,CACvB,MAAM,CAAC,CAAC,MAAM,CAAC,CACf,KAAK,CAAC,CAAC,oBAAoB,CAAC,KAAK,EAAE;YACjC,KAAK,EAAE,aAAa;YACpB,MAAM;YACN,KAAK;YACL,IAAI,EAAE,YAAY;YAClB,IAAI,EAAE,YAAY;YAClB,MAAM,EAAE,cAAc;SACvB,CAAC,CAAC,CAEH;MAAA,CAAC,OAAO,CACV;IAAA,EAAE,eAAe,CAAC,CACnB,CAAC;AACJ,CAAC","sourcesContent":["import { resolveResponsive, useResponsiveRuntime } from '@ankhorage/surface';\nimport React from 'react';\nimport { Text as ReactNativeText } from 'react-native';\n\nimport { useZoraTheme } from '../../theme/useZoraTheme';\nimport { resolveHeadingRecipe, resolveHeadingSizeFromLevel } from './resolveHeadingRecipe';\nimport type { HeadingProps } from './types';\n\nfunction resolveHeadingContent({\n  children,\n  text,\n  i18nKey,\n}: {\n  children: HeadingProps['children'];\n  text: HeadingProps['text'];\n  i18nKey: HeadingProps['i18nKey'];\n}): React.ReactNode {\n  if (children !== undefined) {\n    return children;\n  }\n\n  if (text !== undefined) {\n    return text;\n  }\n\n  if (!i18nKey) {\n    return null;\n  }\n\n  return i18nKey;\n}\n\nexport function Heading({\n  children,\n  text,\n  i18nKey,\n  level = 2,\n  size,\n  tone = 'default',\n  align,\n  weight,\n  italic = false,\n  numberOfLines,\n  ellipsizeMode,\n  selectable,\n  accessibilityLabel,\n  accessibilityHint,\n  accessibilityRole = 'header',\n  nativeID,\n  testID,\n}: HeadingProps) {\n  const { theme } = useZoraTheme();\n  const { breakpoint } = useResponsiveRuntime();\n  const content = resolveHeadingContent({ children, text, i18nKey });\n  const resolvedSize = resolveResponsive(size, breakpoint) ?? resolveHeadingSizeFromLevel(level);\n  const resolvedTone = resolveResponsive(tone, breakpoint) ?? 'default';\n  const resolvedAlign = resolveResponsive(align, breakpoint);\n  const resolvedWeight = resolveResponsive(weight, breakpoint);\n\n  if (content === null || content === undefined) {\n    return null;\n  }\n\n  return (\n    <ReactNativeText\n      accessibilityHint={accessibilityHint}\n      accessibilityLabel={accessibilityLabel}\n      accessibilityRole={accessibilityRole}\n      ellipsizeMode={ellipsizeMode}\n      nativeID={nativeID}\n      numberOfLines={numberOfLines}\n      selectable={selectable}\n      testID={testID}\n      style={resolveHeadingRecipe(theme, {\n        align: resolvedAlign,\n        italic,\n        level,\n        size: resolvedSize,\n        tone: resolvedTone,\n        weight: resolvedWeight,\n      })}\n    >\n      {content}\n    </ReactNativeText>\n  );\n}\n"]}

package/dist/components/text/Text.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Text.d.ts","sourceRoot":"","sources":["../../../src/components/text/Text.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAK1B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAkCzC,wBAAgB,IAAI,CAAC,EACnB,QAAQ,EACR,IAAI,EACJ,OAAO,EACP,OAAgB,EAChB,IAAgB,EAChB,KAAK,EACL,MAAM,EACN,MAAc,EACd,aAAa,EACb,aAAa,EACb,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,QAAQ,EACR,MAAM,GACP,EAAE,SAAS,4BAmCX"}
+{"version":3,"file":"Text.d.ts","sourceRoot":"","sources":["../../../src/components/text/Text.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAK1B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AA0BzC,wBAAgB,IAAI,CAAC,EACnB,QAAQ,EACR,IAAI,EACJ,OAAO,EACP,OAAgB,EAChB,IAAgB,EAChB,KAAK,EACL,MAAM,EACN,MAAc,EACd,aAAa,EACb,aAAa,EACb,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,QAAQ,EACR,MAAM,GACP,EAAE,SAAS,4BAkCX"}

package/dist/components/text/Text.js

@@ -1,9 +1,9 @@
-import { resolveResponsive, useResponsiveRuntime, useTranslationContext } from '@ankhorage/surface';
+import { resolveResponsive, useResponsiveRuntime } from '@ankhorage/surface';
 import React from 'react';
 import { Text as ReactNativeText } from 'react-native';
 import { useZoraTheme } from '../../theme/useZoraTheme';
 import { resolveTextStyle } from './resolveTextRecipe';
-function resolveTextContent({ children, text, i18nKey, translate, }) {
+function resolveTextContent({ children, text, i18nKey, }) {
     if (children !== undefined) {
         return children;
     }
@@ -13,20 +13,12 @@ function resolveTextContent({ children, text, i18nKey, translate, }) {
     if (!i18nKey) {
         return null;
     }
-    try {
-        const translated = translate(i18nKey);
-        return translated && translated !== i18nKey ? translated : i18nKey;
-    }
-    catch (error) {
-        console.warn('[ZoraText] Translation error:', error);
-        return i18nKey;
-    }
+    return i18nKey;
 }
 export function Text({ children, text, i18nKey, variant = 'body', tone = 'default', align, weight, italic = false, numberOfLines, ellipsizeMode, selectable, accessibilityLabel, accessibilityHint, accessibilityRole, nativeID, testID, }) {
     const { theme } = useZoraTheme();
     const { breakpoint } = useResponsiveRuntime();
-    const { t } = useTranslationContext();
-    const content = resolveTextContent({ children, text, i18nKey, translate: t });
+    const content = resolveTextContent({ children, text, i18nKey });
     const resolvedVariant = resolveResponsive(variant, breakpoint) ?? 'body';
     const resolvedStyle = resolveTextStyle({
         theme,

package/dist/components/text/Text.js.map

@@ -1 +1 @@
-{"version":3,"file":"Text.js","sourceRoot":"","sources":["../../../src/components/text/Text.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AACpG,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,IAAI,IAAI,eAAe,EAAE,MAAM,cAAc,CAAC;AAEvD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAGvD,SAAS,kBAAkB,CAAC,EAC1B,QAAQ,EACR,IAAI,EACJ,OAAO,EACP,SAAS,GAMV;IACC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;QACtC,OAAO,UAAU,IAAI,UAAU,KAAK,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC;IACrE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,+BAA+B,EAAE,KAAK,CAAC,CAAC;QACrD,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,EACnB,QAAQ,EACR,IAAI,EACJ,OAAO,EACP,OAAO,GAAG,MAAM,EAChB,IAAI,GAAG,SAAS,EAChB,KAAK,EACL,MAAM,EACN,MAAM,GAAG,KAAK,EACd,aAAa,EACb,aAAa,EACb,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,QAAQ,EACR,MAAM,GACI;IACV,MAAM,EAAE,KAAK,EAAE,GAAG,YAAY,EAAE,CAAC;IACjC,MAAM,EAAE,UAAU,EAAE,GAAG,oBAAoB,EAAE,CAAC;IAC9C,MAAM,EAAE,CAAC,EAAE,GAAG,qBAAqB,EAAE,CAAC;IACtC,MAAM,OAAO,GAAG,kBAAkB,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC;IAC9E,MAAM,eAAe,GAAG,iBAAiB,CAAC,OAAO,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC;IACzE,MAAM,aAAa,GAAG,gBAAgB,CAAC;QACrC,KAAK;QACL,UAAU;QACV,OAAO,EAAE,eAAe;QACxB,IAAI;QACJ,KAAK;QACL,MAAM;QACN,MAAM;KACP,CAAC,CAAC;IAEH,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC9C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,CACL,CAAC,eAAe,CACd,iBAAiB,CAAC,CAAC,iBAAiB,CAAC,CACrC,kBAAkB,CAAC,CAAC,kBAAkB,CAAC,CACvC,iBAAiB,CAAC,CAAC,iBAAiB,CAAC,CACrC,aAAa,CAAC,CAAC,aAAa,CAAC,CAC7B,QAAQ,CAAC,CAAC,QAAQ,CAAC,CACnB,aAAa,CAAC,CAAC,aAAa,CAAC,CAC7B,UAAU,CAAC,CAAC,UAAU,CAAC,CACvB,MAAM,CAAC,CAAC,MAAM,CAAC,CACf,KAAK,CAAC,CAAC,aAAa,CAAC,CAErB;MAAA,CAAC,OAAO,CACV;IAAA,EAAE,eAAe,CAAC,CACnB,CAAC;AACJ,CAAC","sourcesContent":["import { resolveResponsive, useResponsiveRuntime, useTranslationContext } from '@ankhorage/surface';\nimport React from 'react';\nimport { Text as ReactNativeText } from 'react-native';\n\nimport { useZoraTheme } from '../../theme/useZoraTheme';\nimport { resolveTextStyle } from './resolveTextRecipe';\nimport type { TextProps } from './types';\n\nfunction resolveTextContent({\n  children,\n  text,\n  i18nKey,\n  translate,\n}: {\n  children: TextProps['children'];\n  text: TextProps['text'];\n  i18nKey: TextProps['i18nKey'];\n  translate: (key: string) => string;\n}): React.ReactNode {\n  if (children !== undefined) {\n    return children;\n  }\n\n  if (text !== undefined) {\n    return text;\n  }\n\n  if (!i18nKey) {\n    return null;\n  }\n\n  try {\n    const translated = translate(i18nKey);\n    return translated && translated !== i18nKey ? translated : i18nKey;\n  } catch (error) {\n    console.warn('[ZoraText] Translation error:', error);\n    return i18nKey;\n  }\n}\n\nexport function Text({\n  children,\n  text,\n  i18nKey,\n  variant = 'body',\n  tone = 'default',\n  align,\n  weight,\n  italic = false,\n  numberOfLines,\n  ellipsizeMode,\n  selectable,\n  accessibilityLabel,\n  accessibilityHint,\n  accessibilityRole,\n  nativeID,\n  testID,\n}: TextProps) {\n  const { theme } = useZoraTheme();\n  const { breakpoint } = useResponsiveRuntime();\n  const { t } = useTranslationContext();\n  const content = resolveTextContent({ children, text, i18nKey, translate: t });\n  const resolvedVariant = resolveResponsive(variant, breakpoint) ?? 'body';\n  const resolvedStyle = resolveTextStyle({\n    theme,\n    breakpoint,\n    variant: resolvedVariant,\n    tone,\n    align,\n    weight,\n    italic,\n  });\n\n  if (content === null || content === undefined) {\n    return null;\n  }\n\n  return (\n    <ReactNativeText\n      accessibilityHint={accessibilityHint}\n      accessibilityLabel={accessibilityLabel}\n      accessibilityRole={accessibilityRole}\n      ellipsizeMode={ellipsizeMode}\n      nativeID={nativeID}\n      numberOfLines={numberOfLines}\n      selectable={selectable}\n      testID={testID}\n      style={resolvedStyle}\n    >\n      {content}\n    </ReactNativeText>\n  );\n}\n"]}
+{"version":3,"file":"Text.js","sourceRoot":"","sources":["../../../src/components/text/Text.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,IAAI,IAAI,eAAe,EAAE,MAAM,cAAc,CAAC;AAEvD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAGvD,SAAS,kBAAkB,CAAC,EAC1B,QAAQ,EACR,IAAI,EACJ,OAAO,GAKR;IACC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,EACnB,QAAQ,EACR,IAAI,EACJ,OAAO,EACP,OAAO,GAAG,MAAM,EAChB,IAAI,GAAG,SAAS,EAChB,KAAK,EACL,MAAM,EACN,MAAM,GAAG,KAAK,EACd,aAAa,EACb,aAAa,EACb,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,QAAQ,EACR,MAAM,GACI;IACV,MAAM,EAAE,KAAK,EAAE,GAAG,YAAY,EAAE,CAAC;IACjC,MAAM,EAAE,UAAU,EAAE,GAAG,oBAAoB,EAAE,CAAC;IAC9C,MAAM,OAAO,GAAG,kBAAkB,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IAChE,MAAM,eAAe,GAAG,iBAAiB,CAAC,OAAO,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC;IACzE,MAAM,aAAa,GAAG,gBAAgB,CAAC;QACrC,KAAK;QACL,UAAU;QACV,OAAO,EAAE,eAAe;QACxB,IAAI;QACJ,KAAK;QACL,MAAM;QACN,MAAM;KACP,CAAC,CAAC;IAEH,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC9C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,CACL,CAAC,eAAe,CACd,iBAAiB,CAAC,CAAC,iBAAiB,CAAC,CACrC,kBAAkB,CAAC,CAAC,kBAAkB,CAAC,CACvC,iBAAiB,CAAC,CAAC,iBAAiB,CAAC,CACrC,aAAa,CAAC,CAAC,aAAa,CAAC,CAC7B,QAAQ,CAAC,CAAC,QAAQ,CAAC,CACnB,aAAa,CAAC,CAAC,aAAa,CAAC,CAC7B,UAAU,CAAC,CAAC,UAAU,CAAC,CACvB,MAAM,CAAC,CAAC,MAAM,CAAC,CACf,KAAK,CAAC,CAAC,aAAa,CAAC,CAErB;MAAA,CAAC,OAAO,CACV;IAAA,EAAE,eAAe,CAAC,CACnB,CAAC;AACJ,CAAC","sourcesContent":["import { resolveResponsive, useResponsiveRuntime } from '@ankhorage/surface';\nimport React from 'react';\nimport { Text as ReactNativeText } from 'react-native';\n\nimport { useZoraTheme } from '../../theme/useZoraTheme';\nimport { resolveTextStyle } from './resolveTextRecipe';\nimport type { TextProps } from './types';\n\nfunction resolveTextContent({\n  children,\n  text,\n  i18nKey,\n}: {\n  children: TextProps['children'];\n  text: TextProps['text'];\n  i18nKey: TextProps['i18nKey'];\n}): React.ReactNode {\n  if (children !== undefined) {\n    return children;\n  }\n\n  if (text !== undefined) {\n    return text;\n  }\n\n  if (!i18nKey) {\n    return null;\n  }\n\n  return i18nKey;\n}\n\nexport function Text({\n  children,\n  text,\n  i18nKey,\n  variant = 'body',\n  tone = 'default',\n  align,\n  weight,\n  italic = false,\n  numberOfLines,\n  ellipsizeMode,\n  selectable,\n  accessibilityLabel,\n  accessibilityHint,\n  accessibilityRole,\n  nativeID,\n  testID,\n}: TextProps) {\n  const { theme } = useZoraTheme();\n  const { breakpoint } = useResponsiveRuntime();\n  const content = resolveTextContent({ children, text, i18nKey });\n  const resolvedVariant = resolveResponsive(variant, breakpoint) ?? 'body';\n  const resolvedStyle = resolveTextStyle({\n    theme,\n    breakpoint,\n    variant: resolvedVariant,\n    tone,\n    align,\n    weight,\n    italic,\n  });\n\n  if (content === null || content === undefined) {\n    return null;\n  }\n\n  return (\n    <ReactNativeText\n      accessibilityHint={accessibilityHint}\n      accessibilityLabel={accessibilityLabel}\n      accessibilityRole={accessibilityRole}\n      ellipsizeMode={ellipsizeMode}\n      nativeID={nativeID}\n      numberOfLines={numberOfLines}\n      selectable={selectable}\n      testID={testID}\n      style={resolvedStyle}\n    >\n      {content}\n    </ReactNativeText>\n  );\n}\n"]}

package/dist/theme/ZoraProvider.d.ts

@@ -1,9 +1,9 @@
 import React from 'react';
-import { type ZoraThemeOverride } from './createZoraTheme';
+import type { ZoraTheme, ZoraThemeMode } from './types';
 export interface ZoraProviderProps {
     children: React.ReactNode;
-    initialConfig?: ZoraThemeOverride;
-    initialMode?: 'light' | 'dark';
+    theme?: ZoraTheme;
+    initialMode?: ZoraThemeMode;
 }
-export declare function ZoraProvider({ children, initialConfig, initialMode, }: ZoraProviderProps): React.JSX.Element;
+export declare function ZoraProvider({ children, theme, initialMode, }: ZoraProviderProps): React.JSX.Element;
 //# sourceMappingURL=ZoraProvider.d.ts.map

package/dist/theme/ZoraProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ZoraProvider.d.ts","sourceRoot":"","sources":["../../src/theme/ZoraProvider.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAmB,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE5E,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAClC,WAAW,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAChC;AAED,wBAAgB,YAAY,CAAC,EAC3B,QAAQ,EACR,aAAa,EACb,WAAqB,GACtB,EAAE,iBAAiB,qBAMnB"}
+{"version":3,"file":"ZoraProvider.d.ts","sourceRoot":"","sources":["../../src/theme/ZoraProvider.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAGxD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,WAAW,CAAC,EAAE,aAAa,CAAC;CAC7B;AAED,wBAAgB,YAAY,CAAC,EAC3B,QAAQ,EACR,KAAwB,EACxB,WAAqB,GACtB,EAAE,iBAAiB,qBAMnB"}

package/dist/theme/ZoraProvider.js

@@ -1,8 +1,9 @@
 import { ResponsiveProvider, ThemeProvider } from '@ankhorage/surface';
 import React from 'react';
-import { createZoraTheme } from './createZoraTheme';
-export function ZoraProvider({ children, initialConfig, initialMode = 'light', }) {
-    return (<ThemeProvider initialConfig={createZoraTheme(initialConfig)} initialMode={initialMode}>
+import { createZoraThemeConfig } from './createZoraThemeConfig';
+import { zoraDefaultTheme } from './zoraDefaultTheme';
+export function ZoraProvider({ children, theme = zoraDefaultTheme, initialMode = 'light', }) {
+    return (<ThemeProvider initialConfig={createZoraThemeConfig(theme)} initialMode={initialMode}>
       <ResponsiveProvider>{children}</ResponsiveProvider>
     </ThemeProvider>);
 }

package/dist/theme/ZoraProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"ZoraProvider.js","sourceRoot":"","sources":["../../src/theme/ZoraProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,eAAe,EAA0B,MAAM,mBAAmB,CAAC;AAQ5E,MAAM,UAAU,YAAY,CAAC,EAC3B,QAAQ,EACR,aAAa,EACb,WAAW,GAAG,OAAO,GACH;IAClB,OAAO,CACL,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,WAAW,CAAC,CACrF;MAAA,CAAC,kBAAkB,CAAC,CAAC,QAAQ,CAAC,EAAE,kBAAkB,CACpD;IAAA,EAAE,aAAa,CAAC,CACjB,CAAC;AACJ,CAAC","sourcesContent":["import { ResponsiveProvider, ThemeProvider } from '@ankhorage/surface';\nimport React from 'react';\n\nimport { createZoraTheme, type ZoraThemeOverride } from './createZoraTheme';\n\nexport interface ZoraProviderProps {\n  children: React.ReactNode;\n  initialConfig?: ZoraThemeOverride;\n  initialMode?: 'light' | 'dark';\n}\n\nexport function ZoraProvider({\n  children,\n  initialConfig,\n  initialMode = 'light',\n}: ZoraProviderProps) {\n  return (\n    <ThemeProvider initialConfig={createZoraTheme(initialConfig)} initialMode={initialMode}>\n      <ResponsiveProvider>{children}</ResponsiveProvider>\n    </ThemeProvider>\n  );\n}\n"]}
+{"version":3,"file":"ZoraProvider.js","sourceRoot":"","sources":["../../src/theme/ZoraProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAQtD,MAAM,UAAU,YAAY,CAAC,EAC3B,QAAQ,EACR,KAAK,GAAG,gBAAgB,EACxB,WAAW,GAAG,OAAO,GACH;IAClB,OAAO,CACL,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,WAAW,CAAC,CACnF;MAAA,CAAC,kBAAkB,CAAC,CAAC,QAAQ,CAAC,EAAE,kBAAkB,CACpD;IAAA,EAAE,aAAa,CAAC,CACjB,CAAC;AACJ,CAAC","sourcesContent":["import { ResponsiveProvider, ThemeProvider } from '@ankhorage/surface';\nimport React from 'react';\n\nimport { createZoraThemeConfig } from './createZoraThemeConfig';\nimport type { ZoraTheme, ZoraThemeMode } from './types';\nimport { zoraDefaultTheme } from './zoraDefaultTheme';\n\nexport interface ZoraProviderProps {\n  children: React.ReactNode;\n  theme?: ZoraTheme;\n  initialMode?: ZoraThemeMode;\n}\n\nexport function ZoraProvider({\n  children,\n  theme = zoraDefaultTheme,\n  initialMode = 'light',\n}: ZoraProviderProps) {\n  return (\n    <ThemeProvider initialConfig={createZoraThemeConfig(theme)} initialMode={initialMode}>\n      <ResponsiveProvider>{children}</ResponsiveProvider>\n    </ThemeProvider>\n  );\n}\n"]}

package/dist/theme/createZoraThemeConfig.d.ts

@@ -0,0 +1,4 @@
+import type { ThemeConfig } from '@ankhorage/surface';
+import type { ZoraTheme } from './types';
+export declare function createZoraThemeConfig(theme?: ZoraTheme): ThemeConfig;
+//# sourceMappingURL=createZoraThemeConfig.d.ts.map

package/dist/theme/createZoraThemeConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createZoraThemeConfig.d.ts","sourceRoot":"","sources":["../../src/theme/createZoraThemeConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,KAAK,EAAgB,SAAS,EAAiB,MAAM,SAAS,CAAC;AAStE,wBAAgB,qBAAqB,CAAC,KAAK,GAAE,SAA4B,GAAG,WAAW,CAetF"}

package/dist/theme/createZoraThemeConfig.js

@@ -0,0 +1,23 @@
+import { zoraDefaultTheme } from './zoraDefaultTheme';
+function resolveModePrimaryColor(primaryColor, _mode) {
+    // Intentionally conservative in Plan 1: mode-specific primary derivation
+    // (OKLCH/lightness scale, etc.) comes in later theme-engine work.
+    return primaryColor;
+}
+export function createZoraThemeConfig(theme = zoraDefaultTheme) {
+    return {
+        id: theme.id,
+        name: theme.name ?? theme.id,
+        light: {
+            primaryColor: resolveModePrimaryColor(theme.primaryColor, 'light'),
+            harmony: theme.harmony,
+            systemTone: theme.tone,
+        },
+        dark: {
+            primaryColor: resolveModePrimaryColor(theme.primaryColor, 'dark'),
+            harmony: theme.harmony,
+            systemTone: theme.tone,
+        },
+    };
+}
+//# sourceMappingURL=createZoraThemeConfig.js.map

package/dist/theme/createZoraThemeConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createZoraThemeConfig.js","sourceRoot":"","sources":["../../src/theme/createZoraThemeConfig.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,SAAS,uBAAuB,CAAC,YAA0B,EAAE,KAAoB;IAC/E,yEAAyE;IACzE,kEAAkE;IAClE,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,QAAmB,gBAAgB;IACvE,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,EAAE;QAC5B,KAAK,EAAE;YACL,YAAY,EAAE,uBAAuB,CAAC,KAAK,CAAC,YAAY,EAAE,OAAO,CAAC;YAClE,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,UAAU,EAAE,KAAK,CAAC,IAAI;SACvB;QACD,IAAI,EAAE;YACJ,YAAY,EAAE,uBAAuB,CAAC,KAAK,CAAC,YAAY,EAAE,MAAM,CAAC;YACjE,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,UAAU,EAAE,KAAK,CAAC,IAAI;SACvB;KACF,CAAC;AACJ,CAAC","sourcesContent":["import type { ThemeConfig } from '@ankhorage/surface';\n\nimport type { ZoraHexColor, ZoraTheme, ZoraThemeMode } from './types';\nimport { zoraDefaultTheme } from './zoraDefaultTheme';\n\nfunction resolveModePrimaryColor(primaryColor: ZoraHexColor, _mode: ZoraThemeMode): ZoraHexColor {\n  // Intentionally conservative in Plan 1: mode-specific primary derivation\n  // (OKLCH/lightness scale, etc.) comes in later theme-engine work.\n  return primaryColor;\n}\n\nexport function createZoraThemeConfig(theme: ZoraTheme = zoraDefaultTheme): ThemeConfig {\n  return {\n    id: theme.id,\n    name: theme.name ?? theme.id,\n    light: {\n      primaryColor: resolveModePrimaryColor(theme.primaryColor, 'light'),\n      harmony: theme.harmony,\n      systemTone: theme.tone,\n    },\n    dark: {\n      primaryColor: resolveModePrimaryColor(theme.primaryColor, 'dark'),\n      harmony: theme.harmony,\n      systemTone: theme.tone,\n    },\n  };\n}\n"]}

package/dist/theme/index.d.ts

@@ -1,7 +1,7 @@
-export type { ZoraThemeOverride } from './createZoraTheme';
-export { createZoraTheme } from './createZoraTheme';
+export { createZoraThemeConfig } from './createZoraThemeConfig';
+export type { ZoraColorHarmony, ZoraColorTone, ZoraComputedTheme, ZoraHexColor, ZoraTheme, ZoraThemeId, ZoraThemeMode, } from './types';
 export { useZoraTheme } from './useZoraTheme';
+export { zoraDefaultTheme } from './zoraDefaultTheme';
 export type { ZoraProviderProps } from './ZoraProvider';
 export { ZoraProvider } from './ZoraProvider';
-export { zoraTheme } from './zoraTheme';
 //# sourceMappingURL=index.d.ts.map

package/dist/theme/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/theme/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/theme/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,YAAY,EACV,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,SAAS,EACT,WAAW,EACX,aAAa,GACd,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/theme/index.js

@@ -1,5 +1,5 @@
-export { createZoraTheme } from './createZoraTheme';
+export { createZoraThemeConfig } from './createZoraThemeConfig';
 export { useZoraTheme } from './useZoraTheme';
+export { zoraDefaultTheme } from './zoraDefaultTheme';
 export { ZoraProvider } from './ZoraProvider';
-export { zoraTheme } from './zoraTheme';
 //# sourceMappingURL=index.js.map

package/dist/theme/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/theme/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC","sourcesContent":["export type { ZoraThemeOverride } from './createZoraTheme';\nexport { createZoraTheme } from './createZoraTheme';\nexport { useZoraTheme } from './useZoraTheme';\nexport type { ZoraProviderProps } from './ZoraProvider';\nexport { ZoraProvider } from './ZoraProvider';\nexport { zoraTheme } from './zoraTheme';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/theme/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAUhE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC","sourcesContent":["export { createZoraThemeConfig } from './createZoraThemeConfig';\nexport type {\n  ZoraColorHarmony,\n  ZoraColorTone,\n  ZoraComputedTheme,\n  ZoraHexColor,\n  ZoraTheme,\n  ZoraThemeId,\n  ZoraThemeMode,\n} from './types';\nexport { useZoraTheme } from './useZoraTheme';\nexport { zoraDefaultTheme } from './zoraDefaultTheme';\nexport type { ZoraProviderProps } from './ZoraProvider';\nexport { ZoraProvider } from './ZoraProvider';\n"]}

package/dist/theme/types.d.ts

@@ -0,0 +1,21 @@
+import type { ThemeConfig } from '@ankhorage/surface';
+export type ZoraThemeId = string;
+export type ZoraThemeMode = 'light' | 'dark';
+export type ZoraHexColor = `#${string}`;
+export type ZoraColorHarmony = 'monochromatic' | 'analogous' | 'complementary' | 'splitComplementary' | 'triadic' | 'tetradic';
+export type ZoraColorTone = 'neutral' | 'pastel' | 'earth' | 'jewel' | 'fluorescent';
+export interface ZoraTheme {
+    id: ZoraThemeId;
+    name?: string;
+    primaryColor: ZoraHexColor;
+    harmony: ZoraColorHarmony;
+    tone: ZoraColorTone;
+}
+export interface ZoraComputedTheme {
+    id: ZoraThemeId;
+    name: string;
+    mode: ZoraThemeMode;
+    source: ZoraTheme;
+    surfaceConfig: ThemeConfig;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/theme/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/theme/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC;AAEjC,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,MAAM,CAAC;AAE7C,MAAM,MAAM,YAAY,GAAG,IAAI,MAAM,EAAE,CAAC;AAExC,MAAM,MAAM,gBAAgB,GACxB,eAAe,GACf,WAAW,GACX,eAAe,GACf,oBAAoB,GACpB,SAAS,GACT,UAAU,CAAC;AAEf,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,aAAa,CAAC;AAErF,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,WAAW,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,YAAY,CAAC;IAC3B,OAAO,EAAE,gBAAgB,CAAC;IAC1B,IAAI,EAAE,aAAa,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,WAAW,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,aAAa,CAAC;IACpB,MAAM,EAAE,SAAS,CAAC;IAClB,aAAa,EAAE,WAAW,CAAC;CAC5B"}

package/dist/theme/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/theme/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/theme/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { ThemeConfig } from '@ankhorage/surface';\n\nexport type ZoraThemeId = string;\n\nexport type ZoraThemeMode = 'light' | 'dark';\n\nexport type ZoraHexColor = `#${string}`;\n\nexport type ZoraColorHarmony =\n  | 'monochromatic'\n  | 'analogous'\n  | 'complementary'\n  | 'splitComplementary'\n  | 'triadic'\n  | 'tetradic';\n\nexport type ZoraColorTone = 'neutral' | 'pastel' | 'earth' | 'jewel' | 'fluorescent';\n\nexport interface ZoraTheme {\n  id: ZoraThemeId;\n  name?: string;\n  primaryColor: ZoraHexColor;\n  harmony: ZoraColorHarmony;\n  tone: ZoraColorTone;\n}\n\nexport interface ZoraComputedTheme {\n  id: ZoraThemeId;\n  name: string;\n  mode: ZoraThemeMode;\n  source: ZoraTheme;\n  surfaceConfig: ThemeConfig;\n}\n"]}

package/dist/theme/zoraDefaultTheme.d.ts

@@ -0,0 +1,3 @@
+import type { ZoraTheme } from './types';
+export declare const zoraDefaultTheme: ZoraTheme;
+//# sourceMappingURL=zoraDefaultTheme.d.ts.map

package/dist/theme/zoraDefaultTheme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zoraDefaultTheme.d.ts","sourceRoot":"","sources":["../../src/theme/zoraDefaultTheme.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC,eAAO,MAAM,gBAAgB,EAAE,SAM9B,CAAC"}

package/dist/theme/zoraDefaultTheme.js

@@ -0,0 +1,8 @@
+export const zoraDefaultTheme = {
+    id: 'zora',
+    name: 'ZORA',
+    primaryColor: '#0f766e',
+    harmony: 'analogous',
+    tone: 'jewel',
+};
+//# sourceMappingURL=zoraDefaultTheme.js.map

package/dist/theme/zoraDefaultTheme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zoraDefaultTheme.js","sourceRoot":"","sources":["../../src/theme/zoraDefaultTheme.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,gBAAgB,GAAc;IACzC,EAAE,EAAE,MAAM;IACV,IAAI,EAAE,MAAM;IACZ,YAAY,EAAE,SAAS;IACvB,OAAO,EAAE,WAAW;IACpB,IAAI,EAAE,OAAO;CACd,CAAC","sourcesContent":["import type { ZoraTheme } from './types';\n\nexport const zoraDefaultTheme: ZoraTheme = {\n  id: 'zora',\n  name: 'ZORA',\n  primaryColor: '#0f766e',\n  harmony: 'analogous',\n  tone: 'jewel',\n};\n"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ankhorage/zora",
   "type": "module",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "Opinionated React Native and React Native Web UI kit built on @ankhorage/surface.",
   "homepage": "https://github.com/ankhorage/zora#readme",
   "bugs": {

package/src/components/contentFallback.test.ts

@@ -0,0 +1,23 @@
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+
+import { describe, expect, it } from 'bun:test';
+
+const textSource = readFileSync(join(import.meta.dir, 'text', 'Text.tsx'), 'utf8');
+const headingSource = readFileSync(join(import.meta.dir, 'heading', 'Heading.tsx'), 'utf8');
+
+describe('content fallback ownership', () => {
+  it('keeps Text free of translation context coupling', () => {
+    expect(textSource).not.toMatch(/useTranslationContext/);
+    expect(textSource).toMatch(/if \(children !== undefined\) \{/);
+    expect(textSource).toMatch(/if \(text !== undefined\) \{/);
+    expect(textSource).toMatch(/return i18nKey;/);
+  });
+
+  it('keeps Heading free of translation context coupling', () => {
+    expect(headingSource).not.toMatch(/useTranslationContext/);
+    expect(headingSource).toMatch(/if \(children !== undefined\) \{/);
+    expect(headingSource).toMatch(/if \(text !== undefined\) \{/);
+    expect(headingSource).toMatch(/return i18nKey;/);
+  });
+});

package/src/components/heading/Heading.tsx

@@ -1,4 +1,4 @@
-import { resolveResponsive, useResponsiveRuntime, useTranslationContext } from '@ankhorage/surface';
+import { resolveResponsive, useResponsiveRuntime } from '@ankhorage/surface';
 import React from 'react';
 import { Text as ReactNativeText } from 'react-native';
 
@@ -10,12 +10,10 @@ function resolveHeadingContent({
   children,
   text,
   i18nKey,
-  translate,
 }: {
   children: HeadingProps['children'];
   text: HeadingProps['text'];
   i18nKey: HeadingProps['i18nKey'];
-  translate: (key: string) => string;
 }): React.ReactNode {
   if (children !== undefined) {
     return children;
@@ -29,13 +27,7 @@ function resolveHeadingContent({
     return null;
   }
 
-  try {
-    const translated = translate(i18nKey);
-    return translated && translated !== i18nKey ? translated : i18nKey;
-  } catch (error) {
-    console.warn('[ZoraHeading] Translation error:', error);
-    return i18nKey;
-  }
+  return i18nKey;
 }
 
 export function Heading({
@@ -59,8 +51,7 @@ export function Heading({
 }: HeadingProps) {
   const { theme } = useZoraTheme();
   const { breakpoint } = useResponsiveRuntime();
-  const { t } = useTranslationContext();
-  const content = resolveHeadingContent({ children, text, i18nKey, translate: t });
+  const content = resolveHeadingContent({ children, text, i18nKey });
   const resolvedSize = resolveResponsive(size, breakpoint) ?? resolveHeadingSizeFromLevel(level);
   const resolvedTone = resolveResponsive(tone, breakpoint) ?? 'default';
   const resolvedAlign = resolveResponsive(align, breakpoint);

package/src/components/text/Text.tsx

@@ -1,4 +1,4 @@
-import { resolveResponsive, useResponsiveRuntime, useTranslationContext } from '@ankhorage/surface';
+import { resolveResponsive, useResponsiveRuntime } from '@ankhorage/surface';
 import React from 'react';
 import { Text as ReactNativeText } from 'react-native';
 
@@ -10,12 +10,10 @@ function resolveTextContent({
   children,
   text,
   i18nKey,
-  translate,
 }: {
   children: TextProps['children'];
   text: TextProps['text'];
   i18nKey: TextProps['i18nKey'];
-  translate: (key: string) => string;
 }): React.ReactNode {
   if (children !== undefined) {
     return children;
@@ -29,13 +27,7 @@ function resolveTextContent({
     return null;
   }
 
-  try {
-    const translated = translate(i18nKey);
-    return translated && translated !== i18nKey ? translated : i18nKey;
-  } catch (error) {
-    console.warn('[ZoraText] Translation error:', error);
-    return i18nKey;
-  }
+  return i18nKey;
 }
 
 export function Text({
@@ -58,8 +50,7 @@ export function Text({
 }: TextProps) {
   const { theme } = useZoraTheme();
   const { breakpoint } = useResponsiveRuntime();
-  const { t } = useTranslationContext();
-  const content = resolveTextContent({ children, text, i18nKey, translate: t });
+  const content = resolveTextContent({ children, text, i18nKey });
   const resolvedVariant = resolveResponsive(variant, breakpoint) ?? 'body';
   const resolvedStyle = resolveTextStyle({
     theme,

package/src/theme/ZoraProvider.tsx

@@ -1,21 +1,23 @@
 import { ResponsiveProvider, ThemeProvider } from '@ankhorage/surface';
 import React from 'react';
 
-import { createZoraTheme, type ZoraThemeOverride } from './createZoraTheme';
+import { createZoraThemeConfig } from './createZoraThemeConfig';
+import type { ZoraTheme, ZoraThemeMode } from './types';
+import { zoraDefaultTheme } from './zoraDefaultTheme';
 
 export interface ZoraProviderProps {
   children: React.ReactNode;
-  initialConfig?: ZoraThemeOverride;
-  initialMode?: 'light' | 'dark';
+  theme?: ZoraTheme;
+  initialMode?: ZoraThemeMode;
 }
 
 export function ZoraProvider({
   children,
-  initialConfig,
+  theme = zoraDefaultTheme,
   initialMode = 'light',
 }: ZoraProviderProps) {
   return (
-    <ThemeProvider initialConfig={createZoraTheme(initialConfig)} initialMode={initialMode}>
+    <ThemeProvider initialConfig={createZoraThemeConfig(theme)} initialMode={initialMode}>
       <ResponsiveProvider>{children}</ResponsiveProvider>
     </ThemeProvider>
   );

package/src/theme/createZoraThemeConfig.test.ts

@@ -0,0 +1,36 @@
+import { describe, expect, test } from 'bun:test';
+
+import { createZoraThemeConfig } from './createZoraThemeConfig';
+
+describe('createZoraThemeConfig', () => {
+  test('converts the default theme seed into a surface config', () => {
+    const themeConfig = createZoraThemeConfig();
+
+    expect(themeConfig.id).toBe('zora');
+    expect(themeConfig.name).toBe('ZORA');
+    expect(themeConfig.light.primaryColor).toBe('#0f766e');
+    expect(themeConfig.light.harmony).toBe('analogous');
+    expect(themeConfig.light.systemTone).toBe('jewel');
+    expect(themeConfig.dark.primaryColor).toBe('#0f766e');
+    expect(themeConfig.dark.harmony).toBe('analogous');
+    expect(themeConfig.dark.systemTone).toBe('jewel');
+  });
+
+  test('falls back to id when name is omitted', () => {
+    const themeConfig = createZoraThemeConfig({
+      id: 'studio',
+      primaryColor: '#0f766e',
+      harmony: 'analogous',
+      tone: 'jewel',
+    });
+
+    expect(themeConfig.id).toBe('studio');
+    expect(themeConfig.name).toBe('studio');
+    expect(themeConfig.light.primaryColor).toBe('#0f766e');
+    expect(themeConfig.light.harmony).toBe('analogous');
+    expect(themeConfig.light.systemTone).toBe('jewel');
+    expect(themeConfig.dark.primaryColor).toBe('#0f766e');
+    expect(themeConfig.dark.harmony).toBe('analogous');
+    expect(themeConfig.dark.systemTone).toBe('jewel');
+  });
+});

package/src/theme/createZoraThemeConfig.ts

@@ -0,0 +1,27 @@
+import type { ThemeConfig } from '@ankhorage/surface';
+
+import type { ZoraHexColor, ZoraTheme, ZoraThemeMode } from './types';
+import { zoraDefaultTheme } from './zoraDefaultTheme';
+
+function resolveModePrimaryColor(primaryColor: ZoraHexColor, _mode: ZoraThemeMode): ZoraHexColor {
+  // Intentionally conservative in Plan 1: mode-specific primary derivation
+  // (OKLCH/lightness scale, etc.) comes in later theme-engine work.
+  return primaryColor;
+}
+
+export function createZoraThemeConfig(theme: ZoraTheme = zoraDefaultTheme): ThemeConfig {
+  return {
+    id: theme.id,
+    name: theme.name ?? theme.id,
+    light: {
+      primaryColor: resolveModePrimaryColor(theme.primaryColor, 'light'),
+      harmony: theme.harmony,
+      systemTone: theme.tone,
+    },
+    dark: {
+      primaryColor: resolveModePrimaryColor(theme.primaryColor, 'dark'),
+      harmony: theme.harmony,
+      systemTone: theme.tone,
+    },
+  };
+}

package/src/theme/index.ts

@@ -1,6 +1,14 @@
-export type { ZoraThemeOverride } from './createZoraTheme';
-export { createZoraTheme } from './createZoraTheme';
+export { createZoraThemeConfig } from './createZoraThemeConfig';
+export type {
+  ZoraColorHarmony,
+  ZoraColorTone,
+  ZoraComputedTheme,
+  ZoraHexColor,
+  ZoraTheme,
+  ZoraThemeId,
+  ZoraThemeMode,
+} from './types';
 export { useZoraTheme } from './useZoraTheme';
+export { zoraDefaultTheme } from './zoraDefaultTheme';
 export type { ZoraProviderProps } from './ZoraProvider';
 export { ZoraProvider } from './ZoraProvider';
-export { zoraTheme } from './zoraTheme';

package/src/theme/types.ts

@@ -0,0 +1,33 @@
+import type { ThemeConfig } from '@ankhorage/surface';
+
+export type ZoraThemeId = string;
+
+export type ZoraThemeMode = 'light' | 'dark';
+
+export type ZoraHexColor = `#${string}`;
+
+export type ZoraColorHarmony =
+  | 'monochromatic'
+  | 'analogous'
+  | 'complementary'
+  | 'splitComplementary'
+  | 'triadic'
+  | 'tetradic';
+
+export type ZoraColorTone = 'neutral' | 'pastel' | 'earth' | 'jewel' | 'fluorescent';
+
+export interface ZoraTheme {
+  id: ZoraThemeId;
+  name?: string;
+  primaryColor: ZoraHexColor;
+  harmony: ZoraColorHarmony;
+  tone: ZoraColorTone;
+}
+
+export interface ZoraComputedTheme {
+  id: ZoraThemeId;
+  name: string;
+  mode: ZoraThemeMode;
+  source: ZoraTheme;
+  surfaceConfig: ThemeConfig;
+}

package/src/theme/zoraDefaultTheme.ts

@@ -0,0 +1,9 @@
+import type { ZoraTheme } from './types';
+
+export const zoraDefaultTheme: ZoraTheme = {
+  id: 'zora',
+  name: 'ZORA',
+  primaryColor: '#0f766e',
+  harmony: 'analogous',
+  tone: 'jewel',
+};

package/dist/internal/deepMerge.d.ts

@@ -1,2 +0,0 @@
-export declare function deepMerge<T extends object>(target: T, source: Partial<T>): T;
-//# sourceMappingURL=deepMerge.d.ts.map

package/dist/internal/deepMerge.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"deepMerge.d.ts","sourceRoot":"","sources":["../../src/internal/deepMerge.ts"],"names":[],"mappings":"AAAA,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAsB5E"}

package/dist/internal/deepMerge.js

@@ -1,20 +0,0 @@
-export function deepMerge(target, source) {
-    const result = { ...target };
-    Object.keys(source).forEach((key) => {
-        const sourceValue = source[key];
-        const targetValue = target[key];
-        if (sourceValue &&
-            typeof sourceValue === 'object' &&
-            !Array.isArray(sourceValue) &&
-            targetValue &&
-            typeof targetValue === 'object' &&
-            !Array.isArray(targetValue)) {
-            result[key] = deepMerge(targetValue, sourceValue);
-        }
-        else if (sourceValue !== undefined) {
-            result[key] = sourceValue;
-        }
-    });
-    return result;
-}
-//# sourceMappingURL=deepMerge.js.map

package/dist/internal/deepMerge.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"deepMerge.js","sourceRoot":"","sources":["../../src/internal/deepMerge.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,SAAS,CAAmB,MAAS,EAAE,MAAkB;IACvE,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,CAAC;IAE5B,MAAM,CAAC,IAAI,CAAC,MAAM,CAAiB,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;QACnD,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAChC,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAEhC,IACE,WAAW;YACX,OAAO,WAAW,KAAK,QAAQ;YAC/B,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC;YAC3B,WAAW;YACX,OAAO,WAAW,KAAK,QAAQ;YAC/B,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,EAC3B,CAAC;YACD,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,WAAqB,EAAE,WAAqB,CAAe,CAAC;QACtF,CAAC;aAAM,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YACrC,MAAM,CAAC,GAAG,CAAC,GAAG,WAAyB,CAAC;QAC1C,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC","sourcesContent":["export function deepMerge<T extends object>(target: T, source: Partial<T>): T {\n  const result = { ...target };\n\n  (Object.keys(source) as (keyof T)[]).forEach((key) => {\n    const sourceValue = source[key];\n    const targetValue = target[key];\n\n    if (\n      sourceValue &&\n      typeof sourceValue === 'object' &&\n      !Array.isArray(sourceValue) &&\n      targetValue &&\n      typeof targetValue === 'object' &&\n      !Array.isArray(targetValue)\n    ) {\n      result[key] = deepMerge(targetValue as object, sourceValue as object) as T[keyof T];\n    } else if (sourceValue !== undefined) {\n      result[key] = sourceValue as T[keyof T];\n    }\n  });\n\n  return result;\n}\n"]}

package/dist/theme/createZoraTheme.d.ts

@@ -1,4 +0,0 @@
-import type { ThemeConfig } from '@ankhorage/surface';
-export type ZoraThemeOverride = Partial<ThemeConfig>;
-export declare function createZoraTheme(overrides?: ZoraThemeOverride): ThemeConfig;
-//# sourceMappingURL=createZoraTheme.d.ts.map

package/dist/theme/createZoraTheme.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"createZoraTheme.d.ts","sourceRoot":"","sources":["../../src/theme/createZoraTheme.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAKtD,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;AAErD,wBAAgB,eAAe,CAAC,SAAS,GAAE,iBAAsB,GAAG,WAAW,CAE9E"}

package/dist/theme/createZoraTheme.js

@@ -1,6 +0,0 @@
-import { deepMerge } from '../internal/deepMerge';
-import { zoraTheme } from './zoraTheme';
-export function createZoraTheme(overrides = {}) {
-    return deepMerge(zoraTheme, overrides);
-}
-//# sourceMappingURL=createZoraTheme.js.map

package/dist/theme/createZoraTheme.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"createZoraTheme.js","sourceRoot":"","sources":["../../src/theme/createZoraTheme.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAIxC,MAAM,UAAU,eAAe,CAAC,YAA+B,EAAE;IAC/D,OAAO,SAAS,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;AACzC,CAAC","sourcesContent":["import type { ThemeConfig } from '@ankhorage/surface';\n\nimport { deepMerge } from '../internal/deepMerge';\nimport { zoraTheme } from './zoraTheme';\n\nexport type ZoraThemeOverride = Partial<ThemeConfig>;\n\nexport function createZoraTheme(overrides: ZoraThemeOverride = {}): ThemeConfig {\n  return deepMerge(zoraTheme, overrides);\n}\n"]}

package/dist/theme/zoraTheme.d.ts

@@ -1,3 +0,0 @@
-import type { ThemeConfig } from '@ankhorage/surface';
-export declare const zoraTheme: ThemeConfig;
-//# sourceMappingURL=zoraTheme.d.ts.map

package/dist/theme/zoraTheme.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"zoraTheme.d.ts","sourceRoot":"","sources":["../../src/theme/zoraTheme.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,eAAO,MAAM,SAAS,EAAE,WAavB,CAAC"}

package/dist/theme/zoraTheme.js

@@ -1,15 +0,0 @@
-export const zoraTheme = {
-    id: 'zora',
-    name: 'ZORA',
-    light: {
-        primaryColor: '#0f766e',
-        harmony: 'analogous',
-        systemTone: 'jewel',
-    },
-    dark: {
-        primaryColor: '#2dd4bf',
-        harmony: 'analogous',
-        systemTone: 'jewel',
-    },
-};
-//# sourceMappingURL=zoraTheme.js.map

package/dist/theme/zoraTheme.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"zoraTheme.js","sourceRoot":"","sources":["../../src/theme/zoraTheme.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,SAAS,GAAgB;IACpC,EAAE,EAAE,MAAM;IACV,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE;QACL,YAAY,EAAE,SAAS;QACvB,OAAO,EAAE,WAAW;QACpB,UAAU,EAAE,OAAO;KACpB;IACD,IAAI,EAAE;QACJ,YAAY,EAAE,SAAS;QACvB,OAAO,EAAE,WAAW;QACpB,UAAU,EAAE,OAAO;KACpB;CACF,CAAC","sourcesContent":["import type { ThemeConfig } from '@ankhorage/surface';\n\nexport const zoraTheme: ThemeConfig = {\n  id: 'zora',\n  name: 'ZORA',\n  light: {\n    primaryColor: '#0f766e',\n    harmony: 'analogous',\n    systemTone: 'jewel',\n  },\n  dark: {\n    primaryColor: '#2dd4bf',\n    harmony: 'analogous',\n    systemTone: 'jewel',\n  },\n};\n"]}

package/src/internal/deepMerge.ts

@@ -1,23 +0,0 @@
-export function deepMerge<T extends object>(target: T, source: Partial<T>): T {
-  const result = { ...target };
-
-  (Object.keys(source) as (keyof T)[]).forEach((key) => {
-    const sourceValue = source[key];
-    const targetValue = target[key];
-
-    if (
-      sourceValue &&
-      typeof sourceValue === 'object' &&
-      !Array.isArray(sourceValue) &&
-      targetValue &&
-      typeof targetValue === 'object' &&
-      !Array.isArray(targetValue)
-    ) {
-      result[key] = deepMerge(targetValue as object, sourceValue as object) as T[keyof T];
-    } else if (sourceValue !== undefined) {
-      result[key] = sourceValue as T[keyof T];
-    }
-  });
-
-  return result;
-}

package/src/theme/createZoraTheme.test.ts

@@ -1,25 +0,0 @@
-import { describe, expect, test } from 'bun:test';
-
-import { createZoraTheme } from './createZoraTheme';
-
-describe('createZoraTheme', () => {
-  test('keeps the default preset stable', () => {
-    const theme = createZoraTheme();
-
-    expect(theme.id).toBe('zora');
-    expect(theme.light.primaryColor).toBe('#0f766e');
-    expect(theme.dark.primaryColor).toBe('#2dd4bf');
-  });
-
-  test('merges overrides without dropping the preset identity', () => {
-    const theme = createZoraTheme({
-      light: {
-        primaryColor: '#1d4ed8',
-      },
-    });
-
-    expect(theme.id).toBe('zora');
-    expect(theme.light.primaryColor).toBe('#1d4ed8');
-    expect(theme.dark.primaryColor).toBe('#2dd4bf');
-  });
-});

package/src/theme/createZoraTheme.ts

@@ -1,10 +0,0 @@
-import type { ThemeConfig } from '@ankhorage/surface';
-
-import { deepMerge } from '../internal/deepMerge';
-import { zoraTheme } from './zoraTheme';
-
-export type ZoraThemeOverride = Partial<ThemeConfig>;
-
-export function createZoraTheme(overrides: ZoraThemeOverride = {}): ThemeConfig {
-  return deepMerge(zoraTheme, overrides);
-}

package/src/theme/zoraTheme.ts

@@ -1,16 +0,0 @@
-import type { ThemeConfig } from '@ankhorage/surface';
-
-export const zoraTheme: ThemeConfig = {
-  id: 'zora',
-  name: 'ZORA',
-  light: {
-    primaryColor: '#0f766e',
-    harmony: 'analogous',
-    systemTone: 'jewel',
-  },
-  dark: {
-    primaryColor: '#2dd4bf',
-    harmony: 'analogous',
-    systemTone: 'jewel',
-  },
-};