@miethe/ui 0.2.0

package/dist/content-viewer/ContentPane.js

@@ -0,0 +1,247 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState, useMemo, lazy, Suspense } from 'react';
+import { FileText, AlertCircle, AlertTriangle, Edit, ChevronRight, Save, X, ExternalLink, } from 'lucide-react';
+import { cn } from '../primitives/utils';
+import { Button } from '../components/ui/button';
+import { ScrollArea } from '../primitives/ScrollArea';
+import { Skeleton } from '../components/ui/skeleton';
+import { Alert, AlertDescription, AlertTitle } from '../components/ui/alert';
+import { FrontmatterDisplay } from '../display/FrontmatterDisplay';
+import { parseFrontmatter, detectFrontmatter, stripFrontmatter } from '../utils/frontmatter';
+/**
+ * SplitPreview is lazy-loaded so that the CodeMirror editor bundle is only fetched
+ * when a user enters edit mode on a markdown file.  Consumers who render ContentPane
+ * in read-only mode (or for non-markdown files) will never download the editor chunk.
+ */
+const SplitPreview = lazy(() => import('../editor/SplitPreview').then((m) => ({ default: m.SplitPreview })));
+// ============================================================================
+// Helper Functions
+// ============================================================================
+/**
+ * Format bytes to human-readable string (e.g., "1.2 MB")
+ */
+function formatBytes(bytes) {
+    if (bytes === 0)
+        return '0 B';
+    const k = 1024;
+    const sizes = ['B', 'KB', 'MB', 'GB'];
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    const size = bytes / Math.pow(k, i);
+    // Use 1 decimal place for KB and above, no decimals for bytes
+    return i === 0 ? `${bytes} B` : `${size.toFixed(1)} ${sizes[i]}`;
+}
+/**
+ * Check if a file is editable based on its extension
+ */
+function isEditableFile(path) {
+    const editableExtensions = [
+        '.md',
+        '.txt',
+        '.json',
+        '.ts',
+        '.tsx',
+        '.js',
+        '.jsx',
+        '.py',
+        '.yml',
+        '.yaml',
+        '.toml',
+    ];
+    return editableExtensions.some((ext) => path.toLowerCase().endsWith(ext));
+}
+/**
+ * Check if a file should use markdown editor (for .md files)
+ */
+function isMarkdownFile(path) {
+    return path.toLowerCase().endsWith('.md');
+}
+/**
+ * Split path into breadcrumb segments
+ */
+function pathToBreadcrumbs(path) {
+    return path.split('/').filter(Boolean);
+}
+// ============================================================================
+// Loading Skeletons
+// ============================================================================
+/**
+ * Shown inside the Suspense boundary while the SplitPreview (CodeMirror) chunk
+ * is being downloaded.  Mirrors the two-column split layout so the UI does not
+ * shift once the editor mounts.
+ */
+function EditorLoadingSkeleton() {
+    return (_jsxs("div", { className: "flex h-full min-w-0 flex-col gap-4 overflow-hidden lg:flex-row", children: [_jsx("div", { className: "min-h-[300px] min-w-0 flex-1 lg:min-h-0", children: _jsx("div", { className: "h-full space-y-2 rounded-md border p-4", children: [...Array(12)].map((_, i) => (_jsx(Skeleton, { className: "h-4", style: { width: `${50 + Math.random() * 50}%` } }, i))) }) }), _jsx("div", { className: "min-h-[300px] min-w-0 flex-1 overflow-hidden lg:min-h-0", children: _jsx("div", { className: "h-full space-y-2 rounded-md border bg-card p-6", children: [...Array(12)].map((_, i) => (_jsx(Skeleton, { className: "h-4", style: { width: `${40 + Math.random() * 60}%` } }, i))) }) })] }));
+}
+function ContentPaneSkeleton() {
+    return (_jsxs("div", { className: "flex h-full flex-col", children: [_jsx("div", { className: "border-b p-4", children: _jsx(Skeleton, { className: "h-5 w-48" }) }), _jsx("div", { className: "flex-1 space-y-2 p-4", children: [...Array(20)].map((_, i) => (_jsx(Skeleton, { className: "h-4 w-full", style: { width: `${60 + Math.random() * 40}%` } }, i))) })] }));
+}
+// ============================================================================
+// Empty State
+// ============================================================================
+function EmptyState() {
+    return (_jsxs("div", { className: "flex h-full flex-col items-center justify-center py-12 text-center", children: [_jsx(FileText, { className: "mb-4 h-12 w-12 text-muted-foreground opacity-50" }), _jsx("h3", { className: "mb-1 text-sm font-medium text-muted-foreground", children: "No file selected" }), _jsx("p", { className: "max-w-sm text-xs text-muted-foreground", children: "Select a file from the tree on the left to view its contents." })] }));
+}
+function ErrorState({ error }) {
+    return (_jsx("div", { className: "flex h-full flex-col items-center justify-center p-4", children: _jsxs(Alert, { variant: "destructive", className: "max-w-md", children: [_jsx(AlertCircle, { className: "h-4 w-4" }), _jsx(AlertDescription, { className: "text-sm", children: error })] }) }));
+}
+function TruncationBanner({ originalSize, fullFileUrl }) {
+    const sizeText = originalSize ? formatBytes(originalSize) : 'large file';
+    return (_jsxs(Alert, { className: "mb-4 border-amber-500/50 bg-amber-50 dark:bg-amber-950/30", children: [_jsx(AlertTriangle, { className: "h-4 w-4 text-amber-600 dark:text-amber-500" }), _jsx(AlertTitle, { className: "text-amber-800 dark:text-amber-300", children: "Large file truncated" }), _jsxs(AlertDescription, { className: "text-amber-700 dark:text-amber-400", children: [_jsxs("span", { children: ["This file (", sizeText, ") has been truncated. Showing first 10,000 lines."] }), fullFileUrl && (_jsxs("a", { href: fullFileUrl, target: "_blank", rel: "noopener noreferrer", className: "ml-2 inline-flex items-center gap-1 font-medium text-amber-800 underline hover:text-amber-900 dark:text-amber-300 dark:hover:text-amber-200", children: ["View full file on GitHub", _jsx(ExternalLink, { className: "h-3 w-3", "aria-hidden": "true" })] }))] })] }));
+}
+function Breadcrumb({ path, id }) {
+    const segments = useMemo(() => pathToBreadcrumbs(path), [path]);
+    return (_jsx("nav", { id: id, "aria-label": "File path", className: "flex items-center gap-1 text-sm text-muted-foreground", children: segments.map((segment, index) => (_jsxs("div", { className: "flex items-center gap-1", children: [index > 0 && _jsx(ChevronRight, { className: "h-3 w-3", "aria-hidden": "true" }), _jsx("span", { className: cn(index === segments.length - 1 && 'font-medium text-foreground'), "aria-current": index === segments.length - 1 ? 'page' : undefined, children: segment })] }, index))) }));
+}
+function LineNumbers({ lineCount }) {
+    return (_jsx("div", { className: "select-none pr-4 text-right font-mono text-xs text-muted-foreground", children: [...Array(lineCount)].map((_, i) => (_jsx("div", { className: "leading-6", children: i + 1 }, i))) }));
+}
+function ContentDisplay({ content, showLineNumbers = false }) {
+    const lines = useMemo(() => content.split('\n'), [content]);
+    return (_jsxs("div", { className: "flex", children: [showLineNumbers && _jsx(LineNumbers, { lineCount: lines.length }), _jsx("pre", { className: "flex-1 whitespace-pre-wrap break-words font-mono text-xs leading-6", children: content })] }));
+}
+// ============================================================================
+// Main Component
+// ============================================================================
+/**
+ * ContentPane - File content viewer and editor component
+ *
+ * Displays the contents of a selected file with features like breadcrumb navigation,
+ * optional line numbers, and edit functionality for supported file types.
+ *
+ * ## Bundle cost / optional editor loading
+ *
+ * The CodeMirror editor (via SplitPreview and MarkdownEditor) is **lazy-loaded**.
+ * The editor chunk is only fetched from the network when the component actually
+ * needs to render it — that is, when the file is a Markdown file (`*.md`) and the
+ * component is mounted.  While the chunk loads a skeleton placeholder is shown
+ * via a React `Suspense` boundary.
+ *
+ * - **Read-only mode** (`readOnly={true}`): The SplitPreview/MarkdownEditor module
+ *   is still lazy-imported for markdown files because the preview panel is always
+ *   rendered.  However, callers that pass `readOnly` avoid the full edit bundle
+ *   cost for non-markdown file types entirely — only the markdown renderer
+ *   (react-markdown, which is much lighter) loads in that case.
+ *
+ * - **Edit mode** (`readOnly={false}`, default): CodeMirror loads on first render
+ *   of a markdown file.  Subsequent renders use the cached module.
+ *
+ * - **Non-markdown files** (`.ts`, `.json`, `.py`, …): SplitPreview is never
+ *   rendered; CodeMirror is never loaded regardless of `readOnly`.
+ *
+ * ## Props controlling edit mode
+ *
+ * | Prop           | Purpose                                                              |
+ * |----------------|----------------------------------------------------------------------|
+ * | `readOnly`     | When `true`, hides all edit/save UI and disables edit mode entirely  |
+ * | `isEditing`    | Lifted state — `true` when the user has clicked "Edit"               |
+ * | `onEditStart`  | Called when user clicks the "Edit" button                            |
+ * | `onEditChange` | Called on every keystroke in the editor with the updated content     |
+ * | `onSave`       | Called when the user confirms the save; receives final content       |
+ * | `onCancel`     | Called when the user dismisses the editor without saving             |
+ *
+ * @example
+ * ```tsx
+ * // Editable mode (default) — CodeMirror loads when user opens a .md file
+ * <ContentPane
+ *   path="src/index.ts"
+ *   content={fileContent}
+ *   isLoading={isLoading}
+ *   error={error}
+ *   onEditStart={() => handleEdit()}
+ *   onSave={(content) => handleSave(content)}
+ * />
+ *
+ * // Read-only mode — no edit controls rendered; CodeMirror NOT loaded for
+ * // non-markdown files; markdown files render preview only (no editor panel)
+ * <ContentPane
+ *   path="README.md"
+ *   content={fileContent}
+ *   readOnly={true}
+ * />
+ * ```
+ */
+export function ContentPane({ path, content, isLoading = false, error = null, readOnly = false, truncationInfo, isEditing = false, editedContent = '', onEditStart, onEditChange, onSave, onCancel, ariaLabel, showFrontmatter: _showFrontmatter = false, }) {
+    // Generate unique ID for breadcrumb to use in aria-labelledby
+    const breadcrumbId = path
+        ? `content-pane-breadcrumb-${path.replace(/[^a-zA-Z0-9]/g, '-')}`
+        : undefined;
+    const [isSaving, setIsSaving] = useState(false);
+    // Editing is disabled in read-only mode
+    const canEdit = !readOnly && path && (onEditStart || onSave) && isEditableFile(path);
+    const isMarkdown = path && isMarkdownFile(path);
+    // Check if content is truncated
+    const isTruncated = truncationInfo?.truncated === true;
+    // Parse frontmatter from content (memoized to avoid reparsing on every render)
+    const parsedContent = useMemo(() => {
+        if (!content || typeof content !== 'string') {
+            return { frontmatter: null, content: content || '' };
+        }
+        // Only parse if content appears to have frontmatter
+        if (!detectFrontmatter(content)) {
+            return { frontmatter: null, content };
+        }
+        return parseFrontmatter(content);
+    }, [content]);
+    // Content to display: always strip frontmatter when FrontmatterDisplay will be shown
+    const displayContent = useMemo(() => {
+        if (!content || typeof content !== 'string') {
+            return content || '';
+        }
+        // Always strip frontmatter when FrontmatterDisplay will be shown (when frontmatter exists)
+        // This prevents duplication between FrontmatterDisplay and raw content
+        if (detectFrontmatter(content)) {
+            return stripFrontmatter(content);
+        }
+        return content;
+    }, [content]);
+    // Handle edit button click
+    const handleEditClick = () => {
+        onEditChange?.(content || '');
+        onEditStart?.();
+    };
+    // Handle save button click
+    const handleSaveClick = async () => {
+        if (!onSave)
+            return;
+        setIsSaving(true);
+        try {
+            await onSave(editedContent);
+            onCancel?.();
+        }
+        catch (error) {
+            console.error('Failed to save:', error);
+            // Error handling can be expanded here
+        }
+        finally {
+            setIsSaving(false);
+        }
+    };
+    // Handle cancel button click
+    const handleCancelClick = () => {
+        onCancel?.();
+    };
+    // Loading state
+    if (isLoading) {
+        return _jsx(ContentPaneSkeleton, {});
+    }
+    // Error state
+    if (error) {
+        return _jsx(ErrorState, { error: error });
+    }
+    // Empty state - no file selected
+    if (!path) {
+        return _jsx(EmptyState, {});
+    }
+    // Empty content - file is empty or couldn't be loaded
+    if (content === null || content === '') {
+        return (_jsxs("div", { className: "flex h-full flex-col", role: "region", "aria-label": ariaLabel || `File content: ${path}`, "aria-labelledby": breadcrumbId, "data-testid": "content-pane", children: [_jsxs("div", { className: "flex items-center justify-between border-b bg-muted/20 p-4", children: [_jsx(Breadcrumb, { path: path, id: breadcrumbId }), canEdit && !isEditing && (_jsxs(Button, { variant: "ghost", size: "sm", onClick: handleEditClick, "aria-label": `Edit ${path}`, children: [_jsx(Edit, { className: "mr-2 h-4 w-4", "aria-hidden": "true" }), "Edit"] })), !readOnly && isEditing && (_jsxs("div", { className: "flex gap-2", children: [_jsxs(Button, { variant: "ghost", size: "sm", onClick: handleCancelClick, disabled: isSaving, children: [_jsx(X, { className: "mr-2 h-4 w-4", "aria-hidden": "true" }), "Cancel"] }), _jsxs(Button, { variant: "default", size: "sm", onClick: handleSaveClick, disabled: isSaving, children: [_jsx(Save, { className: "mr-2 h-4 w-4", "aria-hidden": "true" }), isSaving ? 'Saving...' : 'Save'] })] }))] }), _jsx("div", { className: "flex flex-1 items-center justify-center text-center", children: _jsxs("div", { children: [_jsx(FileText, { className: "mx-auto mb-2 h-8 w-8 text-muted-foreground opacity-50", "aria-hidden": "true" }), _jsx("p", { className: "text-sm text-muted-foreground", children: "This file is empty" })] }) })] }));
+    }
+    // Markdown file - always use split preview (shows rendered markdown)
+    if (isMarkdown) {
+        return (_jsxs("div", { className: "flex h-full w-full flex-col overflow-hidden", role: "region", "aria-label": ariaLabel || `Markdown file: ${path}`, "aria-labelledby": breadcrumbId, "data-testid": "content-pane", children: [_jsxs("div", { className: "flex flex-shrink-0 items-center justify-between border-b bg-muted/20 p-4", children: [_jsx(Breadcrumb, { path: path, id: breadcrumbId }), !readOnly && isEditing ? (_jsxs("div", { className: "flex gap-2", children: [_jsxs(Button, { variant: "ghost", size: "sm", onClick: handleCancelClick, disabled: isSaving, children: [_jsx(X, { className: "mr-2 h-4 w-4", "aria-hidden": "true" }), "Cancel"] }), _jsxs(Button, { variant: "default", size: "sm", onClick: handleSaveClick, disabled: isSaving, children: [_jsx(Save, { className: "mr-2 h-4 w-4", "aria-hidden": "true" }), isSaving ? 'Saving...' : 'Save'] })] })) : (canEdit && (_jsxs(Button, { variant: "ghost", size: "sm", onClick: handleEditClick, "aria-label": `Edit ${path}`, children: [_jsx(Edit, { className: "mr-2 h-4 w-4", "aria-hidden": "true" }), "Edit"] })))] }), _jsxs("div", { className: "min-h-0 min-w-0 flex-1 overflow-auto p-4", children: [isTruncated && (_jsx(TruncationBanner, { originalSize: truncationInfo?.originalSize, fullFileUrl: truncationInfo?.fullFileUrl })), parsedContent.frontmatter && (_jsx(FrontmatterDisplay, { frontmatter: parsedContent.frontmatter, defaultCollapsed: true, className: "mb-4" })), _jsx("div", { className: "min-w-0", children: _jsx(Suspense, { fallback: _jsx(EditorLoadingSkeleton, {}), children: _jsx(SplitPreview, { content: isEditing ? editedContent : displayContent, onChange: (newContent) => onEditChange?.(newContent), isEditing: isEditing }) }) })] })] }));
+    }
+    // Content display (read-only mode for non-markdown files)
+    return (_jsxs("div", { className: "flex h-full w-full flex-col overflow-hidden", role: "region", "aria-label": ariaLabel || `File content: ${path}`, "aria-labelledby": breadcrumbId, "data-testid": "content-pane", children: [_jsxs("div", { className: "flex flex-shrink-0 items-center justify-between border-b bg-muted/20 p-4", children: [_jsx(Breadcrumb, { path: path, id: breadcrumbId }), canEdit && !isEditing && (_jsxs(Button, { variant: "ghost", size: "sm", onClick: handleEditClick, "aria-label": `Edit ${path}`, children: [_jsx(Edit, { className: "mr-2 h-4 w-4", "aria-hidden": "true" }), "Edit"] }))] }), _jsx(ScrollArea, { className: "min-h-0 min-w-0 flex-1", children: _jsxs("div", { className: "p-4", children: [isTruncated && (_jsx(TruncationBanner, { originalSize: truncationInfo?.originalSize, fullFileUrl: truncationInfo?.fullFileUrl })), parsedContent.frontmatter && (_jsx(FrontmatterDisplay, { frontmatter: parsedContent.frontmatter, defaultCollapsed: true, className: "mb-4" })), _jsx("div", { className: "max-w-full", children: _jsx(ContentDisplay, { content: displayContent, showLineNumbers: false }) })] }) })] }));
+}
+//# sourceMappingURL=ContentPane.js.map

