@devframes/plugin-git 0.9.8 → 0.9.10

package/README.md

@@ -4,13 +4,13 @@
 > This devframe is experimental and may change without a major version bump until
 > it stabilizes.
 
-A git devframe built on [devframe](https://github.com/devframes/devframe) — a
+A git devframe built on [devframe](https://github.com/devframes/devframe): a
 repository dashboard with a **Next.js App Router + shadcn/ui** SPA over
 type-safe RPC. The node side shells out to `git` and exposes the repository;
 the same bundle runs as a live dev server or a fully static deployment.
 
 Status, a SourceTree-style **commit graph**, branches, and diffs, plus staging,
-unstaging, and committing — all through the shared
+unstaging, and committing, all through the shared
 [`@devframes/service-git`](../../services/git) wire service. The UI follows the
 system **light/dark** preference with a manual toggle.
 
@@ -59,21 +59,21 @@ repository; the definition opts them into the static build via `rpc.snapshot`
 (resolved live over WebSocket in dev, served from a build-time snapshot for
 static deploys).
 
-- `devframes:service:git:status` — branch, upstream tracking (ahead/behind), staged / unstaged /
+- `devframes:service:git:status`: branch, upstream tracking (ahead/behind), staged / unstaged /
   untracked files, parsed from `git status --porcelain=v2`.
-- `devframes:service:git:log` — paginated commit history (`limit` / `skip`) including parent
+- `devframes:service:git:log`: paginated commit history (`limit` / `skip`) including parent
   hashes, which drive the commit graph.
-- `devframes:service:git:branches` — local branches with SHA, upstream, ahead/behind, tip subject.
-- `devframes:service:git:diff` — per-file added/deleted counts for the working tree or index, plus
+- `devframes:service:git:branches`: local branches with SHA, upstream, ahead/behind, tip subject.
+- `devframes:service:git:diff`: per-file added/deleted counts for the working tree or index, plus
   a unified patch for a selected file.
 
-Write actions are `action` functions — always exposed by the service, with
+Write actions are `action` functions, always exposed by the service, with
 write authorization governed by the connection-trust boundary. Each
 returns fresh status (commit returns a result):
 
-- `devframes:service:git:stage` — `git add` the given paths.
-- `devframes:service:git:unstage` — `git restore --staged` the given paths.
-- `devframes:service:git:commit` — commit the staged changes with a message.
+- `devframes:service:git:stage`: `git add` the given paths.
+- `devframes:service:git:unstage`: `git restore --staged` the given paths.
+- `devframes:service:git:commit`: commit the staged changes with a message.
 
 ## Develop
 
@@ -83,14 +83,14 @@ pnpm -C plugins/git build   # tsdown (node) + next build (SPA) → dist/
 ```
 
 `pnpm dev` starts the Next.js dev server (with hot-reload) and the devframe
-RPC/WebSocket backend at the same time, then prints both URLs — open the UI one.
+RPC/WebSocket backend at the same time, then prints both URLs; open the UI one.
 The SPA connects to the backend over the WebSocket port carried in
 `NEXT_PUBLIC_DEVFRAME_WS`. Override ports with `PORT` (UI) and
 `DEVFRAME_GIT_PORT` (backend). Run a single side with `dev:client` or
 `dev:server`.
 
 The SPA is a standard shadcn/ui setup (Tailwind v4, `components/ui/*`). Three
-Next.js settings in `src/client/next.config.mjs` keep it portable: `output:
+Next.js settings in `app/next.config.mjs` keep it portable: `output:
 'export'` (devframe owns the server), `assetPrefix: '.'` (relative assets so the
 same bundle works at any base), and `trailingSlash: true` (composes with
 devframe's static directory-with-index resolution).

package/bin.mjs

@@ -1,3 +1,3 @@
 #!/usr/bin/env node
-// Thin launcher for the published package — runs the compiled CLI entry.
-import './dist/cli.mjs'
+// Thin launcher for the published package; runs the compiled CLI entry.
+import './dist/node/cli.mjs'

package/dist/{cli.mjs → node/cli.mjs}

@@ -1,7 +1,7 @@
-import { t as createGitDevframe } from "./src-Dt5wS6qp.mjs";
+import { t as createGitDevframe } from "../node-CSvNBV8w.mjs";
 import process from "node:process";
 import { createCac } from "devframe/adapters/cac";
-//#region src/cli.ts
+//#region src/node/cli.ts
 createCac(createGitDevframe(), { onReady({ origin }) {
 	console.error(`\n  @devframes/plugin-git ready at ${origin}\n`);
 } }).parse().catch((error) => {

package/dist/{index.d.mts → node/index.d.mts}

@@ -1,5 +1,5 @@
 import { DevframeDefinition } from "devframe";
-//#region src/index.d.ts
+//#region src/node/index.d.ts
 interface GitDevframeOptions {
   /** Repository directory to inspect. Defaults to the devframe `cwd`. */
   repoRoot?: string;
@@ -14,7 +14,7 @@ interface GitDevframeOptions {
   port?: number;
   /**
    * Require the trust handshake on the standalone server. Enabled by
-   * default — `--open` embeds the current OTP in the opened URL, so the
+   * default; `--open` embeds the current OTP in the opened URL, so the
    * tab authenticates automatically without extra prompts. Hosted adapters
    * manage their own auth and ignore this.
    */

package/dist/node/index.mjs

@@ -0,0 +1,2 @@
+import { t as createGitDevframe } from "../node-CSvNBV8w.mjs";
+export { createGitDevframe, createGitDevframe as default };

package/dist/{src-Dt5wS6qp.mjs → node-CSvNBV8w.mjs}

@@ -3,11 +3,11 @@ import { defineDevframe } from "devframe";
 import { resolve } from "pathe";
 //#region package.json
 var name = "@devframes/plugin-git";
-var version = "0.9.8";
+var version = "0.9.10";
 var description = "Devframe plugin that shows a Git dashboard for status, log, branches, and diffs.";
 var homepage = "https://github.com/devframes/devframe#readme";
 //#endregion
-//#region src/index.ts
+//#region src/node/index.ts
 const remoteAssets = {
 	package: `${name}--assets`,
 	version
@@ -40,12 +40,30 @@ function createGitDevframe(options = {}) {
 			command: "devframe-git",
 			port: options.port ?? 9710,
 			distDir,
+			/**
+			* Gate the standalone server by default; `maybeOpenBrowser` folds the
+			* current OTP into the `--open` URL so the tab lands already trusted.
+			*/
 			auth: options.auth ?? true
 		},
+		/**
+		* Declared, not imperatively installed: devframe constructs each (merging
+		* options across every declarer) before setup. `service-git` backs every
+		* panel; the SPA calls it directly. `service-shiki` highlights diff patches
+		* via its `codeToTokens`; when a host doesn't advertise it, the client
+		* falls back to a plain, un-highlighted diff.
+		*/
 		services: [{
 			package: GIT_SERVICE,
 			...cwd ? { options: { cwd } } : {}
 		}, { package: "@devframes/service-shiki" }],
+		/**
+		* Bake repo state into the static build. The service defines no dump of
+		* its own, so the read ops are opted in here: status/branches/diff bake
+		* their no-arg call; log bakes the 200-commit head; show bakes one
+		* (patch-less) record per commit, enumerated at build time via the
+		* service's node API.
+		*/
 		rpc: { snapshot: [
 			"devframes:service:git:status",
 			"devframes:service:git:branches",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@devframes/plugin-git",
   "type": "module",
-  "version": "0.9.8",
+  "version": "0.9.10",
   "description": "Devframe plugin that shows a Git dashboard for status, log, branches, and diffs.",
   "author": "Anthony Fu <anthonyfu117@hotmail.com>",
   "license": "MIT",
@@ -21,10 +21,10 @@
   ],
   "sideEffects": false,
   "exports": {
-    ".": "./dist/index.mjs",
+    ".": "./dist/node/index.mjs",
     "./package.json": "./package.json"
   },
-  "types": "./dist/index.d.mts",
+  "types": "./dist/node/index.d.mts",
   "bin": {
     "devframe-git": "./bin.mjs"
   },
@@ -33,7 +33,7 @@
     "dist"
   ],
   "peerDependencies": {
-    "@devframes/plugin-git--assets": "0.9.8"
+    "@devframes/plugin-git--assets": "0.9.10"
   },
   "peerDependenciesMeta": {
     "@devframes/plugin-git--assets": {
@@ -41,15 +41,15 @@
     }
   },
   "dependencies": {
-    "@devframes/service-git": "0.9.8",
-    "@devframes/service-shiki": "0.9.8",
+    "@devframes/service-git": "0.9.10",
+    "@devframes/service-shiki": "0.9.10",
     "cac": "^7.0.0",
-    "devframe": "0.9.8",
+    "devframe": "0.9.10",
     "pathe": "^2.0.3"
   },
   "devDependencies": {
     "@antfu/design": "^0.4.0",
-    "@devframes/plugin-git--assets": "0.9.8",
+    "@devframes/plugin-git--assets": "0.9.10",
     "@floating-ui/react": "^0.27.20",
     "@iconify-json/catppuccin": "^1.2.17",
     "@radix-ui/react-scroll-area": "^1.2.18",
@@ -78,11 +78,12 @@
   },
   "scripts": {
     "build": "tsdown && pnpm run build:spa",
-    "build:spa": "next build src/client && node scripts/build-spa.mjs",
+    "build:spa": "next build app && node scripts/build-spa.mjs",
     "cli:build": "node bin.mjs build --out-dir dist/static",
     "dev": "node scripts/dev.mjs",
-    "dev:server": "node src/cli.ts",
-    "dev:client": "next dev src/client",
+    "dev:server": "node src/node/cli.ts",
+    "dev:client": "next dev app",
+    "play": "pnpm run build && node playgrounds/server.mjs",
     "storybook": "storybook dev -p 6011",
     "storybook:build": "storybook build -o storybook-static",
     "watch": "tsdown --watch",

package/dist/index.mjs

@@ -1,2 +0,0 @@
-import { t as createGitDevframe } from "./src-Dt5wS6qp.mjs";
-export { createGitDevframe, createGitDevframe as default };