@underdogai/mesh-event-schemas 0.1.0

package/dist/blocks.d.ts

@@ -0,0 +1,2320 @@
+/**
+ * UI Blocks — 채팅 타임라인에 인라인 렌더되는 선언적 UI 스키마.
+ *
+ * 설계 원칙 (docs/custom-event-ui.md 참조):
+ *  - 닫힌(화이트리스트) 컴포넌트 집합. 임의 HTML/코드 실행 없음.
+ *  - 순수 데이터(JSON). 렌더는 @chatops/ui-blocks(React)가 담당.
+ *  - 알 수 없는 블록 타입은 클라이언트가 안전한 fallback으로 렌더.
+ *  - 권한은 절대 클라이언트가 아니라 appservice(서버측)가 재검증한다. 여기 disabled/confirm은 UX일 뿐.
+ *
+ * A2UI를 쓰지 않는 대신 우리가 통제하는 이 스키마를 쓴다. 향후 A2UI로 교체 시,
+ * 이벤트 타입(org.corp.ui.card)은 그대로 두고 payload만 바꿔 렌더러를 갈아끼운다.
+ */
+import { z } from "zod";
+export declare const ToneSchema: z.ZodEnum<["neutral", "success", "warning", "danger", "info"]>;
+export type Tone = z.infer<typeof ToneSchema>;
+export declare const ButtonStyleSchema: z.ZodEnum<["default", "primary", "danger"]>;
+export type ButtonStyle = z.infer<typeof ButtonStyleSchema>;
+/** 파괴적 액션 전에 클라이언트가 띄우는 확인 다이얼로그. 서버도 별도로 HITL 재검증한다. */
+export declare const ConfirmSchema: z.ZodObject<{
+    title: z.ZodString;
+    text: z.ZodString;
+    ok: z.ZodOptional<z.ZodString>;
+    cancel: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    title: string;
+    text: string;
+    ok?: string | undefined;
+    cancel?: string | undefined;
+}, {
+    title: string;
+    text: string;
+    ok?: string | undefined;
+    cancel?: string | undefined;
+}>;
+export type Confirm = z.infer<typeof ConfirmSchema>;
+export declare const TextBlockSchema: z.ZodObject<{
+    type: z.ZodLiteral<"text">;
+    text: z.ZodString;
+    /** true면 안전 화이트리스트 마크다운으로 렌더 (raw HTML 금지) */
+    markdown: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    type: "text";
+    text: string;
+    markdown?: boolean | undefined;
+}, {
+    type: "text";
+    text: string;
+    markdown?: boolean | undefined;
+}>;
+export declare const HeadingBlockSchema: z.ZodObject<{
+    type: z.ZodLiteral<"heading">;
+    text: z.ZodString;
+    level: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>>;
+}, "strip", z.ZodTypeAny, {
+    type: "heading";
+    text: string;
+    level?: 1 | 2 | 3 | undefined;
+}, {
+    type: "heading";
+    text: string;
+    level?: 1 | 2 | 3 | undefined;
+}>;
+export declare const DividerBlockSchema: z.ZodObject<{
+    type: z.ZodLiteral<"divider">;
+}, "strip", z.ZodTypeAny, {
+    type: "divider";
+}, {
+    type: "divider";
+}>;
+export declare const FieldsBlockSchema: z.ZodObject<{
+    type: z.ZodLiteral<"fields">;
+    items: z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        value: z.ZodString;
+        /** true면 2열 그리드에 좁게 배치 */
+        short: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        value: string;
+        label: string;
+        short?: boolean | undefined;
+    }, {
+        value: string;
+        label: string;
+        short?: boolean | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    type: "fields";
+    items: {
+        value: string;
+        label: string;
+        short?: boolean | undefined;
+    }[];
+}, {
+    type: "fields";
+    items: {
+        value: string;
+        label: string;
+        short?: boolean | undefined;
+    }[];
+}>;
+export declare const ImageBlockSchema: z.ZodObject<{
+    type: z.ZodLiteral<"image">;
+    /** https URL 또는 mxc:// (둘 중 하나 권장). 클라이언트가 출처를 검증한다. */
+    url: z.ZodOptional<z.ZodString>;
+    mxc: z.ZodOptional<z.ZodString>;
+    alt: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "image";
+    url?: string | undefined;
+    mxc?: string | undefined;
+    alt?: string | undefined;
+}, {
+    type: "image";
+    url?: string | undefined;
+    mxc?: string | undefined;
+    alt?: string | undefined;
+}>;
+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, {
+        icon: string;
+    }, {
+        icon: string;
+    }>, z.ZodObject<{
+        mxc: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        mxc: string;
+    }, {
+        mxc: string;
+    }>]>, "many">;
+}, "strip", z.ZodTypeAny, {
+    type: "context";
+    elements: (string | {
+        icon: string;
+    } | {
+        mxc: string;
+    })[];
+}, {
+    type: "context";
+    elements: (string | {
+        icon: string;
+    } | {
+        mxc: string;
+    })[];
+}>;
+export declare const BadgeBlockSchema: z.ZodObject<{
+    type: z.ZodLiteral<"badge">;
+    text: z.ZodString;
+    tone: z.ZodOptional<z.ZodEnum<["neutral", "success", "warning", "danger", "info"]>>;
+}, "strip", z.ZodTypeAny, {
+    type: "badge";
+    text: string;
+    tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+}, {
+    type: "badge";
+    text: string;
+    tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+}>;
+export declare const TableBlockSchema: z.ZodObject<{
+    type: z.ZodLiteral<"table">;
+    columns: z.ZodArray<z.ZodString, "many">;
+    rows: z.ZodArray<z.ZodArray<z.ZodString, "many">, "many">;
+}, "strip", z.ZodTypeAny, {
+    type: "table";
+    columns: string[];
+    rows: string[][];
+}, {
+    type: "table";
+    columns: string[];
+    rows: string[][];
+}>;
+export declare const InputBlockSchema: z.ZodObject<{
+    type: z.ZodLiteral<"input">;
+    name: z.ZodString;
+    /** date=날짜, datetime=날짜+시각(네이티브 datetime-local), time=시각만 — 모두 네이티브 피커로 렌더. */
+    input: z.ZodOptional<z.ZodEnum<["text", "textarea", "number", "date", "datetime", "time"]>>;
+    label: z.ZodOptional<z.ZodString>;
+    placeholder: z.ZodOptional<z.ZodString>;
+    required: z.ZodOptional<z.ZodBoolean>;
+    value: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "input";
+    name: string;
+    value?: string | undefined;
+    label?: string | undefined;
+    input?: "number" | "text" | "date" | "textarea" | "datetime" | "time" | undefined;
+    placeholder?: string | undefined;
+    required?: boolean | undefined;
+}, {
+    type: "input";
+    name: string;
+    value?: string | undefined;
+    label?: string | undefined;
+    input?: "number" | "text" | "date" | "textarea" | "datetime" | "time" | undefined;
+    placeholder?: string | undefined;
+    required?: boolean | undefined;
+}>;
+/** 토글(스위치) — checkbox 와 같은 불리언을 수집하되 on/off 스위치 어포던스로 렌더. */
+export declare const ToggleBlockSchema: z.ZodObject<{
+    type: z.ZodLiteral<"toggle">;
+    name: z.ZodString;
+    label: z.ZodString;
+    checked: z.ZodOptional<z.ZodBoolean>;
+    /** 켜짐/꺼짐 보조 라벨(선택) — 스위치 옆 상태 텍스트. 색-only 회피용으로도 권장. */
+    onText: z.ZodOptional<z.ZodString>;
+    offText: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "toggle";
+    label: string;
+    name: string;
+    checked?: boolean | undefined;
+    onText?: string | undefined;
+    offText?: string | undefined;
+}, {
+    type: "toggle";
+    label: string;
+    name: string;
+    checked?: boolean | undefined;
+    onText?: string | undefined;
+    offText?: string | undefined;
+}>;
+export type ToggleBlock = z.infer<typeof ToggleBlockSchema>;
+/**
+ * 슬라이더(범위 입력) — min~max 사이 정수 한 값을 끌어서 고른다. 값은 name 으로 폼에 number 로 수집.
+ * 와이어 canonical JSON 은 소수 금지 → min/max/step/value 모두 정수 강제(정도/임계/배분 등).
+ */
+export declare const SliderBlockSchema: z.ZodObject<{
+    type: z.ZodLiteral<"slider">;
+    name: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    /** 하한(기본 0). */
+    min: z.ZodOptional<z.ZodNumber>;
+    /** 상한(기본 100). */
+    max: z.ZodOptional<z.ZodNumber>;
+    /** 증감 단위(기본 1). */
+    step: z.ZodOptional<z.ZodNumber>;
+    value: z.ZodOptional<z.ZodNumber>;
+    /** 현재값 옆 접미(예: "%", "건"). */
+    unit: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "slider";
+    name: string;
+    value?: number | undefined;
+    label?: string | undefined;
+    min?: number | undefined;
+    max?: number | undefined;
+    step?: number | undefined;
+    unit?: string | undefined;
+}, {
+    type: "slider";
+    name: string;
+    value?: number | undefined;
+    label?: string | undefined;
+    min?: number | undefined;
+    max?: number | undefined;
+    step?: number | undefined;
+    unit?: string | undefined;
+}>;
+export type SliderBlock = z.infer<typeof SliderBlockSchema>;
+/** 단일 선택 라디오 그룹. select 와 달리 옵션이 펼쳐져 보인다. */
+export declare const RadioBlockSchema: z.ZodObject<{
+    type: z.ZodLiteral<"radio">;
+    name: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    options: z.ZodArray<z.ZodObject<{
+        value: z.ZodString;
+        label: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        value: string;
+        label: string;
+    }, {
+        value: string;
+        label: string;
+    }>, "many">;
+    value: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    options: {
+        value: string;
+        label: string;
+    }[];
+    type: "radio";
+    name: string;
+    value?: string | undefined;
+    label?: string | undefined;
+}, {
+    options: {
+        value: string;
+        label: string;
+    }[];
+    type: "radio";
+    name: string;
+    value?: string | undefined;
+    label?: string | undefined;
+}>;
+export declare const SelectBlockSchema: z.ZodObject<{
+    type: z.ZodLiteral<"select">;
+    name: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    placeholder: z.ZodOptional<z.ZodString>;
+    options: z.ZodArray<z.ZodObject<{
+        value: z.ZodString;
+        label: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        value: string;
+        label: string;
+    }, {
+        value: string;
+        label: string;
+    }>, "many">;
+    value: z.ZodOptional<z.ZodString>;
+    multi: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    options: {
+        value: string;
+        label: string;
+    }[];
+    type: "select";
+    name: string;
+    value?: string | undefined;
+    label?: string | undefined;
+    placeholder?: string | undefined;
+    multi?: boolean | undefined;
+}, {
+    options: {
+        value: string;
+        label: string;
+    }[];
+    type: "select";
+    name: string;
+    value?: string | undefined;
+    label?: string | undefined;
+    placeholder?: string | undefined;
+    multi?: boolean | undefined;
+}>;
+export declare const CheckboxBlockSchema: z.ZodObject<{
+    type: z.ZodLiteral<"checkbox">;
+    name: z.ZodString;
+    label: z.ZodString;
+    checked: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    type: "checkbox";
+    label: string;
+    name: string;
+    checked?: boolean | undefined;
+}, {
+    type: "checkbox";
+    label: string;
+    name: string;
+    checked?: boolean | undefined;
+}>;
+export declare const ButtonBlockSchema: z.ZodObject<{
+    type: z.ZodLiteral<"button">;
+    /** 어떤 액션인지 식별. 클릭 시 org.corp.ui.action.action_id 로 회신됨. */
+    action_id: z.ZodString;
+    text: z.ZodString;
+    style: z.ZodOptional<z.ZodEnum<["default", "primary", "danger"]>>;
+    /** 버튼 고유 페이로드 (폼 값과 별개로 함께 전송) */
+    value: z.ZodOptional<z.ZodString>;
+    confirm: z.ZodOptional<z.ZodObject<{
+        title: z.ZodString;
+        text: z.ZodString;
+        ok: z.ZodOptional<z.ZodString>;
+        cancel: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+        text: string;
+        ok?: string | undefined;
+        cancel?: string | undefined;
+    }, {
+        title: string;
+        text: string;
+        ok?: string | undefined;
+        cancel?: string | undefined;
+    }>>;
+    disabled: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    type: "button";
+    text: string;
+    action_id: string;
+    value?: string | undefined;
+    style?: "danger" | "default" | "primary" | undefined;
+    confirm?: {
+        title: string;
+        text: string;
+        ok?: string | undefined;
+        cancel?: string | undefined;
+    } | undefined;
+    disabled?: boolean | undefined;
+}, {
+    type: "button";
+    text: string;
+    action_id: string;
+    value?: string | undefined;
+    style?: "danger" | "default" | "primary" | undefined;
+    confirm?: {
+        title: string;
+        text: string;
+        ok?: string | undefined;
+        cancel?: string | undefined;
+    } | undefined;
+    disabled?: boolean | undefined;
+}>;
+export type ButtonBlock = z.infer<typeof ButtonBlockSchema>;
+/**
+ * 링크 버튼 — action_id 로 회신하는 button 과 달리, https URL 로 이동만 한다(서버 왕복 없음).
+ * "Approve"(button, 액션) 옆에 "View PR"(linkButton, 이동)을 같은 줄에 두는 식. 출처는 클라가 검증.
+ */
+export declare const LinkButtonBlockSchema: z.ZodObject<{
+    type: z.ZodLiteral<"linkButton">;
+    text: z.ZodString;
+    /** 이동할 https URL. 클라이언트가 출처를 검증(아니면 비활성 표시). */
+    url: z.ZodString;
+    style: z.ZodOptional<z.ZodEnum<["default", "primary", "danger"]>>;
+    /** 새 탭으로 열기(기본 true). */
+    external: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    type: "linkButton";
+    text: string;
+    url: string;
+    style?: "danger" | "default" | "primary" | undefined;
+    external?: boolean | undefined;
+}, {
+    type: "linkButton";
+    text: string;
+    url: string;
+    style?: "danger" | "default" | "primary" | undefined;
+    external?: boolean | undefined;
+}>;
+export type LinkButtonBlock = z.infer<typeof LinkButtonBlockSchema>;
+/** 버튼 한 줄 묶음 — 액션 버튼(button)과 링크 버튼(linkButton)을 섞어 배치 가능. */
+export declare const ActionsBlockSchema: z.ZodObject<{
+    type: z.ZodLiteral<"actions">;
+    elements: z.ZodArray<z.ZodUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"button">;
+        /** 어떤 액션인지 식별. 클릭 시 org.corp.ui.action.action_id 로 회신됨. */
+        action_id: z.ZodString;
+        text: z.ZodString;
+        style: z.ZodOptional<z.ZodEnum<["default", "primary", "danger"]>>;
+        /** 버튼 고유 페이로드 (폼 값과 별개로 함께 전송) */
+        value: z.ZodOptional<z.ZodString>;
+        confirm: z.ZodOptional<z.ZodObject<{
+            title: z.ZodString;
+            text: z.ZodString;
+            ok: z.ZodOptional<z.ZodString>;
+            cancel: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            title: string;
+            text: string;
+            ok?: string | undefined;
+            cancel?: string | undefined;
+        }, {
+            title: string;
+            text: string;
+            ok?: string | undefined;
+            cancel?: string | undefined;
+        }>>;
+        disabled: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        type: "button";
+        text: string;
+        action_id: string;
+        value?: string | undefined;
+        style?: "danger" | "default" | "primary" | undefined;
+        confirm?: {
+            title: string;
+            text: string;
+            ok?: string | undefined;
+            cancel?: string | undefined;
+        } | undefined;
+        disabled?: boolean | undefined;
+    }, {
+        type: "button";
+        text: string;
+        action_id: string;
+        value?: string | undefined;
+        style?: "danger" | "default" | "primary" | undefined;
+        confirm?: {
+            title: string;
+            text: string;
+            ok?: string | undefined;
+            cancel?: string | undefined;
+        } | undefined;
+        disabled?: boolean | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"linkButton">;
+        text: z.ZodString;
+        /** 이동할 https URL. 클라이언트가 출처를 검증(아니면 비활성 표시). */
+        url: z.ZodString;
+        style: z.ZodOptional<z.ZodEnum<["default", "primary", "danger"]>>;
+        /** 새 탭으로 열기(기본 true). */
+        external: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        type: "linkButton";
+        text: string;
+        url: string;
+        style?: "danger" | "default" | "primary" | undefined;
+        external?: boolean | undefined;
+    }, {
+        type: "linkButton";
+        text: string;
+        url: string;
+        style?: "danger" | "default" | "primary" | undefined;
+        external?: boolean | undefined;
+    }>]>, "many">;
+}, "strip", z.ZodTypeAny, {
+    type: "actions";
+    elements: ({
+        type: "button";
+        text: string;
+        action_id: string;
+        value?: string | undefined;
+        style?: "danger" | "default" | "primary" | undefined;
+        confirm?: {
+            title: string;
+            text: string;
+            ok?: string | undefined;
+            cancel?: string | undefined;
+        } | undefined;
+        disabled?: boolean | undefined;
+    } | {
+        type: "linkButton";
+        text: string;
+        url: string;
+        style?: "danger" | "default" | "primary" | undefined;
+        external?: boolean | undefined;
+    })[];
+}, {
+    type: "actions";
+    elements: ({
+        type: "button";
+        text: string;
+        action_id: string;
+        value?: string | undefined;
+        style?: "danger" | "default" | "primary" | undefined;
+        confirm?: {
+            title: string;
+            text: string;
+            ok?: string | undefined;
+            cancel?: string | undefined;
+        } | undefined;
+        disabled?: boolean | undefined;
+    } | {
+        type: "linkButton";
+        text: string;
+        url: string;
+        style?: "danger" | "default" | "primary" | undefined;
+        external?: boolean | undefined;
+    })[];
+}>;
+/**
+ * 오버플로 메뉴 — "⋯" 트리거를 누르면 액션 항목 목록이 팝오버로 열린다(공간 절약형 액션 묶음).
+ * 각 항목은 button 과 동일하게 action_id 로 회신하고 confirm(파괴적 액션 확인)도 지원.
+ * 권한은 항상 서버가 재검증 — disabled/confirm 은 UX 일 뿐(button 과 동일 자세).
+ */
+export declare const OverflowBlockSchema: z.ZodObject<{
+    type: z.ZodLiteral<"overflow">;
+    /** 트리거 접근성 라벨(기본 "More actions"). */
+    label: z.ZodOptional<z.ZodString>;
+    items: z.ZodArray<z.ZodObject<{
+        action_id: z.ZodString;
+        text: z.ZodString;
+        value: z.ZodOptional<z.ZodString>;
+        /** danger 항목 강조(삭제 등). */
+        tone: z.ZodOptional<z.ZodEnum<["neutral", "success", "warning", "danger", "info"]>>;
+        confirm: z.ZodOptional<z.ZodObject<{
+            title: z.ZodString;
+            text: z.ZodString;
+            ok: z.ZodOptional<z.ZodString>;
+            cancel: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            title: string;
+            text: string;
+            ok?: string | undefined;
+            cancel?: string | undefined;
+        }, {
+            title: string;
+            text: string;
+            ok?: string | undefined;
+            cancel?: string | undefined;
+        }>>;
+        disabled: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        text: string;
+        action_id: string;
+        value?: string | undefined;
+        tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+        confirm?: {
+            title: string;
+            text: string;
+            ok?: string | undefined;
+            cancel?: string | undefined;
+        } | undefined;
+        disabled?: boolean | undefined;
+    }, {
+        text: string;
+        action_id: string;
+        value?: string | undefined;
+        tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+        confirm?: {
+            title: string;
+            text: string;
+            ok?: string | undefined;
+            cancel?: string | undefined;
+        } | undefined;
+        disabled?: boolean | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    type: "overflow";
+    items: {
+        text: string;
+        action_id: string;
+        value?: string | undefined;
+        tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+        confirm?: {
+            title: string;
+            text: string;
+            ok?: string | undefined;
+            cancel?: string | undefined;
+        } | undefined;
+        disabled?: boolean | undefined;
+    }[];
+    label?: string | undefined;
+}, {
+    type: "overflow";
+    items: {
+        text: string;
+        action_id: string;
+        value?: string | undefined;
+        tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+        confirm?: {
+            title: string;
+            text: string;
+            ok?: string | undefined;
+            cancel?: string | undefined;
+        } | undefined;
+        disabled?: boolean | undefined;
+    }[];
+    label?: string | undefined;
+}>;
+export type OverflowBlock = z.infer<typeof OverflowBlockSchema>;
+/** 진행률 바 (0~100). 에이전트가 m.replace 편집으로 갱신해 "스트리밍" 진행 표시 가능. */
+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<{
+    type: z.ZodLiteral<"steps">;
+    items: z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        status: z.ZodOptional<z.ZodEnum<["done", "active", "todo", "error"]>>;
+        note: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        label: string;
+        status?: "done" | "active" | "todo" | "error" | undefined;
+        note?: string | undefined;
+    }, {
+        label: string;
+        status?: "done" | "active" | "todo" | "error" | undefined;
+        note?: string | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    type: "steps";
+    items: {
+        label: string;
+        status?: "done" | "active" | "todo" | "error" | undefined;
+        note?: string | undefined;
+    }[];
+}, {
+    type: "steps";
+    items: {
+        label: string;
+        status?: "done" | "active" | "todo" | "error" | undefined;
+        note?: string | undefined;
+    }[];
+}>;
+/** 코드/JSON 표시 블록 (읽기 전용, 안전하게 escape 되어 렌더). */
+export declare const CodeBlockSchema: z.ZodObject<{
+    type: z.ZodLiteral<"code">;
+    code: z.ZodString;
+    language: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    code: string;
+    type: "code";
+    language?: string | undefined;
+}, {
+    code: string;
+    type: "code";
+    language?: string | undefined;
+}>;
+/**
+ * 코드 diff 블록 — unified patch(통합 diff) 텍스트를 줄 단위(추가/삭제/hunk/문맥)로 색칠해 표시.
+ * 입력은 SCM API 가 주는 그대로의 patch 문자열이고, 렌더러가 줄 첫 글자로 분류한다(표시 전용, escape,
+ * 임의 코드/HTML 없음 — code 블록과 같은 닫힌 자세). PR 리뷰처럼 "무엇이 바뀌었나"를 인라인으로 보여줄 때.
+ * 권위 데이터(전체 diff)는 url 로 재조회 — 여기 patch 는 리뷰용 표시 스냅샷이다.
+ */
+export declare const DiffBlockSchema: z.ZodObject<{
+    type: z.ZodLiteral<"diff">;
+    /** 파일 경로/제목(헤더에 표시). */
+    filename: z.ZodOptional<z.ZodString>;
+    /** unified diff(patch) 텍스트. 렌더러가 줄별로 +(add)/-(del)/@@(hunk)/그 외(context)로 분류. */
+    patch: z.ZodString;
+    /** 변경 통계(선택) — 헤더에 +N / -M 으로 표시. */
+    additions: z.ZodOptional<z.ZodNumber>;
+    deletions: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    type: "diff";
+    patch: string;
+    filename?: string | undefined;
+    additions?: number | undefined;
+    deletions?: number | undefined;
+}, {
+    type: "diff";
+    patch: string;
+    filename?: string | undefined;
+    additions?: number | undefined;
+    deletions?: number | undefined;
+}>;
+export type DiffBlock = z.infer<typeof DiffBlockSchema>;
+/**
+ * 파일/첨부 블록 — 단일 첨부(문서·이미지·아카이브)를 이름·크기·종류·다운로드로 표시.
+ * image 블록이 "본문에 펼쳐 보이는 그림"이라면, file 은 "다운로드 가능한 첨부 타일"이다(승인/재무/문서 흐름).
+ * url(https) 있으면 다운로드 링크, 없으면 정보 타일. mxc 는 인증 미디어(호스트 해석) — 출처는 클라가 검증.
+ */
+export declare const FileBlockSchema: z.ZodObject<{
+    type: z.ZodLiteral<"file">;
+    /** 파일명(표시). */
+    name: z.ZodString;
+    /** 바이트 크기(선택) — 렌더러가 KB/MB 로 표시. */
+    size: z.ZodOptional<z.ZodNumber>;
+    /** MIME 또는 확장자 힌트(아이콘/라벨). 예: "application/pdf", "png". */
+    mime: z.ZodOptional<z.ZodString>;
+    /** 다운로드 https URL(선택). 출처는 클라가 검증. */
+    url: z.ZodOptional<z.ZodString>;
+    /** mxc:// (선택) — 인증 미디어. 호스트가 해석. */
+    mxc: z.ZodOptional<z.ZodString>;
+    /** 보조 설명(선택). */
+    caption: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "file";
+    name: string;
+    url?: string | undefined;
+    mxc?: string | undefined;
+    size?: number | undefined;
+    mime?: string | undefined;
+    caption?: string | undefined;
+}, {
+    type: "file";
+    name: string;
+    url?: string | undefined;
+    mxc?: string | undefined;
+    size?: number | undefined;
+    mime?: string | undefined;
+    caption?: string | undefined;
+}>;
+export type FileBlock = z.infer<typeof FileBlockSchema>;
+/**
+ * 단일 지표(KPI) 블록 — 임팩트/공정률을 1급으로 표시.
+ * value(현재) + 선택 target(기준/목표)·delta(증감)·tone. "현재 / 목표 + 델타" 형태로 렌더.
+ */
+export declare const MetricBlockSchema: z.ZodObject<{
+    type: z.ZodLiteral<"metric">;
+    label: z.ZodString;
+    value: z.ZodString;
+    /** 기준/목표값 (선택) — value 와 함께 "현재 / 목표"로 표시 */
+    target: z.ZodOptional<z.ZodString>;
+    /** 증감 표시 (예: "+12") */
+    delta: z.ZodOptional<z.ZodString>;
+    tone: z.ZodOptional<z.ZodEnum<["neutral", "success", "warning", "danger", "info"]>>;
+}, "strip", z.ZodTypeAny, {
+    value: string;
+    type: "metric";
+    label: string;
+    tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+    target?: string | undefined;
+    delta?: string | undefined;
+}, {
+    value: string;
+    type: "metric";
+    label: string;
+    tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+    target?: string | undefined;
+    delta?: string | undefined;
+}>;
+/**
+ * 차트 블록 — 인라인 데이터 시각화(스파크라인/막대/꺾은선/도넛).
+ * 정적 SVG 로 렌더(임의 JS·HTML 없음, 닫힌 집합). data[] 는 값 묶음이고 variant 가 모양을 정한다.
+ * 무거운/인터랙티브 차트(대시보드·BI)는 여전히 widget 탈출구를 쓴다 — 이건 "가벼운 1급 시각화".
+ */
+export declare const ChartBlockSchema: z.ZodObject<{
+    type: z.ZodLiteral<"chart">;
+    variant: z.ZodEnum<["sparkline", "bar", "line", "donut"]>;
+    /** 데이터 포인트. sparkline/line 은 순서대로 잇고, bar/donut 은 각 항목이 막대/조각이 된다. */
+    data: z.ZodArray<z.ZodObject<{
+        label: z.ZodOptional<z.ZodString>;
+        value: z.ZodNumber;
+        tone: z.ZodOptional<z.ZodEnum<["neutral", "success", "warning", "danger", "info"]>>;
+    }, "strip", z.ZodTypeAny, {
+        value: number;
+        label?: string | undefined;
+        tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+    }, {
+        value: number;
+        label?: string | undefined;
+        tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+    }>, "many">;
+    /** 접근성/표시용 캡션(차트 제목). */
+    caption: z.ZodOptional<z.ZodString>;
+    /** bar/sparkline/line 스케일 상한(생략 시 데이터 최대값). donut 은 합계 기준이라 무시. */
+    max: z.ZodOptional<z.ZodNumber>;
+    /** 값 단위(예: "%", "건") — 표시 보조. */
+    unit: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "chart";
+    variant: "sparkline" | "bar" | "line" | "donut";
+    data: {
+        value: number;
+        label?: string | undefined;
+        tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+    }[];
+    max?: number | undefined;
+    unit?: string | undefined;
+    caption?: string | undefined;
+}, {
+    type: "chart";
+    variant: "sparkline" | "bar" | "line" | "donut";
+    data: {
+        value: number;
+        label?: string | undefined;
+        tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+    }[];
+    max?: number | undefined;
+    unit?: string | undefined;
+    caption?: string | undefined;
+}>;
+export type ChartBlock = z.infer<typeof ChartBlockSchema>;
+/** 단일 아바타 — 얼굴 동그라미(이미지/이니셜) + 이름·보조텍스트 + 상태점. 담당자 표시. */
+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>;
+    status: z.ZodOptional<z.ZodEnum<["online", "away", "busy", "offline"]>>;
+}, "strip", z.ZodTypeAny, {
+    type: "avatar";
+    name: string;
+    status?: "online" | "away" | "busy" | "offline" | undefined;
+    initials?: string | undefined;
+    color?: string | undefined;
+    src?: string | undefined;
+    subtitle?: string | undefined;
+}, {
+    type: "avatar";
+    name: string;
+    status?: "online" | "away" | "busy" | "offline" | undefined;
+    initials?: string | undefined;
+    color?: string | undefined;
+    src?: string | undefined;
+    subtitle?: string | undefined;
+}>;
+export type AvatarBlock = z.infer<typeof AvatarBlockSchema>;
+/** 아바타 묶음 — 겹쳐 쌓고 max 초과분은 +N. 리뷰어·참여자 표시. */
+export declare const AvatarGroupBlockSchema: z.ZodObject<{
+    type: z.ZodLiteral<"avatarGroup">;
+    people: z.ZodArray<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. */
+    max: z.ZodOptional<z.ZodNumber>;
+    label: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "avatarGroup";
+    people: {
+        name: string;
+        initials?: string | undefined;
+        color?: string | undefined;
+        src?: string | undefined;
+    }[];
+    label?: string | undefined;
+    max?: number | undefined;
+}, {
+    type: "avatarGroup";
+    people: {
+        name: string;
+        initials?: string | undefined;
+        color?: string | undefined;
+        src?: string | undefined;
+    }[];
+    label?: string | undefined;
+    max?: number | undefined;
+}>;
+export type AvatarGroupBlock = z.infer<typeof AvatarGroupBlockSchema>;
+/** 게이지 — 점수·리스크를 반원 아크로(0~max). 중앙에 값. */
+export declare const GaugeBlockSchema: z.ZodObject<{
+    type: z.ZodLiteral<"gauge">;
+    value: z.ZodNumber;
+    /** 스케일 상한(기본 100). */
+    max: z.ZodOptional<z.ZodNumber>;
+    /** 스케일 하한(기본 0). */
+    min: z.ZodOptional<z.ZodNumber>;
+    label: z.ZodOptional<z.ZodString>;
+    /** 중앙 값 접미(예: "%", "점"). */
+    unit: z.ZodOptional<z.ZodString>;
+    tone: z.ZodOptional<z.ZodEnum<["neutral", "success", "warning", "danger", "info"]>>;
+}, "strip", z.ZodTypeAny, {
+    value: number;
+    type: "gauge";
+    label?: string | undefined;
+    tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+    min?: number | undefined;
+    max?: number | undefined;
+    unit?: string | undefined;
+}, {
+    value: number;
+    type: "gauge";
+    label?: string | undefined;
+    tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+    min?: number | undefined;
+    max?: number | undefined;
+    unit?: string | undefined;
+}>;
+export type GaugeBlock = z.infer<typeof GaugeBlockSchema>;
+/** 별점 — value/max 를 심볼(★/●)로. 정확값은 숫자로 병기. */
+export declare const RatingBlockSchema: z.ZodObject<{
+    type: z.ZodLiteral<"rating">;
+    value: z.ZodNumber;
+    /** 만점(기본 5). */
+    max: z.ZodOptional<z.ZodNumber>;
+    label: z.ZodOptional<z.ZodString>;
+    /** 심볼 모양(기본 star). */
+    symbol: z.ZodOptional<z.ZodEnum<["star", "dot"]>>;
+}, "strip", z.ZodTypeAny, {
+    value: number;
+    type: "rating";
+    symbol?: "star" | "dot" | undefined;
+    label?: string | undefined;
+    max?: number | undefined;
+}, {
+    value: number;
+    type: "rating";
+    symbol?: "star" | "dot" | undefined;
+    label?: string | undefined;
+    max?: number | undefined;
+}>;
+export type RatingBlock = z.infer<typeof RatingBlockSchema>;
+/** 콜아웃 — 톤 강조 박스(정보/경고/위험 등). 선택 제목 + 본문 + 아이콘. */
+export declare const CalloutBlockSchema: z.ZodObject<{
+    type: z.ZodLiteral<"callout">;
+    text: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    tone: z.ZodOptional<z.ZodEnum<["neutral", "success", "warning", "danger", "info"]>>;
+    /** 아이콘 글리프(이모지/문자). 미지정 시 tone 기본 아이콘. */
+    icon: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "callout";
+    text: string;
+    title?: string | undefined;
+    icon?: string | undefined;
+    tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+}, {
+    type: "callout";
+    text: string;
+    title?: string | undefined;
+    icon?: string | undefined;
+    tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+}>;
+export type CalloutBlock = z.infer<typeof CalloutBlockSchema>;
+/** 엔티티 참조 칩 — 엔티티(송장·리드·repo…)로의 라벨/링크 칩. url 있으면 링크. */
+export declare const EntityRefBlockSchema: z.ZodObject<{
+    type: z.ZodLiteral<"entityRef">;
+    label: z.ZodString;
+    /** 엔티티 종류(예: "invoice","lead","repo") — 작은 종류 태그. */
+    entity: z.ZodOptional<z.ZodString>;
+    /** 클릭 시 이동할 https URL(있으면 링크, 출처는 클라가 검증). */
+    url: z.ZodOptional<z.ZodString>;
+    tone: z.ZodOptional<z.ZodEnum<["neutral", "success", "warning", "danger", "info"]>>;
+}, "strip", z.ZodTypeAny, {
+    type: "entityRef";
+    label: string;
+    url?: string | undefined;
+    tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+    entity?: string | undefined;
+}, {
+    type: "entityRef";
+    label: string;
+    url?: string | undefined;
+    tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+    entity?: string | undefined;
+}>;
+export type EntityRefBlock = z.infer<typeof EntityRefBlockSchema>;
+/**
+ * 칸반 보드 — 정적 표시 블록(닫힌 유니온). 컬럼(상태/스테이지)별 카드 묶음.
+ * 선택/드래그/클릭 액션 없음(표시 전용 — 인터랙션은 후속/위젯). 보드(컬럼+카드)는 템플릿 조합으로
+ * 표현 불가 → 코어 블록 프리미티브가 정당(P4-2). 어떤 도메인의 보드든 범용으로 쓴다.
+ */
+export declare const KanbanBlockSchema: z.ZodObject<{
+    type: z.ZodLiteral<"kanban">;
+    columns: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        tone: z.ZodOptional<z.ZodEnum<["neutral", "success", "warning", "danger", "info"]>>;
+        cards: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            tone: z.ZodOptional<z.ZodEnum<["neutral", "success", "warning", "danger", "info"]>>;
+            /** 보조행(라벨/담당 등) — 카드 제목 아래 표시. */
+            meta: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            badge: z.ZodOptional<z.ZodObject<{
+                label: z.ZodString;
+                tone: z.ZodOptional<z.ZodEnum<["neutral", "success", "warning", "danger", "info"]>>;
+            }, "strip", z.ZodTypeAny, {
+                label: string;
+                tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+            }, {
+                label: string;
+                tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            title: string;
+            id: string;
+            badge?: {
+                label: string;
+                tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+            } | undefined;
+            tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+            meta?: string[] | undefined;
+        }, {
+            title: string;
+            id: string;
+            badge?: {
+                label: string;
+                tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+            } | undefined;
+            tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+            meta?: string[] | undefined;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+        id: string;
+        cards: {
+            title: string;
+            id: string;
+            badge?: {
+                label: string;
+                tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+            } | undefined;
+            tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+            meta?: string[] | undefined;
+        }[];
+        tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+    }, {
+        title: string;
+        id: string;
+        cards: {
+            title: string;
+            id: string;
+            badge?: {
+                label: string;
+                tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+            } | undefined;
+            tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+            meta?: string[] | undefined;
+        }[];
+        tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+    }>, "many">;
+    caption: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "kanban";
+    columns: {
+        title: string;
+        id: string;
+        cards: {
+            title: string;
+            id: string;
+            badge?: {
+                label: string;
+                tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+            } | undefined;
+            tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+            meta?: string[] | undefined;
+        }[];
+        tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+    }[];
+    caption?: string | undefined;
+}, {
+    type: "kanban";
+    columns: {
+        title: string;
+        id: string;
+        cards: {
+            title: string;
+            id: string;
+            badge?: {
+                label: string;
+                tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+            } | undefined;
+            tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+            meta?: string[] | undefined;
+        }[];
+        tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+    }[];
+    caption?: string | undefined;
+}>;
+export type KanbanBlock = z.infer<typeof KanbanBlockSchema>;
+/**
+ * 카운트다운 — 마감 타임스탬프까지 남은 시간을 라이브로 보여주는 표시 블록(닫힌 유니온).
+ * 값(target ISO 타임스탬프)은 정적 데이터지만 렌더러가 매초 남은 시간을 계산·갱신("라이브 틱") →
+ * 정적 metric("resolve by HH:MM")으로 표현 불가하므로 블록이 정당(P4-3). SLA/SLO 위반까지 남은 시간 등.
+ */
+export declare const CountdownBlockSchema: z.ZodObject<{
+    type: z.ZodLiteral<"countdown">;
+    /** 마감 시각(ISO 8601 타임스탬프 문자열) — 렌더러가 new Date 로 파싱해 남은 시간을 계산. */
+    target: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    tone: z.ZodOptional<z.ZodEnum<["neutral", "success", "warning", "danger", "info"]>>;
+    /** 마감 경과 후 표시할 텍스트(기본 "Overdue"). */
+    expiredText: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "countdown";
+    target: string;
+    label?: string | undefined;
+    tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+    expiredText?: string | undefined;
+}, {
+    type: "countdown";
+    target: string;
+    label?: string | undefined;
+    tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+    expiredText?: string | undefined;
+}>;
+export type CountdownBlock = z.infer<typeof CountdownBlockSchema>;
+/**
+ * 접기/펼치기(disclosure) — 요약(title)만 보이다가 펼치면 중첩 블록을 드러낸다(native details/summary).
+ * 긴 보조 정보(로그·상세 필드·부가 첨부)를 카드 높이를 잡아먹지 않게 접어두는 레이아웃 블록.
+ * blocks 는 어떤 블록이든 중첩 가능 — 렌더러가 BlockList 로 재귀 렌더(닫힌 유니온 유지).
+ */
+export declare const CollapsibleBlockSchema: z.ZodObject<{
+    type: z.ZodLiteral<"collapsible">;
+    /** 접힌 상태에서도 보이는 요약 헤더. */
+    title: z.ZodString;
+    /** 처음부터 펼쳐둘지(기본 접힘). */
+    open: z.ZodOptional<z.ZodBoolean>;
+    tone: z.ZodOptional<z.ZodEnum<["neutral", "success", "warning", "danger", "info"]>>;
+    /**
+     * 펼치면 보이는 중첩 블록(재귀). 런타임은 z.lazy 로 BlockSchema 를 지연 참조해 재귀 검증하지만,
+     * 정적 타입은 z.ZodTypeAny 로 끊는다 — Block 이 z.infer 기반이라 재귀 타입 별칭이 conditional type
+     * 순환(TS2456)에 걸리기 때문. 작성자용 정확 타입은 아래 export 한 CollapsibleBlock 을 쓴다.
+     */
+    blocks: z.ZodArray<z.ZodLazy<z.ZodTypeAny>, "many">;
+}, "strip", z.ZodTypeAny, {
+    type: "collapsible";
+    title: string;
+    blocks: any[];
+    tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+    open?: boolean | undefined;
+}, {
+    type: "collapsible";
+    title: string;
+    blocks: any[];
+    tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+    open?: boolean | undefined;
+}>;
+export type CollapsibleBlock = {
+    type: "collapsible";
+    title: string;
+    open?: boolean;
+    tone?: Tone;
+    blocks: Block[];
+};
+/**
+ * 탈출구(escape hatch): A2UI/UI Blocks로 표현하기 어려운 무거운 UI(차트·대형 그리드·지도)는
+ * Matrix Widget으로. 클라이언트가 신뢰 경계 안에서 sandboxed iframe으로 렌더한다.
+ * url 은 클라이언트가 허용 출처를 검증해야 한다(RFC §D4 위젯).
+ */
+export declare const WidgetBlockSchema: z.ZodObject<{
+    type: z.ZodLiteral<"widget">;
+    url: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    /** 위젯 인스턴스 식별자 (브리지 라우팅용) */
+    widget_id: z.ZodOptional<z.ZodString>;
+    /** 호스트가 이 위젯에 부여하는 capability scope (최소권한). 예: ["action.send"] */
+    capabilities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** 렌더 높이(px). 기본은 클라이언트가 정함. */
+    height: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    type: "widget";
+    url: string;
+    name?: string | undefined;
+    widget_id?: string | undefined;
+    capabilities?: string[] | undefined;
+    height?: number | undefined;
+}, {
+    type: "widget";
+    url: string;
+    name?: string | undefined;
+    widget_id?: string | undefined;
+    capabilities?: string[] | undefined;
+    height?: number | undefined;
+}>;
+/** 모든 블록의 판별 유니온. 새 블록을 추가하면 여기에만 등록하면 된다. */
+export declare const BlockSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodLiteral<"text">;
+    text: z.ZodString;
+    /** true면 안전 화이트리스트 마크다운으로 렌더 (raw HTML 금지) */
+    markdown: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    type: "text";
+    text: string;
+    markdown?: boolean | undefined;
+}, {
+    type: "text";
+    text: string;
+    markdown?: boolean | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"heading">;
+    text: z.ZodString;
+    level: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>>;
+}, "strip", z.ZodTypeAny, {
+    type: "heading";
+    text: string;
+    level?: 1 | 2 | 3 | undefined;
+}, {
+    type: "heading";
+    text: string;
+    level?: 1 | 2 | 3 | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"divider">;
+}, "strip", z.ZodTypeAny, {
+    type: "divider";
+}, {
+    type: "divider";
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"fields">;
+    items: z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        value: z.ZodString;
+        /** true면 2열 그리드에 좁게 배치 */
+        short: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        value: string;
+        label: string;
+        short?: boolean | undefined;
+    }, {
+        value: string;
+        label: string;
+        short?: boolean | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    type: "fields";
+    items: {
+        value: string;
+        label: string;
+        short?: boolean | undefined;
+    }[];
+}, {
+    type: "fields";
+    items: {
+        value: string;
+        label: string;
+        short?: boolean | undefined;
+    }[];
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"image">;
+    /** https URL 또는 mxc:// (둘 중 하나 권장). 클라이언트가 출처를 검증한다. */
+    url: z.ZodOptional<z.ZodString>;
+    mxc: z.ZodOptional<z.ZodString>;
+    alt: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "image";
+    url?: string | undefined;
+    mxc?: string | undefined;
+    alt?: string | undefined;
+}, {
+    type: "image";
+    url?: string | undefined;
+    mxc?: string | undefined;
+    alt?: string | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"context">;
+    /** 작은 보조 텍스트/아이콘 줄 */
+    elements: z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+        icon: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        icon: string;
+    }, {
+        icon: string;
+    }>, z.ZodObject<{
+        mxc: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        mxc: string;
+    }, {
+        mxc: string;
+    }>]>, "many">;
+}, "strip", z.ZodTypeAny, {
+    type: "context";
+    elements: (string | {
+        icon: string;
+    } | {
+        mxc: string;
+    })[];
+}, {
+    type: "context";
+    elements: (string | {
+        icon: string;
+    } | {
+        mxc: string;
+    })[];
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"badge">;
+    text: z.ZodString;
+    tone: z.ZodOptional<z.ZodEnum<["neutral", "success", "warning", "danger", "info"]>>;
+}, "strip", z.ZodTypeAny, {
+    type: "badge";
+    text: string;
+    tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+}, {
+    type: "badge";
+    text: string;
+    tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"table">;
+    columns: z.ZodArray<z.ZodString, "many">;
+    rows: z.ZodArray<z.ZodArray<z.ZodString, "many">, "many">;
+}, "strip", z.ZodTypeAny, {
+    type: "table";
+    columns: string[];
+    rows: string[][];
+}, {
+    type: "table";
+    columns: string[];
+    rows: string[][];
+}>, 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;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"steps">;
+    items: z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        status: z.ZodOptional<z.ZodEnum<["done", "active", "todo", "error"]>>;
+        note: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        label: string;
+        status?: "done" | "active" | "todo" | "error" | undefined;
+        note?: string | undefined;
+    }, {
+        label: string;
+        status?: "done" | "active" | "todo" | "error" | undefined;
+        note?: string | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    type: "steps";
+    items: {
+        label: string;
+        status?: "done" | "active" | "todo" | "error" | undefined;
+        note?: string | undefined;
+    }[];
+}, {
+    type: "steps";
+    items: {
+        label: string;
+        status?: "done" | "active" | "todo" | "error" | undefined;
+        note?: string | undefined;
+    }[];
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"metric">;
+    label: z.ZodString;
+    value: z.ZodString;
+    /** 기준/목표값 (선택) — value 와 함께 "현재 / 목표"로 표시 */
+    target: z.ZodOptional<z.ZodString>;
+    /** 증감 표시 (예: "+12") */
+    delta: z.ZodOptional<z.ZodString>;
+    tone: z.ZodOptional<z.ZodEnum<["neutral", "success", "warning", "danger", "info"]>>;
+}, "strip", z.ZodTypeAny, {
+    value: string;
+    type: "metric";
+    label: string;
+    tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+    target?: string | undefined;
+    delta?: string | undefined;
+}, {
+    value: string;
+    type: "metric";
+    label: string;
+    tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+    target?: string | undefined;
+    delta?: string | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"chart">;
+    variant: z.ZodEnum<["sparkline", "bar", "line", "donut"]>;
+    /** 데이터 포인트. sparkline/line 은 순서대로 잇고, bar/donut 은 각 항목이 막대/조각이 된다. */
+    data: z.ZodArray<z.ZodObject<{
+        label: z.ZodOptional<z.ZodString>;
+        value: z.ZodNumber;
+        tone: z.ZodOptional<z.ZodEnum<["neutral", "success", "warning", "danger", "info"]>>;
+    }, "strip", z.ZodTypeAny, {
+        value: number;
+        label?: string | undefined;
+        tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+    }, {
+        value: number;
+        label?: string | undefined;
+        tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+    }>, "many">;
+    /** 접근성/표시용 캡션(차트 제목). */
+    caption: z.ZodOptional<z.ZodString>;
+    /** bar/sparkline/line 스케일 상한(생략 시 데이터 최대값). donut 은 합계 기준이라 무시. */
+    max: z.ZodOptional<z.ZodNumber>;
+    /** 값 단위(예: "%", "건") — 표시 보조. */
+    unit: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "chart";
+    variant: "sparkline" | "bar" | "line" | "donut";
+    data: {
+        value: number;
+        label?: string | undefined;
+        tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+    }[];
+    max?: number | undefined;
+    unit?: string | undefined;
+    caption?: string | undefined;
+}, {
+    type: "chart";
+    variant: "sparkline" | "bar" | "line" | "donut";
+    data: {
+        value: number;
+        label?: string | undefined;
+        tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+    }[];
+    max?: number | undefined;
+    unit?: string | undefined;
+    caption?: string | undefined;
+}>, 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>;
+    status: z.ZodOptional<z.ZodEnum<["online", "away", "busy", "offline"]>>;
+}, "strip", z.ZodTypeAny, {
+    type: "avatar";
+    name: string;
+    status?: "online" | "away" | "busy" | "offline" | undefined;
+    initials?: string | undefined;
+    color?: string | undefined;
+    src?: string | undefined;
+    subtitle?: string | undefined;
+}, {
+    type: "avatar";
+    name: string;
+    status?: "online" | "away" | "busy" | "offline" | undefined;
+    initials?: string | undefined;
+    color?: string | undefined;
+    src?: string | undefined;
+    subtitle?: string | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"avatarGroup">;
+    people: z.ZodArray<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. */
+    max: z.ZodOptional<z.ZodNumber>;
+    label: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "avatarGroup";
+    people: {
+        name: string;
+        initials?: string | undefined;
+        color?: string | undefined;
+        src?: string | undefined;
+    }[];
+    label?: string | undefined;
+    max?: number | undefined;
+}, {
+    type: "avatarGroup";
+    people: {
+        name: string;
+        initials?: string | undefined;
+        color?: string | undefined;
+        src?: string | undefined;
+    }[];
+    label?: string | undefined;
+    max?: number | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"gauge">;
+    value: z.ZodNumber;
+    /** 스케일 상한(기본 100). */
+    max: z.ZodOptional<z.ZodNumber>;
+    /** 스케일 하한(기본 0). */
+    min: z.ZodOptional<z.ZodNumber>;
+    label: z.ZodOptional<z.ZodString>;
+    /** 중앙 값 접미(예: "%", "점"). */
+    unit: z.ZodOptional<z.ZodString>;
+    tone: z.ZodOptional<z.ZodEnum<["neutral", "success", "warning", "danger", "info"]>>;
+}, "strip", z.ZodTypeAny, {
+    value: number;
+    type: "gauge";
+    label?: string | undefined;
+    tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+    min?: number | undefined;
+    max?: number | undefined;
+    unit?: string | undefined;
+}, {
+    value: number;
+    type: "gauge";
+    label?: string | undefined;
+    tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+    min?: number | undefined;
+    max?: number | undefined;
+    unit?: string | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"rating">;
+    value: z.ZodNumber;
+    /** 만점(기본 5). */
+    max: z.ZodOptional<z.ZodNumber>;
+    label: z.ZodOptional<z.ZodString>;
+    /** 심볼 모양(기본 star). */
+    symbol: z.ZodOptional<z.ZodEnum<["star", "dot"]>>;
+}, "strip", z.ZodTypeAny, {
+    value: number;
+    type: "rating";
+    symbol?: "star" | "dot" | undefined;
+    label?: string | undefined;
+    max?: number | undefined;
+}, {
+    value: number;
+    type: "rating";
+    symbol?: "star" | "dot" | undefined;
+    label?: string | undefined;
+    max?: number | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"callout">;
+    text: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    tone: z.ZodOptional<z.ZodEnum<["neutral", "success", "warning", "danger", "info"]>>;
+    /** 아이콘 글리프(이모지/문자). 미지정 시 tone 기본 아이콘. */
+    icon: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "callout";
+    text: string;
+    title?: string | undefined;
+    icon?: string | undefined;
+    tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+}, {
+    type: "callout";
+    text: string;
+    title?: string | undefined;
+    icon?: string | undefined;
+    tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"entityRef">;
+    label: z.ZodString;
+    /** 엔티티 종류(예: "invoice","lead","repo") — 작은 종류 태그. */
+    entity: z.ZodOptional<z.ZodString>;
+    /** 클릭 시 이동할 https URL(있으면 링크, 출처는 클라가 검증). */
+    url: z.ZodOptional<z.ZodString>;
+    tone: z.ZodOptional<z.ZodEnum<["neutral", "success", "warning", "danger", "info"]>>;
+}, "strip", z.ZodTypeAny, {
+    type: "entityRef";
+    label: string;
+    url?: string | undefined;
+    tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+    entity?: string | undefined;
+}, {
+    type: "entityRef";
+    label: string;
+    url?: string | undefined;
+    tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+    entity?: string | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"kanban">;
+    columns: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        tone: z.ZodOptional<z.ZodEnum<["neutral", "success", "warning", "danger", "info"]>>;
+        cards: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            tone: z.ZodOptional<z.ZodEnum<["neutral", "success", "warning", "danger", "info"]>>;
+            /** 보조행(라벨/담당 등) — 카드 제목 아래 표시. */
+            meta: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            badge: z.ZodOptional<z.ZodObject<{
+                label: z.ZodString;
+                tone: z.ZodOptional<z.ZodEnum<["neutral", "success", "warning", "danger", "info"]>>;
+            }, "strip", z.ZodTypeAny, {
+                label: string;
+                tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+            }, {
+                label: string;
+                tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            title: string;
+            id: string;
+            badge?: {
+                label: string;
+                tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+            } | undefined;
+            tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+            meta?: string[] | undefined;
+        }, {
+            title: string;
+            id: string;
+            badge?: {
+                label: string;
+                tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+            } | undefined;
+            tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+            meta?: string[] | undefined;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+        id: string;
+        cards: {
+            title: string;
+            id: string;
+            badge?: {
+                label: string;
+                tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+            } | undefined;
+            tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+            meta?: string[] | undefined;
+        }[];
+        tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+    }, {
+        title: string;
+        id: string;
+        cards: {
+            title: string;
+            id: string;
+            badge?: {
+                label: string;
+                tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+            } | undefined;
+            tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+            meta?: string[] | undefined;
+        }[];
+        tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+    }>, "many">;
+    caption: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "kanban";
+    columns: {
+        title: string;
+        id: string;
+        cards: {
+            title: string;
+            id: string;
+            badge?: {
+                label: string;
+                tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+            } | undefined;
+            tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+            meta?: string[] | undefined;
+        }[];
+        tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+    }[];
+    caption?: string | undefined;
+}, {
+    type: "kanban";
+    columns: {
+        title: string;
+        id: string;
+        cards: {
+            title: string;
+            id: string;
+            badge?: {
+                label: string;
+                tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+            } | undefined;
+            tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+            meta?: string[] | undefined;
+        }[];
+        tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+    }[];
+    caption?: string | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"countdown">;
+    /** 마감 시각(ISO 8601 타임스탬프 문자열) — 렌더러가 new Date 로 파싱해 남은 시간을 계산. */
+    target: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    tone: z.ZodOptional<z.ZodEnum<["neutral", "success", "warning", "danger", "info"]>>;
+    /** 마감 경과 후 표시할 텍스트(기본 "Overdue"). */
+    expiredText: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "countdown";
+    target: string;
+    label?: string | undefined;
+    tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+    expiredText?: string | undefined;
+}, {
+    type: "countdown";
+    target: string;
+    label?: string | undefined;
+    tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+    expiredText?: string | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"code">;
+    code: z.ZodString;
+    language: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    code: string;
+    type: "code";
+    language?: string | undefined;
+}, {
+    code: string;
+    type: "code";
+    language?: string | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"diff">;
+    /** 파일 경로/제목(헤더에 표시). */
+    filename: z.ZodOptional<z.ZodString>;
+    /** unified diff(patch) 텍스트. 렌더러가 줄별로 +(add)/-(del)/@@(hunk)/그 외(context)로 분류. */
+    patch: z.ZodString;
+    /** 변경 통계(선택) — 헤더에 +N / -M 으로 표시. */
+    additions: z.ZodOptional<z.ZodNumber>;
+    deletions: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    type: "diff";
+    patch: string;
+    filename?: string | undefined;
+    additions?: number | undefined;
+    deletions?: number | undefined;
+}, {
+    type: "diff";
+    patch: string;
+    filename?: string | undefined;
+    additions?: number | undefined;
+    deletions?: number | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"file">;
+    /** 파일명(표시). */
+    name: z.ZodString;
+    /** 바이트 크기(선택) — 렌더러가 KB/MB 로 표시. */
+    size: z.ZodOptional<z.ZodNumber>;
+    /** MIME 또는 확장자 힌트(아이콘/라벨). 예: "application/pdf", "png". */
+    mime: z.ZodOptional<z.ZodString>;
+    /** 다운로드 https URL(선택). 출처는 클라가 검증. */
+    url: z.ZodOptional<z.ZodString>;
+    /** mxc:// (선택) — 인증 미디어. 호스트가 해석. */
+    mxc: z.ZodOptional<z.ZodString>;
+    /** 보조 설명(선택). */
+    caption: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "file";
+    name: string;
+    url?: string | undefined;
+    mxc?: string | undefined;
+    size?: number | undefined;
+    mime?: string | undefined;
+    caption?: string | undefined;
+}, {
+    type: "file";
+    name: string;
+    url?: string | undefined;
+    mxc?: string | undefined;
+    size?: number | undefined;
+    mime?: string | undefined;
+    caption?: string | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"collapsible">;
+    /** 접힌 상태에서도 보이는 요약 헤더. */
+    title: z.ZodString;
+    /** 처음부터 펼쳐둘지(기본 접힘). */
+    open: z.ZodOptional<z.ZodBoolean>;
+    tone: z.ZodOptional<z.ZodEnum<["neutral", "success", "warning", "danger", "info"]>>;
+    /**
+     * 펼치면 보이는 중첩 블록(재귀). 런타임은 z.lazy 로 BlockSchema 를 지연 참조해 재귀 검증하지만,
+     * 정적 타입은 z.ZodTypeAny 로 끊는다 — Block 이 z.infer 기반이라 재귀 타입 별칭이 conditional type
+     * 순환(TS2456)에 걸리기 때문. 작성자용 정확 타입은 아래 export 한 CollapsibleBlock 을 쓴다.
+     */
+    blocks: z.ZodArray<z.ZodLazy<z.ZodTypeAny>, "many">;
+}, "strip", z.ZodTypeAny, {
+    type: "collapsible";
+    title: string;
+    blocks: any[];
+    tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+    open?: boolean | undefined;
+}, {
+    type: "collapsible";
+    title: string;
+    blocks: any[];
+    tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+    open?: boolean | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"widget">;
+    url: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    /** 위젯 인스턴스 식별자 (브리지 라우팅용) */
+    widget_id: z.ZodOptional<z.ZodString>;
+    /** 호스트가 이 위젯에 부여하는 capability scope (최소권한). 예: ["action.send"] */
+    capabilities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** 렌더 높이(px). 기본은 클라이언트가 정함. */
+    height: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    type: "widget";
+    url: string;
+    name?: string | undefined;
+    widget_id?: string | undefined;
+    capabilities?: string[] | undefined;
+    height?: number | undefined;
+}, {
+    type: "widget";
+    url: string;
+    name?: string | undefined;
+    widget_id?: string | undefined;
+    capabilities?: string[] | undefined;
+    height?: number | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"input">;
+    name: z.ZodString;
+    /** date=날짜, datetime=날짜+시각(네이티브 datetime-local), time=시각만 — 모두 네이티브 피커로 렌더. */
+    input: z.ZodOptional<z.ZodEnum<["text", "textarea", "number", "date", "datetime", "time"]>>;
+    label: z.ZodOptional<z.ZodString>;
+    placeholder: z.ZodOptional<z.ZodString>;
+    required: z.ZodOptional<z.ZodBoolean>;
+    value: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "input";
+    name: string;
+    value?: string | undefined;
+    label?: string | undefined;
+    input?: "number" | "text" | "date" | "textarea" | "datetime" | "time" | undefined;
+    placeholder?: string | undefined;
+    required?: boolean | undefined;
+}, {
+    type: "input";
+    name: string;
+    value?: string | undefined;
+    label?: string | undefined;
+    input?: "number" | "text" | "date" | "textarea" | "datetime" | "time" | undefined;
+    placeholder?: string | undefined;
+    required?: boolean | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"toggle">;
+    name: z.ZodString;
+    label: z.ZodString;
+    checked: z.ZodOptional<z.ZodBoolean>;
+    /** 켜짐/꺼짐 보조 라벨(선택) — 스위치 옆 상태 텍스트. 색-only 회피용으로도 권장. */
+    onText: z.ZodOptional<z.ZodString>;
+    offText: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "toggle";
+    label: string;
+    name: string;
+    checked?: boolean | undefined;
+    onText?: string | undefined;
+    offText?: string | undefined;
+}, {
+    type: "toggle";
+    label: string;
+    name: string;
+    checked?: boolean | undefined;
+    onText?: string | undefined;
+    offText?: string | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"slider">;
+    name: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    /** 하한(기본 0). */
+    min: z.ZodOptional<z.ZodNumber>;
+    /** 상한(기본 100). */
+    max: z.ZodOptional<z.ZodNumber>;
+    /** 증감 단위(기본 1). */
+    step: z.ZodOptional<z.ZodNumber>;
+    value: z.ZodOptional<z.ZodNumber>;
+    /** 현재값 옆 접미(예: "%", "건"). */
+    unit: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "slider";
+    name: string;
+    value?: number | undefined;
+    label?: string | undefined;
+    min?: number | undefined;
+    max?: number | undefined;
+    step?: number | undefined;
+    unit?: string | undefined;
+}, {
+    type: "slider";
+    name: string;
+    value?: number | undefined;
+    label?: string | undefined;
+    min?: number | undefined;
+    max?: number | undefined;
+    step?: number | undefined;
+    unit?: string | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"radio">;
+    name: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    options: z.ZodArray<z.ZodObject<{
+        value: z.ZodString;
+        label: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        value: string;
+        label: string;
+    }, {
+        value: string;
+        label: string;
+    }>, "many">;
+    value: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    options: {
+        value: string;
+        label: string;
+    }[];
+    type: "radio";
+    name: string;
+    value?: string | undefined;
+    label?: string | undefined;
+}, {
+    options: {
+        value: string;
+        label: string;
+    }[];
+    type: "radio";
+    name: string;
+    value?: string | undefined;
+    label?: string | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"select">;
+    name: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    placeholder: z.ZodOptional<z.ZodString>;
+    options: z.ZodArray<z.ZodObject<{
+        value: z.ZodString;
+        label: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        value: string;
+        label: string;
+    }, {
+        value: string;
+        label: string;
+    }>, "many">;
+    value: z.ZodOptional<z.ZodString>;
+    multi: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    options: {
+        value: string;
+        label: string;
+    }[];
+    type: "select";
+    name: string;
+    value?: string | undefined;
+    label?: string | undefined;
+    placeholder?: string | undefined;
+    multi?: boolean | undefined;
+}, {
+    options: {
+        value: string;
+        label: string;
+    }[];
+    type: "select";
+    name: string;
+    value?: string | undefined;
+    label?: string | undefined;
+    placeholder?: string | undefined;
+    multi?: boolean | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"checkbox">;
+    name: z.ZodString;
+    label: z.ZodString;
+    checked: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    type: "checkbox";
+    label: string;
+    name: string;
+    checked?: boolean | undefined;
+}, {
+    type: "checkbox";
+    label: string;
+    name: string;
+    checked?: boolean | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"button">;
+    /** 어떤 액션인지 식별. 클릭 시 org.corp.ui.action.action_id 로 회신됨. */
+    action_id: z.ZodString;
+    text: z.ZodString;
+    style: z.ZodOptional<z.ZodEnum<["default", "primary", "danger"]>>;
+    /** 버튼 고유 페이로드 (폼 값과 별개로 함께 전송) */
+    value: z.ZodOptional<z.ZodString>;
+    confirm: z.ZodOptional<z.ZodObject<{
+        title: z.ZodString;
+        text: z.ZodString;
+        ok: z.ZodOptional<z.ZodString>;
+        cancel: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+        text: string;
+        ok?: string | undefined;
+        cancel?: string | undefined;
+    }, {
+        title: string;
+        text: string;
+        ok?: string | undefined;
+        cancel?: string | undefined;
+    }>>;
+    disabled: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    type: "button";
+    text: string;
+    action_id: string;
+    value?: string | undefined;
+    style?: "danger" | "default" | "primary" | undefined;
+    confirm?: {
+        title: string;
+        text: string;
+        ok?: string | undefined;
+        cancel?: string | undefined;
+    } | undefined;
+    disabled?: boolean | undefined;
+}, {
+    type: "button";
+    text: string;
+    action_id: string;
+    value?: string | undefined;
+    style?: "danger" | "default" | "primary" | undefined;
+    confirm?: {
+        title: string;
+        text: string;
+        ok?: string | undefined;
+        cancel?: string | undefined;
+    } | undefined;
+    disabled?: boolean | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"linkButton">;
+    text: z.ZodString;
+    /** 이동할 https URL. 클라이언트가 출처를 검증(아니면 비활성 표시). */
+    url: z.ZodString;
+    style: z.ZodOptional<z.ZodEnum<["default", "primary", "danger"]>>;
+    /** 새 탭으로 열기(기본 true). */
+    external: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    type: "linkButton";
+    text: string;
+    url: string;
+    style?: "danger" | "default" | "primary" | undefined;
+    external?: boolean | undefined;
+}, {
+    type: "linkButton";
+    text: string;
+    url: string;
+    style?: "danger" | "default" | "primary" | undefined;
+    external?: boolean | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"actions">;
+    elements: z.ZodArray<z.ZodUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"button">;
+        /** 어떤 액션인지 식별. 클릭 시 org.corp.ui.action.action_id 로 회신됨. */
+        action_id: z.ZodString;
+        text: z.ZodString;
+        style: z.ZodOptional<z.ZodEnum<["default", "primary", "danger"]>>;
+        /** 버튼 고유 페이로드 (폼 값과 별개로 함께 전송) */
+        value: z.ZodOptional<z.ZodString>;
+        confirm: z.ZodOptional<z.ZodObject<{
+            title: z.ZodString;
+            text: z.ZodString;
+            ok: z.ZodOptional<z.ZodString>;
+            cancel: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            title: string;
+            text: string;
+            ok?: string | undefined;
+            cancel?: string | undefined;
+        }, {
+            title: string;
+            text: string;
+            ok?: string | undefined;
+            cancel?: string | undefined;
+        }>>;
+        disabled: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        type: "button";
+        text: string;
+        action_id: string;
+        value?: string | undefined;
+        style?: "danger" | "default" | "primary" | undefined;
+        confirm?: {
+            title: string;
+            text: string;
+            ok?: string | undefined;
+            cancel?: string | undefined;
+        } | undefined;
+        disabled?: boolean | undefined;
+    }, {
+        type: "button";
+        text: string;
+        action_id: string;
+        value?: string | undefined;
+        style?: "danger" | "default" | "primary" | undefined;
+        confirm?: {
+            title: string;
+            text: string;
+            ok?: string | undefined;
+            cancel?: string | undefined;
+        } | undefined;
+        disabled?: boolean | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"linkButton">;
+        text: z.ZodString;
+        /** 이동할 https URL. 클라이언트가 출처를 검증(아니면 비활성 표시). */
+        url: z.ZodString;
+        style: z.ZodOptional<z.ZodEnum<["default", "primary", "danger"]>>;
+        /** 새 탭으로 열기(기본 true). */
+        external: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        type: "linkButton";
+        text: string;
+        url: string;
+        style?: "danger" | "default" | "primary" | undefined;
+        external?: boolean | undefined;
+    }, {
+        type: "linkButton";
+        text: string;
+        url: string;
+        style?: "danger" | "default" | "primary" | undefined;
+        external?: boolean | undefined;
+    }>]>, "many">;
+}, "strip", z.ZodTypeAny, {
+    type: "actions";
+    elements: ({
+        type: "button";
+        text: string;
+        action_id: string;
+        value?: string | undefined;
+        style?: "danger" | "default" | "primary" | undefined;
+        confirm?: {
+            title: string;
+            text: string;
+            ok?: string | undefined;
+            cancel?: string | undefined;
+        } | undefined;
+        disabled?: boolean | undefined;
+    } | {
+        type: "linkButton";
+        text: string;
+        url: string;
+        style?: "danger" | "default" | "primary" | undefined;
+        external?: boolean | undefined;
+    })[];
+}, {
+    type: "actions";
+    elements: ({
+        type: "button";
+        text: string;
+        action_id: string;
+        value?: string | undefined;
+        style?: "danger" | "default" | "primary" | undefined;
+        confirm?: {
+            title: string;
+            text: string;
+            ok?: string | undefined;
+            cancel?: string | undefined;
+        } | undefined;
+        disabled?: boolean | undefined;
+    } | {
+        type: "linkButton";
+        text: string;
+        url: string;
+        style?: "danger" | "default" | "primary" | undefined;
+        external?: boolean | undefined;
+    })[];
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"overflow">;
+    /** 트리거 접근성 라벨(기본 "More actions"). */
+    label: z.ZodOptional<z.ZodString>;
+    items: z.ZodArray<z.ZodObject<{
+        action_id: z.ZodString;
+        text: z.ZodString;
+        value: z.ZodOptional<z.ZodString>;
+        /** danger 항목 강조(삭제 등). */
+        tone: z.ZodOptional<z.ZodEnum<["neutral", "success", "warning", "danger", "info"]>>;
+        confirm: z.ZodOptional<z.ZodObject<{
+            title: z.ZodString;
+            text: z.ZodString;
+            ok: z.ZodOptional<z.ZodString>;
+            cancel: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            title: string;
+            text: string;
+            ok?: string | undefined;
+            cancel?: string | undefined;
+        }, {
+            title: string;
+            text: string;
+            ok?: string | undefined;
+            cancel?: string | undefined;
+        }>>;
+        disabled: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        text: string;
+        action_id: string;
+        value?: string | undefined;
+        tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+        confirm?: {
+            title: string;
+            text: string;
+            ok?: string | undefined;
+            cancel?: string | undefined;
+        } | undefined;
+        disabled?: boolean | undefined;
+    }, {
+        text: string;
+        action_id: string;
+        value?: string | undefined;
+        tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+        confirm?: {
+            title: string;
+            text: string;
+            ok?: string | undefined;
+            cancel?: string | undefined;
+        } | undefined;
+        disabled?: boolean | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    type: "overflow";
+    items: {
+        text: string;
+        action_id: string;
+        value?: string | undefined;
+        tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+        confirm?: {
+            title: string;
+            text: string;
+            ok?: string | undefined;
+            cancel?: string | undefined;
+        } | undefined;
+        disabled?: boolean | undefined;
+    }[];
+    label?: string | undefined;
+}, {
+    type: "overflow";
+    items: {
+        text: string;
+        action_id: string;
+        value?: string | undefined;
+        tone?: "neutral" | "success" | "warning" | "danger" | "info" | undefined;
+        confirm?: {
+            title: string;
+            text: string;
+            ok?: string | undefined;
+            cancel?: string | undefined;
+        } | undefined;
+        disabled?: boolean | undefined;
+    }[];
+    label?: string | undefined;
+}>]>;
+export type Block = z.infer<typeof BlockSchema>;
+/** Block["type"] 리터럴 유니온 — 렌더러 레지스트리 키 타입으로 쓴다. */
+export type BlockType = Block["type"];
+/** 사용자 입력을 수집하는(name을 가진) 블록 타입. */
+export type InputBlock = Extract<Block, {
+    name: string;
+}>;
+/** 해당 블록이 사용자 입력을 수집하는(name을 가진) 블록인지 */
+export declare function isInputBlock(block: Block): block is InputBlock;
+//# sourceMappingURL=blocks.d.ts.map