@things-factory/worklist 10.1.248 → 10.1.250

package/dist-client/chip-filters.js

@@ -0,0 +1,102 @@
+import gql from 'graphql-tag';
+import { client } from '@operato/graphql';
+import { i18next } from '@operato/i18n';
+import { adjustFilters } from '@operato/utils';
+import { chipCounts } from './chip-counts.js';
+import { ActivityThreadStatus } from './types/activity-thread.js';
+/**
+ * 목록 위의 칩이 무엇을 걸러 내는가 — **한 곳에서 정한다.**
+ *
+ * ── 왜 모았나 (2026-09-02) ─────────────────────────────────────────────────
+ * 「중요」와 「만기」가 다섯 화면에 있는데, 그 뜻이 다섯 곳에 복사돼 있었다.
+ *
+ *   priority gte 2                        5곳
+ *   dueAt lte (지금 + 24 * 3600 * 1000)    4곳
+ *
+ * 한 화면에서 「중요」를 우선순위 3 이상으로 바꾸면 나머지 넷은 2로 남는다. 그러면 **같은 이름의 칩이
+ * 화면마다 다른 것을 걸러 낸다.** 사용자는 그것을 알 방법이 없다.
+ *
+ * ── 칩은 컬럼 필터가 아니다 ────────────────────────────────────────────────
+ * `ox-filters-form` 은 칸 하나와 연산자 하나를 그린다. 이 칩들은 **이름 붙인 조건 묶음**이다 —
+ * 「중요」는 `priority = ?` 가 아니라 `priority >= 2` 이고, 「만기」는 지금 시각에서 계산한다.
+ *
+ * 그래서 사용자가 스스로 만들 수 없다. 「중요 = 우선순위 2 이상」은 제품이 아는 사실이다.
+ *
+ * ── 그러니 그 뜻을 화면이 말해야 한다 ──────────────────────────────────────
+ * 이름만 보이면 눌러 보고 결과를 되짚어야 한다. 칩마다 `hint` 를 함께 낸다(마우스를 올리면 보인다).
+ */
+/** 「중요」의 경계. 이 값 이상이 중요하다. */
+export const IMPORTANT_FROM = 2;
+/** 「만기」의 창. 이 시간 안에 만기가 오는 것. */
+export const DUE_WITHIN_HOURS = 24;
+/*
+ * 연산자를 리터럴로 좁힌다(`as const`). `adjustFilters` 가 받는 타입은 연산자가 정해진 낱말 중
+ * 하나인데, 그 타입이 내보내지지 않아 여기서 가져올 수 없다. `string` 으로 두면 넘길 때 거절된다.
+ */
+/** 우선순위가 경계 이상인 것. */
+export function importantFilters() {
+    return [{ name: 'priority', operator: 'gte', value: IMPORTANT_FROM }];
+}
+/**
+ * 만기가 창 안에 드는 것.
+ *
+ * 부를 때마다 지금 시각으로 계산한다 — 화면을 열어 둔 채 시간이 지나면 「만기 임박」의 범위도 함께
+ * 움직여야 한다.
+ */
+export function dueSoonFilters() {
+    const until = new Date(Date.now() + DUE_WITHIN_HOURS * 3600 * 1000).toISOString().replace('T', ' ');
+    return [{ name: 'dueAt', operator: 'lte', value: until }];
+}
+/** 칩 하나 — 이름과 뜻. */
+export function importantChip() {
+    return {
+        display: i18next.t('label.filter-important'),
+        value: 'important',
+        hint: i18next.t('text.filter-important-hint', { from: IMPORTANT_FROM })
+    };
+}
+export function dueSoonChip() {
+    return {
+        display: i18next.t('label.filter-due'),
+        value: 'due',
+        hint: i18next.t('text.filter-due-hint', { hours: DUE_WITHIN_HOURS })
+    };
+}
+/*
+ * 칩마다 거는 조건 — 화면마다 if 로 따로 적던 것을 여기 한 곳에 둔다. 같은 이름의 칩은 어느 화면에서나 같은 것을
+ * 걸러 낸다(위 「왜 모았나」). 시각에서 계산하는 것은 부를 때마다 지금으로 계산한다.
+ */
+const CONDITIONS = {
+    important: importantFilters,
+    due: dueSoonFilters,
+    proceeding: () => [{ name: 'state', operator: 'eq', value: ActivityThreadStatus.Started }],
+    /* 최근 24시간 이내에 끝낸 일 */
+    recent: () => [{ name: 'terminatedAt', operator: 'gte', value: new Date(Date.now() - 24 * 3600 * 1000).toISOString().replace('T', ' ') }],
+    aborted: () => [{ name: 'state', operator: 'eq', value: ActivityThreadStatus.Aborted }],
+    resubmitted: () => [{ name: 'round', operator: 'gte', value: 2 }],
+    rejected: () => [{ name: 'judgment', operator: 'eq', value: 'rejected' }]
+};
+/** The list's filters with the pressed chips' conditions added. */
+export function withChips(filters, chosen) {
+    const keys = chosen instanceof Array ? chosen : chosen ? [chosen] : [];
+    return keys.reduce((narrowed, key) => (CONDITIONS[key] ? adjustFilters(narrowed, CONDITIONS[key]()) : narrowed), filters);
+}
+/**
+ * How many each chip would show under the list's other conditions (`filters`, without the pressed chip) - the list
+ * door `query` asked for its total once per chip, in one request.
+ */
+export async function countChips(query, keys, filters) {
+    return chipCounts(keys, key => withChips(filters, key), async (sets) => {
+        const response = await client.query({
+            query: gql `
+          query (${sets.map((_, at) => `$f${at}: [Filter!]`).join(', ')}) {
+            ${sets.map((_, at) => `c${at}: ${query}(filters: $f${at}, pagination: { page: 1, limit: 1 }) { total }`).join('\n')}
+          }
+        `,
+            variables: Object.fromEntries(sets.map((set, at) => [`f${at}`, set])),
+            fetchPolicy: 'no-cache'
+        });
+        return sets.map((_, at) => response.data?.[`c${at}`]?.total ?? 0);
+    });
+}
+//# sourceMappingURL=chip-filters.js.map

