@gjsify/adwaita-gobject-native 0.61.0 → 0.63.0

package/README.md

@@ -99,3 +99,12 @@ above is node-gi on Linux.
 slot is `'polyfill'` rather than `'none'`, which is an exception to the convention in
 [AGENTS.md](../AGENTS.md): node-gi makes the engine measurable on Linux CI, and a leg that cannot
 run is a claim nobody checks.
+
+## Settings and Gio.File
+
+`createRealGioSettingsSubject` and `createRealGioFileChooserSubject` hold ADR 0099's
+`SETTINGS_VECTORS` and ADR 0100's `FILE_CHOOSER_VECTORS` to real `Gio.Settings` and `Gio.File`.
+Settings needs a compiled schema directory and the `memory` backend (never dconf); the subject
+reads the schema from an explicit source because the default one is fixed at first use. Without a
+Gtk typelib (Android) the file-chooser subject uses a stand-in and `rowsFor` drops the rows that
+are about GTK. Report: `docs/reports/2026-10-12-real-gio-settings-file.md`.

package/lib/esm/file-chooser-subject.js

@@ -0,0 +1 @@
+import"./_virtual/_rolldown/runtime.js";function patternsOf(e){if(typeof e.to_gvariant!=`function`)return e.patterns;let[,t]=e.to_gvariant().recursiveUnpack();return t.map(([,e])=>e)}const e=[/^the enum members the subset raises/,/FileFilter/,/FileDialog/],t=[/^new GLib\.Error\(domain, code, message\) reads back/,/^a GLib\.Error names its domain when printed/];function rowsFor(n,r){let i=r.filter(e=>!t.some(t=>t.test(e.rule)));return n.realGtk?i:i.filter(t=>!(t.row===`dialog`||t.row===`filter`||e.some(e=>e.test(t.rule))))}function loadGtk(e){try{return e(`Gtk`,`4.0`)}catch{return null}}function createGtkStandIn(e){let t=e(`GObject`,`2.0`),n=t.registerClass({GTypeName:`GjsifyStandInFileFilter`,Properties:{name:t.ParamSpec.string(`name`,`name`,`name`,t.ParamFlags.READWRITE,null)}},class GjsifyStandInFileFilter extends t.Object{constructor(...e){super(...e),this.patterns=[]}static new(){return new GjsifyStandInFileFilter}get_name(){return this.name}set_name(e){this.name=e}add_pattern(e){this.patterns.push(e)}});class FileDialog{constructor(e={}){this.title=null,this.modal=!0,this.initial_name=null,this.filters=null,this.default_filter=null,Object.assign(this,e)}}let r={FAILED:0,CANCELLED:1,DISMISSED:2};return Object.defineProperty(r,Symbol.for(`nodeGiErrorDomain`),{value:{name:`gtk-dialog-error-quark`}}),{FileFilter:n,FileDialog,DialogError:r}}function createRealGioFileChooserSubject(e,{dir:t,standIn:n=!1}){let r=e(`GLib`,`2.0`),i=e(`Gio`,`2.0`),a=n?null:loadGtk(e);a?.init_check?.();let o=a??createGtkStandIn(e),s=null,c=[],answer=function(e,n,a){c=[];for(let e=0;this.filters&&e<this.filters.get_n_items();e++)c.push(patternsOf(this.filters.get_item(e)));let l;if(s===null)l={error:new r.Error(o.DialogError,o.DialogError.DISMISSED,`Dismissed by user`)};else{let e=i.File.new_for_path(r.build_filenamev([t,s.basename]));s.contents?.length?e.replace_contents(s.contents,null,!1,i.FileCreateFlags.NONE,null):s.contents&&e.replace(null,!1,i.FileCreateFlags.NONE,null).close(null),l={file:e}}r.idle_add(r.PRIORITY_DEFAULT,()=>(a(this,l),r.SOURCE_REMOVE))},finish=e=>{if(`error`in e)throw e.error;return e.file};return Object.assign(o.FileDialog.prototype,{open:answer,save:answer,open_finish:finish,save_finish:finish}),{name:a?`node-gi (real Gio and Gtk)`:`node-gi (real Gio, Gtk stand-in)`,isOracle:!0,realGtk:a!==null,GLib:r,Gio:i,Gtk:o,script:e=>void(s=e),pickerFilters:()=>c,cancelled:()=>{let e=new i.Cancellable;return e.cancel(),e},dispose:()=>{let e=i.File.new_for_path(t),n=e.enumerate_children(`standard::name`,0,null);for(let e=n.next_file(null);e;e=n.next_file(null))n.get_child(e).delete(null);e.delete(null)}}}export{createRealGioFileChooserSubject,rowsFor};

