@leftium/gg 0.0.21 → 0.0.23

package/dist/gg.d.ts

@@ -1,4 +1,16 @@
 import ErrorStackParser from 'error-stack-parser';
+/**
+ * Hook for capturing gg() output (used by Eruda plugin)
+ */
+interface CapturedEntry {
+    namespace: string;
+    color: string;
+    diff: number;
+    message: string;
+    args: unknown[];
+    timestamp: number;
+}
+type OnLogCallback = (entry: CapturedEntry) => void;
 export declare function gg(): {
     fileName: string;
     functionName: string;
@@ -9,4 +21,7 @@ export declare function gg<T>(arg: T, ...args: unknown[]): T;
 export declare namespace gg {
     var disable: () => void;
     var enable: (namespaces: string) => void;
+    var clearPersist: () => void;
+    var _onLog: OnLogCallback | null;
 }
+export {};

package/dist/gg.js

@@ -64,8 +64,64 @@ function getServerPort() {
 }
 const timestampRegex = /(\?t=\d+)?$/;
 const port = await getServerPort();
+/**
+ * Determines if gg should be enabled based on environment and runtime triggers.
+ *
+ * Priority order:
+ * 1. CloudFlare Workers → always disabled (no stack traces, no filesystem)
+ * 2. ENV hard-disable → absolute override, no runtime enable possible
+ * 3. DEV mode → always enabled
+ * 4. PROD mode → requires runtime trigger (?gg URL param or localStorage)
+ */
+function isGgEnabled() {
+    // CloudFlare Workers - hard disable (no Error stacks, no filesystem)
+    if (isCloudflareWorker())
+        return false;
+    // ENV hard-disable takes absolute precedence
+    // Allows completely removing gg from production builds
+    if (BROWSER) {
+        if (typeof import.meta.env?.VITE_GG_ENABLED === 'string' &&
+            import.meta.env.VITE_GG_ENABLED === 'false') {
+            return false;
+        }
+    }
+    else {
+        if (process?.env?.GG_ENABLED === 'false') {
+            return false;
+        }
+    }
+    // Development - always enabled (unless ENV explicitly disabled above)
+    if (DEV)
+        return true;
+    // Production - requires runtime trigger (similar to Eruda widget loading)
+    if (BROWSER) {
+        // Check URL param (?gg)
+        try {
+            const params = new URLSearchParams(window.location.search);
+            if (params.has('gg')) {
+                // Persist the decision so it survives navigation
+                localStorage.setItem('gg-enabled', 'true');
+                return true;
+            }
+        }
+        catch {
+            // URLSearchParams or localStorage might not be available
+        }
+        // Check localStorage persistence
+        try {
+            if (localStorage.getItem('gg-enabled') === 'true') {
+                return true;
+            }
+        }
+        catch {
+            // localStorage might not be available
+        }
+    }
+    // Default: disabled in production without trigger
+    return false;
+}
 const ggConfig = {
-    enabled: !isCloudflareWorker(), // Disable in CloudFlare Workers
+    enabled: isGgEnabled(),
     showHints: !isCloudflareWorker(), // Don't show hints in CloudFlare Workers
     editorLink: false,
     openInEditorUrlTemplate: `http://localhost:${port}/__open-in-editor?file=$FILENAME`,
@@ -140,10 +196,43 @@ export function gg(...args) {
     else {
         ggLogFunction(args[0], ...args.slice(1));
     }
+    // Call capture hook if registered (for Eruda plugin)
+    if (gg._onLog) {
+        // Don't stringify args - keep them as-is for expandable objects
+        const message = args.length === 1 ? String(args[0]) : args.map(String).join(' ');
+        gg._onLog({
+            namespace,
+            color: ggLogFunction.color,
+            diff: ggLogFunction.diff || 0, // Millisecond diff from debug library
+            message,
+            args, // Keep raw args for object inspection
+            timestamp: Date.now()
+        });
+    }
     return args[0];
 }
 gg.disable = isCloudflareWorker() ? () => { } : debugFactory.disable;
 gg.enable = isCloudflareWorker() ? () => { } : debugFactory.enable;
+/**
+ * Clear the persisted gg-enabled state from localStorage.
+ * Useful to reset production trigger after testing with ?gg parameter.
+ * Page reload required for change to take effect.
+ */
+gg.clearPersist = () => {
+    if (BROWSER) {
+        try {
+            localStorage.removeItem('gg-enabled');
+        }
+        catch {
+            // localStorage might not be available
+        }
+    }
+};
+/**
+ * Hook for capturing gg() output (used by Eruda plugin)
+ * Set this to a callback function to receive log entries
+ */
+gg._onLog = null;
 // Log some gg info to the JS console/terminal:
 if (ggConfig.showHints && !isCloudflareWorker()) {
     const ggLogTest = debugFactory('gg:TEST');
@@ -163,8 +252,16 @@ if (ggConfig.showHints && !isCloudflareWorker()) {
     else {
         message(`Problems detected; fix all ❌:`);
     }
-    const hint = makeHint(!ggConfig.enabled, ' (Update value in gg.ts file.)');
-    message(`${checkbox(ggConfig.enabled)} ggConfig.enabled: ${ggConfig.enabled}${hint}`);
+    let enableHint = '';
+    if (!ggConfig.enabled) {
+        if (DEV) {
+            enableHint = ' (Check GG_ENABLED env variable)';
+        }
+        else if (BROWSER) {
+            enableHint = ' (Add ?gg to URL or set localStorage["gg-enabled"]="true")';
+        }
+    }
+    message(`${checkbox(ggConfig.enabled)} gg enabled: ${ggConfig.enabled}${enableHint}`);
     if (BROWSER) {
         const hint = makeHint(!ggLogTest.enabled, " (Try `localStorage.debug = 'gg:*'`)");
         message(`${checkbox(ggLogTest.enabled)} localStorage.debug: ${localStorage?.debug}${hint}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leftium/gg",
-  "version": "0.0.21",
+  "version": "0.0.23",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Leftium/gg.git"
@@ -10,6 +10,7 @@
     "dist",
     "!dist/**/*.test.*",
     "!dist/**/*.spec.*",
+    "!dist/debug/",
     "patches/"
   ],
   "sideEffects": [
@@ -21,38 +22,44 @@
     ".": {
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
+    },
+    "./eruda": {
+      "types": "./dist/eruda/index.d.ts",
+      "default": "./dist/eruda/index.js"
     }
   },
   "peerDependencies": {
     "svelte": "^5.0.0"
   },
   "devDependencies": {
-    "@eslint/compat": "^2.0.1",
-    "@eslint/js": "^9.39.2",
+    "@eslint/compat": "^2.0.2",
+    "@eslint/js": "^10.0.1",
     "@picocss/pico": "^2.1.1",
     "@rollup/plugin-commonjs": "^29.0.0",
     "@rollup/plugin-node-resolve": "^16.0.3",
     "@rollup/plugin-terser": "^0.4.4",
-    "@sveltejs/adapter-vercel": "^6.3.0",
-    "@sveltejs/kit": "^2.49.4",
+    "@sveltejs/adapter-vercel": "^6.3.1",
+    "@sveltejs/kit": "^2.50.2",
     "@sveltejs/package": "^2.5.7",
     "@sveltejs/vite-plugin-svelte": "^6.2.4",
     "@types/debug": "^4.1.12",
-    "@types/node": "^25.0.8",
+    "@types/node": "^25.2.2",
     "add": "^2.0.6",
     "debug": "^4.4.3",
-    "eslint": "^9.39.2",
+    "eruda": "^3.4.3",
+    "eslint": "^10.0.0",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-svelte": "^3.14.0",
-    "globals": "^17.0.0",
-    "prettier": "^3.7.4",
+    "globals": "^17.3.0",
+    "prettier": "^3.8.1",
     "prettier-plugin-svelte": "^3.4.1",
-    "publint": "^0.3.16",
+    "publint": "^0.3.17",
+    "rollup": "^4.57.1",
     "supports-color": "^10.2.2",
-    "svelte": "^5.46.3",
-    "svelte-check": "^4.3.5",
+    "svelte": "^5.50.1",
+    "svelte-check": "^4.3.6",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.53.0",
+    "typescript-eslint": "^8.55.0",
     "vite": "^7.3.1",
     "vite-plugin-devtools-json": "^1.0.0"
   },
@@ -60,7 +67,7 @@
     "svelte"
   ],
   "dependencies": {
-    "dotenv": "^17.2.3",
+    "dotenv": "^17.2.4",
     "error-stack-parser": "^2.1.4",
     "esm-env": "^1.2.2",
     "launch-editor": "^2.12.0"

package/dist/debug/ms/index.d.ts

@@ -1,2 +0,0 @@
-declare function _exports(val: string | number, options?: Object): string | number;
-export = _exports;

package/dist/debug/ms/index.js

@@ -1,162 +0,0 @@
-/**
- * Helpers.
- */
-
-var s = 1000;
-var m = s * 60;
-var h = m * 60;
-var d = h * 24;
-var w = d * 7;
-var y = d * 365.25;
-
-/**
- * Parse or format the given `val`.
- *
- * Options:
- *
- *  - `long` verbose formatting [false]
- *
- * @param {String|Number} val
- * @param {Object} [options]
- * @throws {Error} throw an error if val is not a non-empty string or a number
- * @return {String|Number}
- * @api public
- */
-
-module.exports = function (val, options) {
-  options = options || {};
-  var type = typeof val;
-  if (type === 'string' && val.length > 0) {
-    return parse(val);
-  } else if (type === 'number' && isFinite(val)) {
-    return options.long ? fmtLong(val) : fmtShort(val);
-  }
-  throw new Error(
-    'val is not a non-empty string or a valid number. val=' +
-      JSON.stringify(val)
-  );
-};
-
-/**
- * Parse the given `str` and return milliseconds.
- *
- * @param {String} str
- * @return {Number}
- * @api private
- */
-
-function parse(str) {
-  str = String(str);
-  if (str.length > 100) {
-    return;
-  }
-  var match = /^(-?(?:\d+)?\.?\d+) *(milliseconds?|msecs?|ms|seconds?|secs?|s|minutes?|mins?|m|hours?|hrs?|h|days?|d|weeks?|w|years?|yrs?|y)?$/i.exec(
-    str
-  );
-  if (!match) {
-    return;
-  }
-  var n = parseFloat(match[1]);
-  var type = (match[2] || 'ms').toLowerCase();
-  switch (type) {
-    case 'years':
-    case 'year':
-    case 'yrs':
-    case 'yr':
-    case 'y':
-      return n * y;
-    case 'weeks':
-    case 'week':
-    case 'w':
-      return n * w;
-    case 'days':
-    case 'day':
-    case 'd':
-      return n * d;
-    case 'hours':
-    case 'hour':
-    case 'hrs':
-    case 'hr':
-    case 'h':
-      return n * h;
-    case 'minutes':
-    case 'minute':
-    case 'mins':
-    case 'min':
-    case 'm':
-      return n * m;
-    case 'seconds':
-    case 'second':
-    case 'secs':
-    case 'sec':
-    case 's':
-      return n * s;
-    case 'milliseconds':
-    case 'millisecond':
-    case 'msecs':
-    case 'msec':
-    case 'ms':
-      return n;
-    default:
-      return undefined;
-  }
-}
-
-/**
- * Short format for `ms`.
- *
- * @param {Number} ms
- * @return {String}
- * @api private
- */
-
-function fmtShort(ms) {
-  var msAbs = Math.abs(ms);
-  if (msAbs >= d) {
-    return Math.round(ms / d) + 'd';
-  }
-  if (msAbs >= h) {
-    return Math.round(ms / h) + 'h';
-  }
-  if (msAbs >= m) {
-    return Math.round(ms / m) + 'm';
-  }
-  if (msAbs >= s) {
-    return Math.round(ms / s) + 's';
-  }
-  return ms + 'ms';
-}
-
-/**
- * Long format for `ms`.
- *
- * @param {Number} ms
- * @return {String}
- * @api private
- */
-
-function fmtLong(ms) {
-  var msAbs = Math.abs(ms);
-  if (msAbs >= d) {
-    return plural(ms, msAbs, d, 'day');
-  }
-  if (msAbs >= h) {
-    return plural(ms, msAbs, h, 'hour');
-  }
-  if (msAbs >= m) {
-    return plural(ms, msAbs, m, 'minute');
-  }
-  if (msAbs >= s) {
-    return plural(ms, msAbs, s, 'second');
-  }
-  return ms + ' ms';
-}
-
-/**
- * Pluralization helper.
- */
-
-function plural(ms, msAbs, n, name) {
-  var isPlural = msAbs >= n * 1.5;
-  return Math.round(ms / n) + ' ' + name + (isPlural ? 's' : '');
-}

package/dist/debug/ms/package.json

@@ -1,38 +0,0 @@
-{
-  "name": "ms",
-  "version": "2.1.3",
-  "description": "Tiny millisecond conversion utility",
-  "repository": "vercel/ms",
-  "main": "./index",
-  "files": [
-    "index.js"
-  ],
-  "scripts": {
-    "precommit": "lint-staged",
-    "lint": "eslint lib/* bin/*",
-    "test": "mocha tests.js"
-  },
-  "eslintConfig": {
-    "extends": "eslint:recommended",
-    "env": {
-      "node": true,
-      "es6": true
-    }
-  },
-  "lint-staged": {
-    "*.js": [
-      "npm run lint",
-      "prettier --single-quote --write",
-      "git add"
-    ]
-  },
-  "license": "MIT",
-  "devDependencies": {
-    "eslint": "4.18.2",
-    "expect.js": "0.3.1",
-    "husky": "0.14.3",
-    "lint-staged": "5.0.0",
-    "mocha": "4.0.1",
-    "prettier": "2.0.5"
-  }
-}

package/dist/debug/package.json

@@ -1,64 +0,0 @@
-{
-  "name": "debug",
-  "version": "4.4.3",
-  "repository": {
-    "type": "git",
-    "url": "git://github.com/debug-js/debug.git"
-  },
-  "description": "Lightweight debugging utility for Node.js and the browser",
-  "keywords": [
-    "debug",
-    "log",
-    "debugger"
-  ],
-  "files": [
-    "src",
-    "LICENSE",
-    "README.md"
-  ],
-  "author": "Josh Junon (https://github.com/qix-)",
-  "contributors": [
-    "TJ Holowaychuk <tj@vision-media.ca>",
-    "Nathan Rajlich <nathan@tootallnate.net> (http://n8.io)",
-    "Andrew Rhyne <rhyneandrew@gmail.com>"
-  ],
-  "license": "MIT",
-  "scripts": {
-    "lint": "xo",
-    "test": "npm run test:node && npm run test:browser && npm run lint",
-    "test:node": "mocha test.js test.node.js",
-    "test:browser": "karma start --single-run",
-    "test:coverage": "cat ./coverage/lcov.info | coveralls"
-  },
-  "dependencies": {
-    "ms": "^2.1.3"
-  },
-  "devDependencies": {
-    "brfs": "^2.0.1",
-    "browserify": "^16.2.3",
-    "coveralls": "^3.0.2",
-    "karma": "^3.1.4",
-    "karma-browserify": "^6.0.0",
-    "karma-chrome-launcher": "^2.2.0",
-    "karma-mocha": "^1.3.0",
-    "mocha": "^5.2.0",
-    "mocha-lcov-reporter": "^1.2.0",
-    "sinon": "^14.0.0",
-    "xo": "^0.23.0"
-  },
-  "peerDependenciesMeta": {
-    "supports-color": {
-      "optional": true
-    }
-  },
-  "main": "./src/index.js",
-  "browser": "./src/browser.js",
-  "engines": {
-    "node": ">=6.0"
-  },
-  "xo": {
-    "rules": {
-      "import/extensions": "off"
-    }
-  }
-}

package/dist/debug/src/browser.d.ts

@@ -1,90 +0,0 @@
-declare const _exports: {
-    (namespace: string): Function;
-    debug: {
-        (namespace: string): Function;
-        debug: /*elided*/ any;
-        default: /*elided*/ any;
-        coerce: (val: Mixed) => Mixed;
-        disable: () => string;
-        enable: (namespaces: string) => void;
-        enabled: (name: string) => boolean;
-        humanize: (val: string | number, options?: Object) => string | number;
-        destroy: () => void;
-        names: any[];
-        skips: any[];
-        formatters: {};
-        selectColor: (namespace: string) => number | string;
-    };
-    default: {
-        (namespace: string): Function;
-        debug: /*elided*/ any;
-        default: /*elided*/ any;
-        coerce: (val: Mixed) => Mixed;
-        disable: () => string;
-        enable: (namespaces: string) => void;
-        enabled: (name: string) => boolean;
-        humanize: (val: string | number, options?: Object) => string | number;
-        destroy: () => void;
-        names: any[];
-        skips: any[];
-        formatters: {};
-        selectColor: (namespace: string) => number | string;
-    };
-    coerce: (val: Mixed) => Mixed;
-    disable: () => string;
-    enable: (namespaces: string) => void;
-    enabled: (name: string) => boolean;
-    humanize: (val: string | number, options?: Object) => string | number;
-    destroy: (() => void) | (() => void);
-    names: any[];
-    skips: any[];
-    formatters: {};
-    selectColor: (namespace: string) => number | string;
-    formatArgs: typeof formatArgs;
-    save: typeof save;
-    load: typeof load;
-    useColors: typeof useColors;
-    storage: LocalStorage;
-    /**
-     * Colors.
-     */
-    colors: string[];
-    /**
-     * Invokes `console.debug()` when available.
-     * No-op when `console.debug` is not a "function".
-     * If `console.debug` is not available, falls back
-     * to `console.log`.
-     *
-     * @api public
-     */
-    log: (...data: any[]) => void;
-};
-export = _exports;
-/**
- * Colorize log arguments if enabled.
- *
- * @api public
- */
-declare function formatArgs(args: any): void;
-/**
- * Save `namespaces`.
- *
- * @param {String} namespaces
- * @api private
- */
-declare function save(namespaces: string): void;
-/**
- * Load `namespaces`.
- *
- * @return {String} returns the previously persisted debug modes
- * @api private
- */
-declare function load(): string;
-/**
- * Currently only WebKit-based Web Inspectors, Firefox >= v31,
- * and the Firebug extension (any Firefox version) are known
- * to support "%c" CSS customizations.
- *
- * TODO: add a `localStorage` variable to explicitly enable/disable colors
- */
-declare function useColors(): any;