package/dist/content-viewer/ContentPane.js.map

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

package/dist/content-viewer/ContentViewerProvider.d.ts

@@ -0,0 +1,83 @@
+/**
+ * ContentViewerProvider — React context provider for the content-viewer adapter.
+ *
+ * Decouples content-viewer components from any specific data-fetching
+ * implementation. Consumers supply a ContentViewerAdapter that components
+ * access via useContentViewerAdapter().
+ *
+ * @example
+ * ```tsx
+ * import {
+ *   ContentViewerProvider,
+ *   type ContentViewerAdapter,
+ * } from '@skillmeat/content-viewer';
+ *
+ * // Build an adapter that wraps your application's hooks:
+ * const adapter: ContentViewerAdapter = {
+ *   useFileTree: (artifactId, options) => {
+ *     const { data, isLoading, error } = useCatalogFileTree(
+ *       mySourceId,
+ *       artifactId,
+ *       { enabled: options?.enabled }
+ *     );
+ *     return { data, isLoading, error: error ?? null };
+ *   },
+ *   useFileContent: (artifactId, filePath, options) => {
+ *     const { data, isLoading, error } = useCatalogFileContent(
+ *       mySourceId,
+ *       artifactId,
+ *       filePath,
+ *       { enabled: options?.enabled }
+ *     );
+ *     return { data, isLoading, error: error ?? null };
+ *   },
+ * };
+ *
+ * function App() {
+ *   return (
+ *     <ContentViewerProvider adapter={adapter}>
+ *       <YourContentViewerTree />
+ *     </ContentViewerProvider>
+ *   );
+ * }
+ * ```
+ */
+import React from 'react';
+import type { ContentViewerAdapter } from './adapters';
+export interface ContentViewerProviderProps {
+    /**
+     * An object implementing ContentViewerAdapter. Components rendered
+     * inside this provider call useContentViewerAdapter() to access it.
+     */
+    adapter: ContentViewerAdapter;
+    children: React.ReactNode;
+}
+/**
+ * Wrap your component tree with ContentViewerProvider to supply a
+ * data-fetching adapter to all content-viewer components.
+ *
+ * You must mount exactly one provider per logical content-viewer subtree.
+ * Nesting is allowed — inner providers shadow outer ones for their subtrees.
+ */
+export declare function ContentViewerProvider({ adapter, children, }: ContentViewerProviderProps): React.JSX.Element;
+/**
+ * Returns the ContentViewerAdapter injected by the nearest
+ * ContentViewerProvider ancestor.
+ *
+ * Throws a descriptive error when called outside a ContentViewerProvider
+ * so misconfiguration is caught at runtime rather than producing silent
+ * undefined behaviour.
+ *
+ * @throws {Error} When called outside a ContentViewerProvider.
+ *
+ * @example
+ * ```tsx
+ * function MyFileTree({ artifactId }: { artifactId: string }) {
+ *   const { useFileTree } = useContentViewerAdapter();
+ *   const { data, isLoading, error } = useFileTree(artifactId);
+ *   // ...
+ * }
+ * ```
+ */
+export declare function useContentViewerAdapter(): ContentViewerAdapter;
+//# sourceMappingURL=ContentViewerProvider.d.ts.map

