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

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

@@ -0,0 +1,290 @@
+/**
+ * 强制兴趣卡落地页使用自定义导航栏：app config 必须声明 navigationStyle: 'custom'，
+ * page config 若声明 navigationStyle 也只能是 custom，每个页面必须显式声明导航前景色，
+ * 且每个页面入口必须接入顶部避让。
+ */
+import { createRequire } from 'node:module';
+
+const ts = createRequire(import.meta.url)('typescript');
+
+const CUSTOM = 'custom';
+const NAVIGATION_TEXT_STYLES = new Set(['black', 'white']);
+
+const CUSTOM_NAV_IMPORTS = new Set([
+  '@/components/custom-nav-space',
+  '@/hooks/use-custom-nav-layout',
+  '@/lib/custom-nav-layout',
+]);
+
+const FORBIDDEN_NAVIGATION_APIS = new Map([
+  ['setNavigationBarTitle', '禁止修改导航栏标题'],
+  ['setNavigationBarColor', '禁止修改导航栏颜色、前景色或状态栏样式'],
+  ['showNavigationBarLoading', '禁止显示导航栏 loading'],
+  ['hideNavigationBarLoading', '禁止隐藏导航栏 loading'],
+  ['hideHomeButton', '禁止隐藏左上角首页或 logo 按钮'],
+]);
+
+function getPropertyName(prop) {
+  if (!ts.isPropertyAssignment(prop)) return null;
+  if (ts.isIdentifier(prop.name)) return prop.name.text;
+  if (ts.isStringLiteral(prop.name)) return prop.name.text;
+  return null;
+}
+
+function getStringLiteral(node) {
+  if (ts.isStringLiteral(node) || ts.isNoSubstitutionTemplateLiteral(node)) {
+    return node.text;
+  }
+  return null;
+}
+
+function getStaticPropertyName(node) {
+  if (!node.computed && node.property.type === 'Identifier') {
+    return node.property.name;
+  }
+  if (
+    node.computed &&
+    node.property.type === 'Literal' &&
+    typeof node.property.value === 'string'
+  ) {
+    return node.property.value;
+  }
+  return null;
+}
+
+function getPropertyKeyName(node) {
+  if (!node.computed && node.key.type === 'Identifier') {
+    return node.key.name;
+  }
+  if (node.key.type === 'Literal' && typeof node.key.value === 'string') {
+    return node.key.value;
+  }
+  return null;
+}
+
+/**
+ * @returns {{ windowStyle: string | null, pageStyle: string | null, windowTextStyle: string | null, pageTextStyle: string | null, invalid: Array<{ kind: string, value: string | null }> } | null}
+ */
+function extractNavigationStyles(filePath, text) {
+  const sf = ts.createSourceFile(filePath, text, ts.ScriptTarget.Latest, true, ts.ScriptKind.TS);
+  let result = null;
+
+  function fromObjectLiteral(obj) {
+    const out = {
+      windowStyle: null,
+      pageStyle: null,
+      windowTextStyle: null,
+      pageTextStyle: null,
+      invalid: [],
+    };
+
+    for (const prop of obj.properties) {
+      if (!ts.isPropertyAssignment(prop)) continue;
+      const key = getPropertyName(prop);
+
+      if (key === 'navigationStyle') {
+        const value = getStringLiteral(prop.initializer);
+        out.pageStyle = value;
+        if (value !== CUSTOM) {
+          out.invalid.push({ kind: 'page', value });
+        }
+      }
+
+      if (key === 'navigationBarTextStyle') {
+        out.pageTextStyle = getStringLiteral(prop.initializer);
+      }
+
+      if (key === 'window' && ts.isObjectLiteralExpression(prop.initializer)) {
+        for (const windowProp of prop.initializer.properties) {
+          if (!ts.isPropertyAssignment(windowProp)) continue;
+          const windowKey = getPropertyName(windowProp);
+          if (windowKey === 'navigationStyle') {
+            const value = getStringLiteral(windowProp.initializer);
+            out.windowStyle = value;
+            if (value !== CUSTOM) {
+              out.invalid.push({ kind: 'window', value });
+            }
+          }
+          if (windowKey === 'navigationBarTextStyle') {
+            out.windowTextStyle = getStringLiteral(windowProp.initializer);
+          }
+        }
+      }
+    }
+
+    return out;
+  }
+
+  function visit(node) {
+    if (result) return;
+    if (ts.isExportAssignment(node) && !node.isExportEquals && node.expression) {
+      const expr = node.expression;
+      if (
+        ts.isCallExpression(expr) &&
+        expr.arguments[0] &&
+        ts.isObjectLiteralExpression(expr.arguments[0])
+      ) {
+        result = fromObjectLiteral(expr.arguments[0]);
+      } else if (ts.isObjectLiteralExpression(expr)) {
+        result = fromObjectLiteral(expr);
+      }
+    }
+    ts.forEachChild(node, visit);
+  }
+
+  visit(sf);
+  return result;
+}
+
+const CONFIG_MESSAGE =
+  '兴趣卡落地页必须使用自定义导航栏：navigationStyle 只能是 "custom"，禁止改成 default 或其他值。' +
+  '页面顶部请用 <CustomNavSpace /> 或 useCustomNavLayout() 避让状态栏与胶囊。';
+
+const TEXT_STYLE_MESSAGE =
+  '请根据该页面首次进入时顶部区域的实际明暗，显式设置 navigationBarTextStyle：' +
+  '浅色顶部使用 "black"，深色顶部使用 "white"。';
+
+/** @type {import('eslint').Rule.RuleModule} */
+const requireCustomNavigationStyle = {
+  meta: {
+    type: 'problem',
+    docs: {
+      description: '强制自定义导航，并要求 app fallback 与每个页面显式声明导航前景色',
+    },
+    schema: [],
+  },
+  create(context) {
+    const filePath = context.filename.replace(/\\/g, '/');
+    const isApp = filePath.endsWith('/src/app.config.ts') || filePath.endsWith('src/app.config.ts');
+    const isPageConfig = /\/src\/pages\/.+\.config\.ts$/.test(filePath);
+    if (!isApp && !isPageConfig) return {};
+
+    return {
+      Program(node) {
+        const sourceText = context.sourceCode.getText(node);
+        const parsed = extractNavigationStyles(filePath, sourceText);
+
+        if (!parsed) {
+          context.report({
+            node,
+            message: `无法解析 ${isApp ? 'defineAppConfig' : 'definePageConfig'}，请使用对象字面量声明。${CONFIG_MESSAGE}`,
+          });
+          return;
+        }
+
+        if (isApp && parsed.windowStyle !== CUSTOM) {
+          context.report({
+            node,
+            message:
+              `src/app.config.ts 的 window.navigationStyle 必须为 "custom"（当前：${parsed.windowStyle ?? '未设置'}）。${CONFIG_MESSAGE}`,
+          });
+        }
+
+        const textStyle = isApp ? parsed.windowTextStyle : parsed.pageTextStyle;
+        if (!NAVIGATION_TEXT_STYLES.has(textStyle)) {
+          context.report({
+            node,
+            message:
+              `${isApp ? 'src/app.config.ts 的 window' : '页面配置'}.navigationBarTextStyle ` +
+              `必须为 "black" 或 "white"（当前：${textStyle ?? '未设置'}）。${TEXT_STYLE_MESSAGE}`,
+          });
+        }
+
+        for (const item of parsed.invalid) {
+          if (isApp && item.kind === 'window') continue;
+          context.report({
+            node,
+            message:
+              `禁止将 ${item.kind === 'window' ? 'window.' : ''}navigationStyle 设为 ${JSON.stringify(item.value)}。${CONFIG_MESSAGE}`,
+          });
+        }
+      },
+    };
+  },
+};
+
+/** @type {import('eslint').Rule.RuleModule} */
+const pagesMustUseCustomNavSpace = {
+  meta: {
+    type: 'problem',
+    docs: {
+      description: '页面入口必须使用 CustomNavSpace 或 useCustomNavLayout 避让自定义导航栏区域',
+    },
+    schema: [],
+  },
+  create(context) {
+    const filePath = context.filename.replace(/\\/g, '/');
+    if (!/\/src\/pages\/.+\/index\.[jt]sx$/.test(filePath)) return {};
+
+    let used = false;
+
+    return {
+      ImportDeclaration(node) {
+        if (typeof node.source.value === 'string' && CUSTOM_NAV_IMPORTS.has(node.source.value)) {
+          used = true;
+        }
+      },
+      'Program:exit'(node) {
+        if (used) return;
+        context.report({
+          node,
+          message:
+            '兴趣卡落地页必须 import <CustomNavSpace /> 或 useCustomNavLayout() 做顶部避让，' +
+            '禁止改回原生导航，也禁止只用固定 pt-* / safe-area 代替。',
+        });
+      },
+    };
+  },
+};
+
+/** @type {import('eslint').Rule.RuleModule} */
+const noNavigationControlApis = {
+  meta: {
+    type: 'problem',
+    docs: {
+      description: '禁止兴趣卡落地页调用会修改宿主导航栏或左上角按钮的 API',
+    },
+    schema: [],
+  },
+  create(context) {
+    function report(node, apiName) {
+      const reason = FORBIDDEN_NAVIGATION_APIS.get(apiName);
+      if (!reason) return;
+
+      context.report({
+        node,
+        message:
+          `兴趣卡落地页禁止使用 ${apiName}：${reason}。` +
+          '导航栏和左上角按钮由宿主及自定义导航模板统一管理。',
+      });
+    }
+
+    return {
+      MemberExpression(node) {
+        report(node.property, getStaticPropertyName(node));
+      },
+      ImportSpecifier(node) {
+        const importedName = node.imported.type === 'Identifier'
+          ? node.imported.name
+          : node.imported.value;
+        report(node.imported, importedName);
+      },
+      Property(node) {
+        if (node.parent.type !== 'ObjectPattern') return;
+        report(node.key, getPropertyKeyName(node));
+      },
+      CallExpression(node) {
+        if (node.callee.type !== 'Identifier') return;
+        report(node.callee, node.callee.name);
+      },
+    };
+  },
+};
+
+export default {
+  rules: {
+    'require-custom-navigation-style': requireCustomNavigationStyle,
+    'pages-must-use-custom-nav-space': pagesMustUseCustomNavSpace,
+    'no-navigation-control-apis': noNavigationControlApis,
+  },
+};

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

