@jinion/core 0.3.0 → 0.4.0

package/dist/directions/viewer.js

@@ -0,0 +1,266 @@
+/**
+ * The viewer the core serves, as drawn in @jinion/ui's playground (`pages/directions`): one page that reads the rounds
+ * from beside it. The core draws no React, so it is written out here, with @jinion/ui's tokens by the same names.
+ */
+export function viewerPage(project) {
+    return `<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>Directions</title>
+<style>${STYLE}</style>
+</head>
+<body>
+<nav id="rounds"><h1><span class="strong">Directions</span><span class="faint">${escapeHtml(project)}</span></h1></nav>
+<main><div class="sheet" id="sheet"></div></main>
+<script>${SCRIPT}</script>
+</body>
+</html>`;
+}
+function escapeHtml(text) {
+    return text.replace(/[&<>"']/g, (character) => `&#${character.charCodeAt(0)};`);
+}
+const STYLE = `
+:root {
+  --background: #ffffff;
+  --raised: #f4f5f8;
+  --floating: #ffffff;
+  --ink: #12162a;
+  --muted: #5c6275;
+  --faint: #989dae;
+  --edge: rgb(18 22 42 / 0.1);
+  --shade: rgb(18 22 42 / 0.045);
+  --selected: rgb(18 22 42 / 0.07);
+  --primary: #181e33;
+  --on-primary: #ffffff;
+  --float-shadow: 0 6px 24px -8px rgb(0 0 0 / 0.14), 0 0 0 0.5px rgb(0 0 0 / 0.1);
+  --sheet-shadow: 0 0 0 1px rgb(0 0 0 / 0.05), 0 1px 2px 0 rgb(0 0 0 / 0.05);
+  --font-sans: -apple-system, BlinkMacSystemFont, "SF Pro Text", system-ui, sans-serif;
+  --font-mono: "JetBrains Mono", ui-monospace, Menlo, monospace;
+  color-scheme: light;
+}
+* { box-sizing: border-box; }
+html, body { height: 100%; margin: 0; }
+body { display: flex; background: var(--raised); color: var(--ink); font: 13px/20px var(--font-sans); -webkit-font-smoothing: antialiased; }
+button { font: inherit; color: inherit; border: 0; background: none; padding: 0; cursor: default; text-align: left; transition: background-color 100ms ease-out, color 100ms ease-out; }
+button:focus-visible { outline: 2px solid var(--primary); outline-offset: 1px; }
+.strong { font-weight: 600; }
+.faint { color: var(--faint); }
+.small { font-size: 12px; line-height: 16px; }
+.truncate { overflow: hidden; white-space: nowrap; text-overflow: ellipsis; }
+nav { display: flex; flex-direction: column; gap: 1px; width: 224px; flex-shrink: 0; padding: 12px; overflow-y: auto; }
+nav h1 { display: flex; align-items: baseline; gap: 8px; margin: 0; padding: 4px 10px 12px; font-size: inherit; font-weight: 400; min-width: 0; }
+.round { display: flex; flex-direction: column; min-width: 0; border-radius: 8px; padding: 6px 10px; color: var(--muted); }
+.round:hover { color: var(--ink); }
+.round[aria-current="true"] { background: var(--shade); color: var(--ink); }
+main { flex: 1; min-width: 0; padding: 12px 12px 12px 0; }
+.sidebar-closed nav { display: none; }
+.sidebar-closed main { padding-left: 12px; }
+.sheet { position: relative; height: 100%; overflow: hidden; border-radius: 12px; background: var(--background); box-shadow: var(--sheet-shadow); }
+iframe { display: block; width: 100%; height: 100%; border: 0; }
+.dock { position: absolute; inset: auto 16px 16px; display: flex; justify-content: center; pointer-events: none; }
+.switcher { display: flex; align-items: center; gap: 4px; max-width: 100%; min-width: 0; padding: 4px; border-radius: 16px; background: var(--floating); box-shadow: var(--float-shadow); pointer-events: auto; user-select: none; }
+.options { display: flex; gap: 4px; min-width: 0; overflow-x: auto; }
+.option { display: flex; flex-direction: column; gap: 2px; width: 208px; min-width: 144px; flex-shrink: 1; border-radius: 12px; padding: 8px 12px; }
+.option:hover { background: var(--shade); }
+.option[aria-pressed="true"] { background: var(--selected); }
+.option-head { display: flex; align-items: center; gap: 6px; }
+.option-name { font-weight: 500; color: var(--ink); }
+.option-number { margin-left: auto; font: 12px/20px var(--font-mono); color: var(--faint); }
+.idea { display: -webkit-box; -webkit-box-orient: vertical; -webkit-line-clamp: 2; overflow: hidden; font-size: 12px; line-height: 16px; color: var(--muted); }
+.check { width: 14px; height: 14px; flex-shrink: 0; color: var(--muted); }
+.act { display: flex; flex-direction: column; align-items: flex-end; gap: 2px; flex-shrink: 0; padding: 0 8px; }
+.button { display: inline-flex; align-items: center; gap: 8px; height: 32px; padding: 0 12px; border-radius: 8px; font-weight: 500; white-space: nowrap; }
+.button .check { width: 16px; height: 16px; color: inherit; }
+.primary { background: var(--primary); color: var(--on-primary); }
+.primary:hover { background: color-mix(in srgb, var(--primary) 90%, transparent); }
+.outline { background: var(--background); box-shadow: 0 0 0 1px var(--edge), 0 1px 2px 0 rgb(0 0 0 / 0.05); }
+.button:disabled { opacity: 0.4; }
+.said { max-width: 208px; text-align: right; }
+.empty { display: flex; flex-direction: column; align-items: center; justify-content: center; gap: 4px; height: 100%; padding: 0 24px; text-align: center; }
+.empty p { margin: 0; }
+.empty .title { font-weight: 500; }
+.empty .text { max-width: 320px; color: var(--muted); text-wrap: pretty; }
+@media (prefers-reduced-motion: reduce) { * { transition: none !important; } }
+`;
+const SCRIPT = `
+const CHECK = '<svg class="check" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M20 6 9 17l-5-5"/></svg>';
+const nav = document.getElementById('rounds');
+const sheet = document.getElementById('sheet');
+let rounds = [];
+let loaded = false;
+const params = new URLSearchParams(location.search);
+let roundId = params.get('round');
+// The direction the address asks for, by its number in the round, as the agent opens each one to look at it.
+const asked = Number(params.get('direction') ?? 1) - 1;
+let shown = 0;
+let said = '';
+
+function element(tag, className, text) {
+  const made = document.createElement(tag);
+  if (className) made.className = className;
+  if (text !== undefined) made.textContent = text;
+  return made;
+}
+
+function current() {
+  return rounds.find((round) => round.id === roundId);
+}
+
+function when(at) {
+  const date = new Date(at);
+  const time = date.toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' });
+  const days = Math.round((new Date().setHours(0, 0, 0, 0) - new Date(at).setHours(0, 0, 0, 0)) / 86400000);
+  if (days === 0) return 'Today, ' + time;
+  if (days === 1) return 'Yesterday, ' + time;
+  return date.toLocaleDateString([], { day: 'numeric', month: 'long' });
+}
+
+function open(id, index = 0) {
+  roundId = id;
+  show(index);
+}
+
+function show(index) {
+  const round = current();
+  shown = round && index >= 0 && index < round.directions.length ? index : 0;
+  said = '';
+  const url = new URL(location.href);
+  if (roundId) url.searchParams.set('round', roundId);
+  url.searchParams.set('direction', String(shown + 1));
+  history.replaceState(null, '', url);
+  render();
+}
+
+function renderRounds() {
+  nav.querySelectorAll('.round').forEach((row) => row.remove());
+  for (const round of rounds) {
+    const row = element('button', 'round');
+    row.type = 'button';
+    row.setAttribute('aria-current', String(round.id === roundId));
+    row.append(element('span', 'truncate', round.title));
+    const status = round.picked ? 'Picked ' + round.picked : round.directions.length + ' to pick from';
+    row.append(element('span', 'truncate small faint', status + ' · ' + when(round.at)));
+    row.onclick = () => open(round.id);
+    nav.append(row);
+  }
+}
+
+function renderSheet() {
+  const round = current();
+  if (!round) {
+    sheet.replaceChildren(empty());
+    return;
+  }
+  document.title = round.title + ' · Directions';
+  const direction = round.directions[shown];
+  const src = 'rounds/' + round.id + '/' + (shown + 1);
+  let frame = sheet.querySelector('iframe');
+  if (!frame) frame = element('iframe');
+  if (frame.getAttribute('src') !== src) {
+    frame.setAttribute('src', src);
+    frame.title = direction.name;
+  }
+  // The page holds no secret of the viewer's, and runs on an origin of its own besides.
+  frame.setAttribute('sandbox', 'allow-scripts allow-forms allow-popups');
+  sheet.replaceChildren(frame, dock(round));
+}
+
+function dock(round) {
+  const options = element('div', 'options');
+  round.directions.forEach((direction, index) => {
+    const option = element('button', 'option');
+    option.type = 'button';
+    option.title = direction.idea;
+    option.setAttribute('aria-pressed', String(index === shown));
+    const head = element('span', 'option-head');
+    head.append(element('span', 'option-name', direction.name));
+    if (direction.name === round.picked) head.insertAdjacentHTML('beforeend', CHECK);
+    head.append(element('span', 'option-number', String(index + 1)));
+    option.append(head, element('span', 'idea', direction.idea));
+    option.onclick = () => show(index);
+    options.append(option);
+  });
+  const act = element('div', 'act');
+  const name = round.directions[shown].name;
+  const button = element('button', 'button');
+  button.type = 'button';
+  if (name === round.picked) {
+    button.className = 'button outline';
+    button.disabled = true;
+    button.innerHTML = CHECK;
+    button.append('Picked');
+  } else {
+    button.className = 'button primary';
+    button.textContent = round.picked ? 'Pick ' + name + ' instead' : 'Pick ' + name;
+    button.onclick = () => pick(round, name);
+  }
+  act.append(button);
+  if (said) act.append(element('span', 'said small faint', said));
+  const switcher = element('div', 'switcher');
+  switcher.append(options, act);
+  const wrapper = element('div', 'dock');
+  wrapper.append(switcher);
+  return wrapper;
+}
+
+function empty(title = 'No directions yet', text = 'When Jinion offers you directions for this project, each round shows here to compare and pick from.') {
+  const box = element('div', 'empty');
+  box.append(element('p', 'title', title), element('p', 'text', text));
+  return box;
+}
+
+async function pick(round, name) {
+  try {
+    const response = await fetch('rounds/' + round.id + '/pick', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ direction: name }) });
+    if (!response.ok) throw new Error(String(response.status));
+    const answer = await response.json();
+    rounds = rounds.map((each) => (each.id === answer.round.id ? answer.round : each));
+    said = answer.sent ? '' : "Saved. Its conversation isn't open, so tell Jinion there.";
+  } catch {
+    said = "Jinion couldn't be reached. Is it still running?";
+  }
+  render();
+}
+
+function render() {
+  document.body.classList.toggle('sidebar-closed', location.hash === '#sidebar-closed');
+  renderRounds();
+  renderSheet();
+}
+
+async function load() {
+  try {
+    const known = new Set(rounds.map((round) => round.id));
+    const response = await fetch('rounds');
+    if (!response.ok) throw new Error(String(response.status));
+    const fresh = await response.json();
+    const first = !loaded;
+    loaded = true;
+    rounds = fresh;
+    const added = fresh.find((round) => !known.has(round.id));
+    // A round shown while the viewer is open comes up by itself.
+    if (!first && added) return open(added.id);
+    if (!current()) roundId = rounds[0] ? rounds[0].id : null;
+    if (first) return roundId ? open(roundId, asked) : render();
+    renderRounds();
+  } catch {
+    if (rounds.length === 0) sheet.replaceChildren(empty("Jinion isn't running", 'The directions show while Jinion runs. Start it again, then reload this page.'));
+  }
+}
+
+addEventListener('hashchange', render);
+addEventListener('keydown', (event) => {
+  const round = current();
+  if (!round || event.metaKey || event.ctrlKey || event.altKey) return;
+  const count = round.directions.length;
+  const number = Number(event.key);
+  if (event.key === 'ArrowRight') show((shown + 1) % count);
+  else if (event.key === 'ArrowLeft') show((shown - 1 + count) % count);
+  else if (number >= 1 && number <= count) show(number - 1);
+});
+load();
+setInterval(load, 2000);
+`;
+//# sourceMappingURL=viewer.js.map

package/dist/directions/viewer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewer.js","sourceRoot":"","sources":["../../src/directions/viewer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,OAAe;IACxC,OAAO;;;;;;SAMA,KAAK;;;iFAGmE,UAAU,CAAC,OAAO,CAAC;;UAE1F,MAAM;;QAER,CAAC;AACT,CAAC;AAED,SAAS,UAAU,CAAC,IAAY;IAC9B,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,KAAK,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AAClF,CAAC;AAED,MAAM,KAAK,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8Db,CAAC;AAEF,MAAM,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkLd,CAAC"}

package/dist/files/names.d.ts

@@ -0,0 +1,6 @@
+/**
+ * The first name free in `folder`, as the Finder names a copy: with a word, `box copy.tsx`, then `box copy 2.tsx`;
+ * without one, `box.tsx` itself, then `box 2.tsx`.
+ */
+export declare function freeName(folder: string, name: string, word: string): Promise<string>;
+//# sourceMappingURL=names.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"names.d.ts","sourceRoot":"","sources":["../../src/files/names.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,mBAexE"}

package/dist/files/names.js

@@ -0,0 +1,18 @@
+import { lstat } from 'node:fs/promises';
+import { extname, join } from 'node:path';
+/**
+ * The first name free in `folder`, as the Finder names a copy: with a word, `box copy.tsx`, then `box copy 2.tsx`;
+ * without one, `box.tsx` itself, then `box 2.tsx`.
+ */
+export async function freeName(folder, name, word) {
+    const extension = extname(name);
+    const stem = name.slice(0, name.length - extension.length);
+    for (let count = 1;; count++) {
+        const suffix = [word, count > 1 ? String(count) : ''].filter(Boolean).join(' ');
+        const candidate = suffix ? `${stem} ${suffix}${extension}` : name;
+        const taken = await lstat(join(folder, candidate)).then(() => true, () => false);
+        if (!taken)
+            return candidate;
+    }
+}
+//# sourceMappingURL=names.js.map

package/dist/files/names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"names.js","sourceRoot":"","sources":["../../src/files/names.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,MAAc,EAAE,IAAY,EAAE,IAAY;IACvE,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IAE3D,KAAK,IAAI,KAAK,GAAG,CAAC,GAAI,KAAK,EAAE,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAChF,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,MAAM,GAAG,SAAS,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAElE,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,CACrD,GAAG,EAAE,CAAC,IAAI,EACV,GAAG,EAAE,CAAC,KAAK,CACZ,CAAC;QAEF,IAAI,CAAC,KAAK;YAAE,OAAO,SAAS,CAAC;IAC/B,CAAC;AACH,CAAC"}

package/dist/files/operations.d.ts

@@ -0,0 +1,54 @@
+import type { FileCreated, FilesCopied, FilesMoved, FilesRestored, Trashed } from './types.js';
+/** Why an operation was refused, for the API to tell as its own error. */
+export declare class FileProblem extends Error {
+    readonly kind: 'missing' | 'taken' | 'invalid';
+    readonly path?: string | undefined;
+    constructor(kind: 'missing' | 'taken' | 'invalid', message: string, path?: string | undefined);
+}
+/**
+ * What can change which files a folder holds: each keeps to the folder, by real paths, so neither `..` nor a link
+ * leads out of it, and a name already taken is refused unless `replace` says to move what holds it to the Trash.
+ */
+export declare class FolderFiles {
+    private readonly root;
+    private constructor();
+    static of(folder: string): Promise<FolderFiles>;
+    /** A file, empty or with `content`, or a folder; the folders it is in are made as needed. */
+    create(path: string, { folder, content, replace }: {
+        folder?: boolean;
+        content?: Buffer;
+        replace?: boolean;
+    }): Promise<FileCreated>;
+    /** Gives a file or folder another name where it is. */
+    rename(path: string, name: string, replace?: boolean): Promise<FilesMoved>;
+    /**
+     * Moves files and folders into a folder of the session's, each keeping its name; with `keepBoth`, one whose name is
+     * taken there takes the next free one, as the Finder's Keep Both names it, `box 2.tsx`.
+     */
+    move(paths: string[], into: string, replace?: boolean, keepBoth?: boolean): Promise<FilesMoved>;
+    /**
+     * Copies files and folders into a folder of the session's: ones of the folder by their paths in it, others, as files
+     * dropped from the Finder, by their whole paths. Copied into the folder it is in, a copy takes a name of its own, as
+     * one whose name is taken does with `keepBoth`.
+     */
+    copy(paths: string[], into: string, replace?: boolean, keepBoth?: boolean): Promise<FilesCopied>;
+    /** Moves files and folders to the Trash. */
+    delete(paths: string[]): Promise<{
+        path: string;
+        trash: string;
+    }[]>;
+    /** Puts back what `delete` or a replace sent to the Trash, at the path it had. */
+    restore(items: Trashed[], replace?: boolean): Promise<FilesRestored>;
+    /** A folder of the session's by its path there, `''` for the folder itself, as a whole path. */
+    folderAt(path: string): Promise<string>;
+    private relocate;
+    private notInto;
+    /** What holds `target`, to the Trash when `replace` says so. */
+    private clear;
+    private existing;
+    private outside;
+    /** Where something new goes: under the deepest folder of its path that is there, which has to be in the folder. */
+    private target;
+    private named;
+}
+//# sourceMappingURL=operations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../../src/files/operations.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,EAAS,OAAO,EAAE,MAAM,YAAY,CAAC;AAEtG,0EAA0E;AAC1E,qBAAa,WAAY,SAAQ,KAAK;IAElC,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS;IAE9C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM;IAHxB,YACW,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,EAC9C,OAAO,EAAE,MAAM,EACN,IAAI,CAAC,EAAE,MAAM,YAAA,EAGvB;CACF;AAED;;;GAGG;AACH,qBAAa,WAAW;IACF,OAAO,CAAC,QAAQ,CAAC,IAAI;IAAzC,OAAO,eAA8C;IAErD,OAAa,EAAE,CAAC,MAAM,EAAE,MAAM,wBAE7B;IAED,6FAA6F;IACvF,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,MAAc,EAAE,OAAO,EAAE,OAAe,EAAE,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAUxJ;IAED,uDAAuD;IACjD,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,UAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CAQ7E;IAED;;;OAGG;IACG,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,UAAQ,EAAE,QAAQ,UAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CAQhG;IAED;;;;OAIG;IACG,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,UAAQ,EAAE,QAAQ,UAAQ,GAAG,OAAO,CAAC,WAAW,CAAC,CAkBjG;IAED,4CAA4C;IACtC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE;;;SAO3B;IAED,kFAAkF;IAC5E,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,OAAO,UAAQ,GAAG,OAAO,CAAC,aAAa,CAAC,CAcvE;IAED,gGAAgG;IAC1F,QAAQ,CAAC,IAAI,EAAE,MAAM,mBAO1B;YAEa,QAAQ;IAiBtB,OAAO,CAAC,OAAO;IAIf,gEAAgE;YAClD,KAAK;YAQL,QAAQ;YAUR,OAAO;IAMrB,mHAAmH;YACrG,MAAM;IAcpB,OAAO,CAAC,KAAK;CAGd"}

package/dist/files/operations.js

@@ -0,0 +1,173 @@
+import { cp, lstat, mkdir, realpath, writeFile } from 'node:fs/promises';
+import { basename, dirname, isAbsolute, join, relative, resolve, sep } from 'node:path';
+import { within } from '../lib/paths.js';
+import { freeName } from './names.js';
+import { fromTrash, moveAcross, restorable, toTrash } from './trash.js';
+/** Why an operation was refused, for the API to tell as its own error. */
+export class FileProblem extends Error {
+    kind;
+    path;
+    constructor(kind, message, path) {
+        super(message);
+        this.kind = kind;
+        this.path = path;
+    }
+}
+/**
+ * What can change which files a folder holds: each keeps to the folder, by real paths, so neither `..` nor a link
+ * leads out of it, and a name already taken is refused unless `replace` says to move what holds it to the Trash.
+ */
+export class FolderFiles {
+    root;
+    constructor(root) {
+        this.root = root;
+    }
+    static async of(folder) {
+        return new FolderFiles(await realpath(folder));
+    }
+    /** A file, empty or with `content`, or a folder; the folders it is in are made as needed. */
+    async create(path, { folder = false, content, replace = false }) {
+        const target = await this.target(path);
+        const replaced = await this.clear(target, replace);
+        await mkdir(dirname(target), { recursive: true });
+        if (folder)
+            await mkdir(target);
+        else
+            await writeFile(target, content ?? '', { flag: 'wx' });
+        return { path: this.named(target), replaced };
+    }
+    /** Gives a file or folder another name where it is. */
+    async rename(path, name, replace = false) {
+        if (!name || name === '.' || name === '..' || name.includes('/') || name.includes(sep)) {
+            throw new FileProblem('invalid', `“${name}” can't be a file's name.`);
+        }
+        const source = await this.existing(path);
+        return this.relocate([[source, join(dirname(source), name)]], replace);
+    }
+    /**
+     * Moves files and folders into a folder of the session's, each keeping its name; with `keepBoth`, one whose name is
+     * taken there takes the next free one, as the Finder's Keep Both names it, `box 2.tsx`.
+     */
+    async move(paths, into, replace = false, keepBoth = false) {
+        const folder = await this.folderAt(into);
+        const sources = await Promise.all(paths.map((path) => this.existing(path)));
+        const pairs = [];
+        for (const source of sources)
+            pairs.push([source, join(folder, keepBoth && dirname(source) !== folder ? await freeName(folder, basename(source), '') : basename(source))]);
+        return this.relocate(pairs, replace);
+    }
+    /**
+     * Copies files and folders into a folder of the session's: ones of the folder by their paths in it, others, as files
+     * dropped from the Finder, by their whole paths. Copied into the folder it is in, a copy takes a name of its own, as
+     * one whose name is taken does with `keepBoth`.
+     */
+    async copy(paths, into, replace = false, keepBoth = false) {
+        const folder = await this.folderAt(into);
+        const copied = [];
+        const replaced = [];
+        for (const path of paths) {
+            const source = isAbsolute(path) && within(path, this.root) === undefined ? await this.outside(path) : await this.existing(path);
+            const own = dirname(source) === folder;
+            const name = own ? await freeName(folder, basename(source), 'copy') : keepBoth ? await freeName(folder, basename(source), '') : basename(source);
+            const target = join(folder, name);
+            this.notInto(source, target);
+            replaced.push(...(await this.clear(target, replace)));
+            await cp(source, target, { recursive: true, verbatimSymlinks: true, errorOnExist: true, force: false });
+            copied.push({ from: within(source, this.root) === undefined ? source : this.named(source), to: this.named(target) });
+        }
+        return { copied, replaced };
+    }
+    /** Moves files and folders to the Trash. */
+    async delete(paths) {
+        const sources = await Promise.all(paths.map((path) => this.existing(path)));
+        const trashed = [];
+        for (const source of sources)
+            trashed.push({ path: this.named(source), trash: await toTrash(source) });
+        return trashed;
+    }
+    /** Puts back what `delete` or a replace sent to the Trash, at the path it had. */
+    async restore(items, replace = false) {
+        const restored = [];
+        const replaced = [];
+        for (const { path, trash } of items) {
+            const target = await this.target(path);
+            if (!(await restorable(trash)))
+                throw new FileProblem('missing', `${path} isn't in the Trash any more.`, path);
+            replaced.push(...(await this.clear(target, replace)));
+            await fromTrash(trash, target);
+            restored.push(this.named(target));
+        }
+        return { restored, replaced };
+    }
+    /** A folder of the session's by its path there, `''` for the folder itself, as a whole path. */
+    async folderAt(path) {
+        const folder = path === '' || path === '.' ? this.root : await this.existing(path).then((each) => realpath(each));
+        const info = await lstat(folder);
+        if (!info.isDirectory() || within(folder, this.root) === undefined)
+            throw new FileProblem('missing', `${path} isn't a folder in this session's folder.`, path);
+        return folder;
+    }
+    async relocate(pairs, replace) {
+        const moved = [];
+        const replaced = [];
+        for (const [source, target] of pairs) {
+            if (source === target)
+                continue;
+            this.notInto(source, target);
+            // A name that differs only in case is the same file on a disk that ignores case, which is no clash.
+            if (!(await sameFile(source, target)))
+                replaced.push(...(await this.clear(target, replace)));
+            await moveAcross(source, target);
+            moved.push({ from: this.named(source), to: this.named(target) });
+        }
+        return { moved, replaced };
+    }
+    notInto(source, target) {
+        if (target.startsWith(`${source}${sep}`))
+            throw new FileProblem('invalid', `${this.named(source)} can't go into itself.`, this.named(source));
+    }
+    /** What holds `target`, to the Trash when `replace` says so. */
+    async clear(target, replace) {
+        if (!(await lstat(target).catch(() => undefined)))
+            return [];
+        if (!replace)
+            throw new FileProblem('taken', `${this.named(target)} is already there.`, this.named(target));
+        return [{ path: this.named(target), trash: await toTrash(target) }];
+    }
+    // A path that is there, its last part not followed, so a link is moved itself rather than what it points at.
+    async existing(path) {
+        const absolute = resolve(this.root, path);
+        const parent = within(absolute, this.root) === undefined ? undefined : await realpath(dirname(absolute)).catch(() => undefined);
+        const file = parent && join(parent, basename(absolute));
+        const there = file && file !== this.root && within(file, this.root) !== undefined && (await lstat(file).catch(() => undefined));
+        if (!file || !there)
+            throw new FileProblem('missing', `${path} isn't in this session's folder.`, path);
+        return file;
+    }
+    async outside(path) {
+        if (!(await lstat(path).catch(() => undefined)))
+            throw new FileProblem('missing', `${path} isn't there.`, path);
+        return path;
+    }
+    /** Where something new goes: under the deepest folder of its path that is there, which has to be in the folder. */
+    async target(path) {
+        const absolute = resolve(this.root, path);
+        if (within(absolute, this.root) === undefined || absolute === this.root)
+            throw new FileProblem('missing', `${path} isn't in this session's folder.`, path);
+        let base = dirname(absolute);
+        while (!(await lstat(base).catch(() => undefined)))
+            base = dirname(base);
+        const real = await realpath(base);
+        if (within(real, this.root) === undefined)
+            throw new FileProblem('missing', `${path} isn't in this session's folder.`, path);
+        return join(real, relative(base, absolute));
+    }
+    named(file) {
+        return relative(this.root, file);
+    }
+}
+async function sameFile(one, other) {
+    const [a, b] = await Promise.all([lstat(one), lstat(other).catch(() => undefined)]);
+    return b !== undefined && a.dev === b.dev && a.ino === b.ino;
+}
+//# sourceMappingURL=operations.js.map

package/dist/files/operations.js.map

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

package/dist/files/search.d.ts

@@ -0,0 +1,11 @@
+import type { Replaced, SearchQuery, SearchResults } from './types.js';
+/** What `query` asks for as a regular expression; throws one that isn't valid. */
+export declare function patternOf({ query, caseSensitive, wholeWord, regex }: SearchQuery): RegExp;
+/** Every line of the folder's files the query finds, file by file in the order git lists them, up to a limit. */
+export declare function searchFiles(folder: string, search: SearchQuery): Promise<SearchResults>;
+/**
+ * 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 declare function replaceInFiles(folder: string, search: SearchQuery, replacement: string, paths?: string[]): Promise<Replaced>;
+//# sourceMappingURL=search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/files/search.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAe,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AASpF,kFAAkF;AAClF,wBAAgB,SAAS,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,WAAW,UAIhF;AAED,iHAAiH;AACjH,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAqB7F;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,QAAQ,CAAC,CAsBlI"}