lwc-convert 1.0.0

package/dist/transformers/aura-to-lwc/events.js

@@ -0,0 +1,262 @@
+"use strict";
+/**
+ * Transform Aura event patterns to LWC CustomEvent
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.transformAuraEvent = transformAuraEvent;
+exports.generatePubSubUtility = generatePubSubUtility;
+exports.generateMessageChannel = generateMessageChannel;
+exports.generateLmsPublishCode = generateLmsPublishCode;
+exports.generateLmsSubscribeCode = generateLmsSubscribeCode;
+exports.transformEventHandler = transformEventHandler;
+const logger_1 = require("../../utils/logger");
+/**
+ * Convert Aura event name to LWC event name
+ * MyEvent -> myevent
+ * onMyEvent -> myevent
+ */
+function toLwcEventName(auraName) {
+    let name = auraName;
+    // Remove 'on' prefix if present
+    if (name.startsWith('on')) {
+        name = name.substring(2);
+    }
+    // Remove namespace prefix (e.g., c:MyEvent -> MyEvent)
+    if (name.includes(':')) {
+        name = name.split(':')[1];
+    }
+    // Convert to lowercase (LWC convention)
+    return name.toLowerCase();
+}
+/**
+ * Transform a registered Aura event to LWC CustomEvent
+ */
+function transformAuraEvent(event, handler) {
+    const warnings = [];
+    const lwcEventName = toLwcEventName(event.name);
+    // Check if this is an application event (namespace indicates)
+    const isApplicationEvent = event.type.includes(':') && !event.type.startsWith('c:');
+    if (isApplicationEvent) {
+        warnings.push(`"${event.type}" is an application event - consider using pub/sub pattern or Lightning Message Service`);
+    }
+    // Generate dispatch code
+    const dispatchCode = `
+    // Fire the ${event.name} event
+    this.dispatchEvent(new CustomEvent('${lwcEventName}', {
+        detail: {
+            // TODO: Add event data properties here
+        },
+        bubbles: ${isApplicationEvent},
+        composed: ${isApplicationEvent}
+    }));`;
+    // Generate handler code
+    const handlerMethod = handler?.action?.replace('{!c.', '').replace('}', '') || `handle${event.name}`;
+    const handlerCode = `
+    // Handler for ${event.name} event
+    ${handlerMethod}(event) {
+        const detail = event.detail;
+        // TODO: Handle event data
+    }`;
+    // Generate parent binding (in parent component's template)
+    const parentBinding = `on${lwcEventName}={${handlerMethod}}`;
+    logger_1.logger.debug(`Transformed event: ${event.name} -> ${lwcEventName}`);
+    return {
+        auraEventName: event.name,
+        auraEventType: event.type,
+        lwcEventName,
+        isApplicationEvent,
+        handlerMethod,
+        warnings,
+        code: {
+            dispatch: dispatchCode.trim(),
+            handler: handlerCode.trim(),
+            parentBinding,
+        },
+    };
+}
+/**
+ * Generate pub/sub utility for application events
+ */
+function generatePubSubUtility() {
+    return `/**
+ * Pub/Sub utility for component communication
+ * Use this when converting Aura application events that need cross-component communication
+ */
+
+const events = {};
+
+const registerListener = (eventName, callback, thisArg) => {
+    if (!events[eventName]) {
+        events[eventName] = [];
+    }
+    const duplicate = events[eventName].find((listener) => {
+        return listener.callback === callback && listener.thisArg === thisArg;
+    });
+    if (!duplicate) {
+        events[eventName].push({ callback, thisArg });
+    }
+};
+
+const unregisterListener = (eventName, callback, thisArg) => {
+    if (events[eventName]) {
+        events[eventName] = events[eventName].filter(
+            (listener) =>
+                listener.callback !== callback || listener.thisArg !== thisArg
+        );
+    }
+};
+
+const unregisterAllListeners = (thisArg) => {
+    Object.keys(events).forEach((eventName) => {
+        events[eventName] = events[eventName].filter(
+            (listener) => listener.thisArg !== thisArg
+        );
+    });
+};
+
+const fireEvent = (eventName, detail) => {
+    if (events[eventName]) {
+        events[eventName].forEach((listener) => {
+            try {
+                listener.callback.call(listener.thisArg, detail);
+            } catch (error) {
+                console.error('Error in event listener:', error);
+            }
+        });
+    }
+};
+
+export { registerListener, unregisterListener, unregisterAllListeners, fireEvent };
+`;
+}
+/**
+ * Generate Lightning Message Service channel definition
+ */
+function generateMessageChannel(eventName, description) {
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<LightningMessageChannel xmlns="http://soap.sforce.com/2006/04/metadata">
+    <description>${description || `Message channel for ${eventName} communication`}</description>
+    <isExposed>true</isExposed>
+    <lightningMessageFields>
+        <description>The payload of the message</description>
+        <fieldName>payload</fieldName>
+    </lightningMessageFields>
+    <masterLabel>${eventName}</masterLabel>
+</LightningMessageChannel>
+`;
+}
+/**
+ * Generate LMS usage code for publishing
+ */
+function generateLmsPublishCode(channelName) {
+    return `
+// Import the message channel
+import { publish, MessageContext } from 'lightning/messageService';
+import ${channelName.toUpperCase()}_CHANNEL from '@salesforce/messageChannel/${channelName}__c';
+
+// Wire the message context
+@wire(MessageContext)
+messageContext;
+
+// Publish a message
+publishMessage(data) {
+    const message = {
+        payload: data
+    };
+    publish(this.messageContext, ${channelName.toUpperCase()}_CHANNEL, message);
+}`;
+}
+/**
+ * Generate LMS usage code for subscribing
+ */
+function generateLmsSubscribeCode(channelName) {
+    return `
+// Import the message channel
+import {
+    subscribe,
+    unsubscribe,
+    APPLICATION_SCOPE,
+    MessageContext
+} from 'lightning/messageService';
+import ${channelName.toUpperCase()}_CHANNEL from '@salesforce/messageChannel/${channelName}__c';
+
+// Wire the message context
+@wire(MessageContext)
+messageContext;
+
+subscription = null;
+
+// Subscribe in connectedCallback
+connectedCallback() {
+    this.subscribeToChannel();
+}
+
+subscribeToChannel() {
+    if (!this.subscription) {
+        this.subscription = subscribe(
+            this.messageContext,
+            ${channelName.toUpperCase()}_CHANNEL,
+            (message) => this.handleMessage(message),
+            { scope: APPLICATION_SCOPE }
+        );
+    }
+}
+
+handleMessage(message) {
+    const payload = message.payload;
+    // TODO: Handle the received message
+}
+
+// Unsubscribe in disconnectedCallback
+disconnectedCallback() {
+    if (this.subscription) {
+        unsubscribe(this.subscription);
+        this.subscription = null;
+    }
+}`;
+}
+/**
+ * Transform Aura component event handler binding
+ */
+function transformEventHandler(handler) {
+    const warnings = [];
+    let templateBinding = '';
+    let methodName = '';
+    // Extract method name from {!c.methodName}
+    const actionMatch = handler.action.match(/\{!c\.(\w+)\}/);
+    if (actionMatch) {
+        methodName = actionMatch[1];
+    }
+    else {
+        methodName = handler.action;
+        warnings.push(`Could not parse action "${handler.action}" - verify method name`);
+    }
+    // Handle different event types
+    if (handler.event.startsWith('c:')) {
+        // Custom component event - use on<eventname> binding
+        const eventName = handler.event.substring(2).toLowerCase();
+        templateBinding = `on${eventName}={${methodName}}`;
+    }
+    else if (handler.event.includes(':')) {
+        // Namespace event - might be platform event
+        const eventName = handler.event.split(':')[1].toLowerCase();
+        if (handler.event.startsWith('force:')) {
+            warnings.push(`Platform event "${handler.event}" - may need alternative approach in LWC`);
+        }
+        templateBinding = `on${eventName}={${methodName}}`;
+    }
+    else {
+        // Simple event name
+        templateBinding = `on${handler.event.toLowerCase()}={${methodName}}`;
+    }
+    // Handle phase attribute (capture vs bubble)
+    if (handler.phase === 'capture') {
+        warnings.push('Capture phase handler found - LWC supports this via addEventListener with { capture: true }');
+    }
+    return {
+        templateBinding,
+        methodName,
+        warnings,
+    };
+}
+//# sourceMappingURL=events.js.map

package/dist/transformers/aura-to-lwc/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../src/transformers/aura-to-lwc/events.ts"],"names":[],"mappings":"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"}

package/dist/transformers/aura-to-lwc/markup.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Transform Aura markup to LWC HTML template
+ */
+import { ParsedAuraMarkup } from '../../parsers/aura/markup-parser';
+export interface TransformedMarkup {
+    html: string;
+    warnings: string[];
+    usedDirectives: string[];
+    usedComponents: string[];
+    /** LMS channels detected from lightning:messageChannel */
+    lmsChannels: LmsChannelConfig[];
+    /** force:recordData instances to convert to @wire */
+    recordDataServices: RecordDataConfig[];
+    /** aura:set facets for slot conversion */
+    facetContent: FacetContent[];
+    /** Complex expressions converted to getters */
+    detectedGetters: DetectedGetter[];
+}
+export interface DetectedGetter {
+    name: string;
+    expression: string;
+}
+/** LMS channel configuration from lightning:messageChannel */
+export interface LmsChannelConfig {
+    channelName: string;
+    auraId: string;
+    onMessageHandler?: string;
+    scope?: string;
+    /** True if this component only publishes (no onMessage handler) */
+    isPublisherOnly?: boolean;
+}
+/** force:recordData configuration */
+export interface RecordDataConfig {
+    auraId: string;
+    recordIdBinding: string;
+    fields: string[];
+    targetFields?: string;
+    targetRecord?: string;
+    targetError?: string;
+    mode?: string;
+}
+/** Facet content from aura:set */
+export interface FacetContent {
+    attributeName: string;
+    content: string;
+}
+/**
+ * Transform parsed Aura markup to LWC HTML
+ */
+export declare function transformAuraMarkup(parsed: ParsedAuraMarkup): TransformedMarkup;
+//# sourceMappingURL=markup.d.ts.map

package/dist/transformers/aura-to-lwc/markup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markup.d.ts","sourceRoot":"","sources":["../../../src/transformers/aura-to-lwc/markup.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAIpE,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,0DAA0D;IAC1D,WAAW,EAAE,gBAAgB,EAAE,CAAC;IAChC,qDAAqD;IACrD,kBAAkB,EAAE,gBAAgB,EAAE,CAAC;IACvC,0CAA0C;IAC1C,YAAY,EAAE,YAAY,EAAE,CAAC;IAC7B,+CAA+C;IAC/C,eAAe,EAAE,cAAc,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,8DAA8D;AAC9D,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,qCAAqC;AACrC,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,kCAAkC;AAClC,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB;AA2gBD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,GAAG,iBAAiB,CAkC/E"}