@gjsify/gtk-host 0.41.0 → 0.43.0

package/lib/esm/host.js

@@ -1 +1 @@
-import"./_virtual/_rolldown/runtime.js";import{err as e}from"./errors.js";import{lookupWidget as t,nearestRegistered as n}from"./registry.js";import{addressOf as r,insertChild as i,makeWrapper as a,removeChild as o}from"./policies.js";import{beginHostWrite as s,clearHandlers as c,endHostWrite as l,isEventProp as u,setHandler as d,toSignalName as f}from"./signals.js";import{coerce as p,defaultValue as m,paramSpecs as h,requireSpec as g,toPropertyName as _}from"./props.js";import v from"gi://GObject";function createElement(e,n){let r={kind:`element`,descriptor:t(e),widget:null,wrapper:null,slot:null,parent:null,prev:null,next:null,first:null,last:null,handlers:new Map,listeners:new Map,props:{},layout:null,textFromChildren:!1,attached:!1};if(n)for(let[e,t]of Object.entries(n))setProp(r,e,t);return r}const createText=e=>({kind:`text`,data:e,parent:null,prev:null,next:null}),createAnchor=(e=``)=>({kind:`anchor`,data:e,parent:null,prev:null,next:null}),isText=e=>e.kind===`text`;function materialize(e){if(e.widget)return e.widget;let t=e.descriptor.ctor(),n=h(t,e.descriptor.gtype),r={};for(let[t,i]of Object.entries(e.props))r[t]=p(g(n,e.descriptor.gtype,t),i,e.descriptor.gtype);s();try{e.widget=new t(r)}finally{l()}try{replayInto(e)}catch(t){c(e);for(let t of childSnapshot(e))t.kind===`element`&&t.attached&&(o(e,t),t.attached=!1);throw e.widget=null,e.wrapper=null,t}return e.widget}function replayInto(e){for(let[t,n]of e.listeners)d(e,t,n);for(let t=e.first;t;t=t.next)t.kind===`element`&&attach(e,t);e.textFromChildren&&flushText(e)}function setProp(e,t,n,r){if(u(t))return setEventHandler(e,t,n);if(t===`slot`)return setSlot(e,n);if(t===`layout`){let t=n,r=e.parent;if(!r||!e.widget){e.layout=t;return}let i=e.layout;replaceAt(e,r,()=>{e.layout=t},()=>{e.layout=i});return}let i=_(t),a=g(h(e.descriptor.ctor(),e.descriptor.gtype),e.descriptor.gtype,i),o=n===void 0?m(a):p(a,n,e.descriptor.gtype),c=i in e.props?e.props[i]:void 0;if(n===void 0?delete e.props[i]:e.props[i]=n,e.widget){if((a.flags&v.ParamFlags.CONSTRUCT_ONLY)!==0)return rebuild(e,i,c);s();try{e.widget.set_property(i,o)}finally{l()}}}function setEventHandler(e,t,n){e.widget?d(e,t,n):n&&assertSignalExists(e,t),n?e.listeners.set(t,n):e.listeners.delete(t)}function assertSignalExists(t,n){let r=f(n,t.descriptor.eventAliases).split(`::`)[0],i=t.descriptor.ctor().$gtype;if(v.signal_lookup(r,i)===0)throw e.unknownSignal(t.descriptor.gtype,n,r)}function setSlot(e,t){if(e.slot===t)return;let n=e.parent;if(!n||!e.widget){e.slot=t;return}let r=e.slot;replaceAt(e,n,()=>{e.slot=t},()=>{e.slot=r})}function replaceAt(e,t,n,r){o(t,e),e.attached=!1,n();try{attach(t,e)}catch(n){r();try{attach(t,e)}catch{}throw n}}function rebuild(e,t,n){let r=e.parent;if(e.widget){c(e);for(let t of childSnapshot(e))t.kind===`element`&&(o(e,t),t.attached=!1);r&&o(r,e)}e.widget=null,e.wrapper=null,e.attached=!1;try{materialize(e)}catch(i){t!==void 0&&(n===void 0?delete e.props[t]:e.props[t]=n);try{materialize(e),r&&attach(r,e)}catch{}throw i}r&&attach(r,e)}function setText(e,t){e.data=t,e.kind===`text`&&e.parent&&flushText(e.parent)}function setElementText(e,t){writeTextSink(e,t),e.textFromChildren=!1;for(let t of childSnapshot(e))destroy(t)}function flushText(e){let t=``,n=!1;for(let r of childNodes(e))r.kind===`text`&&(t+=r.data,n=!0);t===``&&!e.textFromChildren||(writeTextSink(e,t),e.textFromChildren=n)}function writeTextSink(t,n){let r=t.descriptor.textSink;if(!r)throw e.textNotAccepted(t.descriptor.gtype,n);materialize(t);let i=g(h(t.descriptor.ctor(),t.descriptor.gtype),t.descriptor.gtype,r);s();try{t.widget.set_property(r,p(i,n,t.descriptor.gtype))}finally{l()}t.props[r]=n}function*childNodes(e){for(let t=e.first;t;t=t.next)yield t}function childSnapshot(e){let t=[];for(let n=e.first;n;n=n.next)t.push(n);return t}function link(e,t,n){t.parent=e,n?(t.prev=n.prev,t.next=n,n.prev?n.prev.next=t:e.first=t,n.prev=t):(t.prev=e.last,t.next=null,e.last?e.last.next=t:e.first=t,e.last=t)}function unlink(e){let t=e.parent;t&&(e.prev?e.prev.next=e.next:t.first=e.next,e.next?e.next.prev=e.prev:t.last=e.prev,e.prev=null,e.next=null,e.parent=null)}function attach(e,t){if(!e.widget)return;materialize(t),ensureWrapper(e,t);let n=null,a=0;for(let i=e.first;i&&i!==t;i=i.next)i.kind!==`element`||!i.attached||(n=r(i),a+=1);let o=[];for(let e=t.next;e;e=e.next)e.kind===`element`&&e.attached&&o.push(e);i({parent:e,child:t,prevWidget:n,index:a,following:o}),t.attached=!0}function ensureWrapper(e,t){if(t.wrapper)return;let n=a(e.descriptor.children,t.widget);n&&(t.wrapper=n)}function insert(e,t,n=null){let r=e.parent,i=e.next;e.parent&&remove(e),link(t,e,n);try{e.kind===`element`?attach(t,e):e.kind===`text`&&flushText(t)}catch(t){throw unlink(e),r&&restore(e,r,i),t}}function restore(e,t,n){try{link(t,e,n),e.kind===`element`?attach(t,e):e.kind===`text`&&flushText(t)}catch{unlink(e)}}function remove(e){let t=e.parent;t&&e.kind===`element`&&(o(t,e),e.attached=!1,e.wrapper&&=(e.wrapper.set_child(null),null)),unlink(e),t&&e.kind===`text`&&flushText(t)}function clearContainer(e){for(;e.first;)remove(e.first)}function destroy(e){if(e.kind===`element`){for(let t of childSnapshot(e))destroy(t);c(e),e.listeners.clear()}if(remove(e),e.kind===`element`){let t=e.widget;t&&typeof t.destroy==`function`&&typeof t.get_parent==`function`&&t.get_parent()===null&&t.destroy(),e.widget=null,e.wrapper=null,e.props={},e.layout=null,e.textFromChildren=!1}}function mountRoot(t,r){materialize(t);let a=r.constructor.$gtype,o=n(a);if(!o)throw e.unknownTag(gtypeNameOf(r));let s={kind:`element`,descriptor:o,widget:r,wrapper:null,slot:null,parent:null,prev:null,next:null,first:null,last:null,handlers:new Map,listeners:new Map,props:{},layout:null,textFromChildren:!1,attached:!0},c=directChildren(r);link(s,t,null);try{ensureWrapper(s,t),i({parent:s,child:t,prevWidget:c.length>0?c[c.length-1]:null,index:c.length,following:[]}),t.attached=!0}catch(e){throw unlink(t),e}}function directChildren(e){let t=[],n=e;if(typeof n.get_first_child!=`function`)return t;for(let e=n.get_first_child();e;e=e.get_next_sibling())t.push(e);return t}const gtypeNameOf=e=>v.type_name(e.constructor.$gtype),parentNode=e=>e.parent,firstChild=e=>e.first,nextSibling=e=>e.next,prevSibling=e=>e.prev;export{clearContainer,createAnchor,createElement,createText,destroy,firstChild,insert,isText,materialize,mountRoot,nextSibling,parentNode,prevSibling,remove,setElementText,setEventHandler,setProp,setSlot,setText};
+import"./_virtual/_rolldown/runtime.js";import{err as e}from"./errors.js";import{addressOf as t,insertChild as n,makeDetachedContainer as r,makeWrapper as i,removeChild as a,setterSlotOf as o,setterSlots as s,slotOccupant as c}from"./policies.js";import{beginHostWrite as l,clearHandlers as u,endHostWrite as d,isEventProp as f,setHandler as p,toSignalName as m}from"./signals.js";import{coerce as h,paramSpecs as g,removedValue as _,requireSpec as v,toPropertyName as y}from"./props.js";import{lookupWidget as b,nearestRegistered as x}from"./registry.js";import S from"gi://GObject";function createElement(e,t){let n={kind:`element`,descriptor:b(e),widget:null,wrapper:null,slot:null,parent:null,prev:null,next:null,first:null,last:null,handlers:new Map,listeners:new Map,props:{},layout:null,textFromChildren:!1,attached:!1,destroyed:!1,foreign:[]};if(t)for(let[e,r]of Object.entries(t))setProp(n,e,r);return n}const createText=e=>({kind:`text`,data:e,parent:null,prev:null,next:null}),createAnchor=(e=``)=>({kind:`anchor`,data:e,parent:null,prev:null,next:null}),isText=e=>e.kind===`text`;function materialize(t){if(t.widget)return t.widget;for(let n of t.descriptor.requiresProps??[])if(!(n in t.props))throw e.missingConstructProp(t.descriptor.gtype,n);let n=t.descriptor.ctor(),r=g(n,t.descriptor.gtype),i={};for(let[e,n]of Object.entries(t.props))i[e]=h(v(r,t.descriptor.gtype,e),n,t.descriptor.gtype);l();try{t.widget=new n(i)}finally{d()}try{replayInto(t)}catch(e){u(t);for(let e of childSnapshot(t))e.kind===`element`&&e.attached&&(a(t,e),e.attached=!1);throw t.widget=null,t.wrapper=null,e}return t.widget}function replayInto(e){for(let[t,n]of e.listeners)p(e,t,n);for(let t of siblingsFrom(e.first,e))t.kind===`element`&&attach(e,t);e.textFromChildren&&flushText(e)}function setProp(e,t,n,r){if(f(t))return setEventHandler(e,t,n);if(t===`slot`)return setSlot(e,n);if(t===`layout`){let t=n,r=e.parent;if(!r||!e.widget){e.layout=t;return}let i=e.layout;replaceAt(e,r,()=>{e.layout=t},()=>{e.layout=i});return}let i=y(t),a=v(g(e.descriptor.ctor(),e.descriptor.gtype),e.descriptor.gtype,i),o=n==null,s=o?_(e.descriptor,a):h(a,n,e.descriptor.gtype),c=i in e.props?e.props[i]:void 0;if(o?delete e.props[i]:e.props[i]=n,e.widget){if((a.flags&S.ParamFlags.CONSTRUCT_ONLY)!==0)return rebuild(e,i,c);l();try{e.widget.set_property(i,s)}finally{d()}}}function setEventHandler(e,t,n){e.widget?p(e,t,n):n&&assertSignalExists(e,t),n?e.listeners.set(t,n):e.listeners.delete(t)}function assertSignalExists(t,n){let r=m(n,t.descriptor.eventAliases).split(`::`)[0],i=t.descriptor.ctor().$gtype;if(S.signal_lookup(r,i)===0)throw e.unknownSignal(t.descriptor.gtype,n,r)}function setSlot(e,t){if(e.slot===t)return;let n=e.parent;if(!n||!e.widget){e.slot=t;return}let r=e.slot;replaceAt(e,n,()=>{e.slot=t},()=>{e.slot=r})}function replaceAt(e,t,n,r){a(t,e),e.attached=!1,n();try{attach(t,e)}catch(n){r();try{attach(t,e)}catch{}throw n}}function rebuild(e,t,n){let r=e.parent;if(e.widget){u(e);for(let t of childSnapshot(e))t.kind===`element`&&(a(e,t),t.attached=!1);r&&a(r,e)}e.widget=null,e.wrapper=null,e.attached=!1;try{materialize(e)}catch(i){t!==void 0&&(n===void 0?delete e.props[t]:e.props[t]=n);try{materialize(e),r&&attach(r,e)}catch{}throw i}r&&attach(r,e)}function setText(e,t){e.data=t,e.kind===`text`&&e.parent&&flushText(e.parent)}function setElementText(e,t){writeTextSink(e,t),e.textFromChildren=!1,destroyChildren(e)}function flushText(e){let t=``,n=!1;for(let r of childNodes(e))r.kind===`text`&&(t+=r.data,n=!0);if(t===``&&!e.textFromChildren)return;let r=e.descriptor.textSink;if(t===``&&r&&holdsElementInSetterSlot(e)){e.textFromChildren=!1,delete e.props[r];return}writeTextSink(e,t),e.textFromChildren=n}function*setterSlotChildren(e){for(let t of siblingsFrom(e.first,e))t.kind===`element`&&t.attached&&o(e,t)&&(yield t)}const holdsElementInSetterSlot=e=>!setterSlotChildren(e).next().done;function writeTextSink(t,n){let r=t.descriptor.textSink;if(!r)throw e.textNotAccepted(t.descriptor.gtype,n);materialize(t);let i=t.descriptor.children,a=i.kind===`single`?i.set:null;if(a&&!holdsOursInSlot(t,null)&&appOccupant(t.widget,t.descriptor,a))throw e.occupiedSlot(t.descriptor.gtype,`text`,a);let o=v(g(t.descriptor.ctor(),t.descriptor.gtype),t.descriptor.gtype,r);l();try{t.widget.set_property(r,h(o,n,t.descriptor.gtype))}finally{d()}t.props[r]=n;for(let e of setterSlotChildren(t))e.attached=!1}function*childNodes(e){yield*siblingsFrom(e.first,e)}function childSnapshot(e){let t=[];for(let n of siblingsFrom(e.first,e))t.push(n);return t}function*siblingsFrom(t,n){let r=0;for(let i=t;i;i=i.next){if(++r>1e5)throw e.siblingCycle(n.descriptor.gtype);yield i}}function link(e,t,n){t.parent=e,n?(t.prev=n.prev,t.next=n,n.prev?n.prev.next=t:e.first=t,n.prev=t):(t.prev=e.last,t.next=null,e.last?e.last.next=t:e.first=t,e.last=t)}function unlink(e){let t=e.parent;t&&(e.prev?e.prev.next=e.next:t.first=e.next,e.next?e.next.prev=e.prev:t.last=e.prev,e.prev=null,e.next=null,e.parent=null)}function attach(e,r){if(!e.widget)return;materialize(r),ensureWrapper(e,r),refuseOccupiedSlot(e,r);let i=e.foreign.length>0?e.foreign.filter(t=>t.get_parent()===e.widget):e.foreign,a=i.length>0?i[i.length-1]:null,o=i.length;for(let n of siblingsFrom(e.first,e)){if(n===r)break;n.kind!==`element`||!n.attached||(a=t(n),o+=1)}let s=[];for(let t of siblingsFrom(r.next,e))t.kind===`element`&&t.attached&&s.push(t);n({parent:e,child:r,prevWidget:a,index:o,following:s}),r.attached=!0}function refuseOccupiedSlot(t,n){let r=o(t,n);if(r&&!holdsOursInSlot(t,n.slot)&&appOccupant(t.widget,t.descriptor,r))throw e.occupiedSlot(t.descriptor.gtype,n.descriptor.gtype,r)}function holdsOursInSlot(e,t){for(let n of siblingsFrom(e.first,e))if(n.kind===`element`&&n.attached&&n.slot===t)return!0;return!1}function ensureWrapper(e,t){if(t.wrapper)return;let n=i(e.descriptor.children,t.widget);n&&(t.wrapper=n)}function insert(e,t,n=null){assertHostParent(t);let r=e.parent,i=e.next,a=n===e?i:n;e.parent&&remove(e),link(t,e,a);try{e.kind===`element`?attach(t,e):e.kind===`text`&&flushText(t)}catch(t){throw unlink(e),r&&restore(e,r,i),t}}function assertHostParent(t){if(!isHostElement(t))throw e.notAHostParent(describeValue(t))}function isHostElement(e){let t=e;return!!t&&t.kind===`element`&&typeof t.descriptor==`object`}function describeValue(e){if(e==null)return String(e);if(typeof e!=`object`)return`a ${typeof e}`;let t=e.tagName;if(typeof t==`string`)return`a DOM element <${t.toLowerCase()}>`;let n=e.constructor?.$gtype,r=n?S.type_name(n)??`an unnamed GType`:null;if(r!==null&&r!==`JSObject`)return r;let i=e.constructor?.name;return i&&i!==`Object`?`a ${i}`:`a plain object`}function restore(e,t,n){try{link(t,e,n),e.kind===`element`?attach(t,e):e.kind===`text`&&flushText(t)}catch{unlink(e)}}function remove(e){let t=e.parent;t&&e.kind===`element`&&(a(t,e),e.attached=!1,e.wrapper&&=(e.wrapper.set_child(null),null)),unlink(e),t&&e.kind===`text`&&flushText(t)}function destroyChildren(e){for(let t of childSnapshot(e))destroy(t)}function disconnectHandlers(e){u(e),e.listeners.clear()}function destroy(e){if(e.kind===`element`&&(destroyChildren(e),u(e),e.listeners.clear()),remove(e),e.kind===`element`){let t=e.widget;t&&typeof t.destroy==`function`&&typeof t.get_parent==`function`&&t.get_parent()===null&&t.destroy(),e.widget=null,e.wrapper=null,e.props={},e.layout=null,e.textFromChildren=!1,e.destroyed=!0}}function mountRoot(e,t){materialize(e),insert(e,adopt(t))}function widgetOf(t){if(t.kind!==`element`)throw e.notAnElement(t.kind);if(t.destroyed)throw e.destroyedNode(t.descriptor.gtype);return materialize(t)}const createDetachedContainer=()=>adopt(r());function adopt(t){let n=t.constructor.$gtype,r=x(n);if(!r)throw e.unknownTag(gtypeNameOf(t));return{kind:`element`,descriptor:r,widget:t,wrapper:null,slot:null,parent:null,prev:null,next:null,first:null,last:null,handlers:new Map,listeners:new Map,props:{},layout:null,textFromChildren:!1,attached:!0,destroyed:!1,foreign:adoptedChildren(t,r)}}function adoptedChildren(e,t){let n=s(t.children);if(n.length===0)return directChildren(e);let r=[];for(let i of n){let n=appOccupant(e,t,i);n&&r.push(n)}return r}function appOccupant(e,t,n){let r=c(e,n);if(!r)return null;let i=t.textSink;if(!i)return r;let a=e[i.replace(/-([a-z])/g,(e,t)=>t.toUpperCase())];return typeof a==`string`&&a!==``?null:r}function directChildren(e){let t=[],n=e;if(typeof n.get_first_child!=`function`)return t;for(let e=n.get_first_child();e;e=e.get_next_sibling())t.push(e);return t}const gtypeNameOf=e=>S.type_name(e.constructor.$gtype),parentNode=e=>e.parent,firstChild=e=>e.first,nextSibling=e=>e.next,prevSibling=e=>e.prev;export{adopt,createAnchor,createDetachedContainer,createElement,createText,describeValue,destroy,destroyChildren,disconnectHandlers,firstChild,insert,isHostElement,isText,materialize,mountRoot,nextSibling,parentNode,prevSibling,remove,setElementText,setEventHandler,setProp,setSlot,setText,widgetOf};

