@girs/gtef-2 5.2.0 → 5.4.0

package/README.md

@@ -4,7 +4,7 @@
 ![version](https://img.shields.io/npm/v/@girs/gtef-2)
 ![downloads/week](https://img.shields.io/npm/dw/@girs/gtef-2)
 
-GJS TypeScript type definitions for Gtef-2 using [ts-for-gir](https://github.com/gjsify/ts-for-gir) v5.2.0.
+GJS TypeScript type definitions for Gtef-2 using [ts-for-gir](https://github.com/gjsify/ts-for-gir) v5.4.0.
 
 This package contains type declarations only. It ships no runtime code, so it adds
 nothing to your program and works with any bundler or none at all.

package/gtef-2-vocabulary.d.ts

@@ -1,7 +1,7 @@
 /**
  * The GIR-derived widget VOCABULARY for Gtef-2.
  *
- * GENERATED — do not edit. Provenance: Gtef-2 — dropped empty base(s): GObject.Object GObject.InitiallyUnowned Atk.ImplementorIface
+ * GENERATED — do not edit. Provenance: Gtef-2 — dropped empty base(s): Atk.ImplementorIface
  *
  * 15 instantiable GTypes (of which 3 concrete widgets), 15 declarations, 3 enum nick unions, 2 slot candidates.
  *
@@ -28,6 +28,7 @@ import type Gio from '@girs/gio-2.0';
 import type Gtef from './gtef-2.js';
 import type Gtk from '@girs/gtk-3.0';
 import type GtkSource from '@girs/gtksource-3.0';
+import type { GInitiallyUnownedConstructOnly, GInitiallyUnownedProps, GObjectConstructOnly, GObjectProps } from '@girs/gobject-2.0/vocabulary';
 import type { GtkBoxConstructOnly, GtkBoxProps, GtkBuildableConstructOnly, GtkBuildableProps, GtkContainerConstructOnly, GtkContainerProps, GtkGridConstructOnly, GtkGridProps, GtkInfoBarConstructOnly, GtkInfoBarProps, GtkOrientableConstructOnly, GtkOrientableProps, GtkScrollableConstructOnly, GtkScrollableProps, GtkTextBufferConstructOnly, GtkTextBufferProps, GtkTextViewConstructOnly, GtkTextViewProps, GtkWidgetConstructOnly, GtkWidgetProps } from '@girs/gtk-3.0/vocabulary';
 import type { GtkSourceBufferConstructOnly, GtkSourceBufferProps, GtkSourceCompressionTypeNick, GtkSourceGutterRendererConstructOnly, GtkSourceGutterRendererProps, GtkSourceNewlineTypeNick, GtkSourceViewConstructOnly, GtkSourceViewProps } from '@girs/gtksource-3.0/vocabulary';
 
@@ -55,12 +56,12 @@ export type GtefSelectionTypeNick = 'no-selection' | 'on-same-line' | 'multiple-
 // GIR keeps them once, on the interface.
 // ---------------------------------------------------------------------------
 
-export interface GtefActionInfoCentralStoreProps {
+export interface GtefActionInfoCentralStoreProps extends GObjectProps {
 }
 /** Settable only at construction — a renderer must REBUILD, not patch. */
-export type GtefActionInfoCentralStoreConstructOnly = never;
+export type GtefActionInfoCentralStoreConstructOnly = GObjectConstructOnly;
 
-export interface GtefActionInfoStoreProps {
+export interface GtefActionInfoStoreProps extends GObjectProps {
     /**
      * The associated #GtkApplication.
      * @since 2.0
@@ -68,9 +69,9 @@ export interface GtefActionInfoStoreProps {
     application?: Gtk.Application | null;
 }
 /** Settable only at construction — a renderer must REBUILD, not patch. */
-export type GtefActionInfoStoreConstructOnly = 'application';
+export type GtefActionInfoStoreConstructOnly = GObjectConstructOnly | 'application';
 
-export interface GtefApplicationProps {
+export interface GtefApplicationProps extends GObjectProps {
     /**
      * The #GtkApplication.
      * @since 2.0
@@ -78,9 +79,9 @@ export interface GtefApplicationProps {
     application?: Gtk.Application;
 }
 /** Settable only at construction — a renderer must REBUILD, not patch. */
-export type GtefApplicationConstructOnly = 'application';
+export type GtefApplicationConstructOnly = GObjectConstructOnly | 'application';
 
-export interface GtefApplicationWindowProps {
+export interface GtefApplicationWindowProps extends GObjectProps {
     /**
      * The #GtkApplicationWindow.
      * @since 2.0
@@ -93,7 +94,7 @@ export interface GtefApplicationWindowProps {
     statusbar?: Gtk.Statusbar | null;
 }
 /** Settable only at construction — a renderer must REBUILD, not patch. */
-export type GtefApplicationWindowConstructOnly = 'application-window';
+export type GtefApplicationWindowConstructOnly = GObjectConstructOnly | 'application-window';
 
 export interface GtefBufferProps extends GtkSourceBufferProps {
     /**
@@ -105,7 +106,7 @@ export interface GtefBufferProps extends GtkSourceBufferProps {
 /** Settable only at construction — a renderer must REBUILD, not patch. */
 export type GtefBufferConstructOnly = GtkSourceBufferConstructOnly;
 
-export interface GtefFileProps {
+export interface GtefFileProps extends GObjectProps {
     /**
      * The location.
      * @since 1.0
@@ -113,9 +114,9 @@ export interface GtefFileProps {
     location?: Gio.File;
 }
 /** Settable only at construction — a renderer must REBUILD, not patch. */
-export type GtefFileConstructOnly = never;
+export type GtefFileConstructOnly = GObjectConstructOnly;
 
-export interface GtefFileLoaderProps {
+export interface GtefFileLoaderProps extends GObjectProps {
     /**
      * The #GtefBuffer to load the content into.
      * @since 1.0
@@ -143,9 +144,9 @@ export interface GtefFileLoaderProps {
     'max-size'?: bigint | number;
 }
 /** Settable only at construction — a renderer must REBUILD, not patch. */
-export type GtefFileLoaderConstructOnly = 'buffer' | 'file' | 'location';
+export type GtefFileLoaderConstructOnly = GObjectConstructOnly | 'buffer' | 'file' | 'location';
 
-export interface GtefFileMetadataProps {
+export interface GtefFileMetadataProps extends GObjectProps {
     /**
      * The #GtefFile that the metadata belong to.
      * @since 1.0
@@ -153,9 +154,9 @@ export interface GtefFileMetadataProps {
     file?: Gtef.File;
 }
 /** Settable only at construction — a renderer must REBUILD, not patch. */
-export type GtefFileMetadataConstructOnly = 'file';
+export type GtefFileMetadataConstructOnly = GObjectConstructOnly | 'file';
 
-export interface GtefFileSaverProps {
+export interface GtefFileSaverProps extends GObjectProps {
     /**
      * The #GtefBuffer to save.
      * @since 1.0
@@ -193,9 +194,9 @@ export interface GtefFileSaverProps {
     'newline-type'?: GtkSourceNewlineTypeNick | GtkSource.NewlineType;
 }
 /** Settable only at construction — a renderer must REBUILD, not patch. */
-export type GtefFileSaverConstructOnly = 'buffer' | 'file' | 'location';
+export type GtefFileSaverConstructOnly = GObjectConstructOnly | 'buffer' | 'file' | 'location';
 
-export interface GtefFoldRegionProps {
+export interface GtefFoldRegionProps extends GObjectProps {
     /**
      * The #GtkTextBuffer where the fold region is applied.
      * @since 1.0
@@ -208,7 +209,7 @@ export interface GtefFoldRegionProps {
     folded?: boolean;
 }
 /** Settable only at construction — a renderer must REBUILD, not patch. */
-export type GtefFoldRegionConstructOnly = 'buffer';
+export type GtefFoldRegionConstructOnly = GObjectConstructOnly | 'buffer';
 
 export interface GtefGutterRendererFoldsProps extends GtkSourceGutterRendererProps {
 }
@@ -220,7 +221,7 @@ export interface GtefInfoBarProps extends GtkInfoBarProps, GtkBuildableProps, Gt
 /** Settable only at construction — a renderer must REBUILD, not patch. */
 export type GtefInfoBarConstructOnly = GtkInfoBarConstructOnly | GtkBuildableConstructOnly | GtkOrientableConstructOnly;
 
-export interface GtefMenuShellProps {
+export interface GtefMenuShellProps extends GObjectProps {
     /**
      * The #GtkMenuShell.
      * @since 2.0
@@ -228,7 +229,7 @@ export interface GtefMenuShellProps {
     'menu-shell'?: Gtk.MenuShell;
 }
 /** Settable only at construction — a renderer must REBUILD, not patch. */
-export type GtefMenuShellConstructOnly = 'menu-shell';
+export type GtefMenuShellConstructOnly = GObjectConstructOnly | 'menu-shell';
 
 export interface GtefTabProps extends GtkGridProps, GtkBuildableProps, GtkOrientableProps {
 }
@@ -347,6 +348,30 @@ export const PROVENANCE: {
      * GIRs disagreeing, which is what the main emitter answers `never` for as well.
      */
     readonly unresolvedProps: readonly string[];
+    /**
+     * `c:identifier-prefixes` from the GIR, verbatim and in order — `['G']` for Gio.
+     *
+     * The C prefix a type REFERENCE needs: resolving `Gio.Icon` means producing `GIcon`,
+     * and nothing else in this package states that `Gio` spells itself `G`. Carried rather
+     * than derived because GIR carries it, and a derivation over the `DECLS` keys is wrong
+     * wherever the C prefix is not a prefix of the type NAMES: gdkx11-4.0 and gdkwayland-4.0
+     * both state `Gdk` while every key they declare begins `GdkX11`/`GdkWayland`.
+     *
+     * Empty where the GIR states none — 17 of the 627 emitting namespaces — because
+     * inventing the namespace name there is a confident wrong answer in place of a missing
+     * one. A LIST because 20 of them state more than one, which no single string expresses.
+     */
+    readonly identifierPrefixes: readonly string[];
+    /**
+     * Sibling vocabularies this one's DECLARATIONS come from, as import specifiers.
+     *
+     * A chain link with no `OWN_PROPS` row is ambiguous on its own — `GtkSeparator` has no
+     * settable property, `GApplication` has its properties in another package — and this
+     * list is what tells the two apart. Enum and bitfield NUMBERS are not here: those are
+     * carried in this file, because a `PROP_ENUMS` row naming a foreign GType gives a
+     * consumer nothing to load and a `.ui` file using the property never names its owner.
+     */
+    readonly requiredVocabularies: readonly string[];
 };
 
 /** Declaration GType -> its own settable properties, as GObject registered them. */
@@ -456,6 +481,19 @@ export const FLAG_VALUES_UNREADABLE: Readonly<Record<string, string>>;
  */
 export const PROP_ENUMS: Readonly<Record<string, string>>;
 
+/**
+ * `<declaration GType>.<property>` -> the GType of that property's own type.
+ *
+ * `PROP_ENUMS` one case wider, and separate on purpose: that table promises the GType it names
+ * has NUMBERS, and this one promises only that the GType is the property's. A host inferring a
+ * type from a property — the middle of an uncast lookup chain, an uncast closure's return type —
+ * reads this one; a host resolving a nick to a number reads that one.
+ *
+ * Absent means no GType can be stated, not that the property is scalar: `gchararray` is carried
+ * like any other, so absence is readable as "unknown".
+ */
+export const PROP_TYPES: Readonly<Record<string, string>>;
+
 /**
  * The kinds of value a GTK accessible property, relation or state takes.
  *

package/gtef-2-vocabulary.js

@@ -1,6 +1,6 @@
 // The widget vocabulary of Gtef-2 as runtime data.
 //
-// GENERATED — do not edit. Provenance: Gtef-2 — dropped empty base(s): GObject.Object GObject.InitiallyUnowned Atk.ImplementorIface
+// GENERATED — do not edit. Provenance: Gtef-2 — dropped empty base(s): Atk.ImplementorIface
 //
 // 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
@@ -11,10 +11,12 @@ export const PROVENANCE = {
     version: '2',
     libraryVersion: null,
     childHolders: 0,
-    droppedBases: ['GObject.Object', 'GObject.InitiallyUnowned', 'Atk.ImplementorIface'],
+    droppedBases: ['Atk.ImplementorIface'],
     inlinedBases: [],
     unsettableProps: [],
     unresolvedProps: [],
+    identifierPrefixes: ['Gtef'],
+    requiredVocabularies: ['@girs/gobject-2.0/vocabulary', '@girs/gtk-3.0/vocabulary', '@girs/gtksource-3.0/vocabulary'],
 };
 
 export const OWN_PROPS = {
@@ -43,21 +45,21 @@ export const OWN_SIGNALS = {
 // `GtkEventController*` and `GtkCellRenderer*`. Use `Widgets` and `CHILD_HOLDERS`
 // below for the narrower questions; they did not move.
 export const DECLS = {
-    GtefActionInfoCentralStore: ['GtefActionInfoCentralStore'],
-    GtefActionInfoStore: ['GtefActionInfoStore'],
-    GtefApplication: ['GtefApplication'],
-    GtefApplicationWindow: ['GtefApplicationWindow'],
-    GtefBuffer: ['GtefBuffer', 'GtkSourceBuffer', 'GtkTextBuffer'],
-    GtefFile: ['GtefFile'],
-    GtefFileLoader: ['GtefFileLoader'],
-    GtefFileMetadata: ['GtefFileMetadata'],
-    GtefFileSaver: ['GtefFileSaver'],
-    GtefFoldRegion: ['GtefFoldRegion'],
-    GtefGutterRendererFolds: ['GtefGutterRendererFolds', 'GtkSourceGutterRenderer'],
-    GtefInfoBar: ['GtefInfoBar', 'GtkInfoBar', 'GtkBox', 'GtkContainer', 'GtkWidget', 'GtkBuildable', 'GtkOrientable'],
-    GtefMenuShell: ['GtefMenuShell'],
-    GtefTab: ['GtefTab', 'GtkGrid', 'GtkContainer', 'GtkWidget', 'GtkBuildable', 'GtkOrientable'],
-    GtefView: ['GtefView', 'GtkSourceView', 'GtkTextView', 'GtkContainer', 'GtkWidget', 'GtkBuildable', 'GtkScrollable'],
+    GtefActionInfoCentralStore: ['GtefActionInfoCentralStore', 'GObject'],
+    GtefActionInfoStore: ['GtefActionInfoStore', 'GObject'],
+    GtefApplication: ['GtefApplication', 'GObject'],
+    GtefApplicationWindow: ['GtefApplicationWindow', 'GObject'],
+    GtefBuffer: ['GtefBuffer', 'GtkSourceBuffer', 'GtkTextBuffer', 'GObject'],
+    GtefFile: ['GtefFile', 'GObject'],
+    GtefFileLoader: ['GtefFileLoader', 'GObject'],
+    GtefFileMetadata: ['GtefFileMetadata', 'GObject'],
+    GtefFileSaver: ['GtefFileSaver', 'GObject'],
+    GtefFoldRegion: ['GtefFoldRegion', 'GObject'],
+    GtefGutterRendererFolds: ['GtefGutterRendererFolds', 'GtkSourceGutterRenderer', 'GInitiallyUnowned', 'GObject'],
+    GtefInfoBar: ['GtefInfoBar', 'GtkInfoBar', 'GtkBox', 'GtkContainer', 'GtkWidget', 'GInitiallyUnowned', 'GObject', 'GtkBuildable', 'GtkOrientable'],
+    GtefMenuShell: ['GtefMenuShell', 'GObject'],
+    GtefTab: ['GtefTab', 'GtkGrid', 'GtkContainer', 'GtkWidget', 'GInitiallyUnowned', 'GObject', 'GtkBuildable', 'GtkOrientable'],
+    GtefView: ['GtefView', 'GtkSourceView', 'GtkTextView', 'GtkContainer', 'GtkWidget', 'GInitiallyUnowned', 'GObject', 'GtkBuildable', 'GtkScrollable'],
 };
 
 // The GTypes above that ARE widgets are the `Widgets` map in the sibling `.d.ts`; these
@@ -71,6 +73,8 @@ export const ENUM_NICKS = {
     GtefCompressionType: ['none', 'gzip'],
     GtefNewlineType: ['lf', 'cr', 'cr-lf'],
     GtefSelectionType: ['no-selection', 'on-same-line', 'multiple-lines'],
+    GtkSourceCompressionType: ['none', 'gzip'],
+    GtkSourceNewlineType: ['lf', 'cr', 'cr-lf'],
 };
 
 // The number behind each of those nicks, read from GIR's own `value` attribute.
@@ -96,6 +100,11 @@ export const ENUM_VALUES = {
     'GtefSelectionType.multiple-lines': 2,
     'GtefSelectionType.no-selection': 0,
     'GtefSelectionType.on-same-line': 1,
+    'GtkSourceCompressionType.gzip': 1,
+    'GtkSourceCompressionType.none': 0,
+    'GtkSourceNewlineType.cr': 1,
+    'GtkSourceNewlineType.cr-lf': 2,
+    'GtkSourceNewlineType.lf': 0,
 };
 
 // The nicks GIR marks `deprecated="1"`.
@@ -170,6 +179,40 @@ export const PROP_ENUMS = {
     'GtefFileSaver.newline-type': 'GtkSourceNewlineType',
 };
 
+// `<declaration GType>.<property>` -> the GType of that property's own type.
+//
+// `PROP_ENUMS` one case wider, and a SEPARATE table on purpose. That one is a join with a
+// contract — the GType it names has numbers, in this vocabulary or the owner's — and folding a
+// plain type table in would mix "resolvable to numbers" with "not" and hand the distinction to
+// the consumer. `ARIA_VALUE_ENUMS` beside `ARIA_VALUE_TYPES` is the same split.
+//
+// A row is ABSENT where no GType can be stated: a fundamental spelling outside the generator's
+// closed map, a registered type with no `glib:type-name`, or a property with no `<type>`
+// child. Absence therefore reads as "unknown" and never as "scalar".
+export const PROP_TYPES = {
+    'GtefActionInfoStore.application': 'GtkApplication',
+    'GtefApplication.application': 'GtkApplication',
+    'GtefApplicationWindow.application-window': 'GtkApplicationWindow',
+    'GtefApplicationWindow.statusbar': 'GtkStatusbar',
+    'GtefBuffer.gtef-style-scheme-id': 'gchararray',
+    'GtefFile.location': 'GFile',
+    'GtefFileLoader.buffer': 'GtefBuffer',
+    'GtefFileLoader.chunk-size': 'gint64',
+    'GtefFileLoader.file': 'GtefFile',
+    'GtefFileLoader.location': 'GFile',
+    'GtefFileLoader.max-size': 'gint64',
+    'GtefFileMetadata.file': 'GtefFile',
+    'GtefFileSaver.buffer': 'GtkSourceBuffer',
+    'GtefFileSaver.compression-type': 'GtkSourceCompressionType',
+    'GtefFileSaver.file': 'GtefFile',
+    'GtefFileSaver.flags': 'GtefFileSaverFlags',
+    'GtefFileSaver.location': 'GFile',
+    'GtefFileSaver.newline-type': 'GtkSourceNewlineType',
+    'GtefFoldRegion.buffer': 'GtkTextBuffer',
+    'GtefFoldRegion.folded': 'gboolean',
+    'GtefMenuShell.menu-shell': 'GtkMenuShell',
+};
+
 // `<enum GType>.<nick>` -> the kind of value that ARIA slot takes.
 //
 // The one table here that is not about a ParamSpec. A GtkBuilder or Blueprint

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@girs/gtef-2",
-    "version": "5.2.0",
+    "version": "5.4.0",
     "description": "GJS TypeScript type definitions for Gtef-2",
     "type": "module",
     "module": "gtef-2.js",
@@ -36,21 +36,21 @@
       "test": "tsc --project tsconfig.json"
     },
     "dependencies": {
-      "@girs/gjs": "^5.2.0",
-      "@girs/gtksource-3.0": "^5.2.0",
-      "@girs/gtk-3.0": "^5.2.0",
-      "@girs/xlib-2.0": "^5.2.0",
-      "@girs/gdk-3.0": "^5.2.0",
-      "@girs/cairo-1.0": "^5.2.0",
-      "@girs/gobject-2.0": "^5.2.0",
-      "@girs/glib-2.0": "^5.2.0",
-      "@girs/pango-1.0": "^5.2.0",
-      "@girs/harfbuzz-0.0": "^5.2.0",
-      "@girs/freetype2-2.0": "^5.2.0",
-      "@girs/gio-2.0": "^5.2.0",
-      "@girs/gmodule-2.0": "^5.2.0",
-      "@girs/gdkpixbuf-2.0": "^5.2.0",
-      "@girs/atk-1.0": "^5.2.0"    },
+      "@girs/gjs": "^5.4.0",
+      "@girs/gtksource-3.0": "^5.4.0",
+      "@girs/gtk-3.0": "^5.4.0",
+      "@girs/xlib-2.0": "^5.4.0",
+      "@girs/gdk-3.0": "^5.4.0",
+      "@girs/cairo-1.0": "^5.4.0",
+      "@girs/gobject-2.0": "^5.4.0",
+      "@girs/glib-2.0": "^5.4.0",
+      "@girs/pango-1.0": "^5.4.0",
+      "@girs/harfbuzz-0.0": "^5.4.0",
+      "@girs/freetype2-2.0": "^5.4.0",
+      "@girs/gio-2.0": "^5.4.0",
+      "@girs/gmodule-2.0": "^5.4.0",
+      "@girs/gdkpixbuf-2.0": "^5.4.0",
+      "@girs/atk-1.0": "^5.4.0"    },
     "devDependencies": {
       "typescript": "*"
     },