@textcortex/slidewise 1.1.0 → 1.3.0

package/src/compound/topbar/Redo.tsx

@@ -0,0 +1,50 @@
+import type { CSSProperties, ReactNode } from "react";
+import { Redo2 } from "lucide-react";
+import { useEditor } from "@/lib/StoreProvider";
+import { useIcons } from "../IconContext";
+import { useReadOnly } from "../ReadOnlyContext";
+import { iconBtnStyle, hoverHandlers } from "./styles";
+
+/**
+ * Redo button. Calls `store.redo()`. Hidden in read-only mode. Disables
+ * itself when the redo stack is empty.
+ */
+export interface TopBarRedoProps {
+  className?: string;
+  style?: CSSProperties;
+  ariaLabel?: string;
+  children?: ReactNode;
+}
+
+export function Redo({
+  className,
+  style,
+  ariaLabel = "Redo",
+  children,
+}: TopBarRedoProps = {}) {
+  const redo = useEditor((s) => s.redo);
+  const canRedo = useEditor((s) => s.future.length > 0);
+  const icons = useIcons();
+  const readOnly = useReadOnly();
+  if (readOnly) return null;
+
+  return (
+    <button
+      type="button"
+      className={className}
+      title={ariaLabel}
+      aria-label={ariaLabel}
+      disabled={!canRedo}
+      onClick={redo}
+      style={{
+        ...iconBtnStyle(),
+        cursor: canRedo ? "pointer" : "default",
+        opacity: canRedo ? 1 : 0.4,
+        ...style,
+      }}
+      {...hoverHandlers()}
+    >
+      {children ?? icons.redo ?? <Redo2 size={16} />}
+    </button>
+  );
+}

package/src/compound/topbar/Root.tsx

@@ -0,0 +1,51 @@
+import type { CSSProperties, PropsWithChildren } from "react";
+
+/**
+ * Container for the TopBar subparts. Owns the bar's height, padding, theme
+ * background, and shadow. Hosts replace this when they want a different
+ * shell shape (taller bar, different alignment, etc.); otherwise just render
+ * subparts inside it.
+ *
+ * ```tsx
+ * <Slidewise.TopBar.Root>
+ *   <Slidewise.TopBar.Title />
+ *   <Slidewise.TopBar.Spacer />
+ *   <Slidewise.TopBar.Save />
+ * </Slidewise.TopBar.Root>
+ * ```
+ */
+export interface TopBarRootProps {
+  className?: string;
+  style?: CSSProperties;
+}
+
+export function Root({
+  className,
+  style,
+  children,
+}: PropsWithChildren<TopBarRootProps>) {
+  return (
+    <div
+      className={
+        className ? `slidewise-topbar ${className}` : "slidewise-topbar"
+      }
+      style={{
+        height: 56,
+        display: "flex",
+        alignItems: "center",
+        padding: "0 14px",
+        gap: 10,
+        background: "var(--slidewise-bar-bg, var(--app-bg))",
+        borderBottom: "1px solid var(--border)",
+        boxShadow: "var(--topbar-shadow)",
+        fontFamily: "Inter, system-ui, sans-serif",
+        position: "relative",
+        zIndex: 10,
+        color: "var(--ink)",
+        ...style,
+      }}
+    >
+      {children}
+    </div>
+  );
+}

package/src/compound/topbar/Save.tsx