package/lib/esm/index.js

@@ -1 +1 @@
-import{GtkHostError as e}from"./errors.js";import{clearRegistry as t,hasWidget as n,lookupWidget as r,nearestRegistered as i,registerWidget as a,registerWidgets as o,registeredTags as s}from"./registry.js";import{ADW_DESCRIPTORS as c}from"./descriptors/adw.js";import{GTK_DESCRIPTORS as l}from"./descriptors/gtk.js";import{BUILTIN_DESCRIPTORS as u,registerBuiltinWidgets as d}from"./descriptors/index.js";import{addressOf as f,reorderMode as p}from"./policies.js";import{isEventProp as m,toSignalName as h}from"./signals.js";import{constructOnlyNames as g,isConstructOnly as _,isWritable as v,paramSpecs as y,toPropertyName as b}from"./props.js";import{clearContainer as x,createAnchor as S,createElement as C,createText as w,destroy as T,firstChild as E,insert as D,isText as O,materialize as k,mountRoot as A,nextSibling as j,parentNode as M,prevSibling as N,remove as P,setElementText as F,setEventHandler as I,setProp as L,setSlot as R,setText as z}from"./host.js";import"./types.js";export{c as ADW_DESCRIPTORS,u as BUILTIN_DESCRIPTORS,l as GTK_DESCRIPTORS,e as GtkHostError,f as addressOf,x as clearContainer,t as clearRegistry,g as constructOnlyNames,S as createAnchor,C as createElement,w as createText,T as destroy,E as firstChild,n as hasWidget,D as insert,_ as isConstructOnly,m as isEventProp,O as isText,v as isWritable,r as lookupWidget,k as materialize,A as mountRoot,i as nearestRegistered,j as nextSibling,y as paramSpecs,M as parentNode,N as prevSibling,d as registerBuiltinWidgets,a as registerWidget,o as registerWidgets,s as registeredTags,P as remove,p as reorderMode,F as setElementText,I as setEventHandler,L as setProp,R as setSlot,z as setText,b as toPropertyName,h as toSignalName};
+import{GtkHostError as e}from"./errors.js";import{addressOf as t,reorderMode as n}from"./policies.js";import{isEventProp as r,toSignalName as i}from"./signals.js";import{constructOnlyNames as a,isConstructOnly as o,isWritable as s,lookupEnumNick as c,paramSpecs as l,toPropertyName as u}from"./props.js";import{assertInjective as d,tagOf as f}from"./tags.js";import{clearRegistry as p,hasWidget as m,lookupWidget as h,nearestRegistered as g,registerWidget as _,registerWidgets as v,registeredTags as y}from"./registry.js";import{adopt as b,createAnchor as x,createDetachedContainer as S,createElement as C,createText as w,destroy as T,destroyChildren as E,disconnectHandlers as D,firstChild as O,insert as k,isHostElement as A,isText as j,materialize as M,mountRoot as N,nextSibling as P,parentNode as F,prevSibling as I,remove as L,setElementText as R,setEventHandler as z,setProp as B,setSlot as V,setText as H,widgetOf as U}from"./host.js";import{GENERATED_PROVENANCE as W,GENERATED_WIDGETS as G}from"./generated/widgets.js";import{ADW_DESCRIPTORS as K}from"./descriptors/adw.js";import{GTK_DESCRIPTORS as q}from"./descriptors/gtk.js";import{BUILTIN_DESCRIPTORS as J,CURATED_DESCRIPTORS as Y,mergeGenerated as X,registerBuiltinWidgets as Z,tableProvenance as Q}from"./descriptors/index.js";import"./types.js";import{probeEnabled as $,runHostProbe as ee,runHostProbeApp as te}from"./probe.js";export{K as ADW_DESCRIPTORS,J as BUILTIN_DESCRIPTORS,Y as CURATED_DESCRIPTORS,W as GENERATED_PROVENANCE,G as GENERATED_WIDGETS,q as GTK_DESCRIPTORS,e as GtkHostError,t as addressOf,b as adopt,d as assertInjective,p as clearRegistry,a as constructOnlyNames,x as createAnchor,S as createDetachedContainer,C as createElement,w as createText,T as destroy,E as destroyChildren,D as disconnectHandlers,O as firstChild,m as hasWidget,k as insert,o as isConstructOnly,r as isEventProp,A as isHostElement,j as isText,s as isWritable,c as lookupEnumNick,h as lookupWidget,M as materialize,X as mergeGenerated,N as mountRoot,g as nearestRegistered,P as nextSibling,l as paramSpecs,F as parentNode,I as prevSibling,$ as probeEnabled,Z as registerBuiltinWidgets,_ as registerWidget,v as registerWidgets,y as registeredTags,L as remove,n as reorderMode,ee as runHostProbe,te as runHostProbeApp,R as setElementText,z as setEventHandler,B as setProp,V as setSlot,H as setText,Q as tableProvenance,f as tagOf,u as toPropertyName,i as toSignalName,U as widgetOf};

