@lokascript/vite-plugin 1.0.0 → 1.1.0

package/dist/index.d.cts

@@ -153,6 +153,27 @@ interface CustomLanguageKeywords {
      */
     extend?: boolean;
 }
+/**
+ * HTMX/Fixi attribute usage information
+ */
+interface HtmxUsage {
+    /** Whether any htmx attributes were found */
+    hasHtmxAttributes: boolean;
+    /** Whether any fixi-specific attributes were found (fx-action, etc.) */
+    hasFixiAttributes: boolean;
+    /** HTTP methods used (GET, POST, PUT, PATCH, DELETE) */
+    httpMethods: Set<string>;
+    /** Swap strategies used (innerHTML, morph, delete, beforeend, etc.) */
+    swapStrategies: Set<string>;
+    /** hx-on:* handler values (raw hyperscript) */
+    onHandlers: string[];
+    /** Trigger modifiers detected (debounce, throttle, once) */
+    triggerModifiers: Set<string>;
+    /** URL management strategies (push-url, replace-url) */
+    urlManagement: Set<string>;
+    /** Whether hx-confirm is used */
+    usesConfirm: boolean;
+}
 /**
  * Usage information detected from a single file
  */
@@ -165,6 +186,8 @@ interface FileUsage {
     positional: boolean;
     /** Non-English languages detected in hyperscript (ISO 639-1 codes) */
     detectedLanguages: Set<string>;
+    /** HTMX/Fixi attribute usage (if detected) */
+    htmx?: HtmxUsage;
 }
 /**
  * Aggregated usage information across all files
@@ -178,6 +201,8 @@ interface AggregatedUsage {
     positional: boolean;
     /** All non-English languages detected across all files */
     detectedLanguages: Set<string>;
+    /** Aggregated HTMX/Fixi usage across all files */
+    htmx: HtmxUsage;
     /** Map of file paths to their usage */
     fileUsage: Map<string, FileUsage>;
 }

package/dist/index.d.ts

@@ -153,6 +153,27 @@ interface CustomLanguageKeywords {
      */
     extend?: boolean;
 }
+/**
+ * HTMX/Fixi attribute usage information
+ */
+interface HtmxUsage {
+    /** Whether any htmx attributes were found */
+    hasHtmxAttributes: boolean;
+    /** Whether any fixi-specific attributes were found (fx-action, etc.) */
+    hasFixiAttributes: boolean;
+    /** HTTP methods used (GET, POST, PUT, PATCH, DELETE) */
+    httpMethods: Set<string>;
+    /** Swap strategies used (innerHTML, morph, delete, beforeend, etc.) */
+    swapStrategies: Set<string>;
+    /** hx-on:* handler values (raw hyperscript) */
+    onHandlers: string[];
+    /** Trigger modifiers detected (debounce, throttle, once) */
+    triggerModifiers: Set<string>;
+    /** URL management strategies (push-url, replace-url) */
+    urlManagement: Set<string>;
+    /** Whether hx-confirm is used */
+    usesConfirm: boolean;
+}
 /**
  * Usage information detected from a single file
  */
@@ -165,6 +186,8 @@ interface FileUsage {
     positional: boolean;
     /** Non-English languages detected in hyperscript (ISO 639-1 codes) */
     detectedLanguages: Set<string>;
+    /** HTMX/Fixi attribute usage (if detected) */
+    htmx?: HtmxUsage;
 }
 /**
  * Aggregated usage information across all files
@@ -178,6 +201,8 @@ interface AggregatedUsage {
     positional: boolean;
     /** All non-English languages detected across all files */
     detectedLanguages: Set<string>;
+    /** Aggregated HTMX/Fixi usage across all files */
+    htmx: HtmxUsage;
     /** Map of file paths to their usage */
     fileUsage: Map<string, FileUsage>;
 }

package/dist/index.js

@@ -791,6 +791,15 @@ function getOptimalRegion(languages) {
 }
 
 // src/scanner.ts
