diff --git a/Sources/Core/View/Generated/ActionRow.swift b/Sources/Core/View/Generated/ActionRow.swift index 1cd0d8f..04ab465 100644 --- a/Sources/Core/View/Generated/ActionRow.swift +++ b/Sources/Core/View/Generated/ActionRow.swift @@ -2,7 +2,7 @@ // ActionRow.swift // Adwaita // -// Created by auto-generation on 31.10.24. +// Created by auto-generation on 09.04.25. // import CAdw diff --git a/Sources/Core/View/Generated/AspectFrame.swift b/Sources/Core/View/Generated/AspectFrame.swift index 3167e35..bfea154 100644 --- a/Sources/Core/View/Generated/AspectFrame.swift +++ b/Sources/Core/View/Generated/AspectFrame.swift @@ -2,13 +2,13 @@ // AspectFrame.swift // Adwaita // -// Created by auto-generation on 31.10.24. +// Created by auto-generation on 09.04.25. // import CAdw import LevenshteinTransformations -/// `GtkAspectFrame` preserves the aspect ratio of its child. +/// Preserves the aspect ratio of its child. /// /// The frame can respect the aspect ratio of the child widget, /// or use its own aspect ratio. @@ -19,9 +19,9 @@ import LevenshteinTransformations /// /// # Accessibility /// -/// Until GTK 4.10, `GtkAspectFrame` used the `GTK_ACCESSIBLE_ROLE_GROUP` role. +/// Until GTK 4.10, `GtkAspectFrame` used the [enum@Gtk.AccessibleRole.group] role. /// -/// Starting from GTK 4.12, `GtkAspectFrame` uses the `GTK_ACCESSIBLE_ROLE_GENERIC` role. +/// Starting from GTK 4.12, `GtkAspectFrame` uses the [enum@Gtk.AccessibleRole.generic] role. public struct AspectFrame: AdwaitaWidget { /// Additional update functions for type extensions. diff --git a/Sources/Core/View/Generated/Avatar.swift b/Sources/Core/View/Generated/Avatar.swift index cd2eb3f..7cf81a0 100644 --- a/Sources/Core/View/Generated/Avatar.swift +++ b/Sources/Core/View/Generated/Avatar.swift @@ -2,7 +2,7 @@ // Avatar.swift // Adwaita // -// Created by auto-generation on 31.10.24. +// Created by auto-generation on 09.04.25. // import CAdw @@ -28,6 +28,10 @@ import LevenshteinTransformations /// ## CSS nodes /// /// `AdwAvatar` has a single CSS node with name `avatar`. +/// +/// ## Accessibility +/// +/// `AdwAvatar` uses the `GTK_ACCESSIBLE_ROLE_IMG` role. public struct Avatar: AdwaitaWidget { /// Additional update functions for type extensions. diff --git a/Sources/Core/View/Generated/Banner.swift b/Sources/Core/View/Generated/Banner.swift index 800295a..a2350a2 100644 --- a/Sources/Core/View/Generated/Banner.swift +++ b/Sources/Core/View/Generated/Banner.swift @@ -2,7 +2,7 @@ // Banner.swift // Adwaita // -// Created by auto-generation on 31.10.24. +// Created by auto-generation on 09.04.25. // import CAdw @@ -22,7 +22,10 @@ import LevenshteinTransformations /// /// Banners can optionally have a button with text on it, set through /// [property@Banner:button-label]. The button can be used with a `GAction`, -/// or with the [signal@Banner::button-clicked] signal. +/// or with the [signal@Banner::button-clicked] signal. The button can have +/// different styles, a gray style and a suggested style. +/// +/// banner with suggested button style /// /// ## CSS nodes /// diff --git a/Sources/Core/View/Generated/Bin.swift b/Sources/Core/View/Generated/Bin.swift index 3bd5e21..a56fe9a 100644 --- a/Sources/Core/View/Generated/Bin.swift +++ b/Sources/Core/View/Generated/Bin.swift @@ -2,7 +2,7 @@ // Bin.swift // Adwaita // -// Created by auto-generation on 31.10.24. +// Created by auto-generation on 09.04.25. // import CAdw diff --git a/Sources/Core/View/Generated/Box.swift b/Sources/Core/View/Generated/Box.swift index dc99711..57744a7 100644 --- a/Sources/Core/View/Generated/Box.swift +++ b/Sources/Core/View/Generated/Box.swift @@ -2,21 +2,21 @@ // Box.swift // Adwaita // -// Created by auto-generation on 31.10.24. +// Created by auto-generation on 09.04.25. // import CAdw import LevenshteinTransformations -/// The `GtkBox` widget arranges child widgets into a single row or column. +/// Arranges child widgets into a single row or column. /// -/// ![An example GtkBox](box.png) +/// An example GtkBox /// /// Whether it is a row or column depends on the value of its /// [property@Gtk.Orientable:orientation] property. Within the other -/// dimension, all children are allocated the same size. Of course, the -/// [property@Gtk.Widget:halign] and [property@Gtk.Widget:valign] properties -/// can be used on the children to influence their allocation. +/// dimension, all children are allocated the same size. The +/// [property@Gtk.Widget:halign] and [property@Gtk.Widget:valign] +/// properties can be used on the children to influence their allocation. /// /// Use repeated calls to [method@Gtk.Box.append] to pack widgets into a /// `GtkBox` from start to end. Use [method@Gtk.Box.remove] to remove widgets @@ -39,9 +39,9 @@ import LevenshteinTransformations /// /// # Accessibility /// -/// Until GTK 4.10, `GtkBox` used the `GTK_ACCESSIBLE_ROLE_GROUP` role. +/// Until GTK 4.10, `GtkBox` used the [enum@Gtk.AccessibleRole.group] role. /// -/// Starting from GTK 4.12, `GtkBox` uses the `GTK_ACCESSIBLE_ROLE_GENERIC` role. +/// Starting from GTK 4.12, `GtkBox` uses the [enum@Gtk.AccessibleRole.generic] role. public struct Box: AdwaitaWidget { /// Additional update functions for type extensions. @@ -53,7 +53,9 @@ public struct Box: AdwaitaWidget { /// /// The accessible role cannot be changed once set. var accessibleRole: String? - /// The child that determines the baseline, in vertical orientation. + /// The position of the child that determines the baseline. + /// + /// This is only relevant if the box is in vertical orientation. var baselineChild: Int? /// Whether the children should all be the same size. var homogeneous: Bool? @@ -159,7 +161,9 @@ public struct Box: AdwaitaWidget { return newSelf } - /// The child that determines the baseline, in vertical orientation. + /// The position of the child that determines the baseline. + /// + /// This is only relevant if the box is in vertical orientation. public func baselineChild(_ baselineChild: Int?) -> Self { var newSelf = self newSelf.baselineChild = baselineChild diff --git a/Sources/Core/View/Generated/Button.swift b/Sources/Core/View/Generated/Button.swift index a1c0e94..908a277 100644 --- a/Sources/Core/View/Generated/Button.swift +++ b/Sources/Core/View/Generated/Button.swift @@ -2,16 +2,15 @@ // Button.swift // Adwaita // -// Created by auto-generation on 31.10.24. +// Created by auto-generation on 09.04.25. // import CAdw import LevenshteinTransformations -/// The `GtkButton` widget is generally used to trigger a callback function that is -/// called when the button is pressed. +/// Calls a callback function when the button is clicked. /// -/// ![An example GtkButton](button.png) +/// An example GtkButton /// /// The `GtkButton` widget can hold any valid child widget. That is, it can hold /// almost any other standard `GtkWidget`. The most commonly used child is the @@ -43,7 +42,7 @@ import LevenshteinTransformations /// /// # Accessibility /// -/// `GtkButton` uses the %GTK_ACCESSIBLE_ROLE_BUTTON role. +/// `GtkButton` uses the [enum@Gtk.AccessibleRole.button] role. public struct Button: AdwaitaWidget { /// Additional update functions for type extensions. diff --git a/Sources/Core/View/Generated/ButtonContent.swift b/Sources/Core/View/Generated/ButtonContent.swift index 6f2a9c9..29e1838 100644 --- a/Sources/Core/View/Generated/ButtonContent.swift +++ b/Sources/Core/View/Generated/ButtonContent.swift @@ -2,7 +2,7 @@ // ButtonContent.swift // Adwaita // -// Created by auto-generation on 31.10.24. +// Created by auto-generation on 09.04.25. // import CAdw diff --git a/Sources/Core/View/Generated/Carousel.swift b/Sources/Core/View/Generated/Carousel.swift index 802b0d5..9f5eed3 100644 --- a/Sources/Core/View/Generated/Carousel.swift +++ b/Sources/Core/View/Generated/Carousel.swift @@ -2,7 +2,7 @@ // Carousel.swift // Adwaita // -// Created by auto-generation on 31.10.24. +// Created by auto-generation on 09.04.25. // import CAdw diff --git a/Sources/Core/View/Generated/CenterBox.swift b/Sources/Core/View/Generated/CenterBox.swift index 947811a..6c8c013 100644 --- a/Sources/Core/View/Generated/CenterBox.swift +++ b/Sources/Core/View/Generated/CenterBox.swift @@ -2,16 +2,16 @@ // CenterBox.swift // Adwaita // -// Created by auto-generation on 31.10.24. +// Created by auto-generation on 09.04.25. // import CAdw import LevenshteinTransformations -/// `GtkCenterBox` arranges three children in a row, keeping the middle child +/// Arranges three children in a row, keeping the middle child /// centered as well as possible. /// -/// ![An example GtkCenterBox](centerbox.png) +/// An example GtkCenterBox /// /// To add children to `GtkCenterBox`, use [method@Gtk.CenterBox.set_start_widget], /// [method@Gtk.CenterBox.set_center_widget] and @@ -39,9 +39,10 @@ import LevenshteinTransformations /// /// # Accessibility /// -/// Until GTK 4.10, `GtkCenterBox` used the `GTK_ACCESSIBLE_ROLE_GROUP` role. +/// Until GTK 4.10, `GtkCenterBox` used the [enum@Gtk.AccessibleRole.group] role. /// -/// Starting from GTK 4.12, `GtkCenterBox` uses the `GTK_ACCESSIBLE_ROLE_GENERIC` role. +/// Starting from GTK 4.12, `GtkCenterBox` uses the [enum@Gtk.AccessibleRole.generic] +/// role. public struct CenterBox: AdwaitaWidget { /// Additional update functions for type extensions. @@ -59,7 +60,7 @@ public struct CenterBox: AdwaitaWidget { /// /// In vertical orientation, the end position is at the bottom. /// In horizontal orientation, the end position is at the trailing - /// edge wrt. to the text direction. + /// edge with respect to the text direction. var endWidget: (() -> Body)? /// Whether to shrink the center widget after other children. /// @@ -67,14 +68,14 @@ public struct CenterBox: AdwaitaWidget { /// natural widths, the start and end widgets start shrinking and the /// center child keeps natural width until they reach minimum width. /// - /// If set to `FALSE`, start and end widgets keep natural width and the + /// If false, start and end widgets keep natural width and the /// center widget starts shrinking instead. var shrinkCenterLast: Bool? /// The widget that is placed at the start position. /// /// In vertical orientation, the start position is at the top. /// In horizontal orientation, the start position is at the leading - /// edge wrt. to the text direction. + /// edge with respect to the text direction. var startWidget: (() -> Body)? /// Initialize `CenterBox`. @@ -161,7 +162,7 @@ public struct CenterBox: AdwaitaWidget { /// /// In vertical orientation, the end position is at the bottom. /// In horizontal orientation, the end position is at the trailing - /// edge wrt. to the text direction. + /// edge with respect to the text direction. public func endWidget(@ViewBuilder _ endWidget: @escaping (() -> Body)) -> Self { var newSelf = self newSelf.endWidget = endWidget @@ -174,7 +175,7 @@ public struct CenterBox: AdwaitaWidget { /// natural widths, the start and end widgets start shrinking and the /// center child keeps natural width until they reach minimum width. /// - /// If set to `FALSE`, start and end widgets keep natural width and the + /// If false, start and end widgets keep natural width and the /// center widget starts shrinking instead. public func shrinkCenterLast(_ shrinkCenterLast: Bool? = true) -> Self { var newSelf = self @@ -186,7 +187,7 @@ public struct CenterBox: AdwaitaWidget { /// /// In vertical orientation, the start position is at the top. /// In horizontal orientation, the start position is at the leading - /// edge wrt. to the text direction. + /// edge with respect to the text direction. public func startWidget(@ViewBuilder _ startWidget: @escaping (() -> Body)) -> Self { var newSelf = self newSelf.startWidget = startWidget diff --git a/Sources/Core/View/Generated/CheckButton.swift b/Sources/Core/View/Generated/CheckButton.swift index 4d1d73f..5e9ce05 100644 --- a/Sources/Core/View/Generated/CheckButton.swift +++ b/Sources/Core/View/Generated/CheckButton.swift @@ -2,15 +2,15 @@ // CheckButton.swift // Adwaita // -// Created by auto-generation on 31.10.24. +// Created by auto-generation on 09.04.25. // import CAdw import LevenshteinTransformations -/// A `GtkCheckButton` places a label next to an indicator. +/// Places a label next to an indicator. /// -/// ![Example GtkCheckButtons](check-button.png) +/// Example GtkCheckButtons /// /// A `GtkCheckButton` is created by calling either [ctor@Gtk.CheckButton.new] /// or [ctor@Gtk.CheckButton.new_with_label]. @@ -39,7 +39,7 @@ import LevenshteinTransformations /// Grouped check buttons use a different indicator, and are commonly referred /// to as *radio buttons*. /// -/// ![Example GtkCheckButtons](radio-button.png) +/// Example GtkRadioButtons /// /// To add a `GtkCheckButton` to a group, use [method@Gtk.CheckButton.set_group]. /// @@ -70,7 +70,7 @@ import LevenshteinTransformations /// /// # Accessibility /// -/// `GtkCheckButton` uses the %GTK_ACCESSIBLE_ROLE_CHECKBOX role. +/// `GtkCheckButton` uses the [enum@Gtk.AccessibleRole.checkbox] role. public struct CheckButton: AdwaitaWidget { /// Additional update functions for type extensions. diff --git a/Sources/Core/View/Generated/Clamp.swift b/Sources/Core/View/Generated/Clamp.swift index 4875e21..30df04a 100644 --- a/Sources/Core/View/Generated/Clamp.swift +++ b/Sources/Core/View/Generated/Clamp.swift @@ -2,7 +2,7 @@ // Clamp.swift // Adwaita // -// Created by auto-generation on 31.10.24. +// Created by auto-generation on 09.04.25. // import CAdw diff --git a/Sources/Core/View/Generated/ComboRow.swift b/Sources/Core/View/Generated/ComboRow.swift index 758e3a5..4f30156 100644 --- a/Sources/Core/View/Generated/ComboRow.swift +++ b/Sources/Core/View/Generated/ComboRow.swift @@ -2,7 +2,7 @@ // ComboRow.swift // Adwaita // -// Created by auto-generation on 31.10.24. +// Created by auto-generation on 09.04.25. // import CAdw diff --git a/Sources/Core/View/Generated/EntryRow.swift b/Sources/Core/View/Generated/EntryRow.swift index eb97aab..44e49e2 100644 --- a/Sources/Core/View/Generated/EntryRow.swift +++ b/Sources/Core/View/Generated/EntryRow.swift @@ -2,7 +2,7 @@ // EntryRow.swift // Adwaita // -// Created by auto-generation on 31.10.24. +// Created by auto-generation on 09.04.25. // import CAdw diff --git a/Sources/Core/View/Generated/ExpanderRow.swift b/Sources/Core/View/Generated/ExpanderRow.swift index c2b1c8f..a066d66 100644 --- a/Sources/Core/View/Generated/ExpanderRow.swift +++ b/Sources/Core/View/Generated/ExpanderRow.swift @@ -2,7 +2,7 @@ // ExpanderRow.swift // Adwaita // -// Created by auto-generation on 31.10.24. +// Created by auto-generation on 09.04.25. // import CAdw diff --git a/Sources/Core/View/Generated/Fixed.swift b/Sources/Core/View/Generated/Fixed.swift index 4ee0f7a..44e6f46 100644 --- a/Sources/Core/View/Generated/Fixed.swift +++ b/Sources/Core/View/Generated/Fixed.swift @@ -2,13 +2,13 @@ // Fixed.swift // Adwaita // -// Created by auto-generation on 31.10.24. +// Created by auto-generation on 09.04.25. // import CAdw import LevenshteinTransformations -/// `GtkFixed` places its child widgets at fixed positions and with fixed sizes. +/// Places its child widgets at fixed positions and with fixed sizes. /// /// `GtkFixed` performs no automatic layout management. /// diff --git a/Sources/Core/View/Generated/FlowBox.swift b/Sources/Core/View/Generated/FlowBox.swift index 300e9a6..4a32e48 100644 --- a/Sources/Core/View/Generated/FlowBox.swift +++ b/Sources/Core/View/Generated/FlowBox.swift @@ -2,13 +2,15 @@ // FlowBox.swift // Adwaita // -// Created by auto-generation on 31.10.24. +// Created by auto-generation on 09.04.25. // import CAdw import LevenshteinTransformations -/// A `GtkFlowBox` puts child widgets in reflowing grid. +/// Puts child widgets in a reflowing grid. +/// +/// An example GtkFlowBox /// /// For instance, with the horizontal orientation, the widgets will be /// arranged from left to right, starting a new row under the previous @@ -59,8 +61,8 @@ import LevenshteinTransformations /// /// # Accessibility /// -/// `GtkFlowBox` uses the %GTK_ACCESSIBLE_ROLE_GRID role, and `GtkFlowBoxChild` -/// uses the %GTK_ACCESSIBLE_ROLE_GRID_CELL role. +/// `GtkFlowBox` uses the [enum@Gtk.AccessibleRole.grid] role, and `GtkFlowBoxChild` +/// uses the [enum@Gtk.AccessibleRole.grid_cell] role. public struct FlowBox: AdwaitaWidget where Element: Identifiable { /// Additional update functions for type extensions. diff --git a/Sources/Core/View/Generated/HeaderBar.swift b/Sources/Core/View/Generated/HeaderBar.swift index 36127f4..512ddda 100644 --- a/Sources/Core/View/Generated/HeaderBar.swift +++ b/Sources/Core/View/Generated/HeaderBar.swift @@ -2,7 +2,7 @@ // HeaderBar.swift // Adwaita // -// Created by auto-generation on 31.10.24. +// Created by auto-generation on 09.04.25. // import CAdw @@ -86,7 +86,7 @@ import LevenshteinTransformations /// `AdwHeaderBar`'s CSS node is called `headerbar`. It contains a `windowhandle` /// subnode, which contains a `box` subnode, which contains three `widget` /// subnodes at the start, center and end of the header bar. The start and end -/// subnotes contain a `box` subnode with the `.start` and `.end` style classes +/// subnodes contain a `box` subnode with the `.start` and `.end` style classes /// respectively, and the center node contains a node that represents the title. /// /// Each of the boxes contains a `windowcontrols` subnode, see diff --git a/Sources/Core/View/Generated/Label.swift b/Sources/Core/View/Generated/Label.swift index aacdbb1..0c9adb0 100644 --- a/Sources/Core/View/Generated/Label.swift +++ b/Sources/Core/View/Generated/Label.swift @@ -2,18 +2,17 @@ // Label.swift // Adwaita // -// Created by auto-generation on 31.10.24. +// Created by auto-generation on 09.04.25. // import CAdw import LevenshteinTransformations -/// The `GtkLabel` widget displays a small amount of text. +/// Displays a small amount of text. /// -/// As the name implies, most labels are used to label another widget -/// such as a [class@Button]. +/// Most labels are used to label another widget (such as an [class@Entry]). /// -/// ![An example GtkLabel](label.png) +/// An example GtkLabel /// /// ## Shortcuts and Gestures /// @@ -92,7 +91,7 @@ import LevenshteinTransformations /// /// ## Accessibility /// -/// `GtkLabel` uses the %GTK_ACCESSIBLE_ROLE_LABEL role. +/// `GtkLabel` uses the [enum@Gtk.AccessibleRole.label] role. /// /// ## Mnemonics /// @@ -137,9 +136,8 @@ import LevenshteinTransformations /// /// ## Markup (styled text) /// -/// To make it easy to format text in a label (changing colors, -/// fonts, etc.), label text can be provided in a simple -/// markup format: +/// To make it easy to format text in a label (changing colors, fonts, etc.), +/// label text can be provided in a simple markup format: /// /// Here’s how to create a label with a small font: /// ```c @@ -150,7 +148,7 @@ import LevenshteinTransformations /// (See the Pango manual for complete documentation] of available /// tags, [func@Pango.parse_markup]) /// -/// The markup passed to [method@Gtk.Label.set_markup] must be valid; for example, +/// The markup passed to [method@Gtk.Label.set_markup] must be valid XML; for example, /// literal `<`, `>` and `&` characters must be escaped as `<`, `>`, and `&`. /// If you pass text obtained from the user, file, or a network to /// [method@Gtk.Label.set_markup], you’ll want to escape it with @@ -161,16 +159,16 @@ import LevenshteinTransformations /// attributes in some cases. Be careful though; [struct@Pango.AttrList] tends /// to cause internationalization problems, unless you’re applying attributes /// to the entire string (i.e. unless you set the range of each attribute -/// to [0, %G_MAXINT)). The reason is that specifying the start_index and -/// end_index for a [struct@Pango.Attribute] requires knowledge of the exact +/// to [0, `G_MAXINT`)). The reason is that specifying the `start_index` and +/// `end_index` for a [struct@Pango.Attribute] requires knowledge of the exact /// string being displayed, so translations will cause problems. /// /// ## Selectable labels /// /// Labels can be made selectable with [method@Gtk.Label.set_selectable]. -/// Selectable labels allow the user to copy the label contents to -/// the clipboard. Only labels that contain useful-to-copy information—such -/// as error messages—should be made selectable. +/// Selectable labels allow the user to copy the label contents to the +/// clipboard. Only labels that contain useful-to-copy information — such +/// as error messages — should be made selectable. /// /// ## Text layout /// @@ -198,11 +196,11 @@ import LevenshteinTransformations /// ## Links /// /// GTK supports markup for clickable hyperlinks in addition to regular Pango -/// markup. The markup for links is borrowed from HTML, using the `` with -/// “href“, “title“ and “class“ attributes. GTK renders links similar to the -/// way they appear in web browsers, with colored, underlined text. The “title“ -/// attribute is displayed as a tooltip on the link. The “class“ attribute is -/// used as style class on the CSS node for the link. +/// markup. The markup for links is borrowed from HTML, using the `` tag +/// with “href“, “title“ and “class“ attributes. GTK renders links similar to +/// the way they appear in web browsers, with colored, underlined text. The +/// “title“ attribute is displayed as a tooltip on the link. The “class“ +/// attribute is used as style class on the CSS node for the link. /// /// An example of inline links looks like this: /// @@ -233,27 +231,37 @@ public struct Label: AdwaitaWidget { /// /// If the string contains Pango markup (see [func@Pango.parse_markup]), /// you will have to set the [property@Gtk.Label:use-markup] property to - /// %TRUE in order for the label to display the markup attributes. See also + /// true in order for the label to display the markup attributes. See also /// [method@Gtk.Label.set_markup] for a convenience function that sets both /// this property and the [property@Gtk.Label:use-markup] property at the /// same time. /// /// If the string contains underlines acting as mnemonics, you will have to - /// set the [property@Gtk.Label:use-underline] property to %TRUE in order + /// set the [property@Gtk.Label:use-underline] property to true in order /// for the label to display them. var label: String /// The number of lines to which an ellipsized, wrapping label - /// should be limited. + /// should display before it gets ellipsized. This both prevents the label + /// from ellipsizing before this many lines are displayed, and limits the + /// height request of the label to this many lines. + /// + /// ::: warning + /// Setting this property has unintuitive and unfortunate consequences + /// for the minimum _width_ of the label. Specifically, if the height + /// of the label is such that it fits a smaller number of lines than + /// the value of this property, the label can not be ellipsized at all, + /// which means it must be wide enough to fit all the text fully. /// /// This property has no effect if the label is not wrapping or ellipsized. + /// /// Set this property to -1 if you don't want to limit the number of lines. var lines: Int? /// The desired maximum width of the label, in characters. /// /// If this property is set to -1, the width will be calculated automatically. /// - /// See the section on [text layout](class.Label.html#text-layout) for details of how - /// [property@Gtk.Label:width-chars] and [property@Gtk.Label:max-width-chars] + /// See the section on [text layout](class.Label.html#text-layout) for details + /// of how [property@Gtk.Label:width-chars] and [property@Gtk.Label:max-width-chars] /// determine the width of ellipsized and wrapped labels. var maxWidthChars: Int? /// The mnemonic accelerator key for the label. @@ -269,22 +277,22 @@ public struct Label: AdwaitaWidget { /// can be an advantage in situations where resizing the label because /// of text changes would be distracting, e.g. in a statusbar. var singleLineMode: Bool? - /// %TRUE if the text of the label includes Pango markup. + /// True if the text of the label includes Pango markup. /// /// See [func@Pango.parse_markup]. var useMarkup: Bool? - /// %TRUE if the text of the label indicates a mnemonic with an _ + /// True if the text of the label indicates a mnemonic with an `_` /// before the mnemonic character. var useUnderline: Bool? /// The desired width of the label, in characters. /// /// If this property is set to -1, the width will be calculated automatically. /// - /// See the section on [text layout](class.Label.html#text-layout) for details of how - /// [property@Gtk.Label:width-chars] and [property@Gtk.Label:max-width-chars] + /// See the section on [text layout](class.Label.html#text-layout) for details + /// of how [property@Gtk.Label:width-chars] and [property@Gtk.Label:max-width-chars] /// determine the width of ellipsized and wrapped labels. var widthChars: Int? - /// %TRUE if the label text will wrap if it gets too wide. + /// True if the label text will wrap if it gets too wide. var wrap: Bool? /// The horizontal alignment of the label text inside its size allocation. /// @@ -298,7 +306,7 @@ public struct Label: AdwaitaWidget { var yalign: Float? /// Gets emitted to copy the selection to the clipboard. /// - /// The ::copy-clipboard signal is a [keybinding signal](class.SignalAction.html). + /// The `::copy-clipboard` signal is a [keybinding signal](class.SignalAction.html). /// /// The default binding for this signal is Ctrl+c. var copyClipboard: (() -> Void)? @@ -402,13 +410,13 @@ public struct Label: AdwaitaWidget { /// /// If the string contains Pango markup (see [func@Pango.parse_markup]), /// you will have to set the [property@Gtk.Label:use-markup] property to - /// %TRUE in order for the label to display the markup attributes. See also + /// true in order for the label to display the markup attributes. See also /// [method@Gtk.Label.set_markup] for a convenience function that sets both /// this property and the [property@Gtk.Label:use-markup] property at the /// same time. /// /// If the string contains underlines acting as mnemonics, you will have to - /// set the [property@Gtk.Label:use-underline] property to %TRUE in order + /// set the [property@Gtk.Label:use-underline] property to true in order /// for the label to display them. public func label(_ label: String) -> Self { var newSelf = self @@ -417,9 +425,19 @@ public struct Label: AdwaitaWidget { } /// The number of lines to which an ellipsized, wrapping label - /// should be limited. + /// should display before it gets ellipsized. This both prevents the label + /// from ellipsizing before this many lines are displayed, and limits the + /// height request of the label to this many lines. + /// + /// ::: warning + /// Setting this property has unintuitive and unfortunate consequences + /// for the minimum _width_ of the label. Specifically, if the height + /// of the label is such that it fits a smaller number of lines than + /// the value of this property, the label can not be ellipsized at all, + /// which means it must be wide enough to fit all the text fully. /// /// This property has no effect if the label is not wrapping or ellipsized. + /// /// Set this property to -1 if you don't want to limit the number of lines. public func lines(_ lines: Int?) -> Self { var newSelf = self @@ -431,8 +449,8 @@ public struct Label: AdwaitaWidget { /// /// If this property is set to -1, the width will be calculated automatically. /// - /// See the section on [text layout](class.Label.html#text-layout) for details of how - /// [property@Gtk.Label:width-chars] and [property@Gtk.Label:max-width-chars] + /// See the section on [text layout](class.Label.html#text-layout) for details + /// of how [property@Gtk.Label:width-chars] and [property@Gtk.Label:max-width-chars] /// determine the width of ellipsized and wrapped labels. public func maxWidthChars(_ maxWidthChars: Int?) -> Self { var newSelf = self @@ -473,7 +491,7 @@ public struct Label: AdwaitaWidget { return newSelf } - /// %TRUE if the text of the label includes Pango markup. + /// True if the text of the label includes Pango markup. /// /// See [func@Pango.parse_markup]. public func useMarkup(_ useMarkup: Bool? = true) -> Self { @@ -482,7 +500,7 @@ public struct Label: AdwaitaWidget { return newSelf } - /// %TRUE if the text of the label indicates a mnemonic with an _ + /// True if the text of the label indicates a mnemonic with an `_` /// before the mnemonic character. public func useUnderline(_ useUnderline: Bool? = true) -> Self { var newSelf = self @@ -494,8 +512,8 @@ public struct Label: AdwaitaWidget { /// /// If this property is set to -1, the width will be calculated automatically. /// - /// See the section on [text layout](class.Label.html#text-layout) for details of how - /// [property@Gtk.Label:width-chars] and [property@Gtk.Label:max-width-chars] + /// See the section on [text layout](class.Label.html#text-layout) for details + /// of how [property@Gtk.Label:width-chars] and [property@Gtk.Label:max-width-chars] /// determine the width of ellipsized and wrapped labels. public func widthChars(_ widthChars: Int?) -> Self { var newSelf = self @@ -503,7 +521,7 @@ public struct Label: AdwaitaWidget { return newSelf } - /// %TRUE if the label text will wrap if it gets too wide. + /// True if the label text will wrap if it gets too wide. public func wrap(_ wrap: Bool? = true) -> Self { var newSelf = self newSelf.wrap = wrap @@ -532,7 +550,7 @@ public struct Label: AdwaitaWidget { /// Gets emitted to copy the selection to the clipboard. /// - /// The ::copy-clipboard signal is a [keybinding signal](class.SignalAction.html). + /// The `::copy-clipboard` signal is a [keybinding signal](class.SignalAction.html). /// /// The default binding for this signal is Ctrl+c. public func copyClipboard(_ copyClipboard: @escaping () -> Void) -> Self { diff --git a/Sources/Core/View/Generated/LevelBar.swift b/Sources/Core/View/Generated/LevelBar.swift index 905aca1..e011d10 100644 --- a/Sources/Core/View/Generated/LevelBar.swift +++ b/Sources/Core/View/Generated/LevelBar.swift @@ -2,18 +2,18 @@ // LevelBar.swift // Adwaita // -// Created by auto-generation on 31.10.24. +// Created by auto-generation on 09.04.25. // import CAdw import LevenshteinTransformations -/// `GtkLevelBar` is a widget that can be used as a level indicator. +/// Shows a level indicator. /// /// Typical use cases are displaying the strength of a password, or /// showing the charge level of a battery. /// -/// ![An example GtkLevelBar](levelbar.png) +/// An example GtkLevelBar /// /// Use [method@Gtk.LevelBar.set_value] to set the current value, and /// [method@Gtk.LevelBar.add_offset_value] to set the value offsets at which @@ -104,7 +104,7 @@ import LevenshteinTransformations /// /// # Accessibility /// -/// `GtkLevelBar` uses the %GTK_ACCESSIBLE_ROLE_METER role. +/// `GtkLevelBar` uses the [enum@Gtk.AccessibleRole.meter] role. public struct LevelBar: AdwaitaWidget { /// Additional update functions for type extensions. diff --git a/Sources/Core/View/Generated/LinkButton.swift b/Sources/Core/View/Generated/LinkButton.swift index e7476d8..d8b0fac 100644 --- a/Sources/Core/View/Generated/LinkButton.swift +++ b/Sources/Core/View/Generated/LinkButton.swift @@ -2,15 +2,15 @@ // LinkButton.swift // Adwaita // -// Created by auto-generation on 31.10.24. +// Created by auto-generation on 09.04.25. // import CAdw import LevenshteinTransformations -/// A `GtkLinkButton` is a button with a hyperlink. +/// A button with a hyperlink. /// -/// ![An example GtkLinkButton](link-button.png) +/// An example GtkLinkButton /// /// It is useful to show quick links to resources. /// @@ -46,7 +46,7 @@ import LevenshteinTransformations /// /// # Accessibility /// -/// `GtkLinkButton` uses the %GTK_ACCESSIBLE_ROLE_LINK role. +/// `GtkLinkButton` uses the [enum@Gtk.AccessibleRole.link] role. public struct LinkButton: AdwaitaWidget { /// Additional update functions for type extensions. diff --git a/Sources/Core/View/Generated/ListBox.swift b/Sources/Core/View/Generated/ListBox.swift index 9533d24..3334572 100644 --- a/Sources/Core/View/Generated/ListBox.swift +++ b/Sources/Core/View/Generated/ListBox.swift @@ -2,13 +2,15 @@ // ListBox.swift // Adwaita // -// Created by auto-generation on 31.10.24. +// Created by auto-generation on 09.04.25. // import CAdw import LevenshteinTransformations -/// `GtkListBox` is a vertical list. +/// Shows a vertical list. +/// +/// An example GtkListBox /// /// A `GtkListBox` only contains `GtkListBoxRow` children. These rows can /// by dynamically sorted and filtered, and headers can be added dynamically @@ -49,10 +51,10 @@ import LevenshteinTransformations /// /// # CSS nodes /// -/// |[ +/// ``` /// list[.separators][.rich-list][.navigation-sidebar][.boxed-list] /// ╰── row[.activatable] -/// ]| +/// ``` /// /// `GtkListBox` uses a single CSS node named list. It may carry the .separators /// style class, when the [property@Gtk.ListBox:show-separators] property is set. @@ -68,8 +70,8 @@ import LevenshteinTransformations /// /// # Accessibility /// -/// `GtkListBox` uses the %GTK_ACCESSIBLE_ROLE_LIST role and `GtkListBoxRow` uses -/// the %GTK_ACCESSIBLE_ROLE_LIST_ITEM role. +/// `GtkListBox` uses the [enum@Gtk.AccessibleRole.list] role and `GtkListBoxRow` uses +/// the [enum@Gtk.AccessibleRole.list_item] role. public struct ListBox: AdwaitaWidget where Element: Identifiable { /// Additional update functions for type extensions. diff --git a/Sources/Core/View/Generated/Menu.swift b/Sources/Core/View/Generated/Menu.swift index b212e64..af59eac 100644 --- a/Sources/Core/View/Generated/Menu.swift +++ b/Sources/Core/View/Generated/Menu.swift @@ -2,15 +2,15 @@ // Menu.swift // Adwaita // -// Created by auto-generation on 31.10.24. +// Created by auto-generation on 09.04.25. // import CAdw import LevenshteinTransformations -/// The `GtkMenuButton` widget is used to display a popup when clicked. +/// Displays a popup when clicked. /// -/// ![An example GtkMenuButton](menu-button.png) +/// An example GtkMenuButton /// /// This popup can be provided either as a `GtkPopover` or as an abstract /// `GMenuModel`. @@ -68,7 +68,7 @@ import LevenshteinTransformations /// /// # Accessibility /// -/// `GtkMenuButton` uses the %GTK_ACCESSIBLE_ROLE_BUTTON role. +/// `GtkMenuButton` uses the [enum@Gtk.AccessibleRole.button] role. public struct Menu: AdwaitaWidget { /// Additional update functions for type extensions. diff --git a/Sources/Core/View/Generated/NavigationView.swift b/Sources/Core/View/Generated/NavigationView.swift index 4a51005..645c68a 100644 --- a/Sources/Core/View/Generated/NavigationView.swift +++ b/Sources/Core/View/Generated/NavigationView.swift @@ -2,7 +2,7 @@ // NavigationView.swift // Adwaita // -// Created by auto-generation on 31.10.24. +// Created by auto-generation on 09.04.25. // import CAdw @@ -129,11 +129,29 @@ public struct NavigationView: AdwaitaWidget { /// /// Gesture-based transitions are always animated. var animateTransitions: Bool? + /// Whether the view is horizontally homogeneous. + /// + /// If the view is horizontally homogeneous, it allocates the same width for + /// all pages. + /// + /// If it's not, the page may change width when a different page becomes + /// visible. + var hhomogeneous: Bool? /// Whether pressing Escape pops the current page. /// /// Applications using `AdwNavigationView` to implement a browser may want to /// disable it. var popOnEscape: Bool? + /// Whether the view is vertically homogeneous. + /// + /// If the view is vertically homogeneous, it allocates the same height for + /// all pages. + /// + /// If it's not, the view may change height when a different page becomes + /// visible. + var vhomogeneous: Bool? + /// The tag of the currently visible page. + var visiblePageTag: String? /// Emitted when a push shortcut or a gesture is triggered. /// /// To support the push shortcuts and gestures, the application is expected to @@ -214,9 +232,15 @@ public struct NavigationView: AdwaitaWidget { if let animateTransitions, updateProperties, (storage.previousState as? Self)?.animateTransitions != animateTransitions { adw_navigation_view_set_animate_transitions(widget, animateTransitions.cBool) } + if let hhomogeneous, updateProperties, (storage.previousState as? Self)?.hhomogeneous != hhomogeneous { + adw_navigation_view_set_hhomogeneous(widget, hhomogeneous.cBool) + } if let popOnEscape, updateProperties, (storage.previousState as? Self)?.popOnEscape != popOnEscape { adw_navigation_view_set_pop_on_escape(widget, popOnEscape.cBool) } + if let vhomogeneous, updateProperties, (storage.previousState as? Self)?.vhomogeneous != vhomogeneous { + adw_navigation_view_set_vhomogeneous(widget, vhomogeneous.cBool) + } @@ -238,6 +262,19 @@ public struct NavigationView: AdwaitaWidget { return newSelf } + /// Whether the view is horizontally homogeneous. + /// + /// If the view is horizontally homogeneous, it allocates the same width for + /// all pages. + /// + /// If it's not, the page may change width when a different page becomes + /// visible. + public func hhomogeneous(_ hhomogeneous: Bool? = true) -> Self { + var newSelf = self + newSelf.hhomogeneous = hhomogeneous + return newSelf + } + /// Whether pressing Escape pops the current page. /// /// Applications using `AdwNavigationView` to implement a browser may want to @@ -248,6 +285,26 @@ public struct NavigationView: AdwaitaWidget { return newSelf } + /// Whether the view is vertically homogeneous. + /// + /// If the view is vertically homogeneous, it allocates the same height for + /// all pages. + /// + /// If it's not, the view may change height when a different page becomes + /// visible. + public func vhomogeneous(_ vhomogeneous: Bool? = true) -> Self { + var newSelf = self + newSelf.vhomogeneous = vhomogeneous + return newSelf + } + + /// The tag of the currently visible page. + public func visiblePageTag(_ visiblePageTag: String?) -> Self { + var newSelf = self + newSelf.visiblePageTag = visiblePageTag + return newSelf + } + /// Emitted when a push shortcut or a gesture is triggered. /// /// To support the push shortcuts and gestures, the application is expected to diff --git a/Sources/Core/View/Generated/Overlay.swift b/Sources/Core/View/Generated/Overlay.swift index b5d35fa..904286b 100644 --- a/Sources/Core/View/Generated/Overlay.swift +++ b/Sources/Core/View/Generated/Overlay.swift @@ -2,16 +2,15 @@ // Overlay.swift // Adwaita // -// Created by auto-generation on 31.10.24. +// Created by auto-generation on 09.04.25. // import CAdw import LevenshteinTransformations -/// `GtkOverlay` is a container which contains a single main child, on top -/// of which it can place “overlay” widgets. +/// Places “overlay” widgets on top of a single main child. /// -/// ![An example GtkOverlay](overlay.png) +/// An example GtkOverlay /// /// The position of each overlay widget is determined by its /// [property@Gtk.Widget:halign] and [property@Gtk.Widget:valign] diff --git a/Sources/Core/View/Generated/OverlaySplitView.swift b/Sources/Core/View/Generated/OverlaySplitView.swift index a31a96b..b88c628 100644 --- a/Sources/Core/View/Generated/OverlaySplitView.swift +++ b/Sources/Core/View/Generated/OverlaySplitView.swift @@ -2,7 +2,7 @@ // OverlaySplitView.swift // Adwaita // -// Created by auto-generation on 31.10.24. +// Created by auto-generation on 09.04.25. // import CAdw diff --git a/Sources/Core/View/Generated/PasswordEntryRow.swift b/Sources/Core/View/Generated/PasswordEntryRow.swift index e2e718e..77bf827 100644 --- a/Sources/Core/View/Generated/PasswordEntryRow.swift +++ b/Sources/Core/View/Generated/PasswordEntryRow.swift @@ -2,7 +2,7 @@ // PasswordEntryRow.swift // Adwaita // -// Created by auto-generation on 31.10.24. +// Created by auto-generation on 09.04.25. // import CAdw diff --git a/Sources/Core/View/Generated/Picture.swift b/Sources/Core/View/Generated/Picture.swift index 34e4fcc..62adf9d 100644 --- a/Sources/Core/View/Generated/Picture.swift +++ b/Sources/Core/View/Generated/Picture.swift @@ -2,15 +2,15 @@ // Picture.swift // Adwaita // -// Created by auto-generation on 31.10.24. +// Created by auto-generation on 09.04.25. // import CAdw import LevenshteinTransformations -/// The `GtkPicture` widget displays a `GdkPaintable`. +/// Displays a `GdkPaintable`. /// -/// ![An example GtkPicture](picture.png) +/// picture>An example GtkPicture /// /// Many convenience functions are provided to make pictures simple to use. /// For example, if you want to load an image from a file, and then display @@ -53,7 +53,7 @@ import LevenshteinTransformations /// /// ## Accessibility /// -/// `GtkPicture` uses the `GTK_ACCESSIBLE_ROLE_IMG` role. +/// `GtkPicture` uses the [enum@Gtk.AccessibleRole.img] role. public struct Picture: AdwaitaWidget { /// Additional update functions for type extensions. diff --git a/Sources/Core/View/Generated/Popover.swift b/Sources/Core/View/Generated/Popover.swift index 63b12d8..d021e52 100644 --- a/Sources/Core/View/Generated/Popover.swift +++ b/Sources/Core/View/Generated/Popover.swift @@ -2,15 +2,15 @@ // Popover.swift // Adwaita // -// Created by auto-generation on 31.10.24. +// Created by auto-generation on 09.04.25. // import CAdw import LevenshteinTransformations -/// `GtkPopover` is a bubble-like context popup. +/// Presents a bubble-like popup. /// -/// ![An example GtkPopover](popover.png) +/// An example GtkPopover /// /// It is primarily meant to provide context-dependent information /// or options. Popovers are attached to a parent widget. By default, diff --git a/Sources/Core/View/Generated/PreferencesGroup.swift b/Sources/Core/View/Generated/PreferencesGroup.swift index 22aab8c..47bc015 100644 --- a/Sources/Core/View/Generated/PreferencesGroup.swift +++ b/Sources/Core/View/Generated/PreferencesGroup.swift @@ -2,7 +2,7 @@ // PreferencesGroup.swift // Adwaita // -// Created by auto-generation on 31.10.24. +// Created by auto-generation on 09.04.25. // import CAdw diff --git a/Sources/Core/View/Generated/PreferencesPage.swift b/Sources/Core/View/Generated/PreferencesPage.swift index 3c71c89..c15d419 100644 --- a/Sources/Core/View/Generated/PreferencesPage.swift +++ b/Sources/Core/View/Generated/PreferencesPage.swift @@ -2,7 +2,7 @@ // PreferencesPage.swift // Adwaita // -// Created by auto-generation on 31.10.24. +// Created by auto-generation on 09.04.25. // import CAdw @@ -63,7 +63,7 @@ public struct PreferencesPage: AdwaitaWidget { var childStorage: [ViewStorage] = [] for view in child() { childStorage.append(view.storage(data: data, type: type)) - adw_preferences_group_add(storage.opaquePointer?.cast(), childStorage.last?.opaquePointer?.cast()) + adw_preferences_page_add(storage.opaquePointer?.cast(), childStorage.last?.opaquePointer?.cast()) } storage.content["child"] = childStorage return storage diff --git a/Sources/Core/View/Generated/PreferencesRow.swift b/Sources/Core/View/Generated/PreferencesRow.swift index 31747e4..122bf22 100644 --- a/Sources/Core/View/Generated/PreferencesRow.swift +++ b/Sources/Core/View/Generated/PreferencesRow.swift @@ -2,7 +2,7 @@ // PreferencesRow.swift // Adwaita // -// Created by auto-generation on 31.10.24. +// Created by auto-generation on 09.04.25. // import CAdw diff --git a/Sources/Core/View/Generated/ProgressBar.swift b/Sources/Core/View/Generated/ProgressBar.swift index 4375513..73fa154 100644 --- a/Sources/Core/View/Generated/ProgressBar.swift +++ b/Sources/Core/View/Generated/ProgressBar.swift @@ -2,19 +2,18 @@ // ProgressBar.swift // Adwaita // -// Created by auto-generation on 31.10.24. +// Created by auto-generation on 09.04.25. // import CAdw import LevenshteinTransformations -/// `GtkProgressBar` is typically used to display the progress of a long -/// running operation. +/// Displays the progress of a long-running operation. /// -/// It provides a visual clue that processing is underway. `GtkProgressBar` -/// can be used in two different modes: percentage mode and activity mode. +/// `GtkProgressBar` provides a visual clue that processing is underway. +/// It can be used in two different modes: percentage mode and activity mode. /// -/// ![An example GtkProgressBar](progressbar.png) +/// An example GtkProgressBar /// /// When an application can determine how much work needs to take place /// (e.g. read a fixed number of bytes from a file) and can monitor its @@ -53,7 +52,7 @@ import LevenshteinTransformations /// /// # Accessibility /// -/// `GtkProgressBar` uses the %GTK_ACCESSIBLE_ROLE_PROGRESS_BAR role. +/// `GtkProgressBar` uses the [enum@Gtk.AccessibleRole.progress_bar] role. public struct ProgressBar: AdwaitaWidget { /// Additional update functions for type extensions. diff --git a/Sources/Core/View/Generated/ScrolledWindow.swift b/Sources/Core/View/Generated/ScrolledWindow.swift index e925f4e..9f4b3b4 100644 --- a/Sources/Core/View/Generated/ScrolledWindow.swift +++ b/Sources/Core/View/Generated/ScrolledWindow.swift @@ -2,13 +2,15 @@ // ScrolledWindow.swift // Adwaita // -// Created by auto-generation on 31.10.24. +// Created by auto-generation on 09.04.25. // import CAdw import LevenshteinTransformations -/// `GtkScrolledWindow` is a container that makes its child scrollable. +/// Makes its child scrollable. +/// +/// An example GtkScrolledWindow /// /// It does so using either internally added scrollbars or externally /// associated adjustments, and optionally draws a frame around the child. @@ -79,9 +81,10 @@ import LevenshteinTransformations /// /// # Accessibility /// -/// Until GTK 4.10, `GtkScrolledWindow` used the `GTK_ACCESSIBLE_ROLE_GROUP` role. +/// Until GTK 4.10, `GtkScrolledWindow` used the [enum@Gtk.AccessibleRole.group] role. /// -/// Starting from GTK 4.12, `GtkScrolledWindow` uses the `GTK_ACCESSIBLE_ROLE_GENERIC` role. +/// Starting from GTK 4.12, `GtkScrolledWindow` uses the [enum@Gtk.AccessibleRole.generic] +/// role. public struct ScrolledWindow: AdwaitaWidget { /// Additional update functions for type extensions. diff --git a/Sources/Core/View/Generated/SearchBar.swift b/Sources/Core/View/Generated/SearchBar.swift index 61cdf67..45ad59a 100644 --- a/Sources/Core/View/Generated/SearchBar.swift +++ b/Sources/Core/View/Generated/SearchBar.swift @@ -2,15 +2,15 @@ // SearchBar.swift // Adwaita // -// Created by auto-generation on 31.10.24. +// Created by auto-generation on 09.04.25. // import CAdw import LevenshteinTransformations -/// `GtkSearchBar` is a container made to have a search entry. +/// Reveals a search entry when search is started. /// -/// ![An example GtkSearchBar](search-bar.png) +/// An example GtkSearchBar /// /// It can also contain additional widgets, such as drop-down menus, /// or buttons. The search bar would appear when a search is started @@ -57,7 +57,7 @@ import LevenshteinTransformations /// /// # Accessibility /// -/// `GtkSearchBar` uses the %GTK_ACCESSIBLE_ROLE_SEARCH role. +/// `GtkSearchBar` uses the [enum@Gtk.AccessibleRole.search] role. public struct SearchBar: AdwaitaWidget { /// Additional update functions for type extensions. diff --git a/Sources/Core/View/Generated/SearchEntry.swift b/Sources/Core/View/Generated/SearchEntry.swift index 716e991..7c3d01f 100644 --- a/Sources/Core/View/Generated/SearchEntry.swift +++ b/Sources/Core/View/Generated/SearchEntry.swift @@ -2,19 +2,18 @@ // SearchEntry.swift // Adwaita // -// Created by auto-generation on 31.10.24. +// Created by auto-generation on 09.04.25. // import CAdw import LevenshteinTransformations -/// `GtkSearchEntry` is an entry widget that has been tailored for use -/// as a search entry. +/// A single-line text entry widget for use as a search entry. /// /// The main API for interacting with a `GtkSearchEntry` as entry /// is the `GtkEditable` interface. /// -/// ![An example GtkSearchEntry](search-entry.png) +/// An example GtkSearchEntry /// /// It will show an inactive symbolic “find” icon when the search /// entry is empty, and a symbolic “clear” icon when there is text. @@ -60,7 +59,7 @@ import LevenshteinTransformations /// /// ## Accessibility /// -/// `GtkSearchEntry` uses the %GTK_ACCESSIBLE_ROLE_SEARCH_BOX role. +/// `GtkSearchEntry` uses the [enum@Gtk.AccessibleRole.search_box] role. public struct SearchEntry: AdwaitaWidget { /// Additional update functions for type extensions. diff --git a/Sources/Core/View/Generated/Separator.swift b/Sources/Core/View/Generated/Separator.swift index 7e0c7ca..70b1974 100644 --- a/Sources/Core/View/Generated/Separator.swift +++ b/Sources/Core/View/Generated/Separator.swift @@ -2,15 +2,15 @@ // Separator.swift // Adwaita // -// Created by auto-generation on 31.10.24. +// Created by auto-generation on 09.04.25. // import CAdw import LevenshteinTransformations -/// `GtkSeparator` is a horizontal or vertical separator widget. +/// Draws a horizontal or vertical line to separate other widgets. /// -/// ![An example GtkSeparator](separator.png) +/// An example GtkSeparator /// /// A `GtkSeparator` can be used to group the widgets within a window. /// It displays a line with a shadow to make it appear sunken into the @@ -23,7 +23,7 @@ import LevenshteinTransformations /// /// # Accessibility /// -/// `GtkSeparator` uses the %GTK_ACCESSIBLE_ROLE_SEPARATOR role. +/// `GtkSeparator` uses the [enum@Gtk.AccessibleRole.separator] role. public struct Separator: AdwaitaWidget { /// Additional update functions for type extensions. diff --git a/Sources/Core/View/Generated/SpinRow.swift b/Sources/Core/View/Generated/SpinRow.swift index 3348bc3..932a116 100644 --- a/Sources/Core/View/Generated/SpinRow.swift +++ b/Sources/Core/View/Generated/SpinRow.swift @@ -2,7 +2,7 @@ // SpinRow.swift // Adwaita // -// Created by auto-generation on 31.10.24. +// Created by auto-generation on 09.04.25. // import CAdw diff --git a/Sources/Core/View/Generated/Spinner.swift b/Sources/Core/View/Generated/Spinner.swift index 31bc653..e3bca43 100644 --- a/Sources/Core/View/Generated/Spinner.swift +++ b/Sources/Core/View/Generated/Spinner.swift @@ -2,7 +2,7 @@ // Spinner.swift // Adwaita // -// Created by auto-generation on 31.10.24. +// Created by auto-generation on 09.04.25. // import CAdw diff --git a/Sources/Core/View/Generated/SplitButton.swift b/Sources/Core/View/Generated/SplitButton.swift index 2fdaab3..4d61daa 100644 --- a/Sources/Core/View/Generated/SplitButton.swift +++ b/Sources/Core/View/Generated/SplitButton.swift @@ -2,7 +2,7 @@ // SplitButton.swift // Adwaita // -// Created by auto-generation on 31.10.24. +// Created by auto-generation on 09.04.25. // import CAdw diff --git a/Sources/Core/View/Generated/StatusPage.swift b/Sources/Core/View/Generated/StatusPage.swift index 1246f50..b821c29 100644 --- a/Sources/Core/View/Generated/StatusPage.swift +++ b/Sources/Core/View/Generated/StatusPage.swift @@ -2,7 +2,7 @@ // StatusPage.swift // Adwaita // -// Created by auto-generation on 31.10.24. +// Created by auto-generation on 09.04.25. // import CAdw diff --git a/Sources/Core/View/Generated/SwitchRow.swift b/Sources/Core/View/Generated/SwitchRow.swift index 34bc7eb..afbaa21 100644 --- a/Sources/Core/View/Generated/SwitchRow.swift +++ b/Sources/Core/View/Generated/SwitchRow.swift @@ -2,7 +2,7 @@ // SwitchRow.swift // Adwaita // -// Created by auto-generation on 31.10.24. +// Created by auto-generation on 09.04.25. // import CAdw diff --git a/Sources/Core/View/Generated/ToastOverlay.swift b/Sources/Core/View/Generated/ToastOverlay.swift index 5ab0f74..6cd4d65 100644 --- a/Sources/Core/View/Generated/ToastOverlay.swift +++ b/Sources/Core/View/Generated/ToastOverlay.swift @@ -2,7 +2,7 @@ // ToastOverlay.swift // Adwaita // -// Created by auto-generation on 31.10.24. +// Created by auto-generation on 09.04.25. // import CAdw @@ -16,6 +16,9 @@ import LevenshteinTransformations /// main child, on top of which it can display a [class@Toast], overlaid. /// Toasts can be shown with [method@ToastOverlay.add_toast]. /// +/// Use [method@ToastOverlay.dismiss_all] to dismiss all toasts at once, or +/// [method@Toast.dismiss] to dismiss a single toast. +/// /// See [class@Toast] for details. /// /// ## CSS nodes diff --git a/Sources/Core/View/Generated/ToggleButton.swift b/Sources/Core/View/Generated/ToggleButton.swift index ad53f37..762508b 100644 --- a/Sources/Core/View/Generated/ToggleButton.swift +++ b/Sources/Core/View/Generated/ToggleButton.swift @@ -2,14 +2,15 @@ // ToggleButton.swift // Adwaita // -// Created by auto-generation on 31.10.24. +// Created by auto-generation on 09.04.25. // import CAdw import LevenshteinTransformations -/// A `GtkToggleButton` is a button which remains “pressed-in” when -/// clicked. +/// Shows a button which remains “pressed-in” when clicked. +/// +/// Example GtkToggleButtons /// /// Clicking again will cause the toggle button to return to its normal state. /// @@ -22,9 +23,6 @@ import LevenshteinTransformations /// [method@Gtk.ToggleButton.set_active], and retrieved using /// [method@Gtk.ToggleButton.get_active]. /// -/// To simply switch the state of a toggle button, use -/// [method@Gtk.ToggleButton.toggled]. -/// /// ## Grouping /// /// Toggle buttons can be grouped together, to form mutually exclusive @@ -40,7 +38,7 @@ import LevenshteinTransformations /// /// ## Accessibility /// -/// `GtkToggleButton` uses the %GTK_ACCESSIBLE_ROLE_TOGGLE_BUTTON role. +/// `GtkToggleButton` uses the [enum@Gtk.AccessibleRole.toggle_button] role. /// /// ## Creating two `GtkToggleButton` widgets. /// diff --git a/Sources/Core/View/Generated/ToolbarView.swift b/Sources/Core/View/Generated/ToolbarView.swift index 6e94346..167c291 100644 --- a/Sources/Core/View/Generated/ToolbarView.swift +++ b/Sources/Core/View/Generated/ToolbarView.swift @@ -2,7 +2,7 @@ // ToolbarView.swift // Adwaita // -// Created by auto-generation on 31.10.24. +// Created by auto-generation on 09.04.25. // import CAdw diff --git a/Sources/Core/View/Generated/WindowTitle.swift b/Sources/Core/View/Generated/WindowTitle.swift index 59ae1c4..81c67d3 100644 --- a/Sources/Core/View/Generated/WindowTitle.swift +++ b/Sources/Core/View/Generated/WindowTitle.swift @@ -2,7 +2,7 @@ // WindowTitle.swift // Adwaita // -// Created by auto-generation on 31.10.24. +// Created by auto-generation on 09.04.25. // import CAdw diff --git a/Sources/Generation/GenerationConfiguration.swift b/Sources/Generation/GenerationConfiguration.swift index bb5c9d7..925a1b3 100644 --- a/Sources/Generation/GenerationConfiguration.swift +++ b/Sources/Generation/GenerationConfiguration.swift @@ -40,7 +40,12 @@ struct GenerationConfiguration { /// The Libadwaita widgets. var adwWidgets: [WidgetConfiguration] = [ .init(class: "StatusPage", excludeProperties: ["paintable"]), - .init(class: "Banner", initializer: "adw_banner_new(title)", requiredProperties: ["title"]), + .init( + class: "Banner", + initializer: "adw_banner_new(title)", + requiredProperties: ["title"], + excludeProperties: ["button-style"] + ), .init( class: "Avatar", initializer: "adw_avatar_new(size.cInt, text, showInitials.cBool)", @@ -121,7 +126,10 @@ struct GenerationConfiguration { ), .init( class: "PreferencesPage", - staticWidgets: [.init(name: "child", add: "adw_preferences_group_add")], + staticWidgets: [ + .init(name: "child", add: "adw_preferences_page_add"), + ], + excludeProperties: ["banner"], cast: true ), .init( @@ -194,7 +202,7 @@ struct GenerationConfiguration { remove: "gtk_list_box_remove", getElement: "gtk_list_box_get_row_at_index(widget, index.cInt)?.cast()" ), - excludeProperties: ["selection-mode"] + excludeProperties: ["selection-mode", "tab-behavior"] ), .init(class: "ProgressBar", excludeProperties: ["ellipsize", "orientation"]), .init( diff --git a/io.github.AparokshaUI.Generation.json b/io.github.AparokshaUI.Generation.json new file mode 100644 index 0000000..1c07b70 --- /dev/null +++ b/io.github.AparokshaUI.Generation.json @@ -0,0 +1,53 @@ +{ + "app-id": "io.github.AparokshaUI.Demo", + "runtime": "org.gnome.Platform", + "runtime-version": "48", + "sdk": "org.gnome.Sdk", + "sdk-extensions": [ + "org.freedesktop.Sdk.Extension.swift6" + ], + "command": "Demo", + "finish-args": [ + "--share=network", + "--share=ipc", + "--socket=fallback-x11", + "--device=dri", + "--socket=wayland" + ], + "build-options": { + "append-path": "/usr/lib/sdk/swift6/bin", + "prepend-ld-library-path": "/usr/lib/sdk/swift6/lib" + }, + "cleanup": [ + "/include", + "/lib/pkgconfig", + "/man", + "/share/doc", + "/share/gtk-doc", + "/share/man", + "/share/pkgconfig", + "/share/vala", + "*.la", + "*.a" + ], + "modules": [ + { + "name": "Generation", + "builddir": true, + "buildsystem": "simple", + "sources": [ + { + "type": "dir", + "path": "." + } + ], + "build-commands": [ + "swift package clean", + "swift run Generation", + "swift package clean", + "swift build -c debug --static-swift-stdlib", + "install -Dm755 .build/debug/Demo /app/bin/Demo" + ] + } + ] +}