@ankhorage/zora 18.0.1 → 19.0.1

package/src/patterns/notice/meta.ts

@@ -1,36 +0,0 @@
-import type { ZoraComponentMeta } from '../../metadata';
-import { CONTAINER_ALLOWED_CHILDREN } from '../../metadata/allowedChildren';
-
-export const noticeMeta = {
-  name: 'Notice',
-  category: 'pattern',
-  directManifestNode: true,
-  allowedChildren: [...CONTAINER_ALLOWED_CHILDREN],
-  blueprint: {
-    label: 'Notice',
-    defaultProps: {
-      title: 'Notice',
-      color: 'primary',
-    },
-  },
-  props: {
-    title: {
-      type: 'string',
-      category: 'Content',
-      label: 'Title',
-      default: 'Notice',
-    },
-    description: {
-      type: 'string',
-      category: 'Content',
-      label: 'Description',
-    },
-    color: {
-      type: 'enum',
-      category: 'Style',
-      label: 'Color',
-      enum: ['primary', 'neutral', 'danger', 'success', 'warning'],
-      default: 'primary',
-    },
-  },
-} as const satisfies ZoraComponentMeta;

package/src/patterns/notice/types.ts

@@ -1,12 +0,0 @@
-import type React from 'react';
-
-import type { ZoraColor } from '../../internal/recipes';
-import type { ZoraBaseProps } from '../../theme/ZoraBaseProps';
-
-export interface NoticeProps extends ZoraBaseProps {
-  title: React.ReactNode;
-  description?: React.ReactNode;
-  children?: React.ReactNode;
-  actions?: React.ReactNode;
-  color?: ZoraColor;
-}

package/src/patterns/panel/Panel.tsx

@@ -1,26 +0,0 @@
-import React from 'react';
-
-import { Card } from '../../features/card/public';
-import { resolveCardThemeRecipe } from '../../features/card/utils/resolveCardThemeRecipe';
-import { useZoraThemeRecipe } from '../../theme/useZoraThemeRecipe';
-import { withZoraThemeScope } from '../../theme/withZoraThemeScope';
-import type { PanelProps } from './types';
-
-function PanelInner({
-  themeId: _themeId,
-  mode: _mode,
-  tone,
-  compact,
-  padding,
-  radius,
-  ...props
-}: PanelProps) {
-  const themeFields = useZoraThemeRecipe('Panel');
-  const recipe = resolveCardThemeRecipe({ tone, compact, padding, radius, themeFields });
-  return <Card {...props} {...recipe} />;
-}
-
-/***
- * Semantic wrapper around `Card` for panel-style page sections.
- */
-export const Panel = withZoraThemeScope(PanelInner);

package/src/patterns/panel/index.ts

@@ -1,2 +0,0 @@
-export { Panel } from './Panel';
-export type { PanelProps } from './types';

package/src/patterns/panel/meta.ts

@@ -1,51 +0,0 @@
-import type { ZoraComponentMeta } from '../../metadata';
-import { CONTAINER_ALLOWED_CHILDREN } from '../../metadata/allowedChildren';
-
-const themeAuthoring = {
-  authority: 'theme',
-  scope: 'pattern',
-  allowInstanceOverride: true,
-} as const;
-
-export const panelMeta = {
-  name: 'Panel',
-  category: 'pattern',
-  directManifestNode: true,
-  allowedChildren: [...CONTAINER_ALLOWED_CHILDREN],
-  blueprint: { label: 'Panel', defaultProps: { title: 'Panel' } },
-  props: {
-    title: {
-      type: 'string',
-      category: 'Content',
-      label: 'Title',
-      authoring: { authority: 'instance' },
-    },
-    description: {
-      type: 'string',
-      category: 'Content',
-      label: 'Description',
-      authoring: { authority: 'instance' },
-    },
-    eyebrow: {
-      type: 'string',
-      category: 'Content',
-      label: 'Eyebrow',
-      authoring: { authority: 'instance' },
-    },
-    tone: {
-      type: 'enum',
-      category: 'Style',
-      label: 'Tone',
-      enum: ['default', 'subtle', 'outline'],
-      authoring: themeAuthoring,
-    },
-    compact: { type: 'boolean', category: 'Layout', label: 'Compact', authoring: themeAuthoring },
-    padding: { type: 'spacing', category: 'Layout', label: 'Padding', authoring: themeAuthoring },
-    radius: {
-      type: 'radius',
-      category: 'Style',
-      label: 'Corner radius',
-      authoring: themeAuthoring,
-    },
-  },
-} as const satisfies ZoraComponentMeta;