package/dist-client/chip-filters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chip-filters.js","sourceRoot":"","sources":["../client/chip-filters.ts"],"names":[],"mappings":"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","sourcesContent":["import gql from 'graphql-tag'\n\nimport { client } from '@operato/graphql'\nimport { i18next } from '@operato/i18n'\nimport { adjustFilters } from '@operato/utils'\n\nimport { chipCounts } from './chip-counts.js'\nimport { ActivityThreadStatus } from './types/activity-thread.js'\n\n/**\n * 목록 위의 칩이 무엇을 걸러 내는가 — **한 곳에서 정한다.**\n *\n * ── 왜 모았나 (2026-09-02) ─────────────────────────────────────────────────\n * 「중요」와 「만기」가 다섯 화면에 있는데, 그 뜻이 다섯 곳에 복사돼 있었다.\n *\n *   priority gte 2                        5곳\n *   dueAt lte (지금 + 24 * 3600 * 1000)    4곳\n *\n * 한 화면에서 「중요」를 우선순위 3 이상으로 바꾸면 나머지 넷은 2로 남는다. 그러면 **같은 이름의 칩이\n * 화면마다 다른 것을 걸러 낸다.** 사용자는 그것을 알 방법이 없다.\n *\n * ── 칩은 컬럼 필터가 아니다 ────────────────────────────────────────────────\n * `ox-filters-form` 은 칸 하나와 연산자 하나를 그린다. 이 칩들은 **이름 붙인 조건 묶음**이다 —\n * 「중요」는 `priority = ?` 가 아니라 `priority >= 2` 이고, 「만기」는 지금 시각에서 계산한다.\n *\n * 그래서 사용자가 스스로 만들 수 없다. 「중요 = 우선순위 2 이상」은 제품이 아는 사실이다.\n *\n * ── 그러니 그 뜻을 화면이 말해야 한다 ──────────────────────────────────────\n * 이름만 보이면 눌러 보고 결과를 되짚어야 한다. 칩마다 `hint` 를 함께 낸다(마우스를 올리면 보인다).\n */\n\n/** 「중요」의 경계. 이 값 이상이 중요하다. */\nexport const IMPORTANT_FROM = 2\n\n/** 「만기」의 창. 이 시간 안에 만기가 오는 것. */\nexport const DUE_WITHIN_HOURS = 24\n\n/*\n * 연산자를 리터럴로 좁힌다(`as const`). `adjustFilters` 가 받는 타입은 연산자가 정해진 낱말 중\n * 하나인데, 그 타입이 내보내지지 않아 여기서 가져올 수 없다. `string` 으로 두면 넘길 때 거절된다.\n */\n\n/** 우선순위가 경계 이상인 것. */\nexport function importantFilters() {\n  return [{ name: 'priority', operator: 'gte' as const, value: IMPORTANT_FROM }]\n}\n\n/**\n * 만기가 창 안에 드는 것.\n *\n * 부를 때마다 지금 시각으로 계산한다 — 화면을 열어 둔 채 시간이 지나면 「만기 임박」의 범위도 함께\n * 움직여야 한다.\n */\nexport function dueSoonFilters() {\n  const until = new Date(Date.now() + DUE_WITHIN_HOURS * 3600 * 1000).toISOString().replace('T', ' ')\n\n  return [{ name: 'dueAt', operator: 'lte' as const, value: until }]\n}\n\n/** 칩 하나 — 이름과 뜻. */\nexport function importantChip() {\n  return {\n    display: i18next.t('label.filter-important'),\n    value: 'important',\n    hint: i18next.t('text.filter-important-hint', { from: IMPORTANT_FROM })\n  }\n}\n\nexport function dueSoonChip() {\n  return {\n    display: i18next.t('label.filter-due'),\n    value: 'due',\n    hint: i18next.t('text.filter-due-hint', { hours: DUE_WITHIN_HOURS })\n  }\n}\n\n/*\n * 칩마다 거는 조건 — 화면마다 if 로 따로 적던 것을 여기 한 곳에 둔다. 같은 이름의 칩은 어느 화면에서나 같은 것을\n * 걸러 낸다(위 「왜 모았나」). 시각에서 계산하는 것은 부를 때마다 지금으로 계산한다.\n */\nconst CONDITIONS: Record<string, () => { name: string; operator: any; value: any }[]> = {\n  important: importantFilters,\n  due: dueSoonFilters,\n  proceeding: () => [{ name: 'state', operator: 'eq', value: ActivityThreadStatus.Started }],\n  /* 최근 24시간 이내에 끝낸 일 */\n  recent: () => [{ name: 'terminatedAt', operator: 'gte', value: new Date(Date.now() - 24 * 3600 * 1000).toISOString().replace('T', ' ') }],\n  aborted: () => [{ name: 'state', operator: 'eq', value: ActivityThreadStatus.Aborted }],\n  resubmitted: () => [{ name: 'round', operator: 'gte', value: 2 }],\n  rejected: () => [{ name: 'judgment', operator: 'eq', value: 'rejected' }]\n}\n\n/** The list's filters with the pressed chips' conditions added. */\nexport function withChips(filters: any[], chosen?: string | string[] | null): any[] {\n  const keys = chosen instanceof Array ? chosen : chosen ? [chosen] : []\n  return keys.reduce((narrowed, key) => (CONDITIONS[key] ? adjustFilters(narrowed, CONDITIONS[key]()) : narrowed), filters)\n}\n\n/**\n * How many each chip would show under the list's other conditions (`filters`, without the pressed chip) - the list\n * door `query` asked for its total once per chip, in one request.\n */\nexport async function countChips(query: string, keys: string[], filters: any[]): Promise<Map<string, number>> {\n  return chipCounts(\n    keys,\n    key => withChips(filters, key),\n    async sets => {\n      const response = await client.query({\n        query: gql`\n          query (${sets.map((_, at) => `$f${at}: [Filter!]`).join(', ')}) {\n            ${sets.map((_, at) => `c${at}: ${query}(filters: $f${at}, pagination: { page: 1, limit: 1 }) { total }`).join('\\n')}\n          }\n        `,\n        variables: Object.fromEntries(sets.map((set, at) => [`f${at}`, set])),\n        fetchPolicy: 'no-cache'\n      })\n      return sets.map((_, at) => response.data?.[`c${at}`]?.total ?? 0)\n    }\n  )\n}\n"]}

