@dxos/plugin-github 0.7.4 → 0.13.0

package/dist/types/src/containers/PullRequestsArticle/arrange.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrange.d.ts","sourceRoot":"","sources":["../../../../../src/containers/PullRequestsArticle/arrange.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,OAAO,EAAE,WAAW,EAAE,KAAK,IAAI,EAAE,MAAM,aAAa,CAAC;AAErD,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,KAAK,KAAK,gBAAgB,MAAM,iCAAiC,CAAC;AAEzE,uFAAuF;AACvF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,EAAE,EAAE,eAAe,CAAC,OAAO,CAAC;IAC5B,MAAM,EAAE,eAAe,CAAC,WAAW,CAAC;IACpC,MAAM,EAAE,eAAe,CAAC,WAAW,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,kHAAkH;AAClH,MAAM,MAAM,cAAc,GAAG;IAC3B,WAAW,EAAE,WAAW,CAAC,WAAW,CAAC;IACrC,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,KAAK,EAAE,SAAS,IAAI,CAAC,IAAI,EAAE,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,0FAA0F;IAC1F,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,cAAc,EAAE,CAAC;CACjC,CAAC;AAUF,4FAA4F;AAC5F,eAAO,MAAM,UAAU,SAAU,SAAS,cAAc,EAAE,WAAW,MAAM,CAAC,GAAG,KAAG,SAAS,cAAc,EACA,CAAC;AAI1G;;;;GAIG;AACH,eAAO,MAAM,SAAS,mCAAoC,cAAc,KAAG,MAoB1E,CAAC;AA0BF,8DAA8D;AAC9D,eAAO,MAAM,QAAQ,SAAU,SAAS,cAAc,EAAE,QAAQ,gBAAgB,CAAC,IAAI,KAAG,SAAS,cAAc,EAQ9G,CAAC;AASF,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,CAKvD,CAAC;AASF,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,CAK1D,CAAC;AA0BF;;;GAGG;AACH,eAAO,MAAM,SAAS,SACd,SAAS,cAAc,EAAE,SACxB,gBAAgB,CAAC,UAAU,KACjC,mBAAmB,EAAE,GAAG,SAwE1B,CAAC"}

package/dist/types/src/containers/PullRequestsArticle/arrange.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=arrange.test.d.ts.map

package/dist/types/src/containers/PullRequestsArticle/arrange.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrange.test.d.ts","sourceRoot":"","sources":["../../../../../src/containers/PullRequestsArticle/arrange.test.ts"],"names":[],"mappings":""}

package/dist/types/src/containers/PullRequestsArticle/format.d.ts

@@ -0,0 +1,3 @@
+/** `5 minutes ago`, `yesterday`, `3 weeks ago` — in the largest unit that fits; empty for an invalid date. */
+export declare const formatRelative: (value: string, now?: number) => string;
+//# sourceMappingURL=format.d.ts.map

package/dist/types/src/containers/PullRequestsArticle/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../../../src/containers/PullRequestsArticle/format.ts"],"names":[],"mappings":"AAgBA,8GAA8G;AAC9G,eAAO,MAAM,cAAc,UAAW,MAAM,mBAAqB,MAahE,CAAC"}

package/dist/types/src/containers/PullRequestsArticle/index.d.ts

@@ -0,0 +1,2 @@
+export { PullRequestsArticle as default } from './PullRequestsArticle.tsx';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/src/containers/PullRequestsArticle/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/containers/PullRequestsArticle/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,mBAAmB,IAAI,OAAO,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/types/src/containers/WalkthroughArticle/WalkthroughArticle.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+import type * as AppSurface from '@dxos/app-toolkit/AppSurface';
+import { type Walkthrough } from '#types';
+export type WalkthroughArticleProps = AppSurface.ObjectArticleProps<Walkthrough.Walkthrough>;
+/**
+ * A walkthrough opened directly — from a search result, or a link written before the pull request
+ * became the subject — shown as the review of the pull request it narrates.
+ *
+ * The ref is resolved to a snapshot and the live object queried back by id: the article writes to
+ * the pull request (approve, comment) through a ref of its own, which a snapshot cannot give.
+ */
+export declare const WalkthroughArticle: ({ subject, ...props }: WalkthroughArticleProps) => React.JSX.Element | null;
+//# sourceMappingURL=WalkthroughArticle.d.ts.map

package/dist/types/src/containers/WalkthroughArticle/WalkthroughArticle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WalkthroughArticle.d.ts","sourceRoot":"","sources":["../../../../../src/containers/WalkthroughArticle/WalkthroughArticle.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,KAAK,UAAU,MAAM,8BAA8B,CAAC;AAKhE,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,QAAQ,CAAC;AAI1C,MAAM,MAAM,uBAAuB,GAAG,UAAU,CAAC,kBAAkB,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;AAE7F;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,0BAA2B,uBAAuB,6BAMhF,CAAC"}

