@walkeros/explorer 3.0.0 → 3.0.2

package/dist/utils/monaco-walkeros-providers.js

@@ -0,0 +1,284 @@
+import { getVariableCompletions, getDefinitionCompletions, getSecretCompletions, getPackageCompletions, getStepNameCompletions, getContractCompletions, getMappingPathCompletions, } from './monaco-walkeros-completions';
+import { getJsonPathAtOffset } from './monaco-json-path';
+import { detectMappingContext } from './mapping-context-detector';
+// Store context per model path for scoped completions
+const contextRegistry = new Map();
+const disposables = [];
+let registered = false;
+/**
+ * Update the IntelliSense context for a specific editor model.
+ */
+export function setIntelliSenseContext(modelPath, context) {
+    contextRegistry.set(modelPath, context);
+}
+/**
+ * Remove context when editor unmounts.
+ */
+export function removeIntelliSenseContext(modelPath) {
+    contextRegistry.delete(modelPath);
+}
+/**
+ * Register the walkerOS CompletionItemProvider and HoverProvider for JSON.
+ * Call once on app initialization. Safe to call multiple times (idempotent).
+ */
+export function registerWalkerOSProviders(monaco) {
+    if (registered)
+        return;
+    registered = true;
+    // CompletionItemProvider
+    disposables.push(monaco.languages.registerCompletionItemProvider('json', {
+        triggerCharacters: ['"', '.', '$'],
+        provideCompletionItems(model, position) {
+            const modelPath = model.uri.toString();
+            const context = contextRegistry.get(modelPath);
+            if (!context)
+                return { suggestions: [] };
+            const lineContent = model.getLineContent(position.lineNumber);
+            const textBeforeCursor = lineContent.substring(0, position.column - 1);
+            const entries = [];
+            if (textBeforeCursor.includes('$var.') ||
+                textBeforeCursor.endsWith('"$var')) {
+                entries.push(...getVariableCompletions(context.variables));
+            }
+            else if (textBeforeCursor.includes('$def.') ||
+                textBeforeCursor.endsWith('"$def')) {
+                entries.push(...getDefinitionCompletions(context.definitions));
+            }
+            else if (textBeforeCursor.includes('$secret.') ||
+                textBeforeCursor.endsWith('"$secret')) {
+                entries.push(...getSecretCompletions(context.secrets));
+            }
+            else if (textBeforeCursor.includes('$contract.') ||
+                textBeforeCursor.endsWith('"$contract')) {
+                const match = textBeforeCursor.match(/\$contract\.([a-zA-Z0-9_.]*)?$/);
+                const pathStr = match?.[1] || '';
+                const segments = pathStr ? pathStr.split('.').filter(Boolean) : [];
+                if (pathStr && !pathStr.endsWith('.') && segments.length > 0) {
+                    segments.pop();
+                }
+                entries.push(...getContractCompletions(context.contractRaw, segments));
+            }
+            else if (isInsideKey(model, position, 'package')) {
+                entries.push(...getPackageCompletions(context.packages, context.platform));
+            }
+            else if (isInsideKey(model, position, 'next') ||
+                isInsideKey(model, position, 'before')) {
+                const key = isInsideKey(model, position, 'next') ? 'next' : 'before';
+                entries.push(...getStepNameCompletions(context.stepNames, key));
+            }
+            else if (textBeforeCursor.endsWith('"$') ||
+                textBeforeCursor.endsWith('"')) {
+                entries.push(...getVariableCompletions(context.variables));
+                entries.push(...getDefinitionCompletions(context.definitions));
+                entries.push(...getSecretCompletions(context.secrets));
+                entries.push(...getContractCompletions(context.contractRaw, []));
+            }
+            // Mapping value path completions (data., globals., user., etc.)
+            if (entries.length === 0 && context.contractRaw) {
+                const fullText = model.getValue();
+                const offset = model.getOffsetAt(position);
+                const jsonPath = getJsonPathAtOffset(fullText, offset);
+                const mappingCtx = detectMappingContext(jsonPath);
+                if (mappingCtx) {
+                    const valueMatch = textBeforeCursor.match(/"([a-z_]*)\.?$/);
+                    if (valueMatch) {
+                        const prefix = valueMatch[1];
+                        const mappingEntries = getMappingPathCompletions(context.contractRaw, mappingCtx.entity, mappingCtx.action, prefix);
+                        if (mappingEntries.length > 0) {
+                            entries.push(...mappingEntries);
+                        }
+                    }
+                }
+            }
+            // Calculate range that covers the full $ref.name token.
+            // Monaco's getWordUntilPosition doesn't understand $ or . as word chars,
+            // so we scan backwards to find the $ that starts the reference.
+            const refStartMatch = textBeforeCursor.match(/\$(?:var|def|secret|env|code|contract)[.:]?[\w.]*$/);
+            const mappingPathMatch = !refStartMatch
+                ? textBeforeCursor.match(/[a-z_][\w.]*$/i)
+                : null;
+            const word = model.getWordUntilPosition(position);
+            const startCol = refStartMatch
+                ? position.column - refStartMatch[0].length
+                : mappingPathMatch
+                    ? position.column - mappingPathMatch[0].length
+                    : word.startColumn;
+            const range = {
+                startLineNumber: position.lineNumber,
+                endLineNumber: position.lineNumber,
+                startColumn: startCol,
+                endColumn: position.column,
+            };
+            return {
+                suggestions: entries.map((entry) => ({
+                    label: entry.label,
+                    insertText: entry.insertText,
+                    detail: entry.detail,
+                    documentation: entry.documentation,
+                    kind: mapCompletionKind(monaco, entry.kind),
+                    sortText: entry.sortText,
+                    range,
+                })),
+            };
+        },
+    }));
+    // HoverProvider
+    disposables.push(monaco.languages.registerHoverProvider('json', {
+        provideHover(model, position) {
+            const modelPath = model.uri.toString();
+            const context = contextRegistry.get(modelPath);
+            if (!context)
+                return null;
+            const lineContent = model.getLineContent(position.lineNumber);
+            const col = position.column - 1; // 0-based index into line
+            // Helper: find a reference match at cursor position
+            function matchAtCursor(pattern) {
+                const regex = new RegExp(pattern.source, 'g');
+                let m;
+                while ((m = regex.exec(lineContent)) !== null) {
+                    if (col >= m.index && col <= m.index + m[0].length)
+                        return m;
+                }
+                return null;
+            }
+            // $var.name
+            const varMatch = matchAtCursor(/\$var\.(\w+)/);
+            if (varMatch && context.variables) {
+                const name = varMatch[1];
+                if (name in context.variables) {
+                    const value = context.variables[name];
+                    return {
+                        range: {
+                            startLineNumber: position.lineNumber,
+                            startColumn: varMatch.index + 1,
+                            endLineNumber: position.lineNumber,
+                            endColumn: varMatch.index + varMatch[0].length + 1,
+                        },
+                        contents: [
+                            {
+                                value: `**Variable:** \`$var.${name}\`\n\n**Value:** \`${JSON.stringify(value)}\`\n\n*Resolved at runtime via variable interpolation*`,
+                            },
+                        ],
+                    };
+                }
+                return {
+                    contents: [
+                        {
+                            value: `**Unknown variable** \`$var.${name}\`\n\nDefined variables: ${Object.keys(context.variables).join(', ') || 'none'}`,
+                        },
+                    ],
+                };
+            }
+            // $def.name
+            const defMatch = matchAtCursor(/\$def\.(\w+)/);
+            if (defMatch && context.definitions) {
+                const name = defMatch[1];
+                if (name in context.definitions) {
+                    return {
+                        range: {
+                            startLineNumber: position.lineNumber,
+                            startColumn: defMatch.index + 1,
+                            endLineNumber: position.lineNumber,
+                            endColumn: defMatch.index + defMatch[0].length + 1,
+                        },
+                        contents: [
+                            {
+                                value: `**Definition:** \`$def.${name}\`\n\n*Injects reusable config fragment at runtime*`,
+                            },
+                        ],
+                    };
+                }
+                return {
+                    contents: [
+                        {
+                            value: `**Unknown definition** \`$def.${name}\`\n\nDefined: ${Object.keys(context.definitions).join(', ') || 'none'}`,
+                        },
+                    ],
+                };
+            }
+            // $secret.name
+            const secretMatch = matchAtCursor(/\$secret\.(\w+)/);
+            if (secretMatch) {
+                const name = secretMatch[1];
+                if (context.secrets?.includes(name)) {
+                    return {
+                        range: {
+                            startLineNumber: position.lineNumber,
+                            startColumn: secretMatch.index + 1,
+                            endLineNumber: position.lineNumber,
+                            endColumn: secretMatch.index + secretMatch[0].length + 1,
+                        },
+                        contents: [
+                            {
+                                value: `**Secret:** \`$secret.${name}\`\n\n*Securely injected at runtime. Value not stored in config.*`,
+                            },
+                        ],
+                    };
+                }
+                return {
+                    contents: [
+                        {
+                            value: `**Unknown secret** \`$secret.${name}\`\n\nAvailable secrets: ${context.secrets?.join(', ') || 'none'}`,
+                        },
+                    ],
+                };
+            }
+            // $contract.path
+            const contractMatch = matchAtCursor(/\$contract\.[\w.]+/);
+            if (contractMatch && context.contractRaw) {
+                const fullRef = contractMatch[0];
+                const pathStr = fullRef.replace('$contract.', '');
+                const segments = pathStr.split('.');
+                const contractName = segments[0];
+                const description = segments.length === 1
+                    ? `**Contract:** \`${fullRef}\`\n\nNamed contract entry "${contractName}".`
+                    : `**Contract reference:** \`${fullRef}\`\n\nResolves path \`${segments.slice(1).join('.')}\` in contract "${contractName}".`;
+                return {
+                    range: {
+                        startLineNumber: position.lineNumber,
+                        startColumn: contractMatch.index + 1,
+                        endLineNumber: position.lineNumber,
+                        endColumn: contractMatch.index + contractMatch[0].length + 1,
+                    },
+                    contents: [{ value: description }],
+                };
+            }
+            return null;
+        },
+    }));
+}
+/**
+ * Dispose all registered providers. Call on app teardown.
+ */
+export function disposeWalkerOSProviders() {
+    for (const d of disposables)
+        d.dispose();
+    disposables.length = 0;
+    registered = false;
+    contextRegistry.clear();
+}
+function mapCompletionKind(monaco, kind) {
+    switch (kind) {
+        case 'variable':
+            return monaco.languages.CompletionItemKind.Variable;
+        case 'reference':
+            return monaco.languages.CompletionItemKind.Reference;
+        case 'secret':
+            return monaco.languages.CompletionItemKind.Constant;
+        case 'module':
+            return monaco.languages.CompletionItemKind.Module;
+        case 'property':
+            return monaco.languages.CompletionItemKind.Property;
+        default:
+            return monaco.languages.CompletionItemKind.Text;
+    }
+}
+/**
+ * Check if cursor is inside the value of a specific JSON key.
+ */
+function isInsideKey(model, position, key) {
+    const lineContent = model.getLineContent(position.lineNumber);
+    const pattern = new RegExp(`"${key}"\\s*:\\s*"`);
+    return pattern.test(lineContent);
+}
+//# sourceMappingURL=monaco-walkeros-providers.js.map

package/dist/utils/monaco-walkeros-providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"monaco-walkeros-providers.js","sourceRoot":"","sources":["../../src/utils/monaco-walkeros-providers.ts"],"names":[],"mappings":"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"}