package/dist-client/components/activity-/bowner-view.d.ts

@@ -0,0 +1 @@
+import '@material/web/button/elevated-button.js';

package/dist-client/components/activity-/bowner-view.js

@@ -0,0 +1,104 @@
+import { __decorate, __metadata } from "tslib";
+import '@material/web/button/elevated-button.js';
+import gql from 'graphql-tag';
+import { css, html, LitElement } from 'lit';
+import { customElement, property } from 'lit/decorators.js';
+import { client } from '@operato/graphql';
+import { i18next, localize } from '@operato/i18n';
+import { ScrollbarStyles } from '@operato/styles';
+let ActivityOwnerView = class ActivityOwnerView extends localize(i18next)(LitElement) {
+    static { this.styles = [
+        ScrollbarStyles,
+        css `
+      :host {
+        display: flex;
+        flex-direction: column;
+
+        background-color: var(--md-sys-color-surface);
+      }
+
+      content {
+        flex: 1;
+        display: flex;
+        flex-direction: column;
+        padding: var(--spacing-medium);
+        overflow: auto;
+      }
+
+      section {
+        display: flex;
+        flex-direction: column;
+      }
+    `
+    ]; }
+    constructor() {
+        super();
+        this.activityInstance = {};
+    }
+    render() {
+        const { name, description, thumbnail } = this.activity || {};
+        return html `
+      <content>
+        <section>
+          <div>name: ${name}</div>
+          <div>description: ${description}</div>
+        </section>
+
+        <section>
+          <img src=${thumbnail} />
+        </section>
+      </content>
+    `;
+    }
+    firstUpdated() {
+        this.fetchActivity(this.activityId);
+    }
+    async fetchActivity(id) {
+        const response = await client.query({
+            query: gql `
+        query activity($id: String!) {
+          activity(id: $id) {
+            id
+            name
+            description
+            state
+            thumbnail
+            model {
+              name
+              description
+              active
+              tag
+              inout
+              type
+              unit
+              options
+              quantifier
+              spec
+            }
+          }
+        }
+      `,
+            variables: {
+                id
+            }
+        });
+        this.activity = response.data.activity;
+    }
+};
+__decorate([
+    property({ type: String }),
+    __metadata("design:type", String)
+], ActivityOwnerView.prototype, "activityId", void 0);
+__decorate([
+    property({ type: Object }),
+    __metadata("design:type", Object)
+], ActivityOwnerView.prototype, "activity", void 0);
+__decorate([
+    property({ type: Object }),
+    __metadata("design:type", Object)
+], ActivityOwnerView.prototype, "activityInstance", void 0);
+ActivityOwnerView = __decorate([
+    customElement('activity-owner-view'),
+    __metadata("design:paramtypes", [])
+], ActivityOwnerView);
+//# sourceMappingURL=activity-%08owner-view.js.map

