@gjsify/utils 0.52.0 → 0.54.0

package/lib/esm/core.js

@@ -1 +1 @@
-import{makeCallable as e}from"./callable.js";import{deferEmit as t}from"./defer.js";import{initErrorV8Methods as n}from"./error.js";import{GIO_ERROR_TO_NODE as r,GLIB_FILE_ERROR_TO_NODE as i,createGLibFileError as a,createNodeError as o,isNotFoundError as s}from"./gio-errors.js";import{registerGlobal as c}from"./globals.js";import{TARGET_OSES as l,hostOs as u,hostPlatform as d,isDarwin as f,isLinux as p,isTargetOs as m,isWin32 as h}from"./host-os.js";import{notImplemented as g,warnNotImplemented as _}from"./message.js";import{queueMicrotask as v}from"./microtask.js";import{encodePathForFileUrl as y,isWindowsPath as b,lastPathSeparatorIndex as x,pathToFileUrlHref as S,splitPathComponents as C}from"./path-shape.js";import{PROBED_GI_LIBDIRS as w,TYPELIB_SUBDIR as T,giLibraryDirsForTypelibDir as E,splitSearchPath as D,systemGiLibraryDirs as O}from"./system-gi-dirs.js";import{mapMachine as k,mapSysname as A}from"./platform-names.js";import{structuredClone as j}from"./structured-clone.js";import{hasProcfs as M,hostExecPath as N,hostPid as P,hostPpid as F,readProcessMemory as I}from"./host-process.js";import{ensureMainLoop as L,holdMainLoop as R,quitMainLoop as z}from"./main-loop.js";import{__resetBurstStateForTests as B,nextTick as V}from"./next-tick.js";export{r as GIO_ERROR_TO_NODE,i as GLIB_FILE_ERROR_TO_NODE,w as PROBED_GI_LIBDIRS,l as TARGET_OSES,T as TYPELIB_SUBDIR,B as __resetBurstStateForTests,a as createGLibFileError,o as createNodeError,t as deferEmit,y as encodePathForFileUrl,L as ensureMainLoop,E as giLibraryDirsForTypelibDir,M as hasProcfs,R as holdMainLoop,N as hostExecPath,u as hostOs,P as hostPid,d as hostPlatform,F as hostPpid,n as initErrorV8Methods,f as isDarwin,p as isLinux,s as isNotFoundError,m as isTargetOs,h as isWin32,b as isWindowsPath,x as lastPathSeparatorIndex,e as makeCallable,k as mapMachine,A as mapSysname,V as nextTick,g as notImplemented,S as pathToFileUrlHref,v as queueMicrotask,z as quitMainLoop,I as readProcessMemory,c as registerGlobal,C as splitPathComponents,D as splitSearchPath,j as structuredClone,O as systemGiLibraryDirs,_ as warnNotImplemented};
+import{makeCallable as e}from"./callable.js";import{deferEmit as t}from"./defer.js";import{initErrorV8Methods as n}from"./error.js";import{GIO_ERROR_TO_NODE as r,GLIB_FILE_ERROR_TO_NODE as i,createGLibFileError as a,createNodeError as o,isNotFoundError as s}from"./gio-errors.js";import{registerGlobal as c}from"./globals.js";import{TARGET_OSES as l,hostOs as u,hostPlatform as d,isDarwin as f,isLinux as p,isTargetOs as m,isWin32 as h}from"./host-os.js";import{notImplemented as g,warnNotImplemented as _}from"./message.js";import{queueMicrotask as v}from"./microtask.js";import{encodePathForFileUrl as y,isWindowsPath as b,lastPathSeparatorIndex as x,pathToFileUrlHref as S,splitPathComponents as C}from"./path-shape.js";import{PROBED_GI_LIBDIRS as w,TYPELIB_SUBDIR as T,dyldDefaultFallbackDirs as E,giLibraryDirsForTypelibDir as D,splitSearchPath as O,systemGiLibraryDirs as k}from"./system-gi-dirs.js";import{mapMachine as A,mapSysname as j}from"./platform-names.js";import{structuredClone as M}from"./structured-clone.js";import{hasProcfs as N,hostEnv as P,hostExecPath as F,hostPid as I,hostPpid as L,readProcessMemory as R}from"./host-process.js";import{ensureMainLoop as z,holdMainLoop as B,quitMainLoop as V}from"./main-loop.js";import{NativeLibraryLoadError as H,colocateNativeLibrary as U,loadOptionalNativeModule as W,missingLibraryDependency as G,openNativeLibrary as K,probeNativeLibrary as q}from"./native-library.js";import{__resetBurstStateForTests as J,nextTick as Y}from"./next-tick.js";export{r as GIO_ERROR_TO_NODE,i as GLIB_FILE_ERROR_TO_NODE,H as NativeLibraryLoadError,w as PROBED_GI_LIBDIRS,l as TARGET_OSES,T as TYPELIB_SUBDIR,J as __resetBurstStateForTests,U as colocateNativeLibrary,a as createGLibFileError,o as createNodeError,t as deferEmit,E as dyldDefaultFallbackDirs,y as encodePathForFileUrl,z as ensureMainLoop,D as giLibraryDirsForTypelibDir,N as hasProcfs,B as holdMainLoop,P as hostEnv,F as hostExecPath,u as hostOs,I as hostPid,d as hostPlatform,L as hostPpid,n as initErrorV8Methods,f as isDarwin,p as isLinux,s as isNotFoundError,m as isTargetOs,h as isWin32,b as isWindowsPath,x as lastPathSeparatorIndex,W as loadOptionalNativeModule,e as makeCallable,A as mapMachine,j as mapSysname,G as missingLibraryDependency,Y as nextTick,g as notImplemented,K as openNativeLibrary,S as pathToFileUrlHref,q as probeNativeLibrary,v as queueMicrotask,V as quitMainLoop,R as readProcessMemory,c as registerGlobal,C as splitPathComponents,O as splitSearchPath,M as structuredClone,k as systemGiLibraryDirs,_ as warnNotImplemented};

package/lib/esm/font-map.js

