@gjsify/utils 0.38.0 → 0.39.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{mapMachine as y,mapSysname as b}from"./platform-names.js";import{structuredClone as x}from"./structured-clone.js";import{hasProcfs as S,hostExecPath as C,hostPid as w,hostPpid as T,readProcessMemory as E}from"./host-process.js";import{ensureMainLoop as D,quitMainLoop as O}from"./main-loop.js";import{__resetBurstStateForTests as k,nextTick as A}from"./next-tick.js";export{r as GIO_ERROR_TO_NODE,i as GLIB_FILE_ERROR_TO_NODE,l as TARGET_OSES,k as __resetBurstStateForTests,a as createGLibFileError,o as createNodeError,t as deferEmit,D as ensureMainLoop,S as hasProcfs,C as hostExecPath,u as hostOs,w as hostPid,d as hostPlatform,T as hostPpid,n as initErrorV8Methods,f as isDarwin,p as isLinux,s as isNotFoundError,m as isTargetOs,h as isWin32,e as makeCallable,y as mapMachine,b as mapSysname,A as nextTick,g as notImplemented,v as queueMicrotask,O as quitMainLoop,E as readProcessMemory,c as registerGlobal,x as structuredClone,_ 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,splitSearchPath as E,systemGiLibraryDirs as D}from"./system-gi-dirs.js";import{mapMachine as O,mapSysname as k}from"./platform-names.js";import{structuredClone as A}from"./structured-clone.js";import{hasProcfs as j,hostExecPath as M,hostPid as N,hostPpid as P,readProcessMemory as F}from"./host-process.js";import{ensureMainLoop as I,quitMainLoop as L}from"./main-loop.js";import{__resetBurstStateForTests as R,nextTick as z}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,R as __resetBurstStateForTests,a as createGLibFileError,o as createNodeError,t as deferEmit,y as encodePathForFileUrl,I as ensureMainLoop,j as hasProcfs,M as hostExecPath,u as hostOs,N as hostPid,d as hostPlatform,P 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,O as mapMachine,k as mapSysname,z as nextTick,g as notImplemented,S as pathToFileUrlHref,v as queueMicrotask,L as quitMainLoop,F as readProcessMemory,c as registerGlobal,C as splitPathComponents,E as splitSearchPath,A as structuredClone,D as systemGiLibraryDirs,_ as warnNotImplemented};

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{mapMachine as x,mapSysname as S}from"./platform-names.js";import{structuredClone as C}from"./structured-clone.js";import{hasProcfs as w,hostExecPath as T,hostPid as E,hostPpid as D,readProcessMemory as O}from"./host-process.js";import{ensureMainLoop as k,quitMainLoop as A}from"./main-loop.js";import{__resetBurstStateForTests as j,nextTick as M}from"./next-tick.js";import"./core.js";import{readJSON as N}from"./file.js";import{existsFD as P,existsSync as F}from"./fs.js";import{gioAsync as I,inputStreamAsyncIterator as L,readBytesAsync as R}from"./gio.js";import{getNodeModulesPath as z,getPathSeparator as B,getProgramDir as V,getProgramExe as H,resolve as U}from"./path.js";export{a as GIO_ERROR_TO_NODE,o as GLIB_FILE_ERROR_TO_NODE,d as TARGET_OSES,j as __resetBurstStateForTests,n as cli,s as createGLibFileError,c as createNodeError,r as deferEmit,k as ensureMainLoop,P as existsFD,F as existsSync,e as gbytesToUint8Array,z as getNodeModulesPath,B as getPathSeparator,V as getProgramDir,H as getProgramExe,I as gioAsync,w as hasProcfs,T as hostExecPath,f as hostOs,E as hostPid,p as hostPlatform,D as hostPpid,i as initErrorV8Methods,L as inputStreamAsyncIterator,m as isDarwin,h as isLinux,l as isNotFoundError,g as isTargetOs,_ as isWin32,t as makeCallable,x as mapMachine,S as mapSysname,M as nextTick,v as notImplemented,b as queueMicrotask,A as quitMainLoop,R as readBytesAsync,N as readJSON,O as readProcessMemory,u as registerGlobal,U as resolve,C as structuredClone,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,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,hostExecPath as P,hostPid as F,hostPpid as I,readProcessMemory as L}from"./host-process.js";import{ensureMainLoop as R,quitMainLoop as z}from"./main-loop.js";import{__resetBurstStateForTests as B,nextTick as V}from"./next-tick.js";import"./core.js";import{readJSON as H}from"./file.js";import{existsFD as U,existsSync as W}from"./fs.js";import{gioAsync as G,inputStreamAsyncIterator as K,readBytesAsync as q}from"./gio.js";import{getNodeModulesPath as J,getPathSeparator as Y,getProgramDir as X,getProgramExe as Z,resolve as Q}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,B as __resetBurstStateForTests,n as cli,s as createGLibFileError,c as createNodeError,r as deferEmit,x as encodePathForFileUrl,R as ensureMainLoop,U as existsFD,W as existsSync,e as gbytesToUint8Array,J as getNodeModulesPath,Y as getPathSeparator,X as getProgramDir,Z as getProgramExe,G as gioAsync,N as hasProcfs,P as hostExecPath,f as hostOs,F as hostPid,p as hostPlatform,I as hostPpid,i as initErrorV8Methods,K 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,A as mapMachine,j as mapSysname,V as nextTick,v as notImplemented,w as pathToFileUrlHref,b as queueMicrotask,z as quitMainLoop,q as readBytesAsync,H as readJSON,L as readProcessMemory,u as registerGlobal,Q as resolve,T as splitPathComponents,O as splitSearchPath,M as structuredClone,k as systemGiLibraryDirs,y as warnNotImplemented};

