@open-dy/vibecoding-sdk-taro 0.1.11 → 0.1.12

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

@@ -1,3 +1,4 @@
+export { CARD_TYPE_RULES_VERSION } from '../../../eslint/taro.mjs'
 import { createMicroappTaroEslintConfig } from '../../../eslint/taro.mjs'
 
 /**

package/dist/eslint/card-profile.mjs

@@ -0,0 +1,96 @@
+import { existsSync, readFileSync } from 'node:fs'
+import path from 'node:path'
+import { pathToFileURL } from 'node:url'
+
+/**
+ * @desc 校验卡片形态；缺少字段保留历史兴趣卡语义，不写回配置。
+ * @params {object} config 已解析的工程配置。
+ * @params {string} [source] 错误信息中的配置来源。
+ * @return {'interest'|'post'} 卡片形态。
+ * @example parseCardType({ cardType: 'post' })
+ */
+export function parseCardType(config, source = 'card-routing.json') {
+  if (!config || typeof config !== 'object' || Array.isArray(config)) {
+    throw new Error(`${source} must contain an object`)
+  }
+  if (!Object.hasOwn(config, 'cardType')) return 'interest'
+  if (config.cardType !== 'interest' && config.cardType !== 'post') {
+    throw new Error(`${source}: cardType must be interest or post; got ${JSON.stringify(config.cardType)}`)
+  }
+  return config.cardType
+}
+
+/**
+ * @desc 从明确的宿主工程目录读取形态，供 CLI 与两端 SDK 共用。
+ * @params {{projectRoot: string}} options 宿主工程绝对路径；OpenCard 配置也传宿主目录。
+ * @return {{cardType: 'interest'|'post', configPath: string}} 形态及配置来源。
+ * @example readCardProfile({ projectRoot: '/workspace/project/card-app' })
+ */
+export function readCardProfile({ projectRoot }) {
+  if (typeof projectRoot !== 'string' || !path.isAbsolute(projectRoot)) {
+    throw new Error('readCardProfile requires an absolute projectRoot')
+  }
+  const configPath = path.join(projectRoot, 'config/card-routing.json')
+  let raw
+  try {
+    raw = readFileSync(configPath, 'utf8')
+  } catch (error) {
+    if (error.code === 'ENOENT') return { cardType: 'interest', configPath }
+    throw error
+  }
+  let config
+  try {
+    config = JSON.parse(raw)
+  } catch (error) {
+    throw new Error(`${configPath} must contain valid JSON: ${error.message}`)
+  }
+  return { cardType: parseCardType(config, configPath), configPath }
+}
+
+function findEslintHost(filename, target) {
+  let directory = path.dirname(filename)
+  while (true) {
+    // Stop at the owning package/config instead of inheriting another project's
+    // routing. An OpenCard package belongs to its immediate host directory.
+    if (existsSync(path.join(directory, 'package.json')) ||
+        existsSync(path.join(directory, 'eslint.config.mjs')) ||
+        existsSync(path.join(directory, 'project.card.json'))) {
+      return target === 'opencard' ? path.dirname(directory) : directory
+    }
+    if (existsSync(path.join(directory, '.git'))) return undefined
+    const parent = path.dirname(directory)
+    if (parent === directory) return undefined
+    directory = parent
+  }
+}
+
+/**
+ * @desc 创建作品卡文件匹配器；CLI 传入形态，直接 ESLint 从待检查文件定位工程。
+ * @params {{cardType?: 'interest'|'post', target: 'taro'|'opencard'}} options SDK 配置及目标端。
+ * @params {object} [environment] CLI 子进程环境。
+ * @return {(filename: string) => boolean} 是否启用作品卡配置。
+ * @example createPostCardMatcher({ target: 'taro' })('/workspace/app/src/index.ts')
+ */
+export function createPostCardMatcher(options, environment = process.env) {
+  const configured = options.cardType ?? environment.VIBECODING_CARD_TYPE
+  // An explicitly supplied null must not silently fall back to legacy rules.
+  const explicit = options.cardType !== undefined
+  if (explicit || configured !== undefined) {
+    const cardType = parseCardType({ cardType: explicit ? options.cardType : configured }, 'ESLint cardType')
+    return () => cardType === 'post'
+  }
+  return filename => {
+    const projectRoot = findEslintHost(filename, options.target)
+    return projectRoot ? readCardProfile({ projectRoot }).cardType === 'post' : false
+  }
+}
+
+// The legacy shell entry uses the same parser as the SDK-owned ESLint configs.
+if (process.argv[1] && import.meta.url === pathToFileURL(path.resolve(process.argv[1])).href) {
+  try {
+    console.log(readCardProfile({ projectRoot: path.resolve(process.argv[2]) }).cardType)
+  } catch (error) {
+    console.error(error.message)
+    process.exitCode = 1
+  }
+}