@@ -0,0 +1 @@
+import"./_virtual/_rolldown/runtime.js";import e from"gi://GLib?version=2.0";import t from"gi://Gio?version=2.0";import n from"gi://PangoCairo?version=1.0";import r from"gi://Pango?version=1.0";const i=1;function fontMapNamespace(){let e=n.FontMap;if(e!=null&&typeof e.get_default==`function`&&typeof e.new_for_font_type==`function`)return e}function isUnsupportedByFontMap(n){let r=e.Error,i=t.io_error_quark,a=t.IOErrorEnum?.NOT_SUPPORTED;return typeof r!=`function`||typeof i!=`function`||a===void 0||!(n instanceof r)?!1:n.matches(i(),a)}function fontErrorMessage(t){let n=e.Error;return typeof n==`function`&&t instanceof n?t.message??String(t):t instanceof Error?t.message:String(t)}function fontMapFamilies(e){return e.list_families().map(e=>e.get_name())}function fontMapHasFamily(e,t){return e.get_family(t)!==null}function layoutSize(e,t){let n=new r.FontDescription;n.set_family(t),n.set_size(40*r.SCALE);let i=r.Layout.new(e.create_context());return i.set_font_description(n),i.set_text(`Wg`,-1),i.get_pixel_size().join(`x`)}function fontMapServesFamily(e,t,n=layoutSize){return n(e,t)!==n(e,`ZzzGjsifySubstitutionControlQx`)}const a={map:null,before:[],failed:new Map,adopted:!1};function probeFontconfigMap(t,n,r,i=[]){if(r.length===0||e.getenv(`PANGOCAIRO_BACKEND`)!==null)return a;let o=t.new_for_font_type(1);if(o==null)return a;let s=fontMapFamilies(o);if(s.length===0)return a;let c=new Map;for(let e of r)try{o.add_font_file(e)}catch(t){c.set(e,fontErrorMessage(t))}let l=fontMapFamilies(o).filter(e=>!s.includes(e));if(l.length===0)return{map:o,before:s,failed:c,adopted:!1};let alreadyReached=e=>!i.includes(e)&&n.get_family(e)!==null;if(l.every(alreadyReached))return{map:o,before:s,failed:c,adopted:!1};let u=o.set_default;return typeof u==`function`?(u.call(o),{map:o,before:s,failed:c,adopted:!0}):{map:o,before:s,failed:c,adopted:!1}}function noRegistration(){return{available:!1,map:void 0,before:[],registered:[],declined:[],unreachable:[],failed:[],fontconfigFallback:!1}}function registerFontFaces(e,t){let n=fontMapNamespace();if(n===void 0)return noRegistration();let r=t??n.get_default();if(e.length===0)return{...noRegistration(),available:!0,map:r,before:fontMapFamilies(r)};let i=fontMapFamilies(r),a=[],o=[],s=[],c=[];for(let t of e)try{r.add_font_file(t),a.push(t)}catch(e){if(isUnsupportedByFontMap(e)){o.push(t);continue}c.push({path:t,message:fontErrorMessage(e)})}let l=[];a.length>0&&(l=fontMapFamilies(r).filter(e=>!i.includes(e)).filter(e=>!fontMapServesFamily(r,e)),l.length>0&&s.push(...a));let u=[...o,...s];if(u.length>0){let e=probeFontconfigMap(n,r,u,l),t=[];for(let n of o){let r=e.failed.get(n);r===void 0?e.adopted?a.push(n):t.push(n):c.push({path:n,message:r})}if(o.length=0,o.push(...t),e.adopted)s.length=0;else{let t=s.filter(t=>!e.failed.has(t));for(let t of s){let n=e.failed.get(t);n!==void 0&&c.push({path:t,message:n})}s.length=0,s.push(...t)}if(e.adopted&&e.map!==null)return{available:!0,map:e.map,before:e.before,registered:a,declined:o,unreachable:s,failed:c,fontconfigFallback:!0}}return{available:!0,map:r,before:i,registered:a,declined:o,unreachable:s,failed:c,fontconfigFallback:!1}}export{i as CAIRO_FONT_TYPE_FT,fontErrorMessage,fontMapFamilies,fontMapHasFamily,fontMapServesFamily,isUnsupportedByFontMap,registerFontFaces};

package/lib/esm/host-process.js

@@ -1,2 +1,2 @@
-import"./_virtual/_rolldown/runtime.js";function hostGlib(){try{return globalThis.imports?.gi?.GLib}catch{return}}function readText(e,t){try{let[n,r]=e.file_get_contents(t);return!n||!r?null:new TextDecoder().decode(r)}catch{return null}}function shellOut(e,t){try{let[n,r]=e.spawn_command_line_sync(t);if(!n||!r)return null;let i=new TextDecoder().decode(r).trim();return i.length>0?i:null}catch{return null}}function hasProcfs(){let e=hostGlib();if(!e)return!1;try{return e.file_test(`/proc/self/status`,16)}catch{return!1}}let e=null;function hostPid(){if(e!==null)return e>0?e:void 0;let t=hostGlib();if(!t)return;let n=0,r=hasProcfs()?readText(t,`/proc/self/stat`):null;if(r)n=parseInt(r,10);else{let e=shellOut(t,`sh -c 'echo $PPID'`);e&&(n=parseInt(e,10))}return e=Number.isInteger(n)&&n>0?n:0,e>0?e:void 0}function hostPpid(){let e=hostGlib();if(!e)return;let t=hasProcfs()?readText(e,`/proc/self/status`):null;if(t){let e=/PPid:\s+(\d+)/.exec(t);if(e){let t=parseInt(e[1],10);return Number.isInteger(t)?t:void 0}}let n=hostPid();if(n===void 0)return;let r=shellOut(e,`ps -o ppid= -p ${n}`);if(!r)return;let i=parseInt(r,10);return Number.isInteger(i)?i:void 0}function hostExecPath(){let e=hostGlib();if(e){if(hasProcfs())try{let t=e.file_read_link(`/proc/self/exe`);if(t)return t}catch{}try{let t=e.get_prgname();if(t){let n=e.find_program_in_path(t);if(n)return n}}catch{return}}}function readProcessMemory(){let e=hostGlib();if(!e)return null;let t=hasProcfs()?readText(e,`/proc/self/status`):null;if(t){let e=new Map;for(let n of t.split(`
-`)){let t=/^(\w+):\s+(\d+)(\s+kB)?/.exec(n);t&&e.set(t[1],parseInt(t[2],10)*(t[3]?1024:1))}if(e.size>0)return{virtual:e.get(`VmSize`)??0,resident:e.get(`VmRSS`)??0,data:e.get(`VmData`)??0,peak:e.get(`VmPeak`)??0}}let n=shellOut(e,`sh -c 'ps -o rss=,vsz= -p $PPID'`);if(!n)return null;let r=/^(\d+)\s+(\d+)$/.exec(n);return r?{virtual:parseInt(r[2],10)*1024,resident:parseInt(r[1],10)*1024,data:0,peak:0}:null}export{hasProcfs,hostExecPath,hostPid,hostPpid,readProcessMemory};
+import"./_virtual/_rolldown/runtime.js";function hostGlib(){try{return globalThis.imports?.gi?.GLib}catch{return}}function readText(e,t){try{let[n,r]=e.file_get_contents(t);return!n||!r?null:new TextDecoder().decode(r)}catch{return null}}function shellOut(e,t){try{let[n,r]=e.spawn_command_line_sync(t);if(!n||!r)return null;let i=new TextDecoder().decode(r).trim();return i.length>0?i:null}catch{return null}}function hostEnv(e){let t=globalThis.process?.env?.[e];return typeof t==`string`?t:hostGlib()?.getenv(e)??void 0}function hasProcfs(){let e=hostGlib();if(!e)return!1;try{return e.file_test(`/proc/self/status`,16)}catch{return!1}}let e=null;function hostPid(){if(e!==null)return e>0?e:void 0;let t=hostGlib();if(!t)return;let n=0,r=hasProcfs()?readText(t,`/proc/self/stat`):null;if(r)n=parseInt(r,10);else{let e=shellOut(t,`sh -c 'echo $PPID'`);e&&(n=parseInt(e,10))}return e=Number.isInteger(n)&&n>0?n:0,e>0?e:void 0}function hostPpid(){let e=hostGlib();if(!e)return;let t=hasProcfs()?readText(e,`/proc/self/status`):null;if(t){let e=/PPid:\s+(\d+)/.exec(t);if(e){let t=parseInt(e[1],10);return Number.isInteger(t)?t:void 0}}let n=hostPid();if(n===void 0)return;let r=shellOut(e,`ps -o ppid= -p ${n}`);if(!r)return;let i=parseInt(r,10);return Number.isInteger(i)?i:void 0}function hostExecPath(){let e=hostGlib();if(e){if(hasProcfs())try{let t=e.file_read_link(`/proc/self/exe`);if(t)return t}catch{}try{let t=e.get_prgname();if(t){let n=e.find_program_in_path(t);if(n)return n}}catch{return}}}function readProcessMemory(){let e=hostGlib();if(!e)return null;let t=hasProcfs()?readText(e,`/proc/self/status`):null;if(t){let e=new Map;for(let n of t.split(`
+`)){let t=/^(\w+):\s+(\d+)(\s+kB)?/.exec(n);t&&e.set(t[1],parseInt(t[2],10)*(t[3]?1024:1))}if(e.size>0)return{virtual:e.get(`VmSize`)??0,resident:e.get(`VmRSS`)??0,data:e.get(`VmData`)??0,peak:e.get(`VmPeak`)??0}}let n=shellOut(e,`sh -c 'ps -o rss=,vsz= -p $PPID'`);if(!n)return null;let r=/^(\d+)\s+(\d+)$/.exec(n);return r?{virtual:parseInt(r[2],10)*1024,resident:parseInt(r[1],10)*1024,data:0,peak:0}:null}export{hasProcfs,hostEnv,hostExecPath,hostPid,hostPpid,readProcessMemory};

