@cjlapao/ui-kit 0.2.24 → 0.2.25

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.cts CHANGED
@@ -2808,6 +2808,22 @@ interface StackCarouselProps<T = React__default.ReactNode> extends Omit<React__d
2808
2808
  stackOffset?: number;
2809
2809
  /** @default true */
2810
2810
  wheel?: boolean;
2811
+ /** Wrap at either end. @default true */
2812
+ loop?: boolean;
2813
+ /** Allow the deck to expand into a list. @default false */
2814
+ expandable?: boolean;
2815
+ expanded?: boolean;
2816
+ defaultExpanded?: boolean;
2817
+ onExpandedChange?: (expanded: boolean) => void;
2818
+ showExpandButton?: boolean;
2819
+ /** Expand after the mouse remains still; collapse on pointer leave. */
2820
+ expandOnHover?: boolean;
2821
+ /** Stationary hover delay in milliseconds. @default 2000 */
2822
+ hoverExpandDelay?: number;
2823
+ /** Hover-opened stacks collapse this long after leaving; re-entry cancels it. @default 500 */
2824
+ hoverCollapseDelay?: number;
2825
+ expandLabel?: string;
2826
+ collapseLabel?: string;
2811
2827
  /** @default true */
2812
2828
  swipe?: boolean;
2813
2829
  /** @default true */
@@ -2823,7 +2839,7 @@ interface StackCarouselProps<T = React__default.ReactNode> extends Omit<React__d
2823
2839
  emptyState?: React__default.ReactNode;
2824
2840
  }
2825
2841
  /** One interactive card above up to two peeking layers, with circular navigation. */
2826
- declare function StackCarousel<T = React__default.ReactNode>({ items, renderItem, getItemKey, activeIndex, defaultActiveIndex, onActiveIndexChange, visibleCount, stackOffset, wheel, swipe, showNavigators, showStatus, ariaLabel, previousLabel, nextLabel, getItemLabel, emptyState, variant, tone, corner, padding, transparency, className, onKeyDown, style, ...rest }: StackCarouselProps<T>): React__default.JSX.Element;
2842
+ declare function StackCarousel<T = React__default.ReactNode>({ items, renderItem, getItemKey, activeIndex, defaultActiveIndex, onActiveIndexChange, visibleCount, stackOffset, wheel, swipe, showNavigators, showStatus, loop, expandable, expanded, defaultExpanded, onExpandedChange, showExpandButton, expandOnHover, hoverExpandDelay, hoverCollapseDelay, expandLabel, collapseLabel, ariaLabel, previousLabel, nextLabel, getItemLabel, emptyState, variant, tone, corner, padding, transparency, className, onKeyDown, onPointerEnter, onPointerMove, onPointerLeave, onWheelCapture, style, ...rest }: StackCarouselProps<T>): React__default.JSX.Element;
2827
2843
 
2828
2844
  type TraceGraphLayout = "timeline" | "dependency";
2829
2845
  type TraceGraphStatus = "idle" | "running" | "done" | "error" | "blocked";
package/dist/index.d.ts CHANGED
@@ -2808,6 +2808,22 @@ interface StackCarouselProps<T = React__default.ReactNode> extends Omit<React__d
2808
2808
  stackOffset?: number;
2809
2809
  /** @default true */
2810
2810
  wheel?: boolean;
2811
+ /** Wrap at either end. @default true */
2812
+ loop?: boolean;
2813
+ /** Allow the deck to expand into a list. @default false */
2814
+ expandable?: boolean;
2815
+ expanded?: boolean;
2816
+ defaultExpanded?: boolean;
2817
+ onExpandedChange?: (expanded: boolean) => void;
2818
+ showExpandButton?: boolean;
2819
+ /** Expand after the mouse remains still; collapse on pointer leave. */
2820
+ expandOnHover?: boolean;
2821
+ /** Stationary hover delay in milliseconds. @default 2000 */
2822
+ hoverExpandDelay?: number;
2823
+ /** Hover-opened stacks collapse this long after leaving; re-entry cancels it. @default 500 */
2824
+ hoverCollapseDelay?: number;
2825
+ expandLabel?: string;
2826
+ collapseLabel?: string;
2811
2827
  /** @default true */