package/dist/utils/path-analyzer.d.ts

@@ -0,0 +1,88 @@
+import type { Mapping } from '@walkeros/core';
+/**
+ * Path Context Analyzer
+ *
+ * Provides structural understanding of mapping paths by walking the actual
+ * config and inspecting values at each level.
+ *
+ * This is the single source of truth for understanding what a path points to
+ * in the recursive mapping structure.
+ */
+/**
+ * Structural type of a path segment
+ */
+export type SegmentStructuralType = 'entity' | 'action' | 'ruleProperty' | 'valueConfigProperty' | 'mapKey' | 'arrayIndex';
+/**
+ * Semantic context of what's being edited
+ */
+export type SemanticContext = 'overview' | 'entity' | 'rule' | 'ruleProperty' | 'valueConfig' | 'valueConfigProperty' | 'mapValue' | 'primitive';
+/**
+ * Information about a single segment in the path
+ */
+export interface PathSegmentInfo {
+    segment: string;
+    index: number;
+    structuralType: SegmentStructuralType;
+    value: unknown;
+    parentValue: unknown;
+}
+/**
+ * Complete analysis of a path through the mapping structure
+ */
+export interface PathAnalysis {
+    segments: PathSegmentInfo[];
+    finalValue: unknown;
+    finalContext: SemanticContext;
+    isRuleLevel: boolean;
+    isValueConfigLevel: boolean;
+    propertyName?: string;
+}
+/**
+ * Type guard: Check if value is a Rule object
+ */
+export declare function isRule(value: unknown): boolean;
+/**
+ * Type guard: Check if value is a ValueConfig object
+ */
+export declare function isValueConfig(value: unknown): boolean;
+/**
+ * Type guard: Check if value is a Map object (plain object inside ValueConfig.map)
+ */
+export declare function isMapObject(value: unknown): boolean;
+/**
+ * Analyze a path through the mapping configuration
+ *
+ * Walks through the config structure, inspecting values at each step to
+ * determine the semantic type and context.
+ *
+ * @param path - Array of path segments (e.g., ['page', 'view', 'data', 'map', 'page_location', 'consent'])
+ * @param config - The mapping configuration object
+ * @returns Complete analysis of the path
+ *
+ * @example
+ * const analysis = analyzePath(['page', 'view', 'consent'], config);
+ * // analysis.isRuleLevel === true (consent at rule level)
+ *
+ * @example
+ * const analysis = analyzePath(['page', 'view', 'data', 'map', 'items', 'consent'], config);
+ * // analysis.isValueConfigLevel === true (consent at ValueConfig level)
+ */
+export declare function analyzePath(path: string[], config: Mapping.Config): PathAnalysis;
+/**
+ * Get semantic description for a path
+ *
+ * Returns human-readable description of what's being edited at this path.
+ *
+ * @example
+ * getPathDescription(['page', 'view', 'consent'], config)
+ * // Returns: "Rule-level consent for page view event"
+ *
+ * @example
+ * getPathDescription(['page', 'view', 'data', 'map', 'title', 'consent'], config)
+ * // Returns: "Property-level consent for title field"
+ */
+export declare function getPathDescription(path: string[], config: Mapping.Config): {
+    title: string;
+    description: string;
+};
+//# sourceMappingURL=path-analyzer.d.ts.map

