@underdogai/mesh-event-schemas 0.3.0 → 0.8.0

package/dist/blocks.d.ts

@@ -3,7 +3,7 @@
  *
  * 설계 원칙 (docs/custom-event-ui.md 참조):
  *  - 닫힌(화이트리스트) 컴포넌트 집합. 임의 HTML/코드 실행 없음.
- *  - 순수 데이터(JSON). 렌더는 @chatops/ui-blocks(React)가 담당.
+ *  - 순수 데이터(JSON). 렌더는 @chatops/spec-renderer(React)가 담당.
  *  - 알 수 없는 블록 타입은 클라이언트가 안전한 fallback으로 렌더.
  *  - 권한은 절대 클라이언트가 아니라 appservice(서버측)가 재검증한다. 여기 disabled/confirm은 UX일 뿐.
  *
@@ -15,6 +15,56 @@ export declare const ToneSchema: z.ZodEnum<["neutral", "success", "warning", "da
 export type Tone = z.infer<typeof ToneSchema>;
 export declare const ButtonStyleSchema: z.ZodEnum<["default", "primary", "danger"]>;
 export type ButtonStyle = z.infer<typeof ButtonStyleSchema>;
+/**
+ * **참조 값**(0.8.0) — 사람·엔티티를 문자열이 아니라 가리키는 값으로 싣는다.
+ *
+ * 왜 필요한가: 같은 사람이 카드 안에서 세 표기로 흩어진다 — fields 의 "현호 손", 옵션 라벨
+ * "goya@bluepinlabs.com", 이력의 "heetae". 앱이 서버에서 표시명을 만들어 문자열로 박기 때문인데,
+ * 그러면 형식이 갈리고 얼굴이 없고 개명·동명이인에 취약하다. 값이 **MXID 참조**이고 클라가 방 상태로
+ * 이름·아바타를 해석하면, 어느 블록에 놓여도 같은 얼굴로 선다.
+ *
+ * 🔴 **평문 사본은 남는다**(`fields.parts` 와 같은 규칙 — §4). `ref` 를 모르는 옛 클라는 이 키를
+ * zod strip 으로 벗기고 `value`/`label`/`name` 문자열을 지금처럼 그린다. 그래서 참조를 실으면서도
+ * 사본을 비우면 **그 필드가 빈칸이 된다** — 사본은 선택이 아니라 계약이다.
+ *
+ * 🔴 **이것도 권한이 아니다.** 값이 MXID 라는 것은 서버가 멤버십으로 재검증할 수 있다는 뜻이지,
+ * 클라가 신원을 판정한다는 뜻이 아니다.
+ */
+export declare const RefSchema: z.ZodUnion<[z.ZodObject<{
+    /** Matrix 사용자 id — `@local:server` 형태. 해석(이름·아바타)은 호스트가 주입한다(PeopleProvider). */
+    user: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    user: string;
+}, {
+    user: string;
+}>, z.ZodObject<{
+    /** 도메인 엔티티 — `entityRef` **블록**이 이미 쓰는 종류/식별자 짝이 값 안으로 들어온 것. */
+    entity: z.ZodObject<{
+        type: z.ZodString;
+        id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: string;
+        id: string;
+    }, {
+        type: string;
+        id: string;
+    }>;
+    /** 클릭 시 이동할 https URL(선택). 출처는 클라가 검증한다. */
+    url: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    entity: {
+        type: string;
+        id: string;
+    };
+    url?: string | undefined;
+}, {
+    entity: {
+        type: string;
+        id: string;
+    };
+    url?: string | undefined;
+}>]>;
+export type Ref = z.infer<typeof RefSchema>;
 /** 파괴적 액션 전에 클라이언트가 띄우는 확인 다이얼로그. 서버도 별도로 HITL 재검증한다. */
 export declare const ConfirmSchema: z.ZodObject<{
     title: z.ZodString;
@@ -36,7 +86,16 @@ export type Confirm = z.infer<typeof ConfirmSchema>;
 export declare const TextBlockSchema: z.ZodObject<{
     type: z.ZodLiteral<"text">;
     text: z.ZodString;
-    /** true면 안전 화이트리스트 마크다운으로 렌더 (raw HTML 금지) */
+    /**
+     * true면 안전 화이트리스트 마크다운으로 렌더 (raw HTML 금지).
+     *
+     * 인라인: `**굵게**` `*기울임*` `` `코드` `` `[텍스트](http…)`.
+     * 블록: 문단(빈 줄) · 목록(`-` `*` `+` / `1.`, 중첩 가능) · 제목(`#`~`###`) · 인용(`>`) ·
+     *       구분선(`---`) · 펜스 코드(``` ```` ```).
+     * 표는 지원하지 않는다 — 표는 `table` 블록이 따로 있다.
+     *
+     * 플래그를 안 주면 평문이다(줄바꿈만 살아난다). 긴 글에는 켜는 쪽이 읽힌다 — #581.
+     */
     markdown: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     type: "text";
@@ -92,6 +151,44 @@ export declare const FieldsBlockSchema: z.ZodObject<{
             text: string;
             tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
         }>, "many">>;
+        /**
+         * 이 값이 가리키는 사람/엔티티 (0.8.0). 있으면 렌더러가 칩(아바타+이름 / 종류+라벨)으로 그린다.
+         * 🔴 **`value` 는 평문 사본으로 남긴다** — `parts` 와 같은 규칙이다(RefSchema 머리말).
+         */
+        ref: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
+            /** Matrix 사용자 id — `@local:server` 형태. 해석(이름·아바타)은 호스트가 주입한다(PeopleProvider). */
+            user: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            user: string;
+        }, {
+            user: string;
+        }>, z.ZodObject<{
+            /** 도메인 엔티티 — `entityRef` **블록**이 이미 쓰는 종류/식별자 짝이 값 안으로 들어온 것. */
+            entity: z.ZodObject<{
+                type: z.ZodString;
+                id: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                type: string;
+                id: string;
+            }, {
+                type: string;
+                id: string;
+            }>;
+            /** 클릭 시 이동할 https URL(선택). 출처는 클라가 검증한다. */
+            url: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            entity: {
+                type: string;
+                id: string;
+            };
+            url?: string | undefined;
+        }, {
+            entity: {
+                type: string;
+                id: string;
+            };
+            url?: string | undefined;
+        }>]>>;
     }, "strip", z.ZodTypeAny, {
         value: string;
         label: string;
@@ -100,6 +197,15 @@ export declare const FieldsBlockSchema: z.ZodObject<{
             text: string;
             tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
         }[] | undefined;
+        ref?: {
+            user: string;
+        } | {
+            entity: {
+                type: string;
+                id: string;
+            };
+            url?: string | undefined;
+        } | undefined;
     }, {
         value: string;
         label: string;
@@ -108,6 +214,15 @@ export declare const FieldsBlockSchema: z.ZodObject<{
             text: string;
             tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
         }[] | undefined;
+        ref?: {
+            user: string;
+        } | {
+            entity: {
+                type: string;
+                id: string;
+            };
+            url?: string | undefined;
+        } | undefined;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     type: "fields";
@@ -119,6 +234,15 @@ export declare const FieldsBlockSchema: z.ZodObject<{
             text: string;
             tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
         }[] | undefined;
+        ref?: {
+            user: string;
+        } | {
+            entity: {
+                type: string;
+                id: string;
+            };
+            url?: string | undefined;
+        } | undefined;
     }[];
 }, {
     type: "fields";
@@ -130,6 +254,15 @@ export declare const FieldsBlockSchema: z.ZodObject<{
             text: string;
             tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
         }[] | undefined;
+        ref?: {
+            user: string;
+        } | {
+            entity: {
+                type: string;
+                id: string;
+            };
+            url?: string | undefined;
+        } | undefined;
     }[];
 }>;
 export declare const ImageBlockSchema: z.ZodObject<{
@@ -149,9 +282,18 @@ export declare const ImageBlockSchema: z.ZodObject<{
     mxc?: string | undefined;
     alt?: string | undefined;
 }>;
+/**
+ * 작은 보조 텍스트/아이콘 줄.
+ *
+ * ⬜ **여기엔 `ref` 원소를 안 둔다(0.8.0에서 일부러 뺐다).** 다른 자리의 참조는 *기존 객체의 새 키*라
+ * 옛 클라가 zod strip 으로 벗기고 평문 사본을 그리지만, 여기 `elements` 는 **닫힌 유니온**이라 새
+ * 모양의 원소 하나가 유니온 전체를 실패시키고 → 배열이 실패하고 → `dropUnknownBlocks` 가 **context
+ * 블록을 통째로 떨군다**. 즉 "평문 사본이 곁에 선다"는 규칙이 성립하지 않는 유일한 자리다
+ * (`parts`·`hidden_for`·`ref` 가 다 되는 이유가 그 셋은 키 추가이기 때문이다).
+ * 사람을 보조 줄에 그리고 싶으면 `activity` 블록이나 `fields` 항목의 `ref` 를 쓴다.
+ */
 export declare const ContextBlockSchema: z.ZodObject<{
     type: z.ZodLiteral<"context">;
-    /** 작은 보조 텍스트/아이콘 줄 */
     elements: z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
         icon: z.ZodString;
     }, "strip", z.ZodTypeAny, {
@@ -228,26 +370,68 @@ export declare const InputBlockSchema: z.ZodObject<{
      * 단일 업로드로 동작한다(기능 축소일 뿐 파손 없음).
      */
     multiple: z.ZodOptional<z.ZodBoolean>;
+    /**
+     * 하한/상한 (0.7.0) — number/date/datetime/time 공용. **문자열**이다: 날짜·시각은 그 타입의 값
+     * 형식(`2026-09-22`·`18:15`)이고, number 면 숫자를 적은 문자열이다(와이어 canonical JSON 은
+     * 소수를 허용하지 않아 숫자 축을 열 수 없다 — `slider` 가 int 만 받는 것과 같은 제약).
+     *
+     * `"today"` 리터럴을 허용한다 — "기한은 오늘 이후"는 카드를 **보낸 날**이 아니라 **보는 날** 기준이라야
+     * 맞다(카드는 타임라인에 남고 며칠 뒤에도 눌린다). 렌더러가 그릴 때 해석한다.
+     *
+     * 🔴 **UX 다, 진실은 서버**(`hidden_for` 와 같은 자세). 클라가 미리 잠그는 건 헛걸음을 줄이려는
+     * 것뿐이고, 진짜 판정은 언제나 핸들러·게이트가 한다. 이 키를 모르는 옛 클라는 strip 하고 지금처럼
+     * 아무 제약 없이 제출한다 — 그러면 서버가 사람이 읽을 이유와 함께 거절한다(`action.result`).
+     */
+    min: z.ZodOptional<z.ZodString>;
+    max: z.ZodOptional<z.ZodString>;
+    /** 글자 수 하한/상한 (0.7.0) — 텍스트 계열 전용. 🔴 UX 다, 진실은 서버. */
+    minLength: z.ZodOptional<z.ZodNumber>;
+    maxLength: z.ZodOptional<z.ZodNumber>;
+    /**
+     * 값이 맞아야 하는 정규식 **소스**(0.7.0, 예: `"^[A-Z]{2}-\\d{4}$"`). 플래그·구분자 없이 패턴만 적는다.
+     *
+     * 🔴 렌더러는 `new RegExp` 를 **try/catch 로 감싼다** — 작성자가 자바스크립트가 아닌 방언(파이썬
+     * `(?P<x>…)` 등)을 보내면 던지는데, 그걸로 카드 전체가 죽으면 안 된다. 못 읽는 패턴은 무시한다
+     * (= 제약 없음). 진짜 판정은 여전히 서버다.
+     */
+    pattern: z.ZodOptional<z.ZodString>;
+    /**
+     * 제약 위반 시 보여 줄 **작성자 소유 문장**(0.7.0). 없으면 렌더러 크롬 문구를 쓴다
+     * (`LabelContext` — "누구의 문자열인가"가 경계선이고, 도메인 사정을 아는 문장은 작성자 것이다).
+     */
+    error: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     type: "input";
     name: string;
     value?: string | undefined;
     label?: string | undefined;
-    input?: "number" | "text" | "date" | "url" | "textarea" | "datetime" | "time" | "email" | "file" | undefined;
+    input?: "number" | "date" | "url" | "text" | "textarea" | "datetime" | "time" | "email" | "file" | undefined;
     placeholder?: string | undefined;
     required?: boolean | undefined;
     accept?: string | undefined;
     multiple?: boolean | undefined;
+    min?: string | undefined;
+    max?: string | undefined;
+    minLength?: number | undefined;
+    maxLength?: number | undefined;
+    pattern?: string | undefined;
+    error?: string | undefined;
 }, {
     type: "input";
     name: string;
     value?: string | undefined;
     label?: string | undefined;
-    input?: "number" | "text" | "date" | "url" | "textarea" | "datetime" | "time" | "email" | "file" | undefined;
+    input?: "number" | "date" | "url" | "text" | "textarea" | "datetime" | "time" | "email" | "file" | undefined;
     placeholder?: string | undefined;
     required?: boolean | undefined;
     accept?: string | undefined;
     multiple?: boolean | undefined;
+    min?: string | undefined;
+    max?: string | undefined;
+    minLength?: number | undefined;
+    maxLength?: number | undefined;
+    pattern?: string | undefined;
+    error?: string | undefined;
 }>;
 /** 토글(스위치) — checkbox 와 같은 불리언을 수집하되 on/off 스위치 어포던스로 렌더. */
 export declare const ToggleBlockSchema: z.ZodObject<{
@@ -311,7 +495,12 @@ export declare const SliderBlockSchema: z.ZodObject<{
     unit?: string | undefined;
 }>;
 export type SliderBlock = z.infer<typeof SliderBlockSchema>;
-/** 단일 선택 라디오 그룹. select 와 달리 옵션이 펼쳐져 보인다. */
+/** 단일 선택 라디오 그룹. select 와 달리 옵션이 펼쳐져 보인다.
+ *  옵션 `hint` = 라벨 아래 한 줄 보조 설명(선택) — "버그 — 뭔가 잘못 동작해요" 처럼 라벨에 설명을
+ *  욱여넣던 것을 두 줄로 가른다(가독성). 옛 클라는 zod 가 벗겨내므로 라벨만 보인다(하위호환).
+ *  `style` = 표현 힌트(선택): "cards" 는 옵션을 전체폭 카드 행으로, "segmented" 는 한 줄 세그먼트로
+ *  (짧은 라벨 전용 — 렌더러가 hint 를 숨긴다). 값 의미는 동일하고 옛 클라는 평 라디오로 그린다.
+ *  ⚠️ 위치 선택자(:first-child)로 특정 폼만 다르게 칠하지 말 것 — 표현은 이 필드로 선언한다. */
 export declare const RadioBlockSchema: z.ZodObject<{
     type: z.ZodLiteral<"radio">;
     name: z.ZodString;
@@ -319,71 +508,180 @@ export declare const RadioBlockSchema: z.ZodObject<{
     options: z.ZodArray<z.ZodObject<{
         value: z.ZodString;
         label: z.ZodString;
+        hint: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         value: string;
         label: string;
+        hint?: string | undefined;
     }, {
         value: string;
         label: string;
+        hint?: string | undefined;
     }>, "many">;
     value: z.ZodOptional<z.ZodString>;
+    style: z.ZodOptional<z.ZodEnum<["cards", "segmented"]>>;
+    /** 고르지 않으면 제출을 잠근다 (0.7.0). 🔴 UX 다, 진실은 서버 — `input.required` 와 같은 자세. */
+    required: z.ZodOptional<z.ZodBoolean>;
+    /** 미선택 시 보여 줄 작성자 소유 문장 (0.7.0). 없으면 렌더러 크롬 문구. */
+    error: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     options: {
         value: string;
         label: string;
+        hint?: string | undefined;
     }[];
     type: "radio";
     name: string;
     value?: string | undefined;
     label?: string | undefined;
+    required?: boolean | undefined;
+    error?: string | undefined;
+    style?: "cards" | "segmented" | undefined;
 }, {
     options: {
         value: string;
         label: string;
+        hint?: string | undefined;
     }[];
     type: "radio";
     name: string;
     value?: string | undefined;
     label?: string | undefined;
+    required?: boolean | undefined;
+    error?: string | undefined;
+    style?: "cards" | "segmented" | undefined;
 }>;
 export declare const SelectBlockSchema: z.ZodObject<{
     type: z.ZodLiteral<"select">;
     name: z.ZodString;
     label: z.ZodOptional<z.ZodString>;
     placeholder: z.ZodOptional<z.ZodString>;
+    /**
+     * 후보 목록. `ref`(0.8.0)를 주면 렌더러가 행을 칩(아바타·이름·MXID)으로 그린다 —
+     * 🔴 `label` 은 평문 사본으로 남긴다(RefSchema 머리말). 그리는 쪽은 P5(선택 모델)가 맡는다.
+     */
     options: z.ZodArray<z.ZodObject<{
         value: z.ZodString;
         label: z.ZodString;
+        ref: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
+            /** Matrix 사용자 id — `@local:server` 형태. 해석(이름·아바타)은 호스트가 주입한다(PeopleProvider). */
+            user: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            user: string;
+        }, {
+            user: string;
+        }>, z.ZodObject<{
+            /** 도메인 엔티티 — `entityRef` **블록**이 이미 쓰는 종류/식별자 짝이 값 안으로 들어온 것. */
+            entity: z.ZodObject<{
+                type: z.ZodString;
+                id: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                type: string;
+                id: string;
+            }, {
+                type: string;
+                id: string;
+            }>;
+            /** 클릭 시 이동할 https URL(선택). 출처는 클라가 검증한다. */
+            url: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            entity: {
+                type: string;
+                id: string;
+            };
+            url?: string | undefined;
+        }, {
+            entity: {
+                type: string;
+                id: string;
+            };
+            url?: string | undefined;
+        }>]>>;
     }, "strip", z.ZodTypeAny, {
         value: string;
         label: string;
+        ref?: {
+            user: string;
+        } | {
+            entity: {
+                type: string;
+                id: string;
+            };
+            url?: string | undefined;
+        } | undefined;
     }, {
         value: string;
         label: string;
+        ref?: {
+            user: string;
+        } | {
+            entity: {
+                type: string;
+                id: string;
+            };
+            url?: string | undefined;
+        } | undefined;
     }>, "many">;
     value: z.ZodOptional<z.ZodString>;
     multi: z.ZodOptional<z.ZodBoolean>;
+    /** 고르지 않으면 제출을 잠근다 (0.7.0). 🔴 UX 다, 진실은 서버. */
+    required: z.ZodOptional<z.ZodBoolean>;
+    /**
+     * `multi: true` 전용 — **고른 개수**의 하한/상한 (0.7.0). 단일 선택에선 무시한다.
+     * (`input` 의 `min`/`max` 는 값의 크기라 문자열인데, 여기는 개수라 정수다.)
+     * 🔴 UX 다, 진실은 서버.
+     */
+    min: z.ZodOptional<z.ZodNumber>;
+    max: z.ZodOptional<z.ZodNumber>;
+    /** 제약 위반 시 보여 줄 작성자 소유 문장 (0.7.0). 없으면 렌더러 크롬 문구. */
+    error: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     options: {
         value: string;
         label: string;
+        ref?: {
+            user: string;
+        } | {
+            entity: {
+                type: string;
+                id: string;
+            };
+            url?: string | undefined;
+        } | undefined;
     }[];
     type: "select";
     name: string;
     value?: string | undefined;
     label?: string | undefined;
     placeholder?: string | undefined;
+    required?: boolean | undefined;
+    min?: number | undefined;
+    max?: number | undefined;
+    error?: string | undefined;
     multi?: boolean | undefined;
 }, {
     options: {
         value: string;
         label: string;
+        ref?: {
+            user: string;
+        } | {
+            entity: {
+                type: string;
+                id: string;
+            };
+            url?: string | undefined;
+        } | undefined;
     }[];
     type: "select";
     name: string;
     value?: string | undefined;
     label?: string | undefined;
     placeholder?: string | undefined;
+    required?: boolean | undefined;
+    min?: number | undefined;
+    max?: number | undefined;
+    error?: string | undefined;
     multi?: boolean | undefined;
 }>;
 export declare const CheckboxBlockSchema: z.ZodObject<{
@@ -402,6 +700,51 @@ export declare const CheckboxBlockSchema: z.ZodObject<{
     name: string;
     checked?: boolean | undefined;
 }>;
+/**
+ * 위치 입력 — "지금 내 위치" 한 번을 **사용자 제스처로** 받아 폼 값으로 수집한다.
+ *
+ * 왜 입력 블록인가: 위치는 앱이 가져가는 게 아니라 **사람이 주는 것**이다. 그래서 다른 입력과 같은
+ * 자리에 서고(name 으로 수집 → 제출 버튼의 values 에 실림), 카드/모달 어느 쪽에도 놓을 수 있다.
+ * 버튼을 누르는 순간 OS 권한창이 뜨므로 "위치 권한 수락"과 "현재 위치 가져오기"가 한 동작이다 —
+ * 웹에는 애초에 "권한만 요청" 하는 API 가 없고, 네이티브도 쓰지 않을 권한을 미리 묻는 앱은 심사에서
+ * 이유를 설명해야 한다. 그래서 **쓸 때 묻는다**.
+ *
+ * 값의 모양은 `LocationValue`(geo.ts) — 좌표는 문자열 geo URI 다(canonical JSON 소수 금지).
+ * 수집 전에는 `""`. 못 쓰는 클라(구 셸·위치 없는 브라우저)에서는 렌더러가 **버튼을 비활성 + 이유**로
+ * degrade 한다 → 누른 뒤에 실패를 알게 되지 않는다.
+ */
+export declare const LocationBlockSchema: z.ZodObject<{
+    type: z.ZodLiteral<"location">;
+    name: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    /**
+     * 왜 필요한지 한 줄 — **OS 권한창보다 먼저** 보인다. 시스템 문구(Info.plist·Android 권한창)는
+     * 앱 전체에 하나뿐이라 이 카드가 왜 묻는지는 여기서만 말할 수 있다(그리고 그게 심사가 보는 것이다).
+     */
+    purpose: z.ZodOptional<z.ZodString>;
+    required: z.ZodOptional<z.ZodBoolean>;
+    /** GPS 급 정확도로 받을지(느리고 배터리를 더 쓴다). 기본 false = 네트워크/대략 위치. */
+    precise: z.ZodOptional<z.ZodBoolean>;
+    /** 버튼 문구(작성자 소유 문장). 미지정이면 렌더러 크롬 문구를 쓴다. */
+    buttonText: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "location";
+    name: string;
+    label?: string | undefined;
+    required?: boolean | undefined;
+    purpose?: string | undefined;
+    precise?: boolean | undefined;
+    buttonText?: string | undefined;
+}, {
+    type: "location";
+    name: string;
+    label?: string | undefined;
+    required?: boolean | undefined;
+    purpose?: string | undefined;
+    precise?: boolean | undefined;
+    buttonText?: string | undefined;
+}>;
+export type LocationBlock = z.infer<typeof LocationBlockSchema>;
 export declare const ButtonBlockSchema: z.ZodObject<{
     type: z.ZodLiteral<"button">;
     /** 어떤 액션인지 식별. 클릭 시 org.corp.ui.action.action_id 로 회신됨. */
@@ -427,6 +770,39 @@ export declare const ButtonBlockSchema: z.ZodObject<{
         cancel?: string | undefined;
     }>>;
     disabled: z.ZodOptional<z.ZodBoolean>;
+    /**
+     * 이 MXID 들에게는 버튼을 **감춘다**(뷰어별 어포던스).
+     *
+     * 왜 필요한가: 카드 한 장은 방 전체가 같이 본다. 그런데 "이 사람만 절대 못 누르는 버튼"이 있다 —
+     * Forgejo 는 **자기 PR 자기 승인**을 422 로 거절한다(`approve your own pull is not allowed`).
+     * 그래서 작성자에게 Approve 를 보여 주면 눌러도 실패 카드만 쌓인다. 카드 전체에서 버튼을 빼면
+     * 남들이 승인을 못 하므로, 판정은 **보는 사람별**이어야 한다.
+     *
+     * 🔴 **권한이 아니다.** 진짜 게이트는 언제나 서버다(disabled/confirm 과 같은 자세) — 이건 없는
+     * 어포던스를 안 보여 주기 위한 것뿐이다. 그래서 이 키를 모르는 옛 클라이언트가 버튼을 그대로
+     * 보여 줘도 안전하다(누르면 서버가 사람이 읽을 이유와 함께 거절한다).
+     */
+    hidden_for: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /**
+     * `hidden_for` 의 **짝**(0.7.0) — 이 MXID 들에게만 버튼을 보인다(화이트리스트).
+     *
+     * 왜 둘 다 있나: 두 축은 아는 것이 다르다. `hidden_for` 는 "이 사람은 절대 못 누른다"를 아는 경우고
+     * (자기 PR 자기 승인), `visible_for` 는 "이 사람만 누를 수 있다"를 아는 경우다(현재 수신자). 후자를
+     * `hidden_for` 로 쓰려면 방 멤버 전원을 열거해야 하고, 그 목록은 카드를 만든 **순간**에 굳는다 —
+     * 나중에 들어온 사람에게 버튼이 그냥 보인다.
+     *
+     * 🔴 **둘 다 있으면 `hidden_for` 가 이긴다.** "못 누른다"가 "누를 수 있다"보다 강한 진술이라서다
+     * (겹치는 경우는 보통 작성자의 실수이고, 그때 안전한 쪽은 감추는 쪽이다).
+     * 🔴 **권한이 아니다** — `hidden_for` 와 똑같이 UX 고, 진짜 게이트는 언제나 서버다.
+     *   이 키를 모르는 옛 클라는 strip 하고 **전원에게** 버튼을 보인다 → 누르면 서버가 거절한다.
+     */
+    visible_for: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /**
+     * 버튼이 잠기거나 감춰진 **이유 한 줄**(0.7.0) — 사람이 읽을 문장(작성자 소유).
+     * `disabled` 면 버튼 옆 보조 텍스트로, `visible_for` 로 감춰졌으면 버튼 자리에 이 줄만 남는다.
+     * "눌러 봐야 안다"를 없애는 것이 요점이다. 🔴 UX 다, 진실은 서버.
+     */
+    disabled_reason: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     type: "button";
     text: string;
@@ -440,6 +816,9 @@ export declare const ButtonBlockSchema: z.ZodObject<{
         cancel?: string | undefined;
     } | undefined;
     disabled?: boolean | undefined;
+    hidden_for?: string[] | undefined;
+    visible_for?: string[] | undefined;
+    disabled_reason?: string | undefined;
 }, {
     type: "button";
     text: string;
@@ -453,6 +832,9 @@ export declare const ButtonBlockSchema: z.ZodObject<{
         cancel?: string | undefined;
     } | undefined;
     disabled?: boolean | undefined;
+    hidden_for?: string[] | undefined;
+    visible_for?: string[] | undefined;
+    disabled_reason?: string | undefined;
 }>;
 export type ButtonBlock = z.infer<typeof ButtonBlockSchema>;
 /**
@@ -469,14 +851,14 @@ export declare const LinkButtonBlockSchema: z.ZodObject<{
     external: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     type: "linkButton";
-    text: string;
     url: string;
+    text: string;
     style?: "danger" | "default" | "primary" | undefined;
     external?: boolean | undefined;
 }, {
     type: "linkButton";
-    text: string;
     url: string;
+    text: string;
     style?: "danger" | "default" | "primary" | undefined;
     external?: boolean | undefined;
 }>;
@@ -509,6 +891,39 @@ export declare const ActionsBlockSchema: z.ZodObject<{
             cancel?: string | undefined;
         }>>;
         disabled: z.ZodOptional<z.ZodBoolean>;
+        /**
+         * 이 MXID 들에게는 버튼을 **감춘다**(뷰어별 어포던스).
+         *
+         * 왜 필요한가: 카드 한 장은 방 전체가 같이 본다. 그런데 "이 사람만 절대 못 누르는 버튼"이 있다 —
+         * Forgejo 는 **자기 PR 자기 승인**을 422 로 거절한다(`approve your own pull is not allowed`).
+         * 그래서 작성자에게 Approve 를 보여 주면 눌러도 실패 카드만 쌓인다. 카드 전체에서 버튼을 빼면
+         * 남들이 승인을 못 하므로, 판정은 **보는 사람별**이어야 한다.
+         *
+         * 🔴 **권한이 아니다.** 진짜 게이트는 언제나 서버다(disabled/confirm 과 같은 자세) — 이건 없는
+         * 어포던스를 안 보여 주기 위한 것뿐이다. 그래서 이 키를 모르는 옛 클라이언트가 버튼을 그대로
+         * 보여 줘도 안전하다(누르면 서버가 사람이 읽을 이유와 함께 거절한다).
+         */
+        hidden_for: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /**
+         * `hidden_for` 의 **짝**(0.7.0) — 이 MXID 들에게만 버튼을 보인다(화이트리스트).
+         *
+         * 왜 둘 다 있나: 두 축은 아는 것이 다르다. `hidden_for` 는 "이 사람은 절대 못 누른다"를 아는 경우고
+         * (자기 PR 자기 승인), `visible_for` 는 "이 사람만 누를 수 있다"를 아는 경우다(현재 수신자). 후자를
+         * `hidden_for` 로 쓰려면 방 멤버 전원을 열거해야 하고, 그 목록은 카드를 만든 **순간**에 굳는다 —
+         * 나중에 들어온 사람에게 버튼이 그냥 보인다.
+         *
+         * 🔴 **둘 다 있으면 `hidden_for` 가 이긴다.** "못 누른다"가 "누를 수 있다"보다 강한 진술이라서다
+         * (겹치는 경우는 보통 작성자의 실수이고, 그때 안전한 쪽은 감추는 쪽이다).
+         * 🔴 **권한이 아니다** — `hidden_for` 와 똑같이 UX 고, 진짜 게이트는 언제나 서버다.
+         *   이 키를 모르는 옛 클라는 strip 하고 **전원에게** 버튼을 보인다 → 누르면 서버가 거절한다.
+         */
+        visible_for: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /**
+         * 버튼이 잠기거나 감춰진 **이유 한 줄**(0.7.0) — 사람이 읽을 문장(작성자 소유).
+         * `disabled` 면 버튼 옆 보조 텍스트로, `visible_for` 로 감춰졌으면 버튼 자리에 이 줄만 남는다.
+         * "눌러 봐야 안다"를 없애는 것이 요점이다. 🔴 UX 다, 진실은 서버.
+         */
+        disabled_reason: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         type: "button";
         text: string;
@@ -522,6 +937,9 @@ export declare const ActionsBlockSchema: z.ZodObject<{
             cancel?: string | undefined;
         } | undefined;
         disabled?: boolean | undefined;
+        hidden_for?: string[] | undefined;
+        visible_for?: string[] | undefined;
+        disabled_reason?: string | undefined;
     }, {
         type: "button";
         text: string;
@@ -535,6 +953,9 @@ export declare const ActionsBlockSchema: z.ZodObject<{
             cancel?: string | undefined;
         } | undefined;
         disabled?: boolean | undefined;
+        hidden_for?: string[] | undefined;
+        visible_for?: string[] | undefined;
+        disabled_reason?: string | undefined;
     }>, z.ZodObject<{
         type: z.ZodLiteral<"linkButton">;
         text: z.ZodString;
@@ -545,14 +966,14 @@ export declare const ActionsBlockSchema: z.ZodObject<{
         external: z.ZodOptional<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
         type: "linkButton";
-        text: string;
         url: string;
+        text: string;
         style?: "danger" | "default" | "primary" | undefined;
         external?: boolean | undefined;
     }, {
         type: "linkButton";
-        text: string;
         url: string;
+        text: string;
         style?: "danger" | "default" | "primary" | undefined;
         external?: boolean | undefined;
     }>]>, "many">;
@@ -571,10 +992,13 @@ export declare const ActionsBlockSchema: z.ZodObject<{
             cancel?: string | undefined;
         } | undefined;
         disabled?: boolean | undefined;
+        hidden_for?: string[] | undefined;
+        visible_for?: string[] | undefined;
+        disabled_reason?: string | undefined;
     } | {
         type: "linkButton";
-        text: string;
         url: string;
+        text: string;
         style?: "danger" | "default" | "primary" | undefined;
         external?: boolean | undefined;
     })[];
