sgerp-frontend-lib 0.1.3 → 0.1.5

package/dist/markdown.d.ts

@@ -0,0 +1,33 @@
+export type Language = 'en' | 'ja' | 'ms';
+export interface DocMetadata {
+    title: string;
+    description?: string;
+    [key: string]: unknown;
+}
+export interface Heading {
+    id: string;
+    text: string;
+    level: number;
+}
+export interface DocContent {
+    metadata: DocMetadata;
+    content: string;
+    slug: string;
+    headings?: Heading[];
+}
+/**
+ * Extract headings from markdown content
+ */
+export declare function extractHeadings(content: string): Heading[];
+/**
+ * Get a documentation file by slug with locale support
+ * @param slug - The slug path (e.g., ['getting-started'])
+ * @param locale - The language locale (defaults to 'en')
+ * @returns The documentation content or null if not found
+ */
+export declare function getDocBySlug(slug: string[], locale?: Language): DocContent | null;
+/**
+ * Get all documentation slugs
+ */
+export declare function getAllDocSlugs(): string[][];
+//# sourceMappingURL=markdown.d.ts.map

package/dist/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../sgerplib/markdown.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,QAAQ,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAc1C,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,WAAW,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,EAAE,CA6B1D;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,MAAM,GAAE,QAAe,GAAG,UAAU,GAAG,IAAI,CAqCvF;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,EAAE,EAAE,CAwB3C"}

package/dist/markdown.js

