@leftium/gg 0.0.30 → 0.0.31

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';
+import { toWordTuple } from './words.js';
 const _ggCallSitesPlugin = typeof __GG_TAG_PLUGIN__ !== 'undefined' ? __GG_TAG_PLUGIN__ : false;
 /**
  * Creates a debug instance with custom formatArgs to add namespace padding
@@ -166,6 +167,8 @@ const srcRootRegex = new RegExp(ggConfig.srcRootPattern, 'i');
 // - Cache and reuse the same log function for a given callpoint.
 const namespaceToLogFunction = new Map();
 let maxCallpointLength = 0;
+// Cache: raw stack line → word tuple (avoids re-hashing the same call site)
+const stackLineCache = new Map();
 /**
  * Reset the namespace width tracking.
  * Useful after configuration checks that may have long callpoint paths.
@@ -189,27 +192,50 @@ export function gg(...args) {
     // 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
-        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;
+    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}`;
         }
-        // Namespace without padding - keeps colors stable
-        // Editor link appended if enabled
-        namespace = `gg:${callpoint}${ggConfig.editorLink ? url : ''}`;
     }
     const ggLogFunction = namespaceToLogFunction.get(namespace) ||
         namespaceToLogFunction.set(namespace, createGgDebugger(namespace)).get(namespace);
@@ -527,7 +553,7 @@ 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)`));
+    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.`));
     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`));

package/dist/words.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Word lists for generating deterministic human-readable callpoint names.
+ * Used as a fallback in production when the gg-call-sites Vite plugin is not installed.
+ *
+ * Each list has exactly 256 entries (8-bit index) so a 32-bit hash cleanly maps to
+ * an adjective-noun pair: adjectives[hash & 0xFF] + "-" + nouns[(hash >> 8) & 0xFF]
+ * giving 65,536 unique combinations.
+ *
+ * Selection criteria:
+ * - Short (3-6 chars) for compact console output
+ * - Visually distinct (no near-homoglyphs like fast/last)
+ * - Inoffensive
+ */
+export declare const adjectives: readonly ["able", "acid", "aged", "airy", "apt", "avid", "awry", "balmy", "bare", "beefy", "bent", "big", "bland", "bleak", "blind", "bliss", "blue", "blunt", "bold", "brash", "brave", "brief", "briny", "brisk", "broad", "buff", "bulky", "bumpy", "burly", "busy", "calm", "cheap", "chewy", "chief", "chilly", "civil", "clean", "clear", "close", "cold", "cool", "coral", "cozy", "crisp", "cubic", "curly", "curvy", "cute", "cyan", "damp", "dark", "dear", "deep", "dense", "dewy", "dim", "dizzy", "dopey", "dorky", "draft", "dry", "dual", "dull", "dusty", "eager", "early", "easy", "edgy", "elfin", "elite", "empty", "equal", "even", "every", "evil", "exact", "extra", "faded", "fair", "fancy", "fast", "few", "fine", "firm", "first", "fishy", "fit", "five", "fixed", "fizzy", "flat", "fleet", "fluid", "foggy", "fond", "four", "free", "fresh", "front", "full", "funky", "funny", "furry", "fussy", "fuzzy", "gaudy", "giant", "glad", "gold", "good", "grand", "gray", "great", "green", "grim", "gross", "grown", "gusty", "hairy", "half", "happy", "hard", "hardy", "harsh", "hasty", "hazy", "hefty", "high", "holy", "honey", "hot", "huge", "humid", "husky", "icy", "ideal", "idle", "inner", "ionic", "iron", "ivory", "jade", "jazzy", "jolly", "juicy", "jumbo", "jumpy", "just", "keen", "kind", "known", "lanky", "large", "last", "late", "lazy", "lean", "legal", "light", "limp", "live", "local", "lofty", "lone", "long", "lost", "loud", "loved", "low", "loyal", "lucky", "lumpy", "lusty", "mad", "magic", "main", "major", "meek", "merry", "messy", "mild", "minty", "misty", "mixed", "moist", "moody", "mossy", "muddy", "murky", "mushy", "muted", "naive", "neat", "nerdy", "new", "next", "nice", "nimby", "noble", "noisy", "north", "novel", "numb", "nutty", "oaken", "odd", "oily", "old", "olive", "only", "open", "other", "outer", "oval", "paid", "pale", "pasty", "perky", "petty", "pink", "plain", "plump", "plush", "polar", "poor", "prime", "proud", "pulpy", "pure", "pushy", "quick", "quiet", "rare", "raw", "ready", "real", "rich", "rigid", "ripe", "rosy", "rough", "round", "royal", "ruby", "rusty", "safe", "salty", "same", "sandy", "sharp", "shiny", "silky", "slim", "slow", "small", "snug"];
+export declare const nouns: readonly ["ant", "ape", "asp", "auk", "bass", "bat", "bear", "bee", "bird", "bison", "boar", "bream", "buck", "bug", "bull", "bunny", "calf", "carp", "cat", "chick", "chimp", "clam", "cobra", "cod", "colt", "conch", "coon", "cow", "crab", "crane", "crow", "cub", "dart", "deer", "dingo", "dodo", "doe", "dog", "dove", "drake", "drum", "duck", "eagle", "eel", "egret", "elk", "emu", "ewe", "fawn", "finch", "fish", "flea", "fly", "foal", "fox", "frog", "gator", "gecko", "goat", "goose", "grub", "gull", "guppy", "hare", "hawk", "hen", "heron", "hog", "hornet", "horse", "hound", "hyena", "ibex", "ibis", "iguana", "imp", "jackal", "jay", "joey", "kite", "kiwi", "koala", "koi", "lamb", "lark", "lemur", "lion", "llama", "lynx", "macaw", "mako", "mare", "mink", "mite", "mole", "moose", "moth", "mouse", "mule", "newt", "okapi", "orca", "oryx", "otter", "owl", "ox", "panda", "parrot", "perch", "pig", "pike", "plover", "pony", "prawn", "pug", "puma", "quail", "ram", "rat", "raven", "ray", "robin", "rook", "roach", "sail", "seal", "shad", "shark", "sheep", "shrew", "shrimp", "skate", "skink", "skua", "skunk", "sloth", "slug", "smelt", "snail", "snake", "snipe", "sole", "squid", "stag", "stork", "swan", "swift", "tapir", "tern", "thrush", "toad", "trout", "tuna", "turkey", "turtle", "viper", "vole", "vulture", "wasp", "whale", "wolf", "wombat", "worm", "wren", "yak", "zebra", "adder", "akita", "alpaca", "anole", "bongo", "camel", "civet", "coati", "coral", "corgi", "dhole", "drill", "dugong", "dunnit", "eland", "ermine", "falcon", "ferret", "gibbon", "gopher", "grouse", "haddok", "hermit", "hippo", "hoopoe", "hutia", "impala", "indri", "isopod", "jacana", "jerboa", "kakapo", "kudu", "loris", "magpie", "marten", "mayfly", "merlin", "murre", "nandu", "numbat", "ocelot", "osprey", "oyster", "paca", "pangol", "pariah", "peahen", "pipit", "pollock", "possum", "potoo", "python", "quokka", "rail", "redfin", "reebok", "remora", "rhea", "sable", "saola", "serval", "siskin", "snapper", "snoek", "sparrow", "spider", "sponge", "sprat", "stoat", "stilt", "stint", "sunbird", "tanuki", "tarpon", "tenrec", "tigon", "toucan", "treefr", "uguisu", "urutu", "vervet", "vizsla", "walrus", "weasel", "weevil", "whimbr", "whydah", "wisent", "zorilla"];
+/**
+ * FNV-1a hash (32-bit). Fast, good distribution, zero dependencies.
+ * Reference: http://www.isthe.com/chongo/tech/comp/fnv/
+ */
+export declare function fnv1a(str: string): number;
+/**
+ * Map a string to a deterministic adjective-noun pair.
+ * Same input always produces the same word tuple.
+ */
+export declare function toWordTuple(str: string): string;