@@ -593,10 +1017,13 @@ export declare const ActionsBlockSchema: z.ZodObject<{
             cancel?: string | undefined;
         } | undefined;
         disabled?: boolean | undefined;
+        hidden_for?: string[] | undefined;
+        visible_for?: string[] | undefined;
+        disabled_reason?: string | undefined;
     } | {
         type: "linkButton";
-        text: string;
         url: string;
+        text: string;
         style?: "danger" | "default" | "primary" | undefined;
         external?: boolean | undefined;
     })[];
@@ -633,6 +1060,12 @@ export declare const OverflowBlockSchema: z.ZodObject<{
             cancel?: string | undefined;
         }>>;
         disabled: z.ZodOptional<z.ZodBoolean>;
+        /** 이 MXID 들에게만 항목을 보인다 (0.7.0) — `ButtonBlockSchema.visible_for` 와 같은 규칙. 🔴 UX 다, 진실은 서버. */
+        visible_for: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /** 이 MXID 들에게 항목을 감춘다 (0.7.0) — 둘 다 있으면 이쪽이 이긴다(버튼과 같은 규칙). */
+        hidden_for: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /** 잠기거나 감춰진 이유 한 줄 (0.7.0, 작성자 소유 문장). 🔴 UX 다, 진실은 서버. */
+        disabled_reason: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         text: string;
         action_id: string;
