@walkeros/explorer 0.3.1 → 1.0.0

package/dist/hooks/useMappingNavigation.js

@@ -0,0 +1,339 @@
+import { useState, useCallback } from 'react';
+import { buildBreadcrumbSegments, getParentPath, getValueAtPath, } from '../utils/mapping-path';
+import { detectNodeType } from '../utils/type-detector';
+/**
+ * Navigation state for tab-based mapping editor
+ *
+ * Manages:
+ * - Open tabs with their paths and types
+ * - Active tab selection
+ * - Breadcrumb generation
+ * - Tree sidebar visibility
+ * - Tab opening/closing logic
+ *
+ * This hook is UI-agnostic - it only manages navigation state,
+ * not how tabs are rendered.
+ *
+ * @example
+ * const navigation = useMappingNavigation({
+ *   config: myConfig,
+ *   structure: MY_STRUCTURE,
+ *   schemas: mySchemas,
+ * });
+ *
+ * // Open a new tab
+ * navigation.openTab(['product', 'view', 'data'], 'valueConfig');
+ *
+ * // Switch tabs
+ * navigation.switchToTab(tabId);
+ *
+ * // Close current level
+ * navigation.closeLevel(); // Closes current tab and goes to parent
+ */
+const MAX_HISTORY_LENGTH = 50;
+export function useMappingNavigation(params) {
+    const { config, structure, schemas } = params;
+    const [openTabs, setOpenTabs] = useState([]);
+    const [activeTabId, setActiveTabId] = useState('');
+    const [treeVisible, setTreeVisible] = useState(true);
+    const [navigationHistory, setNavigationHistory] = useState([]);
+    /**
+     * Generate unique tab ID from path
+     */
+    const generateTabId = useCallback((path) => {
+        return path.join('.');
+    }, []);
+    /**
+     * Generate human-readable label from path
+     */
+    const generateLabel = useCallback((path, nodeType) => {
+        if (path.length === 0)
+            return 'Overview';
+        // For rules, use "entity action" format
+        if (path.length === 2 && nodeType === 'rule') {
+            return `${path[0]} ${path[1]}`;
+        }
+        // For nested properties, use last segment capitalized
+        const lastSegment = path[path.length - 1];
+        return lastSegment.charAt(0).toUpperCase() + lastSegment.slice(1);
+    }, []);
+    /**
+     * Find tab by ID
+     */
+    const findTab = useCallback((tabId) => {
+        return openTabs.find((tab) => tab.id === tabId);
+    }, [openTabs]);
+    /**
+     * Check if tab exists
+     */
+    const hasTab = useCallback((path) => {
+        const tabId = generateTabId(path);
+        return openTabs.some((tab) => tab.id === tabId);
+    }, [openTabs, generateTabId]);
+    /**
+     * Open new tab or switch to existing one
+     */
+    const openTab = useCallback((path, nodeType) => {
+        const tabId = generateTabId(path);
+        // Check if tab exists and add/update if needed
+        setOpenTabs((prev) => {
+            const existingTab = prev.find((t) => t.id === tabId);
+            if (existingTab) {
+                // Update nodeType if it differs (allows refining type detection)
+                if (existingTab.nodeType !== nodeType) {
+                    return prev.map((t) => (t.id === tabId ? { ...t, nodeType } : t));
+                }
+                return prev; // No change needed
+            }
+            // Create and add new tab
+            const newTab = {
+                id: tabId,
+                path,
+                nodeType,
+                label: generateLabel(path, nodeType),
+            };
+            return [...prev, newTab];
+        });
+        // Add to navigation history (only if switching to different tab)
+        setNavigationHistory((prev) => {
+            // Don't add if it's the same as current active tab
+            if (prev.length > 0 && prev[prev.length - 1] === tabId) {
+                return prev;
+            }
+            // Add and limit to MAX_HISTORY_LENGTH
+            const newHistory = [...prev, tabId];
+            if (newHistory.length > MAX_HISTORY_LENGTH) {
+                return newHistory.slice(-MAX_HISTORY_LENGTH);
+            }
+            return newHistory;
+        });
+        // Always set as active (separate state update)
+        setActiveTabId(tabId);
+    }, [generateTabId, generateLabel]);
+    /**
+     * Switch to existing tab
+     */
+    const switchToTab = useCallback((tabId) => {
+        // Add to navigation history when switching tabs
+        setNavigationHistory((prev) => {
+            // Don't add if it's the same as current active tab
+            if (prev.length > 0 && prev[prev.length - 1] === tabId) {
+                return prev;
+            }
+            // Add and limit to MAX_HISTORY_LENGTH
+            const newHistory = [...prev, tabId];
+            if (newHistory.length > MAX_HISTORY_LENGTH) {
+                return newHistory.slice(-MAX_HISTORY_LENGTH);
+            }
+            return newHistory;
+        });
+        setActiveTabId(tabId);
+    }, []);
+    /**
+     * Close specific tab
+     */
+    const closeTab = useCallback((tabId) => {
+        // Determine new active ID based on what's left after closing
+        let newActiveId = '';
+        setOpenTabs((prev) => {
+            const newTabs = prev.filter((tab) => tab.id !== tabId);
+            // Check if the tab being closed exists and is the last one (likely active)
+            const closingTab = prev.find((tab) => tab.id === tabId);
+            const isLastTab = closingTab && prev[prev.length - 1]?.id === tabId;
+            // If closing what's likely the active tab, switch to last remaining
+            if (isLastTab || tabId === activeTabId) {
+                if (newTabs.length > 0) {
+                    newActiveId = newTabs[newTabs.length - 1].id;
+                }
+                else {
+                    newActiveId = '';
+                }
+            }
+            else {
+                // Not closing active tab, keep current active
+                newActiveId = activeTabId;
+            }
+            return newTabs;
+        });
+        // Update active tab
+        setActiveTabId(newActiveId);
+    }, [activeTabId]);
+    /**
+     * Close current tab and return to parent
+     *
+     * If parent tab already exists, switches to it.
+     * Otherwise just closes current tab.
+     */
+    const closeLevel = useCallback(() => {
+        if (!activeTabId)
+            return;
+        const currentActiveId = activeTabId;
+        // Determine what to do with active tab ID
+        let newActiveId = '';
+        setOpenTabs((prevTabs) => {
+            const activeTab = prevTabs.find((t) => t.id === currentActiveId);
+            if (!activeTab) {
+                newActiveId = currentActiveId; // Keep current
+                return prevTabs;
+            }
+            const parentPath = getParentPath(activeTab.path);
+            const parentId = generateTabId(parentPath);
+            // Check if parent tab exists
+            const parentTab = prevTabs.find((t) => t.id === parentId);
+            // Filter out current tab
+            const newTabs = prevTabs.filter((t) => t.id !== currentActiveId);
+            // Determine new active ID
+            if (parentTab && parentPath.length >= 2) {
+                newActiveId = parentId;
+            }
+            else if (newTabs.length > 0) {
+                newActiveId = newTabs[newTabs.length - 1].id;
+            }
+            else {
+                newActiveId = '';
+            }
+            return newTabs;
+        });
+        // Update active tab (separate state update)
+        setActiveTabId(newActiveId);
+    }, [activeTabId, generateTabId]);
+    /**
+     * Close all tabs
+     */
+    const closeAllTabs = useCallback(() => {
+        setOpenTabs([]);
+        setActiveTabId('');
+    }, []);
+    /**
+     * Get breadcrumb for active tab
+     */
+    const getBreadcrumb = useCallback(() => {
+        const activeTab = findTab(activeTabId);
+        if (!activeTab) {
+            return [{ label: 'Overview', path: [] }];
+        }
+        return buildBreadcrumbSegments(activeTab.path);
+    }, [activeTabId, findTab]);
+    /**
+     * Navigate to breadcrumb segment
+     */
+    const navigateToBreadcrumb = useCallback((segmentPath) => {
+        if (segmentPath.length === 0) {
+            closeAllTabs();
+            return;
+        }
+        const value = getValueAtPath(config, segmentPath);
+        const nodeType = detectNodeType(value, segmentPath, structure, schemas);
+        openTab(segmentPath, nodeType);
+    }, [openTab, closeAllTabs, config, structure, schemas]);
+    /**
+     * Go back to previous tab in navigation history
+     *
+     * Validates that the previous tab still exists before navigating.
+     * If deleted, keeps going back until a valid tab is found.
+     * If no valid history, does nothing (button will be disabled).
+     */
+    const goBack = useCallback(() => {
+        setNavigationHistory((prevHistory) => {
+            if (prevHistory.length <= 1) {
+                // No history to go back to
+                return prevHistory;
+            }
+            // Remove current tab from history (last item)
+            let workingHistory = prevHistory.slice(0, -1);
+            let foundValidTab = false;
+            // Keep popping until we find a valid tab or run out of history
+            while (workingHistory.length > 0 && !foundValidTab) {
+                const previousTabId = workingHistory[workingHistory.length - 1];
+                // Special case: empty tab ID means Overview
+                if (previousTabId === '') {
+                    setActiveTabId(''); // This will trigger Overview pane to show
+                    foundValidTab = true;
+                    return workingHistory;
+                }
+                const previousTab = openTabs.find((t) => t.id === previousTabId);
+                if (previousTab) {
+                    // Found valid tab - switch to it
+                    setActiveTabId(previousTabId);
+                    foundValidTab = true;
+                    return workingHistory;
+                }
+                else {
+                    // Tab was deleted, remove from history and try again
+                    workingHistory = workingHistory.slice(0, -1);
+                }
+            }
+            // No valid tabs found in history - clear history
+            return [];
+        });
+    }, [openTabs]);
+    /**
+     * Check if back navigation is available
+     */
+    const canGoBack = useCallback(() => {
+        if (navigationHistory.length <= 1)
+            return false;
+        // Check if there's at least one valid tab in history (excluding current)
+        const historyWithoutCurrent = navigationHistory.slice(0, -1);
+        return historyWithoutCurrent.some((tabId) => 
+        // Empty tab ID (Overview) is always valid, or tab exists in openTabs
+        tabId === '' || openTabs.some((tab) => tab.id === tabId));
+    }, [navigationHistory, openTabs]);
+    /**
+     * Toggle tree visibility
+     */
+    const toggleTree = useCallback(() => {
+        setTreeVisible((prev) => !prev);
+    }, []);
+    /**
+     * Navigate to a path using dot notation
+     *
+     * Enables deep linking by parsing a string path and opening all intermediate tabs.
+     *
+     * @param dotPath - Path in dot notation (e.g., "page.view.data.map.items.consent")
+     *
+     * @example
+     * navigation.navigateToPath('page.view.consent');
+     * // Opens: page entity → view rule → consent property
+     *
+     * @example
+     * navigation.navigateToPath('product.add.data.map.items.key');
+     * // Opens all intermediate tabs leading to the key property
+     */
+    const navigateToPath = useCallback((dotPath) => {
+        const pathArray = dotPath.split('.').filter((s) => s.trim());
+        if (pathArray.length < 2) {
+            return;
+        }
+        for (let i = 1; i <= pathArray.length; i++) {
+            const subPath = pathArray.slice(0, i);
+            const value = getValueAtPath(config, subPath);
+            const nodeType = detectNodeType(value, subPath, structure, schemas);
+            openTab(subPath, nodeType);
+        }
+    }, [openTab, config, structure, schemas]);
+    return {
+        // State
+        openTabs,
+        activeTabId,
+        treeVisible,
+        breadcrumb: getBreadcrumb(),
+        navigationHistory,
+        // Actions
+        openTab,
+        switchToTab,
+        closeTab,
+        closeLevel,
+        closeAllTabs,
+        navigateToBreadcrumb,
+        navigateToPath,
+        toggleTree,
+        setTreeVisible,
+        goBack,
+        // Queries
+        findTab,
+        hasTab,
+        canGoBack,
+    };
+}
+//# sourceMappingURL=useMappingNavigation.js.map

