promptslide 0.3.5 → 0.3.7

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## [0.3.7](https://github.com/prompticeu/promptslide/compare/promptslide-v0.3.6...promptslide-v0.3.7) (2026-03-19)
+
+
+### Features
+
+* add slide annotation system with persistent storage and pull export ([#78](https://github.com/prompticeu/promptslide/issues/78)) ([c4addbb](https://github.com/prompticeu/promptslide/commit/c4addbba10f53eede84b0c3e1f3f2704a8a7125b))
+* always check registry for publish overwrite scenarios ([#77](https://github.com/prompticeu/promptslide/issues/77)) ([bef4af5](https://github.com/prompticeu/promptslide/commit/bef4af51d397af50baa7ba038fbdf647e0ac5f56))
+* scaffold lockfile with auto-generated publish metadata ([#75](https://github.com/prompticeu/promptslide/issues/75)) ([bc3a7bd](https://github.com/prompticeu/promptslide/commit/bc3a7bd7a6c2871f27e874b12b21978911fe91e0))
+
+## [0.3.6](https://github.com/prompticeu/promptslide/compare/promptslide-v0.3.5...promptslide-v0.3.6) (2026-03-11)
+
+
+### Features
+
+* show organization hint in publish command ([#73](https://github.com/prompticeu/promptslide/issues/73)) ([3002f25](https://github.com/prompticeu/promptslide/commit/3002f255f386a5bf646381808324ebda96c57707))
+
 ## [0.3.5](https://github.com/prompticeu/promptslide/compare/promptslide-v0.3.4...promptslide-v0.3.5) (2026-03-08)
 
 

package/dist/index.d.ts

@@ -376,12 +376,90 @@ interface SlideEmbedProps {
  */
 declare function SlideEmbed({ slides, transition, directionalTransition }: SlideEmbedProps): react_jsx_runtime.JSX.Element;
 
+/**
+ * Types for the slide annotation system.
+ * Annotations are stored as a JSON file in the project root
+ * and read by coding agents to act on user feedback.
+ */
+interface AnnotationTarget {
+    /** User-assigned data-annotate value, if present on the element */
+    dataAnnotate?: string;
+    /** Nearby visible text to help locate the annotated area (first 100 chars, not meant to be edited) */
+    contentNearPin?: string;
+    /** Coordinates as percentage of slide dimensions */
+    position: {
+        xPercent: number;
+        yPercent: number;
+    };
+}
+interface Annotation {
+    /** Unique identifier */
+    id: string;
+    /** Slide index (0-based, matching deck-config order) */
+    slideIndex: number;
+    /** Slide title from SlideConfig (informational, for agent readability) */
+    slideTitle: string;
+    /** Target element identification */
+    target: AnnotationTarget;
+    /** The user's feedback text */
+    body: string;
+    /** ISO 8601 timestamp */
+    createdAt: string;
+    /** open = needs attention, resolved = agent addressed it */
+    status: "open" | "resolved";
+    /** Agent's note when resolving */
+    resolution?: string;
+}
+interface AnnotationsFile {
+    version: 1;
+    annotations: Annotation[];
+}
+/** Storage adapter for annotation persistence */
+interface AnnotationStorageAdapter {
+    load(): Promise<Annotation[]>;
+    add(annotation: Annotation): Promise<void>;
+    remove(id: string): Promise<void>;
+    /** Optional: subscribe to external state updates (e.g. postMessage from parent) */
+    subscribe?(onUpdate: (annotations: Annotation[]) => void): () => void;
+}
+
+interface AnnotationOverlayProps {
+    slides: SlideConfig[];
+    currentSlide: number;
+    /** Ref to the slide container element (the div wrapping SlideRenderer) */
+    slideContainerRef: React.RefObject<HTMLDivElement | null>;
+    selectedId: string | null;
+    onSelectId: (id: string | null) => void;
+    onShowPanel: () => void;
+    slideAnnotations: Annotation[];
+    addAnnotation: (slideIndex: number, slideTitle: string, target: AnnotationTarget, body: string) => void;
+}
+declare function AnnotationOverlay({ slides, currentSlide, slideContainerRef, selectedId, onSelectId, onShowPanel, slideAnnotations, addAnnotation }: AnnotationOverlayProps): react_jsx_runtime.JSX.Element;
+
+declare function useAnnotations(adapter?: AnnotationStorageAdapter): {
+    annotations: Annotation[];
+    addAnnotation: (slideIndex: number, slideTitle: string, target: AnnotationTarget, body: string) => void;
+    deleteAnnotation: (id: string) => void;
+    getSlideAnnotations: (slideIndex: number) => Annotation[];
+    openCount: number;
+    updateAnnotations: (updated: Annotation[]) => void;
+};
+
+/** Storage adapter for local Vite dev server (reads/writes annotations.json via middleware) */
+declare function createHttpAdapter(): AnnotationStorageAdapter;
+
 interface SlideDeckProps {
     slides: SlideConfig[];
     transition?: SlideTransitionType;
     directionalTransition?: boolean;
+    /** 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;
+    /** Called when the user deletes an annotation */
+    onAnnotationDelete?: (id: string) => void;
 }
-declare function SlideDeck({ slides, transition, directionalTransition }: SlideDeckProps): react_jsx_runtime.JSX.Element;
+declare function SlideDeck({ slides, transition, directionalTransition, annotations, onAnnotationAdd, onAnnotationDelete }: SlideDeckProps): react_jsx_runtime.JSX.Element;
 
 interface SlideErrorBoundaryProps {
     slideIndex: number;
@@ -404,4 +482,4 @@ declare class SlideErrorBoundary extends React$1.Component<SlideErrorBoundaryPro
 
 declare function cn(...inputs: ClassValue[]): string;
 
-export { Animated, AnimatedGroup, AnimationProvider, type AnimationType, DEFAULT_SLIDE_TRANSITION, EASE_DEFAULT, EASE_IN, EASE_MORPH, EASE_OUT, ELEMENT_SLIDE_DISTANCE, MORPH_DURATION, MORPH_TRANSITION, Morph, MorphGroup, MorphItem, MorphText, type NavigationDirection, SLIDE_DIMENSIONS, SLIDE_DISTANCE, SLIDE_TRANSITION, SLIDE_TRANSITION_DURATION, SLIDE_VARIANTS, SPRING_BOUNCY, SPRING_SMOOTH, SPRING_SNAPPY, STAGGER_DELAY, STEP_ANIMATION_DURATION, STEP_TRANSITION, type SlideComponent, type SlideConfig, SlideDeck, SlideEmbed, SlideErrorBoundary, type SlideProps, SlideRenderer, type SlideRendererProps, SlideThemeProvider, type SlideTransitionConfig, type SlideTransitionType, type ThemeConfig, type UseSlideNavigationOptions, type UseSlideNavigationReturn, cn, createDirectionalVariants, directionalSlideX, directionalSlideY, getSlideTransition, getSlideVariants, useAnimationContext, useSlideNavigation, useTheme };
+export { Animated, AnimatedGroup, AnimationProvider, type AnimationType, type Annotation, AnnotationOverlay, type AnnotationStorageAdapter, type AnnotationTarget, type AnnotationsFile, DEFAULT_SLIDE_TRANSITION, EASE_DEFAULT, EASE_IN, EASE_MORPH, EASE_OUT, ELEMENT_SLIDE_DISTANCE, MORPH_DURATION, MORPH_TRANSITION, Morph, MorphGroup, MorphItem, MorphText, type NavigationDirection, SLIDE_DIMENSIONS, SLIDE_DISTANCE, SLIDE_TRANSITION, SLIDE_TRANSITION_DURATION, SLIDE_VARIANTS, SPRING_BOUNCY, SPRING_SMOOTH, SPRING_SNAPPY, STAGGER_DELAY, STEP_ANIMATION_DURATION, STEP_TRANSITION, type SlideComponent, type SlideConfig, SlideDeck, SlideEmbed, SlideErrorBoundary, type SlideProps, SlideRenderer, type SlideRendererProps, SlideThemeProvider, type SlideTransitionConfig, type SlideTransitionType, type ThemeConfig, type UseSlideNavigationOptions, type UseSlideNavigationReturn, cn, createDirectionalVariants, createHttpAdapter, directionalSlideX, directionalSlideY, getSlideTransition, getSlideVariants, useAnimationContext, useAnnotations, useSlideNavigation, useTheme };