@scolladon/tsgit 1.3.0 → 2.0.1

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

@@ -1,5 +1,5 @@
-import { b as Context, C as Compressor, I as InflateStreamResult, f as FileSystem, e as FileStat, D as DirEntry, F as FileHandle, H as HashService, g as Hasher } from '../../chunks/context-CMrHCVwK.cjs';
-import { b as HttpTransport, H as HttpRequest, a as HttpResponse } from '../../chunks/http-transport-DirKfK2S.cjs';
+import { b as Context, C as Compressor, I as InflateStreamResult, F as FileSystem, d as FileStat, D as DirEntry, e as FileHandle, H as HashService, f as Hasher } from '../../chunks/context-YDw6qicq.cjs';
+import { H as HttpTransport, a as HttpRequest, b as HttpResponse } from '../../chunks/http-transport--_NdQOiw.cjs';
 
 interface BrowserAdapterOptions {
     readonly rootHandle: FileSystemDirectoryHandle;
@@ -43,6 +43,9 @@ declare class BrowserFileSystem implements FileSystem {
     chmod(path: string, _mode: number): Promise<void>;
     rmRecursive(path: string): Promise<void>;
     openWithNoFollow(_path: string, _mode: 'read' | 'write'): Promise<FileHandle>;
+    homedir(): string;
+    xdgConfigHome(): string;
+    systemConfigPath(): string;
     private splitPath;
     private resolveFileHandle;
     private resolveDirHandle;

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

@@ -1,5 +1,5 @@
-import { b as Context, C as Compressor, I as InflateStreamResult, f as FileSystem, e as FileStat, D as DirEntry, F as FileHandle, H as HashService, g as Hasher } from '../../chunks/context-BORy7yXb.js';
-import { b as HttpTransport, H as HttpRequest, a as HttpResponse } from '../../chunks/http-transport-DirKfK2S.js';
+import { b as Context, C as Compressor, I as InflateStreamResult, F as FileSystem, d as FileStat, D as DirEntry, e as FileHandle, H as HashService, f as Hasher } from '../../chunks/context-CCL0_F8R.js';
+import { H as HttpTransport, a as HttpRequest, b as HttpResponse } from '../../chunks/http-transport--_NdQOiw.js';
 
 interface BrowserAdapterOptions {
     readonly rootHandle: FileSystemDirectoryHandle;
@@ -43,6 +43,9 @@ declare class BrowserFileSystem implements FileSystem {
     chmod(path: string, _mode: number): Promise<void>;
     rmRecursive(path: string): Promise<void>;
     openWithNoFollow(_path: string, _mode: 'read' | 'write'): Promise<FileHandle>;
+    homedir(): string;
+    xdgConfigHome(): string;
+    systemConfigPath(): string;
     private splitPath;
     private resolveFileHandle;
     private resolveDirHandle;

package/dist/types/adapters/memory/index.d.cts

@@ -1,5 +1,5 @@
-import { k as HookRunner, b as Context, C as Compressor, I as InflateStreamResult, f as FileSystem, e as FileStat, D as DirEntry, F as FileHandle, H as HashService, g as Hasher, h as HookName, j as HookResult, i as HookRequest } from '../../chunks/context-CMrHCVwK.cjs';
-import { b as HttpTransport, H as HttpRequest, a as HttpResponse } from '../../chunks/http-transport-DirKfK2S.cjs';
+import { a as HookRunner, b as Context, C as Compressor, I as InflateStreamResult, F as FileSystem, d as FileStat, D as DirEntry, e as FileHandle, H as HashService, f as Hasher, g as HookName, h as HookResult, i as HookRequest } from '../../chunks/context-YDw6qicq.cjs';
+import { H as HttpTransport, a as HttpRequest, b as HttpResponse } from '../../chunks/http-transport--_NdQOiw.cjs';
 
 interface MemoryAdapterOptions {
     readonly files?: Readonly<Record<string, Uint8Array>>;
@@ -11,6 +11,12 @@ interface MemoryAdapterOptions {
     readonly homeDir?: string;
     /** Optional hook runner exposed via `ctx.hooks` (default: undefined — hooks inert). */
     readonly hooks?: HookRunner;
+    /** Override for `fs.homedir()` (default: `'/home/user'`). */
+    readonly home?: string;
+    /** Override for `fs.xdgConfigHome()` (default: `'/home/user/.config'`). */
+    readonly xdg?: string;
+    /** Override for `fs.systemConfigPath()` (default: `'/etc/gitconfig'`). */
+    readonly systemConfig?: string;
 }
 declare function createMemoryContext(options?: MemoryAdapterOptions): Context;
 
@@ -25,6 +31,9 @@ declare class MemoryCompressor implements Compressor {
 interface MemoryFileSystemOptions {
     readonly rootDir: string;
     readonly files?: Readonly<Record<string, Uint8Array>>;
+    readonly home?: string;
+    readonly xdg?: string;
+    readonly systemConfig?: string;
 }
 declare class MemoryFileSystem implements FileSystem {
     private readonly files;
@@ -32,7 +41,13 @@ declare class MemoryFileSystem implements FileSystem {
     private readonly symlinks;
     private readonly times;
     private readonly rootDir;
+    private readonly homePath;
+    private readonly xdgPath;
+    private readonly systemPath;
     constructor(options: MemoryFileSystemOptions);
+    homedir: () => string;
+    xdgConfigHome: () => string;
+    systemConfigPath: () => string;
     read: (path: string) => Promise<Uint8Array>;
     readSlice: (path: string, offset: number, length: number) => Promise<Uint8Array>;
     readUtf8: (path: string) => Promise<string>;

package/dist/types/adapters/memory/index.d.ts

@@ -1,5 +1,5 @@
-import { k as HookRunner, b as Context, C as Compressor, I as InflateStreamResult, f as FileSystem, e as FileStat, D as DirEntry, F as FileHandle, H as HashService, g as Hasher, h as HookName, j as HookResult, i as HookRequest } from '../../chunks/context-BORy7yXb.js';
-import { b as HttpTransport, H as HttpRequest, a as HttpResponse } from '../../chunks/http-transport-DirKfK2S.js';
+import { a as HookRunner, b as Context, C as Compressor, I as InflateStreamResult, F as FileSystem, d as FileStat, D as DirEntry, e as FileHandle, H as HashService, f as Hasher, g as HookName, h as HookResult, i as HookRequest } from '../../chunks/context-CCL0_F8R.js';
+import { H as HttpTransport, a as HttpRequest, b as HttpResponse } from '../../chunks/http-transport--_NdQOiw.js';
 
 interface MemoryAdapterOptions {
     readonly files?: Readonly<Record<string, Uint8Array>>;
@@ -11,6 +11,12 @@ interface MemoryAdapterOptions {
     readonly homeDir?: string;
     /** Optional hook runner exposed via `ctx.hooks` (default: undefined — hooks inert). */
     readonly hooks?: HookRunner;
+    /** Override for `fs.homedir()` (default: `'/home/user'`). */
+    readonly home?: string;
+    /** Override for `fs.xdgConfigHome()` (default: `'/home/user/.config'`). */
+    readonly xdg?: string;
+    /** Override for `fs.systemConfigPath()` (default: `'/etc/gitconfig'`). */
+    readonly systemConfig?: string;
 }
 declare function createMemoryContext(options?: MemoryAdapterOptions): Context;
 
@@ -25,6 +31,9 @@ declare class MemoryCompressor implements Compressor {
 interface MemoryFileSystemOptions {
     readonly rootDir: string;
     readonly files?: Readonly<Record<string, Uint8Array>>;
+    readonly home?: string;
+    readonly xdg?: string;
+    readonly systemConfig?: string;
 }
 declare class MemoryFileSystem implements FileSystem {
     private readonly files;
@@ -32,7 +41,13 @@ declare class MemoryFileSystem implements FileSystem {
     private readonly symlinks;
     private readonly times;
     private readonly rootDir;
+    private readonly homePath;
+    private readonly xdgPath;
+    private readonly systemPath;
     constructor(options: MemoryFileSystemOptions);
+    homedir: () => string;
+    xdgConfigHome: () => string;
+    systemConfigPath: () => string;
     read: (path: string) => Promise<Uint8Array>;
     readSlice: (path: string, offset: number, length: number) => Promise<Uint8Array>;
     readUtf8: (path: string) => Promise<string>;

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

@@ -1,5 +1,5 @@
-import { b as Context, C as Compressor, I as InflateStreamResult, f as FileSystem, e as FileStat, D as DirEntry, F as FileHandle, H as HashService, g as Hasher, k as HookRunner, i as HookRequest, j as HookResult } from '../../chunks/context-CMrHCVwK.cjs';
-import { b as HttpTransport, H as HttpRequest, a as HttpResponse } from '../../chunks/http-transport-DirKfK2S.cjs';
+import { b as Context, C as Compressor, I as InflateStreamResult, F as FileSystem, d as FileStat, D as DirEntry, e as FileHandle, H as HashService, f as Hasher, a as HookRunner, i as HookRequest, h as HookResult } from '../../chunks/context-YDw6qicq.cjs';
+import { H as HttpTransport, a as HttpRequest, b as HttpResponse } from '../../chunks/http-transport--_NdQOiw.cjs';
 
 interface NodeAdapterOptions {
     readonly workDir: string;
@@ -171,6 +171,9 @@ declare class NodeFileSystem implements FileSystem {
     private realpathForCreation;
     private resolveForMode;
     private checkContainment;
+    homedir(): string;
+    xdgConfigHome(): string;
+    systemConfigPath(): string;
 }
 
 type Algorithm = 'sha1' | 'sha256';

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

@@ -1,5 +1,5 @@
-import { b as Context, C as Compressor, I as InflateStreamResult, f as FileSystem, e as FileStat, D as DirEntry, F as FileHandle, H as HashService, g as Hasher, k as HookRunner, i as HookRequest, j as HookResult } from '../../chunks/context-BORy7yXb.js';
-import { b as HttpTransport, H as HttpRequest, a as HttpResponse } from '../../chunks/http-transport-DirKfK2S.js';
+import { b as Context, C as Compressor, I as InflateStreamResult, F as FileSystem, d as FileStat, D as DirEntry, e as FileHandle, H as HashService, f as Hasher, a as HookRunner, i as HookRequest, h as HookResult } from '../../chunks/context-CCL0_F8R.js';
+import { H as HttpTransport, a as HttpRequest, b as HttpResponse } from '../../chunks/http-transport--_NdQOiw.js';
 
 interface NodeAdapterOptions {
     readonly workDir: string;
@@ -171,6 +171,9 @@ declare class NodeFileSystem implements FileSystem {
     private realpathForCreation;
     private resolveForMode;
     private checkContainment;
+    homedir(): string;
+    xdgConfigHome(): string;
+    systemConfigPath(): string;
 }
 
 type Algorithm = 'sha1' | 'sha256';

package/dist/types/chunks/{context-BORy7yXb.d.ts → context-CCL0_F8R.d.ts}

@@ -1,4 +1,40 @@
-import { b as HttpTransport } from './http-transport-DirKfK2S.js';
+import { H as HttpTransport } from './http-transport--_NdQOiw.js';
+
+interface HashConfig {
+    readonly digestLength: 20 | 32;
+    readonly hexLength: 40 | 64;
+}
+
+type ObjectId = string & {
+    readonly __brand: unique symbol;
+};
+declare const ObjectId: {
+    readonly from: (hex: string) => ObjectId;
+    readonly fromRaw: (bytes: Uint8Array) => ObjectId;
+};
+type RefName = string & {
+    readonly __brand: unique symbol;
+};
+declare const RefName: {
+    readonly from: (name: string) => RefName;
+};
+type FilePath = string & {
+    readonly __brand: unique symbol;
+};
+declare const FilePath: {
+    readonly from: (path: string) => FilePath;
+};
+
+interface LruCache<V> {
+    get(key: string): V | undefined;
+    set(key: string, value: V, byteSize: number): void;
+    has(key: string): boolean;
+    delete(key: string): boolean;
+    clear(): void;
+    readonly currentSize: number;
+    readonly maxSize: number;
+    readonly entryCount: number;
+}
 
 interface InflateStreamResult {
     /** The fully-inflated output bytes. */
@@ -151,6 +187,32 @@ interface FileSystem {
      * Throws `PERMISSION_DENIED` if the leaf is a symlink.
      */
     readonly openWithNoFollow: (path: string, mode: 'read' | 'write') => Promise<FileHandle>;
+    /**
+     * Absolute path to the current user's home directory.
+     *
+     * - Node: `os.homedir()`.
+     * - Memory: a fixed value injected via constructor options (default `'/home/user'`).
+     * - Browser: throws `UNSUPPORTED_OPERATION` (no concept of a home directory).
+     */
+    readonly homedir: () => string;
+    /**
+     * Absolute path to the user's XDG config home — `$XDG_CONFIG_HOME` when set
+     * and non-empty, otherwise `<homedir>/.config`.
+     *
+     * - Node: reads `process.env.XDG_CONFIG_HOME`, falls back to `<homedir>/.config`.
+     * - Memory: fixed value injected via constructor options.
+     * - Browser: throws `UNSUPPORTED_OPERATION`.
+     */
+    readonly xdgConfigHome: () => string;
+    /**
+     * Absolute path to the platform's system git config file.
+     *
+     * - Node POSIX: `/etc/gitconfig`.
+     * - Node Windows: `<ProgramData>\Git\config` (ProgramData from env, default `C:\ProgramData`).
+     * - Memory: fixed value injected via constructor options.
+     * - Browser: throws `UNSUPPORTED_OPERATION`.
+     */
+    readonly systemConfigPath: () => string;
 }
 
 /** Incremental hash computation context. Single-use: consumed after digest. */
@@ -175,42 +237,6 @@ interface HashService {
     readonly digestLength: 20 | 32;
 }
 
-type ObjectId = string & {
-    readonly __brand: unique symbol;
-};
-declare const ObjectId: {
-    readonly from: (hex: string) => ObjectId;
-    readonly fromRaw: (bytes: Uint8Array) => ObjectId;
-};
-type RefName = string & {
-    readonly __brand: unique symbol;
-};
-declare const RefName: {
-    readonly from: (name: string) => RefName;
-};
-type FilePath = string & {
-    readonly __brand: unique symbol;
-};
-declare const FilePath: {
-    readonly from: (path: string) => FilePath;
-};
-
-interface HashConfig {
-    readonly digestLength: 20 | 32;
-    readonly hexLength: 40 | 64;
-}
-
-interface LruCache<V> {
-    get(key: string): V | undefined;
-    set(key: string, value: V, byteSize: number): void;
-    has(key: string): boolean;
-    delete(key: string): boolean;
-    clear(): void;
-    readonly currentSize: number;
-    readonly maxSize: number;
-    readonly entryCount: number;
-}
-
 /**
  * The lifecycle hooks tsgit invokes. Extend the union to add a hook.
  *
@@ -463,5 +489,5 @@ interface CreateContextParts {
 /** Assemble a frozen Context from its constituent ports + layout. */
 declare function createContext(parts: CreateContextParts): Context;
 
-export { ObjectId as O, RefName as R, FilePath as d, createContext as p, noopLogger as q, wrapLoggerSanitizer as w };
-export type { AuthStrategy as A, Compressor as C, DirEntry as D, FileHandle as F, HashService as H, InflateStreamResult as I, Logger as L, ProgressReporter as P, AuthorIdentity as a, Context as b, CreateContextParts as c, FileStat as e, FileSystem as f, Hasher as g, HookName as h, HookRequest as i, HookResult as j, HookRunner as k, PromisorFetchOutcome as l, PromisorRemote as m, RepositoryConfig as n, RepositoryLayout as o };
+export { ObjectId as O, FilePath as c, RefName as j, createContext as p, noopLogger as q, wrapLoggerSanitizer as w };
+export type { AuthStrategy as A, Compressor as C, DirEntry as D, FileSystem as F, HashService as H, InflateStreamResult as I, Logger as L, ProgressReporter as P, RepositoryConfig as R, HookRunner as a, Context as b, FileStat as d, FileHandle as e, Hasher as f, HookName as g, HookResult as h, HookRequest as i, AuthorIdentity as k, CreateContextParts as l, PromisorFetchOutcome as m, PromisorRemote as n, RepositoryLayout as o };

package/dist/types/chunks/{context-CMrHCVwK.d.cts → context-YDw6qicq.d.cts}

@@ -1,4 +1,40 @@
-import { b as HttpTransport } from './http-transport-DirKfK2S.cjs';
+import { H as HttpTransport } from './http-transport--_NdQOiw.cjs';
+
+interface HashConfig {
+    readonly digestLength: 20 | 32;
+    readonly hexLength: 40 | 64;
+}
+
+type ObjectId = string & {
+    readonly __brand: unique symbol;
+};
+declare const ObjectId: {
+    readonly from: (hex: string) => ObjectId;
+    readonly fromRaw: (bytes: Uint8Array) => ObjectId;
+};
+type RefName = string & {
+    readonly __brand: unique symbol;
+};
+declare const RefName: {
+    readonly from: (name: string) => RefName;
+};
+type FilePath = string & {
+    readonly __brand: unique symbol;
+};
+declare const FilePath: {
+    readonly from: (path: string) => FilePath;
+};
+
+interface LruCache<V> {
+    get(key: string): V | undefined;
+    set(key: string, value: V, byteSize: number): void;
+    has(key: string): boolean;
+    delete(key: string): boolean;
+    clear(): void;
+    readonly currentSize: number;
+    readonly maxSize: number;
+    readonly entryCount: number;
+}
 
 interface InflateStreamResult {
     /** The fully-inflated output bytes. */
@@ -151,6 +187,32 @@ interface FileSystem {
      * Throws `PERMISSION_DENIED` if the leaf is a symlink.
      */
     readonly openWithNoFollow: (path: string, mode: 'read' | 'write') => Promise<FileHandle>;
+    /**
+     * Absolute path to the current user's home directory.
+     *
+     * - Node: `os.homedir()`.
+     * - Memory: a fixed value injected via constructor options (default `'/home/user'`).
+     * - Browser: throws `UNSUPPORTED_OPERATION` (no concept of a home directory).
+     */
+    readonly homedir: () => string;
+    /**
+     * Absolute path to the user's XDG config home — `$XDG_CONFIG_HOME` when set
+     * and non-empty, otherwise `<homedir>/.config`.
+     *
+     * - Node: reads `process.env.XDG_CONFIG_HOME`, falls back to `<homedir>/.config`.
+     * - Memory: fixed value injected via constructor options.
+     * - Browser: throws `UNSUPPORTED_OPERATION`.
+     */
+    readonly xdgConfigHome: () => string;
+    /**
+     * Absolute path to the platform's system git config file.
+     *
+     * - Node POSIX: `/etc/gitconfig`.
+     * - Node Windows: `<ProgramData>\Git\config` (ProgramData from env, default `C:\ProgramData`).
+     * - Memory: fixed value injected via constructor options.
+     * - Browser: throws `UNSUPPORTED_OPERATION`.
+     */
+    readonly systemConfigPath: () => string;
 }
 
 /** Incremental hash computation context. Single-use: consumed after digest. */
@@ -175,42 +237,6 @@ interface HashService {
     readonly digestLength: 20 | 32;
 }
 
-type ObjectId = string & {
-    readonly __brand: unique symbol;
-};
-declare const ObjectId: {
-    readonly from: (hex: string) => ObjectId;
-    readonly fromRaw: (bytes: Uint8Array) => ObjectId;
-};
-type RefName = string & {
-    readonly __brand: unique symbol;
-};
-declare const RefName: {
-    readonly from: (name: string) => RefName;
-};
-type FilePath = string & {
-    readonly __brand: unique symbol;
-};
-declare const FilePath: {
-    readonly from: (path: string) => FilePath;
-};
-
-interface HashConfig {
-    readonly digestLength: 20 | 32;
-    readonly hexLength: 40 | 64;
-}
-
-interface LruCache<V> {
-    get(key: string): V | undefined;
-    set(key: string, value: V, byteSize: number): void;
-    has(key: string): boolean;
-    delete(key: string): boolean;
-    clear(): void;
-    readonly currentSize: number;
-    readonly maxSize: number;
-    readonly entryCount: number;
-}
-
 /**
  * The lifecycle hooks tsgit invokes. Extend the union to add a hook.
  *
@@ -463,5 +489,5 @@ interface CreateContextParts {
 /** Assemble a frozen Context from its constituent ports + layout. */
 declare function createContext(parts: CreateContextParts): Context;
 
-export { ObjectId as O, RefName as R, FilePath as d, createContext as p, noopLogger as q, wrapLoggerSanitizer as w };
-export type { AuthStrategy as A, Compressor as C, DirEntry as D, FileHandle as F, HashService as H, InflateStreamResult as I, Logger as L, ProgressReporter as P, AuthorIdentity as a, Context as b, CreateContextParts as c, FileStat as e, FileSystem as f, Hasher as g, HookName as h, HookRequest as i, HookResult as j, HookRunner as k, PromisorFetchOutcome as l, PromisorRemote as m, RepositoryConfig as n, RepositoryLayout as o };
+export { ObjectId as O, FilePath as c, RefName as j, createContext as p, noopLogger as q, wrapLoggerSanitizer as w };
+export type { AuthStrategy as A, Compressor as C, DirEntry as D, FileSystem as F, HashService as H, InflateStreamResult as I, Logger as L, ProgressReporter as P, RepositoryConfig as R, HookRunner as a, Context as b, FileStat as d, FileHandle as e, Hasher as f, HookName as g, HookResult as h, HookRequest as i, AuthorIdentity as k, CreateContextParts as l, PromisorFetchOutcome as m, PromisorRemote as n, RepositoryLayout as o };

package/dist/types/chunks/{http-transport-DirKfK2S.d.cts → http-transport--_NdQOiw.d.cts}

@@ -17,4 +17,4 @@ interface HttpTransport {
     readonly request: (req: HttpRequest) => Promise<HttpResponse>;
 }
 
-export type { HttpRequest as H, HttpResponse as a, HttpTransport as b };
+export type { HttpTransport as H, HttpRequest as a, HttpResponse as b };

package/dist/types/chunks/{http-transport-DirKfK2S.d.ts → http-transport--_NdQOiw.d.ts}

@@ -17,4 +17,4 @@ interface HttpTransport {
     readonly request: (req: HttpRequest) => Promise<HttpResponse>;
 }
 
-export type { HttpRequest as H, HttpResponse as a, HttpTransport as b };
+export type { HttpTransport as H, HttpRequest as a, HttpResponse as b };

package/dist/types/chunks/index-entry-DtEbVpOG.d.cts

@@ -0,0 +1,47 @@
+import { O as ObjectId, c as FilePath } from './context-YDw6qicq.cjs';
+import { F as FileMode } from './reflog-entry-BbNnXCTC.cjs';
+
+interface IndexEntryFlags {
+    readonly assumeValid: boolean;
+    readonly stage: 0 | 1 | 2 | 3;
+    /** Index v3 extended flag — the path is intentionally absent from the working tree. */
+    readonly skipWorktree: boolean;
+    /** Index v3 extended flag — `git add -N` placeholder. Modelled for faithful round-tripping. */
+    readonly intentToAdd: boolean;
+}
+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 | 3;
+    readonly entries: ReadonlyArray<IndexEntry>;
+    readonly extensions: ReadonlyArray<IndexExtension>;
+    /**
+     * Trailing hash bytes (SHA-1: 20 bytes, SHA-256: 32 bytes) that close the
+     * index file format. Read but historically discarded; surfaced here so
+     * `CachingIndexResolver` can use it for the racy-stat fallback path
+     * (compare trailing bytes when `(mtime, size, ino)` match an observed
+     * stat but the underlying file may have been mutated in the racy-stat
+     * window — see design §10.4). Empty (`Uint8Array(0)`) when constructed
+     * from the empty-index defaults in `readIndex` (no underlying file).
+     */
+    readonly trailerSha: Uint8Array;
+}
+
+export type { GitIndex as G, IndexEntry as I, IndexEntryFlags as a };

package/dist/types/chunks/index-entry-UD4dvtKh.d.ts

@@ -0,0 +1,47 @@
+import { O as ObjectId, c as FilePath } from './context-CCL0_F8R.js';
+import { F as FileMode } from './reflog-entry-CSzjnZd4.js';
+
+interface IndexEntryFlags {
+    readonly assumeValid: boolean;
+    readonly stage: 0 | 1 | 2 | 3;
+    /** Index v3 extended flag — the path is intentionally absent from the working tree. */
+    readonly skipWorktree: boolean;
+    /** Index v3 extended flag — `git add -N` placeholder. Modelled for faithful round-tripping. */
+    readonly intentToAdd: boolean;
+}
+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 | 3;
+    readonly entries: ReadonlyArray<IndexEntry>;
+    readonly extensions: ReadonlyArray<IndexExtension>;
+    /**
+     * Trailing hash bytes (SHA-1: 20 bytes, SHA-256: 32 bytes) that close the
+     * index file format. Read but historically discarded; surfaced here so
+     * `CachingIndexResolver` can use it for the racy-stat fallback path
+     * (compare trailing bytes when `(mtime, size, ino)` match an observed
+     * stat but the underlying file may have been mutated in the racy-stat
+     * window — see design §10.4). Empty (`Uint8Array(0)`) when constructed
+     * from the empty-index defaults in `readIndex` (no underlying file).
+     */
+    readonly trailerSha: Uint8Array;
+}
+
+export type { GitIndex as G, IndexEntry as I, IndexEntryFlags as a };