package/dist/types/src/containers/WalkthroughArticle/index.d.ts

@@ -0,0 +1,2 @@
+export { WalkthroughArticle as default } from './WalkthroughArticle.tsx';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/src/containers/WalkthroughArticle/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/containers/WalkthroughArticle/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,kBAAkB,IAAI,OAAO,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/types/src/containers/index.d.ts

@@ -0,0 +1,7 @@
+import { type ComponentType } from 'react';
+export declare const ImportPullRequestDialog: ComponentType<any>;
+export declare const PullRequestCardMenu: ComponentType<any>;
+export declare const PullRequestArticle: ComponentType<any>;
+export declare const PullRequestsArticle: ComponentType<any>;
+export declare const WalkthroughArticle: ComponentType<any>;
+//# sourceMappingURL=index.d.ts.map

package/dist/types/src/containers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/containers/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,aAAa,EAAQ,MAAM,OAAO,CAAC;AAEjD,eAAO,MAAM,uBAAuB,EAAE,aAAa,CAAC,GAAG,CAA4D,CAAC;AACpH,eAAO,MAAM,mBAAmB,EAAE,aAAa,CAAC,GAAG,CAAwD,CAAC;AAC5G,eAAO,MAAM,kBAAkB,EAAE,aAAa,CAAC,GAAG,CAAuD,CAAC;AAC1G,eAAO,MAAM,mBAAmB,EAAE,aAAa,CAAC,GAAG,CAAwD,CAAC;AAC5G,eAAO,MAAM,kBAAkB,EAAE,aAAa,CAAC,GAAG,CAAuD,CAAC"}

package/dist/types/src/errors.d.ts

