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

package/dist/utils/index.d.cts

@@ -0,0 +1,47 @@
+import { DecoderResult } from '@lukso/transaction-decoder';
+import { ViewDefinition, ViewMatchOptions, ViewMatchCriteria, ViewMatch } from '../types/index.cjs';
+
+/**
+ * Weights for different matching criteria (higher = more important)
+ * Context is optional - only weighted when both view and request specify context
+ */
+declare const CRITERIA_WEIGHTS: {
+    readonly recordType: 0.25;
+    readonly functionName: 0.2;
+    readonly context: 0.2;
+    readonly standard: 0.15;
+    readonly contractAddress: 0.1;
+    readonly contextRequirements: 0.05;
+    readonly chainId: 0.03;
+    readonly customMatcher: 0.02;
+};
+/**
+ * Calculate how well a view matches a transaction and context
+ *
+ * Context matching is opt-in:
+ * - If view specifies context criteria, request MUST provide matching context
+ * - If view has no context criteria, it matches any context (universal view)
+ * - If request has no context, context-specific views are deprioritized
+ *
+ * Note: For batch operations (executeBatch, setDataBatch, etc.), this matches
+ * against the parent transaction. Future enhancement could include matching
+ * against child transactions for more granular view selection.
+ */
+declare function calculateMatchScore(transaction: DecoderResult, view: ViewDefinition, options?: Pick<ViewMatchOptions, 'context' | 'contextRequirements'>): {
+    score: number;
+    matchedCriteria: (keyof ViewMatchCriteria)[];
+};
+/**
+ * Find and score all matching views for a transaction
+ *
+ * Views are matched and sorted by:
+ * 1. Match score (how well criteria match the transaction)
+ * 2. Native framework bonus (Vue/RN get +0.15, Lit gets 0)
+ * 3. View priority (manually set priority)
+ *
+ * This ensures that native framework views are preferred when available,
+ * while Lit serves as a universal fallback.
+ */
+declare function findMatchingViews(transaction: DecoderResult, views: ViewDefinition[], options: ViewMatchOptions): ViewMatch[];
+
+export { CRITERIA_WEIGHTS, calculateMatchScore, findMatchingViews };

package/dist/utils/index.d.ts

@@ -0,0 +1,47 @@
+import { DecoderResult } from '@lukso/transaction-decoder';
+import { ViewDefinition, ViewMatchOptions, ViewMatchCriteria, ViewMatch } from '../types/index.js';
+
+/**
+ * Weights for different matching criteria (higher = more important)
+ * Context is optional - only weighted when both view and request specify context
+ */
+declare const CRITERIA_WEIGHTS: {
+    readonly recordType: 0.25;
+    readonly functionName: 0.2;
+    readonly context: 0.2;
+    readonly standard: 0.15;
+    readonly contractAddress: 0.1;
+    readonly contextRequirements: 0.05;
+    readonly chainId: 0.03;
+    readonly customMatcher: 0.02;
+};
+/**
+ * Calculate how well a view matches a transaction and context
+ *
+ * Context matching is opt-in:
+ * - If view specifies context criteria, request MUST provide matching context
+ * - If view has no context criteria, it matches any context (universal view)
+ * - If request has no context, context-specific views are deprioritized
+ *
+ * Note: For batch operations (executeBatch, setDataBatch, etc.), this matches
+ * against the parent transaction. Future enhancement could include matching
+ * against child transactions for more granular view selection.
+ */
+declare function calculateMatchScore(transaction: DecoderResult, view: ViewDefinition, options?: Pick<ViewMatchOptions, 'context' | 'contextRequirements'>): {
+    score: number;
+    matchedCriteria: (keyof ViewMatchCriteria)[];
+};
+/**
+ * Find and score all matching views for a transaction
+ *
+ * Views are matched and sorted by:
+ * 1. Match score (how well criteria match the transaction)
+ * 2. Native framework bonus (Vue/RN get +0.15, Lit gets 0)
+ * 3. View priority (manually set priority)
+ *
+ * This ensures that native framework views are preferred when available,
+ * while Lit serves as a universal fallback.
+ */
+declare function findMatchingViews(transaction: DecoderResult, views: ViewDefinition[], options: ViewMatchOptions): ViewMatch[];
+
+export { CRITERIA_WEIGHTS, calculateMatchScore, findMatchingViews };

