@vobs/vite-plugin 0.3.0 → 1.1.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 vobsjs
+Copyright (c) 2026 vobs contributors
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -0,0 +1,43 @@
+# @vobs/vite-plugin
+
+Vite plugin that compiles Vobs TSX, turns imported HTML files into components, and wires up HMR and i18n key extraction.
+
+## Install
+
+```bash
+npm install @vobs/vite-plugin
+```
+
+## Quick start
+
+```ts
+// vite.config.ts
+import { defineConfig } from 'vite'
+import { vobsPlugin } from '@vobs/vite-plugin'
+
+const collectedKeys = new Set<string>()
+
+export default defineConfig({
+  plugins: [
+    vobsPlugin({
+      html: true,
+      extractI18n: key => collectedKeys.add(key)
+    })
+  ]
+})
+```
+
+## API
+
+| Signature | Description |
+| --- | --- |
+| `vobsPlugin(options?)` | Create the plugin; compiles matched modules with `@vobs/compiler`, returns source maps, and throws compiler errors as `VobsError` with code, location and code frame. |
+| `options.include` | `RegExp` selecting modules to compile; defaults to `/\.tsx(?:$|\?)/`. |
+| `options.compiler` | Extra `CompileOptions` forwarded to the compiler (e.g. custom `plugins`). |
+| `options.hmr` | Inject `import.meta.hot` accept/dispose handlers; defaults to on in dev and off for production builds. |
+| `options.extractI18n` | Callback `(key, filename)` receiving each static translation key collected from `t('...')` and `i18n.t('...')` calls. |
+| `options.html` | Compile imported `.html`/`.htm` modules into Vobs components (scripts, inline event attributes and dangerous URLs are rejected); `false` disables, or pass `{ extensions }` for other file types. |
+
+## Types
+
+VobsVitePluginOptions

package/package.json

@@ -1,54 +1,21 @@
 {
-  "name": "@vobs/vite-plugin",
-  "version": "0.3.0",
-  "description": "Vite integration, HTML transforms and file routes for vobs.",
-  "type": "module",
-  "publishConfig": {
-    "access": "public"
-  },
   "license": "MIT",
-  "author": "vobsjs",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/vobsjs/vobs.git",
-    "directory": "plugins/vite"
-  },
-  "bugs": {
-    "url": "https://github.com/vobsjs/vobs/issues"
-  },
-  "homepage": "https://github.com/vobsjs/vobs#readme",
-  "dependencies": {
-    "@vobs/router": "0.3.0",
-    "@vobs/compiler-dom": "0.3.0",
-    "@vobs/runtime-core": "0.3.0",
-    "@vobs/runtime-dom": "0.3.0",
-    "@vobs/icons": "0.3.0"
-  },
-  "peerDependencies": {
-    "vite": "^8.0.0"
-  },
-  "devDependencies": {
-    "vite": "^8.0.0"
-  },
   "files": [
-    "dist"
+    "src",
+    "README.md",
+    "LICENSE"
   ],
+  "name": "@vobs/vite-plugin",
+  "version": "1.1.0",
+  "type": "module",
+  "main": "src/index.ts",
+  "types": "src/index.ts",
   "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
-    },
-    "./client": {
-      "types": "./dist/client.d.ts",
-      "import": "./dist/client.js"
-    },
-    "./package.json": "./package.json"
+    ".": "./src/index.ts"
   },
-  "types": "./dist/index.d.ts",
-  "module": "./dist/index.js",
-  "main": "./dist/index.js",
-  "sideEffects": false,
-  "engines": {
-    "node": ">=22.12.0"
+  "dependencies": {
+    "parse5": "^8.0.1",
+    "@vobs/runtime": "1.1.0",
+    "@vobs/compiler": "1.1.0"
   }
 }

package/src/html-component.ts

