@open-dy/vibecoding-sdk-taro 0.0.1-beta.1

package/dist/build/plugins/vite-taro-source-location.js

@@ -0,0 +1,159 @@
+import generateModule from '@babel/generator';
+import { parse } from '@babel/parser';
+import traverseModule from '@babel/traverse';
+import * as t from '@babel/types';
+import { Buffer } from 'node:buffer';
+import path from 'node:path';
+const TARO_COMPONENTS_MODULE = '@tarojs/components';
+const SOURCE_CLASS_PREFIX = '__ai_src_';
+const generate = generateModule.default ?? generateModule;
+const traverse = traverseModule.default ?? traverseModule;
+const normalizePath = (value) => value.split(path.sep).join('/');
+const encodeSourceClass = (sourceFile, line, column) => `${SOURCE_CLASS_PREFIX}${Buffer.from(JSON.stringify([sourceFile, line, column]), 'utf8').toString('base64url')}`;
+const createClassHelpers = (mergeHelperName, spreadHelperName, includeSpreadHelper) => parse(`
+function ${mergeHelperName}(value, sourceClass) {
+  return value == null || value === false || value === ''
+    ? sourceClass
+    : String(value) + ' ' + sourceClass;
+}
+${includeSpreadHelper ? `
+function ${spreadHelperName}(value, sourceClass) {
+  if (
+    value == null ||
+    !Object.prototype.hasOwnProperty.call(Object(value), 'className')
+  ) {
+    return value;
+  }
+  const props = { ...value };
+  props.className = ${mergeHelperName}(props.className, sourceClass);
+  return props;
+}
+` : ''}
+`, { sourceType: 'module' }).program.body;
+const getAttributeName = (attribute) => t.isJSXAttribute(attribute) && t.isJSXIdentifier(attribute.name)
+    ? attribute.name.name
+    : '';
+const isInsideDirectory = (directory, filename) => {
+    const relative = path.relative(directory, filename);
+    return Boolean(relative) && !relative.startsWith('..') && !path.isAbsolute(relative);
+};
+export function viteTaroSourceLocationPlugin(options) {
+    const projectRoot = path.resolve(options.projectRoot);
+    const sourceRoot = path.join(projectRoot, 'src');
+    return {
+        name: 'taro-source-location',
+        enforce: 'pre',
+        transform(code, id) {
+            const filename = id.split('?')[0].split('#')[0];
+            if (!options.enabled ||
+                !/\.[jt]sx$/.test(filename) ||
+                !isInsideDirectory(sourceRoot, filename)) {
+                return null;
+            }
+            const ast = parse(code, {
+                sourceType: 'module',
+                sourceFilename: filename,
+                plugins: ['jsx', 'typescript', 'decorators-legacy', 'classProperties'],
+            });
+            const namedImports = new Set();
+            const namespaceImports = new Set();
+            let changed = false;
+            let needsMergeHelper = false;
+            let needsSpreadHelper = false;
+            let mergeHelperName = '';
+            let spreadHelperName = '';
+            for (const statement of ast.program.body) {
+                if (!t.isImportDeclaration(statement) ||
+                    statement.source.value !== TARO_COMPONENTS_MODULE) {
+                    continue;
+                }
+                for (const specifier of statement.specifiers) {
+                    if (t.isImportSpecifier(specifier)) {
+                        namedImports.add(specifier.local.name);
+                    }
+                    else if (t.isImportNamespaceSpecifier(specifier)) {
+                        namespaceImports.add(specifier.local.name);
+                    }
+                }
+            }
+            traverse(ast, {
+                Program(programPath) {
+                    mergeHelperName = programPath.scope.generateUidIdentifier('aiSourceClass').name;
+                    spreadHelperName = programPath.scope.generateUidIdentifier('aiSourceProps').name;
+                },
+                JSXOpeningElement(openingPath) {
+                    const name = openingPath.node.name;
+                    const isNamedComponent = t.isJSXIdentifier(name) && namedImports.has(name.name);
+                    const isNamespaceComponent = t.isJSXMemberExpression(name) &&
+                        t.isJSXIdentifier(name.object) &&
+                        namespaceImports.has(name.object.name);
+                    if (!isNamedComponent && !isNamespaceComponent) {
+                        return;
+                    }
+                    const location = openingPath.node.loc?.start;
+                    if (!location) {
+                        return;
+                    }
+                    const sourceClass = encodeSourceClass(normalizePath(path.relative(projectRoot, filename)), location.line, location.column + 1);
+                    let hasExplicitClassName = false;
+                    for (const attribute of openingPath.node.attributes) {
+                        if (t.isJSXSpreadAttribute(attribute)) {
+                            attribute.argument = t.callExpression(t.identifier(spreadHelperName), [
+                                attribute.argument,
+                                t.stringLiteral(sourceClass),
+                            ]);
+                            needsMergeHelper = true;
+                            needsSpreadHelper = true;
+                            continue;
+                        }
+                        if (getAttributeName(attribute) !== 'className') {
+                            continue;
+                        }
+                        hasExplicitClassName = true;
+                        if (t.isStringLiteral(attribute.value)) {
+                            attribute.value = t.stringLiteral(attribute.value.value
+                                ? `${attribute.value.value} ${sourceClass}`
+                                : sourceClass);
+                            continue;
+                        }
+                        const classExpression = t.isJSXExpressionContainer(attribute.value)
+                            ? attribute.value.expression
+                            : attribute.value;
+                        if (!classExpression || t.isJSXEmptyExpression(classExpression)) {
+                            attribute.value = t.stringLiteral(sourceClass);
+                            continue;
+                        }
+                        attribute.value = t.jsxExpressionContainer(t.callExpression(t.identifier(mergeHelperName), [
+                            classExpression,
+                            t.stringLiteral(sourceClass),
+                        ]));
+                        needsMergeHelper = true;
+                    }
+                    if (!hasExplicitClassName) {
+                        openingPath.node.attributes.unshift(t.jsxAttribute(t.jsxIdentifier('className'), t.stringLiteral(sourceClass)));
+                    }
+                    changed = true;
+                },
+            });
+            if (!changed) {
+                return null;
+            }
+            if (needsMergeHelper) {
+                const helpers = createClassHelpers(mergeHelperName, spreadHelperName, needsSpreadHelper);
+                let insertionIndex = 0;
+                for (let index = 0; index < ast.program.body.length; index += 1) {
+                    if (t.isImportDeclaration(ast.program.body[index])) {
+                        insertionIndex = index + 1;
+                    }
+                }
+                ast.program.body.splice(insertionIndex, 0, ...helpers);
+            }
+            const output = generate(ast, {
+                sourceMaps: true,
+                sourceFileName: normalizePath(path.relative(projectRoot, filename)),
+            }, code);
+            return { code: output.code, map: output.map };
+        },
+    };
+}
+//# sourceMappingURL=vite-taro-source-location.js.map

