@industry-theme/alexandria-panels 0.1.0

package/dist/panels/LocalProjectsPanel/LocalProjectsPanel.stories.d.ts

@@ -0,0 +1,51 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import { LocalProjectsPanel } from './index';
+import { LocalProjectCard } from './LocalProjectCard';
+import { RepositoryAvatar } from './RepositoryAvatar';
+/**
+ * LocalProjectsPanel - Browse and manage local Alexandria repositories
+ *
+ * This panel displays a list of locally registered repositories with:
+ * - Search/filter functionality
+ * - Add new project capability
+ * - Open/focus project actions
+ * - Remove project from registry
+ */
+declare const meta: Meta<typeof LocalProjectsPanel>;
+export default meta;
+type Story = StoryObj<typeof LocalProjectsPanel>;
+/**
+ * Default state with mock repositories
+ */
+export declare const Default: Story;
+/**
+ * Empty state - no repositories registered
+ */
+export declare const Empty: Story;
+/**
+ * Loading state
+ */
+export declare const Loading: Story;
+/**
+ * Without add button (no selectDirectory action)
+ */
+export declare const ReadOnly: Story;
+/**
+ * LocalProjectCard component stories
+ */
+export declare const CardDefault: StoryObj<typeof LocalProjectCard>;
+export declare const CardSelected: StoryObj<typeof LocalProjectCard>;
+export declare const CardWindowOpen: StoryObj<typeof LocalProjectCard>;
+export declare const CardWindowOpening: StoryObj<typeof LocalProjectCard>;
+export declare const CardMinimalMode: StoryObj<typeof LocalProjectCard>;
+export declare const CardAddToWorkspaceMode: StoryObj<typeof LocalProjectCard>;
+export declare const CardLocalOnly: StoryObj<typeof LocalProjectCard>;
+export declare const CardCompact: StoryObj<typeof LocalProjectCard>;
+export declare const CardCompactList: StoryObj<typeof LocalProjectCard>;
+/**
+ * RepositoryAvatar component stories
+ */
+export declare const AvatarWithOwner: StoryObj<typeof RepositoryAvatar>;
+export declare const AvatarSizes: StoryObj<typeof RepositoryAvatar>;
+export declare const AvatarFallback: StoryObj<typeof RepositoryAvatar>;
+//# sourceMappingURL=LocalProjectsPanel.stories.d.ts.map

package/dist/panels/LocalProjectsPanel/LocalProjectsPanel.stories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalProjectsPanel.stories.d.ts","sourceRoot":"","sources":["../../../src/panels/LocalProjectsPanel/LocalProjectsPanel.stories.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAStD;;;;;;;;GAQG;AACH,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,OAAO,kBAAkB,CAiCzC,CAAC;AAEF,eAAe,IAAI,CAAC;AACpB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEjD;;GAEG;AACH,eAAO,MAAM,OAAO,EAAE,KAQrB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,KAAK,EAAE,KAsBnB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,OAAO,EAAE,KAsBrB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,QAAQ,EAAE,KAWtB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAC,OAAO,gBAAgB,CAazD,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,QAAQ,CAAC,OAAO,gBAAgB,CAc1D,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,OAAO,gBAAgB,CAc5D,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,OAAO,gBAAgB,CAc/D,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,OAAO,gBAAgB,CAa7D,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAAC,OAAO,gBAAgB,CAapE,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,QAAQ,CAAC,OAAO,gBAAgB,CAa3D,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAC,OAAO,gBAAgB,CAczD,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,OAAO,gBAAgB,CAgB7D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,OAAO,gBAAgB,CAU7D,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAC,OAAO,gBAAgB,CAWzD,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,OAAO,gBAAgB,CAe5D,CAAC"}

package/dist/panels/LocalProjectsPanel/RepositoryAvatar.d.ts

@@ -0,0 +1,12 @@
+import React from 'react';
+import type { RepositoryAvatarProps } from './types';
+/**
+ * RepositoryAvatar - Displays repository owner avatar
+ *
+ * Priority:
+ * 1. customAvatarUrl prop
+ * 2. GitHub avatar from owner username
+ * 3. Fallback icon or initial
+ */
+export declare const RepositoryAvatar: React.FC<RepositoryAvatarProps>;
+//# sourceMappingURL=RepositoryAvatar.d.ts.map

package/dist/panels/LocalProjectsPanel/RepositoryAvatar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RepositoryAvatar.d.ts","sourceRoot":"","sources":["../../../src/panels/LocalProjectsPanel/RepositoryAvatar.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAErD;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CAyD5D,CAAC"}

package/dist/panels/LocalProjectsPanel/index.d.ts

