docs(types): add JSDoc for public utility types

Author: unadlib

src/loader.ts

@@ -23,10 +23,30 @@ const COMPONENT_LOAD_RETRY_MAX_DELAY_MS = 5_000
 const COMPONENT_LOAD_RETRY_MAX_FAILURES = 5
 
 export interface ReactIslandsLoaderOptions {
+  /**
+   * Document to scan and observe.
+   * @default global document
+   */
   document?: Document
+  /**
+   * CSS selector used to find island hosts.
+   * @default '[data-fict-react]'
+   */
   selector?: string
+  /**
+   * Enable MutationObserver to auto-mount/dispose and refresh.
+   * @default true
+   */
   observe?: boolean
+  /**
+   * Fallback client directive when host attribute is missing or invalid.
+   * @default 'load'
+   */
   defaultClient?: ClientDirective
+  /**
+   * Root margin used by visible strategy observers.
+   * @default '200px'
+   */
   visibleRootMargin?: string
 }
 

src/types.ts

@@ -1,6 +1,9 @@
 import type { BaseProps } from '@fictjs/runtime'
 import type { ComponentType } from 'react'
 
+/**
+ * Controls when the React island mounts on the client.
+ */
 export type ClientDirective = 'load' | 'idle' | 'visible' | 'only'
 
 export interface ReactInteropOptions {
@@ -30,8 +33,14 @@ export interface ReactInteropOptions {
   actionProps?: string[]
 }
 
+/**
+ * Static value or lazy accessor used by Fict props.
+ */
 export type MaybeAccessor<T> = T | (() => T)
 
+/**
+ * Serializable marker payload used to represent a React action callback.
+ */
 export interface ReactActionRef {
   __fictReactActionMarker: 'fict.react.action.v1'
   __fictReactActionQrl: string