@lapis-notes/history 0.1.2 → 0.2.0

package/dist/repository/components/operation-view.js

@@ -0,0 +1,95 @@
+import { historySource, } from "../controllers/history-source.js";
+import { View } from "@lapis-notes/api";
+import { mount, unmount } from "svelte";
+import RepositoryOperations from "./RepositoryOperations.svelte";
+import { followBackup } from "../controllers/backup-follow.js";
+export class OperationView extends View {
+    plugin;
+    #controller;
+    #component;
+    #source = "backup";
+    #operation;
+    #unsubscribe;
+    #live;
+    constructor(leaf, plugin) {
+        super(leaf);
+        this.plugin = plugin;
+    }
+    getViewType() {
+        return "repository-oplog";
+    }
+    getDisplayText() {
+        return this.#source === "original"
+            ? "Original repository operations"
+            : "Repository operation log";
+    }
+    getIcon() {
+        return "git-pull-request-arrow";
+    }
+    getState() {
+        return {
+            source: this.#source,
+            operation: this.#controller
+                ? this.#controller.pinned
+                    ? this.#controller.state.operation
+                    : undefined
+                : this.#operation,
+        };
+    }
+    async setState(state) {
+        const source = historySource(state);
+        if (this.#controller && source !== this.#source)
+            throw new Error("Open a separate tab to change history source");
+        this.#source = source;
+        this.#operation =
+            typeof state.operation === "string" ? state.operation : undefined;
+        if (this.#controller &&
+            this.#operation &&
+            this.#operation !== this.#controller.state.operation)
+            await this.#controller.selectPin(this.#operation);
+        await super.setState(state);
+    }
+    async onOpen() { }
+    async onClose() { }
+    onload() {
+        this.#controller = this.plugin.createOperationController(this.#source);
+        this.#live = followBackup(this.#source === "backup" ? this.plugin.backup?.controller : undefined, this.#controller);
+        this.#unsubscribe = this.#controller.subscribe((state) => {
+            if (state.operation !== undefined &&
+                state.operation !== this.#operation) {
+                this.#operation = state.operation;
+                this.app.workspace.requestSaveLayout({
+                    source: "api",
+                    operation: "repository-oplog",
+                });
+            }
+        });
+        this.#component = mount(RepositoryOperations, {
+            target: this.containerEl,
+            props: {
+                controller: this.#controller,
+                sources: this.plugin.sourcePicker(this.#source, (source) => {
+                    void this.plugin
+                        .openOperations(source)
+                        .catch((error) => this.plugin.report(error));
+                }),
+                initialOperation: this.#operation,
+                copyText: (value) => this.plugin.copyIdentifier(value),
+                onHistory: (operation) => void this.plugin
+                    .open(operation, undefined, this.#source)
+                    .catch((error) => this.plugin.report(error)),
+            },
+        });
+    }
+    onunload() {
+        this.#live?.();
+        this.#unsubscribe?.();
+        if (this.#component)
+            void unmount(this.#component);
+        this.#component = undefined;
+        if (this.#controller)
+            void this.plugin
+                .release(this.#controller)
+                .catch((error) => this.plugin.report(error));
+    }
+}

package/dist/repository/components/repository-backup.d.ts

@@ -0,0 +1,22 @@
+import { BackupController } from "../controllers/backup.js";
+import type { RepositoryServices } from "../controllers/history-reader.js";
+import { RepositorySync } from "./repository-sync.js";
+import type { RepositoryPlugin } from "./repository-plugin.js";
+export declare const AUTOMATIC_BACKUP_SETTING = "repository-history.automaticBackup";
+export declare const automaticBackup: (value: Record<string, unknown>) => boolean;
+/** Capture lifetime is independent of whether its status control is visible. */
+export declare class RepositoryBackup {
+    #private;
+    readonly plugin: RepositoryPlugin;
+    readonly controller: BackupController;
+    readonly sync?: RepositorySync;
+    get enabled(): boolean;
+    constructor(plugin: RepositoryPlugin, services: RepositoryServices);
+    start(): Promise<void>;
+    setEnabled(enabled: boolean): Promise<void>;
+    /** Saved-state projection never changes native persisted selection. */
+    reconcile(enabled: boolean): Promise<void>;
+    prepareLeave(): Promise<void>;
+    resumeLeave(): Promise<void>;
+    close(): Promise<void>;
+}

package/dist/repository/components/repository-backup.js

@@ -0,0 +1,75 @@
+import { BackupController } from "../controllers/backup.js";
+import { RepositorySync } from "./repository-sync.js";
+import { BackgroundWork } from "../controllers/background-work.js";
+export const AUTOMATIC_BACKUP_SETTING = "repository-history.automaticBackup";
+export const automaticBackup = (value) => typeof value.automaticBackup === "boolean" ? value.automaticBackup : true;
+/** Capture lifetime is independent of whether its status control is visible. */
+export class RepositoryBackup {
+    plugin;
+    controller;
+    #progress;
+    sync;
+    #enabled = false;
+    get enabled() {
+        return this.#enabled;
+    }
+    constructor(plugin, services) {
+        this.plugin = plugin;
+        this.controller = new BackupController(services.backup, plugin.feedback("Vault backup"));
+        if (services.sync && services.remote)
+            this.sync = new RepositorySync(plugin, services);
+    }
+    async start() {
+        this.#progress = new BackgroundWork(this.plugin.app.notifications, this.plugin.id).follow("Saving vault history", {
+            subscribe: (listener) => this.controller.subscribe((state) => listener({
+                busy: state.phase === "saving",
+                phase: state.phase,
+            })),
+        });
+        const enabled = automaticBackup((await this.plugin.loadData()) ?? {});
+        this.#enabled = enabled;
+        // Admit the worker now; its first scan must not hold plugin/shell startup.
+        if (enabled)
+            void this.controller.start().catch((error) => this.plugin.report(error));
+        else
+            await this.controller.pause();
+        await this.sync?.start();
+    }
+    async setEnabled(enabled) {
+        const service = this.controller.service;
+        if (service.setEnabled) {
+            try {
+                await service.setEnabled(enabled);
+            }
+            finally {
+                // A lost acknowledgement may follow a committed native selection.
+                // Project the reconciled setting without replaying the mutation.
+                await this.reconcile(automaticBackup((await this.plugin.loadData()) ?? {}));
+            }
+            return;
+        }
+        await this.reconcile(enabled);
+    }
+    /** Saved-state projection never changes native persisted selection. */
+    async reconcile(enabled) {
+        this.#enabled = enabled;
+        if (enabled)
+            await this.controller.start();
+        else
+            await this.controller.pause();
+        await this.sync?.start();
+    }
+    async prepareLeave() {
+        await this.controller.pause();
+    }
+    async resumeLeave() {
+        if (this.#enabled)
+            await this.controller.resume();
+    }
+    async close() {
+        this.sync?.close();
+        await this.controller.close();
+        this.#progress?.();
+        this.#progress = undefined;
+    }
+}

package/dist/repository/components/repository-column-chrome.css

@@ -0,0 +1,35 @@
+/* Application-owned contrast treatment for the application-owned column chrome. */
+.repository-shell {
+  --repository-review-column-action-hover: color-mix(
+    in srgb,
+    var(--foreground) 24%,
+    var(--background)
+  );
+  --ui-column-canvas-header-action-hover: var(
+    --repository-review-column-action-hover
+  );
+  --ui-column-canvas-header-action-hover-foreground: var(--foreground);
+  --ui-column-canvas-rail-hover: var(--repository-review-column-action-hover);
+}
+.repository-shell
+  :is(
+    .repository-log-actions,
+    .operation-card-actions,
+    .repository-review-column-actions
+  ) {
+  --accent: var(--repository-review-column-action-hover);
+  --accent-foreground: var(--foreground);
+  --muted: var(--accent);
+  --ui-column-canvas-header-action-hover: var(--accent);
+  --ui-column-canvas-header-action-hover-foreground: var(--foreground);
+}
+.repository-shell
+  :is(
+    .repository-log-actions,
+    .operation-card-actions,
+    .repository-review-column-actions
+  )
+  > button:not(:disabled):is(:hover, :focus-visible) {
+  background: var(--repository-review-column-action-hover);
+  color: var(--foreground);
+}

package/dist/repository/components/repository-commit-picker.css

@@ -0,0 +1,55 @@
+.repository-commit-picker-control {
+  position: relative;
+  min-width: 0;
+  width: 100%;
+}
+.repository-commit-picker-trigger[data-ui-component="button"] {
+  position: absolute;
+  inset: 0;
+  width: 100%;
+  height: auto;
+  min-height: 3.25rem;
+  padding: 0.5rem;
+  justify-content: flex-end;
+  color: var(--foreground);
+  text-align: start;
+}
+.repository-commit-picker-trigger > svg {
+  width: 1rem;
+  height: 1rem;
+  flex: none;
+  color: var(--muted-foreground);
+}
+.repository-commit-picker-value {
+  position: relative;
+  padding: 0.5rem 2rem 0.5rem 0.5rem;
+  pointer-events: none;
+}
+.repository-commit-picker[data-ui-part="popover-content"] {
+  --ui-command-view-list-max-height: min(24rem, 54dvh);
+}
+.repository-commit-picker-header[data-ui-part="popover-header"] {
+  flex-direction: row;
+  align-items: center;
+  justify-content: space-between;
+  gap: 0.25rem;
+  min-height: 0;
+  padding: 0;
+  margin: 0;
+}
+.repository-commit-picker-option[data-ui-component="command-view"] {
+  grid-template-columns: auto minmax(0, 1fr);
+  gap: 0.5rem;
+  cursor: pointer;
+}
+.repository-commit-picker-selection {
+  display: inline-flex;
+  width: 1rem;
+  height: 1rem;
+  align-items: center;
+  justify-content: center;
+}
+.repository-commit-picker-selection > svg {
+  width: 0.9rem;
+  height: 0.9rem;
+}

package/dist/repository/components/repository-feedback.d.ts

@@ -0,0 +1,7 @@
+import type { App } from "@lapis-notes/api";
+export declare function repositoryFeedback(app: App, title: string, identity?: string): {
+    report: (error: unknown) => import("@lapis-notes/api").AppDatabaseNotificationRecord;
+    recovered: () => void;
+};
+export declare function copyRepositoryIdentifier(app: App, value: string): Promise<void>;
+export declare function reportRepositoryError(app: App, error: unknown): void;

package/dist/repository/components/repository-feedback.js

@@ -0,0 +1,40 @@
+import { getWorkspaceHostBinding } from "@lapis-notes/api/workspace-host";
+export function repositoryFeedback(app, title, identity) {
+    const id = identity ?? `repository-history:${crypto.randomUUID()}`;
+    return {
+        report: (error) => app.notifications.notify({
+            id,
+            title,
+            message: error instanceof Error ? error.message : String(error),
+            source: "repository-history",
+            severity: "error",
+            persist: false,
+        }),
+        recovered: () => {
+            getWorkspaceHostBinding(app.workspace).controller.notifications.dismiss(id);
+            void app.notifications
+                .clear(id)
+                .catch((error) => console.error("Repository notification cleanup failed", error));
+        },
+    };
+}
+export async function copyRepositoryIdentifier(app, value) {
+    const feedback = repositoryFeedback(app, "Copy identifier", `repository-copy:${value}`);
+    try {
+        await navigator.clipboard.writeText(value);
+        feedback.recovered();
+    }
+    catch (error) {
+        feedback.report(error);
+        throw error;
+    }
+}
+export function reportRepositoryError(app, error) {
+    app.notifications.notify({
+        title: "Repository history",
+        source: "repository-history",
+        severity: "error",
+        persist: false,
+        message: error instanceof Error ? error.message : String(error),
+    });
+}

package/dist/repository/components/repository-identifiers.css

@@ -0,0 +1,199 @@
+.repository-identifiers {
+  position: absolute;
+  z-index: 3;
+  top: calc(var(--community-revision-graph-row-height, 76px) / 2);
+  right: 0.5rem;
+  display: flex;
+  transform: translateY(-50%);
+  flex-direction: column;
+  align-items: flex-end;
+  gap: 0.2rem;
+}
+
+.repository-identifiers[data-placement="inline"] {
+  position: static;
+  z-index: auto;
+  transform: none;
+  flex-direction: row;
+  flex-wrap: wrap;
+  align-items: center;
+}
+
+.repository-identifiers__split {
+  display: grid;
+  --id-width: calc(
+    max(
+        var(--id-compact) * 2ch + 3.875rem,
+        var(--id-expanded) * 1ch * 10 / 11 + 3.875rem
+      ) + 2px
+  );
+  width: var(--id-width);
+  flex: none;
+  overflow: hidden;
+  border: 1px solid var(--border);
+  border-radius: 0.45rem;
+  color: var(--foreground);
+  background: color-mix(in srgb, currentcolor 4%, var(--background));
+  font-family: var(--font-mono, monospace);
+  font-size: 0.6875rem;
+  transition: grid-template-columns 160ms ease;
+}
+
+.repository-identifiers__split[data-single] {
+  width: calc(var(--id-expanded) * 1ch * 10 / 11 + 2.1875rem + 2px);
+  grid-template-columns: minmax(0, 1fr);
+}
+
+.repository-identifiers__split-button,
+.repository-identifiers__button {
+  display: inline-flex;
+  min-width: 0;
+  height: 1.45rem;
+  align-items: center;
+  gap: 0.25rem;
+  padding: 0 0.3125rem;
+  border: 0;
+  color: inherit;
+  background: transparent;
+  font: inherit;
+  font-weight: 500;
+  cursor: pointer;
+}
+
+.repository-identifiers__split-button {
+  gap: 0.125rem;
+  font-size: 0.5625rem;
+  transition: background-color 160ms ease;
+}
+
+.repository-identifiers__split-button[data-side="change"] {
+  color: var(--foreground);
+  background: color-mix(in srgb, var(--primary) 4%, var(--background));
+}
+
+.repository-identifiers__split-button + .repository-identifiers__split-button {
+  border-left: 1px solid var(--border);
+}
+
+.repository-identifiers__split-button .repository-id-chip {
+  flex: none;
+  font-family: var(--font-sans, sans-serif);
+}
+
+.repository-identifiers__button code {
+  white-space: nowrap;
+  font-family: var(--font-mono, monospace);
+  font-size: 0.75rem;
+  line-height: 1;
+}
+
+.repository-identifiers__split-button code {
+  white-space: nowrap;
+  font-family: var(--font-mono, monospace);
+  font-size: 0.6875rem;
+  line-height: 1;
+}
+
+.repository-identifiers__split-button .id-expanded {
+  display: none;
+  font-size: 0.625rem;
+}
+
+.repository-identifiers__split[data-single] .id-compact {
+  display: none;
+}
+.repository-identifiers__split[data-single] .id-expanded {
+  display: inline;
+}
+
+.repository-identifiers__split[data-active="commit"] {
+  --id-left: calc(var(--id-expanded) * 1ch * 10 / 11 + 2rem);
+}
+.repository-identifiers__split[data-active="change"] {
+  --id-left: calc(
+    var(--id-width) - 2px - (var(--id-expanded) * 1ch * 10 / 11 + 1.875rem)
+  );
+}
+.repository-identifiers__split:not([data-single]) {
+  grid-template-columns:
+    var(--id-left, calc(var(--id-compact) * 1ch + 2.125rem))
+    minmax(0, 1fr);
+}
+.repository-identifiers__split[data-active] .id-compact {
+  display: none;
+}
+.repository-identifiers__split-button[data-active] .id-expanded {
+  display: inline;
+}
+.repository-identifiers__split-button[data-active] {
+  background: color-mix(in srgb, currentcolor 9%, var(--background));
+}
+@media (hover: hover) {
+  .repository-identifiers__button:hover {
+    background: color-mix(in srgb, currentcolor 9%, var(--background));
+  }
+}
+
+.repository-identifiers__split-button:focus-visible,
+.repository-identifiers__button:focus-visible {
+  outline: 2px solid var(--ring);
+  outline-offset: -2px;
+  background: color-mix(in srgb, currentcolor 9%, var(--background));
+}
+.repository-identifiers__split-button:active {
+  box-shadow: inset 0 0 0 1px currentcolor;
+}
+.repository-identifiers__split-button[data-copied] {
+  color: var(--foreground);
+  background: var(--muted);
+}
+.repository-identifiers__split-button[data-copy-failed] {
+  color: var(--destructive);
+}
+
+.repository-identifiers__button {
+  height: 1.65rem;
+  border: 1px solid transparent;
+  border-radius: 0.4rem;
+  background: color-mix(in srgb, currentcolor 7%, transparent);
+}
+.repository-identifiers__button svg {
+  width: 0.75rem;
+  height: 0.75rem;
+  flex: none;
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .repository-identifiers__split,
+  .repository-identifiers__split-button {
+    transition: none;
+  }
+}
+
+.repository-identifiers__split-button .id-feedback {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.125rem;
+  white-space: nowrap;
+  font-size: 0.5rem;
+}
+.repository-identifiers__split-button .id-feedback svg {
+  width: 0.625rem;
+  height: 0.625rem;
+}
+
+.repository-id-chip {
+  padding: 0.05rem 0.2rem;
+  border-radius: 0.2rem;
+  color: var(--muted-foreground);
+  background: var(--muted);
+  font-size: 0.5rem;
+}
+.clipboard-status {
+  position: absolute;
+  width: 1px;
+  height: 1px;
+  overflow: hidden;
+  clip-path: inset(50%);
+  white-space: nowrap;
+}

package/dist/repository/components/repository-navigation.d.ts

@@ -0,0 +1,4 @@
+import type { getWorkspaceHostBinding } from "@lapis-notes/api/workspace-host";
+import { type HistorySource } from "../controllers/history-source.js";
+/** Each source owns its own tab and pins; switching never substitutes a reader. */
+export declare function openRepositoryView(workspace: ReturnType<typeof getWorkspaceHostBinding>["controller"]["workspace"], type: string, source: HistorySource, selection?: Record<string, unknown>): Promise<void>;

package/dist/repository/components/repository-navigation.js

@@ -0,0 +1,16 @@
+import { historySource, } from "../controllers/history-source.js";
+/** Each source owns its own tab and pins; switching never substitutes a reader. */
+export async function openRepositoryView(workspace, type, source, selection = {}) {
+    const existing = workspace
+        .getLeavesOfType(type)
+        .find((leaf) => historySource(leaf.viewState?.state ?? {}) === source);
+    const state = { ...selection, source };
+    if (existing) {
+        if (Object.keys(selection).length)
+            await existing.setViewState({ type, state });
+        workspace.revealLeaf(existing);
+    }
+    else if (!workspace.openLeaf(type, state, { active: true })) {
+        throw new Error("Repository history could not be opened");
+    }
+}

package/dist/repository/components/repository-operation-column.css

@@ -0,0 +1,112 @@
+.operation-diff-stack {
+  display: flex;
+  box-sizing: border-box;
+  min-height: 0;
+  width: 100%;
+  flex: 1 1 auto;
+  flex-direction: column;
+  gap: 0.75rem;
+}
+.operation-diff-stack[data-view-mode="split"] {
+  height: 100%;
+}
+.operation-diff-stack[data-view-mode="split"] .operation-file-card {
+  display: flex;
+  flex: 1 1 0;
+  flex-direction: column;
+  min-height: 0;
+}
+.operation-card,
+.operation-file-card {
+  box-sizing: border-box;
+  overflow: hidden;
+  width: 100%;
+  flex: 0 0 auto;
+  border: 1px solid var(--border);
+  border-radius: var(--ui-column-canvas-radius, var(--radius));
+  background: var(--background);
+}
+.operation-card-header {
+  display: flex;
+  min-width: 0;
+  align-items: center;
+  justify-content: space-between;
+  gap: 0.5rem;
+  min-height: var(--ui-column-canvas-header-height, 2.5rem);
+  padding-inline: 0.75rem;
+  padding-inline-start: 0.5rem;
+  border-bottom: 1px solid var(--border);
+  background: color-mix(
+    in srgb,
+    var(--background) 95%,
+    var(--color-black, #000)
+  );
+}
+.operation-toggle {
+  display: flex;
+  min-width: 0;
+  flex: 1 1 auto;
+  align-items: center;
+  gap: 0.5rem;
+  border: 0;
+  color: inherit;
+  background: transparent;
+  font: inherit;
+  font-size: 0.875rem;
+  font-weight: 600;
+  text-align: left;
+  cursor: pointer;
+}
+.operation-toggle svg {
+  width: 1rem;
+  height: 1rem;
+  flex: 0 0 auto;
+  color: var(--muted-foreground);
+  transition: transform 120ms ease;
+}
+.operation-toggle[aria-expanded="false"] svg {
+  transform: rotate(-90deg);
+}
+.operation-toggle span,
+.operation-file-path {
+  min-width: 0;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+.operation-file-path {
+  font-weight: 600;
+}
+.operation-card-actions {
+  display: inline-flex;
+  flex: 0 0 auto;
+  align-items: center;
+  gap: 0.35rem;
+}
+.operation-diff-empty {
+  min-height: 12rem;
+  padding: 1.5rem;
+  color: var(--muted-foreground);
+}
+.operation-parent-comparison {
+  display: grid;
+  gap: 0.5rem;
+  padding: 0 1rem 0.85rem;
+  color: var(--muted-foreground);
+}
+.operation-parent-hint {
+  margin: 0;
+  padding: 0 1rem 0.85rem;
+  color: var(--muted-foreground);
+}
+.operation-diff-loading {
+  display: grid;
+  gap: 0.75rem;
+  padding: 1.5rem;
+  min-height: 12rem;
+}
+@media (prefers-reduced-motion: reduce) {
+  .operation-toggle svg {
+    transition: none;
+  }
+}

package/dist/repository/components/repository-picker-options.css

@@ -0,0 +1,11 @@
+/* Catalog-owned item layout replaces inherited named command grid areas. */
+.repository-commit-picker
+  .repository-review-picker-options
+  .repository-commit-picker-option {
+  grid-template: auto / 1rem minmax(0, 1fr);
+  width: 100%;
+  min-width: 0;
+  max-width: 100%;
+  box-sizing: border-box;
+  gap: 0.5rem;
+}