actview 3.0.0 → 3.1.0

package/README.md

@@ -7,7 +7,7 @@
 ## 核心功能
 
 - **vue 运行时 re-export**：响应式（`ref` / `reactive` / `computed` / `watch` / `effectScope`）、组件（`defineComponent` / `createApp` / `h`）、生命周期、内置组件（`KeepAlive` / `Teleport` / `Suspense` / `Transition` / `TransitionGroup`）
-- **defineComponent 桥接**（React 语义）：`ctx.slots` → `props.children`（读时求值），props 读不到时从 attrs 兜底，`inheritAttrs: false`
+- **defineComponent 桥接**（React 语义）：`ctx.slots` → `props.children`（读时求值），props 读不到时从 attrs 兜底；**有 props 声明时自动落根**（`inheritAttrs` 开启，未消费 attrs 透传到根元素 + scoped data-v 生效），无声明时保持不透传（React 语义，避免 props 污染 DOM）
 - **createContext**：React 语义（`.Provider` / `.use()`），基于 vue `provide/inject`
 - **JSX 类型层**：全局 `IntrinsicElements` 完整标签表（React 语义属性）+ vue 组件兼容；组件 props 严格检查（未声明 prop 报错）
 

package/dist/index.d.ts

@@ -23,7 +23,16 @@ type ActViewComponent<Props extends Record<string, any> = Record<string, any>> =
     __isVue?: true;
     __vccOpts?: any;
 };
-declare function defineComponent<Props extends Record<string, any> = Record<string, any>>(setup: (props: Props, ctx: SetupContext) => unknown, name?: string): ActViewComponent<Props>;
+interface ActViewDefineComponentOptions {
+    name?: string;
+    /**
+     * 运行时 props 声明（@actview/plugin-jsx 编译期从类型注解提取注入，
+     * 也可手写）。存在时开启自动落根：未消费的 attrs（class / data-v-* /
+     * 事件 / 透传属性）自动 apply 到根元素。
+     */
+    props?: Record<string, any>;
+}
+declare function defineComponent<Props extends Record<string, any> = Record<string, any>>(setup: (props: Props, ctx: SetupContext) => unknown, options?: ActViewDefineComponentOptions | string): ActViewComponent<Props>;
 interface Context<T> {
     /** 内部唯一键（Symbol）：对象身份即键 */
     readonly _key: symbol;
@@ -43,4 +52,4 @@ interface Context<T> {
 declare function createContext<T extends object>(defaultValue: Reactive<T>): Context<T>;
 declare function createContext<T>(defaultValue: T): Context<T>;
 
-export { type ActViewComponent, type Context, createContext, defineComponent };
+export { type ActViewComponent, type ActViewDefineComponentOptions, type Context, createContext, defineComponent };

package/dist/index.js

@@ -79,11 +79,15 @@ import {
   inject as inject2,
   provide as provide2
 } from "vue";
-function defineComponent(setup, name) {
+function defineComponent(setup, options) {
+  const opts = typeof options === "string" ? { name: options } : options ?? {};
   return vueDefineComponent({
-    name,
-    // 未消费 props 不自动落根 DOM（React 语义；Vue 默认 inheritAttrs 会落）
-    inheritAttrs: false,
+    name: opts.name,
+    // 编译期提取的 props 声明（无则 undefined——组件保持「任意 props 兜底」）
+    props: opts.props,
+    // 有 props 声明 → 开启自动落根（透传 + scoped data-v 生效）；
+    // 无声明 → false（React 语义：避免未消费 props 以 DOM 属性形式污染根元素）
+    inheritAttrs: !!opts.props,
     setup(props, ctx) {
       const attrs = ctx.attrs;
       const bridge = new Proxy(props, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "actview",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "type": "module",
   "description": "ActView v2：Vue 引擎 + React 语义 JSX（运行时基于 vue 官方包，JSX 由 @actview/plugin-jsx 编译）",
   "exports": {