package/src/patterns/panel/themeRecipeMeta.ts

@@ -1,32 +0,0 @@
-import type { ZoraThemeRecipeMeta } from '../../metadata/themeRecipeTypes';
-
-export const panelThemeRecipeMeta = {
-  name: 'Panel',
-  kind: 'pattern',
-  description: 'Maps global rhythm and surface tokens into Panel presentation.',
-  fields: {
-    tone: {
-      type: 'choice',
-      label: 'Tone',
-      options: ['default', 'subtle', 'outline'],
-      default: 'default',
-    },
-    padding: {
-      type: 'token',
-      tokenFamily: 'spacing',
-      label: 'Padding',
-      description: 'When unset, Panel keeps Card compact-aware spacing.',
-    },
-    radius: {
-      type: 'token',
-      tokenFamily: 'radii',
-      label: 'Corner radius',
-      default: 'l',
-    },
-    compact: {
-      type: 'boolean',
-      label: 'Compact',
-      default: false,
-    },
-  },
-} as const satisfies ZoraThemeRecipeMeta;

package/src/patterns/panel/types.ts

@@ -1,17 +0,0 @@
-import type React from 'react';
-
-import type { ZoraCardTone } from '../../internal/recipes';
-import type { ZoraBaseProps } from '../../theme/ZoraBaseProps';
-
-export interface PanelProps extends ZoraBaseProps {
-  title?: React.ReactNode;
-  description?: React.ReactNode;
-  eyebrow?: React.ReactNode;
-  actions?: React.ReactNode;
-  footer?: React.ReactNode;
-  children?: React.ReactNode;
-  tone?: ZoraCardTone;
-  compact?: boolean;
-  padding?: string;
-  radius?: string;
-}

package/src/patterns/reader/ReaderSurface.test.ts

@@ -1,46 +0,0 @@
-import { describe, expect, test } from 'bun:test';
-
-import type { ReaderErrorEvent, ReaderLocationChangeEvent, ReaderSurfaceProps } from '../..';
-
-describe('ReaderSurface public contract', () => {
-  test('exports the component and serializable adapter events from the package root', () => {
-    const props: ReaderSurfaceProps = { format: 'epub' };
-    const location: ReaderLocationChangeEvent = {
-      format: 'epub',
-      locator: 'epubcfi(/6/4!/4/2)',
-      page: 2,
-      pageCount: 8,
-      progression: 1 / 7,
-      chapterId: 'chapter-1',
-      chapterTitle: 'A beginning',
-      trigger: 'swipe',
-    };
-    const error: ReaderErrorEvent = {
-      code: 'protected-document',
-      format: 'pdf',
-      message: 'This document is protected.',
-    };
-
-    expect(props.format).toBe('epub');
-    expect(() => JSON.stringify(location)).not.toThrow();
-    expect(() => JSON.stringify(error)).not.toThrow();
-  });
-
-  test('exports the reader API from the package root', async () => {
-    const source = await Bun.file('src/index.ts').text();
-
-    expect(source).toContain("from './patterns/reader';");
-    expect(source).toContain('ReaderSurface, resolveReaderProgress');
-  });
-
-  test('keeps parsing, fetching, persistence, and platform APIs outside ZORA', async () => {
-    const source = await Bun.file('src/patterns/reader/ReaderSurface.tsx').text();
-
-    expect(source).not.toContain('expo-');
-    expect(source).not.toContain('pdfjs');
-    expect(source).not.toContain('epubjs');
-    expect(source).not.toContain('fetch(');
-    expect(source).not.toContain('AsyncStorage');
-    expect(source).toContain('accessibilityLiveRegion="polite"');
-  });
-});