@@ -0,0 +1,55 @@
+import { createMicroappTaroEslintConfig } from '../../../eslint/taro.mjs'
+import customNavigation from './eslint-plugin-custom-navigation.mjs'
+
+const interestCardRules = [
+  {
+    files: ['src/**/*.{js,jsx,ts,tsx}'],
+    plugins: { customNavigation },
+    rules: {
+      'customNavigation/no-navigation-control-apis': 'error',
+    },
+  },
+  {
+    files: ['src/**/*.{js,jsx,ts,tsx}'],
+    ignores: ['src/network.ts'],
+    plugins: { customNavigation },
+    rules: {
+      'customNavigation/require-custom-navigation-style': 'error',
+      'customNavigation/pages-must-use-custom-nav-space': 'error',
+    },
+  },
+]
+
+/**
+ * 兴趣卡 Taro 的通用校验加上业务域导航约束。
+ *
+ * 公共规则仍由 `createMicroappTaroEslintConfig` 维护；这里只声明兴趣卡
+ * 独有的导航能力及其旧图标包来源，避免模板复制整份 ESLint 配置。
+ */
+export function createInterestCardTaroEslintConfig(options = {}) {
+  const { overrides, ...baseOptions } = options
+  const additionalLucideSources = baseOptions.lucideImportSources === undefined
+    ? []
+    : Array.isArray(baseOptions.lucideImportSources)
+      ? baseOptions.lucideImportSources
+      : [baseOptions.lucideImportSources]
+
+  return createMicroappTaroEslintConfig({
+    ...baseOptions,
+    lucideImportSources: ['lucide-taro', ...additionalLucideSources],
+    preferredUiImportBase: '@/components/ui',
+    overrides(config) {
+      const withInterestCardRules = [...config, ...interestCardRules]
+      if (!overrides) return withInterestCardRules
+      if (typeof overrides === 'function') {
+        return overrides(withInterestCardRules) ?? withInterestCardRules
+      }
+      return [
+        ...withInterestCardRules,
+        ...(Array.isArray(overrides) ? overrides : [overrides]),
+      ]
+    },
+  })
+}
+
+export default createInterestCardTaroEslintConfig

