dynim-core 1.0.0

package/dist/builder/builder.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Builder Mode Controller
+ * Manages the floating pill bar, chat widget, and visual editor
+ */
+import { type WidgetConfig } from './widget';
+import { type DiffEntry } from './diff-state';
+export interface BuilderConfig {
+    logo?: string;
+    onSave?: (diffs: DiffEntry[]) => void;
+    onExit?: () => void;
+    onEnter?: () => void;
+    chatConfig?: WidgetConfig;
+    contentRoot?: HTMLElement;
+    pageId?: string;
+    apiBase?: string;
+    /** Session token for authentication */
+    sessionToken?: string;
+    /** Refresh token for session renewal */
+    refreshToken?: string;
+    /** Function to get session tokens */
+    getSession?: () => Promise<{
+        token: string;
+        refreshToken?: string;
+    }>;
+}
+export interface Builder {
+    enter: () => void;
+    exit: () => void;
+    save: () => Promise<void>;
+    isActive: () => boolean;
+    getChanges: () => DiffEntry[];
+    getEditorState: () => unknown;
+    getTreeState: () => unknown;
+    destroy: () => void;
+}
+export declare function createBuilder(config?: BuilderConfig): Builder;
+declare const _default: {
+    create: typeof createBuilder;
+};
+export default _default;
+//# sourceMappingURL=builder.d.ts.map

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

@@ -0,0 +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;AAW/E,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;CACtE;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,CAskBjE;;;;AAMD,wBAAyC"}

package/dist/builder/builder.js