package/lib/esm/index.js

@@ -1 +1 @@
-import{createRealGioEngine as e}from"./engine.js";import{useRealGObjectEngine as t}from"./opt-in.js";import{createRealGioListStore as n}from"./list-store.js";import{SUBSET_SUBJECT_NAME as r,createSubsetSubject as i}from"./vector-subject.js";export{r as SUBSET_SUBJECT_NAME,e as createRealGioEngine,n as createRealGioListStore,i as createSubsetSubject,t as useRealGObjectEngine};
+import{createRealGioEngine as e}from"./engine.js";import{createRealGioFileChooserSubject as t,rowsFor as n}from"./file-chooser-subject.js";import{useRealGObjectEngine as r}from"./opt-in.js";import{createRealGioListStore as i}from"./list-store.js";import{SUBSET_SUBJECT_NAME as a,createSubsetSubject as o}from"./vector-subject.js";import{createRealGioSettingsSubject as s}from"./settings-subject.js";export{a as SUBSET_SUBJECT_NAME,e as createRealGioEngine,t as createRealGioFileChooserSubject,i as createRealGioListStore,s as createRealGioSettingsSubject,o as createSubsetSubject,n as rowsFor,r as useRealGObjectEngine};

package/lib/esm/settings-subject.js

@@ -0,0 +1 @@
+import"./_virtual/_rolldown/runtime.js";function createRealGioSettingsSubject(e,{schemaDir:t,schemaId:n}){let r=e(`GLib`,`2.0`);r.setenv(`GSETTINGS_SCHEMA_DIR`,t,!0),r.setenv(`GSETTINGS_BACKEND`,`memory`,!0);let i=e(`Gio`,`2.0`),a=i.SettingsSchemaSource.new_from_directory(t,null,!1),o=new Proxy(i.Settings,{construct(e,t){let{schema_id:n,...r}=t[0]??{},i=n===void 0?null:a.lookup(n,!1);return Reflect.construct(e,i?[{...r,settings_schema:i}]:t)}});return{name:`node-gi (real Gio.Settings, memory backend)`,isOracle:!0,Settings:o,reset:()=>{let e=new o({schema_id:n});for(let t of e.list_keys())e.reset(t)}}}export{createRealGioSettingsSubject};

package/lib/types/file-chooser-subject.d.ts

@@ -0,0 +1,38 @@
+import type { RequireGi } from './engine.js';
+/** What the next `open`/`save` picks: a file named `basename` (holding `contents`, if given), or a dismissal. */
+export type RealScriptedPick = {
+    readonly basename: string;
+    readonly contents?: Uint8Array;
+} | null;
+/** The `FileChooserSubject` of `@gjsify/adwaita-core/conformance`, restated structurally. */
+export interface RealGioFileChooserSubject {
+    readonly name: string;
+    readonly isOracle: boolean;
+    readonly GLib: any;
+    readonly Gio: any;
+    readonly Gtk: any;
+    script(pick: RealScriptedPick): void;
+    pickerFilters(): string[][];
+    cancelled(): unknown;
+    /** `true` when `Gtk` is the real namespace, `false` on the stand-in. */
+    readonly realGtk: boolean;
+    /** Removes the temporary directory the picks were made in. */
+    dispose(): void;
+}
+export interface RealGioFileChooserOptions {
+    /** A directory the picks land in; the subject creates files in it and `dispose` empties it. */
+    readonly dir: string;
+    /** Use the Gtk stand-in even where Gtk loads: how the Android path is exercised on a host. */
+    readonly standIn?: boolean;
+}
+/** The vectors a subject can answer: all of them on real GTK, those not about GTK otherwise. */
+export declare function rowsFor<V extends {
+    readonly rule: string;
+    readonly row: string;
+}>(subject: Pick<RealGioFileChooserSubject, 'realGtk'>, vectors: readonly V[]): V[];
+/**
+ * The subject for `FILE_CHOOSER_VECTORS` over real Gio. `isOracle` is `true`: GLib and Gio ARE the
+ * real classes, so the subset-only refusals (a picked file has no path, a cancelled `open`,
+ * the ADR 0100 § 2 refusals) are skipped exactly as on the GJS leg.
+ */
+export declare function createRealGioFileChooserSubject(requireGi: RequireGi, { dir, standIn }: RealGioFileChooserOptions): RealGioFileChooserSubject;

