@scolladon/tsgit 1.2.0 → 1.3.0

package/dist/types/chunks/{reflog-entry-D9P2hCgv.d.ts → reflog-entry-C2Hsdobk.d.ts}

@@ -13,6 +13,18 @@ interface Blob {
     readonly content: Uint8Array;
 }
 
+/**
+ * Commit serializer. Produces the canonical Git commit-object payload
+ * (`tree <sha>\nparent <sha>*\nauthor …\ncommitter …\n\n<message>`) that
+ * sits inside a loose commit object. SHA equality is the contract;
+ * disk-bytes vary by zlib compression level (loose object caveat).
+ *
+ * @writes
+ *   surface: commit
+ *   kind:    equivalent-under-readback
+ *   format:  git-commit-object
+ */
+
 interface ExtraHeader {
     readonly key: string;
     readonly value: string;
@@ -43,6 +55,17 @@ type FileMode = (typeof FILE_MODE)[keyof typeof FILE_MODE];
 
 type ObjectType = 'blob' | 'tree' | 'commit' | 'tag';
 
+/**
+ * Tag serializer. Produces the canonical annotated-tag payload
+ * (`object <sha>\ntype <type>\ntag <name>\ntagger …\n\n<message>`) inside a
+ * loose tag object.
+ *
+ * @writes
+ *   surface: tag
+ *   kind:    equivalent-under-readback
+ *   format:  git-tag-object
+ */
+
 interface TagData {
     readonly object: ObjectId;
     readonly objectType: ObjectType;

package/dist/types/chunks/{reflog-entry-BIf-zt__.d.cts → reflog-entry-DNvSz7S5.d.cts}

@@ -13,6 +13,18 @@ interface Blob {
     readonly content: Uint8Array;
 }
 
+/**
+ * Commit serializer. Produces the canonical Git commit-object payload
+ * (`tree <sha>\nparent <sha>*\nauthor …\ncommitter …\n\n<message>`) that
+ * sits inside a loose commit object. SHA equality is the contract;
+ * disk-bytes vary by zlib compression level (loose object caveat).
+ *
+ * @writes
+ *   surface: commit
+ *   kind:    equivalent-under-readback
+ *   format:  git-commit-object
+ */
+
 interface ExtraHeader {
     readonly key: string;
     readonly value: string;
@@ -43,6 +55,17 @@ type FileMode = (typeof FILE_MODE)[keyof typeof FILE_MODE];
 
 type ObjectType = 'blob' | 'tree' | 'commit' | 'tag';
 
+/**
+ * Tag serializer. Produces the canonical annotated-tag payload
+ * (`object <sha>\ntype <type>\ntag <name>\ntagger …\n\n<message>`) inside a
+ * loose tag object.
+ *
+ * @writes
+ *   surface: tag
+ *   kind:    equivalent-under-readback
+ *   format:  git-tag-object
+ */
+
 interface TagData {
     readonly object: ObjectId;
     readonly objectType: ObjectType;

package/dist/types/chunks/{repository-BqibvTOu.d.cts → repository-DCR_3RVt.d.cts}

@@ -1,6 +1,6 @@
 import { add, branch, catFile, checkout, clone, commit, diff, fetch, fetchMissing, init, log, merge, push, reflog, reset, revParse, rm, sparseCheckout, status, submodules, tag } from '../commands/index.cjs';
 import { f as FileSystem, H as HashService, C as Compressor, n as RepositoryConfig, L as Logger, P as ProgressReporter, k as HookRunner, b as Context } from './context-CMrHCVwK.cjs';
-import { c as catFileBatch, a as createCommit, d as diffTrees, g as getRepoRoot, m as mergeBase, r as readBlob, b as readIndex, e as readObject, f as readTree, h as recordRefUpdate, i as resolveRef, j as runHook, u as updateRef, w as walkCommits, k as walkSubmodules, l as walkTree, n as walkWorkingTree, o as writeObject, p as writeSymbolicRef, q as writeTree } from './write-tree-B8G6kgTy.cjs';
+import { c as catFileBatch, a as createCommit, d as diffTrees, g as getRepoRoot, m as mergeBase, r as readBlob, b as readIndex, e as readObject, f as readTree, h as recordRefUpdate, i as resolveRef, j as runHook, u as updateRef, w as walkCommits, k as walkSubmodules, l as walkTree, n as walkWorkingTree, o as writeObject, p as writeSymbolicRef, q as writeTree } from './write-tree-CuhpWKFo.cjs';
 import { b as HttpTransport } from './http-transport-DirKfK2S.cjs';
 
 /**

package/dist/types/chunks/{repository-C4rN09Am.d.ts → repository-DFxFeYi3.d.ts}

@@ -1,6 +1,6 @@
 import { add, branch, catFile, checkout, clone, commit, diff, fetch, fetchMissing, init, log, merge, push, reflog, reset, revParse, rm, sparseCheckout, status, submodules, tag } from '../commands/index.js';
 import { f as FileSystem, H as HashService, C as Compressor, n as RepositoryConfig, L as Logger, P as ProgressReporter, k as HookRunner, b as Context } from './context-BORy7yXb.js';
-import { c as catFileBatch, a as createCommit, d as diffTrees, g as getRepoRoot, m as mergeBase, r as readBlob, b as readIndex, e as readObject, f as readTree, h as recordRefUpdate, i as resolveRef, j as runHook, u as updateRef, w as walkCommits, k as walkSubmodules, l as walkTree, n as walkWorkingTree, o as writeObject, p as writeSymbolicRef, q as writeTree } from './write-tree-BXCDChvv.js';
+import { c as catFileBatch, a as createCommit, d as diffTrees, g as getRepoRoot, m as mergeBase, r as readBlob, b as readIndex, e as readObject, f as readTree, h as recordRefUpdate, i as resolveRef, j as runHook, u as updateRef, w as walkCommits, k as walkSubmodules, l as walkTree, n as walkWorkingTree, o as writeObject, p as writeSymbolicRef, q as writeTree } from './write-tree-Dn1LtIh7.js';
 import { b as HttpTransport } from './http-transport-DirKfK2S.js';
 
 /**

package/dist/types/chunks/{write-tree-B8G6kgTy.d.cts → write-tree-CuhpWKFo.d.cts}

@@ -1,5 +1,5 @@
 import { O as ObjectId, d as FilePath, b as Context, R as RefName, h as HookName } from './context-CMrHCVwK.cjs';
-import { F as FileMode, a as CatFileBatchOptions, C as CatFileBatchEntry, c as CreateCommitInput, D as DiffTreesInput, d as DiffTreesOptions, s as TreeDiff, R as ReadObjectOptions, B as Blob, G as GitObject, T as Tree, r as ResolveRefOptions, U as UpdateRefOptions, W as WalkCommitsOptions, b as Commit, v as WalkSubmodulesOptions, S as SubmoduleEntry, x as WalkTreeOptions, w as WalkTreeEntry, z as WalkWorkingTreeOptions, y as WalkWorkingTreeEntry, t as TreeEntry } from './reflog-entry-BIf-zt__.cjs';
+import { F as FileMode, a as CatFileBatchOptions, C as CatFileBatchEntry, c as CreateCommitInput, D as DiffTreesInput, d as DiffTreesOptions, s as TreeDiff, R as ReadObjectOptions, B as Blob, G as GitObject, T as Tree, r as ResolveRefOptions, U as UpdateRefOptions, W as WalkCommitsOptions, b as Commit, v as WalkSubmodulesOptions, S as SubmoduleEntry, x as WalkTreeOptions, w as WalkTreeEntry, z as WalkWorkingTreeOptions, y as WalkWorkingTreeEntry, t as TreeEntry } from './reflog-entry-DNvSz7S5.cjs';
 
 interface IndexEntryFlags {
     readonly assumeValid: boolean;
@@ -137,6 +137,16 @@ declare function walkWorkingTree(ctx: Context, options?: WalkWorkingTreeOptions)
 
 declare function writeObject(ctx: Context, object: GitObject): Promise<ObjectId>;
 
+/**
+ * Symbolic-ref writer. Produces `ref: <target>\n` files (HEAD and friends).
+ * Used by `init`/`clone`/branch-rename to set the initial HEAD pointer.
+ *
+ * @writes
+ *   surface: symbolicRef
+ *   kind:    byte-identical
+ *   format:  git-symbolic-ref
+ */
+
 /**
  * Write a symbolic ref atomically. Used for HEAD updates that point at a
  * branch, branch renames affecting the current HEAD, and `clone`/`init`

package/dist/types/chunks/{write-tree-BXCDChvv.d.ts → write-tree-Dn1LtIh7.d.ts}

@@ -1,5 +1,5 @@
 import { O as ObjectId, d as FilePath, b as Context, R as RefName, h as HookName } from './context-BORy7yXb.js';
-import { F as FileMode, a as CatFileBatchOptions, C as CatFileBatchEntry, c as CreateCommitInput, D as DiffTreesInput, d as DiffTreesOptions, s as TreeDiff, R as ReadObjectOptions, B as Blob, G as GitObject, T as Tree, r as ResolveRefOptions, U as UpdateRefOptions, W as WalkCommitsOptions, b as Commit, v as WalkSubmodulesOptions, S as SubmoduleEntry, x as WalkTreeOptions, w as WalkTreeEntry, z as WalkWorkingTreeOptions, y as WalkWorkingTreeEntry, t as TreeEntry } from './reflog-entry-D9P2hCgv.js';
+import { F as FileMode, a as CatFileBatchOptions, C as CatFileBatchEntry, c as CreateCommitInput, D as DiffTreesInput, d as DiffTreesOptions, s as TreeDiff, R as ReadObjectOptions, B as Blob, G as GitObject, T as Tree, r as ResolveRefOptions, U as UpdateRefOptions, W as WalkCommitsOptions, b as Commit, v as WalkSubmodulesOptions, S as SubmoduleEntry, x as WalkTreeOptions, w as WalkTreeEntry, z as WalkWorkingTreeOptions, y as WalkWorkingTreeEntry, t as TreeEntry } from './reflog-entry-C2Hsdobk.js';
 
 interface IndexEntryFlags {
     readonly assumeValid: boolean;
@@ -137,6 +137,16 @@ declare function walkWorkingTree(ctx: Context, options?: WalkWorkingTreeOptions)
 
 declare function writeObject(ctx: Context, object: GitObject): Promise<ObjectId>;
 
+/**
+ * Symbolic-ref writer. Produces `ref: <target>\n` files (HEAD and friends).
+ * Used by `init`/`clone`/branch-rename to set the initial HEAD pointer.
+ *
+ * @writes
+ *   surface: symbolicRef
+ *   kind:    byte-identical
+ *   format:  git-symbolic-ref
+ */
+
 /**
  * Write a symbolic ref atomically. Used for HEAD updates that point at a
  * branch, branch renames affecting the current HEAD, and `clone`/`init`

package/dist/types/commands/index.d.cts

@@ -1,5 +1,5 @@
 import { d as FilePath, b as Context, R as RefName, O as ObjectId, m as PromisorRemote } from '../chunks/context-CMrHCVwK.cjs';
-import { C as CatFileBatchEntry, A as AuthorIdentity, s as TreeDiff, q as ReflogEntry, S as SubmoduleEntry } from '../chunks/reflog-entry-BIf-zt__.cjs';
+import { C as CatFileBatchEntry, A as AuthorIdentity, s as TreeDiff, q as ReflogEntry, S as SubmoduleEntry } from '../chunks/reflog-entry-DNvSz7S5.cjs';
 import '../chunks/http-transport-DirKfK2S.cjs';
 
 interface AddOptions {

package/dist/types/commands/index.d.ts

@@ -1,5 +1,5 @@
 import { d as FilePath, b as Context, R as RefName, O as ObjectId, m as PromisorRemote } from '../chunks/context-BORy7yXb.js';
-import { C as CatFileBatchEntry, A as AuthorIdentity, s as TreeDiff, q as ReflogEntry, S as SubmoduleEntry } from '../chunks/reflog-entry-D9P2hCgv.js';
+import { C as CatFileBatchEntry, A as AuthorIdentity, s as TreeDiff, q as ReflogEntry, S as SubmoduleEntry } from '../chunks/reflog-entry-C2Hsdobk.js';
 import '../chunks/http-transport-DirKfK2S.js';
 
 interface AddOptions {

package/dist/types/index.browser.d.cts

@@ -1,9 +1,9 @@
-import { O as OpenRepositoryOptions, R as Repository } from './chunks/repository-BqibvTOu.cjs';
+import { O as OpenRepositoryOptions, R as Repository } from './chunks/repository-DCR_3RVt.cjs';
 export { AdapterSet, consoleProgress, detectRuntime, isBrowser, isNode, noopProgress } from './index.cjs';
 export { P as ProgressReporter } from './chunks/context-CMrHCVwK.cjs';
 import './commands/index.cjs';
-import './chunks/reflog-entry-BIf-zt__.cjs';
-import './chunks/write-tree-B8G6kgTy.cjs';
+import './chunks/reflog-entry-DNvSz7S5.cjs';
+import './chunks/write-tree-CuhpWKFo.cjs';
 import './chunks/http-transport-DirKfK2S.cjs';
 
 /**

package/dist/types/index.browser.d.ts

@@ -1,9 +1,9 @@
-import { O as OpenRepositoryOptions, R as Repository } from './chunks/repository-C4rN09Am.js';
+import { O as OpenRepositoryOptions, R as Repository } from './chunks/repository-DFxFeYi3.js';
 export { AdapterSet, consoleProgress, detectRuntime, isBrowser, isNode, noopProgress } from './index.js';
 export { P as ProgressReporter } from './chunks/context-BORy7yXb.js';
 import './commands/index.js';
-import './chunks/reflog-entry-D9P2hCgv.js';
-import './chunks/write-tree-BXCDChvv.js';
+import './chunks/reflog-entry-C2Hsdobk.js';
+import './chunks/write-tree-Dn1LtIh7.js';
 import './chunks/http-transport-DirKfK2S.js';
 
 /**

package/dist/types/index.d.cts

@@ -3,7 +3,7 @@ export { A as AuthStrategy, a as AuthorIdentity, b as Context, c as CreateContex
 import { b as HttpTransport } from './chunks/http-transport-DirKfK2S.cjs';
 export { H as HttpRequest, a as HttpResponse } from './chunks/http-transport-DirKfK2S.cjs';
 export { AddOptions, AddResult, BranchAction, BranchInfo, BranchResult, CatFileInput, CatFileResult, ChangeEntry, ChangeKind, CheckoutOptions, CheckoutResult, CloneOptions, CloneResult, CommitOptions, CommitResult, DiffOptions, FetchMissingOptions, FetchMissingResult, FetchOptions, FetchResult, InitOptions, InitResult, LogEntry, LogOptions, MergeOptions, MergeResult, PushOptions, PushResult, ReflogAction, ReflogResult, ReflogShowEntry, ResetMode, ResetOptions, ResetResult, RmOptions, RmResult, SparseCheckoutAction, SparseCheckoutResult, StatusResult, SubmodulesAction, SubmodulesResult, TagAction, TagInfo, TagResult, add, branch, catFile, checkout, clone, commit, createPromisorRemote, diff, fetch, fetchMissing, init, log, merge, push, reflog, reset, revParse, rm, sparseCheckout, status, submodules, tag } from './commands/index.cjs';
-export { C as CatFileBatchEntry, S as SubmoduleEntry } from './chunks/reflog-entry-BIf-zt__.cjs';
+export { C as CatFileBatchEntry, S as SubmoduleEntry } from './chunks/reflog-entry-DNvSz7S5.cjs';
 
 /**
  * The four adapter ports the facade plumbs into the Context. Each runtime

package/dist/types/index.d.ts

@@ -3,7 +3,7 @@ export { A as AuthStrategy, a as AuthorIdentity, b as Context, c as CreateContex
 import { b as HttpTransport } from './chunks/http-transport-DirKfK2S.js';
 export { H as HttpRequest, a as HttpResponse } from './chunks/http-transport-DirKfK2S.js';
 export { AddOptions, AddResult, BranchAction, BranchInfo, BranchResult, CatFileInput, CatFileResult, ChangeEntry, ChangeKind, CheckoutOptions, CheckoutResult, CloneOptions, CloneResult, CommitOptions, CommitResult, DiffOptions, FetchMissingOptions, FetchMissingResult, FetchOptions, FetchResult, InitOptions, InitResult, LogEntry, LogOptions, MergeOptions, MergeResult, PushOptions, PushResult, ReflogAction, ReflogResult, ReflogShowEntry, ResetMode, ResetOptions, ResetResult, RmOptions, RmResult, SparseCheckoutAction, SparseCheckoutResult, StatusResult, SubmodulesAction, SubmodulesResult, TagAction, TagInfo, TagResult, add, branch, catFile, checkout, clone, commit, createPromisorRemote, diff, fetch, fetchMissing, init, log, merge, push, reflog, reset, revParse, rm, sparseCheckout, status, submodules, tag } from './commands/index.js';
-export { C as CatFileBatchEntry, S as SubmoduleEntry } from './chunks/reflog-entry-D9P2hCgv.js';
+export { C as CatFileBatchEntry, S as SubmoduleEntry } from './chunks/reflog-entry-C2Hsdobk.js';
 
 /**
  * The four adapter ports the facade plumbs into the Context. Each runtime

package/dist/types/index.default.d.cts

@@ -1,9 +1,9 @@
-import { O as OpenRepositoryOptions, R as Repository } from './chunks/repository-BqibvTOu.cjs';
+import { O as OpenRepositoryOptions, R as Repository } from './chunks/repository-DCR_3RVt.cjs';
 export { AdapterSet, consoleProgress, detectRuntime, isBrowser, isNode, noopProgress } from './index.cjs';
 export { P as ProgressReporter } from './chunks/context-CMrHCVwK.cjs';
 import './commands/index.cjs';
-import './chunks/reflog-entry-BIf-zt__.cjs';
-import './chunks/write-tree-B8G6kgTy.cjs';
+import './chunks/reflog-entry-DNvSz7S5.cjs';
+import './chunks/write-tree-CuhpWKFo.cjs';
 import './chunks/http-transport-DirKfK2S.cjs';
 
 /**

package/dist/types/index.default.d.ts

@@ -1,9 +1,9 @@
-import { O as OpenRepositoryOptions, R as Repository } from './chunks/repository-C4rN09Am.js';
+import { O as OpenRepositoryOptions, R as Repository } from './chunks/repository-DFxFeYi3.js';
 export { AdapterSet, consoleProgress, detectRuntime, isBrowser, isNode, noopProgress } from './index.js';
 export { P as ProgressReporter } from './chunks/context-BORy7yXb.js';
 import './commands/index.js';
-import './chunks/reflog-entry-D9P2hCgv.js';
-import './chunks/write-tree-BXCDChvv.js';
+import './chunks/reflog-entry-C2Hsdobk.js';
+import './chunks/write-tree-Dn1LtIh7.js';
 import './chunks/http-transport-DirKfK2S.js';
 
 /**

package/dist/types/index.node.d.cts

@@ -1,9 +1,9 @@
-import { O as OpenRepositoryOptions, R as Repository } from './chunks/repository-BqibvTOu.cjs';
+import { O as OpenRepositoryOptions, R as Repository } from './chunks/repository-DCR_3RVt.cjs';
 export { AdapterSet, consoleProgress, detectRuntime, isBrowser, isNode, noopProgress } from './index.cjs';
 export { P as ProgressReporter } from './chunks/context-CMrHCVwK.cjs';
 import './commands/index.cjs';
-import './chunks/reflog-entry-BIf-zt__.cjs';
-import './chunks/write-tree-B8G6kgTy.cjs';
+import './chunks/reflog-entry-DNvSz7S5.cjs';
+import './chunks/write-tree-CuhpWKFo.cjs';
 import './chunks/http-transport-DirKfK2S.cjs';
 
 /**

package/dist/types/index.node.d.ts

@@ -1,9 +1,9 @@
-import { O as OpenRepositoryOptions, R as Repository } from './chunks/repository-C4rN09Am.js';
+import { O as OpenRepositoryOptions, R as Repository } from './chunks/repository-DFxFeYi3.js';
 export { AdapterSet, consoleProgress, detectRuntime, isBrowser, isNode, noopProgress } from './index.js';
 export { P as ProgressReporter } from './chunks/context-BORy7yXb.js';
 import './commands/index.js';
-import './chunks/reflog-entry-D9P2hCgv.js';
-import './chunks/write-tree-BXCDChvv.js';
+import './chunks/reflog-entry-C2Hsdobk.js';
+import './chunks/write-tree-Dn1LtIh7.js';
 import './chunks/http-transport-DirKfK2S.js';
 
 /**

package/dist/types/primitives/index.d.cts

@@ -1,8 +1,8 @@
-import { G as GitIndex, I as IndexEntry } from '../chunks/write-tree-B8G6kgTy.cjs';
-export { H as HookInput, c as catFileBatch, a as createCommit, d as diffTrees, g as getRepoRoot, m as mergeBase, r as readBlob, b as readIndex, e as readObject, f as readTree, h as recordRefUpdate, i as resolveRef, j as runHook, s as sparseCheckoutPath, u as updateRef, w as walkCommits, k as walkSubmodules, l as walkTree, n as walkWorkingTree, o as writeObject, p as writeSymbolicRef, q as writeTree } from '../chunks/write-tree-B8G6kgTy.cjs';
+import { G as GitIndex, I as IndexEntry } from '../chunks/write-tree-CuhpWKFo.cjs';
+export { H as HookInput, c as catFileBatch, a as createCommit, d as diffTrees, g as getRepoRoot, m as mergeBase, r as readBlob, b as readIndex, e as readObject, f as readTree, h as recordRefUpdate, i as resolveRef, j as runHook, s as sparseCheckoutPath, u as updateRef, w as walkCommits, k as walkSubmodules, l as walkTree, n as walkWorkingTree, o as writeObject, p as writeSymbolicRef, q as writeTree } from '../chunks/write-tree-CuhpWKFo.cjs';
 import { d as FilePath, O as ObjectId, b as Context, R as RefName } from '../chunks/context-CMrHCVwK.cjs';
-import { F as FileMode, A as AuthorIdentity, q as ReflogEntry } from '../chunks/reflog-entry-BIf-zt__.cjs';
-export { C as CatFileBatchEntry, a as CatFileBatchOptions, c as CreateCommitInput, D as DiffTreesInput, d as DiffTreesOptions, M as MAX_COMMIT_MESSAGE_BYTES, e as MAX_GITIGNORE_BYTES, f as MAX_GITMODULES_BYTES, g as MAX_HAVES, h as MAX_INDEX_BYTES, i as MAX_PEEL_DEPTH, j as MAX_PUSH_OBJECTS, k as MAX_REFLOG_BYTES, l as MAX_SUBMODULE_DEPTH, m as MAX_SYMBOLIC_REF_DEPTH, n as MAX_WALK_QUEUE_SIZE, o as MAX_WALK_SEEDS, p as MAX_WORKING_TREE_BLOB_BYTES, R as ReadObjectOptions, r as ResolveRefOptions, S as SubmoduleEntry, s as TreeDiff, U as UpdateRefOptions, W as WalkCommitsOptions, u as WalkIgnorePredicate, v as WalkSubmodulesOptions, w as WalkTreeEntry, x as WalkTreeOptions, y as WalkWorkingTreeEntry, z as WalkWorkingTreeOptions } from '../chunks/reflog-entry-BIf-zt__.cjs';
+import { F as FileMode, A as AuthorIdentity, q as ReflogEntry } from '../chunks/reflog-entry-DNvSz7S5.cjs';
+export { C as CatFileBatchEntry, a as CatFileBatchOptions, c as CreateCommitInput, D as DiffTreesInput, d as DiffTreesOptions, M as MAX_COMMIT_MESSAGE_BYTES, e as MAX_GITIGNORE_BYTES, f as MAX_GITMODULES_BYTES, g as MAX_HAVES, h as MAX_INDEX_BYTES, i as MAX_PEEL_DEPTH, j as MAX_PUSH_OBJECTS, k as MAX_REFLOG_BYTES, l as MAX_SUBMODULE_DEPTH, m as MAX_SYMBOLIC_REF_DEPTH, n as MAX_WALK_QUEUE_SIZE, o as MAX_WALK_SEEDS, p as MAX_WORKING_TREE_BLOB_BYTES, R as ReadObjectOptions, r as ResolveRefOptions, S as SubmoduleEntry, s as TreeDiff, U as UpdateRefOptions, W as WalkCommitsOptions, u as WalkIgnorePredicate, v as WalkSubmodulesOptions, w as WalkTreeEntry, x as WalkTreeOptions, y as WalkWorkingTreeEntry, z as WalkWorkingTreeOptions } from '../chunks/reflog-entry-DNvSz7S5.cjs';
 import { b as HttpTransport } from '../chunks/http-transport-DirKfK2S.cjs';
 
 /** `true` ⇒ the path is in the sparse set (materialise it). */
@@ -425,6 +425,11 @@ declare const updateCoreConfig: (ctx: Context, entries: Record<string, string>)
  * Write the `.git/info/sparse-checkout` pattern file. The command tier
  * computes the text (via `serializeCone` or raw non-cone lines); this
  * primitive only persists it (design §7.3).
+ *
+ * @writes
+ *   surface: sparseCheckoutFile
+ *   kind:    byte-identical
+ *   format:  git-sparse-checkout
  */
 
 /**

package/dist/types/primitives/index.d.ts

@@ -1,8 +1,8 @@
-import { G as GitIndex, I as IndexEntry } from '../chunks/write-tree-BXCDChvv.js';
-export { H as HookInput, c as catFileBatch, a as createCommit, d as diffTrees, g as getRepoRoot, m as mergeBase, r as readBlob, b as readIndex, e as readObject, f as readTree, h as recordRefUpdate, i as resolveRef, j as runHook, s as sparseCheckoutPath, u as updateRef, w as walkCommits, k as walkSubmodules, l as walkTree, n as walkWorkingTree, o as writeObject, p as writeSymbolicRef, q as writeTree } from '../chunks/write-tree-BXCDChvv.js';
+import { G as GitIndex, I as IndexEntry } from '../chunks/write-tree-Dn1LtIh7.js';
+export { H as HookInput, c as catFileBatch, a as createCommit, d as diffTrees, g as getRepoRoot, m as mergeBase, r as readBlob, b as readIndex, e as readObject, f as readTree, h as recordRefUpdate, i as resolveRef, j as runHook, s as sparseCheckoutPath, u as updateRef, w as walkCommits, k as walkSubmodules, l as walkTree, n as walkWorkingTree, o as writeObject, p as writeSymbolicRef, q as writeTree } from '../chunks/write-tree-Dn1LtIh7.js';
 import { d as FilePath, O as ObjectId, b as Context, R as RefName } from '../chunks/context-BORy7yXb.js';
-import { F as FileMode, A as AuthorIdentity, q as ReflogEntry } from '../chunks/reflog-entry-D9P2hCgv.js';
-export { C as CatFileBatchEntry, a as CatFileBatchOptions, c as CreateCommitInput, D as DiffTreesInput, d as DiffTreesOptions, M as MAX_COMMIT_MESSAGE_BYTES, e as MAX_GITIGNORE_BYTES, f as MAX_GITMODULES_BYTES, g as MAX_HAVES, h as MAX_INDEX_BYTES, i as MAX_PEEL_DEPTH, j as MAX_PUSH_OBJECTS, k as MAX_REFLOG_BYTES, l as MAX_SUBMODULE_DEPTH, m as MAX_SYMBOLIC_REF_DEPTH, n as MAX_WALK_QUEUE_SIZE, o as MAX_WALK_SEEDS, p as MAX_WORKING_TREE_BLOB_BYTES, R as ReadObjectOptions, r as ResolveRefOptions, S as SubmoduleEntry, s as TreeDiff, U as UpdateRefOptions, W as WalkCommitsOptions, u as WalkIgnorePredicate, v as WalkSubmodulesOptions, w as WalkTreeEntry, x as WalkTreeOptions, y as WalkWorkingTreeEntry, z as WalkWorkingTreeOptions } from '../chunks/reflog-entry-D9P2hCgv.js';
+import { F as FileMode, A as AuthorIdentity, q as ReflogEntry } from '../chunks/reflog-entry-C2Hsdobk.js';
+export { C as CatFileBatchEntry, a as CatFileBatchOptions, c as CreateCommitInput, D as DiffTreesInput, d as DiffTreesOptions, M as MAX_COMMIT_MESSAGE_BYTES, e as MAX_GITIGNORE_BYTES, f as MAX_GITMODULES_BYTES, g as MAX_HAVES, h as MAX_INDEX_BYTES, i as MAX_PEEL_DEPTH, j as MAX_PUSH_OBJECTS, k as MAX_REFLOG_BYTES, l as MAX_SUBMODULE_DEPTH, m as MAX_SYMBOLIC_REF_DEPTH, n as MAX_WALK_QUEUE_SIZE, o as MAX_WALK_SEEDS, p as MAX_WORKING_TREE_BLOB_BYTES, R as ReadObjectOptions, r as ResolveRefOptions, S as SubmoduleEntry, s as TreeDiff, U as UpdateRefOptions, W as WalkCommitsOptions, u as WalkIgnorePredicate, v as WalkSubmodulesOptions, w as WalkTreeEntry, x as WalkTreeOptions, y as WalkWorkingTreeEntry, z as WalkWorkingTreeOptions } from '../chunks/reflog-entry-C2Hsdobk.js';
 import { b as HttpTransport } from '../chunks/http-transport-DirKfK2S.js';
 
 /** `true` ⇒ the path is in the sparse set (materialise it). */
@@ -425,6 +425,11 @@ declare const updateCoreConfig: (ctx: Context, entries: Record<string, string>)
  * Write the `.git/info/sparse-checkout` pattern file. The command tier
  * computes the text (via `serializeCone` or raw non-cone lines); this
  * primitive only persists it (design §7.3).
+ *
+ * @writes
+ *   surface: sparseCheckoutFile
+ *   kind:    byte-identical
+ *   format:  git-sparse-checkout
  */
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scolladon/tsgit",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Lightning-fast git, pure TypeScript, everywhere.",
   "type": "module",
   "license": "MIT",
@@ -166,6 +166,7 @@
   "scripts": {
     "prepare": "husky",
     "build": "wireit",
+    "build:parity": "wireit",
     "check": "wireit",
     "check:fix": "wireit",
     "check:types": "wireit",
@@ -178,20 +179,29 @@
     "test:integration": "wireit",
     "test:posix-integration": "wireit",
     "test:win-integration": "wireit",
+    "test:parity": "wireit",
+    "test:parity:deno": "wireit",
+    "test:parity:bun": "wireit",
+    "test:parity:workers": "wireit",
     "test:e2e": "wireit",
     "test:coverage": "wireit",
     "test:mutation": "wireit",
-    "test:mutation:incremental": "wireit",
+    "test:mutation:pr": "wireit",
     "test:bench": "wireit",
     "bench:summary": "wireit",
-    "bench:fixture": "node --experimental-strip-types scripts/gen-bench-fixture.ts",
-    "profile": "npm run build && node --experimental-strip-types scripts/profile.ts",
+    "bench:fixture": "node --experimental-strip-types tooling/gen-bench-fixture.ts",
+    "profile": "npm run build && node --experimental-strip-types tooling/profile.ts",
     "docs": "wireit",
     "docs:check": "wireit",
     "docs:json": "wireit",
     "check:doc-links": "wireit",
     "check:doc-coverage": "wireit",
     "check:doc-typedoc": "wireit",
+    "check:test-pyramid": "wireit",
+    "check:parity-fixtures": "wireit",
+    "check:browser-surface": "wireit",
+    "check:write-surfaces": "wireit",
+    "check:mutation-budgets": "wireit",
     "verify:tarball": "wireit",
     "check:size": "wireit",
     "check:exports": "wireit",
@@ -345,15 +355,81 @@
       ],
       "output": []
     },
+    "test:parity": {
+      "command": "vitest run --project parity",
+      "dependencies": [
+        "check:types"
+      ],
+      "files": [
+        "src/**/*.ts",
+        "test/parity/**/*.ts",
+        "vitest.config.ts"
+      ],
+      "output": []
+    },
+    "test:parity:deno": {
+      "command": "deno test --no-check --allow-read --allow-write --allow-env --no-prompt --config test/runtime-parity/deno/deno.json test/runtime-parity/deno/",
+      "dependencies": [
+        "build"
+      ],
+      "files": [
+        "dist/esm/**/*.js",
+        "test/runtime-parity/deno/**",
+        "test/parity/scenarios/**/*.ts",
+        "test/parity/fixtures.ts"
+      ],
+      "output": []
+    },
+    "test:parity:bun": {
+      "command": "bun test test/runtime-parity/bun/",
+      "dependencies": [
+        "build"
+      ],
+      "files": [
+        "dist/esm/**/*.js",
+        "test/runtime-parity/bun/**",
+        "test/parity/scenarios/**/*.ts",
+        "test/parity/fixtures.ts"
+      ],
+      "output": []
+    },
+    "test:parity:workers": {
+      "command": "vitest run --config test/runtime-parity/workers/vitest.config.ts",
+      "dependencies": [
+        "build"
+      ],
+      "files": [
+        "dist/esm/**/*.js",
+        "test/runtime-parity/workers/**",
+        "test/parity/scenarios/**/*.ts",
+        "test/parity/fixtures.ts"
+      ],
+      "output": []
+    },
+    "build:parity": {
+      "command": "node --experimental-strip-types tooling/build-parity-bundle.ts",
+      "files": [
+        "test/parity/scenarios/**/*.ts",
+        "test/parity/fixtures.ts",
+        "test/browser/parity-scenarios.bundle.ts",
+        "tooling/build-parity-bundle.ts"
+      ],
+      "output": [
+        "test/browser/parity-scenarios.bundle.js",
+        "test/browser/parity-scenarios.bundle.js.map"
+      ]
+    },
     "test:e2e": {
       "command": "npx playwright test",
       "dependencies": [
-        "build"
+        "build",
+        "build:parity"
       ],
       "files": [
         "test/browser/**/*.ts",
         "test/browser/**/*.mjs",
         "test/browser/index.html",
+        "test/browser/parity-scenarios.bundle.js",
         "playwright.config.ts"
       ],
       "output": [
@@ -389,14 +465,15 @@
         "reports/mutation/**"
       ]
     },
-    "test:mutation:incremental": {
-      "command": "stryker run --incremental",
+    "test:mutation:pr": {
+      "command": "node --experimental-strip-types tooling/run-stryker-pr.ts",
       "dependencies": [
         "test:unit"
       ],
       "files": [
         "src/**/*.ts",
         "test/unit/**/*.ts",
+        "tooling/run-stryker-pr.ts",
         "stryker.config.json",
         "vitest.config.ts"
       ],
@@ -419,12 +496,12 @@
       ]
     },
     "bench:summary": {
-      "command": "node --experimental-strip-types scripts/bench-summarize.ts",
+      "command": "node --experimental-strip-types tooling/bench-summarize.ts",
       "dependencies": [
         "test:bench"
       ],
       "files": [
-        "scripts/bench-summarize.ts",
+        "tooling/bench-summarize.ts",
         "reports/benchmarks/raw.json"
       ],
       "output": [
@@ -469,11 +546,11 @@
       "command": "lychee --config .lychee.toml README.md CONTRIBUTING.md RUNBOOK.md SECURITY.md 'docs/**/*.md'"
     },
     "check:doc-coverage": {
-      "command": "node --experimental-strip-types scripts/check-doc-coverage.ts",
+      "command": "node --experimental-strip-types tooling/check-doc-coverage.ts",
       "files": [
         "src/repository.ts",
-        "scripts/check-doc-coverage.ts",
-        "scripts/check-doc-coverage.allowlist.json",
+        "tooling/check-doc-coverage.ts",
+        "tooling/check-doc-coverage.allowlist.json",
         "docs/use/commands/**/*.md",
         "docs/use/primitives/**/*.md"
       ],
@@ -485,13 +562,79 @@
         "docs:json"
       ]
     },
+    "check:test-pyramid": {
+      "command": "node --experimental-strip-types tooling/audit-test-pyramid.ts",
+      "files": [
+        "tooling/audit-test-pyramid.ts",
+        "tooling/test-pyramid/**/*.ts",
+        "test-pyramid-budgets.json",
+        "test/unit/**/*.test.ts",
+        "test/integration/**/*.test.ts",
+        "test/browser/**/*.spec.ts"
+      ],
+      "output": [
+        "reports/test-pyramid.json",
+        "reports/test-pyramid.md"
+      ]
+    },
+    "check:parity-fixtures": {
+      "command": "node --experimental-strip-types tooling/audit-parity-fixtures.ts",
+      "files": [
+        "tooling/audit-parity-fixtures.ts",
+        "tooling/parity-fixtures/**/*.ts",
+        "test/parity/scenarios/**/*.ts",
+        "test/parity/fixtures.ts"
+      ],
+      "output": [
+        "reports/parity-fixtures.json"
+      ]
+    },
+    "check:browser-surface": {
+      "command": "node --experimental-strip-types tooling/audit-browser-surface.ts",
+      "files": [
+        "src/repository.ts",
+        "test/browser/**/*.spec.ts",
+        "test/parity/scenarios/**/*.ts",
+        "tooling/audit-browser-surface.ts",
+        "tooling/audit-browser-surface/**/*.ts",
+        "tooling/audit-browser-surface.allowlist.json"
+      ],
+      "output": [
+        "reports/browser-surface-coverage.json"
+      ]
+    },
+    "check:write-surfaces": {
+      "command": "node --experimental-strip-types tooling/audit-write-surfaces.ts",
+      "files": [
+        "src/**/*.ts",
+        "test/integration/**/*.test.ts",
+        "tooling/audit-write-surfaces.ts",
+        "tooling/audit-write-surfaces/**/*.ts",
+        "tooling/audit-write-surfaces.allowlist.json",
+        "tooling/test-pyramid/parse-proves-header.ts",
+        "tooling/test-pyramid/parse-manifest.ts"
+      ],
+      "output": [
+        "reports/write-surface-coverage.json"
+      ]
+    },
+    "check:mutation-budgets": {
+      "command": "node --experimental-strip-types tooling/check-mutation-budgets.ts",
+      "files": [
+        "tooling/check-mutation-budgets.ts",
+        "tooling/mutation-budgets.ts",
+        "mutation-budgets.json",
+        "reports/mutation/mutation-report.json"
+      ],
+      "output": []
+    },
     "verify:tarball": {
-      "command": "bash scripts/verify-tarball.sh",
+      "command": "bash tooling/verify-tarball.sh",
       "dependencies": [
         "build"
       ],
       "files": [
-        "scripts/verify-tarball.sh",
+        "tooling/verify-tarball.sh",
         "dist/**",
         "package.json",
         "LICENSE",
@@ -562,8 +705,13 @@
         "check:security",
         "check:doc-coverage",
         "check:doc-typedoc",
+        "check:test-pyramid",
+        "check:parity-fixtures",
+        "check:browser-surface",
+        "check:write-surfaces",
         "test:coverage",
-        "test:integration"
+        "test:integration",
+        "test:parity"
       ]
     }
   },
@@ -576,6 +724,8 @@
   "devDependencies": {
     "@arethetypeswrong/cli": "0.18.2",
     "@biomejs/biome": "2.4.15",
+    "@cloudflare/vitest-pool-workers": "0.16.9",
+    "@cloudflare/workers-types": "4.20260525.1",
     "@commitlint/cli": "21.0.1",
     "@commitlint/config-conventional": "21.0.1",
     "@ls-lint/ls-lint": "2.3.1",
@@ -590,13 +740,14 @@
     "@types/node": "25.9.1",
     "@vitest/coverage-v8": "4.1.7",
     "cspell": "10.0.0",
-    "dependency-cruiser": "17.4.0",
+    "dependency-cruiser": "17.4.2",
     "fast-check": "4.8.0",
     "husky": "9.1.7",
-    "isomorphic-git": "1.38.1",
-    "jscpd": "4.2.3",
+    "isomorphic-git": "1.38.2",
+    "jscpd": "4.2.4",
     "knip": "6.14.2",
     "lint-staged": "17.0.5",
+    "minimatch": "10.2.5",
     "rollup": "4.60.4",
     "rollup-plugin-dts": "6.4.1",
     "rollup-plugin-visualizer": "7.0.1",
@@ -604,6 +755,7 @@
     "typedoc": "0.28.19",
     "typescript": "6.0.3",
     "vitest": "4.1.7",
-    "wireit": "0.14.12"
+    "wireit": "0.14.12",
+    "wrangler": "4.94.0"
   }
 }