@hyperfixi/vite-plugin 2.7.1 → 2.8.0

package/README.md

@@ -1,4 +1,4 @@
-# @lokascript/vite-plugin
+# @hyperfixi/vite-plugin
 
 Zero-config Vite plugin that automatically generates minimal LokaScript bundles based on detected hyperscript usage.
 
@@ -13,23 +13,23 @@ Zero-config Vite plugin that automatically generates minimal LokaScript bundles
 ## Installation
 
 ```bash
-npm install @lokascript/vite-plugin @lokascript/core
+npm install @hyperfixi/vite-plugin @hyperfixi/core
 ```
 
 ## Quick Start
 
 ```javascript
 // vite.config.js
-import { lokascript } from '@lokascript/vite-plugin';
+import { hyperfixi } from '@hyperfixi/vite-plugin';
 
 export default {
-  plugins: [lokascript()],
+  plugins: [hyperfixi()],
 };
 ```
 
 ```javascript
 // main.js
-import 'lokascript'; // Auto-generated minimal bundle
+import 'hyperfixi'; // Auto-generated minimal bundle
 ```
 
 ```html
@@ -49,7 +49,7 @@ import 'lokascript'; // Auto-generated minimal bundle
 When bundle size is the priority, use **compile mode** to pre-compile hyperscript to JavaScript at build time:
 
 ```javascript
