@molecule/app-ide-react 1.0.0

package/dist/components/tool-call-utilities.js

@@ -0,0 +1,368 @@
+/**
+ * Pure utility functions for tool call display.
+ *
+ * Extracted from ToolCallCard for testability — these functions have no
+ * React dependencies and can be unit-tested directly.
+ *
+ * @module
+ */
+import { t } from '@molecule/app-i18n';
+/**
+ * Extracts the last path segment from a file path (e.g. "a/b/c.ts" → "c.ts").
+ * @param path - The file path to extract the basename from.
+ * @returns The basename string, or empty string if path is undefined.
+ */
+export function basename(path) {
+    if (!path)
+        return '';
+    return path.split('/').pop() ?? path;
+}
+/**
+ * Path of a `@molecule/*` package's MOLECULE.md inside the sandbox, where every
+ * package is pre-installed. Used by the find_package / read_molecule_doc cards
+ * so clicking a package opens its docs in the editor.
+ * @param packageName - The package name, with or without the `@molecule/` prefix.
+ * @returns The absolute sandbox path to the package's MOLECULE.md, or null for
+ * a name that isn't a plain molecule package slug.
+ */
+export function moleculeDocPath(packageName) {
+    if (!packageName)
+        return null;
+    const bare = packageName.trim().replace(/^@molecule\//, '');
+    if (!/^[a-z0-9-]+$/.test(bare))
+        return null;
+    return `/workspace/node_modules/@molecule/${bare}/MOLECULE.md`;
+}
+/** Truncate a string to `max` characters with a trailing ellipsis. */
+function truncate(value, max = 60) {
+    return value.length > max ? `${value.slice(0, max)}…` : value;
+}
+/**
+ * Human-readable label for a tool call (e.g. "Edit `ChatPanel.tsx`").
+ * @param name - The tool name (e.g. "write_file", "exec_command").
+ * @param input - The raw tool input payload.
+ * @returns A formatted label string with backtick-wrapped filenames.
+ */
+export function toolLabel(name, input) {
+    const inp = (input ?? {});
+    const path = inp.path;
+    const cmd = inp.command;
+    const pattern = inp.pattern;
+    const url = inp.url;
+    // Wrap a value in a leading-space + backticks, or return '' when it's empty.
+    // While a tool call streams, its input arrives a beat after the block is
+    // created, so path/pattern/command are briefly undefined — emitting `Read ``
+    // (empty backticks) flashed before the real filename. Drop the backticks
+    // entirely until there's a value, so the label reads "Read" then "Read `x.ts`".
+    const code = (value) => (value ? ` \`${value}\`` : '');
+    switch (name) {
+        case 'list_files':
+            return `List${code(basename(path) || 'project')}`;
+        case 'read_file':
+            return `Read${code(basename(path))}`;
+        case 'write_file':
+            return `Write${code(basename(path))}`;
+        case 'edit_file':
+            return `Edit${code(basename(path))}`;
+        case 'search_files':
+            return `Search${code(pattern ?? '')}`;
+        case 'create_directory':
+            return `Create dir${code(basename(path))}`;
+        case 'rename_file':
+            return `Rename${code(basename(inp.old_path))}`;
+        case 'delete_file':
+            return `Delete${code(basename(path))}`;
+        case 'find_files':
+            return `Find${code(pattern ?? '')}`;
+        case 'load_skill':
+            return `Load skill${code(inp.name ?? '')}`;
+        case 'find_package': {
+            const query = inp.query ?? inp.category;
+            return `Find package${code(query ?? '')}`;
+        }
+        case 'read_molecule_doc': {
+            const pkg = inp.name?.trim().replace(/^@molecule\//, '');
+            return `Read docs${code(pkg ? `@molecule/${pkg}` : '')}`;
+        }
+        case 'web_fetch': {
+            try {
+                return `Fetch ${new URL(url ?? '').hostname}`;
+            }
+            catch (_error) {
+                // URL parsing failed (malformed/empty URL) — fall back to raw URL string, safe to ignore.
+                return `Fetch ${url ?? ''}`;
+            }
+        }
+        case 'exec_command': {
+            return `Bash${code(truncate(cmd ?? ''))}`;
+        }
+        case 'sandbox_fetch': {
+            // The interesting part is WHICH endpoint (usually one the model just built) —
+            // show method + protocol-stripped URL, e.g. "GET `localhost:4000/api/todos`".
+            const method = (inp.method ?? 'GET').toUpperCase();
+            const compact = (url ?? '').replace(/^https?:\/\//, '').replace(/\/$/, '');
+            return `${method}${code(truncate(compact))}`;
+        }
+        case 'navigate_preview':
+            return `Go to${code(inp.path ?? '')}`;
+        case 'open_file':
+            return `Open${code(basename(path))}`;
+        case 'reload_preview':
+            return 'Reload preview';
+        case 'restart_preview':
+            return inp.restart === true ? 'Restart preview servers' : 'Start preview servers';
+        case 'read_preview_ui':
+            return 'Inspect preview';
+        case 'interact_preview': {
+            // Target priority mirrors the tool's own: molId is canonical, text is the
+            // visible name (usually the most readable), selector is the last resort.
+            // Deliberately NEVER show `value` — fill routinely types credentials.
+            const target = inp.text ??
+                inp.molId ??
+                inp.selector ??
+                '';
+            const verb = { click: 'Click', fill: 'Fill', select: 'Select', waitFor: 'Wait for' }[inp.action];
+            return verb ? `${verb}${code(truncate(target, 40))}` : `Interact${code(truncate(target, 40))}`;
+        }
+        case 'get_ide_state':
+            return 'Check IDE status';
+        case 'read_logs': {
+            const source = inp.source ?? '';
+            const filter = inp.filter ?? '';
+            const which = source && source !== 'all' ? `Read ${source} logs` : 'Read logs';
+            return `${which}${code(truncate(filter, 30))}`;
+        }
+        case 'find_example':
+            return `Find example${code(truncate(inp.query ?? '', 40))}`;
+        case 'save_script':
+            return `Save script${code(inp.name ?? '')}`;
+        case 'request_repo_import':
+            return 'Import repository';
+        case 'web_search':
+            return `Search web${code(truncate(inp.query ?? '', 40))}`;
+        case 'save_plan': {
+            const planName = inp.name ?? '';
+            return planName ? `Save plan \`${planName}\`` : 'Save plan';
+        }
+        case 'set_mode': {
+            const targetMode = inp.mode ?? '';
+            return targetMode ? `Switch to ${targetMode} mode` : 'Switch mode';
+        }
+        case 'ask_user':
+            return inp.question ?? 'Question';
+        default: {
+            const label = name.replace(/_/g, ' ');
+            // Salient-argument fallback for tools without an explicit case: nearly every
+            // tool has ONE short string input that carries its intent — show the first
+            // one present so a new tool never renders as a bare name. Never dump JSON.
+            const salient = [path, url, inp.query, inp.name, pattern, cmd, inp.source, inp.text].find((v) => typeof v === 'string' && v.trim() !== '');
+            return (label.charAt(0).toUpperCase() + label.slice(1) + code(salient ? truncate(salient, 40) : ''));
+        }
+    }
+}
+/**
+ * One-line result summary shown beneath the label.
+ * @param name - The tool name.
+ * @param output - The raw tool output payload.
+ * @param status - The execution status (pending, running, done, error).
+ * @returns A brief summary string describing the result.
+ */
+export function toolSummary(name, output, status) {
+    if (status === 'pending')
+        return '';
+    if (status === 'running')
+        return t('ide.toolCall.statusRunning', undefined, { defaultValue: 'Running' });
+    const out = output;
+    const hasError = typeof out === 'object' && out !== null && 'error' in out;
+    if (hasError) {
+        const msg = (out.error ?? '').toLowerCase();
+        if (msg.includes('not found') || msg.includes('no such file'))
+            return t('ide.toolCall.statusNotFound', undefined, { defaultValue: 'Not found' });
+        if (msg.includes('permission') || msg.includes('access denied'))
+            return t('ide.toolCall.statusPermissionDenied', undefined, {
+                defaultValue: 'Permission denied',
+            });
+        return t('ide.toolCall.statusFailed', undefined, { defaultValue: 'Failed' });
+    }
+    switch (name) {
+        case 'write_file': {
+            const diff = out
+                ?.diff;
+            if (!diff)
+                return '';
+            if (diff.type === 'unchanged')
+                return t('ide.toolCall.statusUnchanged', undefined, { defaultValue: 'Unchanged' });
+            return '';
+        }
+        case 'edit_file':
+            return '';
+        case 'list_files': {
+            const entries = out?.entries;
+            return entries != null
+                ? t('ide.toolCall.entryCount', { count: entries.length }, {
+                    defaultValue: '{{count}} entries',
+                })
+                : '';
+        }
+        case 'read_file':
+            return '';
+        case 'search_files': {
+            const matches = out?.matches;
+            return matches != null
+                ? t('ide.toolCall.matchCount', { count: matches.length }, {
+                    defaultValue: '{{count}} matches',
+                })
+                : '';
+        }
+        case 'find_files': {
+            const files = out?.files;
+            return files != null
+                ? t('ide.toolCall.fileCount', { count: files.length }, {
+                    defaultValue: '{{count}} files',
+                })
+                : '';
+        }
+        case 'create_directory':
+            return '';
+        case 'rename_file':
+            return '';
+        case 'delete_file':
+            return '';
+        case 'web_fetch':
+        case 'sandbox_fetch': {
+            const status_ = out?.status;
+            if (status_ == null)
+                return '';
+            if (status_ >= 200 && status_ < 300)
+                return '';
+            if (status_ === 404)
+                return t('ide.toolCall.statusNotFound', undefined, { defaultValue: 'Not found' });
+            if (status_ >= 400 && status_ < 500)
+                return t('ide.toolCall.statusFailed', undefined, { defaultValue: 'Failed' });
+            if (status_ >= 500)
+                return t('ide.toolCall.statusServerError', undefined, { defaultValue: 'Server error' });
+            return '';
+        }
+        case 'navigate_preview':
+        case 'interact_preview': {
+            // The snapshot's url is where the app actually landed — an auth-guard
+            // redirect is exactly what the user wants to see at a glance.
+            const landed = out?.url;
+            if (typeof landed !== 'string' || !landed)
+                return '';
+            try {
+                const u = new URL(landed);
+                return u.pathname + u.search;
+            }
+            catch (_error) {
+                // Not an absolute URL (already a path or malformed) — show it as-is.
+                return landed;
+            }
+        }
+        case 'exec_command': {
+            const exitCode = out?.exitCode;
+            return exitCode != null && exitCode !== 0
+                ? t('ide.toolCall.statusFailed', undefined, { defaultValue: 'Failed' })
+                : '';
+        }
+        case 'find_package': {
+            const found = out?.found;
+            if (found == null)
+                return '';
+            if (found === 0)
+                return t('ide.toolCall.noMatches', undefined, { defaultValue: 'No matches' });
+            return t('ide.toolCall.packageCount', { count: found }, { defaultValue: '{{count}} packages' });
+        }
+        case 'ask_user': {
+            if (typeof out === 'string')
+                return out;
+            const askOut = out;
+            if (askOut?.status === 'awaiting_response')
+                return '';
+            return '';
+        }
+        default:
+            return '';
+    }
+}
+/**
+ * Count truly added/removed lines between two line arrays using LCS.
+ * @param oldLines - The original lines array.
+ * @param newLines - The modified lines array.
+ * @returns An object with the number of added and removed lines.
+ */
+export function diffLineCount(oldLines, newLines) {
+    const n = oldLines.length;
+    const m = newLines.length;
+    const dp = Array.from({ length: n + 1 }, () => Array(m + 1).fill(0));
+    for (let i = 1; i <= n; i++) {
+        for (let j = 1; j <= m; j++) {
+            dp[i][j] =
+                oldLines[i - 1] === newLines[j - 1]
+                    ? dp[i - 1][j - 1] + 1
+                    : Math.max(dp[i - 1][j], dp[i][j - 1]);
+        }
+    }
+    const common = dp[n][m];
+    return { added: m - common, removed: n - common };
+}
+/**
+ * Compute lines added/removed from a file-changing tool call.
+ * @param name - The tool name (edit_file or write_file).
+ * @param input - The raw tool input payload.
+ * @param output - The raw tool output payload.
+ * @returns Diff stats with added and removed line counts, or null if not applicable.
+ */
+export function fileDiffStats(name, input, output) {
+    if (name === 'edit_file') {
+        const inp = (input ?? {});
+        const replacements = Array.isArray(inp.replacements)
+            ? inp.replacements
+            : [];
+        if (replacements.length === 0)
+            return null;
+        let added = 0;
+        let removed = 0;
+        for (const r of replacements) {
+            if (typeof r.old_string !== 'string' || typeof r.new_string !== 'string')
+                continue;
+            const d = diffLineCount(r.old_string.split('\n'), r.new_string.split('\n'));
+            added += d.added;
+            removed += d.removed;
+        }
+        return { added, removed };
+    }
+    if (name === 'write_file') {
+        const diff = output?.diff;
+        if (!diff || diff.type === 'unchanged')
+            return null;
+        if (diff.type === 'new')
+            return { added: diff.linesAdded, removed: 0 };
+        return { added: diff.linesAdded, removed: diff.linesRemoved };
+    }
+    return null;
+}
+/**
+ * Extracts the primary file path from a tool's input, if it operates on a single file.
+ * @param name - The tool name.
+ * @param input - The raw tool input payload.
+ * @returns The file path string, or null if the tool doesn't target a single file.
+ */
+export function extractFilePath(name, input) {
+    const inp = (input ?? {});
+    switch (name) {
+        case 'read_file':
+        case 'write_file':
+        case 'edit_file':
+        case 'open_file':
+            return inp.path || null;
+        case 'rename_file':
+            return inp.new_path || null;
+        case 'read_molecule_doc':
+            // Clicking the card opens the package's MOLECULE.md (pre-installed in the sandbox).
+            return moleculeDocPath(inp.name);
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=tool-call-utilities.js.map

package/dist/components/tool-call-utilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-call-utilities.js","sourceRoot":"","sources":["../../src/components/tool-call-utilities.ts"],"names":[],"mappings":"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"}

package/dist/components/user-avatar-utilities.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Safe resolution of a user's profile avatar for rendering in the chat timeline
+ * (SOC1).
+ *
+ * The IDE chat renders the signed-in user's real avatar — an inline
+ * `data:image/*` URI or a remote `http(s)` URL from the user's profile metadata
+ * — in place of a generic person glyph on their own messages. This module is the
+ * single, package-owned source of truth for deciding whether a stored avatar
+ * value is a SAFE, renderable `<img src>`.
+ *
+ * It lives in the package (not the host) on purpose: the package owns the render,
+ * so it must own the safety gate — a host that wires {@link ChatPanelProps.userAvatar}
+ * gets correct, attack-resistant behavior for free and does not need to ship its
+ * own copy. The host stays decoupled: it passes whatever string it has, and this
+ * helper — not the host — decides what reaches the DOM.
+ *
+ * Safety: only `data:image/*` URIs and `http(s)` URLs are accepted, so a
+ * `javascript:` (or other-scheme) value can never become an `<img src>`, and an
+ * oversized blob is rejected. Anything else resolves to `null`, which signals the
+ * caller to fall back to the generic icon.
+ *
+ * @module
+ */
+/** Maximum avatar source length we will render inline (~256 KB data-URI). */
+export declare const MAX_AVATAR_SRC_LENGTH = 262144;
+/**
+ * Resolve a stored avatar value to a safe `<img>` src, or `null` to fall back to
+ * the generic icon.
+ *
+ * @param avatar - The avatar value from user metadata (data-URI, URL, or absent).
+ * @returns A safe image src string, or `null` when there is no renderable avatar.
+ */
+export declare function resolveUserAvatar(avatar?: string | null): string | null;
+/**
+ * Whether a stored avatar value is renderable (vs. needing the icon fallback).
+ *
+ * @param avatar - The avatar value from user metadata.
+ * @returns `true` when {@link resolveUserAvatar} would return a src.
+ */
+export declare function hasRenderableAvatar(avatar?: string | null): boolean;
+//# sourceMappingURL=user-avatar-utilities.d.ts.map

package/dist/components/user-avatar-utilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-avatar-utilities.d.ts","sourceRoot":"","sources":["../../src/components/user-avatar-utilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,6EAA6E;AAC7E,eAAO,MAAM,qBAAqB,SAAU,CAAA;AAQ5C;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAMvE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAEnE"}

package/dist/components/user-avatar-utilities.js

@@ -0,0 +1,56 @@
+/**
+ * Safe resolution of a user's profile avatar for rendering in the chat timeline
+ * (SOC1).
+ *
+ * The IDE chat renders the signed-in user's real avatar — an inline
+ * `data:image/*` URI or a remote `http(s)` URL from the user's profile metadata
+ * — in place of a generic person glyph on their own messages. This module is the
+ * single, package-owned source of truth for deciding whether a stored avatar
+ * value is a SAFE, renderable `<img src>`.
+ *
+ * It lives in the package (not the host) on purpose: the package owns the render,
+ * so it must own the safety gate — a host that wires {@link ChatPanelProps.userAvatar}
+ * gets correct, attack-resistant behavior for free and does not need to ship its
+ * own copy. The host stays decoupled: it passes whatever string it has, and this
+ * helper — not the host — decides what reaches the DOM.
+ *
+ * Safety: only `data:image/*` URIs and `http(s)` URLs are accepted, so a
+ * `javascript:` (or other-scheme) value can never become an `<img src>`, and an
+ * oversized blob is rejected. Anything else resolves to `null`, which signals the
+ * caller to fall back to the generic icon.
+ *
+ * @module
+ */
+/** Maximum avatar source length we will render inline (~256 KB data-URI). */
+export const MAX_AVATAR_SRC_LENGTH = 262_144;
+/** Image data-URI MIME types we treat as renderable avatars. */
+const DATA_IMAGE_RE = /^data:image\/(?:png|jpe?g|gif|webp|svg\+xml|avif);/i;
+/** Remote URL schemes we treat as renderable avatars. */
+const HTTP_URL_RE = /^https?:\/\//i;
+/**
+ * Resolve a stored avatar value to a safe `<img>` src, or `null` to fall back to
+ * the generic icon.
+ *
+ * @param avatar - The avatar value from user metadata (data-URI, URL, or absent).
+ * @returns A safe image src string, or `null` when there is no renderable avatar.
+ */
+export function resolveUserAvatar(avatar) {
+    if (typeof avatar !== 'string')
+        return null;
+    const src = avatar.trim();
+    if (!src || src.length > MAX_AVATAR_SRC_LENGTH)
+        return null;
+    if (!DATA_IMAGE_RE.test(src) && !HTTP_URL_RE.test(src))
+        return null;
+    return src;
+}
+/**
+ * Whether a stored avatar value is renderable (vs. needing the icon fallback).
+ *
+ * @param avatar - The avatar value from user metadata.
+ * @returns `true` when {@link resolveUserAvatar} would return a src.
+ */
+export function hasRenderableAvatar(avatar) {
+    return resolveUserAvatar(avatar) !== null;
+}
+//# sourceMappingURL=user-avatar-utilities.js.map

package/dist/components/user-avatar-utilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-avatar-utilities.js","sourceRoot":"","sources":["../../src/components/user-avatar-utilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,6EAA6E;AAC7E,MAAM,CAAC,MAAM,qBAAqB,GAAG,OAAO,CAAA;AAE5C,gEAAgE;AAChE,MAAM,aAAa,GAAG,qDAAqD,CAAA;AAE3E,yDAAyD;AACzD,MAAM,WAAW,GAAG,eAAe,CAAA;AAEnC;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAsB;IACtD,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAA;IAC3C,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,EAAE,CAAA;IACzB,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,GAAG,qBAAqB;QAAE,OAAO,IAAI,CAAA;IAC3D,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAA;IACnE,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAsB;IACxD,OAAO,iBAAiB,CAAC,MAAM,CAAC,KAAK,IAAI,CAAA;AAC3C,CAAC"}

package/dist/components/workspace-layout-utilities.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Pure helpers for {@link WorkspaceLayout} panel sizing and resize clamping.
+ *
+ * Kept side-effect-free (no React, no DOM) so the resize math is unit-testable.
+ * The layout reads the LIVE size from `layout.sizes` — the same place
+ * `WorkspaceProvider.resizePanel` writes — so a drag is reflected and persisted
+ * (the previous code read `defaultSize`, which resize never updated, so drags
+ * silently did nothing).
+ *
+ * @module
+ */
+import type { PanelConfig, WorkspaceLayout } from '@molecule/app-ide';
+/** Smallest a panel may shrink to, as a percentage of the container. */
+export declare const MIN_PANEL_PERCENT = 10;
+/** Largest a panel may grow to, as a percentage of the container. */
+export declare const MAX_PANEL_PERCENT = 80;
+/**
+ * Clamp a panel's new size after a pixel drag delta.
+ * @param currentSize - The panel's current size as a percentage.
+ * @param deltaPx - The drag delta in pixels (positive = grow the left panel).
+ * @param containerWidth - The layout container width in pixels.
+ * @param min - Minimum allowed percentage. Defaults to {@link MIN_PANEL_PERCENT}.
+ * @param max - Maximum allowed percentage. Defaults to {@link MAX_PANEL_PERCENT}.
+ * @returns The new size as a percentage, clamped to `[min, max]`.
+ */
+export declare function clampPanelSize(currentSize: number, deltaPx: number, containerWidth: number, min?: number, max?: number): number;
+/**
+ * The live size (percentage) of the visible panel at `index`, read from
+ * `layout.sizes` keyed by the panel's position group (where `resizePanel`
+ * writes), falling back to the panel's `defaultSize`, then to an equal split.
+ * @param layout - The current workspace layout.
+ * @param panelConfigs - The visible panel configs, in render order.
+ * @param index - The index of the panel within `panelConfigs`.
+ * @returns The panel size as a percentage.
+ */
+export declare function livePanelSize(layout: WorkspaceLayout, panelConfigs: PanelConfig[], index: number): number;
+//# sourceMappingURL=workspace-layout-utilities.d.ts.map

package/dist/components/workspace-layout-utilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-layout-utilities.d.ts","sourceRoot":"","sources":["../../src/components/workspace-layout-utilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAErE,wEAAwE;AACxE,eAAO,MAAM,iBAAiB,KAAK,CAAA;AACnC,qEAAqE;AACrE,eAAO,MAAM,iBAAiB,KAAK,CAAA;AAEnC;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,EACtB,GAAG,SAAoB,EACvB,GAAG,SAAoB,GACtB,MAAM,CAIR;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,eAAe,EACvB,YAAY,EAAE,WAAW,EAAE,EAC3B,KAAK,EAAE,MAAM,GACZ,MAAM,CAiBR"}

package/dist/components/workspace-layout-utilities.js

@@ -0,0 +1,58 @@
+/**
+ * Pure helpers for {@link WorkspaceLayout} panel sizing and resize clamping.
+ *
+ * Kept side-effect-free (no React, no DOM) so the resize math is unit-testable.
+ * The layout reads the LIVE size from `layout.sizes` — the same place
+ * `WorkspaceProvider.resizePanel` writes — so a drag is reflected and persisted
+ * (the previous code read `defaultSize`, which resize never updated, so drags
+ * silently did nothing).
+ *
+ * @module
+ */
+/** Smallest a panel may shrink to, as a percentage of the container. */
+export const MIN_PANEL_PERCENT = 10;
+/** Largest a panel may grow to, as a percentage of the container. */
+export const MAX_PANEL_PERCENT = 80;
+/**
+ * Clamp a panel's new size after a pixel drag delta.
+ * @param currentSize - The panel's current size as a percentage.
+ * @param deltaPx - The drag delta in pixels (positive = grow the left panel).
+ * @param containerWidth - The layout container width in pixels.
+ * @param min - Minimum allowed percentage. Defaults to {@link MIN_PANEL_PERCENT}.
+ * @param max - Maximum allowed percentage. Defaults to {@link MAX_PANEL_PERCENT}.
+ * @returns The new size as a percentage, clamped to `[min, max]`.
+ */
+export function clampPanelSize(currentSize, deltaPx, containerWidth, min = MIN_PANEL_PERCENT, max = MAX_PANEL_PERCENT) {
+    const width = containerWidth > 0 ? containerWidth : 1;
+    const percentDelta = (deltaPx / width) * 100;
+    return Math.max(min, Math.min(max, currentSize + percentDelta));
+}
+/**
+ * The live size (percentage) of the visible panel at `index`, read from
+ * `layout.sizes` keyed by the panel's position group (where `resizePanel`
+ * writes), falling back to the panel's `defaultSize`, then to an equal split.
+ * @param layout - The current workspace layout.
+ * @param panelConfigs - The visible panel configs, in render order.
+ * @param index - The index of the panel within `panelConfigs`.
+ * @returns The panel size as a percentage.
+ */
+export function livePanelSize(layout, panelConfigs, index) {
+    const equal = Math.floor(100 / Math.max(panelConfigs.length, 1));
+    const config = panelConfigs[index];
+    if (!config)
+        return equal;
+    const group = layout.sizes?.[config.position];
+    if (group) {
+        // Index within the position group = count of preceding configs sharing it.
+        let idxInGroup = 0;
+        for (let i = 0; i < index; i++) {
+            if (panelConfigs[i]?.position === config.position)
+                idxInGroup++;
+        }
+        const size = group[idxInGroup];
+        if (typeof size === 'number' && Number.isFinite(size))
+            return size;
+    }
+    return config.defaultSize ?? equal;
+}
+//# sourceMappingURL=workspace-layout-utilities.js.map

package/dist/components/workspace-layout-utilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-layout-utilities.js","sourceRoot":"","sources":["../../src/components/workspace-layout-utilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,wEAAwE;AACxE,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAA;AACnC,qEAAqE;AACrE,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAA;AAEnC;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAC5B,WAAmB,EACnB,OAAe,EACf,cAAsB,EACtB,GAAG,GAAG,iBAAiB,EACvB,GAAG,GAAG,iBAAiB;IAEvB,MAAM,KAAK,GAAG,cAAc,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAA;IACrD,MAAM,YAAY,GAAG,CAAC,OAAO,GAAG,KAAK,CAAC,GAAG,GAAG,CAAA;IAC5C,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,WAAW,GAAG,YAAY,CAAC,CAAC,CAAA;AACjE,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAuB,EACvB,YAA2B,EAC3B,KAAa;IAEb,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAA;IAChE,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,CAAA;IAClC,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAA;IAEzB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;IAC7C,IAAI,KAAK,EAAE,CAAC;QACV,2EAA2E;QAC3E,IAAI,UAAU,GAAG,CAAC,CAAA;QAClB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/B,IAAI,YAAY,CAAC,CAAC,CAAC,EAAE,QAAQ,KAAK,MAAM,CAAC,QAAQ;gBAAE,UAAU,EAAE,CAAA;QACjE,CAAC;QACD,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,CAAA;QAC9B,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAA;IACpE,CAAC;IAED,OAAO,MAAM,CAAC,WAAW,IAAI,KAAK,CAAA;AACpC,CAAC"}