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

package/lib/utils/resolutionUtils.js

@@ -0,0 +1,216 @@
+import { succeed, fail, MessageAggregator } from '@fgv/ts-utils';
+import { Runtime } from '@fgv/ts-res';
+// Helper function for conditional debug logging
+const debugLog = (enableDebug, ...args) => {
+    if (enableDebug) {
+        console.log(...args);
+    }
+};
+/**
+ * Create a resolver with context for resource resolution
+ */
+export function createResolverWithContext(processedResources, contextValues, options = {}) {
+    const enableDebug = options.enableDebugLogging === true;
+    debugLog(enableDebug, '=== CREATING RESOLVER WITH CONTEXT ===');
+    debugLog(enableDebug, 'Context values:', contextValues);
+    // Create context provider with filtered values (remove undefined)
+    const filteredContext = Object.fromEntries(Object.entries(contextValues).filter(([, value]) => value !== undefined));
+    return Runtime.ValidatingSimpleContextQualifierProvider.create({
+        qualifiers: processedResources.system.qualifiers
+    })
+        .withErrorFormat((e) => `Failed to create context provider: ${e}`)
+        .onSuccess((contextProvider) => {
+        const errors = new MessageAggregator();
+        // Set context values
+        for (const [qualifierName, value] of Object.entries(filteredContext)) {
+            contextProvider.validating
+                .set(qualifierName, value)
+                .withErrorFormat((e) => `Failed to set context value ${qualifierName}=${value}: ${e}`)
+                .aggregateError(errors);
+        }
+        if (errors.hasMessages) {
+            return fail(`Errors setting context values: ${errors.toString()}`);
+        }
+        // Create resolver
+        const resolverParams = {
+            resourceManager: processedResources.system.resourceManager,
+            qualifierTypes: processedResources.system.qualifierTypes,
+            contextQualifierProvider: contextProvider
+        };
+        // Add cache metrics listener if caching is enabled
+        if (options.enableCaching) {
+            const metricsListener = new Runtime.ResourceResolverCacheMetricsListener(() => new Runtime.AggregateCacheMetrics());
+            resolverParams.listener = metricsListener;
+        }
+        return Runtime.ResourceResolver.create(resolverParams)
+            .withErrorFormat((e) => `Failed to create resolver: ${e}`)
+            .onSuccess((resolver) => {
+            debugLog(enableDebug, 'Resolver created successfully');
+            return succeed(resolver);
+        });
+    });
+}
+/**
+ * Evaluate conditions for a specific candidate
+ */
+export function evaluateConditionsForCandidate(resolver, candidateIndex, compiledResource, compiledCollection) {
+    try {
+        const decision = compiledCollection.decisions[compiledResource.decision];
+        if (!decision || !decision.conditionSets || candidateIndex >= decision.conditionSets.length) {
+            return [];
+        }
+        const conditionSetIndex = decision.conditionSets[candidateIndex];
+        const conditionSet = compiledCollection.conditionSets[conditionSetIndex];
+        if (!conditionSet || !conditionSet.conditions) {
+            return [];
+        }
+        const evaluations = [];
+        for (const conditionIndex of conditionSet.conditions) {
+            const condition = compiledCollection.conditions[conditionIndex];
+            if (!condition)
+                continue;
+            const qualifier = compiledCollection.qualifiers[condition.qualifierIndex];
+            if (!qualifier)
+                continue;
+            // Get the qualifier value from context
+            const qualifierValueResult = resolver.contextQualifierProvider.get(qualifier);
+            const qualifierValue = qualifierValueResult.orDefault();
+            // Get the cached condition result from resolver (if available)
+            const cachedResult = resolver.conditionCache?.[conditionIndex];
+            const score = cachedResult?.score || 0;
+            const matchType = cachedResult?.matchType || 'noMatch';
+            const matched = matchType !== 'noMatch';
+            evaluations.push({
+                qualifierName: qualifier.name,
+                qualifierValue,
+                conditionValue: condition.value,
+                operator: condition.operator || 'matches',
+                score,
+                matched,
+                matchType,
+                scoreAsDefault: condition.scoreAsDefault,
+                conditionIndex
+            });
+        }
+        return evaluations;
+    }
+    catch (error) {
+        console.warn('Error evaluating conditions for candidate:', error);
+        return [];
+    }
+}
+/**
+ * Resolve a resource and create detailed resolution result
+ */
+export function resolveResourceDetailed(resolver, resourceId, processedResources, options = {}) {
+    const enableDebug = options.enableDebugLogging === true;
+    debugLog(enableDebug, '=== RESOLVING RESOURCE ===');
+    debugLog(enableDebug, 'Resource ID:', resourceId);
+    const resourceResult = processedResources.system.resourceManager.getBuiltResource(resourceId);
+    if (resourceResult.isFailure()) {
+        return succeed({
+            success: false,
+            resourceId,
+            error: `Failed to get resource: ${resourceResult.message}`
+        });
+    }
+    const resource = resourceResult.value;
+    const compiledCollection = processedResources.compiledCollection;
+    // Find the compiled resource for condition analysis
+    const compiledResource = compiledCollection.resources.find((r) => r.id === resourceId);
+    if (!compiledResource) {
+        return succeed({
+            success: false,
+            resourceId,
+            error: 'Failed to find compiled resource'
+        });
+    }
+    // Resolve best candidate
+    const bestResult = resolver.resolveResource(resource);
+    // Resolve all candidates
+    const allResult = resolver.resolveAllResourceCandidates(resource);
+    // Resolve composed value
+    const composedResult = resolver.resolveComposedResourceValue(resource);
+    // Get decision resolution result
+    const decisionResult = resolver.resolveDecision(resource.decision.baseDecision);
+    if (decisionResult.isFailure()) {
+        return succeed({
+            success: false,
+            resourceId,
+            error: `Failed to resolve decision: ${decisionResult.message}`
+        });
+    }
+    const decision = decisionResult.value;
+    // Build detailed candidate information
+    const candidateDetails = [];
+    const matchedCandidates = allResult.isSuccess() ? allResult.value : [];
+    // Create lookup sets for regular and default matches
+    const regularMatchIndices = new Set(decision?.success ? decision.instanceIndices : []);
+    const defaultMatchIndices = new Set(decision?.success ? decision.defaultInstanceIndices : []);
+    // Add matched candidates first
+    matchedCandidates.forEach((matchedCandidate) => {
+        const index = resource.candidates.findIndex((candidate) => candidate === matchedCandidate);
+        if (index !== -1) {
+            const conditionSetKey = `cs-${index}`;
+            const conditionEvaluations = evaluateConditionsForCandidate(resolver, index, compiledResource, compiledCollection);
+            const isDefaultMatch = defaultMatchIndices.has(index);
+            const isRegularMatch = regularMatchIndices.has(index);
+            const candidateMatchType = isRegularMatch ? 'match' : isDefaultMatch ? 'matchAsDefault' : 'noMatch';
+            candidateDetails.push({
+                candidate: resource.candidates[index],
+                conditionSetKey,
+                candidateIndex: index,
+                matched: true,
+                matchType: candidateMatchType,
+                isDefaultMatch,
+                conditionEvaluations
+            });
+        }
+    });
+    // Add non-matching candidates
+    resource.candidates.forEach((candidate, index) => {
+        const isMatched = matchedCandidates.some((mc) => mc === candidate);
+        if (!isMatched) {
+            // Handle different candidate formats - IResourceCandidate doesn't have conditions
+            const conditionSetKey = candidate.conditions?.toHash ? candidate.conditions.toHash() : `cs-${index}`;
+            const conditionEvaluations = evaluateConditionsForCandidate(resolver, index, compiledResource, compiledCollection);
+            candidateDetails.push({
+                candidate,
+                conditionSetKey,
+                candidateIndex: index,
+                matched: false,
+                matchType: 'noMatch',
+                isDefaultMatch: false,
+                conditionEvaluations
+            });
+        }
+    });
+    const result = {
+        success: true,
+        resourceId,
+        resource,
+        bestCandidate: bestResult.isSuccess() ? bestResult.value : undefined,
+        allCandidates: allResult.isSuccess() ? allResult.value : undefined,
+        candidateDetails,
+        composedValue: composedResult.isSuccess() ? composedResult.value : undefined,
+        error: bestResult.isFailure() ? bestResult.message : undefined
+    };
+    debugLog(enableDebug, 'Resolution completed successfully');
+    return succeed(result);
+}
+/**
+ * Get available qualifiers from processed resources
+ */
+export function getAvailableQualifiers(processedResources) {
+    if (processedResources.compiledCollection.qualifiers) {
+        return processedResources.compiledCollection.qualifiers.map((q) => q.name);
+    }
+    return [];
+}
+/**
+ * Check if context has any pending changes
+ */
+export function hasPendingContextChanges(contextValues, pendingContextValues) {
+    return JSON.stringify(contextValues) !== JSON.stringify(pendingContextValues);
+}
+//# sourceMappingURL=resolutionUtils.js.map

