@legendapp/spark 0.0.1-next.3 → 0.0.1-next.4

package/vendor/node_modules/@legendapp/spark-ui/macos/swipe-actions/RNSwipeActions.mm

@@ -0,0 +1,422 @@
+#import "RNSwipeActions.h"
+#import <QuartzCore/QuartzCore.h>
+#import <react/renderer/components/RNSparkUISpec/ComponentDescriptors.h>
+#import <react/renderer/components/RNSparkUISpec/EventEmitters.h>
+#import <react/renderer/components/RNSparkUISpec/Props.h>
+using namespace facebook::react;
+
+static const CGFloat kButtonWidth = 76;   // one revealed action when the row rests open
+static const CGFloat kAxisDistance = 5;   // travel before a gesture commits to an axis
+static const CGFloat kRubberLimit = 36;   // how far a side without actions gives
+
+typedef NS_ENUM(NSInteger, RNSwipeGesture) { RNSwipeGestureIdle, RNSwipeGestureUndecided, RNSwipeGestureTracking, RNSwipeGesturePassing };
+
+static NSColor *RNSwipeColor(NSString *hex)
+{
+  unsigned long long raw = 0;
+  [[NSScanner scannerWithString:[hex substringFromIndex:1]] scanHexLongLong:&raw];
+  if (hex.length == 9) return [NSColor colorWithSRGBRed:((raw >> 24) & 0xff) / 255.0 green:((raw >> 16) & 0xff) / 255.0 blue:((raw >> 8) & 0xff) / 255.0 alpha:(raw & 0xff) / 255.0];
+  return [NSColor colorWithSRGBRed:((raw >> 16) & 0xff) / 255.0 green:((raw >> 8) & 0xff) / 255.0 blue:(raw & 0xff) / 255.0 alpha:1];
+}
+
+static void RNSwipeAnimate(NSTimeInterval duration, void (^changes)(void), void (^_Nullable completion)(void))
+{
+  BOOL reduce = NSWorkspace.sharedWorkspace.accessibilityDisplayShouldReduceMotion;
+  [NSAnimationContext runAnimationGroup:^(NSAnimationContext *context) {
+    context.duration = reduce ? MIN(duration, 0.12) : duration;
+    context.timingFunction = [CAMediaTimingFunction functionWithControlPoints:0.2 :0.9 :0.25 :1];
+    context.allowsImplicitAnimation = YES;
+    changes();
+  } completionHandler:completion];
+}
+
+// React child frames use top-left coordinates, even inside private AppKit containers.
+@interface RNSwipeContainerView : NSView @end
+@implementation RNSwipeContainerView
+- (BOOL)isFlipped { return YES; }
+@end
+
+@class RNSwipeActions;
+
+@interface RNSwipeActionButton : NSView
+@property (nonatomic, readonly) NSString *actionId;
+@property (nonatomic, readonly) BOOL dismisses;
+/** +1 on the leading side, -1 trailing; the outermost button tracks the content edge once armed. */
+@property (nonatomic) NSInteger edge;
+@property (nonatomic) BOOL followsContent;
+@property (nonatomic, weak) RNSwipeActions *owner;
+@end
+
+@interface RNSwipeActions ()
+- (void)performActionForButton:(RNSwipeActionButton *)button;
+@end
+
+@implementation RNSwipeActionButton {
+  NSImageView *_icon;
+  NSTextField *_label;
+}
+- (instancetype)initWithAction:(NSDictionary *)action
+{
+  if ((self = [super initWithFrame:NSZeroRect])) {
+    _actionId = [action[@"id"] copy];
+    _dismisses = [action[@"dismisses"] boolValue];
+    self.wantsLayer = YES;
+    self.layer.backgroundColor = RNSwipeColor(action[@"color"]).CGColor;
+    NSImageSymbolConfiguration *config = [NSImageSymbolConfiguration configurationWithPointSize:17 weight:NSFontWeightSemibold];
+    _icon = [NSImageView imageViewWithImage:[[NSImage imageWithSystemSymbolName:action[@"symbol"] accessibilityDescription:nil] imageWithSymbolConfiguration:config] ?: [NSImage new]];
+    _icon.contentTintColor = NSColor.whiteColor;
+    _label = [NSTextField labelWithString:action[@"title"]];
+    _label.font = [NSFont systemFontOfSize:11 weight:NSFontWeightSemibold];
+    _label.textColor = NSColor.whiteColor;
+    _label.alignment = NSTextAlignmentCenter;
+    _label.lineBreakMode = NSLineBreakByTruncatingTail;
+    [self addSubview:_icon];
+    [self addSubview:_label];
+    self.accessibilityElement = YES;
+    self.accessibilityRole = NSAccessibilityButtonRole;
+    self.accessibilityLabel = action[@"title"];
+  }
+  return self;
+}
+- (BOOL)isFlipped { return YES; }
+- (BOOL)acceptsFirstMouse:(NSEvent *)event { return YES; }
+// Non-opaque views drag the window by default, which would swallow the click.
+- (BOOL)mouseDownCanMoveWindow { return NO; }
+- (void)layout
+{
+  [super layout];
+  NSRect bounds = self.bounds;
+  CGFloat slot = MIN(bounds.size.width, kButtonWidth);
+  CGFloat center = !_followsContent ? NSMidX(bounds) : _edge > 0 ? bounds.size.width - slot / 2 : slot / 2;
+  CGFloat iconSize = 22, labelHeight = 15, top = floor((bounds.size.height - iconSize - 3 - labelHeight) / 2);
+  _icon.frame = NSMakeRect(round(center - iconSize / 2), top, iconSize, iconSize);
+  _label.frame = NSMakeRect(round(center - kButtonWidth / 2) + 4, top + iconSize + 3, kButtonWidth - 8, labelHeight);
+  // Contents fade in as the button gains room, so a sliver never shows clipped glyphs.
+  CGFloat alpha = MAX(0, MIN(1, (bounds.size.width - 20) / 36));
+  _icon.alphaValue = alpha;
+  _label.alphaValue = alpha;
+}
+- (void)mouseDown:(NSEvent *)event {}
+- (void)mouseUp:(NSEvent *)event
+{
+  if (NSPointInRect([self convertPoint:event.locationInWindow fromView:nil], self.bounds)) [_owner performActionForButton:self];
+}
+- (BOOL)accessibilityPerformPress { [_owner performActionForButton:self]; return YES; }
+@end
+
+static __weak RNSwipeActions *RNSwipeOpenRow;
+
+@implementation RNSwipeActions {
+  NSView *_clipView;
+  NSView *_actionsView;
+  NSView *_contentView;
+  NSArray<RNSwipeActionButton *> *_leading;
+  NSArray<RNSwipeActionButton *> *_trailing;
+  std::string _leadingJson;
+  std::string _trailingJson;
+  NSMutableArray<NSEvent *> *_pending;
+  RNSwipeGesture _gesture;
+  CGFloat _pendingX;
+  CGFloat _pendingY;
+  CGFloat _offset;
+  /** The button filling the revealed strip: the outermost once armed, or a tapped dismissing one. */
+  RNSwipeActionButton *_takeover;
+  BOOL _dismissed;
+  NSUInteger _generation;
+}
+
+- (instancetype)initWithFrame:(NSRect)frame
+{
+  if ((self = [super initWithFrame:frame])) {
+    _props = std::make_shared<const SwipeActionsProps>();
+    _clipView = [[RNSwipeContainerView alloc] initWithFrame:self.bounds];
+    _clipView.wantsLayer = YES;
+    // Fabric rewrites the host layer's masksToBounds from overflow props. Own this clip separately.
+    _clipView.layer.masksToBounds = YES;
+    [self addSubview:_clipView];
+    _actionsView = [[RNSwipeContainerView alloc] initWithFrame:self.bounds];
+    _actionsView.wantsLayer = YES;
+    _contentView = [[RNSwipeContainerView alloc] initWithFrame:self.bounds];
+    _contentView.wantsLayer = YES;
+    [_clipView addSubview:_actionsView];
+    [_clipView addSubview:_contentView];
+    _leading = @[];
+    _trailing = @[];
+    _pending = [NSMutableArray new];
+  }
+  return self;
+}
+
+- (BOOL)isFlipped { return YES; }
+
+#pragma mark - React
+
+- (void)mountChildComponentView:(RCTUIView<RCTComponentViewProtocol> *)childComponentView index:(NSInteger)index
+{
+  if (index < (NSInteger)_contentView.subviews.count) [_contentView addSubview:childComponentView positioned:NSWindowBelow relativeTo:_contentView.subviews[index]];
+  else [_contentView addSubview:childComponentView];
+}
+
+- (void)unmountChildComponentView:(RCTUIView<RCTComponentViewProtocol> *)childComponentView index:(NSInteger)index
+{
+  [childComponentView removeFromSuperview];
+}
+
+- (NSArray<RNSwipeActionButton *> *)buttonsFromJson:(const std::string &)json edge:(NSInteger)edge
+{
+  NSData *data = [NSData dataWithBytes:json.data() length:json.size()];
+  NSArray *actions = data.length ? [NSJSONSerialization JSONObjectWithData:data options:0 error:nil] : @[];
+  NSMutableArray *buttons = [NSMutableArray new];
+  for (NSDictionary *action in [actions isKindOfClass:NSArray.class] ? actions : @[]) {
+    RNSwipeActionButton *button = [[RNSwipeActionButton alloc] initWithAction:action];
+    button.edge = edge;
+    button.owner = self;
+    [buttons addObject:button];
+  }
+  return buttons;
+}
+
+- (void)updateProps:(Props::Shared const &)props oldProps:(Props::Shared const &)oldProps
+{
+  const auto &value = *std::static_pointer_cast<const SwipeActionsProps>(props);
+  if (value.leadingActionsJson != _leadingJson || value.trailingActionsJson != _trailingJson) {
+    _leadingJson = value.leadingActionsJson;
+    _trailingJson = value.trailingActionsJson;
+    for (NSView *button in [_leading arrayByAddingObjectsFromArray:_trailing]) [button removeFromSuperview];
+    _leading = [self buttonsFromJson:_leadingJson edge:1];
+    _trailing = [self buttonsFromJson:_trailingJson edge:-1];
+    for (NSView *button in [_leading arrayByAddingObjectsFromArray:_trailing]) [_actionsView addSubview:button];
+    [self resetPosition];
+  }
+  [super updateProps:props oldProps:oldProps];
+  // Revealed actions and slid-away content must never paint over neighboring rows.
+  self.clipsToBounds = YES;
+}
+
+- (void)updateLayoutMetrics:(const LayoutMetrics &)layoutMetrics oldLayoutMetrics:(const LayoutMetrics &)oldLayoutMetrics
+{
+  [super updateLayoutMetrics:layoutMetrics oldLayoutMetrics:oldLayoutMetrics];
+  [self layoutSubviews];
+}
+
+- (void)layoutSubviews
+{
+  [super layoutSubviews];
+  _clipView.frame = self.bounds;
+  _actionsView.frame = _clipView.bounds;
+  if (_dismissed) _offset = _offset > 0 ? self.bounds.size.width : -self.bounds.size.width;
+  [self applyOffset];
+}
+
+- (void)prepareForRecycle
+{
+  [super prepareForRecycle];
+  [self resetPosition];
+}
+
+- (void)resetPosition
+{
+  // Invalidate delayed action completions before this view acquires a new owner or actions.
+  ++_generation;
+  if (RNSwipeOpenRow == self) RNSwipeOpenRow = nil;
+  [_pending removeAllObjects];
+  _gesture = RNSwipeGestureIdle;
+  _offset = 0;
+  _takeover = nil;
+  _dismissed = NO;
+  [self applyOffset];
+}
+
++ (ComponentDescriptorProvider)componentDescriptorProvider
+{
+  return concreteComponentDescriptorProvider<SwipeActionsComponentDescriptor>();
+}
+
+#pragma mark - Layout
+
+- (void)applyOffset
+{
+  NSRect bounds = _clipView.bounds;
+  _contentView.frame = NSOffsetRect(bounds, _offset, 0);
+  [self layoutButtons:_leading reveal:MAX(0, _offset) bounds:bounds];
+  [self layoutButtons:_trailing reveal:MAX(0, -_offset) bounds:bounds];
+}
+
+/** The first action sits at the outer edge; a takeover button fills the whole revealed strip. */
+- (void)layoutButtons:(NSArray<RNSwipeActionButton *> *)buttons reveal:(CGFloat)reveal bounds:(NSRect)bounds
+{
+  CGFloat height = bounds.size.height, width = bounds.size.width, each = buttons.count ? reveal / buttons.count : 0;
+  [buttons enumerateObjectsUsingBlock:^(RNSwipeActionButton *button, NSUInteger index, BOOL *stop) {
+    BOOL takesAll = button == self->_takeover, collapsed = !takesAll && [buttons containsObject:self->_takeover];
+    CGFloat size = takesAll ? reveal : collapsed ? 0 : each;
+    CGFloat inner = takesAll ? 0 : collapsed ? reveal : index * each;
+    CGFloat x = button.edge > 0 ? inner : width - inner - size;
+    button.followsContent = takesAll;
+    button.frame = NSMakeRect(x, 0, size, height);
+    button.needsLayout = YES;
+    [button layoutSubtreeIfNeeded];
+  }];
+}
+
+- (NSArray<RNSwipeActionButton *> *)buttonsForOffset:(CGFloat)offset { return offset > 0 ? _leading : offset < 0 ? _trailing : @[]; }
+
+- (CGFloat)commitDistance
+{
+  CGFloat width = self.bounds.size.width;
+  return MIN(MAX(width * 0.45, 150), width - 24);
+}
+
+#pragma mark - Gesture
+
+- (CGFloat)resisted:(CGFloat)offset
+{
+  if ([self buttonsForOffset:offset].count) return MAX(-self.bounds.size.width, MIN(self.bounds.size.width, offset));
+  CGFloat distance = fabs(offset);
+  return copysign(kRubberLimit * distance / (distance + kRubberLimit), offset);
+}
+
+- (void)scrollWheel:(NSEvent *)event
+{
+  if (_dismissed || (!_leading.count && !_trailing.count)) { [super scrollWheel:event]; return; }
+  // Momentum and plain mouse wheels carry no gesture phase.
+  if (event.phase == NSEventPhaseNone || event.phase == NSEventPhaseMayBegin) {
+    if (_gesture == RNSwipeGestureTracking && event.momentumPhase != NSEventPhaseNone) return;
+    [super scrollWheel:event];
+    return;
+  }
+  if (event.phase == NSEventPhaseBegan) {
+    [_pending removeAllObjects];
+    _gesture = RNSwipeGestureUndecided;
+    _pendingX = 0;
+    _pendingY = 0;
+  }
+  CGFloat dx = event.directionInvertedFromDevice ? event.scrollingDeltaX : -event.scrollingDeltaX;
+  BOOL ended = event.phase == NSEventPhaseEnded || event.phase == NSEventPhaseCancelled;
+
+  if (_gesture == RNSwipeGestureUndecided) {
+    // Held back until the axis is clear, then replayed to the list if the gesture is vertical.
+    [_pending addObject:event];
+    _pendingX += dx;
+    _pendingY += event.scrollingDeltaY;
+    if (!ended && hypot(_pendingX, _pendingY) < kAxisDistance) return;
+    if (!ended && fabs(_pendingX) > fabs(_pendingY) * 1.4) {
+      _gesture = RNSwipeGestureTracking;
+      [_pending removeAllObjects];
+      if (RNSwipeOpenRow && RNSwipeOpenRow != self) [RNSwipeOpenRow close];
+      [self trackBy:_pendingX];
+      return;
+    }
+    _gesture = RNSwipeGesturePassing;
+    if (RNSwipeOpenRow) [RNSwipeOpenRow close];
+    NSArray *replay = [_pending copy];
+    [_pending removeAllObjects];
+    for (NSEvent *pending in replay) [super scrollWheel:pending];
+    return;
+  }
+  if (_gesture == RNSwipeGestureTracking) {
+    if (event.phase == NSEventPhaseCancelled) [self close];
+    else if (ended) [self settle];
+    else [self trackBy:dx];
+    return;
+  }
+  [super scrollWheel:event];
+}
+
+- (void)trackBy:(CGFloat)dx
+{
+  // Accumulate in unresisted space so rubber-banding does not drift.
+  CGFloat raw = _offset + dx;
+  if (![self buttonsForOffset:_offset].count && _offset != 0) {
+    CGFloat distance = fabs(_offset);
+    raw = copysign(kRubberLimit * distance / MAX(kRubberLimit - distance, 1), _offset) + dx;
+  }
+  _offset = [self resisted:raw];
+  NSArray<RNSwipeActionButton *> *buttons = [self buttonsForOffset:_offset];
+  CGFloat restDistance = MIN(kButtonWidth * buttons.count, self.bounds.size.width);
+  // A closing gesture must never arm just because the resting buttons exceed the threshold.
+  RNSwipeActionButton *takeover = fabs(_offset) > restDistance && fabs(_offset) >= [self commitDistance] ? buttons.firstObject : nil;
+  if (takeover != _takeover) {
+    _takeover = takeover;
+    [NSHapticFeedbackManager.defaultPerformer performFeedbackPattern:NSHapticFeedbackPatternAlignment performanceTime:NSHapticFeedbackPerformanceTimeNow];
+    RNSwipeAnimate(0.22, ^{ [self applyOffset]; }, nil);
+    return;
+  }
+  [self applyOffset];
+}
+
+// The gesture stays Tracking until the next one begins, so its momentum never scrolls the list.
+- (void)settle
+{
+  NSArray<RNSwipeActionButton *> *buttons = [self buttonsForOffset:_offset];
+  if (_takeover) { [self commit:_takeover]; return; }
+  if (buttons.count && fabs(_offset) > kButtonWidth * 0.5) {
+    _offset = copysign(MIN(kButtonWidth * buttons.count, self.bounds.size.width), _offset);
+    RNSwipeOpenRow = self;
+    RNSwipeAnimate(0.34, ^{ [self applyOffset]; }, nil);
+    return;
+  }
+  [self close];
+}
+
+- (void)close
+{
+  if (RNSwipeOpenRow == self) RNSwipeOpenRow = nil;
+  if (_offset == 0 || _dismissed) return;
+  _offset = 0;
+  _takeover = nil;
+  RNSwipeAnimate(0.32, ^{ [self applyOffset]; }, nil);
+}
+
+- (void)performActionForButton:(RNSwipeActionButton *)button
+{
+  if (_dismissed) return;
+  [self commit:button];
+}
+
+/** Dismissing actions carry the row away and report once it is gone; others report while it springs back. */
+- (void)commit:(RNSwipeActionButton *)button
+{
+  if (RNSwipeOpenRow == self) RNSwipeOpenRow = nil;
+  NSString *actionId = button.actionId;
+  if (!button.dismisses) {
+    [self close];
+    [self emit:actionId];
+    return;
+  }
+  _dismissed = YES;
+  _takeover = button;
+  _offset = button.edge * self.bounds.size.width;
+  NSUInteger generation = _generation;
+  __weak RNSwipeActions *weakSelf = self;
+  RNSwipeAnimate(0.26, ^{ [self applyOffset]; }, ^{
+    RNSwipeActions *view = weakSelf;
+    if (view && view->_generation == generation && view->_dismissed) [view emit:actionId];
+  });
+}
+
+- (void)emit:(NSString *)actionId
+{
+  auto emitter = std::static_pointer_cast<const SwipeActionsEventEmitter>(_eventEmitter);
+  if (emitter) emitter->onSwipeAction({.actionId = std::string(actionId.UTF8String)});
+}
+
+#pragma mark - Clicks while open
+
+- (NSView *)hitTest:(CGPoint)point withEvent:(UIEvent *)event
+{
+  NSView *hit = [super hitTest:point withEvent:event];
+  // Fabric parents use this local-coordinate route; AppKit's route delegates here too.
+  // Respect the superclass visibility/pointer-events result before consuming a close click.
+  if (hit && _offset != 0 && !_dismissed && NSPointInRect(point, self.bounds) && NSPointInRect(point, _contentView.frame)) return self;
+  return hit;
+}
+
+- (BOOL)mouseDownCanMoveWindow { return _offset == 0 && super.mouseDownCanMoveWindow; }
+
+- (void)mouseDown:(NSEvent *)event
+{
+  if (_offset != 0) [self close];
+  else [super mouseDown:event];
+}
+
+@end