@@ -645,6 +1078,9 @@ export declare const OverflowBlockSchema: z.ZodObject<{
             cancel?: string | undefined;
         } | undefined;
         disabled?: boolean | undefined;
+        hidden_for?: string[] | undefined;
+        visible_for?: string[] | undefined;
+        disabled_reason?: string | undefined;
     }, {
         text: string;
         action_id: string;
@@ -657,6 +1093,9 @@ export declare const OverflowBlockSchema: z.ZodObject<{
             cancel?: string | undefined;
         } | undefined;
         disabled?: boolean | undefined;
+        hidden_for?: string[] | undefined;
+        visible_for?: string[] | undefined;
+        disabled_reason?: string | undefined;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     type: "overflow";
@@ -672,6 +1111,9 @@ export declare const OverflowBlockSchema: z.ZodObject<{
             cancel?: string | undefined;
         } | undefined;
         disabled?: boolean | undefined;
+        hidden_for?: string[] | undefined;
+        visible_for?: string[] | undefined;
+        disabled_reason?: string | undefined;
     }[];
     label?: string | undefined;
 }, {
@@ -688,27 +1130,34 @@ export declare const OverflowBlockSchema: z.ZodObject<{
             cancel?: string | undefined;
         } | undefined;
         disabled?: boolean | undefined;
+        hidden_for?: string[] | undefined;
+        visible_for?: string[] | undefined;
+        disabled_reason?: string | undefined;
     }[];
     label?: string | undefined;
 }>;
 export type OverflowBlock = z.infer<typeof OverflowBlockSchema>;