package/dist/content-viewer/ContentViewerProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContentViewerProvider.d.ts","sourceRoot":"","sources":["../../src/content-viewer/ContentViewerProvider.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAEH,OAAO,KAAoC,MAAM,OAAO,CAAC;AACzD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAoBvD,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,OAAO,EAAE,oBAAoB,CAAC;IAC9B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,OAAO,EACP,QAAQ,GACT,EAAE,0BAA0B,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAMhD;AAMD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,uBAAuB,IAAI,oBAAoB,CAa9D"}

package/dist/content-viewer/ContentViewerProvider.js

@@ -0,0 +1,92 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * ContentViewerProvider — React context provider for the content-viewer adapter.
+ *
+ * Decouples content-viewer components from any specific data-fetching
+ * implementation. Consumers supply a ContentViewerAdapter that components
+ * access via useContentViewerAdapter().
+ *
+ * @example
+ * ```tsx
+ * import {
+ *   ContentViewerProvider,
+ *   type ContentViewerAdapter,
+ * } from '@skillmeat/content-viewer';
+ *
+ * // Build an adapter that wraps your application's hooks:
+ * const adapter: ContentViewerAdapter = {
+ *   useFileTree: (artifactId, options) => {
+ *     const { data, isLoading, error } = useCatalogFileTree(
+ *       mySourceId,
+ *       artifactId,
+ *       { enabled: options?.enabled }
+ *     );
+ *     return { data, isLoading, error: error ?? null };
+ *   },
+ *   useFileContent: (artifactId, filePath, options) => {
+ *     const { data, isLoading, error } = useCatalogFileContent(
+ *       mySourceId,
+ *       artifactId,
+ *       filePath,
+ *       { enabled: options?.enabled }
+ *     );
+ *     return { data, isLoading, error: error ?? null };
+ *   },
+ * };
+ *
+ * function App() {
+ *   return (
+ *     <ContentViewerProvider adapter={adapter}>
+ *       <YourContentViewerTree />
+ *     </ContentViewerProvider>
+ *   );
+ * }
+ * ```
+ */
+import { createContext, useContext } from 'react';
+const ContentViewerContext = createContext(undefined);
+ContentViewerContext.displayName = 'ContentViewerContext';
+/**
+ * Wrap your component tree with ContentViewerProvider to supply a
+ * data-fetching adapter to all content-viewer components.
+ *
+ * You must mount exactly one provider per logical content-viewer subtree.
+ * Nesting is allowed — inner providers shadow outer ones for their subtrees.
+ */
+export function ContentViewerProvider({ adapter, children, }) {
+    return (_jsx(ContentViewerContext.Provider, { value: adapter, children: children }));
+}
+// ============================================================
+// Consumer Hook
+// ============================================================
+/**
+ * Returns the ContentViewerAdapter injected by the nearest
+ * ContentViewerProvider ancestor.
+ *
+ * Throws a descriptive error when called outside a ContentViewerProvider
+ * so misconfiguration is caught at runtime rather than producing silent
+ * undefined behaviour.
+ *
+ * @throws {Error} When called outside a ContentViewerProvider.
+ *
+ * @example
+ * ```tsx
+ * function MyFileTree({ artifactId }: { artifactId: string }) {
+ *   const { useFileTree } = useContentViewerAdapter();
+ *   const { data, isLoading, error } = useFileTree(artifactId);
+ *   // ...
+ * }
+ * ```
+ */
+export function useContentViewerAdapter() {
+    const ctx = useContext(ContentViewerContext);
+    if (ctx === undefined) {
+        throw new Error('[content-viewer] useContentViewerAdapter() was called outside of a ' +
+            '<ContentViewerProvider>. ' +
+            'Wrap the component tree that uses content-viewer components with ' +
+            '<ContentViewerProvider adapter={...}> and supply a ContentViewerAdapter.');
+    }
+    return ctx;
+}
+//# sourceMappingURL=ContentViewerProvider.js.map

