@gjsify/video 0.1.15

package/lib/types/video-bridge.d.ts

@@ -0,0 +1,496 @@
+import GObject from 'gi://GObject';
+import GLib from 'gi://GLib?version=2.0';
+import Gtk from 'gi://Gtk?version=4.0';
+import { HTMLVideoElement } from '@gjsify/dom-elements';
+import { BridgeEnvironment } from '@gjsify/bridge-types';
+type VideoReadyCallback = (video: globalThis.HTMLVideoElement) => void;
+/**
+ * A `Gtk.Box` subclass that hosts a `Gtk.Picture` for video rendering:
+ * - Creates an `HTMLVideoElement` on construction
+ * - Renders video via GStreamer `gtk4paintablesink` → `Gdk.Paintable` → `Gtk.Picture`
+ * - Supports `video.srcObject = mediaStream` (from getUserMedia/WebRTC)
+ * - Supports `video.src = "file:///..."` (URI playback via playbin)
+ * - Fires `onReady()` callbacks with the HTMLVideoElement
+ * - `installGlobals()` sets `globalThis.HTMLVideoElement`
+ *
+ * Usage:
+ * ```ts
+ * const bridge = new VideoBridge();
+ * bridge.installGlobals();
+ * bridge.onReady((video) => {
+ *     video.srcObject = mediaStream;  // from getUserMedia
+ * });
+ * window.set_child(bridge);
+ * ```
+ */
+export declare const VideoBridge: {
+    new (params?: Partial<Gtk.Box.ConstructorProps>): {
+        _picture: Gtk.Picture;
+        _video: HTMLVideoElement;
+        _pipeline: any | null;
+        _readyCallbacks: VideoReadyCallback[];
+        _resizeCallbacks: ((w: number, h: number) => void)[];
+        _environment: BridgeEnvironment;
+        _timeOrigin: number;
+        _ready: boolean;
+        /** The HTMLVideoElement backing this bridge. */
+        get element(): HTMLVideoElement;
+        /** Alias for element — matches browser naming. */
+        get videoElement(): HTMLVideoElement;
+        /** The isolated browser environment for this bridge. */
+        get environment(): BridgeEnvironment;
+        /**
+         * Register a callback to be invoked once the video element is ready.
+         * If already ready, the callback fires synchronously.
+         */
+        onReady(cb: VideoReadyCallback): void;
+        /** Register a callback invoked whenever the widget is resized. */
+        onResize(cb: (width: number, height: number) => void): void;
+        /** Sets browser globals for video support. */
+        installGlobals(): void;
+        /** @internal Handle srcObject change (MediaStream) */
+        _onSrcObjectChange(): void;
+        /** @internal Handle src change (URI) */
+        _onSrcChange(): void;
+        /** @internal Tear down the GStreamer pipeline */
+        _destroyPipeline(): void;
+        get baseline_child(): number;
+        set baseline_child(val: number);
+        get baselineChild(): number;
+        set baselineChild(val: number);
+        get baseline_position(): Gtk.BaselinePosition;
+        set baseline_position(val: Gtk.BaselinePosition);
+        get baselinePosition(): Gtk.BaselinePosition;
+        set baselinePosition(val: Gtk.BaselinePosition);
+        get homogeneous(): boolean;
+        set homogeneous(val: boolean);
+        get spacing(): number;
+        set spacing(val: number);
+        $signals: Gtk.Box.SignalSignatures;
+        _init(...args: any[]): void;
+        connect<K extends keyof Gtk.Box.SignalSignatures>(signal: K, callback: GObject.SignalCallback</*elided*/ any, Gtk.Box.SignalSignatures[K]>): number;
+        connect(signal: string, callback: (...args: any[]) => any): number;
+        connect_after<K extends keyof Gtk.Box.SignalSignatures>(signal: K, callback: GObject.SignalCallback</*elided*/ any, Gtk.Box.SignalSignatures[K]>): number;
+        connect_after(signal: string, callback: (...args: any[]) => any): number;
+        emit<K extends keyof Gtk.Box.SignalSignatures>(signal: K, ...args: GObject.GjsParameters<Gtk.Box.SignalSignatures[K]> extends [any, ...infer Q] ? Q : never): void;
+        emit(signal: string, ...args: any[]): void;
+        append(child: Gtk.Widget): void;
+        get_baseline_child(): number;
+        get_baseline_position(): Gtk.BaselinePosition;
+        get_homogeneous(): boolean;
+        get_spacing(): number;
+        insert_child_after(child: Gtk.Widget, sibling?: Gtk.Widget | null): void;
+        prepend(child: Gtk.Widget): void;
+        remove(child: Gtk.Widget): void;
+        reorder_child_after(child: Gtk.Widget, sibling?: Gtk.Widget | null): void;
+        set_baseline_child(child: number): void;
+        set_baseline_position(position: Gtk.BaselinePosition): void;
+        set_homogeneous(homogeneous: boolean): void;
+        set_spacing(spacing: number): void;
+        get accessible_role(): Gtk.AccessibleRole;
+        set accessible_role(val: Gtk.AccessibleRole);
+        get accessibleRole(): Gtk.AccessibleRole;
+        set accessibleRole(val: Gtk.AccessibleRole);
+        get orientation(): Gtk.Orientation;
+        set orientation(val: Gtk.Orientation);
+        announce(message: string, priority: Gtk.AccessibleAnnouncementPriority): void;
+        get_accessible_id(): string | null;
+        get_accessible_parent(): Gtk.Accessible | null;
+        get_accessible_role(): Gtk.AccessibleRole;
+        get_at_context(): Gtk.ATContext;
+        get_bounds(): [boolean, number, number, number, number];
+        get_first_accessible_child(): Gtk.Accessible | null;
+        get_next_accessible_sibling(): Gtk.Accessible | null;
+        get_platform_state(state: Gtk.AccessiblePlatformState): boolean;
+        reset_property(property: Gtk.AccessibleProperty): void;
+        reset_relation(relation: Gtk.AccessibleRelation): void;
+        reset_state(state: Gtk.AccessibleState): void;
+        set_accessible_parent(parent?: Gtk.Accessible | null, next_sibling?: Gtk.Accessible | null): void;
+        update_next_accessible_sibling(new_sibling?: Gtk.Accessible | null): void;
+        update_platform_state(state: Gtk.AccessiblePlatformState): void;
+        update_property(properties: Gtk.AccessibleProperty[], values: (GObject.Value | any)[]): void;
+        update_relation(relations: Gtk.AccessibleRelation[], values: (GObject.Value | any)[]): void;
+        update_state(states: Gtk.AccessibleState[], values: (GObject.Value | any)[]): void;
+        vfunc_get_accessible_id(): string | null;
+        vfunc_get_accessible_parent(): Gtk.Accessible | null;
+        vfunc_get_at_context(): Gtk.ATContext | null;
+        vfunc_get_bounds(): [boolean, number, number, number, number];
+        vfunc_get_first_accessible_child(): Gtk.Accessible | null;
+        vfunc_get_next_accessible_sibling(): Gtk.Accessible | null;
+        vfunc_get_platform_state(state: Gtk.AccessiblePlatformState): boolean;
+        get_buildable_id(): string | null;
+        vfunc_add_child(builder: Gtk.Builder, child: GObject.Object, type?: string | null): void;
+        vfunc_custom_finished(builder: Gtk.Builder, child: GObject.Object | null, tagname: string, data?: any | null): void;
+        vfunc_custom_tag_end(builder: Gtk.Builder, child: GObject.Object | null, tagname: string, data?: any | null): void;
+        vfunc_custom_tag_start(builder: Gtk.Builder, child: GObject.Object | null, tagname: string): [boolean, Gtk.BuildableParser, any];
+        vfunc_get_id(): string;
+        vfunc_get_internal_child<T = GObject.Object>(builder: Gtk.Builder, childname: string): T;
+        vfunc_parser_finished(builder: Gtk.Builder): void;
+        vfunc_set_buildable_property(builder: Gtk.Builder, name: string, value: unknown): void;
+        vfunc_set_id(id: string): void;
+        get_orientation(): Gtk.Orientation;
+        set_orientation(orientation: Gtk.Orientation): void;
+        bind_property(source_property: string, target: GObject.Object, target_property: string, flags: GObject.BindingFlags): GObject.Binding;
+        bind_property_full(source_property: string, target: GObject.Object, target_property: string, flags: GObject.BindingFlags, transform_to?: GObject.BindingTransformFunc | null, transform_from?: GObject.BindingTransformFunc | null, notify?: GLib.DestroyNotify | null): GObject.Binding;
+        bind_property_full(...args: never[]): any;
+        force_floating(): void;
+        freeze_notify(): void;
+        get_data(key: string): any | null;
+        get_property(property_name: string, value: GObject.Value | any): any;
+        get_qdata(quark: GLib.Quark): any | null;
+        getv(names: string[], values: (GObject.Value | any)[]): void;
+        is_floating(): boolean;
+        notify(property_name: string): void;
+        notify_by_pspec(pspec: GObject.ParamSpec): void;
+        ref(): GObject.Object;
+        ref_sink(): GObject.Object;
+        run_dispose(): void;
+        set_data(key: string, data?: any | null): void;
+        set_property(property_name: string, value: GObject.Value | any): void;
+        steal_data(key: string): any | null;
+        steal_qdata(quark: GLib.Quark): any | null;
+        thaw_notify(): void;
+        unref(): void;
+        watch_closure(closure: GObject.Closure): void;
+        vfunc_constructed(): void;
+        vfunc_dispatch_properties_changed(n_pspecs: number, pspecs: GObject.ParamSpec): void;
+        vfunc_dispose(): void;
+        vfunc_finalize(): void;
+        vfunc_get_property(property_id: number, value: unknown, pspec: GObject.ParamSpec): void;
+        vfunc_notify(pspec: GObject.ParamSpec): void;
+        vfunc_set_property(property_id: number, value: unknown, pspec: GObject.ParamSpec): void;
+        disconnect(id: number): void;
+        set(properties: {
+            [key: string]: any;
+        }): void;
+        block_signal_handler(id: number): void;
+        unblock_signal_handler(id: number): void;
+        stop_emission_by_name(detailedName: string): void;
+        get can_focus(): boolean;
+        set can_focus(val: boolean);
+        get canFocus(): boolean;
+        set canFocus(val: boolean);
+        get can_target(): boolean;
+        set can_target(val: boolean);
+        get canTarget(): boolean;
+        set canTarget(val: boolean);
+        get css_classes(): string[];
+        set css_classes(val: string[]);
+        get cssClasses(): string[];
+        set cssClasses(val: string[]);
+        get css_name(): string;
+        get cssName(): string;
+        get cursor(): import("@girs/gdk-4.0").default.Cursor;
+        set cursor(val: import("@girs/gdk-4.0").default.Cursor);
+        get focus_on_click(): boolean;
+        set focus_on_click(val: boolean);
+        get focusOnClick(): boolean;
+        set focusOnClick(val: boolean);
+        get focusable(): boolean;
+        set focusable(val: boolean);
+        get halign(): Gtk.Align;
+        set halign(val: Gtk.Align);
+        get has_default(): boolean;
+        get hasDefault(): boolean;
+        get has_focus(): boolean;
+        get hasFocus(): boolean;
+        get has_tooltip(): boolean;
+        set has_tooltip(val: boolean);
+        get hasTooltip(): boolean;
+        set hasTooltip(val: boolean);
+        get height_request(): number;
+        set height_request(val: number);
+        get heightRequest(): number;
+        set heightRequest(val: number);
+        get hexpand(): boolean;
+        set hexpand(val: boolean);
+        get hexpand_set(): boolean;
+        set hexpand_set(val: boolean);
+        get hexpandSet(): boolean;
+        set hexpandSet(val: boolean);
+        get layout_manager(): Gtk.LayoutManager;
+        set layout_manager(val: Gtk.LayoutManager);
+        get layoutManager(): Gtk.LayoutManager;
+        set layoutManager(val: Gtk.LayoutManager);
+        get limit_events(): boolean;
+        set limit_events(val: boolean);
+        get limitEvents(): boolean;
+        set limitEvents(val: boolean);
+        get margin_bottom(): number;
+        set margin_bottom(val: number);
+        get marginBottom(): number;
+        set marginBottom(val: number);
+        get margin_end(): number;
+        set margin_end(val: number);
+        get marginEnd(): number;
+        set marginEnd(val: number);
+        get margin_start(): number;
+        set margin_start(val: number);
+        get marginStart(): number;
+        set marginStart(val: number);
+        get margin_top(): number;
+        set margin_top(val: number);
+        get marginTop(): number;
+        set marginTop(val: number);
+        get name(): string;
+        set name(val: string);
+        get opacity(): number;
+        set opacity(val: number);
+        get overflow(): Gtk.Overflow;
+        set overflow(val: Gtk.Overflow);
+        get parent(): Gtk.Widget;
+        get receives_default(): boolean;
+        set receives_default(val: boolean);
+        get receivesDefault(): boolean;
+        set receivesDefault(val: boolean);
+        get root(): Gtk.Root;
+        get scale_factor(): number;
+        get scaleFactor(): number;
+        get sensitive(): boolean;
+        set sensitive(val: boolean);
+        get tooltip_markup(): string;
+        set tooltip_markup(val: string);
+        get tooltipMarkup(): string;
+        set tooltipMarkup(val: string);
+        get tooltip_text(): string;
+        set tooltip_text(val: string);
+        get tooltipText(): string;
+        set tooltipText(val: string);
+        get valign(): Gtk.Align;
+        set valign(val: Gtk.Align);
+        get vexpand(): boolean;
+        set vexpand(val: boolean);
+        get vexpand_set(): boolean;
+        set vexpand_set(val: boolean);
+        get vexpandSet(): boolean;
+        set vexpandSet(val: boolean);
+        get visible(): boolean;
+        set visible(val: boolean);
+        get width_request(): number;
+        set width_request(val: number);
+        get widthRequest(): number;
+        set widthRequest(val: number);
+        vfunc_compute_expand(hexpand_p: boolean, vexpand_p: boolean): void;
+        vfunc_contains(x: number, y: number): boolean;
+        vfunc_css_changed(change: Gtk.CssStyleChange): void;
+        vfunc_direction_changed(previous_direction: Gtk.TextDirection): void;
+        vfunc_focus(direction: Gtk.DirectionType): boolean;
+        vfunc_get_request_mode(): Gtk.SizeRequestMode;
+        vfunc_grab_focus(): boolean;
+        vfunc_hide(): void;
+        vfunc_keynav_failed(direction: Gtk.DirectionType): boolean;
+        vfunc_map(): void;
+        vfunc_measure(orientation: Gtk.Orientation, for_size: number): [number, number, number, number];
+        vfunc_mnemonic_activate(group_cycling: boolean): boolean;
+        vfunc_move_focus(direction: Gtk.DirectionType): void;
+        vfunc_query_tooltip(x: number, y: number, keyboard_tooltip: boolean, tooltip: Gtk.Tooltip): boolean;
+        vfunc_realize(): void;
+        vfunc_root(): void;
+        vfunc_set_focus_child(child?: Gtk.Widget | null): void;
+        vfunc_show(): void;
+        vfunc_size_allocate(width: number, height: number, baseline: number): void;
+        vfunc_snapshot(snapshot: Gtk.Snapshot): void;
+        vfunc_state_flags_changed(previous_state_flags: Gtk.StateFlags): void;
+        vfunc_system_setting_changed(settings: Gtk.SystemSetting): void;
+        vfunc_unmap(): void;
+        vfunc_unrealize(): void;
+        vfunc_unroot(): void;
+        action_set_enabled(action_name: string, enabled: boolean): void;
+        activate(): boolean;
+        activate_action(name: string, args?: GLib.Variant | null): boolean;
+        activate_default(): void;
+        add_controller(controller: Gtk.EventController): void;
+        add_css_class(css_class: string): void;
+        add_mnemonic_label(label: Gtk.Widget): void;
+        add_tick_callback(callback: Gtk.TickCallback): number;
+        allocate(width: number, height: number, baseline: number, transform?: import("@girs/gsk-4.0").default.Transform | null): void;
+        child_focus(direction: Gtk.DirectionType): boolean;
+        compute_bounds(target: Gtk.Widget): [boolean, import("@girs/graphene-1.0").default.Rect];
+        compute_expand(orientation: Gtk.Orientation): boolean;
+        compute_point(target: Gtk.Widget, point: import("@girs/graphene-1.0").default.Point): [boolean, import("@girs/graphene-1.0").default.Point];
+        compute_transform(target: Gtk.Widget): [boolean, import("@girs/graphene-1.0").default.Matrix];
+        contains(x: number, y: number): boolean;
+        create_pango_context(): import("@girs/pango-1.0").default.Context;
+        create_pango_layout(text?: string | null): import("@girs/pango-1.0").default.Layout;
+        dispose_template(widget_type: GObject.GType): void;
+        drag_check_threshold(start_x: number, start_y: number, current_x: number, current_y: number): boolean;
+        error_bell(): void;
+        get_allocated_baseline(): number;
+        get_allocated_height(): number;
+        get_allocated_width(): number;
+        get_allocation(): Gtk.Allocation;
+        get_ancestor(widget_type: GObject.GType): Gtk.Widget | null;
+        get_baseline(): number;
+        get_can_focus(): boolean;
+        get_can_target(): boolean;
+        get_child_visible(): boolean;
+        get_clipboard(): import("@girs/gdk-4.0").default.Clipboard;
+        get_color(): import("@girs/gdk-4.0").default.RGBA;
+        get_css_classes(): string[];
+        get_css_name(): string;
+        get_cursor(): import("@girs/gdk-4.0").default.Cursor | null;
+        get_direction(): Gtk.TextDirection;
+        get_display(): import("@girs/gdk-4.0").default.Display;
+        get_first_child(): Gtk.Widget | null;
+        get_focus_child(): Gtk.Widget | null;
+        get_focus_on_click(): boolean;
+        get_focusable(): boolean;
+        get_font_map(): import("@girs/pango-1.0").default.FontMap | null;
+        get_font_options(): import("@girs/gjs/cairo").default.FontOptions | null;
+        get_frame_clock(): import("@girs/gdk-4.0").default.FrameClock | null;
+        get_halign(): Gtk.Align;
+        get_has_tooltip(): boolean;
+        get_height(): number;
+        get_hexpand(): boolean;
+        get_hexpand_set(): boolean;
+        get_last_child(): Gtk.Widget | null;
+        get_layout_manager(): Gtk.LayoutManager | null;
+        get_limit_events(): boolean;
+        get_mapped(): boolean;
+        get_margin_bottom(): number;
+        get_margin_end(): number;
+        get_margin_start(): number;
+        get_margin_top(): number;
+        get_name(): string;
+        get_native(): Gtk.Native | null;
+        get_next_sibling(): Gtk.Widget | null;
+        get_opacity(): number;
+        get_overflow(): Gtk.Overflow;
+        get_pango_context(): import("@girs/pango-1.0").default.Context;
+        get_parent(): Gtk.Widget | null;
+        get_preferred_size(): [Gtk.Requisition | null, Gtk.Requisition | null];
+        get_prev_sibling(): Gtk.Widget | null;
+        get_primary_clipboard(): import("@girs/gdk-4.0").default.Clipboard;
+        get_realized(): boolean;
+        get_receives_default(): boolean;
+        get_request_mode(): Gtk.SizeRequestMode;
+        get_root(): Gtk.Root | null;
+        get_scale_factor(): number;
+        get_sensitive(): boolean;
+        get_settings(): Gtk.Settings;
+        get_size(orientation: Gtk.Orientation): number;
+        get_size_request(): [number, number];
+        get_state_flags(): Gtk.StateFlags;
+        get_style_context(): Gtk.StyleContext;
+        get_template_child<T = GObject.Object>(widget_type: GObject.GType, name: string): T;
+        get_tooltip_markup(): string | null;
+        get_tooltip_text(): string | null;
+        get_valign(): Gtk.Align;
+        get_vexpand(): boolean;
+        get_vexpand_set(): boolean;
+        get_visible(): boolean;
+        get_width(): number;
+        grab_focus(): boolean;
+        has_css_class(css_class: string): boolean;
+        has_visible_focus(): boolean;
+        hide(): void;
+        in_destruction(): boolean;
+        init_template(): void;
+        insert_action_group(name: string, group?: import("@girs/gio-2.0").default.ActionGroup | null): void;
+        insert_after(parent: Gtk.Widget, previous_sibling?: Gtk.Widget | null): void;
+        insert_before(parent: Gtk.Widget, next_sibling?: Gtk.Widget | null): void;
+        is_ancestor(ancestor: Gtk.Widget): boolean;
+        is_drawable(): boolean;
+        is_focus(): boolean;
+        is_sensitive(): boolean;
+        is_visible(): boolean;
+        keynav_failed(direction: Gtk.DirectionType): boolean;
+        list_mnemonic_labels(): Gtk.Widget[];
+        map(): void;
+        measure(orientation: Gtk.Orientation, for_size: number): [number, number, number, number];
+        mnemonic_activate(group_cycling: boolean): boolean;
+        observe_children(): import("@girs/gio-2.0").default.ListModel;
+        observe_controllers(): import("@girs/gio-2.0").default.ListModel;
+        pick(x: number, y: number, flags: Gtk.PickFlags): Gtk.Widget | null;
+        queue_allocate(): void;
+        queue_draw(): void;
+        queue_resize(): void;
+        realize(): void;
+        remove_controller(controller: Gtk.EventController): void;
+        remove_css_class(css_class: string): void;
+        remove_mnemonic_label(label: Gtk.Widget): void;
+        remove_tick_callback(id: number): void;
+        set_can_focus(can_focus: boolean): void;
+        set_can_target(can_target: boolean): void;
+        set_child_visible(child_visible: boolean): void;
+        set_css_classes(classes: string[]): void;
+        set_cursor(cursor?: import("@girs/gdk-4.0").default.Cursor | null): void;
+        set_cursor_from_name(name?: string | null): void;
+        set_direction(dir: Gtk.TextDirection): void;
+        set_focus_child(child?: Gtk.Widget | null): void;
+        set_focus_on_click(focus_on_click: boolean): void;
+        set_focusable(focusable: boolean): void;
+        set_font_map(font_map?: import("@girs/pango-1.0").default.FontMap | null): void;
+        set_font_options(options?: import("@girs/gjs/cairo").default.FontOptions | null): void;
+        set_halign(align: Gtk.Align): void;
+        set_has_tooltip(has_tooltip: boolean): void;
+        set_hexpand(expand: boolean): void;
+        set_hexpand_set(set: boolean): void;
+        set_layout_manager(layout_manager?: Gtk.LayoutManager | null): void;
+        set_limit_events(limit_events: boolean): void;
+        set_margin_bottom(margin: number): void;
+        set_margin_end(margin: number): void;
+        set_margin_start(margin: number): void;
+        set_margin_top(margin: number): void;
+        set_name(name: string): void;
+        set_opacity(opacity: number): void;
+        set_overflow(overflow: Gtk.Overflow): void;
+        set_parent(parent: Gtk.Widget): void;
+        set_receives_default(receives_default: boolean): void;
+        set_sensitive(sensitive: boolean): void;
+        set_size_request(width: number, height: number): void;
+        set_state_flags(flags: Gtk.StateFlags, clear: boolean): void;
+        set_tooltip_markup(markup?: string | null): void;
+        set_tooltip_text(text?: string | null): void;
+        set_valign(align: Gtk.Align): void;
+        set_vexpand(expand: boolean): void;
+        set_vexpand_set(set: boolean): void;
+        set_visible(visible: boolean): void;
+        should_layout(): boolean;
+        show(): void;
+        size_allocate(allocation: Gtk.Allocation, baseline: number): void;
+        snapshot_child(child: Gtk.Widget, snapshot: Gtk.Snapshot): void;
+        translate_coordinates(dest_widget: Gtk.Widget, src_x: number, src_y: number): [boolean, number, number];
+        trigger_tooltip_query(): void;
+        unmap(): void;
+        unparent(): void;
+        unrealize(): void;
+        unset_state_flags(flags: Gtk.StateFlags): void;
+        [Symbol.iterator]: () => IterableIterator<Gtk.Widget>;
+    };
+    $gtype: GObject.GType<Gtk.Box>;
+    "new"(orientation: Gtk.Orientation, spacing: number): Gtk.Box;
+    get_default_direction(): Gtk.TextDirection;
+    set_default_direction(dir: Gtk.TextDirection): void;
+    add_shortcut(shortcut: Gtk.Shortcut): void;
+    bind_template_callback_full(callback_name: string, callback_symbol: GObject.Callback): void;
+    bind_template_child_full(name: string, internal_child: boolean, struct_offset: bigint | number): void;
+    get_accessible_role(): Gtk.AccessibleRole;
+    get_activate_signal(): number;
+    get_css_name(): string;
+    get_layout_manager_type(): GObject.GType;
+    install_action(action_name: string, parameter_type: string | null, activate: Gtk.WidgetActionActivateFunc): void;
+    install_property_action(action_name: string, property_name: string): void;
+    query_action(index_: number): [boolean, GObject.GType, string, GLib.VariantType | null, string];
+    set_accessible_role(accessible_role: Gtk.AccessibleRole): void;
+    set_activate_signal(signal_id: number): void;
+    set_activate_signal_from_name(signal_name: string): void;
+    set_css_name(name: string): void;
+    set_layout_manager_type(type: GObject.GType): void;
+    set_template(template_bytes: GLib.Bytes | Uint8Array): void;
+    set_template_from_resource(resource_name: string): void;
+    set_template_scope(scope: Gtk.BuilderScope): void;
+    newv(object_type: GObject.GType, parameters: GObject.Parameter[]): GObject.Object;
+    compat_control(what: bigint | number, data?: any | null): number;
+    interface_find_property(g_iface: GObject.TypeInterface, property_name: string): GObject.ParamSpec;
+    interface_install_property(g_iface: GObject.TypeInterface, pspec: GObject.ParamSpec): void;
+    interface_list_properties(g_iface: GObject.TypeInterface): GObject.ParamSpec[];
+    find_property(property_name: string): GObject.ParamSpec;
+    install_properties(pspecs: GObject.ParamSpec[]): void;
+    install_property(property_id: number, pspec: GObject.ParamSpec): void;
+    list_properties(): GObject.ParamSpec[];
+    override_property(property_id: number, name: string): void;
+    _classInit(klass: any): any;
+};
+export type VideoBridge = InstanceType<typeof VideoBridge>;
+export {};

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@gjsify/video",
+  "version": "0.1.15",
+  "description": "VideoBridge — GTK container for HTMLVideoElement backed by GStreamer gtk4paintablesink",
+  "type": "module",
+  "module": "lib/esm/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/esm/index.js"
+    }
+  },
+  "scripts": {
+    "clear": "rm -rf lib tmp tsconfig.tsbuildinfo || exit 0",
+    "check": "tsc --noEmit",
+    "build": "yarn build:gjsify && yarn build:types",
+    "build:gjsify": "gjsify build --library 'src/**/*.{ts,js}' --exclude 'src/**/*.spec.{mts,ts}' 'src/test.{mts,ts}'",
+    "build:types": "tsc"
+  },
+  "keywords": [
+    "gjs",
+    "gtk",
+    "video",
+    "gstreamer",
+    "bridge"
+  ],
+  "dependencies": {
+    "@girs/gdk-4.0": "^4.0.0-4.0.0-rc.3",
+    "@girs/gjs": "^4.0.0-rc.3",
+    "@girs/glib-2.0": "^2.88.0-4.0.0-rc.3",
+    "@girs/gobject-2.0": "^2.88.0-4.0.0-rc.3",
+    "@girs/gst-1.0": "^1.28.1-4.0.0-rc.3",
+    "@girs/gtk-4.0": "^4.23.0-4.0.0-rc.3",
+    "@gjsify/bridge-types": "^0.1.15",
+    "@gjsify/dom-elements": "^0.1.15",
+    "@gjsify/dom-events": "^0.1.15",
+    "@gjsify/event-bridge": "^0.1.15"
+  },
+  "devDependencies": {
+    "@gjsify/cli": "^0.1.15",
+    "@types/node": "^25.6.0",
+    "typescript": "^6.0.2"
+  }
+}