package/lib/esm/index.js

@@ -1 +1 @@
-import{gbytesToUint8Array as e}from"./byte-array.js";import{makeCallable as t}from"./callable.js";import{cli as n}from"./cli.js";import{deferEmit as r}from"./defer.js";import{initErrorV8Methods as i}from"./error.js";import{GIO_ERROR_TO_NODE as a,GLIB_FILE_ERROR_TO_NODE as o,createGLibFileError as s,createNodeError as c,isNotFoundError as l}from"./gio-errors.js";import{registerGlobal as u}from"./globals.js";import{TARGET_OSES as d,hostOs as f,hostPlatform as p,isDarwin as m,isLinux as h,isTargetOs as g,isWin32 as _}from"./host-os.js";import{notImplemented as v,warnNotImplemented as y}from"./message.js";import{queueMicrotask as b}from"./microtask.js";import{encodePathForFileUrl as x,isWindowsPath as S,lastPathSeparatorIndex as C,pathToFileUrlHref as w,splitPathComponents as T}from"./path-shape.js";import{PROBED_GI_LIBDIRS as E,TYPELIB_SUBDIR as D,giLibraryDirsForTypelibDir as O,splitSearchPath as k,systemGiLibraryDirs as A}from"./system-gi-dirs.js";import{mapMachine as j,mapSysname as M}from"./platform-names.js";import{structuredClone as N}from"./structured-clone.js";import{hasProcfs as P,hostExecPath as F,hostPid as I,hostPpid as L,readProcessMemory as R}from"./host-process.js";import{ensureMainLoop as z,holdMainLoop as B,quitMainLoop as V}from"./main-loop.js";import{__resetBurstStateForTests as H,nextTick as U}from"./next-tick.js";import"./core.js";import{readJSON as W}from"./file.js";import{existsFD as G,existsSync as K}from"./fs.js";import{gioAsync as q,inputStreamAsyncIterator as J,readBytesAsync as Y}from"./gio.js";import{getNodeModulesPath as X,getPathSeparator as Z,getProgramDir as Q,getProgramExe as $,resolve as ee}from"./path.js";export{a as GIO_ERROR_TO_NODE,o as GLIB_FILE_ERROR_TO_NODE,E as PROBED_GI_LIBDIRS,d as TARGET_OSES,D as TYPELIB_SUBDIR,H as __resetBurstStateForTests,n as cli,s as createGLibFileError,c as createNodeError,r as deferEmit,x as encodePathForFileUrl,z as ensureMainLoop,G as existsFD,K as existsSync,e as gbytesToUint8Array,X as getNodeModulesPath,Z as getPathSeparator,Q as getProgramDir,$ as getProgramExe,O as giLibraryDirsForTypelibDir,q as gioAsync,P as hasProcfs,B as holdMainLoop,F as hostExecPath,f as hostOs,I as hostPid,p as hostPlatform,L as hostPpid,i as initErrorV8Methods,J as inputStreamAsyncIterator,m as isDarwin,h as isLinux,l as isNotFoundError,g as isTargetOs,_ as isWin32,S as isWindowsPath,C as lastPathSeparatorIndex,t as makeCallable,j as mapMachine,M as mapSysname,U as nextTick,v as notImplemented,w as pathToFileUrlHref,b as queueMicrotask,V as quitMainLoop,Y as readBytesAsync,W as readJSON,R as readProcessMemory,u as registerGlobal,ee as resolve,T as splitPathComponents,k as splitSearchPath,N as structuredClone,A as systemGiLibraryDirs,y as warnNotImplemented};
+import{gbytesToUint8Array as e}from"./byte-array.js";import{makeCallable as t}from"./callable.js";import{cli as n}from"./cli.js";import{deferEmit as r}from"./defer.js";import{initErrorV8Methods as i}from"./error.js";import{GIO_ERROR_TO_NODE as a,GLIB_FILE_ERROR_TO_NODE as o,createGLibFileError as s,createNodeError as c,isNotFoundError as l}from"./gio-errors.js";import{registerGlobal as u}from"./globals.js";import{TARGET_OSES as d,hostOs as f,hostPlatform as p,isDarwin as m,isLinux as h,isTargetOs as g,isWin32 as _}from"./host-os.js";import{notImplemented as v,warnNotImplemented as y}from"./message.js";import{queueMicrotask as b}from"./microtask.js";import{encodePathForFileUrl as x,isWindowsPath as S,lastPathSeparatorIndex as C,pathToFileUrlHref as w,splitPathComponents as T}from"./path-shape.js";import{PROBED_GI_LIBDIRS as E,TYPELIB_SUBDIR as D,dyldDefaultFallbackDirs as O,giLibraryDirsForTypelibDir as k,splitSearchPath as A,systemGiLibraryDirs as j}from"./system-gi-dirs.js";import{mapMachine as M,mapSysname as N}from"./platform-names.js";import{structuredClone as P}from"./structured-clone.js";import{hasProcfs as F,hostEnv as I,hostExecPath as L,hostPid as R,hostPpid as z,readProcessMemory as B}from"./host-process.js";import{ensureMainLoop as V,holdMainLoop as H,quitMainLoop as U}from"./main-loop.js";import{NativeLibraryLoadError as W,colocateNativeLibrary as G,loadOptionalNativeModule as K,missingLibraryDependency as q,openNativeLibrary as J,probeNativeLibrary as Y}from"./native-library.js";import{__resetBurstStateForTests as X,nextTick as Z}from"./next-tick.js";import"./core.js";import{readJSON as Q}from"./file.js";import{existsFD as $,existsSync as ee}from"./fs.js";import{gioAsync as te,inputStreamAsyncIterator as ne,readBytesAsync as re}from"./gio.js";import{getNodeModulesPath as ie,getPathSeparator as ae,getProgramDir as oe,getProgramExe as se,resolve as ce}from"./path.js";import{closeSocketService as le,releaseListenPort as ue}from"./socket-service.js";export{a as GIO_ERROR_TO_NODE,o as GLIB_FILE_ERROR_TO_NODE,W as NativeLibraryLoadError,E as PROBED_GI_LIBDIRS,d as TARGET_OSES,D as TYPELIB_SUBDIR,X as __resetBurstStateForTests,n as cli,le as closeSocketService,G as colocateNativeLibrary,s as createGLibFileError,c as createNodeError,r as deferEmit,O as dyldDefaultFallbackDirs,x as encodePathForFileUrl,V as ensureMainLoop,$ as existsFD,ee as existsSync,e as gbytesToUint8Array,ie as getNodeModulesPath,ae as getPathSeparator,oe as getProgramDir,se as getProgramExe,k as giLibraryDirsForTypelibDir,te as gioAsync,F as hasProcfs,H as holdMainLoop,I as hostEnv,L as hostExecPath,f as hostOs,R as hostPid,p as hostPlatform,z as hostPpid,i as initErrorV8Methods,ne as inputStreamAsyncIterator,m as isDarwin,h as isLinux,l as isNotFoundError,g as isTargetOs,_ as isWin32,S as isWindowsPath,C as lastPathSeparatorIndex,K as loadOptionalNativeModule,t as makeCallable,M as mapMachine,N as mapSysname,q as missingLibraryDependency,Z as nextTick,v as notImplemented,J as openNativeLibrary,w as pathToFileUrlHref,Y as probeNativeLibrary,b as queueMicrotask,U as quitMainLoop,re as readBytesAsync,Q as readJSON,B as readProcessMemory,u as registerGlobal,ue as releaseListenPort,ce as resolve,T as splitPathComponents,A as splitSearchPath,P as structuredClone,j as systemGiLibraryDirs,y as warnNotImplemented};

