@gjsify/adwaita-core 0.64.12-next.280 → 0.64.12

package/lib/esm/list.js

@@ -1 +1 @@
-import"./_virtual/_rolldown/runtime.js";function normalizeComboOptions(e){return Array.isArray(e)?e.map(e=>{if(typeof e==`string`)return{value:e,label:e};let t=e?.value===void 0?String(e?.label??``):String(e.value);return{value:t,label:e?.label===void 0?t:String(e.label)}}):[]}function parseListModel(e){if(!e)return[];try{return normalizeComboOptions(JSON.parse(e))}catch{return[]}}const e=-1;function clampListSelection(e,t){return Number.isFinite(e)&&e>=0&&e<t?e:t===0?-1:0}function sameItem(e,t){return e!==void 0&&t!==void 0&&e.value===t.value&&e.label===t.label}function listItemsChanged(e,t){let n=e??[],r=t??[],i=Math.min(n.length,r.length),a=0;for(;a<i&&sameItem(n[a],r[a]);)a++;let o=0;for(;o<i-a&&sameItem(n[n.length-1-o],r[r.length-1-o]);)o++;let s=n.length-a-o,c=r.length-a-o;return s===0&&c===0?null:{position:a,removed:s,added:c}}export{e as ADW_COMBO_NO_SELECTION,clampListSelection,listItemsChanged,normalizeComboOptions,parseListModel};
+import"./_virtual/_rolldown/runtime.js";function readListModel(e){let t=e;if(typeof t?.get_n_items!=`function`||typeof t.get_item!=`function`)return[];let n=[],r=t.get_n_items();for(let e=0;e<r;e++){let r=t.get_item(e);n.push(typeof r?.string==`string`?r.string:r??{})}return n}function normalizeComboOptions(e){return(Array.isArray(e)?e:readListModel(e)).map(e=>{if(typeof e==`string`)return{value:e,label:e};let t=e?.value===void 0?String(e?.label??``):String(e.value);return{value:t,label:e?.label===void 0?t:String(e.label)}})}function parseListModel(e){if(!e)return[];try{return normalizeComboOptions(JSON.parse(e))}catch{return[]}}const e=-1;function sameItem(e,t){return e!==void 0&&t!==void 0&&e.value===t.value&&e.label===t.label}function listItemsChanged(e,t){let n=e??[],r=t??[],i=Math.min(n.length,r.length),a=0;for(;a<i&&sameItem(n[a],r[a]);)a++;let o=0;for(;o<i-a&&sameItem(n[n.length-1-o],r[r.length-1-o]);)o++;let s=n.length-a-o,c=r.length-a-o;return s===0&&c===0?null:{position:a,removed:s,added:c}}export{e as ADW_COMBO_NO_SELECTION,listItemsChanged,normalizeComboOptions,parseListModel};

package/lib/esm/markup.js

