@gjsify/utils 0.52.0 → 0.53.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/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/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.53.0",
     "description": "Utils module for gjsify",
     "module": "lib/esm/index.js",
     "types": "lib/types/index.d.ts",
@@ -21,6 +21,10 @@
         "./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": {
@@ -40,7 +44,7 @@
         "fs"
     ],
     "devDependencies": {
-        "@gjsify/cli": "^0.52.0",
+        "@gjsify/cli": "^0.53.0",
         "typescript": "^6.0.3"
     },
     "dependencies": {
@@ -79,6 +83,12 @@
                 "node": "polyfill",
                 "browser": "polyfill",
                 "nativescript": "polyfill"
+            },
+            "./native-library": {
+                "gjs": "polyfill",
+                "node": "polyfill",
+                "browser": "polyfill",
+                "nativescript": "polyfill"
             }
         },
         "os": {