@detergent-software/atk 0.12.1-dev.2

package/build/hooks/useBrowseState.js

@@ -0,0 +1,315 @@
+import { useCallback, useReducer } from 'react';
+import { isInstalled } from '../lib/lockfile.js';
+export const TYPE_TABS = [
+    'all',
+    'skill',
+    'agent',
+    'rule',
+    'hook',
+    'memory-template',
+    'mcp-config',
+    'bundle',
+];
+export const TYPE_TAB_LABELS = {
+    agent: 'Agents',
+    all: 'All',
+    bundle: 'Bundles',
+    hook: 'Hooks',
+    'mcp-config': 'MCP Configs',
+    'memory-template': 'Memory Templates',
+    rule: 'Rules',
+    skill: 'Skills',
+};
+// --- Reducer ---
+export function browseReducer(state, action) {
+    switch (action.type) {
+        case 'LOAD_ERROR':
+            if (state.status !== 'loading')
+                return state;
+            return { message: action.message, status: 'error' };
+        case 'SET_VIEWPORT_HEIGHT':
+            if (state.status === 'ready' || state.status === 'loading') {
+                return { ...state, viewportHeight: action.height };
+            }
+            return state;
+    }
+    if (action.type === 'LOAD_SUCCESS') {
+        if (state.status !== 'loading')
+            return state;
+        const allAssets = action.registry.assets;
+        const allBundles = action.registry.bundles ?? [];
+        const typeFilter = action.initialTypeFilter ?? 'all';
+        const filterText = action.initialFilterText ?? '';
+        return {
+            allAssets,
+            allBundles,
+            cursorIndex: 0,
+            expandedIndex: null,
+            filteredItems: computeFilteredItems(allAssets, allBundles, typeFilter, filterText),
+            filterText,
+            lockfile: action.lockfile,
+            mode: { inputMode: 'navigate', kind: 'browsing' },
+            registry: action.registry,
+            scrollOffset: 0,
+            status: 'ready',
+            typeFilter,
+            viewportHeight: state.viewportHeight,
+        };
+    }
+    if (state.status !== 'ready')
+        return state;
+    switch (action.type) {
+        case 'APPEND_FILTER_CHAR': {
+            const newText = state.filterText + action.char;
+            const newItems = computeFilteredItems(state.allAssets, state.allBundles, state.typeFilter, newText);
+            return {
+                ...state,
+                cursorIndex: 0,
+                expandedIndex: null,
+                filteredItems: newItems,
+                filterText: newText,
+                scrollOffset: 0,
+            };
+        }
+        case 'BEGIN_INSTALL': {
+            if (state.mode.kind !== 'browsing')
+                return state;
+            if (state.filteredItems.length === 0)
+                return state;
+            const item = state.filteredItems[state.cursorIndex];
+            if (item.kind === 'asset') {
+                return {
+                    ...state,
+                    mode: {
+                        alreadyInstalled: isInstalled(state.lockfile, item.data.name, item.data.type),
+                        assetName: item.data.name,
+                        assetVersion: item.data.latest,
+                        itemKind: 'asset',
+                        kind: 'confirming-install',
+                    },
+                };
+            }
+            const bundleAssets = item.data.assets ?? [];
+            const anyBundleAssetInstalled = bundleAssets.length > 0 && bundleAssets.some((a) => isInstalled(state.lockfile, a.name, a.type));
+            return {
+                ...state,
+                mode: {
+                    alreadyInstalled: anyBundleAssetInstalled,
+                    assetName: item.data.name,
+                    assetVersion: item.data.version,
+                    bundleAssetCount: item.data.assetCount,
+                    bundleName: item.data.name,
+                    itemKind: 'bundle',
+                    kind: 'confirming-install',
+                },
+            };
+        }
+        case 'CANCEL_INSTALL': {
+            if (state.mode.kind !== 'confirming-install')
+                return state;
+            return { ...state, mode: { inputMode: 'navigate', kind: 'browsing' } };
+        }
+        case 'COLLAPSE': {
+            if (state.expandedIndex === null)
+                return state;
+            return { ...state, expandedIndex: null };
+        }
+        case 'CONFIRM_INSTALL': {
+            if (state.mode.kind !== 'confirming-install')
+                return state;
+            return {
+                ...state,
+                mode: {
+                    assetName: state.mode.assetName,
+                    assetVersion: state.mode.assetVersion,
+                    bundleAssetCount: state.mode.bundleAssetCount,
+                    bundleName: state.mode.bundleName,
+                    itemKind: state.mode.itemKind,
+                    kind: 'installing',
+                    message: `Installing ${state.mode.assetName}...`,
+                },
+            };
+        }
+        case 'CURSOR_DOWN': {
+            if (state.filteredItems.length === 0)
+                return state;
+            const newIndex = Math.min(state.filteredItems.length - 1, state.cursorIndex + 1);
+            if (newIndex === state.cursorIndex)
+                return state;
+            const newScroll = clampScroll(newIndex, state.scrollOffset, state.viewportHeight);
+            return {
+                ...state,
+                cursorIndex: newIndex,
+                expandedIndex: null,
+                scrollOffset: newScroll,
+            };
+        }
+        case 'CURSOR_UP': {
+            if (state.filteredItems.length === 0)
+                return state;
+            const newIndex = Math.max(0, state.cursorIndex - 1);
+            if (newIndex === state.cursorIndex)
+                return state;
+            const newScroll = clampScroll(newIndex, state.scrollOffset, state.viewportHeight);
+            return {
+                ...state,
+                cursorIndex: newIndex,
+                expandedIndex: null,
+                scrollOffset: newScroll,
+            };
+        }
+        case 'CYCLE_TYPE': {
+            const currentIdx = TYPE_TABS.indexOf(state.typeFilter);
+            const nextIdx = (currentIdx + 1) % TYPE_TABS.length;
+            const newTypeFilter = TYPE_TABS[nextIdx];
+            const newItems = computeFilteredItems(state.allAssets, state.allBundles, newTypeFilter, state.filterText);
+            return {
+                ...state,
+                cursorIndex: 0,
+                expandedIndex: null,
+                filteredItems: newItems,
+                scrollOffset: 0,
+                typeFilter: newTypeFilter,
+            };
+        }
+        case 'DELETE_FILTER_CHAR': {
+            if (state.filterText.length === 0)
+                return state;
+            const newText = state.filterText.slice(0, -1);
+            const newItems = computeFilteredItems(state.allAssets, state.allBundles, state.typeFilter, newText);
+            return {
+                ...state,
+                cursorIndex: 0,
+                expandedIndex: null,
+                filteredItems: newItems,
+                filterText: newText,
+                scrollOffset: 0,
+            };
+        }
+        case 'DISMISS_RESULT': {
+            if (state.mode.kind !== 'install-result')
+                return state;
+            return { ...state, mode: { inputMode: 'navigate', kind: 'browsing' } };
+        }
+        case 'ENTER_FILTER_MODE': {
+            if (state.mode.kind !== 'browsing')
+                return state;
+            return { ...state, mode: { inputMode: 'filter', kind: 'browsing' } };
+        }
+        case 'EXIT_FILTER_MODE': {
+            if (state.mode.kind !== 'browsing')
+                return state;
+            return { ...state, mode: { inputMode: 'navigate', kind: 'browsing' } };
+        }
+        case 'EXPAND_TOGGLE': {
+            if (state.filteredItems.length === 0)
+                return state;
+            const newExpanded = state.expandedIndex === state.cursorIndex ? null : state.cursorIndex;
+            return { ...state, expandedIndex: newExpanded };
+        }
+        case 'INSTALL_COMPLETE': {
+            if (state.mode.kind !== 'installing')
+                return state;
+            return {
+                ...state,
+                lockfile: action.newLockfile ?? state.lockfile,
+                mode: {
+                    assetName: state.mode.assetName,
+                    bundleAssetCount: state.mode.bundleAssetCount,
+                    bundleName: state.mode.bundleName,
+                    itemKind: state.mode.itemKind,
+                    kind: 'install-result',
+                    message: action.message,
+                    success: action.success,
+                },
+            };
+        }
+        case 'INSTALL_PROGRESS': {
+            if (state.mode.kind !== 'installing')
+                return state;
+            return {
+                ...state,
+                mode: { ...state.mode, message: action.message },
+            };
+        }
+        default:
+            return state;
+    }
+}
+// --- Helpers ---
+export function computeFilteredItems(allAssets, allBundles, typeFilter, filterText) {
+    const query = filterText.toLowerCase().trim();
+    function matchesText(name, description, tags, author) {
+        if (!query)
+            return true;
+        return (name.toLowerCase().includes(query) ||
+            description.toLowerCase().includes(query) ||
+            tags.some((t) => t.toLowerCase().includes(query)) ||
+            author.toLowerCase().includes(query));
+    }
+    const items = [];
+    if (typeFilter === 'bundle') {
+        // Bundles only
+        for (const b of allBundles) {
+            if (matchesText(b.name, b.description, b.tags, b.author)) {
+                items.push({ data: b, kind: 'bundle' });
+            }
+        }
+    }
+    else if (typeFilter === 'all') {
+        // Assets + bundles mixed
+        for (const a of allAssets) {
+            const latestVersion = a.versions[a.latest];
+            if (matchesText(a.name, latestVersion?.description ?? '', a.tags, latestVersion?.author ?? '')) {
+                items.push({ data: a, kind: 'asset' });
+            }
+        }
+        for (const b of allBundles) {
+            if (matchesText(b.name, b.description, b.tags, b.author)) {
+                items.push({ data: b, kind: 'bundle' });
+            }
+        }
+    }
+    else {
+        // Specific asset type (no bundles)
+        for (const a of allAssets) {
+            const latestVersion = a.versions[a.latest];
+            if (a.type === typeFilter &&
+                matchesText(a.name, latestVersion?.description ?? '', a.tags, latestVersion?.author ?? '')) {
+                items.push({ data: a, kind: 'asset' });
+            }
+        }
+    }
+    return items.sort((a, b) => a.data.name.localeCompare(b.data.name));
+}
+// --- Hook ---
+export function useBrowseState(initialFilterText, initialTypeFilter) {
+    const initialState = {
+        message: 'Loading registry...',
+        status: 'loading',
+        viewportHeight: 20,
+    };
+    const [state, dispatch] = useReducer(browseReducer, initialState);
+    const dispatchLoad = useCallback((registry, lockfile) => {
+        dispatch({
+            initialFilterText: initialFilterText || undefined,
+            initialTypeFilter: initialTypeFilter !== 'all' ? initialTypeFilter : undefined,
+            lockfile,
+            registry,
+            type: 'LOAD_SUCCESS',
+        });
+    }, [initialFilterText, initialTypeFilter]);
+    return [state, dispatch, dispatchLoad];
+}
+function clampScroll(cursorIndex, scrollOffset, viewportHeight) {
+    if (viewportHeight <= 0)
+        return 0;
+    if (cursorIndex < scrollOffset) {
+        return cursorIndex;
+    }
+    if (cursorIndex >= scrollOffset + viewportHeight) {
+        return cursorIndex - viewportHeight + 1;
+    }
+    return scrollOffset;
+}
+//# sourceMappingURL=useBrowseState.js.map

