Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 14 additions & 3 deletions packages/gnome-shell/src/ui/appDisplay.d.ts
Original file line number Diff line number Diff line change
Expand Up @@ -117,7 +117,13 @@ export abstract class BaseAppView extends St.Widget {

_onDestroy(): void;
_createGrid(): AppGrid;
_onScroll(actor: St.ScrollView, event: Clutter.ScrollEvent): boolean;
/**
* Handles the `scroll` signal of the page's scroll controller. GNOME 51
* replaced the old `(actor, event)` handler with these arguments.
*
* @version 51
*/
_onScroll(controller: Clutter.ScrollController, sprite: Clutter.Sprite, source: Clutter.ScrollSource, dx: number, dy: number): void;
_swipeBegin(tracker: any, monitor: Clutter.EventSequence): void;
_swipeUpdate(tracker: any, progress: number): void;
_swipeEnd(tracker: any, duration: number, endProgress: number): void;
Expand Down Expand Up @@ -226,8 +232,13 @@ export class AppDisplay extends BaseAppView {
_getItemPosition(item: AppViewItem): [number, number];
_compareItems(a: AppViewItem, b: AppViewItem): number;
_loadApps(): AppViewItem[];
_onScroll(actor: St.ScrollView, event: Clutter.ScrollEvent): boolean;
_onKeyPressEvent(actor: St.Widget, event: Clutter.KeyEvent): boolean;
/**
* Handles the `scroll` signal of the page's scroll controller. GNOME 51
* replaced the old `(actor, event)` handler with these arguments.
*
* @version 51
*/
_onScroll(controller: Clutter.ScrollController, sprite: Clutter.Sprite, source: Clutter.ScrollSource, dx: number, dy: number): void;
_maybeMoveItem(dragEvent: DragEvent): void;
/** @hidden */
_onDragBegin(): void;
Expand Down
1 change: 0 additions & 1 deletion packages/gnome-shell/src/ui/appFavorites.d.ts
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,6 @@ declare class AppFavorites extends EventEmitter {

constructor();

_onFavsChanged(): void;
_getIds(): string[];
_addFavorite(appId: string, pos: number): void;
_removeFavorite(appId: string): void;
Expand Down
6 changes: 2 additions & 4 deletions packages/gnome-shell/src/ui/boxpointer.d.ts
Original file line number Diff line number Diff line change
Expand Up @@ -27,8 +27,8 @@ export class BoxPointer extends St.Widget {
_border: St.DrawingArea;
_arrowAlignment: number;
_sourceAlignment: number;
_muteKeys: boolean;
_muteInput: boolean;
_muteKeys: Clutter.KeyController;
_muteInput: Clutter.ClickGesture;
_sourceActor: Clutter.Actor | null;
_sourceExtents: ReturnType<typeof Clutter.Actor.prototype.get_transformed_extents>;
_workArea: ReturnType<typeof LayoutManager.prototype.getWorkAreaForMonitor>;
Expand All @@ -51,8 +51,6 @@ export class BoxPointer extends St.Widget {
*/
_init(arrowSide: St.Side, binProperties?: Partial<St.Bin.ConstructorProps>): void;

vfunc_captured_event(event: Clutter.Event): boolean;

vfunc_get_preferred_width(forHeight: number): [number, number];

vfunc_get_preferred_height(forWidth: number): [number, number];
Expand Down
22 changes: 7 additions & 15 deletions packages/gnome-shell/src/ui/calendar.d.ts
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,6 @@ import type Gio from '@girs/gio-2.0';
import type St from '@girs/st-51';
import type Clutter from '@girs/clutter-51';

import type { Switch } from './popupMenu.js';
import type { MessageView } from './messageList.js';

declare function sameYear(dateA: Date, dateB: Date): boolean;
Expand Down Expand Up @@ -154,7 +153,13 @@ export class Calendar extends St.Widget {

updateTimeZone(): void;

vfunc_scroll_event(event: Clutter.ScrollEvent): boolean;
/**
* Handles the `scroll` signal of the calendar's scroll controller, which
* flips to the previous or next month.
*
* @version 51
*/
_onScroll(controller: Clutter.ScrollController, sprite: Clutter.Sprite, source: Clutter.ScrollSource, dx: number, dy: number): void;

_buildHeader(): void;
_onPrevMonthButtonClicked(): void;
Expand All @@ -174,17 +179,6 @@ declare class Placeholder extends St.BoxLayout {
_init(): void;
}

declare class DoNotDisturbSwitch extends Switch {
_settings: Gio.Settings;

constructor();
/** @hidden */
override _init(config?: Partial<St.Bin.ConstructorProps>): void;
/** @hidden */
override _init(state: boolean): void;
_init(): void;
}

/**
* @see https://gitlab.gnome.org/GNOME/gnome-shell/-/blob/main/js/ui/calendar.js#L799
* @version 48
Expand All @@ -193,8 +187,6 @@ declare class DoNotDisturbSwitch extends Switch {
export class CalendarMessageList extends St.Widget {
_placeholder: Placeholder;
_scrollView: St.ScrollView;
_dndSwitch: DoNotDisturbSwitch;
_dndButton: St.Button;
_clearButton: St.Button;
_messageView: MessageView;

Expand Down
1 change: 0 additions & 1 deletion packages/gnome-shell/src/ui/dialog.d.ts
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,6 @@ export class Dialog extends St.Widget {

_init(parentActor: St.Widget, styleClass?: string | null): void;
makeInactive(): void;
vfunc_event(event: Clutter.Event): boolean;
addButton(buttonInfo: ButtonInfo): St.Button;
clearButtons(): void;

Expand Down
6 changes: 0 additions & 6 deletions packages/gnome-shell/src/ui/layout.d.ts
Original file line number Diff line number Diff line change
Expand Up @@ -112,7 +112,6 @@ declare class ScreenTransition extends Clutter.Actor {
* @version 48
*/
declare class HotCorner extends Clutter.Actor {
_entered: boolean;
_monitor: Monitor;
_x: number;
_y: number;
Expand All @@ -126,13 +125,9 @@ declare class HotCorner extends Clutter.Actor {

setBarrierSize(size: number): void;
handleDragOver(source: any, actor: any, x: number, y: number, time: number): DragMotionResult;
vfunc_leave_event(event: Clutter.Event): boolean;

_setupFallbackCornerIfNeeded(layoutManager: LayoutManager): void;
_onDestroy(): void;
_toggleOverview(): void;
_onCornerEntered(): void;
_onCornerLeft(actor: Clutter.Actor, event: Clutter.Event): void;
}

/**
Expand All @@ -159,7 +154,6 @@ export class LayoutManager extends GObject.Object {
_keyboardHeightNotifyId: number;
_backgroundGroup: Meta.BackgroundGroup;
_interfaceSettings: Gio.Settings;
_pendingLoadBackground: boolean;
_systemBackground: SystemBackground;

readonly _startingUp: boolean;
Expand Down
32 changes: 22 additions & 10 deletions packages/gnome-shell/src/ui/messageList.d.ts
Original file line number Diff line number Diff line change
Expand Up @@ -19,10 +19,21 @@ export class URLHighlighter extends St.Label {
_init(params?: Partial<St.Label.ConstructorProps>): void;
_init(text?: string, lineWrap?: boolean, allowMarkup?: boolean): void;

vfunc_button_press_event(buttonEvent: Clutter.ButtonEvent): boolean;
vfunc_button_release_event(buttonEvent: Clutter.ButtonEvent): boolean;
vfunc_motion_event(motionEvent: Clutter.MotionEvent): boolean;
vfunc_leave_event(crossingEvent: Clutter.CrossingEvent): boolean;
/**
* Handles the `motion` signal of the label's motion controller, which sets
* the pointer cursor over a URL.
*
* @version 51
*/
_onMotion(controller: Clutter.MotionController, sprite: Clutter.Sprite, x: number, y: number): void;

/**
* Handles the `leave` signal of the same controller and restores the
* default cursor.
*
* @version 51
*/
_onLeave(): void;
setMarkup(text?: string, allowMarkup?: boolean): void;

_highlightUrls(): void;
Expand Down Expand Up @@ -117,7 +128,13 @@ export class Message extends St.Button {

canClose(): boolean;

vfunc_key_press_event(keyEvent: Clutter.KeyEvent): boolean;
/**
* Closes the message if its notification allows it. The BackSpace and
* Delete key bindings call this.
*
* @version 51
*/
_closeIfAllowed(): void;
}

/**
Expand All @@ -133,16 +150,11 @@ export class NotificationMessage extends Message {

vfunc_clicked(): void;
canClose(): boolean;

_getIcon(): St.Icon;
_onUpdated(n: Notification, _clear?: boolean): void;
}

declare class MediaMessage extends Message {
_player: MprisPlayer;
_icon: St.Icon;
_secondaryBin: St.Bin;
_closeButton: St.Button;
_prevButton: St.Button;
_playPauseButton: St.Button;
_nextButton: St.Button;
Expand Down
2 changes: 0 additions & 2 deletions packages/gnome-shell/src/ui/messageTray.d.ts
Original file line number Diff line number Diff line change
Expand Up @@ -340,13 +340,11 @@ export class MessageTray extends St.Widget {
_onDragBegin(): void;
_onDragEnd(): void;

_onNotificationKeyRelease(actor: St.Widget, event: Clutter.Event): boolean;
_expireNotification(): void;
_addSource(source: Source): void;
_removeSource(source: Source): void;
_onSourceEnableChanged(policy: NotificationPolicy, source: Source): void;
_onNotificationRemoved(source: Source, notification: Notification): void;
_onNotificationShow(_source: Source, notification: Notification): void;
_resetNotificationLeftTimeout(): void;
_onNotificationHoverChanged(): void;
_onStatusChanged(status: PresenceStatus): void;
Expand Down
1 change: 0 additions & 1 deletion packages/gnome-shell/src/ui/modalDialog.d.ts
Original file line number Diff line number Diff line change
Expand Up @@ -80,7 +80,6 @@ export class ModalDialog extends St.Widget {
_fadeOutDialog(timestamp: number): void;

vfunc_key_press_event(event: Clutter.Event): boolean;
vfunc_captured_event(event: Clutter.Event): boolean;

clearButtons(): void;
setButtons(buttons: ButtonInfo[]): void;
Expand Down
2 changes: 0 additions & 2 deletions packages/gnome-shell/src/ui/popupMenu.d.ts
Original file line number Diff line number Diff line change
Expand Up @@ -141,9 +141,7 @@ export class Switch extends St.Widget {
_startDragging(event: Clutter.Event): typeof Clutter.EVENT_PROPAGATE;
override vfunc_motion_event(event: Clutter.Event): typeof Clutter.EVENT_PROPAGATE;
override vfunc_button_release_event(event: Clutter.Event): typeof Clutter.EVENT_PROPAGATE;
_touchDragging(actor: Clutter.Actor, event: Clutter.Event): typeof Clutter.EVENT_PROPAGATE;
_endDragging(): typeof Clutter.EVENT_PROPAGATE;
_motionEvent(actor: Clutter.Actor, event: Clutter.Event): typeof Clutter.EVENT_PROPAGATE;

// General signal handler methods
connect(sigName: string, callback: (...args: any[]) => void): number;
Expand Down
26 changes: 25 additions & 1 deletion packages/gnome-shell/src/ui/search.d.ts
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,7 @@

import type St from '@girs/st-51';
import type Clutter from '@girs/clutter-51';
import type GObject from '@girs/gobject-2.0';

import { AppSearchProvider } from './appDisplay.js';

Expand All @@ -16,6 +17,30 @@ export interface MetaInfo {
clipboardText?: string;
}

export namespace SearchEntry {
export interface SignalSignatures extends St.Entry.SignalSignatures {
'activate-new-instance': () => void;
}
}

/**
* The overview's search entry. Ctrl+Enter emits `activate-new-instance` rather
* than activating the selected result.
*
* @version 51
*/
export class SearchEntry extends St.Entry {
$signals: SearchEntry.SignalSignatures;

// Signal handler methods
connect<S extends SearchEntry.SignalSignatures, K extends keyof S>(signal: K, callback: GObject.SignalCallback<this, S[K]>): number;
connect_after<S extends SearchEntry.SignalSignatures, K extends keyof S>(signal: K, callback: GObject.SignalCallback<this, S[K]>): number;

// Generic signal handler methods
connect(signal: string, callback: (...args: any[]) => any): number;
connect_after(signal: string, callback: (...args: any[]) => any): number;
}

export class MaxWidthBox extends St.BoxLayout {}

export class SearchResult extends St.Button {
Expand Down Expand Up @@ -125,7 +150,6 @@ export class SearchResultsView extends St.BoxLayout {
_doProviderSearch(provider: AppSearchProvider, previousResults: any[]): Promise<any[]>;
_doSearch(): void;
_onSearchTimeout(): void;
_onPan(action: any): void;
_focusChildChanged(provider: AppSearchProvider): void;
_ensureProviderDisplay(provider: AppSearchProvider): void;
_clearDisplay(): void;
Expand Down
70 changes: 20 additions & 50 deletions packages/gnome-shell/src/ui/slider.d.ts
Original file line number Diff line number Diff line change
Expand Up @@ -20,66 +20,36 @@ export class Slider extends BarLevel.BarLevel {
vfunc_repaint(): void;

/**
* Handles button press events, initiating dragging.
* @param event The Clutter button press event.
* @returns The event propagation status.
* Moves the value by the given number of scroll steps.
* @param nSteps The number of steps, negative to move towards the start.
* @returns Whether the value changed.
*/
vfunc_button_press_event(event: Clutter.Event): typeof Clutter.EVENT_PROPAGATE;
step(nSteps: number): boolean;

/**
* Starts dragging the slider.
* @param event The Clutter event initiating the drag.
* @returns The event propagation status.
* Handles the `scroll` signal of the smooth, horizontal scroll controller.
* The slider adds a second, discrete controller for the vertical axis, and
* that one has its own inline handler, so only `dx` arrives here.
*
* @version 51
*/
startDragging(event: Clutter.Event): typeof Clutter.EVENT_PROPAGATE;
_onScroll(controller: Clutter.ScrollController, sprite: Clutter.Sprite, source: Clutter.ScrollSource, dx: number): void;

/**
* Ends dragging the slider.
* @returns The event propagation status.
* Moves the handle a tenth of the range towards the left edge. The Left key
* binding calls it.
*
* @version 51
*/
_endDragging(): typeof Clutter.EVENT_PROPAGATE;
_moveLeft(): void;

/**
* Handles button release events.
* @returns The event propagation status.
* Moves the handle a tenth of the range towards the right edge. The Right
* key binding calls it.
*
* @version 51
*/
vfunc_button_release_event(): typeof Clutter.EVENT_PROPAGATE;

/**
* Handles touch events for the slider.
* @param event The Clutter touch event.
* @returns The event propagation status.
*/
vfunc_touch_event(event: Clutter.Event): typeof Clutter.EVENT_PROPAGATE;

/**
* Scrolls the slider.
* @param event The Clutter scroll event.
* @returns The event propagation status.
*/
scroll(event: Clutter.Event): typeof Clutter.EVENT_PROPAGATE;

/**
* Handles scroll events for the slider.
* @param event The Clutter scroll event.
* @returns The event propagation status.
*/
vfunc_scroll_event(event: Clutter.Event): typeof Clutter.EVENT_PROPAGATE;

/**
* Handles motion events during dragging.
* @param actor The actor receiving the motion event.
* @param event The Clutter motion event.
* @returns The event propagation status.
*/
_motionEvent(actor: Clutter.Actor, event: Clutter.Event): typeof Clutter.EVENT_PROPAGATE;

/**
* Handles key press events for the slider.
* @param event The Clutter key press event.
* @returns The event propagation status.
*/
vfunc_key_press_event(event: Clutter.Event): typeof Clutter.EVENT_PROPAGATE;
_moveRight(): void;

/**
* Moves the handle of the slider to a new position based on the given coordinates.
Expand Down
9 changes: 9 additions & 0 deletions packages/gnome-shell/src/ui/status/backlight.d.ts
Original file line number Diff line number Diff line change
@@ -1,3 +1,4 @@
import Clutter from '@girs/clutter-51';
import St from '@girs/st-51';
import Gio from '@girs/gio-2.0';

Expand Down Expand Up @@ -29,6 +30,14 @@ export declare class SliderItem extends PopupMenu.PopupBaseMenuItem {
* Sets the value of the slider.
*/
set value(value: number);

/**
* Forwards focus navigation to the slider, so Left and Right reach the
* slider's own key bindings.
*
* @version 51
*/
vfunc_navigate_focus(from: Clutter.Actor | null, direction: St.DirectionType): boolean;
}

/**
Expand Down
Loading