package/lib/esm/path-shape.js

@@ -0,0 +1 @@
+import"./_virtual/_rolldown/runtime.js";function isWindowsPath(e){return/^[A-Za-z]:[\\/]/.test(e)||e.startsWith(`\\\\`)}function lastPathSeparatorIndex(e){let t=e.lastIndexOf(`/`);return isWindowsPath(e)?Math.max(t,e.lastIndexOf(`\\`)):t}function splitPathComponents(e){return isWindowsPath(e)?e.split(/[\\/]/):e.split(`/`)}function pathToFileUrlHref(e,t){let n=t?.windows??isWindowsPath(e),r=n?e.replace(/\\/g,`/`):e;if(n&&r.startsWith(`//`)){let e=r.indexOf(`/`,2);return`file://${e===-1?r.slice(2):r.slice(2,e)}${encodePathForFileUrl(e===-1?``:r.slice(e))}`}return`${r.startsWith(`/`)?`file://`:`file:///`}${encodePathForFileUrl(r)}`}function encodePathForFileUrl(t){let n=``;for(let r of t)n+=e.test(r)?r:percentEncode(r);return n}const e=/^[A-Za-z0-9!$&'()*+,\-./:;=@_]$/;function percentEncode(e){let t=``;for(let n of new TextEncoder().encode(e))t+=`%${n.toString(16).toUpperCase().padStart(2,`0`)}`;return t}export{encodePathForFileUrl,isWindowsPath,lastPathSeparatorIndex,pathToFileUrlHref,splitPathComponents};

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

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

package/lib/types/core.d.ts

@@ -6,6 +6,8 @@ export * from './globals.js';
 export * from './host-os.js';
 export * from './message.js';
 export * from './microtask.js';
+export * from './path-shape.js';
+export * from './system-gi-dirs.js';
 export * from './platform-names.js';
 export * from './structured-clone.js';
 export * from './host-process.js';

package/lib/types/path-shape.d.ts

@@ -0,0 +1,57 @@
+/**
+ * A drive-letter absolute path (`C:\x`, `c:/x`) or a UNC path (`\\server\share\x`).
+ *
+ * Deliberately NOT "contains a backslash": `\` is a legal character in a POSIX
+ * filename, so `/tmp/we\ird` is a POSIX path and must keep being treated as one. A
+ * drive-letter or UNC prefix is the positive evidence; nothing else is.
+ */
+export declare function isWindowsPath(path: string): boolean;
+/**
+ * Index of the last path separator, or `-1` when the path has none.
+ *
+ * `\` counts only in a Windows-shaped path (see {@link isWindowsPath}). Returns an
+ * INDEX rather than a dirname on purpose — the four call sites this replaced each had
+ * their own established answer for "no separator" (`''`, `'.'`, return-the-input) and a
+ * shared `dirname` would have changed three of them while fixing the separator.
+ */
+export declare function lastPathSeparatorIndex(path: string): number;
+/**
+ * The path's components, in order, including empty ones — `split` on the separators
+ * this path actually uses, for callers that must inspect each component (`NAME_MAX`).
+ */
+export declare function splitPathComponents(path: string): string[];
+/**
+ * An ABSOLUTE path → the `file://` href naming it, percent-encoded.
+ *
+ * ```
+ * /opt/app/dist        → file:///opt/app/dist
+ * C:\app\dist          → file:///C:/app/dist
+ * \\server\share\app   → file://server/share/app
+ * ```
+ *
+ * The Windows forms are the WHATWG ones: a drive letter is part of the PATH behind an
+ * empty host (three slashes), while a UNC server is the URL's HOST. `new URL()` accepts
+ * `file://C:/x` and normalises it to `file:///C:/x` by the spec's drive-letter quirk,
+ * but relying on that would leave `\` unconverted, so both are spelled out here.
+ *
+ * @param options.windows force the win32 reading of a path whose shape does not say
+ *   (a relative path, or `/foo` on a win32 host) — the same escape hatch Node added to
+ *   `pathToFileURL` in v22 (`refs/node/lib/internal/url.js`).
+ */
+export declare function pathToFileUrlHref(path: string, options?: {
+    windows?: boolean;
+}): string;
+/**
+ * Percent-encode a path for use as a URL path.
+ *
+ * An allowlist and not `encodeURI`, which leaves `#` and `?` intact — in a path those
+ * are DATA, and letting them through hands the caller a URL whose fragment or query is
+ * a piece of the filename.
+ *
+ * Iterated by CODE POINT, and encoded from UTF-8 bytes rather than with
+ * `encodeURIComponent`: fed one half of a surrogate pair that function raises
+ * `URIError: URI malformed`, so the index-based loop this replaced threw on every path
+ * containing a non-BMP character (an emoji, a CJK extension ideograph) instead of
+ * encoding it.
+ */
+export declare function encodePathForFileUrl(path: string): string;

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

@@ -0,0 +1,44 @@
+/** The subdir GI installs typelibs into — historically `1.0` even for the girepository-2.0 API. */
+export declare const TYPELIB_SUBDIR = "girepository-1.0";
+/**
+ * Prefixes worth probing per platform, for the common case where GTK is installed
+ * and `pkg-config` is not.
+ *
+ * darwin only, and that is a statement about LOADERS rather than about GI. Linux
+ * resolves these leaves through `ld.so`'s system-wide cache (`/etc/ld.so.conf.d`),
+ * which a package install populates. dyld is the one loader that neither consults
+ * a system-wide config NOR re-reads its search path after launch. win32 is
+ * deliberately absent rather than proven unnecessary: `PATH` is the DLL search
+ * path, a Windows GTK distribution puts its own `bin` on it, and Windows re-reads
+ * it at every `LoadLibrary`.
+ */
+export declare const PROBED_GI_LIBDIRS: Readonly<Record<string, readonly string[]>>;
+/** Split a `PATH`-shaped value. Empty entries dropped; `undefined` yields `[]`. */
+export declare function splitSearchPath(value: string | undefined, separator?: string): string[];
+export interface SystemGiLibraryDirsHost {
+    /** `process.platform`, or the platform being reasoned about. */
+    platform: string;
+    /** The host's `GI_TYPELIB_PATH`, unsplit. */
+    typelibPath?: string | undefined;
+    /** `pkg-config`'s `.pc` search directories, already resolved by the caller. */
+    pkgConfigDirs?: readonly string[];
+    /** Directory-existence predicate — the caller's `statSync` or a test double. */
+    existsDir: (dir: string) => boolean;
+}
+/**
+ * Absolute library directories this platform's loader needs told about, or `[]`
+ * when it needs none.
+ *
+ * Three sources, in precedence order:
+ *
+ *   1. `GI_TYPELIB_PATH` — the host stating outright where typelibs live; the
+ *      libraries are the sibling `dirname()`. Believed on directory existence
+ *      alone, because an explicit statement is not second-guessed.
+ *   2. `pkg-config`'s `.pc` search path → each `<dir>/pkgconfig`'s parent. The
+ *      general mechanism, covering a custom prefix.
+ *   3. {@link PROBED_GI_LIBDIRS}.
+ *
+ * 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.
+ */
+export declare function systemGiLibraryDirs(host: SystemGiLibraryDirsHost): string[];

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gjsify/utils",
-    "version": "0.38.0",
+    "version": "0.39.0",
     "description": "Utils module for gjsify",
     "module": "lib/esm/index.js",
     "types": "lib/types/index.d.ts",
@@ -40,7 +40,7 @@
         "fs"
     ],
     "devDependencies": {
-        "@gjsify/cli": "^0.38.0",
+        "@gjsify/cli": "^0.39.0",
         "typescript": "^6.0.3"
     },
     "dependencies": {