package/build/hooks/useBrowseState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBrowseState.js","sourceRoot":"","sources":["../../src/hooks/useBrowseState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAMhD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAMjD,MAAM,CAAC,MAAM,SAAS,GAAsB;IAC1C,KAAK;IACL,OAAO;IACP,OAAO;IACP,MAAM;IACN,MAAM;IACN,iBAAiB;IACjB,YAAY;IACZ,QAAQ;CACT,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAoC;IAC9D,KAAK,EAAE,QAAQ;IACf,GAAG,EAAE,KAAK;IACV,MAAM,EAAE,SAAS;IACjB,IAAI,EAAE,OAAO;IACb,YAAY,EAAE,aAAa;IAC3B,iBAAiB,EAAE,kBAAkB;IACrC,IAAI,EAAE,OAAO;IACb,KAAK,EAAE,QAAQ;CAChB,CAAC;AAoGF,kBAAkB;AAElB,MAAM,UAAU,aAAa,CAAC,KAAkB,EAAE,MAAoB;IACpE,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,YAAY;YACf,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;gBAAE,OAAO,KAAK,CAAC;YAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;QACtD,KAAK,qBAAqB;YACxB,IAAI,KAAK,CAAC,MAAM,KAAK,OAAO,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC3D,OAAO,EAAE,GAAG,KAAK,EAAE,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;YACrD,CAAC;YACD,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;QACnC,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QAC7C,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;QACzC,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC;QACjD,MAAM,UAAU,GAAG,MAAM,CAAC,iBAAiB,IAAI,KAAK,CAAC;QACrD,MAAM,UAAU,GAAG,MAAM,CAAC,iBAAiB,IAAI,EAAE,CAAC;QAClD,OAAO;YACL,SAAS;YACT,UAAU;YACV,WAAW,EAAE,CAAC;YACd,aAAa,EAAE,IAAI;YACnB,aAAa,EAAE,oBAAoB,CAAC,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,CAAC;YAClF,UAAU;YACV,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,IAAI,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE;YACjD,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,YAAY,EAAE,CAAC;YACf,MAAM,EAAE,OAAO;YACf,UAAU;YACV,cAAc,EAAE,KAAK,CAAC,cAAc;SACrC,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC;IAE3C,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,oBAAoB,CAAC,CAAC,CAAC;YAC1B,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC;YAC/C,MAAM,QAAQ,GAAG,oBAAoB,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YACpG,OAAO;gBACL,GAAG,KAAK;gBACR,WAAW,EAAE,CAAC;gBACd,aAAa,EAAE,IAAI;gBACnB,aAAa,EAAE,QAAQ;gBACvB,UAAU,EAAE,OAAO;gBACnB,YAAY,EAAE,CAAC;aAChB,CAAC;QACJ,CAAC;QAED,KAAK,eAAe,CAAC,CAAC,CAAC;YACrB,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,UAAU;gBAAE,OAAO,KAAK,CAAC;YACjD,IAAI,KAAK,CAAC,aAAa,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,KAAK,CAAC;YACnD,MAAM,IAAI,GAAG,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,WAAW,CAAE,CAAC;YACrD,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;gBAC1B,OAAO;oBACL,GAAG,KAAK;oBACR,IAAI,EAAE;wBACJ,gBAAgB,EAAE,WAAW,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;wBAC7E,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI;wBACzB,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM;wBAC9B,QAAQ,EAAE,OAAO;wBACjB,IAAI,EAAE,oBAAoB;qBAC3B;iBACF,CAAC;YACJ,CAAC;YACD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC;YAC5C,MAAM,uBAAuB,GAC3B,YAAY,CAAC,MAAM,GAAG,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;YACnG,OAAO;gBACL,GAAG,KAAK;gBACR,IAAI,EAAE;oBACJ,gBAAgB,EAAE,uBAAuB;oBACzC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI;oBACzB,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO;oBAC/B,gBAAgB,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU;oBACtC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI;oBAC1B,QAAQ,EAAE,QAAQ;oBAClB,IAAI,EAAE,oBAAoB;iBAC3B;aACF,CAAC;QACJ,CAAC;QAED,KAAK,gBAAgB,CAAC,CAAC,CAAC;YACtB,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,oBAAoB;gBAAE,OAAO,KAAK,CAAC;YAC3D,OAAO,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,CAAC;QACzE,CAAC;QAED,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,IAAI,KAAK,CAAC,aAAa,KAAK,IAAI;gBAAE,OAAO,KAAK,CAAC;YAC/C,OAAO,EAAE,GAAG,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;QAC3C,CAAC;QAED,KAAK,iBAAiB,CAAC,CAAC,CAAC;YACvB,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,oBAAoB;gBAAE,OAAO,KAAK,CAAC;YAC3D,OAAO;gBACL,GAAG,KAAK;gBACR,IAAI,EAAE;oBACJ,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,SAAS;oBAC/B,YAAY,EAAE,KAAK,CAAC,IAAI,CAAC,YAAY;oBACrC,gBAAgB,EAAE,KAAK,CAAC,IAAI,CAAC,gBAAgB;oBAC7C,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,UAAU;oBACjC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ;oBAC7B,IAAI,EAAE,YAAY;oBAClB,OAAO,EAAE,cAAc,KAAK,CAAC,IAAI,CAAC,SAAS,KAAK;iBACjD;aACF,CAAC;QACJ,CAAC;QAED,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,IAAI,KAAK,CAAC,aAAa,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,KAAK,CAAC;YACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC;YACjF,IAAI,QAAQ,KAAK,KAAK,CAAC,WAAW;gBAAE,OAAO,KAAK,CAAC;YACjD,MAAM,SAAS,GAAG,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;YAClF,OAAO;gBACL,GAAG,KAAK;gBACR,WAAW,EAAE,QAAQ;gBACrB,aAAa,EAAE,IAAI;gBACnB,YAAY,EAAE,SAAS;aACxB,CAAC;QACJ,CAAC;QAED,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,IAAI,KAAK,CAAC,aAAa,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,KAAK,CAAC;YACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC;YACpD,IAAI,QAAQ,KAAK,KAAK,CAAC,WAAW;gBAAE,OAAO,KAAK,CAAC;YACjD,MAAM,SAAS,GAAG,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;YAClF,OAAO;gBACL,GAAG,KAAK;gBACR,WAAW,EAAE,QAAQ;gBACrB,aAAa,EAAE,IAAI;gBACnB,YAAY,EAAE,SAAS;aACxB,CAAC;QACJ,CAAC;QAED,KAAK,YAAY,CAAC,CAAC,CAAC;YAClB,MAAM,UAAU,GAAG,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YACvD,MAAM,OAAO,GAAG,CAAC,UAAU,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC;YACpD,MAAM,aAAa,GAAG,SAAS,CAAC,OAAO,CAAE,CAAC;YAC1C,MAAM,QAAQ,GAAG,oBAAoB,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,UAAU,EAAE,aAAa,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;YAC1G,OAAO;gBACL,GAAG,KAAK;gBACR,WAAW,EAAE,CAAC;gBACd,aAAa,EAAE,IAAI;gBACnB,aAAa,EAAE,QAAQ;gBACvB,YAAY,EAAE,CAAC;gBACf,UAAU,EAAE,aAAa;aAC1B,CAAC;QACJ,CAAC;QAED,KAAK,oBAAoB,CAAC,CAAC,CAAC;YAC1B,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,KAAK,CAAC;YAChD,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YAC9C,MAAM,QAAQ,GAAG,oBAAoB,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YACpG,OAAO;gBACL,GAAG,KAAK;gBACR,WAAW,EAAE,CAAC;gBACd,aAAa,EAAE,IAAI;gBACnB,aAAa,EAAE,QAAQ;gBACvB,UAAU,EAAE,OAAO;gBACnB,YAAY,EAAE,CAAC;aAChB,CAAC;QACJ,CAAC;QAED,KAAK,gBAAgB,CAAC,CAAC,CAAC;YACtB,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,gBAAgB;gBAAE,OAAO,KAAK,CAAC;YACvD,OAAO,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,CAAC;QACzE,CAAC;QAED,KAAK,mBAAmB,CAAC,CAAC,CAAC;YACzB,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,UAAU;gBAAE,OAAO,KAAK,CAAC;YACjD,OAAO,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,CAAC;QACvE,CAAC;QAED,KAAK,kBAAkB,CAAC,CAAC,CAAC;YACxB,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,UAAU;gBAAE,OAAO,KAAK,CAAC;YACjD,OAAO,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,CAAC;QACzE,CAAC;QAED,KAAK,eAAe,CAAC,CAAC,CAAC;YACrB,IAAI,KAAK,CAAC,aAAa,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,KAAK,CAAC;YACnD,MAAM,WAAW,GAAG,KAAK,CAAC,aAAa,KAAK,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC;YACzF,OAAO,EAAE,GAAG,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,CAAC;QAClD,CAAC;QAED,KAAK,kBAAkB,CAAC,CAAC,CAAC;YACxB,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,YAAY;gBAAE,OAAO,KAAK,CAAC;YACnD,OAAO;gBACL,GAAG,KAAK;gBACR,QAAQ,EAAE,MAAM,CAAC,WAAW,IAAI,KAAK,CAAC,QAAQ;gBAC9C,IAAI,EAAE;oBACJ,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,SAAS;oBAC/B,gBAAgB,EAAE,KAAK,CAAC,IAAI,CAAC,gBAAgB;oBAC7C,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,UAAU;oBACjC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ;oBAC7B,IAAI,EAAE,gBAAgB;oBACtB,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,OAAO,EAAE,MAAM,CAAC,OAAO;iBACxB;aACF,CAAC;QACJ,CAAC;QAED,KAAK,kBAAkB,CAAC,CAAC,CAAC;YACxB,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,YAAY;gBAAE,OAAO,KAAK,CAAC;YACnD,OAAO;gBACL,GAAG,KAAK;gBACR,IAAI,EAAE,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE;aACjD,CAAC;QACJ,CAAC;QAED;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC;AAED,kBAAkB;AAElB,MAAM,UAAU,oBAAoB,CAClC,SAA0B,EAC1B,UAA4B,EAC5B,UAA2B,EAC3B,UAAkB;IAElB,MAAM,KAAK,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;IAE9C,SAAS,WAAW,CAAC,IAAY,EAAE,WAAmB,EAAE,IAAc,EAAE,MAAc;QACpF,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QACxB,OAAO,CACL,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC;YAClC,WAAW,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC;YACzC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YACjD,MAAM,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CACrC,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAiB,EAAE,CAAC;IAE/B,IAAI,UAAU,KAAK,QAAQ,EAAE,CAAC;QAC5B,eAAe;QACf,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;YAC3B,IAAI,WAAW,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;gBACzD,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC1C,CAAC;QACH,CAAC;IACH,CAAC;SAAM,IAAI,UAAU,KAAK,KAAK,EAAE,CAAC;QAChC,yBAAyB;QACzB,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;YAC1B,MAAM,aAAa,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;YAC3C,IAAI,WAAW,CAAC,CAAC,CAAC,IAAI,EAAE,aAAa,EAAE,WAAW,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,IAAI,EAAE,CAAC,EAAE,CAAC;gBAC/F,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;YACzC,CAAC;QACH,CAAC;QACD,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;YAC3B,IAAI,WAAW,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;gBACzD,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC1C,CAAC;QACH,CAAC;IACH,CAAC;SAAM,CAAC;QACN,mCAAmC;QACnC,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;YAC1B,MAAM,aAAa,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;YAC3C,IACE,CAAC,CAAC,IAAI,KAAK,UAAU;gBACrB,WAAW,CAAC,CAAC,CAAC,IAAI,EAAE,aAAa,EAAE,WAAW,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,IAAI,EAAE,CAAC,EAC1F,CAAC;gBACD,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;YACzC,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AACtE,CAAC;AAED,eAAe;AAEf,MAAM,UAAU,cAAc,CAAC,iBAAyB,EAAE,iBAAkC;IAC1F,MAAM,YAAY,GAAgB;QAChC,OAAO,EAAE,qBAAqB;QAC9B,MAAM,EAAE,SAAS;QACjB,cAAc,EAAE,EAAE;KACnB,CAAC;IAEF,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,UAAU,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;IAElE,MAAM,YAAY,GAAG,WAAW,CAC9B,CAAC,QAAkB,EAAE,QAAkB,EAAE,EAAE;QACzC,QAAQ,CAAC;YACP,iBAAiB,EAAE,iBAAiB,IAAI,SAAS;YACjD,iBAAiB,EAAE,iBAAiB,KAAK,KAAK,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,SAAS;YAC9E,QAAQ;YACR,QAAQ;YACR,IAAI,EAAE,cAAc;SACrB,CAAC,CAAC;IACL,CAAC,EACD,CAAC,iBAAiB,EAAE,iBAAiB,CAAC,CACvC,CAAC;IAEF,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,YAAY,CAAU,CAAC;AAClD,CAAC;AAED,SAAS,WAAW,CAAC,WAAmB,EAAE,YAAoB,EAAE,cAAsB;IACpF,IAAI,cAAc,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IAElC,IAAI,WAAW,GAAG,YAAY,EAAE,CAAC;QAC/B,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,IAAI,WAAW,IAAI,YAAY,GAAG,cAAc,EAAE,CAAC;QACjD,OAAO,WAAW,GAAG,cAAc,GAAG,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC"}

