@fgv/ts-res-ui-components 5.0.0-10

package/lib/utils/filterResources.js

@@ -0,0 +1,153 @@
+import { succeed, fail } from '@fgv/ts-utils';
+import { Runtime, Import } from '@fgv/ts-res';
+// Helper function for conditional debug logging
+const debugLog = (enableDebug, ...args) => {
+    if (enableDebug) {
+        console.log(...args);
+    }
+};
+/**
+ * Check if filter values object has any meaningful values
+ */
+export function hasFilterValues(values) {
+    return Object.values(values).some((value) => value !== undefined && value !== '');
+}
+/**
+ * Get a summary string of active filter values
+ */
+export function getFilterSummary(values) {
+    const activeFilters = Object.entries(values)
+        .filter(([, value]) => value !== undefined && value !== '')
+        .map(([key, value]) => `${key}=${value}`);
+    return activeFilters.length > 0 ? activeFilters.join(', ') : 'No filters';
+}
+/**
+ * Creates a filtered resource manager using the ResourceManagerBuilder.clone() method.
+ * This is a simplified implementation that leverages the built-in filtering functionality.
+ */
+export const createFilteredResourceManagerSimple = async (originalSystem, partialContext, options = { partialContextMatch: true }) => {
+    const enableDebug = options.enableDebugLogging === true;
+    debugLog(enableDebug, '=== SIMPLE FILTER CREATION ===');
+    debugLog(enableDebug, 'Original system:', originalSystem);
+    debugLog(enableDebug, 'Partial context:', partialContext);
+    // Validate the original system
+    if (!originalSystem?.resourceManager) {
+        return fail('Original system or resourceManager is undefined');
+    }
+    // Filter out undefined values from the context before processing
+    const filteredContext = Object.fromEntries(Object.entries(partialContext).filter(([, value]) => value !== undefined));
+    // Try to use ResourceManagerBuilder.clone() for proper filtering first
+    debugLog(enableDebug, 'Using ResourceManagerBuilder for proper filtering');
+    debugLog(enableDebug, 'Validating context and cloning manager:', filteredContext);
+    const resourceManagerBuilder = originalSystem.resourceManager;
+    return resourceManagerBuilder
+        .validateContext(filteredContext)
+        .onSuccess((validatedContext) => {
+        debugLog(enableDebug, 'Context validated, creating clone with context:', validatedContext);
+        return resourceManagerBuilder.clone({
+            filterForContext: validatedContext,
+            reduceQualifiers: options.reduceQualifiers
+        });
+    })
+        .withErrorFormat((e) => `Failed to validate context or clone: ${e}`)
+        .onSuccess((filteredManager) => {
+        debugLog(enableDebug, 'Filtered manager created:', filteredManager);
+        // Create new ImportManager for the filtered system
+        return Import.ImportManager.create({
+            resources: filteredManager
+        })
+            .withErrorFormat((e) => `Failed to create filtered import manager: ${e}`)
+            .onSuccess((newImportManager) => {
+            // Create new ContextQualifierProvider for the filtered system
+            return Runtime.ValidatingSimpleContextQualifierProvider.create({
+                qualifiers: originalSystem.qualifiers
+            })
+                .withErrorFormat((e) => `Failed to create filtered context provider: ${e}`)
+                .onSuccess((newContextQualifierProvider) => {
+                // Build the new system object
+                const newSystem = {
+                    qualifierTypes: originalSystem.qualifierTypes,
+                    qualifiers: originalSystem.qualifiers,
+                    resourceTypes: originalSystem.resourceTypes,
+                    resourceManager: filteredManager,
+                    importManager: newImportManager,
+                    contextQualifierProvider: newContextQualifierProvider
+                };
+                // Get compiled collection from the filtered manager
+                return filteredManager
+                    .getCompiledResourceCollection({ includeMetadata: true })
+                    .withErrorFormat((e) => `Failed to get compiled collection: ${e}`)
+                    .onSuccess((compiledCollection) => {
+                    // Create resolver for the filtered system
+                    return Runtime.ResourceResolver.create({
+                        resourceManager: filteredManager,
+                        qualifierTypes: originalSystem.qualifierTypes,
+                        contextQualifierProvider: newContextQualifierProvider
+                    })
+                        .withErrorFormat((e) => `Failed to create resolver: ${e}`)
+                        .onSuccess((resolver) => {
+                        // Create summary
+                        const resourceIds = Array.from(filteredManager.resources.keys());
+                        const summary = {
+                            totalResources: resourceIds.length,
+                            resourceIds,
+                            errorCount: 0,
+                            warnings: []
+                        };
+                        const processedResources = {
+                            system: newSystem,
+                            compiledCollection,
+                            resolver,
+                            resourceCount: resourceIds.length,
+                            summary
+                        };
+                        debugLog(enableDebug, '=== FILTERED PROCESSING COMPLETE ===');
+                        debugLog(enableDebug, 'Filtered resource count:', resourceIds.length);
+                        debugLog(enableDebug, 'Filtered resource IDs:', resourceIds);
+                        return succeed(processedResources);
+                    });
+                });
+            });
+        });
+    })
+        .onFailure((error) => {
+        debugLog(enableDebug, 'Failed to create filtered resource manager:', error);
+        return fail(`Failed to create filtered resource manager: ${error}`);
+    });
+};
+/**
+ * Analyze filtered resources compared to original resources
+ */
+export function analyzeFilteredResources(originalResourceIds, filteredProcessedResources, originalProcessedResources) {
+    const filteredResources = [];
+    const warnings = [];
+    for (const resourceId of originalResourceIds) {
+        // Get original resource info
+        const originalResourceResult = originalProcessedResources.system.resourceManager.getBuiltResource(resourceId);
+        const originalCandidateCount = originalResourceResult.isSuccess()
+            ? originalResourceResult.value.candidates.length
+            : 0;
+        // Get filtered resource info
+        const filteredResourceResult = filteredProcessedResources.system.resourceManager.getBuiltResource(resourceId);
+        const filteredCandidateCount = filteredResourceResult.isSuccess()
+            ? filteredResourceResult.value.candidates.length
+            : 0;
+        const hasWarning = filteredCandidateCount === 0 && originalCandidateCount > 0;
+        if (hasWarning) {
+            warnings.push(`Resource ${resourceId} has no matching candidates after filtering`);
+        }
+        filteredResources.push({
+            id: resourceId,
+            originalCandidateCount,
+            filteredCandidateCount,
+            hasWarning
+        });
+    }
+    return {
+        success: true,
+        filteredResources,
+        processedResources: filteredProcessedResources,
+        warnings
+    };
+}
+//# sourceMappingURL=filterResources.js.map