package/lib/esm/main-loop.js

@@ -1 +1 @@
-import"./_virtual/_rolldown/runtime.js";let e=null,t=!1,n=!1;function glib(){return globalThis.imports?.gi?.GLib}function arm(e){n||(n=!0,e.runAsync().catch(()=>{}))}function ensureMainLoop(){let n=glib();if(n)return t?e:(e=new n.MainLoop(null,!1),t=!0,n.main_depth()===0&&arm(e),e)}function holdMainLoop(){let e=ensureMainLoop();return e&&arm(e),e}function quitMainLoop(){e&&=(e.quit(),t=!1,n=!1,null)}export{ensureMainLoop,holdMainLoop,quitMainLoop};
+import"./_virtual/_rolldown/runtime.js";let e=null,t=!1,n=!1;function glib(){let e=globalThis;if(typeof e.process?.versions?.gjs==`string`||e.process===void 0)return e.imports?.gi?.GLib}function arm(e){n||(n=!0,e.runAsync().catch(()=>{}))}function ensureMainLoop(){let n=glib();if(n)return t?e:(e=new n.MainLoop(null,!1),t=!0,n.main_depth()===0&&arm(e),e)}function holdMainLoop(){let e=ensureMainLoop();return e&&arm(e),e}function quitMainLoop(){e&&=(e.quit(),t=!1,n=!1,null)}export{ensureMainLoop,holdMainLoop,quitMainLoop};

package/lib/esm/native-library.js

