@bendyline/docblocks-react 1.1.2 → 2.0.0

package/dist/Git/useGit.js

@@ -0,0 +1,206 @@
+/**
+ * useGit — the single hook DocBlocksShell calls to power all git UI.
+ *
+ * Tier 1 (`available`): running under the Electron host with a working git —
+ * gates only the clone entry. Tier 2 (`repo`): the active workspace is an
+ * electron-native folder that is a git repository — gates everything else.
+ * On the site / VS Code webview / store builds every surface null-renders.
+ *
+ * Actions never throw: typed GitErrors are routed to the auth-guidance or
+ * conflicts dialogs when actionable, otherwise to the aria-live result line.
+ */
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { maybeGetDocBlocksHost } from '@bendyline/docblocks/host';
+import { buildBadgeMap, conflictedPaths } from './git-status.js';
+import { useGitStatus } from './useGitStatus.js';
+/** Capabilities can't change within a session — probe once per page load. */
+let capabilitiesPromise = null;
+function capabilitiesOnce(gitApi) {
+    capabilitiesPromise ?? (capabilitiesPromise = gitApi.capabilities());
+    return capabilitiesPromise;
+}
+function describeError(error) {
+    return error.message || 'Git operation failed';
+}
+export function useGit(provider, requestedWorkspaceId, theme) {
+    const host = maybeGetDocBlocksHost();
+    const gitApi = host?.git ?? null;
+    const workspaceId = gitApi ? requestedWorkspaceId : null;
+    const [capabilities, setCapabilities] = useState(null);
+    useEffect(() => {
+        if (!gitApi)
+            return;
+        let cancelled = false;
+        void capabilitiesOnce(gitApi).then((caps) => {
+            if (!cancelled)
+                setCapabilities(caps);
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, [gitApi]);
+    const available = gitApi !== null && capabilities?.gitAvailable === true;
+    const [repo, setRepo] = useState(null);
+    const [remoteWeb, setRemoteWeb] = useState(null);
+    useEffect(() => {
+        setRepo(null);
+        setRemoteWeb(null);
+        if (!gitApi || !workspaceId || !available)
+            return;
+        let cancelled = false;
+        void gitApi.detectRepo(workspaceId).then((result) => {
+            if (cancelled || !result.ok || !result.value.isRepo || !result.value.repositoryId) {
+                return;
+            }
+            setRepo(result.value);
+            void gitApi.listRemotes(result.value.repositoryId).then((remotes) => {
+                if (cancelled || !remotes.ok)
+                    return;
+                const first = remotes.value[0];
+                setRemoteWeb(first?.web ?? null);
+            });
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, [gitApi, workspaceId, available]);
+    const repositoryId = repo?.repositoryId ?? null;
+    const isRepo = repositoryId !== null;
+    const { status, refresh, scheduleRefresh } = useGitStatus(gitApi, repositoryId, isRepo);
+    const badges = useMemo(() => buildBadgeMap(status?.changes ?? []), [status]);
+    const [busy, setBusy] = useState(null);
+    const [lastResult, setLastResult] = useState(null);
+    const [dialog, setDialog] = useState({ kind: 'none' });
+    const openDialog = useCallback((next) => setDialog(next), []);
+    const closeDialog = useCallback(() => setDialog({ kind: 'none' }), []);
+    // Route a failed operation somewhere useful.
+    const routeError = useCallback((operation, error) => {
+        if (error.code === 'auth-failed') {
+            setDialog({
+                kind: 'auth-guidance',
+                operation: operation === 'commit' || operation === 'branch' ? 'push' : operation,
+                detail: error.message,
+            });
+            return;
+        }
+        setLastResult({ tone: 'error', message: describeError(error) });
+    }, []);
+    const statusRef = useRef(status);
+    statusRef.current = status;
+    const runAction = useCallback(async (kind, operation, action, successMessage) => {
+        if (!gitApi || !repositoryId)
+            return false;
+        setBusy(kind);
+        setLastResult(null);
+        try {
+            const result = await action(gitApi, repositoryId);
+            if (result.ok) {
+                if (successMessage)
+                    setLastResult({ tone: 'info', message: successMessage });
+                refresh();
+                return true;
+            }
+            if (operation === 'pull' && result.error.code === 'merge-conflict') {
+                // Surface the conflicted files; the fresh status carries them.
+                const fresh = await gitApi.status(repositoryId);
+                const paths = fresh.ok ? conflictedPaths(fresh.value) : [];
+                refresh();
+                setDialog({ kind: 'conflicts', paths });
+                setLastResult({ tone: 'error', message: 'Pull hit merge conflicts' });
+                return false;
+            }
+            routeError(operation, result.error);
+            refresh();
+            return false;
+        }
+        finally {
+            setBusy(null);
+        }
+    }, [gitApi, repositoryId, refresh, routeError]);
+    const commit = useCallback((message, paths) => runAction('commit', 'commit', (api, repository) => api.commit(repository, message, paths), 'Committed'), [runAction]);
+    const push = useCallback(async () => {
+        const setUpstream = statusRef.current?.upstream === null;
+        await runAction('push', 'push', (api, repository) => api.push(repository, setUpstream ? { setUpstream: true } : undefined), setUpstream ? 'Branch published' : 'Pushed');
+    }, [runAction]);
+    const pull = useCallback(async () => {
+        await runAction('pull', 'pull', (api, repository) => api.pull(repository), 'Pulled');
+    }, [runAction]);
+    const fetchRemote = useCallback(async () => {
+        await runAction('fetch', 'fetch', (api, repository) => api.fetch(repository), 'Fetched');
+    }, [runAction]);
+    const createBranch = useCallback((name) => runAction('branch', 'branch', (api, repository) => api.createBranch(repository, name, { checkout: true }), `Switched to new branch ${name}`), [runAction]);
+    const switchBranch = useCallback((name) => runAction('branch', 'branch', (api, repository) => api.checkoutBranch(repository, name), `Switched to ${name}`), [runAction]);
+    const openOnRemote = useCallback((filePath) => {
+        if (!remoteWeb || !host)
+            return;
+        let url = remoteWeb.webUrl;
+        // Only GitHub's blob-path shape is a safe bet; other hosts get the repo.
+        if (filePath && remoteWeb.host === 'github.com' && statusRef.current?.branch) {
+            const rel = filePath.replace(/^\/+/, '');
+            url = `${remoteWeb.webUrl}/blob/${encodeURIComponent(statusRef.current.branch)}/${rel
+                .split('/')
+                .map(encodeURIComponent)
+                .join('/')}`;
+        }
+        void host.shell.openExternal(url);
+    }, [remoteWeb, host]);
+    const createPullRequest = useCallback(async () => {
+        if (!gitApi || !repositoryId)
+            return;
+        setBusy('pr');
+        setLastResult(null);
+        try {
+            const result = await gitApi.createPullRequest(repositoryId);
+            if (result.ok) {
+                setLastResult({ tone: 'info', message: 'Opening pull request in browser' });
+                return;
+            }
+            if (result.error.code === 'no-upstream') {
+                setLastResult({
+                    tone: 'error',
+                    message: 'Push the branch first, then create the pull request',
+                });
+                return;
+            }
+            if (result.error.code === 'gh-not-available') {
+                setLastResult({
+                    tone: 'error',
+                    message: 'Install the GitHub CLI (gh) to create pull requests',
+                });
+                return;
+            }
+            routeError('pr', result.error);
+        }
+        finally {
+            setBusy(null);
+        }
+    }, [gitApi, repositoryId, routeError]);
+    return {
+        available,
+        capabilities,
+        repo,
+        repositoryId,
+        remoteWeb,
+        gitApi,
+        provider,
+        theme,
+        status,
+        badges,
+        busy,
+        lastResult,
+        refresh,
+        scheduleRefresh,
+        commit,
+        push,
+        pull,
+        fetchRemote,
+        createBranch,
+        switchBranch,
+        openOnRemote,
+        createPullRequest,
+        dialog,
+        openDialog,
+        closeDialog,
+    };
+}
+//# sourceMappingURL=useGit.js.map

package/dist/Git/useGit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGit.js","sourceRoot":"","sources":["../../src/Git/useGit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAQ1E,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAElE,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD,6EAA6E;AAC7E,IAAI,mBAAmB,GAAoC,IAAI,CAAC;AAChE,SAAS,gBAAgB,CAAC,MAA2B;IACnD,mBAAmB,KAAnB,mBAAmB,GAAK,MAAM,CAAC,YAAY,EAAE,EAAC;IAC9C,OAAO,mBAAmB,CAAC;AAC7B,CAAC;AAED,SAAS,aAAa,CAAC,KAAe;IACpC,OAAO,KAAK,CAAC,OAAO,IAAI,sBAAsB,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,MAAM,CACpB,QAAmC,EACnC,oBAAmC,EACnC,KAAuB;IAEvB,MAAM,IAAI,GAAG,qBAAqB,EAAE,CAAC;IACrC,MAAM,MAAM,GAAG,IAAI,EAAE,GAAG,IAAI,IAAI,CAAC;IACjC,MAAM,WAAW,GAAG,MAAM,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,IAAI,CAAC;IAEzD,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,GAAG,QAAQ,CAAyB,IAAI,CAAC,CAAC;IAC/E,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,MAAM;YAAE,OAAO;QACpB,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,KAAK,gBAAgB,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;YAC1C,IAAI,CAAC,SAAS;gBAAE,eAAe,CAAC,IAAI,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;QACH,OAAO,GAAG,EAAE;YACV,SAAS,GAAG,IAAI,CAAC;QACnB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAEb,MAAM,SAAS,GAAG,MAAM,KAAK,IAAI,IAAI,YAAY,EAAE,YAAY,KAAK,IAAI,CAAC;IAEzE,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAA0B,IAAI,CAAC,CAAC;IAChE,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAwB,IAAI,CAAC,CAAC;IACxE,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,CAAC,IAAI,CAAC,CAAC;QACd,YAAY,CAAC,IAAI,CAAC,CAAC;QACnB,IAAI,CAAC,MAAM,IAAI,CAAC,WAAW,IAAI,CAAC,SAAS;YAAE,OAAO;QAClD,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,KAAK,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;YAClD,IAAI,SAAS,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC;gBAClF,OAAO;YACT,CAAC;YACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACtB,KAAK,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE;gBAClE,IAAI,SAAS,IAAI,CAAC,OAAO,CAAC,EAAE;oBAAE,OAAO;gBACrC,MAAM,KAAK,GAA8B,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBAC1D,YAAY,CAAC,KAAK,EAAE,GAAG,IAAI,IAAI,CAAC,CAAC;YACnC,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QACH,OAAO,GAAG,EAAE;YACV,SAAS,GAAG,IAAI,CAAC;QACnB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC;IAErC,MAAM,YAAY,GAAG,IAAI,EAAE,YAAY,IAAI,IAAI,CAAC;IAChD,MAAM,MAAM,GAAG,YAAY,KAAK,IAAI,CAAC;IACrC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,GAAG,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;IACxF,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,IAAI,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAE7E,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAc,IAAI,CAAC,CAAC;IACpD,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAyB,IAAI,CAAC,CAAC;IAC3E,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAiB,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IAEvE,MAAM,UAAU,GAAG,WAAW,CAAC,CAAC,IAAoB,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IAC9E,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IAEvE,6CAA6C;IAC7C,MAAM,UAAU,GAAG,WAAW,CAC5B,CAAC,SAAiE,EAAE,KAAe,EAAE,EAAE;QACrF,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;YACjC,SAAS,CAAC;gBACR,IAAI,EAAE,eAAe;gBACrB,SAAS,EAAE,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;gBAChF,MAAM,EAAE,KAAK,CAAC,OAAO;aACtB,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QACD,aAAa,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAClE,CAAC,EACD,EAAE,CACH,CAAC;IAEF,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IACjC,SAAS,CAAC,OAAO,GAAG,MAAM,CAAC;IAE3B,MAAM,SAAS,GAAG,WAAW,CAC3B,KAAK,EACH,IAAgC,EAChC,SAAiE,EACjE,MAGqE,EACrE,cAAuB,EACL,EAAE;QACpB,IAAI,CAAC,MAAM,IAAI,CAAC,YAAY;YAAE,OAAO,KAAK,CAAC;QAC3C,OAAO,CAAC,IAAI,CAAC,CAAC;QACd,aAAa,CAAC,IAAI,CAAC,CAAC;QACpB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;YAClD,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;gBACd,IAAI,cAAc;oBAAE,aAAa,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,CAAC;gBAC7E,OAAO,EAAE,CAAC;gBACV,OAAO,IAAI,CAAC;YACd,CAAC;YACD,IAAI,SAAS,KAAK,MAAM,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;gBACnE,+DAA+D;gBAC/D,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;gBAChD,MAAM,KAAK,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC3D,OAAO,EAAE,CAAC;gBACV,SAAS,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC;gBACxC,aAAa,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,0BAA0B,EAAE,CAAC,CAAC;gBACtE,OAAO,KAAK,CAAC;YACf,CAAC;YACD,UAAU,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;YACpC,OAAO,EAAE,CAAC;YACV,OAAO,KAAK,CAAC;QACf,CAAC;gBAAS,CAAC;YACT,OAAO,CAAC,IAAI,CAAC,CAAC;QAChB,CAAC;IACH,CAAC,EACD,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,CAAC,CAC5C,CAAC;IAEF,MAAM,MAAM,GAAG,WAAW,CACxB,CAAC,OAAe,EAAE,KAAe,EAAE,EAAE,CACnC,SAAS,CACP,QAAQ,EACR,QAAQ,EACR,CAAC,GAAG,EAAE,UAAU,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,EAAE,KAAK,CAAC,EAC3D,WAAW,CACZ,EACH,CAAC,SAAS,CAAC,CACZ,CAAC;IAEF,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;QAClC,MAAM,WAAW,GAAG,SAAS,CAAC,OAAO,EAAE,QAAQ,KAAK,IAAI,CAAC;QACzD,MAAM,SAAS,CACb,MAAM,EACN,MAAM,EACN,CAAC,GAAG,EAAE,UAAU,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAC1F,WAAW,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,QAAQ,CAC5C,CAAC;IACJ,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;IAEhB,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;QAClC,MAAM,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,CAAC;IACvF,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;IAEhB,MAAM,WAAW,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;QACzC,MAAM,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,SAAS,CAAC,CAAC;IAC3F,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;IAEhB,MAAM,YAAY,GAAG,WAAW,CAC9B,CAAC,IAAY,EAAE,EAAE,CACf,SAAS,CACP,QAAQ,EACR,QAAQ,EACR,CAAC,GAAG,EAAE,UAAU,EAAE,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC,UAAU,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,EAC3E,0BAA0B,IAAI,EAAE,CACjC,EACH,CAAC,SAAS,CAAC,CACZ,CAAC;IAEF,MAAM,YAAY,GAAG,WAAW,CAC9B,CAAC,IAAY,EAAE,EAAE,CACf,SAAS,CACP,QAAQ,EACR,QAAQ,EACR,CAAC,GAAG,EAAE,UAAU,EAAE,EAAE,CAAC,GAAG,CAAC,cAAc,CAAC,UAAU,EAAE,IAAI,CAAC,EACzD,eAAe,IAAI,EAAE,CACtB,EACH,CAAC,SAAS,CAAC,CACZ,CAAC;IAEF,MAAM,YAAY,GAAG,WAAW,CAC9B,CAAC,QAAiB,EAAE,EAAE;QACpB,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI;YAAE,OAAO;QAChC,IAAI,GAAG,GAAG,SAAS,CAAC,MAAM,CAAC;QAC3B,yEAAyE;QACzE,IAAI,QAAQ,IAAI,SAAS,CAAC,IAAI,KAAK,YAAY,IAAI,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;YAC7E,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YACzC,GAAG,GAAG,GAAG,SAAS,CAAC,MAAM,SAAS,kBAAkB,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,GAAG;iBAClF,KAAK,CAAC,GAAG,CAAC;iBACV,GAAG,CAAC,kBAAkB,CAAC;iBACvB,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACjB,CAAC;QACD,KAAK,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;IACpC,CAAC,EACD,CAAC,SAAS,EAAE,IAAI,CAAC,CAClB,CAAC;IAEF,MAAM,iBAAiB,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;QAC/C,IAAI,CAAC,MAAM,IAAI,CAAC,YAAY;YAAE,OAAO;QACrC,OAAO,CAAC,IAAI,CAAC,CAAC;QACd,aAAa,CAAC,IAAI,CAAC,CAAC;QACpB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,YAAY,CAAC,CAAC;YAC5D,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;gBACd,aAAa,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC,CAAC;gBAC5E,OAAO;YACT,CAAC;YACD,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;gBACxC,aAAa,CAAC;oBACZ,IAAI,EAAE,OAAO;oBACb,OAAO,EAAE,qDAAqD;iBAC/D,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;YACD,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;gBAC7C,aAAa,CAAC;oBACZ,IAAI,EAAE,OAAO;oBACb,OAAO,EAAE,qDAAqD;iBAC/D,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;YACD,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC;gBAAS,CAAC;YACT,OAAO,CAAC,IAAI,CAAC,CAAC;QAChB,CAAC;IACH,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC;IAEvC,OAAO;QACL,SAAS;QACT,YAAY;QACZ,IAAI;QACJ,YAAY;QACZ,SAAS;QACT,MAAM;QACN,QAAQ;QACR,KAAK;QACL,MAAM;QACN,MAAM;QACN,IAAI;QACJ,UAAU;QACV,OAAO;QACP,eAAe;QACf,MAAM;QACN,IAAI;QACJ,IAAI;QACJ,WAAW;QACX,YAAY;QACZ,YAAY;QACZ,YAAY;QACZ,iBAAiB;QACjB,MAAM;QACN,UAAU;QACV,WAAW;KACZ,CAAC;AACJ,CAAC"}

package/dist/Git/useGitStatus.d.ts

@@ -0,0 +1,17 @@
+/**
+ * useGitStatus — subscribes to the host's owner-scoped repository stream.
+ *
+ * Dedupes identical payloads so a permanently-dirty working tree (normal
+ * under the manual-commit model) doesn't repaint the tree on every push
+ * from the main process.
+ */
+import type { DocBlocksHostGitAPI, GitStatus } from '@bendyline/docblocks/host';
+export interface UseGitStatusResult {
+    status: GitStatus | null;
+    /** Fetch a fresh status immediately (after a renderer-initiated git op). */
+    refresh: () => void;
+    /** Trailing-debounced refresh (after autosave writes). */
+    scheduleRefresh: () => void;
+}
+export declare function useGitStatus(gitApi: DocBlocksHostGitAPI | null, repositoryId: string | null, enabled: boolean): UseGitStatusResult;
+//# sourceMappingURL=useGitStatus.d.ts.map

package/dist/Git/useGitStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGitStatus.d.ts","sourceRoot":"","sources":["../../src/Git/useGitStatus.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAQhF,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;IACzB,4EAA4E;IAC5E,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,0DAA0D;IAC1D,eAAe,EAAE,MAAM,IAAI,CAAC;CAC7B;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,mBAAmB,GAAG,IAAI,EAClC,YAAY,EAAE,MAAM,GAAG,IAAI,EAC3B,OAAO,EAAE,OAAO,GACf,kBAAkB,CAgDpB"}

package/dist/Git/useGitStatus.js

@@ -0,0 +1,63 @@
+/**
+ * useGitStatus — subscribes to the host's owner-scoped repository stream.
+ *
+ * Dedupes identical payloads so a permanently-dirty working tree (normal
+ * under the manual-commit model) doesn't repaint the tree on every push
+ * from the main process.
+ */
+import { useCallback, useEffect, useRef, useState } from 'react';
+const SCHEDULE_REFRESH_MS = 1500;
+function statusKey(status) {
+    return JSON.stringify(status);
+}
+export function useGitStatus(gitApi, repositoryId, enabled) {
+    const [status, setStatus] = useState(null);
+    const lastKeyRef = useRef(null);
+    const timerRef = useRef(null);
+    const apply = useCallback((next) => {
+        const key = statusKey(next);
+        if (key === lastKeyRef.current)
+            return;
+        lastKeyRef.current = key;
+        setStatus(next);
+    }, []);
+    useEffect(() => {
+        lastKeyRef.current = null;
+        setStatus(null);
+        if (!gitApi || !repositoryId || !enabled)
+            return;
+        let cancelled = false;
+        const unsubscribe = gitApi.onStatusChanged(repositoryId, (next) => {
+            if (!cancelled)
+                apply(next);
+        });
+        return () => {
+            cancelled = true;
+            unsubscribe();
+        };
+    }, [gitApi, repositoryId, enabled, apply]);
+    const refresh = useCallback(() => {
+        if (!gitApi || !repositoryId || !enabled)
+            return;
+        void gitApi.status(repositoryId).then((result) => {
+            if (result.ok)
+                apply(result.value);
+        });
+    }, [gitApi, repositoryId, enabled, apply]);
+    const scheduleRefresh = useCallback(() => {
+        if (timerRef.current)
+            clearTimeout(timerRef.current);
+        timerRef.current = setTimeout(() => {
+            timerRef.current = null;
+            refresh();
+        }, SCHEDULE_REFRESH_MS);
+    }, [refresh]);
+    useEffect(() => {
+        return () => {
+            if (timerRef.current)
+                clearTimeout(timerRef.current);
+        };
+    }, []);
+    return { status, refresh, scheduleRefresh };
+}
+//# sourceMappingURL=useGitStatus.js.map

package/dist/Git/useGitStatus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGitStatus.js","sourceRoot":"","sources":["../../src/Git/useGitStatus.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAGjE,MAAM,mBAAmB,GAAG,IAAI,CAAC;AAEjC,SAAS,SAAS,CAAC,MAAiB;IAClC,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;AAChC,CAAC;AAUD,MAAM,UAAU,YAAY,CAC1B,MAAkC,EAClC,YAA2B,EAC3B,OAAgB;IAEhB,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAmB,IAAI,CAAC,CAAC;IAC7D,MAAM,UAAU,GAAG,MAAM,CAAgB,IAAI,CAAC,CAAC;IAC/C,MAAM,QAAQ,GAAG,MAAM,CAAuC,IAAI,CAAC,CAAC;IAEpE,MAAM,KAAK,GAAG,WAAW,CAAC,CAAC,IAAe,EAAE,EAAE;QAC5C,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAC5B,IAAI,GAAG,KAAK,UAAU,CAAC,OAAO;YAAE,OAAO;QACvC,UAAU,CAAC,OAAO,GAAG,GAAG,CAAC;QACzB,SAAS,CAAC,IAAI,CAAC,CAAC;IAClB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,SAAS,CAAC,GAAG,EAAE;QACb,UAAU,CAAC,OAAO,GAAG,IAAI,CAAC;QAC1B,SAAS,CAAC,IAAI,CAAC,CAAC;QAChB,IAAI,CAAC,MAAM,IAAI,CAAC,YAAY,IAAI,CAAC,OAAO;YAAE,OAAO;QACjD,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,MAAM,WAAW,GAAG,MAAM,CAAC,eAAe,CAAC,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE;YAChE,IAAI,CAAC,SAAS;gBAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC,CAAC,CAAC;QACH,OAAO,GAAG,EAAE;YACV,SAAS,GAAG,IAAI,CAAC;YACjB,WAAW,EAAE,CAAC;QAChB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;IAE3C,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE;QAC/B,IAAI,CAAC,MAAM,IAAI,CAAC,YAAY,IAAI,CAAC,OAAO;YAAE,OAAO;QACjD,KAAK,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;YAC/C,IAAI,MAAM,CAAC,EAAE;gBAAE,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;IACL,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;IAE3C,MAAM,eAAe,GAAG,WAAW,CAAC,GAAG,EAAE;QACvC,IAAI,QAAQ,CAAC,OAAO;YAAE,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACrD,QAAQ,CAAC,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;YACjC,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC;YACxB,OAAO,EAAE,CAAC;QACZ,CAAC,EAAE,mBAAmB,CAAC,CAAC;IAC1B,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAEd,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,GAAG,EAAE;YACV,IAAI,QAAQ,CAAC,OAAO;gBAAE,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACvD,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC;AAC9C,CAAC"}

package/dist/GitToolbarControl-LMIR4R7I.js

@@ -0,0 +1,117 @@
+import {
+  isFileDirty,
+  useGitContext
+} from "./chunk-5A4KEWKT.js";
+
+// src/Git/GitToolbarControl.tsx
+import { useEffect, useRef, useState } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+function GitToolbarControl({ selectedFile }) {
+  const git = useGitContext();
+  const [menuOpen, setMenuOpen] = useState(false);
+  const menuRef = useRef(null);
+  useEffect(() => {
+    if (!menuOpen) return;
+    const onPointerDown = (e) => {
+      if (menuRef.current && !menuRef.current.contains(e.target)) {
+        setMenuOpen(false);
+      }
+    };
+    document.addEventListener("pointerdown", onPointerDown);
+    return () => document.removeEventListener("pointerdown", onPointerDown);
+  }, [menuOpen]);
+  if (!git || !git.repo || !selectedFile) return null;
+  const dirty = isFileDirty(git.status, selectedFile);
+  const label = dirty ? "Git actions (file modified)" : "Git actions";
+  const openDiff = () => {
+    setMenuOpen(false);
+    git.openDialog({ kind: "diff", path: selectedFile });
+  };
+  const openHistory = () => {
+    setMenuOpen(false);
+    git.openDialog({ kind: "history", path: selectedFile });
+  };
+  const openOnRemote = () => {
+    setMenuOpen(false);
+    git.openOnRemote(selectedFile);
+  };
+  return /* @__PURE__ */ jsxs("div", { className: "db-toolbar-menu", ref: menuRef, children: [
+    /* @__PURE__ */ jsxs(
+      "button",
+      {
+        type: "button",
+        className: "squisq-toolbar-button db-git-toolbar-trigger",
+        onClick: () => setMenuOpen((prev) => !prev),
+        "aria-label": label,
+        "aria-haspopup": "menu",
+        "aria-expanded": menuOpen,
+        "data-tooltip": label,
+        children: [
+          /* @__PURE__ */ jsx(BranchGlyph, {}),
+          dirty && /* @__PURE__ */ jsx("span", { className: "db-git-toolbar-dot", "aria-hidden": "true" })
+        ]
+      }
+    ),
+    menuOpen && /* @__PURE__ */ jsxs("div", { className: "db-toolbar-menu-dropdown", role: "menu", children: [
+      /* @__PURE__ */ jsx(
+        "button",
+        {
+          type: "button",
+          role: "menuitem",
+          className: "db-toolbar-menu-item",
+          disabled: !dirty,
+          onClick: openDiff,
+          children: "View changes"
+        }
+      ),
+      /* @__PURE__ */ jsx(
+        "button",
+        {
+          type: "button",
+          role: "menuitem",
+          className: "db-toolbar-menu-item",
+          onClick: openHistory,
+          children: "File history\u2026"
+        }
+      ),
+      git.remoteWeb && /* @__PURE__ */ jsxs(
+        "button",
+        {
+          type: "button",
+          role: "menuitem",
+          className: "db-toolbar-menu-item",
+          onClick: openOnRemote,
+          children: [
+            "Open on ",
+            git.remoteWeb.host
+          ]
+        }
+      )
+    ] })
+  ] });
+}
+function BranchGlyph() {
+  return /* @__PURE__ */ jsxs(
+    "svg",
+    {
+      viewBox: "0 0 16 16",
+      width: "16",
+      height: "16",
+      fill: "none",
+      stroke: "currentColor",
+      strokeWidth: "1.5",
+      strokeLinecap: "round",
+      strokeLinejoin: "round",
+      "aria-hidden": "true",
+      children: [
+        /* @__PURE__ */ jsx("circle", { cx: "4.5", cy: "12", r: "2" }),
+        /* @__PURE__ */ jsx("circle", { cx: "11.5", cy: "4", r: "2" }),
+        /* @__PURE__ */ jsx("path", { d: "M4.5 10V7.5A2.5 2.5 0 0 1 7 5h2.5" })
+      ]
+    }
+  );
+}
+export {
+  GitToolbarControl
+};
+//# sourceMappingURL=GitToolbarControl-LMIR4R7I.js.map

package/dist/GitToolbarControl-LMIR4R7I.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/Git/GitToolbarControl.tsx"],"sourcesContent":["/**\n * GitToolbarControl — per-file git actions in the editor toolbar.\n *\n * A single branch-glyph button (styled like the export trigger) opening a\n * small dropdown: view working-tree changes, per-file history, and \"Open\n * on <host>\" when a web remote is known. A dot overlay marks the selected\n * file as modified. Null-renders without a git context, a repository, or a\n * selected file. Deliberately has no editor dependency.\n */\n\nimport { useEffect, useRef, useState } from 'react';\nimport { useGitContext } from './GitContext.js';\nimport { isFileDirty } from './git-status.js';\n\nexport interface GitToolbarControlProps {\n  /** Currently selected file path (slash-prefixed), or null. */\n  selectedFile: string | null;\n}\n\nexport function GitToolbarControl({ selectedFile }: GitToolbarControlProps) {\n  const git = useGitContext();\n  const [menuOpen, setMenuOpen] = useState(false);\n  const menuRef = useRef<HTMLDivElement>(null);\n\n  // Close on outside click (same pointerdown pattern as ExportToolbarControls).\n  useEffect(() => {\n    if (!menuOpen) return;\n    const onPointerDown = (e: PointerEvent) => {\n      if (menuRef.current && !menuRef.current.contains(e.target as Node)) {\n        setMenuOpen(false);\n      }\n    };\n    document.addEventListener('pointerdown', onPointerDown);\n    return () => document.removeEventListener('pointerdown', onPointerDown);\n  }, [menuOpen]);\n\n  if (!git || !git.repo || !selectedFile) return null;\n\n  const dirty = isFileDirty(git.status, selectedFile);\n  const label = dirty ? 'Git actions (file modified)' : 'Git actions';\n\n  const openDiff = () => {\n    setMenuOpen(false);\n    git.openDialog({ kind: 'diff', path: selectedFile });\n  };\n  const openHistory = () => {\n    setMenuOpen(false);\n    git.openDialog({ kind: 'history', path: selectedFile });\n  };\n  const openOnRemote = () => {\n    setMenuOpen(false);\n    git.openOnRemote(selectedFile);\n  };\n\n  return (\n    <div className=\"db-toolbar-menu\" ref={menuRef}>\n      <button\n        type=\"button\"\n        className=\"squisq-toolbar-button db-git-toolbar-trigger\"\n        onClick={() => setMenuOpen((prev) => !prev)}\n        aria-label={label}\n        aria-haspopup=\"menu\"\n        aria-expanded={menuOpen}\n        data-tooltip={label}\n      >\n        <BranchGlyph />\n        {dirty && <span className=\"db-git-toolbar-dot\" aria-hidden=\"true\" />}\n      </button>\n\n      {menuOpen && (\n        <div className=\"db-toolbar-menu-dropdown\" role=\"menu\">\n          <button\n            type=\"button\"\n            role=\"menuitem\"\n            className=\"db-toolbar-menu-item\"\n            disabled={!dirty}\n            onClick={openDiff}\n          >\n            View changes\n          </button>\n          <button\n            type=\"button\"\n            role=\"menuitem\"\n            className=\"db-toolbar-menu-item\"\n            onClick={openHistory}\n          >\n            File history…\n          </button>\n          {git.remoteWeb && (\n            <button\n              type=\"button\"\n              role=\"menuitem\"\n              className=\"db-toolbar-menu-item\"\n              onClick={openOnRemote}\n            >\n              Open on {git.remoteWeb.host}\n            </button>\n          )}\n        </div>\n      )}\n    </div>\n  );\n}\n\nfunction BranchGlyph() {\n  return (\n    <svg\n      viewBox=\"0 0 16 16\"\n      width=\"16\"\n      height=\"16\"\n      fill=\"none\"\n      stroke=\"currentColor\"\n      strokeWidth=\"1.5\"\n      strokeLinecap=\"round\"\n      strokeLinejoin=\"round\"\n      aria-hidden=\"true\"\n    >\n      <circle cx=\"4.5\" cy=\"12\" r=\"2\" />\n      <circle cx=\"11.5\" cy=\"4\" r=\"2\" />\n      <path d=\"M4.5 10V7.5A2.5 2.5 0 0 1 7 5h2.5\" />\n    </svg>\n  );\n}\n"],"mappings":";;;;;;AAUA,SAAS,WAAW,QAAQ,gBAAgB;AA8CtC,SASE,KATF;AArCC,SAAS,kBAAkB,EAAE,aAAa,GAA2B;AAC1E,QAAM,MAAM,cAAc;AAC1B,QAAM,CAAC,UAAU,WAAW,IAAI,SAAS,KAAK;AAC9C,QAAM,UAAU,OAAuB,IAAI;AAG3C,YAAU,MAAM;AACd,QAAI,CAAC,SAAU;AACf,UAAM,gBAAgB,CAAC,MAAoB;AACzC,UAAI,QAAQ,WAAW,CAAC,QAAQ,QAAQ,SAAS,EAAE,MAAc,GAAG;AAClE,oBAAY,KAAK;AAAA,MACnB;AAAA,IACF;AACA,aAAS,iBAAiB,eAAe,aAAa;AACtD,WAAO,MAAM,SAAS,oBAAoB,eAAe,aAAa;AAAA,EACxE,GAAG,CAAC,QAAQ,CAAC;AAEb,MAAI,CAAC,OAAO,CAAC,IAAI,QAAQ,CAAC,aAAc,QAAO;AAE/C,QAAM,QAAQ,YAAY,IAAI,QAAQ,YAAY;AAClD,QAAM,QAAQ,QAAQ,gCAAgC;AAEtD,QAAM,WAAW,MAAM;AACrB,gBAAY,KAAK;AACjB,QAAI,WAAW,EAAE,MAAM,QAAQ,MAAM,aAAa,CAAC;AAAA,EACrD;AACA,QAAM,cAAc,MAAM;AACxB,gBAAY,KAAK;AACjB,QAAI,WAAW,EAAE,MAAM,WAAW,MAAM,aAAa,CAAC;AAAA,EACxD;AACA,QAAM,eAAe,MAAM;AACzB,gBAAY,KAAK;AACjB,QAAI,aAAa,YAAY;AAAA,EAC/B;AAEA,SACE,qBAAC,SAAI,WAAU,mBAAkB,KAAK,SACpC;AAAA;AAAA,MAAC;AAAA;AAAA,QACC,MAAK;AAAA,QACL,WAAU;AAAA,QACV,SAAS,MAAM,YAAY,CAAC,SAAS,CAAC,IAAI;AAAA,QAC1C,cAAY;AAAA,QACZ,iBAAc;AAAA,QACd,iBAAe;AAAA,QACf,gBAAc;AAAA,QAEd;AAAA,8BAAC,eAAY;AAAA,UACZ,SAAS,oBAAC,UAAK,WAAU,sBAAqB,eAAY,QAAO;AAAA;AAAA;AAAA,IACpE;AAAA,IAEC,YACC,qBAAC,SAAI,WAAU,4BAA2B,MAAK,QAC7C;AAAA;AAAA,QAAC;AAAA;AAAA,UACC,MAAK;AAAA,UACL,MAAK;AAAA,UACL,WAAU;AAAA,UACV,UAAU,CAAC;AAAA,UACX,SAAS;AAAA,UACV;AAAA;AAAA,MAED;AAAA,MACA;AAAA,QAAC;AAAA;AAAA,UACC,MAAK;AAAA,UACL,MAAK;AAAA,UACL,WAAU;AAAA,UACV,SAAS;AAAA,UACV;AAAA;AAAA,MAED;AAAA,MACC,IAAI,aACH;AAAA,QAAC;AAAA;AAAA,UACC,MAAK;AAAA,UACL,MAAK;AAAA,UACL,WAAU;AAAA,UACV,SAAS;AAAA,UACV;AAAA;AAAA,YACU,IAAI,UAAU;AAAA;AAAA;AAAA,MACzB;AAAA,OAEJ;AAAA,KAEJ;AAEJ;AAEA,SAAS,cAAc;AACrB,SACE;AAAA,IAAC;AAAA;AAAA,MACC,SAAQ;AAAA,MACR,OAAM;AAAA,MACN,QAAO;AAAA,MACP,MAAK;AAAA,MACL,QAAO;AAAA,MACP,aAAY;AAAA,MACZ,eAAc;AAAA,MACd,gBAAe;AAAA,MACf,eAAY;AAAA,MAEZ;AAAA,4BAAC,YAAO,IAAG,OAAM,IAAG,MAAK,GAAE,KAAI;AAAA,QAC/B,oBAAC,YAAO,IAAG,QAAO,IAAG,KAAI,GAAE,KAAI;AAAA,QAC/B,oBAAC,UAAK,GAAE,qCAAoC;AAAA;AAAA;AAAA,EAC9C;AAEJ;","names":[]}