feat: Implement Space Management Suite for Storacha Console Toolkit

[alikhere]

Feature: Space Management Suite

Implements - A comprehensive, headless-first Space Management Suite for the Storacha UI toolkit.

What's New

This PR adds 6 new headless components that provide complete space management functionality:

Components Added

1. SpacePicker - Select and filter spaces (public/private)
2. SpaceCreator - Create new spaces with access control
3. UploadsList - Browse uploads with pagination
4. BlobsList - Browse blobs with pagination
5. ShareTool - Share spaces via email or DID
6. FileViewer - View file/blob details and metadata

Key Features

• ✅ Headless Architecture - Logic separated from UI for maximum flexibility
• ✅ Compound Component Pattern - Composable sub-components for customization
• ✅ Custom Hooks - Reusable logic via hooks (e.g., useSpacePicker)
• ✅ 100% Test Coverage - 54 comprehensive test cases (all passing)
• ✅ Example Implementations - 5 styled example components

Architecture

Headless-First Design

All components follow the headless component pattern using ariakit-react-utils:

• Unstyled, logic-only components
• Style with any CSS framework
• Compose with sub-components
• Access state via custom hooks

Example Usage

import { SpacePicker, useSpacePicker } from '@storacha/ui-react'

function MySpacePicker() {
  return (
    <SpacePicker onSpaceSelected={(space) => console.log(space)}>
      <SpacePicker.Input placeholder="Search spaces..." />
      <SpacePicker.List />
      <SpacePicker.Empty>No spaces found</SpacePicker.Empty>
    </SpacePicker>
  )
}

Examples Included

1. SpacePicker - Search and select spaces
2. SpaceCreator - Create space with validation
3. UploadsList - Paginated uploads table
4. ShareTool - Share via email/DID
5. SpaceManagement - Complete management UI

Closes storacha/console-toolkit#6
Part of storacha/console-toolkit#2

[alikhere]

Hey @Dhruv-Varshney-developer @travis @Nkovaturient, Could you please take a quick look at the PR and share your feedback, Thanks!

[Nkovaturient]

Great work @alikhere
the space component suite is in a modular setup.

[alikhere]

Closing this as the PR moved to storacha/console-toolkit#11