2812
2828
  swipe?: boolean;
2813
2829
  /** @default true */
@@ -2823,7 +2839,7 @@ interface StackCarouselProps<T = React__default.ReactNode> extends Omit<React__d
2823
2839
  emptyState?: React__default.ReactNode;
2824
2840
  }
2825
2841
  /** One interactive card above up to two peeking layers, with circular navigation. */
2826
- declare function StackCarousel<T = React__default.ReactNode>({ items, renderItem, getItemKey, activeIndex, defaultActiveIndex, onActiveIndexChange, visibleCount, stackOffset, wheel, swipe, showNavigators, showStatus, ariaLabel, previousLabel, nextLabel, getItemLabel, emptyState, variant, tone, corner, padding, transparency, className, onKeyDown, style, ...rest }: StackCarouselProps<T>): React__default.JSX.Element;
2842
+ declare function StackCarousel<T = React__default.ReactNode>({ items, renderItem, getItemKey, activeIndex, defaultActiveIndex, onActiveIndexChange, visibleCount, stackOffset, wheel, swipe, showNavigators, showStatus, loop, expandable, expanded, defaultExpanded, onExpandedChange, showExpandButton, expandOnHover, hoverExpandDelay, hoverCollapseDelay, expandLabel, collapseLabel, ariaLabel, previousLabel, nextLabel, getItemLabel, emptyState, variant, tone, corner, padding, transparency, className, onKeyDown, onPointerEnter, onPointerMove, onPointerLeave, onWheelCapture, style, ...rest }: StackCarouselProps<T>): React__default.JSX.Element;
2827
2843
 
2828
2844
  type TraceGraphLayout = "timeline" | "dependency";
2829
2845
  type TraceGraphStatus = "idle" | "running" | "done" | "error" | "blocked";
