@ankhorage/zora 25.8.17 → 25.9.0

package/dist/features/layout/adapters/inbound/ScrollView.js

@@ -7,12 +7,12 @@ import { useScrollGestureLock } from './useScrollGestureLock';
 /*** Adapts the token-aware Surface ScrollView primitive to ZORA theme scope. */
 export const ScrollView = withZoraThemeScope(ScrollViewInner);
 /*** Forwards ZORA scrolling props to the published Surface ScrollView boundary and yields scrolling to active descendant gestures. */
-function ScrollViewInner({ themeId: _themeId, mode: _mode, interactionPolicy: _interactionPolicy, scrollEnabled = true, ...props }) {
+function ScrollViewInner({ themeId: _themeId, mode: _mode, interactionPolicy, scrollEnabled = true, onRefresh, ...props }) {
     const parentLock = useScrollGestureLock();
     const [activeGestures, setActiveGestures] = React.useState(0);
     const lock = React.useMemo(() => createScrollGestureLock(parentLock, (delta) => setActiveGestures((count) => count + delta)), [parentLock]);
     return (<ScrollGestureLockContext.Provider value={lock}>
-      <SurfaceScrollView {...props} scrollEnabled={scrollEnabled && activeGestures === 0}/>
+      <SurfaceScrollView {...props} onRefresh={interactionPolicy === 'passive' ? undefined : onRefresh} scrollEnabled={scrollEnabled && activeGestures === 0}/>
     </ScrollGestureLockContext.Provider>);
 }
 //# sourceMappingURL=ScrollView.js.map

package/dist/features/layout/adapters/inbound/ScrollView.js.map

@@ -1 +1 @@
-{"version":3,"file":"ScrollView.js","sourceRoot":"","sources":["../../../../../src/features/layout/adapters/inbound/ScrollView.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,IAAI,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,oDAAoD,CAAC;AACxF,OAAO,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,gFAAgF;AAChF,MAAM,CAAC,MAAM,UAAU,GAAG,kBAAkB,CAAC,eAAe,CAAC,CAAC;AAE9D,sIAAsI;AACtI,SAAS,eAAe,CAAC,EACvB,OAAO,EAAE,QAAQ,EACjB,IAAI,EAAE,KAAK,EACX,iBAAiB,EAAE,kBAAkB,EACrC,aAAa,GAAG,IAAI,EACpB,GAAG,KAAK,EACQ;IAChB,MAAM,UAAU,GAAG,oBAAoB,EAAE,CAAC;IAC1C,MAAM,CAAC,cAAc,EAAE,iBAAiB,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC9D,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CACxB,GAAG,EAAE,CACH,uBAAuB,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,EAC7F,CAAC,UAAU,CAAC,CACb,CAAC;IAEF,OAAO,CACL,CAAC,wBAAwB,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAC7C;MAAA,CAAC,iBAAiB,CAAC,IAAI,KAAK,CAAC,CAAC,aAAa,CAAC,CAAC,aAAa,IAAI,cAAc,KAAK,CAAC,CAAC,EACrF;IAAA,EAAE,wBAAwB,CAAC,QAAQ,CAAC,CACrC,CAAC;AACJ,CAAC","sourcesContent":["import { ScrollView as SurfaceScrollView } from '@ankhorage/surface';\nimport React from 'react';\n\nimport type { ScrollViewProps } from '../../../../types/layout';\nimport { withZoraThemeScope } from '../../../theme/adapters/inbound/withZoraThemeScope';\nimport { createScrollGestureLock } from '../../utils/createScrollGestureLock';\nimport { ScrollGestureLockContext } from './ScrollGestureLockContext';\nimport { useScrollGestureLock } from './useScrollGestureLock';\n\n/*** Adapts the token-aware Surface ScrollView primitive to ZORA theme scope. */\nexport const ScrollView = withZoraThemeScope(ScrollViewInner);\n\n/*** Forwards ZORA scrolling props to the published Surface ScrollView boundary and yields scrolling to active descendant gestures. */\nfunction ScrollViewInner({\n  themeId: _themeId,\n  mode: _mode,\n  interactionPolicy: _interactionPolicy,\n  scrollEnabled = true,\n  ...props\n}: ScrollViewProps) {\n  const parentLock = useScrollGestureLock();\n  const [activeGestures, setActiveGestures] = React.useState(0);\n  const lock = React.useMemo(\n    () =>\n      createScrollGestureLock(parentLock, (delta) => setActiveGestures((count) => count + delta)),\n    [parentLock],\n  );\n\n  return (\n    <ScrollGestureLockContext.Provider value={lock}>\n      <SurfaceScrollView {...props} scrollEnabled={scrollEnabled && activeGestures === 0} />\n    </ScrollGestureLockContext.Provider>\n  );\n}\n"]}
+{"version":3,"file":"ScrollView.js","sourceRoot":"","sources":["../../../../../src/features/layout/adapters/inbound/ScrollView.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,IAAI,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,oDAAoD,CAAC;AACxF,OAAO,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,gFAAgF;AAChF,MAAM,CAAC,MAAM,UAAU,GAAG,kBAAkB,CAAC,eAAe,CAAC,CAAC;AAE9D,sIAAsI;AACtI,SAAS,eAAe,CAAC,EACvB,OAAO,EAAE,QAAQ,EACjB,IAAI,EAAE,KAAK,EACX,iBAAiB,EACjB,aAAa,GAAG,IAAI,EACpB,SAAS,EACT,GAAG,KAAK,EACQ;IAChB,MAAM,UAAU,GAAG,oBAAoB,EAAE,CAAC;IAC1C,MAAM,CAAC,cAAc,EAAE,iBAAiB,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC9D,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CACxB,GAAG,EAAE,CACH,uBAAuB,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,EAC7F,CAAC,UAAU,CAAC,CACb,CAAC;IAEF,OAAO,CACL,CAAC,wBAAwB,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAC7C;MAAA,CAAC,iBAAiB,CAChB,IAAI,KAAK,CAAC,CACV,SAAS,CAAC,CAAC,iBAAiB,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CACnE,aAAa,CAAC,CAAC,aAAa,IAAI,cAAc,KAAK,CAAC,CAAC,EAEzD;IAAA,EAAE,wBAAwB,CAAC,QAAQ,CAAC,CACrC,CAAC;AACJ,CAAC","sourcesContent":["import { ScrollView as SurfaceScrollView } from '@ankhorage/surface';\nimport React from 'react';\n\nimport type { ScrollViewProps } from '../../../../types/layout';\nimport { withZoraThemeScope } from '../../../theme/adapters/inbound/withZoraThemeScope';\nimport { createScrollGestureLock } from '../../utils/createScrollGestureLock';\nimport { ScrollGestureLockContext } from './ScrollGestureLockContext';\nimport { useScrollGestureLock } from './useScrollGestureLock';\n\n/*** Adapts the token-aware Surface ScrollView primitive to ZORA theme scope. */\nexport const ScrollView = withZoraThemeScope(ScrollViewInner);\n\n/*** Forwards ZORA scrolling props to the published Surface ScrollView boundary and yields scrolling to active descendant gestures. */\nfunction ScrollViewInner({\n  themeId: _themeId,\n  mode: _mode,\n  interactionPolicy,\n  scrollEnabled = true,\n  onRefresh,\n  ...props\n}: ScrollViewProps) {\n  const parentLock = useScrollGestureLock();\n  const [activeGestures, setActiveGestures] = React.useState(0);\n  const lock = React.useMemo(\n    () =>\n      createScrollGestureLock(parentLock, (delta) => setActiveGestures((count) => count + delta)),\n    [parentLock],\n  );\n\n  return (\n    <ScrollGestureLockContext.Provider value={lock}>\n      <SurfaceScrollView\n        {...props}\n        onRefresh={interactionPolicy === 'passive' ? undefined : onRefresh}\n        scrollEnabled={scrollEnabled && activeGestures === 0}\n      />\n    </ScrollGestureLockContext.Provider>\n  );\n}\n"]}

package/dist/features/layout/scrollViewMeta.d.ts

@@ -3,12 +3,25 @@ export declare const scrollViewMeta: {
     readonly category: "foundation";
     readonly directManifestNode: true;
     readonly allowedChildren: readonly ["ActivityIndicator", "AuthScreen", "ForgotPasswordForm", "OAuthProviderButton", "OAuthProviderList", "OtpForm", "SignInForm", "SignUpForm", "Accordion", "Surface", "Avatar", "AvatarGroup", "Badge", "MediaCard", "MetricCard", "Chip", "ChipGroup", "DataTable", "DatePicker", "Dialog", "Pagination", "Rating", "SearchInput", "Tabs", "Toolbar", "Skeleton", "SkeletonCard", "SkeletonList", "SkeletonText", "IconButton", "Uploader", "MediaExplorer", "FileExplorer", "FlatList", "SectionList", "BottomSheet", "ProductCard", "View", "ScrollView", "Grid", "Gradient", "Divider", "Text", "Heading", "Icon", "Image", "Hero", "KeyboardAvoidingView", "Button", "ButtonGroup", "RadioGroup", "ThemeModeToggle", "TextInput", "TimePicker", "Form", "Card", "EmptyState", "SectionHeader", "PostCard", "ChatListItem", "MessageBubble", "ProgressRing", "Reader", "ContentRail", "MissingElement"];
+    readonly events: {
+        readonly refresh: {
+            readonly label: "Refresh";
+            readonly eventType: "scrollView.refresh";
+            readonly description: "Emitted when the native refresh control requests fresh content.";
+            readonly payloadFields: readonly [];
+        };
+    };
     readonly props: {
         readonly horizontal: {
             readonly type: "boolean";
             readonly category: "Layout";
             readonly default: false;
         };
+        readonly refreshing: {
+            readonly type: "boolean";
+            readonly category: "State";
+            readonly default: false;
+        };
         readonly p: {
             readonly type: "spacing";
             readonly category: "Spacing";

package/dist/features/layout/scrollViewMeta.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scrollViewMeta.d.ts","sourceRoot":"","sources":["../../../src/features/layout/scrollViewMeta.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CASW,CAAC"}
+{"version":3,"file":"scrollViewMeta.d.ts","sourceRoot":"","sources":["../../../src/features/layout/scrollViewMeta.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkBW,CAAC"}

package/dist/features/layout/scrollViewMeta.js

@@ -5,9 +5,18 @@ export const scrollViewMeta = {
     category: 'foundation',
     directManifestNode: true,
     allowedChildren: [...CONTAINER_ALLOWED_CHILDREN],
+    events: {
+        refresh: {
+            label: 'Refresh',
+            eventType: 'scrollView.refresh',
+            description: 'Emitted when the native refresh control requests fresh content.',
+            payloadFields: [],
+        },
+    },
     props: {
         ...LAYOUT_PROPS,
         horizontal: { type: 'boolean', category: 'Layout', default: false },
+        refreshing: { type: 'boolean', category: 'State', default: false },
     },
 };
 //# sourceMappingURL=scrollViewMeta.js.map

package/dist/features/layout/scrollViewMeta.js.map

@@ -1 +1 @@
-{"version":3,"file":"scrollViewMeta.js","sourceRoot":"","sources":["../../../src/features/layout/scrollViewMeta.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AAEvE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,IAAI,EAAE,YAAY;IAClB,QAAQ,EAAE,YAAY;IACtB,kBAAkB,EAAE,IAAI;IACxB,eAAe,EAAE,CAAC,GAAG,0BAA0B,CAAC;IAChD,KAAK,EAAE;QACL,GAAG,YAAY;QACf,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE;KACpE;CACmC,CAAC","sourcesContent":["import { CONTAINER_ALLOWED_CHILDREN } from '../../constants/authoring';\nimport type { ZoraComponentMeta } from '../../types/authoring';\nimport { LAYOUT_PROPS } from './constants';\n\nexport const scrollViewMeta = {\n  name: 'ScrollView',\n  category: 'foundation',\n  directManifestNode: true,\n  allowedChildren: [...CONTAINER_ALLOWED_CHILDREN],\n  props: {\n    ...LAYOUT_PROPS,\n    horizontal: { type: 'boolean', category: 'Layout', default: false },\n  },\n} as const satisfies ZoraComponentMeta;\n"]}
+{"version":3,"file":"scrollViewMeta.js","sourceRoot":"","sources":["../../../src/features/layout/scrollViewMeta.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AAEvE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,IAAI,EAAE,YAAY;IAClB,QAAQ,EAAE,YAAY;IACtB,kBAAkB,EAAE,IAAI;IACxB,eAAe,EAAE,CAAC,GAAG,0BAA0B,CAAC;IAChD,MAAM,EAAE;QACN,OAAO,EAAE;YACP,KAAK,EAAE,SAAS;YAChB,SAAS,EAAE,oBAAoB;YAC/B,WAAW,EAAE,iEAAiE;YAC9E,aAAa,EAAE,EAAE;SAClB;KACF;IACD,KAAK,EAAE;QACL,GAAG,YAAY;QACf,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE;QACnE,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE;KACnE;CACmC,CAAC","sourcesContent":["import { CONTAINER_ALLOWED_CHILDREN } from '../../constants/authoring';\nimport type { ZoraComponentMeta } from '../../types/authoring';\nimport { LAYOUT_PROPS } from './constants';\n\nexport const scrollViewMeta = {\n  name: 'ScrollView',\n  category: 'foundation',\n  directManifestNode: true,\n  allowedChildren: [...CONTAINER_ALLOWED_CHILDREN],\n  events: {\n    refresh: {\n      label: 'Refresh',\n      eventType: 'scrollView.refresh',\n      description: 'Emitted when the native refresh control requests fresh content.',\n      payloadFields: [],\n    },\n  },\n  props: {\n    ...LAYOUT_PROPS,\n    horizontal: { type: 'boolean', category: 'Layout', default: false },\n    refreshing: { type: 'boolean', category: 'State', default: false },\n  },\n} as const satisfies ZoraComponentMeta;\n"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ankhorage/zora",
   "type": "module",
-  "version": "25.8.17",
+  "version": "25.9.0",
   "description": "Opinionated React Native and React Native Web UI kit built on @ankhorage/surface.",
   "homepage": "https://github.com/ankhorage/zora#readme",
   "bugs": {
@@ -44,13 +44,13 @@
     "@ankhorage/ankh": "^0.13.2",
     "@ankhorage/capability": "^0.2.2",
     "@ankhorage/color-theory": "^0.3.1",
-    "@ankhorage/contracts": "^26.0.0",
+    "@ankhorage/contracts": "^26.0.2",
     "@ankhorage/game": "^0.1.3",
     "@ankhorage/grid-view": "^0.5.0",
     "@ankhorage/reader": "^0.1.1",
-    "@ankhorage/runtime": "^5.0.3",
-    "@ankhorage/surface": "^9.4.6",
-    "@ankhorage/utility": "^1.9.86",
+    "@ankhorage/runtime": "^5.1.2",
+    "@ankhorage/surface": "^9.4.12",
+    "@ankhorage/utility": "^1.10.0",
     "chess.js": "^1.4.0",
     "expo-document-picker": "~57.0.3",
     "expo-image-picker": "~57.0.20"
@@ -120,6 +120,16 @@
       "import": "./dist/features/theme/public.js",
       "default": "./dist/features/theme/public.js"
     },
+    "./web/runtime": {
+      "types": "./web-dist/runtime/ZoraProvider.d.ts",
+      "import": "./web-dist/runtime/ZoraProvider.js",
+      "default": "./web-dist/runtime/ZoraProvider.js"
+    },
+    "./web/*": {
+      "types": "./web-dist/components/*/index.d.ts",
+      "import": "./web-dist/components/*/index.js",
+      "default": "./web-dist/components/*/index.js"
+    },
     "./package.json": "./package.json",
     "./cli": {
       "types": "./dist/cli/index.d.ts",
@@ -149,7 +159,7 @@
     "version-packages": "ankhorage-changeset version"
   },
   "devDependencies": {
-    "@ankhorage/devtools": "^2.3.21",
+    "@ankhorage/devtools": "^2.3.26",
     "@ankhorage/paradox": "^0.3.5",
     "@react-native-vector-icons/fontawesome": "^14.0.0",
     "@react-native-vector-icons/fontawesome5": "^14.0.0",
@@ -1609,6 +1619,27 @@
           }
         }
       },
+      {
+        "id": "scrollView.refresh",
+        "owner": "@ankhorage/zora",
+        "access": [
+          "emit"
+        ],
+        "binding": {
+          "kind": "event",
+          "bindableAs": [
+            "source"
+          ]
+        },
+        "label": "Refresh",
+        "description": "Emitted when the native refresh control requests fresh content.",
+        "output": {
+          "schema": {
+            "type": "object",
+            "properties": {}
+          }
+        }
+      },
       {
         "id": "searchInput.clear",
         "owner": "@ankhorage/zora",

package/src/expo57Migration.test.ts

@@ -33,7 +33,6 @@ const EXPO_57_GRID_WORKSPACES_CONTRACT = {
   expo: '~57.0.30',
   metroConfig: '0.86.3',
   typesReact: '~19.2.18',
-  zora: '25.8.15',
 } as const;
 const GRID_WORKSPACES_MANIFEST = 'examples/grid-workspaces/package.json';
 
@@ -163,7 +162,7 @@ describe('Expo 57 example boundary', () => {
     const development = readRecord(packageJson, 'devDependencies');
 
     expect(dependencies.expo).toBe(EXPO_57_GRID_WORKSPACES_CONTRACT.expo);
-    expect(dependencies['@ankhorage/zora']).toBe(EXPO_57_GRID_WORKSPACES_CONTRACT.zora);
+    expect(dependencies['@ankhorage/zora']).toMatch(SEMVER_PATTERNS.exact);
     expect(dependencies['@react-native/metro-config']).toBe(
       EXPO_57_GRID_WORKSPACES_CONTRACT.metroConfig,
     );

package/src/features/layout/adapters/inbound/ScrollView.test.tsx

@@ -33,8 +33,18 @@ const reactNativeWeb = await import('react-native-web');
 await mock.module('react-native', () => reactNativeWeb);
 // ZORA's ScrollView only needs Surface's ScrollView and ThemeScope; the real package would load
 // native-only peers, so the DOM-capable react-native-web ScrollView stands in for the primitive.
+type SurfaceScrollViewProps = React.ComponentProps<typeof reactNativeWeb.ScrollView> & {
+  readonly onRefresh?: () => void;
+  readonly refreshing?: boolean;
+};
+
+const surfaceScrollViewProps: SurfaceScrollViewProps[] = [];
+
 await mock.module('@ankhorage/surface', () => ({
-  ScrollView: reactNativeWeb.ScrollView,
+  ScrollView: (props: SurfaceScrollViewProps) => {
+    surfaceScrollViewProps.push(props);
+    return React.createElement(reactNativeWeb.ScrollView, props);
+  },
   ThemeScope: ({ children }: { readonly children: React.ReactNode }) => children,
 }));
 const { ScrollView } = await import('./ScrollView');
@@ -232,3 +242,52 @@ test('never re-enables a ScrollView that the caller disabled explicitly', async
     await mounted.unmount();
   }
 });
+
+test('forwards controlled refresh state and does not simulate a native pull gesture on web', async () => {
+  const mounted = mount();
+  const refreshSignals: undefined[] = [];
+  const onRefresh = () => refreshSignals.push(undefined);
+  try {
+    await mounted.render(
+      <ScrollView refreshing={false} onRefresh={onRefresh} testID="refreshable-scroll-view" />,
+    );
+    expect(surfaceScrollViewProps.at(-1)?.refreshing).toBe(false);
+    expect(surfaceScrollViewProps.at(-1)?.onRefresh).toBe(onRefresh);
+
+    await mounted.swipe('refreshable-scroll-view');
+    expect(refreshSignals).toEqual([]);
+
+    surfaceScrollViewProps.at(-1)?.onRefresh?.();
+    expect(refreshSignals).toEqual([undefined]);
+
+    await mounted.render(
+      <ScrollView refreshing onRefresh={onRefresh} testID="refreshable-scroll-view" />,
+    );
+    expect(surfaceScrollViewProps.at(-1)?.refreshing).toBe(true);
+
+    await mounted.render(
+      <ScrollView refreshing={false} onRefresh={onRefresh} testID="refreshable-scroll-view" />,
+    );
+    expect(surfaceScrollViewProps.at(-1)?.refreshing).toBe(false);
+  } finally {
+    await mounted.unmount();
+  }
+});
+
+test('suppresses pull-to-refresh while the interaction policy is passive', async () => {
+  const mounted = mount();
+  const onRefresh = () => undefined;
+  try {
+    await mounted.render(
+      <ScrollView
+        interactionPolicy="passive"
+        onRefresh={onRefresh}
+        testID="passive-refreshable-scroll-view"
+      />,
+    );
+
+    expect(surfaceScrollViewProps.at(-1)?.onRefresh).toBeUndefined();
+  } finally {
+    await mounted.unmount();
+  }
+});

package/src/features/layout/adapters/inbound/ScrollView.tsx

@@ -14,8 +14,9 @@ export const ScrollView = withZoraThemeScope(ScrollViewInner);
 function ScrollViewInner({
   themeId: _themeId,
   mode: _mode,
-  interactionPolicy: _interactionPolicy,
+  interactionPolicy,
   scrollEnabled = true,
+  onRefresh,
   ...props
 }: ScrollViewProps) {
   const parentLock = useScrollGestureLock();
@@ -28,7 +29,11 @@ function ScrollViewInner({
 
   return (
     <ScrollGestureLockContext.Provider value={lock}>
-      <SurfaceScrollView {...props} scrollEnabled={scrollEnabled && activeGestures === 0} />
+      <SurfaceScrollView
+        {...props}
+        onRefresh={interactionPolicy === 'passive' ? undefined : onRefresh}
+        scrollEnabled={scrollEnabled && activeGestures === 0}
+      />
     </ScrollGestureLockContext.Provider>
   );
 }

package/src/features/layout/scrollViewMeta.ts

@@ -7,8 +7,17 @@ export const scrollViewMeta = {
   category: 'foundation',
   directManifestNode: true,
   allowedChildren: [...CONTAINER_ALLOWED_CHILDREN],
+  events: {
+    refresh: {
+      label: 'Refresh',
+      eventType: 'scrollView.refresh',
+      description: 'Emitted when the native refresh control requests fresh content.',
+      payloadFields: [],
+    },
+  },
   props: {
     ...LAYOUT_PROPS,
     horizontal: { type: 'boolean', category: 'Layout', default: false },
+    refreshing: { type: 'boolean', category: 'State', default: false },
   },
 } as const satisfies ZoraComponentMeta;

package/src/features/registry/componentMeta.test.ts

@@ -101,6 +101,26 @@ describe('ZORA_COMPONENT_META event metadata', () => {
   });
 
   test('owns controlled component events in direct metadata and projects their bindings', () => {
+    expect(ZORA_COMPONENT_META.ScrollView.props.refreshing).toMatchObject({
+      type: 'boolean',
+      category: 'State',
+      default: false,
+    });
+    expect(ZORA_COMPONENT_META.ScrollView.events?.refresh).toMatchObject({
+      eventType: 'scrollView.refresh',
+      payloadFields: [],
+    });
+    expect(ZORA_COMPONENT_META.ScrollView.bindings?.props?.refreshing.value).toEqual({
+      type: 'boolean',
+    });
+    expect(ZORA_COMPONENT_META.ScrollView.bindings?.events?.refresh.payload).toEqual({
+      eventType: 'scrollView.refresh',
+      fields: [],
+    });
+    for (const component of [ZORA_COMPONENT_META.FlatList, ZORA_COMPONENT_META.SectionList]) {
+      expect(component.props.refreshing).toMatchObject({ type: 'boolean', category: 'State' });
+      expect(component.events?.refresh.payloadFields).toEqual([]);
+    }
     expect(ZORA_COMPONENT_META.TextInput.events?.changeText).toMatchObject({
       eventType: 'textInput.changeText',
       payloadFields: [{ path: 'value', type: 'string' }],

package/src/webPackageExports.test.ts

@@ -0,0 +1,101 @@
+import { mkdtemp, rm, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+
+import { expect, test } from 'bun:test';
+import React from 'react';
+import { renderToStaticMarkup } from 'react-dom/server';
+
+const forbiddenWebDependencies = [
+  'expo-document-picker',
+  'expo-image-picker',
+  '@gorhom/bottom-sheet',
+  'react-native-gesture-handler',
+] as const;
+
+/** Verifies that stable package web subpaths resolve only their requested UI graph. */
+test('publishes SSR-safe ordinary UI through canonical web subpaths', async () => {
+  const packageJson = (await Bun.file('package.json').json()) as {
+    readonly exports: Record<string, unknown>;
+  };
+  expect(packageJson.exports['./web/runtime']).toEqual({
+    types: './web-dist/runtime/ZoraProvider.d.ts',
+    import: './web-dist/runtime/ZoraProvider.js',
+    default: './web-dist/runtime/ZoraProvider.js',
+  });
+  expect(packageJson.exports['./web/*']).toEqual({
+    types: './web-dist/components/*/index.d.ts',
+    import: './web-dist/components/*/index.js',
+    default: './web-dist/components/*/index.js',
+  });
+
+  const temporaryDirectory = await mkdtemp(join(process.cwd(), '.cache-zora-web-entrypoints-'));
+  try {
+    const entrypoint = join(temporaryDirectory, 'dashboard.tsx');
+    await writeFile(
+      entrypoint,
+      [
+        "export { ZoraProvider } from '@ankhorage/zora/web/runtime';",
+        "export { AppBar } from '@ankhorage/zora/web/app-bar';",
+        "export { AppShell } from '@ankhorage/zora/web/app-shell';",
+        "export { Badge } from '@ankhorage/zora/web/badge';",
+        "export { Button } from '@ankhorage/zora/web/button';",
+        "export { Card } from '@ankhorage/zora/web/card';",
+        "export { DataTable } from '@ankhorage/zora/web/data-table';",
+        "export { Dialog } from '@ankhorage/zora/web/dialog';",
+        "export { MetricCard } from '@ankhorage/zora/web/metric-card';",
+        "export { PopoverMenu } from '@ankhorage/zora/web/popover-menu';",
+        "export { Select } from '@ankhorage/zora/web/select';",
+        "export { TextInput } from '@ankhorage/zora/web/text-input';",
+        "export { Text } from '@ankhorage/zora/web/text';",
+        "export { Heading } from '@ankhorage/zora/web/heading';",
+        "export { View } from '@ankhorage/zora/web/view';",
+        '',
+      ].join('\n'),
+      'utf8',
+    );
+
+    const build = await Bun.build({
+      entrypoints: [entrypoint],
+      target: 'browser',
+      format: 'esm',
+      external: ['react', 'react/*', 'react-dom', 'react-dom/*'],
+    });
+    expect(build.success).toBe(true);
+    const graph = (await Promise.all(build.outputs.map((output) => output.text()))).join('\n');
+    for (const dependency of forbiddenWebDependencies) {
+      expect(graph).not.toContain(dependency);
+    }
+  } finally {
+    await rm(temporaryDirectory, { force: true, recursive: true });
+  }
+});
+
+/** Renders the generated public web entrypoints without a native runtime host. */
+test('SSR-renders ordinary UI from its public web subpaths', async () => {
+  const [{ ZoraProvider }, { AppShell }, { Button }, { Screen }, { Text }] = await Promise.all([
+    import('@ankhorage/zora/web/runtime'),
+    import('@ankhorage/zora/web/app-shell'),
+    import('@ankhorage/zora/web/button'),
+    import('@ankhorage/zora/web/screen'),
+    import('@ankhorage/zora/web/text'),
+  ]);
+  const markup = renderToStaticMarkup(
+    React.createElement(
+      ZoraProvider,
+      { mode: 'light' },
+      React.createElement(
+        AppShell,
+        undefined,
+        React.createElement(
+          Screen,
+          undefined,
+          React.createElement(Text, undefined, 'Web entrypoint'),
+          React.createElement(Button, undefined, 'Continue'),
+        ),
+      ),
+    ),
+  );
+
+  expect(markup).toContain('Web entrypoint');
+  expect(markup).toContain('Continue');
+});

package/web-dist/chunks/{Accordion-ep35792s.js → Accordion-0x8jncra.js}

@@ -2,11 +2,11 @@
 import {
   resolveResponsive,
   useResponsiveRuntime
-} from "./Accordion-09qs8gt1.js";
+} from "./Accordion-zj4wnm3e.js";
 import {
   View3,
   Divider3
-} from "./Accordion-z5a0tx18.js";
+} from "./Accordion-58yzdsab.js";
 import {
   useTheme
 } from "./Accordion-6wrr910w.js";
@@ -16,7 +16,7 @@ import {
 import {
   resolveSpacing,
   resolveViewStyles
-} from "./Accordion-184r2r82.js";
+} from "./Accordion-yq16wwh5.js";
 import {
   require_cjs
 } from "./Accordion-xgpzh4wq.js";
@@ -177,7 +177,15 @@ function ScrollView(props) {
   const visual = splitVisualProps(spacing.rest);
   const dimensions = splitDimensionProps(visual.rest);
   const layout = splitLayoutProps(dimensions.rest);
-  const { children, contentContainerStyle, style, ...scrollProps } = layout.rest;
+  const {
+    children,
+    contentContainerStyle,
+    style,
+    refreshing,
+    onRefresh,
+    refreshControl: nativeRefreshControl,
+    ...scrollProps
+  } = layout.rest;
   const resolved = resolveViewStyles(theme, breakpoint, {
     ...spacing.styleProps,
     ...visual.styleProps,
@@ -187,10 +195,23 @@ function ScrollView(props) {
   return /* @__PURE__ */ jsx6(import_react_native2.ScrollView, {
     ...scrollProps,
     contentContainerStyle,
+    refreshControl: resolveRefreshControl({ nativeRefreshControl, onRefresh, refreshing }),
     style: [resolved, style],
     children
   });
 }
+function resolveRefreshControl({
+  nativeRefreshControl,
+  onRefresh,
+  refreshing
+}) {
+  if (onRefresh === undefined && refreshing === undefined)
+    return nativeRefreshControl;
+  return /* @__PURE__ */ jsx6(import_react_native2.RefreshControl, {
+    onRefresh,
+    refreshing: refreshing ?? false
+  });
+}
 function splitSpacingProps(props) {
   const { p, px, py, pt, pb, pl, pr, m, mx, my, mt, mb, ml, mr, gap, rowGap, columnGap, ...rest } = props;
   return {
@@ -291,8 +312,9 @@ var ScrollView2 = withZoraThemeScope(ScrollViewInner);
 function ScrollViewInner({
   themeId: _themeId,
   mode: _mode,
-  interactionPolicy: _interactionPolicy,
+  interactionPolicy,
   scrollEnabled = true,
+  onRefresh,
   ...props
 }) {
   const parentLock = useScrollGestureLock();
@@ -302,6 +324,7 @@ function ScrollViewInner({
     value: lock,
     children: /* @__PURE__ */ jsx7(ScrollView, {
       ...props,
+      onRefresh: interactionPolicy === "passive" ? undefined : onRefresh,
       scrollEnabled: scrollEnabled && activeGestures === 0
     })
   });

package/web-dist/chunks/{Accordion-cbbafww1.js → Accordion-1jxtw4vn.js}

@@ -7,10 +7,10 @@ import {
 } from "./Accordion-1fsrnq73.js";
 import {
   View2
-} from "./Accordion-ep35792s.js";
+} from "./Accordion-0x8jncra.js";
 import {
   Text3
-} from "./Accordion-vqx3exsq.js";
+} from "./Accordion-37fyjrmm.js";
 import {
   useZoraTheme2
 } from "./Accordion-srjya6dz.js";

package/web-dist/chunks/{Accordion-cjjg81ry.js → Accordion-221757sc.js}

@@ -1,22 +1,22 @@
 'use client';
 import {
   Button2
-} from "./Accordion-czcaf5x2.js";
+} from "./Accordion-z43mw081.js";
 import {
   withZoraThemeScope
 } from "./Accordion-vj1m2wck.js";
 import {
   View2
-} from "./Accordion-ep35792s.js";
+} from "./Accordion-0x8jncra.js";
 import {
   Card2
-} from "./Accordion-1495be5z.js";
+} from "./Accordion-whk372cs.js";
 import {
   Text3
-} from "./Accordion-vqx3exsq.js";
+} from "./Accordion-37fyjrmm.js";
 import {
   Badge2
-} from "./Accordion-xgxxg1hz.js";
+} from "./Accordion-jz4j00nh.js";
 import {
   useZoraTheme2
 } from "./Accordion-srjya6dz.js";

package/web-dist/chunks/{Accordion-h9brgsk8.js → Accordion-2ga81fwp.js}

@@ -4,7 +4,7 @@ import {
 } from "./Accordion-vj1m2wck.js";
 import {
   View2
-} from "./Accordion-ep35792s.js";
+} from "./Accordion-0x8jncra.js";
 
 // src/features/gradient/adapters/inbound/GradientRendererContext.tsx
 import { createContext, use } from "react";

package/web-dist/chunks/{Accordion-jyemxzat.js → Accordion-2r2tm2nk.js}

@@ -1,16 +1,16 @@
 'use client';
 import {
   Button2
-} from "./Accordion-czcaf5x2.js";
+} from "./Accordion-z43mw081.js";
 import {
   withZoraThemeScope
 } from "./Accordion-vj1m2wck.js";
 import {
   View2
-} from "./Accordion-ep35792s.js";
+} from "./Accordion-0x8jncra.js";
 import {
   Text3
-} from "./Accordion-vqx3exsq.js";
+} from "./Accordion-37fyjrmm.js";
 import {
   useZoraTheme2
 } from "./Accordion-srjya6dz.js";

package/web-dist/chunks/{Accordion-vqx3exsq.js → Accordion-37fyjrmm.js}

@@ -2,7 +2,7 @@
 import {
   resolveResponsive,
   useResponsiveRuntime
-} from "./Accordion-09qs8gt1.js";
+} from "./Accordion-zj4wnm3e.js";
 import {
   withZoraThemeScope
 } from "./Accordion-vj1m2wck.js";

package/web-dist/chunks/{Accordion-d0bebw9j.js → Accordion-43g7xsam.js}

@@ -1,7 +1,7 @@
 'use client';
 import {
   Button2
-} from "./Accordion-czcaf5x2.js";
+} from "./Accordion-z43mw081.js";
 import {
   withZoraThemeScope
 } from "./Accordion-vj1m2wck.js";
@@ -9,28 +9,28 @@ import {
   View2,
   Divider2,
   ScrollView2
-} from "./Accordion-ep35792s.js";
+} from "./Accordion-0x8jncra.js";
 import {
   FormActions2,
   FormError2,
   hasRequiredRule,
   useFormController
-} from "./Accordion-jyemxzat.js";
+} from "./Accordion-2r2tm2nk.js";
 import {
   Text3
-} from "./Accordion-vqx3exsq.js";
+} from "./Accordion-37fyjrmm.js";
 import {
   Field2
-} from "./Accordion-4x8gdqqs.js";
+} from "./Accordion-fvv1jb72.js";
 import {
   TextInput2
-} from "./Accordion-y2pss5p0.js";
+} from "./Accordion-nmxdqe80.js";
 import {
   KeyboardAvoidingView2
 } from "./Accordion-r2g18vxa.js";
 import {
   Surface2
-} from "./Accordion-x055n3b3.js";
+} from "./Accordion-vj2yj9fa.js";
 import {
   require_cjs
 } from "./Accordion-xgpzh4wq.js";