-/** 진행률 바 (0~100). 에이전트가 m.replace 편집으로 갱신해 "스트리밍" 진행 표시 가능. */
+/**
+ * 진행률 바 (0~100). 에이전트가 m.replace 편집으로 갱신해 "스트리밍" 진행 표시 가능.
+ *
+ * 🔴 **톤 축이 없다** — 배지·콜아웃·메트릭과 갈리는 자리다. 이 블록의 렌더러는 shadcn `Progress`
+ * 이고 채움 색이 `bg-primary` 하나뿐이라(라이브러리에 그 축이 없다) 톤을 받아 봐야 그릴 곳이 없다.
+ * 색을 넣고 싶으면 스키마가 아니라 **렌더러부터** 물을 것(`docs/cob-to-shadcn-map.md` 의 `progress` 행).
+ * 진행 바 옆에서 성패를 말해야 하면 `label` 이나 형제 `badge`·`callout` 블록이 그 자리다.
+ */
 export declare const ProgressBlockSchema: z.ZodObject<{
     type: z.ZodLiteral<"progress">;
     /** 0~100 백분율(정수). 생략하면 indeterminate(불확정) 표시. 와이어 canonical JSON 은 소수 금지 → int 강제. */
     value: z.ZodOptional<z.ZodNumber>;
     label: z.ZodOptional<z.ZodString>;
-    tone: z.ZodOptional<z.ZodEnum<["neutral", "success", "warning", "danger", "info"]>>;
 }, "strip", z.ZodTypeAny, {
     type: "progress";
     value?: number | undefined;
     label?: string | undefined;
-    tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
 }, {
     type: "progress";
     value?: number | undefined;
     label?: string | undefined;
-    tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
 }>;
 /** 멀티스텝 진행 상태 표시(타임라인). 폼 마법사와 별개로, 작업 단계 시각화에 쓴다. */
 export declare const StepsBlockSchema: z.ZodObject<{
@@ -719,25 +1168,25 @@ export declare const StepsBlockSchema: z.ZodObject<{
         note: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         label: string;
-        status?: "done" | "active" | "todo" | "error" | undefined;
+        status?: "error" | "done" | "active" | "todo" | undefined;
         note?: string | undefined;
     }, {
         label: string;
-        status?: "done" | "active" | "todo" | "error" | undefined;
+        status?: "error" | "done" | "active" | "todo" | undefined;
         note?: string | undefined;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     type: "steps";
     items: {
         label: string;
-        status?: "done" | "active" | "todo" | "error" | undefined;
+        status?: "error" | "done" | "active" | "todo" | undefined;
         note?: string | undefined;
     }[];
 }, {
     type: "steps";
     items: {
         label: string;
-        status?: "done" | "active" | "todo" | "error" | undefined;
+        status?: "error" | "done" | "active" | "todo" | undefined;
         note?: string | undefined;
     }[];
 }>;
@@ -901,29 +1350,90 @@ export declare const ChartBlockSchema: z.ZodObject<{
     caption?: string | undefined;
 }>;
 export type ChartBlock = z.infer<typeof ChartBlockSchema>;
-/** 단일 아바타 — 얼굴 동그라미(이미지/이니셜) + 이름·보조텍스트 + 상태점. 담당자 표시. */
+/**
+ * 단일 아바타 — 얼굴 동그라미(이미지/이니셜) + 이름·보조텍스트 + 상태점. 담당자 표시.
+ *
+ * 🔴 **`color` 는 뺐다**(0.6.0). 이니셜 면은 shadcn `AvatarFallback` 의 `bg-muted` 한 벌이고
+ * 렌더러엔 그 색을 받을 자리가 없다 — 계약에 두면 작성자가 보내고 아무 일도 안 일어난다
+ * (`progress.tone` 을 뺀 것과 같은 이유). 누구인지는 이니셜·이름·프로필 사진이 나른다.
+ */
 export declare const AvatarBlockSchema: z.ZodObject<{
     type: z.ZodLiteral<"avatar">;
     name: z.ZodString;
     initials: z.ZodOptional<z.ZodString>;
-    color: z.ZodOptional<z.ZodString>;
     src: z.ZodOptional<z.ZodString>;
     subtitle: z.ZodOptional<z.ZodString>;
+    /**
+     * 이 아바타가 가리키는 사람/엔티티 (0.8.0). 있으면 렌더러가 해석 결과(이름·사진)로 `name`/`src` 를
+     * **덮어쓴다** — 방 상태가 정답이라 개명·프로필 변경이 즉시 반영된다.
+     * 🔴 `name` 은 평문 사본으로 남긴다: 해석기가 없거나(외부 임베더) 옛 클라면 그 문자열이 유일한 답이다.
+     */
+    ref: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
+        /** Matrix 사용자 id — `@local:server` 형태. 해석(이름·아바타)은 호스트가 주입한다(PeopleProvider). */
+        user: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        user: string;
+    }, {
+        user: string;
+    }>, z.ZodObject<{
+        /** 도메인 엔티티 — `entityRef` **블록**이 이미 쓰는 종류/식별자 짝이 값 안으로 들어온 것. */
+        entity: z.ZodObject<{
+            type: z.ZodString;
+            id: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            type: string;
+            id: string;
+        }, {
+            type: string;
+            id: string;
+        }>;
+        /** 클릭 시 이동할 https URL(선택). 출처는 클라가 검증한다. */
+        url: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        entity: {
+            type: string;
+            id: string;
+        };
+        url?: string | undefined;
+    }, {
+        entity: {
+            type: string;
+            id: string;
+        };
+        url?: string | undefined;
+    }>]>>;
+    /** 우하단 상태점 — 네 상태가 각자 색을 갖는다(`--cob-color-presence-*`). 색만으로 안 나르도록 `aria-label` 이 상태를 병기한다. */
     status: z.ZodOptional<z.ZodEnum<["online", "away", "busy", "offline"]>>;
 }, "strip", z.ZodTypeAny, {
     type: "avatar";
     name: string;
     status?: "online" | "away" | "busy" | "offline" | undefined;
+    ref?: {
+        user: string;
+    } | {
+        entity: {
+            type: string;
+            id: string;
+        };
+        url?: string | undefined;
+    } | undefined;
     initials?: string | undefined;
-    color?: string | undefined;
     src?: string | undefined;
     subtitle?: string | undefined;
 }, {
     type: "avatar";
     name: string;
     status?: "online" | "away" | "busy" | "offline" | undefined;
+    ref?: {
+        user: string;
+    } | {
+        entity: {
+            type: string;
+            id: string;
+        };
+        url?: string | undefined;
+    } | undefined;
     initials?: string | undefined;
-    color?: string | undefined;
     src?: string | undefined;
     subtitle?: string | undefined;
 }>;
@@ -935,19 +1445,15 @@ export declare const AvatarGroupBlockSchema: z.ZodObject<{
         name: z.ZodString;
         /** 이니셜(미지정 시 name 에서 자동 생성). */
         initials: z.ZodOptional<z.ZodString>;
-        /** 배경색(CSS 색/토큰). 미지정 시 name 해시로 팔레트에서 고름. */
-        color: z.ZodOptional<z.ZodString>;
         /** 이미지 URL(https). 있으면 이미지, 없으면 이니셜. */
         src: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         name: string;
         initials?: string | undefined;
-        color?: string | undefined;
         src?: string | undefined;
     }, {
         name: string;
         initials?: string | undefined;
-        color?: string | undefined;
         src?: string | undefined;
     }>, "many">;
     /** 앞에서 몇 명까지 보일지(기본 5). 나머지는 +N. */
