@lukso/transaction-view-headless 0.2.2-dev.a8c9315

package/dist/types/index.d.cts

@@ -0,0 +1,203 @@
+import { DecoderResult } from '@lukso/transaction-decoder';
+
+/**
+ * Different contexts WHERE transaction views are displayed
+ *
+ * Context determines the environment/location, which affects:
+ * - Available space
+ * - User intent
+ * - Security requirements
+ * - Interaction patterns
+ */
+type ViewContext = 'approval' | 'feed' | 'list' | 'detail' | 'review' | 'notification' | 'embed' | 'batch-summary';
+/**
+ * Different variants of HOW transaction views are displayed
+ *
+ * Variant determines the presentation style within a context:
+ * - Same transaction can have different variants in different contexts
+ * - Example: 'collapsed' in feed vs 'collapsed' in approval are different
+ */
+type ViewVariant = 'full' | 'collapsed' | 'minimal' | 'icon-only' | 'compact' | 'expanded' | string;
+/**
+ * Context-specific display requirements
+ */
+interface ViewContextRequirements {
+    /** Maximum height constraint */
+    maxHeight?: number;
+    /** Whether to show action buttons */
+    showActions?: boolean;
+    /** Level of detail to display */
+    detailLevel: 'minimal' | 'summary' | 'full' | 'debug';
+    /** Whether user can expand for more details */
+    expandable?: boolean;
+    /** Color scheme preference */
+    colorScheme?: 'light' | 'dark' | 'auto';
+    /** Whether to emphasize security warnings */
+    emphasizeSecurity?: boolean;
+}
+
+type DecoderRecordForSelection = DecoderResult & {
+    recordType?: string;
+    functionName?: string;
+    contractAddress?: string;
+    standard?: string;
+};
+
+/**
+ * Criteria that can be used to match transactions to views
+ */
+interface ViewMatchCriteria {
+    /** LSP standard (e.g., 'LSP7', 'LSP8', 'LSP0') */
+    standard?: string | string[];
+    /** Function name from ABI (e.g., 'transfer', 'setData', 'execute') */
+    functionName?: string | string[];
+    /** Record type from decoder (e.g., 'lsp7-transfer', 'set-data') */
+    recordType?: string | string[];
+    /** Contract address (for specific contract implementations) */
+    contractAddress?: string | string[];
+    /** Chain ID (for network-specific views) */
+    chainId?: number | number[];
+    /** Display context (opt-in) - WHERE to display (feed, approval, list, etc.) */
+    context?: ViewContext | ViewContext[];
+    /** Display variant (opt-in) - HOW to display (collapsed, minimal, full, etc.) */
+    variant?: ViewVariant | ViewVariant[];
+    /** Context requirements (opt-in) - additional constraints for context matching */
+    contextRequirements?: Partial<ViewContextRequirements>;
+    /**
+     * Custom matcher function for complex synchronous logic.
+     * Returns the number of conditions that matched (higher = better match).
+     *
+     * IMPORTANT: Must be synchronous and only use data from DecoderResult.
+     * For async operations, populate transaction.custom in an enhancer.
+     *
+     * @returns Number of matching conditions (0 = no match, higher = stronger match)
+     *
+     * @example
+     * // Match token transfers (tokenType === 0)
+     * customMatcher: (tx) => {
+     *   let matches = 0
+     *   if (tx.custom?.tokenType === 0) matches++
+     *   if (BigInt(tx.value || 0) > 0) matches++
+     *   return matches
+     * }
+     */
+    customMatcher?: (transaction: DecoderResult) => number;
+}
+/**
+ * Framework-agnostic view definition
+ */
+interface ViewDefinition {
+    /** Unique identifier for this view */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Criteria for matching transactions to this view */
+    criteria: ViewMatchCriteria;
+    /** Priority when multiple views match (higher = preferred) */
+    priority: number;
+    /** Supported frameworks for this view */
+    frameworks: FrameworkSupport;
+    /** Optional description */
+    description?: string;
+}
+/**
+ * Framework-specific loading configurations
+ *
+ * Strategic Framework Selection (Suffering Economics Optimized):
+ * - lit: Universal web components (works in Vue, React, Angular, Svelte, etc.)
+ * - vue: Native Vue components (optional, for Vue-specific optimizations)
+ * - rn: React Native components (mobile-native, optional - falls back to WebView)
+ *
+ * Lit is the universal fallback. Vue and React Native are optional native implementations
+ * that get priority when available in their respective environments.
+ */
+interface FrameworkSupport {
+    lit: FrameworkViewConfig;
+    vue?: FrameworkViewConfig;
+    rn?: FrameworkViewConfig;
+}
+/**
+ * Configuration for loading a view in a specific framework
+ */
+interface FrameworkViewConfig {
+    /** Loading method */
+    loader: ViewLoader;
+    /** Component name/identifier */
+    component: string;
+    /** Package where the component is located */
+    package?: string;
+}
+/**
+ * Different ways to load a view component
+ *
+ * Loaders support both static and lazy loading:
+ * - Static: `path: './Component.vue'` - bundled with app
+ * - Lazy: `path: () => import('./Component.vue')` - loaded on demand
+ */
+type ViewLoader = {
+    type: 'dynamic-import';
+    path: string | (() => Promise<any>);
+} | {
+    type: 'static-import';
+    path: string | (() => Promise<any>);
+} | {
+    type: 'custom-element';
+    tagName: string;
+} | {
+    type: 'registry-lookup';
+    registryKey: string;
+} | {
+    type: 'custom';
+    loader: (config: FrameworkViewConfig) => Promise<any>;
+};
+/**
+ * Result of matching a transaction against registered views
+ */
+interface ViewMatch {
+    /** The view definition that matched */
+    view: ViewDefinition;
+    /** Score indicating how well this view matches (0-1) */
+    score: number;
+    /** Which criteria matched */
+    matchedCriteria: (keyof ViewMatchCriteria)[];
+    /** Framework-specific loading config */
+    frameworkConfig?: FrameworkViewConfig;
+}
+/**
+ * Options for view matching
+ */
+interface ViewMatchOptions {
+    /** Target framework */
+    framework: 'lit' | 'vue' | 'rn';
+    /** Display context (optional) - WHERE to display (feed, approval, list, etc.) */
+    context?: ViewContext;
+    /** Display variant (optional) - HOW to display (collapsed, minimal, full, etc.) */
+    variant?: ViewVariant;
+    /** Context requirements (optional) - additional constraints for context-aware matching */
+    contextRequirements?: Partial<ViewContextRequirements>;
+    /** Minimum score threshold (0-1) */
+    minScore?: number;
+    /** Maximum number of matches to return */
+    maxMatches?: number;
+    /** Whether to include framework config in results */
+    includeFrameworkConfig?: boolean;
+}
+/**
+ * Registry for managing view definitions
+ */
+interface ViewRegistry {
+    /** Register a new view */
+    register(view: ViewDefinition): void;
+    /** Unregister a view by ID */
+    unregister(viewId: string): void;
+    /** Get all registered views */
+    getAllViews(): ViewDefinition[];
+    /** Find best matching views for a transaction */
+    findMatches(transaction: DecoderResult, options: ViewMatchOptions): ViewMatch[];
+    /** Get a specific view by ID */
+    getView(viewId: string): ViewDefinition | undefined;
+    /** Clear all registered views */
+    clear(): void;
+}
+
+export type { DecoderRecordForSelection, FrameworkSupport, FrameworkViewConfig, ViewContext, ViewContextRequirements, ViewDefinition, ViewLoader, ViewMatch, ViewMatchCriteria, ViewMatchOptions, ViewRegistry, ViewVariant };

