Export the option and return types

`src/index.tsx` re-exported only `NProgress` and `useNProgress`, so the
option shape and the hook's return shape reached the emitted declarations
as local interfaces with no exported names. Anyone typing a wrapper around
either entry point had to reach for `Parameters<typeof useNProgress>[0]`
and `ReturnType<typeof useNProgress>`.

`Options` is renamed to `NProgressOptions`, since `Options` is too generic
an identifier to put in a consumer's import namespace. The return shape,
previously an inline object type on `useNProgress` and spelled
`ReturnType<typeof useNProgress>` in the render-prop signature, is now
`NProgressState`. No MIGRATION.md entry: neither name was reachable from
the package entry point before this commit.

Both are type-only exports, so the runtime bundles are byte-identical:
ESM 997 B, CJS 1.06 kB gzipped, unchanged.

`test/bundles.spec.ts` already asserts facts about what the build emits,
so the public export surface is checked there, over the declaration files
it finds in `dist` rather than a hard-coded list.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

Author: tanem

README.md

@@ -72,7 +72,11 @@ const Progress = ({ isAnimating }) => (
 
 ## API
 
-The package exports one hook and one component. Both take the same [options](#options) and produce the same [values](#return-value), so the choice between them is a matter of which pattern suits the calling code.
+The package exports one hook and one component. Both take the same [options](#options) and produce the same [values](#return-value), so the choice between them is a matter of which pattern suits the calling code. Both shapes are exported as types, for typing code that wraps either entry point:
+
+```ts
+import type { NProgressOptions, NProgressState } from '@tanem/react-nprogress'
+```
 
 ### `useNProgress`
 
@@ -106,7 +110,7 @@ Takes the options as props and calls `children` with the values the hook returns
 
 ### Options
 
-All four options are optional.
+All four options are optional. The type is `NProgressOptions`.
 
 | Option                                    | Type      | Default |
 | ----------------------------------------- | --------- | ------- |
@@ -133,7 +137,7 @@ Lower bound for `progress`, between `0` and `1`. The first increment starts from
 
 ### Return Value
 
-`useNProgress` returns these values, and `NProgress` passes the same object to `children`.
+`useNProgress` returns these values, and `NProgress` passes the same object to `children`. The type is `NProgressState`.
 
 | Value               | Type      | Description                                                                                                                                                   |
 | ------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |

src/NProgress.tsx

@@ -1,10 +1,10 @@
 import type { FC, ReactElement } from 'react'
 
-import type { Options } from './types'
+import type { NProgressOptions, NProgressState } from './types'
 import { useNProgress } from './useNProgress'
 
-type Props = Options & {
-  children: (renderProps: ReturnType<typeof useNProgress>) => ReactElement
+type Props = NProgressOptions & {
+  children: (renderProps: NProgressState) => ReactElement
 }
 
 export const NProgress: FC<Props> = ({ children, ...restProps }: Props) => {

src/index.tsx

@@ -1,2 +1,3 @@
 export * from './NProgress'
+export type { NProgressOptions, NProgressState } from './types'
 export * from './useNProgress'

src/types.ts

@@ -1,6 +1,12 @@
-export interface Options {
+export interface NProgressOptions {
   animationDuration?: number
   incrementDuration?: number
   isAnimating?: boolean
   minimum?: number
 }
+
+export interface NProgressState {
+  animationDuration: number
+  isFinished: boolean
+  progress: number
+}

src/useNProgress.tsx

@@ -3,7 +3,7 @@ import { useEffect, useReducer } from 'react'
 import { clamp } from './clamp'
 import { createTimeout } from './createTimeout'
 import { increment } from './increment'
-import type { Options } from './types'
+import type { NProgressOptions, NProgressState } from './types'
 
 // A four-phase state machine. `idle` and `finished` both report
 // `isFinished: true` and differ only in the progress they hold, so the phase,
@@ -67,11 +67,7 @@ export const useNProgress = ({
   incrementDuration = 200,
   isAnimating = false,
   minimum = 0.08,
-}: Options = {}): {
-  animationDuration: number
-  isFinished: boolean
-  progress: number
-} => {
+}: NProgressOptions = {}): NProgressState => {
   const [{ phase, progress }, dispatch] = useReducer(reducer, initialState)
 
   useEffect(() => {

test/bundles.spec.ts

@@ -16,6 +16,22 @@ const publishedModules = fs
   .readdirSync(distDir)
   .filter((file) => /\.[cm]?js$/.test(file))
 
+// Derived the same way, and for the same reason, as `publishedModules`.
+const declarationFiles = fs
+  .readdirSync(distDir)
+  .filter((file) => /\.d\.[cm]?ts$/.test(file))
+
+// Consumers writing a typed wrapper around the hook or the render-props
+// component need names for the option and return shapes, so both are part of
+// the public API rather than internal declarations the bundler happened to
+// inline.
+const publicNames = [
+  'NProgress',
+  'NProgressOptions',
+  'NProgressState',
+  'useNProgress',
+]
+
 describe('published modules', () => {
   it('should be present', () => {
     expect(publishedModules.length).toBeGreaterThan(0)
@@ -29,3 +45,18 @@ describe('published modules', () => {
     },
   )
 })
+
+describe('declaration files', () => {
+  it('should be present', () => {
+    expect(declarationFiles.length).toBeGreaterThan(0)
+  })
+
+  it.each(declarationFiles)('%s should export the public API', (file) => {
+    const contents = fs.readFileSync(path.join(distDir, file), 'utf8')
+    const exported = (contents.match(/export\s*\{[^}]*\}/g) ?? []).join(' ')
+
+    for (const name of publicNames) {
+      expect(exported).toMatch(new RegExp(`\\b${name}\\b`))
+    }
+  })
+})