package/dist-client/components/activity-/bowner-view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity-\bowner-view.js","sourceRoot":"","sources":["../../client/components/activity-\bowner-view.ts"],"names":[],"mappings":";AAAA,OAAO,yCAAyC,CAAA;AAEhD,OAAO,GAAG,MAAM,aAAa,CAAA;AAC7B,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,KAAK,CAAA;AAC3C,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAE3D,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACzC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAEjD,IACM,iBAAiB,GADvB,MACM,iBAAkB,SAAQ,QAAQ,CAAC,OAAO,CAAC,CAAC,UAAU,CAAC;aACpD,WAAM,GAAG;QACd,eAAe;QACf,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;KAoBF;KACF,AAvBY,CAuBZ;IAKD;QACE,KAAK,EAAE,CAAA;QAEP,IAAI,CAAC,gBAAgB,GAAG,EAAE,CAAA;IAC5B,CAAC;IAED,MAAM;QACJ,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAA;QAE5D,OAAO,IAAI,CAAA;;;uBAGQ,IAAI;8BACG,WAAW;;;;qBAIpB,SAAS;;;KAGzB,CAAA;IACH,CAAC;IAED,YAAY;QACV,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IACrC,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,EAAE;QACpB,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC;YAClC,KAAK,EAAE,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;OAsBT;YACD,SAAS,EAAE;gBACT,EAAE;aACH;SACF,CAAC,CAAA;QAEF,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAA;IACxC,CAAC;;AA9D2B;IAA3B,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;;qDAAoB;AACnB;IAA3B,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;;mDAAc;AACb;IAA3B,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;;2DAAsB;AA3B7C,iBAAiB;IADtB,aAAa,CAAC,qBAAqB,CAAC;;GAC/B,iBAAiB,CAwFtB","sourcesContent":["import '@material/web/button/elevated-button.js'\n\nimport gql from 'graphql-tag'\nimport { css, html, LitElement } from 'lit'\nimport { customElement, property } from 'lit/decorators.js'\n\nimport { client } from '@operato/graphql'\nimport { i18next, localize } from '@operato/i18n'\nimport { ScrollbarStyles } from '@operato/styles'\n\n@customElement('activity-owner-view')\nclass ActivityOwnerView extends localize(i18next)(LitElement) {\n  static styles = [\n    ScrollbarStyles,\n    css`\n      :host {\n        display: flex;\n        flex-direction: column;\n\n        background-color: var(--md-sys-color-surface);\n      }\n\n      content {\n        flex: 1;\n        display: flex;\n        flex-direction: column;\n        padding: var(--spacing-medium);\n        overflow: auto;\n      }\n\n      section {\n        display: flex;\n        flex-direction: column;\n      }\n    `\n  ]\n  @property({ type: String }) activityId?: string\n  @property({ type: Object }) activity: any\n  @property({ type: Object }) activityInstance: any\n\n  constructor() {\n    super()\n\n    this.activityInstance = {}\n  }\n\n  render() {\n    const { name, description, thumbnail } = this.activity || {}\n\n    return html`\n      <content>\n        <section>\n          <div>name: ${name}</div>\n          <div>description: ${description}</div>\n        </section>\n\n        <section>\n          <img src=${thumbnail} />\n        </section>\n      </content>\n    `\n  }\n\n  firstUpdated() {\n    this.fetchActivity(this.activityId)\n  }\n\n  async fetchActivity(id) {\n    const response = await client.query({\n      query: gql`\n        query activity($id: String!) {\n          activity(id: $id) {\n            id\n            name\n            description\n            state\n            thumbnail\n            model {\n              name\n              description\n              active\n              tag\n              inout\n              type\n              unit\n              options\n              quantifier\n              spec\n            }\n          }\n        }\n      `,\n      variables: {\n        id\n      }\n    })\n\n    this.activity = response.data.activity\n  }\n}\n"]}