package/lib/utils/resolutionUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolutionUtils.js","sourceRoot":"","sources":["../../src/utils/resolutionUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACzE,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAQtC,gDAAgD;AAChD,MAAM,QAAQ,GAAG,CAAC,WAAoB,EAAE,GAAG,IAAW,EAAE,EAAE;IACxD,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;IACvB,CAAC;AACH,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,yBAAyB,CACvC,kBAAsC,EACtC,aAAiD,EACjD,UAA6B,EAAE;IAE/B,MAAM,WAAW,GAAG,OAAO,CAAC,kBAAkB,KAAK,IAAI,CAAC;IAExD,QAAQ,CAAC,WAAW,EAAE,wCAAwC,CAAC,CAAC;IAChE,QAAQ,CAAC,WAAW,EAAE,iBAAiB,EAAE,aAAa,CAAC,CAAC;IAExD,kEAAkE;IAClE,MAAM,eAAe,GAAG,MAAM,CAAC,WAAW,CACxC,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CAC/C,CAAC;IAE5B,OAAO,OAAO,CAAC,wCAAwC,CAAC,MAAM,CAAC;QAC7D,UAAU,EAAE,kBAAkB,CAAC,MAAM,CAAC,UAAU;KACjD,CAAC;SACC,eAAe,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,sCAAsC,CAAC,EAAE,CAAC;SACjE,SAAS,CAAC,CAAC,eAAe,EAAE,EAAE;QAC7B,MAAM,MAAM,GAAG,IAAI,iBAAiB,EAAE,CAAC;QACvC,qBAAqB;QACrB,KAAK,MAAM,CAAC,aAAa,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC;YACrE,eAAe,CAAC,UAAU;iBACvB,GAAG,CAAC,aAAa,EAAE,KAAK,CAAC;iBACzB,eAAe,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,+BAA+B,aAAa,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;iBACrF,cAAc,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC;QAED,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC,kCAAkC,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QACrE,CAAC;QAED,kBAAkB;QAClB,MAAM,cAAc,GAAQ;YAC1B,eAAe,EAAE,kBAAkB,CAAC,MAAM,CAAC,eAAe;YAC1D,cAAc,EAAE,kBAAkB,CAAC,MAAM,CAAC,cAAc;YACxD,wBAAwB,EAAE,eAAe;SAC1C,CAAC;QAEF,mDAAmD;QACnD,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;YAC1B,MAAM,eAAe,GAAG,IAAI,OAAO,CAAC,oCAAoC,CACtE,GAAG,EAAE,CAAC,IAAI,OAAO,CAAC,qBAAqB,EAAE,CAC1C,CAAC;YACF,cAAc,CAAC,QAAQ,GAAG,eAAe,CAAC;QAC5C,CAAC;QAED,OAAO,OAAO,CAAC,gBAAgB,CAAC,MAAM,CAAC,cAAc,CAAC;aACnD,eAAe,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,8BAA8B,CAAC,EAAE,CAAC;aACzD,SAAS,CAAC,CAAC,QAAQ,EAAE,EAAE;YACtB,QAAQ,CAAC,WAAW,EAAE,+BAA+B,CAAC,CAAC;YACvD,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC3B,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;AACP,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,8BAA8B,CAC5C,QAAkC,EAClC,cAAsB,EACtB,gBAAqB,EACrB,kBAAuB;IAEvB,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,kBAAkB,CAAC,SAAS,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QACzE,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,CAAC,aAAa,IAAI,cAAc,IAAI,QAAQ,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC;YAC5F,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,iBAAiB,GAAG,QAAQ,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC;QACjE,MAAM,YAAY,GAAG,kBAAkB,CAAC,aAAa,CAAC,iBAAiB,CAAC,CAAC;QACzE,IAAI,CAAC,YAAY,IAAI,CAAC,YAAY,CAAC,UAAU,EAAE,CAAC;YAC9C,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,WAAW,GAAgC,EAAE,CAAC;QAEpD,KAAK,MAAM,cAAc,IAAI,YAAY,CAAC,UAAU,EAAE,CAAC;YACrD,MAAM,SAAS,GAAG,kBAAkB,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;YAChE,IAAI,CAAC,SAAS;gBAAE,SAAS;YAEzB,MAAM,SAAS,GAAG,kBAAkB,CAAC,UAAU,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;YAC1E,IAAI,CAAC,SAAS;gBAAE,SAAS;YAEzB,uCAAuC;YACvC,MAAM,oBAAoB,GAAG,QAAQ,CAAC,wBAAwB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAC9E,MAAM,cAAc,GAAG,oBAAoB,CAAC,SAAS,EAAE,CAAC;YAExD,+DAA+D;YAC/D,MAAM,YAAY,GAAG,QAAQ,CAAC,cAAc,EAAE,CAAC,cAAc,CAAC,CAAC;YAC/D,MAAM,KAAK,GAAG,YAAY,EAAE,KAAK,IAAI,CAAC,CAAC;YACvC,MAAM,SAAS,GAAG,YAAY,EAAE,SAAS,IAAI,SAAS,CAAC;YACvD,MAAM,OAAO,GAAG,SAAS,KAAK,SAAS,CAAC;YAExC,WAAW,CAAC,IAAI,CAAC;gBACf,aAAa,EAAE,SAAS,CAAC,IAAI;gBAC7B,cAAc;gBACd,cAAc,EAAE,SAAS,CAAC,KAAK;gBAC/B,QAAQ,EAAE,SAAS,CAAC,QAAQ,IAAI,SAAS;gBACzC,KAAK;gBACL,OAAO;gBACP,SAAS;gBACT,cAAc,EAAE,SAAS,CAAC,cAAc;gBACxC,cAAc;aACf,CAAC,CAAC;QACL,CAAC;QAED,OAAO,WAAW,CAAC;IACrB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,4CAA4C,EAAE,KAAK,CAAC,CAAC;QAClE,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CACrC,QAAkC,EAClC,UAAkB,EAClB,kBAAsC,EACtC,UAA6B,EAAE;IAE/B,MAAM,WAAW,GAAG,OAAO,CAAC,kBAAkB,KAAK,IAAI,CAAC;IAExD,QAAQ,CAAC,WAAW,EAAE,4BAA4B,CAAC,CAAC;IACpD,QAAQ,CAAC,WAAW,EAAE,cAAc,EAAE,UAAU,CAAC,CAAC;IAElD,MAAM,cAAc,GAAG,kBAAkB,CAAC,MAAM,CAAC,eAAe,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAC9F,IAAI,cAAc,CAAC,SAAS,EAAE,EAAE,CAAC;QAC/B,OAAO,OAAO,CAAC;YACb,OAAO,EAAE,KAAK;YACd,UAAU;YACV,KAAK,EAAE,2BAA2B,cAAc,CAAC,OAAO,EAAE;SAC3D,CAAC,CAAC;IACL,CAAC;IAED,MAAM,QAAQ,GAAG,cAAc,CAAC,KAAK,CAAC;IACtC,MAAM,kBAAkB,GAAG,kBAAkB,CAAC,kBAAkB,CAAC;IAEjE,oDAAoD;IACpD,MAAM,gBAAgB,GAAG,kBAAkB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,UAAU,CAAC,CAAC;IACvF,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,OAAO,OAAO,CAAC;YACb,OAAO,EAAE,KAAK;YACd,UAAU;YACV,KAAK,EAAE,kCAAkC;SAC1C,CAAC,CAAC;IACL,CAAC;IAED,yBAAyB;IACzB,MAAM,UAAU,GAAG,QAAQ,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;IAEtD,yBAAyB;IACzB,MAAM,SAAS,GAAG,QAAQ,CAAC,4BAA4B,CAAC,QAAQ,CAAC,CAAC;IAElE,yBAAyB;IACzB,MAAM,cAAc,GAAG,QAAQ,CAAC,4BAA4B,CAAC,QAAQ,CAAC,CAAC;IAEvE,iCAAiC;IACjC,MAAM,cAAc,GAAG,QAAQ,CAAC,eAAe,CAAC,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IAChF,IAAI,cAAc,CAAC,SAAS,EAAE,EAAE,CAAC;QAC/B,OAAO,OAAO,CAAC;YACb,OAAO,EAAE,KAAK;YACd,UAAU;YACV,KAAK,EAAE,+BAA+B,cAAc,CAAC,OAAO,EAAE;SAC/D,CAAC,CAAC;IACL,CAAC;IAED,MAAM,QAAQ,GAAG,cAAc,CAAC,KAAK,CAAC;IAEtC,uCAAuC;IACvC,MAAM,gBAAgB,GAAoB,EAAE,CAAC;IAC7C,MAAM,iBAAiB,GAAG,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAEvE,qDAAqD;IACrD,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACvF,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAE9F,+BAA+B;IAC/B,iBAAiB,CAAC,OAAO,CAAC,CAAC,gBAAgB,EAAE,EAAE;QAC7C,MAAM,KAAK,GAAG,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,SAAc,EAAE,EAAE,CAAC,SAAS,KAAK,gBAAgB,CAAC,CAAC;QAChG,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;YACjB,MAAM,eAAe,GAAG,MAAM,KAAK,EAAE,CAAC;YACtC,MAAM,oBAAoB,GAAG,8BAA8B,CACzD,QAAQ,EACR,KAAK,EACL,gBAAgB,EAChB,kBAAkB,CACnB,CAAC;YAEF,MAAM,cAAc,GAAG,mBAAmB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACtD,MAAM,cAAc,GAAG,mBAAmB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAEtD,MAAM,kBAAkB,GAAG,cAAc,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,SAAS,CAAC;YAEpG,gBAAgB,CAAC,IAAI,CAAC;gBACpB,SAAS,EAAE,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC;gBACrC,eAAe;gBACf,cAAc,EAAE,KAAK;gBACrB,OAAO,EAAE,IAAI;gBACb,SAAS,EAAE,kBAAkB;gBAC7B,cAAc;gBACd,oBAAoB;aACrB,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,8BAA8B;IAC9B,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,SAAc,EAAE,KAAa,EAAE,EAAE;QAC5D,MAAM,SAAS,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC;QACnE,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,kFAAkF;YAClF,MAAM,eAAe,GAAG,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,EAAE,CAAC;YACrG,MAAM,oBAAoB,GAAG,8BAA8B,CACzD,QAAQ,EACR,KAAK,EACL,gBAAgB,EAChB,kBAAkB,CACnB,CAAC;YAEF,gBAAgB,CAAC,IAAI,CAAC;gBACpB,SAAS;gBACT,eAAe;gBACf,cAAc,EAAE,KAAK;gBACrB,OAAO,EAAE,KAAK;gBACd,SAAS,EAAE,SAAS;gBACpB,cAAc,EAAE,KAAK;gBACrB,oBAAoB;aACrB,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,MAAM,GAAqB;QAC/B,OAAO,EAAE,IAAI;QACb,UAAU;QACV,QAAQ;QACR,aAAa,EAAE,UAAU,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;QACpE,aAAa,EAAE,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;QAClE,gBAAgB;QAChB,aAAa,EAAE,cAAc,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;QAC5E,KAAK,EAAE,UAAU,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;KAC/D,CAAC;IAEF,QAAQ,CAAC,WAAW,EAAE,mCAAmC,CAAC,CAAC;IAC3D,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,kBAAsC;IAC3E,IAAI,kBAAkB,CAAC,kBAAkB,CAAC,UAAU,EAAE,CAAC;QACrD,OAAO,kBAAkB,CAAC,kBAAkB,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC7E,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CACtC,aAAiD,EACjD,oBAAwD;IAExD,OAAO,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC;AAChF,CAAC","sourcesContent":["import { Result, succeed, fail, MessageAggregator } from '@fgv/ts-utils';\nimport { Runtime } from '@fgv/ts-res';\nimport { ProcessedResources, ResolutionResult, CandidateInfo, ConditionEvaluationResult } from '../types';\n\nexport interface ResolutionOptions {\n  enableCaching?: boolean;\n  enableDebugLogging?: boolean;\n}\n\n// Helper function for conditional debug logging\nconst debugLog = (enableDebug: boolean, ...args: any[]) => {\n  if (enableDebug) {\n    console.log(...args);\n  }\n};\n\n/**\n * Create a resolver with context for resource resolution\n */\nexport function createResolverWithContext(\n  processedResources: ProcessedResources,\n  contextValues: Record<string, string | undefined>,\n  options: ResolutionOptions = {}\n): Result<Runtime.ResourceResolver> {\n  const enableDebug = options.enableDebugLogging === true;\n\n  debugLog(enableDebug, '=== CREATING RESOLVER WITH CONTEXT ===');\n  debugLog(enableDebug, 'Context values:', contextValues);\n\n  // Create context provider with filtered values (remove undefined)\n  const filteredContext = Object.fromEntries(\n    Object.entries(contextValues).filter(([, value]) => value !== undefined)\n  ) as Record<string, string>;\n\n  return Runtime.ValidatingSimpleContextQualifierProvider.create({\n    qualifiers: processedResources.system.qualifiers\n  })\n    .withErrorFormat((e) => `Failed to create context provider: ${e}`)\n    .onSuccess((contextProvider) => {\n      const errors = new MessageAggregator();\n      // Set context values\n      for (const [qualifierName, value] of Object.entries(filteredContext)) {\n        contextProvider.validating\n          .set(qualifierName, value)\n          .withErrorFormat((e) => `Failed to set context value ${qualifierName}=${value}: ${e}`)\n          .aggregateError(errors);\n      }\n\n      if (errors.hasMessages) {\n        return fail(`Errors setting context values: ${errors.toString()}`);\n      }\n\n      // Create resolver\n      const resolverParams: any = {\n        resourceManager: processedResources.system.resourceManager,\n        qualifierTypes: processedResources.system.qualifierTypes,\n        contextQualifierProvider: contextProvider\n      };\n\n      // Add cache metrics listener if caching is enabled\n      if (options.enableCaching) {\n        const metricsListener = new Runtime.ResourceResolverCacheMetricsListener(\n          () => new Runtime.AggregateCacheMetrics()\n        );\n        resolverParams.listener = metricsListener;\n      }\n\n      return Runtime.ResourceResolver.create(resolverParams)\n        .withErrorFormat((e) => `Failed to create resolver: ${e}`)\n        .onSuccess((resolver) => {\n          debugLog(enableDebug, 'Resolver created successfully');\n          return succeed(resolver);\n        });\n    });\n}\n\n/**\n * Evaluate conditions for a specific candidate\n */\nexport function evaluateConditionsForCandidate(\n  resolver: Runtime.ResourceResolver,\n  candidateIndex: number,\n  compiledResource: any,\n  compiledCollection: any\n): ConditionEvaluationResult[] {\n  try {\n    const decision = compiledCollection.decisions[compiledResource.decision];\n    if (!decision || !decision.conditionSets || candidateIndex >= decision.conditionSets.length) {\n      return [];\n    }\n\n    const conditionSetIndex = decision.conditionSets[candidateIndex];\n    const conditionSet = compiledCollection.conditionSets[conditionSetIndex];\n    if (!conditionSet || !conditionSet.conditions) {\n      return [];\n    }\n\n    const evaluations: ConditionEvaluationResult[] = [];\n\n    for (const conditionIndex of conditionSet.conditions) {\n      const condition = compiledCollection.conditions[conditionIndex];\n      if (!condition) continue;\n\n      const qualifier = compiledCollection.qualifiers[condition.qualifierIndex];\n      if (!qualifier) continue;\n\n      // Get the qualifier value from context\n      const qualifierValueResult = resolver.contextQualifierProvider.get(qualifier);\n      const qualifierValue = qualifierValueResult.orDefault();\n\n      // Get the cached condition result from resolver (if available)\n      const cachedResult = resolver.conditionCache?.[conditionIndex];\n      const score = cachedResult?.score || 0;\n      const matchType = cachedResult?.matchType || 'noMatch';\n      const matched = matchType !== 'noMatch';\n\n      evaluations.push({\n        qualifierName: qualifier.name,\n        qualifierValue,\n        conditionValue: condition.value,\n        operator: condition.operator || 'matches',\n        score,\n        matched,\n        matchType,\n        scoreAsDefault: condition.scoreAsDefault,\n        conditionIndex\n      });\n    }\n\n    return evaluations;\n  } catch (error) {\n    console.warn('Error evaluating conditions for candidate:', error);\n    return [];\n  }\n}\n\n/**\n * Resolve a resource and create detailed resolution result\n */\nexport function resolveResourceDetailed(\n  resolver: Runtime.ResourceResolver,\n  resourceId: string,\n  processedResources: ProcessedResources,\n  options: ResolutionOptions = {}\n): Result<ResolutionResult> {\n  const enableDebug = options.enableDebugLogging === true;\n\n  debugLog(enableDebug, '=== RESOLVING RESOURCE ===');\n  debugLog(enableDebug, 'Resource ID:', resourceId);\n\n  const resourceResult = processedResources.system.resourceManager.getBuiltResource(resourceId);\n  if (resourceResult.isFailure()) {\n    return succeed({\n      success: false,\n      resourceId,\n      error: `Failed to get resource: ${resourceResult.message}`\n    });\n  }\n\n  const resource = resourceResult.value;\n  const compiledCollection = processedResources.compiledCollection;\n\n  // Find the compiled resource for condition analysis\n  const compiledResource = compiledCollection.resources.find((r) => r.id === resourceId);\n  if (!compiledResource) {\n    return succeed({\n      success: false,\n      resourceId,\n      error: 'Failed to find compiled resource'\n    });\n  }\n\n  // Resolve best candidate\n  const bestResult = resolver.resolveResource(resource);\n\n  // Resolve all candidates\n  const allResult = resolver.resolveAllResourceCandidates(resource);\n\n  // Resolve composed value\n  const composedResult = resolver.resolveComposedResourceValue(resource);\n\n  // Get decision resolution result\n  const decisionResult = resolver.resolveDecision(resource.decision.baseDecision);\n  if (decisionResult.isFailure()) {\n    return succeed({\n      success: false,\n      resourceId,\n      error: `Failed to resolve decision: ${decisionResult.message}`\n    });\n  }\n\n  const decision = decisionResult.value;\n\n  // Build detailed candidate information\n  const candidateDetails: CandidateInfo[] = [];\n  const matchedCandidates = allResult.isSuccess() ? allResult.value : [];\n\n  // Create lookup sets for regular and default matches\n  const regularMatchIndices = new Set(decision?.success ? decision.instanceIndices : []);\n  const defaultMatchIndices = new Set(decision?.success ? decision.defaultInstanceIndices : []);\n\n  // Add matched candidates first\n  matchedCandidates.forEach((matchedCandidate) => {\n    const index = resource.candidates.findIndex((candidate: any) => candidate === matchedCandidate);\n    if (index !== -1) {\n      const conditionSetKey = `cs-${index}`;\n      const conditionEvaluations = evaluateConditionsForCandidate(\n        resolver,\n        index,\n        compiledResource,\n        compiledCollection\n      );\n\n      const isDefaultMatch = defaultMatchIndices.has(index);\n      const isRegularMatch = regularMatchIndices.has(index);\n\n      const candidateMatchType = isRegularMatch ? 'match' : isDefaultMatch ? 'matchAsDefault' : 'noMatch';\n\n      candidateDetails.push({\n        candidate: resource.candidates[index],\n        conditionSetKey,\n        candidateIndex: index,\n        matched: true,\n        matchType: candidateMatchType,\n        isDefaultMatch,\n        conditionEvaluations\n      });\n    }\n  });\n\n  // Add non-matching candidates\n  resource.candidates.forEach((candidate: any, index: number) => {\n    const isMatched = matchedCandidates.some((mc) => mc === candidate);\n    if (!isMatched) {\n      // Handle different candidate formats - IResourceCandidate doesn't have conditions\n      const conditionSetKey = candidate.conditions?.toHash ? candidate.conditions.toHash() : `cs-${index}`;\n      const conditionEvaluations = evaluateConditionsForCandidate(\n        resolver,\n        index,\n        compiledResource,\n        compiledCollection\n      );\n\n      candidateDetails.push({\n        candidate,\n        conditionSetKey,\n        candidateIndex: index,\n        matched: false,\n        matchType: 'noMatch',\n        isDefaultMatch: false,\n        conditionEvaluations\n      });\n    }\n  });\n\n  const result: ResolutionResult = {\n    success: true,\n    resourceId,\n    resource,\n    bestCandidate: bestResult.isSuccess() ? bestResult.value : undefined,\n    allCandidates: allResult.isSuccess() ? allResult.value : undefined,\n    candidateDetails,\n    composedValue: composedResult.isSuccess() ? composedResult.value : undefined,\n    error: bestResult.isFailure() ? bestResult.message : undefined\n  };\n\n  debugLog(enableDebug, 'Resolution completed successfully');\n  return succeed(result);\n}\n\n/**\n * Get available qualifiers from processed resources\n */\nexport function getAvailableQualifiers(processedResources: ProcessedResources): string[] {\n  if (processedResources.compiledCollection.qualifiers) {\n    return processedResources.compiledCollection.qualifiers.map((q) => q.name);\n  }\n  return [];\n}\n\n/**\n * Check if context has any pending changes\n */\nexport function hasPendingContextChanges(\n  contextValues: Record<string, string | undefined>,\n  pendingContextValues: Record<string, string | undefined>\n): boolean {\n  return JSON.stringify(contextValues) !== JSON.stringify(pendingContextValues);\n}\n"]}

