@ankhorage/surface 0.1.3 → 0.1.5

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @ankhorage/surface
 
+## 0.1.5
+
+### Patch Changes
+
+- Refresh the README copy so the published package overview, installation, usage, and positioning match the current messaging.
+
+## 0.1.4
+
+### Patch Changes
+
+- Fix Expo Web icon rendering by importing `@expo/vector-icons` through a bundler-safe static module path instead of runtime `require` resolution.
+
 ## 0.1.3
 
 ### Patch Changes

package/README.md

@@ -1,196 +1,35 @@
-# @ankhorage/surface
+# surface
 
-Stable UI foundation for React Native and React Native Web.
+A minimal design foundation for React Native and React Native Web.
 
-Surface gives application packages a consistent layer for layout, typography, theming, forms, and overlays without turning the foundation into a full product UI kit. It is intended to be the reusable base beneath ZORA and other RN/RN-web packages.
+## 🎯 What you get
+- Predictable layout system
+- Theme-driven styling
+- Cross-platform consistency
 
-## Why Surface?
-
-- Cross-platform primitives and components with one API for React Native and React Native Web.
-- Semantic theming instead of ad hoc component colors.
-- Shared interaction, field-state, and overlay patterns.
-- Small but complete foundation layer: enough to build on, not a product-pattern kit.
-
-## Install
+## ✨ Features
+- Token-based theming
+- Layout primitives
+- Responsive utilities
 
+## 🚀 Installation
 ```bash
-bun add @ankhorage/surface @ankhorage/contracts
+bun add @ankhorage/surface
 ```
 
-Peer dependencies:
-
-- `react`
-- `react-native`
-- `@expo/vector-icons` for icon rendering
-- `expo-font` when using runtime font registration
-
-## Quick Start
-
+## 📦 Usage
 ```tsx
-import React from 'react';
-import { Button, Stack, Text, ThemeProvider } from '@ankhorage/surface';
-
-const themeConfig = {
-  id: 'app',
-  name: 'App',
-  light: {
-    primaryColor: '#2563eb',
-    harmony: 'monochromatic',
-    systemTone: 'neutral',
-  },
-  dark: {
-    primaryColor: '#2563eb',
-    harmony: 'monochromatic',
-    systemTone: 'neutral',
-  },
-};
+import { Box, Text } from '@ankhorage/surface'
 
-export function App() {
-  return (
-    <ThemeProvider initialConfig={themeConfig}>
-      <Stack gap="m" p="l">
-        <Text variant="body">Surface is ready.</Text>
-        <Button>Continue</Button>
-      </Stack>
-    </ThemeProvider>
-  );
-}
+<Box padding="lg" gap="md">
+  <Text variant="title">Title</Text>
+  <Text>Content</Text>
+</Box>
 ```
 