-lokascript({
+hyperfixi({
   mode: 'compile', // ~500 bytes gzip vs ~8KB for interpret mode
 });
 ```
@@ -84,7 +84,7 @@ toggle, add, remove, show, hide, focus, blur, set, get, put, increment, decremen
 
 ## Multilingual & Semantic Parsing
 
-Enable semantic parsing for natural language hyperscript and multilingual support across 13 languages.
+Enable semantic parsing for natural language hyperscript and multilingual support across 24 languages.
 
 ### Multilingual Options
 
@@ -96,29 +96,34 @@ Enable semantic parsing for natural language hyperscript and multilingual suppor
 | `grammar`        | `boolean`                                          | `false` | Enable grammar transformation (SOV/VSO) |
 | `extraLanguages` | `string[]`                                         | `[]`    | Languages to always include             |
 
-### Supported Languages (13)
+### Supported Languages (24)
 
-- **Western:** en, es, pt, fr, de
+- **Western (Latin script):** en, es, pt, fr, de, it, vi
+- **Slavic:** pl, ru, uk
 - **East Asian:** ja, zh, ko
-- **Other:** ar, tr, id, sw, qu
+- **RTL:** ar, he
+- **South Asian:** hi, bn
+- **Southeast Asian:** th
+- **Agglutinative Latin:** tr
+- **Other:** id, ms, sw, qu, tl
 
 ### Usage Examples
 
 ```javascript
 // Auto-detect languages from source files
-lokascript({ semantic: 'auto' });
+hyperfixi({ semantic: 'auto' });
 
 // English synonyms only (smallest semantic bundle)
-lokascript({ semantic: 'en' });
+hyperfixi({ semantic: 'en' });
 
 // Explicit languages (selects optimal regional bundle)
-lokascript({ languages: ['en', 'es', 'ja'] });
+hyperfixi({ languages: ['en', 'es', 'ja'] });
 
 // Force a specific regional bundle
-lokascript({ region: 'western' });
+hyperfixi({ region: 'western' });
 
 // Full multilingual with grammar transformation
-lokascript({ semantic: true, grammar: true });
+hyperfixi({ semantic: true, grammar: true });
 ```
 
 ### Language Auto-Detection
@@ -137,28 +142,35 @@ The plugin automatically selects the smallest bundle that covers all detected la
 
 ### Semantic Bundle Sizes
 
-| Bundle                 | Gzip Size | Languages             |
-| ---------------------- | --------- | --------------------- |
-| `semantic: 'en'`       | ~20 KB    | English only          |
-| `semantic: 'es'`       | ~16 KB    | Spanish only          |
-| `region: 'es-en'`      | ~25 KB    | English + Spanish     |
-| `region: 'western'`    | ~30 KB    | en, es, pt, fr, de    |
-| `region: 'east-asian'` | ~24 KB    | ja, zh, ko            |
-| `region: 'priority'`   | ~48 KB    | 11 priority languages |
-| `region: 'all'`        | ~61 KB    | All 13 languages      |
+| Bundle                 | Languages             |
+| ---------------------- | --------------------- |
+| `semantic: 'en'`       | English only          |
+| `semantic: 'es'`       | Spanish only          |
+| `region: 'es-en'`      | English + Spanish     |
+| `region: 'western'`    | en, es, pt, fr, de    |
+| `region: 'east-asian'` | ja, zh, ko            |
+| `region: 'priority'`   | 11 priority languages |
+| `region: 'all'`        | All 24 languages      |
+
+Final size depends on Vite's tree-shaking of the selected languages; for reference,
+the prebuilt standalone semantic bundles range from ~62 KB (core) to ~203 KB
+(all 24 languages) gzipped — see `docs/BROWSER_BUNDLES.md` in the repo.
 
 ### Tiered Bundle Architecture
 
-```
-Level 0: Base HybridParser (default)     4-9 KB gzip
+```text
+Level 0: Base HybridParser (default)
          ↓ semantic: true
-Level 1: + Semantic English              +20 KB
+Level 1: + Semantic English
          ↓ languages detected/specified
-Level 2: + Regional Semantic Bundle      +16-61 KB
+Level 2: + Regional Semantic Bundle
          ↓ grammar: true
-Level 3: + Grammar Transformation        +68 KB
+Level 3: + Grammar Transformation
 ```
 
+Each level adds bundle weight; the plugin picks the lowest level that covers the
+features and languages it detects in your source.
+
 ## htmx v4 reactive / streaming surface
 
 The scanner detects `hx-live`, `sse-connect` / `sse-swap`, `ws-connect` / `ws-send`, and `bind <var> to <expr>.<prop>` inside `_=` bodies. When any of those is found in the project, the generated bundle is the `hyperfixi-hx-v4.js` premade bundle (full runtime + `@hyperfixi/reactivity` + htmx-compat auto-installed + SSE/WS).
@@ -176,7 +188,7 @@ The slim minimal-bundle generator can't satisfy these features (its parser/runti
 ## Options
 
 ```javascript
-lokascript({
+hyperfixi({
   // Bundle mode: 'interpret' (default) or 'compile'
   mode: 'interpret',
 
@@ -200,8 +212,8 @@ lokascript({
   // Custom bundle name (shown in generated code comments)
   bundleName: 'MyApp',
 
-  // Global variable name (default: 'lokascript')
-  globalName: 'lokascript',
+  // Global variable name (default: 'hyperfixi')
+  globalName: 'hyperfixi',
 
   // Multilingual options (see "Multilingual & Semantic Parsing" section)
   semantic: false, // boolean | 'en' | 'auto'
@@ -214,7 +226,7 @@ lokascript({
 
 ## Detected Features
 
-### Commands (21)
+### Commands
 
 toggle, add, remove, removeClass, show, hide, set, get, put, append, take,
 increment, decrement, log, send, trigger, wait, transition, go, call, focus, blur, return
@@ -233,9 +245,9 @@ The plugin creates a virtual module that you can import:
 
 ```javascript
 // All of these work:
-import 'lokascript';
-import 'virtual:lokascript';
-import '@lokascript/core'; // Redirects to virtual module
+import 'hyperfixi';
+import 'virtual:hyperfixi';
+import '@hyperfixi/core'; // Redirects to virtual module
 ```
 
 ## HMR Support
@@ -267,7 +279,7 @@ element.setAttribute('_', `on click ${dynamicCommand} .active`);
 Use `extraCommands` to include those:
 
 ```javascript
-lokascript({
+hyperfixi({
   extraCommands: ['toggle', 'add', 'remove'],
 });
 ```
@@ -283,18 +295,18 @@ lokascript({
 
 ## Monorepo Development
 
-When developing in the lokascript monorepo:
+When developing in the hyperfixi monorepo:
 
 ```javascript
 // vite.config.js
-import { lokascript } from '../../packages/vite-plugin/src/index.ts';
+import { hyperfixi } from '../../packages/vite-plugin/src/index.ts';
 import path from 'path';
 
 export default {
-  plugins: [lokascript({ debug: true })],
+  plugins: [hyperfixi({ debug: true })],
   resolve: {
     alias: {
-      '@lokascript/core/parser/hybrid': path.resolve(
+      '@hyperfixi/core/parser/hybrid': path.resolve(
         __dirname,
         '../../packages/core/src/parser/hybrid'
       ),
@@ -341,7 +353,7 @@ This example demonstrates language auto-detection with Japanese, Spanish, and Ko
 | `positional`     | `boolean`                   | `false`               | Always include positional expressions |
 | `htmx`           | `boolean`                   | `false`               | Enable htmx integration               |
 | `bundleName`     | `string`                    | `'ViteAutoGenerated'` | Bundle name in comments               |
-| `globalName`     | `string`                    | `'lokascript'`        | Window global name                    |
+| `globalName`     | `string`                    | `'hyperfixi'`         | Window global name                    |
 | `semantic`       | `boolean \| 'en' \| 'auto'` | `false`               | Enable semantic parser                |
 | `languages`      | `string[]`                  | `[]`                  | Explicit language codes               |
 | `region`         | `string`                    | auto                  | Force regional bundle                 |

package/dist/index.cjs

@@ -36,6 +36,7 @@ __export(index_exports, {
   SUPPORTED_LANGUAGES: () => SUPPORTED_LANGUAGES,
   clearCustomKeywords: () => clearCustomKeywords,
   clearSemanticParser: () => clearSemanticParser,
+  computeUsageHash: () => computeUsageHash,
   default: () => index_default,
   descriptorToScanRule: () => descriptorToScanRule,
   detectLanguages: () => detectLanguages,
@@ -50,6 +51,9 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 
+// src/scanner.ts
+var import_bundle_generator = require("@hyperfixi/core/bundle-generator");
+
 // src/language-keywords.ts
 var SUPPORTED_LANGUAGES = [
   "en",
@@ -421,6 +425,7 @@ var INDONESIAN_KEYWORDS = /* @__PURE__ */ new Set([
   "kalau",
   "bila",
   "selainnya",
+  "lainnya",
   "ulangi",
   "tunggu",
   "selama"
@@ -557,6 +562,7 @@ var VIETNAMESE_KEYWORDS = /* @__PURE__ */ new Set([
   "l\u1EB7p l\u1EA1i",
   "ch\u1EDD",
   "\u0111\u1EE3i",
+  "ch\u1EDD \u0111\u1EE3i",
   "trong khi"
 ]);
 var POLISH_KEYWORDS = /* @__PURE__ */ new Set([
@@ -963,6 +969,17 @@ var SSE_NS_PATTERN = /\bsse-[\w\-\p{L}]+\s*=\s*["']/u;
 var WS_NS_PATTERN = /\bws-[\w\-\p{L}]+\s*=\s*["']/u;
 
 // src/scanner.ts
+var SCANNABLE_COMMANDS = [
+  .../* @__PURE__ */ new Set([...import_bundle_generator.AVAILABLE_COMMANDS, ...import_bundle_generator.FULL_RUNTIME_ONLY_COMMANDS])
+].filter(
+  (cmd) => /^[A-Za-z]+$/.test(cmd) && // `unless` is handled by the block detection below (it compiles to the
+  // lite-capable `if` block — flagging it as a full-runtime-only COMMAND
+  // would needlessly bump every unless-user to a full-runtime bundle).
+  // `bind` is handled by the dedicated reactivity detection below, which
+  // routes to the hx-v4 bundle (the tier that actually ships reactivity).
+  cmd !== "unless" && cmd !== "bind"
+);
+var COMMAND_PATTERN_SOURCE = `\\b(${SCANNABLE_COMMANDS.join("|")})\\b`;
 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;
@@ -1071,7 +1088,7 @@ var Scanner = class {
    * Analyze a hyperscript snippet for commands, blocks, and expressions
    */
   analyzeScript(script, usage) {
-    const commandPattern = /\b(toggle|add|remove|removeClass|show|hide|set|get|put|append|take|increment|decrement|log|send|trigger|wait|transition|go|call|focus|blur|return)\b/g;
+    const commandPattern = new RegExp(COMMAND_PATTERN_SOURCE, "g");
     let match;
     while (match = commandPattern.exec(script)) {
       usage.commands.add(match[1]);
@@ -1110,6 +1127,7 @@ var Scanner = class {
       triggerModifiers: /* @__PURE__ */ new Set(),
       urlManagement: /* @__PURE__ */ new Set(),
       usesConfirm: false,
+      needsSwapTiming: false,
       needsHxLive: false,
       needsSSE: false,
       needsWS: false,
@@ -1135,7 +1153,14 @@ var Scanner = class {
     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 spec = match[2].trim();
+      const head = spec.split(/\s+/)[0];
+      if (head.startsWith("morph") || !/^\S*:/.test(spec)) {
+        usage.swapStrategies.add(head);
+      }
+      if (/\b(swap|settle):/.test(spec)) {
+        usage.needsSwapTiming = true;
+      }
     }
     const triggerPattern = new RegExp(HTMX_TRIGGER_PATTERN.source, "gi");
     while (match = triggerPattern.exec(code)) {
@@ -1203,17 +1228,19 @@ var Scanner = class {
       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");
+      const strategy = swap.toLowerCase();
+      if (strategy.startsWith("morph")) {
+        usage.commands.add("morph");
+        if (strategy === "morph:innerhtml") usage.commands.add("put");
+      } else if (strategy === "delete") {
+        usage.commands.add("remove");
+      } else {
+        usage.commands.add("put");
       }
     }
+    if (htmx.needsSwapTiming) {
+      usage.commands.add("wait");
+    }
     if (htmx.usesConfirm) {
       usage.blocks.add("if");
     }
@@ -1308,6 +1335,7 @@ var Aggregator = class {
       triggerModifiers: /* @__PURE__ */ new Set(),
       urlManagement: /* @__PURE__ */ new Set(),
       usesConfirm: false,
+      needsSwapTiming: false,
       needsHxLive: false,
       needsSSE: false,
       needsWS: false,
@@ -1332,6 +1360,7 @@ var Aggregator = class {
         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;
+        if (usage.htmx.needsSwapTiming) htmx.needsSwapTiming = true;
         if (usage.htmx.needsHxLive) htmx.needsHxLive = true;
         if (usage.htmx.needsSSE) htmx.needsSSE = true;
         if (usage.htmx.needsWS) htmx.needsWS = true;
@@ -1404,12 +1433,20 @@ var Aggregator = class {
   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;
+    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 && !!a.needsSwapTiming === !!b.needsSwapTiming && // htmx v4 / reactivity flags: these drive selection of the hx-v4 tier,
+    // so a change must count as "usage changed" or HMR serves a stale
+    // bundle. They were omitted when the v4 surface landed (#623).
+    !!a.needsHxLive === !!b.needsHxLive && !!a.needsSSE === !!b.needsSSE && !!a.needsWS === !!b.needsWS && !!a.needsBindToProperty === !!b.needsBindToProperty && !!a.needsReactivity === !!b.needsReactivity && this.arraysEqual(a.onHandlers, b.onHandlers);
+  }
+  arraysEqual(a, b) {
+    const aa = a ?? [];
+    const bb = b ?? [];
+    return aa.length === bb.length && aa.every((v, i) => v === bb[i]);
   }
 };
 
 // src/generator.ts
-var import_bundle_generator = require("@hyperfixi/core/bundle-generator");
+var import_bundle_generator2 = require("@hyperfixi/core/bundle-generator");
 
 // src/semantic-integration.ts
 var MULTILINGUAL_COMMAND_ALIASES = {
@@ -1957,10 +1994,10 @@ function stripTypes(code) {
 }
 var COMMAND_IMPLEMENTATIONS = {};
 var BLOCK_IMPLEMENTATIONS = {};
-for (const [name, code] of Object.entries(import_bundle_generator.COMMAND_IMPLEMENTATIONS)) {
+for (const [name, code] of Object.entries(import_bundle_generator2.COMMAND_IMPLEMENTATIONS)) {
   COMMAND_IMPLEMENTATIONS[name] = stripTypes(code);
 }
-for (const [name, code] of Object.entries(import_bundle_generator.BLOCK_IMPLEMENTATIONS)) {
+for (const [name, code] of Object.entries(import_bundle_generator2.BLOCK_IMPLEMENTATIONS)) {
   BLOCK_IMPLEMENTATIONS[name] = stripTypes(code);
 }
 function generateBundleCode(config) {
@@ -1975,14 +2012,14 @@ function generateBundleCode(config) {
     esModule = true,
     parserType = "hybrid"
   } = config;
-  const needsStyleHelpers = commands.some((cmd) => import_bundle_generator.STYLE_COMMANDS.includes(cmd));
-  const needsElementArrayHelper = commands.some((cmd) => import_bundle_generator.ELEMENT_ARRAY_COMMANDS.includes(cmd));
-  const needsMorphlex = commands.some((cmd) => import_bundle_generator.MORPH_COMMANDS.includes(cmd));
+  const needsStyleHelpers = commands.some((cmd) => import_bundle_generator2.STYLE_COMMANDS.includes(cmd));
+  const needsElementArrayHelper = commands.some((cmd) => import_bundle_generator2.ELEMENT_ARRAY_COMMANDS.includes(cmd));
+  const needsMorphlex = commands.some((cmd) => import_bundle_generator2.MORPH_COMMANDS.includes(cmd));
   const hasBlocks = blocks.length > 0;
   const hasReturn = commands.includes("return");
   const commandCases = commands.filter((cmd) => COMMAND_IMPLEMENTATIONS[cmd]).map((cmd) => COMMAND_IMPLEMENTATIONS[cmd]).join("\n");
   const blockCases = blocks.filter((block) => BLOCK_IMPLEMENTATIONS[block]).map((block) => BLOCK_IMPLEMENTATIONS[block]).join("\n");
-  const parserTemplate = parserType === "lite" ? import_bundle_generator.LITE_PARSER_TEMPLATE : import_bundle_generator.HYBRID_PARSER_TEMPLATE;
+  const parserTemplate = parserType === "lite" ? import_bundle_generator2.LITE_PARSER_TEMPLATE : import_bundle_generator2.HYBRID_PARSER_TEMPLATE;
   const morphlexImport = needsMorphlex ? `import { morph as morphlexMorph, morphInner as morphlexMorphInner } from 'morphlex';
 
 ` : "";
@@ -2411,7 +2448,7 @@ var Generator = class {
       }
       return this.generateDevFallback("full");
     }
-    const parserType = (0, import_bundle_generator.canUseLiteParser)(commands, blocks, positional) ? "lite" : "hybrid";
+    const parserType = (0, import_bundle_generator2.canUseLiteParser)(commands, blocks, positional) ? "lite" : "hybrid";
     const config = {
       name: options.bundleName ?? "ViteAutoGenerated",
       commands,
@@ -2501,9 +2538,9 @@ ${additionalApiProps}`
   getUnsupportedCommands(commands) {
     const unsupported = [];
     for (const cmd of commands) {
-      if (import_bundle_generator.FULL_RUNTIME_ONLY_COMMANDS.includes(cmd)) {
+      if (import_bundle_generator2.FULL_RUNTIME_ONLY_COMMANDS.includes(cmd)) {
         unsupported.push(cmd);
-      } else if (!(0, import_bundle_generator.isAvailableCommand)(cmd) && !COMMAND_IMPLEMENTATIONS[cmd]) {
+      } else if (!(0, import_bundle_generator2.isAvailableCommand)(cmd) && !COMMAND_IMPLEMENTATIONS[cmd]) {
         unsupported.push(cmd);
       }
     }
@@ -3792,6 +3829,22 @@ var DomainAggregator = class {
 var VIRTUAL_MODULE_ID = "virtual:hyperfixi";
 var RESOLVED_VIRTUAL_MODULE_ID = "\0" + VIRTUAL_MODULE_ID;
 var IMPORT_ALIASES = ["hyperfixi", "@hyperfixi/core", "virtual:hyperfixi"];
+function computeUsageHash(usage) {
+  const commands = [...usage.commands].sort().join(",");
+  const blocks = [...usage.blocks].sort().join(",");
+  const languages = [...usage.detectedLanguages].sort().join(",");
+  const htmx = usage.htmx ? [
+    usage.htmx.hasHtmxAttributes,
+    usage.htmx.hasFixiAttributes,
+    usage.htmx.needsHxLive,
+    usage.htmx.needsSSE,
+    usage.htmx.needsWS,
+    usage.htmx.needsBindToProperty,
+    usage.htmx.needsReactivity
+  ].map((f) => f ? "1" : "0").join("") : "none";
+  const reactivity = `${usage.needsReactivity ? 1 : 0}${usage.needsBindToProperty ? 1 : 0}`;
+  return `${commands}|${blocks}|${usage.positional}|${languages}|${htmx}|${reactivity}`;
+}
 function hyperfixi(options = {}) {
   const mode = options.mode ?? "interpret";
   const scanner = new Scanner(options);
@@ -3808,12 +3861,6 @@ function hyperfixi(options = {}) {
   const fallbackScripts = /* @__PURE__ */ new Set();
   let needsLocals = false;
   let needsGlobals = false;
-  function computeUsageHash(usage) {
-    const commands = [...usage.commands].sort().join(",");
-    const blocks = [...usage.blocks].sort().join(",");
-    const languages = [...usage.detectedLanguages].sort().join(",");
-    return `${commands}|${blocks}|${usage.positional}|${languages}`;
-  }
   function invalidateVirtualModule() {
     if (!server) return;
     const mod = server.moduleGraph.getModuleById(RESOLVED_VIRTUAL_MODULE_ID);
@@ -4114,6 +4161,7 @@ var index_default = hyperfixi;
   SUPPORTED_LANGUAGES,
   clearCustomKeywords,
   clearSemanticParser,
+  computeUsageHash,
   descriptorToScanRule,
   detectLanguages,
   getAllLanguageCodes,