@scolladon/tsgit 1.1.0 → 1.2.0

package/dist/types/chunks/write-tree-DVp0RJ_r.d.cts

@@ -1,282 +0,0 @@
-import { O as ObjectId, d as FilePath, e as FileStat, b as Context, R as RefName } from './context-D84z1i5F.cjs';
-import { A as AuthorIdentity, F as FileMode, T as TreeDiff } from './diff-change-Bm1zvVsC.cjs';
-
-interface Blob {
-    readonly type: 'blob';
-    readonly id: ObjectId;
-    readonly content: Uint8Array;
-}
-
-interface ExtraHeader {
-    readonly key: string;
-    readonly value: string;
-}
-interface CommitData {
-    readonly tree: ObjectId;
-    readonly parents: ReadonlyArray<ObjectId>;
-    readonly author: AuthorIdentity;
-    readonly committer: AuthorIdentity;
-    readonly message: string;
-    readonly gpgSignature?: string;
-    readonly extraHeaders: ReadonlyArray<ExtraHeader>;
-}
-interface Commit {
-    readonly type: 'commit';
-    readonly id: ObjectId;
-    readonly data: CommitData;
-}
-
-type ObjectType = 'blob' | 'tree' | 'commit' | 'tag';
-
-interface TagData {
-    readonly object: ObjectId;
-    readonly objectType: ObjectType;
-    readonly tagName: string;
-    readonly tagger?: AuthorIdentity;
-    readonly message: string;
-    readonly gpgSignature?: string;
-    readonly extraHeaders: ReadonlyArray<ExtraHeader>;
-}
-interface Tag {
-    readonly type: 'tag';
-    readonly id: ObjectId;
-    readonly data: TagData;
-}
-
-interface TreeEntry {
-    readonly mode: FileMode;
-    readonly name: string;
-    readonly id: ObjectId;
-}
-interface Tree {
-    readonly type: 'tree';
-    readonly id: ObjectId;
-    readonly entries: ReadonlyArray<TreeEntry>;
-}
-
-type GitObject = Blob | Tree | Commit | Tag;
-
-interface IndexEntryFlags {
-    readonly assumeValid: boolean;
-    readonly extended: boolean;
-    readonly stage: 0 | 1 | 2 | 3;
-}
-interface IndexEntry {
-    readonly ctimeSeconds: number;
-    readonly ctimeNanoseconds: number;
-    readonly mtimeSeconds: number;
-    readonly mtimeNanoseconds: number;
-    readonly dev: number;
-    readonly ino: number;
-    readonly mode: FileMode;
-    readonly uid: number;
-    readonly gid: number;
-    readonly fileSize: number;
-    readonly id: ObjectId;
-    readonly flags: IndexEntryFlags;
-    readonly path: FilePath;
-}
-interface IndexExtension {
-    readonly signature: string;
-    readonly data: Uint8Array;
-}
-interface GitIndex {
-    readonly version: 2;
-    readonly entries: ReadonlyArray<IndexEntry>;
-    readonly extensions: ReadonlyArray<IndexExtension>;
-}
-
-interface RenameDetectOptions {
-    readonly limit?: number;
-    readonly maxSameIdDeletes?: number;
-}
-
-/**
- * Primitive option shapes, walker value types, and shared constants.
- * Defined in one location to avoid circular imports between primitive modules.
- */
-
-/** Max symbolic-ref dereferences resolveRef will follow. */
-declare const MAX_SYMBOLIC_REF_DEPTH = 5;
-/** Max tag-peel hops resolveRef / readTree will follow when peeling. */
-declare const MAX_PEEL_DEPTH = 5;
-/** Max seeds walkCommits.from can contain. */
-declare const MAX_WALK_SEEDS = 1024;
-/** Hard cap on walkCommits' pending queue size to prevent unbounded heap growth. */
-declare const MAX_WALK_QUEUE_SIZE: number;
-/** Max.git/index file size readIndex will accept. */
-declare const MAX_INDEX_BYTES: number;
-/** Max commit message byte length createCommit will accept. */
-declare const MAX_COMMIT_MESSAGE_BYTES: number;
-/**
- * Per-file size cap enforced by `add --all` before reading working-tree
- * bytes into memory. Mirrors `MAX_CONFLICT_OUTPUT_BYTES` (256 MiB) so the
- * write-side memory ceiling matches the read-side ceiling.
- * See `docs/adr/032-add-all-large-file-guard.md`.
- */
-declare const MAX_WORKING_TREE_BLOB_BYTES: number;
-/**
- * Per-file cap on `.gitignore`, `.git/info/exclude`, and the global
- * excludesFile. 1 MiB leaves a 20× margin over real-world max-size
- * gitignore corpora. See `docs/adr/036-gitignore-bounded-read.md`.
- */
-declare const MAX_GITIGNORE_BYTES: number;
-interface ReadObjectOptions {
-    readonly verifyHash?: boolean;
-    /**
-     * Reject objects whose serialised payload exceeds this byte count, before
-     * inflating the full content into memory. Counts the raw object content
-     * (post-inflate, pre-loose-header). When unset, no cap applies.
-     *
-     * Used by `merge`'s content merger to bound peak memory when an adversarial
-     * remote ships pathologically large blobs. See `docs/design/phase-13-8-
-     * bounded-object-reads.md`.
-     */
-    readonly maxBytes?: number;
-}
-interface ResolveRefOptions {
-    readonly peel?: boolean;
-    readonly maxSymbolicDepth?: number;
-    readonly maxPeelDepth?: number;
-}
-interface UpdateRefOptions {
-    readonly expected?: ObjectId | 'absent';
-    readonly delete?: boolean;
-}
-interface WalkCommitsOptions {
-    readonly from: ReadonlyArray<ObjectId>;
-    readonly until?: ReadonlyArray<ObjectId>;
-    readonly order?: 'topo' | 'first-parent';
-    readonly ignoreMissing?: boolean;
-    readonly verifyHash?: boolean;
-    /**
-     * Commits whose parents must NOT be enqueued. Used for shallow boundaries
-     * . The commit itself is still yielded — only its parents are
-     * skipped. Callers that want to also skip the boundary commit pass it in
-     * `until`.
-     */
-    readonly shallow?: ReadonlySet<ObjectId>;
-}
-/** Maximum `have` lines a single-round fetch will send. */
-declare const MAX_HAVES = 256;
-/** Hard cap on objects enumerated for a single push. design */
-declare const MAX_PUSH_OBJECTS = 1000000;
-interface WalkTreeEntry {
-    readonly path: FilePath;
-    readonly id: ObjectId;
-    readonly mode: FileMode;
-}
-interface WalkTreeOptions {
-    readonly recursive?: boolean;
-    readonly maxDepth?: number;
-    readonly maxEntries?: number;
-}
-interface WalkWorkingTreeEntry {
-    readonly path: FilePath;
-    readonly stat: FileStat;
-}
-type WalkIgnorePredicate = (path: FilePath, isDirectory: boolean) => boolean | Promise<boolean>;
-interface WalkWorkingTreeOptions {
-    readonly maxDepth?: number;
-    readonly maxEntries?: number;
-    /**
-     * predicate. Invoked on every directory BEFORE descent
-     * (returning `true` prunes the entire subtree, skipping its `lstat`
-     * cost) and on every leaf BEFORE yielding (returning `true` drops
-     * the leaf). May be sync or async.
-     */
-    readonly ignore?: WalkIgnorePredicate;
-}
-interface CreateCommitInput {
-    readonly tree: ObjectId;
-    readonly parents: ReadonlyArray<ObjectId>;
-    readonly author: AuthorIdentity;
-    readonly committer: AuthorIdentity;
-    readonly message: string;
-    readonly gpgSignature?: string;
-    readonly extraHeaders?: ReadonlyArray<ExtraHeader>;
-}
-type DiffTreesInput = Tree | ObjectId | undefined;
-interface DiffTreesOptions {
-    readonly detectRenames?: boolean;
-    readonly renameOptions?: RenameDetectOptions;
-}
-
-declare function createCommit(ctx: Context, input: CreateCommitInput): Promise<ObjectId>;
-
-declare function diffTrees(ctx: Context, a: DiffTreesInput, b: DiffTreesInput, options?: DiffTreesOptions): Promise<TreeDiff>;
-
-/**
- * Compute a merge base — the first commit reachable from BOTH `a` and `b`.
- *
- * Algorithm: bidirectional BFS with two visited sets. After each layer
- * advance, check the intersection. When non-empty, return the
- * lexicographically smallest oid (deterministic tie-breaker).
- *
- * Returns `undefined` for unrelated histories. Documented limitation: cherry-picks
- * and criss-cross merges may yield non-optimal bases — `recursive`-strategy
- * multi-base resolution is v2.
- */
-declare const mergeBase: (ctx: Context, a: ObjectId, b: ObjectId) => Promise<ObjectId | undefined>;
-
-/**
- * Pure path helpers composing `ctx.layout.gitDir` with known sub-paths.
- * No I/O. No port access. Primitive step 3.
- */
-
-/**
- * Repository working-tree root. Returns the workDir from the current context;
- * facade-tier code is responsible for discovery / realpath pinning
- * at construction time. Primitives consume the already-resolved path.
- */
-declare const getRepoRoot: (ctx: Context) => FilePath;
-
-declare function readBlob(ctx: Context, id: ObjectId, options?: ReadObjectOptions): Promise<Blob>;
-
-declare function readIndex(ctx: Context): Promise<GitIndex>;
-
-declare function readObject(ctx: Context, id: ObjectId, options?: ReadObjectOptions): Promise<GitObject>;
-
-declare function readTree(ctx: Context, ref: RefName | ObjectId): Promise<Tree>;
-
-declare function resolveRef(ctx: Context, name: RefName | 'HEAD', options?: ResolveRefOptions): Promise<ObjectId>;
-
-declare function updateRef(ctx: Context, name: RefName, newId: ObjectId, options?: UpdateRefOptions): Promise<void>;
-
-declare function walkCommits(ctx: Context, options: WalkCommitsOptions): AsyncIterable<Commit>;
-
-declare function walkTree(ctx: Context, treeIdOrObject: ObjectId | Tree, options?: WalkTreeOptions): AsyncIterable<WalkTreeEntry>;
-
-/**
- * Depth-first walk of the working tree starting at `ctx.layout.workDir`.
- *
- * Yields leaf entries (files and symlinks) as `{ path, stat }`. Directories
- * are descended into, not yielded. `.git` at any level is skipped
- * (case-insensitive, NTFS-trimmed). Embedded repositories (directories
- * containing a `.git` child) are skipped entirely — yields nothing under
- * them. Symlinks are surfaced via `lstat` (no follow); a symlink to a
- * directory is yielded as a leaf, not descended into.
- *
- * The host repository's own `.git` is NOT treated as an embedded-repo
- * marker — at the workDir root we only skip the `.git` entry itself, not
- * the workDir.
- */
-declare function walkWorkingTree(ctx: Context, options?: WalkWorkingTreeOptions): AsyncIterable<WalkWorkingTreeEntry>;
-
-declare function writeObject(ctx: Context, object: GitObject): Promise<ObjectId>;
-
-/**
- * Write a symbolic ref atomically. Used for HEAD updates that point at a
- * branch, branch renames affecting the current HEAD, and `clone`/`init`
- * to set the initial HEAD.
- *
- * Single-level only in v1: target MUST be a direct ref name (no chained
- * symrefs). Validation runs through `validateRefName` for both `name` and
- * `target` — invalid inputs throw INVALID_REF before any I/O.
- */
-declare const writeSymbolicRef: (ctx: Context, name: RefName, target: RefName) => Promise<void>;
-
-declare function writeTree(ctx: Context, entries: ReadonlyArray<TreeEntry>): Promise<ObjectId>;
-
-export { walkCommits as A, walkTree as B, walkWorkingTree as E, writeObject as F, writeSymbolicRef as H, writeTree as J, MAX_COMMIT_MESSAGE_BYTES as M, MAX_GITIGNORE_BYTES as b, MAX_HAVES as c, MAX_INDEX_BYTES as d, MAX_PEEL_DEPTH as e, MAX_PUSH_OBJECTS as f, MAX_SYMBOLIC_REF_DEPTH as g, MAX_WALK_QUEUE_SIZE as h, MAX_WALK_SEEDS as i, MAX_WORKING_TREE_BLOB_BYTES as j, createCommit as q, diffTrees as r, getRepoRoot as s, mergeBase as t, readBlob as u, readIndex as v, readObject as w, readTree as x, resolveRef as y, updateRef as z };
-export type { CreateCommitInput as C, DiffTreesInput as D, GitIndex as G, IndexEntry as I, ReadObjectOptions as R, UpdateRefOptions as U, WalkCommitsOptions as W, DiffTreesOptions as a, ResolveRefOptions as k, WalkIgnorePredicate as l, WalkTreeEntry as m, WalkTreeOptions as n, WalkWorkingTreeEntry as o, WalkWorkingTreeOptions as p };