@@ -1,4 +1,4 @@
 import"./_virtual/_rolldown/runtime.js";import{GTK_WIDGET_EXPAND as e,attributeOf as t,hostTagOf as n,isValueBasedBooleanAttr as r,propertyOf as i,widgetLengthStyle as a}from"./tags.js";function element(e,t,n,r,i,a){let o=`  `.repeat(e),s=n.map(([e,t])=>t===null?e:`${e}=${r(t)}`),c=i.length===0,l=c?a?` />`:`></${t}>`:`>`,u=`${o}<${[t,...s].join(` `)}${l}`,d=u.length<=80||s.length===0?u:[`${o}<${t}`,...s.map(e=>`${o}  ${e}`),`${o}${c?a?`/>`:`></${t}>`:`>`}`].join(`
 `);return c?d:[d,...i,`${o}</${t}>`].join(`
-`)}const htmlText=e=>e.replace(/&/g,`&amp;`).replace(/</g,`&lt;`),htmlQuote=e=>{let t=e.includes(`"`)&&!e.includes(`'`)?`'`:`"`;return`${t}${e.replace(/&/g,`&amp;`).replace(t===`"`?/"/g:/'/g,t===`"`?`&quot;`:`&#39;`)}${t}`};function refuseBehaviour(e,t=`sharedTreeHtml`){let n=[e.bindings&&`bindings`,e.breakpoints&&`breakpoints`].filter(Boolean);if(n.length>0)throw Error(`${t} has no markup for \`${e.tag}\`'s ${n.join(` and `)} (ADR 0093); a bound property and a breakpoint are behaviour, and a renderer has to observe them.`)}function htmlElement(i,o){refuseBehaviour(i);let s=[];i.id!==void 0&&s.push([`id`,i.id]);let c=[],l=n(i.tag);for(let[n,o]of Object.entries(i.props??{})){let i=t(n);typeof o==`boolean`?r(l,i)?s.push([i,o?`true`:`false`]):o?s.push([i,null]):e.some(e=>e===i)&&s.push([i,`false`]):s.push([i,String(o)]);let u=a(i,o);u!==void 0&&u[1]!==null&&c.push(`${u[0]}: ${u[1]};`)}c.length>0&&s.push([`style`,c.join(` `)]),i.styleClasses!==void 0&&i.styleClasses.length>0&&s.push([`class`,i.styleClasses.join(` `)]);let u=i.extensions?.strings;u!==void 0&&s.push([`strings`,JSON.stringify(u.map(e=>e.value))]),i.slot!==void 0&&s.push([`slot`,i.slot]);let d=[...(i.extensions?.responses??[]).map(e=>{let t=[`id=${htmlQuote(e.id)}`];e.appearance!==void 0&&t.push(`appearance=${htmlQuote(e.appearance)}`),e.enabled===!1&&t.push(`enabled="false"`);let n=htmlText(e.label);return`${`  `.repeat(o+1)}<adw-alert-response ${t.join(` `)}>${n}</adw-alert-response>`}),...(i.children??[]).map(e=>htmlElement(e,o+1))];return element(o,n(i.tag),s,htmlQuote,d,!1)}function sharedTreeHtml(e){return htmlElement(e,0)}function xmlNameOf(e){let t=/^(Adw|Gtk)([A-Z]\w*)$/.exec(e);if(t===null)throw Error(`sharedTreeNativeScriptXml: ${e} is not an Adw or Gtk class name`);return{prefix:t[1].toLowerCase(),member:t[2]}}const xmlQuote=e=>{let t=e.includes(`"`)?`'`:`"`;return`${t}${e.replace(/&/g,`&amp;`).replace(/</g,`&lt;`).replace(t===`"`?/"/g:/'/g,t===`"`?`&quot;`:`&apos;`)}${t}`};function prefixesOf(e,t){t.add(xmlNameOf(e.tag).prefix);for(let n of e.children??[])prefixesOf(n,t);return t}const o=[`columns`,`cssClasses`,`direction`,`modal`,`rows`,`visibility`];function xmlElement(e,t,n){refuseBehaviour(e,`sharedTreeNativeScriptXml`);let{prefix:r,member:a}=xmlNameOf(e.tag),s=`${r}:${a}`,c=[...n];e.id!==void 0&&c.push([`id`,e.id]);for(let[t,n]of Object.entries(e.props??{})){let r=i(t);if(o.includes(r))throw Error(`sharedTreeNativeScriptXml: \`${e.tag}\`'s '${t}' has no XML spelling — the attribute would reach NativeScript's own \`${r}\` (ADR 0112). Set it from Blueprint, a .ui file or \`set_${t.replace(/-/g,`_`)}()\`.`);c.push([r,String(n)])}e.styleClasses!==void 0&&e.styleClasses.length>0&&c.push([`styleClasses`,e.styleClasses.join(` `)]);let l=e.extensions?.strings;l!==void 0&&c.push([`strings`,JSON.stringify(l.map(e=>e.value))]);let u=(e.children??[]).map(e=>{if(e.slot===void 0)return xmlElement(e,t+1,[]);let n=`  `.repeat(t+1),r=`${s}.${e.slot}`;return[`${n}<${r}>`,xmlElement(e,t+2,[]),`${n}</${r}>`].join(`
+`)}const htmlText=e=>e.replace(/&/g,`&amp;`).replace(/</g,`&lt;`),htmlQuote=e=>{let t=e.includes(`"`)&&!e.includes(`'`)?`'`:`"`;return`${t}${e.replace(/&/g,`&amp;`).replace(t===`"`?/"/g:/'/g,t===`"`?`&quot;`:`&#39;`)}${t}`};function refuseBehaviour(e,t=`sharedTreeHtml`){let n=[e.bindings&&`bindings`,e.breakpoints&&`breakpoints`].filter(Boolean);if(n.length>0)throw Error(`${t} has no markup for \`${e.tag}\`'s ${n.join(` and `)} (ADR 0093); a bound property and a breakpoint are behaviour, and a renderer has to observe them.`)}function htmlElement(i,o){refuseBehaviour(i);let s=[];i.id!==void 0&&s.push([`id`,i.id]);let c=[],l=n(i.tag);for(let[n,o]of Object.entries(i.props??{})){let i=t(n);typeof o==`boolean`?r(l,i)?s.push([i,o?`true`:`false`]):o?s.push([i,null]):e.some(e=>e===i)&&s.push([i,`false`]):s.push([i,String(o)]);let u=a(i,o);u!==void 0&&u[1]!==null&&c.push(`${u[0]}: ${u[1]};`)}c.length>0&&s.push([`style`,c.join(` `)]),i.styleClasses!==void 0&&i.styleClasses.length>0&&s.push([`class`,i.styleClasses.join(` `)]);let u=i.extensions?.strings;u!==void 0&&s.push([`strings`,JSON.stringify(u.map(e=>e.value))]),i.slot!==void 0&&s.push([`slot`,i.slot]);let d=[...(i.extensions?.responses??[]).map(e=>{let t=[`id=${htmlQuote(e.id)}`];e.appearance!==void 0&&t.push(`appearance=${htmlQuote(e.appearance)}`),e.enabled===!1&&t.push(`enabled="false"`);let n=htmlText(e.label);return`${`  `.repeat(o+1)}<adw-alert-response ${t.join(` `)}>${n}</adw-alert-response>`}),...(i.children??[]).map(e=>htmlElement(e,o+1))];return element(o,n(i.tag),s,htmlQuote,d,!1)}function sharedTreeHtml(e){return htmlElement(e,0)}function xmlNameOf(e){let t=/^(Adw|Gtk)([A-Z]\w*)$/.exec(e);if(t===null)throw Error(`sharedTreeNativeScriptXml: ${e} is not an Adw or Gtk class name`);return{prefix:t[1].toLowerCase(),member:t[2]}}const xmlQuote=e=>{let t=e.includes(`"`)?`'`:`"`;return`${t}${e.replace(/&/g,`&amp;`).replace(/</g,`&lt;`).replace(t===`"`?/"/g:/'/g,t===`"`?`&quot;`:`&apos;`)}${t}`};function isModelAttribute(e){return e.tag===`GtkStringList`&&e.slot===`model`&&e.id===void 0&&e.extensions?.strings!==void 0}function prefixesOf(e,t){t.add(xmlNameOf(e.tag).prefix);for(let n of e.children??[])isModelAttribute(n)||prefixesOf(n,t);return t}const o=[`columns`,`cssClasses`,`direction`,`modal`,`rows`,`visibility`];function xmlElement(e,t,n){refuseBehaviour(e,`sharedTreeNativeScriptXml`);let{prefix:r,member:a}=xmlNameOf(e.tag),s=`${r}:${a}`,c=[...n];e.id!==void 0&&c.push([`id`,e.id]);for(let[t,n]of Object.entries(e.props??{})){let r=i(t);if(o.includes(r))throw Error(`sharedTreeNativeScriptXml: \`${e.tag}\`'s '${t}' has no XML spelling — the attribute would reach NativeScript's own \`${r}\` (ADR 0112). Set it from Blueprint, a .ui file or \`set_${t.replace(/-/g,`_`)}()\`.`);c.push([r,String(n)])}e.styleClasses!==void 0&&e.styleClasses.length>0&&c.push([`styleClasses`,e.styleClasses.join(` `)]);let l=[];for(let t of e.children??[]){let e=t.extensions?.strings;if(e===void 0){l.push(t);continue}if(!isModelAttribute(t))throw Error(`sharedTreeNativeScriptXml: \`${t.tag}\`'s strings have no XML spelling — \`strings\` is construct-only (ADR 0122); only a \`GtkStringList\` without an id at a \`model\` slot is written, as the parent's \`model\` attribute.`);c.push([`model`,JSON.stringify(e.map(e=>e.value))])}if(e.extensions?.strings!==void 0)throw Error(`sharedTreeNativeScriptXml: \`${e.tag}\`'s strings have no XML spelling — \`strings\` is construct-only (ADR 0122), so a list is written as its parent's \`model\` attribute.`);let u=l.map(e=>{if(e.slot===void 0)return xmlElement(e,t+1,[]);let n=`  `.repeat(t+1),r=`${s}.${e.slot}`;return[`${n}<${r}>`,xmlElement(e,t+2,[]),`${n}</${r}>`].join(`
 `)});return element(t,s,c,xmlQuote,u,!0)}function sharedTreeNativeScriptXml(e){return xmlElement(e,0,[[`xmlns`,`http://schemas.nativescript.org/tns.xsd`],...[...prefixesOf(e,new Set)].sort().map(e=>[`xmlns:${e}`,`~/${e}`])])}export{o as NATIVESCRIPT_HOST_MEMBERS,sharedTreeHtml,sharedTreeNativeScriptXml};

package/lib/esm/option-list.js

@@ -0,0 +1 @@
+import"./_virtual/_rolldown/runtime.js";import{GObjectObject as e,ListModel as t,ParamFlags as n,ParamSpec as r,checkPropertyValue as i,registerBaseClass as a}from"./gobject.js";import{MAXUINT32 as o}from"./glib-paths.js";import{INVALID_LIST_POSITION as s}from"./gtk-string-list.js";import{listItemsChanged as c,normalizeComboOptions as l,parseListModel as u}from"./list.js";const d=new WeakMap,f=new WeakMap;function notWritable(e,t){throw Error(`Property ${e}.${t} is not writable`)}var p=class GjsifyOptionObject extends e{constructor(e){super(e??void 0),d.has(this)||d.set(this,{value:``,label:``})}static new(e,t){let n=new GjsifyOptionObject;return d.set(n,{value:String(e),label:String(t)}),n}static fromInput(e){let[t]=l([e]);return GjsifyOptionObject.new(t.value,t.label)}get value(){return d.get(this).value}set value(e){notWritable(`GjsifyOptionObject`,`value`)}get label(){return d.get(this).label}set label(e){notWritable(`GjsifyOptionObject`,`label`)}toOption(){let e=d.get(this);return{value:e.value,label:e.label}}};a(p,`GjsifyOptionObject`,{},[r.string(`value`,``,``,n.READABLE,``),r.string(`label`,``,``,n.READABLE,``)]);var m=class GjsifyOptionList extends e{constructor(e){let t={...e};delete t.options,super(t),f.set(this,(e?.options??[]).map(e=>p.fromInput(e)))}static new(e){return new GjsifyOptionList({options:e})}get item_type(){return p.$gtype}set item_type(e){notWritable(`GjsifyOptionList`,`item-type`)}get itemType(){return this.item_type}set itemType(e){notWritable(`GjsifyOptionList`,`item-type`)}get n_items(){return f.get(this).length}set n_items(e){notWritable(`GjsifyOptionList`,`n-items`)}vfunc_get_item_type(){return this.item_type}vfunc_get_n_items(){return this.n_items}vfunc_get_item(e){return f.get(this)[e]??null}toOptions(){return f.get(this).map(e=>e.toOption())}append(e){this.splice(this.n_items,0,[e])}remove(e){this.splice(e,1,[])}splice(e,t,n){this.spliceItems(e,t,(n??[]).map(e=>p.fromInput(e)))}find(e){let t=f.get(this).findIndex(t=>t.value===e);return t===-1?s:t}reconcile(e){let t=l(e??[]),n=c(this.toOptions(),t);n&&this.spliceItems(n.position,n.removed,t.slice(n.position,n.position+n.added).map(e=>p.new(e.value,e.label)))}spliceItems(e,t,n){let r=f.get(this);if(!Number.isFinite(e)||e<0||e+t>r.length){console.warn(`GLib-GIO-CRITICAL: g_list_store_splice: assertion 'position + n_removals <= n_items' failed`);return}t===0&&n.length===0||(r.splice(e,t,...n),this.items_changed(e,t,n.length),t!==n.length&&this.notify(`n-items`))}};a(m,`GjsifyOptionList`,{},[r.uint(`n-items`,``,``,n.READABLE,0,o,0)],[t]);const h=r.object(`model`,``,``,n.READWRITE,t);function readModelWrite(e,t){if(e==null)return null;if(typeof e==`string`)return t.reconcile(u(e)),t;let n=e;return(typeof n.get_n_items!=`function`||typeof n.get_item!=`function`)&&i(h,e),e}export{m as GjsifyOptionList,p as GjsifyOptionObject,readModelWrite};

package/lib/esm/rows.js

@@ -1 +1 @@
-import"./_virtual/_rolldown/runtime.js";import{SpinState as e}from"./adjustment.js";import{ADW_COMBO_NO_SELECTION as t,clampListSelection as n,listItemsChanged as r,normalizeComboOptions as i}from"./list.js";var ExpanderState=class{constructor(){this._expanded=!1,this._listeners=new Set}subscribe(e){return this._listeners.add(e),()=>{this._listeners.delete(e)}}_emit(){for(let e of[...this._listeners])e(this._expanded)}get expanded(){return this._expanded}setExpanded(e){let t=!!e;return t===this._expanded?!1:(this._expanded=t,this._emit(),!0)}toggle(){return this.setExpanded(!this._expanded)}expand(){return this.setExpanded(!0)}collapse(){return this.setExpanded(!1)}},ComboState=class{constructor(){this._options=[],this._selected=0,this._listeners=new Set,this._itemListeners=new Set}subscribe(e){return this._listeners.add(e),()=>{this._listeners.delete(e)}}subscribeItems(e){return this._itemListeners.add(e),()=>{this._itemListeners.delete(e)}}_emit(e){let t={selected:this._selected,value:this.selectedValue,label:this.selectedLabel,interactive:e};for(let e of[...this._listeners])e(t)}_setIndex(e,t){return e===this._selected?!1:(this._selected=e,this._emit(t),!0)}get model(){return this._options.map(e=>({value:e.value,label:e.label}))}setModel(e){let t=this._options,i=Array.isArray(e)?e:[],a=r(t,i);if(this._options=i.map(e=>({value:e.value,label:e.label})),this._selected=n(this._selected,i.length),a)for(let e of[...this._itemListeners])e(a);this._emit(!1)}get selectedIndex(){return this._selected}get presentsChooser(){return this._options.length>1}setSelectedIndex(e){return this._setIndex(Number.isFinite(e)?e:0,!1)}get selectedValue(){return this._options[this._selected]?.value??``}get selectedLabel(){return this._options[this._selected]?.label??``}setSelectedValue(e){let t=this._options.findIndex(t=>t.value===e);return t>=0?this.setSelectedIndex(t):!1}hasIndex(e){return Number.isFinite(e)&&e>=0&&e<this._options.length}select(e){return!this.hasIndex(e)||e===this._selected?!1:this._setIndex(e,!0)}get count(){return this._options.length}},ToggleGroupState=class{constructor(){this._labels=[],this._selected=0,this._listeners=new Set}subscribe(e){return this._listeners.add(e),()=>{this._listeners.delete(e)}}_emit(){let e={selected:this._selected,value:this.selectedValue};for(let t of[...this._listeners])t(e)}get labels(){return this._labels}setLabels(e){this._labels=Array.isArray(e)?e:[],this._selected>=this._labels.length&&(this._selected=0)}get selected(){return this._selected}setSelected(e){let t=Number.isFinite(e)?e:0;return t===this._selected||t<0||t>=this._labels.length?!1:(this._selected=t,this._emit(),!0)}get selectedValue(){return this._labels[this._selected]??``}get count(){return this._labels.length}};function keptToggles(e){let t=new Set,n=[];for(let r of e){let e=r.name??null;e!==null&&t.has(e)||(e!==null&&t.add(e),n.push(r))}return n}function toggleIndexOfName(e,t){return e.indexOf(t)}export{t as ADW_COMBO_NO_SELECTION,ComboState,ExpanderState,e as SpinState,ToggleGroupState,keptToggles,i as normalizeComboOptions,toggleIndexOfName};
+import"./_virtual/_rolldown/runtime.js";import{SpinState as e}from"./adjustment.js";import{ADW_COMBO_NO_SELECTION as t,listItemsChanged as n,normalizeComboOptions as r}from"./list.js";var ExpanderState=class{constructor(){this._expanded=!1,this._listeners=new Set}subscribe(e){return this._listeners.add(e),()=>{this._listeners.delete(e)}}_emit(){for(let e of[...this._listeners])e(this._expanded)}get expanded(){return this._expanded}setExpanded(e){let t=!!e;return t===this._expanded?!1:(this._expanded=t,this._emit(),!0)}toggle(){return this.setExpanded(!this._expanded)}expand(){return this.setExpanded(!0)}collapse(){return this.setExpanded(!1)}};function watchItemsChanged(e,t){if(typeof e.connect!=`function`||typeof e.disconnect!=`function`)return()=>{};let n=e.connect(`items-changed`,(...e)=>{let[n,r,i]=e.slice(1);t({position:n??0,removed:r??0,added:i??0})});return()=>void e.disconnect?.(n)}var ComboState=class{constructor(){this._model=null,this._options=[],this._selected=-1,this._unwatch=null,this._listeners=new Set,this._itemListeners=new Set,this._notifyListeners=new Set}subscribe(e){return this._listeners.add(e),()=>{this._listeners.delete(e)}}subscribeNotify(e){return this._notifyListeners.add(e),()=>{this._notifyListeners.delete(e)}}subscribeItems(e){return this._itemListeners.add(e),()=>{this._itemListeners.delete(e)}}_emit(e){let t={selected:this._selected,value:this.selectedValue,label:this.selectedLabel,interactive:e};for(let e of[...this._listeners])e(t)}_notify(e){for(let t of[...this._notifyListeners])t(e)}_emitItems(e){for(let t of[...this._itemListeners])t(e)}_setIndex(e,t){return e===this._selected?!1:(this._selected=e,this._emit(t),this._notify(`selected`),this._notify(`selected-item`),!0)}get model(){return this._model}get options(){return this._options.map(e=>({value:e.value,label:e.label}))}get selectedItem(){return!this._model||this._selected<0?null:this._model.get_item(this._selected)??null}setModel(e){if(e===this._model)return;this._unwatch?.(),this._unwatch=null;let t=this._options;this._model=e,this._options=e?r(e):[],this._selected=this._options.length===0?-1:0,e&&(this._unwatch=watchItemsChanged(e,e=>this._onItemsChanged(e)));let i=n(t,this._options);i&&this._emitItems(i),this._emit(!1),e&&(this._notify(`selected`),this._notify(`selected-item`)),this._notify(`model`)}_onItemsChanged(e){this._options=this._model?r(this._model):[],this._emitItems(e);let t=this._selected,n=this._options.length;if(t===-1){if(n===0)return;this._selected=0,this._emit(!1),this._notify(`selected-item`),this._notify(`selected`);return}if(!(t<e.position)){if(t>=e.position+e.removed){this._selected=t+e.added-e.removed,this._emit(!1),this._notify(`selected`);return}this._selected=n===0?-1:Math.min(e.position,n-1),this._emit(!1),this._notify(`selected-item`),this._selected!==t&&this._notify(`selected`)}}get selectedIndex(){return this._selected}get presentsChooser(){return this._options.length>1}setSelectedIndex(e){return this.hasIndex(e)?this._setIndex(e,!1):!1}get selectedValue(){return this._options[this._selected]?.value??``}get selectedLabel(){return this._options[this._selected]?.label??``}setSelectedValue(e){let t=this._options.findIndex(t=>t.value===e);return t>=0?this.setSelectedIndex(t):!1}hasIndex(e){return Number.isFinite(e)&&e>=0&&e<this._options.length}select(e){return!this.hasIndex(e)||e===this._selected?!1:this._setIndex(e,!0)}get count(){return this._options.length}},ToggleGroupState=class{constructor(){this._labels=[],this._selected=0,this._listeners=new Set}subscribe(e){return this._listeners.add(e),()=>{this._listeners.delete(e)}}_emit(){let e={selected:this._selected,value:this.selectedValue};for(let t of[...this._listeners])t(e)}get labels(){return this._labels}setLabels(e){this._labels=Array.isArray(e)?e:[],this._selected>=this._labels.length&&(this._selected=0)}get selected(){return this._selected}setSelected(e){let t=Number.isFinite(e)?e:0;return t===this._selected||t<0||t>=this._labels.length?!1:(this._selected=t,this._emit(),!0)}get selectedValue(){return this._labels[this._selected]??``}get count(){return this._labels.length}};function keptToggles(e){let t=new Set,n=[];for(let r of e){let e=r.name??null;e!==null&&t.has(e)||(e!==null&&t.add(e),n.push(r))}return n}function toggleIndexOfName(e,t){return e.indexOf(t)}export{t as ADW_COMBO_NO_SELECTION,ComboState,ExpanderState,e as SpinState,ToggleGroupState,keptToggles,r as normalizeComboOptions,toggleIndexOfName};

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

@@ -1,7 +1,7 @@
 import type { BindingFlag, BlueprintTemplate, GObjectConstructor, GObjectInstance, GObjectNamespace } from '../gobject.js';
 import type { ConstructHarness } from './constructs.js';
 /** The rows of ADR 0096 § 2 that carry a claim; every one needs a vector. */
-export declare const GOBJECT_ROWS: readonly ["registerClass", "field-form", "ParamSpec", "Signals", "instance API", "type_ensure", "vfunc", "binding engine", "template"];
+export declare const GOBJECT_ROWS: readonly ["registerClass", "field-form", "ParamSpec", "Signals", "instance API", "type_ensure", "vfunc", "binding engine", "template", "interface", "object property"];
 export type GObjectRow = (typeof GOBJECT_ROWS)[number];
 /** A template, in both spellings: GtkBuilder XML for GJS, the projected tree for a port. */
 export interface GObjectTemplateSource {
@@ -19,6 +19,24 @@ export interface GObjectSubject {
     readonly Widget?: GObjectConstructor;
     /** The value to put in `Template`. */
     template(source: GObjectTemplateSource): unknown;
+    /**
+     * The `Gio.ListModel` token a vector puts in `Implements` — the real interface on an oracle,
+     * the core's token on the subset. Absent where no Gio is reachable, which skips those rows.
+     */
+    readonly ListModel?: unknown;
+    /**
+     * Something carrying a READ-WRITE object-kind property called `model` whose value type is
+     * `Gio.ListModel`, and a value that property accepts.
+     *
+     * A REAL C object (`Gtk.DropDown` + `Gtk.StringList`) on the oracles, because a JS-registered
+     * class is not one for this row: GJS's auto-accessors store without a GValue conversion, so a
+     * JS class would accept every value the C property refuses and the refusal vectors would
+     * measure nothing. It needs a display, so an oracle offers it only where Gtk initialised.
+     */
+    objectProperty?(): {
+        readonly instance: GObjectInstance;
+        readonly accepted: GObjectInstance;
+    };
     /** The binding engine; `bind_property` on GJS, which is not exported by the ports. */
     bind(source: GObjectInstance, sourceProperty: string, target: GObjectInstance, targetProperty: string, flags: readonly BindingFlag[]): void;
 }
@@ -27,6 +45,10 @@ export interface GObjectVector {
     readonly rule: string;
     readonly holds: 'oracle' | 'subset';
     readonly widget?: true;
+    /** Needs {@link GObjectSubject.ListModel}; skipped where the subject has no Gio. */
+    readonly iface?: true;
+    /** Needs {@link GObjectSubject.objectProperty}; skipped where the subject cannot build one. */
+    readonly objectProperty?: true;
     readonly observe: (subject: GObjectSubject) => unknown;
     readonly shows: unknown;
 }

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

@@ -16,8 +16,8 @@ export type { ComboRowLike, RowAccessorSubject, RowAccessorVector, StringListLik
 export type { RadioGroupStep, RadioGroupVector } from './checks.js';
 export { CHECK_GROUP_VECTORS, driveCheckGroupVectors } from './check-group.js';
 export type { CheckButtonLike, CheckGroupSubject, CheckGroupVector } from './check-group.js';
-export { COMBO_CHOOSER_VECTORS, COMBO_SELECTION_VECTORS, TOGGLE_ACTIVE_NAME_VECTORS } from './rows.js';
-export type { ComboChooserVector, ComboSelectionStep, ComboSelectionVector, ToggleActiveNameVector } from './rows.js';
+export { COMBO_CHOOSER_VECTORS, COMBO_ITEMS_CHANGED_VECTORS, COMBO_SELECTION_VECTORS, TOGGLE_ACTIVE_NAME_VECTORS, } from './rows.js';
+export type { ComboChooserVector, ComboItemsChangedVector, ComboSelectionStep, ComboSelectionVector, ComboSpliceStep, ToggleActiveNameVector, } from './rows.js';
 export { VIEW_STACK_ICON_NAME_VECTORS, VIEW_STACK_PAGE_VECTORS, VIEW_STACK_VECTORS } from './view-stack.js';
 export type { ViewStackIconNameVector, ViewStackPageDescriptorVector, ViewStackVector, ViewStackVectorChange, ViewStackVectorOp, ViewStackVectorPage, } from './view-stack.js';
 export { NAVIGATION_VIEW_VECTORS, collectNavigationState, navigationEventLog, runNavigationSteps, } from './navigation-view.js';
@@ -32,8 +32,8 @@ export { MENU_BUTTON_DIRECTION_VECTORS, SPLIT_BUTTON_CONTENT_VECTORS, SPLIT_BUTT
 export type { SplitButtonContentStep, SplitButtonContentVector, SplitButtonDirectionVector, SplitButtonDropdownVector, SplitButtonMenuActivationVector, SplitButtonRootStateVector, SplitButtonStyleClassVector, SplitButtonTooltipVector, } from './split-button.js';
 export { ADJUSTMENT_AUTHORED_VECTORS, ADJUSTMENT_PARSE_VECTORS, ADJUSTMENT_SNAP_VECTORS } from './adjustment.js';
 export type { AdjustmentAuthoredVector, AdjustmentParseVector, AdjustmentSnapVector } from './adjustment.js';
-export { LIST_ITEMS_CHANGED_VECTORS, LIST_MODEL_OWNERSHIP_VECTORS, LIST_NORMALIZE_VECTORS, LIST_PARSE_VECTORS, LIST_SELECTION_CLAMP_VECTORS, TAB_PAGES_ITEMS_CHANGED_VECTORS, applyListReadback, replayTabPagesAsSplices, } from './list.js';
-export type { ListItemsChangedVector, ListModelOwnershipVector, ListNormalizeVector, ListParseVector, ListReadbackOp, ListSelectionClampVector, TabPagesItemsChangedVector, } from './list.js';
+export { LIST_ITEMS_CHANGED_VECTORS, LIST_MODEL_OWNERSHIP_VECTORS, LIST_NORMALIZE_VECTORS, LIST_PARSE_VECTORS, TAB_PAGES_ITEMS_CHANGED_VECTORS, applyListMutation, applyListReadback, listModelForInput, replayTabPagesAsSplices, } from './list.js';
+export type { ListItemsChangedVector, ListModelOwnershipVector, ListNormalizeVector, ListParseVector, ListReadbackOp, TabPagesItemsChangedVector, } from './list.js';
 export { COLUMN_VIEW_SORT_VECTORS, GRID_VIEW_COLUMN_VECTORS, LIST_VIEW_SELECT_VECTORS } from './list-view.js';
 export type { ColumnViewSortVector, GridViewColumnVector, ListViewClick, ListViewSelectVector } from './list-view.js';
 export { TREE_EXPANDER_LAYOUT_VECTORS, TREE_EXPANDER_SHORTCUT_VECTORS } from './tree-expander.js';

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

@@ -1,4 +1,5 @@
-import type { AdwComboOption, AdwListItemsChanged, AdwListModel, AdwListModelInput } from '../list.js';
+import type { AdwComboOption, AdwListItemsChanged, AdwListModel, AdwListModelInput, AdwListModelSource } from '../list.js';
+import { GjsifyOptionList } from '../option-list.js';
 import type { TabViewPagesChange } from '../tab-view.js';
 /** One {@link normalizeComboOptions} expectation. */
 export interface ListNormalizeVector {
@@ -24,6 +25,19 @@ export interface ListNormalizeVector {
  * a citation, and that sentence named no table).
  */
 export declare const LIST_NORMALIZE_VECTORS: ReadonlyArray<ListNormalizeVector>;
+/**
+ * A {@link LIST_NORMALIZE_VECTORS} row as the value a `model` PROPERTY write takes.
+ *
+ * ADR 0122 § 4 took the array arm off that property, so the ARRAY rows go in as a list built
+ * out of the array: the normaliser still runs on them, one step further in, as
+ * {@link GjsifyOptionList}'s own constructor. The model-source rows go STRAIGHT through —
+ * that is the shape the door now takes, and they are what proves a surface reads items by
+ * position rather than recognising one class.
+ *
+ * Lives here rather than in each driving suite because WHICH door a row reaches through is
+ * part of what the table claims, and two copies of that answer are two claims.
+ */
+export declare function listModelForInput(input: AdwListModelInput): AdwListModelSource;
 /** One {@link parseListModel} expectation — the JSON attribute door. */
 export interface ListParseVector {
     /** The attribute value exactly as authored. */
@@ -65,20 +79,21 @@ export interface ListItemsChangedVector {
  * change, which is `g_list_store_splice`'s shape.
  */
 export declare const LIST_ITEMS_CHANGED_VECTORS: ReadonlyArray<ListItemsChangedVector>;
-/** What a caller does to the array it read back out of a `model` accessor. */
+/** What a caller does to the options they hold, or to the model they were handed. */
 export type ListReadbackOp = 'append' | 'relabel-first' | 'remove-first';
-/** One read-mutate-assign expectation — see {@link LIST_MODEL_OWNERSHIP_VECTORS}. */
+/** One ownership expectation — see {@link LIST_MODEL_OWNERSHIP_VECTORS}. */
 export interface ListModelOwnershipVector {
     initial: AdwListModel;
     /**
-     * Which array the caller mutates: the one `model` handed BACK, or the one they
-     * assigned and kept. Two doors into the same failure, and closing one leaves the other.
+     * WHAT the caller mutates. `input` is the array they authored and handed to
+     * `GjsifyOptionList.new`; `options` is the array read back out of `toOptions()`; `model`
+     * is the list itself, through its own `Gio.ListModel` API. The first two must move
+     * nothing and the third must move everything, and which of the three a surface gets
+     * wrong is the difference between a leak and a dropped redraw.
      */
-    source: 'readback' | 'input';
+    source: 'options' | 'input' | 'model';
     op: ListReadbackOp;
-    /** Whether the mutated array is assigned back to `model` afterwards. */
-    assign: boolean;
-    /** The model the surface holds when the row is done. */
+    /** The options the surface holds when the row is done. */
     model: AdwListModel;
     /** The splice the surface emits, or `null` where it emits none. */
     itemsChanged: AdwListItemsChanged | null;
@@ -87,50 +102,42 @@ export interface ListModelOwnershipVector {
     rule: string;
 }
 /**
- * WHO OWNS THE ARRAY a `model` accessor hands back — read, mutate, assign.
+ * WHO OWNS THE OPTIONS — the arrays a caller holds on either side of the model, and the
+ * model itself.
  *
  * The browser suite drives `LIST_MODEL_OWNERSHIP_VECTORS` through `<adw-combo-row>` and
- * `<gtk-drop-down>`, and core drives it through `ComboState` itself, which is the surface
- * where BOTH doors are reachable: the element setters run `normalizeComboOptions` and so
- * close the input door on their own, while `ComboState.setModel` takes a normalised model
- * straight from a caller.
+ * `<gtk-drop-down>`, and core drives it through `ComboState`.
  *
- * THE ROWS EXIST BECAUSE THE SPLICE MADE THIS A SILENT FAILURE. Under the full rebuild
- * every assignment redrew the list, so an aliased array was invisible; the splice decides
- * what to redraw by COMPARING the assignment against the stored model, and an alias makes
- * both sides read the new value — "nothing changed", nothing drawn, no error. `append`
- * with `assign` is the pattern that regressed, `relabel-first` is the same failure one
- * level down through a shared descriptor (which is why the copy is per ITEM and not just
- * per array), and the `assign: false` row is the invariant the other two rest on: what a
- * caller holds is THEIRS, so touching it moves nothing until they hand it back.
+ * READ, MUTATE, ASSIGN IS GONE AS A PATTERN, and that is what reshaped these rows. ADR 0122
+ * § 4 narrows `model` to a real `Gio.ListModel`, so there is no array to assign back: the
+ * only way to change a model in place is its own API, and handing over a DIFFERENT list is a
+ * replacement that resets the selection. What survives from the array era is the half that
+ * was never about assignment — an array a caller holds is THEIRS on both sides, going in
+ * (`GjsifyOptionList` copies each descriptor into an item) and coming out (`toOptions`
+ * copies each item back). `relabel-first` is why the copy is per ITEM rather than per array:
+ * a shared descriptor would let the text under a selection move with nothing emitted, which
+ * is the failure `GjsifyOptionObject`'s read-only `label` exists to prevent.
+ *
+ * The `model` rows are the other side of the same invariant: the ONE door that does move the
+ * list emits the one minimal splice for it, in each of the three directions a splice can go.
  */
 export declare const LIST_MODEL_OWNERSHIP_VECTORS: ReadonlyArray<ListModelOwnershipVector>;
 /**
- * The caller-side half of one {@link LIST_MODEL_OWNERSHIP_VECTORS} row: mutate the array a
- * `model` accessor handed back, IN PLACE, and hand the same array back.
+ * The caller-side half of an `options`/`input` row: mutate the array, IN PLACE, and hand the
+ * same array back.
  *
  * In place and returning its argument is the whole point — a helper that built a new array
  * would test the pattern that never broke.
  */
 export declare function applyListReadback(model: AdwComboOption[], op: ListReadbackOp): AdwComboOption[];
-/** One {@link clampListSelection} expectation. */
-export interface ListSelectionClampVector {
-    selected: number;
-    length: number;
-    result: number;
-    rule: string;
-}
 /**
- * Where a selection lands after the model under it was replaced.
+ * The model-side half: the same three ops through the list's own `Gio.ListModel` API.
  *
- * The browser suite drives `LIST_SELECTION_CLAMP_VECTORS` through `<adw-combo-row>` and
- * through that element only. `<gtk-drop-down>` REFUSES an out-of-range `selected` set
- * outright — its published contract, with `ComboState.hasIndex` as the shared bounds — so
- * the starting index these rows replace cannot be put on that element in the first place.
- * One row is narrower than the vector even on the row, and `adw-row-state.spec.ts` says
- * so in place.
+ * `relabel-first` is a splice rather than an assignment because {@link GjsifyOptionObject}
+ * is read-only — changing what an item says means putting a different item there, which is
+ * also how `Gio.ListStore` would have to spell it.
  */
-export declare const LIST_SELECTION_CLAMP_VECTORS: ReadonlyArray<ListSelectionClampVector>;
+export declare function applyListMutation(model: GjsifyOptionList, op: ListReadbackOp): void;
 /** One {@link tabViewItemsChanged} expectation, with the order it replays. */
 export interface TabPagesItemsChangedVector {
     change: TabViewPagesChange;

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

@@ -1,12 +1,21 @@
-import type { AdwComboOption, ComboStateChange } from '../rows.js';
+import type { AdwComboOption, ComboNotify, ComboStateChange } from '../rows.js';
 /**
  * One mutation in a combo scenario. DATA, not a closure: a renderer suite
  * replays these against a real widget (set the options, pick from the chooser)
  * and compares what the user would see.
+ *
+ * `setModel` carries the model's CONTENTS and not a model object, so the table stays
+ * portable: each renderer builds whatever model it holds — a `GjsifyOptionList` in the
+ * core and in both browser elements, the same on the NativeScript host — out of these
+ * descriptors. `setModelAgain` is the one step that is about the model's IDENTITY rather
+ * than its contents, and it is a step rather than a flag because that is the only way to
+ * spell "assign the object you are already holding" in data.
  */
 export type ComboSelectionStep = {
     op: 'setModel';
     model: ReadonlyArray<AdwComboOption>;
+} | {
+    op: 'setModelAgain';
 } | {
     op: 'setSelectedIndex';
     index: number;
@@ -23,7 +32,7 @@ export interface ComboSelectionVector {
     steps: readonly ComboSelectionStep[];
     /** `selectedIndex` afterwards. */
     selected: number;
-    /** `selectedValue` afterwards — `''` when the index sits outside the options. */
+    /** `selectedValue` afterwards — `''` when nothing is selected. */
     value: string;
     /** `selectedLabel` afterwards — the text the inline value / button shows. */
     label: string;
@@ -33,6 +42,12 @@ export interface ComboSelectionVector {
      * gated on `interactive`.
      */
     emitted: ReadonlyArray<ComboStateChange>;
+    /**
+     * Every `notify::` the scenario owes, flattened in EMISSION ORDER — see the module
+     * header. Driven by the surfaces that have real GObject properties; a DOM renderer
+     * skips it.
+     */
+    notified: ReadonlyArray<ComboNotify>;
     rule: string;
 }
 /**
@@ -46,6 +61,51 @@ export interface ComboSelectionVector {
  * replaced. That first change is in `emitted` for exactly that reason.
  */
 export declare const COMBO_SELECTION_VECTORS: ReadonlyArray<ComboSelectionVector>;
+/** One splice applied to the model a combo state is HOLDING. */
+export interface ComboSpliceStep {
+    position: number;
+    removed: number;
+    added: ReadonlyArray<AdwComboOption>;
+}
+/** One `items-changed` → selection scenario. */
+export interface ComboItemsChangedVector {
+    name: string;
+    /** The model the state holds before the splice. */
+    initial: ReadonlyArray<AdwComboOption>;
+    /** Where the selection sits before the splice — `-1` leaves the sentinel in place. */
+    selected: number;
+    splice: ComboSpliceStep;
+    /** `selectedIndex` after the splice. */
+    result: number;
+    /** `selectedValue` after the splice. */
+    value: string;
+    /** The `notify::` the splice owes, in order — EMPTY where GTK emits none. */
+    notified: ReadonlyArray<ComboNotify>;
+    rule: string;
+}
+/**
+ * What a splice on the HELD model does to the selection — `GtkSingleSelection`'s
+ * `items-changed` handler, which `Adw.ComboRow` and `Gtk.DropDown` both sit on.
+ *
+ * NEW IN ADR 0122, and only reachable since it: while `model` was an Array the only way to
+ * change the list was to replace it, so this whole axis had no spelling. A live
+ * `Gio.ListModel` moves under the widget, and WHERE it moved decides whether the selection
+ * follows the item, shifts with it, or is clamped because the item is gone.
+ *
+ * Every row is MEASURED (`combo-probe2.js`), and the `notified` column is the point of the
+ * table: the order here is the INVERSE of a `selected` write — `selected-item` first,
+ * because what changed is the item and the index is downstream of it. The shift row
+ * notifies `selected` ALONE for the mirror-image reason (the item did not change, only its
+ * position), and the replace-in-place row notifies `selected-item` alone.
+ *
+ * `<adw-combo-row>` drives the table through its own DOM, which is where the splice has to
+ * land for a user to see it: the outcome columns, the rebuilt `<option>` list, and the
+ * SILENCE a DOM surface owes (a model moving underneath is not a user pick, so no
+ * `notify::selected` event). The `notified` column itself stays with the core suite — it is
+ * a GObject property feed, and no port publishes one for this path yet; `subscribeNotify`
+ * is the seam a host that owns real properties will re-emit from.
+ */
+export declare const COMBO_ITEMS_CHANGED_VECTORS: ReadonlyArray<ComboItemsChangedVector>;
 /** One `presentsChooser` expectation. */
 export interface ComboChooserVector {
     count: number;

package/lib/types/engine.d.ts

@@ -1,16 +1,50 @@
-import type { Binding, BindingFlag, ClassLike, GObjectInstance, ParamSpec, RegisteredClass, SignalHandler } from './gobject.js';
+import type { Binding, BindingFlag, ClassLike, GInterface, GObjectInstance, GType, ParamSpec, RegisteredClass, SignalHandler } from './gobject.js';
+/**
+ * The kinds that carry a VALUE a declaration can also spell as a default — the five the subset
+ * has had since ADR 0105, and the only ones a signal parameter may take.
+ */
+export type ForeignScalarKind = 'string' | 'boolean' | 'int' | 'uint' | 'double';
 /** The property kinds the subset has, and the only ones a declared widget property may take. */
-export type ForeignPropertyKind = 'string' | 'boolean' | 'int' | 'uint' | 'double';
+export type ForeignPropertyKind = ForeignScalarKind | 'object';
 /** One property a widget class declares at its `extends`. `default` is the unset value. */
-export interface ForeignProperty {
-    readonly kind: ForeignPropertyKind;
+export interface ForeignScalarProperty {
+    readonly kind: ForeignScalarKind;
     readonly default?: string | boolean | number | null;
     readonly nick?: string;
     readonly blurb?: string;
 }
-/** One signal a widget class declares at its `extends`, in the subset's parameter vocabulary. */
+/**
+ * A property holding another GObject, or `null` — `Adw.ComboRow:model` (ADR 0122 § 6).
+ *
+ * `valueType` IS REQUIRED, and that is the whole reason this is a separate arm rather than an
+ * optional field on the one above. `g_param_spec_object` takes the object type as an argument and
+ * has no default for it, so a declaration that omitted it would leave the engine to guess between
+ * "any GObject" and the interface the widget actually means — and a `model` that accepted any
+ * GObject is the refusal ADR 0122 § 6 exists to make. It is the subset's own token (`TYPE_OBJECT`
+ * or an interface of the subset), NOT node-gi's: a port that named a real GType would have to
+ * import node-gi to describe its own properties, which is the dependency this vocabulary exists
+ * to keep out. The engine that has node-gi translates.
+ *
+ * There is no `default`. `g_param_spec_object`'s default is always `NULL`, so a declaration
+ * cannot carry another one.
+ */
+export interface ForeignObjectProperty {
+    readonly kind: 'object';
+    readonly valueType: GType | GInterface;
+    readonly nick?: string;
+    readonly blurb?: string;
+}
+/** One property a widget class declares at its `extends`. */
+export type ForeignProperty = ForeignScalarProperty | ForeignObjectProperty;
+/**
+ * One signal a widget class declares at its `extends`, in the subset's parameter vocabulary.
+ *
+ * SCALARS ONLY. An object parameter would need its own type beside the kind, as the property arm
+ * does, and nothing declares one — `items-changed` is three `uint`s. Widening it to
+ * `ForeignPropertyKind` would make `{ kind: 'object' }` spellable with no type and no meaning.
+ */
 export interface ForeignSignal {
-    readonly param_types?: readonly ForeignPropertyKind[];
+    readonly param_types?: readonly ForeignScalarKind[];
 }
 /**
  * What a widget class declares at its `extends` — GJS's `registerClass` meta, in the port's own
@@ -20,6 +54,16 @@ export interface ForeignClassMeta {
     readonly GTypeName: string;
     readonly Properties?: Readonly<Record<string, ForeignProperty>>;
     readonly Signals?: Readonly<Record<string, ForeignSignal>>;
+    /**
+     * REFUSED, by name, and declared here so the refusal is findable from the call site.
+     *
+     * `Implements` is the one meta key route D cannot carry (ADR 0122 § 4): a foreign-parent class
+     * is registered over a `@nativescript/core` base that is not a GObject, so there is no GType
+     * to add an interface to. A widget that needs `Gio.ListModel` holds one instead of being one —
+     * which is what `Adw.ComboRow:model` does. Ignoring the key would leave a class that says it
+     * implements the interface and does not, which is the silent outcome ADR 0105 refuses.
+     */
+    readonly Implements?: readonly unknown[];
 }
 export interface GObjectEngine {
     /** Names the engine in a diagnostic; `'pure-js'` for the default one. */

package/lib/types/gobject.d.ts

@@ -1,5 +1,5 @@
 import type { SharedTreeNode } from './conformance/shared-trees.js';
-import type { GObjectEngine } from './engine.js';
+import type { ForeignClassMeta, GObjectEngine } from './engine.js';
 /** What `registerClass` accepts as `Template`: the projected tree of a `?template` import (ADR 0096 § 4). */
 export type BlueprintTemplate = SharedTreeNode;
 /** The subset asked for something it does not list. `feature` is the name that was refused. */
@@ -16,6 +16,44 @@ export declare const TYPE_BOOLEAN: GType;
 export declare const TYPE_INT: GType;
 export declare const TYPE_UINT: GType;
 export declare const TYPE_DOUBLE: GType;
+/**
+ * `G_TYPE_OBJECT` — the value type of an object-kind property that takes ANY GObject
+ * ({@link ParamSpec.object}). A property that takes one interface names the interface instead.
+ */
+export declare const TYPE_OBJECT: GType;
+/** What an interface token carries; the token itself is {@link GInterface}. */
+export interface GInterfaceInfo {
+    /** The GIR spelling, as it reads in a refusal and in `items_changed`'s arity message. */
+    readonly name: string;
+    readonly gtype: GType;
+    /** The `vfunc_*` an implementor MUST define. */
+    readonly vfuncs: readonly string[];
+    /** Instance method → the `vfunc_*` it calls through. */
+    readonly methods: Readonly<Record<string, string>>;
+    /** Instance method → the signal it emits, with that signal's arity enforced. */
+    readonly emitters: Readonly<Record<string, string>>;
+    /** The signals the interface brings into the implementor's own signal table. */
+    readonly signals: Readonly<Record<string, readonly GType[]>>;
+}
+/**
+ * One interface of the subset — the value a class puts in `Implements`, and the right-hand side
+ * of `instanceof`.
+ *
+ * It is callable-shaped so `x instanceof ListModel` type-checks like any other `instanceof`;
+ * calling or constructing it throws, because an interface is not a class.
+ */
+export type GInterface = GInterfaceInfo & (abstract new (...args: never[]) => object);
+/**
+ * `Gio.ListModel` — the portable list model's interface, and the whole of the subset's interface
+ * support (ADR 0122 § 2).
+ *
+ * `items-changed` is an ordinary declared signal of every implementor, so an engine that knows
+ * nothing about interfaces registers and emits it like any other; `items_changed()` is the
+ * emitter GIR gives it, down to the arity message real GJS produces for a short call.
+ */
+export declare const ListModel: GInterface;
+/** Whether `instance`'s class chain declares `iface` — what `instanceof ListModel` answers. */
+export declare function implementsInterface(instance: object, iface: GInterface): boolean;
 /**
  * `GObject.Value`, string-only (ADR 0096 Amendment 2). `init` takes `TYPE_STRING`; any other type
  * is refused by name. Real GObject logs a CRITICAL for `get_*`/`set_*` on an uninitialised value and
@@ -38,7 +76,7 @@ export declare const ParamFlags: {
     readonly CONSTRUCT: 4;
     readonly CONSTRUCT_ONLY: 8;
 };
-export type ParamKind = 'boolean' | 'string' | 'int' | 'uint' | 'double';
+export type ParamKind = 'boolean' | 'string' | 'int' | 'uint' | 'double' | 'object';
 export declare class ParamSpec {
     readonly kind: ParamKind;
     readonly name: string;
@@ -47,6 +85,8 @@ export declare class ParamSpec {
     readonly flags: number;
     readonly minimum?: number;
     readonly maximum?: number;
+    /** An object-kind property's value type: {@link TYPE_OBJECT} or the one interface it takes. */
+    readonly valueType?: GType | GInterface;
     private readonly defaultValue;
     private constructor();
     static boolean(name: string, nick: string, blurb: string, flags: number, defaultValue: boolean): ParamSpec;
@@ -54,8 +94,30 @@ export declare class ParamSpec {
     static int(name: string, nick: string, blurb: string, flags: number, minimum: number, maximum: number, defaultValue: number): ParamSpec;
     static uint(name: string, nick: string, blurb: string, flags: number, minimum: number, maximum: number, defaultValue: number): ParamSpec;
     static double(name: string, nick: string, blurb: string, flags: number, minimum: number, maximum: number, defaultValue: number): ParamSpec;
+    /**
+     * `GObject.ParamSpec.object` — a property that holds another GObject, or `null`.
+     *
+     * `valueType` is {@link TYPE_OBJECT} for "any GObject" or an interface token for a property
+     * that takes only implementors of it (`Adw.ComboRow:model`, which takes a `Gio.ListModel`).
+     * The default is ALWAYS `null`: `g_param_spec_object` has no other, and a write that does
+     * not satisfy `valueType` throws rather than being stored (ADR 0122 § 6).
+     */
+    static object(name: string, nick: string, blurb: string, flags: number, valueType: GType | GInterface): ParamSpec;
     get_default_value(): unknown;
 }
+/**
+ * The type check `g_object_set_property` does before a value reaches the store — the ONE place a
+ * declared property refuses a value, so every object-kind property refuses the same way.
+ *
+ * Only object-kind specs have anything to check: the other five kinds take what GJS's generated
+ * accessors take, which is anything (`_generateAccessors` stores without converting, and the
+ * subset's vectors hold it to that). The messages are the ones real GJS produces for a C object
+ * property, measured on `Gtk.DropDown:model` under GJS 1.88.01 / GTK 4.22.5 — a JS-registered
+ * class is NOT an oracle for them, because GJS's auto-accessors skip the GValue conversion that
+ * raises them. The pointer GJS prints in the "not a subclass" message is left out; nothing can
+ * match it.
+ */
+export declare function checkPropertyValue(spec: ParamSpec, value: unknown): void;
 /** GJS's own symbols, so a class written in the field form (`static [GObject.properties] = …`) registers. */
 export declare const META_SYMBOLS: {
     readonly GTypeName: symbol;
@@ -111,8 +173,10 @@ export interface RegisteredClass {
     readonly typeName: string;
     readonly gtype: GType;
     readonly properties: readonly ParamSpec[];
-    /** Signal name → its parameter types. */
+    /** Signal name → its parameter types; an implemented interface's are merged in. */
     readonly signals: Readonly<Record<string, readonly GType[]>>;
+    /** The interfaces of `Implements`, each one of {@link ACCEPTED_INTERFACES}. */
+    readonly interfaces: readonly GInterface[];
     readonly template?: BlueprintTemplate;
     readonly internalChildren: readonly string[];
     readonly cssName?: string;
@@ -130,6 +194,12 @@ export interface GObjectInstance {
     disconnect(id: number): void;
     emit(signal: string, ...args: unknown[]): void;
 }
+/**
+ * `Implements` on a foreign-parent class: refused by name, on EVERY engine (ADR 0122 § 4). It is
+ * the core's refusal rather than each engine's so that route D says the same thing on the engine
+ * that could never do it and on the one that merely does not.
+ */
+export declare function refuseForeignInterfaces(meta: ForeignClassMeta): void;
 /**
  * The default {@link GObjectEngine}: per-instance `Map`s behind a `WeakMap`, the only one the
  * browser can have. Registration needs nothing of it — a `$gtype` here is a token, not a GType.
@@ -213,7 +283,7 @@ export declare const UNLOCKED_VFUNCS: Readonly<Record<string, readonly string[]>
  * resolve through the registry like a registered class's own. The door is one that names the
  * missing widget model: such a class has no event system to fall through to.
  */
-export declare function registerBaseClass(klass: ClassLike, typeName: string, signals: Readonly<Record<string, readonly GType[]>>, properties?: readonly ParamSpec[], engine?: GObjectEngine): void;
+export declare function registerBaseClass(klass: ClassLike, typeName: string, signals: Readonly<Record<string, readonly GType[]>>, properties?: readonly ParamSpec[], interfaces?: readonly GInterface[], engine?: GObjectEngine): void;
 export type GObjectConstructor = new (params?: Record<string, unknown>) => GObjectInstance;
 /** `GObject.Object` for a registered class with no widget model beneath it. */
 export declare class GObjectObject {
@@ -241,6 +311,7 @@ export interface GObjectNamespace {
     readonly TYPE_INT: GType;
     readonly TYPE_UINT: GType;
     readonly TYPE_DOUBLE: GType;
+    readonly TYPE_OBJECT: GType;
     readonly GTypeName: symbol;
     readonly GTypeFlags: symbol;
     readonly interfaces: symbol;

package/lib/types/gtk-platform.d.ts

@@ -42,6 +42,8 @@ export declare const GDK_KEYS: Readonly<{
     readonly KEY_Up: 65362;
     readonly KEY_Right: 65363;
     readonly KEY_Down: 65364;
+    /** XF86Back: the hardware / mouse back key, and what Android's back button is delivered as. */
+    readonly KEY_Back: 269025062;
 }>;
 /** A DOM `key` as the keysym GTK would deliver: a Latin-1 character is its own code point, lowercased. */
 export declare function keyvalOfKey(key: string): number;
@@ -109,6 +111,13 @@ export interface GtkPlatform {
 }
 /** A port is always on a display, so `Settings.get_default()` is never null (real GTK: null before `Gtk.init`). */
 export declare function createGtkPlatform(host: PlatformHost): GtkPlatform;
+/**
+ * Runs `event` through the key controllers attached to `widget`, as GTK does for a key the widget's
+ * toplevel receives: the first controller whose `key-pressed` / `key-released` handler returns true
+ * takes it. For keys the platform delivers by another road than the widget's own key listener (the
+ * Android back button); the result is whether a controller handled it.
+ */
+export declare function deliverKeyToControllers(widget: object, event: HostKeyEvent): boolean;
 /** `Gtk.Widget.add_controller` / `remove_controller` for the widgets of a port. */
 export declare function widgetControllerMembers(host: PlatformHost): {
     add_controller(this: object, controller: EventControllerKey): void;