@robosystems/core 0.3.0

package/hooks/use-user.js

@@ -0,0 +1,39 @@
+'use client';
+import { useMemo } from 'react';
+import { useAuth } from '../auth-components';
+export function useUser() {
+    const { user: authUser, isLoading, isAuthenticated, refreshUser } = useAuth();
+    // Transform AuthUser to User format with graceful defaults for malformed data
+    const user = useMemo(() => {
+        if (!authUser)
+            return null;
+        // If authUser is not an object, return null
+        if (typeof authUser !== 'object' || authUser === null) {
+            if (process.env.NODE_ENV === 'development' &&
+                typeof jest === 'undefined') {
+                console.warn('AuthUser is not a valid object:', authUser);
+            }
+            return null;
+        }
+        // Gracefully handle malformed user data by providing safe defaults
+        const safeId = typeof authUser.id === 'string' ? authUser.id : '';
+        const safeEmail = typeof authUser.email === 'string' ? authUser.email : '';
+        const safeName = typeof authUser.name === 'string' ? authUser.name : '';
+        // Log warnings for malformed data in development (but not in tests)
+        if (process.env.NODE_ENV === 'development' && typeof jest === 'undefined') {
+            if (typeof authUser.id !== 'string' || !authUser.id) {
+                console.warn('AuthUser has invalid id field:', authUser.id);
+            }
+            if (typeof authUser.email !== 'string' || !authUser.email) {
+                console.warn('AuthUser has invalid email field:', authUser.email);
+            }
+        }
+        return {
+            id: safeId,
+            name: safeName,
+            email: safeEmail,
+            emailVerified: authUser.emailVerified,
+        };
+    }, [authUser]);
+    return { user, isLoading, isAuthenticated, refreshUser };
+}

package/index.d.ts