package/lib/esm/jsx-runtime.js

@@ -0,0 +1 @@
+import"./_virtual/_rolldown/runtime.js";const e=`@gjsify/gtk-host/jsx-runtime is a TYPE surface, not an automatic JSX runtime. Set "jsx": "preserve" and compile with babel-preset-solid (Solid) or the Vue SFC compiler (Vue) — those emit the renderer calls. With "jsx": "react-jsx" TypeScript emits jsx()/jsxs() calls instead, and no GTK tree can come out of them.`;function jsx(){throw Error(e)}function jsxs(){throw Error(e)}function jsxDEV(){throw Error(e)}function Fragment(){throw Error(e)}export{Fragment,jsx,jsxDEV,jsxs};

package/lib/esm/policies.js

@@ -1 +1 @@
-import"./_virtual/_rolldown/runtime.js";import{GtkHostError as e,err as t}from"./errors.js";import n from"gi://Gtk?version=4.0";function addressOf(e){let n=e.wrapper??e.widget;if(!n)throw t.notAWidget(e.descriptor.gtype);return n}function makeWrapper(e,t){if(e.kind!==`indexed`||!e.wrap)return null;if(e.wrap===`list-box-row`){if(t instanceof n.ListBoxRow)return null;let e=new n.ListBoxRow;return e.set_child(t),e}if(t instanceof n.FlowBoxChild)return null;let r=new n.FlowBoxChild;return r.set_child(t),r}function insertChild(n){try{placeChild(n)}catch(r){throw r instanceof e?r:t.rejectedChild(n.parent.descriptor.gtype,n.child.descriptor.gtype,r.message)}}function placeChild(e){let{parent:n,child:r}=e,i=n.descriptor.children,a=n.widget,o=addressOf(r);switch(i.kind){case`none`:throw t.unclaimedChild(n.descriptor.gtype,r.descriptor.gtype);case`single`:a[i.set](o);return;case`indexed`:a[i.insert](o,e.index);return;case`coords`:appendChild(n,r,a);return;case`ordered`:if(i.after){a[i.after](o,e.prevWidget??null);return}case`slotted`:case`keyed`:appendChild(n,r,a),rotateTail(n,r,e.following,a);return}}function appendChild(e,n,r){let i=e.descriptor.children,a=addressOf(n);switch(i.kind){case`ordered`:r[i.append](a);return;case`slotted`:{let o=n.slot??i.defaultSlot,s=i.slots[o];if(!s)throw t.unknownSlot(e.descriptor.gtype,o,Object.keys(i.slots));r[s](a);return}case`keyed`:{let e=n.layout?.[i.nameFrom]??n.slot,t=n.layout?.title;i.titled?r[i.add](a,e??null,t??e??``):r[i.add](a);return}case`coords`:{let e=n.layout??{};r[i.attach](a,e.column??0,e.row??0,e.columnSpan??1,e.rowSpan??1);return}default:throw t.unclaimedChild(e.descriptor.gtype,n.descriptor.gtype)}}function rotateTail(e,t,n,r){let i=e.descriptor.children,a=n;if(i.kind===`slotted`){let slotOf=e=>e.slot??i.defaultSlot,e=slotOf(t);if(i.slots[e]?.startsWith(`set_`))return;a=n.filter(t=>slotOf(t)===e)}for(let t of a)detachChild(e,t,r);for(let t of a)appendChild(e,t,r)}function detachChild(e,t,n){let r=e.descriptor.children,i=t.wrapper??t.widget;if(i)switch(r.kind){case`none`:return;case`single`:clearIfCurrent(n,r.set,i);return;case`slotted`:{let e=r.slots[t.slot??r.defaultSlot];if(e?.startsWith(`set_`)){clearIfCurrent(n,e,i);return}n[r.remove](i);return}case`ordered`:case`indexed`:case`keyed`:case`coords`:n[r.remove](i);return}}function clearIfCurrent(e,t,n){let r=t.replace(/^set_/,`get_`),i=typeof e[r]==`function`?e[r]():void 0;(i===void 0||i===n)&&e[t](null)}function removeChild(e,t){let n=e.widget;n&&t.attached&&detachChild(e,t,n)}function reorderMode(e){switch(e.kind){case`ordered`:return e.reorder;case`indexed`:return`native`;case`slotted`:case`keyed`:return`remove-all`;case`coords`:case`single`:case`none`:return`n/a`}}export{addressOf,insertChild,makeWrapper,removeChild,reorderMode};
+import"./_virtual/_rolldown/runtime.js";import{GtkHostError as e,err as t}from"./errors.js";import n from"gi://Gtk?version=4.0";function addressOf(e){let n=e.wrapper??e.widget;if(!n)throw t.notAWidget(e.descriptor.gtype);return n}function makeWrapper(e,t){if(e.kind!==`indexed`||!e.wrap)return null;if(e.wrap===`list-box-row`){if(t instanceof n.ListBoxRow)return null;let e=new n.ListBoxRow;return e.set_child(t),e}if(t instanceof n.FlowBoxChild)return null;let r=new n.FlowBoxChild;return r.set_child(t),r}const makeDetachedContainer=()=>new n.Box;function unhandledPolicy(e){throw Error(`unhandled child policy: ${JSON.stringify(e)}`)}function setterSlotOf(e,t){let n=e.descriptor.children;if(n.kind===`single`)return n.set;if(n.kind!==`slotted`)return null;let r=n.slots[t.slot??n.defaultSlot];return r?.startsWith(`set_`)===!0?r:null}function setterSlots(e){return e.kind===`single`?[e.set]:e.kind===`slotted`?Object.values(e.slots).filter(e=>e.startsWith(`set_`)):[]}function slotOccupant(e,t){let n=e,r=t.replace(/^set_/,`get_`);if(typeof n[r]==`function`)return n[r]()??null}function insertChild(n){try{placeChild(n)}catch(r){throw r instanceof e?r:t.rejectedChild(n.parent.descriptor.gtype,n.child.descriptor.gtype,r.message)}}function placeChild(e){let{parent:n,child:r}=e,i=n.descriptor.children,a=n.widget,o=addressOf(r);switch(i.kind){case`none`:throw t.unclaimedChild(n.descriptor.gtype,r.descriptor.gtype);case`uncurated`:throw t.uncuratedPlacement(n.descriptor.gtype,r.descriptor.gtype);case`single`:a[i.set](o);return;case`indexed`:a[i.insert](o,e.index);return;case`coords`:appendChild(n,r,a);return;case`ordered`:if(i.after){a[i.after](o,e.prevWidget??null);return}case`slotted`:case`keyed`:appendChild(n,r,a),rotateTail(n,r,e.following,a);return;default:return unhandledPolicy(i)}}function appendChild(e,n,r){let i=e.descriptor.children,a=addressOf(n);switch(i.kind){case`uncurated`:throw t.uncuratedPlacement(e.descriptor.gtype,n.descriptor.gtype);case`ordered`:r[i.append](a);return;case`slotted`:{let o=n.slot??i.defaultSlot,s=i.slots[o];if(!s)throw t.unknownSlot(e.descriptor.gtype,o,Object.keys(i.slots));r[s](a);return}case`keyed`:{let e=n.layout?.[i.nameFrom]??n.slot,t=n.layout?.title;i.titled?r[i.add](a,e??null,t??e??``):r[i.add](a);return}case`coords`:{let e=n.layout??{};r[i.attach](a,e.column??0,e.row??0,e.columnSpan??1,e.rowSpan??1);return}default:throw t.unclaimedChild(e.descriptor.gtype,n.descriptor.gtype)}}function rotateTail(e,t,n,r){let i=e.descriptor.children,a=n;if(i.kind===`slotted`){if(setterSlotOf(e,t))return;let slotOf=e=>e.slot??i.defaultSlot,r=slotOf(t);a=n.filter(e=>slotOf(e)===r)}for(let t of a)detachChild(e,t,r);for(let t of a)appendChild(e,t,r)}function detachChild(e,t,n){let r=e.descriptor.children,i=t.wrapper??t.widget;if(i)switch(r.kind){case`none`:case`uncurated`:return;case`single`:clearIfCurrent(n,r.set,i);return;case`slotted`:{let a=setterSlotOf(e,t);if(a){clearIfCurrent(n,a,i);return}n[r.remove](i);return}case`ordered`:case`indexed`:case`keyed`:case`coords`:n[r.remove](i);return;default:return unhandledPolicy(r)}}function clearIfCurrent(e,t,n){let r=slotOccupant(e,t);(r===void 0||r===n)&&e[t](null)}function removeChild(e,t){let n=e.widget;n&&t.attached&&detachChild(e,t,n)}function reorderMode(e){switch(e.kind){case`uncurated`:return`n/a`;case`ordered`:return e.reorder;case`indexed`:return`native`;case`slotted`:case`keyed`:return`remove-all`;case`coords`:case`single`:case`none`:return`n/a`;default:return unhandledPolicy(e)}}export{addressOf,insertChild,makeDetachedContainer,makeWrapper,removeChild,reorderMode,setterSlotOf,setterSlots,slotOccupant,unhandledPolicy};