@@ -0,0 +1 @@
+import"./_virtual/_rolldown/runtime.js";function hostGi(){return globalThis.imports?.gi}function directoryOf(e){return/^(.*)[\\/][^\\/]*$/.exec(e)?.[1]}function colocateNativeLibrary(e,t=hostGi()){try{let n=t?.GIRepository?.Repository?.dup_default?.(),r=n?.get_typelib_path(e),i=r?directoryOf(r):void 0;return!n||!i?!1:(n.prepend_library_path(i),!0)}catch{return!1}}function probeNativeLibrary(e,t=hostGi()){try{let n=t?.GIRepository?.Repository?.dup_default?.(),r=n?.get_typelib_path(e);if(!t||!n||!r)return null;let i=firstSymbol(n,e);if(!i||(t.GModule?.module_error(),i.info.get_typelib().symbol(i.name)[0]))return null;let a=directoryOf(r)??`.`,o=r.includes(`\\`)&&!r.includes(`/`)?`\\`:`/`;for(let s of n.get_shared_libraries(e)??[]){let n=`${a}${o}${s}`,c=t.GLib?.file_test(n,t.GLib.FileTest.EXISTS)?n:s,l=loaderError(t,e,r,c,i.name);if(l!==void 0)return{namespace:e,library:c,reason:l,missingDependency:missingLibraryDependency(l,c)}}let s=(n.get_shared_libraries(e)??[]).join(`, `)||`(none named)`;return{namespace:e,library:s,reason:`symbol ${i.name} not found in ${s}, and the loader reported no error`}}catch{return null}}function firstSymbol(e,t){let n=e.get_n_infos(t),r=null;for(let i=0;i<n;i++){let n=e.get_info(t,i),a=n.get_type_init_function_name?.();if(a)return{info:n,name:a};let o=n.get_symbol?.();o&&!r&&(r={info:n,name:o})}return r}function loaderError(e,t,n,r,i){let{GIRepository:a,GLib:o,GModule:s}=e;if(!a?.Repository||!a.Typelib||!o||!s)return;let[,c]=o.file_get_contents(n),l=new TextEncoder().encode(`${r}\0`),u=new Uint8Array(c.length+l.length);u.set(c),u.set(l,c.length);let d=new DataView(u.buffer);d.setUint32(40,u.length,!0),d.setUint32(52,c.length,!0);let f=new a.Repository,p=firstSymbol(f,f.load_typelib(a.Typelib.new_from_bytes(new o.Bytes(u)),0));if(p&&(s.module_error(),!p.info.get_typelib().symbol(i)[0]))return s.module_error()??`${t}: ${r} could not be opened (the loader reported no error)`}function missingLibraryDependency(e,t){let n=/Library not loaded: (\S+)/.exec(e)?.[1]??/Error loading shared library ([^\s:]+): .*\(needed by /.exec(e)?.[1]??/(?:^|\s)([^\s:]+): cannot open shared object file/.exec(e)?.[1];if(!n)return;let r=n.replace(/^.*[\\/]/,``);if(!(t&&r===t.replace(/^.*[\\/]/,``)))return r}var NativeLibraryLoadError=class extends Error{failure;constructor(e,t){let n=e.missingDependency?`It needs ${e.missingDependency}, which the loader could not find: not installed, or not on its search path.`:`The loader could not open it.`;super(`${e.namespace}: the native library ${e.library} could not be loaded. ${n}\nLoader: ${e.reason.trim()}\n`+(t??"`gjsify system-check` lists the system libraries the installed @gjsify packages need, with the install command for this host.")),this.name=`NativeLibraryLoadError`,this.failure=e}};function openNativeLibrary(e,t=hostGi()){colocateNativeLibrary(e,t);let n=probeNativeLibrary(e,t);return n?new NativeLibraryLoadError(n):null}function loadOptionalNativeModule(e,t,n=hostGi()){if(!n)return{module:null,error:Error(`${e}: imports.gi is not available (not running on GJS)`)};try{let r=n[e];if(!r)return{module:null,error:Error(`${e}: typelib not found`)};let i=openNativeLibrary(e,n);if(i)return console.debug(i.message),{module:null,error:i};for(let e of t)r[e];return{module:r,error:null}}catch(e){return{module:null,error:e instanceof Error?e:Error(String(e))}}}export{NativeLibraryLoadError,colocateNativeLibrary,loadOptionalNativeModule,missingLibraryDependency,openNativeLibrary,probeNativeLibrary};

package/lib/esm/socket-service.js

@@ -0,0 +1 @@
+import"./_virtual/_rolldown/runtime.js";import e from"@girs/glib-2.0";const t=new Map;function finishClose(e){let n=t.get(e);if(n){t.delete(e);try{e.close()}finally{n.onClosed?.()}}}function closeSocketService(n,r,i){n.stop(),t.set(n,{ports:r,onClosed:i}),e.timeout_add(e.PRIORITY_DEFAULT,0,()=>(finishClose(n),e.SOURCE_REMOVE))}function releaseListenPort(e){if(e)for(let[n,r]of t)r.ports.includes(e)&&finishClose(n)}export{closeSocketService,releaseListenPort};

package/lib/esm/system-gi-dirs.js

@@ -1 +1 @@
-import"./_virtual/_rolldown/runtime.js";import{isWindowsPath as e,lastPathSeparatorIndex as t,splitPathComponents as n}from"./path-shape.js";const r=`girepository-1.0`,i={darwin:[`/opt/homebrew/lib`,`/usr/local/lib`,`/opt/local/lib`]};function splitSearchPath(e,t=`:`){return(e??``).split(t).filter(Boolean)}function stripTrailingSeparators(t){return t.replace(e(t)?/(?<=.)[\\/]+$/:/(?<=.)\/+$/,``)}function dirname(e){let n=stripTrailingSeparators(e),r=t(n);return r<0?`.`:r===0?n.slice(0,1):n.slice(0,r)}function basename(e){let t=n(e).filter(Boolean);return t.length===0?``:t[t.length-1]}function giLibraryDirsForTypelibDir(e){let t=dirname(e);return basename(e)===`girepository-1.0`?[t]:[e,t]}function systemGiLibraryDirs(e){let t=i[e.platform];if(!t)return[];let n=[],add=e=>{e&&e!==`/`&&!n.includes(e)&&n.push(e)};for(let t of splitSearchPath(e.typelibPath))for(let n of giLibraryDirsForTypelibDir(t))e.existsDir(n)&&add(n);let r=[];for(let t of e.pkgConfigDirs??[])basename(t)===`pkgconfig`&&r.push(dirname(t));r.push(...t);for(let t of r)e.existsDir(`${t}/girepository-1.0`)&&add(t);return n}export{i as PROBED_GI_LIBDIRS,r as TYPELIB_SUBDIR,giLibraryDirsForTypelibDir,splitSearchPath,systemGiLibraryDirs};
+import"./_virtual/_rolldown/runtime.js";import{isWindowsPath as e,lastPathSeparatorIndex as t,splitPathComponents as n}from"./path-shape.js";const r=`girepository-1.0`,i={darwin:[`/opt/homebrew/lib`,`/usr/local/lib`,`/opt/local/lib`]};function splitSearchPath(e,t=`:`){return(e??``).split(t).filter(Boolean)}function stripTrailingSeparators(t){return t.replace(e(t)?/(?<=.)[\\/]+$/:/(?<=.)\/+$/,``)}function dirname(e){let n=stripTrailingSeparators(e),r=t(n);return r<0?`.`:r===0?n.slice(0,1):n.slice(0,r)}function basename(e){let t=n(e).filter(Boolean);return t.length===0?``:t[t.length-1]}function giLibraryDirsForTypelibDir(e){let t=dirname(e);return basename(e)===`girepository-1.0`?[t]:[e,t]}function dyldDefaultFallbackDirs(e={}){let t=e.HOME;return[...t?[`${t}/lib`]:[],`/usr/local/lib`,`/lib`,`/usr/lib`]}function systemGiLibraryDirs(e){let t=i[e.platform];if(!t)return[];let n=[],add=e=>{e&&e!==`/`&&!n.includes(e)&&n.push(e)};for(let t of splitSearchPath(e.typelibPath))for(let n of giLibraryDirsForTypelibDir(t))e.existsDir(n)&&add(n);let r=[];for(let t of e.pkgConfigDirs??[])basename(t)===`pkgconfig`&&r.push(dirname(t));r.push(...t);for(let t of r)e.existsDir(`${t}/girepository-1.0`)&&add(t);return n}export{i as PROBED_GI_LIBDIRS,r as TYPELIB_SUBDIR,dyldDefaultFallbackDirs,giLibraryDirsForTypelibDir,splitSearchPath,systemGiLibraryDirs};

package/lib/types/core.d.ts

@@ -12,4 +12,5 @@ export * from './platform-names.js';
 export * from './structured-clone.js';
 export * from './host-process.js';
 export * from './main-loop.js';
+export * from './native-library.js';
 export * from './next-tick.js';

package/lib/types/font-map.d.ts

@@ -0,0 +1,164 @@
+import Pango from 'gi://Pango?version=1.0';
+/**
+ * `CAIRO_FONT_TYPE_FT` from `cairo.h` — the value `pango_cairo_font_map_new_for_font_type()` maps to
+ * its fontconfig backend.
+ *
+ * A literal rather than `gi://cairo`'s `FontType.FT`: the enum is part of cairo's ABI, so importing a
+ * fourth namespace to spell one stable integer would add a load-time dependency for nothing.
+ */
+export declare const CAIRO_FONT_TYPE_FT = 1;
+/** A face the font map would not take, and why. */
+export interface FontFaceFailure {
+    readonly path: string;
+    readonly message: string;
+}
+/** What one {@link registerFontFaces} call did. */
+export interface FontFaceRegistration {
+    /**
+     * `false` where there is no Pango font map to register anything on at all — a `--app browser`
+     * bundle empties `gi://` (`plugins/gjs-imports-empty.ts`), and there a browser's OWN font
+     * machinery is what resolves a `FontFace`.
+     *
+     * Reported rather than left to be inferred from an empty outcome, because the two must not be
+     * reported alike: nothing was DECLINED on a browser, and a caller warning about a decline there
+     * would print a font warning per face in every web app.
+     */
+    readonly available: boolean;
+    /**
+     * The map in force afterwards — the adopted fontconfig one where the fallback ran, the `map` that
+     * was passed in otherwise. `undefined` when {@link available} is `false`.
+     *
+     * A caller registering more than one batch MUST thread this forward: after a swap the process
+     * default is the fontconfig map, and only this value knows.
+     */
+    readonly map: Pango.FontMap | undefined;
+    /**
+     * The family names the registering map held before any face was added — the BEFORE of a family
+     * diff. On the fallback path this is the CANDIDATE's list, because the diff has to be taken on
+     * the map that ends up in force or every family the two backends merely SPELL differently would
+     * be credited to this call.
+     */
+    readonly before: readonly string[];
+    /** Faces now on the map. */
+    readonly registered: readonly string[];
+    /**
+     * Faces no map here would take — see {@link isUnsupportedByFontMap}. A face in a shipped `.app`
+     * lands here and is CORRECT: the OS activated the directory before the process started.
+     */
+    readonly declined: readonly string[];
+    /**
+     * Faces this call put on the map that no layout can be served by — registered, `get_family`
+     * answers the family, and text asking for it still measures the fallback. A SUBSET of
+     * {@link registered}, and disjoint from {@link declined}.
+     *
+     * ITS OWN FIELD rather than a third bucket beside the two above, and the difference is what
+     * happened to the map. `declined` is a map that would not TAKE the face, which for a shipped
+     * `.app` is the correct outcome; a face here was TAKEN and then could not SERVE it. A caller
+     * reading `declined` tells its user that no font map would take this file and points at
+     * `ATSApplicationFontsPath` and `initFonts()` — advice that is wrong here, because the face is
+     * already on the map and re-running a registration cannot help. That is why the distinction is
+     * data rather than a comment: one is silent and correct, the other is loud and necessary, and
+     * a caller cannot tell them apart without laying text out itself.
+     *
+     * EMPTY where the fontconfig fallback took over, which is the whole point of it: then the faces
+     * render and there is nothing left to report.
+     */
+    readonly unreachable: readonly string[];
+    /** Faces that failed for any other reason, plus any the fontconfig map could not open either. */
+    readonly failed: readonly FontFaceFailure[];
+    /**
+     * `true` when this call REPLACED the process's default font map with a fontconfig-backed one.
+     *
+     * A whole-application consequence of one call — every widget created afterwards renders through
+     * FreeType instead of the platform rasteriser — so it is reported rather than inferred, and
+     * `PANGOCAIRO_BACKEND=coretext` gives the platform map back (ADR 0038 § Amendment 5).
+     */
+    readonly fontconfigFallback: boolean;
+}
+/**
+ * Did the font map decline runtime registration outright?
+ *
+ * `pango_font_map_add_font_file()` is a vfunc, and the CoreText map implements none — so on macOS the
+ * call falls through to Pango's base implementation, which answers `G_IO_ERROR_NOT_SUPPORTED`. That is
+ * not a failure to report: a shipped `.app` is already correct declaratively, because
+ * `ATSApplicationFontsPath` had the OS activate the staged directory before the process started, and
+ * the ordering makes the runtime call the wrong tool there rather than merely a redundant one —
+ * `pango_core_text_font_map_changed()` only bumps a serial, there is no
+ * `kCTFontManagerRegisteredFontsChangedNotification` observer and no re-scan path in
+ * `pangocoretext-fontmap.c`, so a face registered after the map initialises could not be recovered by
+ * poking it anyway.
+ *
+ * KEYED ON THE ERROR rather than on `process.platform`, which is the difference between a capability
+ * test and a guess about who is asking. It costs no `gjsify.os` declaration, and it stays right for any
+ * other map that declines — which stopped being hypothetical: the backend is whichever is selected
+ * rather than one per platform, and `@gjsify/node-gi`'s loader selects `PANGOCAIRO_BACKEND=fc` on the
+ * bundled windowing runtime (ADR 0038 § Amendment 3), so a darwin process on it reaches this arm's
+ * other side and REGISTERS the faces. A `process.platform` branch would have had to be found and
+ * reversed instead.
+ */
+export declare function isUnsupportedByFontMap(error: unknown): boolean;
+/**
+ * The reported reason as a GError's `message`, never a stringified GError.
+ *
+ * `GLib.Error` is NOT `instanceof Error` under GJS — measured on gjs 1.88.1, where
+ * `GLib.Error.new_literal(…) instanceof Error` is `false`. A plain `instanceof Error` narrowing
+ * therefore misses EXACTLY the errors this module sees, and every diagnostic printed over them would
+ * silently degrade to `String(error)` — which is not obviously broken, only domain-prefixed.
+ */
+export declare function fontErrorMessage(error: unknown): string;
+/**
+ * The family names a font map currently holds.
+ *
+ * Typed `Pango.FontMap` and not `PangoCairo.FontMap`, which is what the call sites have:
+ * `pango_cairo_font_map_get_default()` is declared to RETURN the base type.
+ */
+export declare function fontMapFamilies(fontMap: Pango.FontMap): string[];
+/** Is `family` one this map can resolve? Pango's own answer, asked directly rather than inferred. */
+export declare function fontMapHasFamily(fontMap: Pango.FontMap, family: string): boolean;
+/**
+ * How {@link fontMapServesFamily} takes its reading: a value that is EQUAL for a family the map
+ * serves and for one it substitutes.
+ *
+ * A seam, so the decision can be held from a host that cannot produce the condition — the same
+ * discipline {@link isUnsupportedByFontMap} exists for, and the reason `font-map.spec.ts` can assert
+ * the decision on every leg instead of only where a poisoned map can be built.
+ */
+export type FontFamilyProbe = (fontMap: Pango.FontMap, family: string) => string;
+/**
+ * Does this map actually SERVE `family`, or does asking for it get the fallback?
+ *
+ * A LAYOUT, because that is the only reading that does not lie, and the readings that look cheaper
+ * were measured first (pango 1.58.2 / gjs 1.88.1, on the fc map Fedora has, reached here with
+ * `PANGOCAIRO_BACKEND=fontconfig`) on a map that had resolved the family to the fallback and then
+ * had the face registered on it:
+ *
+ *   `get_family(name)`                  answers it
+ *   `list_families()`                   contains it
+ *   `load_font(desc).describe()`        the requested family — from a FRESH context
+ *   `get_serial()`                      1, exactly as on an unpoisoned map
+ *   `Pango.Layout` pixel size           THE FALLBACK — 86x66, identical to an invented family
+ *
+ * So the map holds the face, hands the right font to a caller that asks for it by name, reports the
+ * same serial as a healthy map, and lays every glyph out in Verdana: a per-map-instance cache of the
+ * negative resolution, which `add_font_file` does not invalidate and which nothing in JS reaches.
+ * Warming a context with `load_font` first does not help (measured — still 86x66), and neither does a
+ * context created after the registration; only a map that never saw the question serves it, which is
+ * the fresh map {@link probeFontconfigMap} builds.
+ *
+ * Which is also why the equality is against a control family rather than against a fixed number: the
+ * fallback's metrics are the host's business (Verdana 86x66 here, 87x63 on the Fedora 44 leg), and a
+ * number pinned to one host's default sans would red everywhere else while proving nothing extra.
+ */
+export declare function fontMapServesFamily(fontMap: Pango.FontMap, family: string, probe?: FontFamilyProbe): boolean;
+/**
+ * Register faces on a font map, falling back to a fontconfig-backed one when that map DECLINES.
+ *
+ * `map` defaults to the process default and exists so a caller can keep a batch on the map a previous
+ * batch adopted — see {@link FontFaceRegistration.map}.
+ *
+ * Total: a face that will not open, or that no map here will take, is reported and never thrown.
+ * Taking an application down over a decorative face would be worse than rendering it in a fallback —
+ * but doing so SILENTLY is the defect this exists against (ADR 0038), so both are reported and the
+ * caller decides what to say about them.
+ */
+export declare function registerFontFaces(faces: readonly string[], map?: Pango.FontMap): FontFaceRegistration;

package/lib/types/host-process.d.ts

@@ -1,3 +1,13 @@
+/**
+ * One environment variable of this process, or `undefined` when it is unset or
+ * nothing can answer.
+ *
+ * `process.env` first — Node, Bun, Deno and a GJS bundle whose `@gjsify/process`
+ * is registered all have it — then GLib's `g_getenv()` for a GJS host without that
+ * singleton. The two read the same environment block, so the order only decides
+ * who answers, never what.
+ */
+export declare function hostEnv(name: string): string | undefined;
 /** Does this host have a readable procfs for the current process? */
 export declare function hasProcfs(): boolean;
 /**

package/lib/types/index.d.ts

@@ -5,3 +5,4 @@ export * from './file.js';
 export * from './fs.js';
 export * from './gio.js';
 export * from './path.js';
+export * from './socket-service.js';

package/lib/types/native-library.d.ts

@@ -0,0 +1,141 @@
+/** What {@link probeNativeLibrary} measured about a library that would not load. */
+export interface NativeLibraryFailure {
+    /** The GI namespace whose library failed, e.g. `GjsifyRolldown`. */
+    namespace: string;
+    /** The library file that failed — absolute when it sits beside its typelib, else the typelib's leaf. */
+    library: string;
+    /** The host loader's own message (dlerror / dyld / LoadLibrary), or a fixed text when none was readable. */
+    reason: string;
+    /** Leaf name of the dependency the loader could not find, when its message names one. */
+    missingDependency?: string;
+}
+interface RegisteredInfoView {
+    get_type_init_function_name?(): string | null;
+    get_symbol?(): string | null;
+    get_typelib(): {
+        symbol(name: string): [boolean, unknown];
+    };
+}
+interface RepositoryView {
+    get_typelib_path(namespace: string): string | null;
+    prepend_library_path(directory: string): void;
+    get_shared_libraries(namespace: string): string[] | null;
+    get_n_infos(namespace: string): number;
+    get_info(namespace: string, index: number): RegisteredInfoView;
+    load_typelib(typelib: unknown, flags: number): string;
+}
+/** Structural view of `imports.gi` — only the slots this module reads. */
+export interface GiImportsView {
+    readonly GIRepository?: {
+        Repository?: {
+            dup_default?: () => RepositoryView | null;
+            new (): RepositoryView;
+        };
+        Typelib?: {
+            new_from_bytes(bytes: unknown): unknown;
+        };
+    };
+    readonly GLib?: {
+        file_get_contents(path: string): [boolean, Uint8Array];
+        file_test(path: string, test: number): boolean;
+        Bytes: new (data: Uint8Array) => unknown;
+        FileTest: {
+            EXISTS: number;
+        };
+    };
+    readonly GModule?: {
+        module_error(): string | null;
+    };
+}
+/**
+ * Put the directory `namespace`'s typelib was loaded from on girepository's
+ * library path.
+ *
+ * Call it AFTER resolving the namespace (`imports.gi.<Ns>` or a `gi://` import —
+ * that loads the typelib only) and BEFORE the first class or function access,
+ * which is what opens the library. Prepending a directory that already resolves
+ * changes nothing, so no caller has to know whether the environment was intact.
+ *
+ * Capability-probed rather than assumed: `dup_default()` is GLib >= 2.86, and an
+ * older host keeps the environment-only behaviour. Never throws.
+ *
+ * @param gi the `imports.gi` to use — defaults to the running GJS host's; a
+ *   parameter so the spec can drive every branch with a stub
+ * @returns whether a directory was prepended
+ */
+export declare function colocateNativeLibrary(namespace: string, gi?: GiImportsView | undefined): boolean;
+/**
+ * Force `namespace`'s shared library to load and, when it cannot, say which file
+ * failed and why.
+ *
+ * Call it after the namespace resolved (`imports.gi.<Ns>` loads the typelib
+ * only) and before relying on its classes. On success it has done what the first
+ * class access would have done anyway — girepository opens a typelib's library
+ * once — so a caller pays nothing extra.
+ *
+ * Returns `null` when the library loads AND when nothing can be measured (not on
+ * GJS, GLib without GIRepository 3, a namespace the repository has not loaded):
+ * this answers "did it fail", never "is it present". Never throws: callers run
+ * it while deciding how to report another failure.
+ *
+ * @param gi the `imports.gi` to use — defaults to the running GJS host's; a
+ *   parameter so the spec can drive the unmeasurable branches with a stub
+ */
+export declare function probeNativeLibrary(namespace: string, gi?: GiImportsView | undefined): NativeLibraryFailure | null;
+/**
+ * The leaf name of the dependency a loader message says is missing, or
+ * `undefined` when it names none (win32's LoadLibrary never does) or names the
+ * library itself (then the library is what is missing, not a dependency).
+ *
+ * Pure — the three message shapes are the loaders' own, captured verbatim in
+ * the spec.
+ */
+export declare function missingLibraryDependency(reason: string, library?: string): string | undefined;
+/**
+ * A native bridge's library could not be loaded. The message names the file, the
+ * missing dependency and what to do — the text GJS's own "Unsupported type void"
+ * leaves out.
+ */
+export declare class NativeLibraryLoadError extends Error {
+    readonly failure: NativeLibraryFailure;
+    /**
+     * @param installHint how to install what is missing, when the caller knows
+     *   (the CLI derives it from its system-dependency table); otherwise the
+     *   message points at `gjsify system-check`, which reads that same table
+     */
+    constructor(failure: NativeLibraryFailure, installHint?: string);
+}
+/**
+ * Make `namespace`'s library loadable and load it: {@link colocateNativeLibrary},
+ * then {@link probeNativeLibrary}. The call a bridge loader makes between
+ * resolving its namespace and its first class access.
+ *
+ * @returns the error naming the file and its missing dependency, or `null` when
+ *   the library loaded or nothing could be measured
+ */
+export declare function openNativeLibrary(namespace: string, gi?: GiImportsView | undefined): NativeLibraryLoadError | null;
+/** What {@link loadOptionalNativeModule} found: the namespace, or why there is none. */
+export interface OptionalNativeModule<T> {
+    /** The loaded namespace, `null` when it is absent or its library cannot be opened. */
+    readonly module: T | null;
+    /** Why `module` is `null` — a {@link NativeLibraryLoadError} when the library was found and refused. */
+    readonly error: Error | null;
+}
+/**
+ * Load an OPTIONAL bridge: resolve `namespace` from `imports.gi`, open its
+ * library ({@link openNativeLibrary}) and touch `classes`, so a namespace that
+ * resolved while its library did not reads as absent rather than failing at
+ * first use. Never throws — an optional bridge that cannot load is a fallback
+ * path for the caller, not an error.
+ *
+ * Absent and broken are different diagnoses, so the result keeps the error:
+ * a missing typelib is girepository's "not found", a found library that will
+ * not open is the {@link NativeLibraryLoadError} naming the dependency. The
+ * latter also goes to `console.debug` (GJS: `G_MESSAGES_DEBUG=Gjs-Console`),
+ * because a broken install that silently degrades is otherwise invisible.
+ *
+ * @param classes members to touch after the library opened — the safety net for
+ *   a host on which the probe measures nothing (GLib < 2.86)
+ */
+export declare function loadOptionalNativeModule<T>(namespace: string, classes: readonly string[], gi?: GiImportsView | undefined): OptionalNativeModule<T>;
+export {};

package/lib/types/socket-service.d.ts

@@ -0,0 +1,16 @@
+import type Gio from '@girs/gio-2.0';
+/**
+ * Stop accepting on `service` and close its listening sockets once no Gio source
+ * polls them any more. `ports` are the ports it is bound to (see
+ * {@link releaseListenPort}); `onClosed` runs right after the descriptors close.
+ */
+export declare function closeSocketService(service: Gio.SocketService, ports: readonly number[], onClosed?: () => void): void;
+/**
+ * Call before binding `port`. Node's `server.close()` releases the port
+ * synchronously (libuv closes the fd in `uv_close`), so `close(); listen(port)`
+ * on the same port is legal there. A deferred close still holding `port` is
+ * therefore finished NOW: on darwin that may cost the one EBADF warning the
+ * deferral exists to avoid, which beats an EADDRINUSE Node would not raise.
+ * Port 0 (ephemeral) never collides, so it flushes nothing.
+ */
+export declare function releaseListenPort(port: number): void;

package/lib/types/system-gi-dirs.d.ts

@@ -56,4 +56,18 @@ export interface SystemGiLibraryDirsHost {
  * Sources 2 and 3 are GUESSES at a prefix, so each must show the
  * `girepository-1.0/` marker before it is believed. Source 1 is not a guess.
  */
+/**
+ * dyld's OWN default fallback list, verbatim from `dyld(1)`. Setting
+ * `DYLD_FALLBACK_LIBRARY_PATH` REPLACES it rather than extending it, so any
+ * caller that composes a value for that variable must carry this tail or a
+ * child launched through it searches LESS than one launched with the
+ * variable unset — the regression `packages/infra/cli/src/utils/system-gi.ts`
+ * (`composeDyldFallback`) and `packages/node-gi/node-gi/system-gi.js` both
+ * exist to avoid. A THIRD caller that only needs the tail, not the rest of
+ * that composition (a launcher replacing the environment outright has no
+ * "current value of the variable" to fold in), imports this rather than
+ * hand-rolling the same four-entry array — see
+ * `packages/framework/gtk-host/src/placement.spec.ts`.
+ */
+export declare function dyldDefaultFallbackDirs(env?: Record<string, string | undefined>): string[];
 export declare function systemGiLibraryDirs(host: SystemGiLibraryDirsHost): string[];

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gjsify/utils",
-    "version": "0.52.0",
+    "version": "0.54.0",
     "description": "Utils module for gjsify",
     "module": "lib/esm/index.js",
     "types": "lib/types/index.d.ts",
@@ -18,9 +18,17 @@
             "types": "./lib/types/core.d.ts",
             "default": "./lib/esm/core.js"
         },
+        "./font-map": {
+            "types": "./lib/types/font-map.d.ts",
+            "default": "./lib/esm/font-map.js"
+        },
         "./main-loop": {
             "types": "./lib/types/main-loop.d.ts",
             "default": "./lib/esm/main-loop.js"
+        },
+        "./native-library": {
+            "types": "./lib/types/native-library.d.ts",
+            "default": "./lib/esm/native-library.js"
         }
     },
     "scripts": {
@@ -28,6 +36,7 @@
         "check": "gjsify tsc --noEmit",
         "build": "gjsify run build:gjsify && gjsify run build:types",
         "build:gjsify": "gjsify build --library 'src/**/*.{ts,js}' --exclude 'src/**/*.spec.{mts,ts}' 'src/test.{mts,ts}'",
+        "build:esm": "gjsify tsc -p tsconfig.build.json",
         "build:types": "gjsify tsc",
         "build:test": "gjsify run build:test:gjs",
         "build:test:gjs": "gjsify build src/test.ts --app gjs --outfile test.gjs.js",
@@ -40,14 +49,16 @@
         "fs"
     ],
     "devDependencies": {
-        "@gjsify/cli": "^0.52.0",
+        "@gjsify/cli": "^0.54.0",
         "typescript": "^6.0.3"
     },
     "dependencies": {
         "@girs/gio-2.0": "5.4.0",
         "@girs/giounix-2.0": "5.4.0",
         "@girs/gjs": "5.4.0",
-        "@girs/glib-2.0": "5.4.0"
+        "@girs/glib-2.0": "5.4.0",
+        "@girs/pango-1.0": "5.4.0",
+        "@girs/pangocairo-1.0": "5.4.0"
     },
     "license": "MIT",
     "repository": {
@@ -74,11 +85,23 @@
                 "browser": "polyfill",
                 "nativescript": "polyfill"
             },
+            "./font-map": {
+                "gjs": "polyfill",
+                "node": "polyfill",
+                "browser": "polyfill",
+                "nativescript": "polyfill"
+            },
             "./main-loop": {
                 "gjs": "polyfill",
                 "node": "polyfill",
                 "browser": "polyfill",
                 "nativescript": "polyfill"
+            },
+            "./native-library": {
+                "gjs": "polyfill",
+                "node": "polyfill",
+                "browser": "polyfill",
+                "nativescript": "polyfill"
             }
         },
         "os": {