@@ -0,0 +1,80 @@
+import { useState, type CSSProperties, type ReactNode } from "react";
+import { Save as SaveIcon } from "lucide-react";
+import { useEditorStore } from "@/lib/StoreProvider";
+import { useHostCallbacks } from "../HostContext";
+import { useIcons } from "../IconContext";
+import { useReadOnly } from "../ReadOnlyContext";
+import { chromeBtnStyle, hoverHandlers } from "./styles";
+
+/**
+ * Save button. Calls the host's `onSave` (from `<Slidewise.Root onSave>`)
+ * with the current deck. If no host callback is registered, falls back to
+ * `localStorage.setItem("slidewise-deck", ...)` so the dev shell works
+ * without wiring.
+ *
+ * Cycles through idle → saving → saved labels around the click; hosts that
+ * want their own loading affordance render their own button using
+ * `useHostCallbacks().onSave` directly.
+ */
+export interface TopBarSaveProps {
+  className?: string;
+  style?: CSSProperties;
+  ariaLabel?: string;
+  labels?: { idle?: string; saving?: string; saved?: string };
+  children?: ReactNode;
+}
+
+export function Save({
+  className,
+  style,
+  ariaLabel = "Save",
+  labels,
+  children,
+}: TopBarSaveProps = {}) {
+  const store = useEditorStore();
+  const { onSave: onSaveHost } = useHostCallbacks();
+  const icons = useIcons();
+  const readOnly = useReadOnly();
+  const [phase, setPhase] = useState<"idle" | "saving" | "saved">("idle");
+
+  if (readOnly) return null;
+
+  const onClick = async () => {
+    setPhase("saving");
+    const deck = store.getState().deck;
+    try {
+      if (onSaveHost) {
+        await onSaveHost(deck);
+      } else {
+        try {
+          localStorage.setItem("slidewise-deck", JSON.stringify(deck));
+        } catch {}
+      }
+      setTimeout(() => setPhase("saved"), 320);
+      setTimeout(() => setPhase("idle"), 1600);
+    } catch {
+      setPhase("idle");
+    }
+  };
+
+  const text =
+    phase === "saving"
+      ? (labels?.saving ?? "Saving…")
+      : phase === "saved"
+        ? (labels?.saved ?? "Saved")
+        : (labels?.idle ?? "Save");
+
+  return (
+    <button
+      type="button"
+      className={className}
+      aria-label={ariaLabel}
+      onClick={onClick}
+      style={{ ...chromeBtnStyle(), ...style }}
+      {...hoverHandlers()}
+    >
+      {children ?? icons.save ?? <SaveIcon size={14} />}
+      {text}
+    </button>
+  );
+}

package/src/compound/topbar/Spacer.tsx

@@ -0,0 +1,27 @@
+import type { CSSProperties } from "react";
+
+/**
+ * Pushes subsequent subparts to the far edge of `<TopBar.Root>`.
+ *
+ * ```tsx
+ * <Slidewise.TopBar.Root>
+ *   <MyExitButton />
+ *   <Slidewise.TopBar.Spacer />
+ *   <Slidewise.TopBar.Save />
+ * </Slidewise.TopBar.Root>
+ * ```
+ */
+export interface TopBarSpacerProps {
+  className?: string;
+  style?: CSSProperties;
+}
+
+export function Spacer({ className, style }: TopBarSpacerProps = {}) {
+  return (
+    <div
+      className={className}
+      aria-hidden="true"
+      style={{ flex: 1, minWidth: 0, ...style }}
+    />
+  );
+}

package/src/compound/topbar/ThemeToggle.tsx

@@ -0,0 +1,49 @@
+import type { CSSProperties, ReactNode } from "react";
+import { Sun, Moon } from "lucide-react";
+import { useEditor } from "@/lib/StoreProvider";
+import { useIcons } from "../IconContext";
+import { iconBtnStyle, hoverHandlers } from "./styles";
+
+/**
+ * Light/dark theme toggle. Always rendered; theme is a viewer concern,
+ * not an editing one.
+ */
+export interface TopBarThemeToggleProps {
+  className?: string;
+  style?: CSSProperties;
+  labels?: { toggleToDark?: string; toggleToLight?: string };
+  children?: ReactNode;
+}
+
+export function ThemeToggle({
+  className,
+  style,
+  labels,
+  children,
+}: TopBarThemeToggleProps = {}) {
+  const theme = useEditor((s) => s.theme);
+  const toggleTheme = useEditor((s) => s.toggleTheme);
+  const icons = useIcons();
+
+  const label =
+    theme === "dark"
+      ? (labels?.toggleToLight ?? "Light mode")
+      : (labels?.toggleToDark ?? "Dark mode");
+
+  return (
+    <button
+      type="button"
+      className={className}
+      title={label}
+      aria-label={label}
+      onClick={toggleTheme}
+      style={{ ...iconBtnStyle(), ...style }}
+      {...hoverHandlers()}
+    >
+      {children ??
+        (theme === "dark"
+          ? (icons.themeLight ?? <Sun size={16} />)
+          : (icons.themeDark ?? <Moon size={16} />))}
+    </button>
+  );
+}