package/lib/esm/probe.js

@@ -0,0 +1 @@
+import"./_virtual/_rolldown/runtime.js";import{installDiagnosticsGate as e}from"./conformance/diagnostics.js";import t from"gi://Gtk?version=4.0";import n from"gi://Adw?version=1";import r from"gi://GLib";import i from"system";function probeEnabled(){let e=r.getenv(`GJSIFY_HOST_PROBE`);if(e===null)return!1;let t=e.toLowerCase();return t!==``&&t!==`0`&&t!==`false`}const a=`<gtk-host probe: recorder self-check>`;function recorderIsHonest(e,t){let n=t.length;e(a,!1);let r=t.length===n+1&&t[n]===a;t.length=n,e(a,!0);let i=t.length===n;return t.length=n,r&&i?null:r?`the probe recorder records a PASSING check as a failure, so every assertion below is a false alarm`:`the probe recorder did not record a failed check, so every assertion below is unverifiable`}function runHostProbe(t,n=null){let r=t.label??`PROBE`,i=e();i.reset();let a=[],check=(e,t)=>{t||a.push(e)},o=recorderIsHonest(check,a);o!==null&&a.push(o);let s={};try{s=t.assert(t.build(n),check)}catch(e){a.push(`threw: ${e.message}`)}let c=i.seen.length;check(`no GTK diagnostics (saw ${c})`,c===0);let l=JSON.stringify({...a.length>0?{failures:a}:{},diagnostics:c,...s});return print(`${r}: ${a.length>0?`FAIL`:`PASS`} ${l}`),+(a.length>0)}async function runHostProbeApp(e){if(probeEnabled())return t.init(),i.exit(runHostProbe(e,null));let r=new n.Application({application_id:e.applicationId});r.connect(`activate`,()=>{let t=runHostProbe(e,r);t!==0&&i.exit(t),e.present(e.build(r))}),await r.runAsync([])}export{probeEnabled,runHostProbe,runHostProbeApp};

package/lib/esm/props.js

