@girs/gtk4layershell-1.0 1.0.0-4.0.0-beta.16

package/README.md

@@ -0,0 +1,86 @@
+
+# Gtk4LayerShell-1.0
+
+![version](https://img.shields.io/npm/v/@girs/gtk4layershell-1.0)
+![downloads/week](https://img.shields.io/npm/dw/@girs/gtk4layershell-1.0)
+
+
+GJS TypeScript type definitions for Gtk4LayerShell-1.0, generated from library version 1.0.0 using [ts-for-gir](https://github.com/gjsify/ts-for-gir) v4.0.0-beta.16.
+
+
+## Install
+
+To use this type definitions, install them with NPM:
+```bash
+npm install @girs/gtk4layershell-1.0
+```
+
+## Usage
+
+You can import this package into your project like this:
+```ts
+import Gtk4LayerShell from '@girs/gtk4layershell-1.0';
+```
+
+### 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.
+For this you need to include `@girs/gtk4layershell-1.0` or `@girs/gtk4layershell-1.0/ambient` in your `tsconfig` or entry point Typescript file:
+
+`index.ts`:
+```ts
+import '@girs/gtk4layershell-1.0'
+```
+
+`tsconfig.json`:
+```json
+{
+  "compilerOptions": {
+    ...
+  },
+  "include": ["@girs/gtk4layershell-1.0"],
+  ...
+}
+```
+
+Now you can import the ambient module with TypeScript support: 
+
+```ts
+import Gtk4LayerShell from 'gi://Gtk4LayerShell?version=1.0';
+```
+
+### Global import
+
+You can also import the module with Typescript support using the global `imports.gi` object of GJS.
+For this you need to include `@girs/gtk4layershell-1.0` or `@girs/gtk4layershell-1.0/import` in your `tsconfig` or entry point Typescript file:
+
+`index.ts`:
+```ts
+import '@girs/gtk4layershell-1.0'
+```
+
+`tsconfig.json`:
+```json
+{
+  "compilerOptions": {
+    ...
+  },
+  "include": ["@girs/gtk4layershell-1.0"],
+  ...
+}
+```
+
+Now you have also type support for this, too:
+
+```ts
+const Gtk4LayerShell = imports.gi.Gtk4LayerShell;
+```
+
+### 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).
+
+## Other packages
+
+All existing pre-generated packages can be found on [gjsify/types](https://github.com/gjsify/types).
+

package/gtk4layershell-1.0-ambient.d.ts

@@ -0,0 +1,9 @@
+declare module 'gi://Gtk4LayerShell?version=1.0' {
+    import Gtk4LayerShell10 from '@girs/gtk4layershell-1.0';
+    export default Gtk4LayerShell10;
+}
+
+declare module 'gi://Gtk4LayerShell' {
+    import Gtk4LayerShell10 from 'gi://Gtk4LayerShell?version=1.0';
+    export default Gtk4LayerShell10;
+}

package/gtk4layershell-1.0-ambient.js

@@ -0,0 +1,2 @@
+export {}
+

package/gtk4layershell-1.0-import.d.ts

@@ -0,0 +1,9 @@
+import Gtk4LayerShell10 from '@girs/gtk4layershell-1.0';
+
+declare global {
+    export interface GjsGiImports {
+        Gtk4LayerShell: typeof Gtk4LayerShell10;
+    }
+}
+
+export default GjsGiImports;

package/gtk4layershell-1.0-import.js

@@ -0,0 +1,3 @@
+const gi = globalThis.imports?.gi || {};
+export default gi;
+

package/gtk4layershell-1.0.d.ts

@@ -0,0 +1,249 @@
+/**
+ * Type Definitions for Gjs (https://gjs.guide/)
+ *
+ * These type definitions are automatically generated, do not edit them by hand.
+ * If you found a bug fix it in `ts-for-gir` or create a bug report on https://github.com/gjsify/ts-for-gir
+ *
+ * The based EJS template file is used for the generated .d.ts file of each GIR module like Gtk-4.0, GObject-2.0, ...
+ */
+
+// Module dependencies
+import type Gtk from '@girs/gtk-4.0';
+import type Gsk from '@girs/gsk-4.0';
+import type Graphene from '@girs/graphene-1.0';
+import type GObject from '@girs/gobject-2.0';
+import type GLib from '@girs/glib-2.0';
+import type Gdk from '@girs/gdk-4.0';
+import type cairo from '@girs/cairo-1.0';
+import type PangoCairo from '@girs/pangocairo-1.0';
+import type Pango from '@girs/pango-1.0';
+import type HarfBuzz from '@girs/harfbuzz-0.0';
+import type freetype2 from '@girs/freetype2-2.0';
+import type Gio from '@girs/gio-2.0';
+import type GModule from '@girs/gmodule-2.0';
+import type GdkPixbuf from '@girs/gdkpixbuf-2.0';
+
+export namespace Gtk4LayerShell {
+    /**
+     * Gtk4LayerShell-1.0
+     */
+
+    export namespace Edge {
+        export const $gtype: GObject.GType<Edge>;
+    }
+
+    enum Edge {
+        /**
+         * The left edge of the screen.
+         */
+        LEFT,
+        /**
+         * The right edge of the screen.
+         */
+        RIGHT,
+        /**
+         * The top edge of the screen.
+         */
+        TOP,
+        /**
+         * The bottom edge of the screen.
+         */
+        BOTTOM,
+        /**
+         * Should not be used except to get the number of entries. (NOTE: may change in
+         * future releases as more entries are added)
+         */
+        ENTRY_NUMBER,
+    }
+
+    export namespace KeyboardMode {
+        export const $gtype: GObject.GType<KeyboardMode>;
+    }
+
+    enum KeyboardMode {
+        /**
+         * This window should not receive keyboard events.
+         */
+        NONE,
+        /**
+         * This window should have exclusive focus if it is on the top or overlay layer.
+         */
+        EXCLUSIVE,
+        /**
+         * The user should be able to focus and unfocues this window in an implementation
+         * defined way. Not supported for protocol version < 4.
+         */
+        ON_DEMAND,
+        /**
+         * Should not be used except to get the number of entries. (NOTE: may change in
+         * future releases as more entries are added)
+         */
+        ENTRY_NUMBER,
+    }
+
+    export namespace Layer {
+        export const $gtype: GObject.GType<Layer>;
+    }
+
+    enum Layer {
+        /**
+         * The background layer.
+         */
+        BACKGROUND,
+        /**
+         * The bottom layer.
+         */
+        BOTTOM,
+        /**
+         * The top layer.
+         */
+        TOP,
+        /**
+         * The overlay layer.
+         */
+        OVERLAY,
+        /**
+         * Should not be used except to get the number of entries. (NOTE: may change in
+         * future releases as more entries are added)
+         */
+        ENTRY_NUMBER,
+    }
+    /**
+     * When auto exclusive zone is enabled, exclusive zone is automatically set to the
+     * size of the `window` + relevant margin. To disable auto exclusive zone, just set the
+     * exclusive zone to 0 or any other fixed value.
+     *
+     * NOTE: you can control the auto exclusive zone by changing the margin on the non-anchored
+     * edge. This behavior is specific to gtk4-layer-shell and not part of the underlying protocol
+     * @param window A layer surface.
+     */
+    function auto_exclusive_zone_enable(window: Gtk.Window): void;
+    function auto_exclusive_zone_is_enabled(window: Gtk.Window): boolean;
+    function get_anchor(window: Gtk.Window, edge: Edge): boolean;
+    function get_exclusive_zone(window: Gtk.Window): number;
+    function get_keyboard_mode(window: Gtk.Window): KeyboardMode;
+    function get_layer(window: Gtk.Window): Layer;
+    function get_major_version(): number;
+    function get_margin(window: Gtk.Window, edge: Edge): number;
+    function get_micro_version(): number;
+    function get_minor_version(): number;
+    /**
+     * NOTE: To get which monitor the surface is actually on, use
+     * gdk_display_get_monitor_at_window().
+     * @param window A layer surface.
+     * @returns the monitor this surface will/has requested to be on, can be %NULL.
+     */
+    function get_monitor(window: Gtk.Window): Gdk.Monitor;
+    /**
+     * NOTE: this function does not return ownership of the string. Do not free the returned string.
+     * Future calls into the library may invalidate the returned string.
+     * @param window A layer surface.
+     * @returns a reference to the namespace property. If namespace is unset, returns the default namespace ("gtk4-layer-shell"). Never returns %NULL.
+     */
+    function get_namespace(window: Gtk.Window): string;
+    /**
+     * May block for a Wayland roundtrip the first time it's called.
+     * @returns version of the zwlr_layer_shell_v1 protocol supported by the compositor or 0 if the protocol is not supported.
+     */
+    function get_protocol_version(): number;
+    function get_zwlr_layer_surface_v1(window: Gtk.Window): any | null;
+    /**
+     * Set the `window` up to be a layer surface once it is mapped. this must be called before
+     * the `window` is realized.
+     * @param window A #GtkWindow to be turned into a layer surface.
+     */
+    function init_for_window(window: Gtk.Window): void;
+    function is_layer_window(window: Gtk.Window): boolean;
+    /**
+     * May block for a Wayland roundtrip the first time it's called.
+     * @returns %TRUE if the platform is Wayland and Wayland compositor supports the zwlr_layer_shell_v1 protocol.
+     */
+    function is_supported(): boolean;
+    /**
+     * Set whether `window` should be anchored to `edge`.
+     * - If two perpendicular edges are anchored, the surface with be anchored to that corner
+     * - If two opposite edges are anchored, the window will be stretched across the screen in that direction
+     *
+     * Default is %FALSE for each #GtkLayerShellEdge
+     * @param window A layer surface.
+     * @param edge A #GtkLayerShellEdge this layer surface may be anchored to.
+     * @param anchor_to_edge Whether or not to anchor this layer surface to @edge.
+     */
+    function set_anchor(window: Gtk.Window, edge: Edge, anchor_to_edge: boolean): void;
+    /**
+     * Has no effect unless the surface is anchored to an edge. Requests that the compositor
+     * does not place other surfaces within the given exclusive zone of the anchored edge.
+     * For example, a panel can request to not be covered by maximized windows. See
+     * wlr-layer-shell-unstable-v1.xml for details.
+     *
+     * Default is 0
+     * @param window A layer surface.
+     * @param exclusive_zone The size of the exclusive zone.
+     */
+    function set_exclusive_zone(window: Gtk.Window, exclusive_zone: number): void;
+    /**
+     * Sets if/when `window` should receive keyboard events from the compositor, see
+     * GtkLayerShellKeyboardMode for details.
+     *
+     * Default is %GTK_LAYER_SHELL_KEYBOARD_MODE_NONE
+     * @param window A layer surface.
+     * @param mode The type of keyboard interactivity requested.
+     */
+    function set_keyboard_mode(window: Gtk.Window, mode: KeyboardMode): void;
+    /**
+     * Set the "layer" on which the surface appears (controls if it is over top of or below other surfaces). The layer may
+     * be changed on-the-fly in the current version of the layer shell protocol, but on compositors that only support an
+     * older version the `window` is remapped so the change can take effect.
+     *
+     * Default is %GTK_LAYER_SHELL_LAYER_TOP
+     * @param window A layer surface.
+     * @param layer The layer on which this surface appears.
+     */
+    function set_layer(window: Gtk.Window, layer: Layer): void;
+    /**
+     * Set the margin for a specific `edge` of a `window`. Effects both surface's distance from
+     * the edge and its exclusive zone size (if auto exclusive zone enabled).
+     *
+     * Default is 0 for each #GtkLayerShellEdge
+     * @param window A layer surface.
+     * @param edge The #GtkLayerShellEdge for which to set the margin.
+     * @param margin_size The margin for @edge to be set.
+     */
+    function set_margin(window: Gtk.Window, edge: Edge, margin_size: number): void;
+    /**
+     * Set the output for the window to be placed on, or %NULL to let the compositor choose.
+     * If the window is currently mapped, it will get remapped so the change can take effect.
+     *
+     * Default is %NULL
+     * @param window A layer surface.
+     * @param monitor The output this layer surface will be placed on (%NULL to let the compositor decide).
+     */
+    function set_monitor(window: Gtk.Window, monitor: Gdk.Monitor): void;
+    /**
+     * Set the "namespace" of the surface.
+     *
+     * No one is quite sure what this is for, but it probably should be something generic
+     * ("panel", "osk", etc). The `name_space` string is copied, and caller maintains
+     * ownership of original. If the window is currently mapped, it will get remapped so
+     * the change can take effect.
+     *
+     * Default is "gtk4-layer-shell" (which will be used if set to %NULL)
+     * @param window A layer surface.
+     * @param name_space The namespace of this layer surface.
+     */
+    function set_namespace(window: Gtk.Window, name_space: string): void;
+    /**
+     * Name of the imported GIR library
+     * `see` https://gitlab.gnome.org/GNOME/gjs/-/blob/master/gi/ns.cpp#L188
+     */
+    const __name__: string;
+    /**
+     * Version of the imported GIR library
+     * `see` https://gitlab.gnome.org/GNOME/gjs/-/blob/master/gi/ns.cpp#L189
+     */
+    const __version__: string;
+}
+
+export default Gtk4LayerShell;
+
+// END

package/gtk4layershell-1.0.js

@@ -0,0 +1,5 @@
+
+// @ts-expect-error
+import Gtk4LayerShell from 'gi://Gtk4LayerShell?version=1.0';
+export default Gtk4LayerShell;
+

package/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Type Definitions for Gjs (https://gjs.guide/)
+ *
+ * These type definitions are automatically generated, do not edit them by hand.
+ * If you found a bug fix it in `ts-for-gir` or create a bug report on https://github.com/gjsify/ts-for-gir
+ *
+ * This template is used to generate the index.d.ts file of each GIR module like Gtk-4.0, GObject-2.0, ...
+ */
+
+import './gtk4layershell-1.0-ambient.d.ts';
+
+import './gtk4layershell-1.0-import.d.ts';
+
+import Gtk4LayerShell from './gtk4layershell-1.0.js';
+export default Gtk4LayerShell;

package/index.js

@@ -0,0 +1,5 @@
+
+// @ts-expect-error
+import Gtk4LayerShell from './gtk4layershell-1.0.js';
+export default Gtk4LayerShell;
+

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@girs/gtk4layershell-1.0",
+  "version": "1.0.0-4.0.0-beta.16",
+  "description": "GJS TypeScript type definitions for Gtk4LayerShell-1.0, generated from library version 1.0.0",
+  "type": "module",
+  "module": "gtk4layershell-1.0.js",
+  "main": "gtk4layershell-1.0.js",
+  "exports": {
+    "./ambient": {
+      "types": "./gtk4layershell-1.0-ambient.d.ts",
+      "import": "./gtk4layershell-1.0-ambient.js",
+      "default": "./gtk4layershell-1.0-ambient.js"
+    },
+    "./import": {
+      "types": "./gtk4layershell-1.0-import.d.ts",
+      "import": "./gtk4layershell-1.0-import.js",
+      "default": "./gtk4layershell-1.0-import.js"
+    },
+    "./gtk4layershell-1.0": {
+      "types": "./gtk4layershell-1.0.d.ts",
+      "import": "./gtk4layershell-1.0.js",
+      "default": "./gtk4layershell-1.0.js"
+    },
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./index.js",
+      "default": "./index.js"
+    }
+  },
+  "scripts": {
+    "test": "tsc --project tsconfig.json"
+  },
+  "dependencies": {
+    "@girs/cairo-1.0": "^1.0.0-4.0.0-beta.16",
+    "@girs/freetype2-2.0": "^2.0.0-4.0.0-beta.16",
+    "@girs/gdk-4.0": "^4.0.0-4.0.0-beta.16",
+    "@girs/gdkpixbuf-2.0": "^2.0.0-4.0.0-beta.16",
+    "@girs/gio-2.0": "^2.82.0-4.0.0-beta.16",
+    "@girs/gjs": "^4.0.0-beta.16",
+    "@girs/glib-2.0": "^2.82.0-4.0.0-beta.16",
+    "@girs/gmodule-2.0": "^2.0.0-4.0.0-beta.16",
+    "@girs/gobject-2.0": "^2.82.0-4.0.0-beta.16",
+    "@girs/graphene-1.0": "^1.0.0-4.0.0-beta.16",
+    "@girs/gsk-4.0": "^4.0.0-4.0.0-beta.16",
+    "@girs/gtk-4.0": "^4.15.5-4.0.0-beta.16",
+    "@girs/harfbuzz-0.0": "^9.0.0-4.0.0-beta.16",
+    "@girs/pango-1.0": "^1.54.0-4.0.0-beta.16",
+    "@girs/pangocairo-1.0": "^1.0.0-4.0.0-beta.16"
+  },
+  "devDependencies": {
+    "typescript": "*"
+  },
+  "keywords": [
+    "Gir",
+    "TypeScript",
+    "types",
+    "GObject-Introspection",
+    "GJS",
+    "Gtk4LayerShell-1.0"
+  ],
+  "author": "ts-for-gir",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gjsify/ts-for-gir.git"
+  },
+  "bugs": {
+    "url": "https://github.com/gjsify/ts-for-gir/issues"
+  },
+  "homepage": "https://github.com/gjsify/types/tree/main/gtk4layershell-1.0#readme"
+}

package/tsconfig.json

@@ -0,0 +1,23 @@
+{
+  "compilerOptions": {
+    // General settings for code interpretation
+    "target": "ESNext",
+    "module": "NodeNext",
+    "lib": ["ESNext"],
+    "types": [],
+    "experimentalDecorators": true,
+    "moduleResolution": "NodeNext",
+    "noEmit": true,
+    "noEmitOnError": false,
+    "baseUrl": "./",
+    "rootDir": ".",
+    // General settings for code generation
+    "removeComments": false,
+    "inlineSourceMap": false,
+    "inlineSources": false,
+    "newLine": "LF"
+  },
+  "include": ["./gtk4layershell-1.0.d.ts"]
+}
+
+

package/typedoc.json

@@ -0,0 +1,7 @@
+{
+    "entryPoints": ["./gtk4layershell-1.0.d.ts"],
+    "readme": "./README.md",
+    "name": "Gtk4LayerShell-1.0",
+    "tsconfig": "./tsconfig.json"
+}
+