@@ -0,0 +1,157 @@
+import { BaseError } from '@dxos/errors';
+declare const GitHubRepoUnresolvedError_base: {
+    new (options?: import("@dxos/errors").BaseErrorOptions): {
+        cause?: unknown;
+        stack?: string;
+        name: "GitHubRepoUnresolvedError";
+        context: Record<string, unknown>;
+        readonly message: string;
+        readonly _tag: "GitHubRepoUnresolvedError";
+    };
+    isError(error: unknown): error is Error;
+    name: "GitHubRepoUnresolvedError";
+    is(error: unknown): error is BaseError;
+    wrap(options?: Omit<import("@dxos/errors").BaseErrorOptions, 'cause'> & {
+        ifTypeDiffers?: boolean;
+    }): (error: unknown) => {
+        cause?: unknown;
+        stack?: string;
+        name: "GitHubRepoUnresolvedError";
+        context: Record<string, unknown>;
+        readonly message: string;
+        readonly _tag: "GitHubRepoUnresolvedError";
+    };
+    extend<Name extends string = string>(name: Name, message?: string): any;
+    captureStackTrace(targetObject: object, constructorOpt?: Function): void;
+    prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
+    stackTraceLimit: number;
+};
+/** The binding names no repository: no `externalId` and no GitHub foreign key on the target. */
+export declare class GitHubRepoUnresolvedError extends GitHubRepoUnresolvedError_base {
+}
+declare const GitHubRepoInaccessibleError_base: {
+    new (options?: import("@dxos/errors").BaseErrorOptions): {
+        cause?: unknown;
+        stack?: string;
+        name: "GitHubRepoInaccessibleError";
+        context: Record<string, unknown>;
+        readonly message: string;
+        readonly _tag: "GitHubRepoInaccessibleError";
+    };
+    isError(error: unknown): error is Error;
+    name: "GitHubRepoInaccessibleError";
+    is(error: unknown): error is BaseError;
+    wrap(options?: Omit<import("@dxos/errors").BaseErrorOptions, 'cause'> & {
+        ifTypeDiffers?: boolean;
+    }): (error: unknown) => {
+        cause?: unknown;
+        stack?: string;
+        name: "GitHubRepoInaccessibleError";
+        context: Record<string, unknown>;
+        readonly message: string;
+        readonly _tag: "GitHubRepoInaccessibleError";
+    };
+    extend<Name extends string = string>(name: Name, message?: string): any;
+    captureStackTrace(targetObject: object, constructorOpt?: Function): void;
+    prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
+    stackTraceLimit: number;
+};
+/** The connection's token cannot see the repository the binding names (un-shared or revoked). */
+export declare class GitHubRepoInaccessibleError extends GitHubRepoInaccessibleError_base {
+}
+declare const GitHubPullRequestUnstoredError_base: {
+    new (options?: import("@dxos/errors").BaseErrorOptions): {
+        cause?: unknown;
+        stack?: string;
+        name: "GitHubPullRequestUnstoredError";
+        context: Record<string, unknown>;
+        readonly message: string;
+        readonly _tag: "GitHubPullRequestUnstoredError";
+    };
+    isError(error: unknown): error is Error;
+    name: "GitHubPullRequestUnstoredError";
+    is(error: unknown): error is BaseError;
+    wrap(options?: Omit<import("@dxos/errors").BaseErrorOptions, 'cause'> & {
+        ifTypeDiffers?: boolean;
+    }): (error: unknown) => {
+        cause?: unknown;
+        stack?: string;
+        name: "GitHubPullRequestUnstoredError";
+        context: Record<string, unknown>;
+        readonly message: string;
+        readonly _tag: "GitHubPullRequestUnstoredError";
+    };
+    extend<Name extends string = string>(name: Name, message?: string): any;
+    captureStackTrace(targetObject: object, constructorOpt?: Function): void;
+    prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
+    stackTraceLimit: number;
+};
+/** The pull request is not stored: a preview card mints one in memory, and it has no database. */
+export declare class GitHubPullRequestUnstoredError extends GitHubPullRequestUnstoredError_base {
+}
+declare const GitHubPullRequestReferenceError_base: {
+    new (options?: import("@dxos/errors").BaseErrorOptions): {
+        cause?: unknown;
+        stack?: string;
+        name: "GitHubPullRequestReferenceError";
+        context: Record<string, unknown>;
+        readonly message: string;
+        readonly _tag: "GitHubPullRequestReferenceError";
+    };
+    isError(error: unknown): error is Error;
+    name: "GitHubPullRequestReferenceError";
+    is(error: unknown): error is BaseError;
+    wrap(options?: Omit<import("@dxos/errors").BaseErrorOptions, 'cause'> & {
+        ifTypeDiffers?: boolean;
+    }): (error: unknown) => {
+        cause?: unknown;
+        stack?: string;
+        name: "GitHubPullRequestReferenceError";
+        context: Record<string, unknown>;
+        readonly message: string;
+        readonly _tag: "GitHubPullRequestReferenceError";
+    };
+    extend<Name extends string = string>(name: Name, message?: string): any;
+    captureStackTrace(targetObject: object, constructorOpt?: Function): void;
+    prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
+    stackTraceLimit: number;
+};
+/** The text a user typed names no pull request: neither a github.com URL nor `owner/repo#123`. */
+export declare class GitHubPullRequestReferenceError extends GitHubPullRequestReferenceError_base {
+}
+declare const GitHubProjectMissingError_base: {
+    new (options?: import("@dxos/errors").BaseErrorOptions): {
+        cause?: unknown;
+        stack?: string;
+        name: "GitHubProjectMissingError";
+        context: Record<string, unknown>;
+        readonly message: string;
+        readonly _tag: "GitHubProjectMissingError";
+    };
+    isError(error: unknown): error is Error;
+    name: "GitHubProjectMissingError";
+    is(error: unknown): error is BaseError;
+    wrap(options?: Omit<import("@dxos/errors").BaseErrorOptions, 'cause'> & {
+        ifTypeDiffers?: boolean;
+    }): (error: unknown) => {
+        cause?: unknown;
+        stack?: string;
+        name: "GitHubProjectMissingError";
+        context: Record<string, unknown>;
+        readonly message: string;
+        readonly _tag: "GitHubProjectMissingError";
+    };
+    extend<Name extends string = string>(name: Name, message?: string): any;
+    captureStackTrace(targetObject: object, constructorOpt?: Function): void;
+    prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
+    stackTraceLimit: number;
+};
+/** The local Project could not be re-resolved after its upsert. */
+export declare class GitHubProjectMissingError extends GitHubProjectMissingError_base {
+}
+/**
+ * User-facing / persisted diagnostic string for failures from GitHub sync paths.
+ */
+export declare const formatGitHubSyncFailure: (error: unknown) => string;
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/dist/types/src/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/errors.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEzC,gGAAgG;AAChG,qBAAa,yBAA0B,SAAQ,8BAG9C;CAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEJ,iGAAiG;AACjG,qBAAa,2BAA4B,SAAQ,gCAGhD;CAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEJ,kGAAkG;AAClG,qBAAa,8BAA+B,SAAQ,mCAGnD;CAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEJ,kGAAkG;AAClG,qBAAa,+BAAgC,SAAQ,oCAGpD;CAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEJ,mEAAmE;AACnE,qBAAa,yBAA0B,SAAQ,8BAG9C;CAAG;AAEJ;;GAEG;AACH,eAAO,MAAM,uBAAuB,UAAW,OAAO,KAAG,MAmBxD,CAAC"}