@@ -0,0 +1,29 @@
+export * as AuthCore from './auth-core';
+export { clearToken, getAuthHeader, getToken, getValidToken, handleAuthResponse, hasValidToken, storeToken, } from './auth-core/token-storage';
+export { clearUserCookies, clearUserLocalStorage, clearUserSessionStorage, listUserData, performLogoutCleanup, resetUIState, } from './auth-core/cleanup';
+export { AppSwitcher, AuthGuard, AuthProvider, SignInForm, SignUpForm, useAuth, } from './auth-components';
+export { useApiError, useMediaQuery, useToast, useUser, useUserLimits, type ToastMessage, } from './hooks';
+export { createGraphContext, createGraphProvider, createUseGraphContext, EntityProvider, GraphContext, GraphProvider, OrgProvider, ServiceOfferingsProvider, SidebarProvider, useEntity, useGraphContext, useOrg, useServiceOfferings, useSidebarContext, type EntityContextValue, type EntityProviderProps, type GraphContextValue, type GraphProviderProps, type GraphState, type OrgContextState, type OrgContextValue, type OrgProviderProps, type ServiceOfferings, } from './contexts';
+export { clientGraphCookie, clientSidebarCookie, entityCookie, graphCookie, sidebarCookie, type EntityCookie, type GraphCookie, type SidebarCookie, } from './lib';
+export { generateEntityUri, isUUID, UUID_REGEX } from './utils';
+export { clearGraphSelection, getGraphSelection, persistGraphSelection, } from './actions/graph-actions';
+export { clearEntitySelection, getEntitySelection, persistEntitySelection, } from './actions/entity-actions';
+export type { Entities, Entity, User } from './types';
+export { customTheme } from './theme';
+export { buildGraphAwareConsoleConfig, ConsoleContent, EXAMPLE_SETS, getGraphExampleKind, useGraphAwareConsoleConfig, } from './components/console';
+export type { ConsoleBranding, ConsoleCommandContext, ConsoleConfig, ConsoleExtraCommand, ConsoleHeaderConfig, ConsoleMcpConfig, ConsoleWelcomeConfig, GraphExampleKind, GraphExampleSet, SampleQuery, } from './components/console';
+export { ActiveSubscriptions, BrowseRepositories, EntitySelector, EntitySelectorCore, GraphSelectorCore, PageLayout, RepositoryGuard, SearchContent, useIsRepository, type ActiveSubscriptionsProps, type BrowseRepositoriesProps, type EntityGroup, type EntityLike, type EntityRecord, type EntitySelectorProps, type GraphSelectorProps, type GraphWithEntities, type SearchConfig, type SearchFilterConfig, type SelectableEntity, } from './components';
+export { composeFilters, excludeRepositories, excludeSubgraphs, GraphFilters, hasSchemaExtension, onlyRepositories, onlyUserGraphs, } from './components/graph-filters';
+export { ApiKeyDisplay, ApiKeysCard, ApiKeyTable, BrandSpinner, categorizeError, ChatHeader, ChatInputArea, ChatMessage, ConfirmModal, CoreNavbar, CoreSidebar, CreateApiKeyModal, DeepResearchToggle, EmptyState, ErrorType, GeneralInformationCard, generateMessageId, getErrorMessage, LandingFooter, LoadingState, PageContainer, PageHeader, PasswordInformationCard, PasswordRequirements, SecureApiKeyField, SettingsCard, SettingsContainer, SettingsFormField, SettingsPageHeader, Spinner, StatCard, StatusAlert, SupportModal, ThemeToggle, } from './ui-components';
+export type { AgentType, FooterLink, LandingFooterProps, Message, PageHeaderProps, SidebarItemData, SupportMetadata, } from './ui-components';
+export * from './library';
+export * as SDK from '@robosystems/client';
+export { clients, EventType, executeQuery, monitorOperation, OperationClient, QueryClient, QueuedQueryError, RoboSystemsClients, SSEClient, streamQuery, useMultipleOperations, useOperation, useQuery, useSDKClients, useStreamingQuery, type OperationMonitorOptions, type OperationProgress, type OperationResult, type QueryOptions, type QueryRequest, type QueryResult, type QueuedQueryResponse, type RoboSystemsClientConfig, type SSEConfig, type SSEEvent, } from '@robosystems/client/clients';
+export { cancelTask, getActiveTasks, pollTaskStatus, taskMonitor, } from './task-monitoring/taskMonitor';
+export { getProgressFromStep, useEntityCreationTask, useTaskMonitoring, type UseTaskMonitoringResult, } from './task-monitoring/hooks';
+export type { TaskCreateResponse, TaskMonitorState, TaskPollingOptions, TaskStatus, TaskStatusResponse, } from './task-monitoring';
+export { useGraphCreation, useOperationMonitoring, useRepositorySubscription, type OperationMonitorState, type UseOperationMonitoringResult, } from './task-monitoring/operationHooks';
+import { client } from '@robosystems/client';
+export { client };
+export type { APIKey, AppName, AuthContextType, AuthUser } from './auth-core';
+export { CURRENT_APP } from './auth-core/config';

package/index.js