package/vendor/node_modules/@legendapp/spark-ui/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@legendapp/spark-ui",
-  "version": "0.0.1-next.3",
+  "version": "0.0.1-next.4",
   "license": "MIT",
   "main": "src/index",
   "react-native": "src/index",
@@ -43,6 +43,7 @@
         "Sidebar": "RNSidebar",
         "SidebarItem": "RNSidebarItem",
         "SFSymbol": "RNSFSymbol",
+        "SwipeActions": "RNSwipeActions",
         "NativeSelect": "RNNativeSelect",
         "NativeSegmentedControl": "RNNativeSegmentedControl",
         "TextInputSearch": "RNTextInputSearch"
@@ -68,6 +69,6 @@
   "dependencies": {
     "clsx": "^2.1.1",
     "tailwind-merge": "^3.4.0",
-    "@legendapp/spark-desktop-app": "0.0.1-next.3"
+    "@legendapp/spark-desktop-app": "0.0.1-next.4"
   }
 }

package/vendor/node_modules/@legendapp/spark-ui/src/appkit-split-view/SidebarSplitViewNativeComponent.ts

@@ -9,6 +9,9 @@ export type SidebarSplitViewResizeEvent = Readonly<{
   height: Double;
   isLayoutReady: boolean;
   isVertical: boolean;
+  listHeight: Double;
+  listWidth: Double;
+  listX: Double;
   sidebarHeight: Double;
   sidebarWidth: Double;
 }>;