package/src/compound/topbar/Title.tsx

@@ -0,0 +1,79 @@
+import type { CSSProperties } from "react";
+import { Sparkles } from "lucide-react";
+import { useEditor } from "@/lib/StoreProvider";
+import { useIcons } from "../IconContext";
+import { useReadOnly } from "../ReadOnlyContext";
+
+/**
+ * Deck title input wrapped in the "Smart" pill. Reads + writes
+ * `deck.title` on the editor store. In read-only mode the input is locked.
+ *
+ * Hosts that want a different title affordance (a static label, a custom
+ * input style) drop this subpart and render their own — `useEditor` is
+ * exported so the host's component can read `s.deck.title` and call
+ * `s.setTitle(...)`.
+ */
+export interface TopBarTitleProps {
+  className?: string;
+  style?: CSSProperties;
+}
+
+export function Title({ className, style }: TopBarTitleProps = {}) {
+  const title = useEditor((s) => s.deck.title);
+  const setTitle = useEditor((s) => s.setTitle);
+  const icons = useIcons();
+  const readOnly = useReadOnly();
+
+  return (
+    <div
+      className={
+        className
+          ? `slidewise-topbar-title ${className}`
+          : "slidewise-topbar-title"
+      }
+      style={{
+        flex: 1,
+        display: "flex",
+        alignItems: "center",
+        justifyContent: "center",
+        gap: 8,
+        minWidth: 0,
+        ...style,
+      }}
+    >
+      <span
+        style={{
+          display: "inline-flex",
+          alignItems: "center",
+          gap: 4,
+          padding: "3px 8px",
+          background: "var(--smart-grad)",
+          color: "var(--smart-fg)",
+          borderRadius: 999,
+          fontSize: 11,
+          fontWeight: 600,
+          letterSpacing: 0.2,
+        }}
+      >
+        {icons.smart ?? <Sparkles size={11} />}
+        Smart
+      </span>
+      <input
+        aria-label="Deck title"
+        value={title}
+        readOnly={readOnly}
+        onChange={(e) => setTitle(e.target.value)}
+        style={{
+          background: "transparent",
+          border: "none",
+          fontSize: 14,
+          fontWeight: 500,
+          color: "var(--ink)",
+          textAlign: "center",
+          minWidth: 240,
+          maxWidth: 520,
+        }}
+      />
+    </div>
+  );
+}

package/src/compound/topbar/Undo.tsx

@@ -0,0 +1,62 @@
+import type { CSSProperties, ReactNode } from "react";
+import { Undo2 } from "lucide-react";
+import { useEditor } from "@/lib/StoreProvider";
+import { useIcons } from "../IconContext";
+import { useReadOnly } from "../ReadOnlyContext";
+import { iconBtnStyle, hoverHandlers } from "./styles";
+
+/**
+ * Undo button. Calls `store.undo()`. Hidden in read-only mode. Disables
+ * itself when the undo stack is empty.
+ *
+ * Hosts replace this when they need a different shape (e.g. their own
+ * tooltip primitive or icon set with custom layout). The hook + store
+ * action are public, so a host replacement is trivially:
+ *
+ * ```tsx
+ * const MyUndo = () => {
+ *   const undo = useEditor(s => s.undo);
+ *   const canUndo = useEditor(s => s.history.length > 0);
+ *   return <MyIconButton disabled={!canUndo} onClick={undo}>↶</MyIconButton>;
+ * };
+ * ```
+ */
+export interface TopBarUndoProps {
+  className?: string;
+  style?: CSSProperties;
+  ariaLabel?: string;
+  children?: ReactNode;
+}
+
+export function Undo({
+  className,
+  style,
+  ariaLabel = "Undo",
+  children,
+}: TopBarUndoProps = {}) {
+  const undo = useEditor((s) => s.undo);
+  const canUndo = useEditor((s) => s.history.length > 0);
+  const icons = useIcons();
+  const readOnly = useReadOnly();
+  if (readOnly) return null;
+
+  return (
+    <button
+      type="button"
+      className={className}
+      title={ariaLabel}
+      aria-label={ariaLabel}
+      disabled={!canUndo}
+      onClick={undo}
+      style={{
+        ...iconBtnStyle(),
+        cursor: canUndo ? "pointer" : "default",
+        opacity: canUndo ? 1 : 0.4,
+        ...style,
+      }}
+      {...hoverHandlers()}
+    >
+      {children ?? icons.undo ?? <Undo2 size={16} />}
+    </button>
+  );
+}