@@ -0,0 +1,137 @@
+import { parseFragment, type DefaultTreeAdapterMap, type DefaultTreeAdapterTypes } from 'parse5'
+
+type HtmlNode = DefaultTreeAdapterTypes.Node
+type HtmlDocumentFragment = DefaultTreeAdapterTypes.DocumentFragment
+type HtmlElement = DefaultTreeAdapterTypes.Element
+
+const blockedTags = new Set(['script', 'iframe', 'object', 'embed', 'base', 'meta', 'link', 'style'])
+const blockedAttributes = /^(?:on[a-z]+|srcdoc|style)$/iu
+const urlAttributes = new Set(['href', 'src', 'action', 'formaction', 'poster', 'xlink:href'])
+const safeProtocols = new Set(['http:', 'https:', 'mailto:', 'tel:'])
+const directivePattern = /^data-vobs-(text|slot|on|bind|prop)(?:-(.+))?$/iu
+const safePropertyNames = new Set([
+  'value', 'checked', 'selected', 'disabled', 'multiple', 'readonly', 'required',
+  'autofocus', 'hidden', 'tabindex'
+])
+
+export interface HtmlComponentOptions {
+  readonly filename?: string
+}
+
+/** Converts a trusted static HTML fragment to Vobs runtime node creation code. */
+export function compileHtmlComponent(source: string, options: HtmlComponentOptions = {}): string {
+  const fragment = parseFragment(source)
+  const body = compileChildren(fragment, options.filename ?? 'component.html')
+  const result = body.length === 1 ? body[0] : `createFragment((parent, anchor) => {${body.map(code => `insertBefore(parent, ${code}, anchor);`).join('')}})`
+
+  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(() => {})"}; }`
+}
+
+function compileChildren(parent: HtmlDocumentFragment | HtmlElement, filename: string): string[] {
+  return parent.childNodes.flatMap(node => compileNode(node, filename))
+}
+
+function compileNode(node: HtmlNode, filename: string): string[] {
+  if (node.nodeName === '#text') {
+    const value = (node as DefaultTreeAdapterMap['textNode']).value
+    return value ? [`createText(${JSON.stringify(value)})`] : []
+  }
+
+  if (node.nodeName === '#comment') return []
+  if (node.nodeName !== '#document-fragment' && !isElement(node)) return []
+
+  if (isElement(node)) {
+    const tag = node.tagName.toLowerCase()
+    if (blockedTags.has(tag)) throw new Error(`Vobs HTML component: 禁止使用 <${tag}> (${filename})`)
+
+    const children = compileChildren(node, filename)
+    const statements = [`const element = createElement(${JSON.stringify(tag)})`]
+    const dynamicText = [] as string[]
+    for (const attribute of node.attrs) {
+      const name = attribute.name.toLowerCase()
+      const value = attribute.value
+      const directive = parseDirective(name, value, filename)
+      if (directive) {
+        if (directive.kind === 'text') {
+          dynamicText.push(directive.prop)
+        } else if (directive.kind === 'slot') {
+          statements.push(`insertDynamic(element, null, () => resolveHtmlSlot(props[${JSON.stringify(directive.prop)}]))`)
+        } else if (directive.kind === 'event') {
+          statements.push(`addEventListener(element, ${JSON.stringify(directive.name)}, (event) => { const handler = props[${JSON.stringify(directive.prop)}]; if (typeof handler === 'function') handler(event); })`)
+        } else if (directive.kind === 'attribute') {
+          statements.push(`bindAttribute(element, ${JSON.stringify(directive.name)}, () => sanitizeHtmlAttribute(${JSON.stringify(directive.name)}, props[${JSON.stringify(directive.prop)}] ?? ''))`)
+        } else if (directive.kind === 'property') {
+          statements.push(`bindProperty(element, ${JSON.stringify(directive.name)}, () => props[${JSON.stringify(directive.prop)}])`)
+        }
+        continue
+      }
+      if (blockedAttributes.test(name)) throw new Error(`Vobs HTML component: 禁止使用危险属性 ${attribute.name} (${filename})`)
+      if (urlAttributes.has(name) && !isSafeUrl(value)) {
+        throw new Error(`Vobs HTML component: 禁止使用危险 URL 属性 ${attribute.name} (${filename})`)
+      }
+      statements.push(`setAttribute(element, ${JSON.stringify(attribute.name)}, ${JSON.stringify(value)})`)
+    }
+    if (dynamicText.length > 1) throw new Error(`Vobs HTML component: 一个元素只能使用一个 data-vobs-text 指令 (${filename})`)
+    if (dynamicText.length === 1) {
+      const text = 'createText("")'
+      statements.push(`const text = ${text}`)
+      statements.push('insertBefore(element, text, null)')
+      statements.push(`bindText(text, () => props[${JSON.stringify(dynamicText[0])}] ?? '')`)
+    } else {
+      for (const child of children) statements.push(`insertBefore(element, ${child}, null)`)
+    }
+    statements.push('return element')
+    return [`(() => {${statements.join(';')};})()`]
+  }
+
+  return compileChildren(node as HtmlDocumentFragment, filename)
+}
+
+function isElement(node: HtmlNode): node is HtmlElement {
+  return !node.nodeName.startsWith('#')
+}
+
+function isSafeUrl(value: string): boolean {
+  const normalized = value.trim().toLowerCase()
+  if (normalized.startsWith('#') || normalized.startsWith('/') || normalized.startsWith('./') || normalized.startsWith('../')) return true
+  try {
+    return safeProtocols.has(new URL(normalized, 'https://vobs.invalid/').protocol)
+  } catch {
+    return false
+  }
+}
+
+type HtmlDirective =
+  | { readonly kind: 'text' | 'slot'; readonly prop: string }
+  | { readonly kind: 'event' | 'attribute' | 'property'; readonly name: string; readonly prop: string }
+
+function parseDirective(name: string, value: string, filename: string): HtmlDirective | null {
+  const match = directivePattern.exec(name)
+  if (!match) return null
+  const kind = match[1].toLowerCase()
+  const namePart = match[2]
+  const prop = value.trim()
+  if (!prop || !/^[A-Za-z_$][\w$]*$/u.test(prop)) {
+    throw new Error(`Vobs HTML component: ${name} 必须引用有效的 props 名称 (${filename})`)
+  }
+  if (kind === 'text' || kind === 'slot') {
+    if (namePart) throw new Error(`Vobs HTML component: ${name} 不接受额外名称 (${filename})`)
+    return { kind, prop }
+  }
+  if (!namePart || !/^[a-z][a-z0-9:-]*$/iu.test(namePart)) {
+    throw new Error(`Vobs HTML component: ${name} 必须包含有效名称 (${filename})`)
+  }
+  if (kind === 'on') return { kind: 'event', name: namePart.toLowerCase(), prop }
+  if (kind === 'bind') {
+    if (namePart.toLowerCase() === 'style') throw new Error(`Vobs HTML component: 不允许动态绑定 style (${filename})`)
+    return { kind: 'attribute', name: namePart, prop }
+  }
+  if (!safePropertyNames.has(namePart.toLowerCase())) {
+    throw new Error(`Vobs HTML component: 不允许动态绑定 property ${namePart} (${filename})`)
+  }
+  return { kind: 'property', name: normalizePropertyName(namePart), prop }
+}
+
+function normalizePropertyName(name: string): string {
+  return name.toLowerCase() === 'readonly' ? 'readOnly' : name.toLowerCase() === 'tabindex' ? 'tabIndex' : name
+}