@@ -958,7 +1464,6 @@ export declare const AvatarGroupBlockSchema: z.ZodObject<{
     people: {
         name: string;
         initials?: string | undefined;
-        color?: string | undefined;
         src?: string | undefined;
     }[];
     label?: string | undefined;
@@ -968,7 +1473,6 @@ export declare const AvatarGroupBlockSchema: z.ZodObject<{
     people: {
         name: string;
         initials?: string | undefined;
-        color?: string | undefined;
         src?: string | undefined;
     }[];
     label?: string | undefined;
@@ -1062,15 +1566,15 @@ export declare const EntityRefBlockSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     type: "entityRef";
     label: string;
-    tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
-    url?: string | undefined;
     entity?: string | undefined;
+    url?: string | undefined;
+    tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
 }, {
     type: "entityRef";
     label: string;
-    tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
-    url?: string | undefined;
     entity?: string | undefined;
+    url?: string | undefined;
+    tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
 }>;
 export type EntityRefBlock = z.infer<typeof EntityRefBlockSchema>;
 /**
@@ -1101,8 +1605,8 @@ export declare const KanbanBlockSchema: z.ZodObject<{
                 tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
             }>>;
         }, "strip", z.ZodTypeAny, {
-            title: string;
             id: string;
+            title: string;
             tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
             badge?: {
                 label: string;
@@ -1110,8 +1614,8 @@ export declare const KanbanBlockSchema: z.ZodObject<{
             } | undefined;
             meta?: string[] | undefined;
         }, {
-            title: string;
             id: string;
+            title: string;
             tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
             badge?: {
                 label: string;
@@ -1120,11 +1624,11 @@ export declare const KanbanBlockSchema: z.ZodObject<{
             meta?: string[] | undefined;
         }>, "many">;
     }, "strip", z.ZodTypeAny, {
-        title: string;
         id: string;
+        title: string;
         cards: {
-            title: string;
             id: string;
+            title: string;
             tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
             badge?: {
                 label: string;
@@ -1134,11 +1638,11 @@ export declare const KanbanBlockSchema: z.ZodObject<{
         }[];
         tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
     }, {
-        title: string;
         id: string;
+        title: string;
         cards: {
-            title: string;
             id: string;
+            title: string;
             tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
             badge?: {
                 label: string;
@@ -1152,11 +1656,11 @@ export declare const KanbanBlockSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     type: "kanban";
     columns: {
-        title: string;
         id: string;
+        title: string;
         cards: {
-            title: string;
             id: string;
+            title: string;
             tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
             badge?: {
                 label: string;
@@ -1170,11 +1674,11 @@ export declare const KanbanBlockSchema: z.ZodObject<{
 }, {
     type: "kanban";
     columns: {
-        title: string;
         id: string;
+        title: string;
         cards: {
-            title: string;
             id: string;
+            title: string;
             tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
             badge?: {
                 label: string;
@@ -1226,6 +1730,18 @@ export declare const CollapsibleBlockSchema: z.ZodObject<{
     /** 처음부터 펼쳐둘지(기본 접힘). */
     open: z.ZodOptional<z.ZodBoolean>;
     tone: z.ZodOptional<z.ZodEnum<["neutral", "success", "warning", "danger", "info"]>>;
+    /**
+     * **옛 클라용 사본이라는 표식**(0.8.0). 빌더가 새 블록을 낼 때 같은 내용을 이 접기 블록으로 병기하고
+     * 여기에 원본 블록 타입을 적는다.
+     *
+     * 왜 필요한가: 새 *블록 타입*은 `dropUnknownBlocks` 에서 **통째로 떨어진다**(키 추가와 달리 degrade
+     * 경로가 없다). 그래서 `activity` 는 빌더가 사본을 같이 내고, **새 렌더러는 원본을 아니까 사본을
+     * 안 그린다** — 안 그러면 새 클라에서 같은 이력이 두 번 보인다.
+     * 이 키를 모르는 옛 클라는 strip 하고 평범한 접기 블록으로 그린다(그게 목적이다).
+     *
+     * 전환기가 끝나 클라 배포가 충분히 퍼지면 빌더의 `legacy` 기본값을 false 로 바꾼다(이 시리즈 밖).
+     */
+    legacy_for: z.ZodOptional<z.ZodEnum<["activity"]>>;
     /**
      * 펼치면 보이는 중첩 블록(재귀). 런타임은 z.lazy 로 BlockSchema 를 지연 참조해 재귀 검증하지만,
      * 정적 타입은 z.ZodTypeAny 로 끊는다 — Block 이 z.infer 기반이라 재귀 타입 별칭이 conditional type
@@ -1238,20 +1754,217 @@ export declare const CollapsibleBlockSchema: z.ZodObject<{
     blocks: any[];
     tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
     open?: boolean | undefined;
+    legacy_for?: "activity" | undefined;
 }, {
     type: "collapsible";
     title: string;
     blocks: any[];
     tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
     open?: boolean | undefined;
+    legacy_for?: "activity" | undefined;
 }>;
 export type CollapsibleBlock = {
     type: "collapsible";
     title: string;
     open?: boolean;
     tone?: Tone;
+    legacy_for?: "activity";
     blocks: Block[];
 };
+/**
+ * **처리 이력**(0.8.0) — 참조가 주어인 시간순 목록. 이 시리즈의 **유일한 새 블록**이다.
+ *
+ * 왜 블록인가(감사 문서 C): "누가 · 무엇을 · 언제"는 지금 `collapsible` 안의 마크다운 텍스트로 산다.
+ * 그래서 접힌 상태에선 정보가 0이고, 펼쳐도 사람·시각에 구조가 없어 아바타도 상대 시각도 못 붙는다.
+ * 기존 블록의 새 축으로는 표현할 수 없는 모양이라("주어가 참조인 행의 목록") 블록이 정당하다.
+ *
+ * 🔴 **새 블록은 `dropUnknownBlocks` 에서 통째로 떨어진다** — 키 추가와 달리 degrade 경로가 없다.
+ * 그래서 빌더(`card.activity`)가 옛 클라용 `collapsible` 사본을 **같이** 낸다(`legacy_for: "activity"`).
+ *
+ * 항목은 **최신순**이다(맨 앞이 가장 최근). `maxVisible` 을 넘는 나머지는 렌더러가 접는다.
+ */
+export declare const ActivityBlockSchema: z.ZodObject<{
+    type: z.ZodLiteral<"activity">;
+    label: z.ZodOptional<z.ZodString>;
+    /** 펼쳐 둘 최근 항목 수(기본 3). 나머지는 "이전 N건 더 보기"로 접힌다. */
+    maxVisible: z.ZodOptional<z.ZodNumber>;
+    items: z.ZodArray<z.ZodObject<{
+        /** 행위의 주어 — 참조면 아바타·이름으로, 문자열이면 그대로. */
+        who: z.ZodUnion<[z.ZodString, z.ZodUnion<[z.ZodObject<{
+            /** Matrix 사용자 id — `@local:server` 형태. 해석(이름·아바타)은 호스트가 주입한다(PeopleProvider). */
+            user: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            user: string;
+        }, {
+            user: string;
+        }>, z.ZodObject<{
+            /** 도메인 엔티티 — `entityRef` **블록**이 이미 쓰는 종류/식별자 짝이 값 안으로 들어온 것. */
+            entity: z.ZodObject<{
+                type: z.ZodString;
+                id: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                type: string;
+                id: string;
+            }, {
+                type: string;
+                id: string;
+            }>;
+            /** 클릭 시 이동할 https URL(선택). 출처는 클라가 검증한다. */
+            url: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            entity: {
+                type: string;
+                id: string;
+            };
+            url?: string | undefined;
+        }, {
+            entity: {
+                type: string;
+                id: string;
+            };
+            url?: string | undefined;
+        }>]>]>;
+        /** 무엇을 했나 — 인라인 마크다운 허용(`text` 블록의 인라인 규칙과 같다). */
+        what: z.ZodString;
+        /** 언제 — ISO 8601 타임스탬프 문자열. 렌더러가 상대 시각으로 그린다. */
+        at: z.ZodString;
+        tone: z.ZodOptional<z.ZodEnum<["neutral", "success", "warning", "danger", "info"]>>;
+        /** 대상(선택) — "A 가 **B 에게** 전달" 의 B. */
+        to: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodUnion<[z.ZodObject<{
+            /** Matrix 사용자 id — `@local:server` 형태. 해석(이름·아바타)은 호스트가 주입한다(PeopleProvider). */
+            user: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            user: string;
+        }, {
+            user: string;
+        }>, z.ZodObject<{
+            /** 도메인 엔티티 — `entityRef` **블록**이 이미 쓰는 종류/식별자 짝이 값 안으로 들어온 것. */
+            entity: z.ZodObject<{
+                type: z.ZodString;
+                id: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                type: string;
+                id: string;
+            }, {
+                type: string;
+                id: string;
+            }>;
+            /** 클릭 시 이동할 https URL(선택). 출처는 클라가 검증한다. */
+            url: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            entity: {
+                type: string;
+                id: string;
+            };
+            url?: string | undefined;
+        }, {
+            entity: {
+                type: string;
+                id: string;
+            };
+            url?: string | undefined;
+        }>]>]>>;
+    }, "strip", z.ZodTypeAny, {
+        at: string;
+        who: string | {
+            user: string;
+        } | {
+            entity: {
+                type: string;
+                id: string;
+            };
+            url?: string | undefined;
+        };
+        what: string;
+        tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+        to?: string | {
+            user: string;
+        } | {
+            entity: {
+                type: string;
+                id: string;
+            };
+            url?: string | undefined;
+        } | undefined;
+    }, {
+        at: string;
+        who: string | {
+            user: string;
+        } | {
+            entity: {
+                type: string;
+                id: string;
+            };
+            url?: string | undefined;
+        };
+        what: string;
+        tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+        to?: string | {
+            user: string;
+        } | {
+            entity: {
+                type: string;
+                id: string;
+            };
+            url?: string | undefined;
+        } | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    type: "activity";
+    items: {
+        at: string;
+        who: string | {
+            user: string;
+        } | {
+            entity: {
+                type: string;
+                id: string;
+            };
+            url?: string | undefined;
+        };
+        what: string;
+        tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+        to?: string | {
+            user: string;
+        } | {
+            entity: {
+                type: string;
+                id: string;
+            };
+            url?: string | undefined;
+        } | undefined;
+    }[];
+    label?: string | undefined;
+    maxVisible?: number | undefined;
+}, {
+    type: "activity";
+    items: {
+        at: string;
+        who: string | {
+            user: string;
+        } | {
+            entity: {
+                type: string;
+                id: string;
+            };
+            url?: string | undefined;
+        };
+        what: string;
+        tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+        to?: string | {
+            user: string;
+        } | {
+            entity: {
+                type: string;
+                id: string;
+            };
+            url?: string | undefined;
+        } | undefined;
+    }[];
+    label?: string | undefined;
+    maxVisible?: number | undefined;
+}>;
+export type ActivityBlock = z.infer<typeof ActivityBlockSchema>;
 /**
  * 탈출구(escape hatch): A2UI/UI Blocks로 표현하기 어려운 무거운 UI(차트·대형 그리드·지도)는
  * Matrix Widget으로. 클라이언트가 신뢰 경계 안에서 sandboxed iframe으로 렌더한다.
@@ -1286,7 +1999,16 @@ export declare const WidgetBlockSchema: z.ZodObject<{
 export declare const BlockSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     type: z.ZodLiteral<"text">;
     text: z.ZodString;
-    /** true면 안전 화이트리스트 마크다운으로 렌더 (raw HTML 금지) */
+    /**
+     * true면 안전 화이트리스트 마크다운으로 렌더 (raw HTML 금지).
+     *
+     * 인라인: `**굵게**` `*기울임*` `` `코드` `` `[텍스트](http…)`.
+     * 블록: 문단(빈 줄) · 목록(`-` `*` `+` / `1.`, 중첩 가능) · 제목(`#`~`###`) · 인용(`>`) ·
+     *       구분선(`---`) · 펜스 코드(``` ```` ```).
+     * 표는 지원하지 않는다 — 표는 `table` 블록이 따로 있다.
+     *
+     * 플래그를 안 주면 평문이다(줄바꿈만 살아난다). 긴 글에는 켜는 쪽이 읽힌다 — #581.
+     */
     markdown: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     type: "text";
@@ -1339,6 +2061,44 @@ export declare const BlockSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
             text: string;
             tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
         }>, "many">>;
+        /**
+         * 이 값이 가리키는 사람/엔티티 (0.8.0). 있으면 렌더러가 칩(아바타+이름 / 종류+라벨)으로 그린다.
+         * 🔴 **`value` 는 평문 사본으로 남긴다** — `parts` 와 같은 규칙이다(RefSchema 머리말).
+         */
+        ref: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
+            /** Matrix 사용자 id — `@local:server` 형태. 해석(이름·아바타)은 호스트가 주입한다(PeopleProvider). */
+            user: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            user: string;
+        }, {
+            user: string;
+        }>, z.ZodObject<{
+            /** 도메인 엔티티 — `entityRef` **블록**이 이미 쓰는 종류/식별자 짝이 값 안으로 들어온 것. */
+            entity: z.ZodObject<{
+                type: z.ZodString;
+                id: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                type: string;
+                id: string;
+            }, {
+                type: string;
+                id: string;
+            }>;
+            /** 클릭 시 이동할 https URL(선택). 출처는 클라가 검증한다. */
+            url: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            entity: {
+                type: string;
+                id: string;
+            };
+            url?: string | undefined;
+        }, {
+            entity: {
+                type: string;
+                id: string;
+            };
+            url?: string | undefined;
+        }>]>>;
     }, "strip", z.ZodTypeAny, {
         value: string;
         label: string;
@@ -1347,6 +2107,15 @@ export declare const BlockSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
             text: string;
             tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
         }[] | undefined;
+        ref?: {
+            user: string;
+        } | {
+            entity: {
+                type: string;
+                id: string;
+            };
+            url?: string | undefined;
+        } | undefined;
     }, {
         value: string;
         label: string;
@@ -1355,6 +2124,15 @@ export declare const BlockSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
             text: string;
             tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
         }[] | undefined;
+        ref?: {
+            user: string;
+        } | {
+            entity: {
+                type: string;
+                id: string;
+            };
+            url?: string | undefined;
+        } | undefined;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     type: "fields";
@@ -1366,6 +2144,15 @@ export declare const BlockSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
             text: string;
             tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
         }[] | undefined;
+        ref?: {
+            user: string;
+        } | {
+            entity: {
+                type: string;
+                id: string;
+            };
+            url?: string | undefined;
+        } | undefined;
     }[];
 }, {
     type: "fields";
@@ -1377,6 +2164,15 @@ export declare const BlockSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
             text: string;
             tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
         }[] | undefined;
