@octane-xplat/pager 0.7.3 → 0.10.0

package/README.md

@@ -0,0 +1,66 @@
+# `@octane-xplat/pager`
+
+```sh
+pnpm add @octane-xplat/pager
+```
+
+Paged horizontal swipe container for Octane xplat apps — onboarding flows,
+media galleries. iOS/Android run `@nativescript-community/ui-pager`
+(ViewPager2 on Android, a paging `UICollectionView` on iOS); web is a
+scroll-snap scroller; a macOS entry exists.
+
+```tsx
+import { useState } from 'octane'
+import { Text } from '@octane-xplat/ui'
+import { Pager } from '@octane-xplat/pager'
+
+export function Onboarding() {
+	const [index, setIndex] = useState(0)
+	return (
+		<Pager
+			items={['Pack', 'Travel']}
+			page={index}
+			onPageChange={setIndex}
+			renderItem={(title) => <Text>{title}</Text>}
+			renderEmpty={() => <Text>No pages</Text>}
+		/>
+	)
+}
+```
+
+It follows the platform-list contract — `items` + `renderItem`, no
+children; each page is a full-host-size cell. `onPageChange` fires on
+settled user swipes; programmatic `page` writes don't echo back. No page
+indicator is built in — compose dots from `HStack` + `View` driven by the
+`page` state. `renderEmpty` covers the empty list.
+
+```tsx
+import { useState } from 'octane'
+import { HStack, Text } from '@octane-xplat/ui'
+import { Pager } from '@octane-xplat/pager'
+
+export function Pages() {
+	const titles = ['Pack', 'Travel']
+	const [page, setPage] = useState(0)
+	return (
+		<>
+			<Pager
+				items={titles}
+				page={page}
+				onPageChange={setPage}
+				renderItem={(title) => <Text>{title}</Text>}
+				renderEmpty={() => <Text>No pages</Text>}
+			/>
+			<HStack>
+				{titles.map((title, index) => (
+					<Text>{index === page ? '●' : '○'}</Text>
+				))}
+			</HStack>
+		</>
+	)
+}
+```
+
+Per-target limits are recorded in
+[known limits](../../docs/verify/known-limits.md). Exercised by
+[`PagerDemo`](../demos/src/PagerDemo.tsrx).

package/dist/native/octane-client-build.json

@@ -1,6 +1,6 @@
 {
   "version": 1,
-  "buildId": "6b9a76b1-4ded-4f60-8f8a-fce96f82937f",
+  "buildId": "9f446e1c-3225-457c-86e9-93e6787095d1",
   "mode": "production",
   "capabilities": {
     "independentHydration": false

package/dist/web/octane-client-build.json

@@ -1,6 +1,6 @@
 {
   "version": 1,
-  "buildId": "ad6030a6-656e-4fdd-8bbb-0e92adec2131",
+  "buildId": "a8657bcf-481b-4f75-aa96-115434033e64",
   "mode": "production",
   "capabilities": {
     "independentHydration": false

package/package.json

@@ -1,26 +1,26 @@
 {
   "name": "@octane-xplat/pager",
-  "version": "0.7.3",
+  "version": "0.10.0",
   "description": "Paged swipe container for Octane xplat — web scroll-snap row + @nativescript-community/ui-pager (ViewPager2 / paging UICollectionView)",
   "keywords": [
-    "octane",
-    "xplat",
+    "android",
+    "carousel",
     "cross-platform",
+    "ios",
+    "nativescript",
+    "octane",
     "pager",
-    "carousel",
+    "paging",
     "swipe",
     "viewpager",
-    "paging",
-    "nativescript",
-    "ios",
-    "android",
-    "web"
+    "web",
+    "xplat"
   ],
-  "license": "MIT",
   "homepage": "https://github.com/octane-xplat/octane-xplat/tree/main/packages/pager",
+  "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/octane-xplat/octane-xplat.git",
+    "url": "https://github.com/octane-xplat/octane-xplat",
     "directory": "packages/pager"
   },
   "files": [
@@ -48,10 +48,11 @@
     "@nativescript-community/ui-pager": "14.1.42"
   },
   "devDependencies": {
-    "@nativescript-community/octane": "0.2.1",
+    "@nativescript-community/octane": "0.2.4",
     "@nativescript/core": "9.1.2",
     "@octanejs/vite-plugin": "0.1.61",
     "octane": "0.6.3",
+    "tsrx-typegen": "0.2.2",
     "typescript": "5.9.3",
     "vite": "8.3.0"
   },
@@ -69,6 +70,9 @@
     }
   },
   "scripts": {
-    "build": "vite build && vite build --mode native && tsc -p tsconfig.types.json && node ../../scripts/check-native-dist.mjs"
+    "build": "vite build && vite build --mode native && pnpm typegen && node ../../scripts/check-native-dist.mjs",
+    "typegen": "tsc -p tsconfig.types.json",
+    "test:packed": "node tests/packed-consumer.mjs",
+    "pack:check": "tsrx-typegen --pack-check"
   }
 }

package/src/Pager.macos.tsrx

@@ -1,4 +1,4 @@
-/** @jsxImportSource @xplat/macos/renderer */
+/** @jsxImportSource @octane-xplat/macos-renderer */
 import type { PagerProps } from './props'
 
 /** Explicit placeholder until the AppKit host has a paging surface. */

package/types/index.d.ts

@@ -1,5 +1,5 @@
 import type { UniversalComponent } from 'octane/universal'
-import type { PagerProps } from './props'
+import type { PagerProps } from './props.js'
 
 export declare const Pager: UniversalComponent<PagerProps>
-export type { PagerProps } from './props'
+export type { PagerProps } from './props.js'

package/types/index.macos.d.ts

@@ -1,4 +1,4 @@
-import type { PagerProps } from './props'
+import type { PagerProps } from './props.js'
 
-export type { PagerProps } from './props'
+export type { PagerProps } from './props.js'
 export declare function Pager(props: PagerProps): unknown