@leftium/gg 0.0.51 → 0.0.53

package/dist/eruda/index.js

@@ -1,5 +1,6 @@
 import { BROWSER } from 'esm-env';
 import { shouldLoadEruda, loadEruda } from './loader.js';
+import { enableGgRuntime } from '../gg.js';
 let initialized = false;
 /**
  * Initialize the gg Eruda plugin
@@ -62,16 +63,11 @@ function setupGestureDetection(options) {
         // Reset timer on each tap
         if (tapTimer)
             clearTimeout(tapTimer);
-        // If 5 taps detected, load Eruda
+        // If 5 taps detected, enable gg logging and load Eruda
         if (tapCount >= 5) {
-            console.log('[gg] 5 taps detected, loading Eruda...');
-            // Persist the decision
-            try {
-                localStorage.setItem('gg-enabled', 'true');
-            }
-            catch {
-                // localStorage might not be available
-            }
+            console.log('[gg] 5 taps detected, enabling gg logging and loading Eruda (session-only). For persistent logging across app restarts, run: localStorage.setItem("gg-enabled", "true")');
+            // Enable gg runtime for this session (flips ggConfig.enabled in memory only)
+            enableGgRuntime();
             loadEruda(options);
             resetTaps();
             return;

package/dist/gg.d.ts

@@ -91,6 +91,20 @@ export declare class GgChain<T> {
     /** Flush the log immediately and return the passthrough value. */
     get v(): T;
 }
+/**
+ * Enable gg logging at runtime (e.g., after 5-tap gesture in production).
+ * Flips the internal enabled flag so subsequent gg() calls start capturing.
+ * This is session-only — does not persist to localStorage, so the next
+ * page load / app launch starts with gg disabled again.
+ *
+ * To enable gg across app restarts (e.g., in a prod Tauri app), run this
+ * in the Eruda console instead:
+ *   localStorage.setItem("gg-enabled", "true")
+ * Clear with: localStorage.removeItem("gg-enabled") or gg.clearPersist()
+ *
+ * @internal Used by the Eruda gesture handler — not part of the public API.
+ */
+export declare function enableGgRuntime(): void;
 /**
  * Chainable wrapper returned by gg.time(). Only supports .ns() for setting
  * the namespace for the entire timer group (inherited by timeLog/timeEnd).

package/dist/gg.js

@@ -1,5 +1,5 @@
-import debugFactory, { debugReady } from './debug/index.js';
 import { BROWSER, DEV } from 'esm-env';
+import debugFactory, { debugReady } from './debug/index.js';
 import { toWordTuple } from './words.js';
 const _ggCallSitesPlugin = typeof __GG_TAG_PLUGIN__ !== 'undefined' ? __GG_TAG_PLUGIN__ : false;
 /**
@@ -11,7 +11,7 @@ function createGgDebugger(namespace) {
     // Store the original formatArgs
     const originalFormatArgs = dbg.formatArgs;
     // Override formatArgs to add padding to the namespace display
-    dbg.formatArgs = function (args) {
+    dbg.formatArgs = (args) => {
         // Call original formatArgs first
         if (originalFormatArgs) {
             originalFormatArgs.call(dbg, args);
@@ -232,7 +232,7 @@ export function gg(...args) {
  * @example
  * <OpenInEditorLink gg={gg.here()} />
  */
