@applift/core 0.3.0 → 0.5.0

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { $ as rnAdapter, A as StoreConfigSchema, B as StageResult, C as CredentialsProfile, D as ProjectConfig, E as GlobalConfigSchema, F as ChannelContext, G as detectBundleIds, H as BundleIds, I as ChannelEvent, J as findArtifacts, K as detectFramework, L as ChannelRegistry, M as StoresSchema, N as Channel, O as ProjectConfigSchema, P as ChannelCapabilities, Q as nativeIosAdapter, R as ReleasePlanEntry, S as CredentialsFileSchema, T as GlobalConfig, U as FrameworkAdapter, V as SubmitResult, W as Platform, X as nativeAndroidAdapter, Y as flutterAdapter, Z as nativeHarmonyAdapter, _ as appendEntry, a as QypubUserConfig, b as BetaConfigSchema, c as PipelineInput, d as runStage, et as tauriAdapter, f as runSubmit, g as HistoryQuery, h as HistoryEvent, i as QypubPlugin, j as Stores, k as StoreConfig, l as PipelineSummary, m as HistoryEntry, n as PluginHookName, o as defineConfig, p as HISTORY_PATH, q as electronAdapter, r as PluginHost, s as resolvePlugins, t as HookContext, u as PipelineSummaryEntry, v as readEntries, w as CredentialsProfileSchema, x as CredentialsFile, y as BetaConfig, z as ReviewStatus } from "./plugin-DzhwzVfu.mjs";
+import { $ as electronAdapter, A as ReleaseConfigSchema, B as ChannelCapabilities, C as CredentialsProfile, D as ProjectConfig, E as GlobalConfigSchema, F as VersionCodeConfig, G as ReviewStatus, H as ChannelEvent, I as VersionCodeConfigSchema, J as BundleIds, K as StageResult, L as VersionConfig, M as StoreConfigSchema, N as Stores, O as ProjectConfigSchema, P as StoresSchema, Q as detectFramework, R as VersionConfigSchema, S as CredentialsFileSchema, T as GlobalConfig, U as ChannelRegistry, V as ChannelContext, W as ReleasePlanEntry, X as Platform, Y as FrameworkAdapter, Z as detectBundleIds, _ as appendEntry, a as QypubUserConfig, at as rnAdapter, b as BetaConfigSchema, c as PipelineInput, d as runStage, et as findArtifacts, f as runSubmit, g as HistoryQuery, h as HistoryEvent, i as QypubPlugin, it as nativeIosAdapter, j as StoreConfig, k as ReleaseConfig, l as PipelineSummary, m as HistoryEntry, n as PluginHookName, nt as nativeAndroidAdapter, o as defineConfig, ot as tauriAdapter, p as HISTORY_PATH, q as SubmitResult, r as PluginHost, rt as nativeHarmonyAdapter, s as resolvePlugins, t as HookContext, tt as flutterAdapter, u as PipelineSummaryEntry, v as readEntries, w as CredentialsProfileSchema, x as CredentialsFile, y as BetaConfig, z as Channel } from "./plugin-CTt0LO8c.mjs";
 //#region src/registry.d.ts
 export declare class DefaultChannelRegistry implements ChannelRegistry {
   private readonly channels;
@@ -321,6 +321,7 @@ export declare class AgcHarmonyChannel implements Channel {
     "1003": string;
     "204144702": string;
     "204144677": string;
+    "204144692": string;
   };
   private authHeaders;
   /** appId 缺省时按 bundleName 查（v1 全链路 step 0，可选） */
@@ -402,7 +403,184 @@ export declare function sha256File(filePath: string): string;
  */
 export declare function humanizeError(hints: Record<string, string> | undefined, message: string): string;
 //#endregion
-//#region src/version.d.ts
+//#region src/version/project.d.ts
+export type VersionFileKind = "gradle" | "pbxproj" | "app-json5" | "pubspec" | "package-json" | "tauri" | "expo-app-json";
+export interface PlatformVersionInfo {
+  platform: string;
+  versionName?: string;
+  versionCode?: string;
+  file: string;
+  kind: VersionFileKind;
+  /** 非标准形态说明（读出但不代写，提示改造） */
+  problem?: string;
+}
+export interface VersionWrite {
+  platform: string;
+  versionName: string;
+  versionCode: number;
+}
+/** 各端版本实况（按框架布局；未识别框架时尝试全部标准位置） */
+export declare function readProjectVersions(cwd: string, framework: FrameworkAdapter | null): PlatformVersionInfo[];
+/**
+ * 写回各端版本（多端 versionName 同步、versionCode 各端独立）。
+ * 返回实际改动的文件列表（commit 范围）。problem 端跳过并在返回中列出（不阻断其他端）。
+ */
+export declare function writeProjectVersions(cwd: string, framework: FrameworkAdapter | null, writes: VersionWrite[]): {
+  changed: string[];
+  skipped: Array<{
+    platform: string;
+    reason: string;
+  }>;
+};
+//#endregion
+//#region src/version/infer.d.ts
+export type BumpLevel = "major" | "minor" | "patch";
+export interface InferResult {
+  level: BumpLevel;
+  /** 展示用判定说明（中文，CLI 直接输出） */
+  reason: string;
+  total: number;
+  breaking: number;
+  feat: number;
+  fix: number;
+}
+/** conventional commits → bump level：BREAKING > feat(minor) > fix(patch)；无可识别提交 → patch */
+export declare function inferBumpLevel(messages: string[]): InferResult;
+export interface DecideOptions {
+  /** 显式 level：major | minor | patch | prerelease */
+  level?: string;
+  /** prerelease 标识（beta | rc…），与 level 组合或延续当前 */
+  pre?: string;
+}
+export interface DecideResult {
+  /** 完整 semver（可含 prerelease，tag 与 changelog 用） */
+  next: string;
+  /** 判定说明 */
+  reason: string;
+}
+/**
+ * 从当前版本决定下一版本（纯函数）。
+ * - 显式 level：semver.inc；当前是 prerelease 且不带 --pre → 剥离转正式（4.0.0-beta.3 + patch → 4.0.0）
+ * - 无 level：用 infer 结果
+ * - prerelease level：当前有 pre → 同基线递进（beta.3 → beta.4）；无 pre → 报错（应使用 --pre 进入）
+ * - --pre：从 level 出发挂 prerelease（4.0.0 + minor + beta → 4.1.0-beta.1）
+ * current 非 semver 时抛错（调用方要求显式指定或先手动规范化）。
+ */
+export declare function decideNextVersion(current: string, opts: DecideOptions, infer?: InferResult): DecideResult;
+/** 工程文件写入用的三段数字 versionName（prerelease 只留在 tag，不进商店） */
+export declare function storeVersionName(full: string): string;
+//#endregion
+//#region src/version/bump.d.ts
+export interface BumpOptions {
+  cwd: string;
+  framework: FrameworkAdapter | null;
+  /** major | minor | patch | prerelease | <semver>；缺省走推断 */
+  level?: string;
+  /** prerelease 标识（beta | rc…） */
+  pre?: string;
+  versionCode?: VersionCodeConfig;
+  /** 仅限端（缺省全端）；平台名 = android/ios/harmony/flutter/js/tauri/expo */
+  platforms?: string[];
+}
+export interface BumpPlan {
+  anchorTag?: string;
+  /** 疑似失败重跑（HEAD 是 release commit 且锚点后无新业务提交）——CLI 在 --yes 且无显式 level 时拒绝 */
+  suspectRerun?: boolean;
+  /** 基线版本（多端中最大 semver） */
+  base: string;
+  currentVersions: PlatformVersionInfo[];
+  /** 完整 semver（tag/changelog 用，可含 prerelease） */
+  nextVersion: string;
+  /** 商店 versionName（三段数字，工程文件用） */
+  storeName: string;
+  reason: string;
+  infer?: InferResult;
+  commits: string[];
+  writes: VersionWrite[];
+  versionCodeNote: string;
+}
+export declare function planBump(opts: BumpOptions): BumpPlan;
+export interface ApplyOptions {
+  /** 代 commit（默认 true；--no-commit 跳过） */
+  commit: boolean;
+  /** 代打 tag（默认 true；--no-tag 跳过） */
+  tag: boolean;
+}
+export interface ApplyResult {
+  changedFiles: string[];
+  skipped: Array<{
+    platform: string;
+    reason: string;
+  }>;
+  changelogFile?: string;
+  committed: boolean;
+  tagged: boolean;
+  /** commit/tag 失败原因（降级不阻断：文件已写好，提示用户手动收尾） */
+  warnings: string[];
+}
+export declare function applyBump(cwd: string, plan: BumpPlan, framework: FrameworkAdapter | null, opts: ApplyOptions): ApplyResult;
+//#endregion
+//#region src/version/version-code.d.ts
+/**
+ * versionCode 计算：默认递增 +1；可配公式（如 major*1000000+minor*1000+patch）。
+ * 实际写入 = max(公式值, 现值+1)——公式在同 versionName 重发时算出同值，
+ * +1 兜底保证单调（AGC 同版本不能重复提交 / Google Play 单调 / App Store 单调）。
+ */
+/** 公式白名单求值（仅支持 + - * ( ) 数字 与 major/minor/patch 变量；不 eval） */
+export declare function evalVersionCodeFormula(formula: string, v: {
+  major: number;
+  minor: number;
+  patch: number;
+}): number | undefined;
+/**
+ * 下一 versionCode：max(公式值, 现值+1)。
+ * - 无现值（首接工程无该字段）：公式值，否则 1
+ * - 有现值：至少现值+1（吞 3052/4000000 等任意历史值，首次 bump 即归一）
+ */
+export declare function nextVersionCode(current: number | undefined, formulaValue: number | undefined): number;
+//#endregion
+//#region src/version/changelog.d.ts
+export interface ChangelogEntry {
+  type: string;
+  scope?: string;
+  subject: string;
+  breaking: boolean;
+  hash?: string;
+}
+/** raw commit messages → 结构化条目（feat/fix/BREAKING 之外的 type 也保留，渲染时归类） */
+export declare function toChangelogEntries(messages: string[]): ChangelogEntry[];
+/** 渲染单个版本段落（## [4.1.0] - 2026-10-17） */
+export declare function renderChangelogSection(version: string, date: string, entries: ChangelogEntry[]): string;
+/**
+ * 插入/替换 CHANGELOG.md 的版本段落（幂等）：
+ * - 已有 `## [version]` → 整段替换为最新渲染
+ * - 否则插到首个 # Changelog 标题之后；无标题/无文件 → 新建带标题
+ * 返回写入路径；entries 为空也写入 heading（bump 闭环保持 tag ↔ changelog 对齐）。
+ */
+export declare function upsertChangelog(cwd: string, version: string, section: string): string;
+//#endregion
+//#region src/version/git.d.ts
+export interface GitResult {
+  ok: boolean;
+  stdout: string;
+  stderr: string;
+}
+export declare function git(cwd: string, args: string[]): GitResult;
+export declare function isGitRepo(cwd: string): boolean;
+/** 宽松 semver 解析（可选 v/前缀，如 v4.1.0 / 4.1.0-beta.3 / release-4.1.0 里取 semver 部分） */
+export declare function looseSemver(tag: string): string | undefined;
+/**
+ * 最新 semver tag（按版本序取最大，非创建时间——修复补打旧版本 tag 的场景更稳）。
+ * 无 tag / 非 git 仓库返回 undefined。
+ */
+export declare function latestSemverTag(cwd: string): string | undefined;
+/** 锚点 tag..HEAD 的完整 commit messages（%B 含 footer，NUL 分隔——body 内建换行安全） */
+export declare function commitsSince(cwd: string, ref?: string): string[];
+/** 工作区状态（--porcelain）。注意：不走通用 git()——其 stdout.trim() 会剥掉首行前导空格，
+ *  破坏 porcelain 的两列状态位（" M file" → "M file"），此处保留原始行仅去行尾。 */
+export declare function statusShort(cwd: string): string[];
+//#endregion
+//#region src/version/artifact.d.ts
 export interface ArtifactVersion {
   versionName?: string;
   versionCode?: string;
@@ -411,4 +589,4 @@ export interface ArtifactVersion {
 }
 export declare function readArtifactVersion(artifactPath: string): ArtifactVersion | undefined;
 //#endregion
-export { BetaConfig, BetaConfigSchema, BundleIds, Channel, ChannelCapabilities, ChannelContext, ChannelEvent, ChannelRegistry, CredentialsFile, CredentialsFileSchema, CredentialsProfile, CredentialsProfileSchema, FrameworkAdapter, GlobalConfig, GlobalConfigSchema, HISTORY_PATH, HistoryEntry, HistoryEvent, HistoryQuery, HookContext, PipelineInput, PipelineSummary, PipelineSummaryEntry, Platform, PluginHookName, PluginHost, ProjectConfig, ProjectConfigSchema, QypubPlugin, QypubUserConfig, ReleasePlanEntry, ReviewStatus, StageResult, StoreConfig, StoreConfigSchema, Stores, StoresSchema, SubmitResult, appendEntry, defineConfig, detectBundleIds, detectFramework, electronAdapter, findArtifacts, flutterAdapter, nativeAndroidAdapter, nativeHarmonyAdapter, nativeIosAdapter, readEntries, resolvePlugins, rnAdapter, runStage, runSubmit, tauriAdapter };
+export { BetaConfig, BetaConfigSchema, BundleIds, Channel, ChannelCapabilities, ChannelContext, ChannelEvent, ChannelRegistry, CredentialsFile, CredentialsFileSchema, CredentialsProfile, CredentialsProfileSchema, FrameworkAdapter, GlobalConfig, GlobalConfigSchema, HISTORY_PATH, HistoryEntry, HistoryEvent, HistoryQuery, HookContext, PipelineInput, PipelineSummary, PipelineSummaryEntry, Platform, PluginHookName, PluginHost, ProjectConfig, ProjectConfigSchema, QypubPlugin, QypubUserConfig, ReleaseConfig, ReleaseConfigSchema, ReleasePlanEntry, ReviewStatus, StageResult, StoreConfig, StoreConfigSchema, Stores, StoresSchema, SubmitResult, VersionCodeConfig, VersionCodeConfigSchema, VersionConfig, VersionConfigSchema, appendEntry, defineConfig, detectBundleIds, detectFramework, electronAdapter, findArtifacts, flutterAdapter, nativeAndroidAdapter, nativeHarmonyAdapter, nativeIosAdapter, readEntries, resolvePlugins, rnAdapter, runStage, runSubmit, tauriAdapter };