+        ref?: {
+            user: string;
+        } | {
+            entity: {
+                type: string;
+                id: string;
+            };
+            url?: string | undefined;
+        } | undefined;
     }[];
 }>, z.ZodObject<{
     type: z.ZodLiteral<"image">;
@@ -1396,7 +2192,6 @@ export declare const BlockSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     alt?: string | undefined;
 }>, z.ZodObject<{
     type: z.ZodLiteral<"context">;
-    /** 작은 보조 텍스트/아이콘 줄 */
     elements: z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
         icon: z.ZodString;
     }, "strip", z.ZodTypeAny, {
@@ -1453,17 +2248,14 @@ export declare const BlockSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     /** 0~100 백분율(정수). 생략하면 indeterminate(불확정) 표시. 와이어 canonical JSON 은 소수 금지 → int 강제. */
     value: z.ZodOptional<z.ZodNumber>;
     label: z.ZodOptional<z.ZodString>;
-    tone: z.ZodOptional<z.ZodEnum<["neutral", "success", "warning", "danger", "info"]>>;
 }, "strip", z.ZodTypeAny, {
     type: "progress";
     value?: number | undefined;
     label?: string | undefined;
-    tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
 }, {
     type: "progress";
     value?: number | undefined;
     label?: string | undefined;
-    tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
 }>, z.ZodObject<{
     type: z.ZodLiteral<"steps">;
     items: z.ZodArray<z.ZodObject<{
@@ -1472,25 +2264,25 @@ export declare const BlockSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
         note: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         label: string;
-        status?: "done" | "active" | "todo" | "error" | undefined;
+        status?: "error" | "done" | "active" | "todo" | undefined;
         note?: string | undefined;
     }, {
         label: string;
-        status?: "done" | "active" | "todo" | "error" | undefined;
+        status?: "error" | "done" | "active" | "todo" | undefined;
         note?: string | undefined;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     type: "steps";
     items: {
         label: string;
-        status?: "done" | "active" | "todo" | "error" | undefined;
+        status?: "error" | "done" | "active" | "todo" | undefined;
         note?: string | undefined;
     }[];
 }, {
     type: "steps";
     items: {
         label: string;
-        status?: "done" | "active" | "todo" | "error" | undefined;
+        status?: "error" | "done" | "active" | "todo" | undefined;
         note?: string | undefined;
     }[];
 }>, z.ZodObject<{
@@ -1565,24 +2357,79 @@ export declare const BlockSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     type: z.ZodLiteral<"avatar">;
     name: z.ZodString;
     initials: z.ZodOptional<z.ZodString>;
-    color: z.ZodOptional<z.ZodString>;
     src: z.ZodOptional<z.ZodString>;
     subtitle: z.ZodOptional<z.ZodString>;
+    /**
+     * 이 아바타가 가리키는 사람/엔티티 (0.8.0). 있으면 렌더러가 해석 결과(이름·사진)로 `name`/`src` 를
+     * **덮어쓴다** — 방 상태가 정답이라 개명·프로필 변경이 즉시 반영된다.
+     * 🔴 `name` 은 평문 사본으로 남긴다: 해석기가 없거나(외부 임베더) 옛 클라면 그 문자열이 유일한 답이다.
+     */
+    ref: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
+        /** Matrix 사용자 id — `@local:server` 형태. 해석(이름·아바타)은 호스트가 주입한다(PeopleProvider). */
+        user: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        user: string;
+    }, {
+        user: string;
+    }>, z.ZodObject<{
+        /** 도메인 엔티티 — `entityRef` **블록**이 이미 쓰는 종류/식별자 짝이 값 안으로 들어온 것. */
+        entity: z.ZodObject<{
+            type: z.ZodString;
+            id: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            type: string;
+            id: string;
+        }, {
+            type: string;
+            id: string;
+        }>;
+        /** 클릭 시 이동할 https URL(선택). 출처는 클라가 검증한다. */
+        url: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        entity: {
+            type: string;
+            id: string;
+        };
+        url?: string | undefined;
+    }, {
+        entity: {
+            type: string;
+            id: string;
+        };
+        url?: string | undefined;
+    }>]>>;
+    /** 우하단 상태점 — 네 상태가 각자 색을 갖는다(`--cob-color-presence-*`). 색만으로 안 나르도록 `aria-label` 이 상태를 병기한다. */
     status: z.ZodOptional<z.ZodEnum<["online", "away", "busy", "offline"]>>;
 }, "strip", z.ZodTypeAny, {
     type: "avatar";
     name: string;
     status?: "online" | "away" | "busy" | "offline" | undefined;
+    ref?: {
+        user: string;
+    } | {
+        entity: {
+            type: string;
+            id: string;
+        };
+        url?: string | undefined;
+    } | undefined;
     initials?: string | undefined;
-    color?: string | undefined;
     src?: string | undefined;
     subtitle?: string | undefined;
 }, {
     type: "avatar";
     name: string;
     status?: "online" | "away" | "busy" | "offline" | undefined;
+    ref?: {
+        user: string;
+    } | {
+        entity: {
+            type: string;
+            id: string;
+        };
+        url?: string | undefined;
+    } | undefined;
     initials?: string | undefined;
-    color?: string | undefined;
     src?: string | undefined;
     subtitle?: string | undefined;
 }>, z.ZodObject<{
@@ -1591,19 +2438,15 @@ export declare const BlockSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
         name: z.ZodString;
         /** 이니셜(미지정 시 name 에서 자동 생성). */
         initials: z.ZodOptional<z.ZodString>;
-        /** 배경색(CSS 색/토큰). 미지정 시 name 해시로 팔레트에서 고름. */
-        color: z.ZodOptional<z.ZodString>;
         /** 이미지 URL(https). 있으면 이미지, 없으면 이니셜. */
         src: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         name: string;
         initials?: string | undefined;
-        color?: string | undefined;
         src?: string | undefined;
     }, {
         name: string;
         initials?: string | undefined;
-        color?: string | undefined;
         src?: string | undefined;
     }>, "many">;
     /** 앞에서 몇 명까지 보일지(기본 5). 나머지는 +N. */
@@ -1614,7 +2457,6 @@ export declare const BlockSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     people: {
         name: string;
         initials?: string | undefined;
-        color?: string | undefined;
         src?: string | undefined;
     }[];
     label?: string | undefined;
@@ -1624,7 +2466,6 @@ export declare const BlockSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     people: {
         name: string;
         initials?: string | undefined;
-        color?: string | undefined;
         src?: string | undefined;
     }[];
     label?: string | undefined;
@@ -1706,15 +2547,15 @@ export declare const BlockSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     type: "entityRef";
     label: string;
-    tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
-    url?: string | undefined;
     entity?: string | undefined;