@@ -0,0 +1,77 @@
+// Root package that re-exports all sub-packages
+// Export auth-core with namespace to avoid conflicts
+export * as AuthCore from './auth-core';
+// Export token storage utilities for JWT authentication
+export { clearToken, getAuthHeader, getToken, getValidToken, handleAuthResponse, hasValidToken, storeToken, } from './auth-core/token-storage';
+// Export auth cleanup utilities
+export { clearUserCookies, clearUserLocalStorage, clearUserSessionStorage, listUserData, performLogoutCleanup, resetUIState, } from './auth-core/cleanup';
+// Export auth-components
+export { AppSwitcher, AuthGuard, AuthProvider, SignInForm, SignUpForm, useAuth, } from './auth-components';
+// Export hooks
+export { useApiError, useMediaQuery, useToast, useUser, useUserLimits, } from './hooks';
+// Export contexts
+export { 
+// Graph context exports
+createGraphContext, createGraphProvider, createUseGraphContext, 
+// Entity context exports
+EntityProvider, GraphContext, GraphProvider, 
+// Org context exports
+OrgProvider, 
+// Service offerings context
+ServiceOfferingsProvider, SidebarProvider, useEntity, useGraphContext, useOrg, useServiceOfferings, useSidebarContext, } from './contexts';
+// Export lib utilities
+export { clientGraphCookie, clientSidebarCookie, entityCookie, graphCookie, sidebarCookie, } from './lib';
+// Export utils
+export { generateEntityUri, isUUID, UUID_REGEX } from './utils';
+// Export server actions
+export { clearGraphSelection, getGraphSelection, persistGraphSelection, } from './actions/graph-actions';
+export { clearEntitySelection, getEntitySelection, persistEntitySelection, } from './actions/entity-actions';
+// Export theme
+export { customTheme } from './theme';
+// Export components
+// Export console components
+export { buildGraphAwareConsoleConfig, ConsoleContent, EXAMPLE_SETS, getGraphExampleKind, useGraphAwareConsoleConfig, } from './components/console';
+export { ActiveSubscriptions, BrowseRepositories, EntitySelector, EntitySelectorCore, GraphSelectorCore, PageLayout, RepositoryGuard, SearchContent, useIsRepository, } from './components';
+// Export graph filters
+export { composeFilters, excludeRepositories, excludeSubgraphs, GraphFilters, hasSchemaExtension, onlyRepositories, onlyUserGraphs, } from './components/graph-filters';
+// Export app-components
+export { ApiKeyDisplay, ApiKeysCard, ApiKeyTable, BrandSpinner, categorizeError, ChatHeader, ChatInputArea, 
+// Chat components
+ChatMessage, ConfirmModal, CoreNavbar, CoreSidebar, CreateApiKeyModal, DeepResearchToggle, EmptyState, ErrorType, GeneralInformationCard, generateMessageId, getErrorMessage, LandingFooter, LoadingState, PageContainer, PageHeader, PasswordInformationCard, PasswordRequirements, SecureApiKeyField, SettingsCard, SettingsContainer, SettingsFormField, SettingsPageHeader, Spinner, StatCard, StatusAlert, SupportModal, ThemeToggle, } from './ui-components';
+// Export library components, types, and helpers
+export * from './library';
+// Export SDK with namespace to avoid conflicts
+export * as SDK from '@robosystems/client';
+// Export SDK Clients (available with @robosystems/client v0.3.2+)
+export { clients, EventType, executeQuery, monitorOperation, OperationClient, QueryClient, QueuedQueryError, RoboSystemsClients, SSEClient, streamQuery, useMultipleOperations, useOperation, useQuery, useSDKClients, useStreamingQuery, } from '@robosystems/client/clients';
+// Export task monitoring utilities
+export { cancelTask, getActiveTasks, pollTaskStatus, taskMonitor, } from './task-monitoring/taskMonitor';
+export { getProgressFromStep, useEntityCreationTask, useTaskMonitoring, } from './task-monitoring/hooks';
+// Export operation monitoring hooks
+export { useGraphCreation, useOperationMonitoring, useRepositorySubscription, } from './task-monitoring/operationHooks';
+// Configure and export client directly for convenience (since it's commonly used)
+import { client } from '@robosystems/client';
+import { getAuthHeader } from './auth-core/token-storage';
+// Configure the SDK client with default settings
+// Skip configuration in test environment to prevent connection attempts
+if (process.env.NODE_ENV !== 'test') {
+    client.setConfig({
+        baseUrl: process.env.NEXT_PUBLIC_ROBOSYSTEMS_API_URL || 'http://localhost:8000',
+        // No longer using credentials: 'include' for cookies
+        // Using Bearer token authentication instead
+        headers: {
+            'Content-Type': 'application/json',
+        },
+    });
+    // Add Bearer token to all requests if authenticated
+    client.interceptors.request.use(async (request) => {
+        const authHeader = getAuthHeader();
+        if (authHeader) {
+            request.headers.set('Authorization', authHeader);
+        }
+        return request;
+    });
+}
+export { client };
+// App identity
+export { CURRENT_APP } from './auth-core/config';

package/lib/entity-cookie.d.ts

@@ -0,0 +1,10 @@
+export interface EntityCookie {
+    identifier: string;
+    name: string;
+    graphId: string;
+}
+export declare const entityCookie: {
+    get(): Promise<EntityCookie | null>;
+    set(value: EntityCookie): Promise<void>;
+    delete(): Promise<void>;
+};