@@ -1 +1 @@
-import"./_virtual/_rolldown/runtime.js";import{err as e}from"./errors.js";import t from"gi://GObject";import n from"gi://Adw?version=1";import r from"gi://Gtk?version=4.0";import i from"gi://Gdk?version=4.0";import a from"gi://Pango";const o=[[`Gtk`,r],[`Adw`,n],[`Gdk`,i],[`Pango`,a],[`G`,t]];function toPropertyName(e){return e.includes(`-`)?e:e.replace(/([a-z0-9])([A-Z])/g,`$1-$2`).toLowerCase()}const s=new Map;function paramSpecs(e,t){let n=s.get(t);if(n)return n;n=new Map;for(let t of e.list_properties())n.set(t.get_name(),t);return s.set(t,n),n}const isFlag=(e,t)=>(e&t)!==0,isWritable=e=>isFlag(e.flags,t.ParamFlags.WRITABLE),isConstructOnly=e=>isFlag(e.flags,t.ParamFlags.CONSTRUCT_ONLY);function constructOnlyNames(e,t){let n=[];for(let[r,i]of paramSpecs(e,t))isConstructOnly(i)&&isWritable(i)&&n.push(r);return n}function resolveEnumValue(e,t){for(let[n,r]of o){if(!e.startsWith(n))continue;let i=r[e.slice(n.length)];if(!i)continue;let a=i[t.toUpperCase().replace(/-/g,`_`)];return typeof a==`number`?{resolved:!0,value:a}:{resolved:!0}}return{resolved:!1}}function coerce(n,r,i){if(r==null)return r;let a=n.value_type;if(t.type_is_a(a,t.TYPE_ENUM)&&typeof r==`string`){let o=t.type_name(a),s=resolveEnumValue(o,r);if(s.value!==void 0)return s.value;throw s.resolved?e.badEnum(i,n.get_name(),r,o):e.unresolvableEnum(o)}if(t.type_is_a(a,t.TYPE_FLAGS)&&typeof r==`string`)throw e.badFlags(i,n.get_name(),r,t.type_name(a));if(t.type_is_a(a,t.TYPE_BOOLEAN)){if(typeof r==`boolean`)return r;if(r===`true`)return!0;if(r===`false`)return!1;if(typeof r==`string`)throw e.badBoolean(i,n.get_name(),r);return!!r}if(t.type_is_a(a,t.TYPE_STRING)){if(typeof r==`string`)return r;if(typeof r==`number`||typeof r==`boolean`)return String(r);throw e.badString(i,n.get_name(),typeof r)}return(t.type_is_a(a,t.TYPE_INT)||t.type_is_a(a,t.TYPE_UINT)||t.type_is_a(a,t.TYPE_INT64)||t.type_is_a(a,t.TYPE_UINT64))&&typeof r==`number`?Math.trunc(r):r}function defaultValue(e){return e.get_default_value()}function requireSpec(t,n,r){let i=t.get(r);if(!i)throw e.unknownProp(n,r);if(!isWritable(i))throw e.readOnlyProp(n,r);return i}export{coerce,constructOnlyNames,defaultValue,isConstructOnly,isWritable,paramSpecs,requireSpec,toPropertyName};
+import"./_virtual/_rolldown/runtime.js";import{err as e}from"./errors.js";import t from"gi://GObject";import n from"gi://Gtk?version=4.0";import r from"gi://Adw?version=1";import i from"gi://Gdk?version=4.0";import a from"gi://Pango";const o=[[`Gtk`,n],[`Adw`,r],[`Gdk`,i],[`Pango`,a],[`G`,t]];function toPropertyName(e){return e.includes(`-`)?e:e.replace(/([a-z0-9])([A-Z])/g,`$1-$2`).toLowerCase()}function withoutKeys(e,t){if(!e)return;let n;for(let r of Object.keys(e))t.has(r)||((n??={})[r]=e[r]);return n}const s=new Map;function paramSpecs(e,t){let n=s.get(t);if(n)return n;n=new Map;for(let t of e.list_properties())n.set(t.get_name(),t);return s.set(t,n),n}const isFlag=(e,t)=>(e&t)!==0,isWritable=e=>isFlag(e.flags,t.ParamFlags.WRITABLE),isConstructOnly=e=>isFlag(e.flags,t.ParamFlags.CONSTRUCT_ONLY);function constructOnlyNames(e,t){let n=[];for(let[r,i]of paramSpecs(e,t))isConstructOnly(i)&&isWritable(i)&&n.push(r);return n}function resolveEnumValue(e,t){for(let[n,r]of o){if(!e.startsWith(n))continue;let i=r[e.slice(n.length)];if(!i)continue;let a=i[t.toUpperCase().replace(/-/g,`_`)];return typeof a==`number`?{resolved:!0,value:a}:{resolved:!0}}return{resolved:!1}}const lookupEnumNick=(e,t)=>resolveEnumValue(e,t).value;function coerce(n,r,i){if(r==null)return r;let a=n.value_type;if(t.type_is_a(a,t.TYPE_ENUM)&&typeof r==`string`){let o=t.type_name(a),s=resolveEnumValue(o,r);if(s.value!==void 0)return s.value;throw s.resolved?e.badEnum(i,n.get_name(),r,o):e.unresolvableEnum(o)}if(t.type_is_a(a,t.TYPE_FLAGS)&&typeof r==`string`)throw e.badFlags(i,n.get_name(),r,t.type_name(a));if(t.type_is_a(a,t.TYPE_BOOLEAN)){if(typeof r==`boolean`)return r;if(r===`true`)return!0;if(r===`false`)return!1;if(typeof r==`string`)throw e.badBoolean(i,n.get_name(),r);return!!r}if(t.type_is_a(a,t.TYPE_STRING)){if(typeof r==`string`)return r;if(typeof r==`number`||typeof r==`boolean`)return String(r);throw e.badString(i,n.get_name(),typeof r)}return(t.type_is_a(a,t.TYPE_INT)||t.type_is_a(a,t.TYPE_UINT)||t.type_is_a(a,t.TYPE_INT64)||t.type_is_a(a,t.TYPE_UINT64))&&typeof r==`number`?Math.trunc(r):r}const c=[t.TYPE_BOOLEAN,t.TYPE_STRING,t.TYPE_INT,t.TYPE_UINT,t.TYPE_INT64,t.TYPE_UINT64,t.TYPE_DOUBLE,t.TYPE_FLOAT],isScalarSpec=e=>t.type_is_a(e.value_type,t.TYPE_ENUM)||c.some(n=>t.type_is_a(e.value_type,n)),toAccessorName=e=>e.replace(/-([a-z0-9])/g,(e,t)=>t.toUpperCase()),l=new Map;function constructedDefaults(e){let r=l.get(e.gtype);if(r)return r;let i=new Map;l.set(e.gtype,i);let a=e.ctor(),o;try{let t={};for(let n of e.requiresProps??[])t[n]=``;o=new a(t)}catch{return i}for(let[n,r]of paramSpecs(a,e.gtype)){if(!isWritable(r)||isConstructOnly(r)||!isFlag(r.flags,t.ParamFlags.READABLE)||isFlag(r.flags,t.ParamFlags.DEPRECATED)||!isScalarSpec(r))continue;let e=toAccessorName(n);e in o&&i.set(n,o[e])}return o instanceof n.Window&&o.destroy(),i}function removedValue(e,t){let n=constructedDefaults(e),r=t.get_name();return n.has(r)?n.get(r):t.get_default_value()}function requireSpec(t,n,r){let i=t.get(r);if(!i)throw e.unknownProp(n,r);if(!isWritable(i))throw e.readOnlyProp(n,r);return i}export{coerce,constructOnlyNames,isConstructOnly,isWritable,lookupEnumNick,paramSpecs,removedValue,requireSpec,toPropertyName,withoutKeys};

package/lib/esm/react-jsx-runtime.js

@@ -0,0 +1 @@
+import{Fragment as e,jsx as t,jsxs as n}from"react/jsx-runtime";import{jsxDEV as r}from"react/jsx-dev-runtime";const i=t,a=n,o=r;export{e as Fragment,i as jsx,o as jsxDEV,a as jsxs};

package/lib/esm/registry.js

@@ -1 +1 @@
-import"./_virtual/_rolldown/runtime.js";import{err as e}from"./errors.js";import t from"gi://GObject";const n=new Map;function registerWidget(e){n.set(e.gtype,e)}function registerWidgets(e){for(let t of e)registerWidget(t)}function lookupWidget(t){let r=n.get(t);if(!r)throw e.unknownTag(t);return r}const hasWidget=e=>n.has(e),registeredTags=()=>[...n.keys()].sort();function nearestRegistered(e){let r,i=-1;for(let a of n.values()){let n;try{n=a.ctor().$gtype}catch{continue}if(!t.type_is_a(e,n))continue;let o=depthOf(n);o>i&&(r=a,i=o)}return r}function depthOf(e){let n=0,r=e;for(;r;){let e=t.type_parent(r);if(!e)break;n+=1,r=e}return n}function clearRegistry(){n.clear()}export{clearRegistry,hasWidget,lookupWidget,nearestRegistered,registerWidget,registerWidgets,registeredTags};
+import"./_virtual/_rolldown/runtime.js";import{err as e}from"./errors.js";import{tagOf as t}from"./tags.js";import n from"gi://GObject";const r=new Map,i=new Map;function registerWidget(e){r.set(e.gtype,e);let n=t(e.gtype);n!==e.gtype&&i.set(n,e)}function registerWidgets(e){for(let t of e)registerWidget(t)}function lookupWidget(t){let n=r.get(t)??i.get(t);if(!n)throw e.unknownTag(t);return n}const hasWidget=e=>r.has(e)||i.has(e),registeredTags=()=>[...r.keys()].sort();function nearestRegistered(e){for(let t=e;t;t=n.type_parent(t)){let e=n.type_name(t);if(!e)break;let i=r.get(e);if(i)return i}}function clearRegistry(){r.clear(),i.clear()}export{clearRegistry,hasWidget,lookupWidget,nearestRegistered,registerWidget,registerWidgets,registeredTags};

package/lib/esm/signals.js