package/dist/hooks/useMappingNavigation.js.map

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

package/dist/hooks/useMappingState.d.ts

@@ -0,0 +1,56 @@
+import type { Mapping } from '@walkeros/core';
+/**
+ * Centralized mapping configuration state management
+ *
+ * This hook provides a single source of truth for the entire mapping config.
+ * All CRUD operations go through this hook, making state management predictable
+ * and testable.
+ *
+ * Features:
+ * - Path-based value access and mutation
+ * - Rule CRUD operations
+ * - Immutable updates (no direct mutations)
+ * - Change callback for external synchronization
+ *
+ * @example
+ * const mappingState = useMappingState(initialMapping);
+ *
+ * // Read
+ * const rule = mappingState.getValueAtPath(['product', 'view']);
+ *
+ * // Update
+ * mappingState.setValueAtPath(['product', 'view', 'name'], 'view_item');
+ *
+ * // Delete
+ * mappingState.deleteRule('product', 'view');
+ */
+export declare function useMappingState(initialMapping: Mapping.Config, onChange?: (config: Mapping.Config) => void): {
+    config: Mapping.Config<unknown>;
+    actions: {
+        getValue: (path: string[]) => unknown;
+        setValue: (path: string[], value: unknown) => void;
+        deleteValue: (path: string[]) => void;
+        getRuleList: () => string[];
+        getRule: (entity: string, action: string) => unknown;
+        createRule: (entity: string, action: string, initialConfig?: unknown) => void;
+        deleteRule: (entity: string, action: string) => void;
+        replaceConfig: (newConfig: Mapping.Config) => void;
+    };
+};
+/**
+ * Return type of useMappingState hook
+ *
+ * Provides centralized mapping state management with:
+ * - config: Current mapping configuration
+ * - actions: CRUD operations for mapping state
+ *
+ * @example
+ * const mappingState: UseMappingStateReturn = useMappingState(initialConfig);
+ */
+export type UseMappingStateReturn = ReturnType<typeof useMappingState>;
+/**
+ * @deprecated Use UseMappingStateReturn instead
+ * This alias is kept for backward compatibility and will be removed in the next major version.
+ */
+export type MappingState = UseMappingStateReturn;
+//# sourceMappingURL=useMappingState.d.ts.map