package/dist/types/index.d.ts

@@ -0,0 +1,203 @@
+import { DecoderResult } from '@lukso/transaction-decoder';
+
+/**
+ * Different contexts WHERE transaction views are displayed
+ *
+ * Context determines the environment/location, which affects:
+ * - Available space
+ * - User intent
+ * - Security requirements
+ * - Interaction patterns
+ */
+type ViewContext = 'approval' | 'feed' | 'list' | 'detail' | 'review' | 'notification' | 'embed' | 'batch-summary';
+/**
+ * Different variants of HOW transaction views are displayed
+ *
+ * Variant determines the presentation style within a context:
+ * - Same transaction can have different variants in different contexts
+ * - Example: 'collapsed' in feed vs 'collapsed' in approval are different
+ */
+type ViewVariant = 'full' | 'collapsed' | 'minimal' | 'icon-only' | 'compact' | 'expanded' | string;
+/**
+ * Context-specific display requirements
+ */
+interface ViewContextRequirements {
+    /** Maximum height constraint */
+    maxHeight?: number;
+    /** Whether to show action buttons */
+    showActions?: boolean;
+    /** Level of detail to display */
+    detailLevel: 'minimal' | 'summary' | 'full' | 'debug';
+    /** Whether user can expand for more details */
+    expandable?: boolean;
+    /** Color scheme preference */
+    colorScheme?: 'light' | 'dark' | 'auto';
+    /** Whether to emphasize security warnings */
+    emphasizeSecurity?: boolean;
+}
+
+type DecoderRecordForSelection = DecoderResult & {
+    recordType?: string;
+    functionName?: string;
+    contractAddress?: string;
+    standard?: string;
+};
+
+/**
+ * Criteria that can be used to match transactions to views
+ */
+interface ViewMatchCriteria {
+    /** LSP standard (e.g., 'LSP7', 'LSP8', 'LSP0') */
+    standard?: string | string[];
+    /** Function name from ABI (e.g., 'transfer', 'setData', 'execute') */
+    functionName?: string | string[];
+    /** Record type from decoder (e.g., 'lsp7-transfer', 'set-data') */
+    recordType?: string | string[];
+    /** Contract address (for specific contract implementations) */
+    contractAddress?: string | string[];
+    /** Chain ID (for network-specific views) */
+    chainId?: number | number[];
+    /** Display context (opt-in) - WHERE to display (feed, approval, list, etc.) */
+    context?: ViewContext | ViewContext[];
+    /** Display variant (opt-in) - HOW to display (collapsed, minimal, full, etc.) */
+    variant?: ViewVariant | ViewVariant[];
+    /** Context requirements (opt-in) - additional constraints for context matching */
+    contextRequirements?: Partial<ViewContextRequirements>;
+    /**
+     * Custom matcher function for complex synchronous logic.
+     * Returns the number of conditions that matched (higher = better match).
+     *
+     * IMPORTANT: Must be synchronous and only use data from DecoderResult.
+     * For async operations, populate transaction.custom in an enhancer.
+     *
+     * @returns Number of matching conditions (0 = no match, higher = stronger match)
+     *
+     * @example
+     * // Match token transfers (tokenType === 0)
+     * customMatcher: (tx) => {
+     *   let matches = 0
+     *   if (tx.custom?.tokenType === 0) matches++
+     *   if (BigInt(tx.value || 0) > 0) matches++
+     *   return matches
+     * }
+     */
+    customMatcher?: (transaction: DecoderResult) => number;
+}
+/**
+ * Framework-agnostic view definition
+ */
+interface ViewDefinition {
+    /** Unique identifier for this view */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Criteria for matching transactions to this view */
+    criteria: ViewMatchCriteria;
+    /** Priority when multiple views match (higher = preferred) */
+    priority: number;
+    /** Supported frameworks for this view */
+    frameworks: FrameworkSupport;
+    /** Optional description */
+    description?: string;
+}
+/**
+ * Framework-specific loading configurations
+ *
+ * Strategic Framework Selection (Suffering Economics Optimized):
+ * - lit: Universal web components (works in Vue, React, Angular, Svelte, etc.)
+ * - vue: Native Vue components (optional, for Vue-specific optimizations)
+ * - rn: React Native components (mobile-native, optional - falls back to WebView)
+ *
+ * Lit is the universal fallback. Vue and React Native are optional native implementations
+ * that get priority when available in their respective environments.
+ */
+interface FrameworkSupport {
+    lit: FrameworkViewConfig;
+    vue?: FrameworkViewConfig;
+    rn?: FrameworkViewConfig;
+}
+/**
+ * Configuration for loading a view in a specific framework
+ */
+interface FrameworkViewConfig {
+    /** Loading method */
+    loader: ViewLoader;
+    /** Component name/identifier */
+    component: string;
+    /** Package where the component is located */
+    package?: string;
+}
+/**
+ * Different ways to load a view component
+ *
+ * Loaders support both static and lazy loading:
+ * - Static: `path: './Component.vue'` - bundled with app
+ * - Lazy: `path: () => import('./Component.vue')` - loaded on demand
+ */
+type ViewLoader = {
+    type: 'dynamic-import';
+    path: string | (() => Promise<any>);
+} | {
+    type: 'static-import';
+    path: string | (() => Promise<any>);
+} | {
+    type: 'custom-element';
+    tagName: string;
+} | {
+    type: 'registry-lookup';
+    registryKey: string;
+} | {
+    type: 'custom';
+    loader: (config: FrameworkViewConfig) => Promise<any>;
+};
+/**
+ * Result of matching a transaction against registered views
+ */
+interface ViewMatch {
+    /** The view definition that matched */
+    view: ViewDefinition;
+    /** Score indicating how well this view matches (0-1) */
+    score: number;
+    /** Which criteria matched */
+    matchedCriteria: (keyof ViewMatchCriteria)[];
+    /** Framework-specific loading config */
+    frameworkConfig?: FrameworkViewConfig;
+}
+/**
+ * Options for view matching
+ */
+interface ViewMatchOptions {
+    /** Target framework */
+    framework: 'lit' | 'vue' | 'rn';
+    /** Display context (optional) - WHERE to display (feed, approval, list, etc.) */
+    context?: ViewContext;
+    /** Display variant (optional) - HOW to display (collapsed, minimal, full, etc.) */
+    variant?: ViewVariant;
+    /** Context requirements (optional) - additional constraints for context-aware matching */
+    contextRequirements?: Partial<ViewContextRequirements>;
+    /** Minimum score threshold (0-1) */
+    minScore?: number;
+    /** Maximum number of matches to return */
+    maxMatches?: number;
+    /** Whether to include framework config in results */
+    includeFrameworkConfig?: boolean;
+}
+/**
+ * Registry for managing view definitions
+ */
+interface ViewRegistry {
+    /** Register a new view */
+    register(view: ViewDefinition): void;
+    /** Unregister a view by ID */
+    unregister(viewId: string): void;
+    /** Get all registered views */
+    getAllViews(): ViewDefinition[];
+    /** Find best matching views for a transaction */
+    findMatches(transaction: DecoderResult, options: ViewMatchOptions): ViewMatch[];
+    /** Get a specific view by ID */
+    getView(viewId: string): ViewDefinition | undefined;
+    /** Clear all registered views */
+    clear(): void;
+}
+
+export type { DecoderRecordForSelection, FrameworkSupport, FrameworkViewConfig, ViewContext, ViewContextRequirements, ViewDefinition, ViewLoader, ViewMatch, ViewMatchCriteria, ViewMatchOptions, ViewRegistry, ViewVariant };