package/build/hooks/useCommand.d.ts

@@ -0,0 +1,23 @@
+import type { DependencyList } from 'react';
+export type CommandState<T> = {
+    data: T;
+    status: 'done';
+} | {
+    message: string;
+    status: 'error';
+} | {
+    message: string;
+    status: 'loading';
+};
+/**
+ * Generic hook that manages the loading → done | error state machine for CLI commands.
+ *
+ * Accepts an async `execute` function that receives a `progress` callback for updating
+ * loading messages. The execute function's return value becomes `state.data` when done.
+ * Thrown errors are caught and surfaced as `state.status === 'error'`.
+ *
+ * Intermediate command outcomes (not-found, already-installed, deprecated, etc.) should
+ * be modeled as variants of `T`, not as additional hook states.
+ */
+export declare function useCommand<T>(execute: (progress: (message: string) => void) => Promise<T>, deps: DependencyList, initialMessage?: string): CommandState<T>;
+//# sourceMappingURL=useCommand.d.ts.map

package/build/hooks/useCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCommand.d.ts","sourceRoot":"","sources":["../../src/hooks/useCommand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAI5C,MAAM,MAAM,YAAY,CAAC,CAAC,IACtB;IAAE,IAAI,EAAE,CAAC,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC3B;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GACpC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,SAAS,CAAA;CAAE,CAAC;AAE3C;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAC1B,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,EAC5D,IAAI,EAAE,cAAc,EACpB,cAAc,SAAoB,GACjC,YAAY,CAAC,CAAC,CAAC,CAoCjB"}

