@girs/gjs 4.0.0-beta.9 → 4.0.0-rc.10

package/console.d.ts

@@ -0,0 +1,26 @@
+
+
+/**
+ * @param logDomain the GLib log domain this Console should print
+ *   with. Defaults to 'Gjs-Console'.
+ */
+export function setConsoleLogDomain(logDomain: string): void
+
+/**
+ * @param logDomain the GLib log domain this Console should print
+ *   with. Defaults to 'Gjs-Console'.
+ */
+export function getConsoleLogDomain(): string
+
+export declare const DEFAULT_LOG_DOMAIN: string
+
+declare const Console: {
+    setConsoleLogDomain: typeof setConsoleLogDomain,
+    getConsoleLogDomain: typeof getConsoleLogDomain,
+    DEFAULT_LOG_DOMAIN: typeof DEFAULT_LOG_DOMAIN
+}
+
+export default Console
+
+
+

package/console.js

@@ -0,0 +1,6 @@
+import Console, { getConsoleLogDomain, setConsoleLogDomain, DEFAULT_LOG_DOMAIN } from 'console';
+
+export { getConsoleLogDomain, setConsoleLogDomain, DEFAULT_LOG_DOMAIN }
+export default Console;
+
+

package/dom.d.ts

@@ -1,3 +1,4 @@
+
 /**
  * Gjs has implemented some functionality from the DOM API,
  * this leads to a conflict when all DOM (`lib.dom.d.ts`) should be used.
@@ -9,48 +10,51 @@
  * See also https://github.com/microsoft/TypeScript/blob/main/lib/lib.dom.d.ts
  */
 
+
 import type GLib from '@girs/glib-2.0';
