papyr-react 1.0.0

package/dist/hooks/useActiveNote.d.ts

@@ -0,0 +1,27 @@
+import { WebReadyNote, Slug } from 'papyr-core/runtime';
+
+export interface UseActiveNoteResult {
+    activeSlug: Slug | null;
+    activeNote: WebReadyNote | null;
+    setActiveSlug: (slug: Slug | null) => void;
+    setActiveNote: (note: WebReadyNote | null) => void;
+}
+/**
+ * Hook for managing active note state.
+ * Useful for tracking which note is currently selected/viewed.
+ *
+ * @param notes - Array of all notes
+ * @param initialSlug - Optional initial active slug
+ *
+ * @example
+ * // Basic usage
+ * const { activeSlug, activeNote, setActiveSlug } = useActiveNote(notes)
+ *
+ * <FileHierarchy activeSlug={activeSlug} onNoteClick={setActiveSlug} />
+ * <NoteViewer note={activeNote} />
+ *
+ * @example
+ * // With initial selection
+ * const { activeSlug, setActiveNote } = useActiveNote(notes, 'welcome')
+ */
+export declare function useActiveNote(notes: WebReadyNote[], initialSlug?: Slug | null): UseActiveNoteResult;

package/dist/hooks/useActiveNote.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/hooks/useNotes.d.ts

@@ -0,0 +1,3 @@
+import { WebReadyNote } from 'papyr-core/runtime';
+
+export declare function useNotes(notes: WebReadyNote[]): WebReadyNote[];

package/dist/hooks/useRoutableActiveNote.d.ts

@@ -0,0 +1,16 @@
+import { WebReadyNote, Slug } from 'papyr-core/runtime';
+import { UseActiveNoteResult } from './useActiveNote';
+
+export interface UseRoutableActiveNoteOptions {
+    /**
+     * Read the current slug from your router.
+     * Ensure the function is stable (wrap with useCallback) to avoid unnecessary syncs.
+     */
+    getCurrentSlug: () => Slug | null;
+    /**
+     * Called when Papyr needs to push a new slug into the router.
+     * For example, call navigate(`/notes/${slug}`).
+     */
+    onSlugChange?: (slug: Slug | null) => void;
+}
+export declare function useRoutableActiveNote(notes: WebReadyNote[], options: UseRoutableActiveNoteOptions): UseActiveNoteResult;

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from './components';
+export * from './hooks';
+export * from './providers';
+export * from './utils';
+export * from './types';
+export * from './blocks';