@vobs/vite-plugin 1.2.2 → 1.3.1

package/dist/index.cjs

@@ -176,11 +176,13 @@ function vobsPlugin(options = {}) {
   const include = options.include ?? /\.tsx(?:$|\?)/;
   const htmlModules = /* @__PURE__ */ new Set();
   let productionBuild = false;
+  let hmrStateEnabled = (options.hmr ?? true) && (options.hmrState ?? true);
   return {
     name: "vobs",
     enforce: "pre",
     configResolved(config) {
       productionBuild = config.command === "build";
+      hmrStateEnabled = (options.hmr ?? true) && !productionBuild && (options.hmrState ?? true);
     },
     resolveId(source, importer) {
       if (!importer || !isHtmlComponent(source, options.html) || !isRelativeModule(source)) return null;
@@ -195,14 +197,24 @@ function vobsPlugin(options = {}) {
       return compileHtmlComponent(await (0, import_promises.readFile)(id, "utf8"), { filename: id });
     },
     transform(code, id) {
-      include.lastIndex = 0;
-      if (!include.test(id)) return null;
+      const cleanId = id.split(/[?#]/u, 1)[0];
+      const isTsx = cleanId.endsWith(".tsx");
+      const isStateTs = isStateModulePath(cleanId);
+      if (!isTsx && !isStateTs) return null;
+      if (options.include) {
+        include.lastIndex = 0;
+        if (!include.test(id)) return null;
+      }
+      if (!isTsx && (!hmrStateEnabled || !isStatefulModule(code))) return null;
       const extractor = options.extractI18n ? (0, import_compiler.createI18nExtractor)({ onKey: options.extractI18n }) : void 0;
+      const hmr = options.hmr ?? !productionBuild;
       const result = (0, import_compiler.compileWithSourceMap)(code, {
         ...options.compiler,
         // 生产构建默认剔除组件源码位置（错误定位走 source map）；显式配置优先。
         sourceLocation: options.compiler?.sourceLocation ?? !productionBuild,
         filename: id,
+        // HMR 模块标识必须跨 ?t= 查询稳定（registry 复用语义依赖它），用干净路径。
+        hmrModuleId: hmr ? cleanId : options.compiler?.hmrModuleId,
         plugins: [
           ...options.compiler?.plugins ?? [],
           ...extractor ? [extractor.plugin] : []
@@ -219,8 +231,7 @@ function vobsPlugin(options = {}) {
           fix: diagnostic.fix
         });
       }
-      const hmr = options.hmr ?? !productionBuild;
-      const hmrCode = hmr ? createHmrCode(id) : "";
+      const hmrCode = hmr ? createHmrCode(cleanId) : "";
       return {
         code: `${result.code}${hmrCode}`,
         map: result.map
@@ -229,6 +240,17 @@ function vobsPlugin(options = {}) {
   };
 }
 __name(vobsPlugin, "vobsPlugin");
+function isStatefulModule(code) {
+  return /\bimport\s+(?:type\s+)?\{[^}]*\bstate\b[^}]*\}\s*from\s*['"]@vobs\/(?:reactivity|vobs)['"]/u.test(code) && /(?<![\w$.])state\s*\(/u.test(code);
+}
+__name(isStatefulModule, "isStatefulModule");
+function isStateModulePath(cleanId) {
+  if (!cleanId.endsWith(".ts")) return false;
+  if (cleanId.endsWith(".d.ts")) return false;
+  if (cleanId.includes("node_modules")) return false;
+  return true;
+}
+__name(isStateModulePath, "isStateModulePath");
 function isRelativeModule(source) {
   return source.startsWith("./") || source.startsWith("../");
 }

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/html-component.ts"],"sourcesContent":["// Vite 插件：集成 Vobs 编译器\n\nimport { readFile } from 'node:fs/promises'\nimport path from 'node:path'\nimport type { Plugin } from 'vite'\nimport { compileWithSourceMap, createI18nExtractor, type CompileOptions } from '@vobs/compiler'\nimport { VobsError } from '@vobs/runtime/error'\nimport { compileHtmlComponent } from './html-component.ts'\n\nexport interface VobsVitePluginOptions {\n  include?: RegExp\n  compiler?: CompileOptions\n  hmr?: boolean\n  extractI18n?: (key: string, filename: string) => void\n  html?: boolean | { readonly extensions?: readonly string[] }\n}\n\nexport function vobsPlugin(options: VobsVitePluginOptions = {}): Plugin {\n  const include = options.include ?? /\\.tsx(?:$|\\?)/\n  const htmlModules = new Set<string>()\n  let productionBuild = false\n\n  return {\n    name: 'vobs',\n\n    enforce: 'pre',\n\n    configResolved(config) {\n      productionBuild = config.command === 'build'\n    },\n\n    resolveId(source: string, importer: string | undefined) {\n      if (!importer || !isHtmlComponent(source, options.html) || !isRelativeModule(source)) return null\n      const cleanImporter = importer.split(/[?#]/u, 1)[0]\n      const cleanSource = source.split(/[?#]/u, 1)[0]\n      const resolved = path.resolve(path.dirname(cleanImporter), cleanSource)\n      htmlModules.add(resolved)\n      return resolved\n    },\n\n    async load(id: string) {\n      if (!htmlModules.has(id)) return null\n      return compileHtmlComponent(await readFile(id, 'utf8'), { filename: id })\n    },\n\n    transform(code: string, id: string) {\n      include.lastIndex = 0\n      if (!include.test(id)) return null\n\n      const extractor = options.extractI18n\n        ? createI18nExtractor({ onKey: options.extractI18n })\n        : undefined\n      const result = compileWithSourceMap(code, {\n        ...options.compiler,\n        // 生产构建默认剔除组件源码位置（错误定位走 source map）；显式配置优先。\n        sourceLocation: options.compiler?.sourceLocation ?? !productionBuild,\n        filename: id,\n        plugins: [\n          ...(options.compiler?.plugins ?? []),\n          ...(extractor ? [extractor.plugin] : [])\n        ]\n      })\n      const diagnostic = result.diagnostics.find(item => item.severity === 'error')\n      if (diagnostic) {\n        throw new VobsError({\n          code: diagnostic.code,\n          layer: 'compiler',\n          message: diagnostic.message,\n          location: diagnostic.location,\n          codeFrame: diagnostic.codeFrame,\n          fix: diagnostic.fix\n        })\n      }\n      const hmr = options.hmr ?? !productionBuild\n      const hmrCode = hmr ? createHmrCode(id) : ''\n      return {\n        code: `${result.code}${hmrCode}`,\n        map: result.map\n      }\n    }\n  }\n}\n\nfunction isRelativeModule(source: string): boolean {\n  return source.startsWith('./') || source.startsWith('../')\n}\n\nfunction isHtmlComponent(id: string, option: VobsVitePluginOptions['html']): boolean {\n  if (option === false) return false\n  const extensions = typeof option === 'object' && option.extensions?.length ? option.extensions : ['.html', '.htm']\n  const cleanId = id.split(/[?#]/u, 1)[0]\n  return extensions.some(extension => cleanId.endsWith(extension))\n}\n\n\nfunction createHmrCode(moduleId: string): string {\n  const encodedId = JSON.stringify(moduleId)\n  return `\nimport { disposeHmrModule, updateHmrModule } from '@vobs/vobs'\n\nif (import.meta.hot) {\n  import.meta.hot.accept((module) => {\n    if (module) updateHmrModule(${encodedId}, module)\n  })\n  import.meta.hot.dispose(() => disposeHmrModule(${encodedId}))\n}\n`\n}\n","import { parseFragment, type DefaultTreeAdapterMap, type DefaultTreeAdapterTypes } from 'parse5'\n\ntype HtmlNode = DefaultTreeAdapterTypes.Node\ntype HtmlDocumentFragment = DefaultTreeAdapterTypes.DocumentFragment\ntype HtmlElement = DefaultTreeAdapterTypes.Element\n\nconst blockedTags = new Set(['script', 'iframe', 'object', 'embed', 'base', 'meta', 'link', 'style'])\nconst blockedAttributes = /^(?:on[a-z]+|srcdoc|style)$/iu\nconst urlAttributes = new Set(['href', 'src', 'action', 'formaction', 'poster', 'xlink:href'])\nconst safeProtocols = new Set(['http:', 'https:', 'mailto:', 'tel:'])\nconst directivePattern = /^data-vobs-(text|slot|on|bind|prop)(?:-(.+))?$/iu\nconst safePropertyNames = new Set([\n  'value', 'checked', 'selected', 'disabled', 'multiple', 'readonly', 'required',\n  'autofocus', 'hidden', 'tabindex'\n])\n\nexport interface HtmlComponentOptions {\n  readonly filename?: string\n}\n\n/** Converts a trusted static HTML fragment to Vobs runtime node creation code. */\nexport function compileHtmlComponent(source: string, options: HtmlComponentOptions = {}): string {\n  const fragment = parseFragment(source)\n  const body = compileChildren(fragment, options.filename ?? 'component.html')\n  const result = body.length === 1 ? body[0] : `createFragment((parent, anchor) => {${body.map(code => `insertBefore(parent, ${code}, anchor);`).join('')}})`\n\n  return `import { addEventListener, bindAttribute, bindProperty, bindText, createElement, createFragment, createText, insertBefore, insertDynamic, setAttribute } from '@vobs/vobs';\\nfunction resolveHtmlSlot(value) { const resolved = typeof value === 'function' ? value() : value; if (resolved === undefined || resolved === null || resolved === false) return null; if (typeof resolved === 'string' || typeof resolved === 'number') return createText(String(resolved)); if (Array.isArray(resolved)) return createFragment((parent, anchor) => { for (const item of resolved) { const child = resolveHtmlSlot(item); if (child) insertBefore(parent, child, anchor); } }); return resolved; }\\nfunction sanitizeHtmlAttribute(name, value) { const stringValue = String(value ?? ''); if (!['href', 'src', 'action', 'formaction', 'poster', 'xlink:href'].includes(name.toLowerCase())) return stringValue; const normalized = stringValue.trim().toLowerCase(); if (normalized.startsWith('#') || normalized.startsWith('/') || normalized.startsWith('./') || normalized.startsWith('../')) return stringValue; try { const protocol = new URL(normalized, 'https://vobs.invalid/').protocol; return ['http:', 'https:', 'mailto:', 'tel:'].includes(protocol) ? stringValue : ''; } catch { return ''; } }\\nexport default function HtmlComponent(props = {}) { return ${result ?? \"createFragment(() => {})\"}; }`\n}\n\nfunction compileChildren(parent: HtmlDocumentFragment | HtmlElement, filename: string): string[] {\n  return parent.childNodes.flatMap(node => compileNode(node, filename))\n}\n\nfunction compileNode(node: HtmlNode, filename: string): string[] {\n  if (node.nodeName === '#text') {\n    const value = (node as DefaultTreeAdapterMap['textNode']).value\n    return value ? [`createText(${JSON.stringify(value)})`] : []\n  }\n\n  if (node.nodeName === '#comment') return []\n  if (node.nodeName !== '#document-fragment' && !isElement(node)) return []\n\n  if (isElement(node)) {\n    const tag = node.tagName.toLowerCase()\n    if (blockedTags.has(tag)) throw new Error(`Vobs HTML component: 禁止使用 <${tag}> (${filename})`)\n\n    const children = compileChildren(node, filename)\n    const statements = [`const element = createElement(${JSON.stringify(tag)})`]\n    const dynamicText = [] as string[]\n    for (const attribute of node.attrs) {\n      const name = attribute.name.toLowerCase()\n      const value = attribute.value\n      const directive = parseDirective(name, value, filename)\n      if (directive) {\n        if (directive.kind === 'text') {\n          dynamicText.push(directive.prop)\n        } else if (directive.kind === 'slot') {\n          statements.push(`insertDynamic(element, null, () => resolveHtmlSlot(props[${JSON.stringify(directive.prop)}]))`)\n        } else if (directive.kind === 'event') {\n          statements.push(`addEventListener(element, ${JSON.stringify(directive.name)}, (event) => { const handler = props[${JSON.stringify(directive.prop)}]; if (typeof handler === 'function') handler(event); })`)\n        } else if (directive.kind === 'attribute') {\n          statements.push(`bindAttribute(element, ${JSON.stringify(directive.name)}, () => sanitizeHtmlAttribute(${JSON.stringify(directive.name)}, props[${JSON.stringify(directive.prop)}] ?? ''))`)\n        } else if (directive.kind === 'property') {\n          statements.push(`bindProperty(element, ${JSON.stringify(directive.name)}, () => props[${JSON.stringify(directive.prop)}])`)\n        }\n        continue\n      }\n      if (blockedAttributes.test(name)) throw new Error(`Vobs HTML component: 禁止使用危险属性 ${attribute.name} (${filename})`)\n      if (urlAttributes.has(name) && !isSafeUrl(value)) {\n        throw new Error(`Vobs HTML component: 禁止使用危险 URL 属性 ${attribute.name} (${filename})`)\n      }\n      statements.push(`setAttribute(element, ${JSON.stringify(attribute.name)}, ${JSON.stringify(value)})`)\n    }\n    if (dynamicText.length > 1) throw new Error(`Vobs HTML component: 一个元素只能使用一个 data-vobs-text 指令 (${filename})`)\n    if (dynamicText.length === 1) {\n      const text = 'createText(\"\")'\n      statements.push(`const text = ${text}`)\n      statements.push('insertBefore(element, text, null)')\n      statements.push(`bindText(text, () => props[${JSON.stringify(dynamicText[0])}] ?? '')`)\n    } else {\n      for (const child of children) statements.push(`insertBefore(element, ${child}, null)`)\n    }\n    statements.push('return element')\n    return [`(() => {${statements.join(';')};})()`]\n  }\n\n  return compileChildren(node as HtmlDocumentFragment, filename)\n}\n\nfunction isElement(node: HtmlNode): node is HtmlElement {\n  return !node.nodeName.startsWith('#')\n}\n\nfunction isSafeUrl(value: string): boolean {\n  const normalized = value.trim().toLowerCase()\n  if (normalized.startsWith('#') || normalized.startsWith('/') || normalized.startsWith('./') || normalized.startsWith('../')) return true\n  try {\n    return safeProtocols.has(new URL(normalized, 'https://vobs.invalid/').protocol)\n  } catch {\n    return false\n  }\n}\n\ntype HtmlDirective =\n  | { readonly kind: 'text' | 'slot'; readonly prop: string }\n  | { readonly kind: 'event' | 'attribute' | 'property'; readonly name: string; readonly prop: string }\n\nfunction parseDirective(name: string, value: string, filename: string): HtmlDirective | null {\n  const match = directivePattern.exec(name)\n  if (!match) return null\n  const kind = match[1].toLowerCase()\n  const namePart = match[2]\n  const prop = value.trim()\n  if (!prop || !/^[A-Za-z_$][\\w$]*$/u.test(prop)) {\n    throw new Error(`Vobs HTML component: ${name} 必须引用有效的 props 名称 (${filename})`)\n  }\n  if (kind === 'text' || kind === 'slot') {\n    if (namePart) throw new Error(`Vobs HTML component: ${name} 不接受额外名称 (${filename})`)\n    return { kind, prop }\n  }\n  if (!namePart || !/^[a-z][a-z0-9:-]*$/iu.test(namePart)) {\n    throw new Error(`Vobs HTML component: ${name} 必须包含有效名称 (${filename})`)\n  }\n  if (kind === 'on') return { kind: 'event', name: namePart.toLowerCase(), prop }\n  if (kind === 'bind') {\n    if (namePart.toLowerCase() === 'style') throw new Error(`Vobs HTML component: 不允许动态绑定 style (${filename})`)\n    return { kind: 'attribute', name: namePart, prop }\n  }\n  if (!safePropertyNames.has(namePart.toLowerCase())) {\n    throw new Error(`Vobs HTML component: 不允许动态绑定 property ${namePart} (${filename})`)\n  }\n  return { kind: 'property', name: normalizePropertyName(namePart), prop }\n}\n\nfunction normalizePropertyName(name: string): string {\n  return name.toLowerCase() === 'readonly' ? 'readOnly' : name.toLowerCase() === 'tabindex' ? 'tabIndex' : name\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAEA,sBAAyB;AACzB,uBAAiB;AAEjB,sBAA+E;AAC/E,mBAA0B;;;ACN1B,oBAAwF;AAMxF,IAAM,cAAc,oBAAI,IAAI,CAAC,UAAU,UAAU,UAAU,SAAS,QAAQ,QAAQ,QAAQ,OAAO,CAAC;AACpG,IAAM,oBAAoB;AAC1B,IAAM,gBAAgB,oBAAI,IAAI,CAAC,QAAQ,OAAO,UAAU,cAAc,UAAU,YAAY,CAAC;AAC7F,IAAM,gBAAgB,oBAAI,IAAI,CAAC,SAAS,UAAU,WAAW,MAAM,CAAC;AACpE,IAAM,mBAAmB;AACzB,IAAM,oBAAoB,oBAAI,IAAI;AAAA,EAChC;AAAA,EAAS;AAAA,EAAW;AAAA,EAAY;AAAA,EAAY;AAAA,EAAY;AAAA,EAAY;AAAA,EACpE;AAAA,EAAa;AAAA,EAAU;AACzB,CAAC;AAOM,SAAS,qBAAqB,QAAgB,UAAgC,CAAC,GAAW;AAC/F,QAAM,eAAW,6BAAc,MAAM;AACrC,QAAM,OAAO,gBAAgB,UAAU,QAAQ,YAAY,gBAAgB;AAC3E,QAAM,SAAS,KAAK,WAAW,IAAI,KAAK,CAAC,IAAI,uCAAuC,KAAK,IAAI,UAAQ,wBAAwB,IAAI,YAAY,EAAE,KAAK,EAAE,CAAC;AAEvJ,SAAO;AAAA;AAAA;AAAA,6DAAgzC,UAAU,0BAA0B;AAC71C;AANgB;AAQhB,SAAS,gBAAgB,QAA4C,UAA4B;AAC/F,SAAO,OAAO,WAAW,QAAQ,UAAQ,YAAY,MAAM,QAAQ,CAAC;AACtE;AAFS;AAIT,SAAS,YAAY,MAAgB,UAA4B;AAC/D,MAAI,KAAK,aAAa,SAAS;AAC7B,UAAM,QAAS,KAA2C;AAC1D,WAAO,QAAQ,CAAC,cAAc,KAAK,UAAU,KAAK,CAAC,GAAG,IAAI,CAAC;AAAA,EAC7D;AAEA,MAAI,KAAK,aAAa,WAAY,QAAO,CAAC;AAC1C,MAAI,KAAK,aAAa,wBAAwB,CAAC,UAAU,IAAI,EAAG,QAAO,CAAC;AAExE,MAAI,UAAU,IAAI,GAAG;AACnB,UAAM,MAAM,KAAK,QAAQ,YAAY;AACrC,QAAI,YAAY,IAAI,GAAG,EAAG,OAAM,IAAI,MAAM,kDAA8B,GAAG,MAAM,QAAQ,GAAG;AAE5F,UAAM,WAAW,gBAAgB,MAAM,QAAQ;AAC/C,UAAM,aAAa,CAAC,iCAAiC,KAAK,UAAU,GAAG,CAAC,GAAG;AAC3E,UAAM,cAAc,CAAC;AACrB,eAAW,aAAa,KAAK,OAAO;AAClC,YAAM,OAAO,UAAU,KAAK,YAAY;AACxC,YAAM,QAAQ,UAAU;AACxB,YAAM,YAAY,eAAe,MAAM,OAAO,QAAQ;AACtD,UAAI,WAAW;AACb,YAAI,UAAU,SAAS,QAAQ;AAC7B,sBAAY,KAAK,UAAU,IAAI;AAAA,QACjC,WAAW,UAAU,SAAS,QAAQ;AACpC,qBAAW,KAAK,4DAA4D,KAAK,UAAU,UAAU,IAAI,CAAC,KAAK;AAAA,QACjH,WAAW,UAAU,SAAS,SAAS;AACrC,qBAAW,KAAK,6BAA6B,KAAK,UAAU,UAAU,IAAI,CAAC,wCAAwC,KAAK,UAAU,UAAU,IAAI,CAAC,0DAA0D;AAAA,QAC7M,WAAW,UAAU,SAAS,aAAa;AACzC,qBAAW,KAAK,0BAA0B,KAAK,UAAU,UAAU,IAAI,CAAC,iCAAiC,KAAK,UAAU,UAAU,IAAI,CAAC,WAAW,KAAK,UAAU,UAAU,IAAI,CAAC,WAAW;AAAA,QAC7L,WAAW,UAAU,SAAS,YAAY;AACxC,qBAAW,KAAK,yBAAyB,KAAK,UAAU,UAAU,IAAI,CAAC,iBAAiB,KAAK,UAAU,UAAU,IAAI,CAAC,IAAI;AAAA,QAC5H;AACA;AAAA,MACF;AACA,UAAI,kBAAkB,KAAK,IAAI,EAAG,OAAM,IAAI,MAAM,yEAAiC,UAAU,IAAI,KAAK,QAAQ,GAAG;AACjH,UAAI,cAAc,IAAI,IAAI,KAAK,CAAC,UAAU,KAAK,GAAG;AAChD,cAAM,IAAI,MAAM,8EAAsC,UAAU,IAAI,KAAK,QAAQ,GAAG;AAAA,MACtF;AACA,iBAAW,KAAK,yBAAyB,KAAK,UAAU,UAAU,IAAI,CAAC,KAAK,KAAK,UAAU,KAAK,CAAC,GAAG;AAAA,IACtG;AACA,QAAI,YAAY,SAAS,EAAG,OAAM,IAAI,MAAM,kHAAsD,QAAQ,GAAG;AAC7G,QAAI,YAAY,WAAW,GAAG;AAC5B,YAAM,OAAO;AACb,iBAAW,KAAK,gBAAgB,IAAI,EAAE;AACtC,iBAAW,KAAK,mCAAmC;AACnD,iBAAW,KAAK,8BAA8B,KAAK,UAAU,YAAY,CAAC,CAAC,CAAC,UAAU;AAAA,IACxF,OAAO;AACL,iBAAW,SAAS,SAAU,YAAW,KAAK,yBAAyB,KAAK,SAAS;AAAA,IACvF;AACA,eAAW,KAAK,gBAAgB;AAChC,WAAO,CAAC,WAAW,WAAW,KAAK,GAAG,CAAC,OAAO;AAAA,EAChD;AAEA,SAAO,gBAAgB,MAA8B,QAAQ;AAC/D;AAtDS;AAwDT,SAAS,UAAU,MAAqC;AACtD,SAAO,CAAC,KAAK,SAAS,WAAW,GAAG;AACtC;AAFS;AAIT,SAAS,UAAU,OAAwB;AACzC,QAAM,aAAa,MAAM,KAAK,EAAE,YAAY;AAC5C,MAAI,WAAW,WAAW,GAAG,KAAK,WAAW,WAAW,GAAG,KAAK,WAAW,WAAW,IAAI,KAAK,WAAW,WAAW,KAAK,EAAG,QAAO;AACpI,MAAI;AACF,WAAO,cAAc,IAAI,IAAI,IAAI,YAAY,uBAAuB,EAAE,QAAQ;AAAA,EAChF,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AARS;AAcT,SAAS,eAAe,MAAc,OAAe,UAAwC;AAC3F,QAAM,QAAQ,iBAAiB,KAAK,IAAI;AACxC,MAAI,CAAC,MAAO,QAAO;AACnB,QAAM,OAAO,MAAM,CAAC,EAAE,YAAY;AAClC,QAAM,WAAW,MAAM,CAAC;AACxB,QAAM,OAAO,MAAM,KAAK;AACxB,MAAI,CAAC,QAAQ,CAAC,sBAAsB,KAAK,IAAI,GAAG;AAC9C,UAAM,IAAI,MAAM,wBAAwB,IAAI,mEAAsB,QAAQ,GAAG;AAAA,EAC/E;AACA,MAAI,SAAS,UAAU,SAAS,QAAQ;AACtC,QAAI,SAAU,OAAM,IAAI,MAAM,wBAAwB,IAAI,gDAAa,QAAQ,GAAG;AAClF,WAAO,EAAE,MAAM,KAAK;AAAA,EACtB;AACA,MAAI,CAAC,YAAY,CAAC,uBAAuB,KAAK,QAAQ,GAAG;AACvD,UAAM,IAAI,MAAM,wBAAwB,IAAI,sDAAc,QAAQ,GAAG;AAAA,EACvE;AACA,MAAI,SAAS,KAAM,QAAO,EAAE,MAAM,SAAS,MAAM,SAAS,YAAY,GAAG,KAAK;AAC9E,MAAI,SAAS,QAAQ;AACnB,QAAI,SAAS,YAAY,MAAM,QAAS,OAAM,IAAI,MAAM,0EAAuC,QAAQ,GAAG;AAC1G,WAAO,EAAE,MAAM,aAAa,MAAM,UAAU,KAAK;AAAA,EACnD;AACA,MAAI,CAAC,kBAAkB,IAAI,SAAS,YAAY,CAAC,GAAG;AAClD,UAAM,IAAI,MAAM,4EAAyC,QAAQ,KAAK,QAAQ,GAAG;AAAA,EACnF;AACA,SAAO,EAAE,MAAM,YAAY,MAAM,sBAAsB,QAAQ,GAAG,KAAK;AACzE;AAzBS;AA2BT,SAAS,sBAAsB,MAAsB;AACnD,SAAO,KAAK,YAAY,MAAM,aAAa,aAAa,KAAK,YAAY,MAAM,aAAa,aAAa;AAC3G;AAFS;;;ADrHF,SAAS,WAAW,UAAiC,CAAC,GAAW;AACtE,QAAM,UAAU,QAAQ,WAAW;AACnC,QAAM,cAAc,oBAAI,IAAY;AACpC,MAAI,kBAAkB;AAEtB,SAAO;AAAA,IACL,MAAM;AAAA,IAEN,SAAS;AAAA,IAET,eAAe,QAAQ;AACrB,wBAAkB,OAAO,YAAY;AAAA,IACvC;AAAA,IAEA,UAAU,QAAgB,UAA8B;AACtD,UAAI,CAAC,YAAY,CAAC,gBAAgB,QAAQ,QAAQ,IAAI,KAAK,CAAC,iBAAiB,MAAM,EAAG,QAAO;AAC7F,YAAM,gBAAgB,SAAS,MAAM,SAAS,CAAC,EAAE,CAAC;AAClD,YAAM,cAAc,OAAO,MAAM,SAAS,CAAC,EAAE,CAAC;AAC9C,YAAM,WAAW,iBAAAA,QAAK,QAAQ,iBAAAA,QAAK,QAAQ,aAAa,GAAG,WAAW;AACtE,kBAAY,IAAI,QAAQ;AACxB,aAAO;AAAA,IACT;AAAA,IAEA,MAAM,KAAK,IAAY;AACrB,UAAI,CAAC,YAAY,IAAI,EAAE,EAAG,QAAO;AACjC,aAAO,qBAAqB,UAAM,0BAAS,IAAI,MAAM,GAAG,EAAE,UAAU,GAAG,CAAC;AAAA,IAC1E;AAAA,IAEA,UAAU,MAAc,IAAY;AAClC,cAAQ,YAAY;AACpB,UAAI,CAAC,QAAQ,KAAK,EAAE,EAAG,QAAO;AAE9B,YAAM,YAAY,QAAQ,kBACtB,qCAAoB,EAAE,OAAO,QAAQ,YAAY,CAAC,IAClD;AACJ,YAAM,aAAS,sCAAqB,MAAM;AAAA,QACxC,GAAG,QAAQ;AAAA;AAAA,QAEX,gBAAgB,QAAQ,UAAU,kBAAkB,CAAC;AAAA,QACrD,UAAU;AAAA,QACV,SAAS;AAAA,UACP,GAAI,QAAQ,UAAU,WAAW,CAAC;AAAA,UAClC,GAAI,YAAY,CAAC,UAAU,MAAM,IAAI,CAAC;AAAA,QACxC;AAAA,MACF,CAAC;AACD,YAAM,aAAa,OAAO,YAAY,KAAK,UAAQ,KAAK,aAAa,OAAO;AAC5E,UAAI,YAAY;AACd,cAAM,IAAI,uBAAU;AAAA,UAClB,MAAM,WAAW;AAAA,UACjB,OAAO;AAAA,UACP,SAAS,WAAW;AAAA,UACpB,UAAU,WAAW;AAAA,UACrB,WAAW,WAAW;AAAA,UACtB,KAAK,WAAW;AAAA,QAClB,CAAC;AAAA,MACH;AACA,YAAM,MAAM,QAAQ,OAAO,CAAC;AAC5B,YAAM,UAAU,MAAM,cAAc,EAAE,IAAI;AAC1C,aAAO;AAAA,QACL,MAAM,GAAG,OAAO,IAAI,GAAG,OAAO;AAAA,QAC9B,KAAK,OAAO;AAAA,MACd;AAAA,IACF;AAAA,EACF;AACF;AAhEgB;AAkEhB,SAAS,iBAAiB,QAAyB;AACjD,SAAO,OAAO,WAAW,IAAI,KAAK,OAAO,WAAW,KAAK;AAC3D;AAFS;AAIT,SAAS,gBAAgB,IAAY,QAAgD;AACnF,MAAI,WAAW,MAAO,QAAO;AAC7B,QAAM,aAAa,OAAO,WAAW,YAAY,OAAO,YAAY,SAAS,OAAO,aAAa,CAAC,SAAS,MAAM;AACjH,QAAM,UAAU,GAAG,MAAM,SAAS,CAAC,EAAE,CAAC;AACtC,SAAO,WAAW,KAAK,eAAa,QAAQ,SAAS,SAAS,CAAC;AACjE;AALS;AAQT,SAAS,cAAc,UAA0B;AAC/C,QAAM,YAAY,KAAK,UAAU,QAAQ;AACzC,SAAO;AAAA;AAAA;AAAA;AAAA;AAAA,kCAKyB,SAAS;AAAA;AAAA,mDAEQ,SAAS;AAAA;AAAA;AAG5D;AAZS;","names":["path"]}
+{"version":3,"sources":["../src/index.ts","../src/html-component.ts"],"sourcesContent":["// Vite 插件：集成 Vobs 编译器\n\nimport { readFile } from 'node:fs/promises'\nimport path from 'node:path'\nimport type { Plugin } from 'vite'\nimport { compileWithSourceMap, createI18nExtractor, type CompileOptions } from '@vobs/compiler'\nimport { VobsError } from '@vobs/runtime/error'\nimport { compileHtmlComponent } from './html-component.ts'\n\nexport interface VobsVitePluginOptions {\n  include?: RegExp\n  compiler?: CompileOptions\n  hmr?: boolean\n  /**\n   * 模块级状态 HMR 保鲜（默认开启，仅 dev 生效）。开启后：\n   * - 模块顶层 state() 声明编译为 hmrStateRef(...)，热更新重执行模块时复用既有信号，\n   *   消除\"新旧两份模块实例、两份状态\"导致的编辑不生效/页面半边失灵；\n   * - 声明了模块级 state 的 .ts 文件（store 类模块）也纳入 HMR 处理。\n   */\n  hmrState?: boolean\n  extractI18n?: (key: string, filename: string) => void\n  html?: boolean | { readonly extensions?: readonly string[] }\n}\n\nexport function vobsPlugin(options: VobsVitePluginOptions = {}): Plugin {\n  const include = options.include ?? /\\.tsx(?:$|\\?)/\n  const htmlModules = new Set<string>()\n  let productionBuild = false\n  let hmrStateEnabled = (options.hmr ?? true) && (options.hmrState ?? true)\n\n  return {\n    name: 'vobs',\n\n    enforce: 'pre',\n\n    configResolved(config) {\n      productionBuild = config.command === 'build'\n      hmrStateEnabled = (options.hmr ?? true) && !productionBuild && (options.hmrState ?? true)\n    },\n\n    resolveId(source: string, importer: string | undefined) {\n      if (!importer || !isHtmlComponent(source, options.html) || !isRelativeModule(source)) return null\n      const cleanImporter = importer.split(/[?#]/u, 1)[0]\n      const cleanSource = source.split(/[?#]/u, 1)[0]\n      const resolved = path.resolve(path.dirname(cleanImporter), cleanSource)\n      htmlModules.add(resolved)\n      return resolved\n    },\n\n    async load(id: string) {\n      if (!htmlModules.has(id)) return null\n      return compileHtmlComponent(await readFile(id, 'utf8'), { filename: id })\n    },\n\n    transform(code: string, id: string) {\n      const cleanId = id.split(/[?#]/u, 1)[0]\n      const isTsx = cleanId.endsWith('.tsx')\n      const isStateTs = isStateModulePath(cleanId)\n      if (!isTsx && !isStateTs) return null\n      if (options.include) {\n        include.lastIndex = 0\n        if (!include.test(id)) return null\n      }\n\n      // .ts 状态模块（store 类）：声明了模块级 state 才纳入编译与 HMR，\n      // 避免对普通 .ts 全量重印。\n      if (!isTsx && (!hmrStateEnabled || !isStatefulModule(code))) return null\n\n      const extractor = options.extractI18n\n        ? createI18nExtractor({ onKey: options.extractI18n })\n        : undefined\n      const hmr = options.hmr ?? !productionBuild\n      const result = compileWithSourceMap(code, {\n        ...options.compiler,\n        // 生产构建默认剔除组件源码位置（错误定位走 source map）；显式配置优先。\n        sourceLocation: options.compiler?.sourceLocation ?? !productionBuild,\n        filename: id,\n        // HMR 模块标识必须跨 ?t= 查询稳定（registry 复用语义依赖它），用干净路径。\n        hmrModuleId: hmr ? cleanId : options.compiler?.hmrModuleId,\n        plugins: [\n          ...(options.compiler?.plugins ?? []),\n          ...(extractor ? [extractor.plugin] : [])\n        ]\n      })\n      const diagnostic = result.diagnostics.find(item => item.severity === 'error')\n      if (diagnostic) {\n        throw new VobsError({\n          code: diagnostic.code,\n          layer: 'compiler',\n          message: diagnostic.message,\n          location: diagnostic.location,\n          codeFrame: diagnostic.codeFrame,\n          fix: diagnostic.fix\n        })\n      }\n      const hmrCode = hmr ? createHmrCode(cleanId) : ''\n      return {\n        code: `${result.code}${hmrCode}`,\n        map: result.map\n      }\n    }\n  }\n}\n\n/** 模块级 state 的 store 类 .ts 模块判定：从 @vobs 导入 state 且实际调用。 */\nfunction isStatefulModule(code: string): boolean {\n  return /\\bimport\\s+(?:type\\s+)?\\{[^}]*\\bstate\\b[^}]*\\}\\s*from\\s*['\"]@vobs\\/(?:reactivity|vobs)['\"]/u.test(code)\n    && /(?<![\\w$.])state\\s*\\(/u.test(code)\n}\n\nfunction isStateModulePath(cleanId: string): boolean {\n  if (!cleanId.endsWith('.ts')) return false\n  if (cleanId.endsWith('.d.ts')) return false\n  if (cleanId.includes('node_modules')) return false\n  return true\n}\n\nfunction isRelativeModule(source: string): boolean {\n  return source.startsWith('./') || source.startsWith('../')\n}\n\nfunction isHtmlComponent(id: string, option: VobsVitePluginOptions['html']): boolean {\n  if (option === false) return false\n  const extensions = typeof option === 'object' && option.extensions?.length ? option.extensions : ['.html', '.htm']\n  const cleanId = id.split(/[?#]/u, 1)[0]\n  return extensions.some(extension => cleanId.endsWith(extension))\n}\n\n\nfunction createHmrCode(moduleId: string): string {\n  const encodedId = JSON.stringify(moduleId)\n  return `\nimport { disposeHmrModule, updateHmrModule } from '@vobs/vobs'\n\nif (import.meta.hot) {\n  import.meta.hot.accept((module) => {\n    if (module) updateHmrModule(${encodedId}, module)\n  })\n  import.meta.hot.dispose(() => disposeHmrModule(${encodedId}))\n}\n`\n}\n","import { parseFragment, type DefaultTreeAdapterMap, type DefaultTreeAdapterTypes } from 'parse5'\n\ntype HtmlNode = DefaultTreeAdapterTypes.Node\ntype HtmlDocumentFragment = DefaultTreeAdapterTypes.DocumentFragment\ntype HtmlElement = DefaultTreeAdapterTypes.Element\n\nconst blockedTags = new Set(['script', 'iframe', 'object', 'embed', 'base', 'meta', 'link', 'style'])\nconst blockedAttributes = /^(?:on[a-z]+|srcdoc|style)$/iu\nconst urlAttributes = new Set(['href', 'src', 'action', 'formaction', 'poster', 'xlink:href'])\nconst safeProtocols = new Set(['http:', 'https:', 'mailto:', 'tel:'])\nconst directivePattern = /^data-vobs-(text|slot|on|bind|prop)(?:-(.+))?$/iu\nconst safePropertyNames = new Set([\n  'value', 'checked', 'selected', 'disabled', 'multiple', 'readonly', 'required',\n  'autofocus', 'hidden', 'tabindex'\n])\n\nexport interface HtmlComponentOptions {\n  readonly filename?: string\n}\n\n/** Converts a trusted static HTML fragment to Vobs runtime node creation code. */\nexport function compileHtmlComponent(source: string, options: HtmlComponentOptions = {}): string {\n  const fragment = parseFragment(source)\n  const body = compileChildren(fragment, options.filename ?? 'component.html')\n  const result = body.length === 1 ? body[0] : `createFragment((parent, anchor) => {${body.map(code => `insertBefore(parent, ${code}, anchor);`).join('')}})`\n\n  return `import { addEventListener, bindAttribute, bindProperty, bindText, createElement, createFragment, createText, insertBefore, insertDynamic, setAttribute } from '@vobs/vobs';\\nfunction resolveHtmlSlot(value) { const resolved = typeof value === 'function' ? value() : value; if (resolved === undefined || resolved === null || resolved === false) return null; if (typeof resolved === 'string' || typeof resolved === 'number') return createText(String(resolved)); if (Array.isArray(resolved)) return createFragment((parent, anchor) => { for (const item of resolved) { const child = resolveHtmlSlot(item); if (child) insertBefore(parent, child, anchor); } }); return resolved; }\\nfunction sanitizeHtmlAttribute(name, value) { const stringValue = String(value ?? ''); if (!['href', 'src', 'action', 'formaction', 'poster', 'xlink:href'].includes(name.toLowerCase())) return stringValue; const normalized = stringValue.trim().toLowerCase(); if (normalized.startsWith('#') || normalized.startsWith('/') || normalized.startsWith('./') || normalized.startsWith('../')) return stringValue; try { const protocol = new URL(normalized, 'https://vobs.invalid/').protocol; return ['http:', 'https:', 'mailto:', 'tel:'].includes(protocol) ? stringValue : ''; } catch { return ''; } }\\nexport default function HtmlComponent(props = {}) { return ${result ?? \"createFragment(() => {})\"}; }`\n}\n\nfunction compileChildren(parent: HtmlDocumentFragment | HtmlElement, filename: string): string[] {\n  return parent.childNodes.flatMap(node => compileNode(node, filename))\n}\n\nfunction compileNode(node: HtmlNode, filename: string): string[] {\n  if (node.nodeName === '#text') {\n    const value = (node as DefaultTreeAdapterMap['textNode']).value\n    return value ? [`createText(${JSON.stringify(value)})`] : []\n  }\n\n  if (node.nodeName === '#comment') return []\n  if (node.nodeName !== '#document-fragment' && !isElement(node)) return []\n\n  if (isElement(node)) {\n    const tag = node.tagName.toLowerCase()\n    if (blockedTags.has(tag)) throw new Error(`Vobs HTML component: 禁止使用 <${tag}> (${filename})`)\n\n    const children = compileChildren(node, filename)\n    const statements = [`const element = createElement(${JSON.stringify(tag)})`]\n    const dynamicText = [] as string[]\n    for (const attribute of node.attrs) {\n      const name = attribute.name.toLowerCase()\n      const value = attribute.value\n      const directive = parseDirective(name, value, filename)\n      if (directive) {\n        if (directive.kind === 'text') {\n          dynamicText.push(directive.prop)\n        } else if (directive.kind === 'slot') {\n          statements.push(`insertDynamic(element, null, () => resolveHtmlSlot(props[${JSON.stringify(directive.prop)}]))`)\n        } else if (directive.kind === 'event') {\n          statements.push(`addEventListener(element, ${JSON.stringify(directive.name)}, (event) => { const handler = props[${JSON.stringify(directive.prop)}]; if (typeof handler === 'function') handler(event); })`)\n        } else if (directive.kind === 'attribute') {\n          statements.push(`bindAttribute(element, ${JSON.stringify(directive.name)}, () => sanitizeHtmlAttribute(${JSON.stringify(directive.name)}, props[${JSON.stringify(directive.prop)}] ?? ''))`)\n        } else if (directive.kind === 'property') {\n          statements.push(`bindProperty(element, ${JSON.stringify(directive.name)}, () => props[${JSON.stringify(directive.prop)}])`)\n        }\n        continue\n      }\n      if (blockedAttributes.test(name)) throw new Error(`Vobs HTML component: 禁止使用危险属性 ${attribute.name} (${filename})`)\n      if (urlAttributes.has(name) && !isSafeUrl(value)) {\n        throw new Error(`Vobs HTML component: 禁止使用危险 URL 属性 ${attribute.name} (${filename})`)\n      }\n      statements.push(`setAttribute(element, ${JSON.stringify(attribute.name)}, ${JSON.stringify(value)})`)\n    }\n    if (dynamicText.length > 1) throw new Error(`Vobs HTML component: 一个元素只能使用一个 data-vobs-text 指令 (${filename})`)\n    if (dynamicText.length === 1) {\n      const text = 'createText(\"\")'\n      statements.push(`const text = ${text}`)\n      statements.push('insertBefore(element, text, null)')\n      statements.push(`bindText(text, () => props[${JSON.stringify(dynamicText[0])}] ?? '')`)\n    } else {\n      for (const child of children) statements.push(`insertBefore(element, ${child}, null)`)\n    }\n    statements.push('return element')\n    return [`(() => {${statements.join(';')};})()`]\n  }\n\n  return compileChildren(node as HtmlDocumentFragment, filename)\n}\n\nfunction isElement(node: HtmlNode): node is HtmlElement {\n  return !node.nodeName.startsWith('#')\n}\n\nfunction isSafeUrl(value: string): boolean {\n  const normalized = value.trim().toLowerCase()\n  if (normalized.startsWith('#') || normalized.startsWith('/') || normalized.startsWith('./') || normalized.startsWith('../')) return true\n  try {\n    return safeProtocols.has(new URL(normalized, 'https://vobs.invalid/').protocol)\n  } catch {\n    return false\n  }\n}\n\ntype HtmlDirective =\n  | { readonly kind: 'text' | 'slot'; readonly prop: string }\n  | { readonly kind: 'event' | 'attribute' | 'property'; readonly name: string; readonly prop: string }\n\nfunction parseDirective(name: string, value: string, filename: string): HtmlDirective | null {\n  const match = directivePattern.exec(name)\n  if (!match) return null\n  const kind = match[1].toLowerCase()\n  const namePart = match[2]\n  const prop = value.trim()\n  if (!prop || !/^[A-Za-z_$][\\w$]*$/u.test(prop)) {\n    throw new Error(`Vobs HTML component: ${name} 必须引用有效的 props 名称 (${filename})`)\n  }\n  if (kind === 'text' || kind === 'slot') {\n    if (namePart) throw new Error(`Vobs HTML component: ${name} 不接受额外名称 (${filename})`)\n    return { kind, prop }\n  }\n  if (!namePart || !/^[a-z][a-z0-9:-]*$/iu.test(namePart)) {\n    throw new Error(`Vobs HTML component: ${name} 必须包含有效名称 (${filename})`)\n  }\n  if (kind === 'on') return { kind: 'event', name: namePart.toLowerCase(), prop }\n  if (kind === 'bind') {\n    if (namePart.toLowerCase() === 'style') throw new Error(`Vobs HTML component: 不允许动态绑定 style (${filename})`)\n    return { kind: 'attribute', name: namePart, prop }\n  }\n  if (!safePropertyNames.has(namePart.toLowerCase())) {\n    throw new Error(`Vobs HTML component: 不允许动态绑定 property ${namePart} (${filename})`)\n  }\n  return { kind: 'property', name: normalizePropertyName(namePart), prop }\n}\n\nfunction normalizePropertyName(name: string): string {\n  return name.toLowerCase() === 'readonly' ? 'readOnly' : name.toLowerCase() === 'tabindex' ? 'tabIndex' : name\n}\n"],"mappings":"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","names":["path"]}

package/dist/index.d.cts

@@ -5,6 +5,13 @@ interface VobsVitePluginOptions {
     include?: RegExp;
     compiler?: CompileOptions;
     hmr?: boolean;
+    /**
+     * 模块级状态 HMR 保鲜（默认开启，仅 dev 生效）。开启后：
+     * - 模块顶层 state() 声明编译为 hmrStateRef(...)，热更新重执行模块时复用既有信号，
+     *   消除"新旧两份模块实例、两份状态"导致的编辑不生效/页面半边失灵；
+     * - 声明了模块级 state 的 .ts 文件（store 类模块）也纳入 HMR 处理。
+     */
+    hmrState?: boolean;
     extractI18n?: (key: string, filename: string) => void;
     html?: boolean | {
         readonly extensions?: readonly string[];

package/dist/index.d.ts

@@ -5,6 +5,13 @@ interface VobsVitePluginOptions {
     include?: RegExp;
     compiler?: CompileOptions;
     hmr?: boolean;
+    /**
+     * 模块级状态 HMR 保鲜（默认开启，仅 dev 生效）。开启后：
+     * - 模块顶层 state() 声明编译为 hmrStateRef(...)，热更新重执行模块时复用既有信号，
+     *   消除"新旧两份模块实例、两份状态"导致的编辑不生效/页面半边失灵；
+     * - 声明了模块级 state 的 .ts 文件（store 类模块）也纳入 HMR 处理。
+     */
+    hmrState?: boolean;
     extractI18n?: (key: string, filename: string) => void;
     html?: boolean | {
         readonly extensions?: readonly string[];

package/dist/index.js

@@ -143,11 +143,13 @@ function vobsPlugin(options = {}) {
   const include = options.include ?? /\.tsx(?:$|\?)/;
   const htmlModules = /* @__PURE__ */ new Set();
   let productionBuild = false;
+  let hmrStateEnabled = (options.hmr ?? true) && (options.hmrState ?? true);
   return {
     name: "vobs",
     enforce: "pre",
     configResolved(config) {
       productionBuild = config.command === "build";
+      hmrStateEnabled = (options.hmr ?? true) && !productionBuild && (options.hmrState ?? true);
     },
     resolveId(source, importer) {
       if (!importer || !isHtmlComponent(source, options.html) || !isRelativeModule(source)) return null;
@@ -162,14 +164,24 @@ function vobsPlugin(options = {}) {
       return compileHtmlComponent(await readFile(id, "utf8"), { filename: id });
     },
     transform(code, id) {
-      include.lastIndex = 0;
-      if (!include.test(id)) return null;
+      const cleanId = id.split(/[?#]/u, 1)[0];
+      const isTsx = cleanId.endsWith(".tsx");
+      const isStateTs = isStateModulePath(cleanId);
+      if (!isTsx && !isStateTs) return null;
+      if (options.include) {
+        include.lastIndex = 0;
+        if (!include.test(id)) return null;
+      }
+      if (!isTsx && (!hmrStateEnabled || !isStatefulModule(code))) return null;
       const extractor = options.extractI18n ? createI18nExtractor({ onKey: options.extractI18n }) : void 0;
+      const hmr = options.hmr ?? !productionBuild;
       const result = compileWithSourceMap(code, {
         ...options.compiler,
         // 生产构建默认剔除组件源码位置（错误定位走 source map）；显式配置优先。
         sourceLocation: options.compiler?.sourceLocation ?? !productionBuild,
         filename: id,
+        // HMR 模块标识必须跨 ?t= 查询稳定（registry 复用语义依赖它），用干净路径。
+        hmrModuleId: hmr ? cleanId : options.compiler?.hmrModuleId,
         plugins: [
           ...options.compiler?.plugins ?? [],
           ...extractor ? [extractor.plugin] : []
@@ -186,8 +198,7 @@ function vobsPlugin(options = {}) {
           fix: diagnostic.fix
         });
       }
-      const hmr = options.hmr ?? !productionBuild;
-      const hmrCode = hmr ? createHmrCode(id) : "";
+      const hmrCode = hmr ? createHmrCode(cleanId) : "";
       return {
         code: `${result.code}${hmrCode}`,
         map: result.map
@@ -196,6 +207,17 @@ function vobsPlugin(options = {}) {
   };
 }
 __name(vobsPlugin, "vobsPlugin");
+function isStatefulModule(code) {
+  return /\bimport\s+(?:type\s+)?\{[^}]*\bstate\b[^}]*\}\s*from\s*['"]@vobs\/(?:reactivity|vobs)['"]/u.test(code) && /(?<![\w$.])state\s*\(/u.test(code);
+}
+__name(isStatefulModule, "isStatefulModule");
+function isStateModulePath(cleanId) {
+  if (!cleanId.endsWith(".ts")) return false;
+  if (cleanId.endsWith(".d.ts")) return false;
+  if (cleanId.includes("node_modules")) return false;
+  return true;
+}
+__name(isStateModulePath, "isStateModulePath");
 function isRelativeModule(source) {
   return source.startsWith("./") || source.startsWith("../");
 }

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/html-component.ts"],"sourcesContent":["// Vite 插件：集成 Vobs 编译器\n\nimport { readFile } from 'node:fs/promises'\nimport path from 'node:path'\nimport type { Plugin } from 'vite'\nimport { compileWithSourceMap, createI18nExtractor, type CompileOptions } from '@vobs/compiler'\nimport { VobsError } from '@vobs/runtime/error'\nimport { compileHtmlComponent } from './html-component.ts'\n\nexport interface VobsVitePluginOptions {\n  include?: RegExp\n  compiler?: CompileOptions\n  hmr?: boolean\n  extractI18n?: (key: string, filename: string) => void\n  html?: boolean | { readonly extensions?: readonly string[] }\n}\n\nexport function vobsPlugin(options: VobsVitePluginOptions = {}): Plugin {\n  const include = options.include ?? /\\.tsx(?:$|\\?)/\n  const htmlModules = new Set<string>()\n  let productionBuild = false\n\n  return {\n    name: 'vobs',\n\n    enforce: 'pre',\n\n    configResolved(config) {\n      productionBuild = config.command === 'build'\n    },\n\n    resolveId(source: string, importer: string | undefined) {\n      if (!importer || !isHtmlComponent(source, options.html) || !isRelativeModule(source)) return null\n      const cleanImporter = importer.split(/[?#]/u, 1)[0]\n      const cleanSource = source.split(/[?#]/u, 1)[0]\n      const resolved = path.resolve(path.dirname(cleanImporter), cleanSource)\n      htmlModules.add(resolved)\n      return resolved\n    },\n\n    async load(id: string) {\n      if (!htmlModules.has(id)) return null\n      return compileHtmlComponent(await readFile(id, 'utf8'), { filename: id })\n    },\n\n    transform(code: string, id: string) {\n      include.lastIndex = 0\n      if (!include.test(id)) return null\n\n      const extractor = options.extractI18n\n        ? createI18nExtractor({ onKey: options.extractI18n })\n        : undefined\n      const result = compileWithSourceMap(code, {\n        ...options.compiler,\n        // 生产构建默认剔除组件源码位置（错误定位走 source map）；显式配置优先。\n        sourceLocation: options.compiler?.sourceLocation ?? !productionBuild,\n        filename: id,\n        plugins: [\n          ...(options.compiler?.plugins ?? []),\n          ...(extractor ? [extractor.plugin] : [])\n        ]\n      })\n      const diagnostic = result.diagnostics.find(item => item.severity === 'error')\n      if (diagnostic) {\n        throw new VobsError({\n          code: diagnostic.code,\n          layer: 'compiler',\n          message: diagnostic.message,\n          location: diagnostic.location,\n          codeFrame: diagnostic.codeFrame,\n          fix: diagnostic.fix\n        })\n      }\n      const hmr = options.hmr ?? !productionBuild\n      const hmrCode = hmr ? createHmrCode(id) : ''\n      return {\n        code: `${result.code}${hmrCode}`,\n        map: result.map\n      }\n    }\n  }\n}\n\nfunction isRelativeModule(source: string): boolean {\n  return source.startsWith('./') || source.startsWith('../')\n}\n\nfunction isHtmlComponent(id: string, option: VobsVitePluginOptions['html']): boolean {\n  if (option === false) return false\n  const extensions = typeof option === 'object' && option.extensions?.length ? option.extensions : ['.html', '.htm']\n  const cleanId = id.split(/[?#]/u, 1)[0]\n  return extensions.some(extension => cleanId.endsWith(extension))\n}\n\n\nfunction createHmrCode(moduleId: string): string {\n  const encodedId = JSON.stringify(moduleId)\n  return `\nimport { disposeHmrModule, updateHmrModule } from '@vobs/vobs'\n\nif (import.meta.hot) {\n  import.meta.hot.accept((module) => {\n    if (module) updateHmrModule(${encodedId}, module)\n  })\n  import.meta.hot.dispose(() => disposeHmrModule(${encodedId}))\n}\n`\n}\n","import { parseFragment, type DefaultTreeAdapterMap, type DefaultTreeAdapterTypes } from 'parse5'\n\ntype HtmlNode = DefaultTreeAdapterTypes.Node\ntype HtmlDocumentFragment = DefaultTreeAdapterTypes.DocumentFragment\ntype HtmlElement = DefaultTreeAdapterTypes.Element\n\nconst blockedTags = new Set(['script', 'iframe', 'object', 'embed', 'base', 'meta', 'link', 'style'])\nconst blockedAttributes = /^(?:on[a-z]+|srcdoc|style)$/iu\nconst urlAttributes = new Set(['href', 'src', 'action', 'formaction', 'poster', 'xlink:href'])\nconst safeProtocols = new Set(['http:', 'https:', 'mailto:', 'tel:'])\nconst directivePattern = /^data-vobs-(text|slot|on|bind|prop)(?:-(.+))?$/iu\nconst safePropertyNames = new Set([\n  'value', 'checked', 'selected', 'disabled', 'multiple', 'readonly', 'required',\n  'autofocus', 'hidden', 'tabindex'\n])\n\nexport interface HtmlComponentOptions {\n  readonly filename?: string\n}\n\n/** Converts a trusted static HTML fragment to Vobs runtime node creation code. */\nexport function compileHtmlComponent(source: string, options: HtmlComponentOptions = {}): string {\n  const fragment = parseFragment(source)\n  const body = compileChildren(fragment, options.filename ?? 'component.html')\n  const result = body.length === 1 ? body[0] : `createFragment((parent, anchor) => {${body.map(code => `insertBefore(parent, ${code}, anchor);`).join('')}})`\n\n  return `import { addEventListener, bindAttribute, bindProperty, bindText, createElement, createFragment, createText, insertBefore, insertDynamic, setAttribute } from '@vobs/vobs';\\nfunction resolveHtmlSlot(value) { const resolved = typeof value === 'function' ? value() : value; if (resolved === undefined || resolved === null || resolved === false) return null; if (typeof resolved === 'string' || typeof resolved === 'number') return createText(String(resolved)); if (Array.isArray(resolved)) return createFragment((parent, anchor) => { for (const item of resolved) { const child = resolveHtmlSlot(item); if (child) insertBefore(parent, child, anchor); } }); return resolved; }\\nfunction sanitizeHtmlAttribute(name, value) { const stringValue = String(value ?? ''); if (!['href', 'src', 'action', 'formaction', 'poster', 'xlink:href'].includes(name.toLowerCase())) return stringValue; const normalized = stringValue.trim().toLowerCase(); if (normalized.startsWith('#') || normalized.startsWith('/') || normalized.startsWith('./') || normalized.startsWith('../')) return stringValue; try { const protocol = new URL(normalized, 'https://vobs.invalid/').protocol; return ['http:', 'https:', 'mailto:', 'tel:'].includes(protocol) ? stringValue : ''; } catch { return ''; } }\\nexport default function HtmlComponent(props = {}) { return ${result ?? \"createFragment(() => {})\"}; }`\n}\n\nfunction compileChildren(parent: HtmlDocumentFragment | HtmlElement, filename: string): string[] {\n  return parent.childNodes.flatMap(node => compileNode(node, filename))\n}\n\nfunction compileNode(node: HtmlNode, filename: string): string[] {\n  if (node.nodeName === '#text') {\n    const value = (node as DefaultTreeAdapterMap['textNode']).value\n    return value ? [`createText(${JSON.stringify(value)})`] : []\n  }\n\n  if (node.nodeName === '#comment') return []\n  if (node.nodeName !== '#document-fragment' && !isElement(node)) return []\n\n  if (isElement(node)) {\n    const tag = node.tagName.toLowerCase()\n    if (blockedTags.has(tag)) throw new Error(`Vobs HTML component: 禁止使用 <${tag}> (${filename})`)\n\n    const children = compileChildren(node, filename)\n    const statements = [`const element = createElement(${JSON.stringify(tag)})`]\n    const dynamicText = [] as string[]\n    for (const attribute of node.attrs) {\n      const name = attribute.name.toLowerCase()\n      const value = attribute.value\n      const directive = parseDirective(name, value, filename)\n      if (directive) {\n        if (directive.kind === 'text') {\n          dynamicText.push(directive.prop)\n        } else if (directive.kind === 'slot') {\n          statements.push(`insertDynamic(element, null, () => resolveHtmlSlot(props[${JSON.stringify(directive.prop)}]))`)\n        } else if (directive.kind === 'event') {\n          statements.push(`addEventListener(element, ${JSON.stringify(directive.name)}, (event) => { const handler = props[${JSON.stringify(directive.prop)}]; if (typeof handler === 'function') handler(event); })`)\n        } else if (directive.kind === 'attribute') {\n          statements.push(`bindAttribute(element, ${JSON.stringify(directive.name)}, () => sanitizeHtmlAttribute(${JSON.stringify(directive.name)}, props[${JSON.stringify(directive.prop)}] ?? ''))`)\n        } else if (directive.kind === 'property') {\n          statements.push(`bindProperty(element, ${JSON.stringify(directive.name)}, () => props[${JSON.stringify(directive.prop)}])`)\n        }\n        continue\n      }\n      if (blockedAttributes.test(name)) throw new Error(`Vobs HTML component: 禁止使用危险属性 ${attribute.name} (${filename})`)\n      if (urlAttributes.has(name) && !isSafeUrl(value)) {\n        throw new Error(`Vobs HTML component: 禁止使用危险 URL 属性 ${attribute.name} (${filename})`)\n      }\n      statements.push(`setAttribute(element, ${JSON.stringify(attribute.name)}, ${JSON.stringify(value)})`)\n    }\n    if (dynamicText.length > 1) throw new Error(`Vobs HTML component: 一个元素只能使用一个 data-vobs-text 指令 (${filename})`)\n    if (dynamicText.length === 1) {\n      const text = 'createText(\"\")'\n      statements.push(`const text = ${text}`)\n      statements.push('insertBefore(element, text, null)')\n      statements.push(`bindText(text, () => props[${JSON.stringify(dynamicText[0])}] ?? '')`)\n    } else {\n      for (const child of children) statements.push(`insertBefore(element, ${child}, null)`)\n    }\n    statements.push('return element')\n    return [`(() => {${statements.join(';')};})()`]\n  }\n\n  return compileChildren(node as HtmlDocumentFragment, filename)\n}\n\nfunction isElement(node: HtmlNode): node is HtmlElement {\n  return !node.nodeName.startsWith('#')\n}\n\nfunction isSafeUrl(value: string): boolean {\n  const normalized = value.trim().toLowerCase()\n  if (normalized.startsWith('#') || normalized.startsWith('/') || normalized.startsWith('./') || normalized.startsWith('../')) return true\n  try {\n    return safeProtocols.has(new URL(normalized, 'https://vobs.invalid/').protocol)\n  } catch {\n    return false\n  }\n}\n\ntype HtmlDirective =\n  | { readonly kind: 'text' | 'slot'; readonly prop: string }\n  | { readonly kind: 'event' | 'attribute' | 'property'; readonly name: string; readonly prop: string }\n\nfunction parseDirective(name: string, value: string, filename: string): HtmlDirective | null {\n  const match = directivePattern.exec(name)\n  if (!match) return null\n  const kind = match[1].toLowerCase()\n  const namePart = match[2]\n  const prop = value.trim()\n  if (!prop || !/^[A-Za-z_$][\\w$]*$/u.test(prop)) {\n    throw new Error(`Vobs HTML component: ${name} 必须引用有效的 props 名称 (${filename})`)\n  }\n  if (kind === 'text' || kind === 'slot') {\n    if (namePart) throw new Error(`Vobs HTML component: ${name} 不接受额外名称 (${filename})`)\n    return { kind, prop }\n  }\n  if (!namePart || !/^[a-z][a-z0-9:-]*$/iu.test(namePart)) {\n    throw new Error(`Vobs HTML component: ${name} 必须包含有效名称 (${filename})`)\n  }\n  if (kind === 'on') return { kind: 'event', name: namePart.toLowerCase(), prop }\n  if (kind === 'bind') {\n    if (namePart.toLowerCase() === 'style') throw new Error(`Vobs HTML component: 不允许动态绑定 style (${filename})`)\n    return { kind: 'attribute', name: namePart, prop }\n  }\n  if (!safePropertyNames.has(namePart.toLowerCase())) {\n    throw new Error(`Vobs HTML component: 不允许动态绑定 property ${namePart} (${filename})`)\n  }\n  return { kind: 'property', name: normalizePropertyName(namePart), prop }\n}\n\nfunction normalizePropertyName(name: string): string {\n  return name.toLowerCase() === 'readonly' ? 'readOnly' : name.toLowerCase() === 'tabindex' ? 'tabIndex' : name\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/html-component.ts"],"sourcesContent":["// Vite 插件：集成 Vobs 编译器\n\nimport { readFile } from 'node:fs/promises'\nimport path from 'node:path'\nimport type { Plugin } from 'vite'\nimport { compileWithSourceMap, createI18nExtractor, type CompileOptions } from '@vobs/compiler'\nimport { VobsError } from '@vobs/runtime/error'\nimport { compileHtmlComponent } from './html-component.ts'\n\nexport interface VobsVitePluginOptions {\n  include?: RegExp\n  compiler?: CompileOptions\n  hmr?: boolean\n  /**\n   * 模块级状态 HMR 保鲜（默认开启，仅 dev 生效）。开启后：\n   * - 模块顶层 state() 声明编译为 hmrStateRef(...)，热更新重执行模块时复用既有信号，\n   *   消除\"新旧两份模块实例、两份状态\"导致的编辑不生效/页面半边失灵；\n   * - 声明了模块级 state 的 .ts 文件（store 类模块）也纳入 HMR 处理。\n   */\n  hmrState?: boolean\n  extractI18n?: (key: string, filename: string) => void\n  html?: boolean | { readonly extensions?: readonly string[] }\n}\n\nexport function vobsPlugin(options: VobsVitePluginOptions = {}): Plugin {\n  const include = options.include ?? /\\.tsx(?:$|\\?)/\n  const htmlModules = new Set<string>()\n  let productionBuild = false\n  let hmrStateEnabled = (options.hmr ?? true) && (options.hmrState ?? true)\n\n  return {\n    name: 'vobs',\n\n    enforce: 'pre',\n\n    configResolved(config) {\n      productionBuild = config.command === 'build'\n      hmrStateEnabled = (options.hmr ?? true) && !productionBuild && (options.hmrState ?? true)\n    },\n\n    resolveId(source: string, importer: string | undefined) {\n      if (!importer || !isHtmlComponent(source, options.html) || !isRelativeModule(source)) return null\n      const cleanImporter = importer.split(/[?#]/u, 1)[0]\n      const cleanSource = source.split(/[?#]/u, 1)[0]\n      const resolved = path.resolve(path.dirname(cleanImporter), cleanSource)\n      htmlModules.add(resolved)\n      return resolved\n    },\n\n    async load(id: string) {\n      if (!htmlModules.has(id)) return null\n      return compileHtmlComponent(await readFile(id, 'utf8'), { filename: id })\n    },\n\n    transform(code: string, id: string) {\n      const cleanId = id.split(/[?#]/u, 1)[0]\n      const isTsx = cleanId.endsWith('.tsx')\n      const isStateTs = isStateModulePath(cleanId)\n      if (!isTsx && !isStateTs) return null\n      if (options.include) {\n        include.lastIndex = 0\n        if (!include.test(id)) return null\n      }\n\n      // .ts 状态模块（store 类）：声明了模块级 state 才纳入编译与 HMR，\n      // 避免对普通 .ts 全量重印。\n      if (!isTsx && (!hmrStateEnabled || !isStatefulModule(code))) return null\n\n      const extractor = options.extractI18n\n        ? createI18nExtractor({ onKey: options.extractI18n })\n        : undefined\n      const hmr = options.hmr ?? !productionBuild\n      const result = compileWithSourceMap(code, {\n        ...options.compiler,\n        // 生产构建默认剔除组件源码位置（错误定位走 source map）；显式配置优先。\n        sourceLocation: options.compiler?.sourceLocation ?? !productionBuild,\n        filename: id,\n        // HMR 模块标识必须跨 ?t= 查询稳定（registry 复用语义依赖它），用干净路径。\n        hmrModuleId: hmr ? cleanId : options.compiler?.hmrModuleId,\n        plugins: [\n          ...(options.compiler?.plugins ?? []),\n          ...(extractor ? [extractor.plugin] : [])\n        ]\n      })\n      const diagnostic = result.diagnostics.find(item => item.severity === 'error')\n      if (diagnostic) {\n        throw new VobsError({\n          code: diagnostic.code,\n          layer: 'compiler',\n          message: diagnostic.message,\n          location: diagnostic.location,\n          codeFrame: diagnostic.codeFrame,\n          fix: diagnostic.fix\n        })\n      }\n      const hmrCode = hmr ? createHmrCode(cleanId) : ''\n      return {\n        code: `${result.code}${hmrCode}`,\n        map: result.map\n      }\n    }\n  }\n}\n\n/** 模块级 state 的 store 类 .ts 模块判定：从 @vobs 导入 state 且实际调用。 */\nfunction isStatefulModule(code: string): boolean {\n  return /\\bimport\\s+(?:type\\s+)?\\{[^}]*\\bstate\\b[^}]*\\}\\s*from\\s*['\"]@vobs\\/(?:reactivity|vobs)['\"]/u.test(code)\n    && /(?<![\\w$.])state\\s*\\(/u.test(code)\n}\n\nfunction isStateModulePath(cleanId: string): boolean {\n  if (!cleanId.endsWith('.ts')) return false\n  if (cleanId.endsWith('.d.ts')) return false\n  if (cleanId.includes('node_modules')) return false\n  return true\n}\n\nfunction isRelativeModule(source: string): boolean {\n  return source.startsWith('./') || source.startsWith('../')\n}\n\nfunction isHtmlComponent(id: string, option: VobsVitePluginOptions['html']): boolean {\n  if (option === false) return false\n  const extensions = typeof option === 'object' && option.extensions?.length ? option.extensions : ['.html', '.htm']\n  const cleanId = id.split(/[?#]/u, 1)[0]\n  return extensions.some(extension => cleanId.endsWith(extension))\n}\n\n\nfunction createHmrCode(moduleId: string): string {\n  const encodedId = JSON.stringify(moduleId)\n  return `\nimport { disposeHmrModule, updateHmrModule } from '@vobs/vobs'\n\nif (import.meta.hot) {\n  import.meta.hot.accept((module) => {\n    if (module) updateHmrModule(${encodedId}, module)\n  })\n  import.meta.hot.dispose(() => disposeHmrModule(${encodedId}))\n}\n`\n}\n","import { parseFragment, type DefaultTreeAdapterMap, type DefaultTreeAdapterTypes } from 'parse5'\n\ntype HtmlNode = DefaultTreeAdapterTypes.Node\ntype HtmlDocumentFragment = DefaultTreeAdapterTypes.DocumentFragment\ntype HtmlElement = DefaultTreeAdapterTypes.Element\n\nconst blockedTags = new Set(['script', 'iframe', 'object', 'embed', 'base', 'meta', 'link', 'style'])\nconst blockedAttributes = /^(?:on[a-z]+|srcdoc|style)$/iu\nconst urlAttributes = new Set(['href', 'src', 'action', 'formaction', 'poster', 'xlink:href'])\nconst safeProtocols = new Set(['http:', 'https:', 'mailto:', 'tel:'])\nconst directivePattern = /^data-vobs-(text|slot|on|bind|prop)(?:-(.+))?$/iu\nconst safePropertyNames = new Set([\n  'value', 'checked', 'selected', 'disabled', 'multiple', 'readonly', 'required',\n  'autofocus', 'hidden', 'tabindex'\n])\n\nexport interface HtmlComponentOptions {\n  readonly filename?: string\n}\n\n/** Converts a trusted static HTML fragment to Vobs runtime node creation code. */\nexport function compileHtmlComponent(source: string, options: HtmlComponentOptions = {}): string {\n  const fragment = parseFragment(source)\n  const body = compileChildren(fragment, options.filename ?? 'component.html')\n  const result = body.length === 1 ? body[0] : `createFragment((parent, anchor) => {${body.map(code => `insertBefore(parent, ${code}, anchor);`).join('')}})`\n\n  return `import { addEventListener, bindAttribute, bindProperty, bindText, createElement, createFragment, createText, insertBefore, insertDynamic, setAttribute } from '@vobs/vobs';\\nfunction resolveHtmlSlot(value) { const resolved = typeof value === 'function' ? value() : value; if (resolved === undefined || resolved === null || resolved === false) return null; if (typeof resolved === 'string' || typeof resolved === 'number') return createText(String(resolved)); if (Array.isArray(resolved)) return createFragment((parent, anchor) => { for (const item of resolved) { const child = resolveHtmlSlot(item); if (child) insertBefore(parent, child, anchor); } }); return resolved; }\\nfunction sanitizeHtmlAttribute(name, value) { const stringValue = String(value ?? ''); if (!['href', 'src', 'action', 'formaction', 'poster', 'xlink:href'].includes(name.toLowerCase())) return stringValue; const normalized = stringValue.trim().toLowerCase(); if (normalized.startsWith('#') || normalized.startsWith('/') || normalized.startsWith('./') || normalized.startsWith('../')) return stringValue; try { const protocol = new URL(normalized, 'https://vobs.invalid/').protocol; return ['http:', 'https:', 'mailto:', 'tel:'].includes(protocol) ? stringValue : ''; } catch { return ''; } }\\nexport default function HtmlComponent(props = {}) { return ${result ?? \"createFragment(() => {})\"}; }`\n}\n\nfunction compileChildren(parent: HtmlDocumentFragment | HtmlElement, filename: string): string[] {\n  return parent.childNodes.flatMap(node => compileNode(node, filename))\n}\n\nfunction compileNode(node: HtmlNode, filename: string): string[] {\n  if (node.nodeName === '#text') {\n    const value = (node as DefaultTreeAdapterMap['textNode']).value\n    return value ? [`createText(${JSON.stringify(value)})`] : []\n  }\n\n  if (node.nodeName === '#comment') return []\n  if (node.nodeName !== '#document-fragment' && !isElement(node)) return []\n\n  if (isElement(node)) {\n    const tag = node.tagName.toLowerCase()\n    if (blockedTags.has(tag)) throw new Error(`Vobs HTML component: 禁止使用 <${tag}> (${filename})`)\n\n    const children = compileChildren(node, filename)\n    const statements = [`const element = createElement(${JSON.stringify(tag)})`]\n    const dynamicText = [] as string[]\n    for (const attribute of node.attrs) {\n      const name = attribute.name.toLowerCase()\n      const value = attribute.value\n      const directive = parseDirective(name, value, filename)\n      if (directive) {\n        if (directive.kind === 'text') {\n          dynamicText.push(directive.prop)\n        } else if (directive.kind === 'slot') {\n          statements.push(`insertDynamic(element, null, () => resolveHtmlSlot(props[${JSON.stringify(directive.prop)}]))`)\n        } else if (directive.kind === 'event') {\n          statements.push(`addEventListener(element, ${JSON.stringify(directive.name)}, (event) => { const handler = props[${JSON.stringify(directive.prop)}]; if (typeof handler === 'function') handler(event); })`)\n        } else if (directive.kind === 'attribute') {\n          statements.push(`bindAttribute(element, ${JSON.stringify(directive.name)}, () => sanitizeHtmlAttribute(${JSON.stringify(directive.name)}, props[${JSON.stringify(directive.prop)}] ?? ''))`)\n        } else if (directive.kind === 'property') {\n          statements.push(`bindProperty(element, ${JSON.stringify(directive.name)}, () => props[${JSON.stringify(directive.prop)}])`)\n        }\n        continue\n      }\n      if (blockedAttributes.test(name)) throw new Error(`Vobs HTML component: 禁止使用危险属性 ${attribute.name} (${filename})`)\n      if (urlAttributes.has(name) && !isSafeUrl(value)) {\n        throw new Error(`Vobs HTML component: 禁止使用危险 URL 属性 ${attribute.name} (${filename})`)\n      }\n      statements.push(`setAttribute(element, ${JSON.stringify(attribute.name)}, ${JSON.stringify(value)})`)\n    }\n    if (dynamicText.length > 1) throw new Error(`Vobs HTML component: 一个元素只能使用一个 data-vobs-text 指令 (${filename})`)\n    if (dynamicText.length === 1) {\n      const text = 'createText(\"\")'\n      statements.push(`const text = ${text}`)\n      statements.push('insertBefore(element, text, null)')\n      statements.push(`bindText(text, () => props[${JSON.stringify(dynamicText[0])}] ?? '')`)\n    } else {\n      for (const child of children) statements.push(`insertBefore(element, ${child}, null)`)\n    }\n    statements.push('return element')\n    return [`(() => {${statements.join(';')};})()`]\n  }\n\n  return compileChildren(node as HtmlDocumentFragment, filename)\n}\n\nfunction isElement(node: HtmlNode): node is HtmlElement {\n  return !node.nodeName.startsWith('#')\n}\n\nfunction isSafeUrl(value: string): boolean {\n  const normalized = value.trim().toLowerCase()\n  if (normalized.startsWith('#') || normalized.startsWith('/') || normalized.startsWith('./') || normalized.startsWith('../')) return true\n  try {\n    return safeProtocols.has(new URL(normalized, 'https://vobs.invalid/').protocol)\n  } catch {\n    return false\n  }\n}\n\ntype HtmlDirective =\n  | { readonly kind: 'text' | 'slot'; readonly prop: string }\n  | { readonly kind: 'event' | 'attribute' | 'property'; readonly name: string; readonly prop: string }\n\nfunction parseDirective(name: string, value: string, filename: string): HtmlDirective | null {\n  const match = directivePattern.exec(name)\n  if (!match) return null\n  const kind = match[1].toLowerCase()\n  const namePart = match[2]\n  const prop = value.trim()\n  if (!prop || !/^[A-Za-z_$][\\w$]*$/u.test(prop)) {\n    throw new Error(`Vobs HTML component: ${name} 必须引用有效的 props 名称 (${filename})`)\n  }\n  if (kind === 'text' || kind === 'slot') {\n    if (namePart) throw new Error(`Vobs HTML component: ${name} 不接受额外名称 (${filename})`)\n    return { kind, prop }\n  }\n  if (!namePart || !/^[a-z][a-z0-9:-]*$/iu.test(namePart)) {\n    throw new Error(`Vobs HTML component: ${name} 必须包含有效名称 (${filename})`)\n  }\n  if (kind === 'on') return { kind: 'event', name: namePart.toLowerCase(), prop }\n  if (kind === 'bind') {\n    if (namePart.toLowerCase() === 'style') throw new Error(`Vobs HTML component: 不允许动态绑定 style (${filename})`)\n    return { kind: 'attribute', name: namePart, prop }\n  }\n  if (!safePropertyNames.has(namePart.toLowerCase())) {\n    throw new Error(`Vobs HTML component: 不允许动态绑定 property ${namePart} (${filename})`)\n  }\n  return { kind: 'property', name: normalizePropertyName(namePart), prop }\n}\n\nfunction normalizePropertyName(name: string): string {\n  return name.toLowerCase() === 'readonly' ? 'readOnly' : name.toLowerCase() === 'tabindex' ? 'tabIndex' : name\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -11,7 +11,7 @@
     "type": "git",
     "url": "git+https://github.com/vobsjs/vobs.git"
   },
-  "version": "1.2.2",
+  "version": "1.3.1",
   "publishConfig": {
     "access": "public"
   },
@@ -33,8 +33,8 @@
     "./source/*": "./src/*"
   },
   "dependencies": {
-    "@vobs/compiler": "1.2.2",
-    "@vobs/runtime": "1.2.2",
-    "parse5": "^8.0.1"
+    "parse5": "^8.0.1",
+    "@vobs/compiler": "1.3.1",
+    "@vobs/runtime": "1.3.1"
   }
 }

package/src/index.test.ts

@@ -141,6 +141,54 @@ describe('vobsPlugin', () => {
     expect(keys).toEqual(['page.title', 'common.ok'])
   })
 
+  it('为 .ts 状态模块注入 HMR 保鲜与接受器（dev 默认开启）', () => {
+    const plugin = vobsPlugin()
+    const transform = plugin.transform
+    if (typeof transform !== 'function') throw new Error('Vobs Vite Plugin: 缺少 transform 钩子')
+
+    const result = transform.call({} as ThisParameterType<typeof transform>,
+      `import { state } from '@vobs/reactivity'\nexport const count = state(0)\n`,
+      'src/stores/counter.ts'
+    ) as { code: string }
+
+    expect(result.code).toContain('hmrStateRef("src/stores/counter.ts#count"')
+    expect(result.code).toContain('import.meta.hot.accept')
+  })
+
+  it('普通 .ts 模块与 .d.ts 不参与编译', () => {
+    const plugin = vobsPlugin()
+    const transform = plugin.transform
+    if (typeof transform !== 'function') throw new Error('Vobs Vite Plugin: 缺少 transform 钩子')
+
+    expect(transform.call({} as ThisParameterType<typeof transform>, `export const value = 1`, 'src/utils/math.ts')).toBeNull()
+    expect(transform.call({} as ThisParameterType<typeof transform>, `export declare const x: number`, 'src/types.d.ts')).toBeNull()
+  })
+
+  it('hmrState: false 关闭 .ts 状态模块处理', () => {
+    const plugin = vobsPlugin({ hmrState: false })
+    const transform = plugin.transform
+    if (typeof transform !== 'function') throw new Error('Vobs Vite Plugin: 缺少 transform 钩子')
+
+    const result = transform.call({} as ThisParameterType<typeof transform>,
+      `import { state } from '@vobs/reactivity'\nexport const count = state(0)\n`,
+      'src/stores/counter.ts'
+    )
+    expect(result).toBeNull()
+  })
+
+  it('生产构建不为 .ts 状态模块注入 HMR', () => {
+    const plugin = vobsPlugin()
+    ;(plugin.configResolved as (config: unknown) => void)?.({ command: 'build' })
+    const transform = plugin.transform
+    if (typeof transform !== 'function') throw new Error('Vobs Vite Plugin: 缺少 transform 钩子')
+
+    const result = transform.call({} as ThisParameterType<typeof transform>,
+      `import { state } from '@vobs/reactivity'\nexport const count = state(0)\n`,
+      'src/stores/counter.ts'
+    )
+    expect(result).toBeNull()
+  })
+
   it('将 HTML 模块编译为无 innerHTML 的 Vobs 组件', () => {
     const result = compileHtmlComponent('<article class="copy"><h1>Hello</h1><p>Safe</p></article>', {
       filename: 'src/content.html'

package/src/index.ts

@@ -11,6 +11,13 @@ export interface VobsVitePluginOptions {
   include?: RegExp
   compiler?: CompileOptions
   hmr?: boolean
+  /**
+   * 模块级状态 HMR 保鲜（默认开启，仅 dev 生效）。开启后：
+   * - 模块顶层 state() 声明编译为 hmrStateRef(...)，热更新重执行模块时复用既有信号，
+   *   消除"新旧两份模块实例、两份状态"导致的编辑不生效/页面半边失灵；
+   * - 声明了模块级 state 的 .ts 文件（store 类模块）也纳入 HMR 处理。
+   */
+  hmrState?: boolean
   extractI18n?: (key: string, filename: string) => void
   html?: boolean | { readonly extensions?: readonly string[] }
 }
@@ -19,6 +26,7 @@ export function vobsPlugin(options: VobsVitePluginOptions = {}): Plugin {
   const include = options.include ?? /\.tsx(?:$|\?)/
   const htmlModules = new Set<string>()
   let productionBuild = false
+  let hmrStateEnabled = (options.hmr ?? true) && (options.hmrState ?? true)
 
   return {
     name: 'vobs',
@@ -27,6 +35,7 @@ export function vobsPlugin(options: VobsVitePluginOptions = {}): Plugin {
 
     configResolved(config) {
       productionBuild = config.command === 'build'
+      hmrStateEnabled = (options.hmr ?? true) && !productionBuild && (options.hmrState ?? true)
     },
 
     resolveId(source: string, importer: string | undefined) {
@@ -44,17 +53,30 @@ export function vobsPlugin(options: VobsVitePluginOptions = {}): Plugin {
     },
 
     transform(code: string, id: string) {
-      include.lastIndex = 0
-      if (!include.test(id)) return null
+      const cleanId = id.split(/[?#]/u, 1)[0]
+      const isTsx = cleanId.endsWith('.tsx')
+      const isStateTs = isStateModulePath(cleanId)
+      if (!isTsx && !isStateTs) return null
+      if (options.include) {
+        include.lastIndex = 0
+        if (!include.test(id)) return null
+      }
+
+      // .ts 状态模块（store 类）：声明了模块级 state 才纳入编译与 HMR，
+      // 避免对普通 .ts 全量重印。
+      if (!isTsx && (!hmrStateEnabled || !isStatefulModule(code))) return null
 
       const extractor = options.extractI18n
         ? createI18nExtractor({ onKey: options.extractI18n })
         : undefined
+      const hmr = options.hmr ?? !productionBuild
       const result = compileWithSourceMap(code, {
         ...options.compiler,
         // 生产构建默认剔除组件源码位置（错误定位走 source map）；显式配置优先。
         sourceLocation: options.compiler?.sourceLocation ?? !productionBuild,
         filename: id,
+        // HMR 模块标识必须跨 ?t= 查询稳定（registry 复用语义依赖它），用干净路径。
+        hmrModuleId: hmr ? cleanId : options.compiler?.hmrModuleId,
         plugins: [
           ...(options.compiler?.plugins ?? []),
           ...(extractor ? [extractor.plugin] : [])
@@ -71,8 +93,7 @@ export function vobsPlugin(options: VobsVitePluginOptions = {}): Plugin {
           fix: diagnostic.fix
         })
       }
-      const hmr = options.hmr ?? !productionBuild
-      const hmrCode = hmr ? createHmrCode(id) : ''
+      const hmrCode = hmr ? createHmrCode(cleanId) : ''
       return {
         code: `${result.code}${hmrCode}`,
         map: result.map
@@ -81,6 +102,19 @@ export function vobsPlugin(options: VobsVitePluginOptions = {}): Plugin {
   }
 }
 
+/** 模块级 state 的 store 类 .ts 模块判定：从 @vobs 导入 state 且实际调用。 */
+function isStatefulModule(code: string): boolean {
+  return /\bimport\s+(?:type\s+)?\{[^}]*\bstate\b[^}]*\}\s*from\s*['"]@vobs\/(?:reactivity|vobs)['"]/u.test(code)
+    && /(?<![\w$.])state\s*\(/u.test(code)
+}
+
+function isStateModulePath(cleanId: string): boolean {
+  if (!cleanId.endsWith('.ts')) return false
+  if (cleanId.endsWith('.d.ts')) return false
+  if (cleanId.includes('node_modules')) return false
+  return true
+}
+
 function isRelativeModule(source: string): boolean {
   return source.startsWith('./') || source.startsWith('../')
 }