-## Real-World Example
-
-```tsx
-import React from 'react';
-import {
-  Button,
-  Field,
-  HelperText,
-  Modal,
-  Stack,
-  Text,
-  TextInput,
-  ThemeProvider,
-} from '@ankhorage/surface';
-
-export function SignInCard() {
-  return (
-    <ThemeProvider initialConfig={themeConfig}>
-      <Stack gap="m" p="l">
-        <Field helperText="We only use this for sign-in." label="Email">
-          <TextInput autoCapitalize="none" keyboardType="email-address" />
-        </Field>
-
-        <Field errorText="Password is required." invalid label="Password">
-          <TextInput secureTextEntry />
-        </Field>
-
-        <Button fullWidth>Sign in</Button>
-
-        <Modal visible={false}>
-          <Text variant="body">Overlay content uses the same theme + spacing system.</Text>
-        </Modal>
-
-        <HelperText tone="muted">
-          Forms, controls, and overlays are meant to compose without extra glue code.
-        </HelperText>
-      </Stack>
-    </ThemeProvider>
-  );
-}
-```
-
-## Included APIs
-
-### Providers and theme
-
-- `ThemeProvider`, `useTheme`, `useThemeConfig`, `useThemeMode`
-- `FontProvider`, `useFontContext`
-- `TranslationProvider`, `useTranslationContext`
-- `createTheme`, `resolveToken`
-
-### Responsive helpers
-
-- `ResponsiveProvider`, `useResponsiveRuntime`, `useBreakpoint`
-- `BREAKPOINTS`, `BREAKPOINT_ORDER`, `getBreakpointFromWidth`, `resolveResponsive`
-
-### Layout
-
-- `Box`, `Surface`
-- `Stack`, `Inline`, `Grid`, `Template`
-- `Container`, `Center`, `Divider`, `Spacer`, `Show`
-
-### Typography and primitives
-
-- `Text`, `Heading`, `Icon`, `ButtonBase`
-
-### Actions and display
-
-- `Button`, `IconButton`
-- `Card`, `Badge`, `ListItem`
-
-### Forms and controls
-
-- `Field`, `Label`, `HelperText`
-- `TextInput`, `Textarea`
-- `Checkbox`, `Radio`, `Switch`
-
-### Overlays and navigation
-
-- `Modal`, `Drawer`, `Tooltip`, `Menu`
-- `Tabs`, `TabList`, `Tab`, `TabPanel`
-- `ToastProvider`, `Toast`, `useToast`
-
-### Utilities
-
-- `deepMerge`, `isDeepEqual`
-
-## Docs-Lite Examples
-
-Small usage references live in
-[docs/examples.md](https://github.com/ankhorage/surface/blob/main/docs/examples.md):
-
-- provider shell
-- form composition
-- modal and drawer composition
-- tabs and menu usage
-- checkbox, radio, and switch usage
-- theme override example
-
-## Scope Boundary
-
-Surface is for reusable foundation concerns:
-
-- layout primitives
-- text and icon primitives
-- semantic tokens and theming
-- responsive helpers
-- interaction primitives
-- form controls
-- overlays and navigation primitives
-
-Surface is not for ready-made product patterns:
-
-- auth flows
-- app shells and dashboards
-- data tables and charts
-- settings panels
-- product-specific dialogs and layouts
-
-Those belong in ZORA.
-
-## Status
-
-Surface is in the stabilization phase: the goal is to keep the public API deliberate, typed, and dependency-ready for downstream packages.
-
-- Foundation work stays in Surface when it is broadly reusable across RN and RN Web.
-- Product-like patterns should move to ZORA instead of expanding Surface into a UI kit.
-- Release and freeze expectations are tracked in
-  [docs/release-checklist.md](https://github.com/ankhorage/surface/blob/main/docs/release-checklist.md).
-
-## Changelog
-
-Version history is maintained in [CHANGELOG.md](./CHANGELOG.md). New release notes should flow through Changesets so the published changelog matches the package surface.
-
-## License
+## 🧪 Use Cases
+- Design system foundations
+- Cross-platform layout abstraction
 
-MIT
+## 🧠 Why this exists
+Bridges the gap between raw primitives and full UI frameworks.

package/dist/primitives/icon/resolveExpoIconComponent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolveExpoIconComponent.d.ts","sourceRoot":"","sources":["../../../src/primitives/icon/resolveExpoIconComponent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAI9D,MAAM,MAAM,iBAAiB,GAAG,KAAK,CAAC,WAAW,CAAC;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC,CAAC;AA4CH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,CAQ5E"}
+{"version":3,"file":"resolveExpoIconComponent.d.ts","sourceRoot":"","sources":["../../../src/primitives/icon/resolveExpoIconComponent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9D,MAAM,MAAM,iBAAiB,GAAG,KAAK,CAAC,WAAW,CAAC;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC,CAAC;AAEH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,CAO5E"}

package/dist/primitives/icon/resolveExpoIconComponent.js

@@ -1,38 +1,10 @@
+import * as ExpoIcons from '@expo/vector-icons';
 import {} from 'react-native';
-let cachedIcons = null;
-function resolveRuntimeRequire() {
-    if (typeof require === 'function') {
-        return require;
-    }
-    const globalCandidate = globalThis.require;
-    if (typeof globalCandidate === 'function') {
-        return globalCandidate;
-    }
-    return null;
-}
-function loadExpoIcons() {
-    if (cachedIcons) {
-        return cachedIcons;
-    }
-    const runtimeRequire = resolveRuntimeRequire();
-    try {
-        if (!runtimeRequire) {
-            throw new Error('runtime require is unavailable');
-        }
-        // Keep icon loading lazy so non-Expo consumers do not need the package until Icon is used.
-        cachedIcons = runtimeRequire('@expo/vector-icons');
-        return cachedIcons;
-    }
-    catch {
-        throw new Error('Surface Icon requires `@expo/vector-icons` and `expo-font` in the host app. Install them to use the Icon primitive.');
-    }
-}
 export function resolveExpoIconComponent(provider) {
-    const Icons = loadExpoIcons();
-    const candidate = Icons[provider];
+    const candidate = ExpoIcons[provider];
     if (typeof candidate === 'function') {
         return candidate;
     }
-    return Icons.Ionicons;
+    return ExpoIcons.Ionicons;
 }
 //# sourceMappingURL=resolveExpoIconComponent.js.map

package/dist/primitives/icon/resolveExpoIconComponent.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolveExpoIconComponent.js","sourceRoot":"","sources":["../../../src/primitives/icon/resolveExpoIconComponent.ts"],"names":[],"mappings":"AAEA,OAAO,EAAkC,MAAM,cAAc,CAAC;AAY9D,IAAI,WAAW,GAA2B,IAAI,CAAC;AAE/C,SAAS,qBAAqB;IAC5B,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;QAClC,OAAO,OAAkC,CAAC;IAC5C,CAAC;IAED,MAAM,eAAe,GACnB,UAGD,CAAC,OAAO,CAAC;IAEV,IAAI,OAAO,eAAe,KAAK,UAAU,EAAE,CAAC;QAC1C,OAAO,eAA0C,CAAC;IACpD,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,aAAa;IACpB,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,MAAM,cAAc,GAAG,qBAAqB,EAAE,CAAC;IAE/C,IAAI,CAAC;QACH,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACpD,CAAC;QAED,2FAA2F;QAC3F,WAAW,GAAG,cAAc,CAAC,oBAAoB,CAAoB,CAAC;QACtE,OAAO,WAAW,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,qHAAqH,CACtH,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,QAAgB;IACvD,MAAM,KAAK,GAAG,aAAa,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAI,KAAiC,CAAC,QAAQ,CAAC,CAAC;IAC/D,IAAI,OAAO,SAAS,KAAK,UAAU,EAAE,CAAC;QACpC,OAAO,SAA8B,CAAC;IACxC,CAAC;IAED,OAAO,KAAK,CAAC,QAA6B,CAAC;AAC7C,CAAC"}
+{"version":3,"file":"resolveExpoIconComponent.js","sourceRoot":"","sources":["../../../src/primitives/icon/resolveExpoIconComponent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,oBAAoB,CAAC;AAEhD,OAAO,EAAkC,MAAM,cAAc,CAAC;AAU9D,MAAM,UAAU,wBAAwB,CAAC,QAAgB;IACvD,MAAM,SAAS,GAAI,SAAqC,CAAC,QAAQ,CAAC,CAAC;IACnE,IAAI,OAAO,SAAS,KAAK,UAAU,EAAE,CAAC;QACpC,OAAO,SAA8B,CAAC;IACxC,CAAC;IAED,OAAO,SAAS,CAAC,QAA6B,CAAC;AACjD,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ankhorage/surface",
   "type": "module",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Stable UI foundation for React Native and React Native Web.",
   "homepage": "https://github.com/ankhorage/surface#readme",
   "bugs": {