@lapis-notes/history 0.1.1 → 0.1.4

package/CHANGELOG.md

@@ -1,6 +1,19 @@
 # History changelog
 
-## 0.1.1
+## 0.1.4
+
+### Patch Changes
+
+- [#6](https://github.com/lapismd/lapis-plugins/pull/6) [`03b483c`](https://github.com/lapismd/lapis-plugins/commit/03b483c89f4e3d9b8ce9af2919903ad42e9b66ad) Thanks [@stevejuma](https://github.com/stevejuma)! - Center comparison actions between revision timestamps and diff statistics on one
+  row, wrapping the actions below on narrow workspace panes.
+
+## 0.1.3
+
+### Patch Changes
+
+- Add official author avatars and deterministic split, light, and dark registry media for plugin banners, overviews, and galleries.
+
+## 0.1.2
 
 - Initial independent public package extracted from Lapis Notes without changing
   the runtime plugin ID.

package/LICENSE.md

@@ -1,8 +1,4 @@
-# License
+Apache-2.0
 
-Copyright (c) LapisMD contributors.
-
-This software is licensed under the GNU Affero General Public License, version
-3 or (at your option) any later version (`AGPL-3.0-or-later`). The complete
-license text is available from the
-[GNU Project](https://www.gnu.org/licenses/agpl-3.0.html).
+This project is licensed under the Apache License 2.0.
+See <https://www.apache.org/licenses/LICENSE-2.0>.

package/README.md

@@ -1,6 +1,6 @@
 # History
 
-File history
+Browse, compare, and restore saved file revisions
 
 ## Install for static composition
 
@@ -13,7 +13,7 @@ Register the exported plugin class in the application's `PluginProfile`. Import
 registration so the host owns its lifecycle.
 
 The runtime plugin ID is `history`. A matching signed
-`history-0.1.1.lapis-plugin` archive is attached to the
+`history-0.1.4.lapis-plugin` archive is attached to the
 package-scoped GitHub release for manual or registry installation.
 
 See the [repository README](https://github.com/lapismd/lapis-plugins#readme) for

package/dist/history-compare-panel.css

@@ -15,6 +15,7 @@
     "Liberation Mono",
     monospace
   );
+  container: history-compare / inline-size;
   display: flex;
   box-sizing: border-box;
   width: 100%;
@@ -33,19 +34,23 @@
   flex-direction: column;
   align-items: stretch;
   gap: 0;
-  padding: 0.25rem 0.25rem 0;
+  padding: 0.25rem;
   border-bottom: 1px solid
-    var(--ui-workspace-border, color-mix(in srgb, currentColor 14%, transparent));
+    var(
+      --ui-workspace-border,
+      color-mix(in srgb, currentColor 14%, transparent)
+    );
   background: var(--ui-workspace-view-background, transparent);
 }
 
 .history-compare__revision {
-  display: flex;
+  display: grid;
+  grid-template-columns: minmax(0, 1fr) auto minmax(0, 1fr);
   min-width: 0;
   align-items: center;
   justify-content: space-between;
   gap: 0.5rem;
-  padding: 0.35rem 0.5rem 0.15rem;
+  padding: 0.15rem 0.5rem;
   color: var(--ui-workspace-muted-foreground, var(--muted-foreground));
   font-size: 0.75rem;
 }
@@ -58,7 +63,7 @@
 }
 
 .history-compare__revision [data-ui-component="file-change-stats"] {
-  flex: 0 0 auto;
+  justify-self: end;
 }
 
 .history-compare__toolbar {
@@ -66,7 +71,7 @@
   align-items: center;
   justify-content: center;
   gap: 0.125rem;
-  padding: 0.15rem 0 0.25rem;
+  padding: 0;
 }
 
 .history-compare__toolbar
@@ -124,3 +129,20 @@
   padding: 0.75rem;
   color: var(--ui-workspace-muted-foreground, var(--muted-foreground));
 }
