@chisquare-tech/origine-ngx-apps-code 0.1.0 → 0.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chisquare-tech/origine-ngx-apps-code",
-  "version": "0.1.0",
+  "version": "0.3.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

@@ -1,7 +1,8 @@
 import * as _angular_core from '@angular/core';
-import { Signal } from '@angular/core';
+import { Signal, AfterViewInit } from '@angular/core';
 import { Observable } from 'rxjs';
 import { ActivatedRoute } from '@angular/router';
+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). */
 interface CodePerson {
@@ -174,6 +175,43 @@ interface Ref {
     merged: boolean;
     canDelete: boolean;
 }
+/** A file on a release (DEV-15). */
+interface ReleaseAsset {
+    id: string;
+    releaseId: string;
+    name: string;
+    size: number;
+    mediaType: string;
+    createdBy: string;
+    createdAt: string;
+}
+/** A release: a tag with a title, Markdown notes and files; a draft until published. */
+interface Release {
+    id: string;
+    repoId: string;
+    tag: string;
+    targetSha: string;
+    short: string;
+    title: string;
+    notes: string;
+    draft: boolean;
+    prerelease: boolean;
+    latest: boolean;
+    createdBy: string;
+    createdAt: string;
+    publishedAt: string | null;
+    version: number;
+    assets: ReleaseAsset[];
+}
+interface ReleaseInput {
+    tag?: string;
+    target?: string;
+    title?: string;
+    notes?: string;
+    draft?: boolean;
+    prerelease?: boolean;
+    version?: number;
+}
 interface Protection {
     id: string;
     repoId: string;
@@ -367,9 +405,24 @@ declare class CodeApi {
     }): Observable<Commit[]>;
     commit(project: string, name: string, sha: string): Observable<CommitDetail>;
     /** One file's hunks from base to head ("" base: the head's first parent). */
-    diff(project: string, name: string, head: string, path: string, base?: string): Observable<FileDiff>;
+    diff(project: string, name: string, head: string, path: string, base?: string, opts?: {
+        context?: number;
+        ignoreSpace?: boolean;
+    }): Observable<FileDiff>;
     compare(project: string, name: string, base: string, head: string): Observable<Comparison>;
     refs(project: string, name: string, kind?: 'branch' | 'tag', q?: string): Observable<Ref[]>;
+    createTag(project: string, name: string, tag: string, target: string): Observable<Ref>;
+    deleteTag(project: string, name: string, tag: string): Observable<unknown>;
+    releases(project: string, name: string): Observable<Release[]>;
+    createRelease(project: string, name: string, r: ReleaseInput): Observable<Release>;
+    updateRelease(project: string, name: string, id: string, r: ReleaseInput): Observable<Release>;
+    deleteRelease(project: string, name: string, id: string, deleteTag: boolean): Observable<unknown>;
+    /** Notes drafted from the done issues and merged pull requests since the previous release. */
+    releaseNotes(project: string, name: string, target: string, tag?: string): Observable<string>;
+    addAsset(project: string, name: string, id: string, file: File): Observable<ReleaseAsset>;
+    /** A release file's bytes (the download needs the session, so no plain link works). */
+    assetBlob(project: string, name: string, id: string, asset: string): Observable<globalThis.Blob>;
+    deleteAsset(project: string, name: string, id: string, asset: string): Observable<unknown>;
     createBranch(project: string, name: string, branch: string, from: string): Observable<unknown>;
     deleteBranch(project: string, name: string, branch: string): Observable<unknown>;
     deleteMerged(project: string, name: string): Observable<{
@@ -412,6 +465,8 @@ declare class CodeApi {
     }): Observable<Pull>;
     conversation(project: string, name: string, n: number): Observable<Timeline>;
     comment(project: string, name: string, n: number, c: NewComment): Observable<PRComment>;
+    /** Discards one of the caller's pending review comments. */
+    discardComment(project: string, name: string, n: number, id: string): Observable<unknown>;
     review(project: string, name: string, n: number, state: 'commented' | 'approved' | 'changes_requested', body?: string): Observable<Review>;
     resolve(project: string, name: string, n: number, thread: string, on: boolean): Observable<unknown>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CodeApi, never>;
@@ -504,27 +559,47 @@ interface LineComment {
     side: 'old' | 'new';
     line: number;
     body: string;
+    /** Part of the caller's review, posted when it is submitted. */
+    pending: boolean;
 }
 interface ThreadReply {
     threadId: string;
     body: string;
 }
-declare class DiffView {
+/** One row of the split view: the old side and the new side. */
+interface SplitRow {
+    left?: DiffLine;
+    right?: DiffLine;
+}
+declare class DiffView implements AfterViewInit {
     private readonly api;
     private readonly host;
+    private readonly el;
+    private readonly destroyRef;
     readonly repo: _angular_core.InputSignal<string>;
     readonly file: _angular_core.InputSignal<FileChange>;
     readonly head: _angular_core.InputSignal<string>;
     readonly base: _angular_core.InputSignal<string>;
     readonly threads: _angular_core.InputSignal<Thread[]>;
     readonly canComment: _angular_core.InputSignal<boolean>;
+    readonly mode: _angular_core.InputSignal<"unified" | "split">;
+    readonly ignoreSpace: _angular_core.InputSignal<boolean>;
+    /** The file is marked viewed (pull requests); null hides the Viewed button. */
+    readonly viewed: _angular_core.InputSignal<boolean | null>;
+    /** The caller has a pending review on this pull request. */
+    readonly reviewing: _angular_core.InputSignal<boolean>;
     readonly comment: _angular_core.OutputEmitterRef<LineComment>;
     readonly reply: _angular_core.OutputEmitterRef<ThreadReply>;
     readonly resolve: _angular_core.OutputEmitterRef<{
         threadId: string;
         resolved: boolean;
     }>;
+    readonly discard: _angular_core.OutputEmitterRef<string>;
+    readonly viewedChange: _angular_core.OutputEmitterRef<boolean>;
     protected readonly open: _angular_core.WritableSignal<boolean>;
+    protected readonly visible: _angular_core.WritableSignal<boolean>;
+    protected readonly waiting: _angular_core.WritableSignal<boolean>;
+    protected readonly context: _angular_core.WritableSignal<number>;
     protected readonly diff: _angular_core.WritableSignal<FileDiff | null>;
     protected readonly error: _angular_core.WritableSignal<string>;
     protected readonly drafting: _angular_core.WritableSignal<string>;
@@ -532,18 +607,30 @@ declare class DiffView {
     protected readonly replies: _angular_core.WritableSignal<Record<string, string>>;
     protected readonly people: _angular_core.Signal<People>;
     protected readonly threadsHere: _angular_core.Signal<Thread[]>;
+    protected readonly viewable: _angular_core.Signal<boolean>;
+    protected readonly me: _angular_core.Signal<string>;
+    protected readonly splitRows: _angular_core.Signal<SplitRow[][]>;
     protected readonly ago: (s?: string) => string;
+    private asked;
     constructor();
+    ngAfterViewInit(): void;
+    protected load(): void;
+    protected toggleOpen(): void;
+    protected moreContext(): void;
     protected key(l: DiffLine): string;
     protected lineOf(l: DiffLine): number;
+    /** The lines of a split row that threads and drafts hang from (a context line once). */
+    protected rowLines(r: SplitRow): DiffLine[];
     protected threadsAt(l: DiffLine): Thread[];
     protected startComment(l: DiffLine): void;
-    protected send(l: DiffLine): void;
+    protected send(l: DiffLine, pending: boolean): void;
     protected setReply(id: string, v: string): void;
     protected sendReply(id: string): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DiffView, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DiffView, "o-diff", never, { "repo": { "alias": "repo"; "required": true; "isSignal": true; }; "file": { "alias": "file"; "required": true; "isSignal": true; }; "head": { "alias": "head"; "required": true; "isSignal": true; }; "base": { "alias": "base"; "required": false; "isSignal": true; }; "threads": { "alias": "threads"; "required": false; "isSignal": true; }; "canComment": { "alias": "canComment"; "required": false; "isSignal": true; }; }, { "comment": "comment"; "reply": "reply"; "resolve": "resolve"; }, never, ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DiffView, "o-diff", never, { "repo": { "alias": "repo"; "required": true; "isSignal": true; }; "file": { "alias": "file"; "required": true; "isSignal": true; }; "head": { "alias": "head"; "required": true; "isSignal": true; }; "base": { "alias": "base"; "required": false; "isSignal": true; }; "threads": { "alias": "threads"; "required": false; "isSignal": true; }; "canComment": { "alias": "canComment"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "ignoreSpace": { "alias": "ignoreSpace"; "required": false; "isSignal": true; }; "viewed": { "alias": "viewed"; "required": false; "isSignal": true; }; "reviewing": { "alias": "reviewing"; "required": false; "isSignal": true; }; }, { "comment": "comment"; "reply": "reply"; "resolve": "resolve"; "discard": "discard"; "viewedChange": "viewedChange"; }, never, ["*"], true, never>;
 }
+/** Pairs a hunk's lines side by side: context on both sides, a run of removals beside the run of additions that follows it. */
+declare function pair(lines: DiffLine[]): SplitRow[];
 
 declare class ReposPage {
     protected readonly host: CodeHost;
@@ -783,7 +870,7 @@ declare class PullsPage {
 }
 
 type Tab = 'conversation' | 'commits' | 'files' | 'checks';
-interface Event {
+interface Event$1 {
     at: string;
     kind: 'comment' | 'review' | 'thread';
     who: string;
@@ -811,6 +898,13 @@ declare class PullPage extends RepoPage {
     protected readonly initials: typeof initials;
     protected readonly dot: typeof checkDot;
     protected readonly threads: _angular_core.Signal<Thread[]>;
+    protected readonly mode: _angular_core.WritableSignal<"unified" | "split">;
+    protected readonly hideWs: _angular_core.WritableSignal<boolean>;
+    /** Files marked viewed, kept per pull request head in this browser (a new push resets them). */
+    protected readonly viewed: _angular_core.WritableSignal<Record<string, boolean>>;
+    protected readonly viewedCount: _angular_core.Signal<number>;
+    /** The caller's pending review comments (shown only to them until the review is submitted). */
+    protected readonly myPending: _angular_core.Signal<_chisquare_tech_origine_ngx_apps_code.PRComment[]>;
     protected readonly openThreads: _angular_core.Signal<number>;
     protected readonly tabs: _angular_core.Signal<{
         id: Tab;
@@ -838,7 +932,7 @@ declare class PullPage extends RepoPage {
         label: string;
         colour: string;
     }[]>;
-    protected readonly events: _angular_core.Signal<Event[]>;
+    protected readonly events: _angular_core.Signal<Event$1[]>;
     constructor();
     protected onRepo(_: Repo): void;
     protected md(s: string): string;
@@ -852,6 +946,12 @@ declare class PullPage extends RepoPage {
     protected submitReview(): void;
     protected addComment(): void;
     protected lineComment(c: LineComment): void;
+    protected discard(id: string): void;
+    protected setMode(m: 'unified' | 'split'): void;
+    private viewedKey;
+    protected isViewed(path: string): boolean;
+    protected setViewed(path: string, on: boolean): void;
+    protected jump(path: string): void;
     protected reply(r: ThreadReply): void;
     protected resolve(e: {
         threadId: string;
@@ -924,5 +1024,51 @@ declare class RepoSettingsPage extends RepoPage {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<RepoSettingsPage, "o-code-settings", never, {}, {}, never, never, true, never>;
 }
 
-export { BranchesPage, CodeApi, CodeHost, CommitPage, CommitsPage, CurrentRepo, CurrentRepoPage, DiffView, FilePage, NewRepoPage, People, PullPage, PullsPage, RefPicker, RepoHomePage, RepoPage, RepoSettingsPage, ReposPage, TOKEN_CSS, ago, apiMessage, checkDot, copy, dayLabel, initials, langColour, shortDate, size };
-export type { BlameHunk, Blob, CheckStatus, CodePerson, CodeProject, Commit, CommitDetail, Comparison, DiffHunk, DiffLine, Entry, FileChange, FileDiff, Gate, GateRow, GitPerson, Language, LineComment, NewComment, PRComment, Protection, Pull, PullBrief, Ref, Repo, Review, ReviewBrief, Thread, ThreadReply, Timeline, Tree };
+interface Draft {
+    id?: string;
+    version?: number;
+    tag: string;
+    newTag: boolean;
+    target: string;
+    title: string;
+    notes: string;
+    prerelease: boolean;
+    draft: boolean;
+}
+declare class ReleasesPage extends RepoPage {
+    protected readonly releases: _angular_core.WritableSignal<Release[]>;
+    protected readonly tags: _angular_core.WritableSignal<Ref[]>;
+    protected readonly loaded: _angular_core.WritableSignal<boolean>;
+    protected readonly tagging: _angular_core.WritableSignal<boolean>;
+    protected readonly draft: _angular_core.WritableSignal<Draft | null>;
+    protected readonly busy: _angular_core.WritableSignal<boolean>;
+    protected readonly confirming: _angular_core.WritableSignal<string>;
+    protected readonly freeTags: _angular_core.Signal<Ref[]>;
+    protected readonly ago: (s?: string) => string;
+    protected tagName: string;
+    protected tagFrom: string;
+    protected alsoTag: boolean;
+    protected onRepo(r: Repo): void;
+    protected md(s: string): string;
+    protected used(tag: string): boolean;
+    private load;
+    private run;
+    protected createTag(): void;
+    protected removeTag(t: Ref): void;
+    protected startRelease(): void;
+    protected setTag(d: Draft, tag: string): void;
+    protected generate(d: Draft): void;
+    protected edit(r: Release): void;
+    protected save(d: Draft, asDraft: boolean): void;
+    protected remove(rel: Release): void;
+    protected upload(rel: Release, ev: Event): void;
+    protected removeAsset(rel: Release, id: string): void;
+    protected download(rel: Release, id: string, filename: string): void;
+    protected archive(rel: Release, format: 'zip' | 'tar.gz'): void;
+    private save_;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ReleasesPage, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ReleasesPage, "o-code-releases", never, {}, {}, never, never, true, never>;
+}
+
+export { BranchesPage, CodeApi, CodeHost, CommitPage, CommitsPage, CurrentRepo, CurrentRepoPage, DiffView, FilePage, NewRepoPage, People, PullPage, PullsPage, RefPicker, ReleasesPage, RepoHomePage, RepoPage, RepoSettingsPage, ReposPage, TOKEN_CSS, ago, apiMessage, checkDot, copy, dayLabel, initials, langColour, pair, shortDate, size };
+export type { BlameHunk, Blob, CheckStatus, CodePerson, CodeProject, Commit, CommitDetail, Comparison, DiffHunk, DiffLine, Entry, FileChange, FileDiff, Gate, GateRow, GitPerson, Language, LineComment, NewComment, PRComment, Protection, Pull, PullBrief, Ref, Release, ReleaseAsset, ReleaseInput, Repo, Review, ReviewBrief, SplitRow, Thread, ThreadReply, Timeline, Tree };