package/src/index.test.ts

@@ -0,0 +1,195 @@
+import { describe, expect, it } from 'vitest'
+import ts from 'typescript'
+import { compileHtmlComponent } from './html-component'
+import { vobsPlugin } from './index'
+
+describe('vobsPlugin', () => {
+  it('将编译器插件配置透传给 TSX 转换', () => {
+    const plugin = vobsPlugin({
+      compiler: {
+        plugins: [{
+          name: 'replace-message',
+          transform: {
+            node(node, context) {
+              if (ts.isIdentifier(node) && node.text === 'message') {
+                return context.factory.createIdentifier('title')
+              }
+              return node
+            }
+          }
+        }]
+      }
+    })
+    const transform = plugin.transform
+    if (typeof transform !== 'function') throw new Error('Vobs Vite plugin: 缺少 transform 钩子')
+
+    const result = transform.call({} as ThisParameterType<typeof transform>,
+      `export function App() { return <span>{message}</span> }`,
+      'src/App.tsx'
+    )
+
+    expect(result).toMatchObject({ code: expect.stringContaining('() => title') })
+  })
+
+  it('返回源码映射并注入可关闭的 HMR 接受器', () => {
+    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>,
+      `export function App() { return <span>hello</span> }`,
+      'src/App.tsx'
+    ) as { code: string; map: { sources: string[] } }
+
+    expect(result.map.sources).toEqual(['src/App.tsx'])
+    expect(result.code).toContain('import.meta.hot.accept')
+    expect(result.code).toContain('updateHmrModule')
+  })
+
+  it('可以关闭 HMR 注入', () => {
+    const plugin = vobsPlugin({ hmr: false })
+    const transform = plugin.transform
+    if (typeof transform !== 'function') throw new Error('Vobs Vite plugin: 缺少 transform 钩子')
+
+    const result = transform.call({} as ThisParameterType<typeof transform>,
+      `export function App() { return <span>hello</span> }`,
+      'src/App.tsx'
+    ) as { code: string }
+
+    expect(result.code).not.toContain('import.meta.hot.accept')
+  })
+
+  it('生产构建默认不注入 HMR 代码', () => {
+    const plugin = vobsPlugin()
+    const configResolved = plugin.configResolved as ((config: unknown) => void) | undefined
+    configResolved?.({ 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>,
+      `export const App = () => <main>hello</main>`, 'src/App.tsx') as { code: string }
+    expect(result.code).not.toContain('import.meta.hot.accept')
+  })
+
+  it('生产构建默认剔除组件源码位置，开发构建保留', () => {
+    const compile = (plugin: ReturnType<typeof vobsPlugin>, source: string) => {
+      const transform = plugin.transform
+      if (typeof transform !== 'function') throw new Error('Vobs Vite plugin: 缺少 transform 钩子')
+      return transform.call({} as ThisParameterType<typeof transform>,
+        source, 'src/App.tsx') as { code: string }
+    }
+
+    const production = vobsPlugin({ hmr: false })
+    ;(production.configResolved as (config: unknown) => void)?.({ command: 'build' })
+    const productionCode = compile(production, `export function App() { return <Panel /> }`).code
+    expect(productionCode).toContain('createComponent')
+    expect(productionCode).not.toContain('file:')
+
+    const development = compile(vobsPlugin(), `export function App() { return <Panel /> }`).code
+    expect(development).toContain('file: "src/App.tsx"')
+  })
+
+  it('显式 compiler.sourceLocation 配置优先于生产默认值', () => {
+    const plugin = vobsPlugin({ hmr: false, compiler: { sourceLocation: true } })
+    const configResolved = plugin.configResolved as ((config: unknown) => void) | undefined
+    configResolved?.({ 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>,
+      `export function App() { return <Panel /> }`, 'src/App.tsx') as { code: string }
+    expect(result.code).toContain('file: "src/App.tsx"')
+  })
+
+  it('转换不含 export function 的合法 TSX 模块', () => {
+    const plugin = vobsPlugin({ hmr: false })
+    const transform = plugin.transform
+    if (typeof transform !== 'function') throw new Error('Vobs Vite plugin: 缺少 transform 钩子')
+
+    const result = transform.call({} as ThisParameterType<typeof transform>,
+      `export const App = () => <main>hello</main>`,
+      'src/App.tsx'
+    ) as { code: string }
+
+    // 完全静态的 JSX 提升为模板克隆
+    expect(result.code).toContain('createTemplate("<main>hello</main>")')
+  })
+
+  it('转换默认箭头导出和带 query 的 TSX 模块', () => {
+    const plugin = vobsPlugin({ hmr: false })
+    const transform = plugin.transform
+    if (typeof transform !== 'function') throw new Error('Vobs Vite plugin: 缺少 transform 钩子')
+
+    const result = transform.call({} as ThisParameterType<typeof transform>,
+      `export default () => <main>hello</main>`,
+      'src/App.tsx?direct'
+    ) as { code: string }
+
+    // 完全静态的 JSX 提升为模板克隆
+    expect(result.code).toContain('createTemplate("<main>hello</main>")')
+  })
+
+  it('通过 extractI18n 回调收集静态翻译 key', () => {
+    const keys: string[] = []
+    const plugin = vobsPlugin({ hmr: false, extractI18n: key => keys.push(key) })
+    const transform = plugin.transform
+    if (typeof transform !== 'function') throw new Error('Vobs Vite Plugin: 缺少 transform 钩子')
+
+    transform.call({} as ThisParameterType<typeof transform>,
+      `export const Page = () => <main>{t('page.title')} {i18n.t('common.ok')}</main>`,
+      'src/Page.tsx'
+    )
+
+    expect(keys).toEqual(['page.title', 'common.ok'])
+  })
+
+  it('将 HTML 模块编译为无 innerHTML 的 Vobs 组件', () => {
+    const result = compileHtmlComponent('<article class="copy"><h1>Hello</h1><p>Safe</p></article>', {
+      filename: 'src/content.html'
+    })
+
+    expect(result).toContain("createElement(\"article\")")
+    expect(result).toContain("setAttribute(element, \"class\", \"copy\")")
+    expect(result).toContain('createText(\"Hello\")')
+    expect(result).not.toContain('innerHTML')
+  })
+
+  it('将受限的 Vobs 指令连接到响应式 props 和事件', () => {
+    const result = compileHtmlComponent(`
+      <button data-vobs-on-click="onSave" data-vobs-prop-disabled="disabled">
+        <span data-vobs-text="label"></span>
+        <span data-vobs-slot="actions"></span>
+      </button>
+    `)
+
+    expect(result).toContain('addEventListener(element, "click"')
+    expect(result).toContain('bindProperty(element, "disabled"')
+    expect(result).toContain('bindText(text')
+    expect(result).toContain('insertDynamic(element, null')
+    expect(result).toContain('props["onSave"]')
+    expect(result).toContain('bindProperty(element, "disabled"')
+  })
+
+  it('拒绝脚本、事件属性和危险 URL', () => {
+    expect(() => compileHtmlComponent('<script>alert(1)</script>')).toThrow('禁止使用 <script>')
+    expect(() => compileHtmlComponent('<button onclick="alert(1)">run</button>')).toThrow('禁止使用危险属性')
+    expect(() => compileHtmlComponent('<a href="javascript:alert(1)">run</a>')).toThrow('禁止使用危险 URL')
+    expect(() => compileHtmlComponent('<button data-vobs-on-click="on-click">run</button>')).toThrow('有效的 props 名称')
+    expect(() => compileHtmlComponent('<div data-vobs-bind-style="styleValue"></div>')).toThrow('不允许动态绑定 style')
+    expect(() => compileHtmlComponent('<div data-vobs-prop-innerHTML="content"></div>')).toThrow('不允许动态绑定 property')
+  })
+
+  it('忽略注释和文档类型声明', () => {
+    const result = compileHtmlComponent('<!doctype html><!-- note --><main>content</main>')
+    expect(result).toContain('createElement(\"main\")')
+    expect(result).not.toContain('tagName')
+  })
+
+  it('只将被导入的 HTML 文件交给组件加载器', async () => {
+    const plugin = vobsPlugin({ hmr: false })
+    const resolveId = plugin.resolveId
+    const load = plugin.load
+    if (typeof resolveId !== 'function' || typeof load !== 'function') throw new Error('Vobs Vite Plugin: 缺少 HTML 模块钩子')
+
+    expect(resolveId.call({} as ThisParameterType<typeof resolveId>, './content.html', 'src/Page.tsx', { attributes: {}, isEntry: false })).toBeTruthy()
+    expect(resolveId.call({} as ThisParameterType<typeof resolveId>, './index.html', undefined, { attributes: {}, isEntry: false })).toBeNull()
+  })
+})

package/src/index.ts

@@ -0,0 +1,108 @@
+// Vite 插件：集成 Vobs 编译器
+
+import { readFile } from 'node:fs/promises'
+import path from 'node:path'
+import type { Plugin } from 'vite'
+import { compileWithSourceMap, createI18nExtractor, type CompileOptions } from '@vobs/compiler'
+import { VobsError } from '@vobs/runtime/error'
+import { compileHtmlComponent } from './html-component.ts'
+
+export interface VobsVitePluginOptions {
+  include?: RegExp
+  compiler?: CompileOptions
+  hmr?: boolean
+  extractI18n?: (key: string, filename: string) => void
+  html?: boolean | { readonly extensions?: readonly string[] }
+}
+
+export function vobsPlugin(options: VobsVitePluginOptions = {}): Plugin {
+  const include = options.include ?? /\.tsx(?:$|\?)/
+  const htmlModules = new Set<string>()
+  let productionBuild = false
+
+  return {
+    name: 'vobs',
+
+    enforce: 'pre',
+
+    configResolved(config) {
+      productionBuild = config.command === 'build'
+    },
+
+    resolveId(source: string, importer: string | undefined) {
+      if (!importer || !isHtmlComponent(source, options.html) || !isRelativeModule(source)) return null
+      const cleanImporter = importer.split(/[?#]/u, 1)[0]
+      const cleanSource = source.split(/[?#]/u, 1)[0]
+      const resolved = path.resolve(path.dirname(cleanImporter), cleanSource)
+      htmlModules.add(resolved)
+      return resolved
+    },
+
+    async load(id: string) {
+      if (!htmlModules.has(id)) return null
+      return compileHtmlComponent(await readFile(id, 'utf8'), { filename: id })
+    },
+
+    transform(code: string, id: string) {
+      include.lastIndex = 0
+      if (!include.test(id)) return null
+
+      const extractor = options.extractI18n
+        ? createI18nExtractor({ onKey: options.extractI18n })
+        : undefined
+      const result = compileWithSourceMap(code, {
+        ...options.compiler,
+        // 生产构建默认剔除组件源码位置（错误定位走 source map）；显式配置优先。
+        sourceLocation: options.compiler?.sourceLocation ?? !productionBuild,
+        filename: id,
+        plugins: [
+          ...(options.compiler?.plugins ?? []),
+          ...(extractor ? [extractor.plugin] : [])
+        ]
+      })
+      const diagnostic = result.diagnostics.find(item => item.severity === 'error')
+      if (diagnostic) {
+        throw new VobsError({
+          code: diagnostic.code,
+          layer: 'compiler',
+          message: diagnostic.message,
+          location: diagnostic.location,
+          codeFrame: diagnostic.codeFrame,
+          fix: diagnostic.fix
+        })
+      }
+      const hmr = options.hmr ?? !productionBuild
+      const hmrCode = hmr ? createHmrCode(id) : ''
+      return {
+        code: `${result.code}${hmrCode}`,
+        map: result.map
+      }
+    }
+  }
+}
+
+function isRelativeModule(source: string): boolean {
+  return source.startsWith('./') || source.startsWith('../')
+}
+
+function isHtmlComponent(id: string, option: VobsVitePluginOptions['html']): boolean {
+  if (option === false) return false
+  const extensions = typeof option === 'object' && option.extensions?.length ? option.extensions : ['.html', '.htm']
+  const cleanId = id.split(/[?#]/u, 1)[0]
+  return extensions.some(extension => cleanId.endsWith(extension))
+}
+
+
+function createHmrCode(moduleId: string): string {
+  const encodedId = JSON.stringify(moduleId)
+  return `
+import { disposeHmrModule, updateHmrModule } from '@vobs/vobs'
+
+if (import.meta.hot) {
+  import.meta.hot.accept((module) => {
+    if (module) updateHmrModule(${encodedId}, module)
+  })
+  import.meta.hot.dispose(() => disposeHmrModule(${encodedId}))
+}
+`
+}

package/dist/client.d.ts

@@ -1,48 +0,0 @@
-/** @license MIT
- * Copyright (c) 2026 vobsjs
- * @vobs/vite-plugin
- */
-declare module '*.html' {
-    const template: import('@vobs/runtime-dom').CompiledTemplate<object>;
-    export default template;
-}
-declare module '*?vobs-image' {
-    export interface VobsImageMetadata {
-        readonly src: string;
-        readonly width: number;
-        readonly height: number;
-        readonly format: 'jpeg' | 'png' | 'svg' | 'webp';
-    }
-    const metadata: VobsImageMetadata;
-    export default metadata;
-}
-declare module '*.svg?raw' {
-    const source: string;
-    export default source;
-}
-declare module 'vobs:icons' {
-    const icons: import('@vobs/icons').IconRegistry;
-    export { icons };
-    export default icons;
-}
-declare module 'vobs:routes' {
-    import type { RouteComponent, RouteRecord, RouterOptions } from '@vobs/router';
-    import type { RouterPort } from '@vobs/runtime-core';
-    export interface GeneratedRoutePathMap {
-    }
-    export type RoutePath = keyof GeneratedRoutePathMap extends never ? string : Extract<keyof GeneratedRoutePathMap, string>;
-    const generatedRoutes: readonly RouteRecord[];
-    const generatedRoutePaths: readonly RoutePath[];
-    const generatedNotFound: RouteComponent | undefined;
-    const generatedError: RouteComponent | undefined;
-    export type GeneratedRoutingManifest = {
-        readonly routes: typeof generatedRoutes;
-        readonly routePaths: typeof generatedRoutePaths;
-        readonly notFound: typeof generatedNotFound;
-        readonly error: typeof generatedError;
-    };
-    export function createRoutingRouter(options?: Omit<RouterOptions, 'routes' | 'notFound' | 'error'>): RouterPort | undefined;
-    const router: RouterPort | undefined;
-    export { generatedError as error, generatedNotFound as notFound, generatedRoutePaths as routePaths, generatedRoutes as routes, };
-    export default router;
-}

package/dist/client.js

@@ -1,5 +0,0 @@
-/** @license MIT
- * Copyright (c) 2026 vobsjs
- * @vobs/vite-plugin
- */
-"use strict";

package/dist/index.d.ts

@@ -1,54 +0,0 @@
-/** @license MIT
- * Copyright (c) 2026 vobsjs
- * @vobs/vite-plugin
- */
-export interface VobsVitePlugin {
-    readonly name: 'vobs-vite-plugin';
-    readonly enforce: 'pre';
-    /** Vite/Rollup binds this hook helper at call time. */
-    addWatchFile?(fileName: string): void;
-    configResolved(config: {
-        readonly root: string;
-    }): void;
-    buildStart(this: VobsBuildStartContext): void;
-    closeWatcher(): void;
-    resolveId(id: string, importer?: string): string | null;
-    load(this: VobsLoadContext, id: string): Promise<string | {
-        readonly code: string;
-        readonly map: object;
-    } | null>;
-    transform(this: VobsTransformContext, code: string, id: string): {
-        readonly code: string;
-        readonly map: object;
-    } | null;
-}
-interface VobsTransformContext {
-    addWatchFile?(fileName: string): void;
-}
-interface VobsLoadContext {
-    addWatchFile?(fileName: string): void;
-}
-interface VobsBuildStartContext {
-    addWatchFile?(fileName: string): void;
-}
-export interface VobsVitePluginOptions {
-    readonly runtimeModule?: string;
-    readonly check?: boolean | VobsViteCheckOptions;
-    readonly routes?: boolean | VobsViteRoutesOptions;
-    readonly images?: boolean;
-    readonly icons?: boolean | VobsViteIconsOptions;
-}
-export interface VobsViteCheckOptions {
-    readonly tsconfigPath?: string;
-    readonly rootNames?: readonly string[];
-    readonly viewFiles?: readonly string[];
-}
-export interface VobsViteRoutesOptions {
-    readonly pagesDir?: string;
-    readonly typesFile?: string;
-}
-export interface VobsViteIconsOptions {
-    readonly config?: string;
-}
-export declare function vobs(options?: VobsVitePluginOptions): VobsVitePlugin;
-export default vobs;