@@ -20,6 +23,9 @@ export interface NativeProps extends ViewProps {
   contentTitlebarOverlayColor?: string;
   contentTitlebarOverlayOpacity?: Double;
   contentMinWidth?: Double;
+  hasList?: boolean;
+  listMinWidth?: Double;
+  listWidth?: Double;
   onSplitViewDidResize?: DirectEventHandler<SidebarSplitViewResizeEvent>;
   sidebarCollapsed?: boolean;
   sidebarMinWidth?: Double;

package/vendor/node_modules/@legendapp/spark-ui/src/appkit-split-view/index.tsx

@@ -6,8 +6,8 @@ import { appearance, callback, finite, macosViewAvailability, type SpecializedVi
 import NativeSplitView from "./SidebarSplitViewNativeComponent";
 export type SidebarSplitViewAppearance = "system" | "light" | "dark";
 export type SidebarSplitViewTitlebarMaterial = "none" | "glass" | "titlebar" | "headerView" | "hudWindow" | "sidebar" | "windowBackground";
-export interface SidebarSplitViewPaneMetrics { contentHeight: number; contentWidth: number; sidebarHeight: number; sidebarWidth: number }
-export interface SidebarSplitViewResizeEvent extends SidebarSplitViewPaneMetrics { contentX: number; height: number; phase: "provisional" | "ready" }
+export interface SidebarSplitViewPaneMetrics { contentHeight: number; contentWidth: number; sidebarHeight: number; sidebarWidth: number; listHeight?: number; listWidth?: number }
+export interface SidebarSplitViewResizeEvent extends SidebarSplitViewPaneMetrics { listHeight: number; listWidth: number; contentX: number; listX: number; height: number; phase: "provisional" | "ready" }
 export interface SplitViewTitleBarOverlay { color: string; opacity?: number }
 export interface SplitViewTitleBarOptions {
   content?: { height?: number; material?: SidebarSplitViewTitlebarMaterial; overlay?: SplitViewTitleBarOverlay };
@@ -16,11 +16,15 @@ export interface SplitViewTitleBarOptions {
 export interface SidebarSplitViewProps extends Omit<SpecializedViewProps, "children"> {
   sidebar: ReactNode;
   content: ReactNode;
+  /** Optional middle column (AppKit content list, as in Mail): sidebar | list | content in one native split. */
+  list?: ReactNode;
   children?: never;
   appearance?: SidebarSplitViewAppearance;
   contentMinWidth?: number;
   sidebarMinWidth?: number;
   sidebarWidth?: number;
+  listMinWidth?: number;
+  listWidth?: number;
   sidebarCollapsed?: boolean;
   /** Used only for initial layout, before native measurements arrive. */
   initialPaneMetrics?: SidebarSplitViewPaneMetrics;
@@ -31,7 +35,9 @@ export function getSplitViewAvailability() { return macosViewAvailability("Sideb
 function metrics(value: SidebarSplitViewPaneMetrics) {
   if (!value || typeof value !== "object") throw new SparkError("E_INVALID_ARGUMENT", "Expected pane metrics");
   for (const key of ["contentHeight", "contentWidth", "sidebarHeight", "sidebarWidth"] as const) finite(value[key], key);
+  for (const key of ["listHeight", "listWidth"] as const) if (value[key] !== undefined) finite(value[key], key);
 }
+const paneKeys = ["contentHeight", "contentWidth", "sidebarHeight", "sidebarWidth", "listHeight", "listWidth"] as const;
 function keys(value: unknown, allowed: readonly string[]) {
   if (!value || typeof value !== "object" || Array.isArray(value)) throw new SparkError("E_INVALID_ARGUMENT", "Expected title-bar options");
   for (const key of Object.keys(value)) if (!allowed.includes(key)) throw new SparkError("E_UNSUPPORTED_OPTION", `Unknown title-bar option: ${key}`);
@@ -42,9 +48,11 @@ function overlay(value?: SplitViewTitleBarOverlay) {
   if (typeof value.color !== "string" || !/^#(?:[\da-f]{6}|[\da-f]{8})$/i.test(value.color)) throw new SparkError("E_INVALID_ARGUMENT", "Expected #RRGGBB or #RRGGBBAA title-bar color");
   if (value.opacity !== undefined) finite(value.opacity, "overlay opacity", 0, 1);
 }
-export function SidebarSplitView({ sidebar, content, children, appearance: theme = "system", contentMinWidth = 320, sidebarMinWidth = 180, sidebarWidth, sidebarCollapsed = false, initialPaneMetrics, titleBar = {}, onResize, ref, onError, ...props }: SidebarSplitViewProps) {
-  appearance(theme); finite(contentMinWidth, "minimum content width"); finite(sidebarMinWidth, "minimum sidebar width");
+export function SidebarSplitView({ sidebar, content, list, children, appearance: theme = "system", contentMinWidth = 320, sidebarMinWidth = 180, sidebarWidth, listMinWidth = 240, listWidth, sidebarCollapsed = false, initialPaneMetrics, titleBar = {}, onResize, ref, onError, ...props }: SidebarSplitViewProps) {
+  appearance(theme); finite(contentMinWidth, "minimum content width"); finite(sidebarMinWidth, "minimum sidebar width"); finite(listMinWidth, "minimum list width");
   if (sidebarWidth !== undefined) finite(sidebarWidth, "sidebar width", sidebarMinWidth);
+  if (listWidth !== undefined) finite(listWidth, "list width", listMinWidth);
+  const hasList = list !== undefined && list !== null && typeof list !== "boolean" && list !== "";
   if (typeof sidebarCollapsed !== "boolean" || children !== undefined) throw new SparkError("E_INVALID_ARGUMENT", "Use named sidebar/content panes and a boolean collapsed state");
   if (initialPaneMetrics !== undefined) metrics(initialPaneMetrics);
   keys(titleBar, ["content", "sidebar"]);
@@ -56,22 +64,23 @@ export function SidebarSplitView({ sidebar, content, children, appearance: theme
   callback(onResize, "resize");
   const control = useControl({ ref, onError }, getSplitViewAvailability());
   const [paneMetrics, setPaneMetrics] = useState<SidebarSplitViewPaneMetrics | undefined>(() => initialPaneMetrics ? { ...initialPaneMetrics } : undefined);
-  function resize(event: NativeSyntheticEvent<SidebarSplitViewPaneMetrics & { contentX: number; height: number; isLayoutReady: boolean }>) {
+  function resize(event: NativeSyntheticEvent<SidebarSplitViewPaneMetrics & { contentX: number; listX: number; height: number; isLayoutReady: boolean }>) {
     if (!control.active()) return;
     let value: SidebarSplitViewResizeEvent;
     try {
-      const data = event?.nativeEvent; metrics(data); finite(data.contentX, "content x", -Infinity); finite(data.height, "height");
+      const data = event?.nativeEvent; metrics(data); finite(data.listHeight, "list height"); finite(data.listWidth, "list width"); finite(data.contentX, "content x", -Infinity); finite(data.listX, "list x", -Infinity); finite(data.height, "height");
       if (typeof data.isLayoutReady !== "boolean") throw new Error("Expected layout readiness");
-      value = { contentHeight: data.contentHeight, contentWidth: data.contentWidth, sidebarHeight: data.sidebarHeight, sidebarWidth: data.sidebarWidth, contentX: data.contentX, height: data.height, phase: data.isLayoutReady ? "ready" : "provisional" };
+      value = { contentHeight: data.contentHeight, contentWidth: data.contentWidth, sidebarHeight: data.sidebarHeight, sidebarWidth: data.sidebarWidth, listHeight: data.listHeight, listWidth: data.listWidth, contentX: data.contentX, listX: data.listX, height: data.height, phase: data.isLayoutReady ? "ready" : "provisional" };
     } catch (cause) { control.error(new SparkError("E_INVALID_DATA", "Invalid split-view layout", { cause })); return; }
-    setPaneMetrics(current => current && ["contentHeight", "contentWidth", "sidebarHeight", "sidebarWidth"].every(key => current[key as keyof SidebarSplitViewPaneMetrics] === value[key as keyof SidebarSplitViewPaneMetrics]) ? current : value);
+    setPaneMetrics(current => current && paneKeys.every(key => current[key] === value[key]) ? current : value);
     onResize?.(value);
   }
-  if (control.failed) return <View {...props} ref={control.ref} style={[{ flexDirection: "row" }, props.style]}>{sidebarCollapsed ? null : sidebar}{content}</View>;
-  return <NativeSplitView {...props} ref={control.ref} appearance={theme} contentMinWidth={contentMinWidth} sidebarMinWidth={sidebarMinWidth} sidebarWidth={sidebarWidth} sidebarCollapsed={sidebarCollapsed} onSplitViewDidResize={resize}
+  if (control.failed) return <View {...props} ref={control.ref} style={[{ flexDirection: "row" }, props.style]}>{sidebarCollapsed ? null : sidebar}{list}{content}</View>;
+  return <NativeSplitView {...props} ref={control.ref} appearance={theme} contentMinWidth={contentMinWidth} sidebarMinWidth={sidebarMinWidth} sidebarWidth={sidebarWidth} hasList={hasList} listMinWidth={listMinWidth} listWidth={listWidth} sidebarCollapsed={sidebarCollapsed} onSplitViewDidResize={resize}
     contentTitlebarHeight={titleBar.content?.height ?? 0} contentTitlebarMaterial={material} contentTitlebarOverlayColor={titleBar.content?.overlay?.color} contentTitlebarOverlayOpacity={titleBar.content?.overlay?.opacity ?? (titleBar.content?.overlay ? 1 : 0)}
     sidebarTitlebarOverlayColor={titleBar.sidebar?.overlay?.color} sidebarTitlebarOverlayOpacity={titleBar.sidebar?.overlay?.opacity ?? (titleBar.sidebar?.overlay ? 1 : 0)}>
     <View key="sidebar" style={{ position: "absolute", top: 0, left: 0, minWidth: 0, height: paneMetrics?.sidebarHeight, width: sidebarCollapsed ? 0 : paneMetrics?.sidebarWidth ?? sidebarWidth ?? sidebarMinWidth }}>{sidebar}</View>
-    <View key="content" style={{ position: "absolute", top: 0, left: 0, minWidth: 0, height: paneMetrics?.contentHeight, width: paneMetrics?.contentWidth }}>{content}</View>
+    <View key="content" style={{ position: "absolute", top: 0, left: 0, minWidth: 0, overflow: "hidden", height: paneMetrics?.contentHeight, width: paneMetrics?.contentWidth }}>{content}</View>
+    {hasList ? <View key="list" style={{ position: "absolute", top: 0, left: 0, minWidth: 0, height: paneMetrics?.listHeight, width: paneMetrics?.listWidth ?? listWidth ?? listMinWidth }}>{list}</View> : null}
   </NativeSplitView>;
 }

package/vendor/node_modules/@legendapp/spark-ui/src/swipe-actions/SwipeActionsNativeComponent.ts

@@ -0,0 +1,11 @@
+import type { HostComponent, ViewProps } from "react-native";
+import { codegenNativeComponent } from "react-native";
+import type { DirectEventHandler } from "react-native/Libraries/Types/CodegenTypes";
+
+export interface NativeProps extends ViewProps {
+  leadingActionsJson: string;
+  trailingActionsJson: string;
+  onSwipeAction?: DirectEventHandler<Readonly<{ actionId: string }>>;
+}
+
+export default codegenNativeComponent<NativeProps>("SwipeActions") as HostComponent<NativeProps>;

package/vendor/node_modules/@legendapp/spark-ui/src/swipe-actions/index.tsx

@@ -0,0 +1,41 @@
+import { View, type NativeSyntheticEvent } from "react-native";
+import { SparkError } from "@legendapp/spark-desktop-app/src/contracts";
+import { useControl } from "../control";
+import { identifier, macosViewAvailability, type SpecializedViewProps } from "../specialized";
+import NativeSwipeActions from "./SwipeActionsNativeComponent";
+/** `dismisses` slides the row away on commit; remove or remount the row to recover after failure/undo. */
+export interface SwipeAction { id: string; title: string; symbol: string; color: string; dismisses?: boolean }
+export interface SwipeActionsProps extends SpecializedViewProps {
+  /** Revealed by swiping right; the first action is outermost and runs on a full swipe. */
+  leadingActions?: readonly SwipeAction[];
+  /** Revealed by swiping left; the first action is outermost and runs on a full swipe. */
+  trailingActions?: readonly SwipeAction[];
+  onAction: (id: string) => void;
+}
+const hexColor = /^#(?:[0-9a-f]{6}|[0-9a-f]{8})$/i;
+function actionsJson(actions: readonly SwipeAction[], ids: Set<string>) {
+  if (!Array.isArray(actions)) throw new SparkError("E_INVALID_ARGUMENT", "Swipe actions must be arrays");
+  for (const action of actions) {
+    identifier(action?.id, "swipe action ID"); identifier(action.title, "swipe action title"); identifier(action.symbol, "swipe action symbol");
+    if (typeof action.color !== "string" || !hexColor.test(action.color)) throw new SparkError("E_INVALID_ARGUMENT", "Swipe action colors are #RRGGBB or #RRGGBBAA");
+    if (action.dismisses !== undefined && typeof action.dismisses !== "boolean") throw new SparkError("E_INVALID_ARGUMENT", "Invalid swipe action dismisses");
+    if (ids.has(action.id)) throw new SparkError("E_INVALID_ARGUMENT", "Duplicate swipe action ID");
+    ids.add(action.id);
+  }
+  return JSON.stringify(actions.map(({ id, title, symbol, color, dismisses = false }) => ({ id, title, symbol, color, dismisses })));
+}
+export function getSwipeActionsAvailability() { return macosViewAvailability("SwipeActions"); }
+/** Native trackpad swipe actions. In recycling lists, key this view by the logical row ID. */
+export function SwipeActions({ leadingActions = [], trailingActions = [], onAction, ref, onError, ...props }: SwipeActionsProps) {
+  if (typeof onAction !== "function") throw new SparkError("E_INVALID_ARGUMENT", "Expected swipe action callback");
+  const ids = new Set<string>(), leading = actionsJson(leadingActions, ids), trailing = actionsJson(trailingActions, ids);
+  const control = useControl({ ref, onError }, getSwipeActionsAvailability());
+  function action(event: NativeSyntheticEvent<{ actionId: string }>) {
+    if (!control.active()) return;
+    const id = event?.nativeEvent?.actionId;
+    if (typeof id !== "string" || !ids.has(id)) { control.error(new SparkError("E_INVALID_DATA", "Invalid swipe action")); return; }
+    onAction(id);
+  }
+  if (control.failed) return <View {...props} ref={control.ref} />;
+  return <NativeSwipeActions {...props} ref={control.ref} leadingActionsJson={leading} trailingActionsJson={trailing} onSwipeAction={action} />;
+}

package/vendor/node_modules/@legendapp/spark-updates/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@legendapp/spark-updates",
-  "version": "0.0.1-next.3",
+  "version": "0.0.1-next.4",
   "license": "MIT",
   "main": "src/index.ts",
   "react-native": "src/index.ts",
@@ -38,7 +38,7 @@
     ]
   },
   "dependencies": {
-    "@legendapp/spark-desktop-app": "0.0.1-next.3"
+    "@legendapp/spark-desktop-app": "0.0.1-next.4"
   },
   "private": true
 }

package/vendor/node_modules/@legendapp/spark-webview/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@legendapp/spark-webview",
-  "version": "0.0.1-next.3",
+  "version": "0.0.1-next.4",
   "license": "MIT",
   "main": "src/index.ts",
   "react-native": "src/index.ts",
@@ -9,7 +9,7 @@
   ],
   "dependencies": {
     "react-native-webview": "16.0.0",
-    "@legendapp/spark-desktop-app": "0.0.1-next.3"
+    "@legendapp/spark-desktop-app": "0.0.1-next.4"
   },
   "private": true
 }

package/vendor/node_modules/@legendapp/spark-window-options/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@legendapp/spark-window-options",
-  "version": "0.0.1-next.3",
+  "version": "0.0.1-next.4",
   "license": "MIT",
   "main": "index.cjs",
   "types": "index.d.ts",