globables 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 te <legal@fetchTe.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,98 @@
+# GlobAbles
+
+CLI/ENV constants for Node.js-like runtimes, supports: [Node.js](https://nodejs.org/), [Deno](https://deno.com/), [Bun](https://bun.sh/), [QuickJS](https://bellard.org/quickjs/), and [QuickJS-NG](https://quickjs-ng.github.io/quickjs/)
+
+```ts
+import {
+  ARGV,
+  ENV,
+  GLOBAL_THIS,
+}  from 'globables';
+
+GLOBAL_THIS.console.log(`Shellin with ${ENV['SHELL']} and commandin ${ARGV.join(', ')}`);
+```
+> ╸`ARGV` - [command-line arguments](https://nodejs.org/api/process.html#processargv)<br/>
+> ╸`ENV` - [process environment](https://nodejs.org/api/process.html#processenv) <br/>
+> ╸`GLOBAL_THIS` - [`globalThis`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/globalThis) object; pollyfill'ed if missing, such as prehistoric node <12 versions<br/>
+> ╸ All Runtimes/Globals Tested -> [./src/index.test.ts](https://github.com/fetchTe/globables/blob/master/src/index.test.ts)<br/>
+
+
+<br/>
+
+
+#### ▎INSTALL
+
+```sh
+# pick your poison
+npm install globables
+bun  add globables
+pnpm add globables
+yarn add globables
+```
+
+
+
+## Development/Contributing
+
+Contributions, pull requests, and suggestions are appreciated. The following runtimes must be installed for you to test any changes and/or add additional tests: [Node.js](https://nodejs.org/), [Bun](https://bun.sh), [Deno](https://deno.com), [QuickJS-NG](https://quickjs-ng.github.io/quickjs/) and [Make](https://www.gnu.org/software/make/manual/make.html)
+
+
+### ▎PULL REQUEST STEPS
+
+1. Clone repository
+2. Create and switch to a new branch for your work
+3. Make and commit changes
+4. Run `make release` to clean, setup, build, lint, and test
+5. If everything checks out, push branch to repository and submit pull request
+
+
+#### ▎MAKEFILE REFERENCE
+
+```
+# USAGE
+   make [flags...] <target>
+
+# TARGET
+  -------------------
+   run                   executes entry-point (./src/index.ts) via 'bun run'
+   release               clean, setup, build, lint, test, aok (everything but the kitchen sink)
+  -------------------
+   build                 builds the .{js,d.ts} (skips: lint, test, and .min.* build)
+   build_cjs             builds the .cjs export
+   build_esm             builds the .js (esm) export
+   build_declarations    builds typescript .d.{ts,mts,cts} declarations
+  -------------------
+   install               installs dependencies via bun
+   update                updates dependencies
+   update_dry            lists dependencies that would be updated via 'make update'
+  -------------------
+   lint                  lints via tsc & eslint
+   lint_eslint           lints via eslint
+   lint_eslint_fix       lints and auto-fixes via eslint --fix
+   lint_tsc              lints via tsc
+   lint_watch            lints via eslint & tsc with fs.watch to continuously lint on change
+  -------------------
+   test                  runs bun test(s)
+   test_watch            runs bun test(s) in watch mode
+   test_update           runs bun test --update-snapshots
+  -------------------
+   help                  displays (this) help screen
+
+# FLAGS
+  -------------------
+   BUN                   [? ] bun build flag(s) (e.g: make BUN="--banner='// bake until golden brown'")
+  -------------------
+   CJS                   [?1] builds the cjs (CommonJS) target on 'make release'
+   EXE                   [?js|mjs] default esm build extension
+   TAR                   [?0] build target env (-1=bun, 0=node, 1=dom, 2=dom+iife, 3=dom+iife+userscript)
+   MIN                   [?1] builds minified (*.min.{mjs,cjs,js}) targets on 'make release'
+  -------------------
+   BAIL                  [?1] fail fast (bail) on the first test or lint error
+   ENV                   [?DEV|PROD|TEST] sets the 'ENV' & 'IS_*' static build variables (else auto-set)
+   TEST                  [?0] sets the 'IS_TEST' static build variable (always 1 if test target)
+   WATCH                 [?0] sets the '--watch' flag for bun/tsc (e.g: WATCH=1 make test)
+  -------------------
+   DEBUG                 [?0] enables verbose logging and sets the 'IS_DEBUG' static build variable
+   QUIET                 [?0] disables pretty-printed/log target (INIT/DONE) info
+   NO_COLOR              [?0] disables color logging/ANSI codes
+```

package/dist/index.cjs

@@ -0,0 +1,56 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __moduleCache = /* @__PURE__ */ new WeakMap;
+var __toCommonJS = (from) => {
+  var entry = __moduleCache.get(from), desc;
+  if (entry)
+    return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if (from && typeof from === "object" || typeof from === "function")
+    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    }));
+  __moduleCache.set(from, entry);
+  return entry;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+
+// src/index.ts
+var exports_src = {};
+__export(exports_src, {
+  GLOBAL_THIS: () => GLOBAL_THIS,
+  ENV: () => ENV,
+  ARGV: () => ARGV
+});
+module.exports = __toCommonJS(exports_src);
+var GLOBAL_THIS = /* @__PURE__ */ (() => typeof globalThis === "object" ? globalThis : (() => {
+  (function(Object2) {
+    function get() {
+      const e = this || self;
+      e.globalThis = e, delete Object2.prototype._T_;
+    }
+    typeof globalThis != "object" && (this ? get() : (Object2.defineProperty(Object2.prototype, "_T_", { configurable: true, get }), _T_));
+  })(Object);
+  return typeof globalThis === "object" ? globalThis : {};
+})())();
+var ARGV = /* @__PURE__ */ (() => typeof process === "undefined" ? typeof scriptArgs !== "undefined" ? scriptArgs : [] : (GLOBAL_THIS?.["Deno"] ? GLOBAL_THIS?.["Deno"]?.args ?? (process["args"]?.length ? process["args"] : process["argv"]) : process["argv"]) ?? [])();
+var ENV = /* @__PURE__ */ (() => typeof process === "undefined" ? typeof GLOBAL_THIS?.["std"]?.getenviron === "function" ? GLOBAL_THIS["std"].getenviron?.() ?? {} : {} : !GLOBAL_THIS?.["Deno"] ? process["env"] : (() => {
+  try {
+    return GLOBAL_THIS?.["Deno"]?.env?.toObject?.() ?? (process["env"]?.toObject ? process["env"]?.toObject() : process["env"]);
+  } catch (_err) {}
+  return {};
+})())();
+
+//# debugId=595C4701BDF3FE0964756E2164756E21
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/index.ts"],
+  "sourcesContent": [
+    "export type GlobalThis = typeof globalThis;\nexport type ProcessArgv = NodeJS.Process['argv'];\nexport type ProcessEnv = NodeJS.ProcessEnv;\n\n\n/**\n * globalThis object - with pollyfil in case of prehistoric node <12\n * @see {@link https://tc39.es/ecma262/multipage/global-object.html#sec-globalthis|globalThis spec - ECMAScript }\n * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/globalThis|globalThis docs - MDN}\n */\nexport const GLOBAL_THIS = /* @__PURE__ */ (() =>\n  typeof globalThis === 'object'\n    ? globalThis\n    /**\n     * globalThis pollyfill\n     * @see {@link https://mathiasbynens.be/notes/globalthis}\n     * @see {@link https://github.com/ungap/global-this}\n     */\n    : (() => {\n      // @ts-expect-error - globalThis pollyfill for prehistoric node envs\n      // eslint-disable-next-line\n      !(function (Object) {function get() {const e = this || self; e.globalThis = e, delete Object.prototype._T_;}'object' != typeof globalThis && (this ? get() : (Object.defineProperty(Object.prototype, '_T_', {configurable:!0, get:get}), _T_));}(Object));\n      // just in case\n      return typeof globalThis === 'object' ? globalThis : {};\n    })()\n)() as GlobalThis;\n\n\n/**\n * command-line arguments (pure/iffe wrapped so we can shake the tree)\n * @see {@link https://nodejs.org/api/process.html#processargv|process.argv - Node.js}\n * @see {@link https://bellard.org/quickjs/quickjs.html#Global-objects|scriptArgs - QuickJS}\n * @see {@link https://quickjs-ng.github.io/quickjs/stdlib#scriptargs|scriptArgs - QuickJS-NG}\n * @see {@link https://docs.deno.com/api/node/process/~/Process#property_argv|process.argv - Deno}\n * @see {@link https://docs.deno.com/api/deno/~/Deno.CommandOptions#property_args|Deno.args - Deno}\n */\nexport const ARGV: NodeJS.Process['argv'] = /* @__PURE__ */ (() =>\n  typeof process === 'undefined'\n    /** quickJs {@link https://bellard.org/quickjs/quickjs.html#Global-objects} */\n    ? typeof scriptArgs !== 'undefined'\n      ? scriptArgs\n      : []\n    : ((GLOBAL_THIS as never)?.['Deno']\n      // @NOTE: DENO.args does not require any perm requests\n      // @NOTE: if --allow-all is used, no args (like --allow-env), use default\n      // @ts-expect-error deno uses 'args' rather than 'argv'\n      ? (GLOBAL_THIS as never)?.['Deno']?.args\n        // @ts-expect-error deno uses 'args' rather than 'argv'\n        ?? (process['args']?.length ? process['args'] : process['argv'])\n      : process['argv']\n    ) ?? []\n)();\n\n\n/**\n * process environment (ENV) variables\n * @see {@link https://nodejs.org/api/process.html#processenv|process.env - Node.js}\n * @see {@link https://docs.deno.com/runtime/reference/env_variables/#built-in-deno.env|env - Deno}\n * @see {@link https://bellard.org/quickjs/quickjs.html#Global-objects|getenviron - QuickJS}\n * @see {@link https://quickjs-ng.github.io/quickjs/stdlib#getenviron|getenviron - QuickJS-NG}\n */\nexport const ENV = /* @__PURE__ */ (() => typeof process === 'undefined'\n  // @ts-expect-error quickjs std\n  ? typeof (GLOBAL_THIS as never)?.['std']?.getenviron === 'function'\n    // @ts-expect-error quickjs std\n    ? ((GLOBAL_THIS as never)['std'].getenviron?.() ?? {})\n    : {}\n  : (!(GLOBAL_THIS as never)?.['Deno']\n    ? process['env']\n    : (() => {\n      try {\n        // @NOTE: if --allow-all is used, no toObject (like --allow-env), use default\n        // @NOTE: DENO.env.toObject only requires one perm request while process requires many\n        // @ts-expect-error deno perms\n        // eslint-disable-next-line @stylistic/max-len\n        return (GLOBAL_THIS as never)?.['Deno']?.env?.toObject?.() ?? (process['env']?.toObject ? process['env']?.toObject() : process['env']);\n      } catch (_err) { /* ignore */ }\n      return {};\n    })())\n)() as ProcessEnv;\n"
+  ],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAUO,IAAM,+BAA+B,MAC1C,OAAO,eAAe,WAClB,cAMC,MAAM;AAAA,GAGL,QAAS,CAAC,SAAQ;AAAA,IAAC,SAAS,GAAG,GAAG;AAAA,MAAC,MAAM,IAAI,QAAQ;AAAA,MAAM,EAAE,aAAa,GAAG,OAAO,QAAO,UAAU;AAAA;AAAA,IAAiB,OAAO,cAAnB,aAAkC,OAAO,IAAI,KAAK,QAAO,eAAe,QAAO,WAAW,OAAO,EAAC,cAAa,MAAI,IAAO,CAAC,GAAG;AAAA,KAAQ,MAAM;AAAA,EAExP,OAAO,OAAO,eAAe,WAAW,aAAa,CAAC;AAAA,GACrD,GACL;AAWK,IAAM,wBAAgD,MAC3D,OAAO,YAAY,cAEf,OAAO,eAAe,cACpB,aACA,CAAC,KACD,cAAwB,UAIvB,cAAwB,SAAS,SAE9B,QAAQ,SAAS,SAAS,QAAQ,UAAU,QAAQ,WACxD,QAAQ,YACP,CAAC,GACR;AAUK,IAAM,uBAAuB,MAAM,OAAO,YAAY,cAEzD,OAAQ,cAAwB,QAAQ,eAAe,aAEnD,YAAsB,OAAO,aAAa,KAAK,CAAC,IAClD,CAAC,KACA,cAAwB,UACzB,QAAQ,UACP,MAAM;AAAA,EACP,IAAI;AAAA,IAKF,OAAQ,cAAwB,SAAS,KAAK,WAAW,MAAM,QAAQ,QAAQ,WAAW,QAAQ,QAAQ,SAAS,IAAI,QAAQ;AAAA,IAC/H,OAAO,MAAM;AAAA,EACf,OAAO,CAAC;AAAA,GACP,GACL;",
+  "debugId": "595C4701BDF3FE0964756E2164756E21",
+  "names": []
+}

package/dist/index.d.cts

@@ -0,0 +1,27 @@
+export type GlobalThis = typeof globalThis;
+export type ProcessArgv = NodeJS.Process['argv'];
+export type ProcessEnv = NodeJS.ProcessEnv;
+/**
+ * globalThis object - with pollyfil in case of prehistoric node <12
+ * @see {@link https://tc39.es/ecma262/multipage/global-object.html#sec-globalthis|globalThis spec - ECMAScript }
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/globalThis|globalThis docs - MDN}
+ */
+export declare const GLOBAL_THIS: GlobalThis;
+/**
+ * command-line arguments (pure/iffe wrapped so we can shake the tree)
+ * @see {@link https://nodejs.org/api/process.html#processargv|process.argv - Node.js}
+ * @see {@link https://bellard.org/quickjs/quickjs.html#Global-objects|scriptArgs - QuickJS}
+ * @see {@link https://quickjs-ng.github.io/quickjs/stdlib#scriptargs|scriptArgs - QuickJS-NG}
+ * @see {@link https://docs.deno.com/api/node/process/~/Process#property_argv|process.argv - Deno}
+ * @see {@link https://docs.deno.com/api/deno/~/Deno.CommandOptions#property_args|Deno.args - Deno}
+ */
+export declare const ARGV: NodeJS.Process['argv'];
+/**
+ * process environment (ENV) variables
+ * @see {@link https://nodejs.org/api/process.html#processenv|process.env - Node.js}
+ * @see {@link https://docs.deno.com/runtime/reference/env_variables/#built-in-deno.env|env - Deno}
+ * @see {@link https://bellard.org/quickjs/quickjs.html#Global-objects|getenviron - QuickJS}
+ * @see {@link https://quickjs-ng.github.io/quickjs/stdlib#getenviron|getenviron - QuickJS-NG}
+ */
+export declare const ENV: ProcessEnv;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.mts

@@ -0,0 +1,27 @@
+export type GlobalThis = typeof globalThis;
+export type ProcessArgv = NodeJS.Process['argv'];
+export type ProcessEnv = NodeJS.ProcessEnv;
+/**
+ * globalThis object - with pollyfil in case of prehistoric node <12
+ * @see {@link https://tc39.es/ecma262/multipage/global-object.html#sec-globalthis|globalThis spec - ECMAScript }
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/globalThis|globalThis docs - MDN}
+ */
+export declare const GLOBAL_THIS: GlobalThis;
+/**
+ * command-line arguments (pure/iffe wrapped so we can shake the tree)
+ * @see {@link https://nodejs.org/api/process.html#processargv|process.argv - Node.js}
+ * @see {@link https://bellard.org/quickjs/quickjs.html#Global-objects|scriptArgs - QuickJS}
+ * @see {@link https://quickjs-ng.github.io/quickjs/stdlib#scriptargs|scriptArgs - QuickJS-NG}
+ * @see {@link https://docs.deno.com/api/node/process/~/Process#property_argv|process.argv - Deno}
+ * @see {@link https://docs.deno.com/api/deno/~/Deno.CommandOptions#property_args|Deno.args - Deno}
+ */
+export declare const ARGV: NodeJS.Process['argv'];
+/**
+ * process environment (ENV) variables
+ * @see {@link https://nodejs.org/api/process.html#processenv|process.env - Node.js}
+ * @see {@link https://docs.deno.com/runtime/reference/env_variables/#built-in-deno.env|env - Deno}
+ * @see {@link https://bellard.org/quickjs/quickjs.html#Global-objects|getenviron - QuickJS}
+ * @see {@link https://quickjs-ng.github.io/quickjs/stdlib#getenviron|getenviron - QuickJS-NG}
+ */
+export declare const ENV: ProcessEnv;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+export type GlobalThis = typeof globalThis;
+export type ProcessArgv = NodeJS.Process['argv'];
+export type ProcessEnv = NodeJS.ProcessEnv;
+/**
+ * globalThis object - with pollyfil in case of prehistoric node <12
+ * @see {@link https://tc39.es/ecma262/multipage/global-object.html#sec-globalthis|globalThis spec - ECMAScript }
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/globalThis|globalThis docs - MDN}
+ */
+export declare const GLOBAL_THIS: GlobalThis;
+/**
+ * command-line arguments (pure/iffe wrapped so we can shake the tree)
+ * @see {@link https://nodejs.org/api/process.html#processargv|process.argv - Node.js}
+ * @see {@link https://bellard.org/quickjs/quickjs.html#Global-objects|scriptArgs - QuickJS}
+ * @see {@link https://quickjs-ng.github.io/quickjs/stdlib#scriptargs|scriptArgs - QuickJS-NG}
+ * @see {@link https://docs.deno.com/api/node/process/~/Process#property_argv|process.argv - Deno}
+ * @see {@link https://docs.deno.com/api/deno/~/Deno.CommandOptions#property_args|Deno.args - Deno}
+ */
+export declare const ARGV: NodeJS.Process['argv'];
+/**
+ * process environment (ENV) variables
+ * @see {@link https://nodejs.org/api/process.html#processenv|process.env - Node.js}
+ * @see {@link https://docs.deno.com/runtime/reference/env_variables/#built-in-deno.env|env - Deno}
+ * @see {@link https://bellard.org/quickjs/quickjs.html#Global-objects|getenviron - QuickJS}
+ * @see {@link https://quickjs-ng.github.io/quickjs/stdlib#getenviron|getenviron - QuickJS-NG}
+ */
+export declare const ENV: ProcessEnv;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,OAAO,UAAU,CAAC;AAC3C,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;AACjD,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;AAG3C;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAejB,UAAU,CAAC;AAGlB;;;;;;;GAOG;AACH,eAAO,MAAM,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,CAerC,CAAC;AAGJ;;;;;;GAMG;AACH,eAAO,MAAM,GAAG,EAkBT,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,26 @@
+// src/index.ts
+var GLOBAL_THIS = /* @__PURE__ */ (() => typeof globalThis === "object" ? globalThis : (() => {
+  (function(Object2) {
+    function get() {
+      const e = this || self;
+      e.globalThis = e, delete Object2.prototype._T_;
+    }
+    typeof globalThis != "object" && (this ? get() : (Object2.defineProperty(Object2.prototype, "_T_", { configurable: true, get }), _T_));
+  })(Object);
+  return typeof globalThis === "object" ? globalThis : {};
+})())();
+var ARGV = /* @__PURE__ */ (() => typeof process === "undefined" ? typeof scriptArgs !== "undefined" ? scriptArgs : [] : (GLOBAL_THIS?.["Deno"] ? GLOBAL_THIS?.["Deno"]?.args ?? (process["args"]?.length ? process["args"] : process["argv"]) : process["argv"]) ?? [])();
+var ENV = /* @__PURE__ */ (() => typeof process === "undefined" ? typeof GLOBAL_THIS?.["std"]?.getenviron === "function" ? GLOBAL_THIS["std"].getenviron?.() ?? {} : {} : !GLOBAL_THIS?.["Deno"] ? process["env"] : (() => {
+  try {
+    return GLOBAL_THIS?.["Deno"]?.env?.toObject?.() ?? (process["env"]?.toObject ? process["env"]?.toObject() : process["env"]);
+  } catch (_err) {}
+  return {};
+})())();
+export {
+  GLOBAL_THIS,
+  ENV,
+  ARGV
+};
+
+//# debugId=3025BAE9C191ECCF64756E2164756E21
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/index.ts"],
+  "sourcesContent": [
+    "export type GlobalThis = typeof globalThis;\nexport type ProcessArgv = NodeJS.Process['argv'];\nexport type ProcessEnv = NodeJS.ProcessEnv;\n\n\n/**\n * globalThis object - with pollyfil in case of prehistoric node <12\n * @see {@link https://tc39.es/ecma262/multipage/global-object.html#sec-globalthis|globalThis spec - ECMAScript }\n * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/globalThis|globalThis docs - MDN}\n */\nexport const GLOBAL_THIS = /* @__PURE__ */ (() =>\n  typeof globalThis === 'object'\n    ? globalThis\n    /**\n     * globalThis pollyfill\n     * @see {@link https://mathiasbynens.be/notes/globalthis}\n     * @see {@link https://github.com/ungap/global-this}\n     */\n    : (() => {\n      // @ts-expect-error - globalThis pollyfill for prehistoric node envs\n      // eslint-disable-next-line\n      !(function (Object) {function get() {const e = this || self; e.globalThis = e, delete Object.prototype._T_;}'object' != typeof globalThis && (this ? get() : (Object.defineProperty(Object.prototype, '_T_', {configurable:!0, get:get}), _T_));}(Object));\n      // just in case\n      return typeof globalThis === 'object' ? globalThis : {};\n    })()\n)() as GlobalThis;\n\n\n/**\n * command-line arguments (pure/iffe wrapped so we can shake the tree)\n * @see {@link https://nodejs.org/api/process.html#processargv|process.argv - Node.js}\n * @see {@link https://bellard.org/quickjs/quickjs.html#Global-objects|scriptArgs - QuickJS}\n * @see {@link https://quickjs-ng.github.io/quickjs/stdlib#scriptargs|scriptArgs - QuickJS-NG}\n * @see {@link https://docs.deno.com/api/node/process/~/Process#property_argv|process.argv - Deno}\n * @see {@link https://docs.deno.com/api/deno/~/Deno.CommandOptions#property_args|Deno.args - Deno}\n */\nexport const ARGV: NodeJS.Process['argv'] = /* @__PURE__ */ (() =>\n  typeof process === 'undefined'\n    /** quickJs {@link https://bellard.org/quickjs/quickjs.html#Global-objects} */\n    ? typeof scriptArgs !== 'undefined'\n      ? scriptArgs\n      : []\n    : ((GLOBAL_THIS as never)?.['Deno']\n      // @NOTE: DENO.args does not require any perm requests\n      // @NOTE: if --allow-all is used, no args (like --allow-env), use default\n      // @ts-expect-error deno uses 'args' rather than 'argv'\n      ? (GLOBAL_THIS as never)?.['Deno']?.args\n        // @ts-expect-error deno uses 'args' rather than 'argv'\n        ?? (process['args']?.length ? process['args'] : process['argv'])\n      : process['argv']\n    ) ?? []\n)();\n\n\n/**\n * process environment (ENV) variables\n * @see {@link https://nodejs.org/api/process.html#processenv|process.env - Node.js}\n * @see {@link https://docs.deno.com/runtime/reference/env_variables/#built-in-deno.env|env - Deno}\n * @see {@link https://bellard.org/quickjs/quickjs.html#Global-objects|getenviron - QuickJS}\n * @see {@link https://quickjs-ng.github.io/quickjs/stdlib#getenviron|getenviron - QuickJS-NG}\n */\nexport const ENV = /* @__PURE__ */ (() => typeof process === 'undefined'\n  // @ts-expect-error quickjs std\n  ? typeof (GLOBAL_THIS as never)?.['std']?.getenviron === 'function'\n    // @ts-expect-error quickjs std\n    ? ((GLOBAL_THIS as never)['std'].getenviron?.() ?? {})\n    : {}\n  : (!(GLOBAL_THIS as never)?.['Deno']\n    ? process['env']\n    : (() => {\n      try {\n        // @NOTE: if --allow-all is used, no toObject (like --allow-env), use default\n        // @NOTE: DENO.env.toObject only requires one perm request while process requires many\n        // @ts-expect-error deno perms\n        // eslint-disable-next-line @stylistic/max-len\n        return (GLOBAL_THIS as never)?.['Deno']?.env?.toObject?.() ?? (process['env']?.toObject ? process['env']?.toObject() : process['env']);\n      } catch (_err) { /* ignore */ }\n      return {};\n    })())\n)() as ProcessEnv;\n"
+  ],
+  "mappings": ";AAUO,IAAM,+BAA+B,MAC1C,OAAO,eAAe,WAClB,cAMC,MAAM;AAAA,GAGL,QAAS,CAAC,SAAQ;AAAA,IAAC,SAAS,GAAG,GAAG;AAAA,MAAC,MAAM,IAAI,QAAQ;AAAA,MAAM,EAAE,aAAa,GAAG,OAAO,QAAO,UAAU;AAAA;AAAA,IAAiB,OAAO,cAAnB,aAAkC,OAAO,IAAI,KAAK,QAAO,eAAe,QAAO,WAAW,OAAO,EAAC,cAAa,MAAI,IAAO,CAAC,GAAG;AAAA,KAAQ,MAAM;AAAA,EAExP,OAAO,OAAO,eAAe,WAAW,aAAa,CAAC;AAAA,GACrD,GACL;AAWK,IAAM,wBAAgD,MAC3D,OAAO,YAAY,cAEf,OAAO,eAAe,cACpB,aACA,CAAC,KACD,cAAwB,UAIvB,cAAwB,SAAS,SAE9B,QAAQ,SAAS,SAAS,QAAQ,UAAU,QAAQ,WACxD,QAAQ,YACP,CAAC,GACR;AAUK,IAAM,uBAAuB,MAAM,OAAO,YAAY,cAEzD,OAAQ,cAAwB,QAAQ,eAAe,aAEnD,YAAsB,OAAO,aAAa,KAAK,CAAC,IAClD,CAAC,KACA,cAAwB,UACzB,QAAQ,UACP,MAAM;AAAA,EACP,IAAI;AAAA,IAKF,OAAQ,cAAwB,SAAS,KAAK,WAAW,MAAM,QAAQ,QAAQ,WAAW,QAAQ,QAAQ,SAAS,IAAI,QAAQ;AAAA,IAC/H,OAAO,MAAM;AAAA,EACf,OAAO,CAAC;AAAA,GACP,GACL;",
+  "debugId": "3025BAE9C191ECCF64756E2164756E21",
+  "names": []
+}

package/dist/index.min.cjs

@@ -0,0 +1 @@
+var{defineProperty:u,getOwnPropertyNames:w,getOwnPropertyDescriptor:z}=Object,C=Object.prototype.hasOwnProperty;var v=new WeakMap,D=(f)=>{var h=v.get(f),k;if(h)return h;if(h=u({},"__esModule",{value:!0}),f&&typeof f==="object"||typeof f==="function")w(f).map((q)=>!C.call(h,q)&&u(h,q,{get:()=>f[q],enumerable:!(k=z(f,q))||k.enumerable}));return v.set(f,h),h};var E=(f,h)=>{for(var k in h)u(f,k,{get:h[k],enumerable:!0,configurable:!0,set:(q)=>h[k]=()=>q})};var K={};E(K,{GLOBAL_THIS:()=>p,ENV:()=>J,ARGV:()=>F});module.exports=D(K);var p=(()=>typeof globalThis==="object"?globalThis:(()=>{return function(f){function h(){let k=this||self;k.globalThis=k,delete f.prototype._T_}typeof globalThis!="object"&&(this?h():(f.defineProperty(f.prototype,"_T_",{configurable:!0,get:h}),_T_))}(Object),typeof globalThis==="object"?globalThis:{}})())(),F=(()=>typeof process==="undefined"?typeof scriptArgs!=="undefined"?scriptArgs:[]:(p?.Deno?p?.Deno?.args??(process.args?.length?process.args:process.argv):process.argv)??[])(),J=(()=>typeof process==="undefined"?typeof p?.std?.getenviron==="function"?p.std.getenviron?.()??{}:{}:!p?.Deno?process.env:(()=>{try{return p?.Deno?.env?.toObject?.()??(process.env?.toObject?process.env?.toObject():process.env)}catch(f){}return{}})())();

package/dist/index.min.js

@@ -0,0 +1 @@
+var f=(()=>typeof globalThis==="object"?globalThis:(()=>{return function(h){function k(){let p=this||self;p.globalThis=p,delete h.prototype._T_}typeof globalThis!="object"&&(this?k():(h.defineProperty(h.prototype,"_T_",{configurable:!0,get:k}),_T_))}(Object),typeof globalThis==="object"?globalThis:{}})())(),q=(()=>typeof process==="undefined"?typeof scriptArgs!=="undefined"?scriptArgs:[]:(f?.Deno?f?.Deno?.args??(process.args?.length?process.args:process.argv):process.argv)??[])(),u=(()=>typeof process==="undefined"?typeof f?.std?.getenviron==="function"?f.std.getenviron?.()??{}:{}:!f?.Deno?process.env:(()=>{try{return f?.Deno?.env?.toObject?.()??(process.env?.toObject?process.env?.toObject():process.env)}catch(h){}return{}})())();export{f as GLOBAL_THIS,u as ENV,q as ARGV};

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "globables",
+  "version": "1.0.0",
+  "description": "CLI/ENV constants for Node.js-like runtimes, supports: Node.js, Deno, Bun, QuickJS, and QuickJS-NG",
+  "homepage": "https://github.com/fetchTe/globables",
+  "license": "MIT",
+  "keywords": ["cli", "env", "argv", "globalThis", "Node.js", "Deno", "Bun", "QuickJS", "QuickJS-NG"],
+  "files": ["dist"],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "make release",
+    "test": "make test"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "@eslint/js": "9.35.0",
+    "@stylistic/eslint-plugin": "5.3.1",
+    "@types/bun": "1.2.21",
+    "@types/eslint": "9.6.1",
+    "@types/node": "24.3.3",
+    "@typescript-eslint/parser": "8.43.0",
+    "eslint": "9.35.0",
+    "typescript": "5.9.2",
+    "typescript-eslint": "8.43.0"
+  },
+  "exports": {
+    ".": {
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      },
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.js"
+      }
+    },
+    "./index": {
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      },
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.js"
+      }
+    }
+  },
+  "author": {
+    "email": "git@fetchte.com",
+    "name": "fetchTe",
+    "url": "https://github.com/fetchTe/globables"
+  },
+  "bugs": {
+    "email": "git@fetchte.com",
+    "url": "https://github.com/fetchTe/globables/issues"
+  },
+  "engines": {
+    "node": ">=14.15.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/fetchTe/globables.git"
+  }
+}