package/dist/types/src/extensions/index.d.ts

@@ -0,0 +1,3 @@
+export * from './links.ts';
+export * from './references.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/src/extensions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/extensions/index.ts"],"names":[],"mappings":"AAIA,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}

package/dist/types/src/extensions/links.d.ts

@@ -0,0 +1,21 @@
+import { type Extension } from '@codemirror/state';
+import { type LinkWidgetProps, type WidgetDef } from '@dxos/ui-editor';
+import { type GitHubLink } from '../github-link.ts';
+export * from '../github-link.ts';
+/** A link widget's props, with the URL's parts alongside it. */
+export type GitHubLinkProps<TContext = any> = LinkWidgetProps<TContext> & GitHubLink;
+/** The chip's leading icon for a pull request, in GitHub's open-state green. */
+export declare const PULL_REQUEST_ICON: {
+    icon: string;
+    classNames: string;
+};
+/** The chip icon for a GitHub URL: a pull request's; none for an issue or a repository. */
+export declare const githubLinkIcon: (url: string) => typeof PULL_REQUEST_ICON | undefined;
+export type GitHubLinksOptions = {
+    /** Overrides the default chip's preview trigger. */
+    trigger?: 'hover' | 'click';
+    /** The inline widget for `[label](https://github.com/…/pull/123)`; the anchor chip by default. */
+    link?: WidgetDef<GitHubLinkProps>;
+};
+export declare const githubLinks: ({ trigger, link, }?: GitHubLinksOptions) => Extension;
+//# sourceMappingURL=links.d.ts.map

package/dist/types/src/extensions/links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"links.d.ts","sourceRoot":"","sources":["../../../../src/extensions/links.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAGnD,OAAO,EAAgB,KAAK,eAAe,EAAE,KAAK,SAAS,EAA6B,MAAM,iBAAiB,CAAC;AAEhH,OAAO,EAAe,KAAK,UAAU,EAAmB,MAAM,mBAAmB,CAAC;AAElF,cAAc,mBAAmB,CAAC;AAElC,gEAAgE;AAChE,MAAM,MAAM,eAAe,CAAC,QAAQ,GAAG,GAAG,IAAI,eAAe,CAAC,QAAQ,CAAC,GAAG,UAAU,CAAC;AAErF,gFAAgF;AAChF,eAAO,MAAM,iBAAiB;IAAK,IAAI;IAAmC,UAAU;CAAoB,CAAC;AAEzG,2FAA2F;AAC3F,eAAO,MAAM,cAAc,QAAS,MAAM,KAAG,OAAO,iBAAiB,GAAG,SACD,CAAC;AAExE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,oDAAoD;IACpD,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IAC5B,kGAAkG;IAClG,IAAI,CAAC,EAAE,SAAS,CAAC,eAAe,CAAC,CAAC;CACnC,CAAC;AAeF,eAAO,MAAM,WAAW,wBAYrB,kBAAkB,KAAQ,SAIzB,CAAC"}

package/dist/types/src/extensions/links.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=links.test.d.ts.map

package/dist/types/src/extensions/links.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"links.test.d.ts","sourceRoot":"","sources":["../../../../src/extensions/links.test.ts"],"names":[],"mappings":""}

package/dist/types/src/extensions/references.d.ts

@@ -0,0 +1,23 @@
+import { type Extension } from '@codemirror/state';
+export type GitHubReferenceResolver = (number: number) => string | undefined;
+export type GitHubReferencesOptions = {
+    /**
+     * Target for a reference, or `undefined` to leave it undecorated — which is the answer whenever
+     * the repository is unknown, since `#123` means nothing without one.
+     */
+    resolve: GitHubReferenceResolver;
+};
+/**
+ * Decorates `#123` as a link to the issue or pull request.
+ *
+ * Contributed by this plugin rather than built into the editor: the number resolves against the
+ * repository the space is bound to, which is GitHub-specific knowledge, and a document with no
+ * GitHub binding must render the text unchanged.
+ */
+export declare const githubReferences: ({ resolve }: GitHubReferencesOptions) => Extension;
+/**
+ * The canonical target for a reference. `issues/<n>` is deliberate: GitHub redirects it to the pull
+ * request when the number is one, so a single URL serves both without asking which it is.
+ */
+export declare const referenceUrl: (repo: string, number: number) => string;
+//# sourceMappingURL=references.d.ts.map

