@s-hirano-ist/s-ui 1.2.0 → 1.3.0

package/dist/forms/fields/form-textarea.js

@@ -2,6 +2,28 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Label } from "../../ui/label";
 import { Textarea } from "../../ui/textarea";
 import { useFormValues } from "../generic-form-wrapper";
+/**
+ * A labeled multi-line text input component for forms.
+ *
+ * @remarks
+ * Integrates with GenericFormWrapper for form state preservation.
+ * Automatically restores value on form errors.
+ *
+ * @param props - Textarea props including label and standard textarea attributes
+ * @returns A labeled textarea field
+ *
+ * @example
+ * ```tsx
+ * <FormTextarea
+ *   label="Description"
+ *   htmlFor="description"
+ *   name="description"
+ *   rows={5}
+ * />
+ * ```
+ *
+ * @see {@link GenericFormWrapper} for form integration
+ */
 export function FormTextarea({ label, htmlFor, defaultValue, ...textareaProps }) {
     const formValues = useFormValues();
     const preservedValue = formValues[textareaProps.name || htmlFor];

package/dist/forms/fields/form-textarea.js.map

@@ -1 +1 @@
-{"version":3,"file":"form-textarea.js","sourceRoot":"","sources":["../../../forms/fields/form-textarea.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAOxD,MAAM,UAAU,YAAY,CAAC,EAC5B,KAAK,EACL,OAAO,EACP,YAAY,EACZ,GAAG,aAAa,EACT;IACP,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC;IACnC,MAAM,cAAc,GAAG,UAAU,CAAC,aAAa,CAAC,IAAI,IAAI,OAAO,CAAC,CAAC;IAEjE,OAAO,CACN,eAAK,SAAS,EAAC,WAAW,aACzB,KAAC,KAAK,IAAC,OAAO,EAAE,OAAO,YAAG,KAAK,GAAS,EACxC,KAAC,QAAQ,IACR,YAAY,EAAE,cAAc,IAAI,YAAY,EAC5C,EAAE,EAAE,OAAO,KACP,aAAa,GAChB,IACG,CACN,CAAC;AACH,CAAC"}
+{"version":3,"file":"form-textarea.js","sourceRoot":"","sources":["../../../forms/fields/form-textarea.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAcxD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,YAAY,CAAC,EAC5B,KAAK,EACL,OAAO,EACP,YAAY,EACZ,GAAG,aAAa,EACG;IACnB,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC;IACnC,MAAM,cAAc,GAAG,UAAU,CAAC,aAAa,CAAC,IAAI,IAAI,OAAO,CAAC,CAAC;IAEjE,OAAO,CACN,eAAK,SAAS,EAAC,WAAW,aACzB,KAAC,KAAK,IAAC,OAAO,EAAE,OAAO,YAAG,KAAK,GAAS,EACxC,KAAC,QAAQ,IACR,YAAY,EAAE,cAAc,IAAI,YAAY,EAC5C,EAAE,EAAE,OAAO,KACP,aAAa,GAChB,IACG,CACN,CAAC;AACH,CAAC"}

package/dist/forms/generic-form-wrapper.d.ts

@@ -1,18 +1,81 @@
 import { type ReactNode } from "react";
+/**
+ * Hook to access form values from the GenericFormWrapper context.
+ *
+ * @remarks
+ * Use this hook in form field components to access preserved form values
+ * when a form submission fails and values need to be restored.
+ *
+ * @returns Record of field names to their preserved values
+ *
+ * @example
+ * ```tsx
+ * function MyFormField({ name }) {
+ *   const formValues = useFormValues();
+ *   const preservedValue = formValues[name];
+ *   return <input defaultValue={preservedValue} name={name} />;
+ * }
+ * ```
+ *
+ * @see {@link GenericFormWrapper} for the provider component
+ */
 export declare const useFormValues: () => Record<string, string>;
-type Props<T> = {
+/**
+ * Props for the GenericFormWrapper component.
+ *
+ * @typeParam T - The response type from the form action
+ *
+ * @see {@link GenericFormWrapper} for the component
+ */
+export type GenericFormWrapperProps<T> = {
+    /** Server action to handle form submission */
     action: (formData: FormData) => Promise<T>;
+    /** Form field components */
     children: ReactNode;
+    /** Label for the save button (fallback) */
     saveLabel: string;
+    /** Label for the submit button */
     submitLabel?: string;
+    /** Label shown during loading state */
     loadingLabel?: string;
+    /** Optional custom submit handler */
     onSubmit?: (formData: FormData) => Promise<void>;
+    /** Pre-filled form values */
     preservedValues?: Record<string, string>;
+    /** Callback after form submission with response message */
     afterSubmit: (responseMessage: string) => void;
 };
+/**
+ * A generic form wrapper with server action integration.
+ *
+ * @remarks
+ * Provides a consistent form experience with:
+ * - Server action integration via useActionState
+ * - Loading state with spinner
+ * - Form value preservation on error
+ * - Context-based form state sharing
+ *
+ * @typeParam T - Response type with `message` and `success` properties
+ * @param props - Form wrapper configuration
+ * @returns A form with submit handling and loading states
+ *
+ * @example
+ * ```tsx
+ * <GenericFormWrapper
+ *   action={createArticle}
+ *   saveLabel="Save"
+ *   submitLabel="Create Article"
+ *   afterSubmit={(msg) => toast(msg)}
+ * >
+ *   <FormInput label="Title" htmlFor="title" name="title" />
+ *   <FormTextarea label="Content" htmlFor="content" name="content" />
+ * </GenericFormWrapper>
+ * ```
+ *
+ * @see {@link useFormValues} for accessing form state in child components
+ */
 export declare function GenericFormWrapper<T extends {
     message: string;
     success: boolean;
-}>({ action, children, saveLabel, submitLabel, loadingLabel, onSubmit, preservedValues, afterSubmit, }: Props<T>): import("react/jsx-runtime").JSX.Element;
-export {};
+}>({ action, children, saveLabel, submitLabel, loadingLabel, onSubmit, preservedValues, afterSubmit, }: GenericFormWrapperProps<T>): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=generic-form-wrapper.d.ts.map

package/dist/forms/generic-form-wrapper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generic-form-wrapper.d.ts","sourceRoot":"","sources":["../../forms/generic-form-wrapper.tsx"],"names":[],"mappings":"AACA,OAAO,EAEN,KAAK,SAAS,EAKd,MAAM,OAAO,CAAC;AAMf,eAAO,MAAM,aAAa,8BAAsC,CAAC;AAEjE,KAAK,KAAK,CAAC,CAAC,IAAI;IACf,MAAM,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IAC3C,QAAQ,EAAE,SAAS,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,WAAW,EAAE,CAAC,eAAe,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/C,CAAC;AAEF,wBAAgB,kBAAkB,CACjC,CAAC,SAAS;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,EAC9C,EACD,MAAM,EACN,QAAQ,EACR,SAAS,EACT,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,eAAe,EACf,WAAW,GACX,EAAE,KAAK,CAAC,CAAC,CAAC,2CAkDV"}
+{"version":3,"file":"generic-form-wrapper.d.ts","sourceRoot":"","sources":["../../forms/generic-form-wrapper.tsx"],"names":[],"mappings":"AACA,OAAO,EAEN,KAAK,SAAS,EAKd,MAAM,OAAO,CAAC;AAUf;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,aAAa,8BAAsC,CAAC;AAEjE;;;;;;GAMG;AACH,MAAM,MAAM,uBAAuB,CAAC,CAAC,IAAI;IACxC,8CAA8C;IAC9C,MAAM,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IAC3C,4BAA4B;IAC5B,QAAQ,EAAE,SAAS,CAAC;IACpB,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,6BAA6B;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,2DAA2D;IAC3D,WAAW,EAAE,CAAC,eAAe,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/C,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,kBAAkB,CACjC,CAAC,SAAS;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,EAC9C,EACD,MAAM,EACN,QAAQ,EACR,SAAS,EACT,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,eAAe,EACf,WAAW,GACX,EAAE,uBAAuB,CAAC,CAAC,CAAC,2CAkD5B"}

package/dist/forms/generic-form-wrapper.js

@@ -3,8 +3,61 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { createContext, useActionState, useContext, useEffect, useState, } from "react";
 import Loading from "../display/loading";
 import { Button } from "../ui/button";
+/**
+ * Context for sharing form values across form fields.
+ * @internal
+ */
 const FormValuesContext = createContext({});
+/**
+ * Hook to access form values from the GenericFormWrapper context.
+ *
+ * @remarks
+ * Use this hook in form field components to access preserved form values
+ * when a form submission fails and values need to be restored.
+ *
+ * @returns Record of field names to their preserved values
+ *
+ * @example
+ * ```tsx
+ * function MyFormField({ name }) {
+ *   const formValues = useFormValues();
+ *   const preservedValue = formValues[name];
+ *   return <input defaultValue={preservedValue} name={name} />;
+ * }
+ * ```
+ *
+ * @see {@link GenericFormWrapper} for the provider component
+ */
 export const useFormValues = () => useContext(FormValuesContext);
+/**
+ * A generic form wrapper with server action integration.
+ *
+ * @remarks
+ * Provides a consistent form experience with:
+ * - Server action integration via useActionState
+ * - Loading state with spinner
+ * - Form value preservation on error
+ * - Context-based form state sharing
+ *
+ * @typeParam T - Response type with `message` and `success` properties
+ * @param props - Form wrapper configuration
+ * @returns A form with submit handling and loading states
+ *
+ * @example
+ * ```tsx
+ * <GenericFormWrapper
+ *   action={createArticle}
+ *   saveLabel="Save"
+ *   submitLabel="Create Article"
+ *   afterSubmit={(msg) => toast(msg)}
+ * >
+ *   <FormInput label="Title" htmlFor="title" name="title" />
+ *   <FormTextarea label="Content" htmlFor="content" name="content" />
+ * </GenericFormWrapper>
+ * ```
+ *
+ * @see {@link useFormValues} for accessing form state in child components
+ */
 export function GenericFormWrapper({ action, children, saveLabel, submitLabel, loadingLabel, onSubmit, preservedValues, afterSubmit, }) {
     const [formValues, setFormValues] = useState(preservedValues || {});
     useEffect(() => {

package/dist/forms/generic-form-wrapper.js.map

@@ -1 +1 @@
-{"version":3,"file":"generic-form-wrapper.js","sourceRoot":"","sources":["../../forms/generic-form-wrapper.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AACb,OAAO,EACN,aAAa,EAEb,cAAc,EACd,UAAU,EACV,SAAS,EACT,QAAQ,GACR,MAAM,OAAO,CAAC;AACf,OAAO,OAAO,MAAM,oBAAoB,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,MAAM,iBAAiB,GAAG,aAAa,CAAyB,EAAE,CAAC,CAAC;AAEpE,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;AAajE,MAAM,UAAU,kBAAkB,CAEhC,EACD,MAAM,EACN,QAAQ,EACR,SAAS,EACT,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,eAAe,EACf,WAAW,GACD;IACV,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAC3C,eAAe,IAAI,EAAE,CACrB,CAAC;IAEF,SAAS,CAAC,GAAG,EAAE;QACd,IAAI,eAAe,EAAE,CAAC;YACrB,aAAa,CAAC,eAAe,CAAC,CAAC;QAChC,CAAC;IACF,CAAC,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC;IAEtB,MAAM,UAAU,GAAG,KAAK,EACvB,cAAwB,EACxB,QAAkB,EACE,EAAE;QACtB,IAAI,QAAQ,EAAE,CAAC;YACd,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACzB,OAAO,IAAI,CAAC;QACb,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;QACxC,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAE9B,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;YACtB,wBAAwB;YACxB,aAAa,CAAC,EAAE,CAAC,CAAC;YAClB,OAAO,QAAQ,CAAC;QACjB,CAAC;QACD,8BAA8B;QAC9B,IAAI,UAAU,IAAI,QAAQ,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;YACjD,aAAa,CAAC,QAAQ,CAAC,QAAkC,CAAC,CAAC;QAC5D,CAAC;QACD,OAAO,QAAQ,CAAC;IACjB,CAAC,CAAC;IAEF,MAAM,CAAC,CAAC,EAAE,YAAY,EAAE,SAAS,CAAC,GAAG,cAAc,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IAEtE,OAAO,CACN,KAAC,iBAAiB,CAAC,QAAQ,IAAC,KAAK,EAAE,UAAU,YAC5C,gBAAM,MAAM,EAAE,YAAY,EAAE,SAAS,EAAC,qBAAqB,aACzD,SAAS,CAAC,CAAC,CAAC,KAAC,OAAO,KAAG,CAAC,CAAC,CAAC,QAAQ,EACnC,KAAC,MAAM,IAAC,SAAS,EAAC,QAAQ,EAAC,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAC,QAAQ,YAC3D,SAAS,IAAI,YAAY;wBACzB,CAAC,CAAC,YAAY;wBACd,CAAC,CAAC,WAAW;4BACZ,CAAC,CAAC,WAAW;4BACb,CAAC,CAAC,SAAS,GACL,IACH,GACqB,CAC7B,CAAC;AACH,CAAC"}
+{"version":3,"file":"generic-form-wrapper.js","sourceRoot":"","sources":["../../forms/generic-form-wrapper.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AACb,OAAO,EACN,aAAa,EAEb,cAAc,EACd,UAAU,EACV,SAAS,EACT,QAAQ,GACR,MAAM,OAAO,CAAC;AACf,OAAO,OAAO,MAAM,oBAAoB,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC;;;GAGG;AACH,MAAM,iBAAiB,GAAG,aAAa,CAAyB,EAAE,CAAC,CAAC;AAEpE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;AA4BjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,kBAAkB,CAEhC,EACD,MAAM,EACN,QAAQ,EACR,SAAS,EACT,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,eAAe,EACf,WAAW,GACiB;IAC5B,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAC3C,eAAe,IAAI,EAAE,CACrB,CAAC;IAEF,SAAS,CAAC,GAAG,EAAE;QACd,IAAI,eAAe,EAAE,CAAC;YACrB,aAAa,CAAC,eAAe,CAAC,CAAC;QAChC,CAAC;IACF,CAAC,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC;IAEtB,MAAM,UAAU,GAAG,KAAK,EACvB,cAAwB,EACxB,QAAkB,EACE,EAAE;QACtB,IAAI,QAAQ,EAAE,CAAC;YACd,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACzB,OAAO,IAAI,CAAC;QACb,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;QACxC,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAE9B,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;YACtB,wBAAwB;YACxB,aAAa,CAAC,EAAE,CAAC,CAAC;YAClB,OAAO,QAAQ,CAAC;QACjB,CAAC;QACD,8BAA8B;QAC9B,IAAI,UAAU,IAAI,QAAQ,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;YACjD,aAAa,CAAC,QAAQ,CAAC,QAAkC,CAAC,CAAC;QAC5D,CAAC;QACD,OAAO,QAAQ,CAAC;IACjB,CAAC,CAAC;IAEF,MAAM,CAAC,CAAC,EAAE,YAAY,EAAE,SAAS,CAAC,GAAG,cAAc,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IAEtE,OAAO,CACN,KAAC,iBAAiB,CAAC,QAAQ,IAAC,KAAK,EAAE,UAAU,YAC5C,gBAAM,MAAM,EAAE,YAAY,EAAE,SAAS,EAAC,qBAAqB,aACzD,SAAS,CAAC,CAAC,CAAC,KAAC,OAAO,KAAG,CAAC,CAAC,CAAC,QAAQ,EACnC,KAAC,MAAM,IAAC,SAAS,EAAC,QAAQ,EAAC,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAC,QAAQ,YAC3D,SAAS,IAAI,YAAY;wBACzB,CAAC,CAAC,YAAY;wBACd,CAAC,CAAC,WAAW;4BACZ,CAAC,CAAC,WAAW;4BACb,CAAC,CAAC,SAAS,GACL,IACH,GACqB,CAC7B,CAAC;AACH,CAAC"}

package/dist/hooks/use-infinite-scroll.d.ts

@@ -1,13 +1,68 @@
-type UseInfiniteScrollOptions = {
+/**
+ * Options for the useInfiniteScroll hook.
+ *
+ * @see {@link useInfiniteScroll} for the hook
+ */
+export type UseInfiniteScrollOptions = {
+    /** Whether there are more pages to load */
     hasNextPage: boolean;
+    /** Whether a page is currently being fetched */
     isFetchingNextPage: boolean;
+    /** Function to fetch the next page */
     fetchNextPage: () => Promise<void>;
+    /** Margin around the root for intersection detection */
     rootMargin?: string;
+    /** Visibility threshold for triggering intersection */
     threshold?: number;
 };
-type UseInfiniteScrollReturn = {
+/**
+ * Return value from the useInfiniteScroll hook.
+ *
+ * @see {@link useInfiniteScroll} for the hook
+ */
+export type UseInfiniteScrollReturn = {
+    /** Ref callback to attach to the last element */
     lastElementRef: (node: HTMLElement | null) => void;
 };
+/**
+ * Hook for implementing infinite scroll with Intersection Observer.
+ *
+ * @remarks
+ * Automatically loads more content when the last element becomes visible.
+ * Uses IntersectionObserver for efficient scroll detection.
+ *
+ * Features:
+ * - Automatic fetch when last element is visible
+ * - Prevents duplicate fetches during loading
+ * - SSR-safe with delayed initialization
+ * - Configurable root margin and threshold
+ *
+ * @param options - Configuration for pagination and intersection
+ * @returns Object containing ref callback for the last element
+ *
+ * @example
+ * ```tsx
+ * function ItemList({ items, hasMore, fetchMore }) {
+ *   const { lastElementRef } = useInfiniteScroll({
+ *     hasNextPage: hasMore,
+ *     isFetchingNextPage: false,
+ *     fetchNextPage: fetchMore,
+ *   });
+ *
+ *   return (
+ *     <ul>
+ *       {items.map((item, i) => (
+ *         <li
+ *           key={item.id}
+ *           ref={i === items.length - 1 ? lastElementRef : null}
+ *         >
+ *           {item.name}
+ *         </li>
+ *       ))}
+ *     </ul>
+ *   );
+ * }
+ * ```
+ */
 export declare function useInfiniteScroll({ hasNextPage, isFetchingNextPage, fetchNextPage, rootMargin, threshold, }: UseInfiniteScrollOptions): UseInfiniteScrollReturn;
-export {};
 //# sourceMappingURL=use-infinite-scroll.d.ts.map

package/dist/hooks/use-infinite-scroll.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-infinite-scroll.d.ts","sourceRoot":"","sources":["../../hooks/use-infinite-scroll.ts"],"names":[],"mappings":"AAIA,KAAK,wBAAwB,GAAG;IAC/B,WAAW,EAAE,OAAO,CAAC;IACrB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,KAAK,uBAAuB,GAAG;IAC9B,cAAc,EAAE,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAC;CACnD,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,EACjC,WAAW,EACX,kBAAkB,EAClB,aAAa,EACb,UAAoB,EACpB,SAAe,GACf,EAAE,wBAAwB,GAAG,uBAAuB,CAuCpD"}
+{"version":3,"file":"use-infinite-scroll.d.ts","sourceRoot":"","sources":["../../hooks/use-infinite-scroll.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACtC,2CAA2C;IAC3C,WAAW,EAAE,OAAO,CAAC;IACrB,gDAAgD;IAChD,kBAAkB,EAAE,OAAO,CAAC;IAC5B,sCAAsC;IACtC,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACrC,iDAAiD;IACjD,cAAc,EAAE,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAC;CACnD,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,iBAAiB,CAAC,EACjC,WAAW,EACX,kBAAkB,EAClB,aAAa,EACb,UAAoB,EACpB,SAAe,GACf,EAAE,wBAAwB,GAAG,uBAAuB,CAuCpD"}

package/dist/hooks/use-infinite-scroll.js

@@ -1,5 +1,45 @@
 "use client";
 import { useCallback, useEffect, useRef, useState } from "react";
+/**
+ * Hook for implementing infinite scroll with Intersection Observer.
+ *
+ * @remarks
+ * Automatically loads more content when the last element becomes visible.
+ * Uses IntersectionObserver for efficient scroll detection.
+ *
+ * Features:
+ * - Automatic fetch when last element is visible
+ * - Prevents duplicate fetches during loading
+ * - SSR-safe with delayed initialization
+ * - Configurable root margin and threshold
+ *
+ * @param options - Configuration for pagination and intersection
+ * @returns Object containing ref callback for the last element
+ *
+ * @example
+ * ```tsx
+ * function ItemList({ items, hasMore, fetchMore }) {
+ *   const { lastElementRef } = useInfiniteScroll({
+ *     hasNextPage: hasMore,
+ *     isFetchingNextPage: false,
+ *     fetchNextPage: fetchMore,
+ *   });
+ *
+ *   return (
+ *     <ul>
+ *       {items.map((item, i) => (
+ *         <li
+ *           key={item.id}
+ *           ref={i === items.length - 1 ? lastElementRef : null}
+ *         >
+ *           {item.name}
+ *         </li>
+ *       ))}
+ *     </ul>
+ *   );
+ * }
+ * ```
+ */
 export function useInfiniteScroll({ hasNextPage, isFetchingNextPage, fetchNextPage, rootMargin = "100px", threshold = 0.1, }) {
     const observer = useRef(null);
     const [isInitialized, setIsInitialized] = useState(false);

package/dist/hooks/use-infinite-scroll.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-infinite-scroll.js","sourceRoot":"","sources":["../../hooks/use-infinite-scroll.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAcjE,MAAM,UAAU,iBAAiB,CAAC,EACjC,WAAW,EACX,kBAAkB,EAClB,aAAa,EACb,UAAU,GAAG,OAAO,EACpB,SAAS,GAAG,GAAG,GACW;IAC1B,MAAM,QAAQ,GAAG,MAAM,CAA8B,IAAI,CAAC,CAAC;IAC3D,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAE1D,MAAM,cAAc,GAAG,WAAW,CACjC,CAAC,IAAwB,EAAE,EAAE;QAC5B,IAAI,kBAAkB;YAAE,OAAO;QAC/B,IAAI,QAAQ,CAAC,OAAO;YAAE,QAAQ,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;QAEpD,QAAQ,CAAC,OAAO,GAAG,IAAI,oBAAoB,CAC1C,CAAC,OAAO,EAAE,EAAE;YACX,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,cAAc,IAAI,WAAW,IAAI,aAAa,EAAE,CAAC;gBAChE,aAAa,EAAE,CAAC;YACjB,CAAC;QACF,CAAC,EACD;YACC,UAAU;YACV,SAAS;SACT,CACD,CAAC;QAEF,IAAI,IAAI;YAAE,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC,EACD;QACC,kBAAkB;QAClB,WAAW;QACX,aAAa;QACb,UAAU;QACV,SAAS;QACT,aAAa;KACb,CACD,CAAC;IAEF,oDAAoD;IACpD,SAAS,CAAC,GAAG,EAAE;QACd,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,EAAE,cAAc,EAAE,CAAC;AAC3B,CAAC"}
+{"version":3,"file":"use-infinite-scroll.js","sourceRoot":"","sources":["../../hooks/use-infinite-scroll.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AA8BjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,UAAU,iBAAiB,CAAC,EACjC,WAAW,EACX,kBAAkB,EAClB,aAAa,EACb,UAAU,GAAG,OAAO,EACpB,SAAS,GAAG,GAAG,GACW;IAC1B,MAAM,QAAQ,GAAG,MAAM,CAA8B,IAAI,CAAC,CAAC;IAC3D,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAE1D,MAAM,cAAc,GAAG,WAAW,CACjC,CAAC,IAAwB,EAAE,EAAE;QAC5B,IAAI,kBAAkB;YAAE,OAAO;QAC/B,IAAI,QAAQ,CAAC,OAAO;YAAE,QAAQ,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;QAEpD,QAAQ,CAAC,OAAO,GAAG,IAAI,oBAAoB,CAC1C,CAAC,OAAO,EAAE,EAAE;YACX,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,cAAc,IAAI,WAAW,IAAI,aAAa,EAAE,CAAC;gBAChE,aAAa,EAAE,CAAC;YACjB,CAAC;QACF,CAAC,EACD;YACC,UAAU;YACV,SAAS;SACT,CACD,CAAC;QAEF,IAAI,IAAI;YAAE,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC,EACD;QACC,kBAAkB;QAClB,WAAW;QACX,aAAa;QACb,UAAU;QACV,SAAS;QACT,aAAa;KACb,CACD,CAAC;IAEF,oDAAoD;IACpD,SAAS,CAAC,GAAG,EAAE;QACd,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,EAAE,cAAc,EAAE,CAAC;AAC3B,CAAC"}

package/dist/index.d.ts

@@ -1,3 +1,39 @@
+/**
+ * @packageDocumentation
+ *
+ * UI component library for the content management system.
+ *
+ * @remarks
+ * This package provides reusable React components built with:
+ * - Radix UI primitives for accessibility
+ * - Tailwind CSS for styling
+ * - class-variance-authority for variant management
+ *
+ * ## Component Categories
+ *
+ * - **UI Components** - Base components (Button, Card, Input, Dialog, etc.)
+ * - **Form Components** - Form wrappers and field components
+ * - **Display Components** - Loading states and status displays
+ * - **Layout Components** - Markdown viewer and content layouts
+ * - **Hooks** - Custom React hooks (useInfiniteScroll)
+ * - **Providers** - Theme provider for dark/light mode
+ * - **Utilities** - cn() class merging utility
+ *
+ * @example
+ * ```tsx
+ * import { Button, Card, Input, Toaster } from "@s-hirano-ist/s-ui";
+ *
+ * function MyComponent() {
+ *   return (
+ *     <Card>
+ *       <Input placeholder="Enter text..." />
+ *       <Button>Submit</Button>
+ *       <Toaster />
+ *     </Card>
+ *   );
+ * }
+ * ```
+ */
 export * from "./display/loading";
 export * from "./display/status/status-code-view";
 export * from "./forms/fields/form-dropdown-input";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAGA,cAAc,mBAAmB,CAAC;AAClC,cAAc,mCAAmC,CAAC;AAClD,cAAc,oCAAoC,CAAC;AACnD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uCAAuC,CAAC;AACtD,cAAc,8BAA8B,CAAC;AAE7C,cAAc,8BAA8B,CAAC;AAE7C,cAAc,6BAA6B,CAAC;AAE5C,cAAc,4BAA4B,CAAC;AAE3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAG9B,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAKH,cAAc,mBAAmB,CAAC;AAClC,cAAc,mCAAmC,CAAC;AAClD,cAAc,oCAAoC,CAAC;AACnD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uCAAuC,CAAC;AACtD,cAAc,8BAA8B,CAAC;AAE7C,cAAc,8BAA8B,CAAC;AAE7C,cAAc,6BAA6B,CAAC;AAE5C,cAAc,4BAA4B,CAAC;AAE3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAG9B,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -1,3 +1,39 @@
+/**
+ * @packageDocumentation
+ *
+ * UI component library for the content management system.
+ *
+ * @remarks
+ * This package provides reusable React components built with:
+ * - Radix UI primitives for accessibility
+ * - Tailwind CSS for styling
+ * - class-variance-authority for variant management
+ *
+ * ## Component Categories
+ *
+ * - **UI Components** - Base components (Button, Card, Input, Dialog, etc.)
+ * - **Form Components** - Form wrappers and field components
+ * - **Display Components** - Loading states and status displays
+ * - **Layout Components** - Markdown viewer and content layouts
+ * - **Hooks** - Custom React hooks (useInfiniteScroll)
+ * - **Providers** - Theme provider for dark/light mode
+ * - **Utilities** - cn() class merging utility
+ *
+ * @example
+ * ```tsx
+ * import { Button, Card, Input, Toaster } from "@s-hirano-ist/s-ui";
+ *
+ * function MyComponent() {
+ *   return (
+ *     <Card>
+ *       <Input placeholder="Enter text..." />
+ *       <Button>Submit</Button>
+ *       <Toaster />
+ *     </Card>
+ *   );
+ * }
+ * ```
+ */
 // UI Components
 // Display Components
 export * from "./display/loading";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,gBAAgB;AAEhB,qBAAqB;AACrB,cAAc,mBAAmB,CAAC;AAClC,cAAc,mCAAmC,CAAC;AAClD,cAAc,oCAAoC,CAAC;AACnD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uCAAuC,CAAC;AACtD,cAAc,8BAA8B,CAAC;AAC7C,kBAAkB;AAClB,cAAc,8BAA8B,CAAC;AAC7C,QAAQ;AACR,cAAc,6BAA6B,CAAC;AAC5C,oBAAoB;AACpB,cAAc,4BAA4B,CAAC;AAC3C,YAAY;AACZ,cAAc,4BAA4B,CAAC;AAC3C,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAE9B,YAAY;AACZ,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,gBAAgB;AAEhB,qBAAqB;AACrB,cAAc,mBAAmB,CAAC;AAClC,cAAc,mCAAmC,CAAC;AAClD,cAAc,oCAAoC,CAAC;AACnD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uCAAuC,CAAC;AACtD,cAAc,8BAA8B,CAAC;AAC7C,kBAAkB;AAClB,cAAc,8BAA8B,CAAC;AAC7C,QAAQ;AACR,cAAc,6BAA6B,CAAC;AAC5C,oBAAoB;AACpB,cAAc,4BAA4B,CAAC;AAC3C,YAAY;AACZ,cAAc,4BAA4B,CAAC;AAC3C,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAE9B,YAAY;AACZ,cAAc,YAAY,CAAC"}

package/dist/layouts/body/viewer-body.d.ts

@@ -1,9 +1,55 @@
 import type { ReactNode } from "react";
-type Props = {
+/**
+ * Props for the ViewerBodyClient component.
+ *
+ * @see {@link ViewerBodyClient} for the component
+ */
+export type ViewerBodyProps = {
+    /** Optional children to render before the markdown content */
     children?: ReactNode;
+    /** Markdown content to render */
     markdown: string;
 };
+/**
+ * Converts markdown to React elements with syntax highlighting.
+ *
+ * @remarks
+ * Features:
+ * - GitHub Flavored Markdown (GFM) support
+ * - Syntax highlighting with VS Code Dark+ theme
+ * - Auto-generated heading IDs for anchor links
+ * - External link handling with nofollow/noreferrer
+ *
+ * @param markdown - The markdown string to convert
+ * @returns React elements representing the markdown
+ *
+ * @example
+ * ```tsx
+ * const content = await markdownToReact("# Hello\n\nWorld");
+ * ```
+ */
 export declare function markdownToReact(markdown: string): Promise<import("react/jsx-runtime").JSX.Element>;
-export declare function ViewerBodyClient({ children, markdown }: Props): Promise<import("react/jsx-runtime").JSX.Element>;
-export {};
+/**
+ * A markdown viewer component with prose styling.
+ *
+ * @remarks
+ * Server component that renders markdown content with:
+ * - Prose typography from Tailwind CSS
+ * - Dark mode support
+ * - Responsive container width
+ * - Optional children rendered before content
+ *
+ * @param props - Markdown content and optional children
+ * @returns A styled markdown viewer
+ *
+ * @example
+ * ```tsx
+ * <ViewerBodyClient markdown={noteContent}>
+ *   <h1>Note Title</h1>
+ * </ViewerBodyClient>
+ * ```
+ *
+ * @see {@link markdownToReact} for the markdown conversion function
+ */
+export declare function ViewerBodyClient({ children, markdown, }: ViewerBodyProps): Promise<import("react/jsx-runtime").JSX.Element>;
 //# sourceMappingURL=viewer-body.d.ts.map

package/dist/layouts/body/viewer-body.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"viewer-body.d.ts","sourceRoot":"","sources":["../../../layouts/body/viewer-body.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAOvC,KAAK,KAAK,GAAG;IAAE,QAAQ,CAAC,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAExD,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,oDAsDrD;AAED,wBAAsB,gBAAgB,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,KAAK,oDASnE"}
+{"version":3,"file":"viewer-body.d.ts","sourceRoot":"","sources":["../../../layouts/body/viewer-body.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAOvC;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG;IAC7B,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,oDAsDrD;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,gBAAgB,CAAC,EACtC,QAAQ,EACR,QAAQ,GACR,EAAE,eAAe,oDASjB"}

package/dist/layouts/body/viewer-body.js

@@ -3,6 +3,24 @@ import ReactMarkdown from "react-markdown";
 import { Prism as SyntaxHighlighter } from "react-syntax-highlighter";
 import { vscDarkPlus } from "react-syntax-highlighter/dist/esm/styles/prism";
 import remarkGfm from "remark-gfm";
+/**
+ * Converts markdown to React elements with syntax highlighting.
+ *
+ * @remarks
+ * Features:
+ * - GitHub Flavored Markdown (GFM) support
+ * - Syntax highlighting with VS Code Dark+ theme
+ * - Auto-generated heading IDs for anchor links
+ * - External link handling with nofollow/noreferrer
+ *
+ * @param markdown - The markdown string to convert
+ * @returns React elements representing the markdown
+ *
+ * @example
+ * ```tsx
+ * const content = await markdownToReact("# Hello\n\nWorld");
+ * ```
+ */
 export async function markdownToReact(markdown) {
     const components = {
         code({ className, children }) {
@@ -38,7 +56,29 @@ export async function markdownToReact(markdown) {
     };
     return (_jsx(ReactMarkdown, { components: components, remarkPlugins: [remarkGfm], children: markdown }));
 }
-export async function ViewerBodyClient({ children, markdown }) {
+/**
+ * A markdown viewer component with prose styling.
+ *
+ * @remarks
+ * Server component that renders markdown content with:
+ * - Prose typography from Tailwind CSS
+ * - Dark mode support
+ * - Responsive container width
+ * - Optional children rendered before content
+ *
+ * @param props - Markdown content and optional children
+ * @returns A styled markdown viewer
+ *
+ * @example
+ * ```tsx
+ * <ViewerBodyClient markdown={noteContent}>
+ *   <h1>Note Title</h1>
+ * </ViewerBodyClient>
+ * ```
+ *
+ * @see {@link markdownToReact} for the markdown conversion function
+ */
+export async function ViewerBodyClient({ children, markdown, }) {
     const content = await markdownToReact(markdown);
     return (_jsxs("div", { className: "prose prose-sm dark:prose-invert mx-auto max-w-5xl space-y-8 px-4 py-2", children: [children, content] }));
 }

package/dist/layouts/body/viewer-body.js.map

@@ -1 +1 @@
-{"version":3,"file":"viewer-body.js","sourceRoot":"","sources":["../../../layouts/body/viewer-body.tsx"],"names":[],"mappings":";AAEA,OAAO,aAAa,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,KAAK,IAAI,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,gDAAgD,CAAC;AAC7E,OAAO,SAAS,MAAM,YAAY,CAAC;AAInC,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,QAAgB;IACrD,MAAM,UAAU,GAAe;QAC9B,IAAI,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE;YAC3B,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;YACrD,MAAM,QAAQ,GAAG,CAAC,KAAK,CAAC;YAExB,OAAO,QAAQ,CAAC,CAAC,CAAC,CACjB,eAAM,SAAS,EAAE,SAAS,YAAG,QAAQ,GAAQ,CAC7C,CAAC,CAAC,CAAC,CACH,KAAC,iBAAiB,IAAC,MAAM,EAAC,KAAK,EAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,YACpE,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,GACjB,CACpB,CAAC;QACH,CAAC;QACD,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE;YACnB,MAAM,UAAU,GAAG,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;YAC5C,OAAO,CACN,YACC,IAAI,EAAE,IAAI,EACV,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,SAAS,EACnD,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,YAExC,QAAQ,GACN,CACJ,CAAC;QACH,CAAC;QACD,EAAE,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE;YACpB,MAAM,EAAE,GAAG,QAAQ;gBAClB,EAAE,QAAQ,EAAE;iBACX,WAAW,EAAE;iBACb,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;YAC1B,OAAO,aAAI,EAAE,EAAE,EAAE,YAAG,QAAQ,GAAM,CAAC;QACpC,CAAC;QACD,EAAE,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE;YACpB,MAAM,EAAE,GAAG,QAAQ;gBAClB,EAAE,QAAQ,EAAE;iBACX,WAAW,EAAE;iBACb,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;YAC1B,OAAO,aAAI,EAAE,EAAE,EAAE,YAAG,QAAQ,GAAM,CAAC;QACpC,CAAC;QACD,EAAE,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE;YACpB,MAAM,EAAE,GAAG,QAAQ;gBAClB,EAAE,QAAQ,EAAE;iBACX,WAAW,EAAE;iBACb,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;YAC1B,OAAO,aAAI,EAAE,EAAE,EAAE,YAAG,QAAQ,GAAM,CAAC;QACpC,CAAC;KACD,CAAC;IAEF,OAAO,CACN,KAAC,aAAa,IAAC,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,CAAC,SAAS,CAAC,YAC/D,QAAQ,GACM,CAChB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAS;IACnE,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,QAAQ,CAAC,CAAC;IAEhD,OAAO,CACN,eAAK,SAAS,EAAC,wEAAwE,aACrF,QAAQ,EACR,OAAO,IACH,CACN,CAAC;AACH,CAAC"}
+{"version":3,"file":"viewer-body.js","sourceRoot":"","sources":["../../../layouts/body/viewer-body.tsx"],"names":[],"mappings":";AAEA,OAAO,aAAa,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,KAAK,IAAI,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,gDAAgD,CAAC;AAC7E,OAAO,SAAS,MAAM,YAAY,CAAC;AAcnC;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,QAAgB;IACrD,MAAM,UAAU,GAAe;QAC9B,IAAI,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE;YAC3B,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;YACrD,MAAM,QAAQ,GAAG,CAAC,KAAK,CAAC;YAExB,OAAO,QAAQ,CAAC,CAAC,CAAC,CACjB,eAAM,SAAS,EAAE,SAAS,YAAG,QAAQ,GAAQ,CAC7C,CAAC,CAAC,CAAC,CACH,KAAC,iBAAiB,IAAC,MAAM,EAAC,KAAK,EAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,YACpE,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,GACjB,CACpB,CAAC;QACH,CAAC;QACD,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE;YACnB,MAAM,UAAU,GAAG,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;YAC5C,OAAO,CACN,YACC,IAAI,EAAE,IAAI,EACV,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,SAAS,EACnD,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,YAExC,QAAQ,GACN,CACJ,CAAC;QACH,CAAC;QACD,EAAE,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE;YACpB,MAAM,EAAE,GAAG,QAAQ;gBAClB,EAAE,QAAQ,EAAE;iBACX,WAAW,EAAE;iBACb,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;YAC1B,OAAO,aAAI,EAAE,EAAE,EAAE,YAAG,QAAQ,GAAM,CAAC;QACpC,CAAC;QACD,EAAE,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE;YACpB,MAAM,EAAE,GAAG,QAAQ;gBAClB,EAAE,QAAQ,EAAE;iBACX,WAAW,EAAE;iBACb,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;YAC1B,OAAO,aAAI,EAAE,EAAE,EAAE,YAAG,QAAQ,GAAM,CAAC;QACpC,CAAC;QACD,EAAE,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE;YACpB,MAAM,EAAE,GAAG,QAAQ;gBAClB,EAAE,QAAQ,EAAE;iBACX,WAAW,EAAE;iBACb,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;YAC1B,OAAO,aAAI,EAAE,EAAE,EAAE,YAAG,QAAQ,GAAM,CAAC;QACpC,CAAC;KACD,CAAC;IAEF,OAAO,CACN,KAAC,aAAa,IAAC,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,CAAC,SAAS,CAAC,YAC/D,QAAQ,GACM,CAChB,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,EACtC,QAAQ,EACR,QAAQ,GACS;IACjB,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,QAAQ,CAAC,CAAC;IAEhD,OAAO,CACN,eAAK,SAAS,EAAC,wEAAwE,aACrF,QAAQ,EACR,OAAO,IACH,CACN,CAAC;AACH,CAAC"}

package/dist/providers/theme-provider.d.ts

@@ -1,4 +1,27 @@
 import { ThemeProvider as NextThemesProvider } from "next-themes";
 import type * as React from "react";
+/**
+ * Theme provider component for dark/light mode support.
+ *
+ * @remarks
+ * Wrapper around next-themes ThemeProvider.
+ * Enables theme switching and system theme detection.
+ *
+ * @param props - next-themes provider props
+ * @returns A theme context provider
+ *
+ * @example
+ * ```tsx
+ * // In your root layout
+ * <ThemeProvider
+ *   attribute="class"
+ *   defaultTheme="system"
+ *   enableSystem
+ *   disableTransitionOnChange
+ * >
+ *   {children}
+ * </ThemeProvider>
+ * ```
+ */
 export declare function ThemeProvider({ children, ...props }: React.ComponentProps<typeof NextThemesProvider>): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=theme-provider.d.ts.map

package/dist/providers/theme-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"theme-provider.d.ts","sourceRoot":"","sources":["../../providers/theme-provider.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,IAAI,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAEpC,wBAAgB,aAAa,CAAC,EAC7B,QAAQ,EACR,GAAG,KAAK,EACR,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,kBAAkB,CAAC,2CAEjD"}
+{"version":3,"file":"theme-provider.d.ts","sourceRoot":"","sources":["../../providers/theme-provider.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,IAAI,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAEpC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,aAAa,CAAC,EAC7B,QAAQ,EACR,GAAG,KAAK,EACR,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,kBAAkB,CAAC,2CAEjD"}

package/dist/providers/theme-provider.js

@@ -1,6 +1,29 @@
 "use client";
 import { jsx as _jsx } from "react/jsx-runtime";
 import { ThemeProvider as NextThemesProvider } from "next-themes";
+/**
+ * Theme provider component for dark/light mode support.
+ *
+ * @remarks
+ * Wrapper around next-themes ThemeProvider.
+ * Enables theme switching and system theme detection.
+ *
+ * @param props - next-themes provider props
+ * @returns A theme context provider
+ *
+ * @example
+ * ```tsx
+ * // In your root layout
+ * <ThemeProvider
+ *   attribute="class"
+ *   defaultTheme="system"
+ *   enableSystem
+ *   disableTransitionOnChange
+ * >
+ *   {children}
+ * </ThemeProvider>
+ * ```
+ */
 export function ThemeProvider({ children, ...props }) {
     return _jsx(NextThemesProvider, { ...props, children: children });
 }

package/dist/providers/theme-provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"theme-provider.js","sourceRoot":"","sources":["../../providers/theme-provider.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,EAAE,aAAa,IAAI,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGlE,MAAM,UAAU,aAAa,CAAC,EAC7B,QAAQ,EACR,GAAG,KAAK,EACyC;IACjD,OAAO,KAAC,kBAAkB,OAAK,KAAK,YAAG,QAAQ,GAAsB,CAAC;AACvE,CAAC"}
+{"version":3,"file":"theme-provider.js","sourceRoot":"","sources":["../../providers/theme-provider.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,EAAE,aAAa,IAAI,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGlE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,aAAa,CAAC,EAC7B,QAAQ,EACR,GAAG,KAAK,EACyC;IACjD,OAAO,KAAC,kBAAkB,OAAK,KAAK,YAAG,QAAQ,GAAsB,CAAC;AACvE,CAAC"}