shellrecap 0.1.0

package/dist/index.d.cts

@@ -0,0 +1,314 @@
+type ShellFormat = "zsh-extended" | "bash" | "fish" | "plain";
+/** One history entry: the command line as typed, plus an epoch timestamp if the format records one. */
+interface HistoryEntry {
+    cmd: string;
+    /** Unix epoch seconds, when the shell recorded it (zsh extended / bash HISTTIMEFORMAT / fish). */
+    ts?: number;
+}
+/** One simple command inside an entry (entries can contain pipes / && / ;). */
+interface Segment {
+    /** The base command, e.g. "git" (sudo/env wrappers stripped, paths basename'd). */
+    base: string;
+    /** "git status" style two-token form for known multi-part CLIs, else same as base. */
+    withSub: string;
+    /** Raw tokens of the segment (after wrapper stripping). */
+    tokens: string[];
+    sudo: boolean;
+}
+/** A tokenized entry. */
+interface ParsedEntry {
+    raw: string;
+    ts?: number;
+    segments: Segment[];
+    pipes: number;
+}
+interface CommandCount {
+    name: string;
+    count: number;
+}
+interface TimeStats {
+    /** True when the history format carried timestamps. */
+    hasTimestamps: boolean;
+    /** Counts by hour 0-23 (only meaningful when hasTimestamps). */
+    byHour: number[];
+    /** Counts by weekday 0=Sun..6=Sat. */
+    byWeekday: number[];
+    peakHour: number;
+    peakWeekday: number;
+    /** Percent of commands typed 22:00–04:59. */
+    nightOwlPct: number;
+    /** Percent typed on Sat/Sun. */
+    weekendPct: number;
+    /** First and last entry dates, YYYY-MM-DD. */
+    firstDate?: string;
+    lastDate?: string;
+    /** Busiest single day. */
+    busiestDay?: {
+        date: string;
+        commands: number;
+    };
+}
+interface TypoHit {
+    typo: string;
+    /** What they meant. */
+    target: string;
+    count: number;
+}
+interface TypoStats {
+    hits: TypoHit[];
+    /** Total mistyped entries. */
+    total: number;
+    /** Wasted keystrokes (typo length × count). */
+    wastedKeystrokes: number;
+}
+interface AliasSuggestion {
+    /** The exact command line typed repeatedly. */
+    command: string;
+    /** Suggested alias name. */
+    alias: string;
+    count: number;
+    /** Keystrokes this alias would have saved: (len(command) - len(alias)) × count. */
+    saves: number;
+}
+interface AliasStats {
+    suggestions: AliasSuggestion[];
+    /** Total keystrokes all suggestions would have saved. */
+    totalSavable: number;
+}
+type SecretKind = "aws-access-key" | "github-token" | "slack-token" | "stripe-key" | "npm-token" | "openai-key" | "jwt" | "bearer-header" | "password-flag" | "password-env";
+interface SecretHit {
+    kind: SecretKind;
+    /** SAFE masked preview, e.g. "ghp_Fk…". Never the full value. */
+    masked: string;
+    /** 1-based entry index in the parsed history (helps locate & delete the line). */
+    entryIndex: number;
+}
+interface Persona {
+    id: string;
+    title: string;
+    emoji: string;
+    blurb: string;
+}
+interface Totals {
+    entries: number;
+    /** Simple commands after splitting pipes/&&/; */
+    segments: number;
+    uniqueCommands: number;
+    uniqueBases: number;
+    pipePct: number;
+    sudoPct: number;
+    avgLength: number;
+}
+interface WrappedReport {
+    source: {
+        label: string;
+        format: ShellFormat;
+    };
+    totals: Totals;
+    time: TimeStats;
+    topCommands: CommandCount[];
+    topSubcommands: CommandCount[];
+    typos: TypoStats;
+    aliases: AliasStats;
+    secrets: SecretHit[];
+    persona: Persona;
+}
+type Theme = "tokyonight" | "dark" | "light" | "candy";
+interface Config {
+    theme: Theme;
+    /** How many top commands / suggestions to show. */
+    top: number;
+    /** Minimum times a long command must repeat before suggesting an alias. */
+    aliasMinCount: number;
+    /** Minimum command length to consider for an alias. */
+    aliasMinLength: number;
+    /** Base commands to ignore entirely (e.g. your employer's internal CLI). */
+    ignoreCommands: string[];
+    /** Scan for secrets left in history (output is always masked). */
+    secretScan: boolean;
+}
+
+declare function detectFormat(raw: string): ShellFormat;
+declare function parseZshExtended(raw: string): HistoryEntry[];
+declare function parseBash(raw: string): HistoryEntry[];
+declare function parseFish(raw: string): HistoryEntry[];
+declare function parsePlain(raw: string): HistoryEntry[];
+/** Parse a history file's contents, auto-detecting the format unless given. */
+declare function parseHistory(raw: string, format?: ShellFormat): {
+    entries: HistoryEntry[];
+    format: ShellFormat;
+};
+
+/**
+ * Split a command line on unquoted |, ||, &&, ; and newlines.
+ * A tiny state machine: enough shell awareness for stats, not a real parser.
+ */
+declare function splitSegments(cmd: string): {
+    parts: string[];
+    pipes: number;
+};
+/** Quote-aware tokens of a single simple command. */
+declare function tokens(segment: string): string[];
+/** Tokenize one simple command into a Segment (wrappers stripped, sudo tracked). */
+declare function toSegment(part: string): Segment | null;
+/** Tokenize a parsed history entry into segments. */
+declare function tokenizeEntry(entry: HistoryEntry): ParsedEntry;
+
+interface AnalyzeContext {
+    /** Display label for the source, e.g. "~/.zsh_history". */
+    sourceLabel: string;
+    format: ShellFormat;
+    /** Minutes to add to UTC for local time (KST = +540). The CLI injects the machine's. */
+    tzOffsetMin: number;
+}
+/** The single pure entrypoint: parsed history + config + context → recap. */
+declare function analyze(rawEntries: HistoryEntry[], config: Config, ctx: AnalyzeContext): WrappedReport;
+
+declare function computeTimeStats(entries: ParsedEntry[], tzOffsetMin: number): TimeStats;
+
+declare const KNOWN_TYPOS: Record<string, string>;
+declare const KNOWN_COMMANDS: Set<string>;
+/**
+ * Optimal-string-alignment distance (Levenshtein + adjacent transposition as 1),
+ * capped at `max`. Transpositions matter: "gti"→"git" must be distance 1.
+ */
+declare function editDistance(a: string, b: string, max?: number): number;
+/**
+ * Find likely typos. Two passes:
+ *  1. the curated dictionary (always wins);
+ *  2. frequency heuristic — a rare base (≤ max(3, 1% of target)) at edit distance 1
+ *     from a much more popular base, where the rare one is NOT a known real command.
+ */
+declare function computeTypoStats(entries: ParsedEntry[]): TypoStats;
+
+/**
+ * Derive an alias name from a command line: first letter of each word token,
+ * skipping flags ("docker compose up -d --build" → "dcu",
+ * "kubectl get pods -n production" → "kgp"). Falls back to extending with more
+ * letters on collision within this suggestion set.
+ */
+declare function suggestAliasName(command: string, taken: Set<string>): string;
+/**
+ * Suggest aliases for exact command lines typed over and over.
+ * Deterministic: grouped by exact text, ranked by keystrokes saved.
+ */
+declare function computeAliasStats(entries: ParsedEntry[], opts: {
+    minCount: number;
+    minLength: number;
+    top: number;
+}): AliasStats;
+
+/** Mask a matched secret: keep a short identifying prefix, drop the rest. */
+declare function mask(value: string): string;
+/**
+ * Scan entries for secrets. `entryIndex` is 1-based over the parsed entries so
+ * the user can find and delete the line. Output is ALWAYS masked.
+ */
+declare function computeSecretHits(entries: ParsedEntry[]): SecretHit[];
+declare const SECRET_KIND_LABELS: Record<SecretKind, string>;
+
+declare const PERSONAS: {
+    readonly nightOwl: {
+        readonly id: "night-owl";
+        readonly title: "The Night Owl";
+        readonly emoji: "🦉";
+        readonly blurb: "Your terminal sees more moonlight than sunlight.";
+    };
+    readonly pipeWizard: {
+        readonly id: "pipe-wizard";
+        readonly title: "The Pipe Wizard";
+        readonly emoji: "🧙";
+        readonly blurb: "Why run one command when five can hold hands?";
+    };
+    readonly sudoSummoner: {
+        readonly id: "sudo-summoner";
+        readonly title: "The Sudo Summoner";
+        readonly emoji: "🔱";
+        readonly blurb: "Asking for forgiveness, never for permission.";
+    };
+    readonly gitGremlin: {
+        readonly id: "git-gremlin";
+        readonly title: "The Git Gremlin";
+        readonly emoji: "🐙";
+        readonly blurb: "Your shell is basically a git client with extra steps.";
+    };
+    readonly containerCaptain: {
+        readonly id: "container-captain";
+        readonly title: "The Container Captain";
+        readonly emoji: "🐳";
+        readonly blurb: "Everything's fine — it works in the container.";
+    };
+    readonly vimMonk: {
+        readonly id: "vim-monk";
+        readonly title: "The Vim Monk";
+        readonly emoji: "🧘";
+        readonly blurb: "You live inside the editor. The shell is just the hallway.";
+    };
+    readonly typoArtist: {
+        readonly id: "typo-artist";
+        readonly title: "The Typo Artist";
+        readonly emoji: "🎨";
+        readonly blurb: "gti, sl, dokcer — close enough, every time.";
+    };
+    readonly navigator: {
+        readonly id: "navigator";
+        readonly title: "The Navigator";
+        readonly emoji: "🧭";
+        readonly blurb: "cd, ls, cd, ls — forever exploring, never lost (mostly).";
+    };
+    readonly polyglot: {
+        readonly id: "polyglot";
+        readonly title: "The Polyglot";
+        readonly emoji: "🌐";
+        readonly blurb: "Is there a CLI you haven't tried?";
+    };
+    readonly steadyOperator: {
+        readonly id: "steady-operator";
+        readonly title: "The Steady Operator";
+        readonly emoji: "🎛️";
+        readonly blurb: "Calm, consistent, quietly unstoppable.";
+    };
+};
+interface PersonaInput {
+    totals: Totals;
+    time: TimeStats;
+    typos: TypoStats;
+    topCommands: CommandCount[];
+}
+/** First matching rule wins — fully deterministic. */
+declare function derivePersona(input: PersonaInput, allBases: CommandCount[]): Persona;
+
+/** Render the recap as a self-contained, shareable SVG. */
+declare function renderCard(report: WrappedReport, theme?: Theme): string;
+
+/** Stable, pretty-printed JSON of the full report (secrets stay masked by construction). */
+declare function toJSON(report: WrappedReport): string;
+
+/** A shareable Markdown recap. Secrets are masked by construction. */
+declare function toMarkdown(r: WrappedReport): string;
+
+declare const DEFAULT_CONFIG: Config;
+declare const CONFIG_FILENAMES: string[];
+/** Coerce arbitrary parsed JSON into a safe partial config (unknown keys ignored). */
+declare function parseConfig(raw: unknown): Partial<Config>;
+declare function mergeConfig(base: Config, override: Partial<Config>): Config;
+declare function isValidTheme(t: string): t is Theme;
+
+/** Local hour 0-23 for an epoch-seconds value shifted by tzOffsetMin. */
+declare function epochToHour(ts: number, tzOffsetMin: number): number;
+/** Weekday 0=Sunday..6=Saturday (1970-01-01 was a Thursday = 4). */
+declare function epochToWeekday(ts: number, tzOffsetMin: number): number;
+/** Civil date from a days-since-epoch value (Howard Hinnant's civil_from_days). */
+declare function daysToYMD(z: number): {
+    y: number;
+    m: number;
+    d: number;
+};
+/** "YYYY-MM-DD" for an epoch-seconds value shifted by tzOffsetMin. */
+declare function epochToDate(ts: number, tzOffsetMin: number): string;
+declare const WEEKDAY_NAMES: string[];
+declare const WEEKDAY_SHORT: string[];
+/** "14" -> "2 PM", "0" -> "12 AM". */
+declare function hourLabel(h: number): string;
+
+export { type AliasStats, type AliasSuggestion, type AnalyzeContext, CONFIG_FILENAMES, type CommandCount, type Config, DEFAULT_CONFIG, type HistoryEntry, KNOWN_COMMANDS, KNOWN_TYPOS, PERSONAS, type ParsedEntry, type Persona, SECRET_KIND_LABELS, type SecretHit, type SecretKind, type Segment, type ShellFormat, type Theme, type TimeStats, type Totals, type TypoHit, type TypoStats, WEEKDAY_NAMES, WEEKDAY_SHORT, type WrappedReport, analyze, computeAliasStats, computeSecretHits, computeTimeStats, computeTypoStats, daysToYMD, derivePersona, detectFormat, editDistance, epochToDate, epochToHour, epochToWeekday, hourLabel, isValidTheme, mask, mergeConfig, parseBash, parseConfig, parseFish, parseHistory, parsePlain, parseZshExtended, renderCard, splitSegments, suggestAliasName, toJSON, toMarkdown, toSegment, tokenizeEntry, tokens };

