openyida 2026.9.21 → 2026.9.22-beta.2

package/lib/app/canvas-icon-guard.js

@@ -1,87 +0,0 @@
-'use strict';
-
-const Babel = require('@babel/standalone');
-const { CliError } = require('../core/cli-error');
-const { t } = require('../core/i18n');
-const { packages } = require('./canvas-icon-exports.json');
-const exportSets = Object.fromEntries(Object.entries(packages).map(([name, entry]) => [name, new Set(entry.exports)]));
-
-function packageName(source) {
-  return Object.keys(packages).find(name => source === name || source.startsWith(name + '/'));
-}
-
-// Resolve literal namespace members and immutable aliases, respecting lexical
-// scope. Dynamic lookups still require a validated component map / fallback.
-function namespacePackage(p, seen = new Set()) {
-  if (!p?.isIdentifier() && !p?.isJSXIdentifier()) { return null; }
-  const binding = p.scope.getBinding(p.node.name);
-  if (!binding || seen.has(binding)) { return null; }
-  seen.add(binding);
-  if (binding.path.isImportNamespaceSpecifier()) {
-    return packageName(binding.path.parent.source.value);
-  }
-  if (binding.constant && binding.path.isVariableDeclarator()) {
-    return namespacePackage(binding.path.get('init'), seen);
-  }
-  return null;
-}
-
-function staticKey(node, computed) {
-  if (!computed && ['Identifier', 'JSXIdentifier'].includes(node?.type)) { return node.name; }
-  if (node?.type === 'StringLiteral') { return node.value; }
-  if (node?.type === 'TemplateLiteral' && node.expressions.length === 0) { return node.quasis[0].value.cooked; }
-  return null;
-}
-
-function assertCanvasIconExports(source, options = {}) {
-  if (!/lucide-react|@ant-design\/icons/.test(source)) { return; }
-  let ast;
-  try {
-    ast = Babel.packages.parser.parse(source, { sourceType: 'module', plugins: ['jsx', 'typescript'] });
-  } catch { return; } // The compiler owns syntax diagnostics.
-  const check = (name, exported, node, namedImport = false) => {
-    if (!name || exported === null || exportSets[name].has(exported)) { return; }
-    if (namedImport && Object.hasOwn(packages[name].specialNamedExports || {}, exported)) { return; }
-    const suggestions = name === 'lucide-react' && exported === 'Museum' ? ['Landmark'] : [];
-    const line = node.loc?.start.line || 1;
-    throw new CliError(t('publish.canvas_icon_export_unavailable', name, exported, line, suggestions.join(', ') || '—'), {
-      code: 'OPENYIDA_CANVAS_ICON_EXPORT_UNAVAILABLE',
-      details: {
-        stage: 'canvas_compile', sourcePath: options.sourcePath || '',
-        line, column: (node.loc?.start.column || 0) + 1,
-        packageName: name, exportName: exported, suggestions,
-        runtimeAsset: packages[name].assetUrl, runtimeSha256: packages[name].sha256,
-      },
-    });
-  };
-  const member = p => check(namespacePackage(p.get('object')), staticKey(p.node.property, p.node.computed), p.node);
-  const destructure = (pattern, init) => {
-    const name = namespacePackage(init);
-    if (!name || !pattern.isObjectPattern()) { return; }
-    for (const property of pattern.node.properties) {
-      if (property.type === 'ObjectProperty') { check(name, staticKey(property.key, property.computed), property); }
-    }
-  };
-  const traverse = Babel.packages.traverse.default || Babel.packages.traverse;
-  traverse(ast, {
-    ImportDeclaration(p) {
-      const name = packageName(p.node.source.value);
-      if (!name || p.node.importKind === 'type') { return; }
-      for (const specifier of p.node.specifiers) {
-        if (specifier.type === 'ImportSpecifier' && specifier.importKind !== 'type') {
-          check(name, specifier.imported.name || specifier.imported.value, specifier, true);
-        }
-      }
-    },
-    MemberExpression: member,
-    OptionalMemberExpression: member,
-    JSXOpeningElement(p) {
-      const name = p.get('name');
-      if (name.isJSXMemberExpression()) { member(name); }
-    },
-    VariableDeclarator(p) { destructure(p.get('id'), p.get('init')); },
-    AssignmentExpression(p) { destructure(p.get('left'), p.get('right')); },
-  });
-}
-
-module.exports = { assertCanvasIconExports };

package/lib/app/canvas-navigation-guard.js