package/dist/content-viewer/ContentViewerProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContentViewerProvider.js","sourceRoot":"","sources":["../../src/content-viewer/ContentViewerProvider.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAEH,OAAc,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAazD,MAAM,oBAAoB,GAAG,aAAa,CAA4B,SAAS,CAAC,CAAC;AAEjF,oBAAoB,CAAC,WAAW,GAAG,sBAAsB,CAAC;AAe1D;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,EACpC,OAAO,EACP,QAAQ,GACmB;IAC3B,OAAO,CACL,KAAC,oBAAoB,CAAC,QAAQ,IAAC,KAAK,EAAE,OAAO,YAC1C,QAAQ,GACqB,CACjC,CAAC;AACJ,CAAC;AAED,+DAA+D;AAC/D,gBAAgB;AAChB,+DAA+D;AAE/D;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,uBAAuB;IACrC,MAAM,GAAG,GAAG,UAAU,CAAC,oBAAoB,CAAC,CAAC;IAE7C,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CACb,qEAAqE;YACnE,2BAA2B;YAC3B,mEAAmE;YACnE,0EAA0E,CAC7E,CAAC;IACJ,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/content-viewer/FileTree.d.ts

@@ -0,0 +1,71 @@
+import type { FileNode } from '../types';
+export interface FileTreeProps {
+    entityId: string;
+    files: FileNode[];
+    selectedPath: string | null;
+    onSelect: (path: string) => void;
+    onAddFile?: () => void;
+    onDeleteFile?: (path: string) => void;
+    isLoading?: boolean;
+    /**
+     * When true, hides create/delete buttons while keeping
+     * file selection and expand/collapse functionality.
+     * @default false
+     */
+    readOnly?: boolean;
+    /**
+     * Accessible label for the file tree.
+     * @default "File browser"
+     */
+    ariaLabel?: string;
+}
+/**
+ * FileTree - Recursive file browser component
+ *
+ * Displays a hierarchical tree of files and directories with expand/collapse functionality.
+ * Supports keyboard navigation, file selection, and optional delete actions.
+ *
+ * Features:
+ * - Recursive rendering of nested directories
+ * - Expandable/collapsible folders with chevron icons
+ * - File type icons (markdown, code, JSON, etc.)
+ * - Selected file highlighting
+ * - Full keyboard navigation (Arrow keys, Enter, Space, Home, End)
+ * - ARIA tree pattern for screen reader accessibility
+ * - Roving tabindex for efficient keyboard focus management
+ * - Optional context actions (delete)
+ * - Loading skeleton state
+ * - Read-only mode (hides create/delete buttons)
+ *
+ * Keyboard Controls:
+ * - ArrowUp/ArrowDown: Move focus between visible items
+ * - ArrowRight: Expand folder (if collapsed) or move to first child
+ * - ArrowLeft: Collapse folder (if expanded) or move to parent
+ * - Enter/Space: Select file or toggle folder
+ * - Home: Move to first item
+ * - End: Move to last visible item
+ *
+ * @example
+ * ```tsx
+ * // Editable mode (default)
+ * <FileTree
+ *   entityId="skill-123"
+ *   files={fileStructure}
+ *   selectedPath={selectedPath}
+ *   onSelect={(path) => setSelectedPath(path)}
+ *   onDeleteFile={(path) => handleDelete(path)}
+ * />
+ *
+ * // Read-only mode (no create/delete buttons)
+ * <FileTree
+ *   entityId="skill-123"
+ *   files={fileStructure}
+ *   selectedPath={selectedPath}
+ *   onSelect={(path) => setSelectedPath(path)}
+ *   readOnly
+ *   ariaLabel="Artifact file browser"
+ * />
+ * ```
+ */
+export declare function FileTree({ entityId: _entityId, files, selectedPath, onSelect, onAddFile, onDeleteFile, isLoading, readOnly, ariaLabel, }: FileTreeProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=FileTree.d.ts.map

package/dist/content-viewer/FileTree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileTree.d.ts","sourceRoot":"","sources":["../../src/content-viewer/FileTree.tsx"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAMzC,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAkRD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,wBAAgB,QAAQ,CAAC,EACvB,QAAQ,EAAE,SAAS,EACnB,KAAK,EACL,YAAY,EACZ,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,SAAiB,EACjB,QAAgB,EAChB,SAA0B,GAC3B,EAAE,aAAa,2CAmLf"}