package/dist/index.d.ts

@@ -0,0 +1,314 @@
+type ShellFormat = "zsh-extended" | "bash" | "fish" | "plain";
+/** One history entry: the command line as typed, plus an epoch timestamp if the format records one. */
+interface HistoryEntry {
+    cmd: string;
+    /** Unix epoch seconds, when the shell recorded it (zsh extended / bash HISTTIMEFORMAT / fish). */
+    ts?: number;
+}
+/** One simple command inside an entry (entries can contain pipes / && / ;). */
+interface Segment {
+    /** The base command, e.g. "git" (sudo/env wrappers stripped, paths basename'd). */
+    base: string;
+    /** "git status" style two-token form for known multi-part CLIs, else same as base. */
+    withSub: string;
+    /** Raw tokens of the segment (after wrapper stripping). */
+    tokens: string[];
+    sudo: boolean;
+}
+/** A tokenized entry. */
+interface ParsedEntry {
+    raw: string;
+    ts?: number;
+    segments: Segment[];
+    pipes: number;
+}
+interface CommandCount {
+    name: string;
+    count: number;
+}
+interface TimeStats {
+    /** True when the history format carried timestamps. */
+    hasTimestamps: boolean;
+    /** Counts by hour 0-23 (only meaningful when hasTimestamps). */
+    byHour: number[];
+    /** Counts by weekday 0=Sun..6=Sat. */
+    byWeekday: number[];
+    peakHour: number;
+    peakWeekday: number;
+    /** Percent of commands typed 22:00–04:59. */
+    nightOwlPct: number;
+    /** Percent typed on Sat/Sun. */
+    weekendPct: number;
+    /** First and last entry dates, YYYY-MM-DD. */
+    firstDate?: string;
+    lastDate?: string;
+    /** Busiest single day. */
+    busiestDay?: {
+        date: string;
+        commands: number;
+    };
+}
+interface TypoHit {
+    typo: string;
+    /** What they meant. */
+    target: string;
+    count: number;
+}
+interface TypoStats {
+    hits: TypoHit[];
+    /** Total mistyped entries. */
+    total: number;
+    /** Wasted keystrokes (typo length × count). */
+    wastedKeystrokes: number;
+}
+interface AliasSuggestion {
+    /** The exact command line typed repeatedly. */
+    command: string;
+    /** Suggested alias name. */
+    alias: string;
+    count: number;
+    /** Keystrokes this alias would have saved: (len(command) - len(alias)) × count. */
+    saves: number;
+}
+interface AliasStats {
+    suggestions: AliasSuggestion[];
+    /** Total keystrokes all suggestions would have saved. */
+    totalSavable: number;
+}
+type SecretKind = "aws-access-key" | "github-token" | "slack-token" | "stripe-key" | "npm-token" | "openai-key" | "jwt" | "bearer-header" | "password-flag" | "password-env";
+interface SecretHit {
+    kind: SecretKind;
+    /** SAFE masked preview, e.g. "ghp_Fk…". Never the full value. */
+    masked: string;
+    /** 1-based entry index in the parsed history (helps locate & delete the line). */
+    entryIndex: number;
+}
+interface Persona {
+    id: string;
+    title: string;
+    emoji: string;
+    blurb: string;
+}
+interface Totals {
+    entries: number;
+    /** Simple commands after splitting pipes/&&/; */
+    segments: number;
+    uniqueCommands: number;
+    uniqueBases: number;
+    pipePct: number;
+    sudoPct: number;
+    avgLength: number;
+}
+interface WrappedReport {
+    source: {
+        label: string;
+        format: ShellFormat;
+    };
+    totals: Totals;
+    time: TimeStats;
+    topCommands: CommandCount[];
+    topSubcommands: CommandCount[];
+    typos: TypoStats;
+    aliases: AliasStats;
+    secrets: SecretHit[];
+    persona: Persona;
+}
+type Theme = "tokyonight" | "dark" | "light" | "candy";
+interface Config {
+    theme: Theme;
+    /** How many top commands / suggestions to show. */
+    top: number;
+    /** Minimum times a long command must repeat before suggesting an alias. */
+    aliasMinCount: number;
+    /** Minimum command length to consider for an alias. */
+    aliasMinLength: number;
+    /** Base commands to ignore entirely (e.g. your employer's internal CLI). */
+    ignoreCommands: string[];
+    /** Scan for secrets left in history (output is always masked). */
+    secretScan: boolean;
+}
+
+declare function detectFormat(raw: string): ShellFormat;
+declare function parseZshExtended(raw: string): HistoryEntry[];
+declare function parseBash(raw: string): HistoryEntry[];
+declare function parseFish(raw: string): HistoryEntry[];
+declare function parsePlain(raw: string): HistoryEntry[];
+/** Parse a history file's contents, auto-detecting the format unless given. */
+declare function parseHistory(raw: string, format?: ShellFormat): {
+    entries: HistoryEntry[];
+    format: ShellFormat;
+};
+
+/**
+ * Split a command line on unquoted |, ||, &&, ; and newlines.
+ * A tiny state machine: enough shell awareness for stats, not a real parser.
+ */
+declare function splitSegments(cmd: string): {
+    parts: string[];
+    pipes: number;
+};
+/** Quote-aware tokens of a single simple command. */
+declare function tokens(segment: string): string[];
+/** Tokenize one simple command into a Segment (wrappers stripped, sudo tracked). */
+declare function toSegment(part: string): Segment | null;
+/** Tokenize a parsed history entry into segments. */
+declare function tokenizeEntry(entry: HistoryEntry): ParsedEntry;
+
+interface AnalyzeContext {
+    /** Display label for the source, e.g. "~/.zsh_history". */
+    sourceLabel: string;
+    format: ShellFormat;
+    /** Minutes to add to UTC for local time (KST = +540). The CLI injects the machine's. */
+    tzOffsetMin: number;
+}
+/** The single pure entrypoint: parsed history + config + context → recap. */
+declare function analyze(rawEntries: HistoryEntry[], config: Config, ctx: AnalyzeContext): WrappedReport;
+
+declare function computeTimeStats(entries: ParsedEntry[], tzOffsetMin: number): TimeStats;
+
+declare const KNOWN_TYPOS: Record<string, string>;
+declare const KNOWN_COMMANDS: Set<string>;
+/**
+ * Optimal-string-alignment distance (Levenshtein + adjacent transposition as 1),
+ * capped at `max`. Transpositions matter: "gti"→"git" must be distance 1.
+ */
+declare function editDistance(a: string, b: string, max?: number): number;
+/**
+ * Find likely typos. Two passes:
+ *  1. the curated dictionary (always wins);
+ *  2. frequency heuristic — a rare base (≤ max(3, 1% of target)) at edit distance 1
+ *     from a much more popular base, where the rare one is NOT a known real command.
+ */
+declare function computeTypoStats(entries: ParsedEntry[]): TypoStats;
+
+/**
+ * Derive an alias name from a command line: first letter of each word token,
+ * skipping flags ("docker compose up -d --build" → "dcu",
+ * "kubectl get pods -n production" → "kgp"). Falls back to extending with more
+ * letters on collision within this suggestion set.
+ */
+declare function suggestAliasName(command: string, taken: Set<string>): string;
+/**
+ * Suggest aliases for exact command lines typed over and over.
+ * Deterministic: grouped by exact text, ranked by keystrokes saved.
+ */
+declare function computeAliasStats(entries: ParsedEntry[], opts: {
+    minCount: number;
+    minLength: number;
+    top: number;
+}): AliasStats;
+
+/** Mask a matched secret: keep a short identifying prefix, drop the rest. */
+declare function mask(value: string): string;
+/**
+ * Scan entries for secrets. `entryIndex` is 1-based over the parsed entries so
+ * the user can find and delete the line. Output is ALWAYS masked.
+ */
+declare function computeSecretHits(entries: ParsedEntry[]): SecretHit[];
+declare const SECRET_KIND_LABELS: Record<SecretKind, string>;
+
+declare const PERSONAS: {
+    readonly nightOwl: {
+        readonly id: "night-owl";
+        readonly title: "The Night Owl";
+        readonly emoji: "🦉";
+        readonly blurb: "Your terminal sees more moonlight than sunlight.";
+    };
+    readonly pipeWizard: {
+        readonly id: "pipe-wizard";
+        readonly title: "The Pipe Wizard";
+        readonly emoji: "🧙";
+        readonly blurb: "Why run one command when five can hold hands?";
+    };
+    readonly sudoSummoner: {
+        readonly id: "sudo-summoner";
+        readonly title: "The Sudo Summoner";
+        readonly emoji: "🔱";
+        readonly blurb: "Asking for forgiveness, never for permission.";
+    };
+    readonly gitGremlin: {
+        readonly id: "git-gremlin";
+        readonly title: "The Git Gremlin";
+        readonly emoji: "🐙";
+        readonly blurb: "Your shell is basically a git client with extra steps.";
+    };
+    readonly containerCaptain: {
+        readonly id: "container-captain";
+        readonly title: "The Container Captain";
+        readonly emoji: "🐳";
+        readonly blurb: "Everything's fine — it works in the container.";
+    };
+    readonly vimMonk: {
+        readonly id: "vim-monk";
+        readonly title: "The Vim Monk";
+        readonly emoji: "🧘";
+        readonly blurb: "You live inside the editor. The shell is just the hallway.";
+    };
+    readonly typoArtist: {
+        readonly id: "typo-artist";
+        readonly title: "The Typo Artist";
+        readonly emoji: "🎨";
+        readonly blurb: "gti, sl, dokcer — close enough, every time.";
+    };
+    readonly navigator: {
+        readonly id: "navigator";
+        readonly title: "The Navigator";
+        readonly emoji: "🧭";
+        readonly blurb: "cd, ls, cd, ls — forever exploring, never lost (mostly).";
+    };
+    readonly polyglot: {
+        readonly id: "polyglot";
+        readonly title: "The Polyglot";
+        readonly emoji: "🌐";
+        readonly blurb: "Is there a CLI you haven't tried?";
+    };
+    readonly steadyOperator: {
+        readonly id: "steady-operator";
+        readonly title: "The Steady Operator";
+        readonly emoji: "🎛️";
+        readonly blurb: "Calm, consistent, quietly unstoppable.";
+    };
+};
+interface PersonaInput {
+    totals: Totals;
+    time: TimeStats;
+    typos: TypoStats;
+    topCommands: CommandCount[];
+}
+/** First matching rule wins — fully deterministic. */
+declare function derivePersona(input: PersonaInput, allBases: CommandCount[]): Persona;
+
+/** Render the recap as a self-contained, shareable SVG. */
+declare function renderCard(report: WrappedReport, theme?: Theme): string;
+
+/** Stable, pretty-printed JSON of the full report (secrets stay masked by construction). */
+declare function toJSON(report: WrappedReport): string;
+
+/** A shareable Markdown recap. Secrets are masked by construction. */
+declare function toMarkdown(r: WrappedReport): string;
+
+declare const DEFAULT_CONFIG: Config;
+declare const CONFIG_FILENAMES: string[];
+/** Coerce arbitrary parsed JSON into a safe partial config (unknown keys ignored). */
+declare function parseConfig(raw: unknown): Partial<Config>;
+declare function mergeConfig(base: Config, override: Partial<Config>): Config;
+declare function isValidTheme(t: string): t is Theme;
+
+/** Local hour 0-23 for an epoch-seconds value shifted by tzOffsetMin. */
+declare function epochToHour(ts: number, tzOffsetMin: number): number;
+/** Weekday 0=Sunday..6=Saturday (1970-01-01 was a Thursday = 4). */
+declare function epochToWeekday(ts: number, tzOffsetMin: number): number;
+/** Civil date from a days-since-epoch value (Howard Hinnant's civil_from_days). */
+declare function daysToYMD(z: number): {
+    y: number;
+    m: number;
+    d: number;
+};
+/** "YYYY-MM-DD" for an epoch-seconds value shifted by tzOffsetMin. */
+declare function epochToDate(ts: number, tzOffsetMin: number): string;
+declare const WEEKDAY_NAMES: string[];
+declare const WEEKDAY_SHORT: string[];
+/** "14" -> "2 PM", "0" -> "12 AM". */
+declare function hourLabel(h: number): string;
+
+export { type AliasStats, type AliasSuggestion, type AnalyzeContext, CONFIG_FILENAMES, type CommandCount, type Config, DEFAULT_CONFIG, type HistoryEntry, KNOWN_COMMANDS, KNOWN_TYPOS, PERSONAS, type ParsedEntry, type Persona, SECRET_KIND_LABELS, type SecretHit, type SecretKind, type Segment, type ShellFormat, type Theme, type TimeStats, type Totals, type TypoHit, type TypoStats, WEEKDAY_NAMES, WEEKDAY_SHORT, type WrappedReport, analyze, computeAliasStats, computeSecretHits, computeTimeStats, computeTypoStats, daysToYMD, derivePersona, detectFormat, editDistance, epochToDate, epochToHour, epochToWeekday, hourLabel, isValidTheme, mask, mergeConfig, parseBash, parseConfig, parseFish, parseHistory, parsePlain, parseZshExtended, renderCard, splitSegments, suggestAliasName, toJSON, toMarkdown, toSegment, tokenizeEntry, tokens };