@girs/foundrygtk-1 5.2.0 → 5.4.0

package/README.md

@@ -4,7 +4,7 @@
 ![version](https://img.shields.io/npm/v/@girs/foundrygtk-1)
 ![downloads/week](https://img.shields.io/npm/dw/@girs/foundrygtk-1)
 
-GJS TypeScript type definitions for FoundryGtk-1 using [ts-for-gir](https://github.com/gjsify/ts-for-gir) v5.2.0.
+GJS TypeScript type definitions for FoundryGtk-1 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/foundrygtk-1-vocabulary.d.ts

@@ -1,9 +1,9 @@
 /**
  * The GIR-derived widget VOCABULARY for FoundryGtk-1.
  *
- * GENERATED — do not edit. Provenance: FoundryGtk-1 — dropped empty base(s): GObject.InitiallyUnowned GObject.Object Gio.MenuModel Gio.ListModel Foundry.Service Json.Serializable — inlined base(s) their owner's vocabulary does not emit: Foundry.Contextual Foundry.TextBuffer
+ * GENERATED — do not edit. Provenance: FoundryGtk-1 — dropped empty base(s): Json.Serializable
  *
- * 14 instantiable GTypes (of which 6 concrete widgets), 16 declarations (2 inlined from a namespace whose vocabulary does not emit them), 0 enum nick unions, 0 slot candidates.
+ * 14 instantiable GTypes (of which 6 concrete widgets), 14 declarations, 0 enum nick unions, 0 slot candidates.
  *
  * Module-scoped exports only. There is no `JSX` namespace here, no tag spelling and
  * no `on<Signal>` prop name: those are DIALECT, and every framework answers them
@@ -28,6 +28,9 @@ import type Foundry from '@girs/foundry-1';
 import type FoundryGtk from './foundrygtk-1.js';
 import type Gio from '@girs/gio-2.0';
 import type Pango from '@girs/pango-1.0';
+import type { FoundryContextualConstructOnly, FoundryContextualProps, FoundryServiceConstructOnly, FoundryServiceProps, FoundryTextBufferConstructOnly, FoundryTextBufferProps } from '@girs/foundry-1/vocabulary';
+import type { GListModelConstructOnly, GListModelProps, GMenuModelConstructOnly, GMenuModelProps } from '@girs/gio-2.0/vocabulary';
+import type { GInitiallyUnownedConstructOnly, GInitiallyUnownedProps, GObjectConstructOnly, GObjectProps } from '@girs/gobject-2.0/vocabulary';
 import type { GtkAccessibleConstructOnly, GtkAccessibleProps, GtkAccessibleTextConstructOnly, GtkAccessibleTextProps, GtkBuildableConstructOnly, GtkBuildableProps, GtkConstraintTargetConstructOnly, GtkConstraintTargetProps, GtkScrollableConstructOnly, GtkScrollableProps, GtkTextBufferConstructOnly, GtkTextBufferProps, GtkTextViewConstructOnly, GtkTextViewProps, GtkWidgetConstructOnly, GtkWidgetProps } from '@girs/gtk-4.0/vocabulary';
 import type { GtkSourceBufferConstructOnly, GtkSourceBufferProps, GtkSourceGutterRendererConstructOnly, GtkSourceGutterRendererProps, GtkSourceViewConstructOnly, GtkSourceViewProps } from '@girs/gtksource-5/vocabulary';
 
@@ -60,13 +63,6 @@ export interface FoundryChangesGutterRendererProps extends GtkSourceGutterRender
 /** Settable only at construction — a renderer must REBUILD, not patch. */
 export type FoundryChangesGutterRendererConstructOnly = GtkSourceGutterRendererConstructOnly | GtkAccessibleConstructOnly | GtkBuildableConstructOnly | GtkConstraintTargetConstructOnly;
 
-/** Abstract base class for objects that are associated with a Foundry context. */
-export interface FoundryContextualProps {
-    context?: Foundry.Context;
-}
-/** Settable only at construction — a renderer must REBUILD, not patch. */
-export type FoundryContextualConstructOnly = 'context';
-
 export interface FoundryDiagnosticsGutterRendererProps extends GtkSourceGutterRendererProps, GtkAccessibleProps, GtkBuildableProps, GtkConstraintTargetProps {
     diagnostics?: Foundry.OnTypeDiagnostics;
 }
@@ -90,33 +86,33 @@ export interface FoundryMarkupViewProps extends GtkWidgetProps, GtkAccessiblePro
 export type FoundryMarkupViewConstructOnly = GtkWidgetConstructOnly | GtkAccessibleConstructOnly | GtkBuildableConstructOnly | GtkConstraintTargetConstructOnly;
 
 /** The goal of #FoundryMenuManager is to simplify the process of merging multiple GtkBuilder .ui files containing menus into a single representation of the application menus. */
-export interface FoundryMenuManagerProps {
+export interface FoundryMenuManagerProps extends GObjectProps {
 }
 /** Settable only at construction — a renderer must REBUILD, not patch. */
-export type FoundryMenuManagerConstructOnly = never;
+export type FoundryMenuManagerConstructOnly = GObjectConstructOnly;
 
-export interface FoundryMenuProxyProps {
+export interface FoundryMenuProxyProps extends GMenuModelProps {
     /** @default NULL */
     'menu-id'?: string;
 }
 /** Settable only at construction — a renderer must REBUILD, not patch. */
-export type FoundryMenuProxyConstructOnly = never;
+export type FoundryMenuProxyConstructOnly = GMenuModelConstructOnly;
 
-export interface FoundryShortcutBundleProps {
+export interface FoundryShortcutBundleProps extends GObjectProps, GListModelProps {
 }
 /** Settable only at construction — a renderer must REBUILD, not patch. */
-export type FoundryShortcutBundleConstructOnly = never;
+export type FoundryShortcutBundleConstructOnly = GObjectConstructOnly | GListModelConstructOnly;
 
-export interface FoundryShortcutManagerProps {
+export interface FoundryShortcutManagerProps extends FoundryServiceProps, GListModelProps {
 }
 /** Settable only at construction — a renderer must REBUILD, not patch. */
-export type FoundryShortcutManagerConstructOnly = never;
+export type FoundryShortcutManagerConstructOnly = FoundryServiceConstructOnly | GListModelConstructOnly;
 
-export interface FoundryShortcutObserverProps {
+export interface FoundryShortcutObserverProps extends GObjectProps {
     model?: Gio.ListModel;
 }
 /** Settable only at construction — a renderer must REBUILD, not patch. */
-export type FoundryShortcutObserverConstructOnly = 'model';
+export type FoundryShortcutObserverConstructOnly = GObjectConstructOnly | 'model';
 
 export interface FoundrySourceBufferProps extends GtkSourceBufferProps, FoundryTextBufferProps {
     context?: Foundry.Context;
@@ -166,21 +162,15 @@ export interface FoundryTerminalProps extends GtkWidgetProps, GtkAccessibleProps
 /** Settable only at construction — a renderer must REBUILD, not patch. */
 export type FoundryTerminalConstructOnly = GtkWidgetConstructOnly | GtkAccessibleConstructOnly | GtkAccessibleTextConstructOnly | GtkBuildableConstructOnly | GtkConstraintTargetConstructOnly | GtkScrollableConstructOnly;
 
-export interface FoundryTerminalPaletteProps {
+export interface FoundryTerminalPaletteProps extends GObjectProps {
 }
 /** Settable only at construction — a renderer must REBUILD, not patch. */
-export type FoundryTerminalPaletteConstructOnly = never;
+export type FoundryTerminalPaletteConstructOnly = GObjectConstructOnly;
 
-export interface FoundryTerminalPaletteSetProps {
+export interface FoundryTerminalPaletteSetProps extends GObjectProps {
 }
 /** Settable only at construction — a renderer must REBUILD, not patch. */
-export type FoundryTerminalPaletteSetConstructOnly = never;
-
-export interface FoundryTextBufferProps {
-    context?: Foundry.Context;
-}
-/** Settable only at construction — a renderer must REBUILD, not patch. */
-export type FoundryTextBufferConstructOnly = 'context';
+export type FoundryTerminalPaletteSetConstructOnly = GObjectConstructOnly;
 
 // ---------------------------------------------------------------------------
 // The GType-keyed widget map.
@@ -306,6 +296,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. */
@@ -415,6 +429,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/foundrygtk-1-vocabulary.js

@@ -1,6 +1,6 @@
 // The widget vocabulary of FoundryGtk-1 as runtime data.
 //
-// GENERATED — do not edit. Provenance: FoundryGtk-1 — dropped empty base(s): GObject.InitiallyUnowned GObject.Object Gio.MenuModel Gio.ListModel Foundry.Service Json.Serializable — inlined base(s) their owner's vocabulary does not emit: Foundry.Contextual Foundry.TextBuffer
+// GENERATED — do not edit. Provenance: FoundryGtk-1 — dropped empty base(s): Json.Serializable
 //
 // 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,15 +11,16 @@ export const PROVENANCE = {
     version: '1',
     libraryVersion: null,
     childHolders: 0,
-    droppedBases: ['GObject.InitiallyUnowned', 'GObject.Object', 'Gio.MenuModel', 'Gio.ListModel', 'Foundry.Service', 'Json.Serializable'],
-    inlinedBases: ['Foundry.Contextual', 'Foundry.TextBuffer'],
+    droppedBases: ['Json.Serializable'],
+    inlinedBases: [],
     unsettableProps: [],
     unresolvedProps: [],
+    identifierPrefixes: ['Foundry'],
+    requiredVocabularies: ['@girs/foundry-1/vocabulary', '@girs/gio-2.0/vocabulary', '@girs/gobject-2.0/vocabulary', '@girs/gtk-4.0/vocabulary', '@girs/gtksource-5/vocabulary'],
 };
 
 export const OWN_PROPS = {
     FoundryChangesGutterRenderer: ['show-overview'],
-    FoundryContextual: ['context'],
     FoundryDiagnosticsGutterRenderer: ['diagnostics'],
     FoundryGitLanes: ['entry'],
     FoundryMenuProxy: ['menu-id'],
@@ -27,7 +28,6 @@ export const OWN_PROPS = {
     FoundrySourceBuffer: ['context', 'override-syntax'],
     FoundrySourceView: ['document', 'enable-completion', 'enable-vim', 'font', 'line-height', 'show-diagnostics', 'show-line-changes', 'show-line-changes-overview'],
     FoundryTerminal: ['palette'],
-    FoundryTextBuffer: ['context'],
 };
 
 export const OWN_SIGNALS = {
@@ -42,20 +42,20 @@ export const OWN_SIGNALS = {
 // `GtkEventController*` and `GtkCellRenderer*`. Use `Widgets` and `CHILD_HOLDERS`
 // below for the narrower questions; they did not move.
 export const DECLS = {
-    FoundryChangesGutterRenderer: ['FoundryChangesGutterRenderer', 'GtkSourceGutterRenderer', 'GtkWidget', 'GtkAccessible', 'GtkBuildable', 'GtkConstraintTarget'],
-    FoundryDiagnosticsGutterRenderer: ['FoundryDiagnosticsGutterRenderer', 'GtkSourceGutterRenderer', 'GtkWidget', 'GtkAccessible', 'GtkBuildable', 'GtkConstraintTarget'],
-    FoundryGitLanes: ['FoundryGitLanes', 'GtkWidget', 'GtkAccessible', 'GtkBuildable', 'GtkConstraintTarget'],
-    FoundryMarkupView: ['FoundryMarkupView', 'GtkWidget', 'GtkAccessible', 'GtkBuildable', 'GtkConstraintTarget'],
-    FoundryMenuManager: ['FoundryMenuManager'],
-    FoundryMenuProxy: ['FoundryMenuProxy'],
-    FoundryShortcutBundle: ['FoundryShortcutBundle'],
-    FoundryShortcutManager: ['FoundryShortcutManager', 'FoundryContextual'],
-    FoundryShortcutObserver: ['FoundryShortcutObserver'],
-    FoundrySourceBuffer: ['FoundrySourceBuffer', 'GtkSourceBuffer', 'GtkTextBuffer', 'FoundryTextBuffer'],
-    FoundrySourceView: ['FoundrySourceView', 'GtkSourceView', 'GtkTextView', 'GtkWidget', 'GtkAccessible', 'GtkAccessibleText', 'GtkBuildable', 'GtkConstraintTarget', 'GtkScrollable'],
-    FoundryTerminal: ['FoundryTerminal', 'GtkWidget', 'GtkAccessible', 'GtkAccessibleText', 'GtkBuildable', 'GtkConstraintTarget', 'GtkScrollable'],
-    FoundryTerminalPalette: ['FoundryTerminalPalette'],
-    FoundryTerminalPaletteSet: ['FoundryTerminalPaletteSet'],
+    FoundryChangesGutterRenderer: ['FoundryChangesGutterRenderer', 'GtkSourceGutterRenderer', 'GtkWidget', 'GInitiallyUnowned', 'GObject', 'GtkAccessible', 'GtkBuildable', 'GtkConstraintTarget'],
+    FoundryDiagnosticsGutterRenderer: ['FoundryDiagnosticsGutterRenderer', 'GtkSourceGutterRenderer', 'GtkWidget', 'GInitiallyUnowned', 'GObject', 'GtkAccessible', 'GtkBuildable', 'GtkConstraintTarget'],
+    FoundryGitLanes: ['FoundryGitLanes', 'GtkWidget', 'GInitiallyUnowned', 'GObject', 'GtkAccessible', 'GtkBuildable', 'GtkConstraintTarget'],
+    FoundryMarkupView: ['FoundryMarkupView', 'GtkWidget', 'GInitiallyUnowned', 'GObject', 'GtkAccessible', 'GtkBuildable', 'GtkConstraintTarget'],
+    FoundryMenuManager: ['FoundryMenuManager', 'GObject'],
+    FoundryMenuProxy: ['FoundryMenuProxy', 'GMenuModel', 'GObject'],
+    FoundryShortcutBundle: ['FoundryShortcutBundle', 'GObject', 'GListModel'],
+    FoundryShortcutManager: ['FoundryShortcutManager', 'FoundryService', 'FoundryContextual', 'GObject', 'GListModel'],
+    FoundryShortcutObserver: ['FoundryShortcutObserver', 'GObject'],
+    FoundrySourceBuffer: ['FoundrySourceBuffer', 'GtkSourceBuffer', 'GtkTextBuffer', 'GObject', 'FoundryTextBuffer'],
+    FoundrySourceView: ['FoundrySourceView', 'GtkSourceView', 'GtkTextView', 'GtkWidget', 'GInitiallyUnowned', 'GObject', 'GtkAccessible', 'GtkAccessibleText', 'GtkBuildable', 'GtkConstraintTarget', 'GtkScrollable'],
+    FoundryTerminal: ['FoundryTerminal', 'GtkWidget', 'GInitiallyUnowned', 'GObject', 'GtkAccessible', 'GtkAccessibleText', 'GtkBuildable', 'GtkConstraintTarget', 'GtkScrollable'],
+    FoundryTerminalPalette: ['FoundryTerminalPalette', 'GObject'],
+    FoundryTerminalPaletteSet: ['FoundryTerminalPaletteSet', 'GObject'],
 };
 
 // The GTypes above that ARE widgets are the `Widgets` map in the sibling `.d.ts`; these
@@ -141,6 +141,34 @@ export const FLAG_VALUES_UNREADABLE = {};
 // vocabulary loaded too. Owners that emit none (Gdk, Pango) are inlined into the tables above.
 export const PROP_ENUMS = {};
 
+// `<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 = {
+    'FoundryChangesGutterRenderer.show-overview': 'gboolean',
+    'FoundryDiagnosticsGutterRenderer.diagnostics': 'FoundryOnTypeDiagnostics',
+    'FoundryGitLanes.entry': 'FoundryVcsGraphEntry',
+    'FoundryMenuProxy.menu-id': 'gchararray',
+    'FoundryShortcutObserver.model': 'GListModel',
+    'FoundrySourceBuffer.context': 'FoundryContext',
+    'FoundrySourceBuffer.override-syntax': 'gchararray',
+    'FoundrySourceView.document': 'FoundryTextDocument',
+    'FoundrySourceView.enable-completion': 'gboolean',
+    'FoundrySourceView.enable-vim': 'gboolean',
+    'FoundrySourceView.line-height': 'gdouble',
+    'FoundrySourceView.show-diagnostics': 'gboolean',
+    'FoundrySourceView.show-line-changes': 'gboolean',
+    'FoundrySourceView.show-line-changes-overview': 'gboolean',
+    'FoundryTerminal.palette': 'FoundryTerminalPalette',
+};
+
 // `<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/foundrygtk-1",
-    "version": "5.2.0",
+    "version": "5.4.0",
     "description": "GJS TypeScript type definitions for FoundryGtk-1",
     "type": "module",
     "module": "foundrygtk-1.js",
@@ -36,27 +36,27 @@
       "test": "tsc --project tsconfig.json"
     },
     "dependencies": {
-      "@girs/gjs": "^5.2.0",
-      "@girs/peas-2": "^5.2.0",
-      "@girs/gio-2.0": "^5.2.0",
-      "@girs/gobject-2.0": "^5.2.0",
-      "@girs/glib-2.0": "^5.2.0",
-      "@girs/gmodule-2.0": "^5.2.0",
-      "@girs/json-1.0": "^5.2.0",
-      "@girs/gtksource-5": "^5.2.0",
-      "@girs/gtk-4.0": "^5.2.0",
-      "@girs/gsk-4.0": "^5.2.0",
-      "@girs/graphene-1.0": "^5.2.0",
-      "@girs/gdk-4.0": "^5.2.0",
-      "@girs/cairo-1.0": "^5.2.0",
-      "@girs/pangocairo-1.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/gdkpixbuf-2.0": "^5.2.0",
-      "@girs/foundry-1": "^5.2.0",
-      "@girs/dex-1": "^5.2.0",
-      "@girs/giounix-2.0": "^5.2.0"    },
+      "@girs/gjs": "^5.4.0",
+      "@girs/peas-2": "^5.4.0",
+      "@girs/gio-2.0": "^5.4.0",
+      "@girs/gobject-2.0": "^5.4.0",
+      "@girs/glib-2.0": "^5.4.0",
+      "@girs/gmodule-2.0": "^5.4.0",
+      "@girs/json-1.0": "^5.4.0",
+      "@girs/gtksource-5": "^5.4.0",
+      "@girs/gtk-4.0": "^5.4.0",
+      "@girs/gsk-4.0": "^5.4.0",
+      "@girs/graphene-1.0": "^5.4.0",
+      "@girs/gdk-4.0": "^5.4.0",
+      "@girs/cairo-1.0": "^5.4.0",
+      "@girs/pangocairo-1.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/gdkpixbuf-2.0": "^5.4.0",
+      "@girs/foundry-1": "^5.4.0",
+      "@girs/dex-1": "^5.4.0",
+      "@girs/giounix-2.0": "^5.4.0"    },
     "devDependencies": {
       "typescript": "*"
     },