package/dist/build/plugins/vite-taro-source-location.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite-taro-source-location.js","sourceRoot":"","sources":["../../../src/build/plugins/vite-taro-source-location.ts"],"names":[],"mappings":"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"}

package/dist/build/taro.d.ts

@@ -0,0 +1,53 @@
+import type { UserConfigExport } from "@tarojs/cli";
+/**
+ * @desc Taro 构建阶段共享的编译上下文。
+ * @example const context: BuildContext = { isH5: true, isTt: false, mode: 'development', projectRoot }
+ * @ai-intent 描述 SDK 构建插件收到的 Taro 编译上下文。
+ * @ai-when 需要根据 H5、TT 或开发模式调整构建配置时。
+ * @ai-avoid 不要在业务页面中手动伪造该上下文或修改构建产物。
+ * @ai-example { isH5: true, isTt: false, mode: 'development', projectRoot }
+ */
+export interface BuildContext {
+    /** @desc 是否构建 H5 输出。 */
+    isH5: boolean;
+    /** @desc 是否构建 TT 小程序输出。 */
+    isTt: boolean;
+    /** @desc 当前 Taro 构建模式。 */
+    mode: string;
+    /** @desc 工程根目录。 */
+    projectRoot: string;
+}
+/**
+ * @desc 创建普通小程序 Taro 配置的选项。
+ * @params {string} projectRoot 工程根目录。
+ * @params {'' | 'ext'} [platformChannel] 平台渠道。
+ * @params {string[]} [viteErrorTargets] Vite 错误上报目标。
+ * @params {Record<string, any> | Function} [overrides] 配置覆盖项。
+ * @example createMicroappTaroConfig({ projectRoot: process.cwd() })
+ * @ai-intent 配置普通小程序的 Taro/Vite 构建入口。
+ * @ai-when 需要从项目构建脚本创建普通小程序配置时。
+ * @ai-avoid 不要在业务代码中直接调用 Taro/Vite 内部构建 API。
+ * @ai-example createMicroappTaroConfig({ projectRoot: process.cwd() })
+ */
+export interface CreateMicroappTaroConfigOptions {
+    /** @desc 工程根目录。 */
+    projectRoot: string;
+    /** @desc 平台渠道。 */
+    platformChannel?: '' | 'ext';
+    /** @desc Vite 错误上报目标列表。 */
+    viteErrorTargets?: string[];
+    /** @desc 配置对象或配置变换函数。 */
+    overrides?: Record<string, any> | ((config: UserConfigExport, ctx: BuildContext) => UserConfigExport | void);
+}
+export { applyConfigOverrides, mergeConfigValue } from './config-overrides.js';
+/**
+ * @desc 创建普通小程序的 Taro/Vite 构建配置。
+ * @params {CreateMicroappTaroConfigOptions} options 构建配置选项。
+ * @return {UserConfigExport} Taro 配置工厂函数。
+ * @example createMicroappTaroConfig({ projectRoot: process.cwd() })
+ * @ai-intent 创建普通小程序的 Taro/Vite 构建配置。
+ * @ai-when 构建脚本需要加载普通小程序的 SDK 配置时。
+ * @ai-avoid 不要在业务页面调用该构建工厂，也不要绕过 SDK 修改代理配置。
+ * @ai-example createMicroappTaroConfig({ projectRoot: process.cwd() })
+ */
+export declare function createMicroappTaroConfig(options: CreateMicroappTaroConfigOptions): UserConfigExport;