@jinion/core 0.3.0 → 0.4.0

package/dist/files/search.js

@@ -0,0 +1,112 @@
+import { readFile, stat, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { matchesGlob } from '../lib/glob.js';
+import { listProjectFiles } from '../prompt/files.js';
+// Large enough for any source file; a bigger one is data, a bundle or a log, and would slow every search down.
+const MAX_BYTES = 1024 * 1024;
+const MAX_MATCHES = 5000;
+const MAX_LINE = 500;
+// Files read at once: enough to keep the disk busy, few enough not to run out of handles in a large project.
+const AT_ONCE = 32;
+/** What `query` asks for as a regular expression; throws one that isn't valid. */
+export function patternOf({ query, caseSensitive, wholeWord, regex }) {
+    const source = regex ? query : query.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    return new RegExp(wholeWord ? `\\b(?:${source})\\b` : source, caseSensitive ? 'g' : 'gi');
+}
+/** Every line of the folder's files the query finds, file by file in the order git lists them, up to a limit. */
+export async function searchFiles(folder, search) {
+    const pattern = patternOf(search);
+    const files = [];
+    let found = 0;
+    await eachText(folder, await candidates(folder, search), (path, text) => {
+        if (found >= MAX_MATCHES)
+            return false;
+        const matches = matchesIn(text, pattern, MAX_MATCHES - found);
+        if (matches.length > 0) {
+            files.push({ path, matches });
+            found += matches.reduce((sum, match) => sum + match.ranges.length, 0);
+        }
+        return true;
+    });
+    files.sort((a, b) => a.path.localeCompare(b.path));
+    return { files, truncated: found >= MAX_MATCHES };
+}
+/**
+ * Replaces what the query finds with `replacement` in the folder's files, or in `paths` of them only, and writes those
+ * it changed. In a regular expression `$1` and the like stand for what it caught; otherwise the text goes in as it is.
+ */
+export async function replaceInFiles(folder, search, replacement, paths) {
+    // Line by line, as the search found them: `^` and `$` stand for a line's start and end.
+    const pattern = new RegExp(patternOf(search).source, `${patternOf(search).flags}m`);
+    const text = search.regex ? replacement : replacement.replaceAll('$', '$$$$');
+    const chosen = (await candidates(folder, search)).filter((path) => !paths || paths.includes(path));
+    const changed = [];
+    let replacements = 0;
+    await eachText(folder, chosen, (path, content) => {
+        const count = [...content.matchAll(pattern)].filter((found) => found[0] !== '').length;
+        if (count > 0) {
+            changed.push({ path, text: content.replace(pattern, text) });
+            replacements += count;
+        }
+        return true;
+    });
+    await Promise.all(changed.map(({ path, text: next }) => writeFile(join(folder, path), next)));
+    return { files: changed.length, replacements };
+}
+/** The folder's files the search's globs let in, as git lists them, so ignored ones stay out. */
+async function candidates(folder, { include, exclude }) {
+    const included = globsOf(include);
+    const excluded = globsOf(exclude);
+    return (await listProjectFiles(folder)).filter((path) => !path.endsWith('/') && (included.length === 0 || included.some((glob) => fits(glob, path))) && !excluded.some((glob) => fits(glob, path)));
+}
+/** Each file's text, a few at a time, till `each` says to stop; one too large or not text is passed. */
+async function eachText(folder, paths, each) {
+    for (let start = 0; start < paths.length; start += AT_ONCE) {
+        const read = await Promise.all(paths.slice(start, start + AT_ONCE).map(async (path) => {
+            const file = join(folder, path);
+            const info = await stat(file).catch(() => undefined);
+            if (!info?.isFile() || info.size > MAX_BYTES)
+                return undefined;
+            const text = await readFile(file, 'utf8').catch(() => undefined);
+            return text === undefined || text.includes('\u0000') ? undefined : { path, text };
+        }));
+        for (const file of read)
+            if (file && !each(file.path, file.text))
+                return;
+    }
+}
+function matchesIn(text, pattern, room) {
+    const matches = [];
+    const lines = text.split(/\r?\n/);
+    let left = room;
+    for (let index = 0; index < lines.length && left > 0; index++) {
+        const line = lines[index];
+        const ranges = [];
+        pattern.lastIndex = 0;
+        for (let found = pattern.exec(line); found && left > 0; found = pattern.exec(line)) {
+            // One that finds nothing, as `^`, would find it again at the same place for ever.
+            if (found[0] === '') {
+                pattern.lastIndex++;
+                continue;
+            }
+            if (found.index < MAX_LINE)
+                ranges.push([found.index, Math.min(found.index + found[0].length, MAX_LINE)]);
+            left--;
+        }
+        if (ranges.length > 0)
+            matches.push({ line: index + 1, text: line.slice(0, MAX_LINE), ranges });
+    }
+    return matches;
+}
+function globsOf(list) {
+    return (list ?? '')
+        .split(',')
+        .map((glob) => glob.trim())
+        .filter(Boolean);
+}
+/** A glob fits a file itself, or a folder it is in, as `src` lets in everything under it. */
+function fits(glob, path) {
+    const parts = path.split('/');
+    return parts.some((_, index) => matchesGlob(glob, parts.slice(0, index + 1).join('/')));
+}
+//# sourceMappingURL=search.js.map

package/dist/files/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/files/search.ts"],"names":[],"mappings":"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"}

package/dist/files/trash.d.ts

@@ -0,0 +1,11 @@
+export declare class TrashUnsupported extends Error {
+}
+/** Moves a file or folder to the Trash, as the Finder would, under a name free there; where it went. */
+export declare function toTrash(path: string): Promise<string>;
+/** Whether `fromTrash` can put it back: `toTrash` moved it there, and it is still there. */
+export declare function restorable(trash: string): Promise<boolean>;
+/** Puts what `toTrash` moved back at `path`, once `restorable` said it can. */
+export declare function fromTrash(trash: string, path: string): Promise<void>;
+/** A rename, or a copy and a removal where the two are on different disks, as a project on another volume is. */
+export declare function moveAcross(from: string, to: string): Promise<void>;
+//# sourceMappingURL=trash.d.ts.map

package/dist/files/trash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trash.d.ts","sourceRoot":"","sources":["../../src/files/trash.ts"],"names":[],"mappings":"AAQA,qBAAa,gBAAiB,SAAQ,KAAK;CAAG;AAE9C,wGAAwG;AACxG,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,mBAiBzC;AAED,4FAA4F;AAC5F,wBAAsB,UAAU,CAAC,KAAK,EAAE,MAAM,oBAE7C;AAED,+EAA+E;AAC/E,wBAAsB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,iBAO1D;AAED,iHAAiH;AACjH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,iBASxD"}

package/dist/files/trash.js

@@ -0,0 +1,64 @@
+import { cp, lstat, mkdir, rename, rm, writeFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { basename, dirname, join } from 'node:path';
+import { freeName } from './names.js';
+/** What this process put in the Trash, so only that can be taken back out through it. */
+const trashed = new Set();
+export class TrashUnsupported extends Error {
+}
+/** Moves a file or folder to the Trash, as the Finder would, under a name free there; where it went. */
+export async function toTrash(path) {
+    const { files, info } = trashFolders();
+    await mkdir(files, { recursive: true });
+    const name = await freeName(files, basename(path), '');
+    const trash = join(files, name);
+    if (info) {
+        await mkdir(info, { recursive: true });
+        await writeFile(join(info, `${name}.trashinfo`), `[Trash Info]\nPath=${encodeURI(path)}\nDeletionDate=${localDate(new Date())}\n`);
+    }
+    await moveAcross(path, trash);
+    trashed.add(trash);
+    return trash;
+}
+/** Whether `fromTrash` can put it back: `toTrash` moved it there, and it is still there. */
+export async function restorable(trash) {
+    return trashed.has(trash) && (await lstat(trash).then(() => true, () => false));
+}
+/** Puts what `toTrash` moved back at `path`, once `restorable` said it can. */
+export async function fromTrash(trash, path) {
+    const { info } = trashFolders();
+    await mkdir(dirname(path), { recursive: true });
+    await moveAcross(trash, path);
+    trashed.delete(trash);
+    if (info)
+        await rm(join(info, `${basename(trash)}.trashinfo`), { force: true });
+}
+/** A rename, or a copy and a removal where the two are on different disks, as a project on another volume is. */
+export async function moveAcross(from, to) {
+    try {
+        await rename(from, to);
+    }
+    catch (error) {
+        if (error.code !== 'EXDEV')
+            throw error;
+        await cp(from, to, { recursive: true, verbatimSymlinks: true, errorOnExist: true, force: false });
+        await rm(from, { recursive: true, force: true });
+    }
+}
+// The Finder's Trash takes what is moved into it without the record its own Put Back reads, which only the Finder
+// writes; Jinion puts back what it trashed itself. Elsewhere, the trash freedesktop.org describes, record and all.
+function trashFolders() {
+    if (process.env.JINION_TRASH)
+        return { files: process.env.JINION_TRASH };
+    if (process.platform === 'darwin')
+        return { files: join(homedir(), '.Trash') };
+    if (process.platform === 'win32')
+        throw new TrashUnsupported("Moving to the Recycle Bin isn't supported on Windows yet.");
+    const trash = join(process.env.XDG_DATA_HOME ?? join(homedir(), '.local', 'share'), 'Trash');
+    return { files: join(trash, 'files'), info: join(trash, 'info') };
+}
+function localDate(date) {
+    const two = (value) => String(value).padStart(2, '0');
+    return `${date.getFullYear()}-${two(date.getMonth() + 1)}-${two(date.getDate())}T${two(date.getHours())}:${two(date.getMinutes())}:${two(date.getSeconds())}`;
+}
+//# sourceMappingURL=trash.js.map

package/dist/files/trash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trash.js","sourceRoot":"","sources":["../../src/files/trash.ts"],"names":[],"mappings":"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"}

package/dist/files/types.d.ts

@@ -0,0 +1,112 @@
+import { z } from 'zod';
+/** What to find in the folder's files, and in which of them. */
+export declare const SearchQuery: z.ZodObject<{
+    query: z.ZodString;
+    caseSensitive: z.ZodOptional<z.ZodBoolean>;
+    wholeWord: z.ZodOptional<z.ZodBoolean>;
+    regex: z.ZodOptional<z.ZodBoolean>;
+    include: z.ZodOptional<z.ZodString>;
+    exclude: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type SearchQuery = z.infer<typeof SearchQuery>;
+/** A line with what was found in it, as `[start, end)` places in `text`, counted from 0. */
+export declare const SearchMatch: z.ZodObject<{
+    line: z.ZodNumber;
+    text: z.ZodString;
+    ranges: z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+}, z.core.$strip>;
+export type SearchMatch = z.infer<typeof SearchMatch>;
+export declare const FileMatches: z.ZodObject<{
+    path: z.ZodString;
+    matches: z.ZodArray<z.ZodObject<{
+        line: z.ZodNumber;
+        text: z.ZodString;
+        ranges: z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type FileMatches = z.infer<typeof FileMatches>;
+/** `truncated` when there were more than are given. */
+export declare const SearchResults: z.ZodObject<{
+    files: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        matches: z.ZodArray<z.ZodObject<{
+            line: z.ZodNumber;
+            text: z.ZodString;
+            ranges: z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    truncated: z.ZodBoolean;
+}, z.core.$strip>;
+export type SearchResults = z.infer<typeof SearchResults>;
+export declare const Replaced: z.ZodObject<{
+    files: z.ZodNumber;
+    replacements: z.ZodNumber;
+}, z.core.$strip>;
+export type Replaced = z.infer<typeof Replaced>;
+/**
+ * A file a client watches changed on disk: its time now, none once it is gone. Moved or renamed through the API, with
+ * `movedTo`, its path now, which is watched from then on in its place.
+ */
+export declare const FileChanged: z.ZodObject<{
+    session: z.ZodString;
+    path: z.ZodString;
+    modified: z.ZodOptional<z.ZodNumber>;
+    movedTo: z.ZodOptional<z.ZodString>;
+    by: z.ZodOptional<z.ZodEnum<{
+        agent: "agent";
+        other: "other";
+    }>>;
+}, z.core.$strip>;
+export type FileChanged = z.infer<typeof FileChanged>;
+/** A file or folder moved, renamed or copied, by its paths in the session's folder; a copy from outside it, by its whole path. */
+export declare const Moved: z.ZodObject<{
+    from: z.ZodString;
+    to: z.ZodString;
+}, z.core.$strip>;
+export type Moved = z.infer<typeof Moved>;
+/** What went to the Trash: its path in the session's folder, and its whole path in the Trash, by which it is put back. */
+export declare const Trashed: z.ZodObject<{
+    path: z.ZodString;
+    trash: z.ZodString;
+}, z.core.$strip>;
+export type Trashed = z.infer<typeof Trashed>;
+/** What a call did, so a client can undo it; `replaced`, what was in the way and went to the Trash for it. */
+export declare const FilesMoved: z.ZodObject<{
+    moved: z.ZodArray<z.ZodObject<{
+        from: z.ZodString;
+        to: z.ZodString;
+    }, z.core.$strip>>;
+    replaced: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        trash: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type FilesMoved = z.infer<typeof FilesMoved>;
+export declare const FilesCopied: z.ZodObject<{
+    copied: z.ZodArray<z.ZodObject<{
+        from: z.ZodString;
+        to: z.ZodString;
+    }, z.core.$strip>>;
+    replaced: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        trash: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type FilesCopied = z.infer<typeof FilesCopied>;
+export declare const FileCreated: z.ZodObject<{
+    path: z.ZodString;
+    replaced: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        trash: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type FileCreated = z.infer<typeof FileCreated>;
+export declare const FilesRestored: z.ZodObject<{
+    restored: z.ZodArray<z.ZodString>;
+    replaced: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        trash: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type FilesRestored = z.infer<typeof FilesRestored>;
+//# sourceMappingURL=types.d.ts.map

package/dist/files/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/files/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,gEAAgE;AAChE,eAAO,MAAM,WAAW;;;;;;;iBAWtB,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD,4FAA4F;AAC5F,eAAO,MAAM,WAAW;;;;iBAKtB,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD,eAAO,MAAM,WAAW;;;;;;;iBAAgE,CAAC;AAEzF,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD,uDAAuD;AACvD,eAAO,MAAM,aAAa;;;;;;;;;;iBAAoE,CAAC;AAE/F,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D,eAAO,MAAM,QAAQ;;;iBAAwE,CAAC;AAE9F,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AAEhD;;;GAGG;AACH,eAAO,MAAM,WAAW;;;;;;;;;iBAOtB,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD,kIAAkI;AAClI,eAAO,MAAM,KAAK;;;iBAAiD,CAAC;AAEpE,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,KAAK,CAAC,CAAC;AAE1C,0HAA0H;AAC1H,eAAO,MAAM,OAAO;;;iBAAoD,CAAC;AAEzE,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,OAAO,CAAC,CAAC;AAE9C,8GAA8G;AAC9G,eAAO,MAAM,UAAU;;;;;;;;;iBAAkE,CAAC;AAE1F,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD,eAAO,MAAM,WAAW;;;;;;;;;iBAAmE,CAAC;AAE5F,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD,eAAO,MAAM,WAAW;;;;;;iBAA6D,CAAC;AAEtF,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD,eAAO,MAAM,aAAa;;;;;;iBAA0E,CAAC;AAErG,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC"}

package/dist/files/types.js

@@ -0,0 +1,47 @@
+import { z } from 'zod';
+/** What to find in the folder's files, and in which of them. */
+export const SearchQuery = z.object({
+    query: z.string().min(1),
+    caseSensitive: z.boolean().optional(),
+    /** Only where it stands as a word of its own. */
+    wholeWord: z.boolean().optional(),
+    /** `query` is a regular expression, as JavaScript reads one. */
+    regex: z.boolean().optional(),
+    /** Globs, by commas, as `src, *.ts`: only the files one fits, or a folder of them. */
+    include: z.string().optional(),
+    /** Globs the same way, for files left out. */
+    exclude: z.string().optional(),
+});
+/** A line with what was found in it, as `[start, end)` places in `text`, counted from 0. */
+export const SearchMatch = z.object({
+    /** Counted from 1. */
+    line: z.number().int(),
+    text: z.string(),
+    ranges: z.array(z.tuple([z.number().int(), z.number().int()])),
+});
+export const FileMatches = z.object({ path: z.string(), matches: z.array(SearchMatch) });
+/** `truncated` when there were more than are given. */
+export const SearchResults = z.object({ files: z.array(FileMatches), truncated: z.boolean() });
+export const Replaced = z.object({ files: z.number().int(), replacements: z.number().int() });
+/**
+ * A file a client watches changed on disk: its time now, none once it is gone. Moved or renamed through the API, with
+ * `movedTo`, its path now, which is watched from then on in its place.
+ */
+export const FileChanged = z.object({
+    session: z.string(),
+    path: z.string(),
+    modified: z.number().optional(),
+    movedTo: z.string().optional(),
+    /** `agent` when the session's running turn edits it, `other` when no turn runs; neither when a turn runs but names it in no edit, as a command of the agent's may change it. */
+    by: z.enum(['agent', 'other']).optional(),
+});
+/** A file or folder moved, renamed or copied, by its paths in the session's folder; a copy from outside it, by its whole path. */
+export const Moved = z.object({ from: z.string(), to: z.string() });
+/** What went to the Trash: its path in the session's folder, and its whole path in the Trash, by which it is put back. */
+export const Trashed = z.object({ path: z.string(), trash: z.string() });
+/** What a call did, so a client can undo it; `replaced`, what was in the way and went to the Trash for it. */
+export const FilesMoved = z.object({ moved: z.array(Moved), replaced: z.array(Trashed) });
+export const FilesCopied = z.object({ copied: z.array(Moved), replaced: z.array(Trashed) });
+export const FileCreated = z.object({ path: z.string(), replaced: z.array(Trashed) });
+export const FilesRestored = z.object({ restored: z.array(z.string()), replaced: z.array(Trashed) });
+//# sourceMappingURL=types.js.map

package/dist/files/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/files/types.ts"],"names":[],"mappings":"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"}

package/dist/files/watch.d.ts

@@ -0,0 +1,26 @@
+import type { FileChanged, Moved } from './types.js';
+/**
+ * The files one client has open, watched on disk: each folder holding one is watched, as many editors write a file by
+ * putting a new one in its place, which a watch on the file itself would lose.
+ */
+export declare class FileWatcher {
+    private readonly changed;
+    private readonly wanted;
+    private readonly folders;
+    private files;
+    private readonly settling;
+    constructor(changed: (change: FileChanged) => void);
+    /**
+     * Files and folders of `folder` moved or renamed through the API, by their paths there: each open file in them is told
+     * of with its path now, and watched there from then on.
+     */
+    static moved(folder: string, moves: Moved[]): void;
+    /** The files of the session's folder it now has open, by their paths there; the ones before are let go. */
+    set(session: string, folder: string, paths: string[]): void;
+    close(): void;
+    private follow;
+    private rebuild;
+    private touched;
+    private tell;
+}
+//# sourceMappingURL=watch.d.ts.map

package/dist/files/watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../src/files/watch.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAQrD;;;GAGG;AACH,qBAAa,WAAW;IAMV,OAAO,CAAC,QAAQ,CAAC,OAAO;IALpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0D;IACjF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgC;IACxD,OAAO,CAAC,KAAK,CAA0D;IACvE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoD;IAE7E,YAA6B,OAAO,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,EAElE;IAED;;;OAGG;IACH,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,QAE1C;IAED,2GAA2G;IAC3G,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAGnD;IAED,KAAK,SAOJ;IAED,OAAO,CAAC,MAAM;IAwBd,OAAO,CAAC,OAAO;IAoCf,OAAO,CAAC,OAAO;IAkBf,OAAO,CAAC,IAAI;CAGb"}

package/dist/files/watch.js

@@ -0,0 +1,107 @@
+import { watch } from 'node:fs';
+import { stat } from 'node:fs/promises';
+import { dirname, isAbsolute, join, normalize, sep } from 'node:path';
+// An editor or a tool writes a file in several steps; the change is told once they are done.
+const SETTLE = 100;
+/** Every client's watcher, for what the API moves to reach all of them. */
+const watchers = new Set();
+/**
+ * The files one client has open, watched on disk: each folder holding one is watched, as many editors write a file by
+ * putting a new one in its place, which a watch on the file itself would lose.
+ */
+export class FileWatcher {
+    changed;
+    wanted = new Map();
+    folders = new Map();
+    files = new Map();
+    settling = new Map();
+    constructor(changed) {
+        this.changed = changed;
+        watchers.add(this);
+    }
+    /**
+     * Files and folders of `folder` moved or renamed through the API, by their paths there: each open file in them is told
+     * of with its path now, and watched there from then on.
+     */
+    static moved(folder, moves) {
+        for (const watcher of watchers)
+            watcher.follow(folder, moves);
+    }
+    /** The files of the session's folder it now has open, by their paths there; the ones before are let go. */
+    set(session, folder, paths) {
+        this.wanted.set(session, { folder, paths: paths.map(normalize).filter((path) => !isAbsolute(path) && !path.startsWith('..')) });
+        this.rebuild();
+    }
+    close() {
+        for (const watcher of this.folders.values())
+            watcher.close();
+        for (const timer of this.settling.values())
+            clearTimeout(timer);
+        this.folders.clear();
+        this.wanted.clear();
+        watchers.delete(this);
+    }
+    follow(folder, moves) {
+        const told = [];
+        for (const [session, wanted] of this.wanted) {
+            if (wanted.folder !== folder)
+                continue;
+            wanted.paths = wanted.paths.map((path) => {
+                const move = moves.find(({ from }) => path === from || path.startsWith(`${from}${sep}`));
+                if (!move)
+                    return path;
+                const movedTo = move.to + path.slice(move.from.length);
+                told.push({ session, path, movedTo });
+                return movedTo;
+            });
+        }
+        if (told.length === 0)
+            return;
+        this.rebuild();
+        for (const change of told)
+            this.changed(change);
+    }
+    rebuild() {
+        const files = new Map();
+        for (const [session, { folder, paths }] of this.wanted) {
+            for (const path of paths) {
+                const file = join(folder, path);
+                files.set(file, [...(files.get(file) ?? []), { session, path }]);
+            }
+        }
+        const needed = new Set([...files.keys()].map(dirname));
+        for (const [folder, watcher] of this.folders) {
+            if (needed.has(folder))
+                continue;
+            watcher.close();
+            this.folders.delete(folder);
+        }
+        for (const folder of needed) {
+            if (this.folders.has(folder))
+                continue;
+            try {
+                const watcher = watch(folder, { persistent: false }, (_event, name) => name && this.touched(join(folder, name.toString())));
+                watcher.on('error', () => this.folders.delete(folder));
+                this.folders.set(folder, watcher);
+            }
+            catch {
+                // A folder that is gone has nothing to watch; it is tried again once the files change.
+            }
+        }
+        this.files = files;
+    }
+    touched(file) {
+        if (!this.files.has(file))
+            return;
+        clearTimeout(this.settling.get(file));
+        this.settling.set(file, setTimeout(() => {
+            this.settling.delete(file);
+            void stat(file).then((info) => this.tell(file, info.mtimeMs), () => this.tell(file, undefined));
+        }, SETTLE));
+    }
+    tell(file, modified) {
+        for (const { session, path } of this.files.get(file) ?? [])
+            this.changed({ session, path, ...(modified !== undefined && { modified }) });
+    }
+}
+//# sourceMappingURL=watch.js.map

package/dist/files/watch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.js","sourceRoot":"","sources":["../../src/files/watch.ts"],"names":[],"mappings":"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"}

package/dist/git/blame.d.ts

@@ -0,0 +1,10 @@
+import type { Blame, CommitDetail } from './types.js';
+/**
+ * Who last changed each line of a file in `folder`, from the repository it is in, the deepest when several hold it.
+ * With `text`, the lines are those of the text rather than the file on disk, as an editor holds it with edits not saved
+ * yet, which show as not committed. `null` for a file git doesn't know, as one never committed.
+ */
+export declare function blame(folder: string, path: string, text?: string): Promise<Blame | null>;
+/** A commit of one of the folder's repositories, with each file it changed. */
+export declare function showCommit(folder: string, root: string, sha: string): Promise<CommitDetail | undefined>;
+//# sourceMappingURL=blame.d.ts.map

package/dist/git/blame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blame.d.ts","sourceRoot":"","sources":["../../src/git/blame.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAc,YAAY,EAAoB,MAAM,YAAY,CAAC;AAKpF;;;;GAIG;AACH,wBAAsB,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAS9F;AAED,+EAA+E;AAC/E,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAS7G"}

package/dist/git/blame.js

@@ -0,0 +1,91 @@
+import { execFile } from 'node:child_process';
+import { isAbsolute, join, relative } from 'node:path';
+import { findRepos } from './repos.js';
+/** The sha git gives lines that aren't committed yet. */
+const UNCOMMITTED = '0'.repeat(40);
+/**
+ * Who last changed each line of a file in `folder`, from the repository it is in, the deepest when several hold it.
+ * With `text`, the lines are those of the text rather than the file on disk, as an editor holds it with edits not saved
+ * yet, which show as not committed. `null` for a file git doesn't know, as one never committed.
+ */
+export async function blame(folder, path, text) {
+    const file = join(folder, path);
+    const repo = repoOf(folder, file);
+    if (!repo)
+        return null;
+    const args = ['blame', '--porcelain', ...(text === undefined ? [] : ['--contents', '-']), '--', relative(repo.root, file)];
+    const [output, you] = await Promise.all([run(repo.root, args, text).catch(() => undefined), run(repo.root, ['config', 'user.email']).catch(() => '')]);
+    return output === undefined ? null : { repo: repo.root, ...(you.trim() && { you: you.trim() }), ...parseBlame(output) };
+}
+/** A commit of one of the folder's repositories, with each file it changed. */
+export async function showCommit(folder, root, sha) {
+    if (!/^[0-9a-f]{4,40}$/i.test(sha) || !findRepos(folder).some((repo) => repo.root === root))
+        return undefined;
+    const output = await run(root, ['show', '--no-color', '-M', '--patch', '--format=%H%x00%an%x00%ae%x00%at%x00%s%x00%b%x00', sha]).catch(() => undefined);
+    if (output === undefined)
+        return undefined;
+    const [full, author, email, time, summary, body, patch] = output.split('\0');
+    return { sha: full, author: author, email: email, time: Number(time) * 1000, summary: summary, body: body.trim(), files: filesOf(patch ?? '') };
+}
+/** `git blame --porcelain`: each line under a header naming its commit, the commit told of the first time it comes. */
+function parseBlame(output) {
+    const commits = {};
+    const ranges = [];
+    let current;
+    let fields = {};
+    for (const line of output.split('\n')) {
+        const header = /^([0-9a-f]{40}) \d+ (\d+)/.exec(line);
+        if (header) {
+            current = { sha: header[1], line: Number(header[2]) };
+            fields = {};
+        }
+        else if (line.startsWith('\t') && current) {
+            const { sha } = current;
+            if (sha !== UNCOMMITTED && !commits[sha]) {
+                commits[sha] = { sha, author: fields.author ?? '', email: (fields['author-mail'] ?? '').replace(/^<|>$/g, ''), time: Number(fields['author-time'] ?? 0) * 1000, summary: fields.summary ?? '' };
+            }
+            const last = ranges.at(-1);
+            const commit = sha === UNCOMMITTED ? undefined : sha;
+            if (last && last.commit === commit && last.start + last.lines === current.line)
+                last.lines += 1;
+            else
+                ranges.push({ start: current.line, lines: 1, ...(commit && { commit }) });
+            current = undefined;
+        }
+        else if (current) {
+            const space = line.indexOf(' ');
+            if (space > 0)
+                fields[line.slice(0, space)] = line.slice(space + 1);
+        }
+    }
+    return { ranges, commits };
+}
+function filesOf(patch) {
+    return patch
+        .split(/^(?=diff --git )/m)
+        .filter((part) => part.startsWith('diff --git '))
+        .map((part) => {
+        const added = /^\+\+\+ b\/(.+)$/m.exec(part)?.[1];
+        const removed = /^--- a\/(.+)$/m.exec(part)?.[1];
+        const named = /^diff --git a\/.+ b\/(.+)$/m.exec(part)?.[1];
+        return { path: added ?? removed ?? named ?? '', patch: part, binary: /^Binary files /m.test(part) };
+    });
+}
+function repoOf(folder, file) {
+    const inside = (root) => {
+        const path = relative(root, file);
+        return !path.startsWith('..') && !isAbsolute(path);
+    };
+    return findRepos(folder)
+        .filter((repo) => inside(repo.root))
+        .sort((a, b) => b.root.length - a.root.length)[0];
+}
+function run(cwd, args, input) {
+    return new Promise((resolve, reject) => {
+        const child = execFile('git', args, { cwd, maxBuffer: 64 * 1024 * 1024, timeout: 30_000 }, (error, stdout) => (error ? reject(error) : resolve(stdout)));
+        // Git can end before it reads its input, as when it refuses what it was asked; writing to it then isn't a failure.
+        child.stdin?.on('error', () => { });
+        child.stdin?.end(input ?? '');
+    });
+}
+//# sourceMappingURL=blame.js.map