@@ -0,0 +1,537 @@
+/**
+ * Builder Mode Controller
+ * Manages the floating pill bar, chat widget, and visual editor
+ */
+import { createState } from './state';
+import { createWidget } from './widget';
+import { createEditorState } from './editor-state';
+import { createHistoryState } from './history-state';
+import { createDiffState } from './diff-state';
+import { createTreeState } from './tree-state';
+import { createFreezeOverlay } from './freeze-overlay';
+import { createOverlays } from './editor-overlays';
+import { createDragEngine } from './drag-engine';
+import { scanDOM } from './dom-scanner';
+import { createAIPromptPopover } from './ai-prompt-popover';
+import { createCodeClient } from './code-client';
+import { createBuilderClient } from './builder-client';
+import { buildElementIdentifier, getRelevantStyles } from './element-utils';
+export function createBuilder(config = {}) {
+    const { logo = 'Builder', onSave, onExit, onEnter, chatConfig = {}, contentRoot = document.body, pageId = window.location.pathname, apiBase = 'http://localhost:8080', sessionToken, refreshToken, getSession } = config;
+    let isActive = false;
+    let chatWidget = null;
+    let state = null;
+    let client = null;
+    let editorState = null;
+    let historyState = null;
+    let diffState = null;
+    let treeState = null;
+    let freezeOverlay = null;
+    let overlays = null;
+    let dragEngine = null;
+    let aiPromptPopover = null;
+    const root = document.createElement('div');
+    root.className = 'builder';
+    root.innerHTML = `
+    <div class="builder-bar">
+      <div class="builder-bar__logo">
+        <svg class="builder-bar__icon" viewBox="0 0 24 24" fill="currentColor">
+          <path d="M22.7 19l-9.1-9.1c.9-2.3.4-5-1.5-6.9-2-2-5-2.4-7.4-1.3L9 6 6 9 1.6 4.7C.4 7.1.9 10.1 2.9 12.1c1.9 1.9 4.6 2.4 6.9 1.5l9.1 9.1c.4.4 1 .4 1.4 0l2.3-2.3c.5-.4.5-1.1.1-1.4z"/>
+        </svg>
+        <span>${logo}</span>
+      </div>
+      <div class="builder-bar__divider"></div>
+      <div class="builder-bar__actions">
+        <button class="builder-bar__btn builder-bar__btn--undo" title="Undo (Cmd+Z)" style="display: none;">
+          <svg viewBox="0 0 24 24" width="14" height="14" fill="currentColor">
+            <path d="M12.5 8c-2.65 0-5.05.99-6.9 2.6L2 7v9h9l-3.62-3.62c1.39-1.16 3.16-1.88 5.12-1.88 3.54 0 6.55 2.31 7.6 5.5l2.37-.78C21.08 11.03 17.15 8 12.5 8z"/>
+          </svg>
+        </button>
+        <button class="builder-bar__btn builder-bar__btn--preview" title="Preview">
+          <svg viewBox="0 0 24 24" width="14" height="14" fill="currentColor">
+            <path d="M12 4.5C7 4.5 2.73 7.61 1 12c1.73 4.39 6 7.5 11 7.5s9.27-3.11 11-7.5c-1.73-4.39-6-7.5-11-7.5zM12 17c-2.76 0-5-2.24-5-5s2.24-5 5-5 5 2.24 5 5-2.24 5-5 5zm0-8c-1.66 0-3 1.34-3 3s1.34 3 3 3 3-1.34 3-3-1.34-3-3-3z"/>
+          </svg>
+          Preview
+        </button>
+        <button class="builder-bar__btn builder-bar__btn--save" title="Save changes" disabled style="background: rgba(100, 116, 139, 0.5); color: rgba(255, 255, 255, 0.4); cursor: not-allowed; pointer-events: none;">
+          <svg viewBox="0 0 24 24" width="14" height="14" fill="currentColor">
+            <path d="M17 3H5c-1.11 0-2 .9-2 2v14c0 1.1.89 2 2 2h14c1.1 0 2-.9 2-2V7l-4-4zm-5 16c-1.66 0-3-1.34-3-3s1.34-3 3-3 3 1.34 3 3-1.34 3-3 3zm3-10H5V5h10v4z"/>
+          </svg>
+          Save
+        </button>
+        <button class="builder-bar__btn builder-bar__btn--exit">
+          <svg viewBox="0 0 24 24" width="14" height="14" fill="currentColor">
+            <path d="M19 6.41L17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/>
+          </svg>
+          Exit
+        </button>
+      </div>
+    </div>
+
+    <div class="builder-modal" style="display: none;">
+      <div class="builder-modal__backdrop"></div>
+      <div class="builder-modal__dialog">
+        <div class="builder-modal__title">Unsaved Changes</div>
+        <div class="builder-modal__message">You have unsaved changes. What would you like to do?</div>
+        <div class="builder-modal__actions">
+          <button class="builder-modal__btn builder-modal__btn--cancel">Cancel</button>
+          <button class="builder-modal__btn builder-modal__btn--discard">Discard Changes</button>
+          <button class="builder-modal__btn builder-modal__btn--save">Save & Exit</button>
+        </div>
+      </div>
+    </div>
+  `;
+    const saveBtn = root.querySelector('.builder-bar__btn--save');
+    const undoBtn = root.querySelector('.builder-bar__btn--undo');
+    const modal = root.querySelector('.builder-modal');
+    let builderClient = null;
+    function initCodeClient(stateRef) {
+        client = createCodeClient({
+            apiBase,
+            sessionToken,
+            refreshToken,
+            getSession,
+            onMessageUpdate: (message) => {
+                console.log('[Builder] Message update:', message.status);
+                // Update the chat UI with the latest text
+                const messages = stateRef.getState().messages;
+                const lastMessage = messages[messages.length - 1];
+                if (lastMessage?.role === 'assistant') {
+                    stateRef.updateMessage(lastMessage.id, {
+                        text: message.text || ''
+                    });
+                }
+                if (message.status === 'done') {
+                    console.log('[Builder] Chat complete');
+                }
+                else if (message.status === 'error') {
+                    console.log('[Builder] Chat error:', message.error);
+                    if (lastMessage?.role === 'assistant') {
+                        stateRef.updateMessage(lastMessage.id, {
+                            text: message.error || 'Something went wrong. Please try again.'
+                        });
+                    }
+                }
+            },
+            onStreamStart: () => {
+                console.log('[Builder] Stream started');
+            },
+            onStreamEnd: () => {
+                console.log('[Builder] Stream ended');
+            },
+            onError: (error) => {
+                console.error('[Builder] Backend error:', error);
+                const messages = stateRef.getState().messages;
+                const lastMessage = messages[messages.length - 1];
+                if (lastMessage?.role === 'assistant') {
+                    stateRef.updateMessage(lastMessage.id, {
+                        text: error.message || 'Sorry, something went wrong. Please try again.'
+                    });
+                }
+            },
+            onAuthError: (error) => {
+                console.error('[Builder] Auth error:', error);
+            }
+        });
+    }
+    function initBuilderClient() {
+        builderClient = createBuilderClient({
+            apiBase,
+            sessionToken,
+            refreshToken,
+            getSession,
+            onError: (error) => {
+                console.error('[Builder] Visual builder error:', error);
+            },
+            onAuthError: (error) => {
+                console.error('[Builder] Auth error:', error);
+            }
+        });
+    }
+    function updateButtonStates() {
+        if (!historyState)
+            return;
+        // Show/hide undo button contextually
+        const canUndo = historyState.canUndo();
+        undoBtn.style.display = canUndo ? 'flex' : 'none';
+        const hasActualChanges = diffState ? diffState.getDiff().length > 0 : false;
+        saveBtn.disabled = !hasActualChanges;
+        if (hasActualChanges) {
+            saveBtn.style.background = '#3b82f6';
+            saveBtn.style.color = '#ffffff';
+            saveBtn.style.opacity = '1';
+            saveBtn.style.cursor = 'pointer';
+            saveBtn.style.pointerEvents = 'auto';
+        }
+        else {
+            saveBtn.style.background = 'rgba(100, 116, 139, 0.5)';
+            saveBtn.style.color = 'rgba(255, 255, 255, 0.4)';
+            saveBtn.style.opacity = '1';
+            saveBtn.style.cursor = 'not-allowed';
+            saveBtn.style.pointerEvents = 'none';
+        }
+    }
+    function performScan() {
+        const tree = scanDOM(contentRoot);
+        if (tree) {
+            treeState?.setTree(tree);
+        }
+        updateButtonStates();
+    }
+    function enter() {
+        if (isActive)
+            return;
+        isActive = true;
+        root.classList.add('builder--active');
+        document.body.classList.add('builder-mode-active');
+        editorState = createEditorState();
+        historyState = createHistoryState();
+        diffState = createDiffState();
+        treeState = createTreeState();
+        diffState.snapshotInitialState(contentRoot);
+        historyState.subscribe(updateButtonStates);
+        overlays = createOverlays();
+        overlays.mount();
+        dragEngine = createDragEngine({
+            contentRoot,
+            editorState,
+            historyState,
+            diffState,
+            treeState,
+            overlays,
+            freezeOverlay: null,
+            onRescan: performScan
+        });
+        freezeOverlay = createFreezeOverlay({
+            contentRoot,
+            onMouseDown: (e, el) => dragEngine?.handleMouseDown(e, el),
+            onMouseMove: (e, el) => dragEngine?.handleMouseMove(e, el),
+            onMouseUp: (e, el) => dragEngine?.handleMouseUp(e, el),
+            onMouseLeave: (e) => dragEngine?.handleMouseLeave(e),
+            onClick: (e, el) => dragEngine?.handleClick(e, el),
+            onDoubleClick: (e, el) => dragEngine?.handleDoubleClick(e, el),
+            onWheel: (e) => dragEngine?.handleWheel(e)
+        });
+        freezeOverlay.mount();
+        dragEngine.setFreezeOverlay(freezeOverlay);
+        dragEngine.attach();
+        aiPromptPopover = createAIPromptPopover({
+            onSubmit: (prompt) => {
+                const selectedEl = editorState?.getState().selectedElement;
+                // Always add user message first
+                state?.addMessage({ role: 'user', text: prompt });
+                if (!client) {
+                    console.error('[Builder] Code client not initialized');
+                    state?.addMessage({ role: 'assistant', text: 'Connection error: client not initialized.' });
+                }
+                else if (!selectedEl) {
+                    // No element selected - send as general query
+                    state?.addMessage({ role: 'assistant', text: '' });
+                    client.sendCode(prompt);
+                }
+                else {
+                    // Element selected - build context and send
+                    state?.addMessage({ role: 'assistant', text: '' });
+                    const el = buildElementIdentifier(selectedEl);
+                    const styles = getRelevantStyles(selectedEl);
+                    const elementContext = [
+                        `[Element Context]`,
+                        `Tag: <${el.tagName}>`,
+                        el.id ? `ID: ${el.id}` : null,
+                        el.classes.length > 0 ? `Classes: ${el.classes.join(' ')}` : null,
+                        `Styles: ${Object.entries(styles).slice(0, 10).map(([k, v]) => `${k}: ${v}`).join('; ')}`,
+                        `[User Request]`,
+                        prompt
+                    ].filter(Boolean).join('\n');
+                    client.sendCode(elementContext);
+                }
+                // Always cleanup and open chat
+                aiPromptPopover?.hide();
+                editorState?.clearSelection();
+                overlays?.hideSelection();
+                chatWidget?.open();
+            },
+            onClose: () => {
+                editorState?.clearSelection();
+                overlays?.hideSelection();
+                aiPromptPopover?.hide();
+            }
+        });
+        aiPromptPopover.mount();
+        let chatWasOpenBeforeDrag = false;
+        let chatWasOpenBeforeSelection = false;
+        editorState.subscribe((newState, prevState) => {
+            if (chatWidget) {
+                const dragStarted = newState.isDragging && !prevState?.isDragging;
+                const dragEnded = !newState.isDragging && prevState?.isDragging;
+                if (dragStarted) {
+                    chatWasOpenBeforeDrag = chatWidget.isOpen();
+                    if (chatWasOpenBeforeDrag) {
+                        chatWidget.close();
+                    }
+                }
+                else if (dragEnded && chatWasOpenBeforeDrag) {
+                    chatWidget.open();
+                }
+                const selectionStarted = newState.selectedElement && !prevState?.selectedElement;
+                const selectionEnded = !newState.selectedElement && prevState?.selectedElement;
+                if (selectionStarted && !newState.isDragging) {
+                    chatWasOpenBeforeSelection = chatWidget.isOpen();
+                    if (chatWasOpenBeforeSelection) {
+                        chatWidget.close();
+                    }
+                }
+                else if (selectionEnded && chatWasOpenBeforeSelection && !newState.isDragging) {
+                    chatWidget.open();
+                    chatWasOpenBeforeSelection = false;
+                }
+            }
+            if (newState.selectedElement && newState.selectionRect && !newState.isDragging) {
+                aiPromptPopover?.show(newState.selectionRect);
+            }
+            else {
+                aiPromptPopover?.hide();
+            }
+        });
+        setTimeout(performScan, 100);
+        if (!chatWidget) {
+            state = createState();
+            state.addMessage({
+                role: 'assistant',
+                text: 'Hi! I\'m here to help you build. Select an element by clicking on it, or drag elements to rearrange them.'
+            });
+            initCodeClient(state);
+            initBuilderClient(); // For visual builder operations (saveDiffs, preview, exit)
+            // Pre-warm the cache for faster chat responses (projectId comes from JWT)
+            if (client) {
+                client.warmCache();
+            }
+            // Create a StreamClient adapter for the widget
+            const streamClientAdapter = {
+                send: async (message) => {
+                    if (!client) {
+                        console.error('[Builder] Code client not initialized');
+                        if (state) {
+                            const messages = state.getState().messages;
+                            const lastMessage = messages[messages.length - 1];
+                            if (lastMessage?.role === 'assistant') {
+                                state.updateMessage(lastMessage.id, {
+                                    text: 'Connection error: client not initialized.'
+                                });
+                            }
+                        }
+                        return;
+                    }
+                    await client.sendCode(message);
+                },
+            };
+            chatWidget = createWidget(null, state, streamClientAdapter, {
+                mode: 'floating',
+                position: 'bottom-right',
+                title: 'Build Assistant',
+                ...chatConfig
+            });
+        }
+        chatWidget.root.style.display = '';
+        chatWidget.open();
+        onEnter?.();
+    }
+    function cleanup() {
+        modal.style.display = 'none';
+        root.classList.remove('builder--active');
+        document.body.classList.remove('builder-mode-active');
+        dragEngine?.detach();
+        aiPromptPopover?.unmount();
+        overlays?.unmount();
+        freezeOverlay?.unmount();
+        dragEngine = null;
+        aiPromptPopover = null;
+        overlays = null;
+        freezeOverlay = null;
+        editorState = null;
+        historyState = null;
+        diffState = null;
+        treeState = null;
+        undoBtn.style.display = 'none';
+        if (chatWidget) {
+            chatWidget.close();
+            chatWidget.root.style.display = 'none';
+        }
+        onExit?.();
+    }
+    async function exit() {
+        if (!isActive)
+            return;
+        isActive = false;
+        // Notify server of exit (discarding changes)
+        if (builderClient) {
+            try {
+                await builderClient.exit(pageId, true);
+                console.log('[Builder] Exit notification sent');
+            }
+            catch (error) {
+                console.error('[Builder] Exit notification failed:', error);
+            }
+        }
+        while (historyState?.canUndo()) {
+            dragEngine?.executeUndo();
+        }
+        cleanup();
+    }
+    async function save() {
+        console.log('[Builder] Save called, isActive:', isActive);
+        if (!isActive)
+            return;
+        isActive = false;
+        const diffs = diffState?.getDiff() || [];
+        console.log('[Builder] Diffs count:', diffs.length);
+        console.log('[Builder] builderClient exists:', !!builderClient);
+        if (builderClient && diffs.length > 0) {
+            try {
+                console.log('[Builder] Saving diffs to backend:', { pageId, diffs });
+                const result = await builderClient.saveDiffs(pageId, diffs);
+                console.log('[Builder] Save result:', result);
+            }
+            catch (error) {
+                console.error('[Builder] Save failed:', error);
+            }
+        }
+        else {
+            console.log('[Builder] Skipping save - no client or no diffs');
+        }
+        onSave?.(diffs);
+        cleanup();
+    }
+    async function preview() {
+        if (!isActive)
+            return;
+        const diffs = diffState?.getDiff() || [];
+        console.log('[Builder] Preview called, diffs:', diffs.length);
+        if (builderClient) {
+            try {
+                const result = await builderClient.preview(pageId, diffs);
+                console.log('[Builder] Preview result:', result);
+                // TODO: Handle preview result (e.g., open preview URL, toggle preview mode)
+                if (result.previewUrl) {
+                    window.open(result.previewUrl, '_blank');
+                }
+            }
+            catch (error) {
+                console.error('[Builder] Preview failed:', error);
+            }
+        }
+    }
+    function showModal() {
+        modal.style.display = '';
+    }
+    function hideModal() {
+        modal.style.display = 'none';
+    }
+    function hasUnsavedChanges() {
+        const hasDiffs = diffState ? diffState.getDiff().length > 0 : false;
+        const hasHistory = historyState ? historyState.canUndo() : false;
+        return hasDiffs || hasHistory;
+    }
+    function handleExitClick() {
+        if (hasUnsavedChanges()) {
+            showModal();
+        }
+        else {
+            exit();
+        }
+    }
+    root.addEventListener('click', (e) => {
+        const target = e.target;
+        if (target.closest('.builder-bar__btn--exit')) {
+            e.stopPropagation();
+            handleExitClick();
+            return;
+        }
+        if (target.closest('.builder-bar__btn--save')) {
+            e.stopPropagation();
+            save();
+            return;
+        }
+        if (target.closest('.builder-bar__btn--preview')) {
+            e.stopPropagation();
+            preview();
+            return;
+        }
+        if (target.closest('.builder-bar__btn--undo')) {
+            e.stopPropagation();
+            dragEngine?.executeUndo();
+            return;
+        }
+        if (target.closest('.builder-modal__btn--cancel')) {
+            e.stopPropagation();
+            hideModal();
+            return;
+        }
+        if (target.closest('.builder-modal__btn--discard')) {
+            e.stopPropagation();
+            hideModal();
+            exit();
+            return;
+        }
+        if (target.closest('.builder-modal__btn--save')) {
+            e.stopPropagation();
+            hideModal();
+            save();
+            return;
+        }
+        if (target.closest('.builder-modal__backdrop')) {
+            e.stopPropagation();
+            hideModal();
+            return;
+        }
+    });
+    document.addEventListener('click', (e) => {
+        const target = e.target;
+        if (target.closest('.builder-bar__btn--exit')) {
+            e.preventDefault();
+            e.stopPropagation();
+            handleExitClick();
+        }
+        else if (target.closest('.builder-bar__btn--save') && !saveBtn.disabled) {
+            e.preventDefault();
+            e.stopPropagation();
+            save();
+        }
+        else if (target.closest('.builder-modal__btn--discard')) {
+            e.preventDefault();
+            e.stopPropagation();
+            hideModal();
+            exit();
+        }
+        else if (target.closest('.builder-modal__btn--save')) {
+            e.preventDefault();
+            e.stopPropagation();
+            hideModal();
+            save();
+        }
+        else if (target.closest('.builder-modal__btn--cancel')) {
+            e.preventDefault();
+            e.stopPropagation();
+            hideModal();
+        }
+    }, true);
+    document.body.appendChild(root);
+    return {
+        enter,
+        exit,
+        save,
+        isActive: () => isActive,
+        getChanges: () => diffState?.getDiff() || [],
+        getEditorState: () => editorState?.getState(),
+        getTreeState: () => treeState?.getState(),
+        destroy: () => {
+            exit();
+            chatWidget?.destroy();
+            root.remove();
+        }
+    };
+}
+if (typeof window !== 'undefined') {
+    window.Builder = { create: createBuilder };
+}
+export default { create: createBuilder };