@@ -1 +1 @@
-import"./_virtual/_rolldown/runtime.js";import{err as e}from"./errors.js";function toSignalName(e,t){if(t?.[e])return t[e];if(e.startsWith(`on:`))return e.slice(3);let n=e.slice(2);return n.startsWith(`Notify`)?`notify::${kebab(n.slice(6))}`:kebab(n)}const kebab=e=>e.replace(/^./,e=>e.toLowerCase()).replace(/([a-z0-9])([A-Z])/g,`$1-$2`).toLowerCase();function isEventProp(e){return e.startsWith(`on:`)||e.length>2&&e.startsWith(`on`)&&e[2]===e[2].toUpperCase()&&e[2]!==e[2].toLowerCase()}let t=0;const beginHostWrite=()=>{t+=1},endHostWrite=()=>{--t},inHostWrite=()=>t>0;function setHandler(t,n,r){let i=toSignalName(n,t.descriptor.eventAliases),a=t.handlers.get(i),o=t.widget;if(a&&a.prop!==n&&r)throw e.signalTaken(t.descriptor.gtype,n,a.prop,i);if(a&&(o.disconnect(a.id),t.handlers.delete(i)),!r)return;let s=i.startsWith(`notify::`),c=o.connect(i,(...e)=>{if(!(s&&inHostWrite()))return r(...e.slice(1))});t.handlers.set(i,{id:c,prop:n})}function clearHandlers(e){if(!e.widget){e.handlers.clear();return}let t=e.widget;for(let{id:n}of e.handlers.values())t.disconnect(n);e.handlers.clear()}export{beginHostWrite,clearHandlers,endHostWrite,inHostWrite,isEventProp,setHandler,toSignalName};
+import"./_virtual/_rolldown/runtime.js";import{err as e}from"./errors.js";const t=/(?:Once|Passive|Capture)$/;function parseEventProp(n,r){if(r?.[n])return{signal:r[n],once:!1};if(n.startsWith(`on:`))return{signal:n.slice(3),once:!1};let i=n.slice(2),a=!1;for(let r=t.exec(i);r;r=t.exec(i)){let t=r[0];if(t!==`Once`)throw e.eventModifier(n,t.toLowerCase());a=!0,i=i.slice(0,i.length-t.length)}return i===`Notify`?{signal:`notify`,once:a}:i.startsWith(`Notify`)?{signal:`notify::${kebab(i.slice(6))}`,once:a}:{signal:kebab(i),once:a}}const toSignalName=(e,t)=>parseEventProp(e,t).signal,kebab=e=>e.replace(/^./,e=>e.toLowerCase()).replace(/([a-z0-9])([A-Z])/g,`$1-$2`).toLowerCase();function isEventProp(e){return e.startsWith(`on:`)||e.length>2&&e.startsWith(`on`)&&e[2]===e[2].toUpperCase()&&e[2]!==e[2].toLowerCase()}let n=0;const beginHostWrite=()=>{n+=1},endHostWrite=()=>{--n},inHostWrite=()=>n>0;function setHandler(t,n,r){let{signal:i,once:a}=parseEventProp(n,t.descriptor.eventAliases),o=t.handlers.get(i),s=t.widget;if(o&&o.prop!==n&&r)throw e.signalTaken(t.descriptor.gtype,n,o.prop,i);if(o&&(s.disconnect(o.id),t.handlers.delete(i)),!r)return;let c=i.startsWith(`notify::`),l=s.connect(i,(...e)=>{if(!(c&&inHostWrite()))return a&&t.handlers.get(i)?.id===l&&(s.disconnect(l),t.handlers.delete(i)),r(...e.slice(1))});t.handlers.set(i,{id:l,prop:n})}function clearHandlers(e){if(!e.widget){e.handlers.clear();return}let t=e.widget;for(let{id:n}of e.handlers.values())t.disconnect(n);e.handlers.clear()}export{beginHostWrite,clearHandlers,endHostWrite,inHostWrite,isEventProp,parseEventProp,setHandler,toSignalName};

package/lib/esm/tags.js

@@ -0,0 +1,2 @@
+import"./_virtual/_rolldown/runtime.js";function tagOf(e){let t=[];for(let n=0;n<e.length;n++){let r=e[n],i=n>0?e[n-1]:``,a=n+1<e.length?e[n+1]:``;r>=`A`&&r<=`Z`&&n>0&&(!(i>=`A`&&i<=`Z`)||a!==``&&a>=`a`&&a<=`z`)&&t.push(`-`),t.push(r.toLowerCase())}return t.join(``)}function assertInjective(e){let t=new Map,n=[];for(let r of e){let e=tagOf(r),i=t.get(e);i?n.push(`${e} <- ${i} and ${r}`):t.set(e,r)}if(n.length>0)throw Error(`tag map is not injective:\n  ${n.join(`
+  `)}`)}export{assertInjective,tagOf};

package/lib/types/adapters/react.d.ts

@@ -0,0 +1,175 @@
+import type { ReactNode } from 'react';
+import type Gtk from '@girs/gtk-4.0';
+import { adopt, widgetOf } from '../host.js';
+import type { HostElement, HostNode, HostText } from '../types.js';
+/** What React hands `createInstance`: the vnode props, `children` included. */
+export type ReactProps = Record<string, unknown>;
+/** One authored property that changed: name, next value, previous value. */
+type PropChange = readonly [key: string, next: unknown, prev: unknown];
+/**
+ * The HostConfig, exported because it IS the contract.
+ *
+ * `react.spec.ts` builds a second reconciler over a Proxy of this object to read
+ * the member set the INSTALLED `react-reconciler` asks for, so a version that
+ * starts asking for something new fails a test instead of returning `undefined`
+ * in a commit. It is also the seam for a consumer who needs a differently
+ * configured reconciler (a `LegacyRoot`, a different event priority) without
+ * restating the mapping.
+ */
+export declare const gtkHostConfig: {
+    supportsMutation: boolean;
+    supportsPersistence: boolean;
+    supportsHydration: boolean;
+    isPrimaryRenderer: boolean;
+    noTimeout: -1;
+    scheduleTimeout: typeof setTimeout;
+    cancelTimeout: typeof clearTimeout;
+    createInstance: (type: string, props: ReactProps) => HostElement;
+    createTextInstance: (text: string) => HostText;
+    appendInitialChild: (parent: HostElement, child: HostNode) => void;
+    finalizeInitialChildren: () => boolean;
+    /**
+     * `false`, always — one text path instead of two.
+     *
+     * `true` would tell React to skip text instances for this element and leave
+     * the string in `props.children` for the adapter to write. The host already
+     * owns that translation: a text NODE is concatenated into the descriptor's
+     * `textSink`, and a widget without one refuses text BY TAG NAME. Answering
+     * `true` would move that decision into the adapter, where it would be a
+     * widget-knowledge test — the one thing ADR 0027 § 7 forbids an adapter.
+     *
+     * It also keeps `resetTextContent` unreachable: React sets the `ContentReset`
+     * flag only when `shouldSetTextContent` was true for the PREVIOUS props.
+     */
+    shouldSetTextContent: () => boolean;
+    getRootHostContext: () => null;
+    getChildHostContext: (parentHostContext: null) => null;
+    /**
+     * What a `ref` receives — the author's widget, never the host's wrapper.
+     *
+     * `<GtkListBox><GtkButton ref={…}/>` puts the button inside a
+     * `GtkListBoxRow` the host created. Handing that row back would give the
+     * author a widget they never wrote and whose `label` write does nothing.
+     */
+    getPublicInstance: (instance: HostElement) => Gtk.Widget;
+    prepareForCommit: () => null;
+    resetAfterCommit: () => void;
+    preparePortalMount: () => void;
+    /**
+     * The priority every update outside React's own event system gets.
+     *
+     * React DOM derives this from the DOM event being handled (a click is
+     * discrete, a scroll continuous). A GTK signal handler is not a DOM event and
+     * there is no ambient event to read, so every update is a default-lane one —
+     * the same answer `react-art` and `react-nil` give. Consequence, stated
+     * because it is load-bearing: a `setState` from a GTK handler is CONCURRENT,
+     * so it lands when `scheduler` next runs, i.e. on the next GLib main-loop
+     * iteration. `flushSync` is the escape hatch, and the spec pumps the main
+     * context to prove the scheduled path works at all under GJS.
+     */
+    getCurrentEventPriority: () => number;
+    appendChild: (parent: HostElement, child: HostNode) => void;
+    appendChildToContainer: (container: HostElement, child: HostNode) => void;
+    insertBefore: (parent: HostElement, child: HostNode, before: HostNode) => void;
+    insertInContainerBefore: (container: HostElement, child: HostNode, before: HostNode) => void;
+    removeChild: (_parent: HostElement, child: HostNode) => void;
+    removeChildFromContainer: (_container: HostElement, child: HostNode) => void;
+    /**
+     * React clears the root before its FIRST commit — and the application's own
+     * chrome must survive it.
+     *
+     * `updateHostRoot` sets the `Snapshot` flag whenever the previous render
+     * produced no child, and `commitBeforeMutationEffects` then calls this on the
+     * container. In the DOM that discards leftover markup. Here the container is a
+     * widget the application built and filled, so this clears what the HOST put
+     * there (the shadow children) and never `el.foreign`, which `adopt` recorded
+     * precisely so placement can offset past it.
+     *
+     * `destroy` rather than `remove`, for the same reason `removeChild` uses it:
+     * GJS blocks JS callbacks during GC, so a detached node keeps its handlers
+     * for the life of the process.
+     */
+    clearContainer: (container: HostElement) => void;
+    prepareUpdate: (_instance: HostElement, _type: string, oldProps: ReactProps, newProps: ReactProps) => PropChange[] | null;
+    commitUpdate: (instance: HostElement, updatePayload: PropChange[]) => void;
+    commitTextUpdate: (textInstance: HostText, _oldText: string, newText: string) => void;
+    commitMount: () => void;
+    resetTextContent: (instance: HostElement) => void;
+    hideInstance: (instance: HostElement) => void;
+    unhideInstance: (instance: HostElement) => void;
+    /**
+     * A text run owns no widget, so hiding it means emptying what it contributes.
+     *
+     * The parent's text sink is a concatenation of its text children, so writing
+     * `''` removes exactly this run and leaves its siblings. Nothing has to be
+     * remembered: React hands the text back to `unhideTextInstance` as the fiber's
+     * own `memoizedProps`.
+     */
+    hideTextInstance: (textInstance: HostText) => void;
+    unhideTextInstance: (textInstance: HostText, text: string) => void;
+    getInstanceFromNode: () => null;
+    getInstanceFromScope: () => null;
+    prepareScopeUpdate: () => void;
+    beforeActiveInstanceBlur: () => void;
+    afterActiveInstanceBlur: () => void;
+    detachDeletedInstance: () => void;
+};
+export type GtkHostConfig = typeof gtkHostConfig;
+/**
+ * Run `fn` and flush every update it schedules before returning.
+ *
+ * The default lane is concurrent (see `getCurrentEventPriority`), so a `setState`
+ * from a GTK signal handler lands on a later main-loop iteration. In an
+ * application that is right — GTK is running a main loop. Outside one, and in a
+ * test, this is how a change becomes visible without pumping.
+ */
+export declare const flushSync: <T>(fn: () => T) => T;
+export interface ReactRoot {
+    /** Render (or re-render) this tree. Synchronous — the widgets exist on return. */
+    render(element: ReactNode): void;
+    /** Unmount the tree, tearing every widget and handler down. */
+    unmount(): void;
+    /** The host element wrapping the application's container. */
+    readonly container: HostElement;
+}
+export interface ReactRootOptions {
+    /**
+     * What to do with an error React RECOVERED from — a render an error boundary
+     * caught and retried, or a commit that had to fall back.
+     *
+     * The default is `console.error`, which is what `react-dom` does
+     * (`reportError`, absent under GJS). Rethrowing is deliberately NOT the
+     * default: React calls this from inside the commit, so a throw would break
+     * the error boundary that just did its job. A test passes its own recorder
+     * and asserts nothing arrived.
+     */
+    onRecoverableError?(error: Error): void;
+}
+/**
+ * A React root over a widget the application owns.
+ *
+ * `adopt` is the bridge every adapter needs: React's `createContainer` wants a
+ * container of the renderer's own type and an application has a `Gtk.Widget`. It
+ * also records what the container already held, so the tree renders AFTER the
+ * application's own chrome instead of above it.
+ *
+ * `render` flushes synchronously. React's own `createRoot().render()` does not,
+ * and the reason to differ is measured rather than stylistic: without a GLib main
+ * loop nothing drives `scheduler`, so an unflushed first render leaves the
+ * container empty with no error — the silent-empty-window failure this package
+ * exists to refuse. An application that wants concurrent behaviour has
+ * `reconciler`-level control through `gtkHostConfig`.
+ */
+export declare function createRoot(container: Gtk.Widget, options?: ReactRootOptions): ReactRoot;
+/** `createRoot(container).render(element)`, for the common case. */
+export declare function mount(element: ReactNode, container: Gtk.Widget, options?: ReactRootOptions): ReactRoot;
+/**
+ * Re-exported, not re-implemented: the Solid adapter carried the SAME function and
+ * Vue carried none. It is a host op now, with coded errors instead of bare ones.
+ */
+export { widgetOf };
+/**
+ * Re-exported because a React app mounting into a second, hand-held container
+ * needs it and importing the host separately is a second module for one function.
+ */
+export { adopt };

