@things-factory/auth-ui 10.1.6 → 10.1.13

package/dist-client/pages/role/role-list-page.d.ts

@@ -5,25 +5,30 @@ import type { CSSResultGroup } from 'lit';
 import { PageView } from '@operato/shell';
 import type { FetchOption } from '@operato/data-grist';
 /**
- * 역할 목록 — **무엇을 여는 역할인지 목록에서 읽힌다.**
+ * 역할 목록 — **보이는 것과 고칠 수 있는 것을 가른다.**
  *
  * ── 옛 화면이 하던 것 (`pages/role/role-management.ts`) ──────────────────────
  * `quick-find-list` 안에 역할을 늘어놓고, 펼치면 그 안에 이름 입력칸과 84줄의 권한 체크박스가
- * 함께 있었다. 그 구조에서 세 가지가 났다.
+ * 함께 있었다. 그 구조에서 셋이 났다.
  *
  *  ① 이름 입력이 매 글자마다 페이지로 올라가 **모든** 편집기에 공유됐다 — A 를 고치고 B 를
- *     저장하면 B 의 이름이 A 가 됐다. 지금은 `role-detail` 이 자기 이름을 들고 있다.
+ *     저장하면 B 의 이름이 A 가 됐다. 지금은 이름·설명을 격자에서 고친다.
  *  ② 목록에 권한이 하나도 안 보였다. 「이 역할이 무엇을 여나」를 알려면 펼쳐야 했다.
  *  ③ 한도도 쪽 나누기도 없었다.
  *
- * ── 목록이 말해 주는 것 ─────────────────────────────────────────────────────
- * 역할마다 **몇 개의 모듈에서 무엇이 열려 있나**를 요약해 싣는다(`board 읽기·쓰기 · order 읽기`
- * 식). 사용자 관리에서 역할을 고를 때 이름만 보고 고르던 것이 여기서 갈린다.
+ * ── 상속이 이 화면의 중심이다 ───────────────────────────────────────────────
+ * 목록은 부모 도메인의 역할까지 보여 준다 — **부여할 수 있는 범위가 그것**이기 때문이다.
+ * 그런데 그 행은 여기서 못 고친다(`updateRole` 이 `domain.id` 하나로 좁혀 찾는다).
  *
- * ── 상속 ────────────────────────────────────────────────────────────────────
- * 부모 도메인의 역할도 함께 나온다(`inherited: Include`) — 실제로 부여할 수 있는 범위가 그것이기
- * 때문이다. 다만 **부모 것은 여기서 못 고친다**(`updateRole` 의 범위가 내 도메인이다). 그래서
- * 어느 도메인의 역할인지 컬럼으로 말한다.
+ * 전에는 `Include` 로 열어서 **못 고치는 9행이 고칠 수 있는 2행 앞에 깔렸다**(UX 실측).
+ * 지금은 「우리 역할」로 열고, 세 묶음의 수를 함께 적어 **상속이 있다는 사실 자체는 남긴다.**
+ * 편집도 `editable` 함수로 상속 행에서 닫고, 삭제도 상속 행을 안 보낸다.
+ *
+ * ── 권한은 수만 낸다 ────────────────────────────────────────────────────────
+ * 전에는 `activity 쓰기 · activity-instance 쓰기·읽기` 식으로 잘린 코드 용어를 그렸고, 그것을
+ * 그리려고 권한 **행**을 받았다(UX 실측 5,731 bytes · 69ms 대 518 bytes · 7ms). 지금은
+ * `privilegeCount` 하나를 받는다. 권한 편집으로 가는 문은 **버튼 gutter 칸**이 진다 —
+ * 눌리는 숫자는 손잡이로 보이지 않는다.
  */
 declare const RoleListPageBase: (new (...args: any[]) => {
     __preferenceProviders: {
@@ -39,6 +44,16 @@ export declare class RoleListPage extends RoleListPageBase {
     private total;
     private filtered;
     private mySubdomain;
+    private scope;
+    /**
+     * 묶음마다 몇 건인가.
+     *
+     * 수를 함께 적는 이유는 **상속이 있다는 사실 자체가 보이게** 하는 것이다. 기본값을 「우리
+     * 역할」로 좁혀 놓으면, 수가 없으면 상속 9건이 존재하는지조차 모른다.
+     *
+     * `undefined` 는 「아직 못 셌다」다 — 0 으로 메우면 「없다」와 같아 보인다.
+     */
+    private counts;
     private grist;
     /**
      * 저장과 삭제를 **툴바**에 둔다.
@@ -46,15 +61,50 @@ export declare class RoleListPage extends RoleListPageBase {
      * 격자에서 고치는 화면들의 관례다(`fiscal-quarter-list-page` 외). 격자 안 편집은 여러 줄을
      * 한꺼번에 고치므로, 줄마다 저장 단추를 두면 어디를 눌러야 하는지가 사라진다.
      */
+    /**
+     * 찾기는 **제목 줄**에 선다 — 셸이 그 자리를 모든 화면에 같은 모양으로 둔다.
+     *
+     * 이 페이지는 한동안 `ox-filters-form` 을 헤드룸의 칩 줄에 **직접** 끼워 넣고 있었다. 그래서
+     * 돋보기가 범위 칩과 만들기 단추 사이에 끼어, 같은 앱의 다른 목록과 찾기 자리가 달랐다
+     * (`env-var-list-page` 외 auth-ui 목록 다섯이 전부 아래 모양이다).
+     *
+     * 둘은 대안이 아니라 **다른 것**이다 — `search` 는 목록 전체를 훑는 글자 찾기이고,
+     * `filter` 는 칸별 조건 폼을 접었다 펴는 것이다. 표준 화면은 둘 다 선언한다.
+     */
     get context(): {
         title: string;
         help: string;
+        search: {
+            handler: (search: string) => void;
+            value: string;
+        };
+        filter: {
+            handler: () => void;
+        };
         actions: {
             title: string;
             action: () => Promise<void>;
         }[];
     };
     render(): import("lit-html").TemplateResult<1>;
+    /**
+     * 세 묶음.
+     *
+     * **수를 함께 적는 것이 이 부품의 이유다.** 기본값을 「우리 역할」로 좁혀 두면 처음 화면이
+     * 깨끗한 대신 **상속 9건이 있다는 사실이 사라진다.** 수가 그것을 되돌려 놓는다.
+     *
+     * 아직 못 센 묶음은 수를 **안 그린다** — 0 으로 메우면 「없다」와 같아 보인다.
+     */
+    private renderScopes;
+    private onScope;
+    /**
+     * 세 묶음의 건수.
+     *
+     * 세 번 묻는다. 한 번에 셋을 세는 질의가 서버에 없고, 각각 `total` 만 받으므로 가볍다
+     * (UX 실측 158·566·684 bytes). 실패하면 **수를 안 그린다** — 틀린 수를 그리는 것보다
+     * 없는 것이 낫다.
+     */
+    private countScopes;
     /**
      * 목록 위에 겹쳐 그린다 — 격자를 떼면 다시 읽을 길이 없어진다.
      *
@@ -70,13 +120,32 @@ export declare class RoleListPage extends RoleListPageBase {
      * 거절한다. 모를 때는 잠가 두는 쪽이 안전하다.
      */
     private isInherited;
+    /**
+     * 출처 한 칸.
+     *
+     * 「우리」는 조용히 둔다 — 기본 상태에 색을 쓰면 색이 아무것도 말하지 않게 된다.
+     * 상속은 **어느 도메인에서 왔는지 함께 적는다.** 「상속」만 적으면 관리자가 어디로 가야
+     * 하는지 모른다.
+     */
+    private sourceCell;
     pageInitialized(): Promise<void>;
     pageUpdated(_changes: any, _lifecycle: any): Promise<void>;
     /**
-     * 역할과 그 권한을 함께 가져온다.
+     * 역할을 가져온다 — **권한 행은 받지 않는다.**
+     *
+     * 전에는 `privileges { id name category }` 를 함께 물었다. 그것으로 그린 것은 잘린 코드 용어
+     * 셋이었고, 값은 이랬다.
+     *
+     * ```
+     * [UX 실측] 권한 포함  5,731 bytes · 69ms
+     * [UX 실측] 권한 없이    518 bytes ·  7ms
+     * ```
      *
-     * 권한은 `Role.privileges` 필드 리졸버가 역할마다 한 번씩 읽는다. 역할은 도메인마다 열 단위이고
-     * 쪽 나누기가 걸려 있으므로 그 비용을 받아들인다 — 요약을 목록에서 보는 값이 그보다 크다.
+     * 바이트보다 큰 것은 **`Role.privileges` 필드 리졸버가 역할마다 한 번씩 도는 것**이 함께
+     * 없어지는 쪽이다. 지금은 `privilegeCount` 를 받는다 — DB 가 센다(`role-query.ts`).
+     *
+     * `inherited` 는 화면이 고른 묶음을 그대로 넘긴다. 기본값이 「우리 역할」이라 처음 화면에
+     * 못 고치는 행이 안 깔린다.
      */
     fetchHandler({ filters, page, limit, sortings }: FetchOption): Promise<{
         records: any;
@@ -101,6 +170,28 @@ export declare class RoleListPage extends RoleListPageBase {
      * 않고 목록을 다시 읽는다 — 무엇이 남았는지가 화면에서 보이는 것이 맞다.
      */
     private onDeleteGrid;
+    /**
+     * 역할을 만드는 두 문을 **한 자리에** 연다.
+     *
+     * ── 왜 `ox-record-creator`(빈 줄)를 걷어냈나 ────────────────────────────────
+     * 이름을 짓는 것은 쉬운 쪽이고 「품질검사원에게 84개 중 무엇을 주나」가 어려운 쪽인데, 빈
+     * 줄은 그 판단을 통째로 사람에게 넘긴다. 미라텍이 그래서 역할 둘뿐이다.
+     *
+     * 그리고 그 단추는 `.filters` 안에 있었는데 `CommonHeaderStyles` 는 `.actions button` 만
+     * 꾸민다. `.filters` 에 button 규칙이 없어서 **브라우저 기본 단추**가 그대로 나왔다 — 옆의
+     * 알약 범위 단추·검색과 같은 줄에서 혼자 네모난 회색 상자였다. 이 관례를 쓰는 다른 목록
+     * 화면(24 파일)도 전부 같은 상태다.
+     *
+     * ── 순서가 가르친다 ────────────────────────────────────────────────────────
+     * 템플릿이 먼저고 백지가 나중이다. 「품질검사원, 권한 7」을 본 사람은 자리가 어떻게 생긴
+     * 것인지 알고 나서 자기 것을 짓는다. 그렇다고 백지를 감추면 안 된다 — 「야간반장」·「외주
+     * 검사」 같은 자리는 그 공장이 아는 것이지 제품이 아는 게 아니다.
+     */
+    private openCreate;
+    /** 템플릿에서 — 이름은 이 공장이 정한 것을 그대로 보낸다. */
+    createFromTemplate(templateId: string, name: string): Promise<boolean>;
+    /** 백지에서 — 권한 없이 선다. 목록의 권한 수 칸이 0 을 빨갛게 말하므로 다음 걸음이 보인다. */
+    createBlankRole(name: string, description: string): Promise<boolean>;
     /**
      * 새 역할.
      *