package/dist/eslint/eslint-plugin-post-card.mjs

@@ -0,0 +1,82 @@
+const TARO_SOURCES = new Set(['@tarojs/taro'])
+const TAB_APIS = new Set([
+  'switchTab', 'setTabBarItem', 'setTabBarStyle', 'showTabBar', 'hideTabBar',
+  'setTabBarBadge', 'removeTabBarBadge', 'showTabBarRedDot', 'hideTabBarRedDot',
+  'getTabBar', 'onTabItemTap', 'useTabItemTap',
+])
+
+function key(node) {
+  return node?.type === 'Identifier' ? node.name
+    : node?.type === 'Literal' && typeof node.value === 'string' ? node.value : null
+}
+
+function platformObject(node, context, seen = new Set()) {
+  if (!node || seen.has(node)) return false
+  seen.add(node)
+  if (['TSAsExpression', 'TSNonNullExpression', 'ChainExpression'].includes(node.type)) {
+    return platformObject(node.expression, context, seen)
+  }
+  if (node.type === 'CallExpression') {
+    return node.callee.type === 'Identifier' && node.callee.name === 'require'
+      && TARO_SOURCES.has(node.arguments[0]?.value)
+  }
+  if (node.type === 'MemberExpression') {
+    return ['globalThis', 'window'].includes(node.object?.name)
+      && ['tt', 'Taro'].includes(key(node.property))
+  }
+  if (node.type !== 'Identifier') return false
+  let scope = context.sourceCode.getScope(node)
+  let variable
+  while (scope && !variable) { variable = scope.set.get(node.name); scope = scope.upper }
+  if (!variable?.defs.length) return ['tt', 'Taro'].includes(node.name)
+  return variable.defs.some(def => {
+    if (def.type === 'ImportBinding') {
+      return TARO_SOURCES.has(def.parent?.source?.value)
+        && ['ImportDefaultSpecifier', 'ImportNamespaceSpecifier'].includes(def.node.type)
+    }
+    return def.type === 'Variable' && platformObject(def.node.init, context, seen)
+  })
+}
+
+export default {
+  rules: {
+    'no-platform-tabbar': {
+      meta: { type: 'problem', schema: [], messages: {
+        config: '作品卡不支持平台 tabBar（含 custom 模式）。请用普通组件绘制导航并实现页面或状态切换。',
+        api: '作品卡不支持 {{name}}。请使用普通页面路由或组件状态切换，不调用平台 TabBar。',
+      } },
+      create(context) {
+        const filename = context.filename.replaceAll('\\', '/')
+        const isAppConfig = /\/app\.config\.[cm]?[jt]s$/.test(filename)
+        const report = (node, name) => {
+          if (TAB_APIS.has(name)) context.report({ node, messageId: 'api', data: { name } })
+        }
+        return {
+          Property(node) {
+            if (isAppConfig && key(node.key) === 'tabBar') context.report({ node, messageId: 'config' })
+            if (node.parent.type === 'ObjectPattern' && platformObject(node.parent.parent?.init, context)) {
+              report(node, key(node.key))
+            }
+          },
+          ImportSpecifier(node) {
+            if (node.importKind !== 'type' && node.parent.importKind !== 'type'
+              && TARO_SOURCES.has(node.parent.source.value)) report(node, key(node.imported))
+          },
+          ExportSpecifier(node) {
+            if (TARO_SOURCES.has(node.parent.source?.value)) report(node, key(node.local))
+          },
+          MemberExpression(node) {
+            const name = key(node.property)
+            if (platformObject(node.object, context) || (name === 'getTabBar' && node.object.type === 'ThisExpression')) {
+              report(node, name)
+            }
+          },
+          JSXAttribute(node) {
+            const value = node.value?.type === 'JSXExpressionContainer' ? node.value.expression?.value : node.value?.value
+            if (node.name.name === 'openType' && value === 'switchTab') report(node, 'switchTab')
+          },
+        }
+      },
+    },
+  },
+}

