@omerdlw/base-framework 3.0.0 → 3.0.1

package/dist/{chunk-JIXBFFRD.js → chunk-WVRMABDN.js}

@@ -410,27 +410,13 @@ var DOCK_SURFACE_PHASE = Object.freeze({
 });
 var VIEWPORT_MARGIN = 24;
 var DOCK_CARD_DIMENSIONS = Object.freeze({
-  expandedY: -72,
   chromeHeight: 20,
-  collapsedY: -10,
-  extensionShelfY: -42,
-  extensionShelfScale: 0.94,
   extensionShelfHeight: 45,
   hudHeight: 52,
   actionGap: 10,
   height: 68
 });
 var DOCK_CARD_LAYOUT = Object.freeze({
-  collapsed: Object.freeze({
-    offsetY: DOCK_CARD_DIMENSIONS.collapsedY,
-    scale: 0.88
-  }),
-  expanded: Object.freeze({
-    offsetY: DOCK_CARD_DIMENSIONS.expandedY,
-    scale: 1
-  }),
-  extensionShelfY: DOCK_CARD_DIMENSIONS.extensionShelfY,
-  extensionShelfScale: DOCK_CARD_DIMENSIONS.extensionShelfScale,
   extensionShelfHeight: DOCK_CARD_DIMENSIONS.extensionShelfHeight,
   chromeHeight: DOCK_CARD_DIMENSIONS.chromeHeight,
   hudHeight: DOCK_CARD_DIMENSIONS.hudHeight,
@@ -499,7 +485,6 @@ var STATUS_CLEAR_DURATION = 4500;
 var API_ERROR_BATCH_DELAY = 300;
 var DOCK_HEIGHT_BUFFER = 16;
 var HEIGHT_EPSILON = 0.5;
-var MAX_VISIBLE_STACKED_CARDS = 3;
 var dockTheme = defineThemeSpec("dock");
 var DockContext = getOrCreateGlobalContext(
   "DockContext",
@@ -1598,10 +1583,6 @@ var DOCK_SURFACE_DRAG_CONSTRAINTS = Object.freeze({
   top: 0,
   bottom: 0
 });
-var DOCK_SURFACE_DRAG_THRESHOLDS = Object.freeze({
-  DISMISS_OFFSET_Y: 65,
-  DISMISS_VELOCITY_Y: 400
-});
 function toGpuTransform(y = 0, scale = 1, x = 0) {
   return gpuTransform(y, scale, x);
 }
@@ -1637,42 +1618,37 @@ function getDockMediaVolumeThumbAnimateProps(motion2, { isDragging = false } = {
 function getDockMediaVolumeThumbPositionTransition(motion2, { isDragging = false } = {}) {
   return isDragging ? "none" : cssTransition("left", motion2.transitions.mediaVolume);
 }
-function getDockSurfaceStackScale(motion2, surfacePhase) {
-  if (surfacePhase === DOCK_SURFACE_PHASE.DISMISSING_ACTION) {
-    return motion2.deck.compress.open;
-  }
-  if (surfacePhase === DOCK_SURFACE_PHASE.CLOSING_ANTICIPATION) {
-    return motion2.deck.compress.close;
-  }
-  return 1;
+var SURFACE_PHASE_KEYS = Object.freeze({
+  [DOCK_SURFACE_PHASE.IDLE]: "idle",
+  [DOCK_SURFACE_PHASE.DISMISSING_ACTION]: "dismissAction",
+  [DOCK_SURFACE_PHASE.EXPANDING_BODY]: "expandBody",
+  [DOCK_SURFACE_PHASE.OPEN]: "open",
+  [DOCK_SURFACE_PHASE.CLOSING_ANTICIPATION]: "anticipation",
+  [DOCK_SURFACE_PHASE.COLLAPSING_BODY]: "collapseBody",
+  [DOCK_SURFACE_PHASE.RESTORING_HEADER]: "restoreHeader"
+});
+function getDockPhaseMotion(motion2, surfacePhase) {
+  const key = surfacePhase && SURFACE_PHASE_KEYS[surfacePhase] || "idle";
+  return motion2.phases[key];
 }
 function getDockStackTransformTransition(motion2, surfacePhase, fallbackTransition) {
-  if (surfacePhase === DOCK_SURFACE_PHASE.EXPANDING_BODY) {
-    return motion2.transitions.surfaceArrival;
-  }
-  if (surfacePhase === DOCK_SURFACE_PHASE.DISMISSING_ACTION || surfacePhase === DOCK_SURFACE_PHASE.CLOSING_ANTICIPATION) {
-    return motion2.transitions.anticipation;
-  }
-  return fallbackTransition;
+  return getDockPhaseMotion(motion2, surfacePhase).transform ?? fallbackTransition;
 }
 function getDockStackTransition(motion2, {
   expanded = false,
   resizeDistance = 0,
   surfacePhase = null
 } = {}) {
-  if (surfacePhase === DOCK_SURFACE_PHASE.EXPANDING_BODY) {
-    return motion2.transitions.expand;
-  }
-  if (surfacePhase === DOCK_SURFACE_PHASE.OPEN || surfacePhase === DOCK_SURFACE_PHASE.CLOSING_ANTICIPATION) {
-    return motion2.transitions.surfaceResize(
-      resizeDistance > 0 ? resizeDistance : 260
-    );
-  }
-  if (surfacePhase === DOCK_SURFACE_PHASE.COLLAPSING_BODY || surfacePhase === DOCK_SURFACE_PHASE.RESTORING_HEADER) {
-    return motion2.transitions.expand;
+  const { deck } = getDockPhaseMotion(motion2, surfacePhase);
+  if (typeof deck === "function") {
+    return deck(resizeDistance > 0 ? resizeDistance : motion2.deck.resizeFallback);
   }
+  if (deck) return deck;
   return expanded ? motion2.transitions.expand : motion2.transitions.stack;
 }
+function getDockLayoutTransition(motion2) {
+  return { layout: motion2.transitions.layout };
+}
 function getDockStackAnimateProps(motion2, {
   width,
   height,
@@ -1683,7 +1659,7 @@ function getDockStackAnimateProps(motion2, {
 }) {
   const safeWidth = Number(width);
   const safeHeight = Number(height);
-  const liftAmount = isBreadcrumbsVisible ? -44 : 0;
+  const liftAmount = isBreadcrumbsVisible ? motion2.deck.breadcrumbOffset : 0;
   return {
     width: Math.max(0, Math.round(Number.isFinite(safeWidth) ? safeWidth : 0)),
     height: Math.max(
@@ -1692,9 +1668,9 @@ function getDockStackAnimateProps(motion2, {
     ),
     transform: toGpuTransform(
       liftAmount,
-      getDockSurfaceStackScale(motion2, surfacePhase)
+      getDockPhaseMotion(motion2, surfacePhase).scale
     ),
-    opacity: isFullscreen ? 0 : 1,
+    opacity: isFullscreen ? motion2.deck.fullscreenOpacity : 1,
     boxShadow: isSurfaceActive ? motion2.deck.elevation.elevated : motion2.deck.elevation.rest,
     pointerEvents: isFullscreen ? "none" : "auto"
   };
@@ -1759,7 +1735,7 @@ function getDockItemExitValues(motion2, {
   return motion2.deck.exit({
     position: safePosition,
     scale: motionValues && Number.isFinite(motionValues.scale) ? motionValues.scale : null,
-    y: motionValues && Number.isFinite(motionValues.y) ? motionValues.y : safePosition * DOCK_CARD_DIMENSIONS.collapsedY
+    y: motionValues && Number.isFinite(motionValues.y) ? motionValues.y : safePosition * motion2.deck.stacking.collapsed.offsetY
   });
 }
 function getDockCardContentAnimateProps(motion2, {
@@ -2203,7 +2179,8 @@ function useDockSurfaceShellModel({
   const handleDragEnd = (_event, info) => {
     if (!isActive || !allowSwipeDismiss || typeof onClose !== "function" || !isFullyOpen)
       return;
-    if (info.offset.y > DOCK_SURFACE_DRAG_THRESHOLDS.DISMISS_OFFSET_Y || info.velocity.y > DOCK_SURFACE_DRAG_THRESHOLDS.DISMISS_VELOCITY_Y) {
+    const { dismiss } = dockMotion.drag;
+    if (info.offset.y > dismiss.offset || info.velocity.y > dismiss.velocity) {
       onClose();
     }
   };
@@ -2228,12 +2205,12 @@ function useDockSurfaceShellModel({
   const resolvedSurfaceId = surfaceId || "active";
   const bodyVariants = useMemo(() => {
     const { surfaceBody } = dockMotion.variants;
-    const { surfaceEnter, surfaceExit, surfaceStep } = dockMotion.transitions;
+    const { surfaceExit } = dockMotion.transitions;
     return {
       hidden: surfaceBody.hidden,
       visible: {
         ...surfaceBody.visible,
-        transition: surfacePhase === DOCK_SURFACE_PHASE.EXPANDING_BODY ? surfaceEnter : surfaceStep
+        transition: getDockPhaseMotion(dockMotion, surfacePhase).body
       },
       exit: {
         ...surfaceBody.exit,
@@ -2329,11 +2306,12 @@ function getDockItemCardProps({
   hasExtensions = false,
   isAnchoredToBottom,
   position,
+  stacking,
   theme,
-  visibleCount = 3
+  visibleCount = stacking.visible.stack
 }) {
-  const { offsetY: collapsedOffsetY, scale: collapsedScale } = DOCK_CARD_LAYOUT.collapsed;
-  const { offsetY: expandedOffsetY } = DOCK_CARD_LAYOUT.expanded;
+  const { offsetY: collapsedOffsetY, scale: collapsedScale } = stacking.collapsed;
+  const { offsetY: expandedOffsetY } = stacking.expanded;
   const safeCardStyle = { ...cardStyle };
   delete safeCardStyle.scale;
   delete safeCardStyle.className;
@@ -2341,10 +2319,12 @@ function getDockItemCardProps({
   const isShelf = !expanded && position === 1 && hasExtensions;
   const isHeavyBlur = position < visibleCount || expanded || isShelf;
   const collapsedScaleValue = collapsedScale ** position;
-  const y = expanded ? position * expandedOffsetY : isShelf ? DOCK_CARD_LAYOUT.extensionShelfY : position * collapsedOffsetY;
-  const shelfScale = DOCK_CARD_LAYOUT.extensionShelfScale ?? 0.94;
-  const scale = expanded ? cardScale || 1 : isShelf ? shelfScale : collapsedScaleValue;
-  const collapsedOpacity = Math.max(0.1, +(1 - position * 0.2).toFixed(2));
+  const y = expanded ? position * expandedOffsetY : isShelf ? stacking.shelf.offsetY : position * collapsedOffsetY;
+  const scale = expanded ? cardScale || 1 : isShelf ? stacking.shelf.scale : collapsedScaleValue;
+  const collapsedOpacity = Math.max(
+    stacking.collapsed.opacityMin,
+    +(1 - position * stacking.collapsed.opacityStep).toFixed(2)
+  );
   const opacity = expanded || isShelf ? 1 : position < visibleCount ? collapsedOpacity : 0;
   return {
     className: cn(theme.slots.card, cardStyle?.className),
@@ -2626,6 +2606,10 @@ function removeInactiveLoadingItems(items = [], activeItem = null) {
     (item) => !item?.isLoading || isSameItem(item, activeItem)
   );
 }
+function stackRank(item) {
+  if (typeof item.stackOrder === "number") return item.stackOrder;
+  return item.path === "/" ? Number.POSITIVE_INFINITY : 0;
+}
 function reorderItemsWithActiveFirst(items, activeIndex) {
   if (activeIndex === -1) return items;
   const active = items[activeIndex];
@@ -2633,7 +2617,7 @@ function reorderItemsWithActiveFirst(items, activeIndex) {
     ...items.slice(0, activeIndex),
     ...items.slice(activeIndex + 1)
   ];
-  rest.sort((a, b) => a.path === "/" ? 1 : b.path === "/" ? -1 : 0);
+  rest.sort((a, b) => stackRank(a) - stackRank(b));
   return [active, ...rest];
 }
 function shouldRenderInlineAction({
@@ -3738,7 +3722,7 @@ function useDockCardItemModel({
       hidden: headerRestore.hidden,
       visible: {
         ...visible,
-        transition: item.surfacePhase === DOCK_SURFACE_PHASE.COLLAPSING_BODY ? dockMotion.transitions.surfaceEnter : visible.transition
+        transition: getDockPhaseMotion(dockMotion, item.surfacePhase).headerReturn ?? visible.transition
       },
       exit: headerRestore.exit
     };
@@ -3802,7 +3786,7 @@ function useDockCardItemModel({
     !expanded && position > 0 && !isExtensionShelf
   );
   const isCollapsedGhostCard = Boolean(
-    !expanded && position >= MAX_VISIBLE_STACKED_CARDS && !isExtensionShelf
+    !expanded && position >= dockMotion.deck.stacking.visible.stack && !isExtensionShelf
   );
   const {
     className: cardClassName,
@@ -3816,7 +3800,8 @@ function useDockCardItemModel({
     cardScale: itemStyle.scale,
     theme,
     isAnchoredToBottom: item.isSurface,
-    visibleCount: item.isStatus && !isStackHovered ? 1 : hasExtensions && !expanded ? 2 : 3,
+    stacking: dockMotion.deck.stacking,
+    visibleCount: item.isStatus && !isStackHovered ? dockMotion.deck.stacking.visible.status : hasExtensions && !expanded ? dockMotion.deck.stacking.visible.extensions : dockMotion.deck.stacking.visible.stack,
     hasExtensions
   });
   const cardDelay = useMemo(
@@ -6180,8 +6165,7 @@ function useDockLayout({
   }, [pathname, dockItems, activeItem]);
   return {
     displayItems,
-    activeIndex: displayActiveIndex,
-    MAX_VISIBLE_STACKED_CARDS
+    activeIndex: displayActiveIndex
   };
 }
 function useDock() {
@@ -6665,7 +6649,7 @@ var DockCardBanner = memo(function DockCardBanner2({
   const resolvedPosition = bannerPosition || bannerObj?.position || bannerObj?.bannerPosition || "center 45%";
   const resolvedSize = bannerSize || bannerObj?.size || bannerObj?.bannerSize || "cover";
   const resolvedRepeat = bannerRepeat || bannerObj?.repeat || bannerObj?.bannerRepeat || "no-repeat";
-  const resolvedOpacity = bannerOpacity ?? bannerObj?.opacity ?? bannerObj?.bannerOpacity ?? 0.95;
+  const resolvedOpacity = bannerOpacity ?? bannerObj?.opacity ?? bannerObj?.bannerOpacity ?? dockMotion.opacity.banner;
   return /* @__PURE__ */ jsxs(
     motion.div,
     {
@@ -6807,9 +6791,9 @@ var DockDescription = memo(function DockDescription2({
   const theme = useDockTheme();
   if (text == null || text === "") return null;
   const { className, inlineStyle } = splitStyle(style);
-  const { opacity = 0.7, ...restStyle } = inlineStyle;
+  const { opacity = dockMotion.opacity.description, ...restStyle } = inlineStyle;
   const isMultiline = Number(maxLines) > 1;
-  const targetOpacity = typeof opacity === "number" ? opacity : 0.7;
+  const targetOpacity = typeof opacity === "number" ? opacity : dockMotion.opacity.description;
   const sharedClass = cn(theme.slots.descriptionText, className);
   const sharedStyle = {
     opacity: targetOpacity,
@@ -7373,7 +7357,7 @@ var DockSurfaceControls = memo(function DockSurfaceControls2({
   const isControlsVisible = Boolean(
     isBodyVisible && (activeItem ? activeItem.isSurface !== false : true) && activeControlKeys.length > 0
   );
-  const targetY = hasExtensions ? DOCK_CARD_LAYOUT.extensionShelfY - DOCK_CARD_LAYOUT.collapsed.offsetY : 0;
+  const targetY = hasExtensions ? dockMotion.deck.stacking.shelf.offsetY - dockMotion.deck.stacking.collapsed.offsetY : 0;
   return /* @__PURE__ */ jsx(AnimatePresence, { children: isControlsVisible && /* @__PURE__ */ jsx(
     motion.div,
     {
@@ -7442,6 +7426,7 @@ var DockSurfaceControls = memo(function DockSurfaceControls2({
           motion.div,
           {
             layout: "position",
+            transition: getDockLayoutTransition(dockMotion),
             variants: dockMotion.variants.controlsClose,
             initial: "hidden",
             animate: "visible",
@@ -8016,7 +8001,7 @@ var DockCardItem = memo(function DockCardItem2({
                 initial: "hidden",
                 animate: item.surfacePhase === DOCK_SURFACE_PHASE.DISMISSING_ACTION ? "hidden" : "visible",
                 exit: layerExit,
-                transition: item.surfacePhase === DOCK_SURFACE_PHASE.DISMISSING_ACTION ? dockMotion.transitions.anticipation : dockMotion.transitions.headerSwap,
+                transition: getDockPhaseMotion(dockMotion, item.surfacePhase).header,
                 style: { ...DOCK_COMPOSITOR_STYLE, willChange: "transform" },
                 className: theme.slots.cardStandard,
                 children: item.isLoading ? /* @__PURE__ */ jsx(LoadingItemContent, {}) : /* @__PURE__ */ jsx(
@@ -8253,6 +8238,7 @@ var DockBreadcrumbsCard = memo(function DockBreadcrumbsCard2({
           motion.div,
           {
             layout: "position",
+            transition: getDockLayoutTransition(dockMotion),
             className: theme.slots.breadcrumbsItem,
             children: [
               isLast ? /* @__PURE__ */ jsx("span", { className: theme.slots.breadcrumbsCurrent, children: crumb.title }) : /* @__PURE__ */ jsx(
@@ -8332,7 +8318,7 @@ function Dock() {
         "data-controls-hidden": expanded || activeItem?.isSurface ? "true" : "false",
         style: {
           ...theme.styles.stack,
-          transformOrigin: "50% 100%"
+          transformOrigin: dockMotion.deck.origin
         },
         initial: false,
         animate: getDockStackAnimateProps(dockMotion, {
@@ -9737,5 +9723,5 @@ var dockModule = defineModule({
 });
 
 export { DOCK_EVENTS, DOCK_HUD_PRIORITY, DOCK_HUD_RENDER_MODE, DOCK_HUD_VARIANT, Dock, DockCardBanner, DockCardHeader, DockDescription, DockIcon, DockProvider, DockSurfaceAction, DockSurfaceExtension, DockSurfaceHeaderButton, DockTitle, ErrorActions, GuardActions, createDockGuardRegistry, createErrorStatus, createGuardStatus, createInlineSurfaceEntry, createSurfaceEntryDefinition, createSurfaceFlowBuilder, defineBreadcrumb, defineDockAction, defineHud, defineStepSurface, defineSurface, dockModule, dockTheme, isValidBannerUrl, useDock, useDockActionClass, useDockActions, useDockBanner, useDockConfig, useDockContextActions, useDockDimensions, useDockGuard, useDockHeight, useDockHud, useDockMotion, useDockRegistration, useDockSelector, useDockState, useDockTheme, useHud, useOptionalDockActions, useOptionalDockState, useSurface, useSurfaceAction, useSurfaceDimensions, useSurfaceFlow, useSurfaceHeader, useSurfaceId, useSurfaceReturn, useSurfaceStep };
-//# sourceMappingURL=chunk-JIXBFFRD.js.map
-//# sourceMappingURL=chunk-JIXBFFRD.js.map
+//# sourceMappingURL=chunk-WVRMABDN.js.map
+//# sourceMappingURL=chunk-WVRMABDN.js.map