tabctl 0.1.4 → 0.2.1

package/dist/extension/lib/groups.js

@@ -0,0 +1,443 @@
+"use strict";
+// Group management — extracted from background.ts (pure structural refactor).
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getGroupTabs = getGroupTabs;
+exports.listGroupSummaries = listGroupSummaries;
+exports.summarizeGroupMatch = summarizeGroupMatch;
+exports.findGroupMatches = findGroupMatches;
+exports.resolveGroupByTitle = resolveGroupByTitle;
+exports.resolveGroupById = resolveGroupById;
+exports.listGroups = listGroups;
+exports.groupUpdate = groupUpdate;
+exports.groupUngroup = groupUngroup;
+exports.groupAssign = groupAssign;
+function getGroupTabs(windowSnapshot, groupId) {
+    return windowSnapshot.tabs
+        .filter((tab) => tab.groupId === groupId)
+        .sort((a, b) => (Number(a.index) || 0) - (Number(b.index) || 0));
+}
+function listGroupSummaries(snapshot, buildWindowLabels, windowId) {
+    const windowLabels = buildWindowLabels(snapshot);
+    const summaries = [];
+    const windows = snapshot.windows;
+    for (const win of windows) {
+        if (windowId && win.windowId !== windowId) {
+            continue;
+        }
+        for (const group of win.groups) {
+            summaries.push({
+                windowId: win.windowId,
+                windowLabel: windowLabels.get(win.windowId) ?? null,
+                groupId: group.groupId,
+                title: typeof group.title === "string" ? group.title : null,
+            });
+        }
+    }
+    return summaries;
+}
+function summarizeGroupMatch(match, windowLabels) {
+    return {
+        windowId: match.windowId,
+        windowLabel: windowLabels.get(match.windowId) ?? null,
+        groupId: match.group.groupId,
+        title: typeof match.group.title === "string" ? match.group.title : null,
+    };
+}
+function findGroupMatches(snapshot, groupTitle, windowId) {
+    const matches = [];
+    const windows = snapshot.windows;
+    for (const win of windows) {
+        if (windowId && win.windowId !== windowId) {
+            continue;
+        }
+        for (const group of win.groups) {
+            if (group.title === groupTitle) {
+                matches.push({
+                    windowId: win.windowId,
+                    group,
+                    tabs: getGroupTabs(win, group.groupId),
+                });
+            }
+        }
+    }
+    return matches;
+}
+function resolveGroupByTitle(snapshot, buildWindowLabels, groupTitle, windowId) {
+    const windowLabels = buildWindowLabels(snapshot);
+    const allMatches = findGroupMatches(snapshot, groupTitle);
+    const matches = windowId ? allMatches.filter((match) => match.windowId === windowId) : allMatches;
+    const availableGroups = listGroupSummaries(snapshot, buildWindowLabels);
+    if (matches.length === 0) {
+        const message = windowId && allMatches.length > 0
+            ? "Group title not found in specified window"
+            : "No matching group title found";
+        return {
+            error: {
+                message,
+                hint: "Use tabctl group-list to see existing groups.",
+                matches: allMatches.map((match) => summarizeGroupMatch(match, windowLabels)),
+                availableGroups,
+            },
+        };
+    }
+    if (matches.length > 1) {
+        return {
+            error: {
+                message: "Group title is ambiguous. Provide a windowId.",
+                hint: "Use --window to disambiguate group titles.",
+                matches: matches.map((match) => summarizeGroupMatch(match, windowLabels)),
+                availableGroups,
+            },
+        };
+    }
+    return { match: matches[0] };
+}
+function resolveGroupById(snapshot, buildWindowLabels, groupId) {
+    const windows = snapshot.windows;
+    const matches = [];
+    for (const win of windows) {
+        const group = win.groups.find((entry) => entry.groupId === groupId);
+        if (group) {
+            matches.push({
+                windowId: win.windowId,
+                group,
+                tabs: getGroupTabs(win, groupId),
+            });
+        }
+    }
+    if (matches.length === 0) {
+        return {
+            error: {
+                message: "Group not found",
+                hint: "Use tabctl group-list to see existing groups.",
+                availableGroups: listGroupSummaries(snapshot, buildWindowLabels),
+            },
+        };
+    }
+    if (matches.length > 1) {
+        const windowLabels = buildWindowLabels(snapshot);
+        return {
+            error: {
+                message: "Group id is ambiguous. Provide a windowId.",
+                hint: "Use --window to disambiguate group ids.",
+                matches: matches.map((match) => summarizeGroupMatch(match, windowLabels)),
+                availableGroups: listGroupSummaries(snapshot, buildWindowLabels),
+            },
+        };
+    }
+    return { match: matches[0] };
+}
+async function listGroups(params, deps) {
+    const snapshot = await deps.getTabSnapshot();
+    const windows = snapshot.windows;
+    const windowLabels = deps.buildWindowLabels(snapshot);
+    const windowIdParam = params.windowId != null ? deps.resolveWindowIdFromParams(snapshot, params.windowId) : null;
+    if (windowIdParam && !windows.some((win) => win.windowId === windowIdParam)) {
+        throw new Error("Window not found");
+    }
+    const groups = [];
+    for (const win of windows) {
+        if (windowIdParam && win.windowId !== windowIdParam) {
+            continue;
+        }
+        const counts = new Map();
+        for (const tab of win.tabs) {
+            const groupId = tab.groupId;
+            if (typeof groupId === "number" && groupId !== -1) {
+                counts.set(groupId, (counts.get(groupId) || 0) + 1);
+            }
+        }
+        for (const group of win.groups) {
+            const groupId = group.groupId;
+            groups.push({
+                windowId: win.windowId,
+                windowLabel: windowLabels.get(win.windowId) ?? null,
+                groupId,
+                title: group.title ?? null,
+                color: group.color ?? null,
+                collapsed: group.collapsed ?? null,
+                tabCount: counts.get(groupId) || 0,
+            });
+        }
+    }
+    return { groups };
+}
+async function groupUpdate(params, deps) {
+    const groupId = Number.isFinite(params.groupId) ? Number(params.groupId) : null;
+    const groupTitle = typeof params.groupTitle === "string" ? params.groupTitle.trim() : "";
+    if (!groupId && !groupTitle) {
+        throw new Error("Missing group identifier");
+    }
+    const snapshot = await deps.getTabSnapshot();
+    const windows = snapshot.windows;
+    const windowIdParam = params.windowId != null ? deps.resolveWindowIdFromParams(snapshot, params.windowId) : null;
+    if (windowIdParam && !windows.some((win) => win.windowId === windowIdParam)) {
+        throw new Error("Window not found");
+    }
+    let match;
+    if (groupId != null) {
+        const resolved = resolveGroupById(snapshot, deps.buildWindowLabels, groupId);
+        if (resolved.error) {
+            throw resolved.error;
+        }
+        match = resolved.match;
+        if (windowIdParam && windowIdParam !== match.windowId) {
+            throw new Error("Group is not in the specified window");
+        }
+    }
+    else {
+        const resolved = resolveGroupByTitle(snapshot, deps.buildWindowLabels, groupTitle, windowIdParam || undefined);
+        if (resolved.error) {
+            throw resolved.error;
+        }
+        match = resolved.match;
+    }
+    const update = {};
+    if (typeof params.title === "string") {
+        update.title = params.title;
+    }
+    if (typeof params.color === "string" && params.color.trim()) {
+        update.color = params.color.trim();
+    }
+    if (typeof params.collapsed === "boolean") {
+        update.collapsed = params.collapsed;
+    }
+    if (!Object.keys(update).length) {
+        throw new Error("Missing group update fields");
+    }
+    const updated = await chrome.tabGroups.update(match.group.groupId, update);
+    return {
+        groupId: updated.id,
+        windowId: updated.windowId,
+        title: updated.title,
+        color: updated.color,
+        collapsed: updated.collapsed,
+        undo: {
+            action: "group-update",
+            groupId: updated.id,
+            windowId: match.windowId,
+            previous: {
+                title: match.group.title ?? null,
+                color: match.group.color ?? null,
+                collapsed: match.group.collapsed ?? null,
+            },
+        },
+        txid: params.txid || null,
+    };
+}
+async function groupUngroup(params, deps) {
+    const groupId = Number.isFinite(params.groupId) ? Number(params.groupId) : null;
+    const groupTitle = typeof params.groupTitle === "string" ? params.groupTitle.trim() : "";
+    if (!groupId && !groupTitle) {
+        throw new Error("Missing group identifier");
+    }
+    const snapshot = await deps.getTabSnapshot();
+    const windows = snapshot.windows;
+    const windowIdParam = params.windowId != null ? deps.resolveWindowIdFromParams(snapshot, params.windowId) : null;
+    if (windowIdParam && !windows.some((win) => win.windowId === windowIdParam)) {
+        throw new Error("Window not found");
+    }
+    let match;
+    if (groupId != null) {
+        const resolved = resolveGroupById(snapshot, deps.buildWindowLabels, groupId);
+        if (resolved.error) {
+            throw resolved.error;
+        }
+        match = resolved.match;
+        if (windowIdParam && windowIdParam !== match.windowId) {
+            throw new Error("Group is not in the specified window");
+        }
+    }
+    else {
+        const resolved = resolveGroupByTitle(snapshot, deps.buildWindowLabels, groupTitle, windowIdParam || undefined);
+        if (resolved.error) {
+            throw resolved.error;
+        }
+        match = resolved.match;
+    }
+    const undoTabs = match.tabs
+        .map((tab) => ({
+        tabId: tab.tabId,
+        windowId: tab.windowId,
+        index: tab.index,
+        groupId: tab.groupId,
+        groupTitle: tab.groupTitle,
+        groupColor: tab.groupColor,
+        groupCollapsed: match.group.collapsed ?? null,
+    }))
+        .filter((tab) => typeof tab.tabId === "number");
+    const tabIds = match.tabs
+        .map((tab) => tab.tabId)
+        .filter((tabId) => typeof tabId === "number");
+    if (tabIds.length) {
+        await chrome.tabs.ungroup(tabIds);
+    }
+    return {
+        groupId: match.group.groupId,
+        groupTitle: match.group.title || null,
+        windowId: match.windowId,
+        summary: {
+            ungroupedTabs: tabIds.length,
+        },
+        undo: {
+            action: "group-ungroup",
+            groupId: match.group.groupId,
+            windowId: match.windowId,
+            groupTitle: match.group.title || null,
+            groupColor: match.group.color || null,
+            groupCollapsed: match.group.collapsed ?? null,
+            tabs: undoTabs,
+        },
+        txid: params.txid || null,
+    };
+}
+async function groupAssign(params, deps) {
+    const rawTabIds = Array.isArray(params.tabIds) ? params.tabIds.map(Number) : [];
+    const tabIds = rawTabIds.filter((id) => Number.isFinite(id));
+    if (!tabIds.length) {
+        throw new Error("Missing tabIds");
+    }
+    const groupId = Number.isFinite(params.groupId) ? Number(params.groupId) : null;
+    const groupTitle = typeof params.groupTitle === "string" ? params.groupTitle.trim() : "";
+    if (!groupId && !groupTitle) {
+        throw new Error("Missing group identifier");
+    }
+    const snapshot = await deps.getTabSnapshot();
+    const windows = snapshot.windows;
+    const windowIdParam = params.windowId != null ? deps.resolveWindowIdFromParams(snapshot, params.windowId) : null;
+    if (windowIdParam && !windows.some((win) => win.windowId === windowIdParam)) {
+        throw new Error("Window not found");
+    }
+    const tabIndex = new Map();
+    for (const win of windows) {
+        for (const tab of win.tabs) {
+            if (typeof tab.tabId === "number") {
+                tabIndex.set(tab.tabId, { tab, windowId: win.windowId });
+            }
+        }
+    }
+    const skipped = [];
+    const resolvedTabIds = [];
+    const sourceWindows = new Set();
+    const undoTabs = [];
+    for (const tabId of tabIds) {
+        const entry = tabIndex.get(tabId);
+        if (!entry) {
+            skipped.push({ tabId, reason: "not_found" });
+            continue;
+        }
+        resolvedTabIds.push(tabId);
+        sourceWindows.add(entry.windowId);
+        const tab = entry.tab;
+        undoTabs.push({
+            tabId,
+            windowId: entry.windowId,
+            index: tab.index,
+            groupId: tab.groupId,
+            groupTitle: tab.groupTitle,
+            groupColor: tab.groupColor,
+            groupCollapsed: tab.groupCollapsed ?? null,
+        });
+    }
+    if (!resolvedTabIds.length) {
+        throw new Error("No matching tabs found");
+    }
+    let targetGroupId = null;
+    let targetWindowId = null;
+    let targetTitle = null;
+    let created = false;
+    if (groupId != null) {
+        const resolved = resolveGroupById(snapshot, deps.buildWindowLabels, groupId);
+        if (resolved.error) {
+            throw resolved.error;
+        }
+        const match = resolved.match;
+        targetGroupId = match.group.groupId;
+        targetWindowId = match.windowId;
+        targetTitle = typeof match.group.title === "string" ? match.group.title : null;
+        if (windowIdParam && windowIdParam !== targetWindowId) {
+            throw new Error("Group is not in the specified window");
+        }
+    }
+    else {
+        const resolved = resolveGroupByTitle(snapshot, deps.buildWindowLabels, groupTitle, windowIdParam || undefined);
+        if (resolved.error) {
+            const error = resolved.error;
+            if (error.message === "No matching group title found" && params.create === true) {
+                targetWindowId = windowIdParam || (sourceWindows.size === 1 ? Array.from(sourceWindows)[0] : null);
+                if (!targetWindowId) {
+                    throw new Error("Multiple source windows. Provide --window to create a new group.");
+                }
+                targetTitle = groupTitle;
+                created = true;
+            }
+            else {
+                throw error;
+            }
+        }
+        else {
+            const match = resolved.match;
+            targetGroupId = match.group.groupId;
+            targetWindowId = match.windowId;
+            targetTitle = typeof match.group.title === "string" && match.group.title ? match.group.title : groupTitle;
+        }
+    }
+    if (!targetWindowId) {
+        throw new Error("Target window not found");
+    }
+    const moveIds = resolvedTabIds.filter((tabId) => {
+        const entry = tabIndex.get(tabId);
+        return entry && entry.windowId !== targetWindowId;
+    });
+    if (moveIds.length > 0) {
+        await chrome.tabs.move(moveIds, { windowId: targetWindowId, index: -1 });
+    }
+    let assignedGroupId = targetGroupId;
+    if (targetGroupId != null) {
+        await chrome.tabs.group({ groupId: targetGroupId, tabIds: resolvedTabIds });
+    }
+    else {
+        assignedGroupId = await chrome.tabs.group({ tabIds: resolvedTabIds, createProperties: { windowId: targetWindowId } });
+        const update = {};
+        if (targetTitle) {
+            update.title = targetTitle;
+        }
+        if (typeof params.color === "string" && params.color.trim()) {
+            update.color = params.color.trim();
+        }
+        if (typeof params.collapsed === "boolean") {
+            update.collapsed = params.collapsed;
+        }
+        if (Object.keys(update).length > 0) {
+            try {
+                await chrome.tabGroups.update(assignedGroupId, update);
+            }
+            catch (error) {
+                deps.log("Failed to update group", error);
+            }
+        }
+        created = true;
+    }
+    return {
+        groupId: assignedGroupId,
+        groupTitle: targetTitle || groupTitle || null,
+        windowId: targetWindowId,
+        created,
+        summary: {
+            movedTabs: moveIds.length,
+            groupedTabs: resolvedTabIds.length,
+            skippedTabs: skipped.length,
+        },
+        skipped,
+        undo: {
+            action: "group-assign",
+            groupId: assignedGroupId,
+            groupTitle: targetTitle || groupTitle || null,
+            groupColor: typeof params.color === "string" && params.color.trim() ? params.color.trim() : null,
+            groupCollapsed: typeof params.collapsed === "boolean" ? params.collapsed : null,
+            created,
+            tabs: undoTabs,
+        },
+        txid: params.txid || null,
+    };
+}