package/dist/utils/path-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-analyzer.d.ts","sourceRoot":"","sources":["../../src/utils/path-analyzer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;;;;;;;GAQG;AAEH;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAC7B,QAAQ,GACR,QAAQ,GACR,cAAc,GACd,qBAAqB,GACrB,QAAQ,GACR,YAAY,CAAC;AAEjB;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB,UAAU,GACV,QAAQ,GACR,MAAM,GACN,cAAc,GACd,aAAa,GACb,qBAAqB,GACrB,UAAU,GACV,WAAW,CAAC;AAEhB;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,qBAAqB,CAAC;IACtC,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,eAAe,CAAC;IAC9B,WAAW,EAAE,OAAO,CAAC;IACrB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAoB9C;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAiBrD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAMnD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,EAAE,OAAO,CAAC,MAAM,GACrB,YAAY,CAqHd;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,EAAE,OAAO,CAAC,MAAM,GACrB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAuBxC"}

package/dist/utils/path-analyzer.js

@@ -0,0 +1,215 @@
+/**
+ * Type guard: Check if value is a Rule object
+ */
+export function isRule(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const obj = value;
+    // Rule has specific properties that ValueConfig doesn't have
+    const ruleOnlyProps = [
+        'name',
+        'batch',
+        'ignore',
+        'settings',
+        'batchFn',
+        'batched',
+    ];
+    const valueConfigOnlyProps = ['key', 'fn', 'loop', 'set', 'validate'];
+    const hasRuleProps = ruleOnlyProps.some((p) => p in obj);
+    const hasValueConfigProps = valueConfigOnlyProps.some((p) => p in obj);
+    // If it has rule-specific properties and no ValueConfig-only properties, it's a Rule
+    return hasRuleProps && !hasValueConfigProps;
+}
+/**
+ * Type guard: Check if value is a ValueConfig object
+ */
+export function isValueConfig(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const obj = value;
+    // ValueConfig markers - if ANY of these exist, it's a ValueConfig
+    const markers = [
+        'key',
+        'value',
+        'fn',
+        'map',
+        'loop',
+        'set',
+        'consent',
+        'condition',
+        'validate',
+    ];
+    return markers.some((m) => m in obj);
+}
+/**
+ * Type guard: Check if value is a Map object (plain object inside ValueConfig.map)
+ */
+export function isMapObject(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return false;
+    // A map is a plain object. We differentiate it from ValueConfig by checking
+    // if it has ValueConfig markers. If no markers, it's a map.
+    return !isValueConfig(value) && !isRule(value);
+}
+/**
+ * Analyze a path through the mapping configuration
+ *
+ * Walks through the config structure, inspecting values at each step to
+ * determine the semantic type and context.
+ *
+ * @param path - Array of path segments (e.g., ['page', 'view', 'data', 'map', 'page_location', 'consent'])
+ * @param config - The mapping configuration object
+ * @returns Complete analysis of the path
+ *
+ * @example
+ * const analysis = analyzePath(['page', 'view', 'consent'], config);
+ * // analysis.isRuleLevel === true (consent at rule level)
+ *
+ * @example
+ * const analysis = analyzePath(['page', 'view', 'data', 'map', 'items', 'consent'], config);
+ * // analysis.isValueConfigLevel === true (consent at ValueConfig level)
+ */
+export function analyzePath(path, config) {
+    const segments = [];
+    // Handle empty path (overview)
+    if (path.length === 0) {
+        return {
+            segments: [],
+            finalValue: config,
+            finalContext: 'overview',
+            isRuleLevel: false,
+            isValueConfigLevel: false,
+        };
+    }
+    let current = config;
+    let parent = null;
+    // Walk through each segment
+    for (let i = 0; i < path.length; i++) {
+        const segment = path[i];
+        parent = current;
+        // Validate we can navigate
+        if (!current || typeof current !== 'object') {
+            throw new Error(`Cannot navigate path at index ${i}: value is not an object`);
+        }
+        const obj = current;
+        current = obj[segment];
+        // Determine structural type based on context
+        let structuralType;
+        if (i === 0) {
+            // First segment is always entity
+            structuralType = 'entity';
+        }
+        else if (i === 1) {
+            // Second segment is always action (points to Rule)
+            structuralType = 'action';
+        }
+        else {
+            // For deeper levels, inspect parent to determine type
+            if (isRule(parent)) {
+                structuralType = 'ruleProperty';
+            }
+            else if (isValueConfig(parent)) {
+                structuralType = 'valueConfigProperty';
+            }
+            else if (Array.isArray(parent)) {
+                structuralType = 'arrayIndex';
+            }
+            else {
+                // Must be a map object
+                structuralType = 'mapKey';
+            }
+        }
+        segments.push({
+            segment,
+            index: i,
+            structuralType,
+            value: current,
+            parentValue: parent,
+        });
+    }
+    // Determine final context and metadata
+    const lastSegment = segments[segments.length - 1];
+    const finalValue = lastSegment.value;
+    const parentValue = lastSegment.parentValue;
+    let finalContext;
+    let isRuleLevel = false;
+    let isValueConfigLevel = false;
+    let propertyName;
+    if (path.length === 1) {
+        finalContext = 'entity';
+    }
+    else if (path.length === 2) {
+        finalContext = 'rule';
+    }
+    else {
+        // Deep path - determine based on structural type
+        switch (lastSegment.structuralType) {
+            case 'ruleProperty':
+                finalContext = 'ruleProperty';
+                isRuleLevel = true;
+                propertyName = lastSegment.segment;
+                break;
+            case 'valueConfigProperty':
+                finalContext = 'valueConfigProperty';
+                isValueConfigLevel = true;
+                propertyName = lastSegment.segment;
+                break;
+            case 'mapKey':
+                // A map key holds a Value (string or ValueConfig)
+                if (typeof finalValue === 'string') {
+                    finalContext = 'primitive';
+                }
+                else if (isValueConfig(finalValue)) {
+                    finalContext = 'valueConfig';
+                }
+                else {
+                    finalContext = 'mapValue';
+                }
+                break;
+            default:
+                finalContext = 'valueConfig';
+        }
+    }
+    return {
+        segments,
+        finalValue,
+        finalContext,
+        isRuleLevel,
+        isValueConfigLevel,
+        propertyName,
+    };
+}
+/**
+ * Get semantic description for a path
+ *
+ * Returns human-readable description of what's being edited at this path.
+ *
+ * @example
+ * getPathDescription(['page', 'view', 'consent'], config)
+ * // Returns: "Rule-level consent for page view event"
+ *
+ * @example
+ * getPathDescription(['page', 'view', 'data', 'map', 'title', 'consent'], config)
+ * // Returns: "Property-level consent for title field"
+ */
+export function getPathDescription(path, config) {
+    const analysis = analyzePath(path, config);
+    if (analysis.propertyName === 'consent') {
+        return {
+            title: 'Required Consent States',
+            description: 'Events or properties will only be processed if these consent states are granted',
+        };
+    }
+    if (analysis.propertyName === 'settings') {
+        return {
+            title: 'Settings',
+            description: 'Configure destination-specific settings for this rule',
+        };
+    }
+    // Default descriptions
+    return {
+        title: `Editing ${analysis.propertyName || 'Value'}`,
+        description: `Configure ${analysis.finalContext} at path: ${path.join(' → ')}`,
+    };
+}
+//# sourceMappingURL=path-analyzer.js.map

