tegami 1.0.0-beta.5 → 1.0.2

package/dist/{types-C1rEqeM4.d.ts → types-DHddSAez.d.ts}

@@ -144,6 +144,395 @@ interface GitLabToken {
   type: "private-token" | "job-token";
 }
 //#endregion
+//#region src/plugins/cargo/schema.d.ts
+/**
+ * @see https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html
+ */
+declare const cargoDependencySchema: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+  package: z.ZodOptional<z.ZodString>;
+  features: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  optional: z.ZodOptional<z.ZodBoolean>;
+  "default-features": z.ZodOptional<z.ZodBoolean>;
+  workspace: z.ZodLiteral<true>;
+}, z.core.$strip>, z.ZodObject<{
+  package: z.ZodOptional<z.ZodString>;
+  features: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  optional: z.ZodOptional<z.ZodBoolean>;
+  "default-features": z.ZodOptional<z.ZodBoolean>;
+  path: z.ZodString;
+  version: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+  package: z.ZodOptional<z.ZodString>;
+  features: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  optional: z.ZodOptional<z.ZodBoolean>;
+  "default-features": z.ZodOptional<z.ZodBoolean>;
+  git: z.ZodString;
+  branch: z.ZodOptional<z.ZodString>;
+  tag: z.ZodOptional<z.ZodString>;
+  rev: z.ZodOptional<z.ZodString>;
+  version: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+  package: z.ZodOptional<z.ZodString>;
+  features: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  optional: z.ZodOptional<z.ZodBoolean>;
+  "default-features": z.ZodOptional<z.ZodBoolean>;
+  version: z.ZodString;
+  registry: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>]>;
+declare const cargoManifestSchema: z.ZodObject<{
+  package: z.ZodOptional<z.ZodObject<{
+    name: z.ZodString;
+    version: z.ZodUnion<[z.ZodString, z.ZodObject<{
+      workspace: z.ZodLiteral<true>;
+    }, z.core.$loose>]>;
+    publish: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodObject<{
+      workspace: z.ZodLiteral<true>;
+    }, z.core.$loose>]>>;
+  }, z.core.$loose>>;
+  workspace: z.ZodOptional<z.ZodObject<{
+    members: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    exclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    package: z.ZodOptional<z.ZodObject<{
+      version: z.ZodOptional<z.ZodString>;
+      publish: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$loose>>;
+    dependencies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+      package: z.ZodOptional<z.ZodString>;
+      features: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      optional: z.ZodOptional<z.ZodBoolean>;
+      "default-features": z.ZodOptional<z.ZodBoolean>;
+      workspace: z.ZodLiteral<true>;
+    }, z.core.$strip>, z.ZodObject<{
+      package: z.ZodOptional<z.ZodString>;
+      features: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      optional: z.ZodOptional<z.ZodBoolean>;
+      "default-features": z.ZodOptional<z.ZodBoolean>;
+      path: z.ZodString;
+      version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+      package: z.ZodOptional<z.ZodString>;
+      features: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      optional: z.ZodOptional<z.ZodBoolean>;
+      "default-features": z.ZodOptional<z.ZodBoolean>;
+      git: z.ZodString;
+      branch: z.ZodOptional<z.ZodString>;
+      tag: z.ZodOptional<z.ZodString>;
+      rev: z.ZodOptional<z.ZodString>;
+      version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+      package: z.ZodOptional<z.ZodString>;
+      features: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      optional: z.ZodOptional<z.ZodBoolean>;
+      "default-features": z.ZodOptional<z.ZodBoolean>;
+      version: z.ZodString;
+      registry: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>>>;
+    "dev-dependencies": z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+      package: z.ZodOptional<z.ZodString>;
+      features: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      optional: z.ZodOptional<z.ZodBoolean>;
+      "default-features": z.ZodOptional<z.ZodBoolean>;
+      workspace: z.ZodLiteral<true>;
+    }, z.core.$strip>, z.ZodObject<{
+      package: z.ZodOptional<z.ZodString>;
+      features: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      optional: z.ZodOptional<z.ZodBoolean>;
+      "default-features": z.ZodOptional<z.ZodBoolean>;
+      path: z.ZodString;
+      version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+      package: z.ZodOptional<z.ZodString>;
+      features: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      optional: z.ZodOptional<z.ZodBoolean>;
+      "default-features": z.ZodOptional<z.ZodBoolean>;
+      git: z.ZodString;
+      branch: z.ZodOptional<z.ZodString>;
+      tag: z.ZodOptional<z.ZodString>;
+      rev: z.ZodOptional<z.ZodString>;
+      version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+      package: z.ZodOptional<z.ZodString>;
+      features: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      optional: z.ZodOptional<z.ZodBoolean>;
+      "default-features": z.ZodOptional<z.ZodBoolean>;
+      version: z.ZodString;
+      registry: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>>>;
+    "build-dependencies": z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+      package: z.ZodOptional<z.ZodString>;
+      features: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      optional: z.ZodOptional<z.ZodBoolean>;
+      "default-features": z.ZodOptional<z.ZodBoolean>;
+      workspace: z.ZodLiteral<true>;
+    }, z.core.$strip>, z.ZodObject<{
+      package: z.ZodOptional<z.ZodString>;
+      features: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      optional: z.ZodOptional<z.ZodBoolean>;
+      "default-features": z.ZodOptional<z.ZodBoolean>;
+      path: z.ZodString;
+      version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+      package: z.ZodOptional<z.ZodString>;
+      features: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      optional: z.ZodOptional<z.ZodBoolean>;
+      "default-features": z.ZodOptional<z.ZodBoolean>;
+      git: z.ZodString;
+      branch: z.ZodOptional<z.ZodString>;
+      tag: z.ZodOptional<z.ZodString>;
+      rev: z.ZodOptional<z.ZodString>;
+      version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+      package: z.ZodOptional<z.ZodString>;
+      features: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      optional: z.ZodOptional<z.ZodBoolean>;
+      "default-features": z.ZodOptional<z.ZodBoolean>;
+      version: z.ZodString;
+      registry: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>>>;
+  }, z.core.$loose>>;
+  dependencies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+    package: z.ZodOptional<z.ZodString>;
+    features: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    optional: z.ZodOptional<z.ZodBoolean>;
+    "default-features": z.ZodOptional<z.ZodBoolean>;
+    workspace: z.ZodLiteral<true>;
+  }, z.core.$strip>, z.ZodObject<{
+    package: z.ZodOptional<z.ZodString>;
+    features: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    optional: z.ZodOptional<z.ZodBoolean>;
+    "default-features": z.ZodOptional<z.ZodBoolean>;
+    path: z.ZodString;
+    version: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>, z.ZodObject<{
+    package: z.ZodOptional<z.ZodString>;
+    features: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    optional: z.ZodOptional<z.ZodBoolean>;
+    "default-features": z.ZodOptional<z.ZodBoolean>;
+    git: z.ZodString;
+    branch: z.ZodOptional<z.ZodString>;
+    tag: z.ZodOptional<z.ZodString>;
+    rev: z.ZodOptional<z.ZodString>;
+    version: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>, z.ZodObject<{
+    package: z.ZodOptional<z.ZodString>;
+    features: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    optional: z.ZodOptional<z.ZodBoolean>;
+    "default-features": z.ZodOptional<z.ZodBoolean>;
+    version: z.ZodString;
+    registry: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>]>>>;
+  "dev-dependencies": z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+    package: z.ZodOptional<z.ZodString>;
+    features: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    optional: z.ZodOptional<z.ZodBoolean>;
+    "default-features": z.ZodOptional<z.ZodBoolean>;
+    workspace: z.ZodLiteral<true>;
+  }, z.core.$strip>, z.ZodObject<{
+    package: z.ZodOptional<z.ZodString>;
+    features: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    optional: z.ZodOptional<z.ZodBoolean>;
+    "default-features": z.ZodOptional<z.ZodBoolean>;
+    path: z.ZodString;
+    version: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>, z.ZodObject<{
+    package: z.ZodOptional<z.ZodString>;
+    features: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    optional: z.ZodOptional<z.ZodBoolean>;
+    "default-features": z.ZodOptional<z.ZodBoolean>;
+    git: z.ZodString;
+    branch: z.ZodOptional<z.ZodString>;
+    tag: z.ZodOptional<z.ZodString>;
+    rev: z.ZodOptional<z.ZodString>;
+    version: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>, z.ZodObject<{
+    package: z.ZodOptional<z.ZodString>;
+    features: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    optional: z.ZodOptional<z.ZodBoolean>;
+    "default-features": z.ZodOptional<z.ZodBoolean>;
+    version: z.ZodString;
+    registry: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>]>>>;
+  "build-dependencies": z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+    package: z.ZodOptional<z.ZodString>;
+    features: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    optional: z.ZodOptional<z.ZodBoolean>;
+    "default-features": z.ZodOptional<z.ZodBoolean>;
+    workspace: z.ZodLiteral<true>;
+  }, z.core.$strip>, z.ZodObject<{
+    package: z.ZodOptional<z.ZodString>;
+    features: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    optional: z.ZodOptional<z.ZodBoolean>;
+    "default-features": z.ZodOptional<z.ZodBoolean>;
+    path: z.ZodString;
+    version: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>, z.ZodObject<{
+    package: z.ZodOptional<z.ZodString>;
+    features: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    optional: z.ZodOptional<z.ZodBoolean>;
+    "default-features": z.ZodOptional<z.ZodBoolean>;
+    git: z.ZodString;
+    branch: z.ZodOptional<z.ZodString>;
+    tag: z.ZodOptional<z.ZodString>;
+    rev: z.ZodOptional<z.ZodString>;
+    version: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>, z.ZodObject<{
+    package: z.ZodOptional<z.ZodString>;
+    features: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    optional: z.ZodOptional<z.ZodBoolean>;
+    "default-features": z.ZodOptional<z.ZodBoolean>;
+    version: z.ZodString;
+    registry: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>]>>>;
+  target: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+    dependencies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+      package: z.ZodOptional<z.ZodString>;
+      features: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      optional: z.ZodOptional<z.ZodBoolean>;
+      "default-features": z.ZodOptional<z.ZodBoolean>;
+      workspace: z.ZodLiteral<true>;
+    }, z.core.$strip>, z.ZodObject<{
+      package: z.ZodOptional<z.ZodString>;
+      features: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      optional: z.ZodOptional<z.ZodBoolean>;
+      "default-features": z.ZodOptional<z.ZodBoolean>;
+      path: z.ZodString;
+      version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+      package: z.ZodOptional<z.ZodString>;
+      features: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      optional: z.ZodOptional<z.ZodBoolean>;
+      "default-features": z.ZodOptional<z.ZodBoolean>;
+      git: z.ZodString;
+      branch: z.ZodOptional<z.ZodString>;
+      tag: z.ZodOptional<z.ZodString>;
+      rev: z.ZodOptional<z.ZodString>;
+      version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+      package: z.ZodOptional<z.ZodString>;
+      features: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      optional: z.ZodOptional<z.ZodBoolean>;
+      "default-features": z.ZodOptional<z.ZodBoolean>;
+      version: z.ZodString;
+      registry: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>>>;
+    "dev-dependencies": z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+      package: z.ZodOptional<z.ZodString>;
+      features: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      optional: z.ZodOptional<z.ZodBoolean>;
+      "default-features": z.ZodOptional<z.ZodBoolean>;
+      workspace: z.ZodLiteral<true>;
+    }, z.core.$strip>, z.ZodObject<{
+      package: z.ZodOptional<z.ZodString>;
+      features: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      optional: z.ZodOptional<z.ZodBoolean>;
+      "default-features": z.ZodOptional<z.ZodBoolean>;
+      path: z.ZodString;
+      version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+      package: z.ZodOptional<z.ZodString>;
+      features: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      optional: z.ZodOptional<z.ZodBoolean>;
+      "default-features": z.ZodOptional<z.ZodBoolean>;
+      git: z.ZodString;
+      branch: z.ZodOptional<z.ZodString>;
+      tag: z.ZodOptional<z.ZodString>;
+      rev: z.ZodOptional<z.ZodString>;
+      version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+      package: z.ZodOptional<z.ZodString>;
+      features: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      optional: z.ZodOptional<z.ZodBoolean>;
+      "default-features": z.ZodOptional<z.ZodBoolean>;
+      version: z.ZodString;
+      registry: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>>>;
+    "build-dependencies": z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+      package: z.ZodOptional<z.ZodString>;
+      features: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      optional: z.ZodOptional<z.ZodBoolean>;
+      "default-features": z.ZodOptional<z.ZodBoolean>;
+      workspace: z.ZodLiteral<true>;
+    }, z.core.$strip>, z.ZodObject<{
+      package: z.ZodOptional<z.ZodString>;
+      features: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      optional: z.ZodOptional<z.ZodBoolean>;
+      "default-features": z.ZodOptional<z.ZodBoolean>;
+      path: z.ZodString;
+      version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+      package: z.ZodOptional<z.ZodString>;
+      features: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      optional: z.ZodOptional<z.ZodBoolean>;
+      "default-features": z.ZodOptional<z.ZodBoolean>;
+      git: z.ZodString;
+      branch: z.ZodOptional<z.ZodString>;
+      tag: z.ZodOptional<z.ZodString>;
+      rev: z.ZodOptional<z.ZodString>;
+      version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+      package: z.ZodOptional<z.ZodString>;
+      features: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      optional: z.ZodOptional<z.ZodBoolean>;
+      "default-features": z.ZodOptional<z.ZodBoolean>;
+      version: z.ZodString;
+      registry: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>>>;
+  }, z.core.$loose>>>;
+}, z.core.$loose>;
+type CargoDependency = z.infer<typeof cargoDependencySchema>;
+type CargoManifest = z.infer<typeof cargoManifestSchema>;
+//#endregion
+//#region src/plugins/cargo.d.ts
+declare const DEP_FIELDS$1: readonly ["dependencies", "dev-dependencies", "build-dependencies"];
+interface CargoToml<Data extends CargoManifest = CargoManifest> {
+  path: string;
+  content: string;
+  data: Data;
+}
+declare class CargoPackage extends WorkspacePackage {
+  readonly path: string;
+  /** a crate must have `package` field defined, otherwise it is merely a virutal workspace file, and Tegami should not include it. */
+  readonly file: CargoToml<RequireFields<CargoManifest, "package">>;
+  readonly workspaceFile?: CargoToml<RequireFields<CargoManifest, "workspace">> | undefined;
+  readonly manager = "cargo";
+  readonly manifest: RequireFields<CargoManifest, "package">;
+  constructor(path: string, /** a crate must have `package` field defined, otherwise it is merely a virutal workspace file, and Tegami should not include it. */
+
+  file: CargoToml<RequireFields<CargoManifest, "package">>, workspaceFile?: CargoToml<RequireFields<CargoManifest, "workspace">> | undefined);
+  get name(): string;
+  get version(): string;
+  setVersion(version: string): void;
+}
+interface DependentRef$1 {
+  dependent: CargoPackage;
+  kind: (typeof DEP_FIELDS$1)[number];
+  name: string;
+  spec: CargoDependency;
+  version?: string;
+}
+interface CargoPluginOptions {
+  /**
+   * Update lock file after versioning.
+   *
+   * @default true
+   */
+  updateLockFile?: boolean;
+  /**
+   * Decide how to bump the dependents of a bumped package.
+   */
+  bumpDep?: (opts: DependentRef$1) => BumpType | false;
+}
+declare function cargo({
+  updateLockFile,
+  bumpDep: getBumpDepType
+}?: CargoPluginOptions): TegamiPlugin;
+interface CargoGraph {
+  /** path -> Cargo.toml */
+  files: Map<string, CargoToml>;
+  /** name -> package */
+  packages: Map<string, CargoPackage>;
+}
+//#endregion
 //#region src/context.d.ts
 interface TegamiContext {
   /** absolute path */
@@ -164,13 +553,16 @@ interface TegamiContext {
   gitlab?: {
     repo?: string;
     token?: GitLabToken;
-    apiUrl?: string;
-    webUrl?: string;
+    apiUrl: string;
+    webUrl: string;
   };
   /** additional context when npm plugin is configured */
   npm?: {
     client: AgentName;
   };
+  cargo?: {
+    graph: CargoGraph;
+  };
 }
 //#endregion
 //#region src/providers/npm/schema.d.ts
@@ -195,160 +587,27 @@ declare const packageManifestSchema: z.ZodObject<{
 }, z.core.$loose>;
 type PackageManifest = z.infer<typeof packageManifestSchema>;
 //#endregion
-//#region src/providers/npm.d.ts
-declare const DEP_FIELDS$1: readonly ["dependencies", "devDependencies", "peerDependencies", "optionalDependencies"];
-declare class NpmPackage extends WorkspacePackage {
-  readonly path: string;
-  readonly manifest: PackageManifest;
-  readonly manager = "npm";
-  constructor(path: string, manifest: PackageManifest);
-  get name(): string;
-  get version(): string | undefined;
-  write(): Promise<void>;
-  initDraft(): PackageDraft;
-  configureDraft(draft: PackageDraft, group?: PackageGroup): void;
-}
-type DependencySpec = {
-  protocol: "npm";
-  alias: string;
-  range: string;
-  linked?: WorkspacePackage;
-} | {
-  protocol: "workspace";
-  range: string;
-  linked?: WorkspacePackage;
-} | {
-  protocol: "file";
-  raw: string;
-  linked?: WorkspacePackage;
-} | {
-  range: string;
-  linked?: WorkspacePackage;
-  protocol?: undefined;
-};
-interface NpmPluginOptions {
-  /** Package manager command used for npm registry operations. */
-  client?: AgentName;
-  /**
-   * Decide how to bump the dependents of a bumped package.
-   */
-  bumpDep?: (opts: {
-    dependent: NpmPackage;
-    kind: (typeof DEP_FIELDS$1)[number];
-    name: string;
-    spec: DependencySpec;
-  }) => BumpType | false;
-  /**
-   * What to do when a workspace dependency's version has gone beyond peer dependency constraints:
-   *
-   * - `set` (default): set to the current version (won't preserve prefix).
-   * - `error`: throw error.
-   * - `ignore`: do nothing.
-   *
-   * Note: `workspace:` protocols are not included.
-   */
-  onBreakPeerDep?: "set" | "error" | "ignore";
-  /** update lockfile after applying a draft @default true */
-  updateLockFile?: boolean;
+//#region src/changelog/generate.d.ts
+interface GenerateFromCommitsOptions {
+  /** Start revision. Defaults to the latest reachable git tag, or all history if none exists. */
+  from?: string;
+  /** End revision. Defaults to HEAD. */
+  to?: string;
 }
-declare function npm({
-  client: defaultClient,
-  onBreakPeerDep,
-  updateLockFile,
-  bumpDep: getBumpDepType
-}?: NpmPluginOptions): TegamiPlugin;
-//#endregion
-//#region src/providers/cargo/schema.d.ts
-declare const cargoManifestSchema: z.ZodObject<{
-  package: z.ZodObject<{
-    name: z.ZodString;
-    version: z.ZodOptional<z.ZodString>;
-    publish: z.ZodOptional<z.ZodBoolean>;
-  }, z.core.$strip>;
-  workspace: z.ZodOptional<z.ZodObject<{
-    members: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    exclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    package: z.ZodOptional<z.ZodObject<{
-      version: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
-  }, z.core.$strip>>;
-  dependencies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
-    version: z.ZodString;
-    package: z.ZodOptional<z.ZodString>;
-    path: z.ZodOptional<z.ZodString>;
-  }, z.core.$strip>]>>>;
-  "dev-dependencies": z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
-    version: z.ZodString;
-    package: z.ZodOptional<z.ZodString>;
-    path: z.ZodOptional<z.ZodString>;
-  }, z.core.$strip>]>>>;
-  "build-dependencies": z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
-    version: z.ZodString;
-    package: z.ZodOptional<z.ZodString>;
-    path: z.ZodOptional<z.ZodString>;
-  }, z.core.$strip>]>>>;
-  target: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
-    dependencies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
-      version: z.ZodString;
-      package: z.ZodOptional<z.ZodString>;
-      path: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>]>>>;
-    "dev-dependencies": z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
-      version: z.ZodString;
-      package: z.ZodOptional<z.ZodString>;
-      path: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>]>>>;
-    "build-dependencies": z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
-      version: z.ZodString;
-      package: z.ZodOptional<z.ZodString>;
-      path: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>]>>>;
-  }, z.core.$strip>>>;
-}, z.core.$strip>;
-type CargoManifest = z.infer<typeof cargoManifestSchema>;
-//#endregion
-//#region src/providers/cargo.d.ts
-declare const DEP_FIELDS: readonly ["dependencies", "dev-dependencies", "build-dependencies"];
-declare class CargoPackage extends WorkspacePackage {
-  readonly path: string;
-  readonly manifest: CargoManifest;
-  private content;
-  private readonly workspaceManifest?;
-  readonly manager = "cargo";
-  constructor(path: string, manifest: CargoManifest, content: string, workspaceManifest?: CargoManifest | undefined);
-  get name(): string;
-  get version(): string | undefined;
-  setVersion(version: string): void;
-  write(): Promise<void>;
-  patch(path: string, value: unknown): void;
-  get packageInfo(): {
-    name: string;
-    version?: string | undefined;
-    publish?: boolean | undefined;
-  };
-  private get workspaceVersion();
+interface CommitChangelog {
+  filename: string;
+  content: string;
+  packages: Record<string, BumpType | ChangelogPackageConfig>;
+  changes: CommitChange[];
 }
-interface CargoPluginOptions {
-  /**
-   * Update lock file after versioning.
-   *
-   * @default true
-   */
-  updateLockFile?: boolean;
-  /**
-   * Decide how to bump the dependents of a bumped package.
-   */
-  bumpDep?: (opts: {
-    dependent: CargoPackage;
-    kind: (typeof DEP_FIELDS)[number];
-    name: string;
-    version: string;
-  }) => BumpType | false;
+interface CommitChange {
+  hash: string;
+  subject: string;
+  body: string;
+  packages: string[];
+  type: BumpType;
+  title: string;
 }
-declare function cargo({
-  updateLockFile,
-  bumpDep: getBumpDepType
-}?: CargoPluginOptions): TegamiPlugin;
 //#endregion
 //#region src/plans/publish.d.ts
 interface PublishPlan {
@@ -368,7 +627,8 @@ interface PackagePublishPlan {
   };
   /** generated by npm plugin */
   npm?: {
-    /** dist tag to use if published */distTag?: string;
+    /** dist tag to use if published */distTag?: string; /** point latest tag to it if published */
+    markLatest?: boolean;
   };
   /** publish result, generated for all packages in publish plan after publishing */
   publishResult?: PackagePublishResult;
@@ -403,28 +663,6 @@ declare class PublishLock {
   serialize(): string;
 }
 //#endregion
-//#region src/changelog/generate.d.ts
-interface GenerateFromCommitsOptions {
-  /** Start revision. Defaults to the latest reachable git tag, or all history if none exists. */
-  from?: string;
-  /** End revision. Defaults to HEAD. */
-  to?: string;
-}
-interface CommitChangelog {
-  filename: string;
-  content: string;
-  packages: Record<string, BumpType | ChangelogPackageConfig>;
-  changes: CommitChange[];
-}
-interface CommitChange {
-  hash: string;
-  subject: string;
-  body: string;
-  packages: string[];
-  type: BumpType;
-  title: string;
-}
-//#endregion
 //#region src/index.d.ts
 interface GenerateChangelogOptions extends GenerateFromCommitsOptions {
   /**
@@ -492,6 +730,83 @@ interface TegamiCliRegistry {
   parse(argv: string[]): Promise<void>;
 }
 //#endregion
+//#region src/providers/npm/cli.d.ts
+type TrustedPublishOptions = {
+  provider: "github"; /** CI workflow filename for publishing. */
+  workflow: string;
+} | {
+  provider: "gitlab"; /** CI pipeline filename for publishing. */
+  workflow: string;
+};
+//#endregion
+//#region src/providers/npm.d.ts
+declare const DEP_FIELDS: readonly ["dependencies", "devDependencies", "peerDependencies", "optionalDependencies"];
+declare class NpmPackage extends WorkspacePackage {
+  readonly path: string;
+  readonly manifest: PackageManifest;
+  readonly manager = "npm";
+  constructor(path: string, manifest: PackageManifest);
+  get name(): string;
+  get version(): string | undefined;
+  write(): Promise<void>;
+  initDraft(): PackageDraft;
+  getRegistry(): string;
+  configureDraft(draft: PackageDraft, group?: PackageGroup): void;
+}
+type DependencySpec = {
+  protocol: "npm";
+  alias: string;
+  range: string;
+  linked?: WorkspacePackage;
+} | {
+  protocol: "workspace";
+  range: string;
+  linked?: WorkspacePackage;
+} | {
+  protocol: "file";
+  raw: string;
+  linked?: WorkspacePackage;
+} | {
+  range: string;
+  linked?: WorkspacePackage;
+  protocol?: undefined;
+};
+interface DependentRef {
+  dependent: NpmPackage;
+  kind: (typeof DEP_FIELDS)[number];
+  name: string;
+  spec: DependencySpec;
+}
+interface NpmPluginOptions {
+  /** Package manager command used for npm registry operations. */
+  client?: AgentName;
+  /**
+   * Decide how to bump the dependents of a bumped package.
+   */
+  bumpDep?: (opts: DependentRef) => BumpType | false;
+  /**
+   * What to do when a workspace dependency's version has gone beyond peer dependency constraints:
+   *
+   * - `set` (default): set to the current version (won't preserve prefix).
+   * - `error`: throw error.
+   * - `ignore`: do nothing.
+   *
+   * Note: `workspace:` protocols are not included.
+   */
+  onBreakPeerDep?: "set" | "error" | "ignore";
+  /** update lockfile after applying a draft @default true */
+  updateLockFile?: boolean;
+  /** Configure `tegami npm pretrust`, disabled by default. */
+  trustedPublish?: TrustedPublishOptions;
+}
+declare function npm({
+  client: defaultClient,
+  onBreakPeerDep,
+  updateLockFile,
+  trustedPublish,
+  bumpDep: getBumpDepType
+}?: NpmPluginOptions): TegamiPlugin;
+//#endregion
 //#region src/types.d.ts
 /** Generates changelog content for a package release. */
 interface LogGenerator {
@@ -525,7 +840,6 @@ interface TegamiOptions<Groups extends string = string> {
    */
   conventionalCommits?: boolean;
   npm?: NpmPluginOptions;
-  cargo?: CargoPluginOptions;
 }
 interface SharedGoOptions {
   /**
@@ -594,6 +908,10 @@ interface TegamiPlugin {
     pkg: WorkspacePackage;
     plan: PublishPlan;
   }): Awaitable<PublishPreflight | void | undefined>;
+  /** Called when all preflights finished */
+  afterPreflight?(this: TegamiContext, opts: {
+    plan: PublishPlan;
+  }): Awaitable<void>;
   /** Publish package, return a result object indicating if the package is published, skipped, or failed. Return `undefined` if the package is not handled by this plugin. */
   publish?(this: TegamiContext, opts: {
     pkg: WorkspacePackage;
@@ -626,6 +944,7 @@ interface TegamiPlugin {
   applyCliDraft?(this: TegamiContext, draft: Draft): Awaitable<void>;
 }
 type Awaitable<T> = T | Promise<T>;
+type RequireFields<Obj, K extends keyof Obj> = Obj & { [R in K]-?: NonNullable<Obj[R]> };
 interface PublishPreflight {
   /**
    * Whether the package should be published, the state **must not** be changed across different runs.
@@ -641,4 +960,4 @@ interface PublishPreflight {
   wait?: string[];
 }
 //#endregion
-export { PackageDraft as A, npm as C, WorkspacePackage as D, PackageGroup as E, Draft as O, NpmPluginOptions as S, PackageGraph as T, PublishPlan as _, PublishPreflight as a, cargo as b, TegamiPluginOption as c, tegami as d, CommitChangelog as f, PublishOptions as g, PackagePublishResult as h, PackageOptions as i, BumpType as j, DraftPolicy as k, GenerateChangelogOptions as l, PackagePublishPlan as m, GroupOptions as n, TegamiOptions as o, PublishLock as p, LogGenerator as r, TegamiPlugin as s, Awaitable as t, Tegami as u, CargoPackage as v, TegamiContext as w, NpmPackage as x, CargoPluginOptions as y };
+export { DraftPolicy as A, CargoPackage as C, PackageGroup as D, PackageGraph as E, BumpType as M, WorkspacePackage as O, CargoGraph as S, cargo as T, PackagePublishResult as _, PublishPreflight as a, CommitChangelog as b, TegamiPluginOption as c, npm as d, GenerateChangelogOptions as f, PackagePublishPlan as g, PublishLock as h, PackageOptions as i, PackageDraft as j, Draft as k, NpmPackage as l, tegami as m, GroupOptions as n, TegamiOptions as o, Tegami as p, LogGenerator as r, TegamiPlugin as s, Awaitable as t, NpmPluginOptions as u, PublishOptions as v, CargoPluginOptions as w, TegamiContext as x, PublishPlan as y };