@open-dy/vibecoding-sdk-taro 0.0.1-beta.5 → 0.0.1-beta.6

package/dist/ui/textarea.js.map

@@ -1 +1 @@
-{"version":3,"file":"textarea.js","sourceRoot":"","sources":["../../src/ui/textarea.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,QAAQ,IAAI,YAAY,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAA;AAEnE,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAA;AAEjC,SAAS,QAAQ,CAAC,EAChB,SAAS,EACT,KAAK,EACL,GAAG,KAAK,EAC4C;IACpD,MAAM,QAAQ,GAAG,CAAC,CAAE,KAAa,CAAC,QAAQ,CAAA;IAC1C,MAAM,WAAW,GAAI,KAAa,CAAC,cAAc,CAAC,CAAA;IAClD,MAAM,OAAO,GACX,WAAW,KAAK,SAAS;QACzB,WAAW,KAAK,KAAK;QACrB,WAAW,KAAK,OAAO,CAAA;IAEzB,OAAO,CACL,KAAC,IAAI,iBACO,UAAU,EACpB,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,EAAE,CACX,wRAAwR,EACxR,QAAQ,IAAI,4DAA4D,EACxE,OAAO,IAAI,mGAAmG,EAC9G,SAAS,CACV,YAED,KAAC,YAAY,IACX,SAAS,EAAC,uEAAuE,KAC7E,KAAK,GACT,GACG,CACR,CAAA;AACH,CAAC;AAED,OAAO,EAAE,QAAQ,EAAE,CAAA"}
+{"version":3,"file":"textarea.js","sourceRoot":"","sources":["../../src/ui/textarea.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,QAAQ,IAAI,YAAY,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAA;AAEnE,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAA;AAEjC;;;;;;;;;;;;GAYG;AACH,SAAS,QAAQ,CAAC,EAChB,SAAS,EACT,KAAK,EACL,GAAG,KAAK,EAC4C;IACpD,MAAM,QAAQ,GAAG,CAAC,CAAE,KAAa,CAAC,QAAQ,CAAA;IAC1C,MAAM,WAAW,GAAI,KAAa,CAAC,cAAc,CAAC,CAAA;IAClD,MAAM,OAAO,GACX,WAAW,KAAK,SAAS;QACzB,WAAW,KAAK,KAAK;QACrB,WAAW,KAAK,OAAO,CAAA;IAEzB,OAAO,CACL,KAAC,IAAI,iBACO,UAAU,EACpB,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,EAAE,CACX,wRAAwR,EACxR,QAAQ,IAAI,4DAA4D,EACxE,OAAO,IAAI,mGAAmG,EAC9G,SAAS,CACV,YAED,KAAC,YAAY,IACX,SAAS,EAAC,uEAAuE,KAC7E,KAAK,GACT,GACG,CACR,CAAA;AACH,CAAC;AAED,OAAO,EAAE,QAAQ,EAAE,CAAA"}

package/dist/ui/toggle-group.d.ts

@@ -2,18 +2,52 @@ import * as React from "react";
 import { type ViewProps } from "@tarojs/components";
 import { type VariantProps } from "class-variance-authority";
 import { toggleVariants } from "./toggle.js";
+/**
+ * @desc 切换按钮组组件。
+ * @param {Parameters<typeof ToggleGroup>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @param {Parameters<typeof ToggleGroup>[0]["variant"]} props.variant 整组的样式变体；未提供时各项默认 default。提供非空值时优先于 ToggleGroupItem.variant。
+ * @param {Parameters<typeof ToggleGroup>[0]["size"]} props.size 整组的尺寸；未提供时各项默认 default。提供非空值时优先于 ToggleGroupItem.size。
+ * @return {ReturnType<typeof ToggleGroup>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { ToggleGroup } from '@open-dy/vibecoding-sdk-taro/ui/toggle-group'
+ * <ToggleGroup />
+ * ```
+ */
 declare function ToggleGroup({ className, variant, size, spacing, orientation, type, multiple, disabled, value: valueProp, defaultValue, onValueChange, children, ...props }: ViewProps & VariantProps<typeof toggleVariants> & {
+    /** @desc 项目间隔的 Tailwind spacing 单位，默认 0；0 时显示相连的按钮边框和圆角，不是直接的像素值。 */
     spacing?: number;
+    /** @desc 按钮组排列方向：horizontal 横排、vertical 竖排，默认 horizontal；决定相连边框和首尾圆角。 */
     orientation?: "horizontal" | "vertical";
+    /** @desc 选择模式：single 单选、multiple 多选，默认 single；multiple 为 true 时强制多选。 */
     type?: "single" | "multiple";
+    /** @desc 多选快捷开关，默认 false；为 true 时优先于 type，允许同时选中多项。 */
     multiple?: boolean;
+    /** @desc 是否禁止整组切换，默认 false；禁用后各项不能通过内部操作改变选中状态。 */
     disabled?: boolean;
+    /** @desc 受控选中项；字符串表示单项，数组表示多项。传入后需在 onValueChange 中同步，省略时由内部状态管理。 */
     value?: string | string[];
+    /** @desc 非受控模式的初始选中项；默认无选中项，字符串表示单项、数组表示多项。仅初始化时读取，传入 value 后不生效。 */
     defaultValue?: string | string[];
+    /** @desc 用户切换选中项时调用；单选返回字符串（取消后为空字符串），多选返回字符串数组（清空后为空数组）。 */
     onValueChange?: (value: string | string[]) => void;
 }): React.JSX.Element;
+/**
+ * @desc 切换按钮组条目。
+ * @param {Parameters<typeof ToggleGroupItem>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @param {Parameters<typeof ToggleGroupItem>[0]["variant"]} props.variant 当前按钮的外观，默认 default；父 ToggleGroup.variant 为非空值时优先使用父配置。
+ * @param {Parameters<typeof ToggleGroupItem>[0]["size"]} props.size 当前按钮的尺寸，默认 default；父 ToggleGroup.size 为非空值时优先使用父配置。
+ * @return {ReturnType<typeof ToggleGroupItem>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { ToggleGroup, ToggleGroupItem } from '@open-dy/vibecoding-sdk-taro/ui/toggle-group'
+ * <ToggleGroup><ToggleGroupItem value="one" /></ToggleGroup>
+ * ```
+ */
 declare function ToggleGroupItem({ className, children, value, variant, size, disabled, ...props }: ViewProps & VariantProps<typeof toggleVariants> & {
+    /** @desc 当前项目的唯一标识；必须与父组件的 value/defaultValue 对应，不同项目使用不同值。 */
     value: string;
+    /** @desc 是否禁用当前项目，默认 false；禁用后不执行内部切换。父组件禁用时此项也不可操作。 */
     disabled?: boolean;
 }): React.JSX.Element;
 export { ToggleGroup, ToggleGroupItem };

package/dist/ui/toggle-group.js

@@ -14,6 +14,18 @@ const ToggleGroupContext = React.createContext({
     toggle: () => { },
     type: "single",
 });
+/**
+ * @desc 切换按钮组组件。
+ * @param {Parameters<typeof ToggleGroup>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @param {Parameters<typeof ToggleGroup>[0]["variant"]} props.variant 整组的样式变体；未提供时各项默认 default。提供非空值时优先于 ToggleGroupItem.variant。
+ * @param {Parameters<typeof ToggleGroup>[0]["size"]} props.size 整组的尺寸；未提供时各项默认 default。提供非空值时优先于 ToggleGroupItem.size。
+ * @return {ReturnType<typeof ToggleGroup>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { ToggleGroup } from '@open-dy/vibecoding-sdk-taro/ui/toggle-group'
+ * <ToggleGroup />
+ * ```
+ */
 function ToggleGroup({ className, variant, size, spacing = 0, orientation = "horizontal", type = "single", multiple = false, disabled = false, value: valueProp, defaultValue, onValueChange, children, ...props }) {
     const normalizeValue = React.useCallback((nextValue) => {
         if (nextValue === undefined)
@@ -43,6 +55,18 @@ function ToggleGroup({ className, variant, size, spacing = 0, orientation = "hor
     }, [value, isMultiple, controlled, onValueChange, disabled]);
     return (_jsx(View, { "data-slot": "toggle-group", "data-variant": variant, "data-size": size, "data-spacing": spacing, "data-orientation": orientation, "aria-disabled": disabled, "data-disabled": disabled ? "" : undefined, style: { "--gap": String(spacing) }, className: cn("group/toggle-group flex w-fit flex-row items-center gap-[--spacing(var(--gap))] rounded-lg", size === "sm" && "rounded-[min(var(--radius-md),10px)]", orientation === "vertical" && "flex-col items-stretch", className), ...props, children: _jsx(ToggleGroupContext.Provider, { value: { variant, size, spacing, orientation, disabled, value, toggle, type: resolvedType }, children: children }) }));
 }
+/**
+ * @desc 切换按钮组条目。
+ * @param {Parameters<typeof ToggleGroupItem>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @param {Parameters<typeof ToggleGroupItem>[0]["variant"]} props.variant 当前按钮的外观，默认 default；父 ToggleGroup.variant 为非空值时优先使用父配置。
+ * @param {Parameters<typeof ToggleGroupItem>[0]["size"]} props.size 当前按钮的尺寸，默认 default；父 ToggleGroup.size 为非空值时优先使用父配置。
+ * @return {ReturnType<typeof ToggleGroupItem>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { ToggleGroup, ToggleGroupItem } from '@open-dy/vibecoding-sdk-taro/ui/toggle-group'
+ * <ToggleGroup><ToggleGroupItem value="one" /></ToggleGroup>
+ * ```
+ */
 function ToggleGroupItem({ className, children, value, variant = "default", size = "default", disabled = false, ...props }) {
     const context = React.useContext(ToggleGroupContext);
     const pressed = context.value.includes(value);

package/dist/ui/toggle-group.js.map

@@ -1 +1 @@
-{"version":3,"file":"toggle-group.js","sourceRoot":"","sources":["../../src/ui/toggle-group.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"toggle-group.js","sourceRoot":"","sources":["../../src/ui/toggle-group.tsx"],"names":[],"mappings":";AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,IAAI,EAAkB,MAAM,oBAAoB,CAAA;AAGzD,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAA;AACjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAEzC,MAAM,kBAAkB,GAAG,KAAK,CAAC,aAAa,CAS5C;IACA,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,CAAC;IACV,WAAW,EAAE,YAAY;IACzB,QAAQ,EAAE,KAAK;IACf,KAAK,EAAE,EAAE;IACT,MAAM,EAAE,GAAG,EAAE,GAAE,CAAC;IAChB,IAAI,EAAE,QAAQ;CACf,CAAC,CAAA;AAEF;;;;;;;;;;;GAWG;AACH,SAAS,WAAW,CAAC,EACnB,SAAS,EACT,OAAO,EACP,IAAI,EACJ,OAAO,GAAG,CAAC,EACX,WAAW,GAAG,YAAY,EAC1B,IAAI,GAAG,QAAQ,EACf,QAAQ,GAAG,KAAK,EAChB,QAAQ,GAAG,KAAK,EAChB,KAAK,EAAE,SAAS,EAChB,YAAY,EACZ,aAAa,EACb,QAAQ,EACR,GAAG,KAAK,EAmBP;IACD,MAAM,cAAc,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC,SAA6B,EAAE,EAAE;QACzE,IAAI,SAAS,KAAK,SAAS;YAAE,OAAO,EAAE,CAAA;QACtC,OAAO,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IAC5E,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAW,GAAG,EAAE,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC,CAAA;IAC5F,MAAM,UAAU,GAAG,SAAS,KAAK,SAAS,CAAA;IAC1C,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAA;IAC/D,MAAM,UAAU,GAAG,QAAQ,IAAI,IAAI,KAAK,UAAU,CAAA;IAClD,MAAM,YAAY,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAA;IAEvD,MAAM,MAAM,GAAG,KAAK,CAAC,WAAW,CAC9B,CAAC,SAAiB,EAAE,EAAE;QACpB,IAAI,QAAQ;YAAE,OAAM;QAEpB,IAAI,IAAc,CAAA;QAClB,IAAI,UAAU,EAAE,CAAC;YACf,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC;gBAC9B,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC;gBACtC,CAAC,CAAC,CAAC,GAAG,KAAK,EAAE,SAAS,CAAC,CAAA;QAC3B,CAAC;aAAM,CAAC;YACN,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;QACrD,CAAC;QACD,IAAI,CAAC,UAAU;YAAE,WAAW,CAAC,IAAI,CAAC,CAAA;QAClC,aAAa,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;IACpD,CAAC,EACD,CAAC,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,QAAQ,CAAC,CACzD,CAAA;IAED,OAAO,CACL,KAAC,IAAI,iBACO,cAAc,kBACV,OAAO,eACV,IAAI,kBACD,OAAO,sBACH,WAAW,mBACd,QAAQ,mBACR,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,EACxC,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,EAAyB,EAC1D,SAAS,EAAE,EAAE,CACX,4FAA4F,EAC5F,IAAI,KAAK,IAAI,IAAI,sCAAsC,EACvD,WAAW,KAAK,UAAU,IAAI,wBAAwB,EACtD,SAAS,CACV,KACG,KAAK,YAET,KAAC,kBAAkB,CAAC,QAAQ,IAC1B,KAAK,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,YAE1F,QAAQ,GACmB,GACzB,CACR,CAAA;AACH,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAS,eAAe,CAAC,EACvB,SAAS,EACT,QAAQ,EACR,KAAK,EACL,OAAO,GAAG,SAAS,EACnB,IAAI,GAAG,SAAS,EAChB,QAAQ,GAAG,KAAK,EAChB,GAAG,KAAK,EAOP;IACD,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAA;IACpD,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;IAC7C,MAAM,UAAU,GAAG,OAAO,CAAC,QAAQ,IAAI,QAAQ,CAAA;IAC/C,MAAM,EAAE,OAAO,EAAE,GAAG,SAAS,EAAE,GAAG,KAAK,CAAA;IACvC,MAAM,eAAe,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,CAAA;IAClD,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,IAAI,IAAI,CAAA;IACzC,MAAM,WAAW,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,CAAC,CAAC,KAAK,CAAC,CAAA;IAChD,MAAM,YAAY,GAAG,OAAO,CAAC,WAAW,KAAK,UAAU,CAAA;IACvD,MAAM,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,GAAG,KAAK,CAAC,OAAO,CAC5D,GAAG,EAAE,CAAC,oBAAoB,CAAC,QAAQ,CAAC,EACpC,CAAC,QAAQ,CAAC,CACX,CAAA;IAED,OAAO,CACL,KAAC,IAAI,iBACO,mBAAmB,kBACf,OAAO,CAAC,OAAO,IAAI,OAAO,eAC7B,OAAO,CAAC,IAAI,IAAI,IAAI,kBACjB,OAAO,CAAC,OAAO,kBACf,OAAO,mBACN,UAAU,gBACb,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,mBACnB,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,EAC1C,SAAS,EAAE,EAAE,CACX,wCAAwC,EACxC,WAAW,IAAI,mBAAmB,EAClC,WAAW,IAAI,kBAAkB,IAAI,QAAQ,EAC7C,WAAW,IAAI,gBAAgB,IAAI,QAAQ,EAC3C,WAAW,IAAI,YAAY,IAAI,sCAAsC,EACrE,WAAW,IAAI,CAAC,YAAY,IAAI,sCAAsC,EACtE,WAAW;YACT,YAAY;YACZ,eAAe,KAAK,SAAS;YAC7B,2BAA2B,EAC7B,WAAW;YACT,CAAC,YAAY;YACb,eAAe,KAAK,SAAS;YAC7B,2BAA2B,EAC7B,cAAc,CAAC;YACb,OAAO,EAAE,eAAe;YACxB,IAAI,EAAE,YAAY;SACnB,CAAC,EACF,OAAO,IAAI,UAAU,EACrB,UAAU,IAAI,gCAAgC,EAC9C,SAAS,CACV,EACD,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YACjB,IAAI,UAAU;gBAAE,OAAM;YACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;YACrB,OAAO,EAAE,CAAC,KAAK,CAAC,CAAA;QAClB,CAAC,KACG,SAAS,YAEZ,QAAQ,GACJ,CACR,CAAA;AACH,CAAC;AAED,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,CAAA"}

package/dist/ui/toggle.d.ts

@@ -1,14 +1,42 @@
 import * as React from "react";
 import { type ViewProps } from "@tarojs/components";
 import { type VariantProps } from "class-variance-authority";
+/**
+ * @desc 生成切换按钮的样式类名；接受其声明的样式变体。
+ * @param {Parameters<typeof toggleVariants>[0]} props 样式变体以及附加的 class 或 className。
+ * @param {Parameters<typeof toggleVariants>[0]["variant"]} props.variant 外观，默认 default（透明背景），outline 增加描边；按下时另加选中背景。
+ * @param {Parameters<typeof toggleVariants>[0]["size"]} props.size 尺寸，默认 default（h-8/min-w-8），sm 为 h-7/min-w-7，lg 为 h-9/min-w-9。
+ * @return {string} 合并后的样式类名。
+ * @example
+ * ```tsx
+ * import { toggleVariants } from '@open-dy/vibecoding-sdk-taro/ui/toggle'
+ * toggleVariants()
+ * ```
+ */
 declare const toggleVariants: (props?: ({
     variant?: "default" | "outline" | null | undefined;
     size?: "default" | "sm" | "lg" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
+/**
+ * @desc 切换按钮组件。
+ * @param {Parameters<typeof Toggle>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @param {Parameters<typeof Toggle>[0]["variant"]} props.variant 外观，默认 default（透明背景），outline 增加描边；按下时另加选中背景。
+ * @param {Parameters<typeof Toggle>[0]["size"]} props.size 尺寸，默认 default（h-8/min-w-8），sm 为 h-7/min-w-7，lg 为 h-9/min-w-9。
+ * @return {ReturnType<typeof Toggle>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Toggle } from '@open-dy/vibecoding-sdk-taro/ui/toggle'
+ * <Toggle />
+ * ```
+ */
 declare function Toggle({ className, variant, size, pressed: pressedProp, defaultPressed, onPressedChange, disabled, children, ...props }: ViewProps & VariantProps<typeof toggleVariants> & {
+    /** @desc 受控按下状态；传入后以该值为准，需在 onPressedChange 中更新。省略时由内部状态管理。 */
     pressed?: boolean;
+    /** @desc 非受控模式的初始按下状态，默认 false；仅初始化时读取，传入 pressed 后不生效。 */
     defaultPressed?: boolean;
+    /** @desc 用户点击切换时调用，参数为下一按下状态；禁用时不触发，受控模式需同步 pressed。 */
     onPressedChange?: (pressed: boolean) => void;
+    /** @desc 是否禁止按下状态切换，默认 false；为 true 时不执行内部切换和点击回调。 */
     disabled?: boolean;
 }): React.JSX.Element;
 export { Toggle, toggleVariants };

package/dist/ui/toggle.js

@@ -4,6 +4,18 @@ import { View } from "@tarojs/components";
 import { cva } from "class-variance-authority";
 import { cn } from "../lib/utils.js";
 import { collectDataIconState } from "./helpers.js";
+/**
+ * @desc 生成切换按钮的样式类名；接受其声明的样式变体。
+ * @param {Parameters<typeof toggleVariants>[0]} props 样式变体以及附加的 class 或 className。
+ * @param {Parameters<typeof toggleVariants>[0]["variant"]} props.variant 外观，默认 default（透明背景），outline 增加描边；按下时另加选中背景。
+ * @param {Parameters<typeof toggleVariants>[0]["size"]} props.size 尺寸，默认 default（h-8/min-w-8），sm 为 h-7/min-w-7，lg 为 h-9/min-w-9。
+ * @return {string} 合并后的样式类名。
+ * @example
+ * ```tsx
+ * import { toggleVariants } from '@open-dy/vibecoding-sdk-taro/ui/toggle'
+ * toggleVariants()
+ * ```
+ */
 const toggleVariants = cva("group/toggle inline-flex items-center justify-center gap-1 rounded-lg text-sm font-medium whitespace-nowrap transition-all outline-none hover:bg-muted hover:text-foreground focus-visible:border-ring focus-visible:ring-[3px] focus-visible:ring-ring/50 disabled:pointer-events-none disabled:opacity-50 aria-invalid:border-destructive aria-invalid:ring-destructive/20 aria-pressed:bg-muted dark:aria-invalid:ring-destructive/40 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4", {
     variants: {
         variant: {
@@ -21,6 +33,18 @@ const toggleVariants = cva("group/toggle inline-flex items-center justify-center
         size: "default",
     },
 });
+/**
+ * @desc 切换按钮组件。
+ * @param {Parameters<typeof Toggle>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @param {Parameters<typeof Toggle>[0]["variant"]} props.variant 外观，默认 default（透明背景），outline 增加描边；按下时另加选中背景。
+ * @param {Parameters<typeof Toggle>[0]["size"]} props.size 尺寸，默认 default（h-8/min-w-8），sm 为 h-7/min-w-7，lg 为 h-9/min-w-9。
+ * @return {ReturnType<typeof Toggle>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Toggle } from '@open-dy/vibecoding-sdk-taro/ui/toggle'
+ * <Toggle />
+ * ```
+ */
 function Toggle({ className, variant = "default", size = "default", pressed: pressedProp, defaultPressed, onPressedChange, disabled = false, children, ...props }) {
     const [internalPressed, setInternalPressed] = React.useState(defaultPressed ?? false);
     const isControlled = pressedProp !== undefined;

package/dist/ui/toggle.js.map

@@ -1 +1 @@
-{"version":3,"file":"toggle.js","sourceRoot":"","sources":["../../src/ui/toggle.tsx"],"names":[],"mappings":";AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,IAAI,EAAkB,MAAM,oBAAoB,CAAA;AACzD,OAAO,EAAE,GAAG,EAAqB,MAAM,0BAA0B,CAAA;AAEjE,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAA;AACjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AAEhD,MAAM,cAAc,GAAG,GAAG,CACxB,4fAA4f,EAC5f;IACE,QAAQ,EAAE;QACR,OAAO,EAAE;YACP,OAAO,EAAE,gBAAgB;YACzB,OAAO,EAAE,mDAAmD;SAC7D;QACD,IAAI,EAAE;YACJ,OAAO,EAAE,oBAAoB;YAC7B,EAAE,EAAE,8GAA8G;YAClH,EAAE,EAAE,oBAAoB;SACzB;KACF;IACD,eAAe,EAAE;QACf,OAAO,EAAE,SAAS;QAClB,IAAI,EAAE,SAAS;KAChB;CACF,CACF,CAAA;AAED,SAAS,MAAM,CAAC,EACd,SAAS,EACT,OAAO,GAAG,SAAS,EACnB,IAAI,GAAG,SAAS,EAChB,OAAO,EAAE,WAAW,EACpB,cAAc,EACd,eAAe,EACf,QAAQ,GAAG,KAAK,EAChB,QAAQ,EACR,GAAG,KAAK,EAOP;IACD,MAAM,CAAC,eAAe,EAAE,kBAAkB,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,cAAc,IAAI,KAAK,CAAC,CAAA;IACrF,MAAM,YAAY,GAAG,WAAW,KAAK,SAAS,CAAA;IAC9C,MAAM,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,eAAe,CAAA;IAC5D,MAAM,EAAE,OAAO,EAAE,GAAG,SAAS,EAAE,GAAG,KAAK,CAAA;IACvC,MAAM,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,GAAG,KAAK,CAAC,OAAO,CAC5D,GAAG,EAAE,CAAC,oBAAoB,CAAC,QAAQ,CAAC,EACpC,CAAC,QAAQ,CAAC,CACX,CAAA;IAED,OAAO,CACL,KAAC,IAAI,iBACO,QAAQ,kBACJ,OAAO,mBACN,QAAQ,gBACX,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,mBACnB,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,EACxC,SAAS,EAAE,EAAE,CACX,cAAc,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EACjC,OAAO,IAAI,UAAU,EACrB,kBAAkB,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,EACzD,gBAAgB,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,EACvD,QAAQ,IAAI,gCAAgC,EAE5C,SAAS,CACV,EACD,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YACjB,IAAI,QAAQ;gBAAE,OAAM;YACpB,MAAM,IAAI,GAAG,CAAC,OAAO,CAAA;YACrB,IAAI,CAAC,YAAY;gBAAE,kBAAkB,CAAC,IAAI,CAAC,CAAA;YAC3C,eAAe,EAAE,CAAC,IAAI,CAAC,CAAA;YACvB,OAAO,EAAE,CAAC,KAAK,CAAC,CAAA;QAClB,CAAC,KACG,SAAS,YAEZ,QAAQ,GACJ,CACR,CAAA;AACH,CAAC;AAED,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,CAAA"}
+{"version":3,"file":"toggle.js","sourceRoot":"","sources":["../../src/ui/toggle.tsx"],"names":[],"mappings":";AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,IAAI,EAAkB,MAAM,oBAAoB,CAAA;AACzD,OAAO,EAAE,GAAG,EAAqB,MAAM,0BAA0B,CAAA;AAEjE,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAA;AACjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AAEhD;;;;;;;;;;;GAWG;AACH,MAAM,cAAc,GAAG,GAAG,CACxB,4fAA4f,EAC5f;IACE,QAAQ,EAAE;QACR,OAAO,EAAE;YACP,OAAO,EAAE,gBAAgB;YACzB,OAAO,EAAE,mDAAmD;SAC7D;QACD,IAAI,EAAE;YACJ,OAAO,EAAE,oBAAoB;YAC7B,EAAE,EAAE,8GAA8G;YAClH,EAAE,EAAE,oBAAoB;SACzB;KACF;IACD,eAAe,EAAE;QACf,OAAO,EAAE,SAAS;QAClB,IAAI,EAAE,SAAS;KAChB;CACF,CACF,CAAA;AAED;;;;;;;;;;;GAWG;AACH,SAAS,MAAM,CAAC,EACd,SAAS,EACT,OAAO,GAAG,SAAS,EACnB,IAAI,GAAG,SAAS,EAChB,OAAO,EAAE,WAAW,EACpB,cAAc,EACd,eAAe,EACf,QAAQ,GAAG,KAAK,EAChB,QAAQ,EACR,GAAG,KAAK,EAWP;IACD,MAAM,CAAC,eAAe,EAAE,kBAAkB,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,cAAc,IAAI,KAAK,CAAC,CAAA;IACrF,MAAM,YAAY,GAAG,WAAW,KAAK,SAAS,CAAA;IAC9C,MAAM,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,eAAe,CAAA;IAC5D,MAAM,EAAE,OAAO,EAAE,GAAG,SAAS,EAAE,GAAG,KAAK,CAAA;IACvC,MAAM,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,GAAG,KAAK,CAAC,OAAO,CAC5D,GAAG,EAAE,CAAC,oBAAoB,CAAC,QAAQ,CAAC,EACpC,CAAC,QAAQ,CAAC,CACX,CAAA;IAED,OAAO,CACL,KAAC,IAAI,iBACO,QAAQ,kBACJ,OAAO,mBACN,QAAQ,gBACX,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,mBACnB,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,EACxC,SAAS,EAAE,EAAE,CACX,cAAc,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EACjC,OAAO,IAAI,UAAU,EACrB,kBAAkB,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,EACzD,gBAAgB,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,EACvD,QAAQ,IAAI,gCAAgC,EAE5C,SAAS,CACV,EACD,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YACjB,IAAI,QAAQ;gBAAE,OAAM;YACpB,MAAM,IAAI,GAAG,CAAC,OAAO,CAAA;YACrB,IAAI,CAAC,YAAY;gBAAE,kBAAkB,CAAC,IAAI,CAAC,CAAA;YAC3C,eAAe,EAAE,CAAC,IAAI,CAAC,CAAA;YACvB,OAAO,EAAE,CAAC,KAAK,CAAC,CAAA;QAClB,CAAC,KACG,SAAS,YAEZ,QAAQ,GACJ,CACR,CAAA;AACH,CAAC;AAED,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,CAAA"}

package/package.json

@@ -1,10 +1,12 @@
 {
   "name": "@open-dy/vibecoding-sdk-taro",
-  "version": "0.0.1-beta.5",
+  "version": "0.0.1-beta.6",
   "description": "Runtime, UI, build and ESLint capabilities for Douyin Taro templates.",
   "type": "module",
   "files": [
-    "dist"
+    "dist",
+    "src",
+    "release-provenance.json"
   ],
   "exports": {
     ".": {

package/release-provenance.json

@@ -0,0 +1,15 @@
+{
+  "schema": 1,
+  "producer": "vibecoding-sdk-taro",
+  "packageName": "@open-dy/vibecoding-sdk-taro",
+  "version": "0.0.1-beta.6",
+  "source": {
+    "digest": "sha256-1df526c157223fdc703483001cab9ac5b3dc45a5b8182fa2fd4b4d0145f748f1",
+    "files": 135
+  },
+  "payload": "sha256-81190e53ee14521fee32cd83315a9109b52ec404c7c6a787e84f28f4ffb44f68",
+  "toolchain": {
+    "node": "v22.23.3",
+    "packageManager": null
+  }
+}

package/src/adapters/interest-card/eslint/eslint-plugin-custom-navigation.mjs

@@ -0,0 +1,2 @@
+// Both Taro templates use the shared navigation rules.
+export { default } from '../../../eslint/eslint-plugin-custom-navigation.mjs'

package/src/adapters/interest-card/eslint/taro.mjs

@@ -0,0 +1,21 @@
+import { createMicroappTaroEslintConfig } from '../../../eslint/taro.mjs'
+
+/**
+ * 兴趣卡 Taro 复用公共导航与页面校验，保留本地 UI 和历史图标导入兼容。
+ * 规则实现统一由公共配置维护，模板只保留 SDK 调用入口。
+ */
+export function createInterestCardTaroEslintConfig(options = {}) {
+  const additionalLucideSources = options.lucideImportSources === undefined
+    ? []
+    : Array.isArray(options.lucideImportSources)
+      ? options.lucideImportSources
+      : [options.lucideImportSources]
+
+  return createMicroappTaroEslintConfig({
+    ...options,
+    lucideImportSources: ['@open-dy/lucide-taro', 'lucide-taro', ...additionalLucideSources],
+    preferredUiImportBase: '@/components/ui',
+  })
+}
+
+export default createInterestCardTaroEslintConfig

package/src/adapters/interest-card/runtime/microapp.ts

@@ -0,0 +1,11 @@
+/**
+ * 兴趣卡落地页 Runtime 入口。
+ *
+ * 此适配层只提供稳定的兴趣卡导入路径；请求、登录和传输能力仍由通用
+ * microapp Runtime 实现，避免在业务域内复制基础逻辑。
+ */
+export {
+  clearDouyinLoginAuth,
+  createMicroappClient,
+  type CreateMicroappClientOptions,
+} from '../../../runtime/index.js'

package/src/adapters/interest-card/types/taro.d.ts

@@ -0,0 +1,28 @@
+/// <reference path="../../../runtime/globals.d.ts" />
+
+declare module '@tarojs/components' {
+  export * from '@tarojs/components/types/index'
+
+  import type { ComponentType } from 'react'
+  import type {
+    CommonEventFunction,
+    StandardProps,
+  } from '@tarojs/components/types/common'
+
+  export interface MiniappOpenCardProps extends StandardProps {
+    id?: string
+    appId: string
+    path: string
+    initData?: Record<string, unknown>
+    envVersion: 'current' | 'latest' | 'preview'
+    onLoad?: CommonEventFunction
+    onError?: CommonEventFunction<{
+      errMsg?: string
+      errNo?: number
+      errorCode?: number
+      errorType?: string
+    }>
+  }
+
+  export const MiniappOpenCard: ComponentType<MiniappOpenCardProps>
+}

package/src/build/config-overrides.ts

@@ -0,0 +1,39 @@
+import type { UserConfigExport } from '@tarojs/cli'
+import type { BuildContext, CreateMicroappTaroConfigOptions } from './taro'
+
+/**
+ * @desc 递归合并 Taro 配置，数组按顺序拼接。
+ * @params {any} base 基础配置。
+ * @params {any} override 覆盖配置。
+ * @return {any} 合并后的配置。
+ * @example mergeConfigValue({ plugins: ['a'] }, { plugins: ['b'] })
+ */
+export function mergeConfigValue(base: any, override: any): any {
+  if (Array.isArray(base) && Array.isArray(override)) return [...base, ...override]
+  if (base && override && typeof base === 'object' && typeof override === 'object') {
+    const result = { ...base }
+    for (const [key, value] of Object.entries(override)) {
+      result[key] = key in result ? mergeConfigValue(result[key], value) : value
+    }
+    return result
+  }
+  return override
+}
+
+/**
+ * @desc 将对象或函数形式的覆盖项应用到 Taro 配置。
+ * @params {UserConfigExport} config 当前配置。
+ * @params {CreateMicroappTaroConfigOptions['overrides']} overrides 覆盖项。
+ * @params {BuildContext} ctx 构建上下文。
+ * @return {UserConfigExport} 应用覆盖后的配置。
+ * @example applyConfigOverrides(config, { h5: { publicPath: '/' } }, ctx)
+ */
+export function applyConfigOverrides(
+  config: UserConfigExport,
+  overrides: CreateMicroappTaroConfigOptions['overrides'],
+  ctx: BuildContext,
+): UserConfigExport {
+  if (!overrides) return config
+  if (typeof overrides === 'function') return overrides(config, ctx) ?? config
+  return mergeConfigValue(config, overrides) as UserConfigExport
+}

package/src/build/index.ts

@@ -0,0 +1,5 @@
+export {
+  createMicroappTaroConfig,
+  type BuildContext,
+  type CreateMicroappTaroConfigOptions,
+} from './taro'

package/src/build/plugins/app-config.ts

@@ -0,0 +1,47 @@
+import path from 'path';
+
+type AppConfigPluginContext = {
+  modifyAppConfig: (
+    modifier: (payload: { appConfig: Record<string, any> }) => Record<string, any>,
+  ) => void;
+}
+
+const withPreviewBasePath = (iconPath: string, previewBasePath: string) => {
+  if (!previewBasePath) {
+    return iconPath
+  }
+  const previewPath = path.join(previewBasePath, iconPath)
+  if (previewPath.startsWith('./')) {
+    return previewPath
+  }
+
+  if (previewPath.startsWith('/')) {
+    return `.${previewPath}`
+  }
+
+  return `./${previewPath}`
+}
+
+export default function appConfigPlugin(
+  ctx: AppConfigPluginContext,
+  options: { previewBasePath?: string } = {},
+) {
+  const previewBasePath = options.previewBasePath ?? ''
+  ctx.modifyAppConfig(({ appConfig }) => {
+    if (!(process.env.TARO_ENV === 'h5' && process.env.NODE_ENV === 'development')) {
+      return appConfig
+    }
+    if (Array.isArray(appConfig.tabBar?.list) && appConfig.tabBar.list.length > 0) {
+      const list = appConfig.tabBar.list;
+      list.forEach(item => {
+        if (item.iconPath) {
+          item.iconPath = withPreviewBasePath(item.iconPath, previewBasePath)
+        }
+        if (item.selectedIconPath) {
+          item.selectedIconPath = withPreviewBasePath(item.selectedIconPath, previewBasePath)
+        }
+      })
+    }
+    return appConfig
+  });
+}

package/src/build/plugins/depend-card/analyze.ts

@@ -0,0 +1,122 @@
+import { parse } from '@babel/parser'
+import traverseModule from '@babel/traverse'
+
+const traverse = (traverseModule as unknown as { default?: typeof traverseModule }).default ?? traverseModule
+const cardComponentModules = new Set([
+  '@tarojs/components',
+  '@open-dy/vibecoding-sdk-taro/components/miniapp-open-card',
+])
+
+/** @description 卡片原生标签，或尚待解析的模块导出引用。 */
+export type CardReference = true | { source: string; name: string }
+/** @description 单个源文件的紧凑分析结果；不保留 AST 和 Babel 作用域。 */
+export interface CardModule {
+  uses: CardReference[]
+  exports: Map<string, CardReference | undefined>
+  stars: string[]
+}
+
+/**
+ * @desc 判断引用是否直接来自已支持的卡片组件入口。
+ * @params {CardReference} reference 组件引用。
+ * @return {boolean} 是否直接指向卡片。
+ * @example isDirectCard({ source: '@tarojs/components', name: 'MiniappOpenCard' })
+ */
+export function isDirectCard(reference: CardReference) {
+  return reference === true ||
+    (cardComponentModules.has(reference.source) && reference.name === 'MiniappOpenCard')
+}
+
+/**
+ * @desc 一次解析并收集 JSX、React.createElement 和运行时导出之间的引用。
+ *   忽略类型导出及被遮蔽或重新赋值的局部别名；语法错误向调用方抛出。
+ * @params {string} source 源码内容。
+ * @params {string} filename 用于选择 TypeScript 和 JSX 语法的文件名。
+ * @return {CardModule} 使用点和导出关系，不递归读取其他文件。
+ * @example analyzeCardModule('export const Page = () => <miniapp-open-card />', 'page.tsx')
+ */
+export function analyzeCardModule(source: string, filename: string): CardModule {
+  const ast = parse(source, {
+    sourceType: 'unambiguous',
+    plugins: [...(/\.[cm]?ts$/.test(filename) ? [] : ['jsx' as const]),
+      ...(/\.[cm]?tsx?$/.test(filename) ? ['typescript' as const] : []), 'decorators-legacy'],
+  })
+  const result: CardModule = { uses: [], exports: new Map(), stars: [] }
+
+  /** @description 按词法绑定追踪导入及不可变别名，避免将同名业务组件识别为卡片。 */
+  function reference(node, scope, seen = new Set(), allowUnbound = false): CardReference | undefined {
+    if (!node) return
+    if (node.type === 'StringLiteral') return node.value === 'miniapp-open-card' ? true : undefined
+    if (node.type === 'JSXMemberExpression' || node.type === 'MemberExpression') {
+      const binding = scope.getBinding(node.object.name)
+      const name = node.computed ? node.property.value : node.property.name
+      if (typeof name === 'string' && binding?.path.isImportNamespaceSpecifier() &&
+          binding.path.parent.importKind !== 'type') {
+        return { source: binding.path.parent.source.value, name }
+      }
+      return
+    }
+    if (!['Identifier', 'JSXIdentifier'].includes(node.type)) return
+    if (node.name === 'miniapp-open-card') return true
+    const binding = scope.getBinding(node.name)
+    if (!binding) return allowUnbound && node.name === 'MiniappOpenCard' ? true : undefined
+    if (seen.has(binding)) return
+    seen.add(binding)
+    if (binding.path.isImportSpecifier() || binding.path.isImportDefaultSpecifier()) {
+      if (binding.path.parent.importKind !== 'type' && binding.path.node.importKind !== 'type') {
+        return {
+          source: binding.path.parent.source.value,
+          name: binding.path.isImportDefaultSpecifier() ? 'default' :
+            (binding.path.node.imported.name ?? binding.path.node.imported.value),
+        }
+      }
+    } else if (binding.path.isVariableDeclarator() && binding.constant) {
+      return reference(binding.path.node.init, binding.path.scope, seen, allowUnbound)
+    }
+  }
+
+  /** @description 记录真实渲染点；仅导入或转导出不会被视为使用。 */
+  function use(node, scope) {
+    const target = reference(node, scope, new Set(), true)
+    if (target) result.uses.push(target)
+  }
+
+  traverse(ast, {
+    JSXOpeningElement(p) { use(p.node.name, p.scope) },
+    CallExpression(p) {
+      const callee = p.node.callee
+      const binding = callee.type === 'Identifier' ? p.scope.getBinding(callee.name) : null
+      const importedCreateElement = binding?.path.isImportSpecifier() &&
+        binding.path.parent.source.value === 'react' &&
+        binding.path.node.imported.name === 'createElement'
+      const reactBinding = callee.type === 'MemberExpression' ? p.scope.getBinding(callee.object.name) : null
+      const reactCreateElement = callee.type === 'MemberExpression' &&
+        callee.property.name === 'createElement' &&
+        ((reactBinding?.path.isImportDefaultSpecifier() || reactBinding?.path.isImportNamespaceSpecifier()) &&
+          reactBinding.path.parent.source.value === 'react')
+      if (importedCreateElement || reactCreateElement) use(p.node.arguments[0], p.scope)
+    },
+    ExportNamedDeclaration(p) {
+      if (p.node.exportKind === 'type') return
+      for (const specifier of p.node.specifiers) {
+        if (specifier.type !== 'ExportSpecifier' || specifier.exportKind === 'type') continue
+        const exported = specifier.exported.name ?? specifier.exported.value
+        result.exports.set(exported, p.node.source
+          ? { source: p.node.source.value, name: specifier.local.name }
+          : reference(specifier.local, p.scope))
+      }
+      if (p.node.declaration) {
+        for (const [name, identifier] of Object.entries(p.getBindingIdentifiers())) {
+          result.exports.set(name, reference(identifier, p.scope))
+        }
+      }
+    },
+    ExportDefaultDeclaration(p) {
+      result.exports.set('default', reference(p.node.declaration, p.scope))
+    },
+    ExportAllDeclaration(p) {
+      if (p.node.exportKind !== 'type') result.stars.push(p.node.source.value)
+    },
+  })
+  return result
+}

package/src/build/plugins/depend-card/source.ts

@@ -0,0 +1,97 @@
+import fs from 'node:fs'
+import path from 'node:path'
+import { analyzeCardModule, isDirectCard } from './analyze'
+import type { CardModule, CardReference } from './analyze'
+
+const extensions = ['.ts', '.tsx', '.js', '.jsx', '.mts', '.cts', '.mjs', '.cjs']
+
+/**
+ * @desc 创建仅扫描 sourceDir 的检测器，按源码内容缓存解析结果，不访问依赖目录。
+ *   每次扫描重新计算导出关系，使转导出修改、新增和删除立即生效；循环引用不会无限递归。
+ * @return {Function} 返回卡片依赖标记和文件、目录监听列表的扫描函数。
+ * @example const scan = createCardSourceScanner(); scan('/workspace/project/src')
+ */
+export function createCardSourceScanner() {
+  const cache = new Map<string, { source: string; module: CardModule }>()
+  return (sourceDir: string) => {
+    const files: string[] = []
+    const directories: string[] = []
+    const modules = new Map<string, CardModule>()
+
+    /** @description 仅遍历真实业务源码；符号链接、测试、配置及声明文件不进入解析范围。 */
+    function visit(directory: string) {
+      if (!fs.existsSync(directory)) return
+      directories.push(directory)
+      for (const entry of fs.readdirSync(directory, { withFileTypes: true })) {
+        const file = path.join(directory, entry.name)
+        if (entry.isDirectory()) {
+          if (!['node_modules', '__tests__', '__mocks__'].includes(entry.name)) visit(file)
+        } else if (entry.isFile() && /\.[cm]?[jt]sx?$/.test(entry.name) &&
+            !/\.(?:d|test|spec|config)\.[cm]?[jt]sx?$/.test(entry.name)) {
+          files.push(file)
+          try {
+            const source = fs.readFileSync(file, 'utf8')
+            let cached = cache.get(file)
+            if (!cached || cached.source !== source) {
+              cached = { source, module: analyzeCardModule(source, file) }
+              cache.set(file, cached)
+            }
+            modules.set(file, cached.module)
+          } catch (error: any) {
+            throw new Error(`Cannot determine isDependCard from ${file}: ${error.message}`)
+          }
+        }
+      }
+    }
+    visit(path.resolve(sourceDir))
+    for (const file of cache.keys()) if (!modules.has(file)) cache.delete(file)
+
+    /** @description 从已扫描文件表解析相对导入；不读取 src 之外的文件，也不解析 npm 包。 */
+    function resolveLocal(importer: string, source: string) {
+      if (!source.startsWith('./') && !source.startsWith('../')) return
+      const target = path.resolve(path.dirname(importer), source)
+      const candidates = [target]
+      if (/\.[cm]?jsx?$/.test(target)) {
+        candidates.push(target.replace(/\.js$/, '.ts'), target.replace(/\.jsx?$/, '.tsx'),
+          target.replace(/\.mjs$/, '.mts'), target.replace(/\.cjs$/, '.cts'))
+      }
+      candidates.push(...extensions.map(ext => target + ext),
+        ...extensions.map(ext => path.join(target, 'index' + ext)))
+      return candidates.find(candidate => modules.has(candidate))
+    }
+
+    const resolved = new Map<string, boolean>()
+    /** @description 迭代追踪命名、默认及星号转导出，按文件和导出名去重并缓存查询结果。 */
+    function isCard(importer: string, reference: CardReference) {
+      if (isDirectCard(reference)) return true
+      if (reference === true) return true
+      const root = resolveLocal(importer, reference.source)
+      if (!root) return false
+      const key = `${root}\0${reference.name}`
+      if (resolved.has(key)) return resolved.get(key)!
+      const queue = [{ file: root, name: reference.name }]
+      const seen = new Set<string>()
+      let found = false
+      for (let index = 0; index < queue.length && !found; index++) {
+        const { file, name } = queue[index]
+        const itemKey = `${file}\0${name}`
+        if (seen.has(itemKey)) continue
+        seen.add(itemKey)
+        const module = modules.get(file)!
+        const target = module.exports.get(name)
+        const next = module.exports.has(name) ? (target ? [target] : []) :
+          (name === 'default' ? [] : module.stars.map(source => ({ source, name })))
+        for (const ref of next) {
+          if (isDirectCard(ref)) { found = true; break }
+          if (ref === true) continue
+          const dependency = resolveLocal(file, ref.source)
+          if (dependency) queue.push({ file: dependency, name: ref.name })
+        }
+      }
+      resolved.set(key, found)
+      return found
+    }
+    const depends = files.some(file => modules.get(file)!.uses.some(ref => isCard(file, ref)))
+    return { depends, files, directories }
+  }
+}