@gtkx/ffi 0.9.1 → 0.9.3

package/dist/generated/gio/file-enumerator.js

@@ -1,24 +1,24 @@
 import { call } from "../../batch.js";
 import { NativeError } from "../../native/error.js";
-import { getObject } from "../../native/object.js";
+import { getNativeObject } from "../../native/object.js";
 import { isInstantiating, setInstantiating } from "../../native/base.js";
 import { registerNativeClass } from "../../registry.js";
 import { File } from "./file.js";
 import * as GObject from "../gobject/index.js";
 /**
- * `GFileEnumerator` allows you to operate on a set of [iface@Gio.File] objects,
- * returning a [class@Gio.FileInfo] structure for each file enumerated (e.g.
- * [method@Gio.File.enumerate_children] will return a `GFileEnumerator` for each
+ * `GFileEnumerator` allows you to operate on a set of {@link Gio.File} objects,
+ * returning a {@link Gio.FileInfo} structure for each file enumerated (e.g.
+ * {@link Gio.File.enumerate_children} will return a `GFileEnumerator` for each
  * of the children within a directory).
  *
  * To get the next file's information from a `GFileEnumerator`, use
- * [method@Gio.FileEnumerator.next_file] or its asynchronous version,
- * [method@Gio.FileEnumerator.next_files_async]. Note that the asynchronous
- * version will return a list of [class@Gio.FileInfo] objects, whereas the
+ * {@link Gio.FileEnumerator.next_file} or its asynchronous version,
+ * {@link Gio.FileEnumerator.next_files_async}. Note that the asynchronous
+ * version will return a list of {@link Gio.FileInfo} objects, whereas the
  * synchronous will only return the next file in the enumerator.
  *
  * The ordering of returned files is unspecified for non-Unix
- * platforms; for more information, see [method@GLib.Dir.read_name].  On Unix,
+ * platforms; for more information, see {@link GLib.Dir.read_name}.  On Unix,
  * when operating on local files, returned files will be sorted by
  * inode number.  Effectively you can assume that the ordering of
  * returned files will be stable between successive calls (and
@@ -28,10 +28,10 @@ import * as GObject from "../gobject/index.js";
  * modification time, you will have to implement that in your
  * application code.
  *
- * To close a `GFileEnumerator`, use [method@Gio.FileEnumerator.close], or
- * its asynchronous version, [method@Gio.FileEnumerator.close_async]. Once
+ * To close a `GFileEnumerator`, use {@link Gio.FileEnumerator.close}, or
+ * its asynchronous version, {@link Gio.FileEnumerator.close_async}. Once
  * a `GFileEnumerator` is closed, no further actions may be performed
- * on it, and it should be freed with [method@GObject.Object.unref].
+ * on it, and it should be freed with {@link GObject.Object.unref}.
  */
 export class FileEnumerator extends GObject.GObject {
     static glibTypeName = "GFileEnumerator";
@@ -99,7 +99,7 @@ export class FileEnumerator extends GObject.GObject {
      * Finishes closing a file enumerator, started from g_file_enumerator_close_async().
      *
      * If the file enumerator was already closed when g_file_enumerator_close_async()
-     * was called, then this function will report %G_IO_ERROR_CLOSED in @error, and
+     * was called, then this function will report %G_IO_ERROR_CLOSED in `error`, and
      * return %FALSE. If the file enumerator had pending operation when the close
      * operation was started, then this function will report %G_IO_ERROR_PENDING, and
      * return %FALSE.  If `cancellable` was not %NULL, then the operation may have been
@@ -138,7 +138,7 @@ export class FileEnumerator extends GObject.GObject {
     }
     /**
      * Return a new #GFile which refers to the file named by `info` in the source
-     * directory of @enumerator.  This function is primarily intended to be used
+     * directory of `enumerator`.  This function is primarily intended to be used
      * inside loops with g_file_enumerator_next_file().
      *
      * To use this, %G_FILE_ATTRIBUTE_STANDARD_NAME must have been listed in the
@@ -163,7 +163,7 @@ export class FileEnumerator extends GObject.GObject {
                 value: info?.id ?? info,
             },
         ], { type: "gobject", borrowed: true });
-        return getObject(ptr, File);
+        return getNativeObject(ptr, File);
     }
     /**
      * Get the #GFile container which is being enumerated.
@@ -175,7 +175,7 @@ export class FileEnumerator extends GObject.GObject {
                 value: this.id,
             },
         ], { type: "gobject", borrowed: true });
-        return getObject(ptr, File);
+        return getNativeObject(ptr, File);
     }
     /**
      * Checks if the file enumerator has pending operations.
@@ -218,7 +218,7 @@ export class FileEnumerator extends GObject.GObject {
      * Finally, this function optionally allows retrieving a #GFile as
      * well.
      *
-     * You must specify at least one of `out_info` or @out_child.
+     * You must specify at least one of `out_info` or `out_child`.
      *
      * The code pattern for correctly using g_file_enumerator_iterate() from C
      * is:
@@ -236,7 +236,8 @@ export class FileEnumerator extends GObject.GObject {
      * }
      *
      * out:
-     * g_object_unref (direnum); // Note: frees the last `info` ]|
+     * g_object_unref (direnum); // Note: frees the last `info`
+     * ]|
      * @param outInfo - Output location for the next #GFileInfo, or %NULL
      * @param outChild - Output location for the next #GFile, or %NULL
      * @param cancellable - a #GCancellable
@@ -279,9 +280,9 @@ export class FileEnumerator extends GObject.GObject {
             throw new NativeError(error.value);
         }
         if (outInfo)
-            outInfo.value = getObject(outInfo.value);
+            outInfo.value = getNativeObject(outInfo.value);
         if (outChild)
-            outChild.value = getObject(outChild.value);
+            outChild.value = getNativeObject(outChild.value);
         return result;
     }
     /**
@@ -327,7 +328,7 @@ export class FileEnumerator extends GObject.GObject {
         }
         if (ptr === null)
             return null;
-        return getObject(ptr);
+        return getNativeObject(ptr);
     }
     /**
      * Finishes the asynchronous operation started with g_file_enumerator_next_files_async().
@@ -364,7 +365,7 @@ export class FileEnumerator extends GObject.GObject {
         if (error.value !== null) {
             throw new NativeError(error.value);
         }
-        return ptrs.map((ptr) => getObject(ptr));
+        return ptrs.map((ptr) => getNativeObject(ptr));
     }
     /**
      * Sets the file enumerator as having pending operations.
@@ -387,7 +388,7 @@ export class FileEnumerator extends GObject.GObject {
         const argTypes = [selfType];
         const returnType = undefined;
         const wrappedHandler = (...args) => {
-            const self = getObject(args[0]);
+            const self = getNativeObject(args[0]);
             return handler(self, ...args.slice(1));
         };
         return call("libgio-2.0.so.0", "g_signal_connect_closure", [

package/dist/generated/gio/file-icon.d.ts

@@ -10,7 +10,7 @@ import * as GObject from "../gobject/index.js";
  * `GFileIcon` specifies an icon by pointing to an image file
  * to be used as icon.
  *
- * It implements [iface@Gio.LoadableIcon].
+ * It implements {@link Gio.LoadableIcon}.
  */
 export declare class FileIcon extends GObject.GObject {
     static readonly glibTypeName: string;
@@ -21,7 +21,7 @@ export declare class FileIcon extends GObject.GObject {
      */
     constructor(file: File);
     /**
-     * Gets the #GFile associated with the given @icon.
+     * Gets the #GFile associated with the given `icon`.
      */
     getFile(): File;
     /**

package/dist/generated/gio/file-icon.js

@@ -1,6 +1,6 @@
 import { call } from "../../batch.js";
 import { NativeError } from "../../native/error.js";
-import { getObject } from "../../native/object.js";
+import { getNativeObject } from "../../native/object.js";
 import { isInstantiating, setInstantiating } from "../../native/base.js";
 import { registerNativeClass } from "../../registry.js";
 import { File } from "./file.js";
@@ -10,7 +10,7 @@ import * as GObject from "../gobject/index.js";
  * `GFileIcon` specifies an icon by pointing to an image file
  * to be used as icon.
  *
- * It implements [iface@Gio.LoadableIcon].
+ * It implements {@link Gio.LoadableIcon}.
  */
 export class FileIcon extends GObject.GObject {
     static glibTypeName = "GFileIcon";
@@ -38,7 +38,7 @@ export class FileIcon extends GObject.GObject {
         }
     }
     /**
-     * Gets the #GFile associated with the given @icon.
+     * Gets the #GFile associated with the given `icon`.
      */
     getFile() {
         const ptr = call("libgio-2.0.so.0", "g_file_icon_get_file", [
@@ -47,7 +47,7 @@ export class FileIcon extends GObject.GObject {
                 value: this.id,
             },
         ], { type: "gobject", borrowed: true });
-        return getObject(ptr, File);
+        return getNativeObject(ptr, File);
     }
     /**
      * Checks if two icons are equal.
@@ -94,11 +94,12 @@ export class FileIcon extends GObject.GObject {
             type: "boxed",
             borrowed: true,
             innerType: "GVariant",
-            lib: "libgio-2.0.so.0",
+            lib: "libgobject-2.0.so.0,libglib-2.0.so.0",
+            getTypeFn: "intern",
         });
         if (ptr === null)
             return null;
-        return getObject(ptr, GLib.Variant);
+        return getNativeObject(ptr, GLib.Variant);
     }
     /**
      * Generates a textual representation of `icon` that can be used for
@@ -169,7 +170,7 @@ export class FileIcon extends GObject.GObject {
         if (error.value !== null) {
             throw new NativeError(error.value);
         }
-        return getObject(ptr);
+        return getNativeObject(ptr);
     }
     /**
      * Finishes an asynchronous icon load started in g_loadable_icon_load_async().
@@ -207,14 +208,14 @@ export class FileIcon extends GObject.GObject {
         if (error.value !== null) {
             throw new NativeError(error.value);
         }
-        return getObject(ptr);
+        return getNativeObject(ptr);
     }
     connect(signal, handler, after = false) {
         const selfType = { type: "gobject", borrowed: true };
         const argTypes = [selfType];
         const returnType = undefined;
         const wrappedHandler = (...args) => {
-            const self = getObject(args[0]);
+            const self = getNativeObject(args[0]);
             return handler(self, ...args.slice(1));
         };
         return call("libgio-2.0.so.0", "g_signal_connect_closure", [

package/dist/generated/gio/file-info.d.ts

@@ -5,7 +5,7 @@ import { Icon } from "./icon.js";
 import * as GLib from "../glib/index.js";
 import * as GObject from "../gobject/index.js";
 /**
- * Stores information about a file system object referenced by a [iface@Gio.File].
+ * Stores information about a file system object referenced by a {@link Gio.File}.
  *
  * Functionality for manipulating basic metadata for files. `GFileInfo`
  * implements methods for getting information that all files should
@@ -14,32 +14,32 @@ import * as GObject from "../gobject/index.js";
  * See the file attributes document for more
  * information on how GIO handles file attributes.
  *
- * To obtain a `GFileInfo` for a [iface@Gio.File], use
- * [method@Gio.File.query_info] (or its async variant). To obtain a `GFileInfo`
- * for a file input or output stream, use [method@Gio.FileInputStream.query_info]
- * or [method@Gio.FileOutputStream.query_info] (or their async variants).
+ * To obtain a `GFileInfo` for a {@link Gio.File}, use
+ * {@link Gio.File.query_info} (or its async variant). To obtain a `GFileInfo`
+ * for a file input or output stream, use {@link Gio.FileInputStream.query_info}
+ * or {@link Gio.FileOutputStream.query_info} (or their async variants).
  *
  * To change the actual attributes of a file, you should then set the
- * attribute in the `GFileInfo` and call [method@Gio.File.set_attributes_from_info]
- * or [method@Gio.File.set_attributes_async] on a `GFile`.
+ * attribute in the `GFileInfo` and call {@link Gio.File.set_attributes_from_info}
+ * or {@link Gio.File.set_attributes_async} on a `GFile`.
  *
  * However, not all attributes can be changed in the file. For instance,
- * the actual size of a file cannot be changed via [method@Gio.FileInfo.set_size].
- * You may call [method@Gio.File.query_settable_attributes] and
- * [method@Gio.File.query_writable_namespaces] to discover the settable attributes
+ * the actual size of a file cannot be changed via {@link Gio.FileInfo.set_size}.
+ * You may call {@link Gio.File.query_settable_attributes} and
+ * {@link Gio.File.query_writable_namespaces} to discover the settable attributes
  * of a particular file at runtime.
  *
- * The direct accessors, such as [method@Gio.FileInfo.get_name], are slightly more
+ * The direct accessors, such as {@link Gio.FileInfo.get_name}, are slightly more
  * optimized than the generic attribute accessors, such as
- * [method@Gio.FileInfo.get_attribute_byte_string].This optimization will matter
+ * {@link Gio.FileInfo.get_attribute_byte_string}.This optimization will matter
  * only if calling the API in a tight loop.
  *
  * It is an error to call these accessors without specifying their required file
  * attributes when creating the `GFileInfo`. Use
- * [method@Gio.FileInfo.has_attribute] or [method@Gio.FileInfo.list_attributes]
+ * {@link Gio.FileInfo.has_attribute} or {@link Gio.FileInfo.list_attributes}
  * to check what attributes are specified for a `GFileInfo`.
  *
- * [struct@Gio.FileAttributeMatcher] allows for searching through a `GFileInfo`
+ * {@link Gio.FileAttributeMatcher} allows for searching through a `GFileInfo`
  * for attributes.
  */
 export declare class FileInfo extends GObject.GObject {
@@ -50,12 +50,12 @@ export declare class FileInfo extends GObject.GObject {
      */
     constructor();
     /**
-     * Clears the status information from @info.
+     * Clears the status information from `info`.
      */
     clearStatus(): void;
     /**
      * First clears all of the GFileAttribute of
-     * @dest_info, and then copies all of the file attributes from `src_info` to @dest_info.
+     * `dest_info`, and then copies all of the file attributes from `src_info` to `dest_info`.
      * @param destInfo - destination to copy attributes to.
      */
     copyInto(destInfo: FileInfo): void;
@@ -84,8 +84,8 @@ export declare class FileInfo extends GObject.GObject {
      * format.
      *
      * To format file name attributes of type
-     * [enum@Gio.FileAttributeType.BYTE_STRING] for output as UTF-8, use
-     * [func@GLib.filename_to_utf8] instead:
+     * {@link Gio.FileAttributeType.BYTE_STRING} for output as UTF-8, use
+     * {@link GLib.filename_to_utf8} instead:
      * ```c
      * const char *trash_orig_path_byte_string;
      * g_autofree char *trash_orig_path_utf8 = NULL;
@@ -225,7 +225,7 @@ export declare class FileInfo extends GObject.GObject {
      */
     getEditName(): string;
     /**
-     * Gets the [entity tag][iface@Gio.File#entity-tags] for a given
+     * Gets the [entity tag]{@link Gio.File#entity-tags} for a given
      * #GFileInfo. See %G_FILE_ATTRIBUTE_ETAG_VALUE.
      *
      * It is an error to call this if the #GFileInfo does not contain
@@ -283,7 +283,7 @@ export declare class FileInfo extends GObject.GObject {
     getModificationDateTime(): GLib.DateTime | null;
     /**
      * Gets the modification time of the current `info` and sets it
-     * in @result.
+     * in `result`.
      *
      * It is an error to call this if the #GFileInfo does not contain
      * %G_FILE_ATTRIBUTE_TIME_MODIFIED. If %G_FILE_ATTRIBUTE_TIME_MODIFIED_USEC is
@@ -330,13 +330,13 @@ export declare class FileInfo extends GObject.GObject {
      */
     getSymlinkTarget(): string | null;
     /**
-     * Checks if a file info structure has an attribute named @attribute.
+     * Checks if a file info structure has an attribute named `attribute`.
      * @param attribute - a file attribute key.
      */
     hasAttribute(attribute: string): boolean;
     /**
      * Checks if a file info structure has an attribute in the
-     * specified @name_space.
+     * specified `name_space`.
      * @param nameSpace - a file attribute namespace.
      */
     hasNamespace(nameSpace: string): boolean;
@@ -361,28 +361,28 @@ export declare class FileInfo extends GObject.GObject {
     setAccessDateTime(atime: GLib.DateTime): void;
     /**
      * Sets the `attribute` to contain the given value, if possible. To unset the
-     * attribute, use %G_FILE_ATTRIBUTE_TYPE_INVALID for @type.
+     * attribute, use %G_FILE_ATTRIBUTE_TYPE_INVALID for `type`.
      * @param attribute - a file attribute key.
      * @param type - a #GFileAttributeType
      * @param valueP - pointer to the value
      */
     setAttribute(attribute: string, type: FileAttributeType, valueP: number): void;
     /**
-     * Sets the `attribute` to contain the given @attr_value,
+     * Sets the `attribute` to contain the given `attr_value`,
      * if possible.
      * @param attribute - a file attribute key.
      * @param attrValue - a boolean value.
      */
     setAttributeBoolean(attribute: string, attrValue: boolean): void;
     /**
-     * Sets the `attribute` to contain the given @attr_value,
+     * Sets the `attribute` to contain the given `attr_value`,
      * if possible.
      * @param attribute - a file attribute key.
      * @param attrValue - a byte string.
      */
     setAttributeByteString(attribute: string, attrValue: string): void;
     /**
-     * Sets the `attribute` to contain the given @attr_value,
+     * Sets the `attribute` to contain the given `attr_value`,
      * if possible.
      *
      * This function is meant to be used by language bindings that have specific
@@ -392,14 +392,14 @@ export declare class FileInfo extends GObject.GObject {
      */
     setAttributeFilePath(attribute: string, attrValue: string): void;
     /**
-     * Sets the `attribute` to contain the given @attr_value,
+     * Sets the `attribute` to contain the given `attr_value`,
      * if possible.
      * @param attribute - a file attribute key.
      * @param attrValue - a signed 32-bit integer
      */
     setAttributeInt32(attribute: string, attrValue: number): void;
     /**
-     * Sets the `attribute` to contain the given @attr_value,
+     * Sets the `attribute` to contain the given `attr_value`,
      * if possible.
      * @param attribute - attribute name to set.
      * @param attrValue - int64 value to set attribute to.
@@ -411,7 +411,7 @@ export declare class FileInfo extends GObject.GObject {
      */
     setAttributeMask(mask: FileAttributeMatcher): void;
     /**
-     * Sets the `attribute` to contain the given @attr_value,
+     * Sets the `attribute` to contain the given `attr_value`,
      * if possible.
      * @param attribute - a file attribute key.
      * @param attrValue - a #GObject.
@@ -429,14 +429,14 @@ export declare class FileInfo extends GObject.GObject {
      */
     setAttributeStatus(attribute: string, status: FileAttributeStatus): boolean;
     /**
-     * Sets the `attribute` to contain the given @attr_value,
+     * Sets the `attribute` to contain the given `attr_value`,
      * if possible.
      * @param attribute - a file attribute key.
      * @param attrValue - a UTF-8 string.
      */
     setAttributeString(attribute: string, attrValue: string): void;
     /**
-     * Sets the `attribute` to contain the given @attr_value,
+     * Sets the `attribute` to contain the given `attr_value`,
      * if possible.
      *
      * Sinze: 2.22
@@ -445,14 +445,14 @@ export declare class FileInfo extends GObject.GObject {
      */
     setAttributeStringv(attribute: string, attrValue: string[]): void;
     /**
-     * Sets the `attribute` to contain the given @attr_value,
+     * Sets the `attribute` to contain the given `attr_value`,
      * if possible.
      * @param attribute - a file attribute key.
      * @param attrValue - an unsigned 32-bit integer.
      */
     setAttributeUint32(attribute: string, attrValue: number): void;
     /**
-     * Sets the `attribute` to contain the given @attr_value,
+     * Sets the `attribute` to contain the given `attr_value`,
      * if possible.
      * @param attribute - a file attribute key.
      * @param attrValue - an unsigned 64-bit integer.
@@ -486,7 +486,7 @@ export declare class FileInfo extends GObject.GObject {
      */
     setEditName(editName: string): void;
     /**
-     * Sets the file type in a #GFileInfo to @type.
+     * Sets the file type in a #GFileInfo to `type`.
      * See %G_FILE_ATTRIBUTE_STANDARD_TYPE.
      * @param type - a #GFileType.
      */
@@ -498,13 +498,13 @@ export declare class FileInfo extends GObject.GObject {
      */
     setIcon(icon: Icon): void;
     /**
-     * Sets the "is_hidden" attribute in a #GFileInfo according to @is_hidden.
+     * Sets the "is_hidden" attribute in a #GFileInfo according to `is_hidden`.
      * See %G_FILE_ATTRIBUTE_STANDARD_IS_HIDDEN.
      * @param isHidden - a #gboolean.
      */
     setIsHidden(isHidden: boolean): void;
     /**
-     * Sets the "is_symlink" attribute in a #GFileInfo according to @is_symlink.
+     * Sets the "is_symlink" attribute in a #GFileInfo according to `is_symlink`.
      * See %G_FILE_ATTRIBUTE_STANDARD_IS_SYMLINK.
      * @param isSymlink - a #gboolean.
      */