package/dist-client/components/activity-approval-ribon.d.ts

@@ -0,0 +1,31 @@
+import '@operato/property-editor/ox-properties-dynamic-view.js';
+import '@things-factory/organization/dist-client/component/approval-line-brief.js';
+import '../templates/activity-approval-context-template.js';
+import { LitElement } from 'lit';
+declare const ActivityApprovalRibon_base: (new (...args: any[]) => LitElement) & typeof LitElement;
+export declare class ActivityApprovalRibon extends ActivityApprovalRibon_base {
+    static styles: import("lit").CSSResult[][];
+    activityApproval: any;
+    render(): import("lit-html").TemplateResult<1>;
+    /**
+     * 이 건의 기본 정보 — **팝업으로 연다.**
+     *
+     * ── 왜 aside 가 아닌가 (2026-09-06) ────────────────────────────────────
+     * 전에는 화면 오른쪽에서 나오는 aside 판이었다. 두 가지가 걸린다.
+     *
+     *   자리를 다툰다   화면 오른쪽 세로 패널은 operato-twin 의 twin-entity360 이 쓰는 자리다
+     *                  (position: fixed · right: 0 · height: 100vh). 같은 자리에 둘이 선다.
+     *   전역 슬롯이다   VIEWPART_POSITION.ASIDEBAR 은 앱이 하나만 갖는다. 열 개가 넘는 패키지가
+     *                  그 자리를 쓰고 있어(twin 의 AI 협의 도크 · board-ui · help · more-ui …),
+     *                  이 패널을 열면 그중 열려 있던 것이 닫힌다.
+     *
+     * 그리고 자리의 뜻이 다르다. 오른쪽 드로어는 **보고 있는 대상을 따라다니는 상세**이고(360 이
+     * 그것이다 — 포커스가 바뀌면 내용이 바뀌고 화면을 옮겨도 남는다), 이 패널은 **이 화면의 이 건**에
+     * 대한 것이라 화면을 벗어나면 뜻이 없다. 페이지에 매인 것을 앱 전역 자리에 두지 않는다.
+     *
+     * 내용도 팝업 크기다 — 값 여덟 줄과 접힌 타임라인이라 세로 100vh 를 쓸 일이 없었다.
+     */
+    private openInfo;
+    updated(changes: any): void;
+}
+export {};

package/dist-client/components/activity-approval-ribon.js

