@ssebastien/tcmd 0.1.3 → 0.1.7

package/src/js/tcmd/core/index.js

@@ -14,6 +14,7 @@ export { createNodeFs } from "./fs.js"
 export { createNullOs, createNodeOs } from "./os.js"
 export { filterEntries, rankEntries, sortEntries, viewEntries } from "./entries.js"
 export { clampCursor, currentEntry, moveCursor, toggleMark } from "./selection.js"
+export { createHistory } from "./history.js"
 export { PANE_BUFFERS, PANE_LABELS, createPane } from "./pane.js"
 export { createDirectory } from "./directory.js"
 export {
@@ -26,14 +27,7 @@ export {
 export { DEFAULT_KEYMAP, matchKeymap } from "./keymap.js"
 export { createDispatch, getCommand, getCommands } from "./commands.js"
 export { expandAll, expandArg, decodePathToken, getOperation, getOperations, pathToken, runOperation } from "./operations.js"
-export {
-	PANEL_FOCUS,
-	argvFor,
-	bindArgs,
-	panelOperations,
-	panelRowList,
-	paneSelectionPaths,
-} from "./panel.js"
-export { parseLine, runLine, scriptItems, tokenize } from "./script.js"
+export { PANEL_FOCUS, argvFor, bindArgs, panelEntries, panelRowList, paneSelectionPaths } from "./panel.js"
+export { parseLine, runLine, tokenize } from "./script.js"
 export { createSession, load } from "./session.js"
 export { SEP, basename, extname, join, normalize, parent, prefix, split } from "./path.js"

package/src/js/tcmd/core/journal.js

@@ -0,0 +1,93 @@
+// Project: TinyCommand
+// Author:  Sebastien Pierre
+// License: BSD
+// Created: 2026-10-17
+
+// Module: tcmd/core/journal
+// The undo/redo journal: an ordered list of applied file operations, each
+// carrying an inverse (`undo`) and a forward (`redo`) action. `index` points at
+// the last *applied* entry; entries after it are undone and can be redone.
+// `record` appends and truncates any redo tail (a new action forks history), so
+// the model is a plain linear history like a text editor's.
+//
+// Actions are closures over the paths an operation touched, so the journal is
+// session-only (not persisted): a fresh session starts empty. `rows()` projects
+// the entries for the history panel, marking which are applied and where the
+// pointer sits.
+
+import { cell } from "select/state/cells"
+
+// Function: createJournal
+// Creates an empty journal. `entries` is the ordered action list (oldest
+// first); `index` is the last applied entry (-1 when nothing is applied).
+function createJournal({ entries = [], index = -1 } = {}) {
+	const journal = {}
+	journal.entries = cell(entries.slice())
+	journal.index = cell(Math.min(index, entries.length - 1))
+	let sequence = entries.length
+
+	// Function: record
+	// Appends `entry` — `{ label, undo?, redo? }` — discarding any undone tail,
+	// and moves the pointer onto it. Returns the entry's id.
+	journal.record = (entry) => {
+		const kept = journal.entries.value.slice(0, journal.index.value + 1)
+		const recorded = { id: ++sequence, at: Date.now(), ...entry }
+		kept.push(recorded)
+		journal.entries.set(kept)
+		journal.index.set(kept.length - 1)
+		return recorded.id
+	}
+
+	// Function: canUndo / canRedo
+	journal.canUndo = () => journal.index.value >= 0
+	journal.canRedo = () => journal.index.value < journal.entries.value.length - 1
+
+	// Function: undo
+	// Runs the inverse of the entry at the pointer and steps back. Returns the
+	// entry, or null when there is nothing to undo.
+	journal.undo = async (session) => {
+		if (!journal.canUndo()) return null
+		const entry = journal.entries.value[journal.index.value]
+		await entry?.undo?.(session)
+		journal.index.set(journal.index.value - 1)
+		return entry
+	}
+
+	// Function: redo
+	// Re-applies the next undone entry and steps onto it. Returns the entry, or
+	// null when there is nothing to redo.
+	journal.redo = async (session) => {
+		if (!journal.canRedo()) return null
+		const next = journal.index.value + 1
+		const entry = journal.entries.value[next]
+		await entry?.redo?.(session)
+		journal.index.set(next)
+		return entry
+	}
+
+	// Function: goTo
+	// Undoes or redoes repeated until the pointer sits on `target` (-1 empties
+	// the applied set). Used by the history panel to jump to an entry.
+	journal.goTo = async (session, target) => {
+		while (journal.index.value > target && journal.canUndo()) await journal.undo(session)
+		while (journal.index.value < target && journal.canRedo()) await journal.redo(session)
+	}
+
+	// Function: rows
+	// Panel rows, oldest first: `{ id, label, at, index, applied, current }`.
+	journal.rows = () =>
+		journal.entries.value.map((entry, i) => ({
+			id: entry.id,
+			label: entry.label,
+			at: entry.at,
+			index: i,
+			applied: i <= journal.index.value,
+			current: i === journal.index.value,
+		}))
+
+	return journal
+}
+
+export { createJournal }
+
+// EOF

package/src/js/tcmd/core/keymap.js

@@ -26,18 +26,26 @@ const DEFAULT_KEYMAP = [
 	{ key: "tab", command: "pane.toggle" },
 	{ key: "tab", shift: true, command: "pane.toggle" },
 	{ key: "space", command: "list.mark" },
-	{ key: "b", command: "bookmark.record" },
-	{ key: "g", command: "bookmark.jump" },
-	{ key: "m", command: "panel.toggle" },
+	{ key: "b", command: "bookmark.open" },
 	{ key: ":", command: "panel.open" },
-	{ key: "!", command: "palette.run" },
+	{ key: "!", command: "panel.shell" },
 	{ key: "/", command: "filter.start" },
+	{ key: "f5", command: "pane.reload" },
+	{ key: "r", command: "pane.reload" },
 	{ key: "r", ctrl: true, command: "pane.reload" },
 	{ key: "v", command: "view.togglePreview" },
+	{ key: "v", shift: true, command: "view.maximize" },
+	{ key: "t", command: "view.toggleMode" },
+	{ key: "t", shift: true, command: "trash.open" },
+	{ key: "n", command: "file.mkdir" },
+	{ key: "u", command: "history.open" },
+	{ key: "z", ctrl: true, command: "history.undo" },
+	{ key: "z", ctrl: true, shift: true, command: "history.redo" },
+	{ key: "y", ctrl: true, command: "history.redo" },
 	{ key: "o", shift: true, command: "file.open" },
 	{ key: "e", shift: true, command: "file.edit" },
-	{ key: "p", ctrl: true, command: "palette.toggle" },
 	{ key: "q", command: "app.quit" },
+	{ key: "?", command: "app.help" },
 ]
 
 // Function: matchKeymap
@@ -55,6 +63,34 @@ function matchKeymap(keymap, chord) {
 	return null
 }
 
-export { DEFAULT_KEYMAP, matchKeymap }
+// Function: keyGlyph
+// Human-readable label for a keymap chord ("↑", "⇧Tab", "^W", "PgUp").
+function keyGlyph(chord) {
+	const name = chord.key
+	const named = {
+		up: "↑",
+		down: "↓",
+		left: "←",
+		right: "→",
+		return: "↵",
+		enter: "↵",
+		space: "Space",
+		tab: "Tab",
+		pageup: "PgUp",
+		pagedown: "PgDn",
+		escape: "Esc",
+		backspace: "Bksp",
+		home: "Home",
+		end: "End",
+		f5: "F5",
+	}
+	let base = named[name] ?? (name.length === 1 ? name.toUpperCase() : `${name}`)
+	if (chord.ctrl) base = `^${base}`
+	if (chord.meta) base = `⌘${base}`
+	if (chord.shift) base = `⇧${base}`
+	return base
+}
+
+export { DEFAULT_KEYMAP, keyGlyph, matchKeymap }
 
 // EOF