@floegence/floe-webapp-core 0.54.1 → 0.55.0

package/dist/full.js

@@ -142,38 +142,39 @@ import { WidgetTypeSwitcher as Df } from "./components/deck/WidgetTypeSwitcher.j
 import { WorkingIndicator as yf } from "./components/chat/status/WorkingIndicator.js";
 import { applyDragDelta as Bf, applyResizeDelta as Mf, getGridCellSize as Of, pixelDeltaToGridDelta as Wf, positionToGridArea as Nf, snapToGrid as bf } from "./utils/gridLayout.js";
 import { buildAssistantNoticeEvents as Uf, createStreamEventBuilder as Hf, isStreamEvent as Gf } from "./components/chat/streamEvents.js";
-import { checkCollision as Kf, constrainPosition as zf, findFreePosition as Xf, hasCollision as Zf, sameGridPosition as Qf } from "./utils/gridCollision.js";
-import { classifyArchiveFileName as qf } from "./components/file-browser/archiveFiles.js";
-import { clientToCanvasLocal as Jf, clientToCanvasWorld as $f, createViewportFromZoomAnchor as ed, isPointInsideCanvasRect as od, localToCanvasWorld as rd } from "./components/ui/canvasGeometry.js";
-import { cn as id } from "./utils/cn.js";
-import { computeCodeDiff as ad, computeCodeDiffSync as cd, configureDiffWorker as ld, createDiffWorker as md, hasDiffWorker as sd, terminateDiffWorker as pd, waitForDiffWorker as fd } from "./components/chat/hooks/useCodeDiff.js";
-import { configureMarkdownWorker as Td, createMarkdownWorker as Sd, hasMarkdownWorker as Id, renderMarkdown as xd, renderMarkdownSync as Cd, terminateMarkdownWorker as ud, waitForMarkdownWorker as gd } from "./components/chat/hooks/useMarkdown.js";
-import { configureMermaidWorker as kd, configureSyncMermaid as Fd, renderMermaid as Ed, terminateMermaidWorker as Pd, useMermaid as Ad } from "./components/chat/hooks/useMermaid.js";
-import { configureShikiWorker as _d, configureSyncHighlighter as Dd, highlightCode as Rd, terminateShikiWorker as yd, useCodeHighlight as vd } from "./components/chat/hooks/useCodeHighlight.js";
-import { createFloatingPresence as Md } from "./components/ui/floatingPresence.js";
-import { createLongPressContextMenuHandlers as Wd } from "./components/file-browser/longPressContextMenu.js";
-import { createSimpleContext as bd } from "./context/createSimpleContext.js";
-import { createUIFirstSelection as Ud } from "./utils/uiFirstSelection.js";
-import { deferAfterPaint as Gd, deferNonBlocking as Vd } from "./utils/defer.js";
-import { duration as zd, easing as Xd, fadeIn as Zd, listContainer as Qd, listItem as Yd, panelResize as qd, popIn as jd, scaleIn as Jd, sidebarVariants as $d, slideInFromBottom as eT, slideInFromLeft as oT, slideInFromRight as rT, slideInFromTop as tT, springConfig as iT } from "./utils/animations.js";
-import { formatKeybind as aT, isMacLikePlatform as cT, isPrimaryModKeyPressed as lT, matchKeybind as mT, parseKeybind as sT } from "./utils/keybind.js";
-import { intersectSurfaceRects as fT } from "./components/ui/surfaceFloatingBoundary.js";
-import { isTypingElement as TT, shouldIgnoreHotkeys as ST } from "./utils/dom.js";
-import { lockBodyStyle as xT } from "./utils/bodyStyleLock.js";
-import { registerCommandContributions as uT, useCommandContributions as gT } from "./hooks/useCommandContributions.js";
-import { resolveFloatingWindowViewport as kT } from "./components/ui/floatingWindowGeometry.js";
-import { secureRandomUUID as ET } from "./utils/secureRandom.js";
-import { startPointerSession as AT } from "./components/ui/pointerSession.js";
-import { useAttachments as _T } from "./components/chat/hooks/useAttachments.js";
-import { useAutoScroll as RT } from "./components/chat/hooks/useAutoScroll.js";
-import { useDebounce as vT } from "./hooks/useDebounce.js";
-import { useDeckDrag as MT } from "./hooks/useDeckDrag.js";
-import { useFileBrowserDropTarget as WT, useFileBrowserItemDrag as NT } from "./hooks/useFileBrowserDrag.js";
-import { useKeybind as wT } from "./hooks/useKeybind.js";
-import { useMediaQuery as HT } from "./hooks/useMediaQuery.js";
-import { usePersisted as VT } from "./hooks/usePersisted.js";
-import { useResizeObserver as zT } from "./hooks/useResizeObserver.js";
-import { useVirtualList as ZT } from "./components/chat/hooks/useVirtualList.js";
+import { calculateFitScale as Kf } from "./utils/fitScale.js";
+import { checkCollision as Xf, constrainPosition as Zf, findFreePosition as Qf, hasCollision as Yf, sameGridPosition as qf } from "./utils/gridCollision.js";
+import { classifyArchiveFileName as Jf } from "./components/file-browser/archiveFiles.js";
+import { clientToCanvasLocal as ed, clientToCanvasWorld as od, createViewportFromZoomAnchor as rd, isPointInsideCanvasRect as td, localToCanvasWorld as id } from "./components/ui/canvasGeometry.js";
+import { cn as ad } from "./utils/cn.js";
+import { computeCodeDiff as ld, computeCodeDiffSync as md, configureDiffWorker as sd, createDiffWorker as pd, hasDiffWorker as fd, terminateDiffWorker as dd, waitForDiffWorker as Td } from "./components/chat/hooks/useCodeDiff.js";
+import { configureMarkdownWorker as Id, createMarkdownWorker as xd, hasMarkdownWorker as Cd, renderMarkdown as ud, renderMarkdownSync as gd, terminateMarkdownWorker as hd, waitForMarkdownWorker as kd } from "./components/chat/hooks/useMarkdown.js";
+import { configureMermaidWorker as Ed, configureSyncMermaid as Pd, renderMermaid as Ad, terminateMermaidWorker as Ld, useMermaid as _d } from "./components/chat/hooks/useMermaid.js";
+import { configureShikiWorker as Rd, configureSyncHighlighter as yd, highlightCode as vd, terminateShikiWorker as Bd, useCodeHighlight as Md } from "./components/chat/hooks/useCodeHighlight.js";
+import { createFloatingPresence as Wd } from "./components/ui/floatingPresence.js";
+import { createLongPressContextMenuHandlers as bd } from "./components/file-browser/longPressContextMenu.js";
+import { createSimpleContext as Ud } from "./context/createSimpleContext.js";
+import { createUIFirstSelection as Gd } from "./utils/uiFirstSelection.js";
+import { deferAfterPaint as Kd, deferNonBlocking as zd } from "./utils/defer.js";
+import { duration as Zd, easing as Qd, fadeIn as Yd, listContainer as qd, listItem as jd, panelResize as Jd, popIn as $d, scaleIn as eT, sidebarVariants as oT, slideInFromBottom as rT, slideInFromLeft as tT, slideInFromRight as iT, slideInFromTop as nT, springConfig as aT } from "./utils/animations.js";
+import { formatKeybind as lT, isMacLikePlatform as mT, isPrimaryModKeyPressed as sT, matchKeybind as pT, parseKeybind as fT } from "./utils/keybind.js";
+import { intersectSurfaceRects as TT } from "./components/ui/surfaceFloatingBoundary.js";
+import { isTypingElement as IT, shouldIgnoreHotkeys as xT } from "./utils/dom.js";
+import { lockBodyStyle as uT } from "./utils/bodyStyleLock.js";
+import { registerCommandContributions as hT, useCommandContributions as kT } from "./hooks/useCommandContributions.js";
+import { resolveFloatingWindowViewport as ET } from "./components/ui/floatingWindowGeometry.js";
+import { secureRandomUUID as AT } from "./utils/secureRandom.js";
+import { startPointerSession as _T } from "./components/ui/pointerSession.js";
+import { useAttachments as RT } from "./components/chat/hooks/useAttachments.js";
+import { useAutoScroll as vT } from "./components/chat/hooks/useAutoScroll.js";
+import { useDebounce as MT } from "./hooks/useDebounce.js";
+import { useDeckDrag as WT } from "./hooks/useDeckDrag.js";
+import { useFileBrowserDropTarget as bT, useFileBrowserItemDrag as wT } from "./hooks/useFileBrowserDrag.js";
+import { useKeybind as HT } from "./hooks/useKeybind.js";
+import { useMediaQuery as VT } from "./hooks/useMediaQuery.js";
+import { usePersisted as zT } from "./hooks/usePersisted.js";
+import { useResizeObserver as ZT } from "./hooks/useResizeObserver.js";
+import { useVirtualList as YT } from "./components/chat/hooks/useVirtualList.js";
 export {
   _ as Activity,
   Zt as ActivityAppsMain,
@@ -639,37 +640,38 @@ export {
   Uf as buildAssistantNoticeEvents,
   Xi as builtInShellThemePresets,
   c as builtInThemes,
+  Kf as calculateFitScale,
   es as centerViewportOnWorldPoint,
-  Kf as checkCollision,
+  Xf as checkCollision,
   os as clampScale,
   It as clampTerminalCursor,
-  qf as classifyArchiveFileName,
-  Jf as clientToCanvasLocal,
-  $f as clientToCanvasWorld,
-  id as cn,
+  Jf as classifyArchiveFileName,
+  ed as clientToCanvasLocal,
+  od as clientToCanvasWorld,
+  ad as cn,
   rs as computeBoardBounds,
-  ad as computeCodeDiff,
-  cd as computeCodeDiffSync,
-  ld as configureDiffWorker,
-  Td as configureMarkdownWorker,
-  kd as configureMermaidWorker,
-  _d as configureShikiWorker,
-  Dd as configureSyncHighlighter,
-  Fd as configureSyncMermaid,
-  zf as constrainPosition,
+  ld as computeCodeDiff,
+  md as computeCodeDiffSync,
+  sd as configureDiffWorker,
+  Id as configureMarkdownWorker,
+  Ed as configureMermaidWorker,
+  Rd as configureShikiWorker,
+  yd as configureSyncHighlighter,
+  Pd as configureSyncMermaid,
+  Zf as constrainPosition,
   oa as createCommandService,
   na as createComponentRegistry,
   Za as createDeckService,
   ts as createDefaultNotesSnapshot,
-  md as createDiffWorker,
+  pd as createDiffWorker,
   Hs as createFilesystemPickerDataSource,
-  Md as createFloatingPresence,
+  Wd as createFloatingPresence,
   sm as createLayoutService,
-  Wd as createLongPressContextMenuHandlers,
-  Sd as createMarkdownWorker,
+  bd as createLongPressContextMenuHandlers,
+  xd as createMarkdownWorker,
   ys as createNotificationService,
   Zi as createShellThemePreset,
-  bd as createSimpleContext,
+  Ud as createSimpleContext,
   Hf as createStreamEventBuilder,
   xt as createTerminalEditorState,
   Wt as createTerminalFullLineSuggestion,
@@ -677,19 +679,19 @@ export {
   Nt as createTerminalTokenSuggestion,
   Kp as createTerminalWidget,
   Yp as createThemeService,
-  Ud as createUIFirstSelection,
-  ed as createViewportFromZoomAnchor,
+  Gd as createUIFirstSelection,
+  rd as createViewportFromZoomAnchor,
   uf as createWidgetRegistry,
-  Gd as deferAfterPaint,
-  Vd as deferNonBlocking,
+  Kd as deferAfterPaint,
+  zd as deferNonBlocking,
   Ct as deleteTerminalTextBackward,
   Pt as dispatchTerminalSessionKey,
-  zd as duration,
-  Xd as easing,
+  Zd as duration,
+  Qd as easing,
   ya as ensureSurfacePortalInteractionTracking,
   zm as estimateNotesContextMenuHeight,
-  Zd as fadeIn,
-  Xf as findFreePosition,
+  Yd as fadeIn,
+  Qf as findFreePosition,
   I as floeColorTokenCategories,
   x as floeDesignTokens,
   C as floeFontFamilyTokens,
@@ -701,7 +703,7 @@ export {
   E as floeThemeColorVariables,
   P as floeTypographyTokens,
   Cm as focusMenuItem,
-  aT as formatKeybind,
+  lT as formatKeybind,
   Gs as formatPickerPath,
   vi as getFileIcon,
   A as getFloeColorTokenValue,
@@ -715,28 +717,28 @@ export {
   bt as getTerminalSuggestions,
   is as groupTrashItems,
   gm as handleMenuKeyboardNavigation,
-  Zf as hasCollision,
+  Yf as hasCollision,
   aa as hasComponentRegistryContext,
-  sd as hasDiffWorker,
+  fd as hasDiffWorker,
   jc as hasFileBrowserDragContext,
-  Id as hasMarkdownWorker,
-  Rd as highlightCode,
+  Cd as hasMarkdownWorker,
+  vd as highlightCode,
   ut as insertTerminalText,
-  fT as intersectSurfaceRects,
+  TT as intersectSurfaceRects,
   m as isFloeSurfaceStyle,
   kn as isLocalInteractionSurfaceTarget,
-  cT as isMacLikePlatform,
-  od as isPointInsideCanvasRect,
-  lT as isPrimaryModKeyPressed,
+  mT as isMacLikePlatform,
+  td as isPointInsideCanvasRect,
+  sT as isPrimaryModKeyPressed,
   Gf as isStreamEvent,
   va as isSurfacePortalMode,
   s as isThemeType,
-  TT as isTypingElement,
-  Qd as listContainer,
-  Yd as listItem,
-  rd as localToCanvasWorld,
-  xT as lockBodyStyle,
-  mT as matchKeybind,
+  IT as isTypingElement,
+  qd as listContainer,
+  jd as listItem,
+  id as localToCanvasWorld,
+  uT as lockBodyStyle,
+  pT as matchKeybind,
   wt as matchesTerminalSuggestionPrefix,
   ns as mergeBoardBounds,
   p as mergeThemeTokenMaps,
@@ -749,29 +751,29 @@ export {
   Yi as normalizeShellThemeSelection,
   Tt as normalizeTerminalWorkspaceProfile,
   ls as noteBucketMetrics,
-  qd as panelResize,
-  sT as parseKeybind,
+  Jd as panelResize,
+  fT as parseKeybind,
   Vs as parsePickerPath,
   Ut as parseTerminalSuggestionContext,
   Wf as pixelDeltaToGridDelta,
-  jd as popIn,
+  $d as popIn,
   Nf as positionToGridArea,
   qi as presetSupportsMode,
   Ba as projectSurfacePortalPosition,
   Ma as projectSurfacePortalRect,
   ms as promoteLocalItem,
-  uT as registerCommandContributions,
+  hT as registerCommandContributions,
   ss as removeSnapshotItem,
   ps as removeSnapshotTopic,
   fs as removeSnapshotTrashItem,
-  xd as renderMarkdown,
-  Cd as renderMarkdownSync,
-  Ed as renderMermaid,
+  ud as renderMarkdown,
+  gd as renderMarkdownSync,
+  Ad as renderMermaid,
   ds as replaceSnapshotItem,
   Ts as replaceSnapshotTopic,
   Ss as replaceSnapshotTrashItem,
   Bi as resolveFileItemIcon,
-  kT as resolveFloatingWindowViewport,
+  ET as resolveFloatingWindowViewport,
   ji as resolveShellThemePresetName,
   Fn as resolveSurfaceInteractionTargetRole,
   Oa as resolveSurfacePortalBoundaryRect,
@@ -785,23 +787,23 @@ export {
   An as resolveWorkbenchWidgetLocalTypingTarget,
   Ln as resolveWorkbenchWidgetTextSelectionTarget,
   yt as runTerminalMockCommand,
-  Qf as sameGridPosition,
+  qf as sameGridPosition,
   mc as sanitizeDisplayMode,
-  Jd as scaleIn,
+  eT as scaleIn,
   Is as screenToWorld,
-  ET as secureRandomUUID,
+  AT as secureRandomUUID,
   _t as setTerminalSessionInputValue,
   _n as shouldActivateWorkbenchWidgetLocalTarget,
-  ST as shouldIgnoreHotkeys,
-  $d as sidebarVariants,
-  eT as slideInFromBottom,
-  oT as slideInFromLeft,
-  rT as slideInFromRight,
-  tT as slideInFromTop,
+  xT as shouldIgnoreHotkeys,
+  oT as sidebarVariants,
+  rT as slideInFromBottom,
+  tT as slideInFromLeft,
+  iT as slideInFromRight,
+  nT as slideInFromTop,
   bf as snapToGrid,
-  iT as springConfig,
+  aT as springConfig,
   Gc as startHotInteraction,
-  AT as startPointerSession,
+  _T as startPointerSession,
   Dt as submitTerminalSession,
   T as syncThemeTokenOverrides,
   Ht as terminalCommandTokenSuggestionProvider,
@@ -809,48 +811,48 @@ export {
   Vt as terminalPathSuggestionProvider,
   Kt as terminalRootSuggestionProvider,
   zt as terminalSnippetSuggestionProvider,
-  pd as terminateDiffWorker,
-  ud as terminateMarkdownWorker,
-  Pd as terminateMermaidWorker,
-  yd as terminateShikiWorker,
+  dd as terminateDiffWorker,
+  hd as terminateMarkdownWorker,
+  Ld as terminateMermaidWorker,
+  Bd as terminateShikiWorker,
   Sl as updateFileOpenSelection,
-  _T as useAttachments,
-  RT as useAutoScroll,
+  RT as useAttachments,
+  vT as useAutoScroll,
   On as useChatContext,
-  vd as useCodeHighlight,
+  Md as useCodeHighlight,
   ra as useCommand,
-  gT as useCommandContributions,
+  kT as useCommandContributions,
   ca as useComponentContextFactory,
   la as useComponentRegistry,
   Pf as useCurrentWidgetId,
-  vT as useDebounce,
+  MT as useDebounce,
   Qa as useDeck,
-  MT as useDeckDrag,
+  WT as useDeckDrag,
   ol as useFileBrowser,
   Jc as useFileBrowserDrag,
-  WT as useFileBrowserDropTarget,
-  NT as useFileBrowserItemDrag,
+  bT as useFileBrowserDropTarget,
+  wT as useFileBrowserItemDrag,
   ha as useFloeConfig,
   Vl as useFormSubmitting,
-  wT as useKeybind,
+  HT as useKeybind,
   pm as useLayout,
-  HT as useMediaQuery,
-  Ad as useMermaid,
+  VT as useMediaQuery,
+  _d as useMermaid,
   vs as useNotification,
   ma as useOptionalComponentRegistry,
-  VT as usePersisted,
-  zT as useResizeObserver,
+  zT as usePersisted,
+  ZT as useResizeObserver,
   ka as useResolvedFloeConfig,
   qp as useTheme,
   sf as useViewActivation,
-  ZT as useVirtualList,
+  YT as useVirtualList,
   gf as useWidgetRegistry,
   Af as useWidgetState,
   Lf as useWidgetStateContext,
   Ep as useWizard,
   xs as visibleWorldRect,
-  fd as waitForDiffWorker,
-  gd as waitForMarkdownWorker,
+  Td as waitForDiffWorker,
+  kd as waitForMarkdownWorker,
   Cs as worldToScreen,
   us as zoomViewportAtPoint
 };

package/dist/hooks/useResizeObserver.d.ts

@@ -4,6 +4,7 @@ export interface Size {
     height: number;
 }
 /**
- * Track element dimensions
+ * Track the usable content box in local CSS pixels, excluding padding and
+ * scrollbars. CSS transforms on the element or its ancestors do not affect it.
  */
 export declare function useResizeObserver(element: Accessor<HTMLElement | null | undefined>): Accessor<Size | null>;

package/dist/hooks/useResizeObserver.js

@@ -1,25 +1,29 @@
-import { createSignal as h, createEffect as g, onCleanup as s } from "solid-js";
-function w(c) {
-  const [d, n] = h(null);
-  return g(() => {
-    const e = c();
-    if (!e) return;
-    const r = e.getBoundingClientRect();
-    if (n({ width: r.width, height: r.height }), typeof ResizeObserver > "u") {
-      const t = () => n({ width: e.getBoundingClientRect().width, height: e.getBoundingClientRect().height });
-      typeof window < "u" && (window.addEventListener("resize", t), s(() => window.removeEventListener("resize", t)));
+import { createSignal as u, createEffect as h, onCleanup as s } from "solid-js";
+function f(d) {
+  const [a, r] = u(null, {
+    equals: (e, t) => e?.width === t?.width && e?.height === t?.height
+  });
+  return h(() => {
+    const e = d();
+    if (!e) {
+      r(null);
       return;
     }
-    const o = new ResizeObserver((t) => {
-      const i = t[0];
-      i && n({
-        width: i.contentRect.width,
-        height: i.contentRect.height
+    const t = () => {
+      const n = e.ownerDocument.defaultView.getComputedStyle(e), i = (c) => Number.parseFloat(c) || 0;
+      r({
+        width: Math.max(0, e.clientWidth - i(n.paddingLeft) - i(n.paddingRight)),
+        height: Math.max(0, e.clientHeight - i(n.paddingTop) - i(n.paddingBottom))
       });
-    });
+    };
+    if (t(), typeof ResizeObserver > "u") {
+      typeof window < "u" && (window.addEventListener("resize", t), s(() => window.removeEventListener("resize", t)));
+      return;
+    }
+    const o = new ResizeObserver(t);
     o.observe(e), s(() => o.disconnect());
-  }), d;
+  }), a;
 }
 export {
-  w as useResizeObserver
+  f as useResizeObserver
 };

package/dist/index.js

@@ -1,5 +1,5 @@
 import { FloeProvider as r } from "./app/FloeProvider.js";
-import { applyShellThemeAttribute as i, applySurfaceStyleAttribute as s, applyTheme as n, builtInThemes as a, getSystemTheme as m, isFloeSurfaceStyle as l, isThemeType as p, mergeThemeTokenMaps as f, resolveThemeTokenOverrides as d, resolveThemeTokens as T, syncThemeTokenOverrides as u } from "./styles/themes/index.js";
+import { applyShellThemeAttribute as i, applySurfaceStyleAttribute as s, applyTheme as n, builtInThemes as a, getSystemTheme as m, isFloeSurfaceStyle as l, isThemeType as p, mergeThemeTokenMaps as f, resolveThemeTokenOverrides as d, resolveThemeTokens as T, syncThemeTokenOverrides as c } from "./styles/themes/index.js";
 import { floeColorTokenCategories as g, floeDesignTokens as x, floeFontFamilyTokens as y, floeMotionTokens as C, floeRadiusTokens as h, floeSharedCssVariables as S, floeSpacingTokens as F, floeSurfaceTokens as v, floeThemeColorVariables as P, floeTypographyTokens as k, getFloeColorTokenValue as I } from "./styles/tokens.js";
 import { BUILT_IN_SHELL_THEME_DEFAULTS as D, REQUIRED_SHELL_THEME_TOKENS as E, assertUniqueThemePresetNames as b, builtInShellThemePresets as L, createShellThemePreset as _, getShellThemePresetsForMode as A, normalizeShellThemeSelection as N, presetSupportsMode as O, resolveShellThemePresetName as M } from "./styles/themes/presets.js";
 import { CommandProvider as U, createCommandService as w, useCommand as G } from "./context/CommandContext.js";
@@ -8,31 +8,32 @@ import { DEFAULT_FLOE_CONFIG as j, FloeConfigProvider as J, useFloeConfig as X,
 import { DeckProvider as ee, createDeckService as oe, useDeck as re } from "./context/DeckContext.js";
 import { FLOE_GEOMETRY_SURFACE_ATTR as ie, FLOE_HOT_INTERACTION_ATTR as se, startHotInteraction as ne } from "./utils/hotInteraction.js";
 import { FileBrowserDragProvider as me, hasFileBrowserDragContext as le, useFileBrowserDrag as pe } from "./context/FileBrowserDragContext.js";
-import { LayoutProvider as de, createLayoutService as Te, useLayout as ue } from "./context/LayoutContext.js";
+import { LayoutProvider as de, createLayoutService as Te, useLayout as ce } from "./context/LayoutContext.js";
 import { NotificationContainer as ge, NotificationProvider as xe, createNotificationService as ye, useNotification as Ce } from "./context/NotificationContext.js";
 import { ThemeProvider as Se, createThemeService as Fe, useTheme as ve } from "./context/ThemeContext.js";
 import { ViewActivationProvider as ke, useViewActivation as Ie } from "./context/ViewActivationContext.js";
 import { WidgetRegistryProvider as De, createWidgetRegistry as Ee, useWidgetRegistry as be } from "./context/WidgetRegistry.js";
 import { WidgetStateProvider as _e, useCurrentWidgetId as Ae, useWidgetState as Ne, useWidgetStateContext as Oe } from "./context/WidgetStateContext.js";
 import { applyDragDelta as Be, applyResizeDelta as Ue, getGridCellSize as we, pixelDeltaToGridDelta as Ge, positionToGridArea as He, snapToGrid as We } from "./utils/gridLayout.js";
-import { checkCollision as Ve, constrainPosition as ze, findFreePosition as Qe, hasCollision as qe, sameGridPosition as Ye } from "./utils/gridCollision.js";
-import { cn as Je } from "./utils/cn.js";
-import { createSimpleContext as Ze } from "./context/createSimpleContext.js";
-import { createUIFirstSelection as eo } from "./utils/uiFirstSelection.js";
-import { deferAfterPaint as ro, deferNonBlocking as to } from "./utils/defer.js";
-import { duration as so, easing as no, fadeIn as ao, listContainer as mo, listItem as lo, panelResize as po, popIn as fo, scaleIn as To, sidebarVariants as uo, slideInFromBottom as co, slideInFromLeft as go, slideInFromRight as xo, slideInFromTop as yo, springConfig as Co } from "./utils/animations.js";
-import { formatKeybind as So, isMacLikePlatform as Fo, isPrimaryModKeyPressed as vo, matchKeybind as Po, parseKeybind as ko } from "./utils/keybind.js";
-import { isTypingElement as Ro, shouldIgnoreHotkeys as Do } from "./utils/dom.js";
-import { lockBodyStyle as bo } from "./utils/bodyStyleLock.js";
-import { registerCommandContributions as _o, useCommandContributions as Ao } from "./hooks/useCommandContributions.js";
-import { secureRandomUUID as Oo } from "./utils/secureRandom.js";
-import { useDebounce as Bo } from "./hooks/useDebounce.js";
-import { useDeckDrag as wo } from "./hooks/useDeckDrag.js";
-import { useFileBrowserDropTarget as Ho, useFileBrowserItemDrag as Wo } from "./hooks/useFileBrowserDrag.js";
-import { useKeybind as Vo } from "./hooks/useKeybind.js";
-import { useMediaQuery as Qo } from "./hooks/useMediaQuery.js";
-import { usePersisted as Yo } from "./hooks/usePersisted.js";
-import { useResizeObserver as Jo } from "./hooks/useResizeObserver.js";
+import { calculateFitScale as Ve } from "./utils/fitScale.js";
+import { checkCollision as Qe, constrainPosition as qe, findFreePosition as Ye, hasCollision as je, sameGridPosition as Je } from "./utils/gridCollision.js";
+import { cn as Ze } from "./utils/cn.js";
+import { createSimpleContext as eo } from "./context/createSimpleContext.js";
+import { createUIFirstSelection as ro } from "./utils/uiFirstSelection.js";
+import { deferAfterPaint as io, deferNonBlocking as so } from "./utils/defer.js";
+import { duration as ao, easing as mo, fadeIn as lo, listContainer as po, listItem as fo, panelResize as To, popIn as co, scaleIn as uo, sidebarVariants as go, slideInFromBottom as xo, slideInFromLeft as yo, slideInFromRight as Co, slideInFromTop as ho, springConfig as So } from "./utils/animations.js";
+import { formatKeybind as vo, isMacLikePlatform as Po, isPrimaryModKeyPressed as ko, matchKeybind as Io, parseKeybind as Ro } from "./utils/keybind.js";
+import { isTypingElement as Eo, shouldIgnoreHotkeys as bo } from "./utils/dom.js";
+import { lockBodyStyle as _o } from "./utils/bodyStyleLock.js";
+import { registerCommandContributions as No, useCommandContributions as Oo } from "./hooks/useCommandContributions.js";
+import { secureRandomUUID as Bo } from "./utils/secureRandom.js";
+import { useDebounce as wo } from "./hooks/useDebounce.js";
+import { useDeckDrag as Ho } from "./hooks/useDeckDrag.js";
+import { useFileBrowserDropTarget as Ko, useFileBrowserItemDrag as Vo } from "./hooks/useFileBrowserDrag.js";
+import { useKeybind as Qo } from "./hooks/useKeybind.js";
+import { useMediaQuery as Yo } from "./hooks/useMediaQuery.js";
+import { usePersisted as Jo } from "./hooks/usePersisted.js";
+import { useResizeObserver as Zo } from "./hooks/useResizeObserver.js";
 export {
   D as BUILT_IN_SHELL_THEME_DEFAULTS,
   U as CommandProvider,
@@ -60,25 +61,26 @@ export {
   b as assertUniqueThemePresetNames,
   L as builtInShellThemePresets,
   a as builtInThemes,
-  Ve as checkCollision,
-  Je as cn,
-  ze as constrainPosition,
+  Ve as calculateFitScale,
+  Qe as checkCollision,
+  Ze as cn,
+  qe as constrainPosition,
   w as createCommandService,
   K as createComponentRegistry,
   oe as createDeckService,
   Te as createLayoutService,
   ye as createNotificationService,
   _ as createShellThemePreset,
-  Ze as createSimpleContext,
+  eo as createSimpleContext,
   Fe as createThemeService,
-  eo as createUIFirstSelection,
+  ro as createUIFirstSelection,
   Ee as createWidgetRegistry,
-  ro as deferAfterPaint,
-  to as deferNonBlocking,
-  so as duration,
-  no as easing,
-  ao as fadeIn,
-  Qe as findFreePosition,
+  io as deferAfterPaint,
+  so as deferNonBlocking,
+  ao as duration,
+  mo as easing,
+  lo as fadeIn,
+  Ye as findFreePosition,
   g as floeColorTokenCategories,
   x as floeDesignTokens,
   y as floeFontFamilyTokens,
@@ -89,67 +91,67 @@ export {
   v as floeSurfaceTokens,
   P as floeThemeColorVariables,
   k as floeTypographyTokens,
-  So as formatKeybind,
+  vo as formatKeybind,
   I as getFloeColorTokenValue,
   we as getGridCellSize,
   A as getShellThemePresetsForMode,
   m as getSystemTheme,
-  qe as hasCollision,
+  je as hasCollision,
   V as hasComponentRegistryContext,
   le as hasFileBrowserDragContext,
   l as isFloeSurfaceStyle,
-  Fo as isMacLikePlatform,
-  vo as isPrimaryModKeyPressed,
+  Po as isMacLikePlatform,
+  ko as isPrimaryModKeyPressed,
   p as isThemeType,
-  Ro as isTypingElement,
-  mo as listContainer,
-  lo as listItem,
-  bo as lockBodyStyle,
-  Po as matchKeybind,
+  Eo as isTypingElement,
+  po as listContainer,
+  fo as listItem,
+  _o as lockBodyStyle,
+  Io as matchKeybind,
   f as mergeThemeTokenMaps,
   N as normalizeShellThemeSelection,
-  po as panelResize,
-  ko as parseKeybind,
+  To as panelResize,
+  Ro as parseKeybind,
   Ge as pixelDeltaToGridDelta,
-  fo as popIn,
+  co as popIn,
   He as positionToGridArea,
   O as presetSupportsMode,
-  _o as registerCommandContributions,
+  No as registerCommandContributions,
   M as resolveShellThemePresetName,
   d as resolveThemeTokenOverrides,
   T as resolveThemeTokens,
-  Ye as sameGridPosition,
-  To as scaleIn,
-  Oo as secureRandomUUID,
-  Do as shouldIgnoreHotkeys,
-  uo as sidebarVariants,
-  co as slideInFromBottom,
-  go as slideInFromLeft,
-  xo as slideInFromRight,
-  yo as slideInFromTop,
+  Je as sameGridPosition,
+  uo as scaleIn,
+  Bo as secureRandomUUID,
+  bo as shouldIgnoreHotkeys,
+  go as sidebarVariants,
+  xo as slideInFromBottom,
+  yo as slideInFromLeft,
+  Co as slideInFromRight,
+  ho as slideInFromTop,
   We as snapToGrid,
-  Co as springConfig,
+  So as springConfig,
   ne as startHotInteraction,
-  u as syncThemeTokenOverrides,
+  c as syncThemeTokenOverrides,
   G as useCommand,
-  Ao as useCommandContributions,
+  Oo as useCommandContributions,
   z as useComponentContextFactory,
   Q as useComponentRegistry,
   Ae as useCurrentWidgetId,
-  Bo as useDebounce,
+  wo as useDebounce,
   re as useDeck,
-  wo as useDeckDrag,
+  Ho as useDeckDrag,
   pe as useFileBrowserDrag,
-  Ho as useFileBrowserDropTarget,
-  Wo as useFileBrowserItemDrag,
+  Ko as useFileBrowserDropTarget,
+  Vo as useFileBrowserItemDrag,
   X as useFloeConfig,
-  Vo as useKeybind,
-  ue as useLayout,
-  Qo as useMediaQuery,
+  Qo as useKeybind,
+  ce as useLayout,
+  Yo as useMediaQuery,
   Ce as useNotification,
   q as useOptionalComponentRegistry,
-  Yo as usePersisted,
-  Jo as useResizeObserver,
+  Jo as usePersisted,
+  Zo as useResizeObserver,
   Z as useResolvedFloeConfig,
   ve as useTheme,
   Ie as useViewActivation,

package/dist/utils/fitScale.d.ts

@@ -0,0 +1,10 @@
+export interface FitScaleSize {
+    width: number;
+    height: number;
+}
+/** Fit local content dimensions without capping enlargement or rounding scale. */
+export declare function calculateFitScale(options: {
+    content: FitScaleSize;
+    viewport: FitScaleSize;
+    mode: 'contain' | 'width';
+}): number | null;

package/dist/utils/fitScale.js

@@ -0,0 +1,9 @@
+function c(n) {
+  const { content: t, viewport: i, mode: r } = n;
+  if (![t.width, t.height, i.width, i.height].every((h) => Number.isFinite(h) && h > 0)) return null;
+  const e = r === "width" ? i.width / t.width : Math.min(i.width / t.width, i.height / t.height);
+  return Number.isFinite(e) && e > 0 ? e : null;
+}
+export {
+  c as calculateFitScale
+};

package/dist/utils/index.d.ts

@@ -1,4 +1,5 @@
 export { cn } from './cn';
+export { calculateFitScale, type FitScaleSize } from './fitScale';
 export * from './defer';
 export * from './keybind';
 export * from './bodyStyleLock';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@floegence/floe-webapp-core",
-  "version": "0.54.1",
+  "version": "0.55.0",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",