package/lib/utils/tsResIntegration.d.ts

@@ -0,0 +1,71 @@
+import { Result, FileTree } from '@fgv/ts-utils';
+import { QualifierTypes, Qualifiers, ResourceTypes, Resources, Import, Runtime, ResourceJson, Config } from '@fgv/ts-res';
+import { ImportedDirectory, ImportedFile } from '../types';
+/**
+ * Get the default system configuration from ts-res library
+ */
+export declare function getDefaultSystemConfiguration(): Config.Model.ISystemConfiguration;
+/**
+ * Create a simple context provider from qualifier values
+ */
+export declare function createSimpleContext(qualifiers: Qualifiers.IReadOnlyQualifierCollector, values: Record<string, string | undefined>): Result<Runtime.ValidatingSimpleContextQualifierProvider>;
+/**
+ * Convert ImportedDirectory to FileTree format
+ */
+export declare function convertImportedDirectoryToFileTree(directory: ImportedDirectory): FileTree.FileTree;
+/**
+ * Create ts-res system from configuration
+ */
+export declare function createTsResSystemFromConfig(systemConfig?: Config.Model.ISystemConfiguration): Result<{
+    qualifierTypes: QualifierTypes.ReadOnlyQualifierTypeCollector;
+    qualifiers: Qualifiers.IReadOnlyQualifierCollector;
+    resourceTypes: ResourceTypes.ReadOnlyResourceTypeCollector;
+    resourceManager: Resources.ResourceManagerBuilder;
+    importManager: Import.ImportManager;
+    contextQualifierProvider: Runtime.ValidatingSimpleContextQualifierProvider;
+}>;
+/**
+ * Process imported files using the ts-res system
+ */
+export declare function processImportedFiles(files: ImportedFile[], systemConfig?: Config.Model.ISystemConfiguration): Result<{
+    system: {
+        qualifierTypes: QualifierTypes.ReadOnlyQualifierTypeCollector;
+        qualifiers: Qualifiers.IReadOnlyQualifierCollector;
+        resourceTypes: ResourceTypes.ReadOnlyResourceTypeCollector;
+        resourceManager: Resources.ResourceManagerBuilder;
+        importManager: Import.ImportManager;
+        contextQualifierProvider: Runtime.ValidatingSimpleContextQualifierProvider;
+    };
+    compiledCollection: ResourceJson.Compiled.ICompiledResourceCollection;
+    resolver: Runtime.ResourceResolver;
+    resourceCount: number;
+    summary: {
+        totalResources: number;
+        resourceIds: string[];
+        errorCount: number;
+        warnings: string[];
+    };
+}>;
+/**
+ * Process imported directory using the ts-res system
+ */
+export declare function processImportedDirectory(directory: ImportedDirectory, systemConfig?: Config.Model.ISystemConfiguration): Result<{
+    system: {
+        qualifierTypes: QualifierTypes.ReadOnlyQualifierTypeCollector;
+        qualifiers: Qualifiers.IReadOnlyQualifierCollector;
+        resourceTypes: ResourceTypes.ReadOnlyResourceTypeCollector;
+        resourceManager: Resources.ResourceManagerBuilder;
+        importManager: Import.ImportManager;
+        contextQualifierProvider: Runtime.ValidatingSimpleContextQualifierProvider;
+    };
+    compiledCollection: ResourceJson.Compiled.ICompiledResourceCollection;
+    resolver: Runtime.ResourceResolver;
+    resourceCount: number;
+    summary: {
+        totalResources: number;
+        resourceIds: string[];
+        errorCount: number;
+        warnings: string[];
+    };
+}>;
+//# sourceMappingURL=tsResIntegration.d.ts.map

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

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

