@textcortex/slidewise 1.2.0 → 1.3.0

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,12 +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";

package/src/components/editor/TopBar.tsx

@@ -1,253 +0,0 @@
-import {
-  Undo2,
-  Redo2,
-  Save,
-  Play,
-  Download,
-  Sparkles,
-  Sun,
-  Moon,
-} from "lucide-react";
-import { useEditor, useEditorStore } from "@/lib/StoreProvider";
-import { useState, type ReactNode } from "react";
-import type { Deck } from "@/lib/types";
-import { useIcons } from "@/compound/IconContext";
-import { useReadOnly } from "@/compound/ReadOnlyContext";
-
-interface TopBarProps {
-  onSave?: (deck: Deck) => void | Promise<void>;
-  onExport?: (deck: Deck) => void;
-}
-
-export function TopBar({ onSave: onSaveProp, onExport: onExportProp }: TopBarProps = {}) {
-  const store = useEditorStore();
-  const title = useEditor((s) => s.deck.title);
-  const setTitle = useEditor((s) => s.setTitle);
-  const undo = useEditor((s) => s.undo);
-  const redo = useEditor((s) => s.redo);
-  const play = useEditor((s) => s.play);
-  const theme = useEditor((s) => s.theme);
-  const toggleTheme = useEditor((s) => s.toggleTheme);
-  const icons = useIcons();
-  const readOnly = useReadOnly();
-  const [saved, setSaved] = useState<"idle" | "saving" | "saved">("idle");
-
-  const onSave = async () => {
-    setSaved("saving");
-    const deck = store.getState().deck;
-    try {
-      if (onSaveProp) {
-        await onSaveProp(deck);
-      } else {
-        try {
-          localStorage.setItem("slidewise-deck", JSON.stringify(deck));
-        } catch {}
-      }
-      setTimeout(() => setSaved("saved"), 320);
-      setTimeout(() => setSaved("idle"), 1600);
-    } catch {
-      setSaved("idle");
-    }
-  };
-
-  const onExport = () => {
-    const deck = store.getState().deck;
-    if (onExportProp) {
-      onExportProp(deck);
-      return;
-    }
-    const blob = new Blob([JSON.stringify(deck, null, 2)], {
-      type: "application/json",
-    });
-    const url = URL.createObjectURL(blob);
-    const a = document.createElement("a");
-    a.href = url;
-    a.download = `${(deck.title || "deck").replace(/[^a-z0-9-_]+/gi, "-")}.slidewise.json`;
-    a.click();
-    URL.revokeObjectURL(url);
-  };
-
-  return (
-    <div
-      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)",
-      }}
-    >
-      {!readOnly && (
-        <>
-          <IconBtn onClick={undo} title="Undo">
-            {icons.undo ?? <Undo2 size={16} />}
-          </IconBtn>
-          <IconBtn onClick={redo} title="Redo">
-            {icons.redo ?? <Redo2 size={16} />}
-          </IconBtn>
-        </>
-      )}
-
-      <div
-        style={{
-          flex: 1,
-          display: "flex",
-          alignItems: "center",
-          justifyContent: "center",
-          gap: 8,
-          minWidth: 0,
-        }}
-      >
-        <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>
-
-      <IconBtn
-        onClick={toggleTheme}
-        title={theme === "dark" ? "Light mode" : "Dark mode"}
-      >
-        {theme === "dark"
-          ? (icons.themeLight ?? <Sun size={16} />)
-          : (icons.themeDark ?? <Moon size={16} />)}
-      </IconBtn>
-
-      {!readOnly && (
-        <button
-          onClick={onSave}
-          style={chromeBtnStyle()}
-          onMouseEnter={(e) => (e.currentTarget.style.background = "var(--hover)")}
-          onMouseLeave={(e) => (e.currentTarget.style.background = "transparent")}
-        >
-          {icons.save ?? <Save size={14} />}
-          {saved === "saving" ? "Saving…" : saved === "saved" ? "Saved" : "Save"}
-        </button>
-      )}
-
-      <button
-        onClick={play}
-        style={chromeBtnStyle()}
-        onMouseEnter={(e) => (e.currentTarget.style.background = "var(--hover)")}
-        onMouseLeave={(e) => (e.currentTarget.style.background = "transparent")}
-      >
-        {icons.play ?? <Play size={14} />}
-        Play
-      </button>
-
-      <button
-        onClick={onExport}
-        style={{
-          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,
-        }}
-        onMouseEnter={(e) =>
-          (e.currentTarget.style.background = "var(--primary-bg-hover)")
-        }
-        onMouseLeave={(e) =>
-          (e.currentTarget.style.background = "var(--primary-bg)")
-        }
-      >
-        {icons.export ?? <Download size={14} />}
-        Export
-      </button>
-    </div>
-  );
-}
-
-function chromeBtnStyle(): React.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,
-  };
-}
-
-function IconBtn({
-  children,
-  onClick,
-  title,
-}: {
-  children: ReactNode;
-  onClick: () => void;
-  title: string;
-}) {
-  return (
-    <button
-      title={title}
-      aria-label={title}
-      onClick={onClick}
-      style={{
-        width: 32,
-        height: 32,
-        borderRadius: 8,
-        border: "none",
-        background: "transparent",
-        cursor: "pointer",
-        display: "flex",
-        alignItems: "center",
-        justifyContent: "center",
-        color: "var(--ink)",
-      }}
-      onMouseEnter={(e) => (e.currentTarget.style.background = "var(--hover)")}
-      onMouseLeave={(e) => (e.currentTarget.style.background = "transparent")}
-    >
-      {children}
-    </button>
-  );
-}