promptslide 0.3.15 → 0.3.17

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.3.17](https://github.com/prompticeu/promptslide/compare/promptslide-v0.3.16...promptslide-v0.3.17) (2026-09-26)
+
+
+### Features
+
+* improve slide navigation, previews, and comments ([#105](https://github.com/prompticeu/promptslide/issues/105)) ([193a6f4](https://github.com/prompticeu/promptslide/commit/193a6f40e16d7fd3b6f6761e76378ede37693309))
+
+## [0.3.16](https://github.com/prompticeu/promptslide/compare/promptslide-v0.3.15...promptslide-v0.3.16) (2026-08-28)
+
+
+### Bug Fixes
+
+* **cli:** guard deck sync against stale slides ([#103](https://github.com/prompticeu/promptslide/issues/103)) ([f8dddc9](https://github.com/prompticeu/promptslide/commit/f8dddc9fe4177c37dbae729d1efc8971aa46ed92))
+
 ## [0.3.15](https://github.com/prompticeu/promptslide/compare/promptslide-v0.3.14...promptslide-v0.3.15) (2026-04-09)
 
 

package/README.md

@@ -21,18 +21,22 @@ Then open your coding agent and say:
 
 All commands are run via `npx promptslide <command>`.
 
-| Command   | Description                              |
-| --------- | ---------------------------------------- |
-| `create`  | Scaffold a new slide deck project        |
-| `studio`  | Start the dev server with hot reload     |
-| `build`   | Build the deck for production            |
-| `preview` | Preview the production build             |
-| `add`     | Add a slide to the current deck          |
-| `remove`  | Remove a slide from the current deck     |
-| `list`    | List all slides in the current deck      |
-| `publish` | Publish the deck to PromptSlide registry |
-| `search`  | Search published decks                   |
-| `pull`    | Pull a published deck                    |
+| Command    | Description                              |
+| ---------- | ---------------------------------------- |
+| `create`   | Scaffold a new slide deck project        |
+| `studio`   | Start the dev server with hot reload     |
+| `build`    | Build the deck for production            |
+| `preview`  | Preview the production build             |
+| `add`      | Add a slide to the current deck          |
+| `remove`   | Remove a slide from the current deck     |
+| `list`     | List all slides in the current deck      |
+| `publish`  | Publish the deck to PromptSlide registry |
+| `search`   | Search published decks                   |
+| `pull`     | Pull a published deck                    |
+| `to-image` | Export a slide as a PNG image            |
+| `to-pdf`   | Export all slides as a PDF               |
+
+Use optional, unique slide IDs in `src/deck-config.ts` for stable URL links and annotations. Existing numbered slide links and decks without IDs continue to work.
 
 ## How It Works
 

package/dist/index.d.ts

@@ -113,6 +113,8 @@ type SlideComponent = React.ComponentType<SlideProps>;
  * eliminating the need for runtime step discovery.
  */
 interface SlideConfig {
+    /** Stable identifier for links and annotations. Keep unchanged when reordering slides. */
+    id?: string;
     /** The slide component to render */
     component: SlideComponent;
     /** Number of animation steps (0 = no animations). This is the max step number used in <Animated step={N}> */
@@ -222,7 +224,7 @@ declare function useAnimationContext(): AnimationContextValue;
 
 type AnimationType = "fade" | "slide-up" | "slide-down" | "slide-left" | "slide-right" | "scale";
 interface AnimatedProps {
-    /** Which step reveals this content (1-indexed) */
+    /** Which step reveals this content (0 = visible from slide entry) */
     step: number;
     /** Animation type */
     animation?: AnimationType;
@@ -397,6 +399,8 @@ interface Annotation {
     id: string;
     /** Slide index (0-based, matching deck-config order) */
     slideIndex: number;
+    /** Stable slide identity, when available. Takes precedence over slideIndex. */
+    slideId?: string;
     /** Slide title from SlideConfig (informational, for agent readability) */
     slideTitle: string;
     /** Target element identification */
@@ -419,6 +423,9 @@ interface AnnotationStorageAdapter {
     load(): Promise<Annotation[]>;
     add(annotation: Annotation): Promise<void>;
     remove(id: string): Promise<void>;
+    update?(id: string, patch: Pick<Annotation, "body" | "status">): Promise<void>;
+    /** Persist a migration of legacy index-based annotations. */
+    replaceAll?(annotations: Annotation[]): Promise<void>;
     /** Optional: subscribe to external state updates (e.g. postMessage from parent) */
     subscribe?(onUpdate: (annotations: Annotation[]) => void): () => void;
 }
@@ -429,17 +436,19 @@ interface AnnotationOverlayProps {
     /** Ref to the slide container element (the div wrapping SlideRenderer) */
     slideContainerRef: React.RefObject<HTMLDivElement | null>;
     selectedId: string | null;
+    hoveredId: string | null;
     onSelectId: (id: string | null) => void;
     onShowPanel: () => void;
     slideAnnotations: Annotation[];
-    addAnnotation: (slideIndex: number, slideTitle: string, target: AnnotationTarget, body: string) => void;
+    addAnnotation: (slideIndex: number, slideTitle: string, target: AnnotationTarget, body: string, slideId?: string) => void;
 }
-declare function AnnotationOverlay({ slides, currentSlide, slideContainerRef, selectedId, onSelectId, onShowPanel, slideAnnotations, addAnnotation }: AnnotationOverlayProps): react_jsx_runtime.JSX.Element;
+declare function AnnotationOverlay({ slides, currentSlide, slideContainerRef, selectedId, hoveredId, onSelectId, onShowPanel, slideAnnotations, addAnnotation }: AnnotationOverlayProps): react_jsx_runtime.JSX.Element;
 
-declare function useAnnotations(adapter?: AnnotationStorageAdapter): {
+declare function useAnnotations(slidesOrAdapter?: SlideConfig[] | AnnotationStorageAdapter, adapter?: AnnotationStorageAdapter): {
     annotations: Annotation[];
-    addAnnotation: (slideIndex: number, slideTitle: string, target: AnnotationTarget, body: string) => void;
+    addAnnotation: (slideIndex: number, slideTitle: string, target: AnnotationTarget, body: string, slideId?: string) => void;
     deleteAnnotation: (id: string) => void;
+    updateAnnotation: (id: string, patch: Partial<Pick<Annotation, "body" | "status">>) => void;
     getSlideAnnotations: (slideIndex: number) => Annotation[];
     openCount: number;
     updateAnnotations: (updated: Annotation[]) => void;
@@ -455,11 +464,12 @@ interface SlideDeckProps {
     /** Annotation data to display. When provided (even empty array), annotation UI is enabled. When undefined, annotation UI is hidden. */
     annotations?: Annotation[];
     /** Called when the user creates an annotation */
-    onAnnotationAdd?: (slideIndex: number, slideTitle: string, target: AnnotationTarget, body: string) => void;
+    onAnnotationAdd?: (slideIndex: number, slideTitle: string, target: AnnotationTarget, body: string, slideId?: string) => void;
     /** Called when the user deletes an annotation */
     onAnnotationDelete?: (id: string) => void;
+    onAnnotationUpdate?: (id: string, patch: Partial<Pick<Annotation, "body" | "status">>) => void;
 }
-declare function SlideDeck({ slides, transition, directionalTransition, annotations, onAnnotationAdd, onAnnotationDelete }: SlideDeckProps): react_jsx_runtime.JSX.Element;
+declare function SlideDeck({ slides, transition, directionalTransition, annotations, onAnnotationAdd, onAnnotationDelete, onAnnotationUpdate }: SlideDeckProps): react_jsx_runtime.JSX.Element;
 
 interface SlideErrorBoundaryProps {
     slideIndex: number;