BlockDex

Components

Registries

Free blocks

Method

BlockDex

Components

Registries

Free blocks

Method

Open API

BlockDex

Components

Registries

Free blocks

Method

Open API

Components/ilinxa/carousel-composer

Carousel Composer

ilinxa/carousel-composer
FreeBlock

Multi-item media post composer — drag in photos and videos, reorder them on a rail, and edit each through a shared editor panel.

Install it

npx shadcn@latest add https://ui.ilinxa.com/r/carousel-composer.json

Source

src/registry/components/media/carousel-composer/carousel-composer.tsxui.ilinxa.com/r/carousel-composer.json · first 6 KB
1"use client";
2
3import {
4 forwardRef,
5 useEffect,
6 useImperativeHandle,
7 useMemo,
8 useRef,
9 useState,
10} from "react";
11import {
12 DndContext,
13 KeyboardSensor,
14 PointerSensor,
15 closestCenter,
16 useSensor,
17 useSensors,
18 type Announcements,
19 type DragEndEvent,
20} from "@dnd-kit/core";
21import { arrayMove, sortableKeyboardCoordinates } from "@dnd-kit/sortable";
22import { AlertCircle, X } from "lucide-react";
23import { cn } from "@/lib/utils";
24import {
25 DEFAULT_CAROUSEL_LABELS,
26 type CarouselComposerHandle,
27 type CarouselComposerProps,
28} from "./types";
29import { useCarouselState } from "./hooks/use-carousel-state";
30import { filesToItems } from "./lib/file-intake";
31import { clampSources } from "./lib/clamp-sources";
32import { aspectToCss, resolveAspect } from "./lib/aspect";
33import { MediaDropzone } from "./parts/media-dropzone";
34import { PreviewRail } from "./parts/preview-rail";
35import { MainPreview } from "./parts/main-preview";
36import { EditPanel } from "./parts/edit-panel";
37
38/**
39 * carousel-composer — a multi-item media composer (Instagram-feed-post
40 * semantics): drag-drop / browse one-or-more mixed photo+video files into an
41 * ordered, reorderable rail with a main preview, and edit any item through a
42 * single shared `media-editor` instance (loaded serially, never N at once).
43 * Composes media-editor without modifying it.
44 */
45function CarouselComposerImpl(
46 props: CarouselComposerProps,
47 ref: React.Ref<CarouselComposerHandle>,
48) {
49 const {
50 value,
51 defaultValue,
52 onChange,
53 maxItems = 10,
54 maxFileSizeMb = 50,
55 accept,
56 sources,
57 aspect = "auto",
58 editorProps,
59 labels: labelOverrides,
60 className,
61 revokeOnUnmount,
62 onItemAdd,
63 onItemRemove,
64 onReorder,
65 onSelect,
66 onEditOpen,
67 onEditApply,
68 onEditCancel,
69 onValidationError,
70 onMaxItemsExceeded,
71 } = props;
72
73 const labels = useMemo(
74 () => ({ ...DEFAULT_CAROUSEL_LABELS, ...labelOverrides }),
75 [labelOverrides],
76 );
77 const acceptKinds = useMemo(
78 () => accept ?? ["image" as const, "video" as const],
79 [accept],
80 );
81 // v0.1: "library" is clamped out — intake is upload-only (drop / browse).
82 const uploadEnabled = useMemo(
83 () => clampSources(sources).includes("upload"),
84 [sources],
85 );
86
87 const [ingesting, setIngesting] = useState(false);
88 const [errors, setErrors] = useState<string[]>([]);
89 const [announce, setAnnounce] = useState("");
90
91// … truncated

What it pulls in

npm packages

  • @dnd-kit/core
  • @dnd-kit/sortable
  • @dnd-kit/utilities
  • lucide-react

Other registry items

  • @ilinxa/media-editor
  • button
  • scroll-area

Files it writes

  • src/registry/components/media/carousel-composer/carousel-composer.tsx
  • src/registry/components/media/carousel-composer/index.ts
  • src/registry/components/media/carousel-composer/types.ts
  • src/registry/components/media/carousel-composer/hooks/use-carousel-state.ts
  • src/registry/components/media/carousel-composer/hooks/use-controllable-state.ts
  • src/registry/components/media/carousel-composer/lib/aspect.ts
  • src/registry/components/media/carousel-composer/lib/clamp-sources.ts
  • src/registry/components/media/carousel-composer/lib/file-intake.ts
  • src/registry/components/media/carousel-composer/lib/validate-media-file.ts
  • src/registry/components/media/carousel-composer/parts/media-dropzone.tsx
  • src/registry/components/media/carousel-composer/parts/preview-rail.tsx
  • src/registry/components/media/carousel-composer/parts/rail-thumb.tsx
  • src/registry/components/media/carousel-composer/parts/main-preview.tsx
  • src/registry/components/media/carousel-composer/parts/edit-panel.tsx

Facts

Registry
ilinxa
Type
registry:block
Access
Free
Files written
14
Licence
MIT
In the index
at or before 2026-08-13
Last confirmed
today

Go to the source

ui.ilinxa.com ilinxa/pro-ui on GitHub Raw registry item This item as JSON

More from ilinxa

All 184 items
Same registry, same kind — the ones you would have found next
ComponentRegistryKindAccessInstallsCommand
Account Switcheraccount-switcherilinxaBlocksFree1 dep · 10 files
Account Switcher (deprecated alias)account-switcher-01ilinxaBlocksFreeno deps
Account Switcher — fixturesaccount-switcher-fixturesilinxaBlocksFreeno deps
App Sidebarapp-sidebarilinxaBlocksFree1 dep · 37 files
App Sidebar — fixturesapp-sidebar-fixturesilinxaBlocksFreeno deps
Rich Text Editor (deprecated alias)article-body-01ilinxaBlocksFreeno deps
Article Metaarticle-metailinxaBlocksFree1 dep · 4 files
Article Meta (deprecated alias)article-meta-01ilinxaBlocksFreeno deps
BlockDex

Built by

Kynth Studios

the studio behind StoreReady, ToolDrift and BreachProbe

Index

Components
Registries
Method
Open API

Guides

shadcn component libraries
Best shadcn registries
Free shadcn blocks

Reference

Corpus counts
Crawl health
hello@kynth.studio
Privacy
Terms

© 2026 BlockDex. A Kynth Studios product.

BlockDex

BlockDex

Built by

Kynth Studios

the studio behind StoreReady, ToolDrift and BreachProbe

Index

Components
Registries
Method
Open API

Guides

shadcn component libraries
Best shadcn registries
Free shadcn blocks

Reference

Corpus counts
Crawl health
hello@kynth.studio
Privacy
Terms

© 2026 BlockDex. A Kynth Studios product.

BlockDex

BlockDex

Built by

Kynth Studios

the studio behind StoreReady, ToolDrift and BreachProbe

Index

Components
Registries
Method
Open API

Guides

shadcn component libraries
Best shadcn registries
Free shadcn blocks

Reference

Corpus counts
Crawl health
hello@kynth.studio
Privacy
Terms

© 2026 BlockDex. A Kynth Studios product.

BlockDex