pubuilder 0.3.0 → 0.5.0

package/README.md

@@ -33,7 +33,7 @@ npx pubuilder scan            # scan app/ or pages/ routes and draft ia.config.t
 npx pubuilder scan --dry-run  # preview without writing
 ```
 
-- First run drafts the config — you only polish titles and replace `[param]` segments with sample paths (e.g. `/artflo/1`).
+- First run drafts the config — you only polish titles and replace `[param]` segments with sample paths (e.g. `/agents/1`).
 - Re-running **merges**: your hand-tuned titles, hierarchy, and variants are preserved; only new routes are added. Routes that disappeared are reported, never deleted.
 - Keep `ia.config.ts` a pure data file (it is actually loaded during scan).
 - Non-Next.js projects aren't scannable yet (v1) — the CLI generates an annotated template to start from instead.
@@ -42,7 +42,7 @@ npx pubuilder scan --dry-run  # preview without writing
 
 ```ts
 // ia.config.ts
-import { defineIA } from 'pubuilder'
+import { defineIA } from 'pubuilder/config'
 
 export default defineIA({
   pages: [
@@ -57,7 +57,7 @@ export default defineIA({
           // screens that differ by query string become child nodes
           variants: [
             { title: 'All', query: { category: 'all' } },
-            { title: 'Art', query: { category: 'art', tab: 1 } },
+            { title: 'Coding', query: { category: 'coding', tab: 1 } },
           ],
         },
         { path: 'https://example.com/brand', title: 'Brand', external: true },
@@ -72,6 +72,29 @@ export default defineIA({
 - `external` — link-out node, no thumbnail/inspection (auto-detected for `http(s)://`)
 - `viewport` — virtual viewport for thumbnails, default `1440x900`
 
+## AI publishing
+
+Select a block in the minimap, paste a Figma node URL, and a local `claude` CLI process publishes it for you.
+
+- Runs via **your own** Claude account (`claude login`) — pubuilder never stores an API key
+- Skill drawer (🧰) to store your Figma token (shared across projects, saved under your home dir) and toggle/upload the skills the agent uses
+- SSE log streams progress; HMR reflects the result immediately
+- Agent runs with `acceptEdits` + a tool allowlist (`Read`, `Glob`, `Grep`, `Edit`, `Write`, a restricted `Bash`) — no arbitrary command execution
+
+**Quick start**
+
+```bash
+pnpm add -D pubuilder
+```
+
+```json
+{ "scripts": { "dev": "pubuilder dev -- next dev" } }
+```
+
+Or run `npx pubuilder serve` in a separate terminal alongside your existing dev script. Requires the [`claude` CLI](https://docs.claude.com/en/docs/claude-code) installed and logged in.
+
+Adds a `.pubuilder/` directory at your project root (cache, settings, uploaded skills) — add it to `.gitignore`.
+
 ## Requirements
 
 - React ≥ 18, same-origin pages (live thumbnails are iframes)

package/dist/api.d.ts

@@ -0,0 +1,47 @@
+import type { BlockSelection } from './types';
+export declare const DEFAULT_SERVER_URL = "http://localhost:4816";
+export interface SkillInfo {
+    id: string;
+    name: string;
+    description: string;
+    source: 'project' | 'global' | 'uploaded';
+    enabled: boolean;
+}
+export interface AgentEvent {
+    type: 'log' | 'tool' | 'error' | 'done';
+    text: string;
+}
+export interface TokenStatus {
+    configured: boolean;
+    masked: string | null;
+}
+/** 서버 에러 응답의 code(server/errors.ts 계약)를 UI 분기용으로 실어 나르는 에러 */
+export declare class ApiError extends Error {
+    readonly code?: string | undefined;
+    constructor(message: string, code?: string | undefined);
+}
+export declare class PubuilderApi {
+    private readonly baseUrl;
+    constructor(baseUrl?: string);
+    private request;
+    isAlive(): Promise<boolean>;
+    listSkills(): Promise<SkillInfo[]>;
+    toggleSkill(id: string, enabled: boolean): Promise<void>;
+    uploadSkill(filename: string, content: string): Promise<SkillInfo>;
+    removeSkill(id: string): Promise<void>;
+    tokenStatus(): Promise<TokenStatus>;
+    saveToken(token: string): Promise<void>;
+    deleteToken(): Promise<void>;
+    startPublish(payload: {
+        selection: BlockSelection;
+        outerHTML: string;
+        figmaUrl: string;
+    }): Promise<{
+        jobId: string;
+    }>;
+    cancelPublish(jobId: string): Promise<void>;
+    /** SSE 구독 — 반환값 호출로 해제 */
+    subscribePublish(jobId: string, onEvent: (e: AgentEvent) => void): () => void;
+}
+/** PageMap이 provider로 감싸고, SkillDrawer/PublishPanel이 useContext로 획득 */
+export declare const PubuilderServerContext: import("react").Context<PubuilderApi>;