package/dist/types/src/extensions/references.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"references.d.ts","sourceRoot":"","sources":["../../../../src/extensions/references.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,SAAS,EAAc,MAAM,mBAAmB,CAAC;AAY/D,MAAM,MAAM,uBAAuB,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;AAE7E,MAAM,MAAM,uBAAuB,GAAG;IACpC;;;OAGG;IACH,OAAO,EAAE,uBAAuB,CAAC;CAClC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,gBAAiB,uBAAuB,KAAG,SAkBrE,CAAC;AA2CJ;;;GAGG;AACH,eAAO,MAAM,YAAY,SAAU,MAAM,UAAU,MAAM,KAAG,MAAuD,CAAC"}

package/dist/types/src/extensions/references.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=references.test.d.ts.map

package/dist/types/src/extensions/references.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"references.test.d.ts","sourceRoot":"","sources":["../../../../src/extensions/references.test.ts"],"names":[],"mappings":""}

package/dist/types/src/github-link.d.ts

@@ -0,0 +1,29 @@
+/**
+ * `https://github.com/owner/repo`, `/pull/123` or `/issues/123`, with an optional trailing slash,
+ * fragment or query. A path below the repository (`/blob/…`, `/actions`) is a page, not an object.
+ */
+export declare const GITHUB_LINK: RegExp;
+export type GitHubLink = {
+    owner: string;
+    repo: string;
+    kind: 'repo' | 'pull' | 'issue';
+    /** Absent for a repository. */
+    number?: number;
+    url: string;
+};
+/** The parts of a pull request or issue URL, or undefined for any other URL. */
+export declare const parseGitHubLink: (url: string) => GitHubLink | undefined;
+/** A pull request named by its coordinates, however the user wrote it. */
+export type PullRequestReference = {
+    owner: string;
+    repo: string;
+    number: number;
+};
+/**
+ * The pull request a user's text names: a github.com URL or `owner/repo#123`.
+ *
+ * An `/issues/123` URL is accepted alongside `/pull/123` because GitHub itself serves a pull
+ * request under both, and a reader who copied the wrong one still means the same change.
+ */
+export declare const parsePullRequestReference: (value: string) => PullRequestReference | undefined;
+//# sourceMappingURL=github-link.d.ts.map

package/dist/types/src/github-link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-link.d.ts","sourceRoot":"","sources":["../../../src/github-link.ts"],"names":[],"mappings":"AAQA;;;GAGG;AACH,eAAO,MAAM,WAAW,QACoF,CAAC;AAE7G,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAChC,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,eAAe,QAAS,MAAM,KAAG,UAAU,GAAG,SAU1D,CAAC;AAQF,0EAA0E;AAC1E,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,UAAW,MAAM,KAAG,oBAAoB,GAAG,SAahF,CAAC"}

package/dist/types/src/hooks/index.d.ts

@@ -1,3 +1,6 @@
-export * from './useDocGhId';
-export * from './useGhIdFromUrl';
+export * from './useOpenObject.ts';
+export * from './usePullRequestFiles.ts';
+export * from './usePullRequestDiff.ts';
+export * from './useSyncPullRequest.ts';
+export * from './usePullRequestChecks.ts';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/src/hooks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/hooks/index.ts"],"names":[],"mappings":"AAIA,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/hooks/index.ts"],"names":[],"mappings":"AAIA,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC"}

package/dist/types/src/hooks/useOpenObject.d.ts

@@ -0,0 +1,9 @@
+import { Obj } from '@dxos/echo';
+/**
+ * Opens a stored object as a plank.
+ *
+ * An object stored moments ago has no graph node yet, and the deck cannot open a node it cannot
+ * find; expanding only asks the connectors, so wait for the node to land.
+ */
+export declare const useOpenObject: () => ((object: Obj.Any) => Promise<void>);
+//# sourceMappingURL=useOpenObject.d.ts.map

package/dist/types/src/hooks/useOpenObject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useOpenObject.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useOpenObject.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAOjC;;;;;GAKG;AACH,eAAO,MAAM,aAAa,QAAO,CAAC,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAqBnE,CAAC"}

package/dist/types/src/hooks/usePullRequestChecks.d.ts

@@ -0,0 +1,10 @@
+import { type SpaceId } from '@dxos/keys';
+import { type PullRequest } from '@dxos/types';
+import { type PullRequestChecks } from '../containers/PullRequestsArticle/arrange.ts';
+/**
+ * The CI and review standing of every live pull request in `pullRequests`, keyed by object id and
+ * filled in as each read lands. Finished pull requests are not read: their checks no longer ask
+ * anything of the reader.
+ */
+export declare const usePullRequestChecks: (pullRequests: readonly PullRequest.PullRequest[], spaceId: SpaceId | undefined) => ReadonlyMap<string, PullRequestChecks>;
+//# sourceMappingURL=usePullRequestChecks.d.ts.map