package/dist/adapters/interest-card/runtime/microapp.d.ts

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

package/dist/adapters/interest-card/runtime/microapp.js

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

package/dist/adapters/interest-card/runtime/microapp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"microapp.js","sourceRoot":"","sources":["../../../../src/adapters/interest-card/runtime/microapp.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,oBAAoB,EACpB,oBAAoB,GAErB,MAAM,2BAA2B,CAAA"}

package/dist/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/dist/build/config-overrides.d.ts

@@ -0,0 +1,19 @@
+import type { UserConfigExport } from '@tarojs/cli';
+import type { BuildContext, CreateMicroappTaroConfigOptions } from './taro.js';
+/**
+ * @desc 递归合并 Taro 配置，数组按顺序拼接。
+ * @params {any} base 基础配置。
+ * @params {any} override 覆盖配置。
+ * @return {any} 合并后的配置。
+ * @example mergeConfigValue({ plugins: ['a'] }, { plugins: ['b'] })
+ */
+export declare function mergeConfigValue(base: any, override: any): any;
+/**
+ * @desc 将对象或函数形式的覆盖项应用到 Taro 配置。
+ * @params {UserConfigExport} config 当前配置。
+ * @params {CreateMicroappTaroConfigOptions['overrides']} overrides 覆盖项。
+ * @params {BuildContext} ctx 构建上下文。
+ * @return {UserConfigExport} 应用覆盖后的配置。
+ * @example applyConfigOverrides(config, { h5: { publicPath: '/' } }, ctx)
+ */
+export declare function applyConfigOverrides(config: UserConfigExport, overrides: CreateMicroappTaroConfigOptions['overrides'], ctx: BuildContext): UserConfigExport;

