dynim-core 1.0.4 → 1.0.5

package/README.md

@@ -1,290 +1,17 @@
 # dynim-core
 
-Framework-agnostic TypeScript library for visual page building, AI chat, and code generation.
+Framework-agnostic TypeScript library for visual page building.
 
-## Installation
+## Documentation
 
-```bash
-npm install dynim-core
-```
-
-## Features
-
-- **Visual Page Builder** - Drag-and-drop editing with undo/redo history
-- **AI Chat Integration** - SSE-based streaming chat with element context awareness
-- **Code Generation** - Flexcode integration for AI-powered code changes
-- **Element Classification** - Semantic, visual, and size analysis of DOM elements
-- **DOM Utilities** - Tree scanning, stable IDs, selector generation
-
-## Quick Start
-
-### Chat Widget
-
-```typescript
-import { createState, createClient, createWidget } from 'dynim-core';
-
-const state = createState();
-const client = createClient({
-  endpoint: '/api/chat',
-  apiKey: 'your-api-key',
-  onMessage: (data) => state.updateMessage(data.id, data.text),
-  onError: (error) => console.error(error),
-});
-
-const widget = createWidget({
-  state,
-  client,
-  position: 'bottom-right', // or 'inline'
-});
-
-widget.mount(document.body);
-```
-
-### Visual Builder
-
-```typescript
-import { createBuilder, createBuilderClient } from 'dynim-core';
-
-const builderClient = createBuilderClient({
-  apiBase: 'https://api.example.com',
-  sessionToken: 'jwt-token',
-  onMessage: (msg) => console.log('AI response:', msg),
-  onError: (err) => console.error(err),
-});
-
-const builder = createBuilder({
-  contentRoot: document.getElementById('app'),
-  client: builderClient,
-});
-
-// Enter edit mode
-builder.enter();
-
-// Save changes
-await builder.save();
-
-// Exit without saving
-builder.exit();
-```
-
-### Code Generation (Flexcode)
-
-```typescript
-import { createCodeClient } from 'dynim-core';
-
-const codeClient = createCodeClient({
-  apiBase: 'https://api.example.com',
-  sessionToken: 'jwt-token',
-  onMessage: (event) => {
-    switch (event.type) {
-      case 'text':
-        console.log('Response:', event.content);
-        break;
-      case 'thinking':
-        console.log('Thinking:', event.content);
-        break;
-      case 'edit':
-        console.log('Code edit:', event.edit);
-        break;
-      case 'done':
-        console.log('Complete');
-        break;
-    }
-  },
-});
-
-// Send code generation request
-await codeClient.sendCode('project-id', 'Add a dark mode toggle');
-
-// Get pending edits
-const edits = codeClient.getEdits();
-
-// Save or abandon
-await codeClient.saveCode('project-id');
-await codeClient.abandonCode('project-id');
-```
-
-## API Reference
-
-### State Management
-
-```typescript
-createState(): StateStore
-
-interface StateStore {
-  getState(): ChatState;
-  setState(state: Partial<ChatState>): void;
-  subscribe(listener: (state: ChatState) => void): () => void;
-  addMessage(message: Message): void;
-  updateMessage(id: string, text: string): void;
-  clearMessages(): void;
-}
-```
-
-### Streaming Client
-
-```typescript
-createClient(config: ClientConfig): StreamClient
-
-interface ClientConfig {
-  endpoint: string;
-  apiKey?: string;
-  onMessage: (data: MessageData) => void;
-  onError?: (error: Error) => void;
-}
-
-interface StreamClient {
-  send(message: string): Promise<void>;
-}
-```
-
-### Builder
+See [SDK Core Documentation](../../utils/docs/sdk/CORE.md)
 