package/src/compound/topbar/index.tsx

@@ -0,0 +1,107 @@
+import type { CSSProperties } from "react";
+import { Root, type TopBarRootProps } from "./Root";
+import { Title, type TopBarTitleProps } from "./Title";
+import { Undo, type TopBarUndoProps } from "./Undo";
+import { Redo, type TopBarRedoProps } from "./Redo";
+import { Save, type TopBarSaveProps } from "./Save";
+import { Play, type TopBarPlayProps } from "./Play";
+import { ThemeToggle, type TopBarThemeToggleProps } from "./ThemeToggle";
+import { Export, type TopBarExportProps } from "./Export";
+import { Spacer, type TopBarSpacerProps } from "./Spacer";
+import { Group, type TopBarGroupProps } from "./Group";
+
+export type TopBarSlotId =
+  | "undo"
+  | "redo"
+  | "title"
+  | "themeToggle"
+  | "save"
+  | "play"
+  | "export";
+
+export interface TopBarProps {
+  /**
+   * Hide individual default buttons without dropping to the compound API.
+   * Pass any subset of slot ids; the rest render as usual. Read-only mode
+   * already hides save/undo/redo regardless of this prop.
+   *
+   * ```tsx
+   * <Slidewise.TopBar hide={["export", "play"]} />
+   * ```
+   */
+  hide?: TopBarSlotId[];
+  className?: string;
+  style?: CSSProperties;
+}
+
+/**
+ * Default TopBar arrangement. Equivalent to:
+ *
+ * ```tsx
+ * <Slidewise.TopBar.Root>
+ *   <Slidewise.TopBar.Group>
+ *     <Slidewise.TopBar.Undo />
+ *     <Slidewise.TopBar.Redo />
+ *   </Slidewise.TopBar.Group>
+ *   <Slidewise.TopBar.Title />
+ *   <Slidewise.TopBar.ThemeToggle />
+ *   <Slidewise.TopBar.Save />
+ *   <Slidewise.TopBar.Play />
+ *   <Slidewise.TopBar.Export />
+ * </Slidewise.TopBar.Root>
+ * ```
+ *
+ * For full control over which subparts render, in what order, and
+ * intermixed with host UI, drop down to `<Slidewise.TopBar.Root>` and the
+ * named subparts directly.
+ */
+function DefaultTopBar({ hide, className, style }: TopBarProps = {}) {
+  const hidden = new Set(hide ?? []);
+  return (
+    <Root className={className} style={style}>
+      {(!hidden.has("undo") || !hidden.has("redo")) && (
+        <Group>
+          {!hidden.has("undo") && <Undo />}
+          {!hidden.has("redo") && <Redo />}
+        </Group>
+      )}
+      {!hidden.has("title") && <Title />}
+      {!hidden.has("themeToggle") && <ThemeToggle />}
+      {!hidden.has("save") && <Save />}
+      {!hidden.has("play") && <Play />}
+      {!hidden.has("export") && <Export />}
+    </Root>
+  );
+}
+
+/**
+ * `<Slidewise.TopBar />` is both a callable component (rendering the
+ * default arrangement) and a namespace of subparts (`TopBar.Root`,
+ * `TopBar.Title`, etc.) for full compound composition. The dual API
+ * mirrors dialux's Dialog / Radix's Dialog patterns.
+ */
+export const TopBar = Object.assign(DefaultTopBar, {
+  Root,
+  Title,
+  Undo,
+  Redo,
+  Save,
+  Play,
+  ThemeToggle,
+  Export,
+  Spacer,
+  Group,
+});
+
+export type {
+  TopBarRootProps,
+  TopBarTitleProps,
+  TopBarUndoProps,
+  TopBarRedoProps,
+  TopBarSaveProps,
+  TopBarPlayProps,
+  TopBarThemeToggleProps,
+  TopBarExportProps,
+  TopBarSpacerProps,
+  TopBarGroupProps,
+};