package/dist/builder/bundle-manager.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Bundle Manager - Handles loading and swapping React bundles with smooth crossfade transitions
+ *
+ * Uses dual containers to enable seamless bundle swapping:
+ * 1. Load new bundle into inactive container (hidden)
+ * 2. Wait for React to mount
+ * 3. Crossfade from active to new container
+ * 4. Cleanup old container
+ *
+ * This prevents any flash or blank screen during bundle updates.
+ */
+export interface BundleManager {
+    /** Load a bundle with crossfade transition */
+    load(bundleUrl: string): Promise<void>;
+    /** Apply inline styles to element in active container */
+    applyStyles(selector: string, styles: Record<string, string>): void;
+    /** Replace className on element */
+    applyClassName(selector: string, className: string): void;
+    /** Add/remove CSS classes (for Tailwind) */
+    toggleClasses(selector: string, add: string[], remove: string[]): void;
+    /** Query element in active container */
+    querySelector<T extends Element = Element>(selector: string): T | null;
+    /** Query all elements in active container */
+    querySelectorAll<T extends Element = Element>(selector: string): NodeListOf<T>;
+    /** Get the active container element */
+    getActiveContainer(): HTMLElement;
+    /** Get the root element (#root) of active container */
+    getActiveRoot(): HTMLElement | null;
+    /** Check if a bundle is currently loaded */
+    isLoaded(): boolean;
+    /** Check if currently loading */
+    isLoading(): boolean;
+    /** Get current bundle URL */
+    getCurrentBundleUrl(): string | null;
+    /** Unload current bundle and clear containers */
+    unload(): void;
+    /** Destroy the bundle manager and cleanup DOM */
+    destroy(): void;
+}
+export interface BundleManagerConfig {
+    /** Parent element to mount preview containers into */
+    parent: HTMLElement;
+    /** Transition duration in ms (default: 300) */
+    transitionDuration?: number;
+    /** Timeout for bundle mount in ms (default: 5000) */
+    mountTimeout?: number;
+    /** Called when bundle starts loading */
+    onLoadStart?: (bundleUrl: string) => void;
+    /** Called when bundle is loaded and visible */
+    onLoadComplete?: (bundleUrl: string) => void;
+    /** Called on load error */
+    onError?: (error: Error, bundleUrl: string) => void;
+    /** Called when bundle is unloaded */
+    onUnload?: () => void;
+}
+/**
+ * Create a bundle manager instance
+ */
+export declare function createBundleManager(config: BundleManagerConfig): BundleManager;
+//# sourceMappingURL=bundle-manager.d.ts.map

