@ohos-cpf/3rdloop 0.0.1 → 0.0.3

package/vendor/Server/Skills/rn-lib-update-doc/scripts/detect-readme-format.cjs

@@ -1,105 +1,105 @@
-#!/usr/bin/env node
-/**
- * Detect README documentation template format.
- * Usage: node detect-readme-format.js <lib-root> [--expect 0.4.2] [--file README.md]
- */
-const fs = require('fs');
-const path = require('path');
-
-const args = process.argv.slice(2);
-const libRoot = args.find((a) => !a.startsWith('--'));
-const expectIdx = args.indexOf('--expect');
-const expect = expectIdx >= 0 ? String(args[expectIdx + 1]).replace(/^v/, '') : '0.4.2';
-const fileIdx = args.indexOf('--file');
-const fileName = fileIdx >= 0 ? args[fileIdx + 1] : 'README.md';
-
-if (!libRoot) {
-  console.error('Usage: node detect-readme-format.js <lib-root> [--expect 0.4.2] [--file README.md]');
-  process.exit(1);
-}
-
-const readmePath = path.join(libRoot, fileName);
-if (!fs.existsSync(readmePath)) {
-  console.log(JSON.stringify({
-    path: readmePath,
-    exists: false,
-    kind: 'missing',
-    matchesExpect: false,
-    expect,
-    needsUsageDocsMigration: true,
-    isV041: false,
-    isExternalLink: false,
-  }, null, 2));
-  process.exit(0);
-}
-
-const text = fs.readFileSync(readmePath, 'utf8');
-const head = text.slice(0, 2500);
-const firstLine = (text.split(/\r?\n/).find((l) => l.trim()) || '').trim();
-
-const versionMatch =
-  firstLine.match(/文档模板\s*[：:]\s*v?(\d+\.\d+\.\d+)/i) ||
-  firstLine.match(/模板版本\s*[：:]\s*v?(\d+\.\d+\.\d+)/i) ||
-  firstLine.match(/Template version\s*[：:]\s*v?(\d+\.\d+\.\d+)/i) ||
-  firstLine.match(/Document template\s*[：:]\s*v?(\d+\.\d+\.\d+)/i);
-
-const declaredVersion = versionMatch ? versionMatch[1] : null;
-
-const hasNpmAddressCol = /\|[^|\n]*npm地址[^|\n]*\|/i.test(head) || /\|\s*npm Address\s*\|/i.test(head);
-const hasVersionNpmCol = /三方库版本（npm地址）/.test(head) || /Version\s*\(npm/i.test(head);
-const hasSourceCol = /源码地址/.test(head) || /\|\s*Source\s*\|/i.test(head) || /源码地址/.test(head);
-const hasDocUrlSection = /##\s*Documentation URL/i.test(text) || /Documentation URL/.test(head);
-const linkHeavy =
-  hasDocUrlSection &&
-  !/##\s*简介/.test(text) &&
-  !/##\s*下载安装/.test(text) &&
-  !/##\s*1\.\s*安装/.test(text) &&
-  (text.match(/https?:\/\//g) || []).length <= 8 &&
-  text.length < 1500;
-
-const hasIntro = /##\s*简介/.test(text) || /##\s*Introduction/i.test(text);
-const hasInstall = /##\s*下载安装/.test(text) || /##\s*Installation/i.test(text);
-const hasUsageGuide = /##\s*使用说明/.test(text) || /##\s*Usage Guide/i.test(text);
-const numberedInstall = /##\s*1\.\s*(安装|Installation)/i.test(text);
-
-let kind = 'unknown';
-if (linkHeavy || (hasDocUrlSection && !hasIntro && !numberedInstall)) {
-  kind = 'external_link';
-} else if (declaredVersion === '0.4.2' || (hasVersionNpmCol && hasSourceCol && hasUsageGuide)) {
-  kind = 'v0.4.2';
-} else if (declaredVersion === '0.4.1' || (hasIntro && hasInstall && hasNpmAddressCol && !hasVersionNpmCol)) {
-  kind = 'v0.4.1';
-} else if (declaredVersion === '0.4.0' || numberedInstall) {
-  kind = 'v0.4.0';
-} else if (declaredVersion) {
-  kind = `v${declaredVersion}`;
-}
-
-const matchesExpect = kind === `v${expect}`;
-const isV041 = kind === 'v0.4.1';
-const isExternalLink = kind === 'external_link';
-const needsUsageDocsMigration = !matchesExpect && !isV041;
-
-const result = {
-  path: readmePath,
-  exists: true,
-  kind,
-  declaredVersion,
-  matchesExpect,
-  expect,
-  isV041,
-  isExternalLink,
-  needsUsageDocsMigration,
-  signals: {
-    hasVersionNpmCol,
-    hasNpmAddressCol,
-    hasSourceCol,
-    hasIntro,
-    hasInstall,
-    hasUsageGuide,
-    numberedInstall,
-    hasDocUrlSection,
-  },
-};
-
-console.log(JSON.stringify(result, null, 2));
+#!/usr/bin/env node
+/**
+ * Detect README documentation template format.
+ * Usage: node detect-readme-format.js <lib-root> [--expect 0.4.2] [--file README.md]
+ */
+const fs = require('fs');
+const path = require('path');
+
+const args = process.argv.slice(2);
+const libRoot = args.find((a) => !a.startsWith('--'));
+const expectIdx = args.indexOf('--expect');
+const expect = expectIdx >= 0 ? String(args[expectIdx + 1]).replace(/^v/, '') : '0.4.2';
+const fileIdx = args.indexOf('--file');
+const fileName = fileIdx >= 0 ? args[fileIdx + 1] : 'README.md';
+
+if (!libRoot) {
+  console.error('Usage: node detect-readme-format.js <lib-root> [--expect 0.4.2] [--file README.md]');
+  process.exit(1);
+}
+
+const readmePath = path.join(libRoot, fileName);
+if (!fs.existsSync(readmePath)) {
+  console.log(JSON.stringify({
+    path: readmePath,
+    exists: false,
+    kind: 'missing',
+    matchesExpect: false,
+    expect,
+    needsUsageDocsMigration: true,
+    isV041: false,
+    isExternalLink: false,
+  }, null, 2));
+  process.exit(0);
+}
+
+const text = fs.readFileSync(readmePath, 'utf8');
+const head = text.slice(0, 2500);
+const firstLine = (text.split(/\r?\n/).find((l) => l.trim()) || '').trim();
+
+const versionMatch =
+  firstLine.match(/文档模板\s*[：:]\s*v?(\d+\.\d+\.\d+)/i) ||
+  firstLine.match(/模板版本\s*[：:]\s*v?(\d+\.\d+\.\d+)/i) ||
+  firstLine.match(/Template version\s*[：:]\s*v?(\d+\.\d+\.\d+)/i) ||
+  firstLine.match(/Document template\s*[：:]\s*v?(\d+\.\d+\.\d+)/i);
+
+const declaredVersion = versionMatch ? versionMatch[1] : null;
+
+const hasNpmAddressCol = /\|[^|\n]*npm地址[^|\n]*\|/i.test(head) || /\|\s*npm Address\s*\|/i.test(head);
+const hasVersionNpmCol = /三方库版本（npm地址）/.test(head) || /Version\s*\(npm/i.test(head);
+const hasSourceCol = /源码地址/.test(head) || /\|\s*Source\s*\|/i.test(head) || /源码地址/.test(head);
+const hasDocUrlSection = /##\s*Documentation URL/i.test(text) || /Documentation URL/.test(head);
+const linkHeavy =
+  hasDocUrlSection &&
+  !/##\s*简介/.test(text) &&
+  !/##\s*下载安装/.test(text) &&
+  !/##\s*1\.\s*安装/.test(text) &&
+  (text.match(/https?:\/\//g) || []).length <= 8 &&
+  text.length < 1500;
+
+const hasIntro = /##\s*简介/.test(text) || /##\s*Introduction/i.test(text);
+const hasInstall = /##\s*下载安装/.test(text) || /##\s*Installation/i.test(text);
+const hasUsageGuide = /##\s*使用说明/.test(text) || /##\s*Usage Guide/i.test(text);
+const numberedInstall = /##\s*1\.\s*(安装|Installation)/i.test(text);
+
+let kind = 'unknown';
+if (linkHeavy || (hasDocUrlSection && !hasIntro && !numberedInstall)) {
+  kind = 'external_link';
+} else if (declaredVersion === '0.4.2' || (hasVersionNpmCol && hasSourceCol && hasUsageGuide)) {
+  kind = 'v0.4.2';
+} else if (declaredVersion === '0.4.1' || (hasIntro && hasInstall && hasNpmAddressCol && !hasVersionNpmCol)) {
+  kind = 'v0.4.1';
+} else if (declaredVersion === '0.4.0' || numberedInstall) {
+  kind = 'v0.4.0';
+} else if (declaredVersion) {
+  kind = `v${declaredVersion}`;
+}
+
+const matchesExpect = kind === `v${expect}`;
+const isV041 = kind === 'v0.4.1';
+const isExternalLink = kind === 'external_link';
+const needsUsageDocsMigration = !matchesExpect && !isV041;
+
+const result = {
+  path: readmePath,
+  exists: true,
+  kind,
+  declaredVersion,
+  matchesExpect,
+  expect,
+  isV041,
+  isExternalLink,
+  needsUsageDocsMigration,
+  signals: {
+    hasVersionNpmCol,
+    hasNpmAddressCol,
+    hasSourceCol,
+    hasIntro,
+    hasInstall,
+    hasUsageGuide,
+    numberedInstall,
+    hasDocUrlSection,
+  },
+};
+
+console.log(JSON.stringify(result, null, 2));

package/vendor/Server/Skills/rn-lib-update-doc/scripts/find-usage-doc.cjs

@@ -1,90 +1,90 @@
-#!/usr/bin/env node
-/**
- * Locate zh/en docs for a library inside usage-docs (local or remote URLs).
- * Usage: node find-usage-doc.js --lib-path <lib-root> [--usage-docs <path>]
- */
-const fs = require('fs');
-const path = require('path');
-
-function parseArgs(argv) {
-  const out = {};
-  for (let i = 0; i < argv.length; i++) {
-    if (argv[i] === '--lib-path') out.libPath = argv[++i];
-    else if (argv[i] === '--usage-docs') out.usageDocs = argv[++i];
-  }
-  return out;
-}
-
-function readConfig() {
-  const cfgPath = path.resolve(__dirname, '..', 'config.json');
-  if (!fs.existsSync(cfgPath)) return {};
-  return JSON.parse(fs.readFileSync(cfgPath, 'utf8'));
-}
-
-function candidateNames(libRoot) {
-  const names = [];
-  const pkgPath = path.join(libRoot, 'package.json');
-  if (fs.existsSync(pkgPath)) {
-    const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
-    if (pkg.harmony && pkg.harmony.alias) names.push(pkg.harmony.alias);
-    if (pkg.name) {
-      names.push(pkg.name.includes('/') ? pkg.name.split('/').pop() : pkg.name);
-    }
-  }
-  const base = path.basename(libRoot);
-  names.push(base);
-  if (base.startsWith('rntpc_')) names.push(base.slice('rntpc_'.length));
-  return [...new Set(names.filter(Boolean))];
-}
-
-const args = parseArgs(process.argv.slice(2));
-if (!args.libPath) {
-  console.error('Usage: node find-usage-doc.js --lib-path <lib-root> [--usage-docs <path>]');
-  process.exit(1);
-}
-
-const cfg = readConfig();
-const usageDocs =
-  args.usageDocs ||
-  (cfg.usageDocsPath && fs.existsSync(cfg.usageDocsPath) ? cfg.usageDocsPath : null);
-const remote = cfg.remoteUsageDocs || 'https://gitcode.com/CPF-RN/usage-docs';
-const branch = cfg.remoteDefaultBranch || 'master';
-const candidates = candidateNames(path.resolve(args.libPath));
-
-const hits = [];
-if (usageDocs) {
-  for (const name of candidates) {
-    const zh = path.join(usageDocs, 'zh-cn', `${name}.md`);
-    const en = path.join(usageDocs, 'en', `${name}.md`);
-    if (fs.existsSync(zh) || fs.existsSync(en)) {
-      hits.push({
-        name,
-        zh: fs.existsSync(zh) ? zh : null,
-        en: fs.existsSync(en) ? en : null,
-      });
-    }
-  }
-}
-
-const remoteUrls = candidates.map((name) => ({
-  name,
-  zh: `${remote.replace(/\/$/, '')}/raw/${branch}/zh-cn/${name}.md`,
-  en: `${remote.replace(/\/$/, '')}/raw/${branch}/en/${name}.md`,
-}));
-
-const result = {
-  libPath: path.resolve(args.libPath),
-  usageDocsPath: usageDocs,
-  hasLocal: Boolean(usageDocs),
-  candidates,
-  localHits: hits,
-  preferredLocal: hits[0] || null,
-  remoteUrls,
-  preferredRemote: remoteUrls[0] || null,
-};
-
-console.log(JSON.stringify(result, null, 2));
-if (usageDocs && hits.length === 0) {
-  console.error('[find-usage-doc] No local doc matched candidates; try remoteUrls or check alias.');
-  process.exitCode = 2;
-}
+#!/usr/bin/env node
+/**
+ * Locate zh/en docs for a library inside usage-docs (local or remote URLs).
+ * Usage: node find-usage-doc.js --lib-path <lib-root> [--usage-docs <path>]
+ */
+const fs = require('fs');
+const path = require('path');
+
+function parseArgs(argv) {
+  const out = {};
+  for (let i = 0; i < argv.length; i++) {
+    if (argv[i] === '--lib-path') out.libPath = argv[++i];
+    else if (argv[i] === '--usage-docs') out.usageDocs = argv[++i];
+  }
+  return out;
+}
+
+function readConfig() {
+  const cfgPath = path.resolve(__dirname, '..', 'config.json');
+  if (!fs.existsSync(cfgPath)) return {};
+  return JSON.parse(fs.readFileSync(cfgPath, 'utf8'));
+}
+
+function candidateNames(libRoot) {
+  const names = [];
+  const pkgPath = path.join(libRoot, 'package.json');
+  if (fs.existsSync(pkgPath)) {
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+    if (pkg.harmony && pkg.harmony.alias) names.push(pkg.harmony.alias);
+    if (pkg.name) {
+      names.push(pkg.name.includes('/') ? pkg.name.split('/').pop() : pkg.name);
+    }
+  }
+  const base = path.basename(libRoot);
+  names.push(base);
+  if (base.startsWith('rntpc_')) names.push(base.slice('rntpc_'.length));
+  return [...new Set(names.filter(Boolean))];
+}
+
+const args = parseArgs(process.argv.slice(2));
+if (!args.libPath) {
+  console.error('Usage: node find-usage-doc.js --lib-path <lib-root> [--usage-docs <path>]');
+  process.exit(1);
+}
+
+const cfg = readConfig();
+const usageDocs =
+  args.usageDocs ||
+  (cfg.usageDocsPath && fs.existsSync(cfg.usageDocsPath) ? cfg.usageDocsPath : null);
+const remote = cfg.remoteUsageDocs || 'https://gitcode.com/CPF-RN/usage-docs';
+const branch = cfg.remoteDefaultBranch || 'master';
+const candidates = candidateNames(path.resolve(args.libPath));
+
+const hits = [];
+if (usageDocs) {
+  for (const name of candidates) {
+    const zh = path.join(usageDocs, 'zh-cn', `${name}.md`);
+    const en = path.join(usageDocs, 'en', `${name}.md`);
+    if (fs.existsSync(zh) || fs.existsSync(en)) {
+      hits.push({
+        name,
+        zh: fs.existsSync(zh) ? zh : null,
+        en: fs.existsSync(en) ? en : null,
+      });
+    }
+  }
+}
+
+const remoteUrls = candidates.map((name) => ({
+  name,
+  zh: `${remote.replace(/\/$/, '')}/raw/${branch}/zh-cn/${name}.md`,
+  en: `${remote.replace(/\/$/, '')}/raw/${branch}/en/${name}.md`,
+}));
+
+const result = {
+  libPath: path.resolve(args.libPath),
+  usageDocsPath: usageDocs,
+  hasLocal: Boolean(usageDocs),
+  candidates,
+  localHits: hits,
+  preferredLocal: hits[0] || null,
+  remoteUrls,
+  preferredRemote: remoteUrls[0] || null,
+};
+
+console.log(JSON.stringify(result, null, 2));
+if (usageDocs && hits.length === 0) {
+  console.error('[find-usage-doc] No local doc matched candidates; try remoteUrls or check alias.');
+  process.exitCode = 2;
+}