+
+@container history-compare (max-width: 40rem) {
+  .history-compare__revision {
+    grid-template-columns: minmax(0, 1fr) auto;
+  }
+
+  .history-compare__toolbar {
+    grid-column: 1 / -1;
+    grid-row: 2;
+    flex-wrap: wrap;
+  }
+
+  .history-compare__revision [data-ui-component="file-change-stats"] {
+    grid-column: 2;
+    grid-row: 1;
+  }
+}

package/dist/history-compare-panel.svelte

@@ -148,56 +148,31 @@
   aria-label="File history comparison"
 >
   <div class="history-compare__chrome" data-ui-part="chrome">
-    {#if model}
-      <div class="history-compare__revision">
-        <span>{model.beforeLabel} → {model.afterLabel}</span>
-        <FileChangeStats
-          additions={stats.additions}
-          deletions={stats.deletions}
-          showZero
-        />
-      </div>
-    {/if}
-    <Tooltip.Provider delayDuration={0}>
-      <div class="history-compare__toolbar" data-ui-part="toolbar">
-        <Tooltip.Root>
-          <Tooltip.Trigger>
-            {#snippet child({ props })}
-              <Button
-                {...props}
-                variant="ghost"
-                size="icon-sm"
-                class="history-compare__toolbar-action"
-                aria-label="Compare with current"
-                aria-pressed={model?.compareMode === "current"}
-                onclick={() => openMode("current")}
-              >
-                <GitCompare aria-hidden="true" />
-              </Button>
-            {/snippet}
-          </Tooltip.Trigger>
-          <Tooltip.Content side="bottom">Compare with current</Tooltip.Content>
-        </Tooltip.Root>
-        <Tooltip.Root>
-          <Tooltip.Trigger>
-            {#snippet child({ props })}
-              <Button
-                {...props}
-                variant="ghost"
-                size="icon-sm"
-                class="history-compare__toolbar-action"
-                aria-label="Compare with previous"
-                aria-pressed={model?.compareMode === "previous"}
-                disabled={!model?.previousRevision}
-                onclick={() => openMode("previous")}
-              >
-                <GitCompareArrows aria-hidden="true" />
-              </Button>
-            {/snippet}
-          </Tooltip.Trigger>
-          <Tooltip.Content side="bottom">Compare with previous</Tooltip.Content>
-        </Tooltip.Root>
-        {#if model?.compareMode !== "current"}
+    <div class="history-compare__revision">
+      <span
+        >{#if model}{model.beforeLabel} → {model.afterLabel}{/if}</span
+      >
+      <Tooltip.Provider delayDuration={0}>
+        <div class="history-compare__toolbar" data-ui-part="toolbar">
+          <Tooltip.Root>
+            <Tooltip.Trigger>
+              {#snippet child({ props })}
+                <Button
+                  {...props}
+                  variant="ghost"
+                  size="icon-sm"
+                  class="history-compare__toolbar-action"
+                  aria-label="Compare with current"
+                  aria-pressed={model?.compareMode === "current"}
+                  onclick={() => openMode("current")}
+                >
+                  <GitCompare aria-hidden="true" />
+                </Button>
+              {/snippet}
+            </Tooltip.Trigger>
+            <Tooltip.Content side="bottom">Compare with current</Tooltip.Content
+            >
+          </Tooltip.Root>
           <Tooltip.Root>
             <Tooltip.Trigger>
               {#snippet child({ props })}
@@ -206,43 +181,45 @@
                   variant="ghost"
                   size="icon-sm"
                   class="history-compare__toolbar-action"
-                  data-testid="history-compare-view-mode"
-                  data-view-mode={viewMode}
-                  aria-label={viewModeLabel}
-                  onclick={() =>
-                    (viewMode = viewMode === "split" ? "unified" : "split")}
+                  aria-label="Compare with previous"
+                  aria-pressed={model?.compareMode === "previous"}
+                  disabled={!model?.previousRevision}
+                  onclick={() => openMode("previous")}
                 >
-                  {#if viewMode === "split"}
-                    <Columns2 aria-hidden="true" />
-                  {:else}
-                    <Rows2 aria-hidden="true" />
-                  {/if}
+                  <GitCompareArrows aria-hidden="true" />
                 </Button>
               {/snippet}
             </Tooltip.Trigger>
-            <Tooltip.Content side="bottom">{viewModeLabel}</Tooltip.Content>
+            <Tooltip.Content side="bottom"
+              >Compare with previous</Tooltip.Content
+            >
           </Tooltip.Root>
-        {/if}
-        <Tooltip.Root>
-          <Tooltip.Trigger>
-            {#snippet child({ props })}
-              <Button
-                {...props}
-                variant="ghost"
-                size="icon-sm"
-                class="history-compare__toolbar-action"
-                data-testid="history-compare-wrap"
-                aria-label="Wrap text"
-                aria-pressed={wrap ? "true" : "false"}
-                onclick={() => (wrap = !wrap)}
-              >
-                <WrapText aria-hidden="true" />
-              </Button>
-            {/snippet}
-          </Tooltip.Trigger>
-          <Tooltip.Content side="bottom">Wrap text</Tooltip.Content>
-        </Tooltip.Root>
-        {#if model?.compareMode === "current"}
+          {#if model?.compareMode !== "current"}
+            <Tooltip.Root>
+              <Tooltip.Trigger>
+                {#snippet child({ props })}
+                  <Button
+                    {...props}
+                    variant="ghost"
+                    size="icon-sm"
+                    class="history-compare__toolbar-action"
+                    data-testid="history-compare-view-mode"
+                    data-view-mode={viewMode}
+                    aria-label={viewModeLabel}
+                    onclick={() =>
+                      (viewMode = viewMode === "split" ? "unified" : "split")}
+                  >
+                    {#if viewMode === "split"}
+                      <Columns2 aria-hidden="true" />
+                    {:else}
+                      <Rows2 aria-hidden="true" />
+                    {/if}
+                  </Button>
+                {/snippet}
+              </Tooltip.Trigger>
+              <Tooltip.Content side="bottom">{viewModeLabel}</Tooltip.Content>
+            </Tooltip.Root>
+          {/if}
           <Tooltip.Root>
             <Tooltip.Trigger>
               {#snippet child({ props })}
@@ -251,36 +228,66 @@
                   variant="ghost"
                   size="icon-sm"
                   class="history-compare__toolbar-action"
-                  aria-label="Apply"
-                  disabled={pendingContent == null}
-                  onclick={() => void applyMerged()}
+                  data-testid="history-compare-wrap"
+                  aria-label="Wrap text"
+                  aria-pressed={wrap ? "true" : "false"}
+                  onclick={() => (wrap = !wrap)}
                 >
-                  <Check aria-hidden="true" />
+                  <WrapText aria-hidden="true" />
                 </Button>
               {/snippet}
             </Tooltip.Trigger>
-            <Tooltip.Content side="bottom">Apply</Tooltip.Content>
+            <Tooltip.Content side="bottom">Wrap text</Tooltip.Content>
           </Tooltip.Root>
-        {/if}
-        <Tooltip.Root>
-          <Tooltip.Trigger>
-            {#snippet child({ props })}
-              <Button
-                {...props}
-                variant="ghost"
-                size="icon-sm"
-                class="history-compare__toolbar-action"
-                aria-label="Restore this revision"
-                onclick={() => void restoreSelected()}
-              >
-                <ArchiveRestore aria-hidden="true" />
-              </Button>
-            {/snippet}
-          </Tooltip.Trigger>
-          <Tooltip.Content side="bottom">Restore this revision</Tooltip.Content>
-        </Tooltip.Root>
-      </div>
-    </Tooltip.Provider>
+          {#if model?.compareMode === "current"}
+            <Tooltip.Root>
+              <Tooltip.Trigger>
+                {#snippet child({ props })}
+                  <Button
+                    {...props}
+                    variant="ghost"
+                    size="icon-sm"
+                    class="history-compare__toolbar-action"
+                    aria-label="Apply"
+                    disabled={pendingContent == null}
+                    onclick={() => void applyMerged()}
+                  >
+                    <Check aria-hidden="true" />
+                  </Button>
+                {/snippet}
+              </Tooltip.Trigger>
+              <Tooltip.Content side="bottom">Apply</Tooltip.Content>
+            </Tooltip.Root>
+          {/if}
+          <Tooltip.Root>
+            <Tooltip.Trigger>
+              {#snippet child({ props })}
+                <Button
+                  {...props}
+                  variant="ghost"
+                  size="icon-sm"
+                  class="history-compare__toolbar-action"
+                  aria-label="Restore this revision"
+                  onclick={() => void restoreSelected()}
+                >
+                  <ArchiveRestore aria-hidden="true" />
+                </Button>
+              {/snippet}
+            </Tooltip.Trigger>
+            <Tooltip.Content side="bottom"
+              >Restore this revision</Tooltip.Content
+            >
+          </Tooltip.Root>
+        </div>
+      </Tooltip.Provider>
+      {#if model}
+        <FileChangeStats
+          additions={stats.additions}
+          deletions={stats.deletions}
+          showZero
+        />
+      {/if}
+    </div>
   </div>
   <div class="history-compare__body">
     {#if error}
@@ -299,7 +306,7 @@
         path={model.filePath}
         syncHorizontalScroll
         {wrap}
-        onResolvedChange={onResolvedChange}
+        {onResolvedChange}
       />
     {:else}
       <FileDiff

package/manifest.json

@@ -1,10 +1,12 @@
 {
   "id": "history",
   "name": "History",
-  "version": "0.1.1",
+  "version": "0.1.4",
   "minAppVersion": "0.1.0",
-  "description": "File history",
+  "description": "Browse, compare, and restore saved file revisions",
   "author": "Lapis Notes",
+  "authorAvatarUrl": "https://www.gravatar.com/avatar/1df68d9ff087b0dd72fd8626056fca7f?s=128&d=404",
+  "isDesktopOnly": false,
   "lapis": {
     "manifestVersion": 1,
     "source": "official",
@@ -17,7 +19,14 @@
           "format": "esm",
           "sharedDependencies": [
             "@lapis-notes/api",
-            "@lapis-notes/api/workspace-host"
+            "@lapis-notes/api/workspace-host",
+            "svelte/renderer/5.56.10",
+            "svelte/renderer/5.56.10/attachments",
+            "svelte/renderer/5.56.10/events",
+            "svelte/renderer/5.56.10/internal/client",
+            "svelte/renderer/5.56.10/internal/disclose-version",
+            "svelte/renderer/5.56.10/reactivity",
+            "svelte/renderer/5.56.10/store"
           ],
           "requiresReloadOnUpdate": false
         }

package/package.json

@@ -1,12 +1,14 @@
 {
   "name": "@lapis-notes/history",
-  "version": "0.1.1",
+  "version": "0.1.4",
   "description": "Lapis Notes file history plugin",
-  "license": "AGPL-3.0-or-later",
+  "license": "Apache-2.0",
   "type": "module",
   "files": [
     "dist",
     "manifest.json",
+    "registry.json",
+    "registry-content",
     "styles.css",
     "README.md",
     "CHANGELOG.md",
@@ -27,14 +29,15 @@
       "default": "./dist/index.js"
     },
     "./manifest.json": "./manifest.json",
-    "./styles.css": "./styles.css"
+    "./styles.css": "./styles.css",
+    "./registry.json": "./registry.json"
   },
   "dependencies": {
-    "@lapis-notes/api": "^0.1.0",
-    "@lapismd/design-core": "^0.1.0",
+    "@lapismd/design-core": "^0.3.2",
     "@lucide/svelte": "^0.523.0"
   },
   "peerDependencies": {
+    "@lapis-notes/api": "^0.1.2",
     "svelte": "^5.0.0"
   },
   "devDependencies": {

package/registry-content/overview.md

@@ -0,0 +1,10 @@
+# History
+
+History keeps a bounded, local timeline of meaningful file revisions as notes
+change. Select the active note to browse timestamped snapshots in the sidebar,
+then open any revision in a clear comparison against the document you have now.
+
+When an earlier version contains something worth recovering, restore it through
+the normal vault write path so every other Lapis view observes the update. The
+retention limit and ignored paths remain configurable per vault, and revision
+content never needs to leave the workspace.

package/registry.json

@@ -0,0 +1,141 @@
+{
+  "$schema": "https://registry.lapis.md/schemas/plugin-source.schema.json",
+  "schemaVersion": 2,
+  "categories": ["history", "versioning"],
+  "highlights": [
+    "Capture bounded local revisions as vault files change.",
+    "Compare saved revisions with the current document.",
+    "Restore selected content through the normal vault write path."
+  ],
+  "documentationUrl": "https://github.com/lapismd/lapis-plugins/tree/main/packages/history#readme",
+  "appearance": {
+    "icon": "history",
+    "accent": "#6366F1"
+  },
+  "media": {
+    "banner": {
+      "alt": "Lapis History with Explorer on the left, a revision comparison in the main workspace, and History on the right.",
+      "images": {
+        "preview": {
+          "path": "registry-assets/banner.preview.webp"
+        },
+        "full": {
+          "path": "registry-assets/banner.full.webp"
+        },
+        "light": {
+          "path": "registry-assets/banner.light.webp"
+        },
+        "dark": {
+          "path": "registry-assets/banner.dark.webp"
+        }
+      },
+      "capture": {
+        "storyId": "plugins-history-registry-screenshots--overview",
+        "focus": "full-shell"
+      }
+    },
+    "overview": {
+      "alt": "Lapis History Compare view showing changes between two revisions in the full workspace.",
+      "images": {
+        "preview": {
+          "path": "registry-assets/overview.preview.webp"
+        },
+        "full": {
+          "path": "registry-assets/overview.full.webp"
+        },
+        "light": {
+          "path": "registry-assets/overview.light.webp"
+        },
+        "dark": {
+          "path": "registry-assets/overview.dark.webp"
+        }
+      },
+      "capture": {
+        "storyId": "plugins-history-registry-screenshots--compare",
+        "focus": "full-shell"
+      }
+    }
+  },
+  "gallery": [
+    {
+      "id": "history-sidebar",
+      "alt": "History sidebar showing saved local revisions for the active Welcome note.",
+      "images": {
+        "preview": {
+          "path": "registry-assets/gallery/history-sidebar.preview.webp"
+        },
+        "full": {
+          "path": "registry-assets/gallery/history-sidebar.full.webp"
+        },
+        "light": {
+          "path": "registry-assets/gallery/history-sidebar.light.webp"
+        },
+        "dark": {
+          "path": "registry-assets/gallery/history-sidebar.dark.webp"
+        }
+      },
+      "capture": {
+        "storyId": "plugins-history-registry-screenshots--history-sidebar",
+        "focus": "right-sidebar"
+      },
+      "card": {
+        "headline": [
+          {
+            "text": "A local timeline",
+            "tone": "neutral"
+          },
+          {
+            "text": "for every edit",
+            "tone": "amber"
+          }
+        ],
+        "description": [
+          {
+            "text": "Browse timestamped local snapshots of the active note, with bounded retention and no remote history service.",
+            "tone": "neutral"
+          }
+        ]
+      }
+    },
+    {
+      "id": "compare",
+      "alt": "History compare view showing a saved revision beside the current Markdown document.",
+      "images": {
+        "preview": {
+          "path": "registry-assets/gallery/compare.preview.webp"
+        },
+        "full": {
+          "path": "registry-assets/gallery/compare.full.webp"
+        },
+        "light": {
+          "path": "registry-assets/gallery/compare.light.webp"
+        },
+        "dark": {
+          "path": "registry-assets/gallery/compare.dark.webp"
+        }
+      },
+      "capture": {
+        "storyId": "plugins-history-registry-screenshots--compare",
+        "focus": "full-shell"
+      },
+      "card": {
+        "headline": [
+          {
+            "text": "Compare changes",
+            "tone": "neutral"
+          },
+          {
+            "text": "before restoring",
+            "tone": "green"
+          }
+        ],
+        "description": [
+          {
+            "text": "Review a saved revision against the live document, then restore through the vault.",
+            "tone": "neutral"
+          }
+        ]
+      }
+    }
+  ]
+}