+    url?: string | undefined;
+    tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
 }, {
     type: "entityRef";
     label: string;
-    tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
-    url?: string | undefined;
     entity?: string | undefined;
+    url?: string | undefined;
+    tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
 }>, z.ZodObject<{
     type: z.ZodLiteral<"kanban">;
     columns: z.ZodArray<z.ZodObject<{
@@ -1738,8 +2579,8 @@ export declare const BlockSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
                 tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
             }>>;
         }, "strip", z.ZodTypeAny, {
-            title: string;
             id: string;
+            title: string;
             tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
             badge?: {
                 label: string;
@@ -1747,8 +2588,8 @@ export declare const BlockSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
             } | undefined;
             meta?: string[] | undefined;
         }, {
-            title: string;
             id: string;
+            title: string;
             tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
             badge?: {
                 label: string;
@@ -1757,11 +2598,11 @@ export declare const BlockSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
             meta?: string[] | undefined;
         }>, "many">;
     }, "strip", z.ZodTypeAny, {
-        title: string;
         id: string;
+        title: string;
         cards: {
-            title: string;
             id: string;
+            title: string;
             tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
             badge?: {
                 label: string;
@@ -1771,11 +2612,11 @@ export declare const BlockSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
         }[];
         tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
     }, {
-        title: string;
         id: string;
+        title: string;
         cards: {
-            title: string;
             id: string;
+            title: string;
             tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
             badge?: {
                 label: string;
@@ -1789,11 +2630,11 @@ export declare const BlockSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     type: "kanban";
     columns: {
-        title: string;
         id: string;
+        title: string;
         cards: {
-            title: string;
             id: string;
+            title: string;
             tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
             badge?: {
                 label: string;
@@ -1807,11 +2648,11 @@ export declare const BlockSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
 }, {
     type: "kanban";
     columns: {
-        title: string;
         id: string;
+        title: string;
         cards: {
-            title: string;
             id: string;
+            title: string;
             tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
             badge?: {
                 label: string;
@@ -1842,6 +2683,186 @@ export declare const BlockSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     label?: string | undefined;
     tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
     expiredText?: string | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"activity">;
+    label: z.ZodOptional<z.ZodString>;
+    /** 펼쳐 둘 최근 항목 수(기본 3). 나머지는 "이전 N건 더 보기"로 접힌다. */
+    maxVisible: z.ZodOptional<z.ZodNumber>;
+    items: z.ZodArray<z.ZodObject<{
+        /** 행위의 주어 — 참조면 아바타·이름으로, 문자열이면 그대로. */
+        who: z.ZodUnion<[z.ZodString, z.ZodUnion<[z.ZodObject<{
+            /** Matrix 사용자 id — `@local:server` 형태. 해석(이름·아바타)은 호스트가 주입한다(PeopleProvider). */
+            user: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            user: string;
+        }, {
+            user: string;
+        }>, z.ZodObject<{
+            /** 도메인 엔티티 — `entityRef` **블록**이 이미 쓰는 종류/식별자 짝이 값 안으로 들어온 것. */
+            entity: z.ZodObject<{
+                type: z.ZodString;
+                id: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                type: string;
+                id: string;
+            }, {
+                type: string;
+                id: string;
+            }>;
+            /** 클릭 시 이동할 https URL(선택). 출처는 클라가 검증한다. */
+            url: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            entity: {
+                type: string;
+                id: string;
+            };
+            url?: string | undefined;
+        }, {
+            entity: {
+                type: string;
+                id: string;
+            };
+            url?: string | undefined;
+        }>]>]>;
+        /** 무엇을 했나 — 인라인 마크다운 허용(`text` 블록의 인라인 규칙과 같다). */
+        what: z.ZodString;
+        /** 언제 — ISO 8601 타임스탬프 문자열. 렌더러가 상대 시각으로 그린다. */
+        at: z.ZodString;
+        tone: z.ZodOptional<z.ZodEnum<["neutral", "success", "warning", "danger", "info"]>>;
+        /** 대상(선택) — "A 가 **B 에게** 전달" 의 B. */
+        to: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodUnion<[z.ZodObject<{
+            /** Matrix 사용자 id — `@local:server` 형태. 해석(이름·아바타)은 호스트가 주입한다(PeopleProvider). */
+            user: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            user: string;
+        }, {
+            user: string;
+        }>, z.ZodObject<{
+            /** 도메인 엔티티 — `entityRef` **블록**이 이미 쓰는 종류/식별자 짝이 값 안으로 들어온 것. */
+            entity: z.ZodObject<{
+                type: z.ZodString;
+                id: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                type: string;
+                id: string;
+            }, {
+                type: string;
+                id: string;
+            }>;
+            /** 클릭 시 이동할 https URL(선택). 출처는 클라가 검증한다. */
+            url: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            entity: {
+                type: string;
+                id: string;
+            };
+            url?: string | undefined;
+        }, {
+            entity: {
+                type: string;
+                id: string;
+            };
+            url?: string | undefined;
+        }>]>]>>;
+    }, "strip", z.ZodTypeAny, {
+        at: string;
+        who: string | {
+            user: string;
+        } | {
+            entity: {
+                type: string;
+                id: string;
+            };
+            url?: string | undefined;
+        };
+        what: string;
+        tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+        to?: string | {
+            user: string;
+        } | {
+            entity: {
+                type: string;
+                id: string;
+            };
+            url?: string | undefined;
+        } | undefined;
+    }, {
+        at: string;
+        who: string | {
+            user: string;
+        } | {
+            entity: {
+                type: string;
+                id: string;
+            };
+            url?: string | undefined;
+        };
+        what: string;
+        tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+        to?: string | {
+            user: string;
+        } | {
+            entity: {
+                type: string;
+                id: string;
+            };
+            url?: string | undefined;
+        } | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    type: "activity";
+    items: {
+        at: string;
+        who: string | {
+            user: string;
+        } | {
+            entity: {
+                type: string;
+                id: string;
+            };
+            url?: string | undefined;
+        };
+        what: string;
+        tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+        to?: string | {
+            user: string;
+        } | {
+            entity: {
+                type: string;
+                id: string;
+            };
+            url?: string | undefined;
+        } | undefined;
+    }[];
+    label?: string | undefined;
+    maxVisible?: number | undefined;
+}, {
+    type: "activity";
+    items: {
+        at: string;
+        who: string | {
+            user: string;
+        } | {
+            entity: {
+                type: string;
+                id: string;
+            };
+            url?: string | undefined;
+        };
+        what: string;
+        tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+        to?: string | {
+            user: string;
+        } | {
+            entity: {
+                type: string;
+                id: string;
+            };
+            url?: string | undefined;
+        } | undefined;
+    }[];
+    label?: string | undefined;
+    maxVisible?: number | undefined;
 }>, z.ZodObject<{
     type: z.ZodLiteral<"code">;
     code: z.ZodString;
@@ -1912,6 +2933,18 @@ export declare const BlockSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     /** 처음부터 펼쳐둘지(기본 접힘). */
     open: z.ZodOptional<z.ZodBoolean>;
     tone: z.ZodOptional<z.ZodEnum<["neutral", "success", "warning", "danger", "info"]>>;
+    /**
+     * **옛 클라용 사본이라는 표식**(0.8.0). 빌더가 새 블록을 낼 때 같은 내용을 이 접기 블록으로 병기하고
+     * 여기에 원본 블록 타입을 적는다.
+     *
+     * 왜 필요한가: 새 *블록 타입*은 `dropUnknownBlocks` 에서 **통째로 떨어진다**(키 추가와 달리 degrade
+     * 경로가 없다). 그래서 `activity` 는 빌더가 사본을 같이 내고, **새 렌더러는 원본을 아니까 사본을
+     * 안 그린다** — 안 그러면 새 클라에서 같은 이력이 두 번 보인다.
+     * 이 키를 모르는 옛 클라는 strip 하고 평범한 접기 블록으로 그린다(그게 목적이다).
+     *
+     * 전환기가 끝나 클라 배포가 충분히 퍼지면 빌더의 `legacy` 기본값을 false 로 바꾼다(이 시리즈 밖).
+     */
+    legacy_for: z.ZodOptional<z.ZodEnum<["activity"]>>;
     /**
      * 펼치면 보이는 중첩 블록(재귀). 런타임은 z.lazy 로 BlockSchema 를 지연 참조해 재귀 검증하지만,
      * 정적 타입은 z.ZodTypeAny 로 끊는다 — Block 이 z.infer 기반이라 재귀 타입 별칭이 conditional type
@@ -1924,12 +2957,14 @@ export declare const BlockSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     blocks: any[];
     tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
     open?: boolean | undefined;
+    legacy_for?: "activity" | undefined;
 }, {
     type: "collapsible";
     title: string;
     blocks: any[];
     tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
     open?: boolean | undefined;
+    legacy_for?: "activity" | undefined;
 }>, z.ZodObject<{
     type: z.ZodLiteral<"widget">;
     url: z.ZodString;
@@ -1976,26 +3011,68 @@ export declare const BlockSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
      * 단일 업로드로 동작한다(기능 축소일 뿐 파손 없음).
      */
     multiple: z.ZodOptional<z.ZodBoolean>;
+    /**
+     * 하한/상한 (0.7.0) — number/date/datetime/time 공용. **문자열**이다: 날짜·시각은 그 타입의 값
+     * 형식(`2026-09-22`·`18:15`)이고, number 면 숫자를 적은 문자열이다(와이어 canonical JSON 은
+     * 소수를 허용하지 않아 숫자 축을 열 수 없다 — `slider` 가 int 만 받는 것과 같은 제약).
+     *
+     * `"today"` 리터럴을 허용한다 — "기한은 오늘 이후"는 카드를 **보낸 날**이 아니라 **보는 날** 기준이라야
+     * 맞다(카드는 타임라인에 남고 며칠 뒤에도 눌린다). 렌더러가 그릴 때 해석한다.
+     *
+     * 🔴 **UX 다, 진실은 서버**(`hidden_for` 와 같은 자세). 클라가 미리 잠그는 건 헛걸음을 줄이려는
+     * 것뿐이고, 진짜 판정은 언제나 핸들러·게이트가 한다. 이 키를 모르는 옛 클라는 strip 하고 지금처럼
+     * 아무 제약 없이 제출한다 — 그러면 서버가 사람이 읽을 이유와 함께 거절한다(`action.result`).
+     */
+    min: z.ZodOptional<z.ZodString>;
+    max: z.ZodOptional<z.ZodString>;
+    /** 글자 수 하한/상한 (0.7.0) — 텍스트 계열 전용. 🔴 UX 다, 진실은 서버. */
+    minLength: z.ZodOptional<z.ZodNumber>;
+    maxLength: z.ZodOptional<z.ZodNumber>;
+    /**
+     * 값이 맞아야 하는 정규식 **소스**(0.7.0, 예: `"^[A-Z]{2}-\\d{4}$"`). 플래그·구분자 없이 패턴만 적는다.
+     *
+     * 🔴 렌더러는 `new RegExp` 를 **try/catch 로 감싼다** — 작성자가 자바스크립트가 아닌 방언(파이썬
+     * `(?P<x>…)` 등)을 보내면 던지는데, 그걸로 카드 전체가 죽으면 안 된다. 못 읽는 패턴은 무시한다
+     * (= 제약 없음). 진짜 판정은 여전히 서버다.
+     */
+    pattern: z.ZodOptional<z.ZodString>;
+    /**
+     * 제약 위반 시 보여 줄 **작성자 소유 문장**(0.7.0). 없으면 렌더러 크롬 문구를 쓴다
+     * (`LabelContext` — "누구의 문자열인가"가 경계선이고, 도메인 사정을 아는 문장은 작성자 것이다).
+     */
+    error: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     type: "input";
     name: string;
     value?: string | undefined;
     label?: string | undefined;
-    input?: "number" | "text" | "date" | "url" | "textarea" | "datetime" | "time" | "email" | "file" | undefined;
+    input?: "number" | "date" | "url" | "text" | "textarea" | "datetime" | "time" | "email" | "file" | undefined;
     placeholder?: string | undefined;
     required?: boolean | undefined;
     accept?: string | undefined;
     multiple?: boolean | undefined;
+    min?: string | undefined;
+    max?: string | undefined;
+    minLength?: number | undefined;
+    maxLength?: number | undefined;
+    pattern?: string | undefined;
+    error?: string | undefined;
 }, {
     type: "input";
     name: string;
     value?: string | undefined;
     label?: string | undefined;
-    input?: "number" | "text" | "date" | "url" | "textarea" | "datetime" | "time" | "email" | "file" | undefined;
+    input?: "number" | "date" | "url" | "text" | "textarea" | "datetime" | "time" | "email" | "file" | undefined;
     placeholder?: string | undefined;
     required?: boolean | undefined;
     accept?: string | undefined;
     multiple?: boolean | undefined;
+    min?: string | undefined;
+    max?: string | undefined;
+    minLength?: number | undefined;
+    maxLength?: number | undefined;
+    pattern?: string | undefined;
+    error?: string | undefined;
 }>, z.ZodObject<{
     type: z.ZodLiteral<"toggle">;
     name: z.ZodString;
@@ -2056,70 +3133,179 @@ export declare const BlockSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     options: z.ZodArray<z.ZodObject<{
         value: z.ZodString;
         label: z.ZodString;
+        hint: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         value: string;
         label: string;
+        hint?: string | undefined;
     }, {
         value: string;
         label: string;
+        hint?: string | undefined;
     }>, "many">;
     value: z.ZodOptional<z.ZodString>;
+    style: z.ZodOptional<z.ZodEnum<["cards", "segmented"]>>;
+    /** 고르지 않으면 제출을 잠근다 (0.7.0). 🔴 UX 다, 진실은 서버 — `input.required` 와 같은 자세. */
+    required: z.ZodOptional<z.ZodBoolean>;
+    /** 미선택 시 보여 줄 작성자 소유 문장 (0.7.0). 없으면 렌더러 크롬 문구. */
+    error: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     options: {
         value: string;
         label: string;
+        hint?: string | undefined;
     }[];
     type: "radio";
     name: string;
     value?: string | undefined;
     label?: string | undefined;
+    required?: boolean | undefined;
+    error?: string | undefined;
+    style?: "cards" | "segmented" | undefined;
 }, {
     options: {
         value: string;
         label: string;
+        hint?: string | undefined;
     }[];
     type: "radio";
     name: string;
     value?: string | undefined;
     label?: string | undefined;
+    required?: boolean | undefined;
+    error?: string | undefined;
+    style?: "cards" | "segmented" | undefined;
 }>, z.ZodObject<{
     type: z.ZodLiteral<"select">;
     name: z.ZodString;
     label: z.ZodOptional<z.ZodString>;
     placeholder: z.ZodOptional<z.ZodString>;
+    /**
+     * 후보 목록. `ref`(0.8.0)를 주면 렌더러가 행을 칩(아바타·이름·MXID)으로 그린다 —
+     * 🔴 `label` 은 평문 사본으로 남긴다(RefSchema 머리말). 그리는 쪽은 P5(선택 모델)가 맡는다.
+     */
     options: z.ZodArray<z.ZodObject<{
         value: z.ZodString;
         label: z.ZodString;
+        ref: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
+            /** Matrix 사용자 id — `@local:server` 형태. 해석(이름·아바타)은 호스트가 주입한다(PeopleProvider). */
+            user: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            user: string;
+        }, {
+            user: string;
+        }>, z.ZodObject<{
+            /** 도메인 엔티티 — `entityRef` **블록**이 이미 쓰는 종류/식별자 짝이 값 안으로 들어온 것. */
+            entity: z.ZodObject<{
+                type: z.ZodString;
+                id: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                type: string;
+                id: string;
+            }, {
+                type: string;
+                id: string;
+            }>;
+            /** 클릭 시 이동할 https URL(선택). 출처는 클라가 검증한다. */
+            url: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            entity: {
+                type: string;
+                id: string;
+            };
+            url?: string | undefined;
+        }, {
+            entity: {
+                type: string;
+                id: string;
+            };
+            url?: string | undefined;
+        }>]>>;
     }, "strip", z.ZodTypeAny, {
         value: string;
         label: string;
+        ref?: {
+            user: string;
+        } | {
+            entity: {
+                type: string;
+                id: string;
+            };
+            url?: string | undefined;
+        } | undefined;
     }, {
         value: string;
         label: string;
+        ref?: {
+            user: string;
+        } | {
+            entity: {
+                type: string;
+                id: string;
+            };
+            url?: string | undefined;
+        } | undefined;
     }>, "many">;
     value: z.ZodOptional<z.ZodString>;
     multi: z.ZodOptional<z.ZodBoolean>;
+    /** 고르지 않으면 제출을 잠근다 (0.7.0). 🔴 UX 다, 진실은 서버. */
+    required: z.ZodOptional<z.ZodBoolean>;
+    /**
+     * `multi: true` 전용 — **고른 개수**의 하한/상한 (0.7.0). 단일 선택에선 무시한다.
+     * (`input` 의 `min`/`max` 는 값의 크기라 문자열인데, 여기는 개수라 정수다.)
+     * 🔴 UX 다, 진실은 서버.
+     */
+    min: z.ZodOptional<z.ZodNumber>;
+    max: z.ZodOptional<z.ZodNumber>;
+    /** 제약 위반 시 보여 줄 작성자 소유 문장 (0.7.0). 없으면 렌더러 크롬 문구. */
+    error: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     options: {
         value: string;
         label: string;
+        ref?: {
+            user: string;
+        } | {
+            entity: {
+                type: string;
+                id: string;
+            };
+            url?: string | undefined;
+        } | undefined;
     }[];
     type: "select";
     name: string;
     value?: string | undefined;
     label?: string | undefined;
     placeholder?: string | undefined;
+    required?: boolean | undefined;
+    min?: number | undefined;
+    max?: number | undefined;
+    error?: string | undefined;
     multi?: boolean | undefined;
 }, {
     options: {
         value: string;
         label: string;
+        ref?: {
+            user: string;
+        } | {
+            entity: {
+                type: string;
+                id: string;
+            };
+            url?: string | undefined;
+        } | undefined;
     }[];
     type: "select";
     name: string;
     value?: string | undefined;
     label?: string | undefined;
     placeholder?: string | undefined;
+    required?: boolean | undefined;
+    min?: number | undefined;
+    max?: number | undefined;
+    error?: string | undefined;
     multi?: boolean | undefined;
 }>, z.ZodObject<{
     type: z.ZodLiteral<"checkbox">;
@@ -2136,6 +3322,36 @@ export declare const BlockSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     label: string;
     name: string;
     checked?: boolean | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"location">;
+    name: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    /**
+     * 왜 필요한지 한 줄 — **OS 권한창보다 먼저** 보인다. 시스템 문구(Info.plist·Android 권한창)는
+     * 앱 전체에 하나뿐이라 이 카드가 왜 묻는지는 여기서만 말할 수 있다(그리고 그게 심사가 보는 것이다).
+     */
+    purpose: z.ZodOptional<z.ZodString>;
+    required: z.ZodOptional<z.ZodBoolean>;
+    /** GPS 급 정확도로 받을지(느리고 배터리를 더 쓴다). 기본 false = 네트워크/대략 위치. */
+    precise: z.ZodOptional<z.ZodBoolean>;
+    /** 버튼 문구(작성자 소유 문장). 미지정이면 렌더러 크롬 문구를 쓴다. */
+    buttonText: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "location";
+    name: string;
+    label?: string | undefined;
+    required?: boolean | undefined;
+    purpose?: string | undefined;
+    precise?: boolean | undefined;
+    buttonText?: string | undefined;
+}, {
+    type: "location";
+    name: string;
+    label?: string | undefined;
+    required?: boolean | undefined;
+    purpose?: string | undefined;
+    precise?: boolean | undefined;
+    buttonText?: string | undefined;
 }>, z.ZodObject<{
     type: z.ZodLiteral<"button">;
     /** 어떤 액션인지 식별. 클릭 시 org.corp.ui.action.action_id 로 회신됨. */
@@ -2161,6 +3377,39 @@ export declare const BlockSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
         cancel?: string | undefined;
     }>>;
     disabled: z.ZodOptional<z.ZodBoolean>;
+    /**
+     * 이 MXID 들에게는 버튼을 **감춘다**(뷰어별 어포던스).
+     *
+     * 왜 필요한가: 카드 한 장은 방 전체가 같이 본다. 그런데 "이 사람만 절대 못 누르는 버튼"이 있다 —
+     * Forgejo 는 **자기 PR 자기 승인**을 422 로 거절한다(`approve your own pull is not allowed`).
+     * 그래서 작성자에게 Approve 를 보여 주면 눌러도 실패 카드만 쌓인다. 카드 전체에서 버튼을 빼면
+     * 남들이 승인을 못 하므로, 판정은 **보는 사람별**이어야 한다.
+     *
+     * 🔴 **권한이 아니다.** 진짜 게이트는 언제나 서버다(disabled/confirm 과 같은 자세) — 이건 없는
+     * 어포던스를 안 보여 주기 위한 것뿐이다. 그래서 이 키를 모르는 옛 클라이언트가 버튼을 그대로
+     * 보여 줘도 안전하다(누르면 서버가 사람이 읽을 이유와 함께 거절한다).
+     */
+    hidden_for: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /**
+     * `hidden_for` 의 **짝**(0.7.0) — 이 MXID 들에게만 버튼을 보인다(화이트리스트).
+     *
+     * 왜 둘 다 있나: 두 축은 아는 것이 다르다. `hidden_for` 는 "이 사람은 절대 못 누른다"를 아는 경우고
+     * (자기 PR 자기 승인), `visible_for` 는 "이 사람만 누를 수 있다"를 아는 경우다(현재 수신자). 후자를
+     * `hidden_for` 로 쓰려면 방 멤버 전원을 열거해야 하고, 그 목록은 카드를 만든 **순간**에 굳는다 —
+     * 나중에 들어온 사람에게 버튼이 그냥 보인다.
+     *
+     * 🔴 **둘 다 있으면 `hidden_for` 가 이긴다.** "못 누른다"가 "누를 수 있다"보다 강한 진술이라서다
+     * (겹치는 경우는 보통 작성자의 실수이고, 그때 안전한 쪽은 감추는 쪽이다).
+     * 🔴 **권한이 아니다** — `hidden_for` 와 똑같이 UX 고, 진짜 게이트는 언제나 서버다.
+     *   이 키를 모르는 옛 클라는 strip 하고 **전원에게** 버튼을 보인다 → 누르면 서버가 거절한다.
+     */
+    visible_for: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /**
+     * 버튼이 잠기거나 감춰진 **이유 한 줄**(0.7.0) — 사람이 읽을 문장(작성자 소유).
+     * `disabled` 면 버튼 옆 보조 텍스트로, `visible_for` 로 감춰졌으면 버튼 자리에 이 줄만 남는다.
+     * "눌러 봐야 안다"를 없애는 것이 요점이다. 🔴 UX 다, 진실은 서버.
+     */
+    disabled_reason: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     type: "button";
     text: string;
@@ -2174,6 +3423,9 @@ export declare const BlockSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
         cancel?: string | undefined;
     } | undefined;
     disabled?: boolean | undefined;
+    hidden_for?: string[] | undefined;
+    visible_for?: string[] | undefined;
+    disabled_reason?: string | undefined;
 }, {
     type: "button";
     text: string;
@@ -2187,6 +3439,9 @@ export declare const BlockSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
         cancel?: string | undefined;
     } | undefined;
     disabled?: boolean | undefined;
+    hidden_for?: string[] | undefined;
+    visible_for?: string[] | undefined;
+    disabled_reason?: string | undefined;
 }>, z.ZodObject<{
     type: z.ZodLiteral<"linkButton">;
     text: z.ZodString;
@@ -2197,14 +3452,14 @@ export declare const BlockSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     external: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     type: "linkButton";
-    text: string;
     url: string;
+    text: string;
     style?: "danger" | "default" | "primary" | undefined;
     external?: boolean | undefined;
 }, {
     type: "linkButton";
-    text: string;
     url: string;
+    text: string;
     style?: "danger" | "default" | "primary" | undefined;
     external?: boolean | undefined;
 }>, z.ZodObject<{
@@ -2234,6 +3489,39 @@ export declare const BlockSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
             cancel?: string | undefined;
         }>>;
         disabled: z.ZodOptional<z.ZodBoolean>;
+        /**
+         * 이 MXID 들에게는 버튼을 **감춘다**(뷰어별 어포던스).
+         *
+         * 왜 필요한가: 카드 한 장은 방 전체가 같이 본다. 그런데 "이 사람만 절대 못 누르는 버튼"이 있다 —
+         * Forgejo 는 **자기 PR 자기 승인**을 422 로 거절한다(`approve your own pull is not allowed`).
+         * 그래서 작성자에게 Approve 를 보여 주면 눌러도 실패 카드만 쌓인다. 카드 전체에서 버튼을 빼면
+         * 남들이 승인을 못 하므로, 판정은 **보는 사람별**이어야 한다.
+         *
+         * 🔴 **권한이 아니다.** 진짜 게이트는 언제나 서버다(disabled/confirm 과 같은 자세) — 이건 없는
+         * 어포던스를 안 보여 주기 위한 것뿐이다. 그래서 이 키를 모르는 옛 클라이언트가 버튼을 그대로
+         * 보여 줘도 안전하다(누르면 서버가 사람이 읽을 이유와 함께 거절한다).
+         */
+        hidden_for: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /**
+         * `hidden_for` 의 **짝**(0.7.0) — 이 MXID 들에게만 버튼을 보인다(화이트리스트).
+         *
+         * 왜 둘 다 있나: 두 축은 아는 것이 다르다. `hidden_for` 는 "이 사람은 절대 못 누른다"를 아는 경우고
+         * (자기 PR 자기 승인), `visible_for` 는 "이 사람만 누를 수 있다"를 아는 경우다(현재 수신자). 후자를
+         * `hidden_for` 로 쓰려면 방 멤버 전원을 열거해야 하고, 그 목록은 카드를 만든 **순간**에 굳는다 —
+         * 나중에 들어온 사람에게 버튼이 그냥 보인다.
+         *
+         * 🔴 **둘 다 있으면 `hidden_for` 가 이긴다.** "못 누른다"가 "누를 수 있다"보다 강한 진술이라서다
+         * (겹치는 경우는 보통 작성자의 실수이고, 그때 안전한 쪽은 감추는 쪽이다).
+         * 🔴 **권한이 아니다** — `hidden_for` 와 똑같이 UX 고, 진짜 게이트는 언제나 서버다.
+         *   이 키를 모르는 옛 클라는 strip 하고 **전원에게** 버튼을 보인다 → 누르면 서버가 거절한다.
+         */
+        visible_for: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /**
+         * 버튼이 잠기거나 감춰진 **이유 한 줄**(0.7.0) — 사람이 읽을 문장(작성자 소유).
+         * `disabled` 면 버튼 옆 보조 텍스트로, `visible_for` 로 감춰졌으면 버튼 자리에 이 줄만 남는다.
+         * "눌러 봐야 안다"를 없애는 것이 요점이다. 🔴 UX 다, 진실은 서버.
+         */
+        disabled_reason: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         type: "button";
         text: string;
@@ -2247,6 +3535,9 @@ export declare const BlockSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
             cancel?: string | undefined;
         } | undefined;
         disabled?: boolean | undefined;
+        hidden_for?: string[] | undefined;
+        visible_for?: string[] | undefined;
+        disabled_reason?: string | undefined;
     }, {
         type: "button";
         text: string;
@@ -2260,6 +3551,9 @@ export declare const BlockSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
             cancel?: string | undefined;
         } | undefined;
         disabled?: boolean | undefined;
+        hidden_for?: string[] | undefined;
+        visible_for?: string[] | undefined;
+        disabled_reason?: string | undefined;
     }>, z.ZodObject<{
         type: z.ZodLiteral<"linkButton">;
         text: z.ZodString;
@@ -2270,14 +3564,14 @@ export declare const BlockSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
         external: z.ZodOptional<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
         type: "linkButton";
-        text: string;
         url: string;
+        text: string;
         style?: "danger" | "default" | "primary" | undefined;
         external?: boolean | undefined;
     }, {
         type: "linkButton";
-        text: string;
         url: string;
+        text: string;
         style?: "danger" | "default" | "primary" | undefined;
         external?: boolean | undefined;
     }>]>, "many">;