package/dist/builder/bundle-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle-manager.d.ts","sourceRoot":"","sources":["../../src/builder/bundle-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AASH,MAAM,WAAW,aAAa;IAC5B,8CAA8C;IAC9C,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvC,yDAAyD;IACzD,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IAEpE,mCAAmC;IACnC,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1D,4CAA4C;IAC5C,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAEvE,wCAAwC;IACxC,aAAa,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC;IAEvE,6CAA6C;IAC7C,gBAAgB,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;IAE/E,uCAAuC;IACvC,kBAAkB,IAAI,WAAW,CAAC;IAElC,uDAAuD;IACvD,aAAa,IAAI,WAAW,GAAG,IAAI,CAAC;IAEpC,4CAA4C;IAC5C,QAAQ,IAAI,OAAO,CAAC;IAEpB,iCAAiC;IACjC,SAAS,IAAI,OAAO,CAAC;IAErB,6BAA6B;IAC7B,mBAAmB,IAAI,MAAM,GAAG,IAAI,CAAC;IAErC,iDAAiD;IACjD,MAAM,IAAI,IAAI,CAAC;IAEf,iDAAiD;IACjD,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,sDAAsD;IACtD,MAAM,EAAE,WAAW,CAAC;IAEpB,+CAA+C;IAC/C,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B,qDAAqD;IACrD,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,wCAAwC;IACxC,WAAW,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAE1C,+CAA+C;IAC/C,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAE7C,2BAA2B;IAC3B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAEpD,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,GAAG,aAAa,CA8Y9E"}