@@ -0,0 +1,34 @@
+import React from 'react';
+import './LocalProjectsPanel.css';
+import type { PanelComponentProps } from '../../types';
+/**
+ * LocalProjectsPanel - Browse and manage local Alexandria repositories
+ *
+ * Features:
+ * - List all registered local repositories
+ * - Search/filter by name, owner, or path
+ * - Add new projects via directory picker
+ * - Open projects in dev workspace
+ * - Remove projects from registry
+ *
+ * Data Slices:
+ * - alexandriaRepositories: List of AlexandriaEntry objects
+ *
+ * Events Emitted:
+ * - industry-theme.local-projects:repository-selected
+ * - industry-theme.local-projects:repository-opened
+ *
+ * Events Listened:
+ * - industry-theme.local-projects:filter
+ * - industry-theme.local-projects:select-repository
+ * - industry-theme.local-projects:open-repository
+ */
+export declare const LocalProjectsPanel: React.FC<PanelComponentProps>;
+/**
+ * LocalProjectsPanelPreview - Compact preview for panel tabs/thumbnails
+ */
+export declare const LocalProjectsPanelPreview: React.FC;
+export type { LocalProjectCardProps, RepositoryAvatarProps } from './types';
+export { LocalProjectCard } from './LocalProjectCard';
+export { RepositoryAvatar } from './RepositoryAvatar';
+//# sourceMappingURL=index.d.ts.map

package/dist/panels/LocalProjectsPanel/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/panels/LocalProjectsPanel/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAoD,MAAM,OAAO,CAAC;AAGzE,OAAO,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAoXvD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,kBAAkB,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CAM5D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB,EAAE,KAAK,CAAC,EA6C7C,CAAC;AAGF,YAAY,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/panels/LocalProjectsPanel/tools.d.ts

@@ -0,0 +1,31 @@
+/**
+ * UTCP Tools for LocalProjectsPanel
+ *
+ * These tools allow AI agents to interact with the Local Projects panel
+ * through the Universal Tool Communication Protocol.
+ */
+import type { PanelTool, PanelToolsMetadata } from '../../types';
+/**
+ * Filter projects tool
+ * Allows filtering the project list by search term
+ */
+export declare const filterProjectsTool: PanelTool;
+/**
+ * Select project tool
+ * Allows selecting a specific project in the list
+ */
+export declare const selectProjectTool: PanelTool;
+/**
+ * Open project tool
+ * Allows opening a project in the dev workspace
+ */
+export declare const openProjectTool: PanelTool;
+/**
+ * All tools for the LocalProjectsPanel
+ */
+export declare const localProjectsPanelTools: PanelTool[];
+/**
+ * Tools metadata for registration
+ */
+export declare const localProjectsPanelToolsMetadata: PanelToolsMetadata;
+//# sourceMappingURL=tools.d.ts.map

package/dist/panels/LocalProjectsPanel/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/panels/LocalProjectsPanel/tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAIjE;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAyBhC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAyB/B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,SAyB7B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,SAAS,EAI9C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,+BAA+B,EAAE,kBAK7C,CAAC"}

package/dist/panels/LocalProjectsPanel/types.d.ts