package/dist/eslint/taro.mjs

@@ -1,3 +1,6 @@
+import postCard from './eslint-plugin-post-card.mjs';
+import { createPostCardMatcher } from './card-profile.mjs';
+export const CARD_TYPE_RULES_VERSION = 1;
 import eslint from '@eslint/js';
 import { fixupPluginRules } from '@eslint/compat';
 import tseslint from 'typescript-eslint';
@@ -381,6 +384,7 @@ const indexPageRestrictedSyntaxRules = [
 ];
 
 export function createMicroappTaroEslintConfig(options = {}) {
+  const matchesPostCard = createPostCardMatcher({ cardType: options.cardType, target: 'taro' });
   const lucideColorCheckPlugin = createLucideColorCheckPlugin(options.lucideImportSources)
   const pageRestrictedSyntaxRules = createPageRestrictedSyntaxRules(
     options.preferredUiImportBase,
@@ -581,6 +585,12 @@ export function createMicroappTaroEslintConfig(options = {}) {
   },
 );
 
+defaults.push({
+  files: [['src/**/*.{js,jsx,ts,tsx}', matchesPostCard]],
+  settings: { cardType: 'post', cardTypeRulesVersion: CARD_TYPE_RULES_VERSION },
+  plugins: { postCard },
+  rules: { 'postCard/no-platform-tabbar': 'error' },
+});
 const overrides = options.overrides
 if (!overrides) return defaults
 if (typeof overrides === 'function') return overrides(defaults) ?? defaults

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-dy/vibecoding-sdk-taro",
-  "version": "0.1.11",
+  "version": "0.1.12",
   "description": "Runtime, UI, build and ESLint capabilities for Douyin Taro templates.",
   "type": "module",
   "files": [

package/release-provenance.json

@@ -2,12 +2,12 @@
   "schema": 1,
   "producer": "vibecoding-sdk-taro",
   "packageName": "@open-dy/vibecoding-sdk-taro",
-  "version": "0.1.11",
+  "version": "0.1.12",
   "source": {
-    "digest": "sha256-65487d3df50200d0d27332e26f04e9d3520d3313d31eae611483a3078b0f658c",
-    "files": 159
+    "digest": "sha256-343c13406654fbfb96b1ae78b83b481b68135affa5484b7230646fda91568c26",
+    "files": 162
   },
-  "payload": "sha256-ff279eab5b08f88997926c9180ecd6a50e8d0f724cf81a76f314f477b116cc40",
+  "payload": "sha256-e969e73830ccf0dfe00b29542c2b992d78d6640c59b04031c7ab9f3f754731de",
   "toolchain": {
     "node": "v22.22.3",
     "runtime": {

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

@@ -1,3 +1,4 @@
+export { CARD_TYPE_RULES_VERSION } from '../../../eslint/taro.mjs'
 import { createMicroappTaroEslintConfig } from '../../../eslint/taro.mjs'
 
 /**

package/src/eslint/card-profile.mjs

@@ -0,0 +1,2 @@
+// SDK builds embed this shared, dependency-free module beside the ESLint entry.
+export { createPostCardMatcher } from '../../../vibecoding-cli/src/config/card-profile.mjs'

package/src/eslint/eslint-plugin-post-card.mjs

@@ -0,0 +1,82 @@
+const TARO_SOURCES = new Set(['@tarojs/taro'])
+const TAB_APIS = new Set([
+  'switchTab', 'setTabBarItem', 'setTabBarStyle', 'showTabBar', 'hideTabBar',
+  'setTabBarBadge', 'removeTabBarBadge', 'showTabBarRedDot', 'hideTabBarRedDot',
+  'getTabBar', 'onTabItemTap', 'useTabItemTap',
+])
+
+function key(node) {
+  return node?.type === 'Identifier' ? node.name
+    : node?.type === 'Literal' && typeof node.value === 'string' ? node.value : null
+}
+
+function platformObject(node, context, seen = new Set()) {
+  if (!node || seen.has(node)) return false
+  seen.add(node)
+  if (['TSAsExpression', 'TSNonNullExpression', 'ChainExpression'].includes(node.type)) {
+    return platformObject(node.expression, context, seen)
+  }
+  if (node.type === 'CallExpression') {
+    return node.callee.type === 'Identifier' && node.callee.name === 'require'
+      && TARO_SOURCES.has(node.arguments[0]?.value)
+  }
+  if (node.type === 'MemberExpression') {
+    return ['globalThis', 'window'].includes(node.object?.name)
+      && ['tt', 'Taro'].includes(key(node.property))
+  }
+  if (node.type !== 'Identifier') return false
+  let scope = context.sourceCode.getScope(node)
+  let variable
+  while (scope && !variable) { variable = scope.set.get(node.name); scope = scope.upper }
+  if (!variable?.defs.length) return ['tt', 'Taro'].includes(node.name)
+  return variable.defs.some(def => {
+    if (def.type === 'ImportBinding') {
+      return TARO_SOURCES.has(def.parent?.source?.value)
+        && ['ImportDefaultSpecifier', 'ImportNamespaceSpecifier'].includes(def.node.type)
+    }
+    return def.type === 'Variable' && platformObject(def.node.init, context, seen)
+  })
+}
+
+export default {
+  rules: {
+    'no-platform-tabbar': {
+      meta: { type: 'problem', schema: [], messages: {
+        config: '作品卡不支持平台 tabBar（含 custom 模式）。请用普通组件绘制导航并实现页面或状态切换。',
+        api: '作品卡不支持 {{name}}。请使用普通页面路由或组件状态切换，不调用平台 TabBar。',
+      } },
+      create(context) {
+        const filename = context.filename.replaceAll('\\', '/')
+        const isAppConfig = /\/app\.config\.[cm]?[jt]s$/.test(filename)
+        const report = (node, name) => {
+          if (TAB_APIS.has(name)) context.report({ node, messageId: 'api', data: { name } })
+        }
+        return {
+          Property(node) {
+            if (isAppConfig && key(node.key) === 'tabBar') context.report({ node, messageId: 'config' })
+            if (node.parent.type === 'ObjectPattern' && platformObject(node.parent.parent?.init, context)) {
+              report(node, key(node.key))
+            }
+          },
+          ImportSpecifier(node) {
+            if (node.importKind !== 'type' && node.parent.importKind !== 'type'
+              && TARO_SOURCES.has(node.parent.source.value)) report(node, key(node.imported))
+          },
+          ExportSpecifier(node) {
+            if (TARO_SOURCES.has(node.parent.source?.value)) report(node, key(node.local))
+          },
+          MemberExpression(node) {
+            const name = key(node.property)
+            if (platformObject(node.object, context) || (name === 'getTabBar' && node.object.type === 'ThisExpression')) {
+              report(node, name)
+            }
+          },
+          JSXAttribute(node) {
+            const value = node.value?.type === 'JSXExpressionContainer' ? node.value.expression?.value : node.value?.value
+            if (node.name.name === 'openType' && value === 'switchTab') report(node, 'switchTab')
+          },
+        }
+      },
+    },
+  },
+}

package/src/eslint/taro.mjs

@@ -1,3 +1,6 @@
+import postCard from './eslint-plugin-post-card.mjs';
+import { createPostCardMatcher } from './card-profile.mjs';
+export const CARD_TYPE_RULES_VERSION = 1;
 import eslint from '@eslint/js';
 import { fixupPluginRules } from '@eslint/compat';
 import tseslint from 'typescript-eslint';
@@ -381,6 +384,7 @@ const indexPageRestrictedSyntaxRules = [
 ];
 
 export function createMicroappTaroEslintConfig(options = {}) {
+  const matchesPostCard = createPostCardMatcher({ cardType: options.cardType, target: 'taro' });
   const lucideColorCheckPlugin = createLucideColorCheckPlugin(options.lucideImportSources)
   const pageRestrictedSyntaxRules = createPageRestrictedSyntaxRules(
     options.preferredUiImportBase,
@@ -581,6 +585,12 @@ export function createMicroappTaroEslintConfig(options = {}) {
   },
 );
 
+defaults.push({
+  files: [['src/**/*.{js,jsx,ts,tsx}', matchesPostCard]],
+  settings: { cardType: 'post', cardTypeRulesVersion: CARD_TYPE_RULES_VERSION },
+  plugins: { postCard },
+  rules: { 'postCard/no-platform-tabbar': 'error' },
+});
 const overrides = options.overrides
 if (!overrides) return defaults
 if (typeof overrides === 'function') return overrides(defaults) ?? defaults