package/lib/entity-cookie.js

@@ -0,0 +1,38 @@
+const ENTITY_COOKIE_NAME = 'selected-entity';
+// Server-side cookie utilities for Next.js 15
+export const entityCookie = {
+    async get() {
+        // Only import cookies when actually needed (server-side)
+        const { cookies } = await import('next/headers');
+        const cookieStore = await cookies();
+        const cookie = cookieStore.get(ENTITY_COOKIE_NAME);
+        if (!(cookie === null || cookie === void 0 ? void 0 : cookie.value)) {
+            return null;
+        }
+        try {
+            return JSON.parse(decodeURIComponent(cookie.value));
+        }
+        catch (_a) {
+            return null;
+        }
+    },
+    async set(value) {
+        // Only import cookies when actually needed (server-side)
+        const { cookies } = await import('next/headers');
+        const cookieStore = await cookies();
+        const cookieValue = JSON.stringify(value);
+        cookieStore.set(ENTITY_COOKIE_NAME, encodeURIComponent(cookieValue), {
+            maxAge: 30 * 24 * 60 * 60, // 30 days
+            secure: process.env.NODE_ENV === 'production',
+            httpOnly: true,
+            sameSite: 'lax',
+            path: '/',
+        });
+    },
+    async delete() {
+        // Only import cookies when actually needed (server-side)
+        const { cookies } = await import('next/headers');
+        const cookieStore = await cookies();
+        cookieStore.delete(ENTITY_COOKIE_NAME);
+    },
+};

package/lib/graph-cookie.d.ts

@@ -0,0 +1,11 @@
+export interface GraphCookie {
+    graphId: string;
+}
+export declare const graphCookie: {
+    get(): Promise<GraphCookie | null>;
+    set(value: GraphCookie): Promise<void>;
+    delete(): Promise<void>;
+};
+export declare const clientGraphCookie: {
+    get(): GraphCookie | null;
+};

package/lib/graph-cookie.js

@@ -0,0 +1,62 @@
+const GRAPH_COOKIE_NAME = 'selected-graph';
+// Server-side cookie utilities for Next.js 15
+export const graphCookie = {
+    async get() {
+        // Only import cookies when actually needed (server-side)
+        const { cookies } = await import('next/headers');
+        const cookieStore = await cookies();
+        const cookie = cookieStore.get(GRAPH_COOKIE_NAME);
+        if (!(cookie === null || cookie === void 0 ? void 0 : cookie.value)) {
+            return null;
+        }
+        try {
+            return JSON.parse(decodeURIComponent(cookie.value));
+        }
+        catch (_a) {
+            return null;
+        }
+    },
+    async set(value) {
+        // Only import cookies when actually needed (server-side)
+        const { cookies } = await import('next/headers');
+        const cookieStore = await cookies();
+        const cookieValue = JSON.stringify(value);
+        cookieStore.set(GRAPH_COOKIE_NAME, encodeURIComponent(cookieValue), {
+            maxAge: 30 * 24 * 60 * 60, // 30 days
+            secure: process.env.NODE_ENV === 'production',
+            httpOnly: true,
+            sameSite: 'lax',
+            path: '/',
+        });
+    },
+    async delete() {
+        // Only import cookies when actually needed (server-side)
+        const { cookies } = await import('next/headers');
+        const cookieStore = await cookies();
+        cookieStore.delete(GRAPH_COOKIE_NAME);
+    },
+};
+// Client-side utilities (if needed)
+export const clientGraphCookie = {
+    get() {
+        if (typeof document === 'undefined') {
+            return null;
+        }
+        const cookie = document.cookie
+            .split('; ')
+            .find((row) => row.startsWith(`${GRAPH_COOKIE_NAME}=`));
+        if (!cookie) {
+            return null;
+        }
+        const cookieValue = cookie.split('=')[1];
+        if (!cookieValue) {
+            return null;
+        }
+        try {
+            return JSON.parse(decodeURIComponent(cookieValue));
+        }
+        catch (_a) {
+            return null;
+        }
+    },
+};

package/lib/graph-tiers.d.ts

