kennel 0.1.9 → 0.2.1

package/node_modules/@raggle-ai/local/dist/native-bridge.d.ts

@@ -0,0 +1,383 @@
+import type { ImportedRepositorySubpath } from "./core/project-subpaths";
+import type { RelatedRepository, RepositoryLinkType } from "./core/project-schema";
+export type RepositoryRemoteMetadata = {
+    provider: string;
+    host: string;
+    owner?: string;
+    repository?: string;
+};
+export type ParsedSearch = {
+    normalizedQuery: string;
+    compactQuery: string;
+    queryWords: string[];
+    owner?: string | null;
+    ownerIsAtSyntax: boolean;
+    ownerCompleted: boolean;
+};
+export type SearchDoc = {
+    id: string;
+    title: string;
+    innerFolder?: string;
+    repositoryLabel?: string;
+    relativePath?: string;
+    worktree: string;
+    description?: string;
+    keywords?: string[];
+    latestSessionTitle?: string;
+    searchPriority?: number;
+    sourceIndex: number;
+    remoteUrl?: string;
+    actualRemoteUrl?: string;
+    relatedRepositories?: RelatedRepository[];
+    relatedOrganisations?: string[];
+    relatedIds?: string[];
+    workspaceId?: string;
+    sourceType?: "native" | "mounted-repository" | "registered-repository";
+    repositoryId?: string;
+    commitId?: string;
+    visibility?: string;
+};
+export type SearchHit = {
+    id: string;
+    name: string;
+    path: string;
+    matchedField: string;
+    matchTier: string;
+    score: number;
+};
+export type GroupedSearchHit = SearchHit;
+export type GroupedSearchGroup = {
+    primary: GroupedSearchHit;
+    related: GroupedSearchHit[];
+};
+export type GroupedSearchResult = {
+    groups: GroupedSearchGroup[];
+    total: number;
+    scanned: number;
+};
+export type SearchIndex = {
+    readonly size: number;
+    search(query: string, limit?: number): {
+        hits: SearchHit[];
+        total: number;
+        scanned: number;
+    };
+    searchGrouped(query: string, limit?: number): GroupedSearchResult;
+    relatedProjectGroups(): SearchGroup[];
+};
+export type SearchGroup = {
+    primaryId: string;
+    relatedIds: string[];
+};
+export type CatalogProject = {
+    id: string;
+    worktree: string;
+    name: string | null;
+    description: string | null;
+    worktreeName: string | null;
+    keywords: string[] | null;
+    tags: string[] | null;
+    latestSessionTitle: string | null;
+    icon: string | null;
+    iconColor: string | null;
+    startupCommand: string | null;
+    sandboxCount: number;
+    updatedAt: number | null;
+    hasIcon: boolean;
+    isSessionOnly: boolean;
+    isFavorite: boolean;
+    relatedIds: string[];
+    remoteUrl: string;
+    browserUrl: string | null;
+    isCloned: boolean;
+    repositoryRoot: string;
+    parentProjectName: string | null;
+    relativePath: string | null;
+    listed: boolean;
+    isSubpathRoot: boolean;
+    allSubpath: boolean;
+    collapseSubpaths: boolean;
+    allTopLevelFolders: boolean;
+    folderDepth: number | null;
+    subpathAllSubpath: boolean;
+    removePathFromName: boolean;
+    hasCustomName: boolean;
+    remoteMismatch: {
+        worktree: string;
+        actualRemoteUrl: string;
+    } | null;
+    searchPriority: number | null;
+    relatedRepositories: RelatedRepository[] | null;
+    relatedOrganisations: string[] | null;
+};
+type Native = {
+    normalizeRepositoryUrl(remoteUrl: string): string;
+    mergeRaggleProjectConfigNative(repositoryJson: string, configJson: string): string;
+    projectBelongsToRepositoryNative(itemUrl: string, repoUrl: string): boolean;
+    raggleProjectConfigFromActionConfigsNative(configsJson: string): string;
+    ignoredSubpathsFromActionConfigsNative(configsJson: string): string[];
+    mergeExistingSubpathSettingsNative(existingJson: string, nextJson: string): NativeSubpath[];
+    upsertSubpathSettingsNative(subpathsJson: string, path: string, allSubpath: boolean | undefined | null, removePathFromName: boolean | undefined | null): NativeSubpath[];
+    isGithubForkRemoteMismatchNative(configuredUrl: string, actualUrl: string): boolean;
+    isRepositoryRootWithSubpathsNative(worktree: string, repositoryRoot: string, relativePath: string | undefined | null, siblingsJson: string): boolean;
+    canonicalRepositoryIdentity(input: string): {
+        key: string;
+        repository: string;
+    } | null;
+    remoteToBrowserUrl(input: string): string | null;
+    repositoryName(input: string): string | null;
+    repositoryLocationKey(input: string): string | null;
+    normalizeTags(input: string): string[];
+    normalizeFolders(input: string): string[];
+    normalizeFolderDepth(input: string): number | null;
+    normalizeIgnoredSubpaths(input: string): string[];
+    normalizeGlobalIgnoredSubpaths(input: string): string[];
+    mergeIgnoredSubpaths(inputs: string[][]): string[];
+    normalizeSearchPriority(input: string): number | null;
+    normalizeSubpathPath(input: string): string;
+    normalizeSubpaths(input: string): NativeSubpath[];
+    readRaggleProjectConfig(directory: string): RaggleConfigResult;
+    decodeRaggleProjectConfig(rawJson: string, baseDirectory: string): RaggleConfigResult;
+    projectKeywordsFromNative(json: string): string[];
+    projectTitleFromWorktree(name: string | null, worktree: string): string;
+    projectSubtitleNative(json: string): string;
+    projectAccessoryPathNative(worktree: string): string;
+    projectIdentityKeyNative(id: string | undefined | null, worktree: string, relativePath: string | undefined | null, remoteUrl: string | undefined | null): string;
+    repositoryDisplayNameNative(remoteUrl: string | null, relatedIds: string[]): string | null;
+    projectSubpathDisplayNameNative(relativePath: string | null): string | null;
+    projectEffectiveBrowserUrlNative(remoteUrl: string, browserUrl: string | null, mismatchUrl: string | null): string | null;
+    repoPrefixedProjectNameNative(parentName: string | null, repoRoot: string, folder: string, removePath: boolean): string;
+    subpathProjectNameNative(folder: string): string;
+    repositoryRemoteMetadataNative(remoteUrl: string | null): RepositoryRemoteMetadata | null;
+    isProjectFavoriteNative(favorites: string[], id: string, worktree: string, relatedIds: string[], remoteUrl: string | undefined | null): boolean;
+    projectFavoriteKeysNative(id: string, worktree: string, relatedIds: string[], remoteUrl: string | undefined | null): string[];
+    sortProjectCollectionNative(itemsJson: string): string;
+    renameProjectCollectionNative(itemsJson: string, worktree: string, name: string | undefined | null): string;
+    updateProjectCollectionNative(itemsJson: string, worktree: string, name: string | undefined | null, iconColor: string | undefined | null, startupCommand: string | undefined | null): string;
+    dedupeProjectCollectionNative(itemsJson: string): string;
+    splitExcludedProjectCollectionNative(itemsJson: string, excludedJson: string): string;
+    setProjectFavoriteNative(itemsJson: string, worktree: string, favoritesJson: string): string;
+    prioritizeProjectHydrationNative(itemsJson: string): string;
+    normalizeFavoriteKeysNative(inputJson: string): string;
+    applyProjectFavoritesNative(itemsJson: string, favoritesJson: string): string;
+    setFavoriteStateNative(favoritesJson: string, id: string, worktree: string, relatedIdsJson: string, remoteUrl: string | undefined | null, favorite: boolean): string;
+    preserveProjectOrderNative(currentJson: string, updatedJson: string): string;
+    recordRecentSelectionNative(recentJson: string, itemKey: string): string;
+    resetRecentSelectionNative(recentJson: string, itemKey: string): string;
+    sortNonFavouritesByRecentSelectionNative(itemsJson: string, favouritesJson: string, recentJson: string, keyField: string): string;
+    projectActivityTimestampNative(itemJson: string): number | null;
+    sortProjectListNative(itemsJson: string, sortByActivity: boolean): string;
+    ProjectSearchIndex: new (documents: SearchDoc[]) => SearchIndex;
+    parseProjectSearch(query: string): ParsedSearch;
+    hasProjectConfig(directory: string): boolean;
+    loadLocalProjectsNative(remoteProjectsJson: string, optionsJson: string, cloneIndexJson: string, scannedReposJson: string): Promise<CatalogProject[]>;
+    mergeProjectCatalogsNative(catalogsJson: string): CatalogProject[];
+    discoverProjectsUnderFolderNative(optionsJson: string): Promise<CatalogProject[]>;
+    buildProjectCatalogNative(optionsJson: string): Promise<CatalogProject[]>;
+};
+export type NativeSubpath = {
+    path: string;
+    listed: boolean | null;
+    allSubpath: boolean | null;
+    removePathFromName: boolean | null;
+    searchPriority: number | null;
+    relatedRepositories: RelatedRepository[] | null;
+    relatedOrganisations: string[] | null;
+};
+type RaggleLinkedRepositoryConfig = {
+    project: string;
+    repository: string;
+    type: RepositoryLinkType;
+};
+type RaggleLinkedOrganisationConfig = {
+    project: string;
+    organisation: string;
+};
+type RaggleConfigResult = {
+    listed: boolean | null;
+    tags: string[];
+    folders: string[];
+    allSubpaths: boolean | null;
+    collapseSubpaths: boolean | null;
+    allTopLevelFolders: boolean | null;
+    folderDepth: number | null;
+    removePathFromName: boolean | null;
+    ignoredSubpaths: string[];
+    excludeFolders: string[];
+    includeAgents: boolean | null;
+    includeSkills: boolean | null;
+    linkedRepositories: RaggleLinkedRepositoryConfig[];
+    linkedOrganisations: RaggleLinkedOrganisationConfig[];
+    searchPriority: number | null;
+};
+export declare function getNative(): Native;
+export declare const normalizeRepositoryUrl: (url: string) => string;
+export declare const repositoryName: (url: string) => string | undefined;
+export declare const repositoryLocationKey: (url: string) => string | undefined;
+export declare const remoteToBrowserUrl: (url: string) => string | undefined;
+export declare function normalizeTags(input: unknown): string[];
+export declare function normalizeFolders(input: unknown): string[];
+export declare function normalizeFolderDepth(input: unknown): number | undefined;
+export declare function normalizeIgnoredSubpaths(input: unknown): string[];
+export declare function normalizeGlobalIgnoredSubpaths(input: unknown): string[];
+export declare function normalizeSearchPriority(input: unknown): number | undefined;
+export declare function mergeIgnoredSubpaths(inputs: string[][]): string[];
+export declare function mergeRaggleProjectConfig<T extends object = object>(repository: T, config: object): T;
+export declare function effectiveProjectBrowserUrl(remoteUrl: string, browserUrl?: string | null, mismatchUrl?: string | null): string | undefined;
+export declare function projectBelongsToRepository(itemUrl: string, repoUrl: string): boolean;
+export declare function raggleProjectConfigFromActionConfigs(configs: unknown[]): Record<string, unknown>;
+export declare function ignoredSubpathsFromActionConfigs(configs: unknown[]): string[];
+export declare function mergeExistingSubpathSettings(existing: ImportedRepositorySubpath[], next: ImportedRepositorySubpath[]): ImportedRepositorySubpath[];
+export declare function upsertSubpathSettings(subpaths: ImportedRepositorySubpath[], path: string, allSubpath: boolean | null, removePathFromName: boolean | null): ImportedRepositorySubpath[];
+export declare function isGithubForkRemoteMismatch(configuredUrl: string, actualUrl: string): boolean;
+export declare function isRepositoryRootWithSubpaths(item: {
+    worktree: string;
+    repositoryRoot?: string;
+    relativePath?: string | null;
+}, siblings: {
+    worktree: string;
+    repositoryRoot?: string;
+    relativePath?: string | null;
+}[]): boolean;
+export declare function normalizeSubpathPath(input: string): string;
+export declare function normalizeSubpaths(input: unknown): ImportedRepositorySubpath[];
+export declare function normalizeSubpathPaths(input: unknown): string[];
+export declare function projectTitle(name: string | null | undefined, worktree: string): string;
+export type ProjectKeywordInput = {
+    worktree: string;
+    remoteUrl?: string | null;
+    name?: string | null;
+    description?: string | null;
+    parentProjectName?: string | null;
+    relativePath?: string | null;
+    tags?: string[] | null;
+    latestSessionTitle?: string | null;
+};
+export declare function projectKeywords(item: ProjectKeywordInput): string[];
+export declare function projectSubtitle(item: {
+    latestSessionTitle?: string;
+    tags?: string[];
+    worktree: string;
+}): string;
+export declare function projectAccessoryPath(worktree: string): string;
+export declare function projectIdentityKey(item: {
+    id?: string;
+    worktree: string;
+    relativePath?: string | null;
+    remoteUrl?: string | null;
+}): string;
+export declare function repositoryDisplayName(remoteUrl?: string, relatedIds?: string[]): string | undefined;
+export declare function projectSubpathDisplayName(relativePath?: string): string | undefined;
+export declare function projectRepositoryAccessory(item: {
+    remoteUrl?: string;
+    relatedIds?: string[];
+    remoteMismatch?: {
+        actualRemoteUrl?: string;
+    };
+}): string | undefined;
+export declare function repositoryRemoteMetadata(remoteUrl?: string): RepositoryRemoteMetadata | undefined;
+export declare function isProjectFavorite(favorites: Set<string>, id: string, worktree: string, relatedIds: string[], remoteUrl?: string | null): boolean;
+export declare function projectFavoriteKeys(id: string, worktree: string, relatedIds: string[], remoteUrl?: string | null): string[];
+export declare function dedupeProjectCollection<T extends object = object>(items: T[]): T[];
+export declare function sortProjectCollection<T extends object = object>(items: T[]): T[];
+export declare function splitExcludedProjectCollection<T extends object = object>(items: T[], excludedWorktrees: string[]): {
+    items: T[];
+    excludedItems: T[];
+};
+export declare function setProjectFavorite<T extends object = object>(items: T[], worktree: string, favorites: Set<string>): T[];
+export declare function prioritizeProjectHydration<T extends object = object>(items: T[]): T[];
+export declare function renameProjectCollection<T extends object = object>(items: T[], worktree: string, name?: string | null): T[];
+export declare function updateProjectCollection<T extends object = object>(items: T[], worktree: string, name?: string | null, iconColor?: string | null, startupCommand?: string | null): T[];
+export type ProjectFavoriteItem = {
+    worktree: string;
+    relatedIds: string[];
+    id?: string;
+    remoteUrl?: string;
+};
+export type ProjectFavoriteState = {
+    favoriteProjects: string[];
+};
+export declare function normalizeFavoriteProjects(input: unknown): string[];
+export declare function applyProjectFavorites<T extends object>(projects: T[], favoriteProjects: string[]): T[];
+export declare function setFavoriteProject(state: ProjectFavoriteState, project: ProjectFavoriteItem, favorite: boolean): ProjectFavoriteState;
+export type ProjectListOrder = "name" | "recentActivity";
+export type ProjectActivityItem = {
+    worktree: string;
+    name?: string;
+    updatedAt?: number;
+    lastCommitAt?: number;
+    localEditAt?: number;
+    activityAt?: number;
+};
+export declare function projectActivityTimestamp(item: ProjectActivityItem): number | undefined;
+export declare function sortProjectList<T extends object>(items: readonly T[], orderBy?: ProjectListOrder): T[];
+export declare function preserveProjectOrder<T extends object>(currentItems: T[], updatedItems: T[]): T[];
+export declare function recordRecentSelection(recentSelections: string[], itemKey: string): string[];
+export declare function resetRecentSelection(recentSelections: string[], itemKey: string): string[];
+export declare function sortNonFavouritesByRecentSelection<T extends object>(items: T[], favourites: string[], recentSelections: string[], keyField: string): T[];
+export declare function loadLocalProjects(remoteProjectsJson: string, optionsJson: string, cloneIndexJson: string, scannedReposJson: string): Promise<CatalogProject[]>;
+export declare function mergeProjectCatalogs(catalogsJson: string): CatalogProject[];
+export declare function hasProjectConfig(folder: string): boolean;
+export declare function readRaggleProjectConfig(directory: string): RaggleConfigResult;
+export type { RaggleConfigResult };
+export type DiscoverUnderFolderOptions = {
+    folder: string;
+    force?: boolean;
+    projectConfigFiles?: string[];
+    subpathMarkerFiles?: string[];
+    ignoredSubpaths?: string[];
+    scanMaxRepos?: number;
+    scanTimeoutMs?: number;
+    iconCacheDir?: string;
+};
+export type CatalogCloneSource = {
+    cloneDirectory: string;
+    repositories?: {
+        remoteUrl: string;
+    }[];
+};
+export type BuildCatalogOptions = {
+    cloneSources?: CatalogCloneSource[];
+    projectRoots?: string[];
+    repositoryLocations?: Record<string, {
+        preferredWorktree: string;
+    }>;
+    localRepositoryLinks?: Record<string, string[]>;
+    force?: boolean;
+    projectConfigFiles?: string[];
+    ignoredSubpaths?: string[];
+    iconCacheDir?: string;
+    /** @deprecated Accepted but ignored. Use repository configuration for discovery. */
+    schemaScanRoots?: string[];
+};
+export declare function discoverProjectsUnderFolder(options: DiscoverUnderFolderOptions): Promise<CatalogProject[]>;
+export declare function buildProjectCatalog(options: BuildCatalogOptions): Promise<CatalogProject[]>;
+export declare function catalogToUserProject(p: CatalogProject): UserProjectSearchItem;
+export type UserProjectSearchItem = {
+    id?: string;
+    worktree: string;
+    repositoryRoot?: string;
+    name?: string;
+    description?: string;
+    tags?: string[];
+    latestSessionTitle?: string;
+    icon?: string;
+    relativePath?: string;
+    listed?: boolean;
+    searchPriority?: number;
+    remoteUrl?: string;
+    relatedIds?: string[];
+    remoteMismatch?: {
+        actualRemoteUrl?: string;
+    };
+    relatedRepositories?: RelatedRepository[];
+    relatedOrganisations?: string[];
+    isFavorite?: boolean;
+    workspaceId?: string;
+    sourceType?: "native" | "mounted-repository" | "registered-repository";
+    repositoryId?: string;
+    commitId?: string;
+    visibility?: string;
+    projectType?: "project" | "skill";
+};
+export { type Native as NativeModule };