@deshlo/plugin-github 0.1.0

package/build/src/lib/hostConfig.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveRepoConfigForCurrentHost = resolveRepoConfigForCurrentHost;
+const errors_1 = require("./errors");
+const HOST_CONFIG_ENV = "NEXT_PUBLIC_SOURCE_INSPECTOR_HOST_CONFIG";
+function parseHostConfig(raw) {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        throw new errors_1.SourceInspectorError("UNMAPPED_HOST", `${HOST_CONFIG_ENV} must be valid JSON.`);
+    }
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+        throw new errors_1.SourceInspectorError("UNMAPPED_HOST", `${HOST_CONFIG_ENV} must be an object keyed by host.`);
+    }
+    return parsed;
+}
+function parseHostConfigInput(input) {
+    if (input && typeof input === "object" && !Array.isArray(input)) {
+        return input;
+    }
+    const raw = typeof input === "string" ? input : process.env.NEXT_PUBLIC_SOURCE_INSPECTOR_HOST_CONFIG;
+    if (!raw) {
+        throw new errors_1.SourceInspectorError("UNMAPPED_HOST", `${HOST_CONFIG_ENV} is not configured.`);
+    }
+    return parseHostConfig(raw);
+}
+function getCurrentHost() {
+    if (typeof window === "undefined" || !window.location?.host) {
+        throw new errors_1.SourceInspectorError("UNMAPPED_HOST", "Unable to infer current host in this runtime.");
+    }
+    const host = window.location.host.trim().toLowerCase();
+    if (!host) {
+        throw new errors_1.SourceInspectorError("UNMAPPED_HOST", "Unable to infer current host.");
+    }
+    return host;
+}
+function stripPort(host) {
+    const portIndex = host.indexOf(":");
+    if (portIndex === -1) {
+        return host;
+    }
+    return host.slice(0, portIndex);
+}
+function validateHostConfig(host, config) {
+    if (!config || typeof config !== "object") {
+        throw new errors_1.SourceInspectorError("UNMAPPED_HOST", `Missing repository configuration for host ${host}.`);
+    }
+    if (!config.owner || !config.repo) {
+        throw new errors_1.SourceInspectorError("UNMAPPED_HOST", `Host config for ${host} must include owner and repo.`);
+    }
+    return {
+        ...config,
+        host,
+        apiBaseUrl: config.apiBaseUrl?.trim() || "https://api.github.com",
+    };
+}
+function resolveRepoConfigForCurrentHost(hostOverride, hostConfigInput) {
+    const host = (hostOverride || getCurrentHost()).trim().toLowerCase();
+    const withoutPort = stripPort(host);
+    const mapping = parseHostConfigInput(hostConfigInput);
+    const config = mapping[host] ?? mapping[withoutPort];
+    if (!config) {
+        throw new errors_1.SourceInspectorError("UNMAPPED_HOST", `No source inspector repo mapping found for host ${host}.`);
+    }
+    return validateHostConfig(host, config);
+}

package/build/src/lib/jsxTextEdit.d.ts

@@ -0,0 +1,15 @@
+import type { ParsedSourceLoc } from "./types";
+export interface ApplyTextReplacementInput {
+    sourceCode: string;
+    sourceLoc: ParsedSourceLoc;
+    tagName: string;
+    selectedText: string;
+    proposedText: string;
+}
+export interface ApplyTextReplacementResult {
+    updatedSourceCode: string;
+    oldText: string;
+    newText: string;
+}
+export declare function applyTextReplacement({ sourceCode, sourceLoc, tagName, selectedText, proposedText, }: ApplyTextReplacementInput): ApplyTextReplacementResult;
+//# sourceMappingURL=jsxTextEdit.d.ts.map

package/build/src/lib/jsxTextEdit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsxTextEdit.d.ts","sourceRoot":"","sources":["../../../src/lib/jsxTextEdit.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,eAAe,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,0BAA0B;IACzC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AA6FD,wBAAgB,oBAAoB,CAAC,EACnC,UAAU,EACV,SAAS,EACT,OAAO,EACP,YAAY,EACZ,YAAY,GACb,EAAE,yBAAyB,GAAG,0BAA0B,CAuFxD"}