package/dist/types/index.js

@@ -0,0 +1 @@
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/utils/index.cjs

@@ -0,0 +1,217 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/utils/index.ts
+var utils_exports = {};
+__export(utils_exports, {
+  CRITERIA_WEIGHTS: () => CRITERIA_WEIGHTS,
+  calculateMatchScore: () => calculateMatchScore,
+  findMatchingViews: () => findMatchingViews
+});
+module.exports = __toCommonJS(utils_exports);
+
+// src/utils/view-matcher.ts
+var CRITERIA_WEIGHTS = {
+  recordType: 0.25,
+  // Most specific to transaction type
+  functionName: 0.2,
+  // Function-level specificity
+  context: 0.2,
+  // Context specificity (when opt-in)
+  standard: 0.15,
+  // LSP standard specificity
+  contractAddress: 0.1,
+  // Contract-specific logic
+  contextRequirements: 0.05,
+  // Context requirement matching
+  chainId: 0.03,
+  // Network-specific behavior
+  customMatcher: 0.02
+  // Custom logic (lowest weight due to unpredictability)
+};
+function calculateMatchScore(transaction, view, options) {
+  const { criteria } = view;
+  const matchedCriteria = [];
+  let totalWeight = 0;
+  let matchedWeight = 0;
+  for (const [criterion, weight] of Object.entries(CRITERIA_WEIGHTS)) {
+    const criterionKey = criterion;
+    const criterionValue = criteria[criterionKey];
+    if (criterionValue === void 0) continue;
+    totalWeight += weight;
+    if (criterionKey === "customMatcher" && typeof criterionValue === "function") {
+      try {
+        const matchCount = criterionValue(transaction);
+        if (matchCount > 0) {
+          matchedCriteria.push(criterionKey);
+          const normalizedScore = Math.min(matchCount / 10, 1);
+          matchedWeight += weight * normalizedScore;
+        }
+      } catch (error) {
+        console.warn("Custom matcher threw error:", error);
+      }
+      continue;
+    }
+    if (doesCriterionMatch(transaction, criterionKey, criterionValue, options)) {
+      matchedCriteria.push(criterionKey);
+      matchedWeight += weight;
+    }
+  }
+  const viewHasContext = criteria.context !== void 0;
+  const requestHasContext = options?.context !== void 0;
+  if (viewHasContext && !requestHasContext) {
+    matchedWeight *= 0.1;
+  } else if (!viewHasContext && requestHasContext) {
+    matchedWeight *= 0.9;
+  }
+  if (totalWeight === 0) return { score: 0, matchedCriteria: [] };
+  const score = matchedWeight / totalWeight;
+  return { score, matchedCriteria };
+}
+function doesCriterionMatch(transaction, criterion, criterionValue, options) {
+  switch (criterion) {
+    case "recordType":
+      return matchesStringOrArray(
+        transaction.recordType,
+        criterionValue
+      );
+    case "functionName":
+      return matchesStringOrArray(
+        transaction.functionName,
+        criterionValue
+      );
+    case "standard":
+      return matchesStringOrArray(
+        transaction.standard,
+        criterionValue
+      );
+    case "contractAddress":
+      return matchesStringOrArray(
+        transaction.contractAddress,
+        criterionValue
+      );
+    case "chainId":
+      return matchesNumberOrArray(transaction.chainId, criterionValue);
+    case "context":
+      if (!options?.context) return false;
+      return matchesStringOrArray(options.context, criterionValue);
+    case "contextRequirements":
+      if (!options?.contextRequirements || !criterionValue) return false;
+      return areContextRequirementsCompatible(
+        options.contextRequirements,
+        criterionValue
+      );
+    case "customMatcher":
+      if (typeof criterionValue === "function") {
+        try {
+          const matchCount = criterionValue(transaction);
+          return matchCount > 0;
+        } catch (error) {
+          console.warn("Custom matcher threw error:", error);
+          return false;
+        }
+      }
+      return false;
+    default:
+      return false;
+  }
+}
+function matchesStringOrArray(value, criteria) {
+  if (!value || !criteria) return false;
+  if (Array.isArray(criteria)) {
+    return criteria.includes(value);
+  }
+  return value === criteria;
+}
+function matchesNumberOrArray(value, criteria) {
+  if (value === void 0 || criteria === void 0) return false;
+  if (Array.isArray(criteria)) {
+    return criteria.includes(value);
+  }
+  return value === criteria;
+}
+function areContextRequirementsCompatible(requested, viewRequirements) {
+  if (requested.detailLevel && viewRequirements.detailLevel) {
+    const detailOrder = ["minimal", "summary", "full", "debug"];
+    const requestedLevel = detailOrder.indexOf(requested.detailLevel);
+    const viewLevel = detailOrder.indexOf(viewRequirements.detailLevel);
+    if (viewLevel < requestedLevel) return false;
+  }
+  if (requested.maxHeight && viewRequirements.maxHeight) {
+    if (viewRequirements.maxHeight > requested.maxHeight) return false;
+  }
+  return true;
+}
+function calculateNativeFrameworkBonus(view, requestedFramework) {
+  if (requestedFramework === "lit") {
+    return 0;
+  }
+  if (requestedFramework === "vue" && view.frameworks.vue) {
+    return 0.15;
+  }
+  if (requestedFramework === "rn" && view.frameworks.rn) {
+    return 0.15;
+  }
+  return 0;
+}
+function findMatchingViews(transaction, views, options) {
+  const matches = [];
+  const minScore = options.minScore ?? 0;
+  for (const view of views) {
+    if (!view.frameworks[options.framework]) {
+      continue;
+    }
+    const { score, matchedCriteria } = calculateMatchScore(transaction, view, {
+      context: options.context,
+      contextRequirements: options.contextRequirements
+    });
+    if (score < minScore) {
+      continue;
+    }
+    const frameworkBonus = calculateNativeFrameworkBonus(
+      view,
+      options.framework
+    );
+    const finalScore = Math.min(1, score + frameworkBonus);
+    const match = {
+      view,
+      score: finalScore,
+      matchedCriteria,
+      frameworkConfig: options.includeFrameworkConfig ? view.frameworks[options.framework] : void 0
+    };
+    matches.push(match);
+  }
+  matches.sort((a, b) => {
+    if (a.score !== b.score) {
+      return b.score - a.score;
+    }
+    return b.view.priority - a.view.priority;
+  });
+  if (options.maxMatches) {
+    return matches.slice(0, options.maxMatches);
+  }
+  return matches;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CRITERIA_WEIGHTS,
+  calculateMatchScore,
+  findMatchingViews
+});
+//# sourceMappingURL=index.cjs.map