-gg.here = function () {
+gg.here = () => {
     if (!ggConfig.enabled) {
         return { fileName: '', functionName: '', url: '' };
     }
@@ -448,14 +448,15 @@ function ggLog(options, ...args) {
     // on CapturedEntry for the Eruda UI to display on hover)
     const logArgs = args.length === 0 ? ['(no args)'] : [...args];
     // Add level prefix emoji for info/warn/error
-    if (level === 'info') {
-        logArgs[0] = `ℹ️ ${logArgs[0]}`;
-    }
-    else if (level === 'warn') {
-        logArgs[0] = `⚠️ ${logArgs[0]}`;
-    }
-    else if (level === 'error') {
-        logArgs[0] = `⛔ ${logArgs[0]}`;
+    const levelEmoji = level === 'info' ? 'ℹ️' : level === 'warn' ? '⚠️' : level === 'error' ? '⛔' : '';
+    if (levelEmoji) {
+        if (typeof logArgs[0] === 'string') {
+            logArgs[0] = `${levelEmoji} ${logArgs[0]}`;
+        }
+        else {
+            // Don't coerce objects to string via template literal — prepend emoji as separate arg
+            logArgs.unshift(levelEmoji);
+        }
     }
     // Compute diff independently of the debug library's enabled state.
     // ggLogFunction.diff only updates when the debugger is enabled (i.e. localStorage.debug
@@ -508,7 +509,7 @@ function ggLog(options, ...args) {
  *
  * Returns a GgChain for chaining modifiers (.ns(), .warn(), etc.)
  */
-gg._ns = function (options, ...args) {
+gg._ns = (options, ...args) => {
     const disabled = !ggConfig.enabled;
     return new GgChain(args[0], args, options, disabled);
 };
@@ -517,7 +518,7 @@ gg._ns = function (options, ...args) {
  *
  * Called by the ggCallSitesPlugin when it rewrites gg.here() calls.
  */
-gg._here = function (options) {
+gg._here = (options) => {
     if (!ggConfig.enabled) {
         return { fileName: '', functionName: '', url: '' };
     }
@@ -540,9 +541,7 @@ gg._here = function (options) {
  * In <script> blocks:  gg._ns({ns:'...', file:'...', line:1, col:1}, args)
  * In template markup:  gg._ns(gg._o('...','...',1,1), args)
  */
-gg._o = function (ns, file, line, col, src) {
-    return { ns, file, line, col, src };
-};
+gg._o = (ns, file, line, col, src) => ({ ns, file, line, col, src });
 gg.disable = isCloudflareWorker() ? () => '' : () => debugFactory.disable();
 gg.enable = isCloudflareWorker() ? () => { } : (ns) => debugFactory.enable(ns);
 /**
@@ -560,6 +559,22 @@ gg.clearPersist = () => {
         }
     }
 };
+/**
+ * Enable gg logging at runtime (e.g., after 5-tap gesture in production).
+ * Flips the internal enabled flag so subsequent gg() calls start capturing.
+ * This is session-only — does not persist to localStorage, so the next
+ * page load / app launch starts with gg disabled again.
+ *
+ * To enable gg across app restarts (e.g., in a prod Tauri app), run this
+ * in the Eruda console instead:
+ *   localStorage.setItem("gg-enabled", "true")
+ * Clear with: localStorage.removeItem("gg-enabled") or gg.clearPersist()
+ *
+ * @internal Used by the Eruda gesture handler — not part of the public API.
+ */
+export function enableGgRuntime() {
+    ggConfig.enabled = true;
+}
 // ── Console-like methods ───────────────────────────────────────────────
 // Each public method (gg.warn, gg.error, etc.) has a corresponding internal
 // method (gg._warn, gg._error, etc.) that accepts call-site metadata from
@@ -633,7 +648,7 @@ gg.time = function (label = 'default') {
     return new GgTimerChain(label, options);
 };
 /** gg._time() - Internal: time with call-site metadata from Vite plugin. */
-gg._time = function (options, label = 'default') {
+gg._time = (options, label = 'default') => {
     if (ggConfig.enabled) {
         timers.set(label, { start: performance.now(), options });
     }
@@ -665,7 +680,7 @@ gg.timeLog = function (label = 'default', ...args) {
     ggLog({ ...timer.options, ns }, `${label}: ${formatElapsed(elapsed)}`, ...args);
 };
 /** gg._timeLog() - Internal: timeLog with call-site metadata from Vite plugin. */
-gg._timeLog = function (options, label = 'default', ...args) {
+gg._timeLog = (options, label = 'default', ...args) => {
     if (!ggConfig.enabled)
         return;
     const timer = timers.get(label);
@@ -702,7 +717,7 @@ gg.timeEnd = function (label = 'default') {
     ggLog({ ...timer.options, ns }, `${label}: ${formatElapsed(elapsed)}`);
 };
 /** gg._timeEnd() - Internal: timeEnd with call-site metadata from Vite plugin. */
-gg._timeEnd = function (options, label = 'default') {
+gg._timeEnd = (options, label = 'default') => {
     if (!ggConfig.enabled)
         return;
     const timer = timers.get(label);
@@ -871,7 +886,7 @@ const STYLE_CODES = {
  * Internal helper to create chainable color function with method chaining
  */
 function createColorFunction(fgCode = '', bgCode = '', styleCode = '') {
-    const tagFn = function (strings, ...values) {
+    const tagFn = (strings, ...values) => {
         const text = strings.reduce((acc, str, i) => acc + str + (values[i] !== undefined ? String(values[i]) : ''), '');
         return fgCode + bgCode + styleCode + text + '\x1b[0m';
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leftium/gg",
-  "version": "0.0.51",
+  "version": "0.0.53",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Leftium/gg.git"