package/build/src/lib/jsxTextEdit.js

@@ -0,0 +1,162 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyTextReplacement = applyTextReplacement;
+const parser = __importStar(require("@babel/parser"));
+const traverse_1 = __importDefault(require("@babel/traverse"));
+const t = __importStar(require("@babel/types"));
+const errors_1 = require("./errors");
+const sourceLoc_1 = require("./sourceLoc");
+function findMatchedOpeningElement(sourceCode, sourceLoc, tagName) {
+    let ast;
+    try {
+        ast = parser.parse(sourceCode, {
+            sourceType: "unambiguous",
+            errorRecovery: true,
+            plugins: [
+                "jsx",
+                "typescript",
+                "classProperties",
+                "classPrivateProperties",
+                "classPrivateMethods",
+                "dynamicImport",
+                "importMeta",
+                "topLevelAwait",
+            ],
+        });
+    }
+    catch {
+        throw new errors_1.SourceInspectorError("INVALID_SOURCE_LOC", "Unable to parse source file.");
+    }
+    const matches = [];
+    (0, traverse_1.default)(ast, {
+        JSXOpeningElement(path) {
+            const nameNode = path.node.name;
+            if (!t.isJSXIdentifier(nameNode)) {
+                return;
+            }
+            if (!path.node.loc || typeof path.node.start !== "number") {
+                return;
+            }
+            const nodeLine = path.node.loc.start.line;
+            const nodeColumnOneBased = path.node.loc.start.column + 1;
+            if (nodeLine === sourceLoc.line &&
+                nodeColumnOneBased === sourceLoc.column &&
+                nameNode.name === tagName) {
+                matches.push({
+                    node: path.node,
+                    start: path.node.start,
+                });
+            }
+        },
+    });
+    if (matches.length !== 1) {
+        throw new errors_1.SourceInspectorError("INVALID_SOURCE_LOC", "Unable to map selected element to a unique JSX tag in source file.");
+    }
+    return matches[0];
+}
+function replaceTrimmedPortion(rawText, replacement) {
+    const trimmed = rawText.trim();
+    if (!trimmed) {
+        throw new errors_1.SourceInspectorError("NON_TEXT_NODE", "Selected element does not contain editable text.");
+    }
+    const first = rawText.indexOf(trimmed);
+    const last = rawText.lastIndexOf(trimmed);
+    if (first === -1 || first !== last) {
+        throw new errors_1.SourceInspectorError("NON_TEXT_NODE", "Selected element text is ambiguous and cannot be replaced safely.");
+    }
+    return `${rawText.slice(0, first)}${replacement}${rawText.slice(first + trimmed.length)}`;
+}
+function applyTextReplacement({ sourceCode, sourceLoc, tagName, selectedText, proposedText, }) {
+    const matchedOpening = findMatchedOpeningElement(sourceCode, sourceLoc, tagName);
+    let ast;
+    try {
+        ast = parser.parse(sourceCode, {
+            sourceType: "unambiguous",
+            errorRecovery: true,
+            plugins: ["jsx", "typescript", "classProperties", "classPrivateProperties", "classPrivateMethods"],
+        });
+    }
+    catch {
+        throw new errors_1.SourceInspectorError("INVALID_SOURCE_LOC", "Unable to parse source file.");
+    }
+    let targetChildren = null;
+    (0, traverse_1.default)(ast, {
+        JSXElement(path) {
+            const opening = path.node.openingElement;
+            if (typeof opening.start !== "number") {
+                return;
+            }
+            if (opening.start === matchedOpening.start) {
+                targetChildren = path.node.children;
+                path.stop();
+            }
+        },
+    });
+    if (!targetChildren) {
+        throw new errors_1.SourceInspectorError("INVALID_SOURCE_LOC", "Unable to locate selected JSX element.");
+    }
+    const resolvedChildren = targetChildren;
+    const unsupportedChild = resolvedChildren.some((child) => !t.isJSXText(child));
+    if (unsupportedChild) {
+        throw new errors_1.SourceInspectorError("NON_TEXT_NODE", "Selected element contains nested or dynamic children. Select a simple text element.");
+    }
+    const meaningfulTextNodes = resolvedChildren.filter((child) => t.isJSXText(child) && child.value.trim().length > 0);
+    if (meaningfulTextNodes.length !== 1) {
+        throw new errors_1.SourceInspectorError("NON_TEXT_NODE", "Selected element must contain exactly one direct text segment.");
+    }
+    const textNode = meaningfulTextNodes[0];
+    if (typeof textNode.start !== "number" || typeof textNode.end !== "number") {
+        throw new errors_1.SourceInspectorError("INVALID_SOURCE_LOC", "Unable to map selected text node offsets.");
+    }
+    const rawText = sourceCode.slice(textNode.start, textNode.end);
+    const oldText = rawText.trim();
+    if ((0, sourceLoc_1.normalizeTextForComparison)(oldText) !== (0, sourceLoc_1.normalizeTextForComparison)(selectedText)) {
+        throw new errors_1.SourceInspectorError("TEXT_MISMATCH", "Selected DOM text no longer matches source. Refresh and try again.");
+    }
+    if (oldText === proposedText.trim()) {
+        throw new errors_1.SourceInspectorError("NO_DIFF", "No effective change detected.");
+    }
+    const replacementRawText = replaceTrimmedPortion(rawText, proposedText.trim());
+    const updatedSourceCode = sourceCode.slice(0, textNode.start) + replacementRawText + sourceCode.slice(textNode.end);
+    return {
+        updatedSourceCode,
+        oldText,
+        newText: proposedText.trim(),
+    };
+}