@@ -1,84 +0,0 @@
-'use strict';
-
-const Babel = require('@babel/standalone');
-const { CliError } = require('../core/cli-error');
-const { t } = require('../core/i18n');
-
-// Only diagnose statically known misuse of the shipped navigation contracts.
-// Dynamic data and actual host geometry still require browser verification.
-function assertCanvasNavigationStructure(source, options = {}) {
-  if (!/CanvasNavigationContent|loadCanvasNavigation|filterCanvasNavigation/.test(source)) { return; }
-  let ast;
-  try { ast = Babel.packages.parser.parse(source, { sourceType: 'module', plugins: ['jsx', 'typescript'] }); }
-  catch { return; }
-  const traverse = Babel.packages.traverse.default || Babel.packages.traverse;
-  const fail = (kind, node) => {
-    const line = node.loc?.start.line || 1;
-    throw new CliError(t(`publish.canvas_navigation_${kind}`, line), {
-      code: 'OPENYIDA_CANVAS_NAVIGATION_INVALID',
-      details: { stage: 'canvas_compile', sourcePath: options.sourcePath || '', line, issueType: kind },
-    });
-  };
-  function resolve(p, seen = new Set()) {
-    if (!p?.node || seen.has(p.node)) { return null; }
-    seen.add(p.node);
-    if (!p.isIdentifier()) { return p; }
-    const binding = p.scope.getBinding(p.node.name);
-    return binding?.constant && binding.path.isVariableDeclarator() ? resolve(binding.path.get('init'), seen) : null;
-  }
-  const prop = (p, name) => {
-    const object = resolve(p);
-    return object?.isObjectExpression() ? object.get('properties').find(item => item.isObjectProperty()
-      && !item.node.computed && (item.node.key.name || item.node.key.value) === name)?.get('value') : undefined;
-  };
-  const string = p => { const value = resolve(p); return value?.isStringLiteral() ? value.node.value : undefined; };
-  const hasUnboundLocal = (p, seen = new Set()) => {
-    const array = resolve(p);
-    if (!array?.isArrayExpression() || seen.has(array.node)) { return false; }
-    seen.add(array.node);
-    return array.get('elements').some(element => {
-      const item = resolve(element);
-      if (!item?.isObjectExpression() || item.node.properties.some(node => node.type === 'SpreadElement')) { return false; }
-      const children = resolve(prop(item, 'children'));
-      if (children?.isArrayExpression() && children.node.elements.length) { return hasUnboundLocal(children, seen); }
-      return string(prop(item, 'targetType')) === 'local'
-        || (!prop(item, 'formUuid') && !prop(item, 'navUuid') && !!prop(item, 'key'));
-    });
-  };
-  let documentLayout = false;
-  const collapsedMains = [];
-  traverse(ast, {
-    CallExpression(p) {
-      const name = p.node.callee.name;
-      const args = p.get('arguments');
-      if (name === 'CanvasNavigationContent' && string(prop(args[0], 'layout')) === 'document') { documentLayout = true; }
-      if (!['loadCanvasNavigation', 'filterCanvasNavigation'].includes(name)) { return; }
-      const configArg = name === 'loadCanvasNavigation' ? args[0] : args[3];
-      const config = resolve(configArg);
-      if (configArg?.node && !config) { return; }
-      if (config && (!config.isObjectExpression() || config.node.properties.some(node => node.type === 'SpreadElement'))) { return; }
-      const mode = prop(config, 'mode');
-      if (mode && string(mode) !== 'platform') { return; }
-      const items = name === 'loadCanvasNavigation' ? prop(config, 'items') : args[0];
-      if (hasUnboundLocal(items)) { fail('local_platform', p.node); }
-    },
-    JSXOpeningElement(p) {
-      const attributes = p.get('attributes');
-      const attribute = name => {
-        const value = attributes.find(item => item.isJSXAttribute() && item.node.name.name === name)?.get('value');
-        return value?.isJSXExpressionContainer() ? value.get('expression') : value;
-      };
-      if (p.node.name.name === 'CanvasNavigationContent' && string(attribute('layout')) === 'document') { documentLayout = true; }
-      if (string(attribute('className')) !== 'openyida-nav-main') { return; }
-      const owner = p.getFunctionParent();
-      const ownerName = owner?.node.id?.name || (owner?.parentPath.isVariableDeclarator() ? owner.parentPath.node.id.name : '');
-      if (ownerName !== 'CanvasNavigationContent') { return; }
-      const style = resolve(attribute('style'));
-      if (style?.isObjectExpression() && string(prop(style, 'display')) === 'flex'
-        && /^1\s+1\s+0(?:px|%)?$/.test(string(prop(style, 'flex')) || '')) { collapsedMains.push(p.node); }
-    },
-  });
-  if (documentLayout && collapsedMains.length) { fail('document_flex', collapsedMains[0]); }
-}
-
-module.exports = { assertCanvasNavigationStructure };