package/build/hooks/useCommand.js

@@ -0,0 +1,43 @@
+import { useEffect, useState } from 'react';
+/**
+ * Generic hook that manages the loading → done | error state machine for CLI commands.
+ *
+ * Accepts an async `execute` function that receives a `progress` callback for updating
+ * loading messages. The execute function's return value becomes `state.data` when done.
+ * Thrown errors are caught and surfaced as `state.status === 'error'`.
+ *
+ * Intermediate command outcomes (not-found, already-installed, deprecated, etc.) should
+ * be modeled as variants of `T`, not as additional hook states.
+ */
+export function useCommand(execute, deps, initialMessage = 'Initializing...') {
+    const [state, setState] = useState({ message: initialMessage, status: 'loading' });
+    useEffect(() => {
+        let cancelled = false;
+        setState({ message: initialMessage, status: 'loading' });
+        const progress = (message) => {
+            if (!cancelled) {
+                setState({ message, status: 'loading' });
+            }
+        };
+        execute(progress)
+            .then((data) => {
+            if (!cancelled) {
+                setState({ data, status: 'done' });
+            }
+        })
+            .catch((err) => {
+            if (!cancelled) {
+                setState({
+                    message: err instanceof Error ? err.message : String(err),
+                    status: 'error',
+                });
+            }
+        });
+        return () => {
+            cancelled = true;
+        };
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, deps);
+    return state;
+}
+//# sourceMappingURL=useCommand.js.map

package/build/hooks/useCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCommand.js","sourceRoot":"","sources":["../../src/hooks/useCommand.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAO5C;;;;;;;;;GASG;AACH,MAAM,UAAU,UAAU,CACxB,OAA4D,EAC5D,IAAoB,EACpB,cAAc,GAAG,iBAAiB;IAElC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAkB,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;IAEpG,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,SAAS,GAAG,KAAK,CAAC;QAEtB,QAAQ,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;QAEzD,MAAM,QAAQ,GAAG,CAAC,OAAe,EAAE,EAAE;YACnC,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,QAAQ,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC,CAAC;QAEF,OAAO,CAAC,QAAQ,CAAC;aACd,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;YACb,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;YACrC,CAAC;QACH,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;YACtB,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,QAAQ,CAAC;oBACP,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;oBACzD,MAAM,EAAE,OAAO;iBAChB,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;QAEL,OAAO,GAAG,EAAE;YACV,SAAS,GAAG,IAAI,CAAC;QACnB,CAAC,CAAC;QACF,uDAAuD;IACzD,CAAC,EAAE,IAAI,CAAC,CAAC;IAET,OAAO,KAAK,CAAC;AACf,CAAC"}

package/build/lib/adapter.d.ts

@@ -0,0 +1,40 @@
+import type { AssetType } from './schemas/manifest.js';
+import { type Adapter, type PlacementConfig } from './schemas/adapter.js';
+export declare class AdapterError extends Error {
+    constructor(message: string);
+}
+/**
+ * Clear the adapter cache (useful for testing).
+ */
+export declare function clearAdapterCache(): void;
+/**
+ * Get the placement config for an asset type from an adapter.
+ * Returns undefined if the adapter has no placement for that type.
+ */
+export declare function getPlacement(adapter: Adapter, assetType: AssetType): PlacementConfig | undefined;
+/**
+ * Get all asset types that an adapter supports placements for.
+ */
+export declare function getSupportedAssetTypes(adapter: Adapter): AssetType[];
+/**
+ * Load a tool adapter by tool name.
+ * Looks for `tool-adapters/{tool}.json` bundled with the repo.
+ */
+export declare function loadAdapter(tool: string): Promise<Adapter>;
+/**
+ * Load all adapter JSON files from the tool-adapters directory.
+ * Reads all `.json` files (excluding files starting with `_`),
+ * parses each with AdapterSchema, and returns all valid adapters.
+ * Leverages the adapter cache to avoid redundant file reads.
+ */
+export declare function loadAllAdapters(): Promise<Adapter[]>;
+/**
+ * Resolve a placement path template by replacing {name} with the asset name.
+ * The basePath is the project root directory.
+ */
+export declare function resolvePlacementPath(placement: PlacementConfig, assetName: string, basePath: string): string;
+/**
+ * Check if an adapter supports a given asset type.
+ */
+export declare function supportsAssetType(adapter: Adapter, assetType: AssetType): boolean;
+//# sourceMappingURL=adapter.d.ts.map

package/build/lib/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/lib/adapter.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGvD,OAAO,EAAE,KAAK,OAAO,EAAiB,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAOzF,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM;CAI5B;AAKD;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,GAAG,eAAe,GAAG,SAAS,CAEhG;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,EAAE,CAEpE;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAoBhE;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,CAoC1D;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG5G;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO,CAEjF"}

package/build/lib/adapter.js

@@ -0,0 +1,112 @@
+import { existsSync } from 'node:fs';
+import { readdir, readFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { parseAndValidate } from './parse-json.js';
+import { AdapterSchema } from './schemas/adapter.js';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+/** Resolve tool-adapters directory relative to the package root (works both in dev and when installed via npm). */
+const ADAPTERS_DIR = join(__dirname, '..', '..', 'tool-adapters');
+export class AdapterError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'AdapterError';
+    }
+}
+/** Cache loaded adapters by tool name. */
+const adapterCache = new Map();
+/**
+ * Clear the adapter cache (useful for testing).
+ */
+export function clearAdapterCache() {
+    adapterCache.clear();
+}
+/**
+ * Get the placement config for an asset type from an adapter.
+ * Returns undefined if the adapter has no placement for that type.
+ */
+export function getPlacement(adapter, assetType) {
+    return adapter.placements[assetType];
+}
+/**
+ * Get all asset types that an adapter supports placements for.
+ */
+export function getSupportedAssetTypes(adapter) {
+    return Object.keys(adapter.placements);
+}
+/**
+ * Load a tool adapter by tool name.
+ * Looks for `tool-adapters/{tool}.json` bundled with the repo.
+ */
+export async function loadAdapter(tool) {
+    const cached = adapterCache.get(tool);
+    if (cached) {
+        return cached;
+    }
+    const filePath = join(ADAPTERS_DIR, `${tool}.json`);
+    if (!existsSync(filePath)) {
+        throw new AdapterError(`No adapter found for tool "${tool}". Expected file at: ${filePath}`);
+    }
+    const raw = await readFile(filePath, 'utf-8');
+    try {
+        const adapter = parseAndValidate(raw, AdapterSchema, `Invalid adapter file for "${tool}"`);
+        adapterCache.set(tool, adapter);
+        return adapter;
+    }
+    catch (err) {
+        throw new AdapterError(err.message);
+    }
+}
+/**
+ * Load all adapter JSON files from the tool-adapters directory.
+ * Reads all `.json` files (excluding files starting with `_`),
+ * parses each with AdapterSchema, and returns all valid adapters.
+ * Leverages the adapter cache to avoid redundant file reads.
+ */
+export async function loadAllAdapters() {
+    if (!existsSync(ADAPTERS_DIR)) {
+        return [];
+    }
+    const entries = await readdir(ADAPTERS_DIR);
+    const adapters = [];
+    for (const entry of entries) {
+        if (entry.startsWith('_') || !entry.endsWith('.json')) {
+            continue;
+        }
+        // Derive the tool name from the filename (e.g., "claude-code.json" -> "claude-code")
+        const tool = entry.replace(/\.json$/, '');
+        // Use cache if already loaded
+        const cached = adapterCache.get(tool);
+        if (cached) {
+            adapters.push(cached);
+            continue;
+        }
+        const filePath = join(ADAPTERS_DIR, entry);
+        try {
+            const raw = await readFile(filePath, 'utf-8');
+            const adapter = parseAndValidate(raw, AdapterSchema, `Invalid adapter file for "${tool}"`);
+            adapterCache.set(tool, adapter);
+            adapters.push(adapter);
+        }
+        catch {
+            // Skip adapters that fail to parse — callers can use loadAdapter() for specific error handling
+            continue;
+        }
+    }
+    return adapters;
+}
+/**
+ * Resolve a placement path template by replacing {name} with the asset name.
+ * The basePath is the project root directory.
+ */
+export function resolvePlacementPath(placement, assetName, basePath) {
+    const resolvedPath = placement.path.replace(/\{name\}/g, assetName);
+    return join(basePath, resolvedPath);
+}
+/**
+ * Check if an adapter supports a given asset type.
+ */
+export function supportsAssetType(adapter, assetType) {
+    return assetType in adapter.placements;
+}
+//# sourceMappingURL=adapter.js.map