package/build/src/lib/sourceLoc.d.ts

@@ -0,0 +1,4 @@
+import type { ParsedSourceLoc } from "./types";
+export declare function parseSourceLoc(raw: string): ParsedSourceLoc;
+export declare function normalizeTextForComparison(value: string): string;
+//# sourceMappingURL=sourceLoc.d.ts.map

package/build/src/lib/sourceLoc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sourceLoc.d.ts","sourceRoot":"","sources":["../../../src/lib/sourceLoc.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAI/C,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CA2B3D;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhE"}

package/build/src/lib/sourceLoc.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseSourceLoc = parseSourceLoc;
+exports.normalizeTextForComparison = normalizeTextForComparison;
+const errors_1 = require("./errors");
+const SOURCE_LOC_PATTERN = /^(?<filePath>.+):(?<line>\d+):(?<column>\d+)$/;
+function parseSourceLoc(raw) {
+    const trimmed = raw.trim();
+    const match = SOURCE_LOC_PATTERN.exec(trimmed);
+    if (!match || !match.groups) {
+        throw new errors_1.SourceInspectorError("INVALID_SOURCE_LOC", "Invalid source location format. Expected path:line:column.");
+    }
+    const filePath = match.groups.filePath;
+    const line = Number(match.groups.line);
+    const column = Number(match.groups.column);
+    if (!filePath || Number.isNaN(line) || Number.isNaN(column) || line < 1 || column < 1) {
+        throw new errors_1.SourceInspectorError("INVALID_SOURCE_LOC", "Invalid source location values. Line and column must be positive integers.");
+    }
+    return {
+        filePath,
+        line,
+        column,
+    };
+}
+function normalizeTextForComparison(value) {
+    return value.replace(/\s+/g, " ").trim();
+}

package/build/src/lib/types.d.ts

