@particle-academy/fancy-slides 0.1.7 → 0.3.0

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode, CSSProperties } from 'react';
-import { f as Slide$1, m as Theme, h as SlideElement, D as Deck, c as DeckOp, e as ShapeKind, k as TextElement, I as ImageElement, S as ShapeElement, i as SlideLayout, g as SlideBackground } from './types-Bc-psiRF.cjs';
-export { C as ChartElement, a as CodeElement, b as DeckActivity, E as ElementBase, d as EmbedElement, j as SlideTransition, T as TableElement, l as TextStyle, n as ThemeColors, o as ThemeFonts, p as TransitionKind } from './types-Bc-psiRF.cjs';
+import { f as Slide$1, m as Theme, h as SlideElement, D as Deck, c as DeckOp, e as ShapeKind, j as SlideTransition, g as SlideBackground, k as TextElement, I as ImageElement, S as ShapeElement, i as SlideLayout } from './types-B2ecrEAz.cjs';
+export { C as ChartElement, a as CodeElement, b as DeckActivity, E as ElementBase, d as EmbedElement, T as TableElement, l as TextStyle, n as ThemeColors, o as ThemeFonts, p as TransitionKind } from './types-B2ecrEAz.cjs';
 
 interface SlideProps {
     /** The slide to render. */
@@ -279,7 +279,7 @@ interface EditorToolbarProps {
 declare function EditorToolbar({ title, onTitleChange, themeName, onApplyTheme, onInsertText, onInsertImage, onInsertShape, onInsertChart, onInsertCode, onInsertTable, onPresent, disabled, }: EditorToolbarProps): react_jsx_runtime.JSX.Element;
 
 interface ElementInspectorProps {
-    /** Element being inspected. `null` shows the empty state. */
+    /** Element being inspected. `null` falls back to slide settings (or the empty state). */
     element: SlideElement | null;
     /** Patch a property on the element. */
     onPatch: (patch: Partial<SlideElement>) => void;
@@ -287,6 +287,12 @@ interface ElementInspectorProps {
     onDelete?: () => void;
     /** Lock toggle. */
     onLockToggle?: (locked: boolean) => void;
+    /** Selected slide — shown when no element is selected so the user can edit slide-level settings. */
+    slide?: Slide$1 | null;
+    /** Set the slide's entrance transition. */
+    onSetTransition?: (transition?: SlideTransition) => void;
+    /** Set the slide's background. */
+    onSetBackground?: (background?: SlideBackground) => void;
 }
 /**
  * Right-hand inspector. Tabs split position + style + advanced properties.
@@ -294,7 +300,7 @@ interface ElementInspectorProps {
  * react-fancy `Card`, `Tabs`, `Input`, `Select`, `Slider`, `ColorPicker`,
  * `Action`.
  */
-declare function ElementInspector({ element, onPatch, onDelete, onLockToggle }: ElementInspectorProps): react_jsx_runtime.JSX.Element;
+declare function ElementInspector({ element, onPatch, onDelete, onLockToggle, slide, onSetTransition, onSetBackground }: ElementInspectorProps): react_jsx_runtime.JSX.Element;
 
 interface SpeakerNotesProps {
     notes?: string;
@@ -343,6 +349,14 @@ declare function TextElementRenderer({ element, theme, slideWidthPx, editing, se
 interface ImageElementRendererProps {
     element: ImageElement;
 }
+/**
+ * Renders an image element. When `element.crop` is set (a window in
+ * image-relative 0..1 coords `{x,y,w,h}`), the image is shown cropped to that
+ * window: an `overflow:hidden` box clips an inner `<img>` that's been scaled up
+ * by `1/w` × `1/h` and offset so the crop window exactly fills the box. Without
+ * a crop it's the plain `object-fit` image. The same renderer feeds both the
+ * editor canvas and the viewer, so a crop is visible everywhere.
+ */
 declare function ImageElementRenderer({ element }: ImageElementRendererProps): react_jsx_runtime.JSX.Element;
 
 interface ShapeElementRendererProps {
@@ -413,6 +427,7 @@ interface DeckStateApi {
     setLayout: (id: string, layout: SlideLayout) => void;
     setNotes: (id: string, notes: string) => void;
     setBackground: (id: string, bg?: SlideBackground) => void;
+    setTransition: (id: string, transition?: SlideTransition) => void;
     /** Element-level helpers. */
     addElement: (slideId: string, element: Omit<SlideElement, "id"> & {
         id?: string;
@@ -481,4 +496,4 @@ type ChartKind = "bar" | "line" | "pie" | "area" | "scatter";
 type Option = Record<string, unknown>;
 declare function chartStarterOption(kind: ChartKind): Option;
 
-export { type ChartKind$1 as ChartKind, Deck, DeckEditor, type DeckEditorProps, DeckOp, type DeckStateApi, EditorToolbar, type EditorToolbarProps, ElementInspector, type ElementInspectorProps, ImageElement, ImageElementRenderer, type ImageElementRendererProps, PresenterView, type PresenterViewProps, ShapeElement, ShapeElementRenderer, type ShapeElementRendererProps, ShapeKind, Slide, SlideBackground, type SlideContextValue, Slide$1 as SlideData, SlideElement, type SlideKeyboardOptions, SlideLayout, type SlideProps, SlideRail, type SlideRailProps, SlideThumbnail, type SlideThumbnailProps, SlideViewer, type SlideViewerProps, SpeakerNotes, type SpeakerNotesProps, TextElement, TextElementRenderer, type TextElementRendererProps, Theme, type UseDeckStateOptions, builtinThemes, chartStarterOption, darkTheme, deckId, defaultTheme, defineTheme, elementId, nextId, reduce as reduceDeck, resolveTheme, slideId, useDeckState, useIsDarkSlide, useSlideContext, useSlideKeyboard, useSlideTheme, vividTheme };
+export { type ChartKind$1 as ChartKind, Deck, DeckEditor, type DeckEditorProps, DeckOp, type DeckStateApi, EditorToolbar, type EditorToolbarProps, ElementInspector, type ElementInspectorProps, ImageElement, ImageElementRenderer, type ImageElementRendererProps, PresenterView, type PresenterViewProps, ShapeElement, ShapeElementRenderer, type ShapeElementRendererProps, ShapeKind, Slide, SlideBackground, type SlideContextValue, Slide$1 as SlideData, SlideElement, type SlideKeyboardOptions, SlideLayout, type SlideProps, SlideRail, type SlideRailProps, SlideThumbnail, type SlideThumbnailProps, SlideTransition, SlideViewer, type SlideViewerProps, SpeakerNotes, type SpeakerNotesProps, TextElement, TextElementRenderer, type TextElementRendererProps, Theme, type UseDeckStateOptions, builtinThemes, chartStarterOption, darkTheme, deckId, defaultTheme, defineTheme, elementId, nextId, reduce as reduceDeck, resolveTheme, slideId, useDeckState, useIsDarkSlide, useSlideContext, useSlideKeyboard, useSlideTheme, vividTheme };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode, CSSProperties } from 'react';
-import { f as Slide$1, m as Theme, h as SlideElement, D as Deck, c as DeckOp, e as ShapeKind, k as TextElement, I as ImageElement, S as ShapeElement, i as SlideLayout, g as SlideBackground } from './types-Bc-psiRF.js';
-export { C as ChartElement, a as CodeElement, b as DeckActivity, E as ElementBase, d as EmbedElement, j as SlideTransition, T as TableElement, l as TextStyle, n as ThemeColors, o as ThemeFonts, p as TransitionKind } from './types-Bc-psiRF.js';
+import { f as Slide$1, m as Theme, h as SlideElement, D as Deck, c as DeckOp, e as ShapeKind, j as SlideTransition, g as SlideBackground, k as TextElement, I as ImageElement, S as ShapeElement, i as SlideLayout } from './types-B2ecrEAz.js';
+export { C as ChartElement, a as CodeElement, b as DeckActivity, E as ElementBase, d as EmbedElement, T as TableElement, l as TextStyle, n as ThemeColors, o as ThemeFonts, p as TransitionKind } from './types-B2ecrEAz.js';
 
 interface SlideProps {
     /** The slide to render. */
@@ -279,7 +279,7 @@ interface EditorToolbarProps {
 declare function EditorToolbar({ title, onTitleChange, themeName, onApplyTheme, onInsertText, onInsertImage, onInsertShape, onInsertChart, onInsertCode, onInsertTable, onPresent, disabled, }: EditorToolbarProps): react_jsx_runtime.JSX.Element;
 
 interface ElementInspectorProps {
-    /** Element being inspected. `null` shows the empty state. */
+    /** Element being inspected. `null` falls back to slide settings (or the empty state). */
     element: SlideElement | null;
     /** Patch a property on the element. */
     onPatch: (patch: Partial<SlideElement>) => void;
@@ -287,6 +287,12 @@ interface ElementInspectorProps {
     onDelete?: () => void;
     /** Lock toggle. */
     onLockToggle?: (locked: boolean) => void;
+    /** Selected slide — shown when no element is selected so the user can edit slide-level settings. */
+    slide?: Slide$1 | null;
+    /** Set the slide's entrance transition. */
+    onSetTransition?: (transition?: SlideTransition) => void;
+    /** Set the slide's background. */
+    onSetBackground?: (background?: SlideBackground) => void;
 }
 /**
  * Right-hand inspector. Tabs split position + style + advanced properties.
@@ -294,7 +300,7 @@ interface ElementInspectorProps {
  * react-fancy `Card`, `Tabs`, `Input`, `Select`, `Slider`, `ColorPicker`,
  * `Action`.
  */
-declare function ElementInspector({ element, onPatch, onDelete, onLockToggle }: ElementInspectorProps): react_jsx_runtime.JSX.Element;
+declare function ElementInspector({ element, onPatch, onDelete, onLockToggle, slide, onSetTransition, onSetBackground }: ElementInspectorProps): react_jsx_runtime.JSX.Element;
 
 interface SpeakerNotesProps {
     notes?: string;
@@ -343,6 +349,14 @@ declare function TextElementRenderer({ element, theme, slideWidthPx, editing, se
 interface ImageElementRendererProps {
     element: ImageElement;
 }
+/**
+ * Renders an image element. When `element.crop` is set (a window in
+ * image-relative 0..1 coords `{x,y,w,h}`), the image is shown cropped to that
+ * window: an `overflow:hidden` box clips an inner `<img>` that's been scaled up
+ * by `1/w` × `1/h` and offset so the crop window exactly fills the box. Without
+ * a crop it's the plain `object-fit` image. The same renderer feeds both the
+ * editor canvas and the viewer, so a crop is visible everywhere.
+ */
 declare function ImageElementRenderer({ element }: ImageElementRendererProps): react_jsx_runtime.JSX.Element;
 
 interface ShapeElementRendererProps {
@@ -413,6 +427,7 @@ interface DeckStateApi {
     setLayout: (id: string, layout: SlideLayout) => void;
     setNotes: (id: string, notes: string) => void;
     setBackground: (id: string, bg?: SlideBackground) => void;
+    setTransition: (id: string, transition?: SlideTransition) => void;
     /** Element-level helpers. */
     addElement: (slideId: string, element: Omit<SlideElement, "id"> & {
         id?: string;
@@ -481,4 +496,4 @@ type ChartKind = "bar" | "line" | "pie" | "area" | "scatter";
 type Option = Record<string, unknown>;
 declare function chartStarterOption(kind: ChartKind): Option;
 
-export { type ChartKind$1 as ChartKind, Deck, DeckEditor, type DeckEditorProps, DeckOp, type DeckStateApi, EditorToolbar, type EditorToolbarProps, ElementInspector, type ElementInspectorProps, ImageElement, ImageElementRenderer, type ImageElementRendererProps, PresenterView, type PresenterViewProps, ShapeElement, ShapeElementRenderer, type ShapeElementRendererProps, ShapeKind, Slide, SlideBackground, type SlideContextValue, Slide$1 as SlideData, SlideElement, type SlideKeyboardOptions, SlideLayout, type SlideProps, SlideRail, type SlideRailProps, SlideThumbnail, type SlideThumbnailProps, SlideViewer, type SlideViewerProps, SpeakerNotes, type SpeakerNotesProps, TextElement, TextElementRenderer, type TextElementRendererProps, Theme, type UseDeckStateOptions, builtinThemes, chartStarterOption, darkTheme, deckId, defaultTheme, defineTheme, elementId, nextId, reduce as reduceDeck, resolveTheme, slideId, useDeckState, useIsDarkSlide, useSlideContext, useSlideKeyboard, useSlideTheme, vividTheme };
+export { type ChartKind$1 as ChartKind, Deck, DeckEditor, type DeckEditorProps, DeckOp, type DeckStateApi, EditorToolbar, type EditorToolbarProps, ElementInspector, type ElementInspectorProps, ImageElement, ImageElementRenderer, type ImageElementRendererProps, PresenterView, type PresenterViewProps, ShapeElement, ShapeElementRenderer, type ShapeElementRendererProps, ShapeKind, Slide, SlideBackground, type SlideContextValue, Slide$1 as SlideData, SlideElement, type SlideKeyboardOptions, SlideLayout, type SlideProps, SlideRail, type SlideRailProps, SlideThumbnail, type SlideThumbnailProps, SlideTransition, SlideViewer, type SlideViewerProps, SpeakerNotes, type SpeakerNotesProps, TextElement, TextElementRenderer, type TextElementRendererProps, Theme, type UseDeckStateOptions, builtinThemes, chartStarterOption, darkTheme, deckId, defaultTheme, defineTheme, elementId, nextId, reduce as reduceDeck, resolveTheme, slideId, useDeckState, useIsDarkSlide, useSlideContext, useSlideKeyboard, useSlideTheme, vividTheme };