@@ -0,0 +1,103 @@
+import { __decorate, __metadata } from "tslib";
+import '@operato/property-editor/ox-properties-dynamic-view.js';
+import '@things-factory/organization/dist-client/component/approval-line-brief.js';
+import '../templates/activity-approval-context-template.js';
+import { html, LitElement } from 'lit';
+import { customElement, property } from 'lit/decorators.js';
+import { i18next, localize } from '@operato/i18n';
+import { entity360Name, openPopup } from '@operato/layout';
+import { StateRibonStyles } from './state-ribon.js';
+let ActivityApprovalRibon = class ActivityApprovalRibon extends localize(i18next)(LitElement) {
+    static { this.styles = [StateRibonStyles]; }
+    render() {
+        const { activityInstance, state } = this.activityApproval?.activityThread || {};
+        const { description, assignee, approvalLine, activity } = activityInstance || {};
+        const { startingType, label, labelTKey } = activity || {};
+        /*
+         * What kind of decision this is — the activity's own name, not this instance's.
+         *
+         * Those are different facts and both belong here: 「부적합 처분 승인」 says what kind, and the
+         * headline the activity declares says what this one asks for. The activity's name reached only
+         * the catalog until it became a column on the row, so this screen showed the instance
+         * description alone.
+         *
+         * ── The fallback puts English on a Korean screen ──────────────────────
+         * Activity.description is what a developer wrote for other developers ("The disposition waiting
+         * for approval"), so an activity with no label shows that to the person approving. That is worse
+         * than the instance description and it is the reason to fill label in — it is not a fallback
+         * anybody should be content with.
+         */
+        const named = label && labelTKey ? String(i18next.t(labelTKey, { defaultValue: label })) : label;
+        const kind = named || description || '';
+        return html `
+      <span class="state">
+        <i class="dot"></i>
+        ${i18next.t('label.activity-state-' + state)}
+      </span>
+
+      <md-icon
+        class="info"
+        role="button"
+        tabindex="0"
+        title=${String(i18next.t('label.approval-info'))}
+        @click=${() => this.openInfo(state)}
+        @keydown=${(e) => {
+            if (e.key === 'Enter' || e.key === ' ') {
+                e.preventDefault();
+                this.openInfo(state);
+            }
+        }}
+        >info</md-icon
+      >
+
+      <span class="desc" title=${kind}>${kind}</span>
+
+
+      ${startingType == 'issue' && assignee
+            ? html `<span class="who"><span class="who-label">${i18next.t('field.assignee')}</span>${entity360Name(assignee)}</span>`
+            : ''}
+      ${approvalLine
+            ? html `<approval-line-brief
+            .model=${approvalLine}
+            .current=${this.activityApproval.order}
+          ></approval-line-brief>`
+            : ''}
+    `;
+    }
+    /**
+     * 이 건의 기본 정보 — **팝업으로 연다.**
+     *
+     * ── 왜 aside 가 아닌가 (2026-09-06) ────────────────────────────────────
+     * 전에는 화면 오른쪽에서 나오는 aside 판이었다. 두 가지가 걸린다.
+     *
+     *   자리를 다툰다   화면 오른쪽 세로 패널은 operato-twin 의 twin-entity360 이 쓰는 자리다
+     *                  (position: fixed · right: 0 · height: 100vh). 같은 자리에 둘이 선다.
+     *   전역 슬롯이다   VIEWPART_POSITION.ASIDEBAR 은 앱이 하나만 갖는다. 열 개가 넘는 패키지가
+     *                  그 자리를 쓰고 있어(twin 의 AI 협의 도크 · board-ui · help · more-ui …),
+     *                  이 패널을 열면 그중 열려 있던 것이 닫힌다.
+     *
+     * 그리고 자리의 뜻이 다르다. 오른쪽 드로어는 **보고 있는 대상을 따라다니는 상세**이고(360 이
+     * 그것이다 — 포커스가 바뀌면 내용이 바뀌고 화면을 옮겨도 남는다), 이 패널은 **이 화면의 이 건**에
+     * 대한 것이라 화면을 벗어나면 뜻이 없다. 페이지에 매인 것을 앱 전역 자리에 두지 않는다.
+     *
+     * 내용도 팝업 크기다 — 값 여덟 줄과 접힌 타임라인이라 세로 100vh 를 쓸 일이 없었다.
+     */
+    openInfo(state) {
+        openPopup(html `<activity-approval-context-template .activityApproval=${this.activityApproval} state=${state}></activity-approval-context-template>`, { title: i18next.t('label.approval-info') });
+    }
+    updated(changes) {
+        if (changes.has('activityApproval') && this.activityApproval) {
+            const { state } = this.activityApproval.activityThread;
+            this.setAttribute('state', state);
+        }
+    }
+};
+__decorate([
+    property({ type: Object }),
+    __metadata("design:type", Object)
+], ActivityApprovalRibon.prototype, "activityApproval", void 0);
+ActivityApprovalRibon = __decorate([
+    customElement('activity-approval-ribon')
+], ActivityApprovalRibon);
+export { ActivityApprovalRibon };
+//# sourceMappingURL=activity-approval-ribon.js.map