+var HTMX_REQUEST_PATTERN = /\b(hx-get|hx-post|hx-put|hx-patch|hx-delete)\s*=\s*["']([^"']+)["']/gi;
+var FIXI_ACTION_PATTERN = /\bfx-action\s*=\s*["']([^"']+)["']/gi;
+var FIXI_METHOD_PATTERN = /\bfx-method\s*=\s*["'](GET|POST|PUT|PATCH|DELETE)["']/gi;
+var HTMX_SWAP_PATTERN = /\b(hx-swap|fx-swap)\s*=\s*["']([^"']+)["']/gi;
+var HTMX_TARGET_PATTERN = /\b(hx-target|fx-target)\s*=\s*["']([^"']+)["']/gi;
+var HTMX_TRIGGER_PATTERN = /\b(hx-trigger|fx-trigger)\s*=\s*["']([^"']+)["']/gi;
+var HTMX_URL_PATTERN = /\b(hx-push-url|hx-replace-url)\s*=\s*["'][^"']+["']/gi;
+var HTMX_CONFIRM_PATTERN = /\bhx-confirm\s*=\s*["']/gi;
+var HTMX_ON_PATTERN = /\bhx-on:(\w+)\s*=\s*["']([^"']+)["']/g;
 function toRegex(pattern, defaultPattern) {
   if (!pattern) return defaultPattern;
   if (pattern instanceof RegExp) return pattern;
@@ -848,12 +857,29 @@ var Scanner = class {
     while (match = scriptPattern.exec(code)) {
       this.analyzeScript(match[1], usage);
     }
-    if (this.debug && (usage.commands.size > 0 || usage.blocks.size > 0 || usage.detectedLanguages.size > 0)) {
+    const htmxUsage = this.scanHtmxAttributes(code);
+    if (htmxUsage.hasHtmxAttributes) {
+      usage.htmx = htmxUsage;
+      this.inferCommandsFromHtmx(htmxUsage, usage);
+      for (const handlerCode of htmxUsage.onHandlers) {
+        this.analyzeScript(handlerCode, usage);
+      }
+      if (/hx-target\s*=\s*["'](closest|next|previous|find)\s/i.test(code)) {
+        usage.positional = true;
+      }
+    }
+    if (this.debug && (usage.commands.size > 0 || usage.blocks.size > 0 || usage.detectedLanguages.size > 0 || usage.htmx?.hasHtmxAttributes)) {
       console.log(`[hyperfixi] Scanned ${id}:`, {
         commands: [...usage.commands],
         blocks: [...usage.blocks],
         positional: usage.positional,
-        languages: [...usage.detectedLanguages]
+        languages: [...usage.detectedLanguages],
+        htmx: usage.htmx ? {
+          hasHtmxAttributes: usage.htmx.hasHtmxAttributes,
+          hasFixiAttributes: usage.htmx.hasFixiAttributes,
+          httpMethods: [...usage.htmx.httpMethods],
+          swapStrategies: [...usage.htmx.swapStrategies]
+        } : void 0
       });
     }
     return usage;
@@ -881,6 +907,93 @@ var Scanner = class {
       usage.detectedLanguages.add(lang);
     }
   }
+  /**
+   * Scan for htmx/fixi attributes
+   */
+  scanHtmxAttributes(code) {
+    const usage = {
+      hasHtmxAttributes: false,
+      hasFixiAttributes: false,
+      httpMethods: /* @__PURE__ */ new Set(),
+      swapStrategies: /* @__PURE__ */ new Set(),
+      onHandlers: [],
+      triggerModifiers: /* @__PURE__ */ new Set(),
+      urlManagement: /* @__PURE__ */ new Set(),
+      usesConfirm: false
+    };
+    let match;
+    const requestPattern = new RegExp(HTMX_REQUEST_PATTERN.source, "gi");
+    while (match = requestPattern.exec(code)) {
+      usage.hasHtmxAttributes = true;
+      usage.httpMethods.add(match[1].replace("hx-", "").toUpperCase());
+    }
+    if (new RegExp(FIXI_ACTION_PATTERN.source, "gi").test(code)) {
+      usage.hasHtmxAttributes = true;
+      usage.hasFixiAttributes = true;
+    }
+    const fixiMethodPattern = new RegExp(FIXI_METHOD_PATTERN.source, "gi");
+    while (match = fixiMethodPattern.exec(code)) {
+      usage.hasHtmxAttributes = true;
+      usage.hasFixiAttributes = true;
+      usage.httpMethods.add(match[1].toUpperCase());
+    }
+    const swapPattern = new RegExp(HTMX_SWAP_PATTERN.source, "gi");
+    while (match = swapPattern.exec(code)) {
+      usage.hasHtmxAttributes = true;
+      usage.swapStrategies.add(match[2].split(/\s+/)[0]);
+    }
+    const triggerPattern = new RegExp(HTMX_TRIGGER_PATTERN.source, "gi");
+    while (match = triggerPattern.exec(code)) {
+      usage.hasHtmxAttributes = true;
+      const trigger = match[2];
+      if (/delay:/i.test(trigger)) usage.triggerModifiers.add("debounce");
+      if (/throttle:/i.test(trigger)) usage.triggerModifiers.add("throttle");
+      if (/\bonce\b/i.test(trigger)) usage.triggerModifiers.add("once");
+    }
+    if (new RegExp(HTMX_URL_PATTERN.source, "gi").test(code)) {
+      usage.hasHtmxAttributes = true;
+      if (/hx-push-url/i.test(code)) usage.urlManagement.add("push-url");
+      if (/hx-replace-url/i.test(code)) usage.urlManagement.add("replace-url");
+    }
+    if (new RegExp(HTMX_CONFIRM_PATTERN.source, "gi").test(code)) {
+      usage.hasHtmxAttributes = true;
+      usage.usesConfirm = true;
+    }
+    const onPattern = new RegExp(HTMX_ON_PATTERN.source, "g");
+    while (match = onPattern.exec(code)) {
+      usage.hasHtmxAttributes = true;
+      usage.onHandlers.push(match[2]);
+    }
+    const targetPattern = new RegExp(HTMX_TARGET_PATTERN.source, "gi");
+    while (match = targetPattern.exec(code)) {
+      usage.hasHtmxAttributes = true;
+    }
+    return usage;
+  }
+  /**
+   * Infer commands from htmx usage
+   */
+  inferCommandsFromHtmx(htmx, usage) {
+    if (htmx.httpMethods.size > 0) {
+      usage.blocks.add("fetch");
+      usage.commands.add("put");
+    }
+    for (const swap of htmx.swapStrategies) {
+      switch (swap.toLowerCase()) {
+        case "morph":
+          usage.commands.add("morph");
+          break;
+        case "delete":
+          usage.commands.add("remove");
+          break;
+        default:
+          usage.commands.add("put");
+      }
+    }
+    if (htmx.usesConfirm) {
+      usage.blocks.add("if");
+    }
+  }
   /**
    * Scan all files in a project directory
    * Used during production build to scan the entire codebase
@@ -931,7 +1044,8 @@ var Aggregator = class {
       const blocksEqual = this.setsEqual(existing.blocks, usage.blocks);
       const positionalEqual = existing.positional === usage.positional;
       const languagesEqual = this.setsEqual(existing.detectedLanguages, usage.detectedLanguages);
-      if (commandsEqual && blocksEqual && positionalEqual && languagesEqual) {
+      const htmxEqual = this.htmxUsageEqual(existing.htmx, usage.htmx);
+      if (commandsEqual && blocksEqual && positionalEqual && languagesEqual && htmxEqual) {
         return false;
       }
     }
@@ -961,17 +1075,38 @@ var Aggregator = class {
     const blocks = /* @__PURE__ */ new Set();
     const detectedLanguages = /* @__PURE__ */ new Set();
     let positional = false;
+    const htmx = {
+      hasHtmxAttributes: false,
+      hasFixiAttributes: false,
+      httpMethods: /* @__PURE__ */ new Set(),
+      swapStrategies: /* @__PURE__ */ new Set(),
+      onHandlers: [],
+      triggerModifiers: /* @__PURE__ */ new Set(),
+      urlManagement: /* @__PURE__ */ new Set(),
+      usesConfirm: false
+    };
     for (const usage of this.fileUsage.values()) {
       for (const cmd of usage.commands) commands.add(cmd);
       for (const block of usage.blocks) blocks.add(block);
       for (const lang of usage.detectedLanguages) detectedLanguages.add(lang);
       if (usage.positional) positional = true;
+      if (usage.htmx) {
+        if (usage.htmx.hasHtmxAttributes) htmx.hasHtmxAttributes = true;
+        if (usage.htmx.hasFixiAttributes) htmx.hasFixiAttributes = true;
+        for (const method of usage.htmx.httpMethods) htmx.httpMethods.add(method);
+        for (const swap of usage.htmx.swapStrategies) htmx.swapStrategies.add(swap);
+        htmx.onHandlers.push(...usage.htmx.onHandlers);
+        for (const modifier of usage.htmx.triggerModifiers) htmx.triggerModifiers.add(modifier);
+        for (const url of usage.htmx.urlManagement) htmx.urlManagement.add(url);
+        if (usage.htmx.usesConfirm) htmx.usesConfirm = true;
+      }
     }
     this.cachedUsage = {
       commands,
       blocks,
       positional,
       detectedLanguages,
+      htmx,
       fileUsage: new Map(this.fileUsage)
     };
     return this.cachedUsage;
@@ -1020,6 +1155,14 @@ var Aggregator = class {
     }
     return true;
   }
+  /**
+   * Compare two HtmxUsage objects for equality
+   */
+  htmxUsageEqual(a, b) {
+    if (!a && !b) return true;
+    if (!a || !b) return false;
+    return a.hasHtmxAttributes === b.hasHtmxAttributes && a.hasFixiAttributes === b.hasFixiAttributes && this.setsEqual(a.httpMethods, b.httpMethods) && this.setsEqual(a.swapStrategies, b.swapStrategies) && this.setsEqual(a.triggerModifiers, b.triggerModifiers) && this.setsEqual(a.urlManagement, b.urlManagement) && a.usesConfirm === b.usesConfirm;
+  }
 };
 
 // src/generator.ts
@@ -1894,7 +2037,7 @@ var Generator = class {
       commands,
       blocks,
       positionalExpressions: positional,
-      htmxIntegration: options.htmx ?? false,
+      htmxIntegration: options.htmx ?? usage.htmx?.hasHtmxAttributes ?? false,
       globalName: options.globalName ?? "hyperfixi",
       // Use @lokascript/core package path for virtual module
       parserImportPath: "@lokascript/core/parser/hybrid",