@leftium/gg 0.0.28 → 0.0.29

package/dist/{gg-tag-plugin.d.ts → gg-call-sites-plugin.d.ts}

@@ -1,5 +1,5 @@
 import type { Plugin } from 'vite';
-export interface GgTagPluginOptions {
+export interface GgCallSitesPluginOptions {
     /**
      * Pattern to strip from file paths to produce short callpoints.
      * Should match up to and including the source root folder.
@@ -22,10 +22,10 @@ export interface GgTagPluginOptions {
  *
  * @example
  * // vite.config.ts
- * import { ggTagPlugin } from '@leftium/gg';
+ * import { ggCallSitesPlugin } from '@leftium/gg';
  *
  * export default defineConfig({
- *   plugins: [ggTagPlugin()]
+ *   plugins: [ggCallSitesPlugin()]
  * });
  */
-export default function ggTagPlugin(options?: GgTagPluginOptions): Plugin;
+export default function ggCallSitesPlugin(options?: GgCallSitesPluginOptions): Plugin;

package/dist/{gg-tag-plugin.js → gg-call-sites-plugin.js}

@@ -9,17 +9,27 @@
  *
  * @example
  * // vite.config.ts
- * import { ggTagPlugin } from '@leftium/gg';
+ * import { ggCallSitesPlugin } from '@leftium/gg';
  *
  * export default defineConfig({
- *   plugins: [ggTagPlugin()]
+ *   plugins: [ggCallSitesPlugin()]
  * });
  */
-export default function ggTagPlugin(options = {}) {
+export default function ggCallSitesPlugin(options = {}) {
     const srcRootPattern = options.srcRootPattern ?? '.*?(/(?:src|chunks)/)';
     const srcRootRegex = new RegExp(srcRootPattern, 'i');
     return {
-        name: 'gg-tag',
+        name: 'gg-call-sites',
+        config() {
+            // Set a compile-time flag so gg() can detect the plugin is installed.
+            // Vite replaces all occurrences of __GG_TAG_PLUGIN__ with true at build time,
+            // before any code executes — no ordering issues.
+            return {
+                define: {
+                    __GG_TAG_PLUGIN__: 'true'
+                }
+            };
+        },
         transform(code, id) {
             // Only process JS/TS/Svelte files
             if (!/\.(js|ts|svelte|jsx|tsx|mjs|mts)(\?.*)?$/.test(id))

package/dist/gg.js

@@ -1,6 +1,7 @@
 import debugFactory from './debug.js';
 import ErrorStackParser from 'error-stack-parser';
 import { BROWSER, DEV } from 'esm-env';
+const _ggCallSitesPlugin = typeof __GG_TAG_PLUGIN__ !== 'undefined' ? __GG_TAG_PLUGIN__ : false;
 /**
  * Creates a debug instance with custom formatArgs to add namespace padding
  * Padding is done at format time, not in the namespace itself, to keep colors stable
@@ -185,9 +186,12 @@ export function gg(...args) {
     let url = '';
     let stack = [];
     let namespace = 'gg:';
-    // In development: calculate detailed callpoint information
-    // In production: skip expensive stack parsing and use simple namespace
-    if (DEV) {
+    // When ggCallSitesPlugin is installed, all bare gg() calls are rewritten to gg.ns()
+    // at build time, so this code path only runs for un-transformed calls.
+    // Skip expensive stack parsing if the plugin is handling callpoints.
+    // In development without plugin: calculate detailed callpoint information
+    // In production without plugin: skip expensive stack parsing and use simple namespace
+    if (DEV && !_ggCallSitesPlugin) {
         // Ignore first stack frame, which is always the call to gg() itself.
         stack = ErrorStackParser.parse(new Error()).splice(1);
         // Example: http://localhost:5173/src/routes/+page.svelte
@@ -258,7 +262,7 @@ export function gg(...args) {
 /**
  * gg.ns() - Log with an explicit namespace (callpoint label).
  *
- * In production builds, the ggTagPlugin Vite plugin rewrites bare gg() calls
+ * In production builds, the ggCallSitesPlugin Vite plugin rewrites bare gg() calls
  * to gg.ns('callpoint', ...) so each call site gets a unique namespace even
  * after minification. Users can also call gg.ns() directly to set a meaningful
  * label that survives across builds.
@@ -514,10 +518,6 @@ export async function runGgDiagnostics() {
     if (BROWSER) {
         const hint = makeHint(!ggLogTest.enabled, " (Try `localStorage.debug = 'gg:*'`)");
         message(`${checkbox(ggLogTest.enabled)} localStorage.debug: ${localStorage?.debug}${hint}`);
-        if (DEV) {
-            const { status } = await fetch('/__open-in-editor?file=+');
-            message(makeHint(status === 222, `✅ (optional) open-in-editor vite plugin detected! (status code: ${status})`, `⚠️ (optional) open-in-editor vite plugin not detected. (status code: ${status}.) Add plugin in vite.config.ts`));
-        }
     }
     else {
         const hint = makeHint(!ggLogTest.enabled, ' (Try `DEBUG=gg:* npm dev`)');
@@ -526,6 +526,12 @@ export async function runGgDiagnostics() {
         }
         message(`${checkbox(ggLogTest.enabled)} DEBUG env variable: ${process?.env?.DEBUG}${hint}`);
     }
+    // Optional plugin diagnostics listed last
+    message(makeHint(_ggCallSitesPlugin, `✅ (optional) gg-call-sites vite plugin detected! Call-site namespaces baked in at build time.`, `⚠️ (optional) gg-call-sites vite plugin not detected. Add ggCallSitesPlugin() to vite.config.ts for build-time call-site namespaces (needed for useful namespaces in prod, faster/more reliable in dev)`));
+    if (BROWSER && DEV) {
+        const { status } = await fetch('/__open-in-editor?file=+');
+        message(makeHint(status === 222, `✅ (optional) open-in-editor vite plugin detected! (status code: ${status}) Clickable links open source files in editor.`, `⚠️ (optional) open-in-editor vite plugin not detected. (status code: ${status}) Add openInEditorPlugin() to vite.config.ts for clickable links that open source files in editor`));
+    }
     // Use plain console.log for diagnostics - appears in Eruda's Console tab
     console.log(ggMessage);
     // Reset namespace width after configuration check

package/dist/index.d.ts

@@ -1,4 +1,4 @@
 import { gg, fg, bg } from './gg.js';
 import openInEditorPlugin from './open-in-editor.js';
-import ggTagPlugin from './gg-tag-plugin.js';
-export { gg, fg, bg, openInEditorPlugin, ggTagPlugin };
+import ggCallSitesPlugin from './gg-call-sites-plugin.js';
+export { gg, fg, bg, openInEditorPlugin, ggCallSitesPlugin };

package/dist/index.js

@@ -1,5 +1,5 @@
 // Reexport your entry components here
 import { gg, fg, bg } from './gg.js';
 import openInEditorPlugin from './open-in-editor.js';
-import ggTagPlugin from './gg-tag-plugin.js';
-export { gg, fg, bg, openInEditorPlugin, ggTagPlugin };
+import ggCallSitesPlugin from './gg-call-sites-plugin.js';
+export { gg, fg, bg, openInEditorPlugin, ggCallSitesPlugin };

package/package.json

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