package/dist/utils/index.js

@@ -0,0 +1,188 @@
+// 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;
+}
+export {
+  CRITERIA_WEIGHTS,
+  calculateMatchScore,
+  findMatchingViews
+};
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/view-matcher.ts"],"sourcesContent":["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":[]}

package/dist/view-loader-dD86QAlQ.d.cts

@@ -0,0 +1,121 @@
+import { ViewLoader, FrameworkViewConfig, ViewMatch } from './types/index.cjs';
+
+/**
+ * Error thrown when view loading fails
+ */
+declare class ViewLoadingError extends Error {
+    readonly loader: ViewLoader;
+    readonly config: FrameworkViewConfig;
+    readonly cause?: Error;
+    constructor(message: string, loader: ViewLoader, config: FrameworkViewConfig, cause?: Error);
+}
+/**
+ * Framework-agnostic view loader that handles different loading strategies
+ */
+declare class UniversalViewLoader {
+    private cache;
+    /**
+     * Load a component based on the framework configuration
+     */
+    loadComponent(config: FrameworkViewConfig): Promise<any>;
+    /**
+     * Load a component from a view match
+     */
+    loadFromMatch(match: ViewMatch): Promise<any>;
+    /**
+     * Load component using the specific strategy
+     */
+    private loadByStrategy;
+    /**
+     * Dynamic import strategy (most common)
+     * Supports both static strings and lazy-loaded callbacks
+     */
+    private loadDynamicImport;
+    /**
+     * Static import strategy (requires bundler support)
+     * Supports both static strings and lazy-loaded callbacks
+     */
+    private loadStaticImport;
+    /**
+     * Custom element strategy (for Lit components)
+     */
+    private loadCustomElement;
+    /**
+     * Registry lookup strategy (for pre-registered components)
+     */
+    private loadFromRegistry;
+    /**
+     * Generate cache key for component config
+     */
+    private getCacheKey;
+    /**
+     * Clear the component cache
+     */
+    clearCache(): void;
+    /**
+     * Get cache statistics
+     */
+    getCacheStats(): {
+        size: number;
+        keys: string[];
+    };
+}
+/**
+ * Get the global view loader
+ */
+declare function getGlobalLoader(): UniversalViewLoader;
+/**
+ * Set a custom global loader (useful for testing)
+ */
+declare function setGlobalLoader(loader: UniversalViewLoader): void;
+/**
+ * Framework-specific helpers for strategically optimized loading patterns
+ *
+ * Following our Suffering Economics optimization, we support:
+ * - Lit Web Components (universal web compatibility) - REQUIRED
+ * - Vue (native Vue optimization) - OPTIONAL
+ * - React Native (mobile-native optimization) - OPTIONAL (WebView fallback available)
+ *
+ * All loaders support lazy loading via callbacks:
+ * ```typescript
+ * // Static (bundled)
+ * vueComponent('./Component.vue')
+ *
+ * // Lazy (loaded on demand)
+ * vueComponent(() => import('./Component.vue'))
+ * ```
+ */
+declare const LoaderHelpers: {
+    /**
+     * Create a Lit custom element loader (universal web compatibility)
+     */
+    litComponent(tagName: string): ViewLoader;
+    /**
+     * Create a Vue component loader (native Vue, optional)
+     * Supports both static paths and lazy-loaded callbacks
+     */
+    vueComponent(path: string | (() => Promise<any>)): ViewLoader;
+    /**
+     * Create a React Native JSX dynamic import loader (mobile-native, optional)
+     * Supports both static paths and lazy-loaded callbacks
+     */
+    rnComponent(path: string | (() => Promise<any>)): ViewLoader;
+    /**
+     * Create a custom loader function for advanced use cases
+     */
+    custom(loader: (config: FrameworkViewConfig) => Promise<any>): ViewLoader;
+    /**
+     * @deprecated Use litComponent() instead. This exists for compilation pipeline compatibility.
+     */
+    vueToLitCompiled(tagName: string): ViewLoader;
+    /**
+     * @deprecated Use litComponent() instead. This exists for compilation pipeline compatibility.
+     */
+    reactToLitCompiled(tagName: string): ViewLoader;
+    /**
+     * @deprecated Use rnComponent() instead. Updated for better TypeScript support.
+     */
+    reactNativeComponent(path: string): ViewLoader;
+};
+
+export { LoaderHelpers as L, UniversalViewLoader as U, ViewLoadingError as V, getGlobalLoader as g, setGlobalLoader as s };