package/src/patterns/reader/ReaderSurface.tsx

@@ -1,349 +0,0 @@
-import React from 'react';
-
-import { AppBar } from '../../features/app-bar/public';
-import { IconButton } from '../../features/button/public';
-import { View } from '../../features/layout/public';
-import { Progress } from '../../features/progress/public';
-import { Surface } from '../../features/surface/public';
-import { Text } from '../../features/typography/public';
-import { useZoraTheme } from '../../theme/useZoraTheme';
-import { withZoraThemeScope } from '../../theme/withZoraThemeScope';
-import { resolveReaderProgress } from './resolveReaderProgress';
-import type { ReaderStatus, ReaderSurfaceProps } from './types';
-
-function resolvePageLabel(page: number | undefined, pageCount: number | undefined): string | null {
-  if (page === undefined || !Number.isFinite(page)) return null;
-  if (pageCount === undefined || !Number.isFinite(pageCount)) return `Page ${page}`;
-  return `Page ${page} of ${pageCount}`;
-}
-
-function resolveCanGoPrevious({
-  canGoPrevious,
-  page,
-}: Pick<ReaderSurfaceProps, 'canGoPrevious' | 'page'>): boolean {
-  if (canGoPrevious !== undefined) return canGoPrevious;
-  return page === undefined || page > 1;
-}
-
-function resolveCanGoNext({
-  canGoNext,
-  page,
-  pageCount,
-}: Pick<ReaderSurfaceProps, 'canGoNext' | 'page' | 'pageCount'>): boolean {
-  if (canGoNext !== undefined) return canGoNext;
-  return page === undefined || pageCount === undefined || page < pageCount;
-}
-
-function ReaderEmptyState({
-  status,
-  loadingLabel,
-  errorTitle,
-  unavailableTitle,
-}: {
-  status: ReaderStatus;
-  loadingLabel: string;
-  errorTitle: string;
-  unavailableTitle: string;
-}) {
-  const title =
-    status === 'loading' ? loadingLabel : status === 'error' ? errorTitle : unavailableTitle;
-
-  return (
-    <View align="center" justify="center" flex={1} minHeight={360} p="l">
-      <Text align="center" emphasis="muted" variant="bodySmall">
-        {title}
-      </Text>
-    </View>
-  );
-}
-
-function invokeReaderAction(action: (() => void | Promise<void>) | undefined): void {
-  void action?.();
-}
-
-function ReaderHeader({
-  interactionPolicy,
-  title,
-  subtitle,
-  contentsLabel,
-  appearanceLabel,
-  highlightLabel,
-  highlighted,
-  headerActions,
-  onOpenContents,
-  onOpenAppearance,
-  onToggleHighlight,
-}: Pick<
-  ReaderSurfaceProps,
-  | 'interactionPolicy'
-  | 'title'
-  | 'subtitle'
-  | 'contentsLabel'
-  | 'appearanceLabel'
-  | 'highlightLabel'
-  | 'highlighted'
-  | 'headerActions'
-  | 'onOpenContents'
-  | 'onOpenAppearance'
-  | 'onToggleHighlight'
->) {
-  const actions =
-    onOpenContents || onOpenAppearance || onToggleHighlight || headerActions ? (
-      <View direction="row" align="center" gap="xs" wrap="nowrap">
-        {onOpenContents ? (
-          <IconButton
-            icon={{ name: 'list-outline' }}
-            interactionPolicy={interactionPolicy}
-            label={contentsLabel ?? 'Table of contents'}
-            onPress={() => invokeReaderAction(onOpenContents)}
-            size="l"
-          />
-        ) : null}
-        {onOpenAppearance ? (
-          <IconButton
-            icon={{ name: 'text-outline' }}
-            interactionPolicy={interactionPolicy}
-            label={appearanceLabel ?? 'Reading appearance'}
-            onPress={() => invokeReaderAction(onOpenAppearance)}
-            size="l"
-          />
-        ) : null}
-        {onToggleHighlight ? (
-          <IconButton
-            color={highlighted ? 'primary' : 'neutral'}
-            icon={{ name: highlighted ? 'bookmark' : 'bookmark-outline' }}
-            interactionPolicy={interactionPolicy}
-            label={highlightLabel ?? 'Toggle highlight'}
-            onPress={() => invokeReaderAction(onToggleHighlight)}
-            size="l"
-          />
-        ) : null}
-        {headerActions}
-      </View>
-    ) : undefined;
-
-  return (
-    <AppBar
-      actions={actions}
-      divider
-      interactionPolicy={interactionPolicy}
-      safeAreaTop
-      subtitle={subtitle}
-      title={title}
-    />
-  );
-}
-
-function ReaderFooter({
-  interactionPolicy,
-  status,
-  page,
-  pageCount,
-  progress,
-  canGoPrevious,
-  canGoNext,
-  chapterLabel,
-  pageLabel,
-  previousPageLabel,
-  nextPageLabel,
-  footerActions,
-  onPreviousPage,
-  onNextPage,
-}: Pick<
-  ReaderSurfaceProps,
-  | 'interactionPolicy'
-  | 'status'
-  | 'page'
-  | 'pageCount'
-  | 'progress'
-  | 'canGoPrevious'
-  | 'canGoNext'
-  | 'chapterLabel'
-  | 'pageLabel'
-  | 'previousPageLabel'
-  | 'nextPageLabel'
-  | 'footerActions'
-  | 'onPreviousPage'
-  | 'onNextPage'
->) {
-  const { theme } = useZoraTheme();
-  const resolvedProgress = resolveReaderProgress({ progress, page, pageCount });
-  const resolvedPageLabel = pageLabel ?? resolvePageLabel(page, pageCount);
-  const previousEnabled =
-    status === 'ready' && Boolean(onPreviousPage) && resolveCanGoPrevious({ canGoPrevious, page });
-  const nextEnabled =
-    status === 'ready' && Boolean(onNextPage) && resolveCanGoNext({ canGoNext, page, pageCount });
-
-  return (
-    <View
-      bg={theme.semantics.surface.raised}
-      borderColor={theme.semantics.neutral.divider}
-      borderWidth={1}
-      gap="s"
-      p="m"
-    >
-      <Progress value={resolvedProgress} max={1} size="s" />
-      <View align="center" direction="row" gap="m" justify="space-between" wrap="nowrap">
-        <IconButton
-          disabled={!previousEnabled}
-          icon={{ name: 'chevron-back' }}
-          interactionPolicy={interactionPolicy}
-          label={previousPageLabel ?? 'Previous page'}
-          onPress={() => invokeReaderAction(onPreviousPage)}
-          size="l"
-        />
-        <View flex={1} minWidth={0}>
-          <View align="center" gap="xs">
-            {chapterLabel ? (
-              <Text
-                align="center"
-                ellipsizeMode="tail"
-                numberOfLines={1}
-                variant="label"
-                weight="semiBold"
-              >
-                {chapterLabel}
-              </Text>
-            ) : null}
-            {resolvedPageLabel ? (
-              <Text
-                accessibilityLiveRegion="polite"
-                align="center"
-                emphasis="muted"
-                variant="caption"
-              >
-                {resolvedPageLabel}
-              </Text>
-            ) : null}
-          </View>
-        </View>
-        <IconButton
-          disabled={!nextEnabled}
-          icon={{ name: 'chevron-forward' }}
-          interactionPolicy={interactionPolicy}
-          label={nextPageLabel ?? 'Next page'}
-          onPress={() => invokeReaderAction(onNextPage)}
-          size="l"
-        />
-      </View>
-      {footerActions ? <View>{footerActions}</View> : null}
-    </View>
-  );
-}
-
-function ReaderSurfaceInner({
-  themeId: _themeId,
-  mode: _mode,
-  interactionPolicy,
-  source: _source,
-  format: _format,
-  location: _location,
-  status = 'idle',
-  page,
-  pageCount,
-  progress,
-  canGoPrevious,
-  canGoNext,
-  title,
-  subtitle,
-  chapterLabel,
-  pageLabel,
-  previousPageLabel = 'Previous page',
-  nextPageLabel = 'Next page',
-  contentsLabel = 'Table of contents',
-  appearanceLabel = 'Reading appearance',
-  highlightLabel = 'Toggle highlight',
-  loadingLabel = 'Loading document…',
-  errorTitle = 'Unable to open this document.',
-  unavailableTitle = 'Reader preview unavailable.',
-  showChrome = true,
-  readerColorScheme: _readerColorScheme = 'system',
-  fontScale: _fontScale = 1,
-  lineHeight: _lineHeight = 'normal',
-  highlighted = false,
-  viewport,
-  headerActions,
-  footerActions,
-  onPreviousPage,
-  onNextPage,
-  onLocationChange: _onLocationChange,
-  onOpenContents,
-  onOpenAppearance,
-  onToggleHighlight,
-  onOpenExternalLink: _onOpenExternalLink,
-  onReaderError: _onReaderError,
-  testID,
-}: ReaderSurfaceProps) {
-  const { theme } = useZoraTheme();
-
-  const viewportContent =
-    viewport && status !== 'error' ? (
-      viewport
-    ) : (
-      <ReaderEmptyState
-        errorTitle={errorTitle}
-        loadingLabel={loadingLabel}
-        status={status}
-        unavailableTitle={unavailableTitle}
-      />
-    );
-
-  return (
-    <Surface
-      radius="l"
-      testID={testID}
-      variant="default"
-      style={{ minHeight: 480, overflow: 'hidden' }}
-    >
-      <View flex={1} gap={0}>
-        {showChrome ? (
-          <ReaderHeader
-            appearanceLabel={appearanceLabel}
-            contentsLabel={contentsLabel}
-            headerActions={headerActions}
-            highlightLabel={highlightLabel}
-            highlighted={highlighted}
-            interactionPolicy={interactionPolicy}
-            onOpenAppearance={onOpenAppearance}
-            onOpenContents={onOpenContents}
-            onToggleHighlight={onToggleHighlight}
-            subtitle={subtitle}
-            title={title}
-          />
-        ) : null}
-
-        <View bg={theme.semantics.surface.default} flex={1} minHeight={360} overflow="hidden">
-          {viewportContent}
-        </View>
-
-        {showChrome ? (
-          <ReaderFooter
-            canGoNext={canGoNext}
-            canGoPrevious={canGoPrevious}
-            chapterLabel={chapterLabel}
-            footerActions={footerActions}
-            interactionPolicy={interactionPolicy}
-            nextPageLabel={nextPageLabel}
-            onNextPage={onNextPage}
-            onPreviousPage={onPreviousPage}
-            page={page}
-            pageCount={pageCount}
-            pageLabel={pageLabel}
-            previousPageLabel={previousPageLabel}
-            progress={progress}
-            status={status}
-          />
-        ) : null}
-      </View>
-    </Surface>
-  );
-}
-
-/***
- * Adapter-neutral reader shell for EPUB and PDF experiences.
- *
- * Supply the actual renderer through `viewport`; ZORA owns only the reader
- * chrome, controlled state, progress, accessible controls, and normalized
- * adapter callbacks.
- */
-export const ReaderSurface = withZoraThemeScope(ReaderSurfaceInner);

package/src/patterns/reader/index.ts

@@ -1,15 +0,0 @@
-export { ReaderSurface } from './ReaderSurface';
-export { resolveReaderProgress } from './resolveReaderProgress';
-export type {
-  ReaderColorScheme,
-  ReaderDocumentFormat,
-  ReaderErrorCode,
-  ReaderErrorEvent,
-  ReaderExternalLinkEvent,
-  ReaderLineHeight,
-  ReaderLocationChangeEvent,
-  ReaderNavigationTrigger,
-  ReaderResolvedSource,
-  ReaderStatus,
-  ReaderSurfaceProps,
-} from './types';