package/lib/types/file-chooser.node-gi.spec.d.ts

@@ -0,0 +1,2 @@
+import type { RequireGi } from './engine.js';
+export declare const realGioFileChooserSuite: (requireGi: RequireGi, standIn?: boolean) => () => Promise<void>;

package/lib/types/index.d.ts

@@ -4,3 +4,7 @@ export type { RequireGi } from './engine.js';
 export { createRealGioListStore } from './list-store.js';
 export type { RealGioListStore } from './list-store.js';
 export { createSubsetSubject, SUBSET_SUBJECT_NAME } from './vector-subject.js';
+export { createRealGioSettingsSubject } from './settings-subject.js';
+export type { RealGioSettingsOptions, RealGioSettingsSubject } from './settings-subject.js';
+export { createRealGioFileChooserSubject, rowsFor } from './file-chooser-subject.js';
+export type { RealGioFileChooserOptions, RealGioFileChooserSubject } from './file-chooser-subject.js';

package/lib/types/settings-subject.d.ts

@@ -0,0 +1,27 @@
+import type { RequireGi } from './engine.js';
+/** The shape `SETTINGS_VECTORS` drive; structural, so this package needs no dependency on the vectors. */
+export interface RealGioSettingsSubject {
+    readonly name: string;
+    readonly isOracle: boolean;
+    readonly Settings: new (props: {
+        schema_id: string;
+        path?: string;
+    }) => {
+        readonly schema_id: string;
+        readonly path: string;
+        [method: string]: any;
+    };
+    /** Forgets everything written, so a vector starts from the defaults. */
+    reset(): void;
+}
+export interface RealGioSettingsOptions {
+    /** A directory holding the compiled `gschemas.compiled` of the schema under test. */
+    readonly schemaDir: string;
+    /** The schema id `reset` clears; the vectors' own schema. */
+    readonly schemaId: string;
+}
+/**
+ * The subject for `SETTINGS_VECTORS` over real Gio. `isOracle` is `true`: this is real `Gio.Settings`,
+ * so the subset-only refusals are skipped exactly as on the GJS leg.
+ */
+export declare function createRealGioSettingsSubject(requireGi: RequireGi, { schemaDir, schemaId }: RealGioSettingsOptions): RealGioSettingsSubject;

package/lib/types/settings.node-gi.spec.d.ts

@@ -0,0 +1,2 @@
+import type { RequireGi } from './engine.js';
+export declare const realGioSettingsSuite: (requireGi: RequireGi) => () => Promise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gjsify/adwaita-gobject-native",
-    "version": "0.61.0",
+    "version": "0.63.0",
     "description": "Real GObject behind @gjsify/adwaita-core's GObject subset — a GObjectEngine whose property store and signal bus are a live GObject reached through node-gi (ADR 0105)",
     "type": "module",
     "module": "lib/esm/index.js",
@@ -36,12 +36,13 @@
         "adwaita"
     ],
     "dependencies": {
-        "@gjsify/adwaita-core": "^0.61.0"
+        "@gjsify/adwaita-core": "^0.63.0"
     },
     "devDependencies": {
-        "@gjsify/cli": "^0.61.0",
+        "@gjsify/app-settings": "^0.63.0",
+        "@gjsify/cli": "^0.63.0",
         "@gjsify/node-gi": "file:../../node-gi/node-gi",
-        "@gjsify/unit": "^0.61.0",
+        "@gjsify/unit": "^0.63.0",
         "@types/node": "^25.9.2",
         "typescript": "^6.0.3"
     },