package/lib/utils/filterResources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filterResources.js","sourceRoot":"","sources":["../../src/utils/filterResources.ts"],"names":[],"mappings":"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","sourcesContent":["import { Result, succeed, fail } from '@fgv/ts-utils';\nimport { Runtime, Import, Resources } from '@fgv/ts-res';\nimport { ProcessedResources } from '../types';\n\nexport interface FilterOptions {\n  partialContextMatch?: boolean;\n  enableDebugLogging?: boolean;\n  reduceQualifiers?: boolean;\n}\n\nexport interface FilteredResource {\n  id: string;\n  originalCandidateCount: number;\n  filteredCandidateCount: number;\n  hasWarning: boolean;\n}\n\nexport interface FilterResult {\n  success: boolean;\n  filteredResources: FilteredResource[];\n  processedResources?: ProcessedResources;\n  error?: string;\n  warnings: string[];\n}\n\n// Helper function for conditional debug logging\nconst debugLog = (enableDebug: boolean, ...args: unknown[]) => {\n  if (enableDebug) {\n    console.log(...args);\n  }\n};\n\n/**\n * Check if filter values object has any meaningful values\n */\nexport function hasFilterValues(values: Record<string, string | undefined>): boolean {\n  return Object.values(values).some((value) => value !== undefined && value !== '');\n}\n\n/**\n * Get a summary string of active filter values\n */\nexport function getFilterSummary(values: Record<string, string | undefined>): string {\n  const activeFilters = Object.entries(values)\n    .filter(([, value]) => value !== undefined && value !== '')\n    .map(([key, value]) => `${key}=${value}`);\n  return activeFilters.length > 0 ? activeFilters.join(', ') : 'No filters';\n}\n\n/**\n * Creates a filtered resource manager using the ResourceManagerBuilder.clone() method.\n * This is a simplified implementation that leverages the built-in filtering functionality.\n */\nexport const createFilteredResourceManagerSimple = async (\n  originalSystem: ProcessedResources['system'],\n  partialContext: Record<string, string | undefined>,\n  options: FilterOptions = { partialContextMatch: true }\n): Promise<Result<ProcessedResources>> => {\n  const enableDebug = options.enableDebugLogging === true;\n\n  debugLog(enableDebug, '=== SIMPLE FILTER CREATION ===');\n  debugLog(enableDebug, 'Original system:', originalSystem);\n  debugLog(enableDebug, 'Partial context:', partialContext);\n\n  // Validate the original system\n  if (!originalSystem?.resourceManager) {\n    return fail('Original system or resourceManager is undefined');\n  }\n\n  // Filter out undefined values from the context before processing\n  const filteredContext = Object.fromEntries(\n    Object.entries(partialContext).filter(([, value]) => value !== undefined)\n  ) as Record<string, string>;\n\n  // Try to use ResourceManagerBuilder.clone() for proper filtering first\n  debugLog(enableDebug, 'Using ResourceManagerBuilder for proper filtering');\n  debugLog(enableDebug, 'Validating context and cloning manager:', filteredContext);\n  const resourceManagerBuilder = originalSystem.resourceManager;\n\n  return resourceManagerBuilder\n    .validateContext(filteredContext)\n    .onSuccess((validatedContext) => {\n      debugLog(enableDebug, 'Context validated, creating clone with context:', validatedContext);\n      return resourceManagerBuilder.clone({\n        filterForContext: validatedContext,\n        reduceQualifiers: options.reduceQualifiers\n      });\n    })\n    .withErrorFormat((e) => `Failed to validate context or clone: ${e}`)\n    .onSuccess((filteredManager) => {\n      debugLog(enableDebug, 'Filtered manager created:', filteredManager);\n\n      // Create new ImportManager for the filtered system\n      return Import.ImportManager.create({\n        resources: filteredManager\n      })\n        .withErrorFormat((e) => `Failed to create filtered import manager: ${e}`)\n        .onSuccess((newImportManager) => {\n          // Create new ContextQualifierProvider for the filtered system\n          return Runtime.ValidatingSimpleContextQualifierProvider.create({\n            qualifiers: originalSystem.qualifiers\n          })\n            .withErrorFormat((e) => `Failed to create filtered context provider: ${e}`)\n            .onSuccess((newContextQualifierProvider) => {\n              // Build the new system object\n              const newSystem = {\n                qualifierTypes: originalSystem.qualifierTypes,\n                qualifiers: originalSystem.qualifiers,\n                resourceTypes: originalSystem.resourceTypes,\n                resourceManager: filteredManager,\n                importManager: newImportManager,\n                contextQualifierProvider: newContextQualifierProvider\n              };\n\n              // Get compiled collection from the filtered manager\n              return filteredManager\n                .getCompiledResourceCollection({ includeMetadata: true })\n                .withErrorFormat((e) => `Failed to get compiled collection: ${e}`)\n                .onSuccess((compiledCollection) => {\n                  // Create resolver for the filtered system\n                  return Runtime.ResourceResolver.create({\n                    resourceManager: filteredManager,\n                    qualifierTypes: originalSystem.qualifierTypes,\n                    contextQualifierProvider: newContextQualifierProvider\n                  })\n                    .withErrorFormat((e) => `Failed to create resolver: ${e}`)\n                    .onSuccess((resolver) => {\n                      // Create summary\n                      const resourceIds = Array.from(filteredManager.resources.keys());\n                      const summary = {\n                        totalResources: resourceIds.length,\n                        resourceIds,\n                        errorCount: 0,\n                        warnings: [] as string[]\n                      };\n\n                      const processedResources: ProcessedResources = {\n                        system: newSystem,\n                        compiledCollection,\n                        resolver,\n                        resourceCount: resourceIds.length,\n                        summary\n                      };\n\n                      debugLog(enableDebug, '=== FILTERED PROCESSING COMPLETE ===');\n                      debugLog(enableDebug, 'Filtered resource count:', resourceIds.length);\n                      debugLog(enableDebug, 'Filtered resource IDs:', resourceIds);\n\n                      return succeed(processedResources);\n                    });\n                });\n            });\n        });\n    })\n    .onFailure((error) => {\n      debugLog(enableDebug, 'Failed to create filtered resource manager:', error);\n      return fail(`Failed to create filtered resource manager: ${error}`);\n    });\n};\n\n/**\n * Analyze filtered resources compared to original resources\n */\nexport function analyzeFilteredResources(\n  originalResourceIds: string[],\n  filteredProcessedResources: ProcessedResources,\n  originalProcessedResources: ProcessedResources\n): FilterResult {\n  const filteredResources: FilteredResource[] = [];\n  const warnings: string[] = [];\n\n  for (const resourceId of originalResourceIds) {\n    // Get original resource info\n    const originalResourceResult =\n      originalProcessedResources.system.resourceManager.getBuiltResource(resourceId);\n    const originalCandidateCount = originalResourceResult.isSuccess()\n      ? originalResourceResult.value.candidates.length\n      : 0;\n\n    // Get filtered resource info\n    const filteredResourceResult =\n      filteredProcessedResources.system.resourceManager.getBuiltResource(resourceId);\n    const filteredCandidateCount = filteredResourceResult.isSuccess()\n      ? filteredResourceResult.value.candidates.length\n      : 0;\n\n    const hasWarning = filteredCandidateCount === 0 && originalCandidateCount > 0;\n    if (hasWarning) {\n      warnings.push(`Resource ${resourceId} has no matching candidates after filtering`);\n    }\n\n    filteredResources.push({\n      id: resourceId,\n      originalCandidateCount,\n      filteredCandidateCount,\n      hasWarning\n    });\n  }\n\n  return {\n    success: true,\n    filteredResources,\n    processedResources: filteredProcessedResources,\n    warnings\n  };\n}\n"]}