-```typescript
-createBuilder(config: BuilderConfig): Builder
+Related:
+- [SDK Overview](../../utils/docs/sdk/README.md)
+- [UI Builder](../../utils/docs/ui-builder/README.md)
 
-interface BuilderConfig {
-  contentRoot?: HTMLElement;
-  client: BuilderClient;
-}
+## Install
 
-interface Builder {
-  enter(): void;
-  exit(): void;
-  save(): Promise<void>;
-  isActive(): boolean;
-  getChanges(): DiffEntry[];
-  getEditorState(): EditorState;
-  getTreeState(): TreeState;
-  destroy(): void;
-}
-```
-
-### Builder Client
-
-```typescript
-createBuilderClient(config: BuilderClientConfig): BuilderClient
-
-interface BuilderClientConfig {
-  apiBase?: string;
-  sessionToken?: string;
-  refreshToken?: string;
-  getSession?: () => Promise<{ token: string }>;
-  onMessage?: (data: BuilderMessage) => void;
-  onError?: (error: Error) => void;
-}
-
-interface BuilderClient {
-  sendChat(message: string): Promise<void>;
-  sendElementChat(message: string, element: HTMLElement): Promise<void>;
-  saveDiffs(diffs: DiffEntry[]): Promise<void>;
-  setSessionToken(token: string): void;
-  isAuthenticated(): boolean;
-}
-```
-
-### Code Client
-
-```typescript
-createCodeClient(config: CodeClientConfig): CodeClient
-
-interface CodeClientConfig {
-  apiBase?: string;
-  sessionToken?: string;
-  getSession?: () => Promise<{ token: string }>;
-  onMessage?: (event: CodeEvent) => void;
-}
-
-interface CodeClient {
-  sendCode(projectId: string, prompt: string): Promise<void>;
-  saveCode(projectId: string): Promise<void>;
-  abandonCode(projectId: string): Promise<void>;
-  getEdits(): CodeEdit[];
-}
-
-type CodeEvent =
-  | { type: 'text'; content: string }
-  | { type: 'thinking'; content: string }
-  | { type: 'edit'; edit: CodeEdit }
-  | { type: 'question'; content: string }
-  | { type: 'done' }
-  | { type: 'error'; content: string };
-```
-
-### DOM Utilities
-
-```typescript
-// Scan DOM tree
-scanDOM(root: HTMLElement): DOMNode[]
-
-// Create debounced scanner
-createDebouncedScanner(callback: (nodes: DOMNode[]) => void): Scanner
-
-// Element queries
-getElementAtPath(root: HTMLElement, path: number[]): HTMLElement | null
-queryElements(root: HTMLElement, selector: string): HTMLElement[]
-generateSelector(element: HTMLElement): string
-
-// Stable IDs for tracking elements across changes
-getStableId(element: HTMLElement): string
-findByStableId(root: HTMLElement, id: string): HTMLElement | null
-
-// Build element context for AI
-buildElementIdentifier(element: HTMLElement): ElementIdentifier
-```
-
-### Element Classifier
-
-```typescript
-createClassifier(): Classifier
-
-interface Classifier {
-  classify(element: HTMLElement): Classification;
-}
-
-interface Classification {
-  semantic: SemanticInfo;   // HTML tag, ARIA roles, attributes
-  classes: ClassInfo;       // CSS class patterns
-  visual: VisualInfo;       // Colors, fonts, spacing
-  size: SizeInfo;           // Dimensions, viewport relation
-}
-```
-
-## Styling
-
-Import base styles for the chat widget and builder UI:
-
-```typescript
-import 'dynim-core/styles/base.css';
-import 'dynim-core/styles/builder.css';
-import 'dynim-core/styles/editor.css';
-
-// Themes
-import 'dynim-core/styles/themes/light.css';
-import 'dynim-core/styles/themes/dark.css';
-```
-
-## Browser Global API
-
-For non-module usage, `dynim-core` exposes global helpers:
-
-```html
-<script src="dynim-core/dist/index.js"></script>
-<script>
-  // Quick chatbot setup
-  window.Chatbot.init({
-    endpoint: '/api/chat',
-    position: 'bottom-right',
-  });
-
-  // Quick builder setup
-  window.Builder.create({
-    apiBase: 'https://api.example.com',
-    sessionToken: 'jwt-token',
-  });
-</script>
+```bash
+npm install dynim-core
 ```
-
-## License
-
-MIT

package/dist/builder/builder-client.d.ts

@@ -3,13 +3,11 @@
  *
  * NOTE: For AI chat/code operations, use code-client.ts instead.
  * This client handles visual builder-specific operations:
- * - saveDiffs: Save visual DOM changes
  * - preview: Generate preview URL
  * - exit: Notify server of builder exit
  *
  * Authentication uses JWT session tokens.
  */
-import type { DiffEntry } from './diff-state';
 export interface BuilderClientConfig {
     apiBase?: string;
     /** JWT session token for authentication */
@@ -28,10 +26,8 @@ export interface BuilderClientConfig {
     onAuthError?: (error: Error) => void;
 }
 export interface BuilderClient {
-    /** Save visual DOM diffs to backend */
-    saveDiffs: (pageId: string, diffs: DiffEntry[]) => Promise<unknown>;
     /** Generate preview URL for current changes */
-    preview: (pageId: string, diffs?: DiffEntry[]) => Promise<{
+    preview: (pageId: string) => Promise<{
         success: boolean;
         previewUrl?: string;
         message?: string;

package/dist/builder/builder-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builder-client.d.ts","sourceRoot":"","sources":["../../src/builder/builder-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAI9C,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mDAAmD;IACnD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,uCAAuC;IACvC,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,uCAAuC;IACvC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACtC;AAGD,MAAM,WAAW,aAAa;IAC5B,uCAAuC;IACvC,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACpE,+CAA+C;IAC/C,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,SAAS,EAAE,KAAK,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvH,oCAAoC;IACpC,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7F,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAChE,eAAe,EAAE,MAAM,OAAO,CAAC;CAChC;AAED,wBAAgB,mBAAmB,CAAC,MAAM,GAAE,mBAAwB,GAAG,aAAa,CAyKnF"}
+{"version":3,"file":"builder-client.d.ts","sourceRoot":"","sources":["../../src/builder/builder-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mDAAmD;IACnD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,uCAAuC;IACvC,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,uCAAuC;IACvC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACtC;AAGD,MAAM,WAAW,aAAa;IAC5B,+CAA+C;IAC/C,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClG,oCAAoC;IACpC,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7F,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAChE,eAAe,EAAE,MAAM,OAAO,CAAC;CAChC;AAED,wBAAgB,mBAAmB,CAAC,MAAM,GAAE,mBAAwB,GAAG,aAAa,CAoJnF"}

package/dist/builder/builder-client.js

@@ -3,7 +3,6 @@
  *
  * NOTE: For AI chat/code operations, use code-client.ts instead.
  * This client handles visual builder-specific operations:
- * - saveDiffs: Save visual DOM changes
  * - preview: Generate preview URL
  * - exit: Notify server of builder exit
  *
@@ -84,30 +83,12 @@ export function createBuilderClient(config = {}) {
         headers.set('Authorization', `Bearer ${token}`);
         return fetch(url, { ...options, headers });
     }
-    async function saveDiffs(pageId, diffs) {
-        try {
-            const response = await authenticatedFetch(`${apiBase}/api/builder/save`, {
-                method: 'POST',
-                headers: { 'Content-Type': 'application/json' },
-                body: JSON.stringify({ pageId, diffs })
-            });
-            if (!response.ok) {
-                throw new Error(`HTTP ${response.status}: ${response.statusText}`);
-            }
-            return response.json();
-        }
-        catch (error) {
-            console.error('[BuilderClient] Save error:', error);
-            onError?.(error);
-            throw error;
-        }
-    }
-    async function preview(pageId, diffs) {
+    async function preview(pageId) {
         try {
             const response = await authenticatedFetch(`${apiBase}/api/builder/preview`, {
                 method: 'POST',
                 headers: { 'Content-Type': 'application/json' },
-                body: JSON.stringify({ pageId, diffs: diffs || [] })
+                body: JSON.stringify({ pageId })
             });
             if (!response.ok) {
                 throw new Error(`HTTP ${response.status}: ${response.statusText}`);
@@ -148,7 +129,6 @@ export function createBuilderClient(config = {}) {
         }
     }
     return {
-        saveDiffs,
         preview,
         exit,
         setSessionToken,

package/dist/builder/builder.d.ts

@@ -3,11 +3,9 @@
  * Manages the floating pill bar, chat widget, and visual editor
  */
 import { type WidgetConfig } from './widget';
-import { type DiffEntry } from './diff-state';
 import { type CodeClient } from './code-client';
 export interface BuilderConfig {
     logo?: string;
-    onSave?: (diffs: DiffEntry[]) => void;
     onExit?: () => void;
     onEnter?: () => void;
     chatConfig?: WidgetConfig;
@@ -29,9 +27,7 @@ export interface BuilderConfig {
 export interface Builder {
     enter: () => void;
     exit: () => void;
-    save: () => Promise<void>;
     isActive: () => boolean;
-    getChanges: () => DiffEntry[];
     getEditorState: () => unknown;
     getTreeState: () => unknown;
     destroy: () => void;

package/dist/builder/builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../src/builder/builder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAA6B,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AAGxE,OAAO,EAAmC,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAO/E,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAIlE,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,IAAI,CAAC;IACtC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,UAAU,CAAC,EAAE,YAAY,CAAC;IAC1B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qCAAqC;IACrC,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrE,+FAA+F;IAC/F,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAED,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,QAAQ,EAAE,MAAM,OAAO,CAAC;IACxB,UAAU,EAAE,MAAM,SAAS,EAAE,CAAC;IAC9B,cAAc,EAAE,MAAM,OAAO,CAAC;IAC9B,YAAY,EAAE,MAAM,OAAO,CAAC;IAC5B,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,wBAAgB,aAAa,CAAC,MAAM,GAAE,aAAkB,GAAG,OAAO,CAwlBjE;;;;AAMD,wBAAyC"}
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../src/builder/builder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAA6B,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AAQxE,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAIlE,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,UAAU,CAAC,EAAE,YAAY,CAAC;IAC1B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qCAAqC;IACrC,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrE,+FAA+F;IAC/F,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAED,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,QAAQ,EAAE,MAAM,OAAO,CAAC;IACxB,cAAc,EAAE,MAAM,OAAO,CAAC;IAC9B,YAAY,EAAE,MAAM,OAAO,CAAC;IAC5B,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,wBAAgB,aAAa,CAAC,MAAM,GAAE,aAAkB,GAAG,OAAO,CAmXjE;;;;AAMD,wBAAyC"}