@leftium/gg 0.0.31 → 0.0.34

package/dist/gg.d.ts

@@ -1,4 +1,3 @@
-import ErrorStackParser from 'error-stack-parser';
 /**
  * Hook for capturing gg() output (used by Eruda plugin)
  */
@@ -9,13 +8,16 @@ interface CapturedEntry {
     message: string;
     args: unknown[];
     timestamp: number;
+    file?: string;
+    line?: number;
+    col?: number;
+    src?: string;
 }
 type OnLogCallback = (entry: CapturedEntry) => void;
 export declare function gg(): {
     fileName: string;
     functionName: string;
     url: string;
-    stack: ErrorStackParser.StackFrame[];
 };
 export declare function gg<T>(arg: T, ...args: unknown[]): T;
 export declare namespace gg {
@@ -85,6 +87,20 @@ export declare function bg(color: string): ChainableColorFn;
 export declare namespace gg {
     let _onLog: OnLogCallback | null;
     let ns: (nsLabel: string, ...args: unknown[]) => unknown;
+    let _ns: (options: {
+        ns: string;
+        file?: string;
+        line?: number;
+        col?: number;
+        src?: string;
+    }, ...args: unknown[]) => unknown;
+    let _o: (ns: string, file?: string, line?: number, col?: number, src?: string) => {
+        ns: string;
+        file?: string;
+        line?: number;
+        col?: number;
+        src?: string;
+    };
 }
 /**
  * Run gg diagnostics and log configuration status

package/dist/gg.js

@@ -1,5 +1,4 @@
-import debugFactory from './debug.js';
-import ErrorStackParser from 'error-stack-parser';
+import debugFactory, {} from './debug/index.js';
 import { BROWSER, DEV } from 'esm-env';
 import { toWordTuple } from './words.js';
 const _ggCallSitesPlugin = typeof __GG_TAG_PLUGIN__ !== 'undefined' ? __GG_TAG_PLUGIN__ : false;
@@ -9,23 +8,21 @@ const _ggCallSitesPlugin = typeof __GG_TAG_PLUGIN__ !== 'undefined' ? __GG_TAG_P
  */
 function createGgDebugger(namespace) {
     const dbg = debugFactory(namespace);
-    // Store the original formatArgs (if it exists)
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    // Store the original formatArgs
     const originalFormatArgs = dbg.formatArgs;
     // Override formatArgs to add padding to the namespace display
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     dbg.formatArgs = function (args) {
         // Call original formatArgs first
         if (originalFormatArgs) {
-            originalFormatArgs.call(this, args);
+            originalFormatArgs.call(dbg, args);
         }
         // Extract the callpoint from namespace (strip 'gg:' prefix and any URL suffix)
-        const nsMatch = this.namespace.match(/^gg:([^h]+?)(?:http|$)/);
-        const callpoint = nsMatch ? nsMatch[1] : this.namespace.replace(/^gg:/, '');
+        const nsMatch = dbg.namespace.match(/^gg:([^h]+?)(?:http|$)/);
+        const callpoint = nsMatch ? nsMatch[1] : dbg.namespace.replace(/^gg:/, '');
         const paddedCallpoint = callpoint.padEnd(maxCallpointLength, ' ');
         // Replace the namespace in the formatted string with padded version
         if (typeof args[0] === 'string') {
-            args[0] = args[0].replace(this.namespace, `gg:${paddedCallpoint}`);
+            args[0] = args[0].replace(dbg.namespace, `gg:${paddedCallpoint}`);
         }
     };
     return dbg;
@@ -91,7 +88,6 @@ function getServerPort() {
         }
     });
 }