package/lib/types/adapters/react.spec.d.ts

@@ -0,0 +1,2 @@
+declare const _default: () => Promise<void>;
+export default _default;

package/lib/types/adapters/solid.d.ts

@@ -0,0 +1,78 @@
+import type Gtk from '@girs/gtk-4.0';
+import { widgetOf } from '../host.js';
+import type { HostNode } from '../types.js';
+export declare const render: (code: () => HostNode, node: HostNode) => () => void, effect: <T>(fn: (prev?: T) => T, init?: T) => void, memo: <T>(fn: () => T, equal: boolean) => () => T, createComponent: <T>(Comp: (props: T) => HostNode, props: T) => HostNode, createElement: (tag: string) => HostNode, createTextNode: (value: string) => HostNode, insertNode: (parent: HostNode, node: HostNode, anchor?: HostNode) => void, insert: <T>(parent: any, accessor: T | (() => T), marker?: any | null, initial?: any) => HostNode, spread: <T>(node: any, accessor: (() => T) | T, skipChildren?: boolean) => void, setProp: <T>(node: HostNode, name: string, value: T, prev?: T) => T, mergeProps: (...sources: unknown[]) => unknown, use: <A, T>(fn: (element: HostNode, arg: A) => T, element: HostNode, arg: A) => T;
+/**
+ * Render a Solid component into a widget the application owns.
+ *
+ * `render` wants a host node as its container; an application has a `Gtk.Widget`.
+ * `adopt` bridges that through the same descriptor table every other parent uses,
+ * so a `GObject.registerClass` subclass of a known container works unchanged.
+ *
+ * Returns Solid's disposer. Calling it unmounts the tree — and because the host's
+ * `destroy` is eager (GJS blocks JS callbacks during GC), that is also what
+ * disconnects the signal handlers.
+ */
+export declare function mount(code: () => HostNode, container: Gtk.Widget): () => void;
+/** `<For each={items}>` — keyed by item identity, so a reorder MOVES nodes. */
+export declare const For: <T>(props: {
+    each: readonly T[] | undefined | null | false;
+    fallback?: HostNode;
+    children: (item: T, index: () => number) => HostNode;
+}) => HostNode;
+/** `<Index each={items}>` — keyed by position; the item is an accessor. */
+export declare const Index: <T>(props: {
+    each: readonly T[] | undefined | null | false;
+    fallback?: HostNode;
+    children: (item: () => T, index: number) => HostNode;
+}) => HostNode;
+/**
+ * `<Show when={cond}>` — a conditional branch.
+ *
+ * The child function receives an ACCESSOR, not the value: Solid's runtime passes
+ * `keyed ? c : () => …`, so without `keyed` a `(item) => item.name` reads `.name`
+ * off a function and renders the function's own name — no type error, no runtime
+ * error, wrong string on screen. `keyed: true` opts into the value.
+ */
+export declare const Show: {
+    <T>(props: {
+        when: T | undefined | null | false;
+        keyed: true;
+        fallback?: HostNode;
+        children: HostNode | ((item: NonNullable<T>) => HostNode);
+    }): HostNode;
+    <T>(props: {
+        when: T | undefined | null | false;
+        keyed?: false;
+        fallback?: HostNode;
+        children: HostNode | ((item: () => NonNullable<T>) => HostNode);
+    }): HostNode;
+};
+/**
+ * `<Dynamic component={…}>` — the one control-flow component Solid does NOT ship
+ * renderer-agnostically.
+ *
+ * `For`, `Index` and `Show` live in `solid-js` and reconcile whatever their
+ * children return, so this adapter only re-types them. `Dynamic` lives in
+ * `solid-js/web`, and that package IS the DOM renderer: its string branch is
+ * `document.createElement(component)` followed by the DOM's `spread`. Under a
+ * universal renderer it therefore produces a DOM element nobody here can place —
+ * measured as `container: ["GtkBox"]`, box children `[]`, no throw, no
+ * diagnostic, exit 0. Re-implementing it over the host ops is four lines and it
+ * is the only honest alternative to that silence.
+ *
+ * A `component` that is neither a tag nor a function is REFUSED, where Solid's
+ * own `switch` falls through and returns undefined: `component={registry[key]}`
+ * with a key that missed is the single most common way to render nothing by
+ * accident, and rendering nothing on purpose is `<Show>`'s job.
+ */
+export declare function Dynamic<P extends Record<string, unknown>>(props: P & {
+    component: string | ((props: P) => HostNode);
+}): HostNode;
+/**
+ * Re-exported, not re-implemented: this and the React adapter carried the SAME
+ * function, and Vue carried none — so a Vue app had no supported way to reach a
+ * widget at all. It is a host op now (`../host.js`), and its two refusals are
+ * coded errors rather than the bare `new Error` they used to be.
+ */
+export { widgetOf };

package/lib/types/adapters/solid.spec.d.ts

@@ -0,0 +1,2 @@
+declare const _default: () => Promise<void>;
+export default _default;

package/lib/types/adapters/vue.d.ts

@@ -0,0 +1,24 @@
+import type Gtk from '@girs/gtk-4.0';
+import { adopt, widgetOf } from '../host.js';
+import type { HostElement } from '../types.js';
+export declare const render: import("@vue/runtime-core").RootRenderFunction<HostElement>, createApp: import("@vue/runtime-core").CreateAppFunction<HostElement>;
+/**
+ * Re-exported because a Vue app needs it and importing the host separately is a
+ * second module for one function: `<Teleport :to="adopt(el)">` is the explicit
+ * spelling of what `insert` now does implicitly, and it is the one to reach for
+ * when the same target is also addressed by hand.
+ *
+ * `widgetOf` for the same reason — and it is NEW here, not moved: Solid and React
+ * each carried their own copy and this adapter carried none, so a Vue app's only
+ * route to a widget was `materialize()`, the very call `widgetOf`'s destroyed-node
+ * refusal exists to intercept.
+ */
+export { adopt, widgetOf };
+/**
+ * Mount a Vue app into a widget the application owns.
+ *
+ * `createApp(...).mount(container)` wants a host element; an application has a
+ * `Gtk.Widget`. `adopt` bridges that and records what the container already held,
+ * so the app renders AFTER the application's own chrome rather than above it.
+ */
+export declare function mount(rootComponent: Parameters<typeof createApp>[0], container: Gtk.Widget): import("@vue/runtime-core").App<HostElement>;

package/lib/types/adapters/vue.spec.d.ts

@@ -0,0 +1,2 @@
+declare const _default: () => Promise<void>;
+export default _default;

package/lib/types/attrs.d.ts