package/dist/build/config-overrides.js

@@ -0,0 +1,35 @@
+/**
+ * @desc 递归合并 Taro 配置，数组按顺序拼接。
+ * @params {any} base 基础配置。
+ * @params {any} override 覆盖配置。
+ * @return {any} 合并后的配置。
+ * @example mergeConfigValue({ plugins: ['a'] }, { plugins: ['b'] })
+ */
+export function mergeConfigValue(base, override) {
+    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, overrides, ctx) {
+    if (!overrides)
+        return config;
+    if (typeof overrides === 'function')
+        return overrides(config, ctx) ?? config;
+    return mergeConfigValue(config, overrides);
+}
+//# sourceMappingURL=config-overrides.js.map

package/dist/build/config-overrides.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-overrides.js","sourceRoot":"","sources":["../../src/build/config-overrides.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAS,EAAE,QAAa;IACvD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;QAAE,OAAO,CAAC,GAAG,IAAI,EAAE,GAAG,QAAQ,CAAC,CAAA;IACjF,IAAI,IAAI,IAAI,QAAQ,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACjF,MAAM,MAAM,GAAG,EAAE,GAAG,IAAI,EAAE,CAAA;QAC1B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YACpD,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,IAAI,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;QAC5E,CAAC;QACD,OAAO,MAAM,CAAA;IACf,CAAC;IACD,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAClC,MAAwB,EACxB,SAAuD,EACvD,GAAiB;IAEjB,IAAI,CAAC,SAAS;QAAE,OAAO,MAAM,CAAA;IAC7B,IAAI,OAAO,SAAS,KAAK,UAAU;QAAE,OAAO,SAAS,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,MAAM,CAAA;IAC5E,OAAO,gBAAgB,CAAC,MAAM,EAAE,SAAS,CAAqB,CAAA;AAChE,CAAC"}