@@ -0,0 +1,41 @@
+import { type AvailableGraphTiersResponse, type GraphCapacityResponse, type GraphTierInfo, type GraphTierInstance, type GraphTierLimits, type TierCapacity } from '@robosystems/client';
+/**
+ * Graph tier service for fetching tier configurations using the RoboSystems SDK
+ */
+export type { GraphTierInstance, GraphTierLimits, TierCapacity };
+export type GraphTier = GraphTierInfo;
+export type GraphTiersResponse = AvailableGraphTiersResponse;
+/**
+ * Fetch available graph tiers from the API using the RoboSystems client
+ * Note: Uses the pre-configured client from core which includes auth interceptors
+ */
+export declare function fetchGraphTiers(includeDisabled?: boolean): Promise<GraphTiersResponse>;
+/**
+ * Map tier to color for UI display based on price
+ * Uses a heuristic: lowest price = info, middle = warning, highest = success
+ */
+export declare function getTierColor(tier: GraphTier, allTiers: GraphTier[]): 'info' | 'warning' | 'success';
+/**
+ * Get the popular/recommended tier (usually the middle tier)
+ * Returns the tier with median price or the middle index
+ */
+export declare function getPopularTier(tiers: GraphTier[]): string | null;
+/**
+ * Check if a tier supports subgraphs
+ */
+export declare function supportsSubgraphs(tier: GraphTier): boolean;
+/**
+ * Format tier for display in dropdown or selection
+ */
+export declare function formatTierForDisplay(tier: GraphTier): string;
+/**
+ * Fetch graph capacity from the API using the RoboSystems client
+ */
+export declare function fetchGraphCapacity(): Promise<GraphCapacityResponse>;
+/**
+ * Get badge display properties for a capacity status
+ */
+export declare function getCapacityBadge(status: string): {
+    label: string;
+    color: 'success' | 'warning' | 'failure';
+};

package/lib/graph-tiers.js

@@ -0,0 +1,107 @@
+import { getAvailableGraphTiers, getGraphCapacity, } from '@robosystems/client';
+// Import the pre-configured client from core (already set up with auth interceptors)
+import { client } from '../index';
+/**
+ * Fetch available graph tiers from the API using the RoboSystems client
+ * Note: Uses the pre-configured client from core which includes auth interceptors
+ */
+export async function fetchGraphTiers(includeDisabled = false) {
+    const response = await getAvailableGraphTiers({
+        client,
+        query: {
+            include_disabled: includeDisabled,
+        },
+    });
+    if (response.error) {
+        const errorMsg = response.error &&
+            typeof response.error === 'object' &&
+            'message' in response.error
+            ? String(response.error.message)
+            : 'Unknown error';
+        throw new Error(`Failed to fetch graph tiers: ${errorMsg}`);
+    }
+    return response.data;
+}
+/**
+ * Map tier to color for UI display based on price
+ * Uses a heuristic: lowest price = info, middle = warning, highest = success
+ */
+export function getTierColor(tier, allTiers) {
+    // Sort tiers by price (null/undefined treated as 0)
+    const sortedByPrice = [...allTiers].sort((a, b) => {
+        var _a, _b;
+        const priceA = (_a = a.monthly_price) !== null && _a !== void 0 ? _a : 0;
+        const priceB = (_b = b.monthly_price) !== null && _b !== void 0 ? _b : 0;
+        return priceA - priceB;
+    });
+    const tierIndex = sortedByPrice.findIndex((t) => t.tier === tier.tier);
+    const totalTiers = sortedByPrice.length;
+    // Assign colors based on position in sorted list
+    if (tierIndex === 0)
+        return 'info'; // Lowest price
+    if (tierIndex === totalTiers - 1)
+        return 'success'; // Highest price
+    return 'warning'; // Middle tier(s)
+}
+/**
+ * Get the popular/recommended tier (usually the middle tier)
+ * Returns the tier with median price or the middle index
+ */
+export function getPopularTier(tiers) {
+    if (tiers.length === 0)
+        return null;
+    if (tiers.length === 1)
+        return tiers[0].tier;
+    // Sort by price and return the middle one
+    const sortedByPrice = [...tiers].sort((a, b) => {
+        var _a, _b;
+        const priceA = (_a = a.monthly_price) !== null && _a !== void 0 ? _a : 0;
+        const priceB = (_b = b.monthly_price) !== null && _b !== void 0 ? _b : 0;
+        return priceA - priceB;
+    });
+    const middleIndex = Math.floor(sortedByPrice.length / 2);
+    return sortedByPrice[middleIndex].tier;
+}
+/**
+ * Check if a tier supports subgraphs
+ */
+export function supportsSubgraphs(tier) {
+    return tier.max_subgraphs !== null && tier.max_subgraphs > 0;
+}
+/**
+ * Format tier for display in dropdown or selection
+ */
+export function formatTierForDisplay(tier) {
+    const price = tier.monthly_price ? `$${tier.monthly_price}/mo` : '';
+    return `${tier.display_name} ${price}`.trim();
+}
+/**
+ * Fetch graph capacity from the API using the RoboSystems client
+ */
+export async function fetchGraphCapacity() {
+    const response = await getGraphCapacity({ client });
+    if (response.error) {
+        const errorMsg = response.error &&
+            typeof response.error === 'object' &&
+            'message' in response.error
+            ? String(response.error.message)
+            : 'Unknown error';
+        throw new Error(`Failed to fetch graph capacity: ${errorMsg}`);
+    }
+    return response.data;
+}
+/**
+ * Get badge display properties for a capacity status
+ */
+export function getCapacityBadge(status) {
+    switch (status) {
+        case 'ready':
+            return { label: 'Available', color: 'success' };
+        case 'scalable':
+            return { label: 'Available — 3-5 min setup', color: 'warning' };
+        case 'at_capacity':
+            return { label: 'At Capacity', color: 'failure' };
+        default:
+            return { label: 'Available', color: 'success' };
+    }
+}

