@ankhorage/zora 3.1.1 → 3.3.1

package/dist/patterns/reader/meta.d.ts

@@ -125,11 +125,11 @@ export declare const readerSurfaceMeta: {
         };
         readonly headerActions: {
             readonly label: "Header actions";
-            readonly allowedChildren: readonly ["Box", "Stack", "Grid", "Container", "Divider", "Text", "Heading", "Button", "ButtonGroup", "ThemeModeToggle", "Input", "Textarea", "FormField", "Card", "Panel", "Notice", "EmptyState", "SectionHeader", "SettingsRow", "PostCard", "ChatListItem", "MessageBubble", "ReaderSurface"];
+            readonly allowedChildren: readonly ["Box", "Stack", "Grid", "Container", "Divider", "Text", "Heading", "Button", "ButtonGroup", "ThemeModeToggle", "Input", "Textarea", "FormField", "Card", "Panel", "Notice", "EmptyState", "SectionHeader", "SettingsRow", "PostCard", "ChatListItem", "MessageBubble", "ProgressRing", "ReaderSurface", "ContentRail"];
         };
         readonly footerActions: {
             readonly label: "Footer actions";
-            readonly allowedChildren: readonly ["Box", "Stack", "Grid", "Container", "Divider", "Text", "Heading", "Button", "ButtonGroup", "ThemeModeToggle", "Input", "Textarea", "FormField", "Card", "Panel", "Notice", "EmptyState", "SectionHeader", "SettingsRow", "PostCard", "ChatListItem", "MessageBubble", "ReaderSurface"];
+            readonly allowedChildren: readonly ["Box", "Stack", "Grid", "Container", "Divider", "Text", "Heading", "Button", "ButtonGroup", "ThemeModeToggle", "Input", "Textarea", "FormField", "Card", "Panel", "Notice", "EmptyState", "SectionHeader", "SettingsRow", "PostCard", "ChatListItem", "MessageBubble", "ProgressRing", "ReaderSurface", "ContentRail"];
         };
     };
     readonly props: {

package/dist/patterns/scanner/meta.d.ts

@@ -105,7 +105,7 @@ export declare const barcodeScannerViewMeta: {
     readonly category: "pattern";
     readonly description: "Composed scanner shell with permission, camera slot, scan overlay, and manual entry affordance.";
     readonly directManifestNode: true;
-    readonly allowedChildren: readonly ["Box", "Stack", "Grid", "Container", "Divider", "Text", "Heading", "Button", "ButtonGroup", "ThemeModeToggle", "Input", "Textarea", "FormField", "Card", "Panel", "Notice", "EmptyState", "SectionHeader", "SettingsRow", "PostCard", "ChatListItem", "MessageBubble", "ReaderSurface"];
+    readonly allowedChildren: readonly ["Box", "Stack", "Grid", "Container", "Divider", "Text", "Heading", "Button", "ButtonGroup", "ThemeModeToggle", "Input", "Textarea", "FormField", "Card", "Panel", "Notice", "EmptyState", "SectionHeader", "SettingsRow", "PostCard", "ChatListItem", "MessageBubble", "ProgressRing", "ReaderSurface", "ContentRail"];
     readonly requirements: {
         readonly permissions: readonly [{
             readonly permission: "camera";
@@ -145,7 +145,7 @@ export declare const barcodeScannerViewMeta: {
         };
         readonly children: {
             readonly label: "Scanner footer";
-            readonly allowedChildren: readonly ["Box", "Stack", "Grid", "Container", "Divider", "Text", "Heading", "Button", "ButtonGroup", "ThemeModeToggle", "Input", "Textarea", "FormField", "Card", "Panel", "Notice", "EmptyState", "SectionHeader", "SettingsRow", "PostCard", "ChatListItem", "MessageBubble", "ReaderSurface"];
+            readonly allowedChildren: readonly ["Box", "Stack", "Grid", "Container", "Divider", "Text", "Heading", "Button", "ButtonGroup", "ThemeModeToggle", "Input", "Textarea", "FormField", "Card", "Panel", "Notice", "EmptyState", "SectionHeader", "SettingsRow", "PostCard", "ChatListItem", "MessageBubble", "ProgressRing", "ReaderSurface", "ContentRail"];
         };
     };
     readonly props: {

package/dist/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAqG/B,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;AA2IhF,eAAO,MAAM,uBAAuB,EAAE,qBAAgD,CAAC"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAsG/B,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;AA6IhF,eAAO,MAAM,uBAAuB,EAAE,qBAAgD,CAAC"}

package/dist/registry.js

@@ -27,7 +27,7 @@ import { Modal } from './components/modal';
 import { NavigationItem } from './components/navigation-item';
 import { NavigationList } from './components/navigation-list';
 import { Pagination } from './components/pagination';
-import { Progress } from './components/progress';
+import { Progress, ProgressRing } from './components/progress';
 import { Radio, RadioGroup } from './components/radio';
 import { Rating } from './components/rating';
 import { SearchBar } from './components/search-bar';
@@ -51,6 +51,7 @@ import { ForgotPasswordForm, OAuthProviderButton, OAuthProviderList, OtpForm, Si
 import { ChatListItem } from './patterns/chat-list-item';
 import { CollectionEditor } from './patterns/collection-editor';
 import { ConfirmDialog } from './patterns/confirm-dialog';
+import { ContentRail } from './patterns/content-rail';
 import { DisclosureSection } from './patterns/disclosure-section';
 import { EmptyState } from './patterns/empty-state';
 import { FilterBar } from './patterns/filter-bar';
@@ -115,6 +116,7 @@ const _ZORA_COMPONENT_REGISTRY = {
     NavigationList,
     Pagination,
     Progress,
+    ProgressRing,
     Radio,
     RadioGroup,
     Rating,
@@ -158,6 +160,7 @@ const _ZORA_COMPONENT_REGISTRY = {
     ChatListItem,
     CollectionEditor,
     ConfirmDialog,
+    ContentRail,
     DisclosureSection,
     EmptyState,
     FilterBar,

package/dist/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"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","sourcesContent":["import type { InteractionPolicyProps } from '@ankhorage/surface';\nimport type React from 'react';\n\nimport { ActionSheet, ActionSheetItem } from './components/action-sheet';\nimport { AppBar } from './components/app-bar';\nimport { Avatar } from './components/avatar';\nimport { AvatarGroup } from './components/avatar-group';\nimport { Badge } from './components/badge';\nimport { Breadcrumbs } from './components/breadcrumbs';\nimport { Button } from './components/button';\nimport { ButtonGroup } from './components/button-group';\nimport { Card } from './components/card';\nimport { Checkbox, CheckboxGroup } from './components/checkbox';\nimport { Chip } from './components/chip';\nimport { ChipGroup } from './components/chip-group';\nimport { DataTable } from './components/data-table';\nimport { DatePicker } from './components/date-picker';\nimport { Drawer } from './components/drawer';\nimport { Form, FormActions, FormError, FormField } from './components/form';\nimport { Gradient } from './components/gradient';\nimport { Heading } from './components/heading';\nimport { Icon } from './components/icon';\nimport { IconButton } from './components/icon-button';\nimport { Image } from './components/image';\nimport { Input } from './components/input';\nimport { MediaCard } from './components/media-card';\nimport { DropdownMenu, Menu } from './components/menu';\nimport { MetricCard } from './components/metric-card';\nimport { Modal } from './components/modal';\nimport { NavigationItem } from './components/navigation-item';\nimport { NavigationList } from './components/navigation-list';\nimport { Pagination } from './components/pagination';\nimport { Progress } from './components/progress';\nimport { Radio, RadioGroup } from './components/radio';\nimport { Rating } from './components/rating';\nimport { SearchBar } from './components/search-bar';\nimport { Select } from './components/select';\nimport { Skeleton, SkeletonCard, SkeletonList, SkeletonText } from './components/skeleton';\nimport { SplashScreen } from './components/splash-screen';\nimport { Tabs } from './components/tabs';\nimport { Text } from './components/text';\nimport { Textarea } from './components/textarea';\nimport { TimePicker } from './components/time-picker';\nimport { Toast } from './components/toast';\nimport { Toolbar, ToolbarAction } from './components/toolbar';\nimport {\n  Box,\n  Center,\n  Container,\n  Divider,\n  Grid,\n  Inline,\n  Show,\n  Spacer,\n  Stack,\n  Surface,\n} from './foundation';\nimport { AppShell } from './layout/app-shell';\nimport { Screen } from './layout/screen';\nimport { ScreenSection } from './layout/screen-section';\nimport { SettingsLayout } from './layout/settings-layout';\nimport { SidebarLayout } from './layout/sidebar-layout';\nimport { TopbarLayout } from './layout/topbar-layout';\nimport {\n  ForgotPasswordForm,\n  OAuthProviderButton,\n  OAuthProviderList,\n  OtpForm,\n  SignInForm,\n  SignUpForm,\n} from './patterns/auth';\nimport { ChatListItem } from './patterns/chat-list-item';\nimport { CollectionEditor } from './patterns/collection-editor';\nimport { ConfirmDialog } from './patterns/confirm-dialog';\nimport { DisclosureSection } from './patterns/disclosure-section';\nimport { EmptyState } from './patterns/empty-state';\nimport { FilterBar } from './patterns/filter-bar';\nimport { Hero } from './patterns/hero';\nimport { ImagePreview } from './patterns/image-preview';\nimport { ImageUploadField } from './patterns/image-upload-field';\nimport { InspectorField } from './patterns/inspector-field';\nimport { List, ListRow, ListSection } from './patterns/list';\nimport { MessageBubble } from './patterns/message-bubble';\nimport { Notice } from './patterns/notice';\nimport { Panel } from './patterns/panel';\nimport { PostCard } from './patterns/post-card';\nimport { ProductCard } from './patterns/product-card';\nimport { ReaderSurface } from './patterns/reader';\nimport { ResponsivePanel } from './patterns/responsive-panel';\nimport { BarcodeScannerView, CameraPermissionView, ScanOverlay } from './patterns/scanner';\nimport { SectionHeader } from './patterns/section-header';\nimport { SelectableItem } from './patterns/selection';\nimport { SettingsRow } from './patterns/settings-row';\nimport { SwitchField } from './patterns/switch-field';\nimport { ThemeComposer } from './patterns/theme-composer';\nimport { PaletteItem, TileGrid } from './patterns/tile-grid';\nimport { Timeline } from './patterns/timeline';\nimport { TreeItem, TreeView } from './patterns/tree-view';\nimport { ZoraDrawerContent } from './patterns/zora-drawer-content';\nimport { ZoraTabBar } from './patterns/zora-tab-bar';\nimport { ThemeModeToggle } from './theme/ThemeModeToggle';\n\nexport type ZoraComponentRegistry = Readonly<Record<string, React.ElementType>>;\n\ntype ComponentPropsFor<K extends keyof typeof _ZORA_COMPONENT_REGISTRY> = React.ComponentProps<\n  (typeof _ZORA_COMPONENT_REGISTRY)[K]\n>;\n\ntype AcceptsSurfaceInteractionPolicyProps<P> = 'interactionPolicy' extends keyof P\n  ? InteractionPolicyProps extends Pick<P, 'interactionPolicy'>\n    ? Pick<P, 'interactionPolicy'> extends InteractionPolicyProps\n      ? true\n      : false\n    : false\n  : false;\n\ntype RegistryInteractionPolicyContract = {\n  [K in keyof typeof _ZORA_COMPONENT_REGISTRY]: AcceptsSurfaceInteractionPolicyProps<\n    ComponentPropsFor<K>\n  >;\n};\n\ntype _AssertTrue<T extends true> = T;\ntype _RegistryInteractionPolicyCheck = _AssertTrue<\n  RegistryInteractionPolicyContract[keyof typeof _ZORA_COMPONENT_REGISTRY]\n>;\n\nconst _ZORA_COMPONENT_REGISTRY = {\n  ActionSheet,\n  ActionSheetItem,\n  AppBar,\n  Avatar,\n  AvatarGroup,\n  Badge,\n  Breadcrumbs,\n  Button,\n  ButtonGroup,\n  Card,\n  Checkbox,\n  CheckboxGroup,\n  Chip,\n  ChipGroup,\n  DataTable,\n  DatePicker,\n  Drawer,\n  DropdownMenu,\n  Form,\n  FormActions,\n  FormError,\n  FormField,\n  Gradient,\n  Heading,\n  Icon,\n  IconButton,\n  Image,\n  Input,\n  MediaCard,\n  Menu,\n  MetricCard,\n  Modal,\n  NavigationItem,\n  NavigationList,\n  Pagination,\n  Progress,\n  Radio,\n  RadioGroup,\n  Rating,\n  SearchBar,\n  Select,\n  Skeleton,\n  SkeletonCard,\n  SkeletonList,\n  SkeletonText,\n  SplashScreen,\n  Tabs,\n  Text,\n  Textarea,\n  TimePicker,\n  Toast,\n  Toolbar,\n  ToolbarAction,\n  ThemeModeToggle,\n  Box,\n  Center,\n  Container,\n  Divider,\n  Grid,\n  Inline,\n  Show,\n  Spacer,\n  Stack,\n  Surface,\n  AppShell,\n  Screen,\n  ScreenSection,\n  SettingsLayout,\n  SidebarLayout,\n  TopbarLayout,\n  ForgotPasswordForm,\n  OAuthProviderButton,\n  OAuthProviderList,\n  OtpForm,\n  SignInForm,\n  SignUpForm,\n  ChatListItem,\n  CollectionEditor,\n  ConfirmDialog,\n  DisclosureSection,\n  EmptyState,\n  FilterBar,\n  Hero,\n  ImagePreview,\n  ImageUploadField,\n  InspectorField,\n  List,\n  ListRow,\n  ListSection,\n  MessageBubble,\n  Notice,\n  Panel,\n  PostCard,\n  ProductCard,\n  ResponsivePanel,\n  ReaderSurface,\n  BarcodeScannerView,\n  CameraPermissionView,\n  ScanOverlay,\n  SectionHeader,\n  SelectableItem,\n  SettingsRow,\n  SwitchField,\n  ThemeComposer,\n  PaletteItem,\n  TileGrid,\n  Timeline,\n  TreeItem,\n  TreeView,\n  ZoraDrawerContent,\n  ZoraTabBar,\n} as const satisfies ZoraComponentRegistry;\n\nexport const ZORA_COMPONENT_REGISTRY: ZoraComponentRegistry = _ZORA_COMPONENT_REGISTRY;\n"]}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"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","sourcesContent":["import type { InteractionPolicyProps } from '@ankhorage/surface';\nimport type React from 'react';\n\nimport { ActionSheet, ActionSheetItem } from './components/action-sheet';\nimport { AppBar } from './components/app-bar';\nimport { Avatar } from './components/avatar';\nimport { AvatarGroup } from './components/avatar-group';\nimport { Badge } from './components/badge';\nimport { Breadcrumbs } from './components/breadcrumbs';\nimport { Button } from './components/button';\nimport { ButtonGroup } from './components/button-group';\nimport { Card } from './components/card';\nimport { Checkbox, CheckboxGroup } from './components/checkbox';\nimport { Chip } from './components/chip';\nimport { ChipGroup } from './components/chip-group';\nimport { DataTable } from './components/data-table';\nimport { DatePicker } from './components/date-picker';\nimport { Drawer } from './components/drawer';\nimport { Form, FormActions, FormError, FormField } from './components/form';\nimport { Gradient } from './components/gradient';\nimport { Heading } from './components/heading';\nimport { Icon } from './components/icon';\nimport { IconButton } from './components/icon-button';\nimport { Image } from './components/image';\nimport { Input } from './components/input';\nimport { MediaCard } from './components/media-card';\nimport { DropdownMenu, Menu } from './components/menu';\nimport { MetricCard } from './components/metric-card';\nimport { Modal } from './components/modal';\nimport { NavigationItem } from './components/navigation-item';\nimport { NavigationList } from './components/navigation-list';\nimport { Pagination } from './components/pagination';\nimport { Progress, ProgressRing } from './components/progress';\nimport { Radio, RadioGroup } from './components/radio';\nimport { Rating } from './components/rating';\nimport { SearchBar } from './components/search-bar';\nimport { Select } from './components/select';\nimport { Skeleton, SkeletonCard, SkeletonList, SkeletonText } from './components/skeleton';\nimport { SplashScreen } from './components/splash-screen';\nimport { Tabs } from './components/tabs';\nimport { Text } from './components/text';\nimport { Textarea } from './components/textarea';\nimport { TimePicker } from './components/time-picker';\nimport { Toast } from './components/toast';\nimport { Toolbar, ToolbarAction } from './components/toolbar';\nimport {\n  Box,\n  Center,\n  Container,\n  Divider,\n  Grid,\n  Inline,\n  Show,\n  Spacer,\n  Stack,\n  Surface,\n} from './foundation';\nimport { AppShell } from './layout/app-shell';\nimport { Screen } from './layout/screen';\nimport { ScreenSection } from './layout/screen-section';\nimport { SettingsLayout } from './layout/settings-layout';\nimport { SidebarLayout } from './layout/sidebar-layout';\nimport { TopbarLayout } from './layout/topbar-layout';\nimport {\n  ForgotPasswordForm,\n  OAuthProviderButton,\n  OAuthProviderList,\n  OtpForm,\n  SignInForm,\n  SignUpForm,\n} from './patterns/auth';\nimport { ChatListItem } from './patterns/chat-list-item';\nimport { CollectionEditor } from './patterns/collection-editor';\nimport { ConfirmDialog } from './patterns/confirm-dialog';\nimport { ContentRail } from './patterns/content-rail';\nimport { DisclosureSection } from './patterns/disclosure-section';\nimport { EmptyState } from './patterns/empty-state';\nimport { FilterBar } from './patterns/filter-bar';\nimport { Hero } from './patterns/hero';\nimport { ImagePreview } from './patterns/image-preview';\nimport { ImageUploadField } from './patterns/image-upload-field';\nimport { InspectorField } from './patterns/inspector-field';\nimport { List, ListRow, ListSection } from './patterns/list';\nimport { MessageBubble } from './patterns/message-bubble';\nimport { Notice } from './patterns/notice';\nimport { Panel } from './patterns/panel';\nimport { PostCard } from './patterns/post-card';\nimport { ProductCard } from './patterns/product-card';\nimport { ReaderSurface } from './patterns/reader';\nimport { ResponsivePanel } from './patterns/responsive-panel';\nimport { BarcodeScannerView, CameraPermissionView, ScanOverlay } from './patterns/scanner';\nimport { SectionHeader } from './patterns/section-header';\nimport { SelectableItem } from './patterns/selection';\nimport { SettingsRow } from './patterns/settings-row';\nimport { SwitchField } from './patterns/switch-field';\nimport { ThemeComposer } from './patterns/theme-composer';\nimport { PaletteItem, TileGrid } from './patterns/tile-grid';\nimport { Timeline } from './patterns/timeline';\nimport { TreeItem, TreeView } from './patterns/tree-view';\nimport { ZoraDrawerContent } from './patterns/zora-drawer-content';\nimport { ZoraTabBar } from './patterns/zora-tab-bar';\nimport { ThemeModeToggle } from './theme/ThemeModeToggle';\n\nexport type ZoraComponentRegistry = Readonly<Record<string, React.ElementType>>;\n\ntype ComponentPropsFor<K extends keyof typeof _ZORA_COMPONENT_REGISTRY> = React.ComponentProps<\n  (typeof _ZORA_COMPONENT_REGISTRY)[K]\n>;\n\ntype AcceptsSurfaceInteractionPolicyProps<P> = 'interactionPolicy' extends keyof P\n  ? InteractionPolicyProps extends Pick<P, 'interactionPolicy'>\n    ? Pick<P, 'interactionPolicy'> extends InteractionPolicyProps\n      ? true\n      : false\n    : false\n  : false;\n\ntype RegistryInteractionPolicyContract = {\n  [K in keyof typeof _ZORA_COMPONENT_REGISTRY]: AcceptsSurfaceInteractionPolicyProps<\n    ComponentPropsFor<K>\n  >;\n};\n\ntype _AssertTrue<T extends true> = T;\ntype _RegistryInteractionPolicyCheck = _AssertTrue<\n  RegistryInteractionPolicyContract[keyof typeof _ZORA_COMPONENT_REGISTRY]\n>;\n\nconst _ZORA_COMPONENT_REGISTRY = {\n  ActionSheet,\n  ActionSheetItem,\n  AppBar,\n  Avatar,\n  AvatarGroup,\n  Badge,\n  Breadcrumbs,\n  Button,\n  ButtonGroup,\n  Card,\n  Checkbox,\n  CheckboxGroup,\n  Chip,\n  ChipGroup,\n  DataTable,\n  DatePicker,\n  Drawer,\n  DropdownMenu,\n  Form,\n  FormActions,\n  FormError,\n  FormField,\n  Gradient,\n  Heading,\n  Icon,\n  IconButton,\n  Image,\n  Input,\n  MediaCard,\n  Menu,\n  MetricCard,\n  Modal,\n  NavigationItem,\n  NavigationList,\n  Pagination,\n  Progress,\n  ProgressRing,\n  Radio,\n  RadioGroup,\n  Rating,\n  SearchBar,\n  Select,\n  Skeleton,\n  SkeletonCard,\n  SkeletonList,\n  SkeletonText,\n  SplashScreen,\n  Tabs,\n  Text,\n  Textarea,\n  TimePicker,\n  Toast,\n  Toolbar,\n  ToolbarAction,\n  ThemeModeToggle,\n  Box,\n  Center,\n  Container,\n  Divider,\n  Grid,\n  Inline,\n  Show,\n  Spacer,\n  Stack,\n  Surface,\n  AppShell,\n  Screen,\n  ScreenSection,\n  SettingsLayout,\n  SidebarLayout,\n  TopbarLayout,\n  ForgotPasswordForm,\n  OAuthProviderButton,\n  OAuthProviderList,\n  OtpForm,\n  SignInForm,\n  SignUpForm,\n  ChatListItem,\n  CollectionEditor,\n  ConfirmDialog,\n  ContentRail,\n  DisclosureSection,\n  EmptyState,\n  FilterBar,\n  Hero,\n  ImagePreview,\n  ImageUploadField,\n  InspectorField,\n  List,\n  ListRow,\n  ListSection,\n  MessageBubble,\n  Notice,\n  Panel,\n  PostCard,\n  ProductCard,\n  ResponsivePanel,\n  ReaderSurface,\n  BarcodeScannerView,\n  CameraPermissionView,\n  ScanOverlay,\n  SectionHeader,\n  SelectableItem,\n  SettingsRow,\n  SwitchField,\n  ThemeComposer,\n  PaletteItem,\n  TileGrid,\n  Timeline,\n  TreeItem,\n  TreeView,\n  ZoraDrawerContent,\n  ZoraTabBar,\n} as const satisfies ZoraComponentRegistry;\n\nexport const ZORA_COMPONENT_REGISTRY: ZoraComponentRegistry = _ZORA_COMPONENT_REGISTRY;\n"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ankhorage/zora",
   "type": "module",
-  "version": "3.1.1",
+  "version": "3.3.1",
   "description": "Opinionated React Native and React Native Web UI kit built on @ankhorage/surface.",
   "homepage": "https://github.com/ankhorage/zora#readme",
   "bugs": {
@@ -38,7 +38,7 @@
   "dependencies": {
     "@ankhorage/color-theory": "^0.0.8",
     "@ankhorage/contracts": "^8.0.1",
-    "@ankhorage/surface": "^3.1.0"
+    "@ankhorage/surface": "^3.1.1"
   },
   "files": [
     "dist",

package/src/components/progress/ProgressRing.test.ts

@@ -0,0 +1,48 @@
+import { describe, expect, test } from 'bun:test';
+
+import { progressRingMeta } from './meta';
+
+describe('ProgressRing public contract', () => {
+  test('is exported from the component and package entrypoints', async () => {
+    const [componentIndex, rootIndex] = await Promise.all([
+      Bun.file('src/components/progress/index.ts').text(),
+      Bun.file('src/index.ts').text(),
+    ]);
+
+    expect(componentIndex).toContain("export { ProgressRing } from './ProgressRing';");
+    expect(componentIndex).toContain('ProgressRingProps');
+    expect(rootIndex).toContain("export { Progress, ProgressRing } from './components/progress';");
+    expect(rootIndex).toContain('ProgressProps, ProgressRingProps');
+  });
+
+  test('exposes native progress semantics and uses canonical normalization and colors', async () => {
+    const source = await Bun.file('src/components/progress/ProgressRing.tsx').text();
+
+    expect(source).toContain('accessibilityRole="progressbar"');
+    expect(source).toContain('accessibilityValue={{');
+    expect(source).toContain('resolveProgressFraction({ max, value })');
+    expect(source).toContain('resolveProgressRole(theme, color)');
+    expect(source).not.toMatch(/#[0-9A-Fa-f]{3,8}|rgba?\(|hsla?\(/);
+  });
+
+  test('declares a complete serializable manifest blueprint', () => {
+    expect(progressRingMeta.directManifestNode).toBe(true);
+    expect(progressRingMeta.allowedChildren).toEqual([]);
+    expect(progressRingMeta.blueprint.defaultProps).toEqual({
+      value: 68,
+      max: 100,
+      color: 'primary',
+      trackColor: 'neutral',
+      size: 120,
+      thickness: 10,
+      centerValue: '68%',
+      centerLabel: 'Complete',
+      accessibilityLabel: 'Progress',
+      accessibilityValueText: '68% complete',
+    });
+    expect(Object.keys(progressRingMeta.props).sort()).toEqual(
+      Object.keys(progressRingMeta.blueprint.defaultProps).sort(),
+    );
+    expect(JSON.parse(JSON.stringify(progressRingMeta))).toEqual(progressRingMeta);
+  });
+});

package/src/components/progress/ProgressRing.tsx

@@ -0,0 +1,151 @@
+import React from 'react';
+import { StyleSheet, View } from 'react-native';
+
+import { Stack } from '../../foundation';
+import { useZoraTheme } from '../../theme/useZoraTheme';
+import { withZoraThemeScope } from '../../theme/withZoraThemeScope';
+import { Text } from '../text';
+import { resolveProgressFraction } from './resolveProgressFraction';
+import { resolveProgressRingGeometry } from './resolveProgressRingGeometry';
+import { type ProgressRingProps, resolveProgressRole } from './types';
+
+function ProgressRingInner({
+  themeId: _themeId,
+  mode: _mode,
+  interactionPolicy: _interactionPolicy,
+  accessibilityLabel = 'Progress',
+  accessibilityValueText,
+  centerLabel,
+  centerValue,
+  color = 'primary',
+  max = 100,
+  size = 120,
+  testID,
+  thickness = 10,
+  trackColor = 'neutral',
+  value,
+}: ProgressRingProps) {
+  const { theme } = useZoraTheme();
+  const fraction = resolveProgressFraction({ max, value });
+  const geometry = resolveProgressRingGeometry({ fraction, size, thickness });
+  const progressRole = resolveProgressRole(theme, color);
+  const trackRole = resolveProgressRole(theme, trackColor);
+  const accessibilityMaximum = Number.isFinite(max) && max > 0 ? max : 1;
+  const accessibilityValue = fraction * accessibilityMaximum;
+  const valueText = accessibilityValueText ?? `${Math.round(fraction * 100)}%`;
+  const segments = Array.from({ length: geometry.filledSegmentCount });
+
+  return (
+    <View
+      accessibilityLabel={accessibilityLabel}
+      accessibilityRole="progressbar"
+      accessibilityValue={{
+        max: accessibilityMaximum,
+        min: 0,
+        now: accessibilityValue,
+        text: valueText,
+      }}
+      accessible
+      style={{ height: geometry.diameter, width: geometry.diameter }}
+      testID={testID}
+    >
+      <View
+        importantForAccessibility="no-hide-descendants"
+        pointerEvents="none"
+        style={styles.visual}
+      >
+        <View
+          style={[
+            styles.track,
+            {
+              borderColor: trackRole.softBg,
+              borderRadius: geometry.diameter / 2,
+              borderWidth: geometry.strokeWidth,
+            },
+          ]}
+        />
+
+        {segments.map((_, index) => (
+          <View
+            key={index}
+            style={[
+              styles.segmentLayer,
+              { transform: [{ rotate: `${index * (360 / geometry.segmentCount)}deg` }] },
+            ]}
+          >
+            <View
+              style={{
+                backgroundColor: progressRole.base,
+                borderRadius: geometry.strokeWidth / 2,
+                height: geometry.strokeWidth,
+                left: (geometry.diameter - geometry.segmentWidth) / 2,
+                position: 'absolute',
+                top: 0,
+                width: geometry.segmentWidth,
+              }}
+            />
+          </View>
+        ))}
+      </View>
+
+      {centerValue !== undefined || centerLabel !== undefined ? (
+        <View
+          importantForAccessibility="no-hide-descendants"
+          pointerEvents="none"
+          style={styles.center}
+        >
+          <Stack align="center" gap="xxs" px="s">
+            {centerValue !== undefined ? (
+              <Text align="center" variant="lead" weight="bold">
+                {centerValue}
+              </Text>
+            ) : null}
+            {centerLabel !== undefined ? (
+              <Text align="center" emphasis="muted" numberOfLines={2} variant="caption">
+                {centerLabel}
+              </Text>
+            ) : null}
+          </Stack>
+        </View>
+      ) : null}
+    </View>
+  );
+}
+
+const styles = StyleSheet.create({
+  center: {
+    alignItems: 'center',
+    bottom: 0,
+    justifyContent: 'center',
+    left: 0,
+    position: 'absolute',
+    right: 0,
+    top: 0,
+  },
+  segmentLayer: {
+    bottom: 0,
+    left: 0,
+    position: 'absolute',
+    right: 0,
+    top: 0,
+  },
+  track: {
+    bottom: 0,
+    left: 0,
+    position: 'absolute',
+    right: 0,
+    top: 0,
+  },
+  visual: {
+    bottom: 0,
+    left: 0,
+    position: 'absolute',
+    right: 0,
+    top: 0,
+  },
+});
+
+/***
+ * Circular determinate progress with optional serializable center value and label content.
+ */
+export const ProgressRing = withZoraThemeScope(ProgressRingInner);

package/src/components/progress/index.ts

@@ -1,2 +1,3 @@
 export { Progress } from './Progress';
-export type { ProgressProps } from './types';
+export { ProgressRing } from './ProgressRing';
+export type { ProgressProps, ProgressRingProps } from './types';

package/src/components/progress/meta.ts

@@ -44,3 +44,102 @@ export const progressMeta = {
     },
   },
 } as const satisfies ZoraComponentMeta;
+
+const instanceAuthoring = { authority: 'instance' } as const;
+
+export const progressRingMeta = {
+  name: 'ProgressRing',
+  category: 'component',
+  description: 'Displays circular determinate progress with optional center value and label text.',
+  directManifestNode: true,
+  allowedChildren: [],
+  blueprint: {
+    label: 'Progress ring',
+    defaultProps: {
+      value: 68,
+      max: 100,
+      color: 'primary',
+      trackColor: 'neutral',
+      size: 120,
+      thickness: 10,
+      centerValue: '68%',
+      centerLabel: 'Complete',
+      accessibilityLabel: 'Progress',
+      accessibilityValueText: '68% complete',
+    },
+  },
+  props: {
+    value: {
+      type: 'number',
+      category: 'State',
+      label: 'Value',
+      default: 68,
+      authoring: instanceAuthoring,
+    },
+    max: {
+      type: 'number',
+      category: 'State',
+      label: 'Maximum',
+      default: 100,
+      authoring: instanceAuthoring,
+    },
+    centerValue: {
+      type: 'string',
+      category: 'Content',
+      label: 'Center value',
+      default: '68%',
+      authoring: instanceAuthoring,
+    },
+    centerLabel: {
+      type: 'string',
+      category: 'Content',
+      label: 'Center label',
+      default: 'Complete',
+      authoring: instanceAuthoring,
+    },
+    accessibilityLabel: {
+      type: 'string',
+      category: 'Accessibility',
+      label: 'Accessibility label',
+      default: 'Progress',
+      authoring: instanceAuthoring,
+    },
+    accessibilityValueText: {
+      type: 'string',
+      category: 'Accessibility',
+      label: 'Accessibility value text',
+      default: '68% complete',
+      authoring: instanceAuthoring,
+    },
+    color: {
+      type: 'enum',
+      category: 'Style',
+      label: 'Progress color',
+      enum: [...ZORA_COLORS],
+      default: 'primary',
+      authoring: instanceAuthoring,
+    },
+    trackColor: {
+      type: 'enum',
+      category: 'Style',
+      label: 'Track color',
+      enum: [...ZORA_COLORS],
+      default: 'neutral',
+      authoring: instanceAuthoring,
+    },
+    size: {
+      type: 'number',
+      category: 'Layout',
+      label: 'Diameter',
+      default: 120,
+      authoring: instanceAuthoring,
+    },
+    thickness: {
+      type: 'number',
+      category: 'Style',
+      label: 'Thickness',
+      default: 10,
+      authoring: instanceAuthoring,
+    },
+  },
+} as const satisfies ZoraComponentMeta;

package/src/components/progress/resolveProgressRingGeometry.test.ts

@@ -0,0 +1,30 @@
+import { describe, expect, test } from 'bun:test';
+
+import { resolveProgressRingGeometry } from './resolveProgressRingGeometry';
+
+describe('resolveProgressRingGeometry', () => {
+  test('normalizes invalid dimensions and fractions deterministically', () => {
+    expect(
+      resolveProgressRingGeometry({ fraction: Number.NaN, size: Number.NaN, thickness: -1 }),
+    ).toMatchObject({
+      diameter: 120,
+      filledSegmentCount: 0,
+      strokeWidth: 10,
+    });
+  });
+
+  test('clamps size, thickness, and progress to renderable bounds', () => {
+    const empty = resolveProgressRingGeometry({ fraction: -1, size: 4, thickness: 30 });
+    const complete = resolveProgressRingGeometry({ fraction: 2, size: 80, thickness: 8 });
+
+    expect(empty).toMatchObject({ diameter: 24, filledSegmentCount: 0, strokeWidth: 12 });
+    expect(complete.filledSegmentCount).toBe(complete.segmentCount);
+  });
+
+  test('maps determinate progress to the ring segments', () => {
+    const geometry = resolveProgressRingGeometry({ fraction: 0.68, size: 120, thickness: 10 });
+
+    expect(geometry.filledSegmentCount).toBe(Math.round(geometry.segmentCount * 0.68));
+    expect(geometry.segmentWidth).toBeGreaterThan(0);
+  });
+});

package/src/components/progress/resolveProgressRingGeometry.ts

@@ -0,0 +1,44 @@
+export function resolveProgressRingGeometry({
+  fraction,
+  size,
+  thickness,
+}: {
+  fraction: number;
+  size: number;
+  thickness: number;
+}) {
+  const diameter = normalizePositiveNumber(size, DEFAULT_SIZE, MINIMUM_SIZE);
+  const strokeWidth = Math.min(
+    normalizePositiveNumber(thickness, DEFAULT_THICKNESS, MINIMUM_THICKNESS),
+    diameter / 2,
+  );
+  const centerlineRadius = (diameter - strokeWidth) / 2;
+  const segmentCount = Math.max(
+    MINIMUM_SEGMENT_COUNT,
+    Math.min(MAXIMUM_SEGMENT_COUNT, Math.round(Math.PI * centerlineRadius)),
+  );
+  const normalizedFraction = Math.min(Math.max(Number.isFinite(fraction) ? fraction : 0, 0), 1);
+
+  return {
+    diameter,
+    filledSegmentCount: Math.round(normalizedFraction * segmentCount),
+    segmentCount,
+    segmentWidth: Math.max(1, (2 * Math.PI * centerlineRadius) / segmentCount + 0.5),
+    strokeWidth,
+  };
+}
+
+const DEFAULT_SIZE = 120;
+const DEFAULT_THICKNESS = 10;
+const MAXIMUM_SEGMENT_COUNT = 120;
+const MINIMUM_SEGMENT_COUNT = 32;
+const MINIMUM_SIZE = 24;
+const MINIMUM_THICKNESS = 1;
+
+function normalizePositiveNumber(value: number, fallback: number, minimum: number): number {
+  if (!Number.isFinite(value) || value <= 0) {
+    return fallback;
+  }
+
+  return Math.max(value, minimum);
+}

package/src/components/progress/types.ts

@@ -10,6 +10,19 @@ export interface ProgressProps extends ZoraBaseProps {
   size?: ZoraControlSize;
 }
 
+export interface ProgressRingProps extends ZoraBaseProps {
+  value: number;
+  max?: number;
+  color?: ZoraColor;
+  trackColor?: ZoraColor;
+  size?: number;
+  thickness?: number;
+  centerValue?: string;
+  centerLabel?: string;
+  accessibilityLabel?: string;
+  accessibilityValueText?: string;
+}
+
 export function resolveProgressRole(theme: SurfaceTheme, color: ZoraColor): RoleSemantics {
   switch (color) {
     case 'secondary':

package/src/index.ts

@@ -115,8 +115,8 @@ export type { NavigationListProps, ZoraNavigationRouteMap } from './components/n
 export { NavigationList } from './components/navigation-list';
 export type { PaginationProps } from './components/pagination';
 export { Pagination } from './components/pagination';
-export type { ProgressProps } from './components/progress';
-export { Progress } from './components/progress';
+export type { ProgressProps, ProgressRingProps } from './components/progress';
+export { Progress, ProgressRing } from './components/progress';
 export type { RadioGroupOption, RadioGroupProps, RadioProps } from './components/radio';
 export { Radio, RadioGroup } from './components/radio';
 export type { RatingProps } from './components/rating';
@@ -275,6 +275,16 @@ export type {
 export { CollectionEditor } from './patterns/collection-editor';
 export type { ConfirmDialogProps } from './patterns/confirm-dialog';
 export { ConfirmDialog } from './patterns/confirm-dialog';
+export type {
+  ContentRailControlPressEvent,
+  ContentRailDirection,
+  ContentRailItemSize,
+  ContentRailMotion,
+  ContentRailProps,
+  ContentRailSpacing,
+  ContentRailVisibleRangeChangeEvent,
+} from './patterns/content-rail';
+export { ContentRail } from './patterns/content-rail';
 export type { DisclosureSectionProps } from './patterns/disclosure-section';
 export { DisclosureSection } from './patterns/disclosure-section';
 export type { EmptyStateAction, EmptyStateProps } from './patterns/empty-state';

package/src/interactionPolicy.test.ts

@@ -186,6 +186,28 @@ describe('ReaderSurface', () => {
   });
 });
 
+describe('ContentRail', () => {
+  test('types extend ZoraBaseProps instead of duplicating InteractionPolicy', () => {
+    const source = readPattern('content-rail', 'types.ts');
+
+    expect(source).toMatch(/export interface ContentRailProps extends ZoraBaseProps/);
+    expect(source).not.toMatch(/interactionPolicy\?: InteractionPolicy;/);
+  });
+
+  test('suppresses scrolling and forwards interactionPolicy to owned controls', () => {
+    const source = readPattern('content-rail', 'ContentRail.tsx');
+
+    expect(source).not.toMatch(/interactionPolicy:\s*_interactionPolicy/);
+    expect(source).toContain('scrollEnabled={!passive}');
+    expect(source).toMatch(
+      /<IconButton[\s\S]*?interactionPolicy=\{interactionPolicy\}[\s\S]*?label=\{previousLabel\}/,
+    );
+    expect(source).toMatch(
+      /<IconButton[\s\S]*?interactionPolicy=\{interactionPolicy\}[\s\S]*?label=\{nextLabel\}/,
+    );
+  });
+});
+
 describe('CameraPermissionView', () => {
   test('forwards interactionPolicy to internal Buttons after prop spreads', () => {
     const source = readPattern('scanner', 'CameraPermissionView.tsx');

package/src/metadata/allowedChildren.ts

@@ -21,7 +21,21 @@ export const CONTAINER_ALLOWED_CHILDREN = [
   'PostCard',
   'ChatListItem',
   'MessageBubble',
+  'ProgressRing',
   'ReaderSurface',
+  'ContentRail',
+] as const;
+
+export const CONTENT_RAIL_ALLOWED_CHILDREN = [
+  'Box',
+  'Stack',
+  'Card',
+  'Panel',
+  'Image',
+  'ProductCard',
+  'PostCard',
+  'ChatListItem',
+  'MessageBubble',
 ] as const;
 
 export const SCREEN_SECTION_ALLOWED_CHILDREN = [...CONTAINER_ALLOWED_CHILDREN] as const;