@girs/gtksource-5 4.2.0 → 4.3.0

package/README.md

@@ -5,25 +5,25 @@
 ![downloads/week](https://img.shields.io/npm/dw/@girs/gtksource-5)
 
 
-GJS TypeScript type definitions for GtkSource-5, generated from library version 5.20.0 using [ts-for-gir](https://github.com/gjsify/ts-for-gir) v4.2.0.
+GJS TypeScript type definitions for GtkSource-5, generated from library version 5.21.0 using [ts-for-gir](https://github.com/gjsify/ts-for-gir) v4.3.0.
 
 ## Install
 
-To use this type definitions, install them with NPM:
+Install the type definitions with npm:
 ```bash
 npm install @girs/gtksource-5
 ```
 
 ## Usage
 
-You can import this package into your project like this:
+Import it like any other module:
 ```ts
 import GtkSource from '@girs/gtksource-5';
 ```
 
 ### Ambient Modules
 
-You can also use [ambient modules](https://github.com/gjsify/ts-for-gir/tree/main/packages/cli#ambient-modules) to import this module like you would do this in JavaScript.
+[Ambient modules](https://github.com/gjsify/ts-for-gir/tree/main/packages/cli#ambient-modules) let you write the same import you would in plain JavaScript.
 For this you need to include `@girs/gtksource-5` or `@girs/gtksource-5/ambient` in your `tsconfig` or entry point Typescript file:
 
 `index.ts`:
@@ -42,7 +42,7 @@ import '@girs/gtksource-5'
 }
 ```
 
-Now you can import the ambient module with TypeScript support: 
+The ambient module now resolves with types:
 
 ```ts
 import GtkSource from 'gi://GtkSource?version=5';
@@ -50,7 +50,7 @@ import GtkSource from 'gi://GtkSource?version=5';
 
 ### Global import
 
-You can also import the module with Typescript support using the global `imports.gi` object of GJS.
+GJS's global `imports.gi` works too, with types.
 For this you need to include `@girs/gtksource-5` or `@girs/gtksource-5/import` in your `tsconfig` or entry point Typescript file:
 
 `index.ts`:
@@ -69,7 +69,7 @@ import '@girs/gtksource-5'
 }
 ```
 
-Now you have also type support for this, too:
+That form carries types as well:
 
 ```ts
 const GtkSource = imports.gi.GtkSource;
@@ -77,7 +77,7 @@ const GtkSource = imports.gi.GtkSource;
 
 ### Bundle
 
-Depending on your project configuration, it is recommended to use a bundler like [esbuild](https://esbuild.github.io/). You can find examples using different bundlers [here](https://github.com/gjsify/ts-for-gir/tree/main/examples).
+Most projects want a bundler. [esbuild](https://esbuild.github.io/) is the smallest thing that works; the [examples directory](https://github.com/gjsify/ts-for-gir/tree/main/examples) has setups for several others.
 
 ## Other packages
 

package/gtksource-5-surface.d.ts

@@ -1,7 +1,7 @@
 /**
  * The GIR-derived widget VOCABULARY for GtkSource-5.
  *
- * GENERATED — do not edit. Provenance: GtkSource-5 — library 5.20.0 — dropped empty base(s): GObject.InitiallyUnowned GObject.Object
+ * GENERATED — do not edit. Provenance: GtkSource-5 — library 5.21.0 — dropped empty base(s): GObject.InitiallyUnowned GObject.Object
  *
  * 10 concrete widgets, 12 declarations, 11 enum nick unions, 2 slot candidates.
  *

package/gtksource-5-surface.js

@@ -1,12 +1,12 @@
 // The widget vocabulary of GtkSource-5 as runtime data.
 //
-// GENERATED — do not edit. Provenance: GtkSource-5 — library 5.20.0 — dropped empty base(s): GObject.InitiallyUnowned GObject.Object
+// GENERATED — do not edit. Provenance: GtkSource-5 — library 5.21.0 — dropped empty base(s): GObject.InitiallyUnowned GObject.Object
 //
 // The type half of this subpath is the sibling `.d.ts`. This file exists because
 // types are erased: a consumer that wants to ask the installed library whether every
 // name here is real needs values, not declarations.
 
-export const SURFACE_PROVENANCE = 'GtkSource-5 — library 5.20.0 — dropped empty base(s): GObject.InitiallyUnowned GObject.Object';
+export const SURFACE_PROVENANCE = 'GtkSource-5 — library 5.21.0 — dropped empty base(s): GObject.InitiallyUnowned GObject.Object';
 
 export const OWN_PROPS = {
     GtkSourceCompletionCell: ['column', 'markup', 'paintable', 'text', 'widget'],

package/gtksource-5.d.ts

@@ -2386,7 +2386,7 @@ export namespace GtkSource {
         /**
          * Stores the id attribute given in the {@link Gtk.Builder} UI definition.
          *   {@link Gtk.Widget} stores the name as object data. Implement this method if your
-         *   object has some notion of “ID” and it makes sense to map the XML id
+         *   object has some notion of “ID” and it makes sense to map the XML id
          *   attribute to it.
          * @param id 
          * @virtual
@@ -3672,6 +3672,7 @@ export namespace GtkSource {
             "notify::file": (pspec: GObject.ParamSpec) => void;
             "notify::input-stream": (pspec: GObject.ParamSpec) => void;
             "notify::location": (pspec: GObject.ParamSpec) => void;
+            "notify::max-size": (pspec: GObject.ParamSpec) => void;
         }
 
         // Constructor properties interface
@@ -3681,6 +3682,8 @@ export namespace GtkSource {
             input_stream: Gio.InputStream | null;
             inputStream: Gio.InputStream | null;
             location: Gio.File | null;
+            max_size: bigint | number;
+            maxSize: bigint | number;
         }
     }
 
@@ -3745,6 +3748,24 @@ export namespace GtkSource {
          */
         get location(): Gio.File | null;
 
+        /**
+         * The maximum expanded size, in bytes, that the loader will insert into
+         * the buffer. A value of 0 disables the limit.
+         * @since 5.22
+         * @default 1073741824
+         */
+        get max_size(): number;
+        set max_size(val: bigint | number);
+
+        /**
+         * The maximum expanded size, in bytes, that the loader will insert into
+         * the buffer. A value of 0 disables the limit.
+         * @since 5.22
+         * @default 1073741824
+         */
+        get maxSize(): number;
+        set maxSize(val: bigint | number);
+
         /**
          * Compile-time signal type information.
          *
@@ -3807,6 +3828,12 @@ export namespace GtkSource {
          */
         get_location(): Gio.File | null;
 
+        /**
+         * Gets the maximum expanded size that `loader` will insert into the buffer.
+         * @returns the maximum expanded size in bytes, or 0 if the limit is disabled.
+         */
+        get_max_size(): number;
+
         /**
          * @returns the detected newline type.
          */
@@ -3873,6 +3900,15 @@ export namespace GtkSource {
          * @param candidate_encodings a list of   {@link GtkSource.Encoding}<!-- -->s.
          */
         set_candidate_encodings(candidate_encodings: Encoding[]): void;
+
+        /**
+         * Sets the maximum expanded size that `loader` will insert into the buffer.
+         * 
+         * The limit is checked after decompression, so compressed files are limited by
+         * the size of their uncompressed contents rather than their on-disk size.
+         * @param max_size maximum expanded size in bytes, or 0 to disable the limit.
+         */
+        set_max_size(max_size: bigint | number): void;
     }
 
 
@@ -4609,7 +4645,7 @@ export namespace GtkSource {
         /**
          * Stores the id attribute given in the {@link Gtk.Builder} UI definition.
          *   {@link Gtk.Widget} stores the name as object data. Implement this method if your
-         *   object has some notion of &#x201C;ID&#x201D; and it makes sense to map the XML id
+         *   object has some notion of “ID” and it makes sense to map the XML id
          *   attribute to it.
          * @param id 
          * @virtual
@@ -5565,7 +5601,7 @@ export namespace GtkSource {
         /**
          * Stores the id attribute given in the {@link Gtk.Builder} UI definition.
          *   {@link Gtk.Widget} stores the name as object data. Implement this method if your
-         *   object has some notion of &#x201C;ID&#x201D; and it makes sense to map the XML id
+         *   object has some notion of “ID” and it makes sense to map the XML id
          *   attribute to it.
          * @param id 
          * @virtual
@@ -6514,7 +6550,7 @@ export namespace GtkSource {
         /**
          * Stores the id attribute given in the {@link Gtk.Builder} UI definition.
          *   {@link Gtk.Widget} stores the name as object data. Implement this method if your
-         *   object has some notion of &#x201C;ID&#x201D; and it makes sense to map the XML id
+         *   object has some notion of “ID” and it makes sense to map the XML id
          *   attribute to it.
          * @param id 
          * @virtual
@@ -10707,7 +10743,7 @@ export namespace GtkSource {
          * Usually this function is used when the widget is located (or will be
          * located) within the hierarchy of a {@link Gtk.ApplicationWindow}.
          * 
-         * Names are of the form &#x201C;win.save&#x201D; or &#x201C;app.quit&#x201D; for actions on the
+         * Names are of the form “win.save” or “app.quit” for actions on the
          * containing {@link ApplicationWindow} or its associated {@link Application},
          * respectively. This is the same form used for actions in the {@link Gio.Menu}
          * associated with the window.
@@ -10723,14 +10759,14 @@ export namespace GtkSource {
          * The target value has two purposes. First, it is used as the parameter
          * to activation of the action associated with the {@link Gtk.Actionable} widget.
          * Second, it is used to determine if the widget should be rendered as
-         * &#x201C;active&#x201D; &#x2014; the widget is active if the state is equal to the given target.
+         * “active” — the widget is active if the state is equal to the given target.
          * 
          * Consider the example of associating a set of buttons with a {@link Gio.Action}
-         * with string state in a typical &#x201C;radio button&#x201D; situation. Each button
+         * with string state in a typical “radio button” situation. Each button
          * will be associated with the same action, but with a different target
          * value for that action. Clicking on a particular button will activate
          * the action with the target of that button, which will typically cause
-         * the action&#x2019;s state to change to that value. Since the action&#x2019;s state
+         * the action’s state to change to that value. Since the action’s state
          * is now equal to the target value of the button, the button will now
          * be rendered as active (and the other buttons, with different targets,
          * rendered inactive).
@@ -10770,7 +10806,7 @@ export namespace GtkSource {
          * Usually this function is used when the widget is located (or will be
          * located) within the hierarchy of a {@link Gtk.ApplicationWindow}.
          * 
-         * Names are of the form &#x201C;win.save&#x201D; or &#x201C;app.quit&#x201D; for actions on the
+         * Names are of the form “win.save” or “app.quit” for actions on the
          * containing {@link ApplicationWindow} or its associated {@link Application},
          * respectively. This is the same form used for actions in the {@link Gio.Menu}
          * associated with the window.
@@ -10787,14 +10823,14 @@ export namespace GtkSource {
          * The target value has two purposes. First, it is used as the parameter
          * to activation of the action associated with the {@link Gtk.Actionable} widget.
          * Second, it is used to determine if the widget should be rendered as
-         * &#x201C;active&#x201D; &#x2014; the widget is active if the state is equal to the given target.
+         * “active” — the widget is active if the state is equal to the given target.
          * 
          * Consider the example of associating a set of buttons with a {@link Gio.Action}
-         * with string state in a typical &#x201C;radio button&#x201D; situation. Each button
+         * with string state in a typical “radio button” situation. Each button
          * will be associated with the same action, but with a different target
          * value for that action. Clicking on a particular button will activate
          * the action with the target of that button, which will typically cause
-         * the action&#x2019;s state to change to that value. Since the action&#x2019;s state
+         * the action’s state to change to that value. Since the action’s state
          * is now equal to the target value of the button, the button will now
          * be rendered as active (and the other buttons, with different targets,
          * rendered inactive).
@@ -11277,7 +11313,7 @@ export namespace GtkSource {
         /**
          * Stores the id attribute given in the {@link Gtk.Builder} UI definition.
          *   {@link Gtk.Widget} stores the name as object data. Implement this method if your
-         *   object has some notion of &#x201C;ID&#x201D; and it makes sense to map the XML id
+         *   object has some notion of “ID” and it makes sense to map the XML id
          *   attribute to it.
          * @param id 
          * @virtual
@@ -11873,7 +11909,7 @@ export namespace GtkSource {
          * Usually this function is used when the widget is located (or will be
          * located) within the hierarchy of a {@link Gtk.ApplicationWindow}.
          * 
-         * Names are of the form &#x201C;win.save&#x201D; or &#x201C;app.quit&#x201D; for actions on the
+         * Names are of the form “win.save” or “app.quit” for actions on the
          * containing {@link ApplicationWindow} or its associated {@link Application},
          * respectively. This is the same form used for actions in the {@link Gio.Menu}
          * associated with the window.
@@ -11889,14 +11925,14 @@ export namespace GtkSource {
          * The target value has two purposes. First, it is used as the parameter
          * to activation of the action associated with the {@link Gtk.Actionable} widget.
          * Second, it is used to determine if the widget should be rendered as
-         * &#x201C;active&#x201D; &#x2014; the widget is active if the state is equal to the given target.
+         * “active” — the widget is active if the state is equal to the given target.
          * 
          * Consider the example of associating a set of buttons with a {@link Gio.Action}
-         * with string state in a typical &#x201C;radio button&#x201D; situation. Each button
+         * with string state in a typical “radio button” situation. Each button
          * will be associated with the same action, but with a different target
          * value for that action. Clicking on a particular button will activate
          * the action with the target of that button, which will typically cause
-         * the action&#x2019;s state to change to that value. Since the action&#x2019;s state
+         * the action’s state to change to that value. Since the action’s state
          * is now equal to the target value of the button, the button will now
          * be rendered as active (and the other buttons, with different targets,
          * rendered inactive).
@@ -11936,7 +11972,7 @@ export namespace GtkSource {
          * Usually this function is used when the widget is located (or will be
          * located) within the hierarchy of a {@link Gtk.ApplicationWindow}.
          * 
-         * Names are of the form &#x201C;win.save&#x201D; or &#x201C;app.quit&#x201D; for actions on the
+         * Names are of the form “win.save” or “app.quit” for actions on the
          * containing {@link ApplicationWindow} or its associated {@link Application},
          * respectively. This is the same form used for actions in the {@link Gio.Menu}
          * associated with the window.
@@ -11953,14 +11989,14 @@ export namespace GtkSource {
          * The target value has two purposes. First, it is used as the parameter
          * to activation of the action associated with the {@link Gtk.Actionable} widget.
          * Second, it is used to determine if the widget should be rendered as
-         * &#x201C;active&#x201D; &#x2014; the widget is active if the state is equal to the given target.
+         * “active” — the widget is active if the state is equal to the given target.
          * 
          * Consider the example of associating a set of buttons with a {@link Gio.Action}
-         * with string state in a typical &#x201C;radio button&#x201D; situation. Each button
+         * with string state in a typical “radio button” situation. Each button
          * will be associated with the same action, but with a different target
          * value for that action. Clicking on a particular button will activate
          * the action with the target of that button, which will typically cause
-         * the action&#x2019;s state to change to that value. Since the action&#x2019;s state
+         * the action’s state to change to that value. Since the action’s state
          * is now equal to the target value of the button, the button will now
          * be rendered as active (and the other buttons, with different targets,
          * rendered inactive).
@@ -12060,7 +12096,7 @@ export namespace GtkSource {
         /**
          * Stores the id attribute given in the {@link Gtk.Builder} UI definition.
          *   {@link Gtk.Widget} stores the name as object data. Implement this method if your
-         *   object has some notion of &#x201C;ID&#x201D; and it makes sense to map the XML id
+         *   object has some notion of “ID” and it makes sense to map the XML id
          *   attribute to it.
          * @param id 
          * @virtual

package/package.json

@@ -1,8 +1,8 @@
 {
     "name": "@girs/gtksource-5",
-    "version": "4.2.0",
-    "libraryVersion": "5.20.0",
-    "description": "GJS TypeScript type definitions for GtkSource-5, generated from library version 5.20.0",
+    "version": "4.3.0",
+    "libraryVersion": "5.21.0",
+    "description": "GJS TypeScript type definitions for GtkSource-5, generated from library version 5.21.0",
     "type": "module",
     "module": "gtksource-5.js",
     "main": "gtksource-5.js",
@@ -37,21 +37,21 @@
       "test": "tsc --project tsconfig.json"
     },
     "dependencies": {
-      "@girs/gjs": "^4.2.0",
-      "@girs/gtk-4.0": "^4.2.0",
-      "@girs/gsk-4.0": "^4.2.0",
-      "@girs/graphene-1.0": "^4.2.0",
-      "@girs/gobject-2.0": "^4.2.0",
-      "@girs/glib-2.0": "^4.2.0",
-      "@girs/gdk-4.0": "^4.2.0",
-      "@girs/cairo-1.0": "^4.2.0",
-      "@girs/pangocairo-1.0": "^4.2.0",
-      "@girs/pango-1.0": "^4.2.0",
-      "@girs/harfbuzz-0.0": "^4.2.0",
-      "@girs/freetype2-2.0": "^4.2.0",
-      "@girs/gio-2.0": "^4.2.0",
-      "@girs/gmodule-2.0": "^4.2.0",
-      "@girs/gdkpixbuf-2.0": "^4.2.0"    },
+      "@girs/gjs": "^4.3.0",
+      "@girs/gtk-4.0": "^4.3.0",
+      "@girs/gsk-4.0": "^4.3.0",
+      "@girs/graphene-1.0": "^4.3.0",
+      "@girs/gobject-2.0": "^4.3.0",
+      "@girs/glib-2.0": "^4.3.0",
+      "@girs/gdk-4.0": "^4.3.0",
+      "@girs/cairo-1.0": "^4.3.0",
+      "@girs/pangocairo-1.0": "^4.3.0",
+      "@girs/pango-1.0": "^4.3.0",
+      "@girs/harfbuzz-0.0": "^4.3.0",
+      "@girs/freetype2-2.0": "^4.3.0",
+      "@girs/gio-2.0": "^4.3.0",
+      "@girs/gmodule-2.0": "^4.3.0",
+      "@girs/gdkpixbuf-2.0": "^4.3.0"    },
     "devDependencies": {
       "typescript": "*"
     },