package/dist-client/components/activity-approval-ribon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity-approval-ribon.js","sourceRoot":"","sources":["../../client/components/activity-approval-ribon.ts"],"names":[],"mappings":"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","sourcesContent":["import '@operato/property-editor/ox-properties-dynamic-view.js'\nimport '@things-factory/organization/dist-client/component/approval-line-brief.js'\nimport '../templates/activity-approval-context-template.js'\n\nimport { html, LitElement } from 'lit'\nimport { customElement, property } from 'lit/decorators.js'\n\nimport { i18next, localize } from '@operato/i18n'\nimport { entity360Name, openPopup } from '@operato/layout'\n\nimport { StateRibonStyles } from './state-ribon.js'\n\n@customElement('activity-approval-ribon')\nexport class ActivityApprovalRibon extends localize(i18next)(LitElement) {\n  static styles = [StateRibonStyles]\n\n  @property({ type: Object }) activityApproval: any\n\n  render() {\n    const { activityInstance, state } = this.activityApproval?.activityThread || {}\n    const { description, assignee, approvalLine, activity } = activityInstance || {}\n    const { startingType, label, labelTKey } = activity || {}\n\n    /*\n     * What kind of decision this is — the activity's own name, not this instance's.\n     *\n     * Those are different facts and both belong here: 「부적합 처분 승인」 says what kind, and the\n     * headline the activity declares says what this one asks for. The activity's name reached only\n     * the catalog until it became a column on the row, so this screen showed the instance\n     * description alone.\n     *\n     * ── The fallback puts English on a Korean screen ──────────────────────\n     * Activity.description is what a developer wrote for other developers (\"The disposition waiting\n     * for approval\"), so an activity with no label shows that to the person approving. That is worse\n     * than the instance description and it is the reason to fill label in — it is not a fallback\n     * anybody should be content with.\n     */\n    const named = label && labelTKey ? String(i18next.t(labelTKey, { defaultValue: label })) : label\n    const kind = named || description || ''\n\n    return html`\n      <span class=\"state\">\n        <i class=\"dot\"></i>\n        ${i18next.t('label.activity-state-' + state)}\n      </span>\n\n      <md-icon\n        class=\"info\"\n        role=\"button\"\n        tabindex=\"0\"\n        title=${String(i18next.t('label.approval-info'))}\n        @click=${() => this.openInfo(state)}\n        @keydown=${(e: KeyboardEvent) => {\n          if (e.key === 'Enter' || e.key === ' ') {\n            e.preventDefault()\n            this.openInfo(state)\n          }\n        }}\n        >info</md-icon\n      >\n\n      <span class=\"desc\" title=${kind}>${kind}</span>\n\n\n      ${startingType == 'issue' && assignee\n        ? html`<span class=\"who\"><span class=\"who-label\">${i18next.t('field.assignee')}</span>${entity360Name(assignee)}</span>`\n        : ''}\n      ${approvalLine\n        ? html`<approval-line-brief\n            .model=${approvalLine}\n            .current=${this.activityApproval.order}\n          ></approval-line-brief>`\n        : ''}\n    `\n  }\n\n  /**\n   * 이 건의 기본 정보 — **팝업으로 연다.**\n   *\n   * ── 왜 aside 가 아닌가 (2026-09-06) ────────────────────────────────────\n   * 전에는 화면 오른쪽에서 나오는 aside 판이었다. 두 가지가 걸린다.\n   *\n   *   자리를 다툰다   화면 오른쪽 세로 패널은 operato-twin 의 twin-entity360 이 쓰는 자리다\n   *                  (position: fixed · right: 0 · height: 100vh). 같은 자리에 둘이 선다.\n   *   전역 슬롯이다   VIEWPART_POSITION.ASIDEBAR 은 앱이 하나만 갖는다. 열 개가 넘는 패키지가\n   *                  그 자리를 쓰고 있어(twin 의 AI 협의 도크 · board-ui · help · more-ui …),\n   *                  이 패널을 열면 그중 열려 있던 것이 닫힌다.\n   *\n   * 그리고 자리의 뜻이 다르다. 오른쪽 드로어는 **보고 있는 대상을 따라다니는 상세**이고(360 이\n   * 그것이다 — 포커스가 바뀌면 내용이 바뀌고 화면을 옮겨도 남는다), 이 패널은 **이 화면의 이 건**에\n   * 대한 것이라 화면을 벗어나면 뜻이 없다. 페이지에 매인 것을 앱 전역 자리에 두지 않는다.\n   *\n   * 내용도 팝업 크기다 — 값 여덟 줄과 접힌 타임라인이라 세로 100vh 를 쓸 일이 없었다.\n   */\n  private openInfo(state: string) {\n    openPopup(\n      html`<activity-approval-context-template .activityApproval=${this.activityApproval} state=${state}></activity-approval-context-template>`,\n      { title: i18next.t('label.approval-info') }\n    )\n  }\n\n  updated(changes) {\n    if (changes.has('activityApproval') && this.activityApproval) {\n      const { state } = this.activityApproval.activityThread\n\n      this.setAttribute('state', state)\n    }\n  }\n}\n"]}

package/dist-client/components/activity-fields.d.ts