package/dist/build/index.d.ts

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

package/dist/build/index.js

@@ -0,0 +1,2 @@
+export { createMicroappTaroConfig, } from './taro.js';
+//# sourceMappingURL=index.js.map

package/dist/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/build/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,GAGzB,MAAM,QAAQ,CAAA"}

package/dist/build/plugins/app-config.cjs

@@ -0,0 +1,43 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = appConfigPlugin;
+const path_1 = __importDefault(require("path"));
+const withPreviewBasePath = (iconPath, previewBasePath) => {
+    if (!previewBasePath) {
+        return iconPath;
+    }
+    const previewPath = path_1.default.join(previewBasePath, iconPath);
+    if (previewPath.startsWith('./')) {
+        return previewPath;
+    }
+    if (previewPath.startsWith('/')) {
+        return `.${previewPath}`;
+    }
+    return `./${previewPath}`;
+};
+function appConfigPlugin(ctx, options = {}) {
+    const previewBasePath = options.previewBasePath ?? '';
+    ctx.modifyAppConfig(({ appConfig }) => {
+        if (typeof options.isClosedDomain === 'boolean') {
+            appConfig.isClosedDomain = options.isClosedDomain;
+        }
+        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/dist/build/plugins/vite-depend-card.d.ts

@@ -0,0 +1,29 @@
+import type { Plugin } from 'vite';
+/**
+ * @desc 通过 AST 检测卡片组件的 JSX 或 React.createElement 用法；仅导入或声明不算使用。
+ *   支持导入别名、命名空间及不可变局部别名；源码语法错误会向调用方抛出。
+ * @params {string} source 待分析的源码。
+ * @params {string} filename 用于按扩展名选择 TypeScript、JSX 解析语法的文件名。
+ * @return {boolean} 是否检测到卡片组件使用；不判断条件分支在运行时是否执行。
+ * @example usesCard("<Card />", "src/pages/index.tsx")
+ */
+export declare function usesCard(source: string, filename: string): boolean;
+/**
+ * @desc 递归扫描业务源码并收集监听路径，跳过依赖、测试、mock、声明和配置文件。
+ *   目录不存在时返回空结果；语法错误会中断扫描，避免将无法解析误判为不依赖卡片。
+ * @params {string} sourceDir Taro 编译上下文提供的源码目录，可为自定义 sourceRoot。
+ * @return {{ depends: boolean, files: string[], directories: string[] }} 检测结果及已扫描的文件、目录。
+ * @example scanSource("/workspace/project/src")
+ */
+export declare function scanSource(sourceDir: string): {
+    depends: boolean;
+    files: string[];
+    directories: string[];
+};
+/**
+ * @desc 创建自动维护 isDependCard 的 Vite 插件，从 Taro 模块 metadata 获取编译上下文。
+ *   在入口配置序列化前完成扫描，并在开发期间处理文件修改、新增及删除。
+ * @return {Plugin} 注册到 compiler.vitePlugins 的插件实例。
+ * @example viteDependCardPlugin()
+ */
+export declare function viteDependCardPlugin(): Plugin;