package/dist/types/src/hooks/usePullRequestChecks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePullRequestChecks.d.ts","sourceRoot":"","sources":["../../../../src/hooks/usePullRequestChecks.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAI/C,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,8CAA8C,CAAC;AActF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,iBACjB,SAAS,WAAW,CAAC,WAAW,EAAE,WACvC,OAAO,GAAG,SAAS,KAC3B,WAAW,CAAC,MAAM,EAAE,iBAAiB,CA4CvC,CAAC"}

package/dist/types/src/hooks/usePullRequestDiff.d.ts

@@ -0,0 +1,12 @@
+import { type Ref } from '@dxos/echo';
+import { type SpaceId } from '@dxos/keys';
+import { type PullRequest } from '@dxos/types';
+export type PullRequestDiff = {
+    diff?: string;
+    /** Head commit the diff was read at, which a line comment on it must name. */
+    commit?: string;
+    error?: Error;
+};
+/** Reads a pull request's diff through the space's GitHub connection, once `enabled` first turns true. */
+export declare const usePullRequestDiff: (pullRequest: Ref.Ref<PullRequest.PullRequest>, spaceId: SpaceId | undefined, enabled: boolean) => PullRequestDiff;
+//# sourceMappingURL=usePullRequestDiff.d.ts.map

package/dist/types/src/hooks/usePullRequestDiff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePullRequestDiff.d.ts","sourceRoot":"","sources":["../../../../src/hooks/usePullRequestDiff.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,GAAG,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAI/C,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf,CAAC;AAEF,0GAA0G;AAC1G,eAAO,MAAM,kBAAkB,gBAChB,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,WAAW,CAAC,WACpC,OAAO,GAAG,SAAS,WACnB,OAAO,KACf,eA8BF,CAAC"}

package/dist/types/src/hooks/usePullRequestFiles.d.ts

@@ -0,0 +1,22 @@
+import { type FileNode } from '../components/PullRequestFiles/files.ts';
+import { type PatchFile } from '../walkthrough/patch.ts';
+export type PullRequestFiles = {
+    tree?: FileNode;
+    files: PatchFile[];
+    /** The file on screen. */
+    file?: PatchFile;
+    reviewed: ReadonlySet<string>;
+    select: (path: string) => void;
+    /** Moves to the file `delta` places away in tree order; a no-op past either end. */
+    step: (delta: number) => void;
+    setReviewed: (path: string, reviewed: boolean) => void;
+};
+/**
+ * A pull request's changed files, the one on screen, and which the reader has reviewed.
+ *
+ * Reviewed state is the reader's own, so it lives in their browser under `storageKey` rather than in
+ * the space. A file is reviewed at the change it had when checked: a push that changes it unchecks
+ * it, as GitHub's "Viewed" does.
+ */
+export declare const usePullRequestFiles: (diff: string | undefined, storageKey: string) => PullRequestFiles;
+//# sourceMappingURL=usePullRequestFiles.d.ts.map

package/dist/types/src/hooks/usePullRequestFiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePullRequestFiles.d.ts","sourceRoot":"","sources":["../../../../src/hooks/usePullRequestFiles.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,QAAQ,EAA8C,MAAM,yCAAyC,CAAC;AACpH,OAAO,EAAE,KAAK,SAAS,EAAc,MAAM,yBAAyB,CAAC;AAErE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,0BAA0B;IAC1B,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC9B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,oFAAoF;IACpF,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;CACxD,CAAC;AAwBF;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,SAAU,MAAM,GAAG,SAAS,cAAc,MAAM,KAAG,gBA6ClF,CAAC"}

package/dist/types/src/hooks/useSyncPullRequest.d.ts

@@ -0,0 +1,10 @@
+import { type PullRequest } from '@dxos/types';
+/**
+ * Refreshes a stored pull request from GitHub when it is shown, since whatever shows it is the moment
+ * its fields are worth trusting: a repository sync may be days old, and an import is never re-synced.
+ *
+ * A pull request held by no database (a link preview) is skipped, as there is nothing to write back to,
+ * and one synced within {@link SYNC_INTERVAL} is skipped too.
+ */
+export declare const useSyncPullRequest: (pullRequest: PullRequest.PullRequest) => void;
+//# sourceMappingURL=useSyncPullRequest.d.ts.map

package/dist/types/src/hooks/useSyncPullRequest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSyncPullRequest.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useSyncPullRequest.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAqB/C;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,gBAAiB,WAAW,CAAC,WAAW,KAAG,IAazE,CAAC"}