package/dist/view-loader-ii8AxiQR.d.ts

@@ -0,0 +1,121 @@
+import { ViewLoader, FrameworkViewConfig, ViewMatch } from './types/index.js';
+
+/**
+ * Error thrown when view loading fails
+ */
+declare class ViewLoadingError extends Error {
+    readonly loader: ViewLoader;
+    readonly config: FrameworkViewConfig;
+    readonly cause?: Error;
+    constructor(message: string, loader: ViewLoader, config: FrameworkViewConfig, cause?: Error);
+}
+/**
+ * Framework-agnostic view loader that handles different loading strategies
+ */
+declare class UniversalViewLoader {
+    private cache;
+    /**
+     * Load a component based on the framework configuration
+     */
+    loadComponent(config: FrameworkViewConfig): Promise<any>;
+    /**
+     * Load a component from a view match
+     */
+    loadFromMatch(match: ViewMatch): Promise<any>;
+    /**
+     * Load component using the specific strategy
+     */
+    private loadByStrategy;
+    /**
+     * Dynamic import strategy (most common)
+     * Supports both static strings and lazy-loaded callbacks
+     */
+    private loadDynamicImport;
+    /**
+     * Static import strategy (requires bundler support)
+     * Supports both static strings and lazy-loaded callbacks
+     */
+    private loadStaticImport;
+    /**
+     * Custom element strategy (for Lit components)
+     */
+    private loadCustomElement;
+    /**
+     * Registry lookup strategy (for pre-registered components)
+     */
+    private loadFromRegistry;
+    /**
+     * Generate cache key for component config
+     */
+    private getCacheKey;
+    /**
+     * Clear the component cache
+     */
+    clearCache(): void;
+    /**
+     * Get cache statistics
+     */
+    getCacheStats(): {
+        size: number;
+        keys: string[];
+    };
+}
+/**
+ * Get the global view loader
+ */
+declare function getGlobalLoader(): UniversalViewLoader;
+/**
+ * Set a custom global loader (useful for testing)
+ */
+declare function setGlobalLoader(loader: UniversalViewLoader): void;
+/**
+ * Framework-specific helpers for strategically optimized loading patterns
+ *
+ * Following our Suffering Economics optimization, we support:
+ * - Lit Web Components (universal web compatibility) - REQUIRED
+ * - Vue (native Vue optimization) - OPTIONAL
+ * - React Native (mobile-native optimization) - OPTIONAL (WebView fallback available)
+ *
+ * All loaders support lazy loading via callbacks:
+ * ```typescript
+ * // Static (bundled)
+ * vueComponent('./Component.vue')
+ *
+ * // Lazy (loaded on demand)
+ * vueComponent(() => import('./Component.vue'))
+ * ```
+ */
+declare const LoaderHelpers: {
+    /**
+     * Create a Lit custom element loader (universal web compatibility)
+     */
+    litComponent(tagName: string): ViewLoader;
+    /**
+     * Create a Vue component loader (native Vue, optional)
+     * Supports both static paths and lazy-loaded callbacks
+     */
+    vueComponent(path: string | (() => Promise<any>)): ViewLoader;
+    /**
+     * Create a React Native JSX dynamic import loader (mobile-native, optional)
+     * Supports both static paths and lazy-loaded callbacks
+     */
+    rnComponent(path: string | (() => Promise<any>)): ViewLoader;
+    /**
+     * Create a custom loader function for advanced use cases
+     */
+    custom(loader: (config: FrameworkViewConfig) => Promise<any>): ViewLoader;
+    /**
+     * @deprecated Use litComponent() instead. This exists for compilation pipeline compatibility.
+     */
+    vueToLitCompiled(tagName: string): ViewLoader;
+    /**
+     * @deprecated Use litComponent() instead. This exists for compilation pipeline compatibility.
+     */
+    reactToLitCompiled(tagName: string): ViewLoader;
+    /**
+     * @deprecated Use rnComponent() instead. Updated for better TypeScript support.
+     */
+    reactNativeComponent(path: string): ViewLoader;
+};
+
+export { LoaderHelpers as L, UniversalViewLoader as U, ViewLoadingError as V, getGlobalLoader as g, setGlobalLoader as s };

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@lukso/transaction-view-headless",
+  "version": "0.2.2-dev.a8c9315",
+  "description": "Framework-agnostic transaction decoder and view selection system",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./types": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/types/index.js",
+      "require": "./dist/types/index.cjs"
+    },
+    "./composables": {
+      "types": "./dist/composables/index.d.ts",
+      "import": "./dist/composables/index.js",
+      "require": "./dist/composables/index.cjs"
+    },
+    "./registry": {
+      "types": "./dist/registry/index.d.ts",
+      "import": "./dist/registry/index.js",
+      "require": "./dist/registry/index.cjs"
+    },
+    "./utils": {
+      "types": "./dist/utils/index.d.ts",
+      "import": "./dist/utils/index.js",
+      "require": "./dist/utils/index.cjs"
+    }
+  },
+  "dependencies": {
+    "@preact/signals-core": "^1.12.1",
+    "@tanstack/query-core": "^5.90.12",
+    "viem": "^2.41.2",
+    "@lukso/transaction-decoder": "1.0.1-dev.a8c9315"
+  },
+  "devDependencies": {
+    "@types/node": "^24.10.1",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3"
+  },
+  "peerDependencies": {
+    "@tanstack/react-query": "^5.0.0",
+    "@tanstack/vue-query": "^5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@tanstack/vue-query": {
+      "optional": true
+    },
+    "@tanstack/react-query": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "dev-alt": "tsup --watch",
+    "clean": "rm -rf dist"
+  }
+}