package/dist/utils/path-analyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-analyzer.js","sourceRoot":"","sources":["../../src/utils/path-analyzer.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@walkeros/explorer",
-  "version": "3.0.0",
+  "version": "3.0.2",
   "description": "Interactive React components for walkerOS documentation and exploration",
   "license": "MIT",
   "type": "module",
@@ -39,9 +39,9 @@
     "monaco-editor": "^0.55.1",
     "prettier": "^3.7.4",
     "roughjs": "^4.6.6",
-    "@walkeros/collector": "^3.0.0",
-    "@walkeros/core": "^3.0.0",
-    "@walkeros/web-source-browser": "^3.0.0",
+    "@walkeros/collector": "^3.0.2",
+    "@walkeros/core": "^3.0.2",
+    "@walkeros/web-source-browser": "^3.0.2",
     "tailwind-merge": "^3.4.0"
   },
   "peerDependencies": {
@@ -49,7 +49,7 @@
     "react-dom": ">=18.0.0"
   },
   "devDependencies": {
-    "@walkeros/config": "^3.0.0",
+    "@walkeros/config": "^3.0.2",
     "@storybook/addon-docs": "^10.1.11",
     "@storybook/react-vite": "^10.1.11",
     "@swc/core": "^1.11.13",
@@ -63,7 +63,7 @@
     "@typescript-eslint/eslint-plugin": "^8.28.0",
     "@typescript-eslint/parser": "^8.28.0",
     "@vitejs/plugin-react": "^5.1.2",
-    "@walkeros/web-destination-gtag": "^3.0.0",
+    "@walkeros/web-destination-gtag": "^3.0.2",
     "eslint": "^9.23.0",
     "eslint-plugin-jest": "^28.11.0",
     "eslint-plugin-storybook": "^10.1.11",