package/dist/types/src/index.d.ts

@@ -1,4 +1,4 @@
-import { GithubPlugin } from './GithubPlugin';
-export default GithubPlugin;
-export * from './GithubPlugin';
+export * as GitHubPlugin from './GitHubPlugin.ts';
+export * from '#types';
+export * as Extensions from './Extensions.ts';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,eAAe,YAAY,CAAC;AAE5B,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAC;AAClD,cAAc,QAAQ,CAAC;AACvB,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAC"}

package/dist/types/src/meta.d.ts

@@ -1,13 +1,36 @@
-export declare const GITHUB_PLUGIN = "dxos.org/plugin/github";
-export declare const GITHUB_PLUGIN_SHORT_ID = "github";
-declare const _default: {
-    id: string;
-    shortId: string;
-    name: string;
-    description: string;
-    icon: string;
-    source: string;
-    tags: string[];
+import { DXN } from '@dxos/keys';
+export declare const meta: {
+    readonly profile: {
+        readonly key: string;
+        readonly name: string;
+        readonly description?: string | undefined;
+        readonly homePage?: string | undefined;
+        readonly source?: string | undefined;
+        readonly tags?: readonly string[] | undefined;
+        readonly screenshots?: readonly {
+            readonly light?: string | undefined;
+            readonly dark?: string | undefined;
+        }[] | undefined;
+        readonly icon?: {
+            readonly key: string;
+            readonly hue?: string | undefined;
+        } | undefined;
+        readonly dependsOn?: readonly string[] | undefined;
+        readonly spec?: string | undefined;
+        readonly createdAt?: string | undefined;
+        readonly author?: string | undefined;
+    };
+    readonly release?: {
+        readonly version: string;
+        readonly moduleUrl: string;
+        readonly dependencies?: {
+            readonly [x: string]: string;
+        } | undefined;
+        readonly pluginKey?: string | undefined;
+        readonly manifestHash?: string | undefined;
+        readonly createdAt?: string | undefined;
+    } | undefined;
 };
-export default _default;
+/** The dialog behind the "Import pull request" command. */
+export declare const IMPORT_PULL_REQUEST_DIALOG: DXN.DXN;
 //# sourceMappingURL=meta.d.ts.map

package/dist/types/src/meta.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../../src/meta.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,aAAa,2BAA2B,CAAC;AACtD,eAAO,MAAM,sBAAsB,WAAW,CAAC;;;;;;;;;;AAE/C,wBAQuB"}
+{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../../src/meta.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAIjC,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAmC,CAAC;AAErD,2DAA2D;AAC3D,eAAO,MAAM,0BAA0B,SAA0D,CAAC"}

package/dist/types/src/operations/add-pull-request-comment.d.ts

@@ -0,0 +1,5 @@
+import * as Operation from '@dxos/compute/Operation';
+import { GitHubOperation } from '#types';
+declare const handler: Operation.WithHandler<typeof GitHubOperation.AddPullRequestComment>;
+export default handler;
+//# sourceMappingURL=add-pull-request-comment.d.ts.map

package/dist/types/src/operations/add-pull-request-comment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-pull-request-comment.d.ts","sourceRoot":"","sources":["../../../../src/operations/add-pull-request-comment.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,SAAS,MAAM,yBAAyB,CAAC;AAErD,OAAO,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAKzC,QAAA,MAAM,OAAO,EAAE,SAAS,CAAC,WAAW,CAAC,OAAO,eAAe,CAAC,qBAAqB,CAc9E,CAAC;eAEW,OAAO"}

package/dist/types/src/operations/add-pull-request-review-comment.d.ts

@@ -0,0 +1,5 @@
+import * as Operation from '@dxos/compute/Operation';
+import { GitHubOperation } from '#types';
+declare const handler: Operation.WithHandler<typeof GitHubOperation.AddPullRequestReviewComment>;
+export default handler;
+//# sourceMappingURL=add-pull-request-review-comment.d.ts.map

package/dist/types/src/operations/add-pull-request-review-comment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-pull-request-review-comment.d.ts","sourceRoot":"","sources":["../../../../src/operations/add-pull-request-review-comment.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,SAAS,MAAM,yBAAyB,CAAC;AAErD,OAAO,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAKzC,QAAA,MAAM,OAAO,EAAE,SAAS,CAAC,WAAW,CAAC,OAAO,eAAe,CAAC,2BAA2B,CAepF,CAAC;eAEW,OAAO"}

package/dist/types/src/operations/generate-walkthrough.d.ts

@@ -0,0 +1,11 @@
+import * as Operation from '@dxos/compute/Operation';
+import { GitHubOperation } from '#types';
+/**
+ * Generate a walkthrough of a pull request.
+ *
+ * Only the I/O is here — fetch the pull request, fetch its diff, run the model — because that is the
+ * part a test cannot reach. The decisions live in {@link generateWalkthrough}.
+ */
+declare const handler: Operation.WithHandler<typeof GitHubOperation.GenerateWalkthrough>;
+export default handler;
+//# sourceMappingURL=generate-walkthrough.d.ts.map

package/dist/types/src/operations/generate-walkthrough.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-walkthrough.d.ts","sourceRoot":"","sources":["../../../../src/operations/generate-walkthrough.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,SAAS,MAAM,yBAAyB,CAAC;AAKrD,OAAO,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAgBzC;;;;;GAKG;AACH,QAAA,MAAM,OAAO,EAAE,SAAS,CAAC,WAAW,CAAC,OAAO,eAAe,CAAC,mBAAmB,CAiF5E,CAAC;eAEW,OAAO"}

package/dist/types/src/operations/get-pull-request-diff.d.ts

@@ -0,0 +1,5 @@
+import * as Operation from '@dxos/compute/Operation';
+import { GitHubOperation } from '#types';
+declare const handler: Operation.WithHandler<typeof GitHubOperation.GetPullRequestDiff>;
+export default handler;
+//# sourceMappingURL=get-pull-request-diff.d.ts.map

package/dist/types/src/operations/get-pull-request-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-pull-request-diff.d.ts","sourceRoot":"","sources":["../../../../src/operations/get-pull-request-diff.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,SAAS,MAAM,yBAAyB,CAAC;AAErD,OAAO,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAKzC,QAAA,MAAM,OAAO,EAAE,SAAS,CAAC,WAAW,CAAC,OAAO,eAAe,CAAC,kBAAkB,CAoB3E,CAAC;eAEW,OAAO"}

package/dist/types/src/operations/get-pull-request-status.d.ts

@@ -0,0 +1,5 @@
+import * as Operation from '@dxos/compute/Operation';
+import { GitHubOperation } from '#types';
+declare const handler: Operation.WithHandler<typeof GitHubOperation.GetPullRequestStatus>;
+export default handler;
+//# sourceMappingURL=get-pull-request-status.d.ts.map

package/dist/types/src/operations/get-pull-request-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-pull-request-status.d.ts","sourceRoot":"","sources":["../../../../src/operations/get-pull-request-status.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,SAAS,MAAM,yBAAyB,CAAC;AAGrD,OAAO,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAQzC,QAAA,MAAM,OAAO,EAAE,SAAS,CAAC,WAAW,CAAC,OAAO,eAAe,CAAC,oBAAoB,CAuB7E,CAAC;eAEW,OAAO"}

package/dist/types/src/operations/get-repositories.d.ts

@@ -0,0 +1,13 @@
+import * as Operation from '@dxos/compute/Operation';
+import { GitHubOperation } from '#types';
+/**
+ * Discovery only — list GitHub repositories reachable from the connection's
+ * token. Read-only: NO local Projects are created here. Materialization is
+ * handled by the connector's `materializeTarget` when a binding is created.
+ *
+ * Output is sorted by `full_name` (case-insensitive) so the picker is stable
+ * regardless of GitHub's response order.
+ */
+declare const handler: Operation.WithHandler<typeof GitHubOperation.GetGitHubRepositories>;
+export default handler;
+//# sourceMappingURL=get-repositories.d.ts.map

package/dist/types/src/operations/get-repositories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-repositories.d.ts","sourceRoot":"","sources":["../../../../src/operations/get-repositories.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,SAAS,MAAM,yBAAyB,CAAC;AAGrD,OAAO,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAIzC;;;;;;;GAOG;AACH,QAAA,MAAM,OAAO,EAAE,SAAS,CAAC,WAAW,CAAC,OAAO,eAAe,CAAC,qBAAqB,CA2B9E,CAAC;eAEW,OAAO"}

package/dist/types/src/operations/import-pull-request-from-snapshot.d.ts

@@ -0,0 +1,12 @@
+import * as Operation from '@dxos/compute/Operation';
+import { GitHubOperation } from '#types';
+/**
+ * Import the pull request the extension's page is showing.
+ *
+ * The snapshot is read for its URL alone — the page's DOM says nothing GitHub's API does not say
+ * better — and the import itself is delegated, so the anonymous fallback and the existing-object
+ * check stay in one place.
+ */
+declare const handler: Operation.WithHandler<typeof GitHubOperation.ImportPullRequestFromSnapshot>;
+export default handler;
+//# sourceMappingURL=import-pull-request-from-snapshot.d.ts.map