react-os-shell 0.1.15 → 0.1.18

package/dist/index.d.ts

@@ -426,6 +426,18 @@ declare function WindowManagerProvider({ children }: {
     children: ReactNode;
 }): react_jsx_runtime.JSX.Element;
 
+/**
+ * INTERNAL stub — Desktop's About modal references the consumer-side
+ * changelog. The package ships no built-in changelog; consumer wires their
+ * own through the eventual `branding` prop (TODO). Default = empty array
+ * keeps the import compiling.
+ */
+interface ChangelogEntry {
+    version: string;
+    date: string;
+    changes: string[];
+}
+
 interface DesktopItem {
     entityType: string;
     entityId: string;
@@ -460,6 +472,8 @@ interface DesktopHostConfig {
     /** Version string shown on the desktop watermark and About dialog. Falls
      *  back to the react-os-shell package version if omitted. */
     productVersion?: string;
+    /** Changelog rendered in the "What's New" dialog. Hidden when omitted. */
+    productChangelog?: ChangelogEntry[];
     /** Copyright line in the About dialog footer. Hidden when omitted. */
     productCopyright?: string;
     /** Website URL in the About dialog footer. Hidden when omitted. */
@@ -650,4 +664,4 @@ declare function useNewHotkey(callback: () => void): void;
  */
 declare function useEditHotkey(callback: (() => void) | null): void;
 
-export { ALT, ALT_SHIFT_D, ALT_SHIFT_E, ALT_SHIFT_N, type BugReport, type BugReportConfig, BugReportConfigProvider, BugReportDetail, BugReportProvider, type BugReportSubmission, type BugReportSubmitPayload, CMD_A, CMD_DOT, CMD_ENTER, CMD_K, CMD_S, CancelButton, ConfirmProvider, CopyButton, Customization, Desktop, type DesktopHostConfig, DesktopHostProvider, DocFavStar, ENTER, type EntityFetcher, GLASS_DIVIDER, GLASS_INPUT_BG, GlobalSearch, Layout, type LayoutProps, MOD, Modal, ModalActions, NotificationBell, type NotificationsConfig, PopupMenu, PopupMenuDivider, PopupMenuItem, PopupMenuLabel, SHIFT, type SearchConfig, type SearchProvider, type SearchResult, type SemanticGroup, type ShellAuth, ShellAuthProvider, ShellEntityFetcherProvider, type ShellNotification, type ShellPrefsAdapter, ShellPrefsProvider, ShortcutHelp, StartMenu, StatusBadge, StatusBadgeProvider, type StickyEntityRef, type StickyResolver, VERSION, WindowManagerProvider, WindowRegistry, WindowTitle, confirm, confirmDestructive, createWindowRegistry, formatDate, glassStyle, isMac, openBugReportDialog, reportBug, setShellApiClient, setShellAuthBridge, setShellNavIcons, toast, useBugReport, useClickOutside, useDesktopHost, useEditHotkey, useLocalStoragePrefs, useModalActive, useNewHotkey, useShellAuth, useShellEntityFetcher, useShellPrefs, useWidgetSettings, useWindowManager, useWindowMenuItem, useWindowTitle };
+export { ALT, ALT_SHIFT_D, ALT_SHIFT_E, ALT_SHIFT_N, type BugReport, type BugReportConfig, BugReportConfigProvider, BugReportDetail, BugReportProvider, type BugReportSubmission, type BugReportSubmitPayload, CMD_A, CMD_DOT, CMD_ENTER, CMD_K, CMD_S, CancelButton, type ChangelogEntry, ConfirmProvider, CopyButton, Customization, Desktop, type DesktopHostConfig, DesktopHostProvider, DocFavStar, ENTER, type EntityFetcher, GLASS_DIVIDER, GLASS_INPUT_BG, GlobalSearch, Layout, type LayoutProps, MOD, Modal, ModalActions, NotificationBell, type NotificationsConfig, PopupMenu, PopupMenuDivider, PopupMenuItem, PopupMenuLabel, SHIFT, type SearchConfig, type SearchProvider, type SearchResult, type SemanticGroup, type ShellAuth, ShellAuthProvider, ShellEntityFetcherProvider, type ShellNotification, type ShellPrefsAdapter, ShellPrefsProvider, ShortcutHelp, StartMenu, StatusBadge, StatusBadgeProvider, type StickyEntityRef, type StickyResolver, VERSION, WindowManagerProvider, WindowRegistry, WindowTitle, confirm, confirmDestructive, createWindowRegistry, formatDate, glassStyle, isMac, openBugReportDialog, reportBug, setShellApiClient, setShellAuthBridge, setShellNavIcons, toast, useBugReport, useClickOutside, useDesktopHost, useEditHotkey, useLocalStoragePrefs, useModalActive, useNewHotkey, useShellAuth, useShellEntityFetcher, useShellPrefs, useWidgetSettings, useWindowManager, useWindowMenuItem, useWindowTitle };

package/dist/index.js

@@ -7,8 +7,8 @@ import { toast_default } from './chunk-WIJ45SYD.js';
 export { toast_default as toast } from './chunk-WIJ45SYD.js';
 import { useShellPrefs } from './chunk-36VM54SC.js';
 export { ShellPrefsProvider, useLocalStoragePrefs, useShellPrefs } from './chunk-36VM54SC.js';
-import { useWindowManager, glassStyle, PopupMenu, PopupMenuLabel, PopupMenuDivider, PopupMenuItem, Modal, startMenuCategories, navSections, isSection, GLASS_INPUT_BG, navIcons, sectionIcons, ModalActions, useModalActive } from './chunk-XKN6O2JW.js';
-export { CancelButton, CopyButton, DocFavStar, GLASS_DIVIDER, GLASS_INPUT_BG, Modal, ModalActions, PopupMenu, PopupMenuDivider, PopupMenuItem, PopupMenuLabel, WindowManagerProvider, WindowTitle, glassStyle, isEntityEntry, isPageEntry, setShellApiClient, setShellNavIcons, setShellWindowRegistry, useModalActive, useWidgetSettings, useWindowManager, useWindowMenuItem, useWindowTitle } from './chunk-XKN6O2JW.js';
+import { useWindowManager, glassStyle, PopupMenu, PopupMenuLabel, PopupMenuDivider, PopupMenuItem, Modal, startMenuCategories, navSections, isSection, GLASS_INPUT_BG, navIcons, sectionIcons, ModalActions, useModalActive } from './chunk-AKZTZLKP.js';
+export { CancelButton, CopyButton, DocFavStar, GLASS_DIVIDER, GLASS_INPUT_BG, Modal, ModalActions, PopupMenu, PopupMenuDivider, PopupMenuItem, PopupMenuLabel, WindowManagerProvider, WindowTitle, glassStyle, isEntityEntry, isPageEntry, setShellApiClient, setShellNavIcons, setShellWindowRegistry, useModalActive, useWidgetSettings, useWindowManager, useWindowMenuItem, useWindowTitle } from './chunk-AKZTZLKP.js';
 export { ConfirmProvider, confirm, confirmDestructive } from './chunk-RFTLYCSF.js';
 import { createContext, useState, useRef, useEffect, useCallback, useLayoutEffect, useContext, isValidElement, cloneElement, useSyncExternalStore } from 'react';
 import { jsxs, jsx, Fragment } from 'react/jsx-runtime';
@@ -643,7 +643,7 @@ function StatusBadge({ status }) {
 }
 
 // src/version.ts
-var VERSION = "0.1.15" ;
+var VERSION = "0.1.18" ;
 var APP_VERSION = VERSION;
 
 // src/changelog.ts
@@ -1034,6 +1034,8 @@ function Desktop({ profile }) {
   const [editingStickyId, setEditingStickyId] = useState(null);
   const [stickyDrag, setStickyDrag] = useState(null);
   const [stickyResize, setStickyResize] = useState(null);
+  const [hoverFolderIdx, setHoverFolderIdx] = useState(null);
+  const hoverFolderIdxRef = useRef(null);
   const saveDocs = useCallback((docs) => {
     if (host.saveShortcuts) host.saveShortcuts(docs);
     else saveShellPrefs({ favorite_documents: docs });
@@ -1095,6 +1097,7 @@ function Desktop({ profile }) {
   useEffect(() => {
     if (!dragging) return;
     const entries = dragEntriesRef.current;
+    const isSingleItemDrag = entries.length === 1 && entries[0].type === "item";
     const move = (e) => {
       const dx = e.clientX - dragging.startX;
       const dy = e.clientY - dragging.startY;
@@ -1106,6 +1109,20 @@ function Desktop({ profile }) {
         entry.el.style.zIndex = "100";
         entry.el.style.opacity = "0.7";
       }
+      if (isSingleItemDrag) {
+        const elsBelow = document.elementsFromPoint(e.clientX, e.clientY);
+        let nextHover = null;
+        for (const el of elsBelow) {
+          const fk = el.closest?.('[data-desktop-icon^="folder-"]');
+          if (fk) {
+            const key = fk.getAttribute("data-desktop-icon");
+            if (key) nextHover = parseInt(key.slice(7), 10);
+            break;
+          }
+        }
+        hoverFolderIdxRef.current = nextHover;
+        setHoverFolderIdx((prev) => prev === nextHover ? prev : nextHover);
+      }
     };
     const up = (e) => {
       const dx = e.clientX - dragging.startX;
@@ -1115,6 +1132,10 @@ function Desktop({ profile }) {
         entry.el.style.zIndex = "";
         entry.el.style.opacity = "";
       }
+      const liveHoverIdx = hoverFolderIdxRef.current;
+      const hoveredFolder = liveHoverIdx != null ? folders[liveHoverIdx] : null;
+      hoverFolderIdxRef.current = null;
+      setHoverFolderIdx(null);
       const computedPositions = entries.map((entry) => {
         let finalRight = entry.origX - dx;
         let finalTop = Math.max(0, entry.origY + dy);
@@ -1131,7 +1152,7 @@ function Desktop({ profile }) {
         const updated = [...favDocs];
         const positionsPatch = {};
         const singleItem = itemMoves.length === 1 && entries.length === 1 ? itemMoves[0] : null;
-        const droppedOnFolder = singleItem ? folders.find((f, fi) => {
+        const droppedOnFolder = singleItem ? hoveredFolder ?? folders.find((f, fi) => {
           const fp = getFolderPos(f, fi);
           return Math.abs(singleItem.finalRight - fp.right) < 40 && Math.abs(singleItem.finalTop - fp.top) < 40;
         }) : void 0;
@@ -1275,8 +1296,11 @@ function Desktop({ profile }) {
   }, [contextMenu]);
   const createFolder = () => {
     const rect = containerRef.current?.getBoundingClientRect();
-    const x = contextMenu ? contextMenu.x - (rect?.left || 0) : 100;
-    const y = contextMenu ? contextMenu.y - (rect?.top || 0) : 100;
+    const containerW = rect?.width ?? 0;
+    const cursorLeft = contextMenu ? contextMenu.x - (rect?.left ?? 0) : containerW - 100;
+    const cursorTop = contextMenu ? contextMenu.y - (rect?.top ?? 0) : 100;
+    const x = Math.max(0, containerW - cursorLeft - 40);
+    const y = Math.max(0, cursorTop - 20);
     const id = `folder-${Date.now()}`;
     saveFolders([...folders, { id, name: "New Folder", x, y }]);
     setContextMenu(null);
@@ -1506,12 +1530,20 @@ function Desktop({ profile }) {
         folders.map((folder, i) => {
           const pos = localPositions[`folder-${i}`] || getFolderPos(folder, i);
           const isSelected = selected.has(`folder-${i}`);
+          const isHovered = hoverFolderIdx === i;
           const itemCount = folderItems(folder.id).length;
           return /* @__PURE__ */ jsx(
             "div",
             {
               "data-desktop-icon": `folder-${i}`,
-              style: { position: "absolute", right: pos.right, top: pos.top, zIndex: 1 },
+              style: {
+                position: "absolute",
+                right: pos.right,
+                top: pos.top,
+                zIndex: 1,
+                transform: isHovered ? "scale(1.15)" : "scale(1)",
+                transition: "transform 180ms ease-out"
+              },
               onPointerDown: (e) => {
                 e.stopPropagation();
                 startDrag("folder", i, e);
@@ -1535,7 +1567,7 @@ function Desktop({ profile }) {
               },
               className: "cursor-default select-none",
               children: /* @__PURE__ */ jsxs("div", { className: "flex flex-col items-center gap-1 w-20 p-2", children: [
-                /* @__PURE__ */ jsx("div", { className: `w-12 h-12 flex items-center justify-center ${isSelected ? "rounded-lg bg-blue-400/30 ring-2 ring-blue-500" : ""}`, children: /* @__PURE__ */ jsxs("svg", { className: "h-12 w-12 drop-shadow-[0_2px_3px_rgba(0,0,0,0.3)]", viewBox: "0 0 48 48", children: [
+                /* @__PURE__ */ jsx("div", { className: `w-12 h-12 flex items-center justify-center ${isSelected ? "rounded-lg bg-blue-400/30 ring-2 ring-blue-500" : ""} ${isHovered ? "rounded-lg ring-4 ring-amber-400 shadow-[0_0_20px_rgba(245,158,11,0.6)]" : ""}`, children: /* @__PURE__ */ jsxs("svg", { className: "h-12 w-12 drop-shadow-[0_2px_3px_rgba(0,0,0,0.3)]", viewBox: "0 0 48 48", children: [
                   /* @__PURE__ */ jsx("path", { d: "M6 12a4 4 0 014-4h10l4 4h14a4 4 0 014 4v20a4 4 0 01-4 4H10a4 4 0 01-4-4V12z", fill: "white", stroke: "#eab308", strokeWidth: "2", strokeLinejoin: "round" }),
                   /* @__PURE__ */ jsx("path", { d: "M6 18h36", stroke: "#eab308", strokeWidth: "1.5" })
                 ] }) }),
@@ -1847,7 +1879,7 @@ function Desktop({ profile }) {
             ] })
           ] }) });
         })(),
-        (prefs.show_desktop_version ?? true) && (host.productVersion ?? APP_VERSION) && /* @__PURE__ */ jsx(
+        prefs.show_desktop_version === true && (host.productVersion ?? APP_VERSION) && /* @__PURE__ */ jsx(
           "button",
           {
             onClick: (e) => {
@@ -1858,17 +1890,20 @@ function Desktop({ profile }) {
             children: host.productVersion ?? APP_VERSION
           }
         ),
-        whatsNewOpen && /* @__PURE__ */ jsx(Modal, { open: true, onClose: () => setWhatsNewOpen(false), title: "What's New", size: "md", bodyScroll: false, children: /* @__PURE__ */ jsx("div", { className: "space-y-5 max-h-[60vh] overflow-y-auto px-1", children: changelog_default.map((entry, i) => /* @__PURE__ */ jsxs("div", { children: [
-          /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-3 mb-2", children: [
-            /* @__PURE__ */ jsx("span", { className: "text-sm font-bold text-gray-900 font-mono", children: entry.version }),
-            /* @__PURE__ */ jsx("span", { className: "text-xs text-gray-400", children: formatDate(entry.date) })
-          ] }),
-          /* @__PURE__ */ jsx("ul", { className: "space-y-1.5 ml-1", children: entry.changes.map((change, j) => /* @__PURE__ */ jsxs("li", { className: "flex items-start gap-2 text-sm text-gray-600", children: [
-            /* @__PURE__ */ jsx("span", { className: "text-blue-500 mt-1 shrink-0", children: "\u2022" }),
-            change
-          ] }, j)) }),
-          i < changelog_default.length - 1 && /* @__PURE__ */ jsx("div", { className: "border-b border-gray-200 mt-4" })
-        ] }, entry.version)) }) })
+        whatsNewOpen && (() => {
+          const entries = host.productChangelog ?? changelog_default;
+          return /* @__PURE__ */ jsx(Modal, { open: true, onClose: () => setWhatsNewOpen(false), title: "What's New", size: "md", bodyScroll: false, children: /* @__PURE__ */ jsx("div", { className: "space-y-5 max-h-[60vh] overflow-y-auto px-1", children: entries.length === 0 ? /* @__PURE__ */ jsx("p", { className: "text-sm text-gray-400 text-center py-6", children: "No changelog available." }) : entries.map((entry, i) => /* @__PURE__ */ jsxs("div", { children: [
+            /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-3 mb-2", children: [
+              /* @__PURE__ */ jsx("span", { className: "text-sm font-bold text-gray-900 font-mono", children: entry.version }),
+              /* @__PURE__ */ jsx("span", { className: "text-xs text-gray-400", children: formatDate(entry.date) })
+            ] }),
+            /* @__PURE__ */ jsx("ul", { className: "space-y-1.5 ml-1", children: entry.changes.map((change, j) => /* @__PURE__ */ jsxs("li", { className: "flex items-start gap-2 text-sm text-gray-600", children: [
+              /* @__PURE__ */ jsx("span", { className: "text-blue-500 mt-1 shrink-0", children: "\u2022" }),
+              change
+            ] }, j)) }),
+            i < entries.length - 1 && /* @__PURE__ */ jsx("div", { className: "border-b border-gray-200 mt-4" })
+          ] }, entry.version)) }) });
+        })()
       ]
     }
   );