@girs/clutter-16 5.2.0 → 5.4.0

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.
@@ -0,0 +1,1587 @@
1
+ /**
2
+ * The GIR-derived widget VOCABULARY for Clutter-16.
3
+ *
4
+ * GENERATED — do not edit. Provenance: Clutter-16 — dropped empty base(s): Atk.ImplementorIface
5
+ *
6
+ * 59 instantiable GTypes (of which 0 concrete widgets), 70 declarations, 48 enum nick unions, 0 slot candidates.
7
+ *
8
+ * Module-scoped exports only. There is no `JSX` namespace here, no tag spelling and
9
+ * no `on<Signal>` prop name: those are DIALECT, and every framework answers them
10
+ * differently. The shape to avoid is the GLOBAL AUGMENT — a `declare global` on
11
+ * `React.JSX` collides with every other library on a shared tag — while a
12
+ * module-scoped `JSX` behind a `jsxImportSource` does not. This package is used by
13
+ * projects that want nothing to do with JSX, so it emits neither; a consumer declaring
14
+ * a module-scoped namespace over these names is doing it right.
15
+ *
16
+ * Three things this is and `ConstructorProps` is not: WRITABLE-only (measured on
17
+ * Gtk-4.0, `ConstructorProps` offers 150 read-only properties across 68 classes as
18
+ * settable, and GTK's failure mode for writing one is exit 0), OPTIONAL, and keyed
19
+ * by the name GObject actually REGISTERED — the dashed spelling `g_object_set`,
20
+ * GtkBuilder XML and Blueprint all use.
21
+ *
22
+ * Signal handler types are not re-derived: `X.SignalSignatures`, which this package
23
+ * already emits for every class with the parent chain, every implemented interface
24
+ * and the `notify::` keys folded in, is what `Widgets[G]['signals']` points at.
25
+ */
26
+
27
+ import type Atk from '@girs/atk-1.0';
28
+ import type Clutter from './clutter-16.js';
29
+ import type Cogl from '@girs/cogl-16';
30
+ import type GObject from '@girs/gobject-2.0';
31
+ import type Graphene from '@girs/graphene-1.0';
32
+ import type Mtk from '@girs/mtk-16';
33
+ import type Pango from '@girs/pango-1.0';
34
+ import type { AtkComponentConstructOnly, AtkComponentProps, AtkGObjectAccessibleConstructOnly, AtkGObjectAccessibleProps, AtkObjectConstructOnly, AtkObjectProps, AtkRoleNick } from '@girs/atk-1.0/vocabulary';
35
+ import type { CoglShaderTypeNick } from '@girs/cogl-16/vocabulary';
36
+ import type { GInitiallyUnownedConstructOnly, GInitiallyUnownedProps, GObjectConstructOnly, GObjectProps } from '@girs/gobject-2.0/vocabulary';
37
+ import type { PangoAlignmentNick, PangoEllipsizeModeNick, PangoWrapModeNick } from '@girs/pango-1.0/vocabulary';
38
+
39
+ // ---------------------------------------------------------------------------
40
+ // Enum nicks — the string vocabulary GObject registered, from GIR's `glib:nick`.
41
+ //
42
+ // Not derived from the member name. Substituting underscores for dashes is not a law:
43
+ // some nicks keep an underscore the substitution would have replaced, and only the
44
+ // attribute knows which. Gtk-4.0 and Adw-1 contradict no derivation at all, which is
45
+ // how a derived nick passes review and breaks elsewhere.
46
+ // Re-measure with `scripts/check-nick-derivation.mjs` in ts-for-gir.
47
+ // ---------------------------------------------------------------------------
48
+
49
+ export type ClutterActorAlignNick = 'fill' | 'start' | 'center' | 'end';
50
+ export type ClutterAlignAxisNick = 'x-axis' | 'y-axis' | 'both';
51
+ export type ClutterAnimationModeNick = 'custom-mode' | 'linear' | 'ease-in-quad' | 'ease-out-quad' | 'ease-in-out-quad' | 'ease-in-cubic' | 'ease-out-cubic' | 'ease-in-out-cubic' | 'ease-in-quart' | 'ease-out-quart' | 'ease-in-out-quart' | 'ease-in-quint' | 'ease-out-quint' | 'ease-in-out-quint' | 'ease-in-sine' | 'ease-out-sine' | 'ease-in-out-sine' | 'ease-in-expo' | 'ease-out-expo' | 'ease-in-out-expo' | 'ease-in-circ' | 'ease-out-circ' | 'ease-in-out-circ' | 'ease-in-elastic' | 'ease-out-elastic' | 'ease-in-out-elastic' | 'ease-in-back' | 'ease-out-back' | 'ease-in-out-back' | 'ease-in-bounce' | 'ease-out-bounce' | 'ease-in-out-bounce' | 'steps' | 'step-start' | 'step-end' | 'cubic-bezier' | 'ease' | 'ease-in' | 'ease-out' | 'ease-in-out' | 'animation-last';
52
+ export type ClutterBindCoordinateNick = 'x' | 'y' | 'width' | 'height' | 'position' | 'size' | 'all';
53
+ export type ClutterButtonStateNick = 'released' | 'pressed';
54
+ export type ClutterColorimetryTypeNick = 'colorspace' | 'primaries';
55
+ export type ClutterColorspaceNick = 'srgb' | 'bt2020' | 'ntsc';
56
+ export type ClutterContentGravityNick = 'top-left' | 'top' | 'top-right' | 'left' | 'center' | 'right' | 'bottom-left' | 'bottom' | 'bottom-right' | 'resize-fill' | 'resize-aspect';
57
+ export type ClutterEOTFTypeNick = 'named' | 'gamma';
58
+ export type ClutterEncodingRequiredFormatNick = 'uint8' | 'uint10' | 'fp16';
59
+ export type ClutterEventPhaseNick = 'capture' | 'bubble';
60
+ export type ClutterEventTypeNick = 'nothing' | 'key-press' | 'key-release' | 'motion' | 'enter' | 'leave' | 'button-press' | 'button-release' | 'scroll' | 'touch-begin' | 'touch-update' | 'touch-end' | 'touch-cancel' | 'touchpad-pinch' | 'touchpad-swipe' | 'touchpad-hold' | 'proximity-in' | 'proximity-out' | 'pad-button-press' | 'pad-button-release' | 'pad-strip' | 'pad-ring' | 'device-added' | 'device-removed' | 'im-commit' | 'im-delete' | 'im-preedit' | 'event-last';
61
+ export type ClutterFrameClockModeNick = 'fixed' | 'variable';
62
+ export type ClutterFrameResultNick = 'pending-presented' | 'idle';
63
+ export type ClutterGestureStateNick = 'waiting' | 'possible' | 'recognizing' | 'completed' | 'cancelled' | 'clutter-n-gesture-states';
64
+ export type ClutterGestureTriggerEdgeNick = 'none' | 'after' | 'before';
65
+ export type ClutterGridPositionNick = 'left' | 'right' | 'top' | 'bottom';
66
+ export type ClutterInputAxisNick = 'ignore' | 'x' | 'y' | 'pressure' | 'xtilt' | 'ytilt' | 'wheel' | 'distance' | 'rotation' | 'slider' | 'last';
67
+ export type ClutterInputContentPurposeNick = 'normal' | 'alpha' | 'digits' | 'number' | 'phone' | 'url' | 'email' | 'name' | 'password' | 'date' | 'time' | 'datetime' | 'terminal';
68
+ export type ClutterInputDevicePadFeatureNick = 'button' | 'ring' | 'strip';
69
+ export type ClutterInputDevicePadSourceNick = 'unknown' | 'finger';
70
+ export type ClutterInputDeviceToolTypeNick = 'none' | 'pen' | 'eraser' | 'brush' | 'pencil' | 'airbrush' | 'mouse' | 'lens';
71
+ export type ClutterInputDeviceTypeNick = 'pointer-device' | 'keyboard-device' | 'extension-device' | 'joystick-device' | 'tablet-device' | 'touchpad-device' | 'touchscreen-device' | 'pen-device' | 'eraser-device' | 'cursor-device' | 'pad-device' | 'n-device-types';
72
+ export type ClutterInputModeNick = 'logical' | 'physical' | 'floating';
73
+ export type ClutterInputPanelStateNick = 'off' | 'on' | 'toggle';
74
+ export type ClutterKeyStateNick = 'released' | 'pressed';
75
+ export type ClutterLongPressStateNick = 'query' | 'activate' | 'cancel';
76
+ export type ClutterLuminanceTypeNick = 'derived' | 'explicit';
77
+ export type ClutterOrientationNick = 'horizontal' | 'vertical';
78
+ export type ClutterPanAxisNick = 'axis-none' | 'x-axis' | 'y-axis' | 'axis-auto';
79
+ export type ClutterPickModeNick = 'none' | 'reactive' | 'all';
80
+ export type ClutterPipelineCapabilityNick = 'state';
81
+ export type ClutterPointerA11yDwellClickTypeNick = 'none' | 'primary' | 'secondary' | 'middle' | 'double' | 'drag';
82
+ export type ClutterPointerA11yDwellDirectionNick = 'none' | 'left' | 'right' | 'up' | 'down';
83
+ export type ClutterPointerA11yDwellModeNick = 'window' | 'gesture';
84
+ export type ClutterPointerA11yTimeoutTypeNick = 'secondary-click' | 'dwell' | 'gesture';
85
+ export type ClutterPreeditResetModeNick = 'clear' | 'commit';
86
+ export type ClutterRequestModeNick = 'height-for-width' | 'width-for-height' | 'content-size';
87
+ export type ClutterRotateAxisNick = 'x-axis' | 'y-axis' | 'z-axis';
88
+ export type ClutterScalingFilterNick = 'linear' | 'nearest' | 'trilinear';
89
+ export type ClutterScrollDirectionNick = 'up' | 'down' | 'left' | 'right' | 'smooth';
90
+ export type ClutterScrollSourceNick = 'unknown' | 'wheel' | 'finger' | 'continuous';
91
+ export type ClutterSnapEdgeNick = 'top' | 'right' | 'bottom' | 'left';
92
+ export type ClutterStepModeNick = 'start' | 'end';
93
+ export type ClutterTextDirectionNick = 'default' | 'ltr' | 'rtl';
94
+ export type ClutterTimelineDirectionNick = 'forward' | 'backward';
95
+ export type ClutterTouchpadGesturePhaseNick = 'begin' | 'update' | 'end' | 'cancel';
96
+ export type ClutterTransferFunctionNick = 'srgb' | 'pq' | 'bt709' | 'linear';
97
+
98
+ // ---------------------------------------------------------------------------
99
+ // Property surfaces — one interface per GIR DECLARATION, mirroring GIR's own
100
+ // inheritance rather than flattening per widget.
101
+ //
102
+ // The interfaces are load-bearing, not tidiness: `GtkBox` declares four properties
103
+ // of its own and `orientation` is not among them — it lives on `Gtk.Orientable`,
104
+ // because GObject installs interface properties on the implementor at runtime while
105
+ // GIR keeps them once, on the interface.
106
+ // ---------------------------------------------------------------------------
107
+
108
+ /** Abstract class for event-related logic #ClutterAction is an abstract base class for event-related actions that modify the user interaction of a [class@Actor], just like [class@Constraint] is an abstr… */
109
+ export interface ClutterActionProps extends ClutterActorMetaProps {
110
+ }
111
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
112
+ export type ClutterActionConstructOnly = ClutterActorMetaConstructOnly;
113
+
114
+ /** The basic element of the scene graph The ClutterActor class is the basic element of the scene graph in Clutter, and it encapsulates the position, size, and transformations of a node in the graph. */
115
+ export interface ClutterActorProps extends GInitiallyUnownedProps, ClutterAnimatableProps {
116
+ /**
117
+ * Object instance's name for assistive technology access.
118
+ * @default NULL
119
+ */
120
+ 'accessible-name'?: string;
121
+ /**
122
+ * The accessible role of this object
123
+ * @default ATK_ROLE_INVALID
124
+ */
125
+ 'accessible-role'?: AtkRoleNick | Atk.Role;
126
+ /** Adds a #ClutterAction to the actor */
127
+ actions?: Clutter.Action;
128
+ /**
129
+ * Paints a solid fill of the actor's allocation using the specified color.
130
+ * @default #00000000
131
+ */
132
+ 'background-color'?: Cogl.Color;
133
+ /** Applies a transformation matrix on each child of an actor. */
134
+ 'child-transform'?: Graphene.Matrix;
135
+ /** The visible region of the actor, in actor-relative coordinates, expressed as a #graphene_rect_t. */
136
+ 'clip-rect'?: Graphene.Rect;
137
+ /**
138
+ * Whether the clip region should track the allocated area of the actor.
139
+ * @default FALSE
140
+ */
141
+ 'clip-to-allocation'?: boolean;
142
+ /** The #ClutterColorState contains the properties like colorspace for each actors. */
143
+ 'color-state'?: Clutter.ColorState;
144
+ /** Adds a #ClutterConstraint to the actor */
145
+ constraints?: Clutter.Constraint;
146
+ /** The #ClutterContent implementation that controls the content of the actor. */
147
+ content?: Clutter.Content;
148
+ /**
149
+ * The alignment that should be honoured by the #ClutterContent set with the [property@Clutter.Actor:content] property.
150
+ * @default CLUTTER_CONTENT_GRAVITY_RESIZE_FILL
151
+ */
152
+ 'content-gravity'?: ClutterContentGravityNick | Clutter.ContentGravity;
153
+ /**
154
+ * The repeat policy for the actor's [property@Clutter.Actor:content].
155
+ * @default CLUTTER_REPEAT_NONE
156
+ */
157
+ 'content-repeat'?: number;
158
+ /** The %ClutterContext of the actor */
159
+ context?: Clutter.Context;
160
+ /** Adds #ClutterEffect to the list of effects be applied on a #ClutterActor */
161
+ effect?: Clutter.Effect | null;
162
+ /**
163
+ * This flag controls whether the [property@Clutter.Actor:fixed-x] and [property@Clutter.Actor:fixed-y] properties are used
164
+ * @default FALSE
165
+ */
166
+ 'fixed-position-set'?: boolean;
167
+ /**
168
+ * The fixed X position of the actor in pixels.
169
+ * @default 0.000000
170
+ */
171
+ 'fixed-x'?: number;
172
+ /**
173
+ * The fixed Y position of the actor in pixels.
174
+ * @default 0.000000
175
+ */
176
+ 'fixed-y'?: number;
177
+ /**
178
+ * Height of the actor (in pixels).
179
+ * @default 0.000000
180
+ */
181
+ height?: number;
182
+ /** A delegate object for controlling the layout of the children of an actor. */
183
+ 'layout-manager'?: Clutter.LayoutManager;
184
+ /** @default CLUTTER_SCALING_FILTER_LINEAR */
185
+ 'magnification-filter'?: ClutterScalingFilterNick | Clutter.ScalingFilter;
186
+ /**
187
+ * The margin (in pixels) from the bottom of the actor.
188
+ * @default 0.000000
189
+ */
190
+ 'margin-bottom'?: number;
191
+ /**
192
+ * The margin (in pixels) from the left of the actor.
193
+ * @default 0.000000
194
+ */
195
+ 'margin-left'?: number;
196
+ /**
197
+ * The margin (in pixels) from the right of the actor.
198
+ * @default 0.000000
199
+ */
200
+ 'margin-right'?: number;
201
+ /**
202
+ * The margin (in pixels) from the top of the actor.
203
+ * @default 0.000000
204
+ */
205
+ 'margin-top'?: number;
206
+ /**
207
+ * A forced minimum height request for the actor, in pixels Writing this property sets the [property@Clutter.Actor:min-height-set] property as well, as a side effect.
208
+ * @default 0.000000
209
+ */
210
+ 'min-height'?: number;
211
+ /**
212
+ * This flag controls whether the [property@Clutter.Actor:min-height] property is used
213
+ * @default FALSE
214
+ */
215
+ 'min-height-set'?: boolean;
216
+ /**
217
+ * A forced minimum width request for the actor, in pixels Writing this property sets the [property@Clutter.Actor:min-width-set] property as well, as a side effect.
218
+ * @default 0.000000
219
+ */
220
+ 'min-width'?: number;
221
+ /**
222
+ * This flag controls whether the [property@Clutter.Actor:min-width] property is used
223
+ * @default FALSE
224
+ */
225
+ 'min-width-set'?: boolean;
226
+ /** @default CLUTTER_SCALING_FILTER_LINEAR */
227
+ 'minification-filter'?: ClutterScalingFilterNick | Clutter.ScalingFilter;
228
+ /**
229
+ * The name of the actor
230
+ * @default NULL
231
+ */
232
+ name?: string | null;
233
+ /**
234
+ * A forced natural height request for the actor, in pixels Writing this property sets the [property@Clutter.Actor:natural-height-set] property as well, as a side effect.
235
+ * @default 0.000000
236
+ */
237
+ 'natural-height'?: number;
238
+ /**
239
+ * This flag controls whether the [property@Clutter.Actor:natural-height] property is used
240
+ * @default FALSE
241
+ */
242
+ 'natural-height-set'?: boolean;
243
+ /**
244
+ * A forced natural width request for the actor, in pixels Writing this property sets the [property@Clutter.Actor:natural-width-set] property as well, as a side effect.
245
+ * @default 0.000000
246
+ */
247
+ 'natural-width'?: number;
248
+ /**
249
+ * This flag controls whether the [property@Clutter.Actor:natural-width] property is used
250
+ * @default FALSE
251
+ */
252
+ 'natural-width-set'?: boolean;
253
+ /**
254
+ * Determines the conditions in which the actor will be redirected to an offscreen framebuffer while being painted.
255
+ * @default 0
256
+ */
257
+ 'offscreen-redirect'?: number;
258
+ /**
259
+ * Opacity of an actor, between 0 (fully transparent) and 255 (fully opaque) The [property@Clutter.Actor:opacity] property is animatable.
260
+ * @default 255
261
+ */
262
+ opacity?: number;
263
+ /** The point around which the scaling and rotation transformations occur. */
264
+ 'pivot-point'?: Graphene.Point;
265
+ /**
266
+ * The Z component of the [property@Clutter.Actor:pivot-point], expressed as a value along the Z axis.
267
+ * @default 0.000000
268
+ */
269
+ 'pivot-point-z'?: number;
270
+ /** The position of the origin of the actor. */
271
+ position?: Graphene.Point;
272
+ /**
273
+ * Whether the actor is reactive to events or not Only reactive actors will emit event-related signals
274
+ * @default FALSE
275
+ */
276
+ reactive?: boolean;
277
+ /**
278
+ * Request mode for the #ClutterActor.
279
+ * @default CLUTTER_REQUEST_HEIGHT_FOR_WIDTH
280
+ */
281
+ 'request-mode'?: ClutterRequestModeNick | Clutter.RequestMode;
282
+ /**
283
+ * The rotation angle on the X axis.
284
+ * @default 0.000000
285
+ */
286
+ 'rotation-angle-x'?: number;
287
+ /**
288
+ * The rotation angle on the Y axis The [property@Clutter.Actor:rotation-angle-y] property is animatable.
289
+ * @default 0.000000
290
+ */
291
+ 'rotation-angle-y'?: number;
292
+ /**
293
+ * The rotation angle on the Z axis The [property@Clutter.Actor:rotation-angle-z] property is animatable.
294
+ * @default 0.000000
295
+ */
296
+ 'rotation-angle-z'?: number;
297
+ /**
298
+ * The horizontal scale of the actor.
299
+ * @default 1.000000
300
+ */
301
+ 'scale-x'?: number;
302
+ /**
303
+ * The vertical scale of the actor.
304
+ * @default 1.000000
305
+ */
306
+ 'scale-y'?: number;
307
+ /**
308
+ * The scale factor of the actor along the Z axis.
309
+ * @default 1.000000
310
+ */
311
+ 'scale-z'?: number;
312
+ /**
313
+ * If %TRUE, the actor is automatically shown when parented.
314
+ * @default TRUE
315
+ */
316
+ 'show-on-set-parent'?: boolean;
317
+ /** The size of the actor. */
318
+ size?: Graphene.Size;
319
+ /**
320
+ * The direction of the text inside a #ClutterActor.
321
+ * @default CLUTTER_TEXT_DIRECTION_LTR
322
+ */
323
+ 'text-direction'?: ClutterTextDirectionNick | Clutter.TextDirection;
324
+ /** Overrides the transformations of a #ClutterActor with a custom matrix. */
325
+ transform?: Graphene.Matrix;
326
+ /**
327
+ * An additional translation applied along the X axis, relative to the actor's [property@Clutter.Actor:pivot-point].
328
+ * @default 0.000000
329
+ */
330
+ 'translation-x'?: number;
331
+ /**
332
+ * An additional translation applied along the Y axis, relative to the actor's [property@Clutter.Actor:pivot-point].
333
+ * @default 0.000000
334
+ */
335
+ 'translation-y'?: number;
336
+ /**
337
+ * An additional translation applied along the Z axis, relative to the actor's [property@Clutter.Actor:pivot-point].
338
+ * @default 0.000000
339
+ */
340
+ 'translation-z'?: number;
341
+ /**
342
+ * Whether the actor is set to be visible or not See also [property@Clutter.Actor:mapped]
343
+ * @default FALSE
344
+ */
345
+ visible?: boolean;
346
+ /**
347
+ * Width of the actor (in pixels).
348
+ * @default 0.000000
349
+ */
350
+ width?: number;
351
+ /**
352
+ * X coordinate of the actor in pixels.
353
+ * @default 0.000000
354
+ */
355
+ x?: number;
356
+ /**
357
+ * The alignment of an actor on the X axis, if the actor has been given extra space for its allocation.
358
+ * @default CLUTTER_ACTOR_ALIGN_FILL
359
+ */
360
+ 'x-align'?: ClutterActorAlignNick | Clutter.ActorAlign;
361
+ /**
362
+ * Whether a layout manager should assign more space to the actor on the X axis.
363
+ * @default FALSE
364
+ */
365
+ 'x-expand'?: boolean;
366
+ /**
367
+ * Y coordinate of the actor in pixels.
368
+ * @default 0.000000
369
+ */
370
+ y?: number;
371
+ /**
372
+ * The alignment of an actor on the Y axis, if the actor has been given extra space for its allocation.
373
+ * @default CLUTTER_ACTOR_ALIGN_FILL
374
+ */
375
+ 'y-align'?: ClutterActorAlignNick | Clutter.ActorAlign;
376
+ /**
377
+ * Whether a layout manager should assign more space to the actor on the Y axis.
378
+ * @default FALSE
379
+ */
380
+ 'y-expand'?: boolean;
381
+ /**
382
+ * The actor's position on the Z axis, relative to the parent's transformations.
383
+ * @default 0.000000
384
+ */
385
+ 'z-position'?: number;
386
+ }
387
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
388
+ export type ClutterActorConstructOnly = GInitiallyUnownedConstructOnly | ClutterAnimatableConstructOnly | 'context';
389
+
390
+ /** Implementation of the ATK interfaces for [class@Clutter.Actor] #ClutterActorAccessible implements the required ATK interfaces of [class@Clutter.Actor] exposing the common elements on each actor (posi… */
391
+ export interface ClutterActorAccessibleProps extends AtkGObjectAccessibleProps, AtkComponentProps {
392
+ }
393
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
394
+ export type ClutterActorAccessibleConstructOnly = AtkGObjectAccessibleConstructOnly | AtkComponentConstructOnly;
395
+
396
+ /** Base class of actor modifiers #ClutterActorMeta is an abstract class providing a common API for modifiers of [class@Actor] behaviour, appearance or layout. */
397
+ export interface ClutterActorMetaProps extends GInitiallyUnownedProps {
398
+ /**
399
+ * Whether or not the #ClutterActorMeta is enabled
400
+ * @default TRUE
401
+ */
402
+ enabled?: boolean;
403
+ /**
404
+ * The unique name to access the #ClutterActorMeta
405
+ * @default NULL
406
+ */
407
+ name?: string;
408
+ }
409
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
410
+ export type ClutterActorMetaConstructOnly = GInitiallyUnownedConstructOnly;
411
+
412
+ export interface ClutterActorNodeProps extends ClutterPaintNodeProps {
413
+ }
414
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
415
+ export type ClutterActorNodeConstructOnly = ClutterPaintNodeConstructOnly;
416
+
417
+ /** A constraint aligning the position of an actor #ClutterAlignConstraint is a [class@Constraint] that aligns the position of the [class@Actor] to which it is applied to the size of another [class@Actor… */
418
+ export interface ClutterAlignConstraintProps extends ClutterConstraintProps {
419
+ /**
420
+ * The axis to be used to compute the alignment
421
+ * @default CLUTTER_ALIGN_X_AXIS
422
+ */
423
+ 'align-axis'?: ClutterAlignAxisNick | Clutter.AlignAxis;
424
+ /**
425
+ * The alignment factor, as a normalized value between 0.0 and 1.0 The factor depends on the #ClutterAlignConstraint:align-axis property: with an align-axis value of %CLUTTER_ALIGN_X_AXIS, 0.0 means lef…
426
+ * @default 0.000000
427
+ */
428
+ factor?: number;
429
+ /** The pivot point used by the constraint. */
430
+ 'pivot-point'?: Graphene.Point;
431
+ /** The #ClutterActor used as the source for the alignment. */
432
+ source?: Clutter.Actor;
433
+ }
434
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
435
+ export type ClutterAlignConstraintConstructOnly = ClutterConstraintConstructOnly;
436
+
437
+ /** Interface for animatable classes #ClutterAnimatable is an interface that allows a [class@GObject.Object] class to control how an actor will animate a property. */
438
+ export interface ClutterAnimatableProps extends GObjectProps {
439
+ }
440
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
441
+ export type ClutterAnimatableConstructOnly = GObjectConstructOnly;
442
+
443
+ /** A simple layout manager #ClutterBinLayout is a layout manager which implements the following policy: - the preferred size is the maximum preferred size between all the children of the container using… */
444
+ export interface ClutterBinLayoutProps extends ClutterLayoutManagerProps {
445
+ }
446
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
447
+ export type ClutterBinLayoutConstructOnly = ClutterLayoutManagerConstructOnly;
448
+
449
+ /** A constraint binding the position or size of an actor #ClutterBindConstraint is a [class@Constraint] that binds the position or the size of the [class@Actor] to which it is applied to the the positio… */
450
+ export interface ClutterBindConstraintProps extends ClutterConstraintProps {
451
+ /**
452
+ * The coordinate to be bound
453
+ * @default CLUTTER_BIND_X
454
+ */
455
+ coordinate?: ClutterBindCoordinateNick | Clutter.BindCoordinate;
456
+ /**
457
+ * The offset, in pixels, to be applied to the binding
458
+ * @default 0.000000
459
+ */
460
+ offset?: number;
461
+ /** The #ClutterActor used as the source for the binding. */
462
+ source?: Clutter.Actor;
463
+ }
464
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
465
+ export type ClutterBindConstraintConstructOnly = ClutterConstraintConstructOnly;
466
+
467
+ /** Pool for key bindings #ClutterBindingPool is a data structure holding a set of key bindings. */
468
+ export interface ClutterBindingPoolProps extends GObjectProps {
469
+ /**
470
+ * The unique name of the #ClutterBindingPool.
471
+ * @default NULL
472
+ */
473
+ name?: string;
474
+ }
475
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
476
+ export type ClutterBindingPoolConstructOnly = GObjectConstructOnly | 'name';
477
+
478
+ export interface ClutterBlitNodeProps extends ClutterPaintNodeProps {
479
+ }
480
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
481
+ export type ClutterBlitNodeConstructOnly = ClutterPaintNodeConstructOnly;
482
+
483
+ /** A blur effect #ClutterBlurEffect is a sub-class of #ClutterEffect that allows blurring a actor and its contents. */
484
+ export interface ClutterBlurEffectProps extends ClutterOffscreenEffectProps {
485
+ }
486
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
487
+ export type ClutterBlurEffectConstructOnly = ClutterOffscreenEffectConstructOnly;
488
+
489
+ export interface ClutterBlurNodeProps extends ClutterLayerNodeProps {
490
+ }
491
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
492
+ export type ClutterBlurNodeConstructOnly = ClutterLayerNodeConstructOnly;
493
+
494
+ /** A layout manager arranging children on a single line The #ClutterBoxLayout is a [class@Clutter.LayoutManager] implementing the following layout policy: - all children are arranged on a single line - … */
495
+ export interface ClutterBoxLayoutProps extends ClutterLayoutManagerProps {
496
+ /**
497
+ * Whether the #ClutterBoxLayout should arrange its children homogeneously, i.e.
498
+ * @default FALSE
499
+ */
500
+ homogeneous?: boolean;
501
+ /**
502
+ * The orientation of the #ClutterBoxLayout, either horizontal or vertical
503
+ * @default CLUTTER_ORIENTATION_HORIZONTAL
504
+ */
505
+ orientation?: ClutterOrientationNick | Clutter.Orientation;
506
+ /**
507
+ * The spacing between children of the #ClutterBoxLayout, in pixels
508
+ * @default 0
509
+ */
510
+ spacing?: number;
511
+ }
512
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
513
+ export type ClutterBoxLayoutConstructOnly = ClutterLayoutManagerConstructOnly;
514
+
515
+ /** Increase/decrease brightness and/or contrast of actor. */
516
+ export interface ClutterBrightnessContrastEffectProps extends ClutterOffscreenEffectProps {
517
+ /**
518
+ * The brightness change to apply to the effect.
519
+ * @default #7f7f7fff
520
+ */
521
+ brightness?: Cogl.Color;
522
+ /**
523
+ * The contrast change to apply to the effect.
524
+ * @default #7f7f7fff
525
+ */
526
+ contrast?: Cogl.Color;
527
+ }
528
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
529
+ export type ClutterBrightnessContrastEffectConstructOnly = ClutterOffscreenEffectConstructOnly;
530
+
531
+ /** Action for clickable actors #ClutterClickAction is a sub-class of [class@Action] that implements the logic for clickable actors, by using the low level events of [class@Actor], such as [signal@Actor:… */
532
+ export interface ClutterClickActionProps extends ClutterActionProps {
533
+ /**
534
+ * The minimum duration of a press for it to be recognized as a long press gesture, in milliseconds.
535
+ * @default -1
536
+ */
537
+ 'long-press-duration'?: number;
538
+ /**
539
+ * The maximum allowed distance that can be covered (on both axes) before a long press gesture is cancelled, in pixels.
540
+ * @default -1
541
+ */
542
+ 'long-press-threshold'?: number;
543
+ }
544
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
545
+ export type ClutterClickActionConstructOnly = ClutterActionConstructOnly;
546
+
547
+ export interface ClutterClipNodeProps extends ClutterPaintNodeProps {
548
+ }
549
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
550
+ export type ClutterClipNodeConstructOnly = ClutterPaintNodeConstructOnly;
551
+
552
+ /** An actor that displays a clone of a source actor #ClutterClone is a [class@Clutter.Actor] which draws with the paint function of another actor, scaled to fit its own allocation. */
553
+ export interface ClutterCloneProps extends ClutterActorProps, ClutterAnimatableProps {
554
+ /** This property specifies the source actor being cloned. */
555
+ source?: Clutter.Actor;
556
+ }
557
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
558
+ export type ClutterCloneConstructOnly = ClutterActorConstructOnly | ClutterAnimatableConstructOnly;
559
+
560
+ export interface ClutterColorManagerProps extends GObjectProps {
561
+ /** The associated ClutterContext. */
562
+ context?: Clutter.Context;
563
+ }
564
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
565
+ export type ClutterColorManagerConstructOnly = GObjectConstructOnly | 'context';
566
+
567
+ export interface ClutterColorNodeProps extends ClutterPipelineNodeProps {
568
+ }
569
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
570
+ export type ClutterColorNodeConstructOnly = ClutterPipelineNodeConstructOnly;
571
+
572
+ /** Color state of each ClutterActor The #ClutterColorState class contains the colorspace of each color states (e.g. */
573
+ export interface ClutterColorStateProps extends GObjectProps {
574
+ /** The associated ClutterContext. */
575
+ context?: Clutter.Context;
576
+ }
577
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
578
+ export type ClutterColorStateConstructOnly = GObjectConstructOnly | 'context';
579
+
580
+ export interface ClutterColorStateParamsProps extends ClutterColorStateProps {
581
+ }
582
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
583
+ export type ClutterColorStateParamsConstructOnly = ClutterColorStateConstructOnly;
584
+
585
+ /** A colorization effect #ClutterColorizeEffect is a sub-class of #ClutterEffect that colorizes an actor with the given tint. */
586
+ export interface ClutterColorizeEffectProps extends ClutterOffscreenEffectProps {
587
+ /**
588
+ * The tint to apply to the actor
589
+ * @default #ffcc99ff
590
+ */
591
+ tint?: Cogl.Color;
592
+ }
593
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
594
+ export type ClutterColorizeEffectConstructOnly = ClutterOffscreenEffectConstructOnly;
595
+
596
+ /** Abstract class for constraints on position or size #ClutterConstraint is a base abstract class for modifiers of a #ClutterActor position or size. */
597
+ export interface ClutterConstraintProps extends ClutterActorMetaProps {
598
+ }
599
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
600
+ export type ClutterConstraintConstructOnly = ClutterActorMetaConstructOnly;
601
+
602
+ /** Delegate for painting the content of an actor #ClutterContent is an interface to implement types responsible for painting the content of a [class@Actor]. */
603
+ export interface ClutterContentProps extends GObjectProps {
604
+ }
605
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
606
+ export type ClutterContentConstructOnly = GObjectConstructOnly;
607
+
608
+ export interface ClutterContextProps extends GObjectProps {
609
+ }
610
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
611
+ export type ClutterContextConstructOnly = GObjectConstructOnly;
612
+
613
+ /** A base class for effects deforming the geometry of an actor #ClutterDeformEffect is an abstract class providing all the plumbing for creating effects that result in the deformation of an actor's geom… */
614
+ export interface ClutterDeformEffectProps extends ClutterOffscreenEffectProps {
615
+ /** A pipeline to be used when painting the back of the actor to which this effect has been applied By default, no pipeline will be used */
616
+ 'back-pipeline'?: Cogl.Pipeline | null;
617
+ /**
618
+ * The number of horizontal tiles.
619
+ * @default 32
620
+ */
621
+ 'x-tiles'?: number;
622
+ /**
623
+ * The number of vertical tiles.
624
+ * @default 32
625
+ */
626
+ 'y-tiles'?: number;
627
+ }
628
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
629
+ export type ClutterDeformEffectConstructOnly = ClutterOffscreenEffectConstructOnly;
630
+
631
+ /** A desaturation effect #ClutterDesaturateEffect is a sub-class of #ClutterEffect that desaturates the color of an actor and its contents. */
632
+ export interface ClutterDesaturateEffectProps extends ClutterOffscreenEffectProps {
633
+ /**
634
+ * The desaturation factor, between 0.0 (no desaturation) and 1.0 (full desaturation).
635
+ * @default 1.000000
636
+ */
637
+ factor?: number;
638
+ }
639
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
640
+ export type ClutterDesaturateEffectConstructOnly = ClutterOffscreenEffectConstructOnly;
641
+
642
+ /** Base class for actor effects The #ClutterEffect class provides a default type and API for creating effects for generic actors. */
643
+ export interface ClutterEffectProps extends ClutterActorMetaProps {
644
+ }
645
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
646
+ export type ClutterEffectConstructOnly = ClutterActorMetaConstructOnly;
647
+
648
+ /** A fixed layout manager #ClutterFixedLayout is a layout manager implementing the same layout policies as #ClutterGroup. */
649
+ export interface ClutterFixedLayoutProps extends ClutterLayoutManagerProps {
650
+ }
651
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
652
+ export type ClutterFixedLayoutConstructOnly = ClutterLayoutManagerConstructOnly;
653
+
654
+ /** A reflowing layout manager #ClutterFlowLayout is a layout manager which implements the following policy: - the preferred natural size depends on the value of the #ClutterFlowLayout:orientation proper… */
655
+ export interface ClutterFlowLayoutProps extends ClutterLayoutManagerProps {
656
+ /**
657
+ * The spacing between columns, in pixels; the value of this property is honoured by horizontal non-overflowing layouts and by vertical overflowing layouts
658
+ * @default 0.000000
659
+ */
660
+ 'column-spacing'?: number;
661
+ /**
662
+ * Whether each child inside the #ClutterFlowLayout should receive the same allocation
663
+ * @default FALSE
664
+ */
665
+ homogeneous?: boolean;
666
+ /**
667
+ * Maximum width for each column in the layout, in pixels.
668
+ * @default -1.000000
669
+ */
670
+ 'max-column-width'?: number;
671
+ /**
672
+ * Maximum height for each row in the layout, in pixels.
673
+ * @default -1.000000
674
+ */
675
+ 'max-row-height'?: number;
676
+ /**
677
+ * Minimum width for each column in the layout, in pixels
678
+ * @default 0.000000
679
+ */
680
+ 'min-column-width'?: number;
681
+ /**
682
+ * Minimum height for each row in the layout, in pixels
683
+ * @default 0.000000
684
+ */
685
+ 'min-row-height'?: number;
686
+ /**
687
+ * The orientation of the #ClutterFlowLayout.
688
+ * @default CLUTTER_ORIENTATION_HORIZONTAL
689
+ */
690
+ orientation?: ClutterOrientationNick | Clutter.Orientation;
691
+ /**
692
+ * The spacing between rows, in pixels; the value of this property is honoured by vertical non-overflowing layouts and by horizontal overflowing layouts
693
+ * @default 0.000000
694
+ */
695
+ 'row-spacing'?: number;
696
+ /**
697
+ * Whether the #ClutterFlowLayout should arrange its children on a grid
698
+ * @default TRUE
699
+ */
700
+ 'snap-to-grid'?: boolean;
701
+ }
702
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
703
+ export type ClutterFlowLayoutConstructOnly = ClutterLayoutManagerConstructOnly;
704
+
705
+ export interface ClutterFrameClockProps extends GObjectProps {
706
+ }
707
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
708
+ export type ClutterFrameClockConstructOnly = GObjectConstructOnly;
709
+
710
+ /** Action for gesture gestures #ClutterGestureAction is a sub-class of [class@Action] that implements the logic for recognizing gesture gestures. */
711
+ export interface ClutterGestureActionProps extends ClutterActionProps {
712
+ /**
713
+ * Number of touch points to trigger a gesture action.
714
+ * @default 1
715
+ */
716
+ 'n-touch-points'?: number;
717
+ /**
718
+ * The horizontal trigger distance to be used by the action to either emit the [signal@GestureAction::gesture-begin] signal or to emit the [signal@GestureAction::gesture-cancel] signal.
719
+ * @default -1.000000
720
+ */
721
+ 'threshold-trigger-distance-x'?: number;
722
+ /**
723
+ * The vertical trigger distance to be used by the action to either emit the [signal@GestureAction::gesture-begin] signal or to emit the [signal@GestureAction::gesture-cancel] signal.
724
+ * @default -1.000000
725
+ */
726
+ 'threshold-trigger-distance-y'?: number;
727
+ /**
728
+ * The trigger edge to be used by the action to either emit the [signal@GestureAction::gesture-begin] signal or to emit the [signal@GestureAction::gesture-cancel] signal.
729
+ * @default CLUTTER_GESTURE_TRIGGER_EDGE_NONE
730
+ */
731
+ 'threshold-trigger-edge'?: ClutterGestureTriggerEdgeNick | Clutter.GestureTriggerEdge;
732
+ }
733
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
734
+ export type ClutterGestureActionConstructOnly = ClutterActionConstructOnly | 'threshold-trigger-distance-x' | 'threshold-trigger-distance-y' | 'threshold-trigger-edge';
735
+
736
+ export interface ClutterGrabProps extends GObjectProps {
737
+ }
738
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
739
+ export type ClutterGrabConstructOnly = GObjectConstructOnly;
740
+
741
+ /** A layout manager for a grid of actors #ClutterGridLayout is a layout manager which arranges its child widgets in rows and columns. */
742
+ export interface ClutterGridLayoutProps extends ClutterLayoutManagerProps {
743
+ /**
744
+ * Whether all columns of the layout should have the same width
745
+ * @default FALSE
746
+ */
747
+ 'column-homogeneous'?: boolean;
748
+ /**
749
+ * The amount of space in pixels between two consecutive columns
750
+ * @default 0
751
+ */
752
+ 'column-spacing'?: number;
753
+ /**
754
+ * The orientation of the layout, either horizontal or vertical
755
+ * @default CLUTTER_ORIENTATION_HORIZONTAL
756
+ */
757
+ orientation?: ClutterOrientationNick | Clutter.Orientation;
758
+ /**
759
+ * Whether all rows of the layout should have the same height
760
+ * @default FALSE
761
+ */
762
+ 'row-homogeneous'?: boolean;
763
+ /**
764
+ * The amount of space in pixels between two consecutive rows
765
+ * @default 0
766
+ */
767
+ 'row-spacing'?: number;
768
+ }
769
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
770
+ export type ClutterGridLayoutConstructOnly = ClutterLayoutManagerConstructOnly;
771
+
772
+ /** An input device managed by Clutter #ClutterInputDevice represents an input device known to Clutter. */
773
+ export interface ClutterInputDeviceProps extends GObjectProps {
774
+ /**
775
+ * The capabilities of the device
776
+ * @default CLUTTER_INPUT_CAPABILITY_NONE
777
+ */
778
+ capabilities?: number;
779
+ /** @default CLUTTER_INPUT_MODE_FLOATING */
780
+ 'device-mode'?: ClutterInputModeNick | Clutter.InputMode;
781
+ /** @default NULL */
782
+ 'device-node'?: string;
783
+ /**
784
+ * The type of the device
785
+ * @default CLUTTER_POINTER_DEVICE
786
+ */
787
+ 'device-type'?: ClutterInputDeviceTypeNick | Clutter.InputDeviceType;
788
+ /**
789
+ * Whether the device has an on screen cursor following its movement.
790
+ * @default FALSE
791
+ */
792
+ 'has-cursor'?: boolean;
793
+ /** @default 0 */
794
+ 'n-buttons'?: number;
795
+ /** @default 0 */
796
+ 'n-mode-groups'?: number;
797
+ /** @default 0 */
798
+ 'n-rings'?: number;
799
+ /** @default 0 */
800
+ 'n-strips'?: number;
801
+ /**
802
+ * The name of the device
803
+ * @default NULL
804
+ */
805
+ name?: string;
806
+ /**
807
+ * Product ID of this device.2
808
+ * @default NULL
809
+ */
810
+ 'product-id'?: string;
811
+ /** The #ClutterSeat instance which owns the device */
812
+ seat?: Clutter.Seat;
813
+ /**
814
+ * Vendor ID of this device.2
815
+ * @default NULL
816
+ */
817
+ 'vendor-id'?: string;
818
+ }
819
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
820
+ export type ClutterInputDeviceConstructOnly = GObjectConstructOnly | 'capabilities' | 'device-mode' | 'device-node' | 'device-type' | 'has-cursor' | 'n-buttons' | 'n-mode-groups' | 'n-rings' | 'n-strips' | 'name' | 'product-id' | 'seat' | 'vendor-id';
821
+
822
+ /** An object holding an interval of two values #ClutterInterval is a simple object that can hold two values defining an interval. */
823
+ export interface ClutterIntervalProps extends GInitiallyUnownedProps {
824
+ /** The final value of the interval. */
825
+ final?: GObject.Value;
826
+ /** The initial value of the interval. */
827
+ initial?: GObject.Value;
828
+ /** The type of the values in the interval. */
829
+ 'value-type'?: GObject.GType;
830
+ }
831
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
832
+ export type ClutterIntervalConstructOnly = GInitiallyUnownedConstructOnly | 'value-type';
833
+
834
+ /** Keyframe property transition #ClutterKeyframeTransition allows animating a property by defining "key frames": values at a normalized position on the transition duration. */
835
+ export interface ClutterKeyframeTransitionProps extends ClutterPropertyTransitionProps {
836
+ }
837
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
838
+ export type ClutterKeyframeTransitionConstructOnly = ClutterPropertyTransitionConstructOnly;
839
+
840
+ export interface ClutterLayerNodeProps extends ClutterPaintNodeProps {
841
+ }
842
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
843
+ export type ClutterLayerNodeConstructOnly = ClutterPaintNodeConstructOnly;
844
+
845
+ /** Layout managers base class #ClutterLayoutManager is a base abstract class for layout managers. */
846
+ export interface ClutterLayoutManagerProps extends GInitiallyUnownedProps {
847
+ }
848
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
849
+ export type ClutterLayoutManagerConstructOnly = GInitiallyUnownedConstructOnly;
850
+
851
+ /** Base class for effects using offscreen buffers #ClutterOffscreenEffect is an abstract class that can be used by [class@Effect] sub-classes requiring access to an offscreen buffer. */
852
+ export interface ClutterOffscreenEffectProps extends ClutterEffectProps {
853
+ }
854
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
855
+ export type ClutterOffscreenEffectConstructOnly = ClutterEffectConstructOnly;
856
+
857
+ /** A page turning effect A simple page turning effect */
858
+ export interface ClutterPageTurnEffectProps extends ClutterDeformEffectProps {
859
+ /**
860
+ * The angle of the page rotation, in degrees, between 0.0 and 360.0
861
+ * @default 0.000000
862
+ */
863
+ angle?: number;
864
+ /**
865
+ * The period of the page turn, between 0.0 (no curling) and 1.0 (fully curled)
866
+ * @default 0.000000
867
+ */
868
+ period?: number;
869
+ /**
870
+ * The radius of the page curl, in pixels
871
+ * @default 24.000000
872
+ */
873
+ radius?: number;
874
+ }
875
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
876
+ export type ClutterPageTurnEffectConstructOnly = ClutterDeformEffectConstructOnly;
877
+
878
+ /** Paint objects #ClutterPaintNode is an element in the render graph. */
879
+ export interface ClutterPaintNodeProps {
880
+ }
881
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
882
+ export type ClutterPaintNodeConstructOnly = never;
883
+
884
+ /** Action for pan gestures #ClutterPanAction is a sub-class of [class@GestureAction] that implements the logic for recognizing pan gestures. */
885
+ export interface ClutterPanActionProps extends ClutterGestureActionProps {
886
+ /**
887
+ * The initial acceleration factor The kinetic momentum measured at the time of releasing the pointer will be multiplied by the factor specified by this property before being used to generate interpolat…
888
+ * @default 1.000000
889
+ */
890
+ 'acceleration-factor'?: number;
891
+ /**
892
+ * The rate at which the interpolated panning will decelerate in #ClutterPanAction will emit interpolated ::pan events with decreasing scroll deltas, using the rate specified by this property.
893
+ * @default 0.950000
894
+ */
895
+ deceleration?: number;
896
+ /**
897
+ * Whether interpolated events emission is enabled.
898
+ * @default FALSE
899
+ */
900
+ interpolate?: boolean;
901
+ /**
902
+ * Constraints the panning action to the specified axis
903
+ * @default CLUTTER_PAN_AXIS_NONE
904
+ */
905
+ 'pan-axis'?: ClutterPanAxisNick | Clutter.PanAxis;
906
+ }
907
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
908
+ export type ClutterPanActionConstructOnly = ClutterGestureActionConstructOnly;
909
+
910
+ export interface ClutterPipelineCacheProps extends GObjectProps {
911
+ }
912
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
913
+ export type ClutterPipelineCacheConstructOnly = GObjectConstructOnly;
914
+
915
+ export interface ClutterPipelineNodeProps extends ClutterPaintNodeProps {
916
+ }
917
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
918
+ export type ClutterPipelineNodeConstructOnly = ClutterPaintNodeConstructOnly;
919
+
920
+ /** Property transitions #ClutterPropertyTransition is a specialized [class@Transition] that can be used to tween a property of a [iface@Animatable] instance. */
921
+ export interface ClutterPropertyTransitionProps extends ClutterTransitionProps {
922
+ /**
923
+ * The name of the property of a [iface@Animatable] to animate.
924
+ * @default NULL
925
+ */
926
+ 'property-name'?: string;
927
+ }
928
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
929
+ export type ClutterPropertyTransitionConstructOnly = ClutterTransitionConstructOnly;
930
+
931
+ export interface ClutterRootNodeProps extends ClutterPaintNodeProps {
932
+ }
933
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
934
+ export type ClutterRootNodeConstructOnly = ClutterPaintNodeConstructOnly;
935
+
936
+ /** Action to rotate an actor #ClutterRotateAction is a sub-class of [class@GestureAction] that implements the logic for recognizing rotate gestures using two touch points. */
937
+ export interface ClutterRotateActionProps extends ClutterGestureActionProps {
938
+ }
939
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
940
+ export type ClutterRotateActionConstructOnly = ClutterGestureActionConstructOnly;
941
+
942
+ /** Settings configuration Clutter depends on some settings to perform operations like detecting multiple button press events, or font options to render text. */
943
+ export interface ClutterSettingsProps extends GObjectProps {
944
+ /**
945
+ * The default distance that the cursor of a pointer device should travel before a drag operation should start.
946
+ * @default 8
947
+ */
948
+ 'dnd-drag-threshold'?: number;
949
+ /**
950
+ * The maximum distance, in pixels, between button-press events that determines whether or not to increase the click count by 1.
951
+ * @default 5
952
+ */
953
+ 'double-click-distance'?: number;
954
+ /**
955
+ * The time, in milliseconds, that should elapse between button-press events in order to increase the click count by 1.
956
+ * @default 250
957
+ */
958
+ 'double-click-time'?: number;
959
+ /**
960
+ * The DPI used when rendering text, as a value of 1024 * dots/inch.
961
+ * @default -1
962
+ */
963
+ 'font-dpi'?: number;
964
+ /**
965
+ * The default font name that should be used by text actors, as a string that can be passed to [func@Pango.FontDescription.from_string].
966
+ * @default NULL
967
+ */
968
+ 'font-name'?: string;
969
+ /**
970
+ * Sets the minimum duration for a press to be recognized as a long press gesture.
971
+ * @default 500
972
+ */
973
+ 'long-press-duration'?: number;
974
+ /** @default 0 */
975
+ 'password-hint-time'?: number;
976
+ }
977
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
978
+ export type ClutterSettingsConstructOnly = GObjectConstructOnly;
979
+
980
+ /** Base class for shader effects #ClutterShaderEffect is a class that implements all the plumbing for creating [class@Effect]s using GLSL shaders. */
981
+ export interface ClutterShaderEffectProps extends ClutterOffscreenEffectProps {
982
+ /**
983
+ * The type of shader that is used by the effect.
984
+ * @default COGL_SHADER_TYPE_FRAGMENT
985
+ */
986
+ 'shader-type'?: CoglShaderTypeNick | Cogl.ShaderType;
987
+ }
988
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
989
+ export type ClutterShaderEffectConstructOnly = ClutterOffscreenEffectConstructOnly | 'shader-type';
990
+
991
+ export interface ClutterShaderFloatProps {
992
+ }
993
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
994
+ export type ClutterShaderFloatConstructOnly = never;
995
+
996
+ export interface ClutterShaderIntProps {
997
+ }
998
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
999
+ export type ClutterShaderIntConstructOnly = never;
1000
+
1001
+ export interface ClutterShaderMatrixProps {
1002
+ }
1003
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
1004
+ export type ClutterShaderMatrixConstructOnly = never;
1005
+
1006
+ /** A constraint snapping two actors together #ClutterSnapConstraint is a constraint the snaps the edges of two actors together, expanding the actor's allocation if necessary. */
1007
+ export interface ClutterSnapConstraintProps extends ClutterConstraintProps {
1008
+ /**
1009
+ * The edge of the [class@Actor] that should be snapped
1010
+ * @default CLUTTER_SNAP_EDGE_RIGHT
1011
+ */
1012
+ 'from-edge'?: ClutterSnapEdgeNick | Clutter.SnapEdge;
1013
+ /**
1014
+ * The offset, in pixels, between [property@SnapConstraint:from-edge] and [property@SnapConstraint:to-edge]
1015
+ * @default 0.000000
1016
+ */
1017
+ offset?: number;
1018
+ /** The [class@Actor] used as the source for the constraint */
1019
+ source?: Clutter.Actor;
1020
+ /**
1021
+ * The edge of the [property@SnapConstraint:source] that should be snapped
1022
+ * @default CLUTTER_SNAP_EDGE_RIGHT
1023
+ */
1024
+ 'to-edge'?: ClutterSnapEdgeNick | Clutter.SnapEdge;
1025
+ }
1026
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
1027
+ export type ClutterSnapConstraintConstructOnly = ClutterConstraintConstructOnly;
1028
+
1029
+ /** Top level visual element to which actors are placed. */
1030
+ export interface ClutterStageProps extends ClutterActorProps, ClutterAnimatableProps {
1031
+ /** The [class@Clutter.Actor] that will receive key events from the underlying windowing system. */
1032
+ 'key-focus'?: Clutter.Actor | null;
1033
+ }
1034
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
1035
+ export type ClutterStageConstructOnly = ClutterActorConstructOnly | ClutterAnimatableConstructOnly;
1036
+
1037
+ export interface ClutterStageViewProps extends GObjectProps {
1038
+ 'color-state'?: Clutter.ColorState;
1039
+ framebuffer?: Cogl.Framebuffer;
1040
+ layout?: Mtk.Rectangle;
1041
+ /** @default NULL */
1042
+ name?: string;
1043
+ 'output-color-state'?: Clutter.ColorState;
1044
+ /** @default 60.000000 */
1045
+ 'refresh-rate'?: number;
1046
+ /** @default 1.000000 */
1047
+ scale?: number;
1048
+ stage?: Clutter.Stage;
1049
+ /** @default 0 */
1050
+ transform?: number;
1051
+ /** @default FALSE */
1052
+ 'use-shadowfb'?: boolean;
1053
+ /** @default 0 */
1054
+ 'vblank-duration-us'?: bigint | number;
1055
+ }
1056
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
1057
+ export type ClutterStageViewConstructOnly = GObjectConstructOnly | 'name' | 'stage' | 'transform' | 'use-shadowfb' | 'vblank-duration-us';
1058
+
1059
+ /** Action for swipe gestures #ClutterSwipeAction is a sub-class of [class@GestureAction] that implements the logic for recognizing swipe gestures. */
1060
+ export interface ClutterSwipeActionProps extends ClutterGestureActionProps {
1061
+ }
1062
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
1063
+ export type ClutterSwipeActionConstructOnly = ClutterGestureActionConstructOnly;
1064
+
1065
+ /** Action for tap gestures #ClutterTapAction is a sub-class of [class@GestureAction] that implements the logic for recognizing mouse clicks and touch tap gestures. */
1066
+ export interface ClutterTapActionProps extends ClutterGestureActionProps {
1067
+ }
1068
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
1069
+ export type ClutterTapActionConstructOnly = ClutterGestureActionConstructOnly;
1070
+
1071
+ /** An actor for displaying and editing text #ClutterText is an actor that displays custom text using Pango as the text rendering engine. */
1072
+ export interface ClutterTextProps extends ClutterActorProps, ClutterAnimatableProps {
1073
+ /**
1074
+ * Toggles whether return invokes the activate signal or not.
1075
+ * @default TRUE
1076
+ */
1077
+ activatable?: boolean;
1078
+ /** A list of `PangoStyleAttribute`s to be applied to the contents of the #ClutterText actor. */
1079
+ attributes?: Pango.AttrList;
1080
+ /** The buffer which stores the text for this #ClutterText. */
1081
+ buffer?: Clutter.TextBuffer;
1082
+ /**
1083
+ * The color used to render the text.
1084
+ * @default #000000ff
1085
+ */
1086
+ color?: Cogl.Color;
1087
+ /**
1088
+ * The color of the cursor.
1089
+ * @default #000000ff
1090
+ */
1091
+ 'cursor-color'?: Cogl.Color;
1092
+ /**
1093
+ * The current input cursor position.
1094
+ * @default -1
1095
+ */
1096
+ 'cursor-position'?: number;
1097
+ /**
1098
+ * The size of the cursor, in pixels.
1099
+ * @default 2
1100
+ */
1101
+ 'cursor-size'?: number;
1102
+ /**
1103
+ * Whether the input cursor is visible or not.
1104
+ * @default TRUE
1105
+ */
1106
+ 'cursor-visible'?: boolean;
1107
+ /**
1108
+ * Whether key events delivered to the actor causes editing.
1109
+ * @default FALSE
1110
+ */
1111
+ editable?: boolean;
1112
+ /**
1113
+ * The preferred place to ellipsize the contents of the #ClutterText actor
1114
+ * @default PANGO_ELLIPSIZE_NONE
1115
+ */
1116
+ ellipsize?: PangoEllipsizeModeNick | Pango.EllipsizeMode;
1117
+ /** The [struct@Pango.FontDescription] that should be used by the #ClutterText If you have a string describing the font then you should look at [property@Text:font-name] instead */
1118
+ 'font-description'?: Pango.FontDescription;
1119
+ /**
1120
+ * The font to be used by the #ClutterText, as a string that can be parsed by [func@Pango.FontDescription.from_string].
1121
+ * @default NULL
1122
+ */
1123
+ 'font-name'?: string;
1124
+ /** @default 0 */
1125
+ 'input-hints'?: number;
1126
+ /** @default CLUTTER_INPUT_CONTENT_PURPOSE_NORMAL */
1127
+ 'input-purpose'?: ClutterInputContentPurposeNick | Clutter.InputContentPurpose;
1128
+ /**
1129
+ * Whether the contents of the #ClutterText should be justified on both margins.
1130
+ * @default FALSE
1131
+ */
1132
+ justify?: boolean;
1133
+ /**
1134
+ * The preferred alignment for the text.
1135
+ * @default PANGO_ALIGN_LEFT
1136
+ */
1137
+ 'line-alignment'?: PangoAlignmentNick | Pango.Alignment;
1138
+ /**
1139
+ * Whether to wrap the lines of [property@Text:text] if the contents exceed the available allocation.
1140
+ * @default FALSE
1141
+ */
1142
+ 'line-wrap'?: boolean;
1143
+ /**
1144
+ * If [property@Text:line-wrap] is set to %TRUE, this property will control how the text is wrapped.
1145
+ * @default PANGO_WRAP_WORD
1146
+ */
1147
+ 'line-wrap-mode'?: PangoWrapModeNick | Pango.WrapMode;
1148
+ /**
1149
+ * The maximum length of the contents of the #ClutterText actor.
1150
+ * @default 0
1151
+ */
1152
+ 'max-length'?: number;
1153
+ /**
1154
+ * If non-zero, the character that should be used in place of the actual text in a password text actor.
1155
+ * @default 0
1156
+ */
1157
+ 'password-char'?: number;
1158
+ /**
1159
+ * Whether it is possible to select text, either using the pointer or the keyboard.
1160
+ * @default TRUE
1161
+ */
1162
+ selectable?: boolean;
1163
+ /**
1164
+ * The color of selected text.
1165
+ * @default #000000ff
1166
+ */
1167
+ 'selected-text-color'?: Cogl.Color;
1168
+ /**
1169
+ * The current input cursor position.
1170
+ * @default -1
1171
+ */
1172
+ 'selection-bound'?: number;
1173
+ /**
1174
+ * The color of the selection.
1175
+ * @default #000000ff
1176
+ */
1177
+ 'selection-color'?: Cogl.Color;
1178
+ /**
1179
+ * Whether the #ClutterText actor should be in single line mode or not.
1180
+ * @default FALSE
1181
+ */
1182
+ 'single-line-mode'?: boolean;
1183
+ /** The text to render inside the actor. */
1184
+ text?: string;
1185
+ /**
1186
+ * Whether the text includes Pango markup.
1187
+ * @default FALSE
1188
+ */
1189
+ 'use-markup'?: boolean;
1190
+ }
1191
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
1192
+ export type ClutterTextConstructOnly = ClutterActorConstructOnly | ClutterAnimatableConstructOnly;
1193
+
1194
+ /** Text buffer for [class@Text] The #ClutterTextBuffer class contains the actual text displayed in a [class@Text] widget. */
1195
+ export interface ClutterTextBufferProps extends GObjectProps {
1196
+ /**
1197
+ * The maximum length (in characters) of the text in the buffer.
1198
+ * @default 0
1199
+ */
1200
+ 'max-length'?: number;
1201
+ }
1202
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
1203
+ export type ClutterTextBufferConstructOnly = GObjectConstructOnly;
1204
+
1205
+ export interface ClutterTextNodeProps extends ClutterPaintNodeProps {
1206
+ }
1207
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
1208
+ export type ClutterTextNodeConstructOnly = ClutterPaintNodeConstructOnly;
1209
+
1210
+ export interface ClutterTextureContentProps extends GObjectProps, ClutterContentProps {
1211
+ }
1212
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
1213
+ export type ClutterTextureContentConstructOnly = GObjectConstructOnly | ClutterContentConstructOnly;
1214
+
1215
+ export interface ClutterTextureNodeProps extends ClutterPipelineNodeProps {
1216
+ }
1217
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
1218
+ export type ClutterTextureNodeConstructOnly = ClutterPipelineNodeConstructOnly;
1219
+
1220
+ /** A class for time-based events #ClutterTimeline is a base class for managing time-based event that cause Clutter to redraw a stage, such as animations. */
1221
+ export interface ClutterTimelineProps extends GObjectProps {
1222
+ actor?: Clutter.Actor;
1223
+ /**
1224
+ * If the direction of the timeline should be automatically reversed when reaching the end.
1225
+ * @default FALSE
1226
+ */
1227
+ 'auto-reverse'?: boolean;
1228
+ /**
1229
+ * A delay, in milliseconds, that should be observed by the timeline before actually starting.
1230
+ * @default 0
1231
+ */
1232
+ delay?: number;
1233
+ /**
1234
+ * The direction of the timeline, either %CLUTTER_TIMELINE_FORWARD or %CLUTTER_TIMELINE_BACKWARD.
1235
+ * @default CLUTTER_TIMELINE_FORWARD
1236
+ */
1237
+ direction?: ClutterTimelineDirectionNick | Clutter.TimelineDirection;
1238
+ /**
1239
+ * Duration of the timeline in milliseconds, depending on the [property@Timeline:frame-clock] value.
1240
+ * @default 1000
1241
+ */
1242
+ duration?: number;
1243
+ /** The frame clock driving the timeline. */
1244
+ 'frame-clock'?: Clutter.FrameClock;
1245
+ /**
1246
+ * Controls the way a #ClutterTimeline computes the normalized progress.
1247
+ * @default CLUTTER_LINEAR
1248
+ */
1249
+ 'progress-mode'?: ClutterAnimationModeNick | Clutter.AnimationMode;
1250
+ /**
1251
+ * Defines how many times the timeline should repeat.
1252
+ * @default 0
1253
+ */
1254
+ 'repeat-count'?: number;
1255
+ }
1256
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
1257
+ export type ClutterTimelineConstructOnly = GObjectConstructOnly;
1258
+
1259
+ export interface ClutterTransformNodeProps extends ClutterPaintNodeProps {
1260
+ }
1261
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
1262
+ export type ClutterTransformNodeConstructOnly = ClutterPaintNodeConstructOnly;
1263
+
1264
+ /** Transition between two values #ClutterTransition is an abstract subclass of [class@Timeline] that computes the interpolation between two values, stored by a [class@Interval]. */
1265
+ export interface ClutterTransitionProps extends ClutterTimelineProps {
1266
+ /** The [iface@Animatable] instance currently being animated. */
1267
+ animatable?: Clutter.Animatable;
1268
+ /** The [class@Interval] used to describe the initial and final states of the transition. */
1269
+ interval?: Clutter.Interval;
1270
+ /**
1271
+ * Whether the #ClutterTransition should be automatically detached from the [property@Transition:animatable] instance whenever the [signal@Timeline::stopped] signal is emitted.
1272
+ * @default FALSE
1273
+ */
1274
+ 'remove-on-complete'?: boolean;
1275
+ }
1276
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
1277
+ export type ClutterTransitionConstructOnly = ClutterTimelineConstructOnly;
1278
+
1279
+ /** Group transitions together The #ClutterTransitionGroup allows running multiple [class@Transition] instances concurrently. */
1280
+ export interface ClutterTransitionGroupProps extends ClutterTransitionProps {
1281
+ }
1282
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
1283
+ export type ClutterTransitionGroupConstructOnly = ClutterTransitionConstructOnly;
1284
+
1285
+ export interface ClutterVirtualInputDeviceProps extends GObjectProps {
1286
+ /** @default CLUTTER_POINTER_DEVICE */
1287
+ 'device-type'?: ClutterInputDeviceTypeNick | Clutter.InputDeviceType;
1288
+ seat?: Clutter.Seat;
1289
+ }
1290
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
1291
+ export type ClutterVirtualInputDeviceConstructOnly = GObjectConstructOnly | 'device-type' | 'seat';
1292
+
1293
+ /** Action enabling zooming on actors #ClutterZoomAction is a sub-class of [class@GestureAction] that implements all the necessary logic for zooming actors using a "pinch" gesture between two touch point… */
1294
+ export interface ClutterZoomActionProps extends ClutterGestureActionProps {
1295
+ }
1296
+ /** Settable only at construction — a renderer must REBUILD, not patch. */
1297
+ export type ClutterZoomActionConstructOnly = ClutterGestureActionConstructOnly;
1298
+
1299
+ // ---------------------------------------------------------------------------
1300
+ // The GType-keyed widget map.
1301
+ //
1302
+ // Keyed by GType because that is also the GtkBuilder XML key and the typelib key. A
1303
+ // consumer maps GTypes to tags in ITS convention — kebab for JSX intrinsics, Pascal
1304
+ // for a Vue `GlobalComponents`, the class itself for a renderer whose element type
1305
+ // is the class. None of those is baked in here.
1306
+ //
1307
+ // `slotCandidates` is a candidate list and never an answer: derived from methods
1308
+ // taking exactly one widget argument. The GIR cannot tell adoption from reference —
1309
+ // `set_title_widget` parents its argument and `set_activatable_widget` does not, and
1310
+ // both are `void f(GtkWidget*)` at `transfer-ownership="none"`. Curation decides;
1311
+ // this is what notices when a release adds a candidate.
1312
+ // ---------------------------------------------------------------------------
1313
+
1314
+ export interface Widgets {
1315
+
1316
+ }
1317
+
1318
+ /**
1319
+ * Every GType this namespace can create AND put on screen. A consumer derives its own
1320
+ * tag map. For everything a UI file can instantiate — layout managers, event
1321
+ * controllers, cell renderers, `GtkSizeGroup` — read `DECLS` below.
1322
+ */
1323
+ export type WidgetGType = keyof Widgets;
1324
+
1325
+ // ---------------------------------------------------------------------------
1326
+ // Child holders — the same shape, for objects that CARRY a widget without being one.
1327
+ //
1328
+ // `GtkListItem`, `GtkListHeader`, `GtkColumnViewCell` and `AdwToggle` descend from
1329
+ // `GObject.Object` and hold a widget through `set_child`/`get_child`. A renderer places
1330
+ // them exactly like a container, so they belong in the vocabulary; a check asking "is
1331
+ // this a widget" must still be able to say no. Hence a sibling table rather than four
1332
+ // more rows in `Widgets`: concatenate them when you mean both.
1333
+ // ---------------------------------------------------------------------------
1334
+
1335
+ export interface ChildHolders {
1336
+
1337
+ }
1338
+
1339
+ /** Every GType this namespace holds a child in without it being a widget. */
1340
+ export type ChildHolderGType = keyof ChildHolders;
1341
+
1342
+ /** The writable, optional, GObject-keyed property surface of one GType. */
1343
+ export type PropsOf<G extends WidgetGType> = Widgets[G]['props'];
1344
+
1345
+ /** The signal table this package already emits, reached by GType. */
1346
+ export type SignalsOf<G extends WidgetGType> = Widgets[G]['signals'];
1347
+
1348
+ /** The instance type — what a `ref`-shaped prop should infer. */
1349
+ export type InstanceOf<G extends WidgetGType> = Widgets[G]['class'];
1350
+
1351
+ /** Property names that can only be set at construction. */
1352
+ export type ConstructOnlyOf<G extends WidgetGType> = Widgets[G]['constructOnly'];
1353
+
1354
+ /** Candidate child slots — see the note above; curation decides. */
1355
+ export type SlotCandidatesOf<G extends WidgetGType> = keyof Widgets[G]['slotCandidates'];
1356
+
1357
+ /**
1358
+ * The same facts as runtime data, for a consumer that CHECKS them.
1359
+ *
1360
+ * Types are erased, so a spec that asks the installed GTK whether every property
1361
+ * here is a writable ParamSpec, every signal resolvable by `GObject.signal_lookup`
1362
+ * and every nick resolvable through an enum lookup cannot read the interfaces
1363
+ * above. Emitted headlessly with no GTK present, which is exactly why the checking
1364
+ * belongs to the consumer and the DATA belongs here.
1365
+ */
1366
+ export const PROVENANCE: {
1367
+ readonly namespace: string;
1368
+ readonly version: string;
1369
+ /** The version the LIBRARY states, or null where it states none. Never the namespace's. */
1370
+ readonly libraryVersion: string | null;
1371
+ readonly childHolders: number;
1372
+ readonly droppedBases: readonly string[];
1373
+ readonly inlinedBases: readonly string[];
1374
+ /** `<decl>.<prop>` for every property printed `never` because TypeScript has no value for it. */
1375
+ readonly unsettableProps: readonly string[];
1376
+ /**
1377
+ * `<decl>.<prop>: <Ns>.<Name>` for every property printed `never` because the model
1378
+ * could not resolve its type across a namespace boundary — two independently released
1379
+ * GIRs disagreeing, which is what the main emitter answers `never` for as well.
1380
+ */
1381
+ readonly unresolvedProps: readonly string[];
1382
+ /**
1383
+ * `c:identifier-prefixes` from the GIR, verbatim and in order — `['G']` for Gio.
1384
+ *
1385
+ * The C prefix a type REFERENCE needs: resolving `Gio.Icon` means producing `GIcon`,
1386
+ * and nothing else in this package states that `Gio` spells itself `G`. Carried rather
1387
+ * than derived because GIR carries it, and a derivation over the `DECLS` keys is wrong
1388
+ * wherever the C prefix is not a prefix of the type NAMES: gdkx11-4.0 and gdkwayland-4.0
1389
+ * both state `Gdk` while every key they declare begins `GdkX11`/`GdkWayland`.
1390
+ *
1391
+ * Empty where the GIR states none — 17 of the 627 emitting namespaces — because
1392
+ * inventing the namespace name there is a confident wrong answer in place of a missing
1393
+ * one. A LIST because 20 of them state more than one, which no single string expresses.
1394
+ */
1395
+ readonly identifierPrefixes: readonly string[];
1396
+ /**
1397
+ * Sibling vocabularies this one's DECLARATIONS come from, as import specifiers.
1398
+ *
1399
+ * A chain link with no `OWN_PROPS` row is ambiguous on its own — `GtkSeparator` has no
1400
+ * settable property, `GApplication` has its properties in another package — and this
1401
+ * list is what tells the two apart. Enum and bitfield NUMBERS are not here: those are
1402
+ * carried in this file, because a `PROP_ENUMS` row naming a foreign GType gives a
1403
+ * consumer nothing to load and a `.ui` file using the property never names its owner.
1404
+ */
1405
+ readonly requiredVocabularies: readonly string[];
1406
+ };
1407
+
1408
+ /** Declaration GType -> its own settable properties, as GObject registered them. */
1409
+ export const OWN_PROPS: Readonly<Record<string, readonly string[]>>;
1410
+
1411
+ /**
1412
+ * Declaration GType -> the signals it registers itself, never its parents'.
1413
+ *
1414
+ * Keyed like `OWN_PROPS`, so both are read at every link of a `DECLS` chain. An
1415
+ * abstract base has no `Widgets` row and still owns signals — `GtkWidget` owns 13.
1416
+ */
1417
+ export const OWN_SIGNALS: Readonly<Record<string, readonly string[]>>;
1418
+
1419
+ /**
1420
+ * Instantiable GType -> every declaration its members come from, self first.
1421
+ *
1422
+ * The key set is what a UI description file can NAME: every registered, non-abstract
1423
+ * class this namespace declares. GtkBuilder resolves a `<object class="…">` through
1424
+ * `g_type_from_name`, which knows nothing about widgets, so this is wider than
1425
+ * `Widgets` by design — `GtkSizeGroup`, `GtkTextTag`, every `GtkEventController`
1426
+ * and every `GtkCellRenderer` are here and are not widgets.
1427
+ *
1428
+ * `Widgets` and `CHILD_HOLDERS` are the narrower questions and answer them unchanged.
1429
+ */
1430
+ export const DECLS: Readonly<Record<string, readonly string[]>>;
1431
+
1432
+ /** The GTypes in `DECLS` that hold a widget without being one — see `ChildHolders`. */
1433
+ export const CHILD_HOLDERS: readonly string[];
1434
+
1435
+ /** Enum GType -> the nicks this surface offers. */
1436
+ export const ENUM_NICKS: Readonly<Record<string, readonly string[]>>;
1437
+
1438
+ /**
1439
+ * `<enum GType>.<nick>` -> the integer GObject registers for it, from GIR's `value`.
1440
+ *
1441
+ * Position in `ENUM_NICKS` is NOT this number. Counting is wrong on 6 of the 137 enums a
1442
+ * GTK 4 vocabulary carries -- 112 in Gtk-4.0 and 25 in Adw-1: `GtkResponseType` runs -1 to -11, `GtkTextWindowType` starts
1443
+ * at 1, `GtkOrdering` and `GtkConstraintRelation` are -1/0/1, `GtkAlign` has two names
1444
+ * on one value, and `GtkConstraintStrength.required` is 1001001000 where counting says 0.
1445
+ *
1446
+ * Read from the same GIR as the nicks, deliberately. A consumer reading the numbers off an
1447
+ * installed typelib instead has two provenances for one table, and then cannot tell a
1448
+ * missing number from a host older than the vocabulary.
1449
+ */
1450
+ export const ENUM_VALUES: Readonly<Record<string, number>>;
1451
+
1452
+ /**
1453
+ * The `<enum GType>.<nick>` entries GIR marks `deprecated="1"`.
1454
+ *
1455
+ * Two names on one value is how GObject spells an alias -- `GTK_ALIGN_BASELINE` and
1456
+ * `GTK_ALIGN_BASELINE_FILL` are both 4, and both keep a `ENUM_VALUES` entry. The pairing
1457
+ * is visible in the numbers; which name is the old one is not, and this is that fact --
1458
+ * where GIR states it. It usually does not: 4 registered-enum members across the 718 GIRs
1459
+ * carry the attribute, and 179 of the 182 value-sharing pairs carry it on neither half, so
1460
+ * absence from this list means GIR is silent, not that the nick is the current one.
1461
+ */
1462
+ export const ENUM_DEPRECATED: readonly string[];
1463
+
1464
+ /**
1465
+ * `<enum GType>.<nick>` -> the raw GIR `value` no number could be read from.
1466
+ *
1467
+ * The declared remainder, so that every nick in `ENUM_NICKS` is in `ENUM_VALUES` or in
1468
+ * here and a drop cannot be silent. Two shapes reach it: a symbolic or absent value (Vala
1469
+ * writes `(null)`, a char enum writes a letter) and an integer past
1470
+ * `Number.MAX_SAFE_INTEGER`, where a literal would lose precision and stop being the
1471
+ * GIR's number. Empty for Gtk, Adw, GLib and Gio.
1472
+ */
1473
+ export const ENUM_VALUES_UNREADABLE: Readonly<Record<string, string>>;
1474
+
1475
+ /**
1476
+ * `<bitfield GType>.<nick>` -> the integer GObject registers for that one member.
1477
+ *
1478
+ * `ENUM_NICKS` carries no bitfield, because GObject cannot resolve a nick SET; that says
1479
+ * nothing about a single member's number, and the number is what a host without GI needs.
1480
+ * 23 settable properties in Gtk-4.0 and Adw-1 are bitfield-typed and are declared bare
1481
+ * `number` -- `GtkEntry:input-hints`, `GtkPopoverMenu:flags`, `AdwTabView:shortcuts`,
1482
+ * `GtkDropTarget:actions` among them. Counting is worst here: 119 of the 156 Gtk-4.0
1483
+ * bitfield members this vocabulary carries disagree with their declaration position,
1484
+ * against 29 of 672 enumeration members.
1485
+ *
1486
+ * Combine with `|` as GObject does. There is no nick table to pair this with, so a name
1487
+ * here is resolvable and a SET still is not.
1488
+ */
1489
+ export const FLAG_VALUES: Readonly<Record<string, number>>;
1490
+
1491
+ /** `<bitfield GType>.<nick>` -> the raw GIR `value` no number could be read from. */
1492
+ export const FLAG_VALUES_UNREADABLE: Readonly<Record<string, string>>;
1493
+
1494
+ /**
1495
+ * `<declaration GType>.<property>` -> the GType of that property's enum or bitfield.
1496
+ *
1497
+ * The join the value tables need and nothing else here carries. A host with no GI has a
1498
+ * property name and a nick and needs a number; `ENUM_VALUES` is keyed by ENUM GType, and
1499
+ * only this says which enum a property is. Keyed by DECLARATION like `OWN_PROPS`, so it is
1500
+ * read at every link of a `DECLS` chain — `orientation` belongs to `GtkOrientable`, not
1501
+ * to the `GtkBox` a caller starts from.
1502
+ *
1503
+ * Present only where the property's OWN type is the enum: an array of them, or a union that
1504
+ * merely mentions one, would be an entry a consumer resolves wrongly.
1505
+ *
1506
+ * The GType named here is not always one THIS module gives numbers for. A nick vocabulary is
1507
+ * emitted once, by the namespace that owns the enum, so `AdwComboRow.search-match-mode` names
1508
+ * `GtkStringFilterMatchMode` and its rows are in `@girs/gtk-4.0/vocabulary` — 83 of the 909
1509
+ * entries in a full run resolve only with the owner's vocabulary loaded beside this one. An
1510
+ * owner with no vocabulary of its own (Gdk, Pango) is inlined here instead, so every entry
1511
+ * resolves against SOME module.
1512
+ */
1513
+ export const PROP_ENUMS: Readonly<Record<string, string>>;
1514
+
1515
+ /**
1516
+ * `<declaration GType>.<property>` -> the GType of that property's own type.
1517
+ *
1518
+ * `PROP_ENUMS` one case wider, and separate on purpose: that table promises the GType it names
1519
+ * has NUMBERS, and this one promises only that the GType is the property's. A host inferring a
1520
+ * type from a property — the middle of an uncast lookup chain, an uncast closure's return type —
1521
+ * reads this one; a host resolving a nick to a number reads that one.
1522
+ *
1523
+ * Absent means no GType can be stated, not that the property is scalar: `gchararray` is carried
1524
+ * like any other, so absence is readable as "unknown".
1525
+ */
1526
+ export const PROP_TYPES: Readonly<Record<string, string>>;
1527
+
1528
+ /**
1529
+ * The kinds of value a GTK accessible property, relation or state takes.
1530
+ *
1531
+ * `enum` is the one that needs a second lookup: `ARIA_VALUE_ENUMS` names the enum GType,
1532
+ * and `ENUM_NICKS` and `ENUM_VALUES` answer from there.
1533
+ */
1534
+ export type AriaValueType = 'string' | 'integer' | 'double' | 'boolean' | 'reference' | 'enum';
1535
+
1536
+ /**
1537
+ * `<enum GType>.<nick>` -> the kind of value that ARIA slot takes.
1538
+ *
1539
+ * The one table in this file that is not a fact about a ParamSpec. A GtkBuilder or
1540
+ * Blueprint `accessibility { … }` block is typed by GTK's ARIA table, not by the widget,
1541
+ * and the two disagree where it costs most: `orientation` is settable on a `GtkLabel`
1542
+ * that implements no `GtkOrientable`, and `checked` is a `GtkAccessibleTristate`, so
1543
+ * `checked: true` is the number 1 rather than a boolean. Typing those slots from the
1544
+ * widget's properties gets both wrong and raises nothing.
1545
+ *
1546
+ * Keyed like `ENUM_VALUES` because the ARIA names ARE enum members — of
1547
+ * `GtkAccessibleProperty`, `GtkAccessibleRelation` and `GtkAccessibleState` — so
1548
+ * `ENUM_NICKS` already lists them and one key parser reads both.
1549
+ *
1550
+ * Read from each member's own GIR documentation. `gtk_accessible_property_init_value()`
1551
+ * is the C half of this table and is not introspectable; the doc sentence is, and states
1552
+ * the type for 52 of the 53 members in gtk4 4.23.3. Complete or absent, never partial: a
1553
+ * member the generator cannot answer for fails the build and names itself.
1554
+ */
1555
+ export const ARIA_VALUE_TYPES: Readonly<Record<string, AriaValueType>>;
1556
+
1557
+ /**
1558
+ * The same keys, for the `'enum'` rows only -> the GType of that enum.
1559
+ *
1560
+ * A table of its own for the reason `PROP_ENUMS` is one: folded in, the values of
1561
+ * `ARIA_VALUE_TYPES` would be six reserved words mixed with arbitrary GTypes and telling
1562
+ * them apart would be the consumer's problem. Apart, `ARIA_VALUE_TYPES[k] === 'enum'` is
1563
+ * the whole test and `ENUM_NICKS[ARIA_VALUE_ENUMS[k]]` is the nick list.
1564
+ */
1565
+ export const ARIA_VALUE_ENUMS: Readonly<Record<string, string>>;
1566
+
1567
+ /** Widget GType -> slot name -> the method that may adopt a child there. */
1568
+ export const SLOT_CANDIDATES: Readonly<Record<string, Readonly<Record<string, string>>>>;
1569
+
1570
+ /**
1571
+ * `Type`, `Type.property` and `Type::signal` -> the release that introduced it.
1572
+ *
1573
+ * What keeps a runtime cross-check honest across a version gap without an
1574
+ * allowlist: a name the installed library lacks is a defect UNLESS the version
1575
+ * here is newer than the one running.
1576
+ *
1577
+ * ALL THREE key shapes, because that test only works for the names it covers. A
1578
+ * property-only map leaves a consumer no way to explain a missing SIGNAL, which is
1579
+ * a correct vocabulary reported as 18 defects; a member-only map leaves it no way to
1580
+ * explain a missing CLASS, and that one fails as a bare
1581
+ * `TypeError: can't access property "$gtype", ctor() is undefined` that does not
1582
+ * even name the GType.
1583
+ *
1584
+ * A key is present only where the GIR states a version — sparse by nature (`version`
1585
+ * sits on 29 of the 301 classes and interfaces in Gtk-4.0), never inferred.
1586
+ */
1587
+ export const SINCE: Readonly<Record<string, string>>;