package/lib/utils/resolutionEditing.d.ts

@@ -0,0 +1,58 @@
+import { Result } from '@fgv/ts-utils';
+import { ResourceJson, Resources, Runtime } from '@fgv/ts-res';
+import { ProcessedResources, JsonValue } from '../types';
+export interface EditedResourceInfo {
+    resourceId: string;
+    originalValue: JsonValue;
+    editedValue: JsonValue;
+    timestamp: Date;
+}
+export interface EditValidationResult {
+    isValid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+/**
+ * Validates an edited resource JSON value
+ */
+export declare function validateEditedResource(editedValue: JsonValue): EditValidationResult;
+/**
+ * Computes a 3-way diff between base, resolved, and edited values to create minimal delta
+ * @param baseValue - The base/original value before resolution (if available)
+ * @param resolvedValue - The fully resolved/composed value shown to user
+ * @param editedValue - The value after user edits
+ * @returns A minimal delta object with only the changes, or null if no changes
+ */
+export declare function computeResourceDelta(baseValue: JsonValue | undefined, resolvedValue: JsonValue, editedValue: JsonValue): Result<JsonValue>;
+/**
+ * Creates candidate declarations for edited resources with proper delta handling
+ */
+export declare function createCandidateDeclarations(editedResources: Map<string, {
+    originalValue: JsonValue;
+    editedValue: JsonValue;
+    delta: JsonValue;
+}>, currentContext: Record<string, string>): ResourceJson.Json.ILooseResourceCandidateDecl[];
+/**
+ * Rebuilds the resource system with edited candidates using deltas
+ */
+export declare function rebuildSystemWithEdits(originalSystem: ProcessedResources['system'], editedResources: Map<string, {
+    originalValue: JsonValue;
+    editedValue: JsonValue;
+    delta: JsonValue;
+}>, currentContext: Record<string, string>): Promise<Result<ProcessedResources>>;
+/**
+ * Extracts the current resolution context from resolver state
+ */
+export declare function extractResolutionContext(resolver: Runtime.ResourceResolver, contextValues: Record<string, string>): Record<string, string>;
+/**
+ * Creates a collision detection key for tracking edit conflicts
+ */
+export declare function createEditCollisionKey(resourceId: string, context: Record<string, string>): string;
+/**
+ * Checks for potential edit conflicts with existing candidates
+ */
+export declare function checkEditConflicts(resourceManager: Resources.ResourceManagerBuilder | Runtime.IResourceManager, editedResources: Map<string, JsonValue>, currentContext: Record<string, string>): {
+    conflicts: string[];
+    warnings: string[];
+};
+//# sourceMappingURL=resolutionEditing.d.ts.map

package/lib/utils/resolutionEditing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolutionEditing.d.ts","sourceRoot":"","sources":["../../src/utils/resolutionEditing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAiB,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAG/D,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAEzD,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,SAAS,CAAC;IACzB,WAAW,EAAE,SAAS,CAAC;IACvB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,SAAS,GAAG,oBAAoB,CA6CnF;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,SAAS,GAAG,SAAS,EAChC,aAAa,EAAE,SAAS,EACxB,WAAW,EAAE,SAAS,GACrB,MAAM,CAAC,SAAS,CAAC,CAsCnB;AAoBD;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE;IAAE,aAAa,EAAE,SAAS,CAAC;IAAC,WAAW,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,CAAC,EACpG,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACrC,YAAY,CAAC,IAAI,CAAC,2BAA2B,EAAE,CAuCjD;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,cAAc,EAAE,kBAAkB,CAAC,QAAQ,CAAC,EAC5C,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE;IAAE,aAAa,EAAE,SAAS,CAAC;IAAC,WAAW,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,CAAC,EACpG,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACrC,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,CA2DrC;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,OAAO,CAAC,gBAAgB,EAClC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACpC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAWxB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAOlG;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,eAAe,EAAE,SAAS,CAAC,sBAAsB,GAAG,OAAO,CAAC,gBAAgB,EAC5E,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,EACvC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACrC;IAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CA2B7C"}

package/lib/utils/resolutionEditing.js

@@ -0,0 +1,246 @@
+import { succeed, fail } from '@fgv/ts-utils';
+import { Runtime } from '@fgv/ts-res';
+import { Diff } from '@fgv/ts-json';
+/**
+ * Validates an edited resource JSON value
+ */
+export function validateEditedResource(editedValue) {
+    const errors = [];
+    const warnings = [];
+    // Basic JSON validation
+    if (editedValue === null || editedValue === undefined) {
+        errors.push('Resource value cannot be null or undefined');
+    }
+    // Check if it's valid JSON-serializable
+    try {
+        JSON.stringify(editedValue);
+    }
+    catch (error) {
+        errors.push(`Invalid JSON: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    }
+    // Type-specific validation
+    if (typeof editedValue === 'object' && editedValue !== null) {
+        // Object validation - check for circular references
+        const seen = new Set();
+        const checkCircular = (obj) => {
+            if (seen.has(obj))
+                return true;
+            seen.add(obj);
+            if (typeof obj === 'object' && obj !== null) {
+                for (const key in obj) {
+                    const objTyped = obj;
+                    if (typeof objTyped[key] === 'object' && objTyped[key] !== null) {
+                        if (checkCircular(objTyped[key]))
+                            return true;
+                    }
+                }
+            }
+            seen.delete(obj);
+            return false;
+        };
+        if (checkCircular(editedValue)) {
+            errors.push('Resource contains circular references');
+        }
+    }
+    return {
+        isValid: errors.length === 0,
+        errors,
+        warnings
+    };
+}
+/**
+ * Computes a 3-way diff between base, resolved, and edited values to create minimal delta
+ * @param baseValue - The base/original value before resolution (if available)
+ * @param resolvedValue - The fully resolved/composed value shown to user
+ * @param editedValue - The value after user edits
+ * @returns A minimal delta object with only the changes, or null if no changes
+ */
+export function computeResourceDelta(baseValue, resolvedValue, editedValue) {
+    // Use ts-json's three-way diff for proper delta computation
+    const diffResult = Diff.jsonThreeWayDiff(resolvedValue, editedValue);
+    if (diffResult.isFailure()) {
+        // Fall back to full replacement on diff failure
+        console.error('Failed to compute three-way diff:', diffResult.message);
+        return succeed(editedValue);
+    }
+    const diff = diffResult.value;
+    // If identical, no changes needed
+    if (diff.identical) {
+        return succeed(null);
+    }
+    // Build a proper delta that includes deletions as null values
+    const delta = {};
+    // Add all changes/additions from onlyInB
+    if (diff.onlyInB !== null) {
+        Object.assign(delta, diff.onlyInB);
+    }
+    // Add deletions as null values from onlyInA
+    // onlyInA contains properties that existed in resolved but not in edited
+    if (diff.onlyInA !== null) {
+        // Add null entries for all deleted properties
+        addDeletionsAsNull(diff.onlyInA, delta);
+    }
+    // If delta is empty, no changes
+    if (Object.keys(delta).length === 0) {
+        return succeed(null);
+    }
+    return succeed(delta);
+}
+/**
+ * Recursively adds null values to delta for all properties in the deleted object
+ */
+function addDeletionsAsNull(deleted, delta) {
+    if (typeof deleted === 'object' && deleted !== null && !Array.isArray(deleted)) {
+        const deletedObj = deleted;
+        for (const key in deletedObj) {
+            if (deletedObj.hasOwnProperty(key)) {
+                // If this key already exists in delta (from onlyInB), it means the property
+                // was modified, not deleted, so don't override with null
+                if (!(key in delta)) {
+                    delta[key] = null;
+                }
+            }
+        }
+    }
+}
+/**
+ * Creates candidate declarations for edited resources with proper delta handling
+ */
+export function createCandidateDeclarations(editedResources, currentContext) {
+    const declarations = [];
+    for (const [resourceId, resourceEdit] of editedResources.entries()) {
+        // Create conditions from current context (using array format)
+        const conditions = [];
+        for (const [qualifierName, qualifierValue] of Object.entries(currentContext)) {
+            if (qualifierValue && qualifierValue.trim() !== '') {
+                conditions.push({
+                    qualifierName,
+                    operator: 'matches',
+                    value: qualifierValue,
+                    priority: 900 // High priority for user edits
+                });
+            }
+        }
+        // Always use the delta if we have one (which should be the minimal changes)
+        // The delta will be null if there are no changes, or the delta itself if there are changes
+        const hasChanges = resourceEdit.delta !== null && resourceEdit.delta !== undefined;
+        if (!hasChanges) {
+            // No changes, skip this resource
+            continue;
+        }
+        // Always save as partial with just the delta when we have changes
+        // This ensures minimal, clean resource files
+        declarations.push({
+            id: resourceId,
+            conditions: conditions.length > 0 ? conditions : undefined,
+            json: resourceEdit.delta, // Always use the delta (minimal changes only)
+            isPartial: true, // Always partial when saving deltas
+            mergeMethod: 'augment' // Always augment to merge the delta with base
+        });
+    }
+    return declarations;
+}
+/**
+ * Rebuilds the resource system with edited candidates using deltas
+ */
+export async function rebuildSystemWithEdits(originalSystem, editedResources, currentContext) {
+    try {
+        const candidateDeclarations = createCandidateDeclarations(editedResources, currentContext);
+        const clonedManager = originalSystem.resourceManager.clone({
+            candidates: candidateDeclarations
+        });
+        if (clonedManager.isFailure()) {
+            return fail(`Failed to clone manager: ${clonedManager.message}`);
+        }
+        // Get compiled collection from the updated manager
+        const compiledResult = clonedManager.value.getCompiledResourceCollection({ includeMetadata: true });
+        if (compiledResult.isFailure()) {
+            return fail(`Failed to get compiled collection: ${compiledResult.message}`);
+        }
+        // Create resolver for the updated system
+        const resolverResult = Runtime.ResourceResolver.create({
+            resourceManager: clonedManager.value,
+            qualifierTypes: originalSystem.qualifierTypes,
+            contextQualifierProvider: originalSystem.contextQualifierProvider
+        });
+        if (resolverResult.isFailure()) {
+            return fail(`Failed to create resolver: ${resolverResult.message}`);
+        }
+        // Create summary
+        const resourceIds = Array.from(clonedManager.value.resources.keys());
+        const summary = {
+            totalResources: resourceIds.length,
+            resourceIds,
+            errorCount: 0,
+            warnings: []
+        };
+        const updatedSystem = {
+            system: {
+                qualifierTypes: originalSystem.qualifierTypes,
+                qualifiers: originalSystem.qualifiers,
+                resourceTypes: originalSystem.resourceTypes,
+                resourceManager: clonedManager.value,
+                importManager: originalSystem.importManager,
+                contextQualifierProvider: originalSystem.contextQualifierProvider
+            },
+            compiledCollection: compiledResult.value,
+            resolver: resolverResult.value,
+            resourceCount: resourceIds.length,
+            summary
+        };
+        return succeed(updatedSystem);
+    }
+    catch (error) {
+        return fail(`Failed to rebuild system with edits: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Extracts the current resolution context from resolver state
+ */
+export function extractResolutionContext(resolver, contextValues) {
+    // Filter out empty/undefined context values
+    const cleanContext = {};
+    for (const [key, value] of Object.entries(contextValues)) {
+        if (value && value.trim() !== '') {
+            cleanContext[key] = value.trim();
+        }
+    }
+    return cleanContext;
+}
+/**
+ * Creates a collision detection key for tracking edit conflicts
+ */
+export function createEditCollisionKey(resourceId, context) {
+    const contextEntries = Object.entries(context)
+        .sort(([a], [b]) => a.localeCompare(b))
+        .map(([key, value]) => `${key}=${value}`)
+        .join('&');
+    return `${resourceId}?${contextEntries}`;
+}
+/**
+ * Checks for potential edit conflicts with existing candidates
+ */
+export function checkEditConflicts(resourceManager, editedResources, currentContext) {
+    const conflicts = [];
+    const warnings = [];
+    for (const [resourceId] of editedResources) {
+        try {
+            // Get the current resource to check for conflicts
+            const resourceResult = resourceManager.getBuiltResource(resourceId);
+            if (resourceResult.isSuccess()) {
+                const resource = resourceResult.value;
+                // Check if we're likely to create a conflict
+                if (resource.candidates.length > 1) {
+                    warnings.push(`Resource ${resourceId} has ${resource.candidates.length} candidates - edits may create conflicts`);
+                }
+                // Could add more sophisticated conflict detection here
+                // based on condition overlap analysis
+            }
+        }
+        catch (error) {
+            // Ignore errors in conflict checking
+        }
+    }
+    return { conflicts, warnings };
+}
+//# sourceMappingURL=resolutionEditing.js.map

package/lib/utils/resolutionEditing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolutionEditing.js","sourceRoot":"","sources":["../../src/utils/resolutionEditing.ts"],"names":[],"mappings":"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","sourcesContent":["import { Result, succeed, fail } from '@fgv/ts-utils';\nimport { ResourceJson, Resources, Runtime } from '@fgv/ts-res';\nimport { Diff } from '@fgv/ts-json';\nimport { JsonObject } from '@fgv/ts-json-base';\nimport { ProcessedResources, JsonValue } from '../types';\n\nexport interface EditedResourceInfo {\n  resourceId: string;\n  originalValue: JsonValue;\n  editedValue: JsonValue;\n  timestamp: Date;\n}\n\nexport interface EditValidationResult {\n  isValid: boolean;\n  errors: string[];\n  warnings: string[];\n}\n\n/**\n * Validates an edited resource JSON value\n */\nexport function validateEditedResource(editedValue: JsonValue): EditValidationResult {\n  const errors: string[] = [];\n  const warnings: string[] = [];\n\n  // Basic JSON validation\n  if (editedValue === null || editedValue === undefined) {\n    errors.push('Resource value cannot be null or undefined');\n  }\n\n  // Check if it's valid JSON-serializable\n  try {\n    JSON.stringify(editedValue);\n  } catch (error) {\n    errors.push(`Invalid JSON: ${error instanceof Error ? error.message : 'Unknown error'}`);\n  }\n\n  // Type-specific validation\n  if (typeof editedValue === 'object' && editedValue !== null) {\n    // Object validation - check for circular references\n    const seen = new Set<unknown>();\n    const checkCircular = (obj: unknown): boolean => {\n      if (seen.has(obj)) return true;\n      seen.add(obj);\n      if (typeof obj === 'object' && obj !== null) {\n        for (const key in obj as Record<string, unknown>) {\n          const objTyped = obj as Record<string, unknown>;\n          if (typeof objTyped[key] === 'object' && objTyped[key] !== null) {\n            if (checkCircular(objTyped[key])) return true;\n          }\n        }\n      }\n      seen.delete(obj);\n      return false;\n    };\n\n    if (checkCircular(editedValue)) {\n      errors.push('Resource contains circular references');\n    }\n  }\n\n  return {\n    isValid: errors.length === 0,\n    errors,\n    warnings\n  };\n}\n\n/**\n * Computes a 3-way diff between base, resolved, and edited values to create minimal delta\n * @param baseValue - The base/original value before resolution (if available)\n * @param resolvedValue - The fully resolved/composed value shown to user\n * @param editedValue - The value after user edits\n * @returns A minimal delta object with only the changes, or null if no changes\n */\nexport function computeResourceDelta(\n  baseValue: JsonValue | undefined,\n  resolvedValue: JsonValue,\n  editedValue: JsonValue\n): Result<JsonValue> {\n  // Use ts-json's three-way diff for proper delta computation\n  const diffResult = Diff.jsonThreeWayDiff(resolvedValue, editedValue);\n\n  if (diffResult.isFailure()) {\n    // Fall back to full replacement on diff failure\n    console.error('Failed to compute three-way diff:', diffResult.message);\n    return succeed(editedValue);\n  }\n\n  const diff = diffResult.value;\n\n  // If identical, no changes needed\n  if (diff.identical) {\n    return succeed(null);\n  }\n\n  // Build a proper delta that includes deletions as null values\n  const delta: Record<string, JsonValue> = {};\n\n  // Add all changes/additions from onlyInB\n  if (diff.onlyInB !== null) {\n    Object.assign(delta, diff.onlyInB);\n  }\n\n  // Add deletions as null values from onlyInA\n  // onlyInA contains properties that existed in resolved but not in edited\n  if (diff.onlyInA !== null) {\n    // Add null entries for all deleted properties\n    addDeletionsAsNull(diff.onlyInA, delta);\n  }\n\n  // If delta is empty, no changes\n  if (Object.keys(delta).length === 0) {\n    return succeed(null);\n  }\n\n  return succeed(delta);\n}\n\n/**\n * Recursively adds null values to delta for all properties in the deleted object\n */\nfunction addDeletionsAsNull(deleted: JsonValue, delta: Record<string, JsonValue>): void {\n  if (typeof deleted === 'object' && deleted !== null && !Array.isArray(deleted)) {\n    const deletedObj = deleted as Record<string, JsonValue>;\n    for (const key in deletedObj) {\n      if (deletedObj.hasOwnProperty(key)) {\n        // If this key already exists in delta (from onlyInB), it means the property\n        // was modified, not deleted, so don't override with null\n        if (!(key in delta)) {\n          delta[key] = null;\n        }\n      }\n    }\n  }\n}\n\n/**\n * Creates candidate declarations for edited resources with proper delta handling\n */\nexport function createCandidateDeclarations(\n  editedResources: Map<string, { originalValue: JsonValue; editedValue: JsonValue; delta: JsonValue }>,\n  currentContext: Record<string, string>\n): ResourceJson.Json.ILooseResourceCandidateDecl[] {\n  const declarations: ResourceJson.Json.ILooseResourceCandidateDecl[] = [];\n\n  for (const [resourceId, resourceEdit] of editedResources.entries()) {\n    // Create conditions from current context (using array format)\n    const conditions: ResourceJson.Json.ILooseConditionDecl[] = [];\n\n    for (const [qualifierName, qualifierValue] of Object.entries(currentContext)) {\n      if (qualifierValue && qualifierValue.trim() !== '') {\n        conditions.push({\n          qualifierName,\n          operator: 'matches',\n          value: qualifierValue,\n          priority: 900 // High priority for user edits\n        });\n      }\n    }\n\n    // Always use the delta if we have one (which should be the minimal changes)\n    // The delta will be null if there are no changes, or the delta itself if there are changes\n    const hasChanges = resourceEdit.delta !== null && resourceEdit.delta !== undefined;\n\n    if (!hasChanges) {\n      // No changes, skip this resource\n      continue;\n    }\n\n    // Always save as partial with just the delta when we have changes\n    // This ensures minimal, clean resource files\n    declarations.push({\n      id: resourceId,\n      conditions: conditions.length > 0 ? conditions : undefined,\n      json: resourceEdit.delta as JsonObject, // Always use the delta (minimal changes only)\n      isPartial: true, // Always partial when saving deltas\n      mergeMethod: 'augment' // Always augment to merge the delta with base\n    });\n  }\n\n  return declarations;\n}\n\n/**\n * Rebuilds the resource system with edited candidates using deltas\n */\nexport async function rebuildSystemWithEdits(\n  originalSystem: ProcessedResources['system'],\n  editedResources: Map<string, { originalValue: JsonValue; editedValue: JsonValue; delta: JsonValue }>,\n  currentContext: Record<string, string>\n): Promise<Result<ProcessedResources>> {\n  try {\n    const candidateDeclarations = createCandidateDeclarations(editedResources, currentContext);\n\n    const clonedManager = originalSystem.resourceManager.clone({\n      candidates: candidateDeclarations\n    });\n\n    if (clonedManager.isFailure()) {\n      return fail(`Failed to clone manager: ${clonedManager.message}`);\n    }\n\n    // Get compiled collection from the updated manager\n    const compiledResult = clonedManager.value.getCompiledResourceCollection({ includeMetadata: true });\n    if (compiledResult.isFailure()) {\n      return fail(`Failed to get compiled collection: ${compiledResult.message}`);\n    }\n\n    // Create resolver for the updated system\n    const resolverResult = Runtime.ResourceResolver.create({\n      resourceManager: clonedManager.value,\n      qualifierTypes: originalSystem.qualifierTypes,\n      contextQualifierProvider: originalSystem.contextQualifierProvider\n    });\n\n    if (resolverResult.isFailure()) {\n      return fail(`Failed to create resolver: ${resolverResult.message}`);\n    }\n\n    // Create summary\n    const resourceIds = Array.from(clonedManager.value.resources.keys());\n    const summary = {\n      totalResources: resourceIds.length,\n      resourceIds,\n      errorCount: 0,\n      warnings: []\n    };\n\n    const updatedSystem: ProcessedResources = {\n      system: {\n        qualifierTypes: originalSystem.qualifierTypes,\n        qualifiers: originalSystem.qualifiers,\n        resourceTypes: originalSystem.resourceTypes,\n        resourceManager: clonedManager.value,\n        importManager: originalSystem.importManager,\n        contextQualifierProvider: originalSystem.contextQualifierProvider\n      },\n      compiledCollection: compiledResult.value,\n      resolver: resolverResult.value,\n      resourceCount: resourceIds.length,\n      summary\n    };\n\n    return succeed(updatedSystem);\n  } catch (error) {\n    return fail(\n      `Failed to rebuild system with edits: ${error instanceof Error ? error.message : String(error)}`\n    );\n  }\n}\n\n/**\n * Extracts the current resolution context from resolver state\n */\nexport function extractResolutionContext(\n  resolver: Runtime.ResourceResolver,\n  contextValues: Record<string, string>\n): Record<string, string> {\n  // Filter out empty/undefined context values\n  const cleanContext: Record<string, string> = {};\n\n  for (const [key, value] of Object.entries(contextValues)) {\n    if (value && value.trim() !== '') {\n      cleanContext[key] = value.trim();\n    }\n  }\n\n  return cleanContext;\n}\n\n/**\n * Creates a collision detection key for tracking edit conflicts\n */\nexport function createEditCollisionKey(resourceId: string, context: Record<string, string>): string {\n  const contextEntries = Object.entries(context)\n    .sort(([a], [b]) => a.localeCompare(b))\n    .map(([key, value]) => `${key}=${value}`)\n    .join('&');\n\n  return `${resourceId}?${contextEntries}`;\n}\n\n/**\n * Checks for potential edit conflicts with existing candidates\n */\nexport function checkEditConflicts(\n  resourceManager: Resources.ResourceManagerBuilder | Runtime.IResourceManager,\n  editedResources: Map<string, JsonValue>,\n  currentContext: Record<string, string>\n): { conflicts: string[]; warnings: string[] } {\n  const conflicts: string[] = [];\n  const warnings: string[] = [];\n\n  for (const [resourceId] of editedResources) {\n    try {\n      // Get the current resource to check for conflicts\n      const resourceResult = resourceManager.getBuiltResource(resourceId);\n      if (resourceResult.isSuccess()) {\n        const resource = resourceResult.value;\n\n        // Check if we're likely to create a conflict\n        if (resource.candidates.length > 1) {\n          warnings.push(\n            `Resource ${resourceId} has ${resource.candidates.length} candidates - edits may create conflicts`\n          );\n        }\n\n        // Could add more sophisticated conflict detection here\n        // based on condition overlap analysis\n      }\n    } catch (error) {\n      // Ignore errors in conflict checking\n    }\n  }\n\n  return { conflicts, warnings };\n}\n"]}

package/lib/utils/resolutionUtils.d.ts

@@ -0,0 +1,28 @@
+import { Result } from '@fgv/ts-utils';
+import { Runtime } from '@fgv/ts-res';
+import { ProcessedResources, ResolutionResult, ConditionEvaluationResult } from '../types';
+export interface ResolutionOptions {
+    enableCaching?: boolean;
+    enableDebugLogging?: boolean;
+}
+/**
+ * Create a resolver with context for resource resolution
+ */
+export declare function createResolverWithContext(processedResources: ProcessedResources, contextValues: Record<string, string | undefined>, options?: ResolutionOptions): Result<Runtime.ResourceResolver>;
+/**
+ * Evaluate conditions for a specific candidate
+ */
+export declare function evaluateConditionsForCandidate(resolver: Runtime.ResourceResolver, candidateIndex: number, compiledResource: any, compiledCollection: any): ConditionEvaluationResult[];
+/**
+ * Resolve a resource and create detailed resolution result
+ */
+export declare function resolveResourceDetailed(resolver: Runtime.ResourceResolver, resourceId: string, processedResources: ProcessedResources, options?: ResolutionOptions): Result<ResolutionResult>;
+/**
+ * Get available qualifiers from processed resources
+ */
+export declare function getAvailableQualifiers(processedResources: ProcessedResources): string[];
+/**
+ * Check if context has any pending changes
+ */
+export declare function hasPendingContextChanges(contextValues: Record<string, string | undefined>, pendingContextValues: Record<string, string | undefined>): boolean;
+//# sourceMappingURL=resolutionUtils.d.ts.map

package/lib/utils/resolutionUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolutionUtils.d.ts","sourceRoot":"","sources":["../../src/utils/resolutionUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAoC,MAAM,eAAe,CAAC;AACzE,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAiB,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAE1G,MAAM,WAAW,iBAAiB;IAChC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AASD;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,kBAAkB,EAAE,kBAAkB,EACtC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EACjD,OAAO,GAAE,iBAAsB,GAC9B,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAmDlC;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,OAAO,CAAC,gBAAgB,EAClC,cAAc,EAAE,MAAM,EACtB,gBAAgB,EAAE,GAAG,EACrB,kBAAkB,EAAE,GAAG,GACtB,yBAAyB,EAAE,CAkD7B;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,OAAO,CAAC,gBAAgB,EAClC,UAAU,EAAE,MAAM,EAClB,kBAAkB,EAAE,kBAAkB,EACtC,OAAO,GAAE,iBAAsB,GAC9B,MAAM,CAAC,gBAAgB,CAAC,CA4H1B;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,kBAAkB,EAAE,kBAAkB,GAAG,MAAM,EAAE,CAKvF;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EACjD,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GACvD,OAAO,CAET"}