@@ -0,0 +1,44 @@
+export type SourceInspectorErrorCode = "AUTH_REQUIRED" | "UNMAPPED_HOST" | "INVALID_SOURCE_LOC" | "BASE_BRANCH_NOT_FOUND" | "FILE_NOT_FOUND" | "NON_TEXT_NODE" | "TEXT_MISMATCH" | "NO_DIFF" | "PROVIDER_ERROR";
+export interface ProposedChangeInput {
+    sourceLoc: string;
+    tagName: string;
+    selectedText: string;
+    proposedText: string;
+    baseBranch: string;
+    commitSha?: string;
+}
+export interface ParsedSourceLoc {
+    filePath: string;
+    line: number;
+    column: number;
+}
+export interface PreviewChangeSuccess {
+    filePath: string;
+    oldText: string;
+    newText: string;
+    line: number;
+    column: number;
+    tagName: string;
+    branchNamePreview: string;
+}
+export interface CreateDraftPrSuccess {
+    branchName: string;
+    commitSha: string;
+    prNumber: number;
+    prUrl: string;
+}
+export interface ActionFailure {
+    ok: false;
+    code: SourceInspectorErrorCode;
+    message: string;
+}
+export interface ActionSuccess<T> {
+    ok: true;
+    data: T;
+}
+export type ActionResult<T> = ActionSuccess<T> | ActionFailure;
+export interface BranchesSuccess {
+    branches: string[];
+    defaultBaseBranch: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/src/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,wBAAwB,GAChC,eAAe,GACf,eAAe,GACf,oBAAoB,GACpB,uBAAuB,GACvB,gBAAgB,GAChB,eAAe,GACf,eAAe,GACf,SAAS,GACT,gBAAgB,CAAC;AAErB,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,KAAK,CAAC;IACV,IAAI,EAAE,wBAAwB,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,EAAE,EAAE,IAAI,CAAC;IACT,IAAI,EAAE,CAAC,CAAC;CACT;AAED,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC;AAE/D,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;CAC3B"}

package/build/src/lib/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/build/src/lib/workflow.d.ts

@@ -0,0 +1,19 @@
+import { type RepoProvider } from "./githubProvider";
+import { type HostConfigInput } from "./hostConfig";
+import type { BranchesSuccess, CreateDraftPrSuccess, PreviewChangeSuccess, ProposedChangeInput } from "./types";
+export interface ClientRuntimeContext {
+    token: string;
+    runtime?: SourceInspectorRuntimeOptions;
+}
+export interface SourceInspectorRuntimeOptions {
+    host?: string;
+    hostConfig?: HostConfigInput;
+    githubPathPrefix?: string;
+    branchPrefix?: string;
+}
+export declare function getBranches(context: ClientRuntimeContext): Promise<BranchesSuccess>;
+export declare function previewProposedChangeWithProvider(input: ProposedChangeInput, provider: RepoProvider, runtime?: SourceInspectorRuntimeOptions): Promise<PreviewChangeSuccess>;
+export declare function createDraftPrFromProposedChangeWithProvider(input: ProposedChangeInput, provider: RepoProvider, runtime?: SourceInspectorRuntimeOptions): Promise<CreateDraftPrSuccess>;
+export declare function previewProposedChange(input: ProposedChangeInput, context: ClientRuntimeContext): Promise<PreviewChangeSuccess>;
+export declare function createDraftPrFromProposedChange(input: ProposedChangeInput, context: ClientRuntimeContext): Promise<CreateDraftPrSuccess>;
+//# sourceMappingURL=workflow.d.ts.map

package/build/src/lib/workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../../src/lib/workflow.ts"],"names":[],"mappings":"AACA,OAAO,EAAwB,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,cAAc,CAAC;AAGtB,OAAO,KAAK,EACV,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,SAAS,CAAC;AA6EjB,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,6BAA6B,CAAC;CACzC;AAED,MAAM,WAAW,6BAA6B;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAeD,wBAAsB,WAAW,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,eAAe,CAAC,CAkBzF;AAoCD,wBAAsB,iCAAiC,CACrD,KAAK,EAAE,mBAAmB,EAC1B,QAAQ,EAAE,YAAY,EACtB,OAAO,CAAC,EAAE,6BAA6B,GACtC,OAAO,CAAC,oBAAoB,CAAC,CAG/B;AAyBD,wBAAsB,2CAA2C,CAC/D,KAAK,EAAE,mBAAmB,EAC1B,QAAQ,EAAE,YAAY,EACtB,OAAO,CAAC,EAAE,6BAA6B,GACtC,OAAO,CAAC,oBAAoB,CAAC,CAwC/B;AAED,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,mBAAmB,EAC1B,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,oBAAoB,CAAC,CAG/B;AAED,wBAAsB,+BAA+B,CACnD,KAAK,EAAE,mBAAmB,EAC1B,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,oBAAoB,CAAC,CAG/B"}

package/build/src/lib/workflow.js

@@ -0,0 +1,174 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getBranches = getBranches;
+exports.previewProposedChangeWithProvider = previewProposedChangeWithProvider;
+exports.createDraftPrFromProposedChangeWithProvider = createDraftPrFromProposedChangeWithProvider;
+exports.previewProposedChange = previewProposedChange;
+exports.createDraftPrFromProposedChange = createDraftPrFromProposedChange;
+const errors_1 = require("./errors");
+const githubProvider_1 = require("./githubProvider");
+const hostConfig_1 = require("./hostConfig");
+const jsxTextEdit_1 = require("./jsxTextEdit");
+const sourceLoc_1 = require("./sourceLoc");
+function normalizeRepoPath(value) {
+    return value
+        .replace(/\\/g, "/")
+        .replace(/^\/+/, "")
+        .replace(/^\.\/+/, "");
+}
+function resolveGitHubFilePath(sourceFilePath, prefixOverride) {
+    const normalizedSourcePath = normalizeRepoPath(sourceFilePath);
+    const rawPrefix = prefixOverride?.trim() || process.env.NEXT_PUBLIC_SOURCE_INSPECTOR_GITHUB_PATH_PREFIX?.trim() || "";
+    const normalizedPrefix = rawPrefix
+        .replace(/\\/g, "/")
+        .replace(/^\/+/, "")
+        .replace(/\/+$/, "");
+    if (!normalizedPrefix) {
+        return normalizedSourcePath;
+    }
+    if (normalizedSourcePath === normalizedPrefix ||
+        normalizedSourcePath.startsWith(`${normalizedPrefix}/`)) {
+        return normalizedSourcePath;
+    }
+    return `${normalizedPrefix}/${normalizedSourcePath}`;
+}
+function slugifyTag(tagName) {
+    return (tagName
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "") || "element");
+}
+function generateBranchName(tagName, prefixOverride) {
+    const prefix = prefixOverride?.trim() ||
+        process.env.NEXT_PUBLIC_SOURCE_INSPECTOR_BRANCH_PREFIX ||
+        "source-inspector";
+    const timestamp = Date.now();
+    const slug = slugifyTag(tagName);
+    return `${prefix}/${slug}-${timestamp}`;
+}
+function assertValidInput(input) {
+    if (!input.tagName?.trim()) {
+        throw new errors_1.SourceInspectorError("INVALID_SOURCE_LOC", "tagName is required.");
+    }
+    if (!input.sourceLoc?.trim()) {
+        throw new errors_1.SourceInspectorError("INVALID_SOURCE_LOC", "sourceLoc is required.");
+    }
+    if (!input.baseBranch?.trim()) {
+        throw new errors_1.SourceInspectorError("BASE_BRANCH_NOT_FOUND", "baseBranch is required.");
+    }
+    if (!input.selectedText?.trim()) {
+        throw new errors_1.SourceInspectorError("NON_TEXT_NODE", "Selected element does not contain direct text. Select a text element.");
+    }
+    if (!input.proposedText?.trim()) {
+        throw new errors_1.SourceInspectorError("NO_DIFF", "Proposed changes cannot be empty.");
+    }
+}
+function createProviderFromContext(context) {
+    const token = context.token.trim();
+    if (!token) {
+        throw new errors_1.SourceInspectorError("AUTH_REQUIRED", "GitHub token is required.");
+    }
+    const repoConfig = (0, hostConfig_1.resolveRepoConfigForCurrentHost)(context.runtime?.host, context.runtime?.hostConfig);
+    return (0, githubProvider_1.createGitHubProvider)(repoConfig, token);
+}
+async function getBranches(context) {
+    const repoConfig = (0, hostConfig_1.resolveRepoConfigForCurrentHost)(context.runtime?.host, context.runtime?.hostConfig);
+    const provider = (0, githubProvider_1.createGitHubProvider)(repoConfig, context.token);
+    const branches = await provider.listBranches();
+    if (branches.length === 0) {
+        throw new errors_1.SourceInspectorError("BASE_BRANCH_NOT_FOUND", "Repository has no branches.");
+    }
+    const fallback = branches.includes("main") ? "main" : branches[0];
+    return {
+        branches,
+        defaultBaseBranch: repoConfig.defaultBaseBranch || fallback,
+    };
+}
+async function buildPreview(input, provider, runtime) {
+    assertValidInput(input);
+    const parsedSourceLoc = (0, sourceLoc_1.parseSourceLoc)(input.sourceLoc);
+    const repoFilePath = resolveGitHubFilePath(parsedSourceLoc.filePath, runtime?.githubPathPrefix);
+    await provider.getBranchHeadSha(input.baseBranch);
+    const file = await provider.getFileContent(repoFilePath, input.baseBranch);
+    const replacement = (0, jsxTextEdit_1.applyTextReplacement)({
+        sourceCode: file.content,
+        sourceLoc: parsedSourceLoc,
+        tagName: input.tagName,
+        selectedText: input.selectedText,
+        proposedText: input.proposedText,
+    });
+    return {
+        preview: {
+            filePath: repoFilePath,
+            oldText: replacement.oldText,
+            newText: replacement.newText,
+            line: parsedSourceLoc.line,
+            column: parsedSourceLoc.column,
+            tagName: input.tagName,
+            branchNamePreview: generateBranchName(input.tagName, runtime?.branchPrefix),
+        },
+        updatedSourceCode: replacement.updatedSourceCode,
+    };
+}
+async function previewProposedChangeWithProvider(input, provider, runtime) {
+    const { preview } = await buildPreview(input, provider, runtime);
+    return preview;
+}
+function buildPrBody(params) {
+    const lines = [
+        "This draft PR was generated by Source Inspector.",
+        "",
+        `- Source location: \`${params.sourceLoc}\``,
+        `- Base branch: \`${params.baseBranch}\``,
+        `- Old text: \`${params.oldText}\``,
+        `- New text: \`${params.newText}\``,
+    ];
+    if (params.commitSha && params.commitSha !== "unknown") {
+        lines.push(`- Build commit: \`${params.commitSha}\``);
+    }
+    return lines.join("\n");
+}
+async function createDraftPrFromProposedChangeWithProvider(input, provider, runtime) {
+    const { preview, updatedSourceCode } = await buildPreview(input, provider, runtime);
+    const branchName = generateBranchName(input.tagName, runtime?.branchPrefix);
+    const baseSha = await provider.getBranchHeadSha(input.baseBranch);
+    await provider.createBranch(branchName, baseSha);
+    const currentFile = await provider.getFileContent(preview.filePath, input.baseBranch);
+    const commitMessage = `Source Inspector: update ${preview.tagName} text in ${preview.filePath}`;
+    const commit = await provider.updateFile({
+        path: preview.filePath,
+        branch: branchName,
+        sha: currentFile.sha,
+        content: updatedSourceCode,
+        message: commitMessage,
+    });
+    const prTitle = `Source Inspector: update ${preview.tagName} text in ${preview.filePath}`;
+    const prBody = buildPrBody({
+        sourceLoc: input.sourceLoc,
+        oldText: preview.oldText,
+        newText: preview.newText,
+        baseBranch: input.baseBranch,
+        commitSha: input.commitSha,
+    });
+    const pr = await provider.createDraftPullRequest({
+        title: prTitle,
+        body: prBody,
+        head: branchName,
+        base: input.baseBranch,
+    });
+    return {
+        branchName,
+        commitSha: commit.commitSha,
+        prNumber: pr.prNumber,
+        prUrl: pr.prUrl,
+    };
+}
+async function previewProposedChange(input, context) {
+    const provider = createProviderFromContext(context);
+    return previewProposedChangeWithProvider(input, provider, context.runtime);
+}
+async function createDraftPrFromProposedChange(input, context) {
+    const provider = createProviderFromContext(context);
+    return createDraftPrFromProposedChangeWithProvider(input, provider, context.runtime);
+}