package/build/lib/adapter.js.map

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

package/build/lib/auth.d.ts

@@ -0,0 +1,31 @@
+export declare class AuthError extends Error {
+    constructor(message: string);
+}
+/**
+ * Clear the cached GitHub token. Useful for testing.
+ */
+export declare function clearTokenCache(): void;
+/**
+ * Get a GitHub token for API access.
+ *
+ * Resolution order:
+ * 1. Config file githubToken (from ~/.atkrc.json)
+ * 2. GITHUB_TOKEN environment variable
+ * 3. `gh auth token` subprocess call
+ *
+ * The resolved token is cached for the lifetime of the process.
+ */
+export declare function getGitHubToken(): Promise<string>;
+/**
+ * Check if the gh CLI is installed and available.
+ */
+export declare function isGhCliAvailable(): Promise<boolean>;
+/**
+ * Validate that a GitHub token has access to the registry repo.
+ * Makes a lightweight API call to check access.
+ */
+export declare function validateToken(token: string): Promise<{
+    username?: string;
+    valid: boolean;
+}>;
+//# sourceMappingURL=auth.d.ts.map

package/build/lib/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/lib/auth.ts"],"names":[],"mappings":"AAMA,qBAAa,SAAU,SAAQ,KAAK;gBACtB,OAAO,EAAE,MAAM;CAI5B;AAKD;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAED;;;;;;;;;GASG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,CAsBtD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC,CAMnD;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC,CAoBjG"}