package/dist/words.js

@@ -0,0 +1,105 @@
+/**
+ * Word lists for generating deterministic human-readable callpoint names.
+ * Used as a fallback in production when the gg-call-sites Vite plugin is not installed.
+ *
+ * Each list has exactly 256 entries (8-bit index) so a 32-bit hash cleanly maps to
+ * an adjective-noun pair: adjectives[hash & 0xFF] + "-" + nouns[(hash >> 8) & 0xFF]
+ * giving 65,536 unique combinations.
+ *
+ * Selection criteria:
+ * - Short (3-6 chars) for compact console output
+ * - Visually distinct (no near-homoglyphs like fast/last)
+ * - Inoffensive
+ */
+// prettier-ignore
+export const adjectives = [
+    'able', 'acid', 'aged', 'airy', 'apt', 'avid', 'awry', 'balmy',
+    'bare', 'beefy', 'bent', 'big', 'bland', 'bleak', 'blind', 'bliss',
+    'blue', 'blunt', 'bold', 'brash', 'brave', 'brief', 'briny', 'brisk',
+    'broad', 'buff', 'bulky', 'bumpy', 'burly', 'busy', 'calm', 'cheap',
+    'chewy', 'chief', 'chilly', 'civil', 'clean', 'clear', 'close', 'cold',
+    'cool', 'coral', 'cozy', 'crisp', 'cubic', 'curly', 'curvy', 'cute',
+    'cyan', 'damp', 'dark', 'dear', 'deep', 'dense', 'dewy', 'dim',
+    'dizzy', 'dopey', 'dorky', 'draft', 'dry', 'dual', 'dull', 'dusty',
+    'eager', 'early', 'easy', 'edgy', 'elfin', 'elite', 'empty', 'equal',
+    'even', 'every', 'evil', 'exact', 'extra', 'faded', 'fair', 'fancy',
+    'fast', 'few', 'fine', 'firm', 'first', 'fishy', 'fit', 'five',
+    'fixed', 'fizzy', 'flat', 'fleet', 'fluid', 'foggy', 'fond', 'four',
+    'free', 'fresh', 'front', 'full', 'funky', 'funny', 'furry', 'fussy',
+    'fuzzy', 'gaudy', 'giant', 'glad', 'gold', 'good', 'grand', 'gray',
+    'great', 'green', 'grim', 'gross', 'grown', 'gusty', 'hairy', 'half',
+    'happy', 'hard', 'hardy', 'harsh', 'hasty', 'hazy', 'hefty', 'high',
+    'holy', 'honey', 'hot', 'huge', 'humid', 'husky', 'icy', 'ideal',
+    'idle', 'inner', 'ionic', 'iron', 'ivory', 'jade', 'jazzy', 'jolly',
+    'juicy', 'jumbo', 'jumpy', 'just', 'keen', 'kind', 'known', 'lanky',
+    'large', 'last', 'late', 'lazy', 'lean', 'legal', 'light', 'limp',
+    'live', 'local', 'lofty', 'lone', 'long', 'lost', 'loud', 'loved',
+    'low', 'loyal', 'lucky', 'lumpy', 'lusty', 'mad', 'magic', 'main',
+    'major', 'meek', 'merry', 'messy', 'mild', 'minty', 'misty', 'mixed',
+    'moist', 'moody', 'mossy', 'muddy', 'murky', 'mushy', 'muted', 'naive',
+    'neat', 'nerdy', 'new', 'next', 'nice', 'nimby', 'noble', 'noisy',
+    'north', 'novel', 'numb', 'nutty', 'oaken', 'odd', 'oily', 'old',
+    'olive', 'only', 'open', 'other', 'outer', 'oval', 'paid', 'pale',
+    'pasty', 'perky', 'petty', 'pink', 'plain', 'plump', 'plush', 'polar',
+    'poor', 'prime', 'proud', 'pulpy', 'pure', 'pushy', 'quick', 'quiet',
+    'rare', 'raw', 'ready', 'real', 'rich', 'rigid', 'ripe', 'rosy',
+    'rough', 'round', 'royal', 'ruby', 'rusty', 'safe', 'salty', 'same',
+    'sandy', 'sharp', 'shiny', 'silky', 'slim', 'slow', 'small', 'snug',
+];
+// prettier-ignore
+export const nouns = [
+    'ant', 'ape', 'asp', 'auk', 'bass', 'bat', 'bear', 'bee',
+    'bird', 'bison', 'boar', 'bream', 'buck', 'bug', 'bull', 'bunny',
+    'calf', 'carp', 'cat', 'chick', 'chimp', 'clam', 'cobra', 'cod',
+    'colt', 'conch', 'coon', 'cow', 'crab', 'crane', 'crow', 'cub',
+    'dart', 'deer', 'dingo', 'dodo', 'doe', 'dog', 'dove', 'drake',
+    'drum', 'duck', 'eagle', 'eel', 'egret', 'elk', 'emu', 'ewe',
+    'fawn', 'finch', 'fish', 'flea', 'fly', 'foal', 'fox', 'frog',
+    'gator', 'gecko', 'goat', 'goose', 'grub', 'gull', 'guppy', 'hare',
+    'hawk', 'hen', 'heron', 'hog', 'hornet', 'horse', 'hound', 'hyena',
+    'ibex', 'ibis', 'iguana', 'imp', 'jackal', 'jay', 'joey', 'kite',
+    'kiwi', 'koala', 'koi', 'lamb', 'lark', 'lemur', 'lion', 'llama',
+    'lynx', 'macaw', 'mako', 'mare', 'mink', 'mite', 'mole', 'moose',
+    'moth', 'mouse', 'mule', 'newt', 'okapi', 'orca', 'oryx', 'otter',
+    'owl', 'ox', 'panda', 'parrot', 'perch', 'pig', 'pike', 'plover',
+    'pony', 'prawn', 'pug', 'puma', 'quail', 'ram', 'rat', 'raven',
+    'ray', 'robin', 'rook', 'roach', 'sail', 'seal', 'shad', 'shark',
+    'sheep', 'shrew', 'shrimp', 'skate', 'skink', 'skua', 'skunk', 'sloth',
+    'slug', 'smelt', 'snail', 'snake', 'snipe', 'sole', 'squid', 'stag',
+    'stork', 'swan', 'swift', 'tapir', 'tern', 'thrush', 'toad', 'trout',
+    'tuna', 'turkey', 'turtle', 'viper', 'vole', 'vulture', 'wasp', 'whale',
+    'wolf', 'wombat', 'worm', 'wren', 'yak', 'zebra', 'adder', 'akita',
+    'alpaca', 'anole', 'bongo', 'camel', 'civet', 'coati', 'coral', 'corgi',
+    'dhole', 'drill', 'dugong', 'dunnit', 'eland', 'ermine', 'falcon', 'ferret',
+    'gibbon', 'gopher', 'grouse', 'haddok', 'hermit', 'hippo', 'hoopoe', 'hutia',
+    'impala', 'indri', 'isopod', 'jacana', 'jerboa', 'kakapo', 'kudu', 'loris',
+    'magpie', 'marten', 'mayfly', 'merlin', 'murre', 'nandu', 'numbat', 'ocelot',
+    'osprey', 'oyster', 'paca', 'pangol', 'pariah', 'peahen', 'pipit', 'pollock',
+    'possum', 'potoo', 'python', 'quokka', 'rail', 'redfin', 'reebok', 'remora',
+    'rhea', 'sable', 'saola', 'serval', 'siskin', 'snapper', 'snoek', 'sparrow',
+    'spider', 'sponge', 'sprat', 'stoat', 'stilt', 'stint', 'sunbird', 'tanuki',
+    'tarpon', 'tenrec', 'tigon', 'toucan', 'treefr', 'uguisu', 'urutu', 'vervet',
+    'vizsla', 'walrus', 'weasel', 'weevil', 'whimbr', 'whydah', 'wisent', 'zorilla',
+];
+/**
+ * FNV-1a hash (32-bit). Fast, good distribution, zero dependencies.
+ * Reference: http://www.isthe.com/chongo/tech/comp/fnv/
+ */
+export function fnv1a(str) {
+    let hash = 0x811c9dc5; // FNV offset basis
+    for (let i = 0; i < str.length; i++) {
+        hash ^= str.charCodeAt(i);
+        hash = Math.imul(hash, 0x01000193); // FNV prime
+    }
+    return hash >>> 0; // Ensure unsigned 32-bit
+}
+/**
+ * Map a string to a deterministic adjective-noun pair.
+ * Same input always produces the same word tuple.
+ */
+export function toWordTuple(str) {
+    const hash = fnv1a(str);
+    const adj = adjectives[hash & 0xff];
+    const noun = nouns[(hash >>> 8) & 0xff];
+    return `${adj}-${noun}`;
+}

package/package.json

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