@@ -0,0 +1,102 @@
+import type GObject from '@girs/gobject-2.0';
+import type { HostNode } from './types.js';
+/**
+ * A `notify::` handler.
+ *
+ * The host strips the emitting object (`next(...args.slice(1))` in `signals.ts`),
+ * so what reaches the callback is the ParamSpec alone. Declared HERE rather than in
+ * the generated file because it is the same for every property in GTK — and because
+ * a generator that emitted it would have to import GObject for a type that has
+ * nothing to do with the GIR it read.
+ */
+export type NotifyHandler = (pspec: GObject.ParamSpec) => void;
+declare const outParam: unique symbol;
+/**
+ * A signal parameter GIR declares `out`/`inout` with `caller-allocates="0"`.
+ *
+ * GJS still passes an argument in that position, and what it holds is whatever
+ * was in the memory the marshaller allocated: measured on gjs 1.88.1 / GTK
+ * 4.22.4, a handler on `Gtk.SpinButton::input` receives `new_value` as
+ * `6.9526682391035e-310`, and one on `Gtk.Editable::insert-text` receives
+ * `position` as `1711500784`. Both arrive as ordinary numbers. Nothing warns.
+ *
+ * So the slot is DECLARED — dropping it would silently shift every parameter
+ * after it — and given a type nothing can be read out of, and nothing but
+ * itself assigns to. Annotating the parameter `number` is then a compile error
+ * naming the position, which is the only place a reader would have looked.
+ *
+ * `caller-allocates="1"` is a different thing and keeps its real type: there the
+ * callee is handed a live object to FILL, as `Gtk.Overlay::get-child-position`
+ * is handed a `Gdk.Rectangle`.
+ */
+export type OutParam = {
+    readonly [outParam]: never;
+};
+/**
+ * What may appear as a child, mirroring Solid's own `JSX.Element`.
+ *
+ * The shape is copied from `solid-js/types/jsx.d.ts` because a renderer's element
+ * union is not a free choice: a string, a number and a boolean are all legal
+ * children there, an array of children is legal recursively, and a FUNCTION is
+ * not. Substituting our host node for the DOM's `Node` is the only change.
+ */
+export type ElementChild = HostNode | ElementChildren | string | number | boolean | null | undefined;
+export interface ElementChildren extends Array<ElementChild> {
+}
+/**
+ * Add the `.once` spelling of every event prop, without generating 2× the members.
+ *
+ * `signals.ts` accepts `onClickedOnce` for every `onClicked`, including every
+ * `onNotifyFooOnce`, which would be another ~1000 generated members. A mapped type
+ * derives them from the interface instead — including the ones a consumer adds by
+ * declaration merging.
+ */
+export type WithOnce<T> = T & {
+    [K in keyof T & string as K extends `on${string}` ? `${K}Once` : never]?: T[K];
+};
+/** Which of a container's slots this child goes into. Read by `setSlot()`. */
+export interface SlotAttribute {
+    slot?: string | null;
+}
+/**
+ * The `on:<raw-signal-name>` escape hatch, typed.
+ *
+ * `parseEventProp` takes `on:` + a signal name verbatim, which is how a signal
+ * whose name resists the camelCase derivation gets bound at all. The handler type
+ * is deliberately the widest one that is not `any`: parameters of `never` accept
+ * a handler declared with any parameters, so nothing a consumer writes is refused.
+ * An inline arrow's parameter arrives as `never` here, which is the price of an
+ * escape hatch that carries no signal-specific knowledge.
+ */
+export interface RawSignalAttributes {
+    [key: `on:${string}`]: ((...args: never[]) => unknown) | undefined;
+}
+/**
+ * Per-element attributes a JSX dialect needs on top of the GObject properties.
+ *
+ * `ref` and `children` MUST be real members of the element's own props. Measured:
+ * TypeScript unions `JSX.IntrinsicAttributes` into the attributes of a COMPONENT
+ * and not of an intrinsic element, so a `ref` that is not declared here is
+ * rejected outright (TS2322) — and `children` that is not declared makes every
+ * nested element an error (TS2559). `children` must also be OPTIONAL: a required
+ * one makes `<gtk-box/>` an error (TS2741).
+ *
+ * `T` is the widget's own instance type, so `ref={(el) => …}` infers `el` as
+ * `Gtk.Box` rather than the `unknown` a DOM renderer settles for.
+ */
+export interface JsxAttributes<T> extends SlotAttribute, RawSignalAttributes {
+    children?: ElementChild;
+    ref?: T | ((el: T) => void) | undefined;
+}
+/**
+ * Per-element attributes for Vue.
+ *
+ * Deliberately NOT `JsxAttributes`: Vue supplies `ref` and `key` itself through
+ * `VNodeProps`, which every registered component's props are intersected with.
+ * Declaring our own `ref` would intersect two different `ref` types and could
+ * leave the property unusable, so the Vue surface adds only what Vue does not —
+ * and `children` is a SLOT in Vue, never a prop.
+ */
+export interface VueAttributes extends SlotAttribute, RawSignalAttributes {
+}
+export {};

package/lib/types/buildable.spec.d.ts

@@ -0,0 +1,2 @@
+declare const _default: () => Promise<void>;
+export default _default;

package/lib/types/conformance/diagnostics.d.ts

@@ -14,4 +14,18 @@ export interface DiagnosticsGate {
  * what GLib's default writer does with `G_MESSAGES_DEBUG` unset: message-and-above
  * is printed, info/debug is not.
  */
+/**
+ * What a log record SAYS — and never the empty string.
+ *
+ * `MESSAGE` is a structured field like any other, and a record is allowed to
+ * arrive without one. The first version answered `String(raw ?? '')`, so such a
+ * record was counted and then described as nothing: a CI run failed with
+ * `GTK reported 1 diagnostic(s) that would have passed at exit 0:` followed by a
+ * BLANK LIST, over a test that had just constructed 164 widgets. A gate that can
+ * count a failure but not name it sends the reader back to guessing, which is the
+ * state this whole module exists to end.
+ *
+ * So a record with no `MESSAGE` is rendered from the fields it does carry.
+ */
+export declare function describeLogRecord(fields: unknown, decoder?: TextDecoder): string;
 export declare function installDiagnosticsGate(): DiagnosticsGate;

package/lib/types/conformance/index.d.ts

@@ -1,4 +1,4 @@
-export { installDiagnosticsGate, type DiagnosticsGate } from './diagnostics.js';
+export { describeLogRecord, installDiagnosticsGate, type DiagnosticsGate } from './diagnostics.js';
 import type Gtk from '@girs/gtk-4.0';
 import type { ChildPolicy, HostElement, WidgetDescriptor } from '../types.js';
 /** Every method name a policy names, so the check does not have to know the shapes. */
@@ -22,5 +22,28 @@ export declare function gtkChildren(widget: Gtk.Widget): Gtk.Widget[];
 export declare const gtkChildTypes: (widget: Gtk.Widget) => string[];
 /** The addresses a host element's element-children occupy, in shadow order. */
 export declare function addressesOf(el: HostElement): Gtk.Widget[];
+/**
+ * First STRICT descendant matching `pred`, breadth-first over the REAL GTK tree.
+ *
+ * Both showcase probes wrote this, identically. It excludes the root on purpose:
+ * every caller is asking "what did the renderer put INSIDE this", and a root that
+ * matches its own predicate answers a different question.
+ *
+ * Breadth-first is not incidental either — `findDescendant(root, w => w instanceof
+ * Gtk.Box)` on an Adwaita window finds an INTERNAL box of the header bar before
+ * anything the author wrote, which is why a probe that needs a specific widget
+ * reaches it through a landmark (a button's `get_parent()`) rather than by type.
+ * Measured: with a search-by-type version, authoring `orientation="horizontal"`
+ * still printed PROBE: PASS with byte-identical output.
+ */
+export declare function findDescendant(root: Gtk.Widget, pred: (widget: Gtk.Widget) => boolean): Gtk.Widget | null;
+/**
+ * Every widget in a subtree, ROOT FIRST and depth-first — GTK's own document order.
+ *
+ * Depth-first and not breadth-first, because the callers that collect (rather than
+ * search) are asserting on ORDER: "the rows land before the counter row" is only a
+ * claim about the tree if the walk visits it the way the tree reads.
+ */
+export declare function descendants(root: Gtk.Widget): Gtk.Widget[];
 /** Recursive GType dump — what a devtools tree walk would show. */
 export declare function dumpTree(widget: Gtk.Widget, depth?: number): string;

package/lib/types/conformance/vectors.d.mts

@@ -0,0 +1,34 @@
+import Gtk from 'gi://Gtk?version=4.0';
+import type { DiagnosticsGate } from './diagnostics.js';
+/** A tree in the one shape all three adapters can build: tag, props, children. */
+export interface VectorElement {
+    readonly tag: string;
+    readonly props?: Record<string, unknown>;
+    /** A string child is a TEXT NODE — never a bulk `setElementText` write. */
+    readonly children?: readonly VectorNode[];
+}
+export type VectorNode = string | VectorElement;
+/** `h('GtkBox', { spacing: 6 }, h('GtkLabel', null, 'hi'))`. */
+export declare const h: (tag: string, props?: Record<string, unknown> | null, ...children: VectorNode[]) => VectorElement;
+export interface VectorMount {
+    /**
+     * Re-render the SAME tree shape with new props and new text, flushed — Vue's
+     * `nextTick`, React's `flushSync`, Solid's synchronous effects.
+     */
+    patch(tree: VectorElement): Promise<void>;
+    unmount(): void;
+}
+export interface VectorHarness {
+    /** Names the describe block, so a failure says which adapter. */
+    readonly framework: string;
+    /** Mount `tree` into a container the application owns, flushed on return. */
+    mount(container: Gtk.Widget, tree: VectorElement): Promise<VectorMount>;
+}
+/**
+ * Every vector, against one adapter.
+ *
+ * `gated` rather than a bare `describe`: `@gjsify/unit` keeps ONE
+ * `beforeEach`/`afterEach` slot per module and nulls both when a describe returns,
+ * so hooks registered outside the block cover exactly one sibling.
+ */
+export declare function runAdapterVectors(harness: VectorHarness, gate: DiagnosticsGate): Promise<void>;