package/dist/hooks/useMappingState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMappingState.d.ts","sourceRoot":"","sources":["../../src/hooks/useMappingState.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAS9C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,eAAe,CAC7B,cAAc,EAAE,OAAO,CAAC,MAAM,EAC9B,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,KAAK,IAAI;;;yBA4BlC,MAAM,EAAE;yBAUR,MAAM,EAAE,SAAS,OAAO;4BAWxB,MAAM,EAAE;2BAUmB,MAAM,EAAE;0BAsBjC,MAAM,UAAU,MAAM;6BAUtB,MAAM,UAAU,MAAM,kBAAkB,OAAO;6BAmC/C,MAAM,UAAU,MAAM;mCAqBnB,OAAO,CAAC,MAAM;;EAmB7B;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,qBAAqB,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;AAEvE;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,qBAAqB,CAAC"}

package/dist/hooks/useMappingState.js

@@ -0,0 +1,142 @@
+import { useState, useCallback, useRef } from 'react';
+import { getValueAtPath, setValueAtPath, deleteAtPath, buildRulePath, } from '../utils/mapping-path';
+/**
+ * Centralized mapping configuration state management
+ *
+ * This hook provides a single source of truth for the entire mapping config.
+ * All CRUD operations go through this hook, making state management predictable
+ * and testable.
+ *
+ * Features:
+ * - Path-based value access and mutation
+ * - Rule CRUD operations
+ * - Immutable updates (no direct mutations)
+ * - Change callback for external synchronization
+ *
+ * @example
+ * const mappingState = useMappingState(initialMapping);
+ *
+ * // Read
+ * const rule = mappingState.getValueAtPath(['product', 'view']);
+ *
+ * // Update
+ * mappingState.setValueAtPath(['product', 'view', 'name'], 'view_item');
+ *
+ * // Delete
+ * mappingState.deleteRule('product', 'view');
+ */
+export function useMappingState(initialMapping, onChange) {
+    const [config, setConfig] = useState(initialMapping);
+    // Track if onChange callback is currently being fired to prevent loops
+    const isCallingOnChange = useRef(false);
+    /**
+     * Internal state updater that also triggers onChange callback
+     */
+    const updateConfig = useCallback((newConfig) => {
+        setConfig(newConfig);
+        // Call onChange if provided and not already in callback
+        if (onChange && !isCallingOnChange.current) {
+            isCallingOnChange.current = true;
+            onChange(newConfig);
+            isCallingOnChange.current = false;
+        }
+    }, [onChange]);
+    /**
+     * Get value at path
+     */
+    const getValue = useCallback((path) => {
+        return getValueAtPath(config, path);
+    }, [config]);
+    /**
+     * Set value at path (immutable update)
+     */
+    const setValue = useCallback((path, value) => {
+        const newConfig = setValueAtPath(config, path, value);
+        updateConfig(newConfig);
+    }, [config, updateConfig]);
+    /**
+     * Delete value at path (immutable delete)
+     */
+    const deleteValue = useCallback((path) => {
+        const newConfig = deleteAtPath(config, path);
+        updateConfig(newConfig);
+    }, [config, updateConfig]);
+    /**
+     * Get list of all rules in format "entity action"
+     */
+    const getRuleList = useCallback(() => {
+        const rules = [];
+        const configRecord = config;
+        Object.keys(config).forEach((entity) => {
+            const actions = configRecord[entity];
+            if (actions && typeof actions === 'object') {
+                Object.keys(actions).forEach((action) => {
+                    rules.push(buildRulePath(entity, action));
+                });
+            }
+        });
+        return rules.sort();
+    }, [config]);
+    /**
+     * Get rule configuration
+     */
+    const getRule = useCallback((entity, action) => {
+        return getValue([entity, action]);
+    }, [getValue]);
+    /**
+     * Create new rule with default configuration
+     */
+    const createRule = useCallback((entity, action, initialConfig) => {
+        const path = [entity, action];
+        // Check if rule already exists
+        if (getValue(path)) {
+            return;
+        }
+        // Default config: just the name field
+        const defaultConfig = initialConfig || {
+            name: `${entity}_${action}`,
+        };
+        // Create entity object if it doesn't exist
+        let newConfig = config;
+        const configRecord = newConfig;
+        if (!configRecord[entity]) {
+            newConfig = { ...newConfig, [entity]: {} };
+        }
+        // Add the rule
+        newConfig = setValueAtPath(newConfig, path, defaultConfig);
+        updateConfig(newConfig);
+    }, [config, getValue, updateConfig]);
+    /**
+     * Delete rule
+     */
+    const deleteRule = useCallback((entity, action) => {
+        let newConfig = deleteAtPath(config, [entity, action]);
+        // Remove entity if no actions left
+        const configRecord = newConfig;
+        const entityActions = configRecord[entity];
+        if (entityActions && Object.keys(entityActions).length === 0) {
+            newConfig = deleteAtPath(newConfig, [entity]);
+        }
+        updateConfig(newConfig);
+    }, [config, updateConfig]);
+    /**
+     * Update entire config (for external changes)
+     */
+    const replaceConfig = useCallback((newConfig) => {
+        updateConfig(newConfig);
+    }, [updateConfig]);
+    return {
+        config,
+        actions: {
+            getValue,
+            setValue,
+            deleteValue,
+            getRuleList,
+            getRule,
+            createRule,
+            deleteRule,
+            replaceConfig,
+        },
+    };
+}
+//# sourceMappingURL=useMappingState.js.map