@@ -0,0 +1,77 @@
+import '@material/web/icon/icon.js';
+/**
+ * 업무 항목을 화면에 내는 방식 — **두 화면이 한 벌을 쓴다.**
+ *
+ * 업무 상세(activity-thread-page)와 결재 상세(activity-approval-page)는 거의 복사본이다. 항목을
+ * 고르는 함수, 화면 종류에 따라 그리는 분기, 절을 그리는 부분이 두 파일에 같은 코드로 있었다.
+ * 그래서 한쪽만 고치면 나머지가 그대로 남는다 — 실제로 그랬다(2026-09-06, 상세 화면의
+ * Input · Output 영문 legend 를 고쳤는데 결재 화면에는 그대로 있었다).
+ *
+ * 화면마다 다른 것은 남긴다 — 상세는 결과를 적고, 결재는 읽기만 한다.
+ */
+/** 절과 값 표의 모양. 카드 값은 SurfaceStyles 의 .ui-card 와 같다. */
+export declare const ActivityFieldsStyles: import("lit").CSSResult;
+/** 받은 값 — 업무를 시작할 때 함께 온 것. */
+export declare function inputSpecOf(model: any[] | null | undefined): any[];
+/** 적어 낼 값 — 수행자가 채우는 것. */
+export declare function outputSpecOf(model: any[] | null | undefined): any[];
+/**
+ * 값을 **표로** 보인다. 입력칸으로 그리지 않는다.
+ *
+ * 전에는 읽기만 하는 절도 ox-properties-dynamic-view 로 그렸다. 그러면 값마다 흰 입력 상자가
+ * 생기고 사용자는 고쳐 쓸 수 있는 것으로 읽는다. 그런데 그 절에는 변경을 받는 자리가 없다 —
+ * 결재 화면은 아예 output 을 mutation 에 싣지 않는다(approveActivityApproval 은 id 와 comment 만
+ * 보낸다). 「적을 수 있게 보이는데 적히지 않는 칸」이라 가장 나쁜 쪽이다.
+ */
+export declare function renderGiven(specs: any[], values: any): import("lit-html").TemplateResult<1>;
+/**
+ * 항목 이름 — ox-property-editor 와 같은 규칙으로 찾는다(그쪽은 label. 접두사를 스스로 붙인다).
+ *
+ * 번역이 없으면 **키를 그대로 보이지 않는다.** 전에는 label.because 가 없어서 화면에
+ * Label.Because 가 나왔다. 사용자에게 뜻이 없는 글자다.
+ *
+ * description 으로 물러나지도 않는다 — 액티비티의 description 은 개발자가 영어로 적어 둔 설명이다
+ * (예: "The disposition waiting for approval"). 한국어 화면에 영어 문장이 나오는 것보다 항목
+ * 이름이 낫다.
+ */
+export declare function fieldLabel(spec: any): string;
+/**
+ * 선언이 준 이름 — `tKey` 로 찾되, **없으면 키를 보이지 않는다.**
+ *
+ * 찾는 축(`searchKeys`)과 판단 자리(`decisionKeys`) 둘 다 이것을 쓴다. 두 선언이 같은 모양으로
+ * 이름을 나른다 — `tKey` 가 있으면 그 키로, 없으면 `name` 으로.
+ *
+ * `fieldLabel` 과 규칙이 하나 다르다. 그쪽은 `label.` 을 스스로 붙이지만 여기는 안 붙인다 — 이 두
+ * 선언의 `tKey` 는 선언한 모듈이 온전한 키로 적는다(plant 는 `field.lot`, twin 은 `twin.instance`).
+ * 접두사를 붙이면 맞게 적은 키가 오히려 안 찾아진다.
+ *
+ * ── 왜 물러날 자리가 필요한가 (2026-09-16) ────────────────────────────────
+ * i18next 는 없는 키를 **키 그대로** 돌려준다. 선언된 tKey 를 세어 보니 plant 는 서른 중 열아홉이,
+ * twin 은 셋 다 다섯 언어 어디에도 없었다. 그래서 그 표가 「어느 로트」 자리에 `lotName` 을, 「누가
+ * 냈나」 자리에 `twin.command-origin` 을 그리고 있다. 사용자에게 뜻이 없는 글자다.
+ *
+ * 없는 번역을 이 자리에서 지어낼 수는 없다. 대신 선언이 이미 준 `name` 으로 물러난다 — 개발자가 적은
+ * 영어지만 점과 낙타등이 섞인 키보다는 읽힌다. 같은 규율이 `fieldLabel` 에 이미 있었고, 이 규칙이
+ * 다섯 자리에 흩어져 있어서 한 자리만 고쳐서는 나머지 넷이 그대로 남았다.
+ */
+export declare function declaredLabel(item: any): string;
+/**
+ * 값 한 칸.
+ *
+ * ── 오브젝트를 한 줄 JSON 으로 내지 않는다 (2026-09-07) ─────────────────────
+ * `JSON.stringify` 한 줄이었다. 트윈의 작동 명령을 열면 그 한 줄이 700자가 넘어서, 「업무 내용」이
+ * 읽을 수 없는 글자 덩어리 하나가 됐다. 값은 다 있는데 아무것도 읽히지 않는다.
+ *
+ * 화면은 이미 이름과 값을 두 칸으로 보이는 말을 갖고 있다(dl.given). 오브젝트도 그 말로 편다 —
+ * 새 표현을 만들지 않고, 안쪽이든 바깥쪽이든 같은 모양으로 읽힌다.
+ *
+ * 값이 없으면 빈 칸으로 두지 않는다 — 빈 칸은 값이 없는 것인지 화면이 못 낸 것인지 모른다.
+ */
+export declare function fieldValue(value: any, depth?: number): unknown;
+/**
+ * A person as a value - their name opens their 360 (ADR-0067 decision 1), and no one says so as
+ * `fieldValue` would. `entity360Name` draws plain text until the person kind is registered.
+ */
+export declare function personValue(person?: {
+    name?: string;
+} | null): unknown;