package/lib/index.d.ts

@@ -0,0 +1,3 @@
+export { clientSidebarCookie, sidebarCookie, type SidebarCookie, } from './sidebar-cookie';
+export { clientGraphCookie, graphCookie, type GraphCookie, } from './graph-cookie';
+export { entityCookie, type EntityCookie } from './entity-cookie';

package/lib/index.js

@@ -0,0 +1,3 @@
+export { clientSidebarCookie, sidebarCookie, } from './sidebar-cookie';
+export { clientGraphCookie, graphCookie, } from './graph-cookie';
+export { entityCookie } from './entity-cookie';

package/lib/sidebar-cookie.d.ts

@@ -0,0 +1,11 @@
+export interface SidebarCookie {
+    isCollapsed: boolean;
+}
+export declare const sidebarCookie: {
+    get(): Promise<SidebarCookie>;
+    set(value: SidebarCookie): Promise<void>;
+};
+export declare const clientSidebarCookie: {
+    get(): SidebarCookie;
+    set(value: SidebarCookie): void;
+};

package/lib/sidebar-cookie.js

@@ -0,0 +1,42 @@
+const NAME = 'sidebar-collapsed';
+// Server-side cookie utilities (for Server Components)
+export const sidebarCookie = {
+    async get() {
+        // Only import cookies when actually needed (server-side)
+        const { cookies } = await import('next/headers');
+        const cookie = (await cookies()).get(NAME);
+        const isCollapsed = (cookie === null || cookie === void 0 ? void 0 : cookie.value) === 'true';
+        return { isCollapsed };
+    },
+    async set(value) {
+        // Only import cookies when actually needed (server-side)
+        const { cookies } = await import('next/headers');
+        (await cookies()).set(NAME, String(value.isCollapsed), {
+            path: '/',
+            maxAge: 60 * 60 * 24 * 365, // 1 year
+            sameSite: 'lax',
+            secure: process.env.NODE_ENV === 'production',
+        });
+    },
+};
+// Client-side cookie utilities (for Client Components)
+export const clientSidebarCookie = {
+    get() {
+        if (typeof document === 'undefined') {
+            return { isCollapsed: false };
+        }
+        const cookie = document.cookie
+            .split('; ')
+            .find((row) => row.startsWith(`${NAME}=`));
+        const isCollapsed = (cookie === null || cookie === void 0 ? void 0 : cookie.split('=')[1]) === 'true';
+        return { isCollapsed };
+    },
+    set(value) {
+        if (typeof document === 'undefined')
+            return;
+        // Set cookie with consistent options
+        const maxAge = 60 * 60 * 24 * 365; // 1 year in seconds
+        const secure = window.location.protocol === 'https:' ? '; secure' : '';
+        document.cookie = `${NAME}=${String(value.isCollapsed)}; path=/; max-age=${maxAge}; samesite=lax${secure}`;
+    },
+};