@@ -2296,10 +3590,13 @@ export declare const BlockSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
             cancel?: string | undefined;
         } | undefined;
         disabled?: boolean | undefined;
+        hidden_for?: string[] | undefined;
+        visible_for?: string[] | undefined;
+        disabled_reason?: string | undefined;
     } | {
         type: "linkButton";
-        text: string;
         url: string;
+        text: string;
         style?: "danger" | "default" | "primary" | undefined;
         external?: boolean | undefined;
     })[];
@@ -2318,10 +3615,13 @@ export declare const BlockSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
             cancel?: string | undefined;
         } | undefined;
         disabled?: boolean | undefined;
+        hidden_for?: string[] | undefined;
+        visible_for?: string[] | undefined;
+        disabled_reason?: string | undefined;
     } | {
         type: "linkButton";
-        text: string;
         url: string;
+        text: string;
         style?: "danger" | "default" | "primary" | undefined;
         external?: boolean | undefined;
     })[];
@@ -2352,6 +3652,12 @@ export declare const BlockSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
             cancel?: string | undefined;
         }>>;
         disabled: z.ZodOptional<z.ZodBoolean>;
+        /** 이 MXID 들에게만 항목을 보인다 (0.7.0) — `ButtonBlockSchema.visible_for` 와 같은 규칙. 🔴 UX 다, 진실은 서버. */
+        visible_for: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /** 이 MXID 들에게 항목을 감춘다 (0.7.0) — 둘 다 있으면 이쪽이 이긴다(버튼과 같은 규칙). */
+        hidden_for: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /** 잠기거나 감춰진 이유 한 줄 (0.7.0, 작성자 소유 문장). 🔴 UX 다, 진실은 서버. */
+        disabled_reason: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         text: string;
         action_id: string;
@@ -2364,6 +3670,9 @@ export declare const BlockSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
             cancel?: string | undefined;
         } | undefined;
         disabled?: boolean | undefined;
+        hidden_for?: string[] | undefined;
+        visible_for?: string[] | undefined;
+        disabled_reason?: string | undefined;
     }, {
         text: string;
         action_id: string;
@@ -2376,6 +3685,9 @@ export declare const BlockSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
             cancel?: string | undefined;
         } | undefined;
         disabled?: boolean | undefined;
+        hidden_for?: string[] | undefined;
+        visible_for?: string[] | undefined;
+        disabled_reason?: string | undefined;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     type: "overflow";
@@ -2391,6 +3703,9 @@ export declare const BlockSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
             cancel?: string | undefined;
         } | undefined;
         disabled?: boolean | undefined;
+        hidden_for?: string[] | undefined;
+        visible_for?: string[] | undefined;
+        disabled_reason?: string | undefined;
     }[];
     label?: string | undefined;
 }, {
@@ -2407,6 +3722,9 @@ export declare const BlockSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
             cancel?: string | undefined;
         } | undefined;
         disabled?: boolean | undefined;
+        hidden_for?: string[] | undefined;
+        visible_for?: string[] | undefined;
+        disabled_reason?: string | undefined;
     }[];
     label?: string | undefined;
 }>]>;