package/build/src/plugin.d.ts

@@ -0,0 +1,9 @@
+import type { OverlayPlugin } from "@deshlo/core/overlay-plugin";
+import { type SourceInspectorRuntimeOptions } from "./lib/workflow";
+export interface GitHubBrowserPluginConfig extends SourceInspectorRuntimeOptions {
+    token?: string;
+    baseBranch?: string;
+}
+export declare function createGitHubBrowserPlugin(config?: GitHubBrowserPluginConfig): OverlayPlugin;
+export type { SourceInspectorRuntimeOptions };
+//# sourceMappingURL=plugin.d.ts.map

package/build/src/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EAId,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EAGL,KAAK,6BAA6B,EACnC,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,yBAA0B,SAAQ,6BAA6B;IAC9E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AA8CD,wBAAgB,yBAAyB,CACvC,MAAM,GAAE,yBAA8B,GACrC,aAAa,CAoDf;AAED,YAAY,EAAE,6BAA6B,EAAE,CAAC"}

package/build/src/plugin.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createGitHubBrowserPlugin = createGitHubBrowserPlugin;
+const errors_1 = require("./lib/errors");
+const workflow_1 = require("./lib/workflow");
+function resolveToken(config) {
+    return (config.token?.trim() ||
+        process.env.NEXT_PUBLIC_SOURCE_INSPECTOR_GITHUB_TOKEN?.trim() ||
+        "");
+}
+function resolveHost(context, config) {
+    return config.host || context.host || "unknown";
+}
+function toErrorResult(error) {
+    if (error instanceof errors_1.SourceInspectorError) {
+        return {
+            ok: false,
+            message: `${error.code}: ${error.message}`,
+        };
+    }
+    if (error instanceof Error) {
+        return {
+            ok: false,
+            message: `PROVIDER_ERROR: ${error.message}`,
+        };
+    }
+    return {
+        ok: false,
+        message: "PROVIDER_ERROR: Unexpected provider error.",
+    };
+}
+function toProposedChangeInput(input, baseBranch) {
+    return {
+        sourceLoc: input.sourceLoc,
+        tagName: input.tagName,
+        selectedText: input.selectedText,
+        proposedText: input.proposedText,
+        commitSha: input.commitSha,
+        baseBranch,
+    };
+}
+function createGitHubBrowserPlugin(config = {}) {
+    return {
+        id: "github-browser",
+        async submit(input, context) {
+            const token = resolveToken(config);
+            if (!token) {
+                return {
+                    ok: false,
+                    message: "AUTH_REQUIRED: Configure NEXT_PUBLIC_SOURCE_INSPECTOR_GITHUB_TOKEN or pass token.",
+                };
+            }
+            const runtime = {
+                ...config,
+                host: resolveHost(context, config),
+            };
+            try {
+                const baseBranch = config.baseBranch ||
+                    (await (0, workflow_1.getBranches)({
+                        token,
+                        runtime,
+                    })).defaultBaseBranch;
+                const result = await (0, workflow_1.createDraftPrFromProposedChange)(toProposedChangeInput(input, baseBranch), {
+                    token,
+                    runtime,
+                });
+                return {
+                    ok: true,
+                    message: `Draft PR #${result.prNumber} created on branch ${result.branchName}.`,
+                    links: [
+                        {
+                            label: `Open PR #${result.prNumber}`,
+                            url: result.prUrl,
+                        },
+                    ],
+                };
+            }
+            catch (error) {
+                return toErrorResult(error);
+            }
+        },
+    };
+}