package/library/colors.d.ts

@@ -0,0 +1,4 @@
+type BadgeColor = 'success' | 'failure' | 'warning' | 'info' | 'purple' | 'indigo' | 'pink' | 'gray';
+export declare function classificationColor(cls: string): BadgeColor;
+export declare function arcTypeColor(assocType: string): BadgeColor;
+export {};

package/library/colors.js

@@ -0,0 +1,41 @@
+export function classificationColor(cls) {
+    switch (cls) {
+        case 'asset':
+        case 'contraAsset':
+            return 'success';
+        case 'liability':
+        case 'contraLiability':
+            return 'failure';
+        case 'equity':
+        case 'contraEquity':
+        case 'temporaryEquity':
+            return 'purple';
+        case 'revenue':
+        case 'expenseReversal':
+        case 'gain':
+            return 'info';
+        case 'expense':
+        case 'loss':
+            return 'warning';
+        case 'comprehensiveIncome':
+        case 'investmentByOwners':
+        case 'distributionToOwners':
+            return 'indigo';
+        case 'metric':
+            return 'pink';
+        default:
+            return 'gray';
+    }
+}
+export function arcTypeColor(assocType) {
+    switch (assocType) {
+        case 'equivalence':
+            return 'info';
+        case 'general-special':
+            return 'purple';
+        case 'essence-alias':
+            return 'indigo';
+        default:
+            return 'gray';
+    }
+}

package/library/components/ClassificationPicker.d.ts

@@ -0,0 +1,8 @@
+export declare function ClassificationPicker({ selected, onSelect, activity, onActivityChange, disabled, }: {
+    selected: string | null;
+    onSelect: (value: string | null) => void;
+    /** Cash-flow activity axis (orthogonal to SFAC 6 EFS). Optional — omit to hide. */
+    activity?: string | null;
+    onActivityChange?: (value: string | null) => void;
+    disabled?: boolean;
+}): import("react").JSX.Element;

package/library/components/ClassificationPicker.js

