@batijs/core 0.0.628 → 0.0.630

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { BatiSet, CategoryLabels, Flags } from "@batijs/features";
 import * as _$attributes_parser0 from "attributes-parser";
 import * as _$yaml from "yaml";
-import { Document as YAMLDocument, DocumentOptions, ParseOptions, SchemaOptions } from "yaml";
+import { Document as YAMLDocument, DocumentOptions, ParseOptions, SchemaOptions, YAMLMap, YAMLSeq } from "yaml";
 import { ProxifiedModule, builders, generateCode, loadFile, parseModule } from "magicast";
 import { addVitePlugin, deepMergeObject } from "magicast/helpers";
 import { Color } from "colorette";
@@ -11,6 +11,59 @@ export * from "colorette";
 
 //#region \0rolldown/runtime.js
 //#endregion
+//#region src/dockerfile.d.ts
+/**
+ * Chainable builder for the multi-stage Dockerfiles emitted by Bati boilerplates.
+ *
+ * `.from(img, { as })` widens the `Stages` type parameter, so `.copy(..., { from })`
+ * only autocompletes — and accepts — stage names that were actually declared.
+ */
+interface BaseOptions {
+  /** Rendered as `# <comment>` line(s) immediately before the instruction. */
+  comment?: string;
+}
+interface FromOptions extends BaseOptions {
+  /** Stage alias: `AS <name>`. */
+  as: string;
+}
+interface CopyOptions<Stages extends string = string> extends BaseOptions {
+  /** Copy from a named build stage: `--from=<stage>`. */
+  from?: Stages;
+}
+type EnvRecord = Record<string, string>;
+declare class DockerfileBuilder<Stages extends string = never> {
+  private readonly instructions;
+  from<S extends string>(image: string, options: FromOptions & {
+    as: S;
+  }): DockerfileBuilder<Stages | S>;
+  workdir(path: string, options?: BaseOptions): this;
+  run(command: string, options?: BaseOptions): this;
+  copy(sources: string[], dest: string, options?: CopyOptions<Stages | (string & {})>): this;
+  env(vars: EnvRecord, options?: BaseOptions): this;
+  expose(port: number, options?: BaseOptions): this;
+  cmd(command: string[], options?: BaseOptions): this;
+  /** Run `cb` against the builder only when `condition` holds. */
+  when(condition: boolean, cb: (builder: this) => void): this;
+  /** Apply a reusable group of steps. */
+  pipe(cb: (builder: this) => void): this;
+  build(): string;
+}
+declare function dockerfile(): DockerfileBuilder;
+interface DockerPackageManager {
+  image: string;
+  /** pnpm and yarn ship through corepack; bun and npm don't. */
+  corepack: boolean;
+  install: string;
+  installProd: string;
+  /** Glob(s) to COPY so the install layer re-caches only on lockfile changes. */
+  lockfiles: string[];
+}
+declare function dockerPackageManager(name: string, {
+  frozenLockfile
+}: {
+  frozenLockfile: boolean;
+}): DockerPackageManager;
+//#endregion
 //#region src/format.d.ts
 declare function formatCode(code: string, options: {
   filepath: string;
@@ -1270,7 +1323,7 @@ declare function getVersion(): {
 //#region src/utils/env.d.ts
 declare function appendToEnv(envContent: string | undefined | null, key: string, value: unknown, comment?: string): string;
 declare namespace index_d_exports {
-  export { ContentGetter, FileContext, MarkdownV2, PackageJson, PackageManagerInfo, StringTransformer, Transformer, TransformerProps, VikeMeta, YAMLDocument, addVitePlugin, appendToEnv, builders, deepMergeObject, formatCode, generateCode, getArgs, getVersion, loadAsJson, loadAsMagicast, loadFile, loadMarkdown, loadPackageJson, loadRelativeFileAsMagicast, loadYaml, packageManager, parseMarkdown, parseModule, randomBytes, transformAndFormat, which, withIcon };
+  export { BaseOptions, ContentGetter, CopyOptions, DockerPackageManager, DockerfileBuilder, EnvRecord, FileContext, FromOptions, MarkdownV2, PackageJson, PackageManagerInfo, StringTransformer, Transformer, TransformerProps, VikeMeta, YAMLDocument, YAMLMap, YAMLSeq, addVitePlugin, appendToEnv, builders, deepMergeObject, dockerPackageManager, dockerfile, formatCode, generateCode, getArgs, getVersion, loadAsJson, loadAsMagicast, loadFile, loadMarkdown, loadPackageJson, loadRelativeFileAsMagicast, loadYaml, packageManager, parseMarkdown, parseModule, randomBytes, transformAndFormat, which, withIcon };
 }
 //#endregion
-export { ContentGetter, type FileContext, MarkdownV2, PackageJson, PackageManagerInfo, StringTransformer, Transformer, TransformerProps, VikeMeta, type YAMLDocument, addVitePlugin, appendToEnv, builders, deepMergeObject, formatCode, generateCode, getArgs, getVersion, loadAsJson, loadAsMagicast, loadFile, loadMarkdown, loadPackageJson, loadRelativeFileAsMagicast, loadYaml, packageManager, parseMarkdown, parseModule, randomBytes, transformAndFormat, which, withIcon };
+export { BaseOptions, ContentGetter, CopyOptions, DockerPackageManager, DockerfileBuilder, EnvRecord, type FileContext, FromOptions, MarkdownV2, PackageJson, PackageManagerInfo, StringTransformer, Transformer, TransformerProps, VikeMeta, type YAMLDocument, YAMLMap, YAMLSeq, addVitePlugin, appendToEnv, builders, deepMergeObject, dockerPackageManager, dockerfile, formatCode, generateCode, getArgs, getVersion, loadAsJson, loadAsMagicast, loadFile, loadMarkdown, loadPackageJson, loadRelativeFileAsMagicast, loadYaml, packageManager, parseMarkdown, parseModule, randomBytes, transformAndFormat, which, withIcon };