package/src/composables/index.ts

@@ -0,0 +1,59 @@
+// Configuration exports
+export type { LuksoConfig } from '../config/lukso-config'
+export {
+  cacheAddress,
+  clearAddressCache,
+  getCachedAddress,
+  getLuksoConfig,
+  isAddressResolutionEnabled,
+  setLuksoConfig,
+  useLuksoMainnet,
+  useLuksoTestnet,
+} from '../config/lukso-config'
+// Address resolution exports
+export type {
+  AddressResolutionState,
+  ResolvedAddress,
+} from '../hooks/useAddressResolution'
+export {
+  createAddressResolutionState,
+  resolveAddress,
+  resolveAddresses,
+  resolveAddressWithState,
+} from '../hooks/useAddressResolution'
+export type {
+  ViewContext,
+  ViewContextRequirements,
+  ViewVariant,
+} from '../types/view-contexts'
+export type { ViewMatch } from '../types/view-matching'
+export type {
+  AddressImageData,
+  ImageLoadOptions,
+  ImageResult,
+} from './use-image-loader'
+export {
+  useAddressResolver,
+  useImageLoader,
+} from './use-image-loader'
+// Transaction playback exports
+export type {
+  PlaybackIndexResult,
+  TransactionPlaybackOptions,
+  TransactionPlaybackState,
+} from './use-transaction-playback'
+export {
+  createTransactionPlayback,
+  getValidPlaybackIndices,
+  isValidPlaybackIndex,
+  useTransactionPlayback,
+} from './use-transaction-playback'
+export type {
+  UseTransactionViewOptions,
+  UseTransactionViewResult,
+} from './use-transaction-view'
+export {
+  findAllTransactionViews,
+  findBestTransactionView,
+  useTransactionView,
+} from './use-transaction-view'