package/dist/hooks/useMappingState.js.map

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

package/dist/hooks/useMonacoHeight.d.ts

@@ -0,0 +1,31 @@
+import type { editor } from 'monaco-editor';
+export interface UseMonacoHeightOptions {
+    enabled?: boolean;
+    minHeight?: number;
+    maxHeight?: number;
+    defaultHeight?: number;
+    onHeightChange?: (height: number) => void;
+}
+/**
+ * Hook to automatically calculate Monaco Editor height based on content
+ *
+ * @param enabled - Whether to enable auto-height calculation
+ * @param minHeight - Minimum height in pixels (default: 100)
+ * @param maxHeight - Maximum height in pixels (default: 800)
+ * @param defaultHeight - Default height when not auto-sizing (default: 400)
+ *
+ * @returns [height, setEditor] - Current height and function to register editor instance
+ *
+ * @example
+ * const [height, setEditor] = useMonacoHeight({ enabled: autoHeight });
+ *
+ * <Editor
+ *   height={height}
+ *   onMount={(editor) => setEditor(editor)}
+ * />
+ */
+export declare function useMonacoHeight({ enabled, minHeight, maxHeight, defaultHeight, onHeightChange, }?: UseMonacoHeightOptions): [
+    number,
+    (editor: editor.IStandaloneCodeEditor | null) => void
+];
+//# sourceMappingURL=useMonacoHeight.d.ts.map

package/dist/hooks/useMonacoHeight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMonacoHeight.d.ts","sourceRoot":"","sources":["../../src/hooks/useMonacoHeight.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE5C,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3C;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAAC,EAC9B,OAAe,EACf,SAAe,EACf,SAAe,EACf,aAAmB,EACnB,cAAc,GACf,GAAE,sBAA2B,GAAG;IAC/B,MAAM;IACN,CAAC,MAAM,EAAE,MAAM,CAAC,qBAAqB,GAAG,IAAI,KAAK,IAAI;CACtD,CAoFA"}