codemeld 2.1.0

package/dist/parsers/js-analyzer.d.ts

@@ -0,0 +1,199 @@
+import type { StateVariable, EventHandler } from '../types.js';
+export interface PageTemplate {
+    functionName: string;
+    targetElement: string;
+    htmlContent: string;
+    route?: string;
+}
+export interface AnalyzedJS {
+    stateVars: StateVariable[];
+    effects: string[];
+    eventHandlers: EventHandler[];
+    imports: string[];
+    utilityCode: string[];
+    domManipulations: DOMManipulation[];
+    refs: RefDeclaration[];
+    fetchCalls: FetchCall[];
+    storageCalls: StorageCall[];
+    jqueryPatterns: JQueryPattern[];
+    domMutations: DOMMutation[];
+    timerCalls: TimerCall[];
+    pageTemplates: PageTemplate[];
+    interactivePatterns: InteractivePatterns;
+}
+export interface DOMManipulation {
+    type: 'querySelector' | 'getElementById' | 'getElementsByClassName' | 'innerHTML' | 'textContent' | 'setAttribute' | 'classList' | 'style';
+    selector: string;
+    action: string;
+    value: string;
+}
+export interface RefDeclaration {
+    name: string;
+    selector: string;
+    type: string;
+}
+export interface FetchCall {
+    url: string;
+    method: string;
+    hasBody: boolean;
+    variableName: string;
+}
+export interface StorageCall {
+    storageType: 'localStorage' | 'sessionStorage';
+    operation: 'getItem' | 'setItem' | 'removeItem';
+    key: string;
+    value?: string;
+}
+export interface JQueryPattern {
+    selector: string;
+    method: string;
+    args: string;
+    original: string;
+}
+export interface DOMMutation {
+    type: 'innerHTML' | 'textContent' | 'classList.add' | 'classList.remove' | 'classList.toggle' | 'style' | 'setAttribute' | 'appendChild' | 'removeChild' | 'insertBefore';
+    selector: string;
+    value: string;
+}
+export interface TimerCall {
+    type: 'setTimeout' | 'setInterval';
+    handler: string;
+    delay: string;
+    variableName?: string;
+}
+export interface ScrollRevealPattern {
+    /** CSS selector targeted (e.g., '.reveal') */
+    selector: string;
+    /** CSS property being toggled (e.g., 'animationPlayState') */
+    property: string;
+    /** Value set when intersecting (e.g., 'running') */
+    activeValue: string;
+    /** IntersectionObserver threshold */
+    threshold: number;
+}
+export interface TabPattern {
+    /** CSS selector for tab buttons (e.g., '.demo-tab') */
+    tabSelector: string;
+    /** CSS selector for tab panels (e.g., '.demo-panel') */
+    panelSelector: string;
+    /** Data attribute used to link tab to panel (e.g., 'data-tab') */
+    dataAttr: string;
+    /** Active class name (e.g., 'active') */
+    activeClass: string;
+}
+export interface AccordionPattern {
+    /** CSS selector for toggle buttons (e.g., '.faq-q') */
+    triggerSelector: string;
+    /** CSS selector for accordion items (e.g., '.faq-item') */
+    itemSelector: string;
+    /** Open/active class name (e.g., 'open') */
+    openClass: string;
+    /** Whether only one item can be open at a time */
+    singleOpen: boolean;
+}
+export interface ScrollClassPattern {
+    /** Element selector (e.g., '#nav') */
+    elementSelector: string;
+    /** Class to toggle (e.g., 'scrolled') */
+    className: string;
+    /** Scroll threshold in pixels (e.g., 20) */
+    threshold: number;
+}
+export interface CounterAnimationPattern {
+    /** CSS selector for counter elements */
+    selector: string;
+    /** Data attribute holding target value (e.g., 'data-target') */
+    dataAttr: string;
+}
+export interface CarouselPattern {
+    /** CSS selector for slide container */
+    containerSelector: string;
+    /** State variable name for current slide */
+    stateVar: string;
+    /** Whether auto-play was detected */
+    autoPlay: boolean;
+}
+export interface EventDelegationPattern {
+    /** Parent element selector */
+    parentSelector: string;
+    /** Target match (class, tag, or data attribute) */
+    targetMatch: string;
+    /** Event type */
+    event: string;
+    /** Handler body */
+    handler: string;
+}
+export interface DebouncePattern {
+    /** The function being debounced */
+    functionName: string;
+    /** Delay in ms */
+    delay: string;
+}
+export interface FormValidationPattern {
+    /** Form selector */
+    formSelector: string;
+    /** Validation methods used */
+    methods: string[];
+}
+export interface HistoryRoutingPattern {
+    /** Route paths detected */
+    routes: string[];
+    /** Type: hash or pushState */
+    type: 'hash' | 'pushState';
+}
+export interface MobileMenuPattern {
+    /** Hamburger button selector */
+    hamburgerSelector: string;
+    /** Mobile menu container selector */
+    menuSelector: string;
+    /** Open class name */
+    openClass: string;
+    /** Whether body overflow is toggled */
+    togglesBodyOverflow: boolean;
+}
+export interface FormHandlerPattern {
+    /** Input element selector/id */
+    inputSelector: string;
+    /** Button selector or adjacent */
+    buttonSelector: string;
+    /** Handler function name */
+    handlerName: string;
+    /** Whether it validates email */
+    isEmail: boolean;
+    /** Whether it has success feedback */
+    hasSuccessFeedback: boolean;
+}
+export interface RipplePattern {
+    /** CSS selectors for buttons that get ripple effect */
+    selectors: string[];
+}
+export interface InteractivePatterns {
+    scrollReveals: ScrollRevealPattern[];
+    tabs: TabPattern[];
+    accordions: AccordionPattern[];
+    scrollClasses: ScrollClassPattern[];
+    counterAnimations: CounterAnimationPattern[];
+    carousels: CarouselPattern[];
+    eventDelegations: EventDelegationPattern[];
+    debounces: DebouncePattern[];
+    formValidations: FormValidationPattern[];
+    historyRouting: HistoryRoutingPattern[];
+    mobileMenus: MobileMenuPattern[];
+    formHandlers: FormHandlerPattern[];
+    ripples: RipplePattern[];
+}
+/**
+ * Detect common interactive patterns via regex (IntersectionObserver, tabs, accordion, scroll classes, counters).
+ * These patterns are too high-level for AST-based detection, so we use regex on the raw source.
+ */
+export declare function detectInteractivePatterns(code: string): InteractivePatterns;
+/**
+ * Analyze vanilla JavaScript using Babel AST and extract React-convertible patterns.
+ */
+export declare function analyzeJS(code: string): AnalyzedJS;
+/**
+ * Convert an event handler body from DOM-manipulating code to React-style code.
+ * Handles common patterns: state mutations, DOM reads, form resets, preventDefault.
+ */
+export declare function convertEventHandlerToReact(handler: string, stateVars: StateVariable[]): string;
+//# sourceMappingURL=js-analyzer.d.ts.map

package/dist/parsers/js-analyzer.d.ts.map

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