package/src/gst-init.ts

@@ -0,0 +1,41 @@
+// Lazy GStreamer initialization for the Video bridge.
+//
+// gtk4paintablesink ships with GStreamer's gst-plugins-rs (Rust plugins).
+// On Fedora: gstreamer1-plugin-gtk4
+// On Ubuntu/Debian: gstreamer1.0-gtk4
+//
+// This module is GJS-only — the Node alias layer routes it to @gjsify/empty.
+
+import Gst from 'gi://Gst?version=1.0';
+
+let initialized = false;
+
+export function ensureGstInit(): void {
+    if (initialized) return;
+    Gst.init(null as any);
+    initialized = true;
+}
+
+/** Throws if the gtk4paintablesink element is not registered. */
+export function ensurePaintableSinkAvailable(): void {
+    ensureGstInit();
+    const factory = Gst.ElementFactory.find('gtk4paintablesink');
+    if (!factory) {
+        throwNotSupported(
+            'GStreamer element "gtk4paintablesink" not available. Install gst-plugins-rs:\n' +
+            '  Fedora:        dnf install gstreamer1-plugin-gtk4\n' +
+            '  Ubuntu/Debian: apt install gstreamer1.0-gtk4\n' +
+            '  Verify with:   gst-inspect-1.0 gtk4paintablesink',
+        );
+    }
+}
+
+function throwNotSupported(message: string): never {
+    const DOMExceptionCtor: typeof DOMException | undefined = (globalThis as any).DOMException;
+    if (DOMExceptionCtor) {
+        throw new DOMExceptionCtor(message, 'NotSupportedError');
+    }
+    throw new Error(message);
+}
+
+export { Gst };

package/src/index.ts

@@ -0,0 +1,15 @@
+// Video bridge for GJS — Gtk.Picture container backed by GStreamer gtk4paintablesink.
+// Reimplemented for GJS using GStreamer + GTK4.
+
+export { VideoBridge } from './video-bridge.js';
+export { buildMediaStreamPipeline, buildUriPipeline, createPaintableSink } from './pipeline-builder.js';
+
+// Side-effect: register so that document.createElement('video') works
+// (already built into @gjsify/dom-elements, but register the global constructor)
+import { HTMLVideoElement } from '@gjsify/dom-elements';
+
+Object.defineProperty(globalThis, 'HTMLVideoElement', {
+    value: HTMLVideoElement,
+    writable: true,
+    configurable: true,
+});