@@ -0,0 +1,117 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractHeadings = extractHeadings;
+exports.getDocBySlug = getDocBySlug;
+exports.getAllDocSlugs = getAllDocSlugs;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const gray_matter_1 = __importDefault(require("gray-matter"));
+/**
+ * Get the content directory for a specific locale
+ * @param locale - The language locale (en, ja, ms)
+ * @returns The path to the content directory
+ */
+function getContentDirectory(locale = 'en') {
+    const suffix = locale === 'en' ? '' : `-${locale}`;
+    return path_1.default.join(process.cwd(), `content/docs${suffix}`);
+}
+const contentDirectory = path_1.default.join(process.cwd(), 'content/docs');
+/**
+ * Extract headings from markdown content
+ */
+function extractHeadings(content) {
+    const headings = [];
+    const lines = content.split('\n');
+    const idCounts = new Map();
+    for (const line of lines) {
+        // Match markdown headings (## Heading)
+        const match = line.match(/^(#{2,3})\s+(.+)$/);
+        if (match) {
+            const level = match[1].length;
+            const text = match[2].trim();
+            // Create a slug from the heading text
+            let id = text
+                .toLowerCase()
+                .replace(/[^a-z0-9\s-]/g, '')
+                .replace(/\s+/g, '-');
+            // Handle duplicate IDs
+            const count = idCounts.get(id) || 0;
+            if (count > 0) {
+                id = `${id}-${count}`;
+            }
+            idCounts.set(id.replace(/-\d+$/, ''), count + 1);
+            headings.push({ id, text, level });
+        }
+    }
+    return headings;
+}
+/**
+ * Get a documentation file by slug with locale support
+ * @param slug - The slug path (e.g., ['getting-started'])
+ * @param locale - The language locale (defaults to 'en')
+ * @returns The documentation content or null if not found
+ */
+function getDocBySlug(slug, locale = 'en') {
+    try {
+        const slugPath = slug.join('/');
+        const localeContentDir = getContentDirectory(locale);
+        let fullPath = path_1.default.join(localeContentDir, `${slugPath}.md`);
+        // If the direct path doesn't exist, try index.md inside the directory
+        if (!fs_1.default.existsSync(fullPath)) {
+            const indexPath = path_1.default.join(localeContentDir, slugPath, 'index.md');
+            if (fs_1.default.existsSync(indexPath)) {
+                fullPath = indexPath;
+            }
+            else {
+                // Fallback to English if locale file doesn't exist
+                if (locale !== 'en') {
+                    return getDocBySlug(slug, 'en');
+                }
+                return null;
+            }
+        }
+        const fileContents = fs_1.default.readFileSync(fullPath, 'utf8');
+        const { data, content } = (0, gray_matter_1.default)(fileContents);
+        return {
+            metadata: data,
+            content,
+            slug: slugPath,
+            headings: extractHeadings(content),
+        };
+    }
+    catch (error) {
+        console.error('Error reading doc:', error);
+        // Fallback to English on error if not already English
+        if (locale !== 'en') {
+            return getDocBySlug(slug, 'en');
+        }
+        return null;
+    }
+}
+/**
+ * Get all documentation slugs
+ */
+function getAllDocSlugs() {
+    const slugs = [];
+    function traverseDirectory(dir, currentPath = []) {
+        const files = fs_1.default.readdirSync(dir);
+        files.forEach((file) => {
+            const filePath = path_1.default.join(dir, file);
+            const stat = fs_1.default.statSync(filePath);
+            if (stat.isDirectory()) {
+                traverseDirectory(filePath, [...currentPath, file]);
+            }
+            else if (file.endsWith('.md')) {
+                const slug = [...currentPath, file.replace(/\.md$/, '')];
+                slugs.push(slug);
+            }
+        });
+    }
+    if (fs_1.default.existsSync(contentDirectory)) {
+        traverseDirectory(contentDirectory);
+    }
+    return slugs;
+}

package/dist/sgerp/collection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"collection.d.ts","sourceRoot":"","sources":["../../sgerplib/sgerp/collection.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"collection.d.ts","sourceRoot":"","sources":["../../sgerplib/sgerp/collection.ts"],"names":[],"mappings":"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"}

package/dist/sgerp/collection.js

@@ -212,9 +212,13 @@ class Collection {
             // Update or add to models array
             const existingIndex = newModels.findIndex(m => m.id === model.id);
             if (existingIndex >= 0) {
-                // Always update existing items (backend may not update modified_at)
-                newModels[existingIndex] = model;
-                this._index.set(model.id, model);
+                // Merge with existing model to preserve client-side attributes
+                // Spread existing first, then new data, so server data takes precedence
+                // But client-side-only attributes (like visible_position) are preserved if not in new data
+                const existingModel = newModels[existingIndex];
+                const mergedModel = Object.assign(Object.assign({}, existingModel), model);
+                newModels[existingIndex] = mergedModel;
+                this._index.set(model.id, mergedModel);
                 hasChanges = true;
             }
             else {
@@ -225,8 +229,18 @@ class Collection {
         });
         // Only update and notify if something actually changed
         if (hasChanges) {
+            // Safety check: deduplicate by ID (should not happen, but prevents React key errors)
+            const seen = new Set();
+            const deduplicated = newModels.filter(model => {
+                if (seen.has(model.id)) {
+                    console.warn(`[Collection] Duplicate model with ID ${model.id} detected and removed`);
+                    return false;
+                }
+                seen.add(model.id);
+                return true;
+            });
             // Create new array reference for React to detect changes
-            this._models = newModels;
+            this._models = deduplicated;
             this._notifyChange();
         }
     }

package/dist/sgerp/domains.d.ts

@@ -37,11 +37,25 @@ export declare const DEFAULT_SERVERS: {
     url: string;
 }[];
 /**
- * Environment type
+ * Backend environment type (for OSRM routing)
  */
-export type Environment = 'staging' | 'production' | 'tcp' | 'ppe';
+export type BackendEnvironment = 'development' | 'staging' | 'production' | 'tc' | 'tcp' | 'ppe';
 /**
  * OSRM backend type
  */
 export type OSRMBackend = keyof typeof SGERP_DOMAINS.osrm;
+/**
+ * Backend environment detection rules
+ * Maps URL patterns to backend environment types
+ */
+export declare const BACKEND_DETECTION_RULES: Array<{
+    patterns: string[];
+    backend: OSRMBackend;
+}>;
+/**
+ * Detect backend environment from base URL
+ * @param baseUrl - The SGERP API base URL
+ * @returns The detected backend environment or 'development' as default
+ */
+export declare function detectBackendFromUrl(baseUrl: string): OSRMBackend;
 //# sourceMappingURL=domains.d.ts.map

package/dist/sgerp/domains.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"domains.d.ts","sourceRoot":"","sources":["../../sgerplib/sgerp/domains.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,eAAO,MAAM,aAAa;;;;;;;;;;;;CAehB,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,eAAe;;;GAK8B,CAAC;AAE3D;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,YAAY,GAAG,KAAK,GAAG,KAAK,CAAC;AAEnE;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,aAAa,CAAC,IAAI,CAAC"}
+{"version":3,"file":"domains.d.ts","sourceRoot":"","sources":["../../sgerplib/sgerp/domains.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,eAAO,MAAM,aAAa;;;;;;;;;;;;CAehB,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,eAAe;;;GAK8B,CAAC;AAE3D;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,aAAa,GAAG,SAAS,GAAG,YAAY,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,CAAC;AAEjG;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,aAAa,CAAC,IAAI,CAAC;AAE1D;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAE,KAAK,CAAC;IAC1C,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,WAAW,CAAC;CACtB,CA0BA,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAUjE"}

package/dist/sgerp/domains.js

@@ -16,7 +16,8 @@
  * - NEXT_PUBLIC_OSRM_DOMAIN_PPE
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_SERVERS = exports.SGERP_DOMAINS = void 0;
+exports.BACKEND_DETECTION_RULES = exports.DEFAULT_SERVERS = exports.SGERP_DOMAINS = void 0;
+exports.detectBackendFromUrl = detectBackendFromUrl;
 exports.SGERP_DOMAINS = {
     // SGERP API Domains
     staging: process.env.NEXT_PUBLIC_SGERP_DOMAIN_STAGING || '',
@@ -43,3 +44,48 @@ exports.DEFAULT_SERVERS = [
     { labelKey: "env.tcp", url: exports.SGERP_DOMAINS.tcp },
     { labelKey: "env.ppe", url: exports.SGERP_DOMAINS.ppe },
 ].filter(server => server.url && server.url.trim() !== '');
+/**
+ * Backend environment detection rules
+ * Maps URL patterns to backend environment types
+ */
+exports.BACKEND_DETECTION_RULES = [
+    {
+        patterns: ['gcdev', 'gcstage', 'staging', 'stage', 'dev'],
+        backend: 'development',
+    },
+    {
+        patterns: ['gcprod', 'prod'],
+        backend: 'production',
+    },
+    {
+        patterns: [
+            process.env.NEXT_PUBLIC_BACKEND_TC_PATTERN || 'tc.example',
+        ],
+        backend: 'tc',
+    },
+    {
+        patterns: [
+            process.env.NEXT_PUBLIC_BACKEND_TCP_PATTERN || 'tcp.example',
+            process.env.NEXT_PUBLIC_BACKEND_TCP_PATTERN_2 || 'tms-planning.example',
+        ],
+        backend: 'tcp',
+    },
+    {
+        patterns: ['ppe'],
+        backend: 'ppe',
+    },
+];
+/**
+ * Detect backend environment from base URL
+ * @param baseUrl - The SGERP API base URL
+ * @returns The detected backend environment or 'development' as default
+ */
+function detectBackendFromUrl(baseUrl) {
+    const lowerUrl = baseUrl.toLowerCase();
+    for (const rule of exports.BACKEND_DETECTION_RULES) {
+        if (rule.patterns.some(pattern => lowerUrl.includes(pattern))) {
+            return rule.backend;
+        }
+    }
+    return 'development'; // Default fallback
+}

package/dist/sgerp/hooks/use-selection-state.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Hook for managing selection state (vehicles, bookings, etc.)
+ * Provides consistent selection management across simulation pages
+ */
+export interface SelectionState<T extends number | string> {
+    selected: Set<T>;
+    count: number;
+    isSelected: (id: T) => boolean;
+    toggle: (id: T) => void;
+    selectAll: (ids: T[]) => void;
+    clearAll: () => void;
+    setSelection: (ids: T[]) => void;
+}
+/**
+ * Hook for managing selection state with Set-based storage
+ * Useful for checkbox selections, multi-select, etc.
+ *
+ * @param initialIds - Initial selected IDs
+ * @returns Selection state and methods
+ */
+export declare function useSelectionState<T extends number | string>(initialIds?: T[]): SelectionState<T>;
+/**
+ * Hook for tracking recently changed items (for visual feedback)
+ * Automatically clears highlights after a timeout
+ *
+ * @param timeoutMs - How long to highlight changes (default: 3000ms)
+ */
+export declare function useRecentChanges<T extends number | string>(timeoutMs?: number): {
+    recentlyChanged: Set<T>;
+    isRecentlyChanged: (id: T) => boolean;
+    detectChanges: (items: Array<{
+        id?: T;
+        uid?: T;
+        [key: string]: any;
+    }>, stateKey: string) => void;
+};
+//# sourceMappingURL=use-selection-state.d.ts.map

package/dist/sgerp/hooks/use-selection-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-selection-state.d.ts","sourceRoot":"","sources":["../../../sgerplib/sgerp/hooks/use-selection-state.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IACvD,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,OAAO,CAAC;IAC/B,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,IAAI,CAAC;IACxB,SAAS,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,IAAI,CAAC;IAC9B,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,YAAY,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,IAAI,CAAC;CAClC;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EACzD,UAAU,GAAE,CAAC,EAAO,GACnB,cAAc,CAAC,CAAC,CAAC,CAsDnB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EACxD,SAAS,GAAE,MAAa;;4BA8CjB,CAAC,KAAG,OAAO;2BAvCR,KAAK,CAAC;QAAE,EAAE,CAAC,EAAE,CAAC,CAAC;QAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE,CAAC,YAAY,MAAM;EA2D3E"}

package/dist/sgerp/hooks/use-selection-state.js

@@ -0,0 +1,121 @@
+"use strict";
+/**
+ * Hook for managing selection state (vehicles, bookings, etc.)
+ * Provides consistent selection management across simulation pages
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useSelectionState = useSelectionState;
+exports.useRecentChanges = useRecentChanges;
+const react_1 = require("react");
+/**
+ * Hook for managing selection state with Set-based storage
+ * Useful for checkbox selections, multi-select, etc.
+ *
+ * @param initialIds - Initial selected IDs
+ * @returns Selection state and methods
+ */
+function useSelectionState(initialIds = []) {
+    const selectedRef = (0, react_1.useRef)(new Set(initialIds));
+    const [count, setCount] = (0, react_1.useState)(initialIds.length);
+    const [refreshCounter, setRefreshCounter] = (0, react_1.useState)(0);
+    // Keep ref in sync with initial value changes
+    (0, react_1.useEffect)(() => {
+        if (initialIds.length > 0 && selectedRef.current.size === 0) {
+            selectedRef.current = new Set(initialIds);
+            setCount(initialIds.length);
+        }
+    }, [initialIds]);
+    const isSelected = (0, react_1.useCallback)((id) => {
+        return selectedRef.current.has(id);
+    }, [refreshCounter]); // Refresh when counter changes
+    const toggle = (0, react_1.useCallback)((id) => {
+        if (selectedRef.current.has(id)) {
+            selectedRef.current.delete(id);
+        }
+        else {
+            selectedRef.current.add(id);
+        }
+        setCount(selectedRef.current.size);
+        setRefreshCounter((c) => c + 1);
+    }, []);
+    const selectAll = (0, react_1.useCallback)((ids) => {
+        selectedRef.current = new Set(ids);
+        setCount(ids.length);
+        setRefreshCounter((c) => c + 1);
+    }, []);
+    const clearAll = (0, react_1.useCallback)(() => {
+        selectedRef.current.clear();
+        setCount(0);
+        setRefreshCounter((c) => c + 1);
+    }, []);
+    const setSelection = (0, react_1.useCallback)((ids) => {
+        selectedRef.current = new Set(ids);
+        setCount(ids.length);
+        setRefreshCounter((c) => c + 1);
+    }, []);
+    return {
+        selected: selectedRef.current,
+        count,
+        isSelected,
+        toggle,
+        selectAll,
+        clearAll,
+        setSelection,
+    };
+}
+/**
+ * Hook for tracking recently changed items (for visual feedback)
+ * Automatically clears highlights after a timeout
+ *
+ * @param timeoutMs - How long to highlight changes (default: 3000ms)
+ */
+function useRecentChanges(timeoutMs = 3000) {
+    const [recentlyChanged, setRecentlyChanged] = (0, react_1.useState)(new Set());
+    const previousStatesRef = (0, react_1.useRef)(new Map());
+    const timeoutRef = (0, react_1.useRef)(null);
+    const detectChanges = (0, react_1.useCallback)((items, stateKey) => {
+        const changedIds = new Set();
+        items.forEach((item) => {
+            const id = (item.id || item.uid);
+            if (!id)
+                return;
+            const previousState = previousStatesRef.current.get(id);
+            const currentState = item[stateKey];
+            // If we have a previous state and it's different from current, mark as changed
+            if (previousState !== undefined && previousState !== currentState) {
+                changedIds.add(id);
+            }
+            // Update the previous state map
+            previousStatesRef.current.set(id, currentState);
+        });
+        // If we detected changes, highlight them
+        if (changedIds.size > 0) {
+            setRecentlyChanged(changedIds);
+            // Clear existing timeout
+            if (timeoutRef.current) {
+                clearTimeout(timeoutRef.current);
+            }
+            // Set new timeout to clear highlights
+            timeoutRef.current = setTimeout(() => {
+                setRecentlyChanged(new Set());
+                timeoutRef.current = null;
+            }, timeoutMs);
+        }
+    }, [timeoutMs]);
+    const isRecentlyChanged = (0, react_1.useCallback)((id) => {
+        return recentlyChanged.has(id);
+    }, [recentlyChanged]);
+    // Cleanup timeout on unmount
+    (0, react_1.useEffect)(() => {
+        return () => {
+            if (timeoutRef.current) {
+                clearTimeout(timeoutRef.current);
+            }
+        };
+    }, []);
+    return {
+        recentlyChanged,
+        isRecentlyChanged,
+        detectChanges,
+    };
+}

package/dist/sgerp/hooks/use-simulation-data.d.ts

@@ -0,0 +1,105 @@
+import type { SGERPClient } from '../client';
+import type { Simulation } from '../types/simulation/simulation';
+import type { Booking } from '../types/simulation/booking';
+import type { Vehicle } from '../types/simulation/vehicle';
+import type { Driver } from '../types/simulation/driver';
+import type { Geofence } from '../types/simulation/geofence';
+import type { Node } from '../types/simulation/node';
+import { type RouteNode } from '../utils/routeUtils';
+export interface SimulationDataState {
+    vehicles: Vehicle[];
+    bookings: Booking[];
+    nodes: Node[];
+    drivers: Driver[];
+    geofences: Geofence[];
+    mainGeofence: Geofence | null;
+    vehicleRoutes: Map<number, {
+        waypoints: any[];
+        polyline?: any;
+    }>;
+    vehicleData: Map<number, {
+        assigned_nodes: RouteNode[];
+        completed_nodes: RouteNode[];
+        assigned_booking_uids: Set<string>;
+        completed_booking_uids: Set<string>;
+    }>;
+    loading: boolean;
+    error: Error | null;
+}
+export interface UseSimulationDataOptions {
+    /**
+     * Enable automatic data fetching on mount
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * Enable live updates for vehicles, bookings, and nodes
+     * @default false
+     */
+    enableLiveUpdates?: boolean;
+    /**
+     * Live update interval in milliseconds
+     * @default 5000
+     */
+    liveUpdateInterval?: number;
+    /**
+     * Callback when data is successfully loaded
+     */
+    onSuccess?: (data: Omit<SimulationDataState, 'loading' | 'error'>) => void;
+    /**
+     * Callback when data loading fails
+     */
+    onError?: (error: Error) => void;
+    /**
+     * Callback when live update occurs
+     */
+    onLiveUpdate?: () => void;
+}
+/**
+ * React hook for fetching and managing simulation data
+ * Encapsulates the full data loading pipeline: fetch, attach references, generate routes
+ *
+ * @param api - SGERP client instance
+ * @param simulationId - Simulation ID to fetch data for
+ * @param simulation - Optional simulation object (for fetching main geofence)
+ * @param options - Hook options
+ * @returns Simulation data state and control functions
+ *
+ * @example
+ * ```tsx
+ * function SimulationPage({ simulationId }) {
+ *   const api = useSGERP();
+ *   const simulation = useCollection(api?.collections.simulation ?? null)
+ *     ?.find(s => s.id === simulationId);
+ *
+ *   // Basic usage - fetches data once
+ *   const {
+ *     vehicles,
+ *     bookings,
+ *     nodes,
+ *     vehicleRoutes,
+ *     vehicleData,
+ *     loading,
+ *     error,
+ *     refetch
+ *   } = useSimulationData(api, simulationId, simulation);
+ *
+ *   // With live updates - automatically refreshes every 5 seconds
+ *   const data = useSimulationData(api, simulationId, simulation, {
+ *     enableLiveUpdates: true,
+ *     liveUpdateInterval: 5000,
+ *     onLiveUpdate: () => console.log('Data updated!')
+ *   });
+ *
+ *   if (loading) return <Spinner />;
+ *   if (error) return <Error message={error.message} />;
+ *
+ *   // All data is already processed - routes generated, references attached
+ *   return <SimulationView vehicles={vehicles} bookings={bookings} routes={vehicleRoutes} />;
+ * }
+ * ```
+ */
+export declare function useSimulationData(api: SGERPClient | null, simulationId: number | string | null, simulation?: Simulation | null, options?: UseSimulationDataOptions): SimulationDataState & {
+    refetch: () => Promise<void>;
+};
+//# sourceMappingURL=use-simulation-data.d.ts.map

package/dist/sgerp/hooks/use-simulation-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-simulation-data.d.ts","sourceRoot":"","sources":["../../../sgerplib/sgerp/hooks/use-simulation-data.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAGrD,OAAO,EAAgC,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGnF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,YAAY,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC9B,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,GAAG,EAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,GAAG,CAAA;KAAE,CAAC,CAAC;IACjE,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE;QACvB,cAAc,EAAE,SAAS,EAAE,CAAC;QAC5B,eAAe,EAAE,SAAS,EAAE,CAAC;QAC7B,qBAAqB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;QACnC,sBAAsB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;KACrC,CAAC,CAAC;IACH,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,mBAAmB,EAAE,SAAS,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC;IAE3E;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAEjC;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,WAAW,GAAG,IAAI,EACvB,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,EACpC,UAAU,GAAE,UAAU,GAAG,IAAW,EACpC,OAAO,GAAE,wBAA6B,GACrC,mBAAmB,GAAG;IAAE,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CA2JxD"}