package/lib/app/canvas-path-guard.js

@@ -1,78 +0,0 @@
-'use strict';
-
-const Babel = require('@babel/standalone');
-const { CliError } = require('../core/cli-error');
-const { t } = require('../core/i18n');
-
-// Inspect navigation destinations, not every string: '/custom/' is a valid
-// suffix in '/' + appType + '/custom/' + formUuid. Unknown values need runtime QA.
-function assertCanvasNavigationPaths(source, options = {}) {
-  let ast;
-  try { ast = Babel.packages.parser.parse(source, { sourceType: 'module', plugins: ['jsx', 'typescript'] }); }
-  catch { return; }
-  const traverse = Babel.packages.traverse.default || Babel.packages.traverse;
-  const name = node => node?.computed ? node.property?.value : node?.property?.name;
-  function value(p, seen = new Set()) {
-    if (!p?.node || seen.has(p.node)) { return null; }
-    seen.add(p.node);
-    if (p.isStringLiteral()) { return p.node.value; }
-    if (p.isTemplateLiteral()) { return p.node.quasis[0].value.cooked + (p.node.expressions.length ? '<dynamic>' : ''); }
-    if (p.isBinaryExpression({ operator: '+' })) {
-      const left = value(p.get('left'), new Set(seen));
-      const right = value(p.get('right'), new Set(seen));
-      return left === null ? null : left + (right === null ? '<dynamic>' : right);
-    }
-    if (p.isIdentifier()) {
-      const binding = p.scope.getBinding(p.node.name);
-      return binding?.constant && binding.path.isVariableDeclarator() ? value(binding.path.get('init'), seen) : null;
-    }
-    if (p.isNewExpression() && p.node.callee.name === 'URL') { return value(p.get('arguments.0'), seen); }
-    if (p.isMemberExpression() && ['href', 'pathname'].includes(name(p.node))) { return value(p.get('object'), seen); }
-    return null;
-  }
-  function check(p) {
-    if (!p?.node) { return; }
-    if (p.isConditionalExpression() || p.isLogicalExpression()) {
-      for (const key of p.isConditionalExpression() ? ['consequent', 'alternate'] : ['left', 'right']) { check(p.get(key)); }
-      return;
-    }
-    const path = value(p);
-    if (!/^\s*\/(?:custom|workbench|submission|formDetail)(?:\/|[?#]|$)/.test(path || '')) { return; }
-    const line = p.node.loc?.start.line || 1;
-    throw new CliError(t('publish.canvas_path_missing_app_type', line), {
-      code: 'OPENYIDA_CANVAS_PATH_MISSING_APP_TYPE',
-      details: { stage: 'canvas_compile', sourcePath: options.sourcePath || '', line, path,
-        expectedPath: '/{appType}/{pageType}/{formUuid}', sample: 'openyida sample openyida-page-template canvas-navigation' },
-    });
-  }
-  traverse(ast, {
-    JSXAttribute(p) {
-      if (!['href', 'action', 'formAction'].includes(p.node.name.name)) { return; }
-      const val = p.get('value');
-      check(val.isJSXExpressionContainer() ? val.get('expression') : val);
-    },
-    AssignmentExpression(p) {
-      const left = p.node.left;
-      if ((left.type === 'Identifier' && left.name === 'location') || name(left) === 'location'
-        || (['href', 'pathname'].includes(name(left)) && (left.object?.name === 'location' || name(left.object) === 'location'))) { check(p.get('right')); }
-    },
-    CallExpression(p) {
-      const callee = p.node.callee;
-      const method = name(callee);
-      const receiver = callee.object;
-      if ((method === 'open' && ['window', 'self', 'globalThis'].includes(receiver?.name))
-        || (['assign', 'replace'].includes(method) && (receiver?.name === 'location' || name(receiver) === 'location'))
-        || (['push', 'replace'].includes(method) && (receiver?.name === 'router' || name(receiver) === 'router'))) { check(p.get('arguments.0')); }
-      if (method === 'openPage' || callee.name === 'openPage') {
-        const arg = p.get('arguments.0');
-        if (arg?.isObjectExpression()) {
-          for (const prop of arg.get('properties')) {
-            if (prop.isObjectProperty() && (prop.node.key.name || prop.node.key.value) === 'url') { check(prop.get('value')); }
-          }
-        } else { check(arg); }
-      }
-    },
-  });
-}
-
-module.exports = { assertCanvasNavigationPaths };

package/lib/app/canvas-theme-guard.js

@@ -1,184 +0,0 @@
-'use strict';
-
-const Babel = require('@babel/standalone');
-const { CliError } = require('../core/cli-error');
-const { t } = require('../core/i18n');
-
-// Check the maintained theme contract without executing business code.
-// Dynamic component factories and runtime branches still need browser verification.
-function assertCanvasThemeStructure(source, options = {}) {
-  if (!/CanvasThemeProvider|useCanvasThemeContext|CanvasThemeContext|@canvas-theme-provider|antd/.test(source)) { return; }
-  let ast;
-  try {
-    ast = Babel.packages.parser.parse(source, { sourceType: 'module', plugins: ['jsx', 'typescript'] });
-  } catch { return; } // Let the compiler report syntax errors.
-  const marker = ast.comments?.find(comment => comment.type === 'CommentBlock' && comment.value.trim() === '@canvas-theme-provider');
-  if (marker) {
-    const line = marker.loc.start.line;
-    throw new CliError(t('publish.canvas_theme_not_assembled', line), {
-      code: 'OPENYIDA_CANVAS_THEME_NOT_ASSEMBLED',
-      details: { stage: 'canvas_compile', sourcePath: options.sourcePath || '', line, issueType: 'unexpanded_marker' },
-    });
-  }
-  const traverse = Babel.packages.traverse.default || Babel.packages.traverse;
-  assertBrandOverrides(ast, traverse, options);
-  const functions = new Map();
-  let program;
-  let defaultExport;
-  const fail = (kind, node) => {
-    const line = node?.loc?.start.line || 1;
-    throw new CliError(t(`publish.canvas_theme_${kind}`, line), {
-      code: 'OPENYIDA_CANVAS_THEME_PROVIDER_INVALID',
-      details: { stage: 'canvas_compile', sourcePath: options.sourcePath || '', line, issueType: kind },
-    });
-  };
-
-  traverse(ast, {
-    Program(p) { program = p; },
-    ExportDefaultDeclaration(p) { defaultExport = p.get('declaration'); },
-    Function(p) {
-      const name = p.node.id?.name || (p.parentPath.isVariableDeclarator() ? p.parentPath.node.id.name : '');
-      functions.set(p.node, { name, calls: [], renders: [], hooks: [] });
-    },
-    VariableDeclarator(p) {
-      if (p.node.id.name === 'CanvasThemeContext' && p.getFunctionParent()) {
-        fail('context_scope', p.node);
-      }
-    },
-  });
-
-  function resolveFunction(p, seen = new Set()) {
-    if (!p?.node || seen.has(p.node)) { return null; }
-    seen.add(p.node);
-    if (p.isFunction()) { return p.node; }
-    if (p.isVariableDeclarator()) { return resolveFunction(p.get('init'), seen); }
-    if (p.isIdentifier() || p.isJSXIdentifier()) {
-      return resolveFunction(p.scope.getBinding(p.node.name)?.path, seen);
-    }
-    // React.memo/forwardRef retain the wrapped component's theme requirements.
-    if (p.isCallExpression()) {
-      const callee = p.node.callee;
-      const name = callee.type === 'Identifier' ? callee.name : callee.property?.name;
-      if (['memo', 'forwardRef'].includes(name)) { return resolveFunction(p.get('arguments.0'), seen); }
-    }
-    return null;
-  }
-
-  traverse(ast, {
-    CallExpression(p) {
-      const owner = functions.get(p.getFunctionParent()?.node);
-      const target = resolveFunction(p.get('callee'));
-      const targetName = functions.get(target)?.name || p.node.callee.name;
-      if (targetName === 'useCanvasThemeContext') {
-        if (!owner) { fail('root_hook', p.node); }
-        owner.hooks.push(p.node);
-      }
-      if (!owner) { return; }
-      if (target) { owner.calls.push(target); }
-      const callee = p.node.callee;
-      if (callee.type === 'MemberExpression' && callee.object.name === 'React' && callee.property.name === 'createElement') {
-        const component = resolveFunction(p.get('arguments.0'));
-        if (component) { owner.renders.push(component); }
-      }
-    },
-    JSXOpeningElement(p) {
-      const owner = functions.get(p.getFunctionParent()?.node);
-      const component = resolveFunction(p.get('name'));
-      if (owner && component) { owner.renders.push(component); }
-    },
-  });
-
-  const entry = resolveFunction(program.scope.getBinding('YidaComp')?.path) || resolveFunction(defaultExport);
-  if (!entry) { return; }
-
-  // Calling a hook before returning a Provider cannot read that Provider.
-  const directSeen = new Set();
-  function checkEntryCalls(node) {
-    if (directSeen.has(node)) { return; }
-    directSeen.add(node);
-    const info = functions.get(node);
-    if (info.hooks.length) { fail('root_hook', info.hooks[0]); }
-    info.calls.forEach(checkEntryCalls);
-  }
-  checkEntryCalls(entry);
-
-  const seen = new Set();
-  let providerMounted = false;
-  let firstHook;
-  function visit(node) {
-    if (seen.has(node)) { return; }
-    seen.add(node);
-    const info = functions.get(node);
-    firstHook = firstHook || info.hooks[0];
-    info.renders.forEach(child => {
-      if (functions.get(child).name === 'CanvasThemeProvider') { providerMounted = true; }
-      visit(child);
-    });
-    info.calls.forEach(visit);
-  }
-  visit(entry);
-  const hasProvider = [...functions.values()].some(info => info.name === 'CanvasThemeProvider');
-  if (!providerMounted && (hasProvider || firstHook)) {
-    fail('provider_missing', firstHook || entry);
-  }
-}
-
-// Only reject provably fixed brand colors passed to antd's ConfigProvider.
-// Semantic colors, layout tokens and dynamic theme resolvers remain supported.
-function assertBrandOverrides(ast, traverse, options) {
-  const resolve = (p, seen = new Set()) => {
-    if (!p?.node || seen.has(p.node)) { return null; }
-    seen.add(p.node);
-    if (!p.isIdentifier()) { return p; }
-    const binding = p.scope.getBinding(p.node.name);
-    return binding?.constant && binding.path.isVariableDeclarator() ? resolve(binding.path.get('init'), seen) : null;
-  };
-  const properties = p => {
-    const object = resolve(p);
-    // Spreads may override earlier values; unknown shapes are not rejected.
-    return object?.isObjectExpression() && !object.node.properties.some(prop => prop.type === 'SpreadElement')
-      ? object.get('properties').filter(prop => prop.isObjectProperty() && !prop.node.computed) : [];
-  };
-  const key = p => p.node.key.name || p.node.key.value;
-  const prop = (p, name) => properties(p).filter(item => key(item) === name).pop()?.get('value');
-  const check = (p, field) => {
-    const val = resolve(p);
-    if (!val?.isStringLiteral() && !(val?.isTemplateLiteral() && !val.node.expressions.length)) { return; }
-    const color = val.isStringLiteral() ? val.node.value : val.node.quasis[0].value.cooked;
-    if (!color) { return; }
-    const line = val.node.loc?.start.line || 1;
-    throw new CliError(t('publish.canvas_theme_fixed_brand', line), {
-      code: 'OPENYIDA_CANVAS_THEME_FIXED_BRAND',
-      details: { stage: 'canvas_compile', sourcePath: options.sourcePath || '', line, field, value: color,
-        sample: 'openyida sample openyida-page-template canvas-theme' },
-    });
-  };
-  const tokens = p => properties(p).forEach(item => {
-    if (/^color(?:Primary|Link)(?:Hover|Active|Bg|BgHover|Border|BorderHover|Text|TextHover|TextActive)?$/.test(key(item))) {
-      check(item.get('value'), key(item));
-    }
-  });
-  traverse(ast, {
-    JSXOpeningElement(p) {
-      const name = p.get('name');
-      const binding = p.scope.getBinding(name.isJSXIdentifier() ? name.node.name : name.node.object?.name);
-      const imported = binding?.path;
-      if (imported?.parent.source?.value !== 'antd') { return; }
-      if (!(imported.isImportSpecifier() && imported.node.imported.name === 'ConfigProvider')
-        && !(imported.isImportNamespaceSpecifier() && name.node.property?.name === 'ConfigProvider')) { return; }
-      const attribute = p.get('attributes').find(attr => attr.isJSXAttribute() && attr.node.name.name === 'theme');
-      const theme = attribute?.get('value.expression');
-      tokens(prop(theme, 'token'));
-      const components = prop(theme, 'components');
-      for (const component of ['Button', 'Tabs', 'Segmented']) {
-        const config = prop(components, component);
-        tokens(config);
-        const fields = component === 'Tabs' ? ['inkBarColor', 'itemSelectedColor', 'itemHoverColor', 'itemActiveColor']
-          : component === 'Button' ? ['defaultHoverColor', 'defaultHoverBorderColor', 'defaultActiveColor', 'defaultActiveBorderColor'] : [];
-        fields.forEach(field => check(prop(config, field), `${component}.${field}`));
-      }
-    },
-  });
-}
-
-module.exports = { assertCanvasThemeStructure };

package/lib/app/form-data-response-guard.js

@@ -1,57 +0,0 @@
-'use strict';
-
-const Babel = require('@babel/standalone');
-const traverse = Babel.packages.traverse.default || Babel.packages.traverse;
-const { CliError } = require('../core/cli-error');
-const { t } = require('../core/i18n');
-
-const member = (node, name) => node && ['MemberExpression', 'OptionalMemberExpression'].includes(node.type)
-  && (node.computed ? node.property.value : node.property.name) === name;
-
-// Only inspect a direct result from the installed Yida bridge, not arbitrary
-// HTTP clients, adapters, similarly named methods, or a shadowed variable.
-function bridgeMember(node) {
-  return (member(node, '__OPENYIDA_YIDA_API__') || member(node, 'openyidaYidaApi'))
-    && node.object?.type === 'Identifier' && node.object.name === 'window';
-}
-
-function isYidaBridge(path) {
-  if (bridgeMember(path.node) && !path.scope.getBinding('window')) {return true;}
-  if (!path.isIdentifier()) {return false;}
-  const binding = path.scope.getBinding(path.node.name);
-  return !!(binding && binding.constant && binding.path.isVariableDeclarator()
-    && bridgeMember(binding.path.node.init) && !binding.path.scope.getBinding('window'));
-}
-
-function assertFormDataResponse(source, options = {}) {
-  let ast;
-  try { ast = Babel.packages.parser.parse(source, { sourceType: 'module', plugins: ['jsx', 'typescript'] }); }
-  catch { return; } // The compiler owns syntax diagnostics.
-  const issues = [];
-  traverse(ast, { VariableDeclarator(path) {
-    if (!path.get('id').isIdentifier() || !path.get('init').isAwaitExpression()) {return;}
-    const call = path.get('init.argument');
-    if (!call.isCallExpression() || !member(call.node.callee, 'searchFormDatas') || !isYidaBridge(call.get('callee.object'))) {return;}
-    const binding = path.scope.getBinding(path.node.id.name);
-    if (!binding || !binding.constant) {return;}
-    let unwrapsArray = false;
-    const doubleData = [];
-    for (const ref of binding.referencePaths) {
-      const first = ref.parentPath;
-      if (!member(first.node, 'data') || first.node.object !== ref.node) {continue;}
-      const next = first.parentPath;
-      if (member(next.node, 'data') && next.node.object === first.node) {doubleData.push(next);}
-      if (next.isCallExpression() && member(next.node.callee, 'isArray') && next.node.callee.object?.name === 'Array') {unwrapsArray = true;}
-    }
-    if (!unwrapsArray && doubleData.length) {
-      issues.push({ line: doubleData[0].node.loc?.start.line || 1, variable: path.node.id.name });
-    }
-  } });
-  if (issues.length) {
-    throw new CliError(t('publish.lint_searchformdata_bridge_unwrap'), {
-      code: 'OPENYIDA_FORM_DATA_RESPONSE_INVALID',
-      details: { sourcePath: options.sourcePath || '', issues, nextAction: 'normalize_form_rows' },
-    });
-  }
-}
-module.exports = { assertFormDataResponse };

package/lib/asset/asset-execution.js

@@ -1,79 +0,0 @@
-'use strict';
-
-function getAssetExecutionContract() {
-  return {
-    capabilitySource: 'agent-capabilities.asset_capabilities + actual_host_tool_inventory',
-    modes: ['background_agent', 'background_shell', 'synchronous'],
-    selection: 'Use a verified nonblocking agent when available; otherwise a verified background shell for scriptable steps; otherwise business-first synchronous batches.',
-    nonblockingProof: ['actual_tool_and_background_option', 'hostTaskId', 'dispatchReturnedAt_before_endedAt', 'result_and_exit_status_retrieval'],
-    shell: {
-      qwenworkHint: 'Inspect Bash.run_in_background in the current tool schema; do not infer Agent background support from Bash support or a host name.',
-      allowedWork: ['scriptable_search_with_verified_cli', 'allowed_download_or_upload', 'asset_resolve'],
-      foregroundWork: ['host_only_search_or_generation', 'visual_image_review'],
-      handoff: 'Pass task.resolve.argv with actual paths and appType when uploading; use the supported background option, save the returned job ID and log/output paths, then resume business work. Poll only at the owning page image-binding join; read exit code and manifest, and stop timed-out jobs before handing over file ownership.',
-      unsupported: 'A shell cannot call agent-only image tools. A command ending in & or a returned PID alone is not proof of durable background support.',
-    },
-    synchronousOrder: ['authorized_resource_creation_or_reuse', 'seed_if_in_scope', 'independent_page_layout_and_data_work', 'bounded_asset_batch', 'next_independent_work', 'own_page_image_binding'],
-    forbid: ['blocking_whole_collection_subagent_before_business', 'immediate_wait_after_background_dispatch', 'all_page_asset_barrier', 'claim_parallel_without_overlapping_intervals'],
-    audit: 'Copy actual taskState records and businessWork intervals into build-manifest.assetExecution for check-prd-completeness; missing evidence is not verified concurrency.',
-  };
-}
-
-function selectAssetExecutionMode(backgroundAgent, backgroundShell) {
-  if (backgroundAgent.available === true) { return 'background_agent'; }
-  if (backgroundShell.available === true) { return 'background_shell'; }
-  return backgroundAgent.available === null || backgroundShell.available === null ? 'host_inventory_required' : 'synchronous';
-}
-
-// Check recorded intervals only; this does not manufacture or verify host tool events.
-function auditAssetExecution(record, expectedTasks = []) {
-  const issues = [];
-  const add = (code, task = {}) => issues.push({ code, taskKey: task.taskKey || '', pageId: task.pageId || '' });
-  const text = value => typeof value === 'string' && value.trim().length > 0;
-  const time = value => typeof value === 'string' && /^\d{4}-\d\d-\d\dT.*(?:Z|[+-]\d\d:\d\d)$/.test(value) ? Date.parse(value) : NaN;
-  const interval = value => {
-    const start = time(value?.startedAt), end = time(value?.endedAt);
-    return Number.isFinite(start) && Number.isFinite(end) && end >= start ? { start, end } : null;
-  };
-  if (record === undefined || record === null) {
-    if (Array.isArray(expectedTasks) && expectedTasks.length) { add('execution_record_missing'); }
-    return { status: issues.length ? 'needs_review' : 'not_checked', issues };
-  }
-  if (!Array.isArray(record.tasks) || !Array.isArray(record.businessWork)) {
-    add('execution_record_invalid');
-    return { status: 'needs_review', issues };
-  }
-  for (const task of Array.isArray(expectedTasks) ? expectedTasks : []) {
-    if (!record.tasks.some(value => value?.taskKey && value.taskKey === task?.taskKey)) { add('task_record_missing', task || {}); }
-  }
-  const work = record.businessWork.map(interval);
-  if (work.some(value => !value)) { add('business_interval_invalid'); }
-  const independent = work.filter(Boolean);
-  const noIndependentWork = record.independentWork === 'none' && text(record.noIndependentWorkReason) && !record.businessWork.length;
-  const seen = new Set();
-  for (const value of record.tasks) {
-    const task = value || {};
-    if (!text(task.taskKey) || seen.has(task.taskKey)) { add('task_identity_invalid', task); }
-    seen.add(task.taskKey);
-    if (task.executionMode === 'reused' && task.status === 'completed' && text(task.reuseEvidence)) { continue; }
-    const run = interval(task);
-    if (!run || !['completed', 'partial', 'failed'].includes(task.status)) { add('asset_interval_incomplete', task); continue; }
-    if (!['background_agent', 'background_shell', 'synchronous'].includes(task.executionMode)) { add('execution_mode_unknown', task); continue; }
-    const returned = time(task.dispatchReturnedAt);
-    const overlapStart = task.executionMode !== 'synchronous' && Number.isFinite(returned) ? Math.max(run.start, returned) : run.start;
-    const overlap = independent.some(item => Math.max(item.start, overlapStart) < Math.min(item.end, run.end));
-    if (task.executionMode !== 'synchronous') {
-      if (!text(task.hostTaskId) || !text(task.toolName) || !text(task.backgroundOption)
-        || !Number.isFinite(returned) || returned < run.start || returned >= run.end) { add('background_dispatch_unproven', task); }
-      if (!overlap && !noIndependentWork) { add('asset_business_overlap_missing', task); }
-    } else {
-      if (!text(task.fallbackReason)) { add('synchronous_reason_missing', task); }
-      if (!noIndependentWork && !independent.some(item => item.start <= run.start)) { add('assets_before_business', task); }
-    }
-    if (task.claimedParallel === true && !overlap) { add('parallel_claim_unproven', task); }
-  }
-  if (issues.length) { return { status: 'needs_review', issues }; }
-  return { status: record.tasks.length ? 'verified' : 'not_applicable', issues, evidence: 'recorded_intervals_only' };
-}
-
-module.exports = { getAssetExecutionContract, selectAssetExecutionMode, auditAssetExecution };

package/lib/core/css-structure.js

@@ -1,37 +0,0 @@
-'use strict';
-
-/**
- * 检查静态 CSS 的括号、字符串和注释闭合；忽略转义及字面量中的括号。
- * 供页面编译和应用主题共用，不验证属性支持或浏览器渲染效果。
- */
-function findCssStructureIssue(css) {
-  const stack = [];
-  const pairs = { '(': ')', '[': ']', '{': '}' };
-  for (let index = 0; index < css.length; index++) {
-    const char = css[index];
-    if (char === '\\') { index++; continue; }
-    if (char === '/' && css[index + 1] === '*') {
-      const end = css.indexOf('*/', index + 2);
-      if (end < 0) { return { index, type: 'unclosed_comment' }; }
-      index = end + 1;
-    } else if (char === '"' || char === "'") {
-      const start = index;
-      for (index++; index < css.length; index++) {
-        if (css[index] === '\\') { index++; continue; }
-        if (css[index] === char) { break; }
-      }
-      if (index >= css.length) { return { index: start, type: 'unclosed_string' }; }
-    } else if (pairs[char]) {
-      stack.push({ char, index });
-    } else if (')]}'.includes(char)) {
-      const open = stack.pop();
-      if (!open || pairs[open.char] !== char) {
-        return { index: open ? open.index : index, type: 'mismatched_delimiter', expected: open && pairs[open.char], actual: char };
-      }
-    }
-  }
-  const open = stack.pop();
-  return open ? { index: open.index, type: 'unclosed_delimiter', expected: pairs[open.char] } : null;
-}
-
-module.exports = { findCssStructureIssue };

package/lib/design/check-design.js

@@ -1,51 +0,0 @@
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-const { CliError } = require('../core/cli-error');
-const { t } = require('../core/i18n');
-const { success } = require('../core/chalk');
-const { validateDesignDocument } = require('./document');
-
-function parseArgs(args = []) {
-  const options = { json: false, help: false };
-  for (let index = 0; index < args.length; index++) {
-    const arg = args[index];
-    if (arg === '--json') {options.json = true;}
-    else if (arg === '--help' || arg === '-h') {options.help = true;}
-    else if (['--prd', '--base-dir'].includes(arg) && args[index + 1] && !args[index + 1].startsWith('-')) {
-      const key = arg === '--prd' ? 'prd' : 'baseDir';
-      if (options[key]) {throw new CliError(t('design_document.usage'), { code: 'CHECK_DESIGN_USAGE' });}
-      options[key] = args[++index];
-    } else if (!arg.startsWith('-') && !options.design) {options.design = arg;}
-    else {throw new CliError(t('design_document.usage'), { code: 'CHECK_DESIGN_USAGE' });}
-  }
-  if (!options.help && !options.design) {throw new CliError(t('design_document.usage'), { code: 'CHECK_DESIGN_USAGE' });}
-  return options;
-}
-
-function readDocument(file) {
-  try {return fs.readFileSync(file, 'utf8');} catch (error) {
-    throw new CliError(t('design_document.read_error', file), {
-      code: 'CHECK_DESIGN_FILE_UNREADABLE', details: { file, reason: error.code },
-    });
-  }
-}
-
-async function run(args = []) {
-  const options = parseArgs(args);
-  if (options.help) {console.log(t('design_document.usage')); return;}
-  const designFile = path.resolve(options.design);
-  const prdFile = options.prd ? path.resolve(options.prd) : undefined;
-  const baseDir = path.resolve(options.baseDir || process.cwd());
-  const result = validateDesignDocument(readDocument(designFile), {
-    designFile, baseDir,
-    ...(prdFile ? { prdMarkdown: readDocument(prdFile) } : {}),
-  });
-  const output = { ...result, designFile, ...(prdFile ? { prdFile, baseDir } : {}) };
-  if (options.json) {console.log(JSON.stringify(output, null, 2));}
-  else {success(t('design_document.checked', result.name, result.pages.length, result.tokenCount));}
-  return output;
-}
-
-module.exports = { run, parseArgs };