@chisquare-tech/origine-ngx-apps-code 0.11.3 → 0.13.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chisquare-tech/origine-ngx-apps-code",
-  "version": "0.11.3",
+  "version": "0.13.0",
   "description": "Origine's Code module screens: repositories, files, commits, branches, pull requests and review, repository settings.",
   "repository": {
     "type": "git",

package/types/chisquare-tech-origine-ngx-apps-code.d.ts

@@ -2,6 +2,7 @@ import * as _angular_core from '@angular/core';
 import { Signal, AfterViewInit } from '@angular/core';
 import { Observable } from 'rxjs';
 import { ActivatedRoute } from '@angular/router';
+import { SafeResourceUrl } from '@angular/platform-browser';
 import * as _chisquare_tech_origine_ngx_apps_code from '@chisquare-tech/origine-ngx-apps-code';
 
 /** A person in the organization, as the host knows them (identity's members). */
@@ -15,7 +16,7 @@ interface CodeProject {
     id: string;
     key: string;
     name: string;
-    /** The caller's capabilities on the project: code.write, protection.manage, resources.manage… */
+    /** The caller's coarse capabilities on the project, from before V4-01. Screens ask can(id). */
     capabilities: string[];
     archivedAt?: string;
 }
@@ -28,6 +29,11 @@ declare abstract class CodeHost {
     abstract readonly projectLoaded: Signal<boolean>;
     abstract readonly people: Signal<CodePerson[]>;
     abstract meId(): string;
+    /**
+     * Whether the caller holds capability id on the project (V4-01): code.push, code.repo.create…
+     * Screens of one repository ask the repository's own caps instead, which add a collaborator row.
+     */
+    abstract can(id: string, env?: 'protected' | 'unprotected'): boolean;
     /** A router link to a path inside the current project ('' is its overview). */
     abstract link(path?: string): string[];
 }
@@ -52,13 +58,67 @@ interface Repo {
     cloneHttps: string;
     cloneSsh: string;
     empty: boolean;
+    /** Coarse capabilities, from before V4-01; screens read caps. */
     capabilities: string[];
+    /** The code capability ids the caller holds on this repository, a collaborator row included (V4-01). */
+    caps?: string[];
     readOnly?: boolean;
     /** Pull requests can be armed to merge once the gate passes (DEV-25). */
     allowAutoMerge?: boolean;
     /** The caller's collaborator permission on this repository (read, write or maintain), if any. */
     collaborator?: string;
     createdAt?: string;
+    /** The repository is a pull mirror of its import source, read-only for pushes (V6-01). */
+    mirror?: boolean;
+}
+/** A repository's pull mirror (V6-01). */
+interface Mirror {
+    source: string;
+    intervalMinutes: number;
+    /** Whom the mirror syncs as: who set it up, or last saved it. */
+    setBy: string;
+    nextSyncAt: string;
+    lastSyncAt?: string;
+    lastSuccessAt?: string;
+    lastError?: string;
+    lfsMissing?: number;
+    hasCredentials: boolean;
+    waiting: boolean;
+    syncing: boolean;
+}
+/** One conflicted file of a pull request, for the resolver (V6-03). */
+interface ConflictFile {
+    path: string;
+    /** content (resolvable here), binary, modify/delete, rename, large, lfs or other. */
+    kind: string;
+    resolvable: boolean;
+    message?: string;
+    base?: string;
+    ours?: string;
+    theirs?: string;
+    merged?: string;
+}
+/** A pull request's conflicts with its target (V6-03). */
+interface Conflicts {
+    number: number;
+    source: string;
+    target: string;
+    headSha: string;
+    baseSha: string;
+    files: ConflictFile[];
+    resolvable: boolean;
+    canResolve: boolean;
+    /** The resolution lands on the head branch; else on a new branch with a pull request into it. */
+    direct: boolean;
+}
+/** Where a resolution went (V6-03). */
+interface Resolution {
+    branch: string;
+    commit: {
+        oid: string;
+        short: string;
+    };
+    pull?: number;
 }
 interface GitPerson {
     name: string;
@@ -172,6 +232,16 @@ interface Blob {
     text?: string;
     /** Set for a Git LFS file: the view (size, lines, links) is of the object. */
     lfs?: LfsObject;
+    /** How the viewer previews the file (V0-21): a CSV or TSV as a table, a PDF in the browser's viewer. */
+    preview?: 'csv' | 'pdf';
+    table?: BlobTable;
+}
+/** A delimited file's first rows (V0-21): the header, up to 1,000 rows, and whether there are more. */
+interface BlobTable {
+    delimiter: string;
+    header: string[];
+    rows: string[][];
+    truncated: boolean;
 }
 interface CommitRequest {
     branch: string;
@@ -289,7 +359,7 @@ interface Protection {
     requireCodeOwnerReview?: boolean;
     requireSignedCommits?: boolean;
     requireLinearHistory?: boolean;
-    /** Roles that may bypass the rule: owner, admin, maintainer. */
+    /** Roles that may bypass the rule: owner, admin, maintainer, or a custom role ("role:<uuid>"). */
     bypass?: string[];
     requiredChecks: string[];
 }
@@ -429,6 +499,16 @@ declare function apiMessage(err: any, fallback?: string): string;
 declare class CodeApi {
     private readonly api;
     private repoPath;
+    /**
+     * Whether this installation signs the commits it makes (DEV-31, D-67): GET /signing-key answers.
+     * A web edit is then signed, so a rule that only asks for signed commits takes it directly.
+     */
+    platformSigns(): Observable<boolean>;
+    /** The organization's custom roles (V4-01), for the bypass list of a branch rule. */
+    customRoles(): Observable<{
+        id: string;
+        name: string;
+    }[]>;
     repos(project: string): Observable<Repo[]>;
     create(project: string, body: {
         name: string;
@@ -446,7 +526,22 @@ declare class CodeApi {
         token?: string;
         description?: string;
         visibility?: string;
+        mirror?: boolean;
+        intervalMinutes?: number;
     }): Observable<Repo>;
+    /** A repository's pull mirror (V6-01). */
+    mirror(project: string, name: string): Observable<Mirror>;
+    /** Changes the mirror's source, credentials or interval; the saver becomes whom it syncs as. */
+    updateMirror(project: string, name: string, body: Partial<{
+        url: string;
+        username: string;
+        token: string;
+        clearCredentials: boolean;
+        intervalMinutes: number;
+    }>): Observable<Mirror>;
+    syncMirror(project: string, name: string): Observable<Mirror>;
+    /** Stops mirroring: an ordinary repository that takes pushes. */
+    stopMirror(project: string, name: string): Observable<Repo>;
     repo(project: string, name: string): Observable<Repo>;
     update(project: string, name: string, body: Partial<{
         name: string;
@@ -548,6 +643,15 @@ declare class CodeApi {
         deleteBranch?: boolean;
         expectHead?: string;
     }): Observable<Pull>;
+    /** A pull request's conflicts with its target, for the resolver (V6-03). */
+    conflicts(project: string, name: string, n: number): Observable<Conflicts>;
+    /** Commits a resolution of the conflicts (V6-03). */
+    resolveConflicts(project: string, name: string, n: number, body: {
+        files: Record<string, string>;
+        message?: string;
+        expectHead: string;
+        expectBase: string;
+    }): Observable<Resolution>;
     conversation(project: string, name: string, n: number): Observable<Timeline>;
     comment(project: string, name: string, n: number, c: NewComment): Observable<PRComment>;
     /** Arms (method) or disarms (null) auto-merge on a pull request (DEV-25). */
@@ -595,6 +699,17 @@ declare class CurrentRepo {
  * component's encapsulation, hence ::ng-deep.
  */
 declare const TOKEN_CSS = "\n  :host ::ng-deep [class^=\"tk-k\"]{color:var(--o-tk-k)}\n  :host ::ng-deep [class^=\"tk-s\"], :host ::ng-deep [class^=\"tk-l\"]{color:var(--o-tk-s)}\n  :host ::ng-deep [class^=\"tk-c\"]{color:var(--o-tk-c);font-style:italic}\n  :host ::ng-deep [class^=\"tk-m\"]{color:var(--o-tk-n)}\n  :host ::ng-deep .tk-nf, :host ::ng-deep .tk-nx, :host ::ng-deep .tk-fm{color:var(--o-tk-f)}\n  :host ::ng-deep .tk-nb, :host ::ng-deep .tk-nt, :host ::ng-deep .tk-bp{color:var(--o-tk-p)}\n  :host ::ng-deep .tk-gi{color:var(--o-add)} :host ::ng-deep .tk-gd{color:var(--o-bad-tx)}\n";
+/** A commit's verification badge (DEV-31, V6-04): commits Origine made read "Verified · Origine". */
+declare function verifyLabel(v: {
+    verified: boolean;
+    signer?: string;
+}): string;
+/** The badge's hover text: whose key signed it, or why it is not verified. */
+declare function verifyTitle(v: {
+    verified: boolean;
+    reason: string;
+    signer?: string;
+}, name: (id: string) => string): string;
 /** Why a signed commit is not verified (DEV-31). */
 declare function verifyWhy(reason: string): string;
 
@@ -614,11 +729,27 @@ declare abstract class RepoPage {
     protected readonly note: _angular_core.WritableSignal<string>;
     protected readonly people: _angular_core.Signal<People>;
     protected readonly verifyWhy: typeof verifyWhy;
+    protected readonly verifyLabel: typeof verifyLabel;
+    protected verifyTitle(v: {
+        verified: boolean;
+        reason: string;
+        signer?: string;
+    }): string;
+    /** Whether the caller holds code capability id on this repository (V4-01): its caps, a collaborator row included. */
+    protected can(id: string): boolean;
+    /** Takes writes: not archived, and not a pull mirror (V6-01). */
+    private readonly live;
     protected readonly canWrite: _angular_core.Signal<boolean>;
-    protected readonly canAdmin: _angular_core.Signal<boolean>;
-    /** Repository settings short of a rename, the visibility and deletion: Maintainers, and maintain collaborators. */
+    /** Every repository setting, a rename and the visibility included. */
+    protected readonly canSettings: _angular_core.Signal<boolean>;
+    /** Repository settings short of a rename and the visibility: the above, and maintain collaborators. */
     protected readonly canMaintain: _angular_core.Signal<boolean>;
+    protected readonly canDelete: _angular_core.Signal<boolean>;
+    protected readonly canCollaborators: _angular_core.Signal<boolean>;
     protected readonly canProtect: _angular_core.Signal<boolean>;
+    protected readonly canRelease: _angular_core.Signal<boolean>;
+    protected readonly canOpenPull: _angular_core.Signal<boolean>;
+    protected readonly canMerge: _angular_core.Signal<boolean>;
     constructor();
     /** Called with the repository once it has loaded (and again after it changes). */
     protected abstract onRepo(repo: Repo): void;
@@ -772,6 +903,8 @@ declare class NewRepoPage {
     protected url_: string;
     protected user: string;
     protected token: string;
+    protected mirror: boolean;
+    protected interval: number;
     constructor();
     protected nameFromUrl(): void;
     protected copyUrl(): void;
@@ -859,11 +992,14 @@ declare class CommitBox {
     protected readonly toNew: _angular_core.WritableSignal<boolean>;
     protected readonly newBranch: _angular_core.WritableSignal<string>;
     private readonly rules;
+    /** Whether the platform signs web commits (GET /signing-key answers). */
+    private readonly signs;
     /** Whether the branch's rules are known yet. */
-    protected readonly rulesState: _angular_core.WritableSignal<"failed" | "loading" | "loaded">;
+    protected readonly rulesState: _angular_core.WritableSignal<"loading" | "loaded" | "failed">;
     /**
      * Direct commits are refused (or may be): the rules block direct pushes, or require signed
-     * commits (a browser commit is unsigned), or they could not be loaded.
+     * commits while the platform signs nothing (a browser commit is then unsigned), or they could not
+     * be loaded.
      */
     protected readonly blocked: _angular_core.Signal<boolean>;
     private rulesFor;
@@ -882,7 +1018,10 @@ declare class FilePage extends RepoPage {
     protected readonly ref: _angular_core.WritableSignal<string>;
     protected readonly path: _angular_core.WritableSignal<string>;
     protected readonly line: _angular_core.WritableSignal<number>;
-    protected readonly view: _angular_core.WritableSignal<"preview" | "code">;
+    protected readonly view: _angular_core.WritableSignal<"code" | "preview">;
+    private readonly sanitizer;
+    /** The PDF's signed raw link, trusted as a frame source: the cookieless raw host serves it inline. */
+    protected readonly pdfUrl: _angular_core.Signal<SafeResourceUrl | null>;
     protected readonly copied: _angular_core.WritableSignal<boolean>;
     protected readonly ago: (s?: string) => string;
     protected readonly initials: typeof initials;
@@ -892,7 +1031,7 @@ declare class FilePage extends RepoPage {
         path: string;
     }[]>;
     protected readonly meta: _angular_core.Signal<string>;
-    protected readonly mode: _angular_core.WritableSignal<"" | "edit" | "delete">;
+    protected readonly mode: _angular_core.WritableSignal<"" | "delete" | "edit">;
     protected readonly text: _angular_core.WritableSignal<string | null>;
     protected readonly busy: _angular_core.WritableSignal<boolean>;
     private readonly branches;
@@ -1050,6 +1189,10 @@ declare class PullPage extends RepoPage {
     protected readonly method: _angular_core.WritableSignal<string>;
     protected readonly delBranch: _angular_core.WritableSignal<boolean>;
     private number;
+    /** The conflict resolver (V6-03): the conflicts, and each file's resolution as edited. */
+    protected readonly resolver: _angular_core.WritableSignal<Conflicts | null>;
+    protected readonly resolved: _angular_core.WritableSignal<Record<string, string>>;
+    protected readonly resolutionReady: _angular_core.Signal<boolean>;
     protected readonly ago: (s?: string) => string;
     protected readonly initials: typeof initials;
     protected readonly dot: typeof checkDot;
@@ -1067,7 +1210,7 @@ declare class PullPage extends RepoPage {
         label: string;
         n: number | undefined;
     }[]>;
-    protected readonly badge: _angular_core.Signal<"" | "Merged" | "Closed" | "Draft" | "Open">;
+    protected readonly badge: _angular_core.Signal<"" | "Open" | "Merged" | "Closed" | "Draft">;
     protected readonly badgeBg: _angular_core.Signal<string>;
     protected readonly approvedByMe: _angular_core.Signal<boolean>;
     protected readonly reviewKinds: _angular_core.Signal<({
@@ -1120,6 +1263,11 @@ declare class PullPage extends RepoPage {
         resolved: boolean;
     }): void;
     protected merge(): void;
+    protected openResolver(): void;
+    protected take(path: string, text: string): void;
+    protected hasMarkers(text?: string): boolean;
+    protected conflictKind(kind: string): string;
+    protected commitResolution(): void;
     protected close(reopen: boolean): void;
     protected outside(e: MouseEvent): void;
     private sendReview;
@@ -1129,7 +1277,7 @@ declare class PullPage extends RepoPage {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<PullPage, "o-code-pull", never, {}, {}, never, never, true, never>;
 }
 
-type Section = 'general' | 'protect' | 'collab' | 'danger';
+type Section = 'general' | 'mirror' | 'protect' | 'collab' | 'danger';
 interface RuleForm {
     id: string;
     pattern: string;
@@ -1172,11 +1320,25 @@ declare class RepoSettingsPage extends RepoPage {
         label: string;
         hint: string;
     }[];
-    protected readonly bypassRoles: {
+    /** Who may bypass a rule: the built-in Owner, Admin and Maintainer, and the organization's custom roles. */
+    private readonly customRoles;
+    protected readonly bypassRoles: _angular_core.Signal<{
         id: string;
         label: string;
-    }[];
+    }[]>;
     constructor();
+    protected readonly ago: typeof ago;
+    protected readonly mirror: _angular_core.WritableSignal<Mirror | null>;
+    protected mf: {
+        url: string;
+        username: string;
+        token: string;
+        interval: number;
+    };
+    private loadMirror;
+    protected syncNow(): void;
+    protected saveMirror(): void;
+    protected stopMirror(): void;
     protected readonly collabs: _angular_core.WritableSignal<Collaborator[]>;
     protected readonly perms: {
         id: string;
@@ -1302,5 +1464,5 @@ declare class CodeSearchPage extends RepoPage {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<CodeSearchPage, "o-code-search", never, {}, {}, never, never, true, never>;
 }
 
-export { BranchesPage, CodeApi, CodeHost, CodeSearchPage, CommitBox, CommitPage, CommitsPage, CurrentRepo, CurrentRepoPage, DiffView, FilePage, NewFilePage, NewRepoPage, People, PullPage, PullsPage, RefPicker, ReleasesPage, RepoHomePage, RepoPage, RepoSettingsPage, ReposPage, TOKEN_CSS, ago, apiMessage, checkDot, copy, dayLabel, initials, langColour, matchesPattern, pair, shortDate, size, verifyWhy };
-export type { BlameHunk, Blob, CheckStatus, CodeHit, CodePerson, CodeProject, Collaborator, Commit, CommitChoice, CommitDetail, CommitRequest, CommitResult, Comparison, DiffHunk, DiffLine, Entry, FileChange, FileDiff, Gate, GateRow, GitPerson, Language, LfsObject, LineComment, NewComment, PRComment, Protection, Pull, PullBrief, Ref, Release, ReleaseAsset, ReleaseInput, Repo, Review, ReviewBrief, SplitRow, Thread, ThreadReply, Timeline, Tree };
+export { BranchesPage, CodeApi, CodeHost, CodeSearchPage, CommitBox, CommitPage, CommitsPage, CurrentRepo, CurrentRepoPage, DiffView, FilePage, NewFilePage, NewRepoPage, People, PullPage, PullsPage, RefPicker, ReleasesPage, RepoHomePage, RepoPage, RepoSettingsPage, ReposPage, TOKEN_CSS, ago, apiMessage, checkDot, copy, dayLabel, initials, langColour, matchesPattern, pair, shortDate, size, verifyLabel, verifyTitle, verifyWhy };
+export type { BlameHunk, Blob, BlobTable, CheckStatus, CodeHit, CodePerson, CodeProject, Collaborator, Commit, CommitChoice, CommitDetail, CommitRequest, CommitResult, Comparison, ConflictFile, Conflicts, DiffHunk, DiffLine, Entry, FileChange, FileDiff, Gate, GateRow, GitPerson, Language, LfsObject, LineComment, Mirror, NewComment, PRComment, Protection, Pull, PullBrief, Ref, Release, ReleaseAsset, ReleaseInput, Repo, Resolution, Review, ReviewBrief, SplitRow, Thread, ThreadReply, Timeline, Tree };