@reopt-ai/opt-ui 1.5.0 → 1.6.0

package/dist/docs/03-recipes/03-layouts.md

@@ -7,7 +7,7 @@ related:
     - ../02-components/03-shells.md
 ---
 
-<!-- AI agent hint: Surface/페이지 루트에 직접 space-y-* 사용 금지. 반드시 SurfaceLayout 또는 createSurface 사용. -->
+<!-- AI agent hint: Block/페이지 루트에 직접 space-y-* 사용 금지. 반드시 BlockLayout 또는 createBlock 사용. 페이지 경계를 직접 맡으면 inset="section"을 지정. -->
 
 # Layout Recipes
 
@@ -111,14 +111,14 @@ export function AppLayout({ children }: { children: React.ReactNode }) {
 
 ## 2. Data Explorer Page
 
-FilterBar + DataTable + Pagination in a SurfaceLayout.
+FilterBar + DataTable + Pagination in a BlockLayout.
 
 ```tsx
 "use client";
 
 import { useState, useMemo } from "react";
 import {
-  SurfaceLayout,
+  BlockLayout,
   PageHeader,
   FilterBar,
   DataTable,
@@ -221,7 +221,7 @@ export function UserExplorerPage() {
   };
 
   return (
-    <SurfaceLayout>
+    <BlockLayout inset="section">
       <PageHeader
         title="사용자 관리"
         description={`총 ${filtered.length}명`}
@@ -253,20 +253,20 @@ export function UserExplorerPage() {
         currentPage={page}
         onPageChange={setPage}
       />
-    </SurfaceLayout>
+    </BlockLayout>
   );
 }
 ```
 
 ## 3. Settings Page with Vertical Tabs
 
-SurfaceLayout with VerticalTabs for section navigation and SettingsForm for each tab.
+BlockLayout with VerticalTabs for section navigation and SettingsForm for each tab.
 
 ```tsx
 "use client";
 
 import {
-  SurfaceLayout,
+  BlockLayout,
   PageHeader,
   VerticalTabs,
   SettingsForm,
@@ -391,7 +391,7 @@ const tabs: TabDef[] = [
 
 export function SettingsPage() {
   return (
-    <SurfaceLayout>
+    <BlockLayout inset="section">
       <PageHeader title="설정" description="프로젝트 설정을 관리합니다" />
 
       <VerticalTabs
@@ -399,7 +399,7 @@ export function SettingsPage() {
         defaultTabId="general"
         labels={{ ariaLabel: "설정 카테고리" }}
       />
-    </SurfaceLayout>
+    </BlockLayout>
   );
 }
 ```
@@ -408,14 +408,14 @@ export function SettingsPage() {
 
 | Element        | Approach                                                                  |
 | -------------- | ------------------------------------------------------------------------- |
-| Page root      | `SurfaceLayout` (provides `gap-section` between children)                 |
+| Page root      | `BlockLayout inset="section"` (page inset + `gap-section`)                |
 | App chrome     | `AppShell` + `AppShell.Header/Sidebar/Content/Footer`                     |
 | Sidebar nav    | `Sidebar` with `Sidebar.Header/Content/Footer` sub-components             |
-| Page title     | `PageHeader` with optional `description` and `actions` slot               |
+| Page title     | `PageHeader` with optional slots; outer inset belongs to the page root    |
 | Section grids  | `gap-group` between columns, `gap-element` for tight spacing              |
 | Tab navigation | `VerticalTabs` for left-side tabs, `ContentTabs` for horizontal           |
 | Pagination     | `Pagination` below `DataTable` with `totalItems`/`pageSize`/`currentPage` |
-| Loading state  | `SurfaceLayout loading={true}` wraps content with `LoadingOverlay`        |
+| Loading state  | `BlockLayout loading={true}` wraps content with `LoadingOverlay`          |
 
 ### Semantic Spacing Quick Reference
 
@@ -423,6 +423,10 @@ export function SettingsPage() {
 gap-section  ->  24px  (between major sections)
 gap-group    ->  16px  (between related items)
 gap-element  ->   8px  (between tightly coupled elements)
+p-section    ->  24px  (inside a page-owned content boundary)
 ```
 
 CSS variables: `--opt-space-section`, `--opt-space-group`, `--opt-space-element`.
+
+`BlockLayout`의 inset 기본값은 없음입니다. 재사용 Block이 카드나 Shell 안에 들어갈 때 이중
+여백이 생기지 않게 하고, 페이지 콘텐츠 경계를 맡는 호출부만 `inset="section"`을 명시합니다.

package/dist/docs/05-migration/01-breaking-changes.md

@@ -25,6 +25,34 @@ description: "opt-ui 버전별 Breaking/Deprecated 변경사항 레지스트리"
 
 ---
 
+## Version 1.5.0
+
+### Breaking
+
+- version: "1.5.0"
+  level: B
+  component: "Surface runtime exports"
+  change: "런타임 Surface export 제거 — opt-cli 블록 registry로 이관"
+  detail: "ChatAssistant, DataExplorer, DeploymentCenter 등 런타임 Surface와 createSurface가 @reopt-ai/opt-ui에서 더 이상 export되지 않습니다. 페이지 템플릿은 opt-cli 블록 registry(copy-paste)로 소비합니다."
+  scan: "ChatAssistant\\|DataExplorer\\|DeploymentCenter\\|createSurface"
+  fix:
+  type: manual
+  from: 'import { ChatAssistant } from "@reopt-ai/opt-ui"'
+  to: "npx @reopt-ai/opt-cli surface add <slug>"
+
+### Deprecated
+
+- version: "1.5.0"
+  level: D
+  component: "SurfaceLayout"
+  change: "SurfaceLayout deprecated → BlockLayout / createBlock"
+  detail: "SurfaceLayout이 deprecated 되었습니다. 페이지 간격·레이아웃은 BlockLayout 또는 createBlock을 사용하세요."
+  scan: "SurfaceLayout"
+  fix:
+  type: rename
+  from: "<SurfaceLayout>"
+  to: "<BlockLayout>"
+
 ## Version 1.2.0
 
 ### Breaking