package/dist/index.js CHANGED
@@ -20956,6 +20956,17 @@ function StackCarousel({
20956
20956
  swipe = true,
20957
20957
  showNavigators = true,
20958
20958
  showStatus = true,
20959
+ loop = true,
20960
+ expandable = false,
20961
+ expanded,
20962
+ defaultExpanded = false,
20963
+ onExpandedChange,
20964
+ showExpandButton = false,
20965
+ expandOnHover = false,
20966
+ hoverExpandDelay = 2e3,
20967
+ hoverCollapseDelay = 500,
20968
+ expandLabel = "Expand stack",
20969
+ collapseLabel = "Collapse stack",
20959
20970
  ariaLabel = "Card stack",
20960
20971
  previousLabel = "Previous item",
20961
20972
  nextLabel = "Next item",
@@ -20968,12 +20979,51 @@ function StackCarousel({
20968
20979
  transparency,
20969
20980
  className = "",
20970
20981
  onKeyDown,
20982
+ onPointerEnter,
20983
+ onPointerMove,
20984
+ onPointerLeave,
20985
+ onWheelCapture,
20971
20986
  style,
20972
20987
  ...rest
20973
20988
  }) {
20974
20989
  const [internalIndex, setInternalIndex] = useState22(defaultActiveIndex);
20975
- const index = wrap(Number.isFinite(activeIndex ?? internalIndex) ? activeIndex ?? internalIndex : 0, items.length);
20976
- const layers = Math.min(items.length, Math.max(1, Math.min(3, Math.trunc(visibleCount) || 1)));
20990
+ const [internalExpanded, setInternalExpanded] = useState22(defaultExpanded);
20991
+ const isExpanded = expandable && (expanded ?? internalExpanded);
20992
+ const hoverTimer = useRef18(null);
20993
+ const collapseTimer = useRef18(null);
20994
+ const hoverOpened = useRef18(false);
20995
+ const setExpanded = useCallback12((value) => {
20996
+ if (expanded === void 0) setInternalExpanded(value);
20997
+ onExpandedChange?.(value);
20998
+ }, [expanded, onExpandedChange]);
20999
+ const clearHover = useCallback12(() => {
21000
+ if (hoverTimer.current !== null) clearTimeout(hoverTimer.current);
21001
+ hoverTimer.current = null;
21002
+ }, []);
21003
+ const clearCollapse = useCallback12(() => {
21004
+ if (collapseTimer.current !== null) clearTimeout(collapseTimer.current);
21005
+ collapseTimer.current = null;
21006
+ }, []);
21007
+ useEffect14(() => {
21008
+ clearHover();
21009
+ clearCollapse();
21010
+ return () => {
21011
+ clearHover();
21012
+ clearCollapse();
21013
+ };
21014
+ }, [expandable, expandOnHover, hoverExpandDelay, hoverCollapseDelay, isExpanded, clearHover, clearCollapse]);
21015
+ const armHover = (event) => {
21016
+ clearHover();
21017
+ clearCollapse();
21018
+ if (!expandable || !expandOnHover || isExpanded || event?.pointerType === "touch") return;
21019
+ hoverTimer.current = setTimeout(() => {
21020
+ hoverOpened.current = true;
21021
+ setExpanded(true);
21022
+ }, Math.max(0, Number.isFinite(hoverExpandDelay) ? hoverExpandDelay : 2e3));
21023
+ };
21024
+ const normalize = useCallback12((value) => loop ? wrap(value, items.length) : Math.max(0, Math.min(items.length - 1, Math.trunc(value))), [loop, items.length]);
21025
+ const index = normalize(Number.isFinite(activeIndex ?? internalIndex) ? activeIndex ?? internalIndex : 0);
21026
+ const layers = Math.min(loop ? items.length : items.length - index, Math.max(1, Math.min(3, Math.trunc(visibleCount) || 1)));
20977
21027
  const offset = Math.max(0, Number.isFinite(stackOffset) ? stackOffset : 12);
20978
21028
  const rootRef = useRef18(null);
20979
21029
  const measureRef = useRef18(null);
@@ -20984,16 +21034,20 @@ function StackCarousel({
20984
21034
  const wheelDelta = useRef18(0);
20985
21035
  const touch = useRef18(null);
20986
21036
  const label = (i) => getItemLabel?.(items[i], i) ?? `Item ${i + 1}`;
21037
+ useLayoutEffect7(() => {
21038
+ if (!isExpanded && document.activeElement instanceof Element && rootRef.current?.contains(document.activeElement) && document.activeElement.closest("[inert]"))
21039
+ rootRef.current.focus({ preventScroll: true });
21040
+ }, [isExpanded]);
20987
21041
  const navigate = useCallback12((next, focus = false) => {
20988
21042
  if (items.length < 2) return;
20989
- const normalized = wrap(next, items.length);
21043
+ const normalized = normalize(next);
20990
21044
  if (normalized === index) return;
20991
21045
  if (focus || measureRef.current?.contains(document.activeElement)) {
20992
21046
  rootRef.current?.focus({ preventScroll: true });
20993
21047
  }
20994
21048
  if (activeIndex === void 0) setInternalIndex(normalized);
20995
21049
  onActiveIndexChange?.(normalized);
20996
- }, [items.length, index, activeIndex, onActiveIndexChange]);
21050
+ }, [items.length, index, activeIndex, onActiveIndexChange, normalize]);
20997
21051
  useLayoutEffect7(() => {
20998
21052
  const old = previousIndex.current;
20999
21053
  previousIndex.current = index;
@@ -21014,7 +21068,7 @@ function StackCarousel({
21014
21068
  const observer = new ResizeObserver(measure);
21015
21069
  observer.observe(element);
21016
21070
  return () => observer.disconnect();
21017
- }, [index, items.length, items[index]]);
21071
+ }, [index, items.length, items[index], isExpanded]);
21018
21072
  const canScrollInside = useCallback12((target, delta) => {
21019
21073
  let element = target instanceof Element ? target : null;
21020
21074
  while (element && element !== rootRef.current) {
@@ -21026,7 +21080,7 @@ function StackCarousel({
21026
21080
  }, []);
21027
21081
  useEffect14(() => {
21028
21082
  const root = rootRef.current;
21029
- if (!root || !swipe || items.length < 2) return;
21083
+ if (!root || !swipe || isExpanded || items.length < 2) return;
21030
21084
  const handleMove = (event) => {
21031
21085
  const start = touch.current;
21032
21086
  if (!start || event.touches.length !== 1) return;
@@ -21036,10 +21090,10 @@ function StackCarousel({
21036
21090
  };
21037
21091
  root.addEventListener("touchmove", handleMove, { passive: false });
21038
21092
  return () => root.removeEventListener("touchmove", handleMove);
21039
- }, [swipe, items.length, canScrollInside]);
21093
+ }, [swipe, isExpanded, items.length, canScrollInside]);
21040
21094
  useEffect14(() => {
21041
21095
  const root = rootRef.current;
21042
- if (!root || !wheel || items.length < 2) return;
21096
+ if (!root || !wheel || isExpanded || items.length < 2) return;
21043
21097
  const handleWheel = (event) => {
21044
21098
  if (event.ctrlKey || event.metaKey || !event.deltaY || Math.abs(event.deltaX) > Math.abs(event.deltaY) || canScrollInside(event.target, event.deltaY)) return;
21045
21099
  event.preventDefault();
@@ -21055,11 +21109,11 @@ function StackCarousel({
21055
21109
  };
21056
21110
  root.addEventListener("wheel", handleWheel, { passive: false });
21057
21111
  return () => root.removeEventListener("wheel", handleWheel);
21058
- }, [wheel, items.length, index, navigate, canScrollInside]);
21059
- const visible = Array.from({ length: layers }, (_, rank) => wrap(index + rank, items.length));
21112
+ }, [wheel, isExpanded, items.length, index, navigate, canScrollInside]);
21113
+ const visible = isExpanded ? items.map((_, i) => i) : Array.from({ length: layers }, (_, rank) => normalize(index + rank));
21060
21114
  const rendered = [...visible];
21061
21115
  const transitionFrom = previousIndex.current !== index ? previousIndex.current : outgoing;
21062
- if (transitionFrom !== null && transitionFrom < items.length && !rendered.includes(transitionFrom)) rendered.push(transitionFrom);
21116
+ if (!isExpanded && transitionFrom !== null && transitionFrom < items.length && !rendered.includes(transitionFrom)) rendered.push(transitionFrom);
21063
21117
  return (
21064
21118
  // A focusable carousel region owns arrow navigation; child controls keep
21065
21119
  // their native key handling. It is a region rather than a single button.
@@ -21075,9 +21129,31 @@ function StackCarousel({
21075
21129
  tabIndex: 0,
21076
21130
  className: `min-w-0 outline-none focus-visible:ring-2 focus-visible:ring-blue-400 rounded-lg ${className}`,
21077
21131
  style,
21132
+ onPointerEnter: (event) => {
21133
+ onPointerEnter?.(event);
21134
+ if (!event.defaultPrevented) armHover(event);
21135
+ },
21136
+ onPointerMove: (event) => {
21137
+ onPointerMove?.(event);
21138
+ if (!event.defaultPrevented) armHover(event);
21139
+ },
21140
+ onWheelCapture: (event) => {
21141
+ onWheelCapture?.(event);
21142
+ if (event.deltaX || event.deltaY) armHover();
21143
+ },
21144
+ onPointerLeave: (event) => {
21145
+ onPointerLeave?.(event);
21146
+ clearHover();
21147
+ clearCollapse();
21148
+ if (hoverOpened.current) collapseTimer.current = setTimeout(() => {
21149
+ collapseTimer.current = null;
21150
+ hoverOpened.current = false;
21151
+ setExpanded(false);
21152
+ }, Math.max(0, Number.isFinite(hoverCollapseDelay) ? hoverCollapseDelay : 500));
21153
+ },
21078
21154
  onKeyDown: (event) => {
21079
21155
  onKeyDown?.(event);
21080
- if (event.defaultPrevented || event.target !== event.currentTarget) return;
21156
+ if (event.defaultPrevented || event.target !== event.currentTarget || isExpanded) return;
21081
21157
  const next = event.key === "ArrowDown" || event.key === "ArrowRight" ? index + 1 : event.key === "ArrowUp" || event.key === "ArrowLeft" ? index - 1 : event.key === "Home" ? 0 : event.key === "End" ? items.length - 1 : null;
21082
21158
  if (next !== null && items.length > 1) {
21083
21159
  event.preventDefault();
@@ -21090,9 +21166,10 @@ function StackCarousel({
21090
21166
  {
21091
21167
  className: "relative transition-[height] duration-300 ease-out motion-reduce:transition-none",
21092
21168
  "data-stack-carousel-track": true,
21093
- style: { height: height ? height + Math.max(0, layers - 1) * offset : void 0 },
21169
+ "data-expanded": isExpanded,
21170
+ style: { height: !isExpanded && height ? height + Math.max(0, layers - 1) * offset : void 0 },
21094
21171
  onTouchStart: (event) => {
21095
- if (!swipe || event.touches.length !== 1) {
21172
+ if (!swipe || isExpanded || event.touches.length !== 1) {
21096
21173
  touch.current = null;
21097
21174
  return;
21098
21175
  }
@@ -21112,7 +21189,7 @@ function StackCarousel({
21112
21189
  },
21113
21190
  children: rendered.map((i) => {
21114
21191
  const rank = visible.indexOf(i);
21115
- const active = rank === 0;
21192
+ const active = isExpanded || rank === 0;
21116
21193
  const leaving = rank < 0;
21117
21194
  return /* @__PURE__ */ jsxs90(
21118
21195
  "div",
@@ -21120,19 +21197,20 @@ function StackCarousel({
21120
21197
  "data-stack-rank": rank,
21121
21198
  className: `w-full origin-top transition-[transform,opacity,height] duration-300 ease-out motion-reduce:transition-none ${getSurfaceCornerClass(corner)}`,
21122
21199
  style: {
21123
- position: height || !active ? "absolute" : "relative",
21200
+ position: isExpanded ? "relative" : height || !active ? "absolute" : "relative",
21124
21201
  top: 0,
21125
- zIndex: leaving ? 4 : 3 - rank,
21202
+ marginTop: isExpanded && rank > 0 ? offset : void 0,
21203
+ zIndex: isExpanded ? 0 : leaving ? 4 : 3 - rank,
21126
21204
  opacity: leaving ? 0 : 1,
21127
21205
  pointerEvents: leaving ? "none" : void 0,
21128
- transform: leaving ? "translateY(-16px) scaleX(1.02)" : `translateY(${rank * offset}px) scaleX(${1 - rank * 0.04})`,
21206
+ transform: isExpanded ? "none" : leaving ? "translateY(-16px) scaleX(1.02)" : `translateY(${rank * offset}px) scaleX(${1 - rank * 0.04})`,
21129
21207
  height: !active && height ? height : void 0
21130
21208
  },
21131
21209
  children: [
21132
21210
  /* @__PURE__ */ jsx194(
21133
21211
  "div",
21134
21212
  {
21135
- ref: active ? measureRef : void 0,
21213
+ ref: i === index ? measureRef : void 0,
21136
21214
  inert: !active || void 0,
21137
21215
  "aria-hidden": !active || void 0,
21138
21216
  style: { height: !active && height ? height : void 0 },
@@ -21167,7 +21245,7 @@ function StackCarousel({
21167
21245
  })
21168
21246
  }
21169
21247
  ),
21170
- /* @__PURE__ */ jsxs90("div", { className: showStatus || showNavigators && items.length > 1 ? "mt-3 flex items-center justify-between gap-3 text-xs text-neutral-600 dark:text-neutral-400" : void 0, children: [
21248
+ /* @__PURE__ */ jsxs90("div", { className: showStatus || showNavigators && items.length > 1 || expandable && showExpandButton ? "mt-3 flex items-center justify-between gap-3 text-xs text-neutral-600 dark:text-neutral-400" : void 0, children: [
21171
21249
  /* @__PURE__ */ jsxs90("span", { className: showStatus ? void 0 : "sr-only", role: "status", "aria-live": "polite", "aria-atomic": "true", children: [
21172
21250
  label(index),
21173
21251
  " \xB7 ",
@@ -21175,27 +21253,37 @@ function StackCarousel({
21175
21253
  " / ",
21176
21254
  items.length
21177
21255
  ] }),
21178
- showNavigators && items.length > 1 && /* @__PURE__ */ jsxs90("div", { className: "ml-auto flex items-center gap-1", children: [
21179
- /* @__PURE__ */ jsx194(
21180
- "button",
21181
- {
21182
- type: "button",
21183
- "aria-label": previousLabel,
21184
- onClick: () => navigate(index - 1),
21185
- className: "rounded-md px-2 py-1 hover:bg-black/5 focus-visible:outline-2 dark:hover:bg-white/10",
21186
- children: "\u2191"
21187
- }
21188
- ),
21189
- /* @__PURE__ */ jsx194(
21190
- "button",
21191
- {
21192
- type: "button",
21193
- "aria-label": nextLabel,
21194
- onClick: () => navigate(index + 1),
21195
- className: "rounded-md px-2 py-1 hover:bg-black/5 focus-visible:outline-2 dark:hover:bg-white/10",
21196
- children: "\u2193"
21197
- }
21198
- )
21256
+ (showNavigators && items.length > 1 || expandable && showExpandButton) && /* @__PURE__ */ jsxs90("div", { className: "ml-auto flex items-center gap-1", children: [
21257
+ expandable && showExpandButton && /* @__PURE__ */ jsx194("button", { type: "button", "aria-expanded": isExpanded, onClick: () => {
21258
+ hoverOpened.current = false;
21259
+ clearHover();
21260
+ clearCollapse();
21261
+ setExpanded(!isExpanded);
21262
+ }, className: "rounded-md px-2 py-1 hover:bg-black/5 dark:hover:bg-white/10", children: isExpanded ? collapseLabel : expandLabel }),
21263
+ showNavigators && !isExpanded && items.length > 1 && /* @__PURE__ */ jsxs90(Fragment15, { children: [
21264
+ /* @__PURE__ */ jsx194(
21265
+ "button",
21266
+ {
21267
+ type: "button",
21268
+ "aria-label": previousLabel,
21269
+ disabled: !loop && index === 0,
21270
+ onClick: () => navigate(index - 1),
21271
+ className: "rounded-md px-2 py-1 hover:bg-black/5 focus-visible:outline-2 dark:hover:bg-white/10",
21272
+ children: "\u2191"
21273
+ }
21274
+ ),
21275
+ /* @__PURE__ */ jsx194(
21276
+ "button",
21277
+ {
21278
+ type: "button",
21279
+ "aria-label": nextLabel,
21280
+ disabled: !loop && index === items.length - 1,
21281
+ onClick: () => navigate(index + 1),
21282
+ className: "rounded-md px-2 py-1 hover:bg-black/5 focus-visible:outline-2 dark:hover:bg-white/10",
21283
+ children: "\u2193"
21284
+ }
21285
+ )
21286
+ ] })
21199
21287
  ] })
21200
21288
  ] })
21201
21289
  ] })