+import type GObject from '@girs/gobject-2.0';
 
 declare global {
+
     interface ImportMeta {
         /**
          * The absolute file: or resource: URL of the module.
          *
          * @see https://gitlab.gnome.org/GNOME/gjs/-/blob/master/doc/ESModules.md#importmetaurl
          */
-        readonly url: string;
+        url: string; // with readonly this type is incompatible with e.g. https://github.com/vitejs/vite/blob/main/packages/vite/types/importMeta.d.ts
     }
 
     // Timers
     // See https://gitlab.gnome.org/GNOME/gjs/-/blob/master/modules/esm/_timers.js
 
     /**
-     * @version Gjs 1.71.1
+     * @since 1.71.1
      * @param callback a callback function
      * @param delay the duration in milliseconds to wait before running callback
      * @param args arguments to pass to callback
      */
-    function setTimeout(callback: (...args: any[]) => any, delay?: number, ...args: any[]): GLib.Source;
+    function setTimeout(callback: (...args: any[]) => any, delay?: number, ...args: any[]): GLib.Source
 
     /**
-     * @version Gjs 1.71.1
+     * @since 1.71.1
      * @param callback a callback function
      * @param delay the duration in milliseconds to wait between calling callback
      * @param args arguments to pass to callback
      */
-    function setInterval(callback: (...args: any[]) => any, delay?: number, ...args: any[]): GLib.Source;
+    function setInterval(callback: (...args: any[]) => any, delay?: number, ...args: any[]): GLib.Source
 
     /**
-     * @version Gjs 1.71.1
+     * @since 1.71.1
      * @param timeout the timeout to clear
      */
-    function clearTimeout(timeout: GLib.Source): void;
+    function clearTimeout(timeout: GLib.Source): void
 
     /**
-     * @version Gjs 1.71.1
+     * @since 1.71.1
      * @param timeout the timeout to clear
      */
-    function clearInterval(timeout: GLib.Source): void;
+    function clearInterval(timeout: GLib.Source): void
 
     interface Console {
         /**
@@ -62,7 +66,7 @@ declare global {
          * @param data formatting substitutions, if applicable
          * @returns
          */
-        assert(condition: boolean, ...data: any[]): void;
+        assert(condition: boolean, ...data: any[]): void
 
         /**
          * Resets grouping and clears the terminal on systems supporting ANSI
@@ -72,14 +76,14 @@ declare global {
          * console.clear() has no visual effect.
          *
          */
-        clear(): void;
+        clear(): void
 
         /**
          * Logs a message with severity equal to {@link GLib.LogLevelFlags.DEBUG}.
          *
          * @param  {...any} data formatting substitutions, if applicable
          */
-        debug(...data: any[]): void;
+        debug(...data: any[]): void
 
         /**
          * Logs a message with severity equal to {@link GLib.LogLevelFlags.CRITICAL}.
@@ -88,46 +92,46 @@ declare global {
          *
          * @param data formatting substitutions, if applicable
          */
-        error(...data: any[]): void;
+        error(...data: any[]): void
 
         /**
          * Logs a message with severity equal to {@link GLib.LogLevelFlags.INFO}.
          *
          * @param data formatting substitutions, if applicable
          */
-        info(...data: any[]): void;
+        info(...data: any[]): void
 
         /**
          * Logs a message with severity equal to {@link GLib.LogLevelFlags.MESSAGE}.
          *
          * @param data formatting substitutions, if applicable
          */
-        log(...data: any[]): void;
+        log(...data: any[]): void
 
         // 1.1.7 table(tabularData, properties)
-        table(tabularData: any, _properties: never): void;
+        table(tabularData: any, _properties: never): void
 
         /**
          * @param data formatting substitutions, if applicable
          */
-        trace(...data: any[]): void;
+        trace(...data: any[]): void
 
         /**
          * @param data formatting substitutions, if applicable
          */
-        warn(...data: any[]): void;
+        warn(...data: any[]): void
 
         /**
          * @param item an item to format generically
          * @param [options] any additional options for the formatter. Unused
          *   in our implementation.
          */
-        dir(item: object, options: never): void;
+        dir(item: object, options: never): void
 
         /**
          * @param data formatting substitutions, if applicable
          */
-        dirxml(...data: any[]): void;
+        dirxml(...data: any[]): void
 
         // 1.2 Counting functions
         // https://console.spec.whatwg.org/#counting
@@ -139,12 +143,12 @@ declare global {
          *
          * @param label unique identifier for this action
          */
-        count(label: string): void;
+        count(label: string): void
 
         /**
          * @param label the unique label to reset the count for
          */
-        countReset(label: string): void;
+        countReset(label: string): void
 
         // 1.3 Grouping functions
         // https://console.spec.whatwg.org/#grouping
@@ -152,18 +156,18 @@ declare global {
         /**
          * @param data formatting substitutions, if applicable
          */
-        group(...data: any[]): void;
+        group(...data: any[]): void
 
         /**
          * Alias for console.group()
          *
          * @param  {...any} data formatting substitutions, if applicable
          */
-        groupCollapsed(...data: any[]): void;
+        groupCollapsed(...data: any[]): void
 
         /**
          */
-        groupEnd(): void;
+        groupEnd(): void
 
         // 1.4 Timing functions
         // https://console.spec.whatwg.org/#timing
@@ -172,7 +176,7 @@ declare global {
          * @param label unique identifier for this action, pass to
          *   console.timeEnd() to complete
          */
-        time(label: string): void;
+        time(label: string): void
 
         /**
          * Logs the time since the last call to console.time(label) where label is
@@ -182,7 +186,7 @@ declare global {
          *   console.timeEnd() to complete
          * @param data string substitutions, if applicable
          */
-        timeLog(label: string, ...data: any[]): void;
+        timeLog(label: string, ...data: any[]): void
 
         /**
          * Logs the time since the last call to console.time(label) and completes
@@ -191,7 +195,7 @@ declare global {
          *
          * @param label unique identifier for this action
          */
-        timeEnd(label: string): void;
+        timeEnd(label: string): void
 
         // Non-standard functions which are de-facto standards.
         // Similar to Node, we define these as no-ops for now.
@@ -202,33 +206,21 @@ declare global {
          * @param _label unique identifier for this action, pass to
          *   console.profileEnd to complete
          */
-        profile(_label: string): void;
+        profile(_label: string): void
 
         /**
          * @deprecated Not implemented in GJS
          *
          * @param _label unique identifier for this action
          */
-        profileEnd(_label: string): void;
+        profileEnd(_label: string): void
 
         /**
          * @deprecated Not implemented in GJS
          *
          * @param _label unique identifier for this action
          */
-        timeStamp(_label: string): void;
-
-        // GJS-specific extensions for integrating with GLib structured logging
-
-        /**
-         * @param logDomain the GLib log domain this Console should print
-         *   with. Defaults to 'Gjs-Console'.
-         */
-        setLogDomain(logDomain: string): void;
-
-        logDomain: string;
-
-        interact(): void;
+        timeStamp(_label: string): void
     }
 
     interface TextDecodeOptions {
@@ -238,24 +230,24 @@ declare global {
 
     interface TextDecoderOptions {
         /** Indicates whether the error mode is fatal. */
-        fatal?: boolean;
+        fatal?: boolean
         /** Indicates whether whether the byte order mark is ignored. */
-        ignoreBOM?: boolean;
+        ignoreBOM?: boolean
     }
 
     /**
      * The TextDecoder interface represents a decoder for a specific text encoding.
      * It takes a stream of bytes as input and emits a stream of code points.
      *
-     * @version Gjs 1.69.2
+     * @since 1.69.2
      */
     interface TextDecoder {
         /** A string containing the name of the decoder, that is a string describing the method the TextDecoder will use. */
-        readonly encoding: TextDecoderEncoding;
+        readonly encoding: TextDecoderEncoding
         /** A Boolean indicating whether the error mode is fatal. */
-        readonly fatal: boolean;
+        readonly fatal: boolean
         /** A Boolean indicating whether the byte order mark is ignored. */
-        readonly ignoreBOM: boolean;
+        readonly ignoreBOM: boolean
 
         /**
          * Returns a string containing the text decoded with the method of the specific TextDecoder object.
@@ -265,28 +257,28 @@ declare global {
          * @param input Buffer containing the text to decode
          * @param options Object defining the decode options
          */
-        decode(input?: ArrayBufferView | ArrayBuffer, options?: TextDecodeOptions): string;
+        decode(input?: ArrayBufferView | ArrayBuffer, options?: TextDecodeOptions): string
     }
 
     interface TextEncoderEncodeIntoResult {
-        read?: number;
-        written?: number;
+        read?: number
+        written?: number
     }
 
     /**
      * TextEncoder takes a stream of code points as input and emits a stream of bytes.
      *
-     * @version Gjs 1.69.2
+     * @since 1.69.2
      */
     interface TextEncoder {
-        readonly encoding: 'utf-8';
+        readonly encoding: 'utf-8'
 
         /**
          * Takes a string as input, and returns a buffer containing the text given in parameters encoded with the UTF-8 method.
          *
          * @param input Text to encode.
          */
-        encode(input?: string): Uint8Array;
+        encode(input?: string): Uint8Array
         /**
          * Takes a string to encode and a destination Uint8Array to put resulting UTF-8 encoded text into,
          * and returns a dictionary object indicating the progress of the encoding.
@@ -296,20 +288,21 @@ declare global {
          * @param source Text to encode.
          * @param destination Buffer where to place the resulting UTF-8 encoded text into.
          */
-        encodeInto(source: string, destination: Uint8Array): TextEncoderEncodeIntoResult;
+        encodeInto(source: string, destination: Uint8Array): TextEncoderEncodeIntoResult
     }
 
-    const console: Console;
+    const console: Console
 
     const TextDecoder: {
-        prototype: TextDecoder;
-        new (label?: TextDecoderEncoding, options?: TextDecoderOptions): TextDecoder;
-    };
+        prototype: TextDecoder
+        new (label?: TextDecoderEncoding, options?: TextDecoderOptions): TextDecoder
+    }
 
     const TextEncoder: {
-        prototype: TextEncoder;
-        new (): TextEncoder;
-    };
+        prototype: TextEncoder
+        new (): TextEncoder
+    }
 }
 
-export {};
+export {}
+

package/gettext.d.ts

@@ -7,35 +7,38 @@ export enum LocaleCategory {
     NUMERIC,
     TIME,
 }
-export function setlocale(category: number, locale: string | null): string;
-export function textdomain(domainname: string | null): string;
-export function bindtextdomain(domainname: string, dirname: string | null): string;
-export function gettext(msgid: string): string;
-export function dgettext(domainname: string | null, msgid: string): string;
-export function dcgettext(domainname: string | null, msgid: string, category: number): string;
-export function ngettext(msgid: string, msgid_plural: string, n: number): string;
-export function dngettext(domainname: string, msgid: string, msgid_plural: string, n: number): string;
-export function pgettext(context: string, msgid: string): string;
-export function dpgettext(dom: string | null, context: string, msgid: string): string;
+export function setlocale(category: number, locale: string | null): string
+export function textdomain(domainname: string | null): string
+export function bindtextdomain(domainname: string, dirname: string | null): string
+export function gettext(msgid: string): string
+export function dgettext(domainname: string | null, msgid: string): string
+export function dcgettext(domainname: string | null, msgid: string, category: number): string
+export function ngettext(msgid: string, msgid_plural: string, n: number): string
+export function dngettext(domainname: string, msgid: string, msgid_plural: string, n: number): string
+export function pgettext(context: string, msgid: string): string
+export function dpgettext(dom: string | null, context: string, msgid: string): string
 export function domain(domainName: string): {
-    gettext: (msgid: string) => string;
-    ngettext: (msgid: string, msgid_plural: string, n: number) => string;
-    pgettext: (context: string, msgid: string) => string;
-};
+    gettext: (msgid: string) => string
+    ngettext: (msgid: string, msgid_plural: string, n: number) => string
+    pgettext: (context: string, msgid: string) => string
+}
 
 declare const Gettext: {
-    LocaleCategory: typeof LocaleCategory;
-    setlocale: typeof setlocale;
-    textdomain: typeof textdomain;
-    bindtextdomain: typeof bindtextdomain;
-    gettext: typeof gettext;
-    dgettext: typeof dgettext;
-    dcgettext: typeof dcgettext;
-    ngettext: typeof ngettext;
-    dngettext: typeof dngettext;
-    pgettext: typeof pgettext;
-    dpgettext: typeof dpgettext;
-    domain: typeof domain;
-};
+    LocaleCategory: typeof LocaleCategory,
+    setlocale: typeof setlocale,
+    textdomain: typeof textdomain,
+    bindtextdomain: typeof bindtextdomain,
+    gettext: typeof gettext,
+    dgettext: typeof dgettext,
+    dcgettext: typeof dcgettext,
+    ngettext: typeof ngettext,
+    dngettext: typeof dngettext,
+    pgettext: typeof pgettext,
+    dpgettext: typeof dpgettext,
+    domain: typeof domain,
+}
+
+export default Gettext
+
+
 
-export default Gettext;

package/gi.d.ts

@@ -0,0 +1,32 @@
+
+/**
+ * Requires a GObject Introspection namespace, optionally at a specific version.
+ * If a version is specified and a different version of the same namespace is
+ * already loaded, an error will be thrown.
+ *
+ * @param namespace The GI namespace to import (e.g. 'Gtk', 'GLib')
+ * @param version The version of the namespace (e.g. '4.0', '2.0')
+ * @returns The imported namespace module
+ */
+export function require(namespace: string, version?: string): any
+
+/**
+ * The `gi` module provides a single entry point for importing GObject
+ * Introspection namespaces in GJS ESM modules.
+ *
+ * @example
+ * ```ts
+ * import Gi from 'gi';
+ * Gi.require('Gtk', '4.0');
+ * ```
+ *
+ * @see https://gjs-docs.gnome.org/gjs/overrides.md#gi-require
+ */
+declare const Gi: {
+    readonly require: typeof require;
+}
+
+export default Gi
+
+
+

package/gi.js

@@ -0,0 +1,6 @@
+import Gi, { require } from 'gi';
+
+export { require };
+export default Gi;
+
+

package/gjs-ambient.d.ts

@@ -2,18 +2,32 @@
 // https://stackoverflow.com/questions/45099605/ambient-declaration-with-an-imported-type-in-typescript
 
 declare module 'gettext' {
-    export * from '@girs/gjs/gettext';
-    import Gettext from '@girs/gjs/gettext';
-    export default Gettext;
+    export * from '@girs/gjs/gettext'
+    import Gettext from '@girs/gjs/gettext'
+    export default Gettext
 }
 
 declare module 'system' {
-    export * from '@girs/gjs/system';
-    import System from '@girs/gjs/system';
-    export default System;
+    export * from '@girs/gjs/system'
+    import System from '@girs/gjs/system'
+    export default System
 }
 
 declare module 'cairo' {
-    import Cairo from '@girs/gjs/cairo';
-    export default Cairo;
+    import Cairo from '@girs/gjs/cairo'
+    export default Cairo
 }
+
+declare module 'console' {
+    import Console, { setConsoleLogDomain, getConsoleLogDomain, DEFAULT_LOG_DOMAIN } from '@girs/gjs/console'
+    export { setConsoleLogDomain, getConsoleLogDomain, DEFAULT_LOG_DOMAIN }
+    export default Console
+}
+
+declare module 'gi' {
+    import Gi, { require } from '@girs/gjs/gi'
+    export { require }
+    export default Gi
+}
+
+