package/dist/utils/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/index.ts","../../src/utils/view-matcher.ts"],"sourcesContent":["export {\n  CRITERIA_WEIGHTS,\n  calculateMatchScore,\n  findMatchingViews,\n} from './view-matcher'\n","import type { DecoderResult } from '@lukso/transaction-decoder'\nimport type {\n  DecoderRecordForSelection,\n  ViewDefinition,\n  ViewMatch,\n  ViewMatchCriteria,\n  ViewMatchOptions,\n} from '../types/view-matching'\n\n/**\n * Weights for different matching criteria (higher = more important)\n * Context is optional - only weighted when both view and request specify context\n */\nexport const CRITERIA_WEIGHTS = {\n  recordType: 0.25, // Most specific to transaction type\n  functionName: 0.2, // Function-level specificity\n  context: 0.2, // Context specificity (when opt-in)\n  standard: 0.15, // LSP standard specificity\n  contractAddress: 0.1, // Contract-specific logic\n  contextRequirements: 0.05, // Context requirement matching\n  chainId: 0.03, // Network-specific behavior\n  customMatcher: 0.02, // Custom logic (lowest weight due to unpredictability)\n} as const\n\n/**\n * Calculate how well a view matches a transaction and context\n *\n * Context matching is opt-in:\n * - If view specifies context criteria, request MUST provide matching context\n * - If view has no context criteria, it matches any context (universal view)\n * - If request has no context, context-specific views are deprioritized\n *\n * Note: For batch operations (executeBatch, setDataBatch, etc.), this matches\n * against the parent transaction. Future enhancement could include matching\n * against child transactions for more granular view selection.\n */\nexport function calculateMatchScore(\n  transaction: DecoderResult,\n  view: ViewDefinition,\n  options?: Pick<ViewMatchOptions, 'context' | 'contextRequirements'>\n): { score: number; matchedCriteria: (keyof ViewMatchCriteria)[] } {\n  const { criteria } = view\n  const matchedCriteria: (keyof ViewMatchCriteria)[] = []\n  let totalWeight = 0\n  let matchedWeight = 0\n\n  // Check each criterion and accumulate scores\n  for (const [criterion, weight] of Object.entries(CRITERIA_WEIGHTS)) {\n    const criterionKey = criterion as keyof ViewMatchCriteria\n    const criterionValue = criteria[criterionKey]\n\n    if (criterionValue === undefined) continue\n\n    totalWeight += weight\n\n    // Special handling for customMatcher - use match count\n    if (\n      criterionKey === 'customMatcher' &&\n      typeof criterionValue === 'function'\n    ) {\n      try {\n        const matchCount = criterionValue(transaction)\n        if (matchCount > 0) {\n          matchedCriteria.push(criterionKey)\n          // Normalize match count to 0-1 range (cap at 10 conditions)\n          const normalizedScore = Math.min(matchCount / 10, 1)\n          matchedWeight += weight * normalizedScore\n        }\n      } catch (error) {\n        console.warn('Custom matcher threw error:', error)\n      }\n      continue\n    }\n\n    if (\n      doesCriterionMatch(transaction, criterionKey, criterionValue, options)\n    ) {\n      matchedCriteria.push(criterionKey)\n      matchedWeight += weight\n    }\n  }\n\n  // Handle context opt-in logic\n  const viewHasContext = criteria.context !== undefined\n  const requestHasContext = options?.context !== undefined\n\n  if (viewHasContext && !requestHasContext) {\n    // View requires specific context, but none provided - penalize heavily\n    matchedWeight *= 0.1 // Reduce score by 90%\n  } else if (!viewHasContext && requestHasContext) {\n    // Universal view matching specific context - slight penalty to prefer context-specific views\n    matchedWeight *= 0.9 // Reduce score by 10%\n  }\n\n  // If no criteria are defined, this view doesn't match\n  if (totalWeight === 0) return { score: 0, matchedCriteria: [] }\n\n  // Calculate final score (0-1)\n  const score = matchedWeight / totalWeight\n\n  return { score, matchedCriteria }\n}\n\n/**\n * Check if a specific criterion matches the transaction\n */\nfunction doesCriterionMatch(\n  transaction: DecoderResult,\n  criterion: keyof ViewMatchCriteria,\n  criterionValue: any,\n  options?: Pick<ViewMatchOptions, 'context' | 'contextRequirements'>\n): boolean {\n  switch (criterion) {\n    case 'recordType':\n      return matchesStringOrArray(\n        (transaction as DecoderRecordForSelection).recordType,\n        criterionValue\n      )\n\n    case 'functionName':\n      return matchesStringOrArray(\n        (transaction as DecoderRecordForSelection).functionName,\n        criterionValue\n      )\n\n    case 'standard':\n      return matchesStringOrArray(\n        (transaction as DecoderRecordForSelection).standard,\n        criterionValue\n      )\n\n    case 'contractAddress':\n      return matchesStringOrArray(\n        (transaction as DecoderRecordForSelection).contractAddress,\n        criterionValue\n      )\n\n    case 'chainId':\n      return matchesNumberOrArray(transaction.chainId, criterionValue)\n\n    case 'context':\n      if (!options?.context) return false // No context provided, can't match\n      return matchesStringOrArray(options.context, criterionValue)\n\n    case 'contextRequirements':\n      if (!options?.contextRequirements || !criterionValue) return false\n      return areContextRequirementsCompatible(\n        options.contextRequirements,\n        criterionValue\n      )\n\n    case 'customMatcher':\n      if (typeof criterionValue === 'function') {\n        try {\n          const matchCount = criterionValue(transaction)\n          // Match if any conditions matched (> 0)\n          // The actual count contributes to the score in calculateMatchScore\n          return matchCount > 0\n        } catch (error) {\n          console.warn('Custom matcher threw error:', error)\n          return false\n        }\n      }\n      return false\n\n    default:\n      return false\n  }\n}\n\n/**\n * Helper to match string values against string or array criteria\n */\nfunction matchesStringOrArray(\n  value: string | undefined,\n  criteria: string | string[]\n): boolean {\n  if (!value || !criteria) return false\n\n  if (Array.isArray(criteria)) {\n    return criteria.includes(value)\n  }\n\n  return value === criteria\n}\n\n/**\n * Helper to match number values against number or array criteria\n */\nfunction matchesNumberOrArray(\n  value: number | undefined,\n  criteria: number | number[]\n): boolean {\n  if (value === undefined || criteria === undefined) return false\n\n  if (Array.isArray(criteria)) {\n    return criteria.includes(value)\n  }\n\n  return value === criteria\n}\n\n/**\n * Check if context requirements are compatible\n */\nfunction areContextRequirementsCompatible(\n  requested: any,\n  viewRequirements: any\n): boolean {\n  // Simple compatibility check - can be extended\n  if (requested.detailLevel && viewRequirements.detailLevel) {\n    const detailOrder = ['minimal', 'summary', 'full', 'debug']\n    const requestedLevel = detailOrder.indexOf(requested.detailLevel)\n    const viewLevel = detailOrder.indexOf(viewRequirements.detailLevel)\n    if (viewLevel < requestedLevel) return false\n  }\n\n  if (requested.maxHeight && viewRequirements.maxHeight) {\n    if (viewRequirements.maxHeight > requested.maxHeight) return false\n  }\n\n  return true\n}\n\n/**\n * Calculate native framework priority bonus\n *\n * Native framework implementations (Vue, React Native) get priority over Lit fallbacks:\n * - Vue: +0.15 bonus when view has Vue implementation\n * - React Native (rn): +0.15 bonus when view has RN implementation\n * - Lit: NO bonus (Lit is the universal fallback)\n *\n * This ensures that when both native and Lit views exist for the same transaction:\n * - Vue app prefers Vue view (Vue score + 0.15 > Lit score)\n * - React Native app prefers RN view (RN score + 0.15 > Lit score)\n * - Other frameworks use Lit view (universal compatibility)\n */\nfunction calculateNativeFrameworkBonus(\n  view: ViewDefinition,\n  requestedFramework: 'lit' | 'vue' | 'rn'\n): number {\n  // Lit gets no bonus - it's the universal fallback\n  if (requestedFramework === 'lit') {\n    return 0\n  }\n\n  // Vue gets bonus if view has Vue implementation\n  if (requestedFramework === 'vue' && view.frameworks.vue) {\n    return 0.15\n  }\n\n  // React Native gets bonus if view has RN implementation\n  if (requestedFramework === 'rn' && view.frameworks.rn) {\n    return 0.15\n  }\n\n  return 0\n}\n\n/**\n * Find and score all matching views for a transaction\n *\n * Views are matched and sorted by:\n * 1. Match score (how well criteria match the transaction)\n * 2. Native framework bonus (Vue/RN get +0.15, Lit gets 0)\n * 3. View priority (manually set priority)\n *\n * This ensures that native framework views are preferred when available,\n * while Lit serves as a universal fallback.\n */\nexport function findMatchingViews(\n  transaction: DecoderResult,\n  views: ViewDefinition[],\n  options: ViewMatchOptions\n): ViewMatch[] {\n  const matches: ViewMatch[] = []\n  const minScore = options.minScore ?? 0\n\n  for (const view of views) {\n    // Skip if framework is not supported\n    if (!view.frameworks[options.framework]) {\n      continue\n    }\n\n    const { score, matchedCriteria } = calculateMatchScore(transaction, view, {\n      context: options.context,\n      contextRequirements: options.contextRequirements,\n    })\n\n    // Skip if score is below threshold\n    if (score < minScore) {\n      continue\n    }\n\n    // Apply native framework bonus (Vue/RN only, NOT Lit)\n    const frameworkBonus = calculateNativeFrameworkBonus(\n      view,\n      options.framework\n    )\n    const finalScore = Math.min(1, score + frameworkBonus)\n\n    const match: ViewMatch = {\n      view,\n      score: finalScore,\n      matchedCriteria,\n      frameworkConfig: options.includeFrameworkConfig\n        ? view.frameworks[options.framework]\n        : undefined,\n    }\n\n    matches.push(match)\n  }\n\n  // Sort by score (descending), then by priority (descending)\n  matches.sort((a, b) => {\n    if (a.score !== b.score) {\n      return b.score - a.score\n    }\n    return b.view.priority - a.view.priority\n  })\n\n  // Limit results if requested\n  if (options.maxMatches) {\n    return matches.slice(0, options.maxMatches)\n  }\n\n  return matches\n}\n\n/**\n * TODO: Future enhancement for batch operations\n *\n * For batch operations like executeBatch, setDataBatch, we might want to:\n * 1. Match against the batch container (current behavior)\n * 2. Also match against child transactions for more specific views\n * 3. Allow views to specify whether they handle batches vs individual items\n * 4. Support composite views that render both batch info + child items\n */\n"],"mappings":"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","names":[]}