package/src/compound/topbar/styles.ts

@@ -0,0 +1,81 @@
+import type { CSSProperties } from "react";
+
+/**
+ * Shared button styles for TopBar subparts. Kept here so a host that swaps
+ * out one subpart (e.g. their own Save button) can match the visual weight
+ * of the remaining built-in subparts by importing these and applying them.
+ */
+
+export function chromeBtnStyle(): CSSProperties {
+  return {
+    height: 32,
+    padding: "0 12px",
+    display: "flex",
+    alignItems: "center",
+    gap: 6,
+    background: "transparent",
+    border: "1px solid var(--border-strong)",
+    borderRadius: "var(--slidewise-radius, 10px)",
+    cursor: "pointer",
+    color: "var(--ink)",
+    fontSize: 13,
+    fontWeight: 500,
+    fontFamily: "inherit",
+  };
+}
+
+export function iconBtnStyle(): CSSProperties {
+  return {
+    width: 32,
+    height: 32,
+    borderRadius: 8,
+    border: "none",
+    background: "transparent",
+    cursor: "pointer",
+    display: "flex",
+    alignItems: "center",
+    justifyContent: "center",
+    color: "var(--ink)",
+    fontFamily: "inherit",
+  };
+}
+
+export function primaryBtnStyle(): CSSProperties {
+  return {
+    height: 32,
+    padding: "0 12px",
+    display: "flex",
+    alignItems: "center",
+    gap: 6,
+    background: "var(--primary-bg)",
+    border: "1px solid var(--primary-bg)",
+    borderRadius: "var(--slidewise-radius, 10px)",
+    cursor: "pointer",
+    color: "var(--primary-fg)",
+    fontSize: 13,
+    fontWeight: 500,
+    fontFamily: "inherit",
+  };
+}
+
+export function hoverHandlers(bg: string = "var(--hover)") {
+  return {
+    onMouseEnter: (e: React.MouseEvent<HTMLElement>) => {
+      (e.currentTarget as HTMLElement).style.background = bg;
+    },
+    onMouseLeave: (e: React.MouseEvent<HTMLElement>) => {
+      (e.currentTarget as HTMLElement).style.background = "transparent";
+    },
+  };
+}
+
+export function primaryHoverHandlers() {
+  return {
+    onMouseEnter: (e: React.MouseEvent<HTMLElement>) => {
+      (e.currentTarget as HTMLElement).style.background = "var(--primary-bg-hover)";
+    },
+    onMouseLeave: (e: React.MouseEvent<HTMLElement>) => {
+      (e.currentTarget as HTMLElement).style.background = "var(--primary-bg)";
+    },
+  };
+}

package/src/index.ts

@@ -45,11 +45,26 @@ export {
   useHostCallbacks,
   useIcons,
   useReadOnly,
+  useDirty,
+  useEditor,
+  useEditorStore,
+  useSlides,
+  useActiveSlide,
+  useActiveSlideId,
+  useSelection,
+  useSelectedElements,
+  useTheme,
+  useZoom,
+  usePlaying,
+  useHistory,
   type SlidewiseRootProps,
   type SlidewiseRootHandle,
+  type HistoryState,
   type SlidewiseHostCallbacks,
   type SlidewiseIcons,
   type RegionProps,
+  type TopBarProps,
+  type TopBarSlotId,
 } from "./compound";
 
 export { parsePptx, serializeDeck } from "./lib/pptx";