@@ -0,0 +1,55 @@
+'use client';
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+export function ClassificationPicker({ selected, onSelect, activity, onActivityChange, disabled, }) {
+    const balanceSheetClasses = [
+        { value: 'asset', label: 'Asset' },
+        { value: 'contraAsset', label: 'Contra Asset' },
+        { value: 'liability', label: 'Liability' },
+        { value: 'contraLiability', label: 'Contra Liability' },
+        { value: 'equity', label: 'Equity' },
+        { value: 'contraEquity', label: 'Contra Equity' },
+        { value: 'temporaryEquity', label: 'Temp. Equity' },
+    ];
+    const incomeStatementClasses = [
+        { value: 'revenue', label: 'Revenue' },
+        { value: 'expense', label: 'Expense' },
+        { value: 'expenseReversal', label: 'Exp. Reversal' },
+        { value: 'gain', label: 'Gain' },
+        { value: 'loss', label: 'Loss' },
+        { value: 'comprehensiveIncome', label: 'OCI' },
+        { value: 'investmentByOwners', label: 'Investment' },
+        { value: 'distributionToOwners', label: 'Distribution' },
+    ];
+    const activityClasses = [
+        {
+            value: 'operatingActivity',
+            label: 'Operating',
+            title: 'Cash flows from operating activities',
+        },
+        {
+            value: 'investingActivity',
+            label: 'Investing',
+            title: 'Cash flows from investing activities',
+        },
+        {
+            value: 'financingActivity',
+            label: 'Financing',
+            title: 'Cash flows from financing activities',
+        },
+    ];
+    const chipClass = (value) => `rounded px-2 py-1 text-xs ${selected === value
+        ? 'bg-primary-600 text-white'
+        : 'bg-gray-100 text-gray-700 hover:bg-gray-200 dark:bg-gray-800 dark:text-gray-200'} ${disabled ? 'cursor-not-allowed opacity-50' : ''}`;
+    const allClass = `rounded px-2 py-1 text-xs ${selected === null
+        ? 'bg-primary-600 text-white'
+        : 'bg-gray-100 text-gray-700 hover:bg-gray-200 dark:bg-gray-800 dark:text-gray-200'} ${disabled ? 'cursor-not-allowed opacity-50' : ''}`;
+    const activityChipClass = (value) => `rounded px-2 py-1 text-xs ${activity === value
+        ? 'bg-emerald-600 text-white'
+        : 'bg-gray-100 text-gray-700 hover:bg-gray-200 dark:bg-gray-800 dark:text-gray-200'} ${disabled ? 'cursor-not-allowed opacity-50' : ''}`;
+    const showActivity = onActivityChange !== undefined;
+    return (_jsxs("div", { className: "flex flex-wrap gap-1", children: [_jsx("button", { onClick: () => onSelect(null), disabled: disabled, className: allClass, children: "All" }), balanceSheetClasses.map((c) => (_jsx("button", { onClick: () => onSelect(c.value), disabled: disabled, title: c.title, className: chipClass(c.value), children: c.label }, c.value))), _jsx("span", { className: "mx-1 self-center text-gray-300 dark:text-gray-600", children: "\u00B7" }), incomeStatementClasses.map((c) => (_jsx("button", { onClick: () => onSelect(c.value), disabled: disabled, title: c.title, className: chipClass(c.value), children: c.label }, c.value))), _jsx("button", { onClick: () => onSelect('metric'), disabled: disabled, title: "Derived metrics / subtotals (Net Income, Gross Profit, Comprehensive Income totals). Not SFAC 6 primary elements.", className: `rounded px-2 py-1 text-xs ${selected === 'metric'
+                    ? 'bg-pink-600 text-white'
+                    : 'bg-gray-100 text-gray-700 hover:bg-gray-200 dark:bg-gray-800 dark:text-gray-200'} ${disabled ? 'cursor-not-allowed opacity-50' : ''}`, children: "Metric" }), _jsx("span", { className: "mx-1 self-center text-gray-300 dark:text-gray-600", children: "\u00B7" }), _jsx("button", { onClick: () => onSelect('abstract'), disabled: disabled, title: "Abstract grouping concepts (hypercubes, RollUps, LineItems).", className: `rounded px-2 py-1 text-xs ${selected === 'abstract'
+                    ? 'bg-secondary-600 text-white'
+                    : 'bg-gray-100 text-gray-700 hover:bg-gray-200 dark:bg-gray-800 dark:text-gray-200'} ${disabled ? 'cursor-not-allowed opacity-50' : ''}`, children: "Abstract" }), showActivity && (_jsxs(_Fragment, { children: [_jsx("span", { className: "mx-1 self-center text-gray-300 dark:text-gray-600", children: "\u00B7" }), activityClasses.map((c) => (_jsx("button", { onClick: () => onActivityChange === null || onActivityChange === void 0 ? void 0 : onActivityChange(activity === c.value ? null : c.value), disabled: disabled, title: c.title, className: activityChipClass(c.value), children: c.label }, c.value)))] }))] }));
+}

package/library/components/ElementBrowser.d.ts

@@ -0,0 +1,11 @@
+import type { LibraryClient, LibraryTaxonomy } from '@robosystems/client/clients';
+export declare function ElementBrowser({ client, graphId, taxonomyId, taxonomies, onTaxonomyChange, selectedElementId, onSelectElement, }: {
+    client: LibraryClient;
+    graphId: string;
+    taxonomyId: string | null;
+    /** When provided, renders a taxonomy selector alongside search. */
+    taxonomies?: LibraryTaxonomy[];
+    onTaxonomyChange?: (id: string) => void;
+    selectedElementId: string | null;
+    onSelectElement: (id: string) => void;
+}): import("react").JSX.Element;