-const timestampRegex = /(\?t=\d+)?$/;
 const port = await getServerPort();
 /**
  * Determines if gg should be enabled based on environment and runtime triggers.
@@ -169,6 +165,23 @@ const namespaceToLogFunction = new Map();
 let maxCallpointLength = 0;
 // Cache: raw stack line → word tuple (avoids re-hashing the same call site)
 const stackLineCache = new Map();
+/**
+ * Resolve the callpoint for the caller at the given stack depth.
+ * depth=2 → caller of gg(), depth=3 → caller of gg.ns() (extra frame).
+ */
+function resolveCallpoint(depth) {
+    const rawStack = new Error().stack || '';
+    const callerLine = rawStack.split('\n')[depth] || rawStack;
+    const callerKey = callerLine.replace(/:\d+:\d+\)?$/, '').trim();
+    const callpoint = stackLineCache.get(callerKey) ?? toWordTuple(callerKey);
+    if (!stackLineCache.has(callerKey)) {
+        stackLineCache.set(callerKey, callpoint);
+    }
+    if (callpoint.length < 80 && callpoint.length > maxCallpointLength) {
+        maxCallpointLength = callpoint.length;
+    }
+    return callpoint;
+}
 /**
  * Reset the namespace width tracking.
  * Useful after configuration checks that may have long callpoint paths.
@@ -176,80 +189,37 @@ const stackLineCache = new Map();
 function resetNamespaceWidth() {
     maxCallpointLength = 0;
 }
-function openInEditorUrl(fileName) {
-    return ggConfig.openInEditorUrlTemplate.replace('$FILENAME', encodeURIComponent(fileName).replaceAll('%2F', '/'));
+function openInEditorUrl(fileName, line, col) {
+    let url = ggConfig.openInEditorUrlTemplate.replace('$FILENAME', encodeURIComponent(fileName).replaceAll('%2F', '/'));
+    if (line != null)
+        url += `&line=${line}`;
+    if (col != null)
+        url += `&col=${col}`;
+    return url;
 }
 export function gg(...args) {
     if (!ggConfig.enabled || isCloudflareWorker()) {
-        return args.length ? args[0] : { url: '', stack: [] };
-    }
-    // Initialize return values
-    let fileName = '';
-    let functionName = '';
-    let url = '';
-    let stack = [];
-    let namespace = 'gg:';
-    // 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.
-    if (!_ggCallSitesPlugin) {
-        if (DEV) {
-            // Development without plugin: full stack parsing for detailed callpoint info
-            // 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
-            const filename = stack[0].fileName?.replace(timestampRegex, '') || '';
-            // Example: src/routes/+page.svelte
-            const filenameToOpen = filename.replace(srcRootRegex, '$<folderName>/');
-            url = openInEditorUrl(filenameToOpen);
-            // Example: routes/+page.svelte
-            fileName = filename.replace(srcRootRegex, '');
-            functionName = stack[0].functionName || '';
-            // A callpoint is uniquely identified by the filename plus function name
-            const callpoint = `${fileName}${functionName ? `@${functionName}` : ''}`;
-            if (callpoint.length < 80 && callpoint.length > maxCallpointLength) {
-                maxCallpointLength = callpoint.length;
-            }
-            // Namespace without padding - keeps colors stable
-            // Editor link appended if enabled
-            namespace = `gg:${callpoint}${ggConfig.editorLink ? url : ''}`;
-        }
-        else {
-            // Production without plugin: cheap stack hash → deterministic word tuple
-            // Avoids expensive ErrorStackParser; just grabs the raw stack line and hashes it.
-            // Same call site always produces the same word pair (e.g. "calm-fox").
-            const rawStack = new Error().stack || '';
-            // Stack line [2]: skip "Error" header [0] and gg() frame [1]
-            const callerLine = rawStack.split('\n')[2] || rawStack;
-            // Strip line:col numbers so all gg() calls within the same function
-            // hash to the same word tuple. In minified builds, multiple gg() calls
-            // in one function differ only by column offset — we want them grouped.
-            // Chrome: "at handleClick (chunk-abc.js:1:45892)" → "at handleClick (chunk-abc.js)"
-            // Firefox: "handleClick@https://...:1:45892" → "handleClick@https://..."
-            const callerKey = callerLine.replace(/:\d+:\d+\)?$/, '').trim();
-            const callpoint = stackLineCache.get(callerKey) ?? toWordTuple(callerKey);
-            if (!stackLineCache.has(callerKey)) {
-                stackLineCache.set(callerKey, callpoint);
-            }
-            if (callpoint.length < 80 && callpoint.length > maxCallpointLength) {
-                maxCallpointLength = callpoint.length;
-            }
-            namespace = `gg:${callpoint}`;
-        }
-    }
+        return args.length ? args[0] : { fileName: '', functionName: '', url: '' };
+    }
+    // Without the call-sites plugin, use cheap stack hash → deterministic word tuple.
+    // When the plugin IS installed, all gg() calls are rewritten to gg._ns() at build time,
+    // so this code path only runs for un-transformed calls (i.e. plugin not installed).
+    // Same call site always produces the same word pair (e.g. "calm-fox").
+    // depth=2: skip "Error" header [0] and gg() frame [1]
+    const callpoint = resolveCallpoint(2);
+    const namespace = `gg:${callpoint}`;
     const ggLogFunction = namespaceToLogFunction.get(namespace) ||
         namespaceToLogFunction.set(namespace, createGgDebugger(namespace)).get(namespace);
     // Prepare args for logging
     let logArgs;
     let returnValue;
     if (!args.length) {
-        // No arguments: log editor link
-        logArgs = [`    📝📝 ${url} 👀👀`];
+        // No arguments: return stub call-site info (no open-in-editor without plugin)
+        logArgs = [`    📝 ${callpoint} (install gg-call-sites-plugin for editor links)`];
         returnValue = {
-            fileName,
-            functionName,
-            url,
-            stack
+            fileName: callpoint,
+            functionName: '',
+            url: ''
         };
     }
     else if (args.length === 1) {
@@ -288,22 +258,54 @@ export function gg(...args) {
 /**
  * gg.ns() - Log with an explicit namespace (callpoint label).
  *
- * 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.
+ * Users call gg.ns() directly to set a meaningful label that survives
+ * across builds. For the internal plugin-generated version with file
+ * metadata, see gg._ns().
+ *
+ * The label supports template variables (substituted by the vite plugin
+ * at build time, or at runtime for $NS):
+ *   $NS   - auto-generated callpoint (file@fn with plugin, word-tuple without)
+ *   $FN   - enclosing function name (plugin only, empty without)
+ *   $FILE - short file path (plugin only, empty without)
+ *   $LINE - line number (plugin only, empty without)
+ *   $COL  - column number (plugin only, empty without)
  *
  * @param nsLabel - The namespace label (appears as gg:<nsLabel> in output)
  * @param args - Same arguments as gg()
  * @returns Same as gg() - the first arg, or call-site info if no args
  *
  * @example
- * gg.ns("auth", "login failed")   // logs under namespace "gg:auth"
- * gg.ns("cart", item, quantity)    // logs under namespace "gg:cart"
+ * gg.ns("auth", "login failed")        // → gg:auth
+ * gg.ns("ERROR:$NS", msg)              // → gg:ERROR:routes/+page.svelte@handleClick (with plugin)
+ *                                       // → gg:ERROR:calm-fox (without plugin)
+ * gg.ns("$NS:validation", fieldName)   // → gg:routes/+page.svelte@handleClick:validation
  */
 gg.ns = function (nsLabel, ...args) {
+    // Resolve $NS at runtime (word-tuple fallback when plugin isn't installed).
+    // With the plugin, $NS is already substituted at build time before this runs.
+    // depth=3: skip "Error" [0], resolveCallpoint [1], gg.ns [2] → caller [3]
+    if (nsLabel.includes('$NS')) {
+        const callpoint = resolveCallpoint(3);
+        nsLabel = nsLabel.replace(/\$NS/g, callpoint);
+    }
+    return gg._ns({ ns: nsLabel }, ...args);
+};
+/**
+ * gg._ns() - Internal: log with namespace and source file metadata.
+ *
+ * Called by the ggCallSitesPlugin Vite plugin, which rewrites both bare gg()
+ * calls and manual gg.ns() calls to gg._ns({ns, file, line, col}, ...) at
+ * build time. This gives each call site a unique namespace plus the source
+ * location for open-in-editor support.
+ *
+ * @param options - { ns: string; file?: string; line?: number; col?: number }
+ * @param args - Same arguments as gg()
+ * @returns Same as gg() - the first arg, or call-site info if no args
+ */
+gg._ns = function (options, ...args) {
+    const { ns: nsLabel, file, line, col, src } = options;
     if (!ggConfig.enabled || isCloudflareWorker()) {
-        return args.length ? args[0] : { url: '', stack: [] };
+        return args.length ? args[0] : { fileName: '', functionName: '', url: '' };
     }
     const namespace = `gg:${nsLabel}`;
     if (nsLabel.length < 80 && nsLabel.length > maxCallpointLength) {
@@ -311,12 +313,17 @@ gg.ns = function (nsLabel, ...args) {
     }
     const ggLogFunction = namespaceToLogFunction.get(namespace) ||
         namespaceToLogFunction.set(namespace, createGgDebugger(namespace)).get(namespace);
-    // Prepare args for logging
+    // Prepare args for logging (console output is value-only; src is carried
+    // on CapturedEntry for the Eruda UI to display on hover)
     let logArgs;
     let returnValue;
     if (!args.length) {
+        // No arguments: return call-site info for open-in-editor
+        const fileName = file ? file.replace(srcRootRegex, '') : nsLabel;
+        const functionName = nsLabel.includes('@') ? nsLabel.split('@').pop() || '' : '';
+        const url = file ? openInEditorUrl(file, line, col) : '';
         logArgs = [`    📝 ${nsLabel}`];
-        returnValue = { fileName: '', functionName: '', url: '', stack: [] };
+        returnValue = { fileName, functionName, url };
     }
     else if (args.length === 1) {
         logArgs = [args[0]];
@@ -340,7 +347,11 @@ gg.ns = function (nsLabel, ...args) {
         diff: ggLogFunction.diff || 0,
         message: logArgs.length === 1 ? String(logArgs[0]) : logArgs.map(String).join(' '),
         args: logArgs,
-        timestamp: Date.now()
+        timestamp: Date.now(),
+        file,
+        line,
+        col,
+        src
     };
     if (_onLogCallback) {
         _onLogCallback(entry);
@@ -350,6 +361,18 @@ gg.ns = function (nsLabel, ...args) {
     }
     return returnValue;
 };
+/**
+ * gg._o() - Internal: build options object for gg._ns() without object literal syntax.
+ *
+ * Used by the vite plugin to transform gg() calls in Svelte template markup,
+ * where object literals ({...}) would break Svelte's template parser.
+ *
+ * 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.disable = isCloudflareWorker() ? () => { } : debugFactory.disable;
 gg.enable = isCloudflareWorker() ? () => { } : debugFactory.enable;
 /**
@@ -506,26 +529,28 @@ Object.defineProperty(gg, '_onLog', {
 // eslint-disable-next-line @typescript-eslint/no-namespace
 (function (gg) {
 })(gg || (gg = {}));
+// Track if diagnostics have already run to prevent double execution
+let diagnosticsRan = false;
 /**
  * Run gg diagnostics and log configuration status
  * Can be called immediately or delayed (e.g., after Eruda loads)
  */
 export async function runGgDiagnostics() {
-    if (!ggConfig.showHints || isCloudflareWorker())
+    if (!ggConfig.showHints || isCloudflareWorker() || diagnosticsRan)
         return;
+    diagnosticsRan = true;
+    // Create test debugger for server-side enabled check
     const ggLogTest = debugFactory('gg:TEST');
     let ggMessage = '\n';
-    // Utilities for forming ggMessage:
     const message = (s) => (ggMessage += `${s}\n`);
     const checkbox = (test) => (test ? '✅' : '❌');
     const makeHint = (test, ifTrue, ifFalse = '') => (test ? ifTrue : ifFalse);
-    // Use plain console.log for diagnostics - appears in Eruda's Console tab
     console.log(`Loaded gg module. Checking configuration...`);
-    if (ggConfig.enabled && ggLogTest.enabled) {
-        gg('If you can see this logg, gg configured correctly!');
+    const configOk = BROWSER ? ggConfig.enabled : ggConfig.enabled && ggLogTest.enabled;
+    if (configOk) {
         message(`No problems detected:`);
         if (BROWSER) {
-            message(`ℹ️ If gg output not visible: enable "Verbose" log level in DevTools, or check Eruda's GG tab.`);
+            message(`ℹ️ gg messages appear in the Eruda GG panel. Use Settings > Native Console to also show in browser console.`);
         }
     }
     else {
@@ -541,35 +566,27 @@ export async function runGgDiagnostics() {
         }
     }
     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}`);
-    }
-    else {
-        const hint = makeHint(!ggLogTest.enabled, ' (Try `DEBUG=gg:* npm dev`)');
+    if (!BROWSER) {
+        // Server-side: check DEBUG env var (the only output path on the server)
+        const hint = makeHint(!ggLogTest.enabled, ' (Try `DEBUG=gg:* npm run dev`)');
         if (dotenvModule) {
-            dotenvModule.config(); // Load the environment variables
+            dotenvModule.config();
         }
         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 (faster/more reliable). Without plugin, prod uses word-tuple names (e.g. calm-fox) as unique call-site identifiers.`));
+    // Optional plugin diagnostics
+    message(makeHint(_ggCallSitesPlugin, `✅ gg-call-sites vite plugin detected! Call-site namespaces and open-in-editor links baked in at build time.`, `⚠️ gg-call-sites vite plugin not detected. Add ggCallSitesPlugin() to vite.config.ts for file:line call-site namespaces and open-in-editor links. Without plugin, using word-tuple names (e.g. calm-fox) as call-site identifiers.`));
     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
-    // This prevents the long callpoint from the config check from affecting subsequent logs
     resetNamespaceWidth();
 }
-// Run diagnostics immediately on module load if Eruda is not being used
-// (If Eruda will load, the loader will call runGgDiagnostics after Eruda is ready)
-if (ggConfig.showHints && !isCloudflareWorker()) {
-    // Only run immediately if we're not in a context where Eruda might load
-    // In browser dev mode, assume Eruda might load and skip immediate diagnostics
-    if (!BROWSER || !DEV) {
-        runGgDiagnostics();
-    }
+// Run diagnostics immediately on module load ONLY in Node.js environments
+// In browser, the Eruda loader (if configured) will call runGgDiagnostics()
+// after Eruda is ready. If Eruda is not configured, diagnostics won't run
+// in browser (user must manually check console or call runGgDiagnostics()).
+if (ggConfig.showHints && !isCloudflareWorker() && !BROWSER) {
+    runGgDiagnostics();
 }

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import { gg, fg, bg } from './gg.js';
 import openInEditorPlugin from './open-in-editor.js';
 import ggCallSitesPlugin from './gg-call-sites-plugin.js';
+export { default as GgConsole } from './GgConsole.svelte';
 export { gg, fg, bg, openInEditorPlugin, ggCallSitesPlugin };

package/dist/index.js

@@ -2,4 +2,5 @@
 import { gg, fg, bg } from './gg.js';
 import openInEditorPlugin from './open-in-editor.js';
 import ggCallSitesPlugin from './gg-call-sites-plugin.js';
+export { default as GgConsole } from './GgConsole.svelte';
 export { gg, fg, bg, openInEditorPlugin, ggCallSitesPlugin };

package/dist/open-in-editor.js

@@ -16,17 +16,30 @@ export default function openInEditorPlugin(specifiedEditor, srcRoot, onErrorCall
         name: 'open-in-editor',
         configureServer(server) {
             server.middlewares.use('/__open-in-editor', (req, res) => {
-                const { file } = url.parse(req.url || '', true).query || {};
+                const { file, line, col, editor } = url.parse(req.url || '', true).query || {};
                 if (!file) {
                     res.statusCode = 500;
                     res.end(`open-in-editor-plugin: required query param "file" is missing.`);
                 }
                 else {
                     res.statusCode = 222;
-                    launch(path.resolve(srcRoot, file), specifiedEditor, onErrorCallback);
+                    // launch-editor supports file:line:col format for cursor positioning
+                    let fileArg = path.resolve(srcRoot, file);
+                    if (line)
+                        fileArg += `:${line}`;
+                    if (line && col)
+                        fileArg += `:${col}`;
+                    // Use editor from query param if provided, otherwise fall back to plugin config
+                    const editorToUse = typeof editor === 'string' && editor ? editor : specifiedEditor;
+                    launch(fileArg, editorToUse, onErrorCallback);
                     res.end('<p>You may safely close this window.</p><script>window.close()</script>');
                 }
             });
+            // Expose project root for client-side $ROOT variable (forward slashes for URI compat)
+            server.middlewares.use('/__gg-project-root', (_req, res) => {
+                res.setHeader('Content-Type', 'text/plain');
+                res.end(srcRoot.replace(/\\/g, '/'));
+            });
         }
     };
 }

package/dist/vite.d.ts

@@ -0,0 +1,37 @@
+import type { Plugin } from 'vite';
+import ggCallSitesPlugin from './gg-call-sites-plugin.js';
+import type { GgCallSitesPluginOptions } from './gg-call-sites-plugin.js';
+import openInEditorPlugin from './open-in-editor.js';
+export interface GgPluginsOptions {
+    /**
+     * Options for the call-sites Vite plugin (source metadata rewriting).
+     * @default {}
+     */
+    callSites?: GgCallSitesPluginOptions;
+    /**
+     * Enable the open-in-editor Vite plugin (dev server middleware).
+     * Set to `false` to disable.
+     * @default true
+     */
+    openInEditor?: boolean;
+}
+/**
+ * All gg Vite plugins bundled together.
+ *
+ * Includes:
+ * - `ggCallSitesPlugin` — rewrites `gg()` calls with source file/line/col metadata
+ * - `openInEditorPlugin` — adds `/__open-in-editor` dev server middleware
+ * - Automatic `es2022` build target (required for top-level await)
+ *
+ * @example
+ * ```ts
+ * import ggPlugins from '@leftium/gg/vite';
+ *
+ * export default defineConfig({
+ *   plugins: [sveltekit(), ...ggPlugins()]
+ * });
+ * ```
+ */
+export default function ggPlugins(options?: GgPluginsOptions): Plugin[];
+export { ggCallSitesPlugin, openInEditorPlugin };
+export type { GgCallSitesPluginOptions };

package/dist/vite.js

@@ -0,0 +1,46 @@
+import ggCallSitesPlugin from './gg-call-sites-plugin.js';
+import openInEditorPlugin from './open-in-editor.js';
+/**
+ * All gg Vite plugins bundled together.
+ *
+ * Includes:
+ * - `ggCallSitesPlugin` — rewrites `gg()` calls with source file/line/col metadata
+ * - `openInEditorPlugin` — adds `/__open-in-editor` dev server middleware
+ * - Automatic `es2022` build target (required for top-level await)
+ *
+ * @example
+ * ```ts
+ * import ggPlugins from '@leftium/gg/vite';
+ *
+ * export default defineConfig({
+ *   plugins: [sveltekit(), ...ggPlugins()]
+ * });
+ * ```
+ */
+export default function ggPlugins(options = {}) {
+    const plugins = [];
+    // Ensure es2022 target for top-level await support
+    plugins.push({
+        name: 'gg-config',
+        config() {
+            return {
+                build: {
+                    target: 'es2022'
+                },
+                optimizeDeps: {
+                    esbuildOptions: {
+                        target: 'es2022',
+                        supported: { 'top-level-await': true }
+                    }
+                }
+            };
+        }
+    });
+    plugins.push(ggCallSitesPlugin(options.callSites));
+    if (options.openInEditor !== false) {
+        plugins.push(openInEditorPlugin());
+    }
+    return plugins;
+}
+// Allow granular imports for advanced users
+export { ggCallSitesPlugin, openInEditorPlugin };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leftium/gg",
-  "version": "0.0.31",
+  "version": "0.0.34",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Leftium/gg.git"
@@ -9,9 +9,7 @@
   "files": [
     "dist",
     "!dist/**/*.test.*",
-    "!dist/**/*.spec.*",
-    "!dist/debug/",
-    "patches/"
+    "!dist/**/*.spec.*"
   ],
   "sideEffects": [
     "**/*.css"
@@ -21,8 +19,13 @@
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
+      "svelte": "./dist/index.js",
       "default": "./dist/index.js"
     },
+    "./vite": {
+      "types": "./dist/vite.d.ts",
+      "default": "./dist/vite.js"
+    },
     "./eruda": {
       "types": "./dist/eruda/index.d.ts",
       "default": "./dist/eruda/index.js"
@@ -31,21 +34,21 @@
   "peerDependencies": {
     "svelte": "^5.0.0"
   },
+  "peerDependenciesMeta": {
+    "svelte": {
+      "optional": true
+    }
+  },
   "devDependencies": {
     "@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.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.2.2",
     "add": "^2.0.6",
-    "debug": "^4.4.3",
     "eruda": "^3.4.3",
     "eslint": "^10.0.0",
     "eslint-config-prettier": "^10.1.8",
@@ -54,21 +57,23 @@
     "prettier": "^3.8.1",
     "prettier-plugin-svelte": "^3.4.1",
     "publint": "^0.3.17",
-    "rollup": "^4.57.1",
     "supports-color": "^10.2.2",
     "svelte": "^5.50.1",
     "svelte-check": "^4.3.6",
     "typescript": "^5.9.3",
     "typescript-eslint": "^8.55.0",
     "vite": "^7.3.1",
-    "vite-plugin-devtools-json": "^1.0.0"
+    "vite-plugin-devtools-json": "^1.0.0",
+    "vitest": "^4.0.18"
   },
   "keywords": [
     "svelte"
   ],
   "dependencies": {
+    "@sveltejs/acorn-typescript": "^1.0.9",
+    "@types/estree": "^1.0.8",
+    "acorn": "^8.15.0",
     "dotenv": "^17.2.4",
-    "error-stack-parser": "^2.1.4",
     "esm-env": "^1.2.2",
     "launch-editor": "^2.12.0"
   },
@@ -79,6 +84,8 @@
     "check": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json",
     "check:watch": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json --watch",
     "format": "prettier --write .",
-    "lint": "prettier --check . && eslint ."
+    "lint": "prettier --check . && eslint .",
+    "test": "vitest run",
+    "test:watch": "vitest"
   }
 }

package/dist/debug-bundled.d.ts

@@ -1,2 +0,0 @@
-export { w as default };
-declare var w: any;