@ankhorage/zora 2.5.2 → 2.5.4

package/src/patterns/empty-state/EmptyState.tsx

@@ -61,7 +61,7 @@ function EmptyStateInner({
  * `EmptyState` combines concise copy with optional primary and secondary actions
  * so apps can guide users without custom card and button wiring.
  *
- * @readme
+ 
  * @example Empty project list
  * ```tsx
  * <EmptyState title="No projects yet" primaryAction={{ label: 'Create project', onPress }} />

package/src/patterns/filter-bar/FilterBar.tsx

@@ -22,4 +22,9 @@ function FilterBarInner({
   );
 }
 
+/***
+ * Horizontal filter/action bar layout with leading/trailing slots.
+ *
+ 
+ */
 export const FilterBar = withZoraThemeScope(FilterBarInner);

package/src/patterns/hero/Hero.tsx

@@ -113,4 +113,9 @@ function resolveContentAlign(align: HeroAlign) {
   return align === 'center' ? 'center' : 'flex-start';
 }
 
+/***
+ * Hero section pattern for prominent page introductions with actions.
+ *
+ 
+ */
 export const Hero = withZoraThemeScope(HeroInner);

package/src/patterns/image-preview/ImagePreview.tsx

@@ -73,4 +73,9 @@ function ImagePreviewInner({
   );
 }
 
+/***
+ * Preview pattern for showing an image with optional metadata and actions.
+ *
+ 
+ */
 export const ImagePreview = withZoraThemeScope(ImagePreviewInner);

package/src/patterns/image-upload-field/ImageUploadField.tsx

@@ -290,4 +290,9 @@ function ImageUploadFieldInner({
   );
 }
 
+/***
+ * Form field pattern for picking, previewing, and uploading an image.
+ *
+ 
+ */
 export const ImageUploadField = withZoraThemeScope(ImageUploadFieldInner);

package/src/patterns/inspector-field/InspectorField.tsx

@@ -23,4 +23,9 @@ function InspectorFieldInner({
   );
 }
 
+/***
+ * Inspector row pattern with label, description, and control slot.
+ *
+ 
+ */
 export const InspectorField = withZoraThemeScope(InspectorFieldInner);

package/src/patterns/list/List.tsx

@@ -69,4 +69,9 @@ function ListInner(props: ListProps) {
   );
 }
 
+/***
+ * List container pattern for composing `ListRow` and `ListSection`.
+ *
+ 
+ */
 export const List = withZoraThemeScope(ListInner);

package/src/patterns/list/ListRow.tsx

@@ -190,4 +190,9 @@ function ListRowInner({
   );
 }
 
+/***
+ * Row pattern for lists with leading/trailing slots and optional press behavior.
+ *
+ 
+ */
 export const ListRow = withZoraThemeScope(ListRowInner);

package/src/patterns/list/ListSection.tsx

@@ -33,4 +33,9 @@ function ListSectionInner({
   );
 }
 
+/***
+ * Section wrapper for lists with optional title and description.
+ *
+ 
+ */
 export const ListSection = withZoraThemeScope(ListSectionInner);

package/src/patterns/message-bubble/MessageBubble.tsx

@@ -262,4 +262,9 @@ function MessageBubbleInner({
   );
 }
 
+/***
+ * Message bubble pattern for chat UIs with direction and status styling.
+ *
+ 
+ */
 export const MessageBubble = withZoraThemeScope(MessageBubbleInner);

package/src/patterns/notice/Notice.tsx

@@ -32,4 +32,9 @@ function NoticeInner({
   );
 }
 
+/***
+ * Notice pattern for inline feedback with tone, title, and actions.
+ *
+ 
+ */
 export const Notice = withZoraThemeScope(NoticeInner);

package/src/patterns/panel/Panel.tsx

@@ -8,4 +8,9 @@ function PanelInner({ themeId: _themeId, mode: _mode, ...props }: PanelProps) {
   return <Card {...props} />;
 }
 
+/***
+ * Semantic wrapper around `Card` for panel-style page sections.
+ *
+ 
+ */
 export const Panel = withZoraThemeScope(PanelInner);

package/src/patterns/post-card/PostCard.tsx

@@ -231,4 +231,9 @@ function PostCardInner({
   );
 }
 
+/***
+ * Social-style post card pattern with author, content, media, and actions.
+ *
+ 
+ */
 export const PostCard = withZoraThemeScope(PostCardInner);

package/src/patterns/responsive-panel/ResponsivePanel.tsx

@@ -150,7 +150,7 @@ const styles = StyleSheet.create({
  * Use `ResponsivePanel` for tool panes and admin/detail flows that need the same
  * content to work across compact mobile screens and wider desktop layouts.
  *
- * @readme
+ 
  * @example Scrollable wide panel
  * ```tsx
  * <ResponsivePanel open title="APIs" size="wide" scroll="content">...</ResponsivePanel>

package/src/patterns/section-header/SectionHeader.tsx

@@ -43,4 +43,9 @@ function SectionHeaderInner({
   );
 }
 
+/***
+ * Section heading pattern with optional description and action slot.
+ *
+ 
+ */
 export const SectionHeader = withZoraThemeScope(SectionHeaderInner);

package/src/patterns/selection/SelectableItem.tsx

@@ -15,6 +15,11 @@ function isRenderProp(
   return typeof children === 'function';
 }
 
+/***
+ * Adds selection behavior to arbitrary child content via render props.
+ *
+ 
+ */
 export function SelectableItem({ id, trigger, disabled = false, children }: SelectableItemProps) {
   const selection = useSelection();
   const resolvedTrigger = resolveTrigger(trigger);

package/src/patterns/selection/SelectionProvider.tsx

@@ -18,6 +18,11 @@ function resolveDisabled(disabled: boolean | undefined): boolean {
   return disabled ?? false;
 }
 
+/***
+ * Accesses selection state provided by `SelectionProvider`.
+ *
+ 
+ */
 export function useSelection(): UseSelectionResult {
   const value = React.useContext(SelectionContext);
   if (!value) {
@@ -27,6 +32,11 @@ export function useSelection(): UseSelectionResult {
   return value;
 }
 
+/***
+ * Provides selection state for building selectable lists and grids.
+ *
+ 
+ */
 export function SelectionProvider({
   children,
   selectedIds,

package/src/patterns/settings-row/SettingsRow.tsx

@@ -43,4 +43,9 @@ function SettingsRowInner({
   );
 }
 
+/***
+ * Settings row pattern with title, description/meta, and optional trailing content.
+ *
+ 
+ */
 export const SettingsRow = withZoraThemeScope(SettingsRowInner);

package/src/patterns/switch-field/SwitchField.tsx

@@ -26,4 +26,9 @@ function SwitchFieldInner({
   );
 }
 
+/***
+ * Labeled switch field pattern built on `SettingsRow`.
+ *
+ 
+ */
 export const SwitchField = withZoraThemeScope(SwitchFieldInner);

package/src/patterns/theme-composer/ThemeComposer.tsx

@@ -307,4 +307,9 @@ function ThemeComposerInner({
   );
 }
 
+/***
+ * UI for composing and applying a theme via structured controls.
+ *
+ 
+ */
 export const ThemeComposer = withZoraThemeScope(ThemeComposerInner);

package/src/patterns/tile-grid/PaletteItem.tsx

@@ -54,4 +54,9 @@ function PaletteItemInner({
   );
 }
 
+/***
+ * Tile item pattern for palettes and option grids.
+ *
+ 
+ */
 export const PaletteItem = withZoraThemeScope(PaletteItemInner);

package/src/patterns/tile-grid/TileGrid.tsx

@@ -46,4 +46,9 @@ function TileGridInner({
   );
 }
 
+/***
+ * Responsive grid layout for arranging tile content.
+ *
+ 
+ */
 export const TileGrid = withZoraThemeScope(TileGridInner);

package/src/patterns/timeline/Timeline.tsx

@@ -112,4 +112,9 @@ function TimelineInner({
   );
 }
 
+/***
+ * Timeline pattern for displaying a sequence of events.
+ *
+ 
+ */
 export const Timeline = withZoraThemeScope(TimelineInner);

package/src/patterns/tree-view/TreeItem.tsx

@@ -90,4 +90,9 @@ function TreeItemInner<TId extends string = string>({
   );
 }
 
+/***
+ * Single tree node row used within `TreeView`.
+ *
+ 
+ */
 export const TreeItem = withZoraThemeScope(TreeItemInner);

package/src/patterns/tree-view/TreeView.tsx

@@ -52,4 +52,9 @@ function TreeViewInner<TId extends string = string>({
   );
 }
 
+/***
+ * Tree view pattern for hierarchical navigation and expandable lists.
+ *
+ 
+ */
 export const TreeView = withZoraThemeScope(TreeViewInner);

package/src/patterns/zora-drawer-content/ZoraDrawerContent.tsx

@@ -50,4 +50,9 @@ function ZoraDrawerContentInner({
   );
 }
 
+/***
+ * Standard drawer content pattern for ZORA navigation lists.
+ *
+ 
+ */
 export const ZoraDrawerContent = withZoraThemeScope(ZoraDrawerContentInner);

package/src/patterns/zora-tab-bar/ZoraTabBar.tsx

@@ -141,4 +141,9 @@ function ZoraTabBarInner({
   );
 }
 
+/***
+ * Bottom tab bar pattern with badge support and active state styling.
+ *
+ 
+ */
 export const ZoraTabBar = withZoraThemeScope(ZoraTabBarInner);

package/src/theme/ZoraProvider.tsx

@@ -18,7 +18,6 @@ export interface ZoraProviderProps {
  * Wrap an app with `ZoraProvider` once near the root so components, patterns,
  * layouts, and theme hooks resolve the same design tokens and color mode.
  *
- * @readme
  * @example App provider
  * ```tsx
  * <ZoraProvider initialMode="light"><App /></ZoraProvider>