promptslide 0.3.17 → 0.3.19

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.3.19](https://github.com/prompticeu/promptslide/compare/promptslide-v0.3.18...promptslide-v0.3.19) (2026-10-23)
+
+
+### Features
+
+* add timed autoplay loops and shared slide inspector ([#109](https://github.com/prompticeu/promptslide/issues/109)) ([6393775](https://github.com/prompticeu/promptslide/commit/63937759fd86b996fe69b0a76dd3e18adf0a8a86))
+
+## [0.3.18](https://github.com/prompticeu/promptslide/compare/promptslide-v0.3.17...promptslide-v0.3.18) (2026-10-23)
+
+
+### Features
+
+* add visual slide editing in studio ([#107](https://github.com/prompticeu/promptslide/issues/107)) ([4dd6651](https://github.com/prompticeu/promptslide/commit/4dd6651269687c6a0d219c8e3b261a9ac11b7876))
+
 ## [0.3.17](https://github.com/prompticeu/promptslide/compare/promptslide-v0.3.16...promptslide-v0.3.17) (2026-09-26)
 
 

package/README.md

@@ -38,6 +38,82 @@ All commands are run via `npx promptslide <command>`.
 
 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.
 
+## Auto-loop presentations
+
+Open **Slide settings** in the toolbar, or choose **Present** → **Configure loop…**.
+The shared right inspector has **Slide**, **Elements** (local Studio only), and **Comments**
+tabs. Use the existing thumbnail rail to select a slide; its settings follow the selection.
+Each slide has an initial view plus its numbered click steps. Select a timing row to preview
+that exact state on the main canvas, then edit its duration in seconds. The normal navigation
+arrows update the highlighted row too. Unconfigured states use the deck default (5 seconds).
+
+**Include in loop** excludes a slide from autoplay while keeping it available for manual
+presentations. Excluded slides show **Skip in loop** on their thumbnails. **Loop defaults**
+contains the default duration and estimated total time. Edits remain buffered when switching
+slides, tabs, or closing the inspector. **Revert** restores the last saved loop settings.
+
+**Save settings** in local Studio writes `loop-config.json` in the project folder.
+The CLI embeds it in production builds and preserves it through publish, clone, create,
+and pull. Static presentations save changes in that browser; use **Download settings**
+and put the file in the project folder to include them in later builds or publications.
+Use stable slide IDs so timings survive reordering. Adding steps uses the default duration;
+changing a configured slide's step count flags its timings for review.
+
+```json
+{
+  "version": 1,
+  "defaultDuration": 5,
+  "slides": {
+    "intro": { "steps": 0, "dwell": [6] },
+    "agents": { "steps": 5, "dwell": [3, 2, 2, 2, 3, 12] },
+    "notification": { "excluded": true }
+  }
+}
+```
+
+`dwell[0]` is the initial state. Later entries correspond to click steps; missing or
+`null` entries inherit the default. Durations are between 0.1 and 3600 seconds.
+Timing begins after an incoming slide transition; each state duration includes its
+reveal animation. The estimated total excludes slide transitions. Videos and custom
+animations need enough explicit time; their completion is not detected automatically.
+
+Choose **Auto-loop** to start in full screen from the first included slide, step zero.
+**Space** pauses or resumes progression, **Left/Right** navigate within the loop and
+restart the state's timer, and **Escape** stops and exits. Timers pause in hidden tabs
+without catching up afterward. Pausing progression does not pause custom animations or
+videos. Slide components remount each cycle so mount-driven animations replay.
+
+For unattended use, run `npm run build && npm run preview` and open
+`http://localhost:4173/?loop`. Click once to start. Full screen requires a real user
+interaction; a rejected request shows a retryable error. Keep the computer awake and
+self-host fonts, images, video, and other assets needed offline.
+
+Custom SDK hosts can pass `loopConfig` and `onLoopConfigChange` to `SlideDeck` to provide
+settings and their own persistence adapter. CLI Studio's file save endpoint accepts
+validated, same-origin requests on loopback interfaces only.
+
+```tsx
+import { SlideDeck, type LoopConfig } from "promptslide"
+
+const loopConfig: LoopConfig = {
+  version: 1,
+  defaultDuration: 5,
+  slides: {
+    intro: { dwell: [6] },
+    agents: { steps: 2, dwell: [3, 2, 12] },
+    notification: { excluded: true }
+  }
+}
+
+// `slides` is your existing SlideConfig[] in deck order.
+<SlideDeck slides={slides} loopConfig={loopConfig} />
+```
+
+The prop overrides CLI/provider defaults; saved browser settings may override the same
+base configuration locally. CLI publishing reads `loop-config.json`, so keep shared
+timings there rather than only in a React prop. Included slides follow deck order;
+there is no separate playlist order.
+
 ## How It Works
 
 1. **You describe** what you want in natural language

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { Variants, Transition } from 'framer-motion';
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import React$1 from 'react';
+import React$1, { ReactNode } from 'react';
 import { ClassValue } from 'clsx';
 
 /**
@@ -195,6 +195,18 @@ interface ThemeConfig {
     /** Typography preferences */
     fonts?: ThemeFonts;
 }
+/** Durations in seconds, including the initial state at dwell[0]. */
+interface LoopSlideConfig {
+    excluded?: boolean;
+    /** Step count when these timings were edited; used to flag changes. */
+    steps?: number;
+    dwell?: (number | null)[];
+}
+interface LoopConfig {
+    version: 1;
+    defaultDuration: number;
+    slides: Record<string, LoopSlideConfig>;
+}
 
 interface AnimationContextValue {
     /** Current animation step (0 = no animations shown yet) */
@@ -322,6 +334,8 @@ interface UseSlideNavigationReturn {
     advance: () => void;
     goBack: () => void;
     goToSlide: (index: number) => void;
+    goToStep: (step: number) => void;
+    restartAtSlide: (index: number) => void;
     onTransitionComplete: () => void;
 }
 declare function useSlideNavigation({ slides, initialSlide, onSlideChange }: UseSlideNavigationOptions): UseSlideNavigationReturn;
@@ -341,6 +355,7 @@ interface SlideThemeProviderProps {
 declare function SlideThemeProvider({ theme, children }: SlideThemeProviderProps): react_jsx_runtime.JSX.Element;
 
 interface SlideRendererProps {
+    playbackKey?: number;
     slides: SlideConfig[];
     currentSlide: number;
     animationStep: number;
@@ -355,7 +370,7 @@ interface SlideRendererProps {
  * Renders a single slide with animated transitions.
  * Extracted from SlideDeck so it can be reused in SlideEmbed and other contexts.
  */
-declare function SlideRenderer({ slides, currentSlide, animationStep, totalSteps, direction, showAllAnimations, transition, directionalTransition, onTransitionComplete }: SlideRendererProps): react_jsx_runtime.JSX.Element;
+declare function SlideRenderer({ playbackKey, slides, currentSlide, animationStep, totalSteps, direction, showAllAnimations, transition, directionalTransition, onTransitionComplete }: SlideRendererProps): react_jsx_runtime.JSX.Element;
 
 interface SlideEmbedProps {
     slides: SlideConfig[];
@@ -461,6 +476,10 @@ interface SlideDeckProps {
     slides: SlideConfig[];
     transition?: SlideTransitionType;
     directionalTransition?: boolean;
+    /** Overrides the CLI-provided loop settings. */
+    loopConfig?: LoopConfig;
+    /** Persist settings in a custom host. CLI Studio saves loop-config.json automatically. */
+    onLoopConfigChange?: (config: LoopConfig) => void | Promise<void>;
     /** 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 */
@@ -469,7 +488,7 @@ interface SlideDeckProps {
     onAnnotationDelete?: (id: string) => void;
     onAnnotationUpdate?: (id: string, patch: Partial<Pick<Annotation, "body" | "status">>) => void;
 }
-declare function SlideDeck({ slides, transition, directionalTransition, annotations, onAnnotationAdd, onAnnotationDelete, onAnnotationUpdate }: SlideDeckProps): react_jsx_runtime.JSX.Element;
+declare function SlideDeck({ slides, transition, directionalTransition, loopConfig: suppliedLoopConfig, onLoopConfigChange, annotations, onAnnotationAdd, onAnnotationDelete, onAnnotationUpdate }: SlideDeckProps): react_jsx_runtime.JSX.Element;
 
 interface SlideErrorBoundaryProps {
     slideIndex: number;
@@ -492,4 +511,10 @@ declare class SlideErrorBoundary extends React$1.Component<SlideErrorBoundaryPro
 
 declare function cn(...inputs: ClassValue[]): string;
 
-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 };
+/** The CLI supplies the deck's loop-config.json in development and production. */
+declare function LoopConfigProvider({ config, children }: {
+    config: LoopConfig;
+    children: ReactNode;
+}): react_jsx_runtime.JSX.Element;
+
+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, type LoopConfig, LoopConfigProvider, type LoopSlideConfig, 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 };