@@ -0,0 +1,134 @@
+/**
+ * LocalProjectsPanel Type Definitions
+ *
+ * Types for the Local Projects panel, extending core-library types
+ */
+import type { AlexandriaEntry } from '@principal-ai/alexandria-core-library/types';
+import type { PanelActions } from '../../types';
+/**
+ * Data slice for Alexandria repositories
+ * Provided by the host application through panel context
+ */
+export interface AlexandriaRepositoriesSlice {
+    /** List of registered local repositories */
+    repositories: AlexandriaEntry[];
+    /** Whether repositories are currently loading */
+    loading: boolean;
+    /** Error message if loading failed */
+    error?: string;
+}
+/**
+ * Window state for a repository
+ */
+export type RepositoryWindowState = 'closed' | 'opening' | 'ready';
+/**
+ * Extended actions for LocalProjectsPanel
+ * These are provided by the host application
+ */
+export interface LocalProjectsPanelActions extends PanelActions {
+    /**
+     * Open a directory picker dialog
+     * @returns Selected directory info or null if cancelled
+     */
+    selectDirectory?: () => Promise<{
+        path: string;
+        name: string;
+    } | null>;
+    /**
+     * Register a new repository in Alexandria
+     * @param name - Repository name
+     * @param path - Local path to the repository
+     */
+    registerRepository?: (name: string, path: string) => Promise<void>;
+    /**
+     * Remove a repository from Alexandria
+     * @param name - Repository name
+     * @param deleteLocal - Whether to delete local files
+     */
+    removeRepository?: (name: string, deleteLocal: boolean) => Promise<void>;
+    /**
+     * Open a repository in dev workspace
+     * @param entry - Alexandria entry to open
+     */
+    openRepository?: (entry: AlexandriaEntry) => Promise<void>;
+    /**
+     * Focus an already-open repository window
+     * @param entry - Alexandria entry to focus
+     */
+    focusRepository?: (entry: AlexandriaEntry) => Promise<void>;
+    /**
+     * Check if a repository window is open
+     * @param entry - Alexandria entry to check
+     * @returns Window state
+     */
+    getRepositoryWindowState?: (entry: AlexandriaEntry) => Promise<RepositoryWindowState>;
+}
+/**
+ * Action mode for LocalProjectCard
+ * Controls which action buttons are displayed
+ */
+export type CardActionMode = 'default' | 'add-to-workspace' | 'minimal';
+/**
+ * Props for LocalProjectCard component
+ */
+export interface LocalProjectCardProps {
+    /** Alexandria entry data */
+    entry: AlexandriaEntry;
+    /** Action mode controls which buttons are shown */
+    actionMode?: CardActionMode;
+    /** Whether this card is currently selected */
+    isSelected?: boolean;
+    /** Callback when card is clicked/selected */
+    onSelect?: (entry: AlexandriaEntry) => void;
+    /** Callback when open button is clicked */
+    onOpen?: (entry: AlexandriaEntry) => void;
+    /** Callback when remove button is clicked */
+    onRemove?: (entry: AlexandriaEntry) => void;
+    /** Callback for add-to-workspace action */
+    onAddToWorkspace?: (entry: AlexandriaEntry) => void;
+    /** Whether an operation is in progress */
+    isLoading?: boolean;
+    /** Current window state for this repository */
+    windowState?: RepositoryWindowState;
+    /** Compact mode - hides path/info, stacks buttons under name */
+    compact?: boolean;
+}
+/**
+ * Props for RepositoryAvatar component
+ */
+export interface RepositoryAvatarProps {
+    /** GitHub owner username for avatar URL */
+    owner?: string;
+    /** Custom avatar URL (takes precedence over owner) */
+    customAvatarUrl?: string | null;
+    /** Avatar size in pixels */
+    size?: number;
+    /** Fallback content when no avatar available */
+    fallbackIcon?: React.ReactNode;
+}
+/**
+ * Event payloads for LocalProjectsPanel
+ */
+export interface LocalProjectsPanelEventPayloads {
+    /** Filter projects event */
+    'filter': {
+        filter: string;
+    };
+    /** Select project event */
+    'select-repository': {
+        identifier: string;
+    };
+    /** Open project event */
+    'open-repository': {
+        identifier: string;
+    };
+    /** Repository selected notification */
+    'repository-selected': {
+        entry: AlexandriaEntry;
+    };
+    /** Repository opened notification */
+    'repository-opened': {
+        entry: AlexandriaEntry;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/panels/LocalProjectsPanel/types.d.ts.map

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

package/dist/panels.bundle.css

@@ -0,0 +1,86 @@
+/* Container query for responsive LocalProjectCard */
+.local-projects-panel {
+  container-type: inline-size;
+  container-name: local-projects;
+  height: 100%;
+}
+
+.local-project-card {
+  display: flex;
+  flex-direction: row;
+  align-items: center;
+  gap: 12px;
+}
+
+.local-project-card__content {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  flex: 1;
+  min-width: 0;
+}
+
+.local-project-card__info {
+  flex: 1;
+  min-width: 0;
+  display: flex;
+  flex-direction: column;
+  gap: 2px;
+}
+
+.local-project-card__path,
+.local-project-card__meta {
+  display: flex;
+}
+
+.local-project-card__actions {
+  display: flex;
+  gap: 4px;
+  flex-shrink: 0;
+  align-items: center;
+}
+
+.local-project-card__actions--stacked {
+  display: none;
+}
+
+/* Compact mode when container is 400px or less */
+@container local-projects (max-width: 400px) {
+  .local-projects-panel {
+    padding: 8px !important;
+    gap: 8px !important;
+  }
+
+  .local-projects-list {
+    gap: 12px !important;
+  }
+
+  .local-project-card {
+    flex-direction: column;
+    align-items: stretch;
+    gap: 6px;
+    padding: 0 !important;
+  }
+
+  .local-project-card__content {
+    gap: 8px;
+  }
+
+  .local-project-card__path,
+  .local-project-card__meta {
+    display: none;
+  }
+
+  .local-project-card__actions {
+    display: none;
+  }
+
+  .local-project-card__actions--stacked {
+    display: flex;
+    gap: 4px;
+  }
+
+  .local-project-card__actions--stacked button {
+    flex: 1;
+  }
+}