@dsh-workbench/shared 1.1.1 → 1.1.3

package/src/i18n/zh.ts

@@ -255,6 +255,7 @@ export const zh = {
   'panels.market.add.failureInstalled':
     '它已经装在这份工作台里了。同一个包不能就地覆盖，得先卸载再装；这次卸载也没成功。',
   'panels.market.add.failureGeneric': '安装过程中出错，原因见安装详情',
+  'panels.market.add.failureCredentials': '这个仓库要凭证：本机没有它的 git 凭据。先在终端里 clone 一次、配好凭据助手，或改用 SSH 地址，再装一次。',
   'panels.market.add.approveTitle': '需要你允许安装脚本',
   'panels.market.add.approveCaution': '只允许你信得过的包：安装脚本会以你的权限在这台机器上运行。',
   'panels.market.add.approveRun': '允许并继续安装',
@@ -296,10 +297,16 @@ export const zh = {
   'panels.discover.addingSource': '正在添加…',
   'panels.discover.addFirstSource': '添加索引源',
   'panels.discover.removeSource': '移除',
-  'panels.discover.removeSourceNamed': '移除 {url}',
-  'panels.discover.useSource': '使用',
-  'panels.discover.useSourceNamed': '使用 {label}',
-  'panels.discover.sourceCurrent': '当前使用',
+  'panels.discover.removeTitle': '移除这个索引源？',
+  'panels.discover.removeBody': '会把「{label}」从这份列表里移除；仓库本身不会被删，之后还能再添加。',
+  'panels.discover.sourceActions': '「{label}」的操作',
+  'panels.discover.sourceStateWritable': '可发布',
+  'panels.discover.sourceStateReadOnly': '仅读取模块列表',
+  'panels.discover.sourceEnable': '设为可发布',
+  'panels.discover.sourceDisable': '设为只读',
+  'panels.discover.sourceWorking': '设置中…',
+  'panels.discover.sourceEnabled': '已把「{label}」设为可发布',
+  'panels.discover.sourceReadOnly': '已把「{label}」设为只读',
   'panels.discover.refresh': '刷新',
   'panels.discover.search': '搜索模块',
   'panels.discover.clearSearch': '清除搜索',
@@ -321,12 +328,13 @@ export const zh = {
   'panels.discover.noSourceHint': '添加一个模块市场索引（http 地址或 git 仓库），即可在这里浏览和安装其中的模块',
   'panels.discover.sourcesFailed': '无法读取索引源',
   'panels.discover.unreadable': '无法读取此索引',
+  'panels.discover.sourceAuth': '这个索引源读不了：本机没有它的 git 凭据。配好凭据（或在源里改用 SSH 地址），再点右上角的刷新。',
   'panels.discover.invalid': '此索引的格式无效',
   'panels.discover.emptyRepo': '这个仓库还没有任何提交',
   'panels.discover.missingIndex': '仓库里还没有索引文件 {path}',
   'panels.discover.initTitle': '把这个仓库初始化成模块市场索引？',
   'panels.discover.initCta': '初始化成市场索引',
-  'panels.discover.initWhat': '会在 {branch} 分支写 market.json 与 README.md，提交一次并推上去；之后从这个工作台发布的模块会把打包好的文件提交到 packages/<unit>/。仓库的写权限归它的所有者。',
+  'panels.discover.initWhat': '会在 {branch} 分支写 market.json 与 README.md，提交一次并推上去；之后从这个工作台发布的模块会把打包好的文件提交到按包名分的 packages/<包名>/。仓库的写权限归它的所有者。',
   'panels.discover.initBranch': '分支',
   'panels.discover.initBranchHint': '索引和打包文件都发到这个分支；空仓库会新建它。',
   'panels.discover.initBranchBad': '分支名只能用字母、数字、点、下划线、斜杠或短横线',
@@ -344,8 +352,23 @@ export const zh = {
   'panels.discover.badShellDetail': '此版本与当前的工作台 {current} 不兼容，它要求 {peer}',
   'panels.discover.unverified': '工作台未验证',
   'panels.discover.installing': '正在安装…',
+  'panels.discover.installingNamed': '正在安装「{name}」…',
+  'panels.discover.cancelInstall': '取消安装',
+  'panels.discover.cancelling': '正在取消…',
+  'panels.discover.installCancelled': '已取消安装：{name}',
   'panels.discover.installedDone': '装好了：{name}',
   'panels.discover.failed': '操作失败：{reason}',
+  'panels.discover.transportTitle': '从哪读这个仓库',
+  'panels.discover.transportSsh': 'SSH',
+  'panels.discover.transportHttps': 'HTTPS',
+  'panels.discover.transportOk': '能读',
+  'panels.discover.transportAuth': '要凭证',
+  'panels.discover.transportUnreachable': '连不上',
+  'panels.discover.transportUnknown': '没探成',
+  'panels.discover.transportChecking': '正在探测…',
+  'panels.discover.transportTest': '试这个地址',
+  'panels.discover.transportPlaceholder': '或贴一个别的地址（公司镜像、别名）',
+  'panels.discover.transportNeedsAuth': '这个仓库要凭证：先在终端里把它 clone 一次，或配好 SSH key / 凭据助手；配好后再点安装。',
   'panels.discover.expand': '展开版本',
   'panels.discover.collapse': '收起版本',
   'panels.discover.versionCount': '{n} 个版本',
@@ -642,6 +665,13 @@ export const zh = {
   'approval.publish.version': '版本',
   'approval.publish.author': '作者',
   'approval.publish.authorMissing': '未署名',
+  'approval.publish.owner': '认领人',
+  'approval.publish.ownerUnowned': '原来没署名',
+  'approval.publish.ownerTaken': '已有主人：{owner}',
+  'approval.publish.unit': '模块 id',
+  'approval.publish.unitTaken': '已被 {entry} 占用',
+  'approval.publish.path': '产物目录',
+  'approval.publish.pathTaken': '已被 {entry} 占用',
   'approval.publish.registry': '源',
   'approval.publish.repo': '仓库',
   'approval.publish.branch': '分支',
@@ -652,6 +682,7 @@ export const zh = {
   'approval.publish.twoCommits': '打包文件 + market.json 两次提交，一次推送',
   'approval.publish.reading': '读取中…',
   'approval.publish.changelog': '{version} 的更新日志',
+  'approval.publish.changelogPending': '{version} 这一版会写进更新日志，随包发布',
   'approval.publish.changelogMissing': '这一版还没有更新日志（{version}），发布会被拦下',
   'approval.publish.targetAuto': '按配置默认',
   'approval.publish.targetTeam': '团队源',
@@ -660,6 +691,15 @@ export const zh = {
   'approval.publish.targetGit': 'git 仓库',
   'approval.publish.targetMarket': '模块市场索引',
   'approval.publish.targetLocal': '留在本机',
+  'approval.market.source': '索引源',
+  'approval.market.url': '地址',
+  'approval.market.action': '这次操作',
+  'approval.market.policy': '当前状态',
+  'approval.market.enable': '设为可发布',
+  'approval.market.disable': '改回只读',
+  'approval.market.writable': '可发布',
+  'approval.market.readOnly': '仅读取模块列表',
+  'approval.market.reading': '正在读取…',
   'markdown.copy': '复制',
   'markdown.copied': '已复制',
   'markdown.footnotes': '脚注',

package/src/index.ts

@@ -66,6 +66,7 @@ export * from './i18n/settings.js';
 export * from './i18n/zh.js';
 export * from './lib/blocker-action.js';
 export * from './lib/market-index.js';
+export * from './lib/git-address.js';
 export * from './lib/board-fact.js';
 export * from './lib/busy.js';
 export * from './lib/dsh-client.js';

package/src/lib/git-address.test.ts

@@ -0,0 +1,63 @@
+import { describe, expect, it } from 'vitest';
+import { gitAddressOf, gitAddressText, gitTransportCandidates } from './git-address.js';
+
+describe('git 地址的两种读法', () => {
+  it('https 原样留着，另一条推成 ssh://', () => {
+    expect(gitTransportCandidates('https://e.coding.net/org/repo.git')).toEqual([
+      { kind: 'https', url: 'https://e.coding.net/org/repo.git' },
+      { kind: 'ssh', url: 'ssh://git@e.coding.net/org/repo.git' },
+    ]);
+  });
+
+  it('scp 写法当 ssh，并规范成 ssh://（pnpm 只认这个）', () => {
+    expect(gitTransportCandidates('git@e.coding.net:org/repo.git')).toEqual([
+      { kind: 'ssh', url: 'ssh://git@e.coding.net/org/repo.git' },
+      { kind: 'https', url: 'https://e.coding.net/org/repo.git' },
+    ]);
+  });
+
+  it('git+ 前缀先剥掉，别带进 spec', () => {
+    expect(gitTransportCandidates('git+https://host/org/repo.git')[0]).toEqual({
+      kind: 'https',
+      url: 'https://host/org/repo.git',
+    });
+  });
+
+  it('端口只留在它本来那一种上，另一种回到默认端口', () => {
+    expect(gitTransportCandidates('ssh://git@host:2222/org/repo.git')).toEqual([
+      { kind: 'ssh', url: 'ssh://git@host:2222/org/repo.git' },
+      { kind: 'https', url: 'https://host/org/repo.git' },
+    ]);
+    expect(gitTransportCandidates('https://host:8443/org/repo.git')).toEqual([
+      { kind: 'https', url: 'https://host:8443/org/repo.git' },
+      { kind: 'ssh', url: 'ssh://git@host/org/repo.git' },
+    ]);
+  });
+
+  it('http 的仓库留着 http，别替发布者升到 https', () => {
+    expect(gitTransportCandidates('http://host/org/repo.git')[0]).toEqual({
+      kind: 'https',
+      url: 'http://host/org/repo.git',
+    });
+  });
+
+  it('拆得开要拆对，拆不开给 undefined', () => {
+    expect(gitAddressOf('https://host/a/b.git')).toEqual({ kind: 'https', host: 'host', path: 'a/b.git' });
+    expect(gitAddressOf('ssh://git@host:2222/a/b.git')).toEqual({
+      kind: 'ssh',
+      host: 'host',
+      path: 'a/b.git',
+      user: 'git',
+      port: 2222,
+    });
+    expect(gitAddressOf('git@host:a/b.git')).toEqual({ kind: 'ssh', host: 'host', path: 'a/b.git', user: 'git' });
+    expect(gitAddressOf('https://host/')).toBeUndefined();
+    expect(gitAddressOf('ftp://host/a.git')).toBeUndefined();
+    expect(gitAddressOf('')).toBeUndefined();
+  });
+
+  it('拼回去是规范写法，用户名缺省补 git', () => {
+    expect(gitAddressText({ kind: 'ssh', host: 'h', path: 'a/b.git' })).toBe('ssh://git@h/a/b.git');
+    expect(gitAddressText({ kind: 'https', host: 'h', path: 'a/b.git', port: 8443 })).toBe('https://h:8443/a/b.git');
+  });
+});

package/src/lib/git-address.ts

@@ -0,0 +1,92 @@
+export interface GitAddress {
+  readonly kind: 'https' | 'ssh';
+  readonly host: string;
+  readonly path: string;
+  readonly user?: string;
+  readonly port?: number;
+}
+
+export interface GitTransportCandidate {
+  readonly kind: 'https' | 'ssh';
+  readonly url: string;
+}
+
+const SCP = /^(?:([A-Za-z0-9._-]+)@)?([A-Za-z0-9.-]+):(?!\/)(\S+)$/;
+
+function bare(url: string): string {
+  return url.trim().replace(/^git\+/, '');
+}
+
+function pathOf(pathname: string): string {
+  return pathname.replace(/^\/+/, '').replace(/\/+$/, '');
+}
+
+/**
+ * 把一个 git 地址拆成「哪台主机 + 哪个路径」，不管发布者当初用的是 https、ssh 还是
+ * scp 那种 `git@host:path` 写法；认不出来给 undefined。
+ */
+export function gitAddressOf(url: string): GitAddress | undefined {
+  const text = bare(url);
+  if (text === '') return undefined;
+  if (text.includes('://')) {
+    let parsed: URL;
+    try {
+      parsed = new URL(text);
+    } catch {
+      return undefined;
+    }
+    if (parsed.protocol !== 'https:' && parsed.protocol !== 'http:' && parsed.protocol !== 'ssh:') {
+      return undefined;
+    }
+    const path = pathOf(parsed.pathname);
+    if (path === '') return undefined;
+    const port = parsed.port === '' ? undefined : Number(parsed.port);
+    const shared = {
+      host: parsed.hostname,
+      path,
+      ...(port === undefined ? {} : { port }),
+    };
+    if (parsed.protocol !== 'ssh:') return { kind: 'https', ...shared };
+    return { kind: 'ssh', ...shared, ...(parsed.username === '' ? {} : { user: parsed.username }) };
+  }
+  const scp = SCP.exec(text);
+  if (scp === null) return undefined;
+  const path = pathOf(scp[3] ?? '');
+  if (path === '') return undefined;
+  return {
+    kind: 'ssh',
+    host: scp[2] ?? '',
+    path,
+    ...(scp[1] === undefined ? {} : { user: scp[1] }),
+  };
+}
+
+/** 一份地址的规范写法：ssh 一律成 `ssh://user@host/path`（pnpm 认这个），https 原样。 */
+export function gitAddressText(address: GitAddress): string {
+  const port = address.port === undefined ? '' : `:${String(address.port)}`;
+  if (address.kind === 'ssh') {
+    return `ssh://${address.user === undefined || address.user === '' ? 'git' : address.user}@${address.host}${port}/${address.path}`;
+  }
+  return `https://${address.host}${port}/${address.path}`;
+}
+
+/**
+ * 同一个仓库的两种读法，发布者用的那种排前面。ssh 那条一律规范成 `ssh://` 形式，
+ * 因为 `git@host:path` 拼进安装 spec 时 pnpm 不认；https 那条保留发布者的原样（含 http）。
+ */
+export function gitTransportCandidates(url: string): readonly GitTransportCandidate[] {
+  const address = gitAddressOf(url);
+  if (address === undefined) {
+    const only = bare(url);
+    return only === '' ? [] : [{ kind: only.startsWith('ssh') ? 'ssh' : 'https', url: only }];
+  }
+  const primary: GitTransportCandidate = {
+    kind: address.kind,
+    url: address.kind === 'ssh' ? gitAddressText(address) : bare(url),
+  };
+  const other: GitTransportCandidate =
+    address.kind === 'https'
+      ? { kind: 'ssh', url: gitAddressText({ kind: 'ssh', host: address.host, path: address.path }) }
+      : { kind: 'https', url: gitAddressText({ kind: 'https', host: address.host, path: address.path }) };
+  return other.url === primary.url ? [primary] : [primary, other];
+}