package/lib/utils/tsResIntegration.js

@@ -0,0 +1,294 @@
+import { succeed, fail, FileTree } from '@fgv/ts-utils';
+import { Resources, Import, Runtime, Config } from '@fgv/ts-res';
+/**
+ * Get the default system configuration from ts-res library
+ */
+export function getDefaultSystemConfiguration() {
+    return Config.getPredefinedDeclaration('default').orDefault({
+        // Fallback configuration if predefined default is not available
+        name: 'Browser Default Configuration',
+        description: 'Fallback default configuration for ts-res browser tool',
+        qualifierTypes: [
+            {
+                name: 'language',
+                systemType: 'language',
+                configuration: {
+                    allowContextList: true
+                }
+            },
+            {
+                name: 'territory',
+                systemType: 'territory',
+                configuration: {
+                    allowContextList: false
+                }
+            }
+        ],
+        qualifiers: [
+            {
+                name: 'currentTerritory',
+                token: 'geo',
+                typeName: 'territory',
+                defaultPriority: 850
+            },
+            {
+                name: 'language',
+                token: 'lang',
+                typeName: 'language',
+                defaultPriority: 800
+            }
+        ],
+        resourceTypes: [
+            {
+                name: 'json',
+                typeName: 'json'
+            }
+        ]
+    });
+}
+/**
+ * Create a simple context provider from qualifier values
+ */
+export function createSimpleContext(qualifiers, values) {
+    return Runtime.ValidatingSimpleContextQualifierProvider.create({
+        qualifiers
+    }).withErrorFormat((e) => `Failed to create context: ${e}`);
+}
+/**
+ * Convert ImportedDirectory to FileTree format
+ */
+export function convertImportedDirectoryToFileTree(directory) {
+    // Convert files to IInMemoryFile format and flatten the directory structure
+    const flattenFiles = (dir, parentPath = '') => {
+        const files = [];
+        // Add files from current directory
+        if (dir.files) {
+            dir.files.forEach((file) => {
+                const filePath = parentPath ? `${parentPath}/${file.name}` : file.name;
+                files.push({
+                    path: filePath,
+                    contents: file.content
+                });
+            });
+        }
+        // Recursively process subdirectories
+        if (dir.subdirectories) {
+            dir.subdirectories.forEach((subdir) => {
+                const subdirPath = parentPath ? `${parentPath}/${subdir.name}` : subdir.name;
+                files.push(...flattenFiles(subdir, subdirPath));
+            });
+        }
+        return files;
+    };
+    const inMemoryFiles = flattenFiles(directory);
+    console.log('[convertImportedDirectoryToFileTree] Converting directory to FileTree:', {
+        directoryName: directory.name,
+        directoryPath: directory.path,
+        numFiles: directory.files?.length || 0,
+        numSubdirs: directory.subdirectories?.length || 0,
+        totalFlattenedFiles: inMemoryFiles.length,
+        sampleFiles: inMemoryFiles.slice(0, 3).map((f) => f.path)
+    });
+    // Use ts-res's inMemory FileTree utility
+    return FileTree.inMemory(inMemoryFiles).orThrow((msg) => `Failed to create file tree: ${msg}`);
+}
+/**
+ * Create ts-res system from configuration
+ */
+export function createTsResSystemFromConfig(systemConfig) {
+    const configToUse = systemConfig ?? getDefaultSystemConfiguration();
+    return Config.SystemConfiguration.create(configToUse)
+        .onSuccess((systemConfiguration) => {
+        return Resources.ResourceManagerBuilder.create({
+            qualifiers: systemConfiguration.qualifiers,
+            resourceTypes: systemConfiguration.resourceTypes
+        })
+            .withErrorFormat((e) => `Failed to create resource manager: ${e}`)
+            .onSuccess((resourceManager) => {
+            return Import.ImportManager.create({
+                resources: resourceManager
+            })
+                .withErrorFormat((e) => `Failed to create import manager: ${e}`)
+                .onSuccess((importManager) => {
+                return Runtime.ValidatingSimpleContextQualifierProvider.create({
+                    qualifiers: systemConfiguration.qualifiers
+                })
+                    .withErrorFormat((e) => `Failed to create context qualifier provider: ${e}`)
+                    .onSuccess((contextQualifierProvider) => {
+                    return succeed({
+                        qualifierTypes: systemConfiguration.qualifierTypes,
+                        qualifiers: systemConfiguration.qualifiers,
+                        resourceTypes: systemConfiguration.resourceTypes,
+                        resourceManager,
+                        importManager,
+                        contextQualifierProvider
+                    });
+                });
+            });
+        });
+    })
+        .withErrorFormat((e) => `Failed to create ts-res system: ${e}`);
+}
+/**
+ * Process imported files using the ts-res system
+ */
+export function processImportedFiles(files, systemConfig) {
+    if (files.length === 0) {
+        return fail('No files provided for processing');
+    }
+    return createTsResSystemFromConfig(systemConfig)
+        .onSuccess((tsResSystem) => {
+        // Convert ImportedFile[] to IInMemoryFile[] format
+        const inMemoryFiles = files.map((file) => ({
+            path: file.path || file.name,
+            contents: file.content
+        }));
+        return FileTree.inMemory(inMemoryFiles)
+            .onSuccess((fileTree) => {
+            return Import.ImportManager.create({
+                fileTree,
+                resources: tsResSystem.resourceManager
+            });
+        })
+            .onSuccess((importManager) => {
+            // Import each file using its filesystem path
+            for (const file of files) {
+                const importResult = importManager.importFromFileSystem(file.path || file.name);
+                if (importResult.isFailure()) {
+                    return fail(`Failed to import file ${file.path || file.name}: ${importResult.message}`);
+                }
+            }
+            // Finalize processing
+            const updatedSystem = {
+                ...tsResSystem,
+                importManager
+            };
+            return finalizeProcessing(updatedSystem);
+        });
+    })
+        .withErrorFormat((message) => `processImportedFiles failed: ${message}`);
+}
+/**
+ * Process imported directory using the ts-res system
+ */
+export function processImportedDirectory(directory, systemConfig) {
+    return createTsResSystemFromConfig(systemConfig)
+        .onSuccess((tsResSystem) => {
+        // Convert directory to file tree
+        const fileTree = convertImportedDirectoryToFileTree(directory);
+        return Import.ImportManager.create({
+            fileTree,
+            resources: tsResSystem.resourceManager
+        }).onSuccess((importManager) => {
+            // Simply try to import from the filesystem root
+            // The ImportManager will handle finding and importing all resources
+            console.log('[tsResIntegration] Starting resource import from FileTree');
+            const importResult = importManager.importFromFileSystem('/');
+            if (importResult.isFailure()) {
+                console.warn(`[tsResIntegration] Failed to import from root, trying individual files`);
+                // If root import fails, try to import files individually
+                // We'll recursively traverse the tree using the FileTree API
+                let importedCount = 0;
+                const failedImports = [];
+                const importDirectory = (dirPath) => {
+                    const dirResult = fileTree.getDirectory(dirPath);
+                    if (dirResult.isSuccess()) {
+                        const dir = dirResult.value;
+                        const childrenResult = dir.getChildren();
+                        if (childrenResult.isSuccess()) {
+                            for (const child of childrenResult.value) {
+                                if (child.type === 'file' && child.name.endsWith('.json')) {
+                                    console.log(`[tsResIntegration] Importing file: ${child.absolutePath}`);
+                                    const fileImportResult = importManager.importFromFileSystem(child.absolutePath);
+                                    if (fileImportResult.isSuccess()) {
+                                        importedCount++;
+                                        console.log(`[tsResIntegration] Successfully imported ${child.absolutePath}`);
+                                    }
+                                    else {
+                                        console.warn(`[tsResIntegration] Failed to import ${child.absolutePath}: ${fileImportResult.message}`);
+                                        failedImports.push({ file: child.absolutePath, error: fileImportResult.message });
+                                    }
+                                }
+                                else if (child.type === 'directory') {
+                                    importDirectory(child.absolutePath);
+                                }
+                            }
+                        }
+                    }
+                };
+                // Start from root
+                importDirectory('/');
+                // Also try without leading slash
+                if (importedCount === 0) {
+                    importDirectory('');
+                }
+                console.log(`[tsResIntegration] Import complete. Imported ${importedCount} files`);
+                if (importedCount === 0 && failedImports.length > 0) {
+                    // Create a summary of unique errors
+                    const errorSummary = new Map();
+                    failedImports.forEach(({ file, error }) => {
+                        // Extract the main error (e.g., "invalid item: role: not found")
+                        const mainError = error.split('\n')[0];
+                        if (!errorSummary.has(mainError)) {
+                            errorSummary.set(mainError, []);
+                        }
+                        errorSummary.get(mainError).push(file);
+                    });
+                    let errorMessage = `Failed to import resources. Missing qualifiers in configuration:\n`;
+                    errorSummary.forEach((files, error) => {
+                        errorMessage += `- ${error} (${files.length} file${files.length > 1 ? 's' : ''})\n`;
+                    });
+                    return fail(errorMessage);
+                }
+                else if (importedCount === 0) {
+                    return fail(`No resource files found in ${directory.name}`);
+                }
+            }
+            else {
+                console.log('[tsResIntegration] Successfully imported resources from root');
+            }
+            // Finalize processing
+            const updatedSystem = {
+                ...tsResSystem,
+                importManager
+            };
+            return finalizeProcessing(updatedSystem);
+        });
+    })
+        .withErrorFormat((message) => `processImportedDirectory failed: ${message}`);
+}
+/**
+ * Finalizes processing and creates compiled resources
+ */
+function finalizeProcessing(system) {
+    return system.resourceManager
+        .getCompiledResourceCollection({ includeMetadata: true })
+        .onSuccess((compiledCollection) => {
+        // Create resolver directly without CompiledResourceCollection manager
+        return Runtime.ResourceResolver.create({
+            resourceManager: system.resourceManager,
+            qualifierTypes: system.qualifierTypes,
+            contextQualifierProvider: system.contextQualifierProvider
+        }).onSuccess((resolver) => {
+            // Create summary
+            const resourceIds = Array.from(system.resourceManager.resources.keys());
+            const summary = {
+                totalResources: resourceIds.length,
+                resourceIds,
+                errorCount: 0,
+                warnings: []
+            };
+            return succeed({
+                system,
+                compiledCollection,
+                resolver,
+                resourceCount: resourceIds.length,
+                summary
+            });
+        });
+    })
+        .withErrorFormat((message) => `Failed to finalize processing: ${message}`);
+}
+// Note: createCompiledResourceCollectionManager was removed as part of the refactoring
+// We now always use ResourceManagerBuilder as the primary data structure
+//# sourceMappingURL=tsResIntegration.js.map