@fgv/ts-res-ui-components 5.0.0-26 → 5.0.0-28

package/dist/ts-res-ui-components.d.ts

@@ -2,6 +2,7 @@ import { Bundle } from '@fgv/ts-res';
 import { Config } from '@fgv/ts-res';
 import { FileTree } from '@fgv/ts-utils';
 import { Import } from '@fgv/ts-res';
+import { JsonCompatible } from '@fgv/ts-json-base';
 import { JsonValue } from '@fgv/ts-json-base';
 import { Logging } from '@fgv/ts-utils';
 import { MessageLogLevel } from '@fgv/ts-utils';
@@ -1832,13 +1833,13 @@ declare interface IConfigurationViewProps extends IViewBaseProps {
  *
  * @public
  */
-declare interface ICreatePendingResourceParams {
+declare interface ICreatePendingResourceParams<T = JsonValue, TV extends JsonCompatible<T> = JsonCompatible<T>> {
     /** Full resource ID (e.g., 'platform.languages.az-AZ') - must be unique */
     id: string;
     /** Name of the resource type to use for validation and template creation */
     resourceTypeName: string;
     /** JSON content for the resource candidate. If undefined, the resource type's base template will be used. */
-    json?: JsonValue;
+    json?: TV;
 }
 
 /**
@@ -1977,11 +1978,11 @@ declare interface IEditableJsonViewProps {
  *
  * @public
  */
-declare interface IEditedResourceInfo {
+declare interface IEditedResourceInfo<T = JsonValue, TV extends JsonCompatible<T> = JsonCompatible<T>> {
     /** Unique identifier of the resource being edited */
     resourceId: string;
-    originalValue: JsonValue;
-    editedValue: JsonValue;
+    originalValue: TV;
+    editedValue: TV;
     timestamp: Date;
 }
 
@@ -2987,16 +2988,20 @@ export declare interface IOrchestratorActions {
     updateFilterState: (state: Partial<IFilterState>) => void;
     applyFilter: () => Promise<IFilterResult | null>;
     resetFilter: () => void;
-    updateResolutionContext: (qualifierName: string, value: string | undefined) => void;
-    applyResolutionContext: () => void;
-    selectResourceForResolution: (resourceId: string) => void;
+    updateResolutionContext: (qualifierName: string, value: string | undefined) => Result<void>;
+    applyResolutionContext: (hostManagedValues?: Record<string, string | undefined>) => Result<void>;
+    selectResourceForResolution: (resourceId: string) => Result<void>;
     setResolutionViewMode: (mode: 'composed' | 'best' | 'all' | 'raw') => void;
-    resetResolutionCache: () => void;
-    saveResourceEdit: (resourceId: string, editedValue: JsonValue, originalValue?: JsonValue) => void;
+    resetResolutionCache: () => Result<void>;
+    saveResourceEdit: (resourceId: string, editedValue: JsonValue, originalValue?: JsonValue) => Result<void>;
     getEditedValue: (resourceId: string) => JsonValue | undefined;
     hasResourceEdit: (resourceId: string) => boolean;
-    clearResourceEdits: () => void;
-    discardResourceEdits: () => void;
+    clearResourceEdits: () => Result<{
+        clearedCount: number;
+    }>;
+    discardResourceEdits: () => Result<{
+        discardedCount: number;
+    }>;
     createPendingResource: (params: ICreatePendingResourceParams) => Result<void>;
     startNewResource: (params?: IStartNewResourceParams) => Result<{
         draft: IResolutionState['newResourceDraft'];
@@ -3019,7 +3024,7 @@ export declare interface IOrchestratorActions {
         diagnostics: string[];
     }>;
     cancelNewResource: () => void;
-    removePendingResource: (resourceId: string) => void;
+    removePendingResource: (resourceId: string) => Result<void>;
     markResourceForDeletion: (resourceId: string) => void;
     applyPendingResources: () => Promise<Result<{
         appliedCount: number;
@@ -3111,6 +3116,7 @@ export declare interface IOrchestratorState {
     isProcessing: boolean;
     error: string | null;
     messages: IMessage[];
+    resourceEditorFactory?: IResourceEditorFactory;
 }
 
 /**
@@ -3506,7 +3512,7 @@ declare interface IResolutionOptions {
  *
  * @public
  */
-declare interface IResolutionResult {
+declare interface IResolutionResult<T = JsonValue, TV extends JsonCompatible<T> = JsonCompatible<T>> {
     /** Whether the resolution was successful */
     success: boolean;
     /** ID of the resource that was resolved */
@@ -3520,7 +3526,7 @@ declare interface IResolutionResult {
     /** Detailed information about each candidate's matching process */
     candidateDetails?: ICandidateInfo[];
     /** The final composed/resolved value */
-    composedValue?: JsonValue;
+    composedValue?: TV;
     /** Error message if resolution failed */
     error?: string;
 }
@@ -3732,7 +3738,7 @@ declare interface IResourceDetailData {
  *
  * @public
  */
-declare interface IResourceEditorFactory {
+declare interface IResourceEditorFactory<T = JsonValue, TV extends JsonCompatible<T> = JsonCompatible<T>> {
     /**
      * Attempts to create a resource editor for the given resource.
      *
@@ -3741,7 +3747,7 @@ declare interface IResourceEditorFactory {
      * @param value - The current value of the resource
      * @returns ResourceEditorResult indicating success/failure and the editor component or error message
      */
-    createEditor(resourceId: string, resourceType: string, value: JsonValue): ResourceEditorResult;
+    createEditor(resourceId: string, resourceType: string, value: TV): ResourceEditorResult<T, TV>;
 }
 
 /**
@@ -3750,17 +3756,17 @@ declare interface IResourceEditorFactory {
  *
  * @public
  */
-declare interface IResourceEditorProps {
+declare interface IResourceEditorProps<T = JsonValue, TV extends JsonCompatible<T> = JsonCompatible<T>> {
     /** The original JSON value to edit */
-    value: JsonValue;
+    value: TV;
     /** The resource ID for tracking edits */
     resourceId: string;
     /** Whether this resource has been edited */
     isEdited?: boolean;
     /** The current edited value if any */
-    editedValue?: JsonValue;
+    editedValue?: TV;
     /** Callback when the user saves an edit */
-    onSave?: (resourceId: string, editedValue: JsonValue, originalValue: JsonValue) => void;
+    onSave?: (resourceId: string, editedValue: TV, originalValue: TV) => void;
     /** Callback when the user cancels an edit */
     onCancel?: (resourceId: string) => void;
     /** Whether editing is currently disabled */
@@ -3844,6 +3850,12 @@ declare interface IResourceOrchestratorProps {
     qualifierTypeFactory?: Config.IConfigInitFactory<QualifierTypes.Config.IAnyQualifierTypeConfig, QualifierTypes.QualifierType>;
     /** Optional resource type factory for creating custom resource types */
     resourceTypeFactory?: Config.IConfigInitFactory<ResourceTypes.Config.IResourceTypeConfig, ResourceTypes.ResourceType>;
+    /**
+     * Optional factory for creating type-specific resource editors.
+     * When provided, ResolutionView will use custom editors for supported resource types
+     * instead of the default JSON editor.
+     */
+    resourceEditorFactory?: IResourceEditorFactory;
     /** Callback fired when orchestrator state changes */
     onStateChange?: (state: Partial<IOrchestratorState>) => void;
     /** Optional observability context for logging and user feedback */
@@ -4129,6 +4141,10 @@ declare interface ISourceResourceDetailProps {
 declare interface ISourceViewProps extends IViewBaseProps {
     /** The processed resource system to display */
     resources?: IExtendedProcessedResources | null;
+    /** Optional filter state for filtered views */
+    filterState?: IFilterState;
+    /** Result of filtering if applied */
+    filterResult?: IFilterResult | null;
     /** Currently selected resource ID for detailed view */
     selectedResourceId?: string | null;
     /** Callback when a resource is selected */
@@ -4177,7 +4193,7 @@ declare function isPendingAddition(resourceId: string, pendingResources: Map<str
  *
  * @public
  */
-declare interface IStartNewResourceParams {
+declare interface IStartNewResourceParams<T = JsonValue, TV extends JsonCompatible<T> = JsonCompatible<T>> {
     /** Resource type to use (optional - will use first available if not provided) */
     defaultTypeName?: string;
     /** Pre-seed with specific ID (optional) */
@@ -4185,7 +4201,7 @@ declare interface IStartNewResourceParams {
     /** Pre-seed with specific resource type name (optional) */
     resourceTypeName?: string;
     /** Pre-seed with specific JSON content (optional) */
-    json?: JsonValue;
+    json?: TV;
 }
 
 /**
@@ -5401,11 +5417,11 @@ declare function resolveResourceDetailed(resolver: Runtime.ResourceResolver, res
  *
  * @public
  */
-declare type ResourceEditorResult = {
+declare type ResourceEditorResult<T = JsonValue, TV extends JsonCompatible<T> = JsonCompatible<T>> = {
     /** Indicates whether the factory was able to create an editor for the resource */
     success: true;
     /** The React component to render for editing this resource */
-    editor: React.ComponentType<IResourceEditorProps>;
+    editor: React.ComponentType<IResourceEditorProps<T, TV>>;
 } | {
     /** Indicates the factory could not create an editor for this resource */
     success: false;
@@ -6490,6 +6506,35 @@ declare function useResolutionState(processedResources: IProcessedResources | nu
  */
 declare function useResourceData(params?: IUseResourceDataParams): IUseResourceDataReturn;
 
+/**
+ * Smart observability hook that automatically provides the best available observability context.
+ *
+ * This hook detects the current observability context type and:
+ * - Uses ViewState-connected context when available (best experience)
+ * - Auto-creates ViewState connection when only console context is available
+ * - Preserves custom contexts provided by consumers
+ * - Provides helpful warnings for suboptimal configurations
+ *
+ * @returns The most appropriate observability context for the current component tree
+ *
+ * @example
+ * ```tsx
+ * // In a component that needs user feedback in the UI
+ * const MyComponent = () => {
+ *   const o11y = useSmartObservability();
+ *
+ *   const handleAction = () => {
+ *     o11y.user.success('Action completed successfully!');
+ *   };
+ *
+ *   return <button onClick={handleAction}>Do Something</button>;
+ * };
+ * ```
+ *
+ * @public
+ */
+export declare function useSmartObservability(): IObservabilityContext;
+
 /**
  * Hook for managing view state including messages and resource selection.
  *

package/lib/components/forms/QualifierTypeEditForm.js

@@ -118,22 +118,23 @@ export const QualifierTypeEditForm = ({ qualifierType, onSave, onCancel, existin
             let allowedTerritories = [];
             let hierarchy = {};
             if (qualifierTypeInstance.isSuccess()) {
-                const configResult = qualifierTypeInstance.value.getConfigurationJson();
+                const configResult = qualifierTypeInstance.value.getConfiguration();
                 if (configResult.isSuccess()) {
                     const config = configResult.value;
-                    allowContextList = config.allowContextList === true;
-                    caseSensitive = config.caseSensitive !== false; // Default to true
-                    enumeratedValues = Array.isArray(config.enumeratedValues)
-                        ? config.enumeratedValues
-                        : [];
-                    acceptLowercase = config.acceptLowercase === true;
-                    allowedTerritories = Array.isArray(config.allowedTerritories)
-                        ? config.allowedTerritories
-                        : [];
-                    hierarchy =
-                        typeof config.hierarchy === 'object' && config.hierarchy !== null
-                            ? config.hierarchy
-                            : {};
+                    allowContextList = config.configuration?.allowContextList === true;
+                    // Type-specific property access based on systemType
+                    if (config.systemType === 'literal') {
+                        const literalConfig = config.configuration;
+                        caseSensitive = literalConfig?.caseSensitive !== false; // Default to true
+                        enumeratedValues = literalConfig?.enumeratedValues ?? [];
+                        hierarchy = literalConfig?.hierarchy ?? {};
+                    }
+                    else if (config.systemType === 'territory') {
+                        const territoryConfig = config.configuration;
+                        acceptLowercase = territoryConfig?.acceptLowercase === true;
+                        allowedTerritories = territoryConfig?.allowedTerritories ?? [];
+                        hierarchy = territoryConfig?.hierarchy ?? {};
+                    }
                 }
             }
             return {

package/lib/components/orchestrator/ResourceOrchestrator.d.ts

@@ -1,6 +1,6 @@
 import React, { ReactNode } from 'react';
 import { Config, QualifierTypes, ResourceTypes } from '@fgv/ts-res';
-import { IOrchestratorState, IOrchestratorActions } from '../../types';
+import { IOrchestratorState, IOrchestratorActions, IResourceEditorFactory } from '../../types';
 import * as ObservabilityTools from '../../utils/observability';
 /**
  * Props for the ResourceOrchestrator component.
@@ -20,6 +20,12 @@ export interface IResourceOrchestratorProps {
     qualifierTypeFactory?: Config.IConfigInitFactory<QualifierTypes.Config.IAnyQualifierTypeConfig, QualifierTypes.QualifierType>;
     /** Optional resource type factory for creating custom resource types */
     resourceTypeFactory?: Config.IConfigInitFactory<ResourceTypes.Config.IResourceTypeConfig, ResourceTypes.ResourceType>;
+    /**
+     * Optional factory for creating type-specific resource editors.
+     * When provided, ResolutionView will use custom editors for supported resource types
+     * instead of the default JSON editor.
+     */
+    resourceEditorFactory?: IResourceEditorFactory;
     /** Callback fired when orchestrator state changes */
     onStateChange?: (state: Partial<IOrchestratorState>) => void;
     /** Optional observability context for logging and user feedback */

package/lib/components/orchestrator/ResourceOrchestrator.js

@@ -11,7 +11,7 @@ import * as DownloadUtils from '../../utils/downloadHelper';
 /**
  * Internal orchestrator component that has access to observability context via hook.
  */
-const ResourceOrchestratorInternal = ({ children, initialConfiguration, qualifierTypeFactory, resourceTypeFactory, onStateChange, viewState }) => {
+const ResourceOrchestratorInternal = ({ children, initialConfiguration, qualifierTypeFactory, resourceTypeFactory, resourceEditorFactory, onStateChange, viewState }) => {
     // Get observability context from provider
     const o11y = useObservability();
     // Core hooks
@@ -27,9 +27,16 @@ const ResourceOrchestratorInternal = ({ children, initialConfiguration, qualifie
         resourceData.actions.updateProcessedResources(updatedResources);
         o11y.user.success('Resource system updated with edits');
     }, [resourceData.actions, o11y.user]);
-    const resolutionData = useResolutionState(resourceData.state.processedResources, handleSystemUpdate);
     // Local state for filter results
     const [filterResult, setFilterResult] = useState(null);
+    // Use filtered resources for resolution when filtering is active and successful
+    const resolutionProcessedResources = useMemo(() => {
+        const isFilteringActive = filterState.state.enabled && filterResult?.success === true;
+        return isFilteringActive
+            ? filterResult?.processedResources ?? null
+            : resourceData.state.processedResources;
+    }, [filterState.state.enabled, filterResult, resourceData.state.processedResources]);
+    const resolutionData = useResolutionState(resolutionProcessedResources, handleSystemUpdate);
     // Track if filtering is in progress to prevent concurrent operations
     const isFilteringInProgress = React.useRef(false);
     // Initialize with configuration if provided
@@ -196,14 +203,16 @@ const ResourceOrchestratorInternal = ({ children, initialConfiguration, qualifie
         selectedResourceId: viewState.selectedResourceId,
         isProcessing: resourceData.state.isProcessing,
         error: resourceData.state.error,
-        messages: viewState.messages
+        messages: viewState.messages,
+        resourceEditorFactory
     }), [
         resourceData.state,
         filterState.state,
         filterResult,
         resolutionData.state,
         viewState.selectedResourceId,
-        viewState.messages
+        viewState.messages,
+        resourceEditorFactory
     ]);
     // Combined actions
     const actions = useMemo(() => ({

package/lib/components/pickers/ResourcePicker/index.js

@@ -131,7 +131,7 @@ export const ResourcePicker = ({ resources, selectedResourceId, onResourceSelect
                             : 'text-gray-600 hover:text-gray-900'}`, title: "Tree View" },
                         React.createElement(FolderIcon, { className: "h-4 w-4" }),
                         React.createElement("span", { className: "ml-1" }, "Tree"))))))),
-        React.createElement("div", { className: "flex-1 overflow-y-auto border border-gray-200 rounded-lg bg-gray-50 !relative !z-auto !min-h-[300px]" }, viewMode === 'tree' ? (React.createElement(ResourcePickerTree, { resources: resources, pendingResources: pendingResources, selectedResourceId: selectedResourceId, onResourceSelect: handleResourceSelect, resourceAnnotations: resourceAnnotations, searchTerm: searchTerm, rootPath: rootPath, hideRootNode: hideRootNode, emptyMessage: emptyMessage })) : (React.createElement(ResourcePickerList, { resourceIds: resources.summary.resourceIds || [], pendingResources: pendingResources, selectedResourceId: selectedResourceId, onResourceSelect: handleResourceSelect, resourceAnnotations: resourceAnnotations, searchTerm: searchTerm, rootPath: rootPath, hideRootNode: hideRootNode, emptyMessage: emptyMessage })))));
+        React.createElement("div", { className: "flex-1 overflow-y-auto border border-gray-200 rounded-lg bg-gray-50 !relative !z-auto !min-h-[300px]" }, viewMode === 'tree' ? (React.createElement(ResourcePickerTree, { resources: resources, pendingResources: pendingResources, selectedResourceId: selectedResourceId, onResourceSelect: handleResourceSelect, resourceAnnotations: resourceAnnotations, searchTerm: searchTerm, rootPath: rootPath, hideRootNode: hideRootNode, emptyMessage: emptyMessage })) : (React.createElement(ResourcePickerList, { resourceIds: resourceIds, pendingResources: pendingResources, selectedResourceId: selectedResourceId, onResourceSelect: handleResourceSelect, resourceAnnotations: resourceAnnotations, searchTerm: searchTerm, rootPath: rootPath, hideRootNode: hideRootNode, emptyMessage: emptyMessage })))));
 };
 export default ResourcePicker;
 //# sourceMappingURL=index.js.map

package/lib/components/views/GridView/index.js

@@ -55,6 +55,11 @@ import { useSmartObservability } from '../../../hooks/useSmartObservability';
  */
 export const GridView = ({ gridConfig, resources, resolutionState, resolutionActions, availableQualifiers = [], contextOptions, filterState, filterResult, showContextControls = true, showChangeControls = true, className = '' }) => {
     const o11y = useSmartObservability();
+    // Store o11y in a ref to avoid re-render issues
+    const o11yRef = React.useRef(o11y);
+    React.useEffect(() => {
+        o11yRef.current = o11y;
+    }, [o11y]);
     // Use filtered resources when filtering is active and successful
     const isFilteringActive = filterState?.enabled && filterResult?.success === true;
     const baseProcessedResources = isFilteringActive ? filterResult?.processedResources : resources;
@@ -65,11 +70,12 @@ export const GridView = ({ gridConfig, resources, resolutionState, resolutionAct
         }
         const selectionResult = selectResources(gridConfig.resourceSelection, baseProcessedResources);
         if (selectionResult.isFailure()) {
-            o11y.user.error(`Resource selection failed: ${selectionResult.message}`);
+            // Use ref to avoid dependency on o11y
+            o11yRef.current.user.error(`Resource selection failed: ${selectionResult.message}`);
             return [];
         }
         return selectionResult.value;
-    }, [baseProcessedResources, gridConfig.resourceSelection, o11y]);
+    }, [baseProcessedResources, gridConfig.resourceSelection]); // Removed o11y from dependencies
     // Resolve all selected resources with current context
     const resourceResolutions = useMemo(() => {
         if (!resolutionState?.currentResolver || !selectedResourceIds.length) {

package/lib/components/views/MessagesWindow/index.js

@@ -116,9 +116,11 @@ export const MessagesWindow = ({ messages, onClearMessages, className = '' }) =>
             o11y.diag.error('Failed to copy messages:', err);
         });
     };
-    if (messages.length === 0) {
-        return null;
-    }
+    // Always show the messages window, even when empty
+    // This ensures consistent UI layout and visibility
+    // if (messages.length === 0) {
+    //   return null;
+    // }
     const getMessageIcon = (type) => {
         switch (type) {
             case 'info':

package/lib/components/views/SourceView/index.js

@@ -39,10 +39,13 @@ import { useSmartObservability } from '../../../hooks/useSmartObservability';
  *
  * @public
  */
-export const SourceView = ({ resources, onExport, pickerOptions, pickerOptionsPresentation = 'hidden', className = '' }) => {
+export const SourceView = ({ resources, filterState, filterResult, onExport, pickerOptions, pickerOptionsPresentation = 'hidden', className = '' }) => {
     const o11y = useSmartObservability();
     const [selectedResourceId, setSelectedResourceId] = useState(null);
     const [showJsonView, setShowJsonView] = useState(false);
+    // Use filtered resources when filtering is active and successful
+    const isFilteringActive = filterState?.enabled && filterResult?.success === true;
+    const activeProcessedResources = isFilteringActive ? filterResult?.processedResources : resources;
     // State for picker options control
     const [currentPickerOptions, setCurrentPickerOptions] = useState((pickerOptions ?? {}));
     // Merge picker options with view-specific defaults
@@ -68,19 +71,20 @@ export const SourceView = ({ resources, onExport, pickerOptions, pickerOptionsPr
     }, [o11y]);
     // Get full resource collection data using the new method
     const getResourceCollectionData = useCallback(() => {
-        if (!resources?.system.resourceManager) {
+        if (!activeProcessedResources?.system.resourceManager) {
             return null;
         }
         // Check if this is a ResourceManagerBuilder (has getResourceCollectionDecl method)
-        if ('getResourceCollectionDecl' in resources.system.resourceManager) {
-            const collectionResult = resources.system.resourceManager.getResourceCollectionDecl();
+        if ('getResourceCollectionDecl' in activeProcessedResources.system.resourceManager) {
+            const collectionResult = activeProcessedResources.system.resourceManager.getResourceCollectionDecl();
             if (collectionResult.isSuccess()) {
                 return {
                     ...collectionResult.value,
                     metadata: {
                         exportedAt: new Date().toISOString(),
-                        totalResources: resources.summary.totalResources,
-                        type: 'ts-res-resource-collection'
+                        totalResources: activeProcessedResources.summary.totalResources,
+                        type: isFilteringActive ? 'ts-res-filtered-resource-collection' : 'ts-res-resource-collection',
+                        ...(isFilteringActive && { filterContext: filterState?.appliedValues })
                     }
                 };
             }
@@ -89,14 +93,15 @@ export const SourceView = ({ resources, onExport, pickerOptions, pickerOptionsPr
                 return null;
             }
         }
-        else if (resources.compiledCollection) {
+        else if (activeProcessedResources.compiledCollection) {
             // For IResourceManager from bundles, use the compiled collection directly
             return {
-                resources: resources.compiledCollection.resources || [],
+                resources: activeProcessedResources.compiledCollection.resources ?? [],
                 metadata: {
                     exportedAt: new Date().toISOString(),
-                    totalResources: resources.summary.totalResources,
-                    type: 'ts-res-resource-collection'
+                    totalResources: activeProcessedResources.summary.totalResources,
+                    type: isFilteringActive ? 'ts-res-filtered-resource-collection' : 'ts-res-resource-collection',
+                    ...(isFilteringActive && { filterContext: filterState?.appliedValues })
                 }
             };
         }
@@ -104,7 +109,7 @@ export const SourceView = ({ resources, onExport, pickerOptions, pickerOptionsPr
             o11y.user.error('Resource collection data not available');
             return null;
         }
-    }, [resources, o11y]);
+    }, [activeProcessedResources, isFilteringActive, filterState?.appliedValues, o11y]);
     // Export source data to JSON file
     const handleExportSourceData = useCallback(() => {
         try {
@@ -120,7 +125,7 @@ export const SourceView = ({ resources, onExport, pickerOptions, pickerOptionsPr
             o11y.user.error(`Failed to export resource collection: ${error instanceof Error ? error.message : String(error)}`);
         }
     }, [getResourceCollectionData, onExport, o11y]);
-    if (!resources) {
+    if (!activeProcessedResources) {
         return (React.createElement("div", { className: `p-6 ${className}` },
             React.createElement("div", { className: "flex items-center space-x-3 mb-6" },
                 React.createElement(DocumentTextIcon, { className: "h-8 w-8 text-blue-600" }),
@@ -138,13 +143,14 @@ export const SourceView = ({ resources, onExport, pickerOptions, pickerOptionsPr
         React.createElement("div", { className: "flex items-center justify-between mb-6" },
             React.createElement("div", { className: "flex items-center space-x-3" },
                 React.createElement(DocumentTextIcon, { className: "h-8 w-8 text-blue-600" }),
-                React.createElement("h2", { className: "text-2xl font-bold text-gray-900" }, "Source Browser")),
-            resources && (React.createElement("div", { className: "flex items-center space-x-2" },
+                React.createElement("h2", { className: "text-2xl font-bold text-gray-900" }, "Source Browser"),
+                isFilteringActive && (React.createElement("span", { className: "inline-flex items-center px-2.5 py-0.5 rounded-full text-xs font-medium bg-purple-100 text-purple-800" }, "Filtered"))),
+            activeProcessedResources && (React.createElement("div", { className: "flex items-center space-x-2" },
                 React.createElement("button", { onClick: handleExportSourceData, className: "inline-flex items-center px-3 py-1.5 border border-gray-300 text-xs font-medium rounded text-gray-700 bg-white hover:bg-gray-50 focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-blue-500" },
                     React.createElement(DocumentArrowDownIcon, { className: "h-4 w-4 mr-1" }),
                     "Export JSON")))),
         React.createElement(ResourcePickerOptionsControl, { options: currentPickerOptions, onOptionsChange: setCurrentPickerOptions, presentation: pickerOptionsPresentation, title: "Source Browser Picker Options", className: "mb-6" }),
-        resources && (React.createElement("div", { className: "bg-white rounded-lg shadow-sm border border-gray-200 p-4 mb-6" },
+        activeProcessedResources && (React.createElement("div", { className: "bg-white rounded-lg shadow-sm border border-gray-200 p-4 mb-6" },
             React.createElement("button", { onClick: () => setShowJsonView(!showJsonView), className: "inline-flex items-center px-3 py-1.5 text-sm font-medium text-gray-700 hover:text-gray-900 focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-blue-500" },
                 React.createElement(CodeBracketIcon, { className: "h-4 w-4 mr-2" }),
                 showJsonView ? 'Hide' : 'Show',
@@ -164,8 +170,8 @@ export const SourceView = ({ resources, onExport, pickerOptions, pickerOptionsPr
                     React.createElement("div", { className: "flex items-center mb-4" },
                         React.createElement("h3", { className: "text-lg font-semibold text-gray-900" }, "Resources")),
                     React.createElement("div", { className: "flex-1 min-h-0" },
-                        React.createElement(ResourcePicker, { resources: resources, selectedResourceId: selectedResourceId, onResourceSelect: handleResourceSelect, options: effectivePickerOptions }))),
-                React.createElement("div", { className: "lg:w-1/2 flex flex-col" }, selectedResourceId ? (React.createElement(SourceResourceDetail, { resourceId: selectedResourceId, processedResources: resources })) : (React.createElement("div", { className: "flex-1 flex items-center justify-center border border-gray-200 rounded-lg bg-gray-50" },
+                        React.createElement(ResourcePicker, { resources: activeProcessedResources, selectedResourceId: selectedResourceId, onResourceSelect: handleResourceSelect, options: effectivePickerOptions }))),
+                React.createElement("div", { className: "lg:w-1/2 flex flex-col" }, selectedResourceId ? (React.createElement(SourceResourceDetail, { resourceId: selectedResourceId, processedResources: activeProcessedResources })) : (React.createElement("div", { className: "flex-1 flex items-center justify-center border border-gray-200 rounded-lg bg-gray-50" },
                     React.createElement("div", { className: "text-center" },
                         React.createElement(DocumentTextIcon, { className: "h-12 w-12 text-gray-400 mx-auto mb-4" }),
                         React.createElement("p", { className: "text-gray-500" }, "Select a resource to view details")))))))));

package/lib/index.d.ts

@@ -11,10 +11,13 @@ export { MessagesWindow } from './components/views/MessagesWindow';
 export { GridView } from './components/views/GridView';
 export { MultiGridView } from './components/views/GridView/MultiGridView';
 export { ResourceOrchestrator } from './components/orchestrator/ResourceOrchestrator';
-export { ObservabilityProvider, useObservability, type IObservabilityProviderProps } from './contexts';
-export { ResourceTreeView } from './components/common/ResourceTreeView';
-export { ResourceListView } from './components/common/ResourceListView';
-export { SourceResourceDetail } from './components/common/SourceResourceDetail';
-export { ResolutionResults } from './components/common/ResolutionResults';
+import { ObservabilityProvider, useObservability, type IObservabilityProviderProps } from './contexts';
+import { useSmartObservability } from './hooks/useSmartObservability';
+export { useSmartObservability, ObservabilityProvider, useObservability, type IObservabilityProviderProps };
+import { ResourceTreeView } from './components/common/ResourceTreeView';
+import { ResourceListView } from './components/common/ResourceListView';
+import { SourceResourceDetail } from './components/common/SourceResourceDetail';
+import { ResolutionResults } from './components/common/ResolutionResults';
+export { ResourceTreeView, ResourceListView, SourceResourceDetail, ResolutionResults };
 export { DownloadTools, FilterTools, ResolutionTools, ConfigurationTools, ResourceTools, ImportTools, TsResTools, ZipTools, ViewStateTools, PickerTools, GridTools, ObservabilityTools } from './namespaces';
 //# sourceMappingURL=index.d.ts.map

package/lib/index.js

@@ -22,12 +22,15 @@ export { MultiGridView } from './components/views/GridView/MultiGridView';
 // Export orchestrator
 export { ResourceOrchestrator } from './components/orchestrator/ResourceOrchestrator';
 // Export contexts and hooks
-export { ObservabilityProvider, useObservability } from './contexts';
+import { ObservabilityProvider, useObservability } from './contexts';
+import { useSmartObservability } from './hooks/useSmartObservability';
+export { useSmartObservability, ObservabilityProvider, useObservability };
 // Export common components (likely to be used by consumers)
-export { ResourceTreeView } from './components/common/ResourceTreeView';
-export { ResourceListView } from './components/common/ResourceListView';
-export { SourceResourceDetail } from './components/common/SourceResourceDetail';
-export { ResolutionResults } from './components/common/ResolutionResults';
+import { ResourceTreeView } from './components/common/ResourceTreeView';
+import { ResourceListView } from './components/common/ResourceListView';
+import { SourceResourceDetail } from './components/common/SourceResourceDetail';
+import { ResolutionResults } from './components/common/ResolutionResults';
+export { ResourceTreeView, ResourceListView, SourceResourceDetail, ResolutionResults };
 // Form components are now available through ConfigurationTools namespace:
 // - ConfigurationTools.QualifierTypeEditForm
 // - ConfigurationTools.QualifierEditForm

package/lib/tsdoc-metadata.json

@@ -5,7 +5,7 @@
   "toolPackages": [
     {
       "packageName": "@microsoft/api-extractor",
-      "packageVersion": "7.52.10"
+      "packageVersion": "7.52.12"
     }
   ]
 }

package/lib/types/index.d.ts

@@ -1,6 +1,6 @@
 import { Result } from '@fgv/ts-utils';
 import { ResourceJson, Config, Bundle, Resources, Runtime, QualifierTypes, Qualifiers, ResourceTypes, Import } from '@fgv/ts-res';
-import { JsonValue } from '@fgv/ts-json-base';
+import { JsonCompatible, JsonValue } from '@fgv/ts-json-base';
 import type { IObservabilityContext } from '../utils/observability';
 /**
  * Configuration options for ResourcePicker components.
@@ -240,6 +240,10 @@ export interface IImportViewProps extends IViewBaseProps {
 export interface ISourceViewProps extends IViewBaseProps {
     /** The processed resource system to display */
     resources?: IExtendedProcessedResources | null;
+    /** Optional filter state for filtered views */
+    filterState?: IFilterState;
+    /** Result of filtering if applied */
+    filterResult?: IFilterResult | null;
     /** Currently selected resource ID for detailed view */
     selectedResourceId?: string | null;
     /** Callback when a resource is selected */
@@ -297,11 +301,11 @@ export interface ICompiledViewProps extends IViewBaseProps {
  *
  * @public
  */
-export type ResourceEditorResult = {
+export type ResourceEditorResult<T = JsonValue, TV extends JsonCompatible<T> = JsonCompatible<T>> = {
     /** Indicates whether the factory was able to create an editor for the resource */
     success: true;
     /** The React component to render for editing this resource */
-    editor: React.ComponentType<IResourceEditorProps>;
+    editor: React.ComponentType<IResourceEditorProps<T, TV>>;
 } | {
     /** Indicates the factory could not create an editor for this resource */
     success: false;
@@ -314,17 +318,17 @@ export type ResourceEditorResult = {
  *
  * @public
  */
-export interface IResourceEditorProps {
+export interface IResourceEditorProps<T = JsonValue, TV extends JsonCompatible<T> = JsonCompatible<T>> {
     /** The original JSON value to edit */
-    value: JsonValue;
+    value: TV;
     /** The resource ID for tracking edits */
     resourceId: string;
     /** Whether this resource has been edited */
     isEdited?: boolean;
     /** The current edited value if any */
-    editedValue?: JsonValue;
+    editedValue?: TV;
     /** Callback when the user saves an edit */
-    onSave?: (resourceId: string, editedValue: JsonValue, originalValue: JsonValue) => void;
+    onSave?: (resourceId: string, editedValue: TV, originalValue: TV) => void;
     /** Callback when the user cancels an edit */
     onCancel?: (resourceId: string) => void;
     /** Whether editing is currently disabled */
@@ -338,7 +342,7 @@ export interface IResourceEditorProps {
  *
  * @public
  */
-export interface IResourceEditorFactory {
+export interface IResourceEditorFactory<T = JsonValue, TV extends JsonCompatible<T> = JsonCompatible<T>> {
     /**
      * Attempts to create a resource editor for the given resource.
      *
@@ -347,7 +351,7 @@ export interface IResourceEditorFactory {
      * @param value - The current value of the resource
      * @returns ResourceEditorResult indicating success/failure and the editor component or error message
      */
-    createEditor(resourceId: string, resourceType: string, value: JsonValue): ResourceEditorResult;
+    createEditor(resourceId: string, resourceType: string, value: TV): ResourceEditorResult<T, TV>;
 }
 /**
  * Props for the ResolutionView component.
@@ -400,11 +404,11 @@ export interface IResolutionViewProps extends IViewBaseProps {
  *
  * @public
  */
-export interface IEditedResourceInfo {
+export interface IEditedResourceInfo<T = JsonValue, TV extends JsonCompatible<T> = JsonCompatible<T>> {
     /** Unique identifier of the resource being edited */
     resourceId: string;
-    originalValue: JsonValue;
-    editedValue: JsonValue;
+    originalValue: TV;
+    editedValue: TV;
     timestamp: Date;
 }
 /**
@@ -464,13 +468,13 @@ export interface IResolutionState {
  *
  * @public
  */
-export interface ICreatePendingResourceParams {
+export interface ICreatePendingResourceParams<T = JsonValue, TV extends JsonCompatible<T> = JsonCompatible<T>> {
     /** Full resource ID (e.g., 'platform.languages.az-AZ') - must be unique */
     id: string;
     /** Name of the resource type to use for validation and template creation */
     resourceTypeName: string;
     /** JSON content for the resource candidate. If undefined, the resource type's base template will be used. */
-    json?: JsonValue;
+    json?: TV;
 }
 /**
  * Parameters for starting a new resource with optional pre-seeding.
@@ -492,7 +496,7 @@ export interface ICreatePendingResourceParams {
  *
  * @public
  */
-export interface IStartNewResourceParams {
+export interface IStartNewResourceParams<T = JsonValue, TV extends JsonCompatible<T> = JsonCompatible<T>> {
     /** Resource type to use (optional - will use first available if not provided) */
     defaultTypeName?: string;
     /** Pre-seed with specific ID (optional) */
@@ -500,7 +504,7 @@ export interface IStartNewResourceParams {
     /** Pre-seed with specific resource type name (optional) */
     resourceTypeName?: string;
     /** Pre-seed with specific JSON content (optional) */
-    json?: JsonValue;
+    json?: TV;
 }
 /**
  * Actions available for managing resource resolution testing and editing.
@@ -674,7 +678,7 @@ export interface IResolutionContextOptions {
  *
  * @public
  */
-export interface IResolutionResult {
+export interface IResolutionResult<T = JsonValue, TV extends JsonCompatible<T> = JsonCompatible<T>> {
     /** Whether the resolution was successful */
     success: boolean;
     /** ID of the resource that was resolved */
@@ -688,7 +692,7 @@ export interface IResolutionResult {
     /** Detailed information about each candidate's matching process */
     candidateDetails?: ICandidateInfo[];
     /** The final composed/resolved value */
-    composedValue?: JsonValue;
+    composedValue?: TV;
     /** Error message if resolution failed */
     error?: string;
 }
@@ -1149,6 +1153,7 @@ export interface IOrchestratorState {
     isProcessing: boolean;
     error: string | null;
     messages: IMessage[];
+    resourceEditorFactory?: IResourceEditorFactory;
 }
 /**
  * Complete actions interface for the resource orchestrator system.
@@ -1266,16 +1271,20 @@ export interface IOrchestratorActions {
     updateFilterState: (state: Partial<IFilterState>) => void;
     applyFilter: () => Promise<IFilterResult | null>;
     resetFilter: () => void;
-    updateResolutionContext: (qualifierName: string, value: string | undefined) => void;
-    applyResolutionContext: () => void;
-    selectResourceForResolution: (resourceId: string) => void;
+    updateResolutionContext: (qualifierName: string, value: string | undefined) => Result<void>;
+    applyResolutionContext: (hostManagedValues?: Record<string, string | undefined>) => Result<void>;
+    selectResourceForResolution: (resourceId: string) => Result<void>;
     setResolutionViewMode: (mode: 'composed' | 'best' | 'all' | 'raw') => void;
-    resetResolutionCache: () => void;
-    saveResourceEdit: (resourceId: string, editedValue: JsonValue, originalValue?: JsonValue) => void;
+    resetResolutionCache: () => Result<void>;
+    saveResourceEdit: (resourceId: string, editedValue: JsonValue, originalValue?: JsonValue) => Result<void>;
     getEditedValue: (resourceId: string) => JsonValue | undefined;
     hasResourceEdit: (resourceId: string) => boolean;
-    clearResourceEdits: () => void;
-    discardResourceEdits: () => void;
+    clearResourceEdits: () => Result<{
+        clearedCount: number;
+    }>;
+    discardResourceEdits: () => Result<{
+        discardedCount: number;
+    }>;
     createPendingResource: (params: ICreatePendingResourceParams) => Result<void>;
     startNewResource: (params?: IStartNewResourceParams) => Result<{
         draft: IResolutionState['newResourceDraft'];
@@ -1298,7 +1307,7 @@ export interface IOrchestratorActions {
         diagnostics: string[];
     }>;
     cancelNewResource: () => void;
-    removePendingResource: (resourceId: string) => void;
+    removePendingResource: (resourceId: string) => Result<void>;
     markResourceForDeletion: (resourceId: string) => void;
     applyPendingResources: () => Promise<Result<{
         appliedCount: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fgv/ts-res-ui-components",
-  "version": "5.0.0-26",
+  "version": "5.0.0-28",
   "description": "Reusable React components for ts-res resource visualization and management",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -23,11 +23,11 @@
     "@heroicons/react": "~2.2.0",
     "tslib": "^2.8.1",
     "json-edit-react": "~1.28.2",
-    "@fgv/ts-res": "5.0.0-26",
-    "@fgv/ts-json": "5.0.0-26",
-    "@fgv/ts-json-base": "5.0.0-26",
-    "@fgv/ts-utils": "5.0.0-26",
-    "@fgv/ts-extras": "5.0.0-26"
+    "@fgv/ts-res": "5.0.0-28",
+    "@fgv/ts-utils": "5.0.0-28",
+    "@fgv/ts-json-base": "5.0.0-28",
+    "@fgv/ts-json": "5.0.0-28",
+    "@fgv/ts-extras": "5.0.0-28"
   },
   "peerDependencies": {
     "react": ">=18.0.0",
@@ -55,14 +55,14 @@
     "rimraf": "^6.0.1",
     "ts-jest": "^29.4.1",
     "typescript": "5.8.3",
-    "@rushstack/heft": "0.74.3",
-    "@rushstack/heft-web-rig": "0.29.8",
+    "@rushstack/heft": "0.74.4",
+    "@rushstack/heft-web-rig": "0.29.9",
     "@rushstack/eslint-config": "4.4.0",
-    "@rushstack/heft-jest-plugin": "0.16.12",
+    "@rushstack/heft-jest-plugin": "0.16.13",
     "@microsoft/api-documenter": "^7.26.31",
     "@microsoft/api-extractor": "^7.52.10",
     "@testing-library/dom": "^10.4.0",
-    "@fgv/ts-utils-jest": "5.0.0-26"
+    "@fgv/ts-utils-jest": "5.0.0-28"
   },
   "scripts": {
     "build": "heft build --clean",