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

package/package.json

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

@@ -54,6 +54,8 @@ interface Repo {
     empty: boolean;
     capabilities: string[];
     readOnly?: boolean;
+    /** The caller's collaborator permission on this repository (read, write or maintain), if any. */
+    collaborator?: string;
     createdAt?: string;
 }
 interface GitPerson {
@@ -149,6 +151,27 @@ interface Blob {
     rawUrl?: string;
     downloadUrl?: string;
     lastCommit?: Commit;
+    /** The file as it is (asked for by the editor; UTF-8 text shown in full). */
+    text?: string;
+}
+interface CommitRequest {
+    branch: string;
+    from?: string;
+    expect?: string;
+    files?: Record<string, string>;
+    uploads?: Record<string, string>;
+    deletes?: string[];
+    pull?: {
+        title?: string;
+        body?: string;
+    };
+    message: string;
+}
+interface CommitResult {
+    branch: string;
+    commit: Commit;
+    created: boolean;
+    pull?: number;
 }
 interface BlameHunk {
     commit: string;
@@ -175,6 +198,15 @@ interface Ref {
     merged: boolean;
     canDelete: boolean;
 }
+/** A repository collaborator (DEV-06): access beyond the project role, for one repository. */
+interface Collaborator {
+    repoId: string;
+    userId: string;
+    permission: 'read' | 'write' | 'maintain';
+    projectRole: string;
+    addedBy: string;
+    createdAt: string;
+}
 /** A file on a release (DEV-15). */
 interface ReleaseAsset {
     id: string;
@@ -389,7 +421,9 @@ declare class CodeApi {
     updateProtection(project: string, name: string, id: string, p: Partial<Protection>): Observable<Protection>;
     removeProtection(project: string, name: string, id: string): Observable<unknown>;
     tree(project: string, name: string, ref: string, path: string): Observable<Tree>;
-    blob(project: string, name: string, ref: string, path: string): Observable<Blob>;
+    blob(project: string, name: string, ref: string, path: string, withText?: boolean): Observable<Blob>;
+    /** A commit from the browser (DEV-13): files, base64 uploads and deletes; from a new branch it can open a pull request. */
+    commitFiles(project: string, name: string, body: CommitRequest): Observable<CommitResult>;
     blame(project: string, name: string, ref: string, path: string): Observable<BlameHunk[]>;
     files(project: string, name: string, ref: string): Observable<{
         files: string[];
@@ -411,6 +445,9 @@ declare class CodeApi {
     }): 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[]>;
+    collaborators(project: string, name: string): Observable<Collaborator[]>;
+    setCollaborator(project: string, name: string, userId: string, permission: string): Observable<Collaborator>;
+    removeCollaborator(project: string, name: string, userId: string): Observable<unknown>;
     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[]>;
@@ -524,6 +561,8 @@ declare abstract class RepoPage {
     protected readonly people: _angular_core.Signal<People>;
     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. */
+    protected readonly canMaintain: _angular_core.Signal<boolean>;
     protected readonly canProtect: _angular_core.Signal<boolean>;
     constructor();
     /** Called with the repository once it has loaded (and again after it changes). */
@@ -696,6 +735,7 @@ declare class RepoHomePage extends RepoPage {
     protected readonly path: _angular_core.WritableSignal<string>;
     protected readonly proto: _angular_core.WritableSignal<"https" | "ssh">;
     protected readonly cloneOpen: _angular_core.WritableSignal<boolean>;
+    protected readonly addOpen: _angular_core.WritableSignal<boolean>;
     protected readonly copied: _angular_core.WritableSignal<boolean>;
     protected readonly finding: _angular_core.WritableSignal<boolean>;
     protected readonly fq: _angular_core.WritableSignal<string>;
@@ -729,6 +769,34 @@ declare class RepoHomePage extends RepoPage {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<RepoHomePage, "o-code-repo", never, {}, {}, never, never, true, never>;
 }
 
+/** Where a web commit goes: onto the branch, or onto a new branch with a pull request. */
+interface CommitChoice {
+    message: string;
+    /** Set for a new branch (with a pull request into the current one). */
+    newBranch?: string;
+}
+/** Whether a branch protection pattern names the branch (as code's protect.Match: * within a segment, ** across). */
+declare function matchesPattern(pattern: string, branch: string): boolean;
+declare class CommitBox {
+    private readonly api;
+    private readonly host;
+    readonly repo: _angular_core.InputSignal<string>;
+    readonly branch: _angular_core.InputSignal<string>;
+    readonly defaultMessage: _angular_core.InputSignal<string>;
+    readonly busy: _angular_core.InputSignal<boolean>;
+    readonly commit: _angular_core.OutputEmitterRef<CommitChoice>;
+    readonly cancel: _angular_core.OutputEmitterRef<void>;
+    protected readonly message: _angular_core.WritableSignal<string>;
+    protected readonly toNew: _angular_core.WritableSignal<boolean>;
+    protected readonly newBranch: _angular_core.WritableSignal<string>;
+    private readonly rules;
+    protected readonly blocked: _angular_core.Signal<boolean>;
+    constructor();
+    protected send(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CommitBox, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CommitBox, "o-commit-box", never, { "repo": { "alias": "repo"; "required": true; "isSignal": true; }; "branch": { "alias": "branch"; "required": true; "isSignal": true; }; "defaultMessage": { "alias": "defaultMessage"; "required": false; "isSignal": true; }; "busy": { "alias": "busy"; "required": false; "isSignal": true; }; }, { "commit": "commit"; "cancel": "cancel"; }, never, never, true, never>;
+}
+
 declare class FilePage extends RepoPage {
     private readonly router;
     protected readonly blob: _angular_core.WritableSignal<Blob | null>;
@@ -746,8 +814,18 @@ declare class FilePage extends RepoPage {
         path: string;
     }[]>;
     protected readonly meta: _angular_core.Signal<string>;
+    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;
+    /** The branch the view is on ('' for a tag or a commit, which cannot take commits). */
+    protected readonly branch: _angular_core.Signal<string>;
+    protected readonly editable: _angular_core.Signal<boolean>;
     constructor();
     protected onRepo(r: Repo): void;
+    protected startEdit(): void;
+    /** Commits the edit (or the delete), onto the branch or onto a new branch with a pull request. */
+    protected save(c: CommitChoice, del?: boolean): void;
     protected pickRef(ref: string): void;
     protected pickLine(n: number): void;
     protected copyText(): void;
@@ -1006,6 +1084,18 @@ declare class RepoSettingsPage extends RepoPage {
         hint: string;
     }[];
     constructor();
+    protected readonly collabs: _angular_core.WritableSignal<Collaborator[]>;
+    protected readonly perms: {
+        id: string;
+        label: string;
+    }[];
+    protected readonly addable: _angular_core.Signal<_chisquare_tech_origine_ngx_apps_code.CodePerson[]>;
+    protected newCollab: string;
+    protected newPerm: string;
+    protected roleLabel(r: string): string;
+    private loadCollabs;
+    protected setCollab(userId: string, permission: string, adding?: boolean): void;
+    protected removeCollab(userId: string): void;
     protected onRepo(r: Repo): void;
     protected go(s: Section): void;
     protected max0(n: number): number;
@@ -1070,5 +1160,33 @@ declare class ReleasesPage extends RepoPage {
     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 };
+interface Upload {
+    name: string;
+    size: number;
+    b64: string;
+}
+declare class NewFilePage extends RepoPage {
+    private readonly router;
+    protected readonly upload: _angular_core.WritableSignal<boolean>;
+    protected readonly ref: _angular_core.WritableSignal<string>;
+    protected readonly uploads: _angular_core.WritableSignal<Upload[]>;
+    protected readonly busy: _angular_core.WritableSignal<boolean>;
+    protected filePath: string;
+    protected content: string;
+    protected dir: string;
+    protected readonly branch: _angular_core.Signal<string>;
+    protected readonly defaultMessage: _angular_core.Signal<"Add files via upload" | "Create a file">;
+    protected readonly fmt: typeof size;
+    constructor();
+    protected onRepo(_: Repo): void;
+    protected pick(ev: Event): Promise<void>;
+    protected shown(name: string): string;
+    protected drop(name: string): void;
+    protected back(): void;
+    protected save(c: CommitChoice): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NewFilePage, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NewFilePage, "o-code-new-file", never, {}, {}, never, never, true, never>;
+}
+
+export { BranchesPage, CodeApi, CodeHost, 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 };
+export type { BlameHunk, Blob, CheckStatus, CodePerson, CodeProject, Collaborator, Commit, CommitChoice, CommitDetail, CommitRequest, CommitResult, 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 };