registry.json

{
	"$schema": "https://shadcn-svelte.com/schema/registry.json",
	"name": "codeworks-ui",
	"homepage": "https://ui.akcodeworks.com",
	"aliases": {
		"lib": "$lib",
		"ui": "$lib/components/ui",
		"components": "$lib/components",
		"utils": "$lib/utils",
		"hooks": "$lib/hooks"
	},
	"items": [
		{
			"name": "aura",
			"type": "registry:ui",
			"title": "Aura",
			"description": "Wraps content in an animated luminous aura with color, material, size, and speed variants.",
			"dependencies": [],
			"registryDependencies": ["utils"],
			"files": [
				{ "path": "src/lib/components/ui/aura/aura.svelte", "type": "registry:ui" },
				{ "path": "src/lib/components/ui/aura/index.ts", "type": "registry:ui" }
			],
			"meta": {
				"docs": {
					"usage": "Wrap content with Aura, choose a visual variant and size, then use class to match the wrapper radius to your content. Aura provides an internal rounded clipping layer while allowing the outer glow to remain visible. Pass color for a single CSS color or colors for a custom multi-color palette. Background colors and animation durations are customizable, and reduced-motion preferences are respected.",
					"moreExamples": [
						{
							"name": "variants",
							"title": "Visual variants",
							"description": "Choose from default, dual, rainbow, holo, glow, gold, and silver treatments."
						},
						{
							"name": "customization",
							"title": "Sizes and customization",
							"description": "Control aura thickness, CSS colors, backdrop color, and animation duration."
						}
					],
					"api": [
						{
							"name": "variant",
							"type": "default | dual | rainbow | holo | glow | gold | silver",
							"default": "default"
						},
						{ "name": "size", "type": "xs | sm | md | lg | xl", "default": "md" },
						{ "name": "color", "type": "CSS color", "default": "currentColor" },
						{ "name": "colors", "type": "CSS color[]", "default": "[]" },
						{ "name": "backgroundColor", "type": "CSS color", "default": "transparent" },
						{ "name": "duration", "type": "number (milliseconds)", "default": "6000" },
						{ "name": "class", "type": "string", "default": "—" },
						{ "name": "children", "type": "Snippet", "default": "required" }
					]
				}
			}
		},
		{
			"name": "chat",
			"type": "registry:ui",
			"title": "Chat",
			"description": "A composable chat interface with aligned messages, message content, and an accessible composer.",
			"dependencies": [],
			"registryDependencies": ["utils"],
			"files": [
				{ "path": "src/lib/components/ui/chat/chat.svelte", "type": "registry:ui" },
				{
					"path": "src/lib/components/ui/chat/chat-messages.svelte",
					"type": "registry:ui"
				},
				{
					"path": "src/lib/components/ui/chat/chat-message.svelte",
					"type": "registry:ui"
				},
				{
					"path": "src/lib/components/ui/chat/chat-content.svelte",
					"type": "registry:ui"
				},
				{
					"path": "src/lib/components/ui/chat/chat-composer.svelte",
					"type": "registry:ui"
				},
				{ "path": "src/lib/components/ui/chat/index.ts", "type": "registry:ui" }
			],
			"meta": {
				"docs": {
					"demo": "chat-basic",
					"usage": "Compose Root, Messages, Message, Content, and Composer. Message defaults to the right side; pass side=\"left\" for incoming messages. Bind Composer's value and handle messages with onSend.",
					"moreExamples": [
						{
							"name": "support",
							"title": "Avatars and message metadata",
							"description": "Combine avatars, presence, timestamps, delivery states, and an interactive composer."
						},
						{
							"name": "project",
							"title": "Custom message content",
							"description": "Use custom message content for sender names, attachments, dividers, and delivery details."
						}
					],
					"api": [
						{ "name": "Message.side", "type": "left | right", "default": "right" },
						{ "name": "Composer.value", "type": "string", "default": "''" },
						{
							"name": "Composer.onSend",
							"type": "(message: string) => void | Promise<void>",
							"default": "—"
						},
						{ "name": "Composer.clearOnSend", "type": "boolean", "default": "true" },
						{ "name": "Composer.submitOnEnter", "type": "boolean", "default": "true" },
						{ "name": "Composer.disabled", "type": "boolean", "default": "false" }
					]
				}
			}
		},
		{
			"name": "code",
			"type": "registry:ui",
			"title": "Code",
			"description": "Syntax-highlighted code display with Svelte support and one-click copying.",
			"dependencies": ["shiki@^4.4.3"],
			"registryDependencies": ["utils"],
			"files": [
				{ "path": "src/lib/components/ui/code/code.svelte", "type": "registry:ui" },
				{ "path": "src/lib/components/ui/code/highlighter.ts", "type": "registry:ui" },
				{ "path": "src/lib/components/ui/code/index.ts", "type": "registry:ui" }
			],
			"meta": {
				"docs": {
					"usage": "Pass the source text, its language, and an optional filename label. The highlighter is shared across every instance.",
					"moreExamples": [
						{
							"name": "languages",
							"title": "Languages",
							"description": "Highlight TypeScript, JSON, and shell commands with language-aware labels."
						},
						{
							"name": "presentation",
							"title": "Presentation controls",
							"description": "Hide the copy action, customize the label, and control the code block dimensions with Tailwind classes."
						}
					],
					"api": [
						{ "name": "code", "type": "string", "default": "required" },
						{
							"name": "language",
							"type": "svelte | typescript | javascript | json | shellscript | text",
							"default": "svelte"
						},
						{ "name": "label", "type": "string", "default": "language" },
						{ "name": "showCopy", "type": "boolean", "default": "true" }
					]
				}
			}
		},
		{
			"name": "context-menu",
			"type": "registry:ui",
			"title": "Context Menu",
			"description": "A composable context menu opened by right-clicking on desktop or long-pressing on mobile, with nested submenus, selectable items, shortcuts, and icon-friendly actions.",
			"dependencies": ["bits-ui@^2.19.0"],
			"registryDependencies": ["utils"],
			"files": [
				{
					"path": "src/lib/components/ui/context-menu/context-menu.svelte",
					"type": "registry:ui"
				},
				{
					"path": "src/lib/components/ui/context-menu/context-menu-trigger.svelte",
					"type": "registry:ui"
				},
				{
					"path": "src/lib/components/ui/context-menu/context-menu-content.svelte",
					"type": "registry:ui"
				},
				{
					"path": "src/lib/components/ui/context-menu/context-menu-item.svelte",
					"type": "registry:ui"
				},
				{
					"path": "src/lib/components/ui/context-menu/context-menu-checkbox-item.svelte",
					"type": "registry:ui"
				},
				{
					"path": "src/lib/components/ui/context-menu/context-menu-radio-group.svelte",
					"type": "registry:ui"
				},
				{
					"path": "src/lib/components/ui/context-menu/context-menu-radio-item.svelte",
					"type": "registry:ui"
				},
				{
					"path": "src/lib/components/ui/context-menu/context-menu-group.svelte",
					"type": "registry:ui"
				},
				{
					"path": "src/lib/components/ui/context-menu/context-menu-group-heading.svelte",
					"type": "registry:ui"
				},
				{
					"path": "src/lib/components/ui/context-menu/context-menu-label.svelte",
					"type": "registry:ui"
				},
				{
					"path": "src/lib/components/ui/context-menu/context-menu-shortcut.svelte",
					"type": "registry:ui"
				},
				{
					"path": "src/lib/components/ui/context-menu/context-menu-separator.svelte",
					"type": "registry:ui"
				},
				{
					"path": "src/lib/components/ui/context-menu/context-menu-sub.svelte",
					"type": "registry:ui"
				},
				{
					"path": "src/lib/components/ui/context-menu/context-menu-sub-trigger.svelte",
					"type": "registry:ui"
				},
				{
					"path": "src/lib/components/ui/context-menu/context-menu-sub-content.svelte",
					"type": "registry:ui"
				},
				{
					"path": "src/lib/components/ui/context-menu/context-menu-portal.svelte",
					"type": "registry:ui"
				},
				{
					"path": "src/lib/components/ui/context-menu/index.ts",
					"type": "registry:ui"
				}
			],
			"meta": {
				"docs": {
					"usage": "Compose Root, Trigger, Content, and Item using the ContextMenu namespace. Tell users to right-click the trigger on desktop or long-press it on mobile. Add Sub, SubTrigger, and SubContent for any depth of nested menu. CheckboxItem and RadioGroup provide persistent selection state through Svelte bindings. For action icons, import components from the icon library configured by shadcn and render them directly inside an Item or SubTrigger; the menu automatically sizes and aligns SVG icons.",
					"moreExamples": [
						{
							"name": "nested",
							"title": "Icons and nested submenus",
							"description": "Compose multiple submenu levels and render tree-shakeable icon components directly inside actions."
						},
						{
							"name": "selections",
							"title": "Checkboxes and radio groups",
							"description": "Build stateful view controls with checked items, exclusive choices, groups, and disabled actions."
						}
					],
					"api": [
						{ "name": "Root.open", "type": "boolean (bindable)", "default": "false" },
						{ "name": "Trigger", "type": "Bits UI trigger props", "default": "—" },
						{ "name": "Content", "type": "Bits UI content props", "default": "—" },
						{ "name": "Item.variant", "type": "default | destructive", "default": "default" },
						{ "name": "Item.inset", "type": "boolean", "default": "false" },
						{ "name": "CheckboxItem.checked", "type": "boolean (bindable)", "default": "false" },
						{ "name": "RadioGroup.value", "type": "string (bindable)", "default": "''" },
						{ "name": "Sub.open", "type": "boolean (bindable)", "default": "false" },
						{ "name": "class", "type": "string", "default": "—" }
					]
				}
			}
		},
		{
			"name": "error",
			"type": "registry:ui",
			"title": "Error",
			"description": "A polished SvelteKit error-page presentation with status-aware messaging, recovery actions, and custom content.",
			"dependencies": ["@lucide/svelte@^1.37.0"],
			"registryDependencies": ["button", "utils"],
			"files": [
				{ "path": "src/lib/components/ui/error/error.svelte", "type": "registry:ui" },
				{ "path": "src/lib/components/ui/error/index.ts", "type": "registry:ui" }
			],
			"meta": {
				"docs": {
					"usage": "In +error.svelte, import page from $app/state and pass status={page.status} and error={page.error}. Error derives a friendly title from common HTTP statuses and displays the error message SvelteKit exposes. Use title or message to override either value, configure the home and retry actions, and pass children for support references, technical details, or custom controls below the error.",
					"moreExamples": [
						{
							"name": "custom-content",
							"title": "Additional error details",
							"description": "Render support references, disclosure panels, or any custom content beneath the error."
						},
						{
							"name": "minimal",
							"title": "Message only",
							"description": "Hide the default recovery actions for errors that should not offer navigation or retry."
						}
					],
					"api": [
						{ "name": "status", "type": "number", "default": "required" },
						{
							"name": "error",
							"type": "App.Error | Error | string | null",
							"default": "required"
						},
						{ "name": "title", "type": "string", "default": "derived from status" },
						{ "name": "message", "type": "string", "default": "error.message" },
						{ "name": "homeHref", "type": "string | null", "default": "/" },
						{ "name": "homeLabel", "type": "string", "default": "Go home" },
						{ "name": "showRetry", "type": "boolean", "default": "true" },
						{ "name": "retryLabel", "type": "string", "default": "Try again" },
						{ "name": "onRetry", "type": "() => void", "default": "location.reload" },
						{ "name": "children", "type": "Snippet", "default": "—" },
						{ "name": "class", "type": "string", "default": "—" },
						{ "name": "contentClass", "type": "string", "default": "—" },
						{ "name": "childrenClass", "type": "string", "default": "—" }
					]
				}
			}
		},
		{
			"name": "file-dropzone",
			"type": "registry:ui",
			"title": "File Dropzone",
			"description": "A drag-and-drop file manager with renaming, removal, validation, native form support, and callback-driven upload progress.",
			"dependencies": ["@lucide/svelte@^1.37.0"],
			"registryDependencies": ["button", "input", "utils"],
			"files": [
				{
					"path": "src/lib/components/ui/file-dropzone/file-dropzone.svelte",
					"type": "registry:ui"
				},
				{
					"path": "src/lib/components/ui/file-dropzone/index.ts",
					"type": "registry:ui"
				}
			],
			"meta": {
				"docs": {
					"usage": "Bind files for application state or provide name to submit the synchronized FileList through a native form. Users can add files by dropping or browsing, inspect file sizes, rename files, and remove individual entries. Pass onUpload to connect any upload helper; call context.onProgress with a value from 0 to 100 and observe context.signal to support cancellation. Uploads can start from each row, through Upload all, or automatically with autoUpload. Use accept, maxFiles, and maxFileSize to reject unsupported selections before upload.",
					"moreExamples": [
						{
							"name": "upload",
							"title": "Callback uploads",
							"description": "Connect an asynchronous upload helper and report progress for every file."
						},
						{
							"name": "restrictions",
							"title": "File restrictions",
							"description": "Limit file types, count, and size while receiving structured rejection details."
						}
					],
					"api": [
						{ "name": "files", "type": "File[] (bindable)", "default": "[]" },
						{
							"name": "onFilesChange",
							"type": "(files: File[]) => void",
							"default": "—"
						},
						{
							"name": "onUpload",
							"type": "(file: File, context: FileUploadContext) => Promise<void>",
							"default": "—"
						},
						{
							"name": "FileUploadContext.onProgress",
							"type": "(progress: number) => void",
							"default": "—"
						},
						{
							"name": "FileUploadContext.signal",
							"type": "AbortSignal",
							"default": "—"
						},
						{
							"name": "onUploadComplete",
							"type": "(file: File) => void",
							"default": "—"
						},
						{
							"name": "onUploadError",
							"type": "(file: File, error: Error) => void",
							"default": "—"
						},
						{
							"name": "onReject",
							"type": "(rejections: FileRejection[]) => void",
							"default": "—"
						},
						{ "name": "autoUpload", "type": "boolean", "default": "false" },
						{ "name": "name", "type": "string", "default": "—" },
						{ "name": "accept", "type": "string", "default": "—" },
						{ "name": "multiple", "type": "boolean", "default": "true" },
						{ "name": "maxFiles", "type": "number", "default": "Infinity" },
						{ "name": "maxFileSize", "type": "number (bytes)", "default": "—" },
						{ "name": "disabled", "type": "boolean", "default": "false" },
						{ "name": "dropLabel", "type": "string", "default": "Drop files here" },
						{ "name": "browseLabel", "type": "string", "default": "or choose files" },
						{ "name": "class", "type": "string", "default": "—" },
						{ "name": "dropzoneClass", "type": "string", "default": "—" },
						{ "name": "listClass", "type": "string", "default": "—" },
						{ "name": "inputProps", "type": "HTML input props", "default": "—" }
					]
				}
			}
		},
		{
			"name": "install",
			"type": "registry:ui",
			"title": "Install",
			"description": "A persistent package-manager switcher for installation commands.",
			"dependencies": ["bits-ui@^2.19.0"],
			"registryDependencies": ["utils", "local:code"],
			"files": [
				{ "path": "src/lib/components/ui/install/install.svelte", "type": "registry:ui" },
				{ "path": "src/lib/components/ui/install/index.ts", "type": "registry:ui" }
			],
			"meta": {
				"docs": {
					"usage": "Pass package-manager command prefixes through values and the shared package or CLI arguments through script. Install joins them with one space and remembers the active manager.",
					"moreExamples": [
						{
							"name": "runners",
							"title": "CLI runners",
							"description": "Combine each manager's runner prefix with one shared CLI script."
						},
						{
							"name": "options",
							"title": "Labels and availability",
							"description": "Use custom labels, disable unavailable choices, and isolate remembered selections with a storage key."
						}
					],
					"api": [
						{
							"name": "values",
							"type": "Array<{ value: string; command: string; label?: string; disabled?: boolean }>",
							"default": "required"
						},
						{ "name": "script", "type": "string", "default": "required" },
						{
							"name": "storageKey",
							"type": "string",
							"default": "codeworks-ui:package-manager"
						}
					]
				}
			}
		},
		{
			"name": "holographic",
			"type": "registry:ui",
			"title": "Holographic",
			"description": "Applies an animated holographic spectrum and shimmer over any content.",
			"dependencies": [],
			"registryDependencies": ["utils"],
			"files": [
				{
					"path": "src/lib/components/ui/holographic/holographic.svelte",
					"type": "registry:ui"
				},
				{
					"path": "src/lib/components/ui/holographic/index.ts",
					"type": "registry:ui"
				}
			],
			"meta": {
				"docs": {
					"usage": "Wrap any content and optionally pass CSS color values. Shape and border radius are controlled through class; no radius is applied by default. Empty color arrays use the built-in spectrum, and reduced-motion preferences are respected.",
					"moreExamples": [
						{
							"name": "intensity",
							"title": "Intensity and speed",
							"description": "Tune the shimmer from barely-there polish to a stronger accent and control its duration."
						},
						{
							"name": "content",
							"title": "Any shape or content",
							"description": "Apply the effect to interactive controls and cards while owning the shape entirely through Tailwind classes."
						}
					],
					"api": [
						{ "name": "colors", "type": "string[]", "default": "built-in spectrum" },
						{ "name": "intensity", "type": "number (0–1)", "default": "0.16" },
						{ "name": "duration", "type": "number (milliseconds)", "default": "5000" },
						{ "name": "class", "type": "string", "default": "—" },
						{ "name": "children", "type": "Snippet", "default": "required" }
					]
				}
			}
		},
		{
			"name": "navigation-progress",
			"type": "registry:ui",
			"title": "Navigation Progress",
			"description": "A lifecycle-aware progress bar for SvelteKit navigation with top and bottom placement.",
			"dependencies": [],
			"registryDependencies": ["utils"],
			"files": [
				{
					"path": "src/lib/components/ui/navigation-progress/navigation-progress.svelte",
					"type": "registry:ui"
				},
				{
					"path": "src/lib/components/ui/navigation-progress/index.ts",
					"type": "registry:ui"
				}
			],
			"meta": {
				"docs": {
					"usage": [
						"Mount NavigationProgress once in src/routes/+layout.svelte so it remains active across page changes.",
						"Navigation and top-level streamed promises returned from load are tracked automatically.",
						"Use waitFor for remote queries or other async work. For SSE, resolve it after the first meaningful event—the maxWaitTime safety limit prevents a stalled stream from holding the bar forever."
					],
					"moreExamples": [
						{
							"name": "bottom",
							"title": "Bottom placement",
							"description": "Place the progress indicator along the bottom edge of the viewport or a contained application shell."
						},
						{
							"name": "customization",
							"title": "Controlled and customized",
							"description": "Control progress directly and customize its thickness and CSS color for non-navigation work."
						}
					],
					"api": [
						{ "name": "position", "type": "top | bottom", "default": "top" },
						{ "name": "maxProgress", "type": "number (1–99)", "default": "90" },
						{ "name": "initialProgress", "type": "number", "default": "8" },
						{ "name": "trickleInterval", "type": "number (milliseconds)", "default": "250" },
						{ "name": "transitionDuration", "type": "number (milliseconds)", "default": "200" },
						{ "name": "completionDelay", "type": "number (milliseconds)", "default": "180" },
						{
							"name": "minDisplayTime",
							"type": "number (milliseconds)",
							"default": "0",
							"description": "Minimum time the bar remains visible, including fast navigations."
						},
						{
							"name": "waitFor",
							"type": "PromiseLike | () => PromiseLike",
							"default": "—",
							"description": "Additional promise to await before completing, such as a remote query or the first SSE event."
						},
						{
							"name": "maxWaitTime",
							"type": "number (milliseconds)",
							"default": "30000",
							"description": "Safety timeout for streamed or explicit async work. Set to 0 to disable it."
						},
						{ "name": "height", "type": "number (pixels)", "default": "3" },
						{ "name": "color", "type": "CSS color", "default": "shadcn primary" },
						{ "name": "zIndex", "type": "number", "default": "9999" },
						{
							"name": "trackNavigation",
							"type": "boolean",
							"default": "true",
							"description": "Starts and completes from SvelteKit's client-side navigation lifecycle."
						},
						{
							"name": "trackPageData",
							"type": "boolean",
							"default": "true",
							"description": "Waits for top-level promises streamed through the destination's page.data."
						},
						{ "name": "contained", "type": "boolean", "default": "false" },
						{ "name": "value", "type": "number (0–100)", "default": "—" },
						{ "name": "ariaLabel", "type": "string", "default": "Navigation progress" },
						{ "name": "onStart", "type": "() => void", "default": "—" },
						{ "name": "onComplete", "type": "() => void", "default": "—" },
						{ "name": "class", "type": "string", "default": "—" },
						{ "name": "indicatorClass", "type": "string", "default": "—" }
					]
				}
			}
		},
		{
			"name": "mention-input",
			"type": "registry:ui",
			"title": "Mention Input",
			"description": "A customizable mention-aware textarea with keyboard suggestions, multiple triggers, and application-defined mention actions.",
			"dependencies": [],
			"registryDependencies": ["utils"],
			"files": [
				{
					"path": "src/lib/components/ui/mention-input/mention-input.svelte",
					"type": "registry:ui"
				},
				{
					"path": "src/lib/components/ui/mention-input/index.ts",
					"type": "registry:ui"
				}
			],
			"meta": {
				"docs": {
					"usage": "Pass MentionItem objects and bind value for a controlled textarea. Type a configured trigger to open suggestions, then use the pointer, arrow keys, Enter, or Tab to insert a mention. Each item can define its own onMention action, while the component-level onMention observes every selection. Use onSearch to load remote results, filter to replace local matching, formatMention to control inserted text, and the suggestion and empty snippets plus Tailwind class props to own the presentation.",
					"moreExamples": [
						{
							"name": "custom",
							"title": "Custom styling and actions",
							"description": "Render rich suggestions, search keywords, customize every layer with Tailwind, and run an item-specific action after insertion."
						},
						{
							"name": "triggers",
							"title": "People and channels",
							"description": "Use multiple trigger characters, customize inserted text, and respond to every selected mention."
						},
						{
							"name": "event",
							"title": "Mention event payload",
							"description": "Select a mention and inspect every field delivered to global and item-specific callbacks."
						}
					],
					"api": [
						{ "name": "items", "type": "MentionItem[]", "default": "required" },
						{ "name": "value", "type": "string (bindable)", "default": "''" },
						{
							"name": "onValueChange",
							"type": "(value: string) => void",
							"default": "—"
						},
						{
							"name": "onMention",
							"type": "(event: MentionEvent) => void | Promise<void>",
							"default": "—"
						},
						{
							"name": "MentionItem.onMention",
							"type": "(event: MentionEvent) => void | Promise<void>",
							"default": "—"
						},
						{
							"name": "MentionEvent.item",
							"type": "MentionItem",
							"default": "—",
							"description": "The complete selected item, including its id, label, optional data, and item-specific action."
						},
						{
							"name": "MentionEvent.trigger",
							"type": "string",
							"default": "—",
							"description": "The trigger that opened the suggestions, such as @ or #."
						},
						{
							"name": "MentionEvent.query",
							"type": "string",
							"default": "—",
							"description": "The text typed after the trigger and before selecting the suggestion."
						},
						{
							"name": "MentionEvent.start",
							"type": "number",
							"default": "—",
							"description": "The starting character index of the trigger in the value before insertion."
						},
						{
							"name": "MentionEvent.end",
							"type": "number",
							"default": "—",
							"description": "The ending character index of the query in the value before insertion."
						},
						{
							"name": "MentionEvent.mention",
							"type": "string",
							"default": "—",
							"description": "The exact formatted mention inserted into the textarea."
						},
						{
							"name": "MentionEvent.value",
							"type": "string",
							"default": "—",
							"description": "The complete textarea value immediately after insertion."
						},
						{
							"name": "onSearch",
							"type": "(query: string, trigger: string) => void | Promise<void>",
							"default": "—"
						},
						{
							"name": "filter",
							"type": "(item, query, trigger) => boolean",
							"default": "label, value, and keywords"
						},
						{
							"name": "formatMention",
							"type": "(item, trigger) => string",
							"default": "trigger + item value or label"
						},
						{ "name": "triggers", "type": "string[]", "default": "['@']" },
						{ "name": "minQueryLength", "type": "number", "default": "0" },
						{ "name": "maxSuggestions", "type": "number", "default": "8" },
						{ "name": "allowSpaces", "type": "boolean", "default": "false" },
						{ "name": "open", "type": "boolean (bindable)", "default": "false" },
						{ "name": "suggestion", "type": "Snippet", "default": "—" },
						{ "name": "empty", "type": "Snippet", "default": "—" },
						{ "name": "class", "type": "string", "default": "—" },
						{ "name": "inputClass", "type": "string", "default": "—" },
						{ "name": "menuClass", "type": "string", "default": "—" },
						{ "name": "itemClass", "type": "string", "default": "—" },
						{ "name": "emptyClass", "type": "string", "default": "—" }
					]
				}
			}
		},
		{
			"name": "navbar",
			"type": "registry:ui",
			"title": "Navbar",
			"description": "A responsive navigation bar with shadcn Popover subroutes and an automatic Sheet menu on mobile.",
			"dependencies": [],
			"registryDependencies": ["popover", "sheet", "utils"],
			"files": [
				{
					"path": "src/lib/components/ui/navbar/navbar.svelte",
					"type": "registry:ui"
				},
				{
					"path": "src/lib/components/ui/navbar/index.ts",
					"type": "registry:ui"
				}
			],
			"meta": {
				"docs": {
					"usage": "Pass an array of navigation items and optionally give an item a subroutes array. Subroutes open in a shadcn Popover on desktop and render as an easy-to-scan nested list in the mobile Sheet. Use showParentLink when a group does not have a true overview route, mobileShowDescriptions for a more compact mobile list, and popoverClass or subroutesClass to size dense menus with Tailwind. Active, disabled, external, described, and badged links are supported at both levels. Use snippets for a custom brand, desktop actions, mobile actions below the Sheet heading, and true footer content. Set forceMobile when the compact navigation should be shown regardless of viewport width. The Sheet closes automatically when a mobile link is selected.",
					"moreExamples": [
						{
							"name": "actions",
							"title": "Branding and composed actions",
							"description": "Add a custom brand, Popover subroutes, badges, calls to action, and a nested Context Menu account control."
						},
						{
							"name": "mobile",
							"title": "Mobile behavior",
							"description": "See how subroutes become a touch-friendly nested hierarchy inside the mobile Sheet."
						}
					],
					"api": [
						{
							"name": "items",
							"type": "NavbarItem[]",
							"default": "required"
						},
						{
							"name": "NavbarItem.subroutes",
							"type": "NavbarSubroute[]",
							"default": "—"
						},
						{
							"name": "NavbarItem.showParentLink",
							"type": "boolean",
							"default": "true"
						},
						{
							"name": "NavbarItem.popoverClass",
							"type": "string",
							"default": "—"
						},
						{
							"name": "NavbarItem.subroutesClass",
							"type": "string",
							"default": "—"
						},
						{
							"name": "NavbarItem.mobileShowDescriptions",
							"type": "boolean",
							"default": "true"
						},
						{ "name": "brand", "type": "string | Snippet", "default": "Brand" },
						{ "name": "brandHref", "type": "string", "default": "/" },
						{
							"name": "breakpoint",
							"type": "sm | md | lg | xl | 2xl",
							"default": "md"
						},
						{ "name": "forceMobile", "type": "boolean", "default": "false" },
						{ "name": "mobileSide", "type": "left | right", "default": "right" },
						{ "name": "open", "type": "boolean (bindable)", "default": "false" },
						{
							"name": "onOpenChange",
							"type": "(open: boolean) => void",
							"default": "—"
						},
						{ "name": "actions", "type": "Snippet", "default": "—" },
						{ "name": "mobileActions", "type": "Snippet", "default": "—" },
						{ "name": "mobileFooter", "type": "Snippet", "default": "—" },
						{ "name": "containerClass", "type": "string", "default": "—" },
						{ "name": "contentClass", "type": "string", "default": "—" },
						{ "name": "class", "type": "string", "default": "—" }
					]
				}
			}
		},
		{
			"name": "phone-input",
			"type": "registry:ui",
			"title": "Phone Input",
			"description": "A phone field with accessible E.164 validation for messaging providers such as AWS.",
			"dependencies": ["libphonenumber-js@^1.13.12"],
			"registryDependencies": ["input", "utils"],
			"files": [
				{
					"path": "src/lib/components/ui/phone-input/phone-input.svelte",
					"type": "registry:ui"
				},
				{
					"path": "src/lib/components/ui/phone-input/index.ts",
					"type": "registry:ui"
				}
			],
			"meta": {
				"docs": {
					"usage": "Bind value to receive the exact E.164 string and bind valid for reactive UI state. Use onValueChange when a value change should trigger a side effect. Pass countries={['UNITED_STATES']} to accept only complete U.S. numbers such as +15404441234; +1540 remains invalid. Multiple common countries can be allowed in the same array, and any ISO country code is supported. With no countries, any valid international number is accepted. Validation uses international numbering-plan metadata, and the field is composed from the Shadcn Input primitive. The component renders no label or helper copy; it only shows the error when a non-empty value is invalid.",
					"moreExamples": [
						{
							"name": "countries",
							"title": "Multiple accepted countries",
							"description": "Accept numbers from several countries while rejecting valid numbers outside the configured list."
						},
						{
							"name": "validation",
							"title": "Delivery lookup",
							"description": "Use onValueChange to debounce a side effect once the destination has become valid."
						}
					],
					"api": [
						{ "name": "value", "type": "string (bindable)", "default": "''" },
						{ "name": "valid", "type": "boolean (bindable)", "default": "false" },
						{
							"name": "countries",
							"type": "PhoneCountry[] (common names or ISO codes)",
							"default": "[] (generic E.164)"
						},
						{
							"name": "error",
							"type": "string",
							"default": "Enter a valid phone number, such as +15404441234."
						},
						{
							"name": "onValueChange",
							"type": "(value: string, valid: boolean) => void",
							"default": "—"
						},
						{ "name": "required", "type": "boolean", "default": "false" },
						{ "name": "class", "type": "string", "default": "—" },
						{ "name": "inputClass", "type": "string", "default": "—" }
					]
				}
			}
		},
		{
			"name": "stat",
			"type": "registry:ui",
			"title": "Stat",
			"description": "Displays related numbers and supporting data in composable horizontal, vertical, or responsive blocks.",
			"dependencies": [],
			"registryDependencies": ["utils"],
			"files": [
				{ "path": "src/lib/components/ui/stat/stat.svelte", "type": "registry:ui" },
				{ "path": "src/lib/components/ui/stat/stat-item.svelte", "type": "registry:ui" },
				{ "path": "src/lib/components/ui/stat/stat-title.svelte", "type": "registry:ui" },
				{ "path": "src/lib/components/ui/stat/stat-value.svelte", "type": "registry:ui" },
				{ "path": "src/lib/components/ui/stat/stat-description.svelte", "type": "registry:ui" },
				{ "path": "src/lib/components/ui/stat/stat-figure.svelte", "type": "registry:ui" },
				{ "path": "src/lib/components/ui/stat/stat-actions.svelte", "type": "registry:ui" },
				{ "path": "src/lib/components/ui/stat/index.ts", "type": "registry:ui" }
			],
			"meta": {
				"docs": {
					"usage": "Compose Root, Item, Title, Value, and Description. Add Figure for an icon or image and Actions for controls. Root defaults to a horizontal layout; use vertical or responsive when the stats should stack, including on smaller screens.",
					"moreExamples": [
						{
							"name": "dashboard",
							"title": "Responsive dashboard",
							"description": "Combine figures, semantic colors, and multiple values in a layout that stacks on smaller screens."
						},
						{
							"name": "actions",
							"title": "Actions and alignment",
							"description": "Add controls or center individual stat items with ordinary Tailwind classes."
						}
					],
					"api": [
						{
							"name": "Root.direction",
							"type": "horizontal | vertical | responsive",
							"default": "horizontal"
						},
						{ "name": "class", "type": "string", "default": "—" },
						{ "name": "children", "type": "Snippet", "default": "required" }
					]
				}
			}
		},
		{
			"name": "steps",
			"type": "registry:ui",
			"title": "Steps",
			"description": "Shows progress through a sequence with composable steps, states, colors, and responsive orientations.",
			"dependencies": [],
			"registryDependencies": ["utils"],
			"files": [
				{ "path": "src/lib/components/ui/steps/steps.svelte", "type": "registry:ui" },
				{ "path": "src/lib/components/ui/steps/steps-item.svelte", "type": "registry:ui" },
				{ "path": "src/lib/components/ui/steps/steps-context.ts", "type": "registry:ui" },
				{ "path": "src/lib/components/ui/steps/index.ts", "type": "registry:ui" }
			],
			"meta": {
				"docs": {
					"usage": "Compose Root and Item. Root controls horizontal, vertical, or responsive layout. Each Item accepts a pending, current, or complete state and an optional semantic color variant. Pass indicator as text, a number, or a snippet for icons and custom markup. The underlying ordered list preserves the process order for assistive technology.",
					"moreExamples": [
						{
							"name": "directions",
							"title": "Vertical and responsive",
							"description": "Use a vertical sequence or switch automatically from vertical on mobile to horizontal on larger screens."
						},
						{
							"name": "variants",
							"title": "Colors and custom indicators",
							"description": "Communicate success, warnings, and errors with semantic variants and snippet-based indicator content."
						}
					],
					"api": [
						{
							"name": "Root.direction",
							"type": "horizontal | vertical | responsive",
							"default": "horizontal"
						},
						{
							"name": "Item.state",
							"type": "pending | current | complete",
							"default": "pending"
						},
						{
							"name": "Item.variant",
							"type": "primary | secondary | accent | neutral | info | success | warning | destructive",
							"default": "primary"
						},
						{ "name": "Item.indicator", "type": "string | number | Snippet", "default": "—" },
						{ "name": "class", "type": "string", "default": "—" },
						{ "name": "Item.indicatorClass", "type": "string", "default": "—" },
						{ "name": "Item.labelClass", "type": "string", "default": "—" },
						{ "name": "children", "type": "Snippet", "default": "required" }
					]
				}
			}
		},
		{
			"name": "tooltip",
			"type": "registry:ui",
			"title": "Tooltip",
			"description": "Displays concise contextual information on hover, keyboard focus, or touch-friendly tap.",
			"dependencies": ["bits-ui@^2.19.0"],
			"registryDependencies": ["utils"],
			"files": [
				{ "path": "src/lib/components/ui/tooltip/tooltip.svelte", "type": "registry:ui" },
				{ "path": "src/lib/components/ui/tooltip/index.ts", "type": "registry:ui" }
			],
			"meta": {
				"docs": {
					"usage": "Wrap a single control or element and pass content as text or a snippet. The tooltip opens on pointer hover and keyboard focus, toggles on touch tap, closes on outside interaction or Escape, avoids viewport edges, and keeps a mobile-safe maximum width. Keep tooltip content concise and non-interactive; use a popover for buttons or form controls.",
					"moreExamples": [
						{
							"name": "placements",
							"title": "Placement",
							"description": "Position the tooltip on any side while collision handling keeps it inside the viewport."
						},
						{
							"name": "content",
							"title": "Rich content",
							"description": "Use a snippet for concise formatted content while preserving tooltip semantics."
						}
					],
					"api": [
						{ "name": "content", "type": "string | Snippet", "default": "required" },
						{ "name": "open", "type": "boolean", "default": "false" },
						{ "name": "side", "type": "top | right | bottom | left", "default": "top" },
						{ "name": "align", "type": "start | center | end", "default": "center" },
						{ "name": "sideOffset", "type": "number", "default": "8" },
						{ "name": "delayDuration", "type": "number", "default": "300" },
						{ "name": "tapToOpen", "type": "boolean", "default": "true" },
						{ "name": "showArrow", "type": "boolean", "default": "true" },
						{ "name": "disabled", "type": "boolean", "default": "false" },
						{ "name": "class", "type": "string", "default": "—" },
						{ "name": "contentClass", "type": "string", "default": "—" },
						{ "name": "children", "type": "Snippet", "default": "required" }
					]
				}
			}
		},
		{
			"name": "typewriter",
			"type": "registry:ui",
			"title": "Typewriter",
			"description": "Animates a string or sequence of strings as inline text when it first enters the viewport.",
			"dependencies": [],
			"registryDependencies": ["utils"],
			"files": [
				{
					"path": "src/lib/components/ui/typewriter/typewriter.svelte",
					"type": "registry:ui"
				},
				{
					"path": "src/lib/components/ui/typewriter/index.ts",
					"type": "registry:ui"
				}
			],
			"meta": {
				"docs": {
					"usage": [
						"Place Typewriter anywhere ordinary inline text can appear and pass value as a string or array of strings.",
						"The animation begins once when the span first enters the viewport. Set loop to cycle continuously through every supplied phrase.",
						"Timing, cursor presentation, and lifecycle callbacks are configurable. Reduced-motion preferences display the final text immediately."
					],
					"moreExamples": [
						{
							"name": "phrases",
							"title": "Looping phrases",
							"description": "Cycle through an array of phrases with typing, pausing, and deletion between each value."
						},
						{
							"name": "inline",
							"title": "Inline text",
							"description": "Insert the span directly into a sentence without introducing a block-level wrapper."
						}
					],
					"api": [
						{
							"name": "value",
							"type": "string | string[]",
							"default": "required",
							"description": "Text or sequence of phrases to type."
						},
						{
							"name": "loop",
							"type": "boolean",
							"default": "false",
							"description": "Deletes and repeats the supplied phrases continuously."
						},
						{
							"name": "speed",
							"type": "number (milliseconds)",
							"default": "70",
							"description": "Delay between each typed or deleted grapheme cluster."
						},
						{
							"name": "pauseDuration",
							"type": "number (milliseconds)",
							"default": "1200",
							"description": "Time a completed phrase remains visible before deletion begins."
						},
						{
							"name": "startDelay",
							"type": "number (milliseconds)",
							"default": "0",
							"description": "Delay after the component enters the viewport before typing starts."
						},
						{
							"name": "showCursor",
							"type": "boolean",
							"default": "true",
							"description": "Shows the blinking cursor when enabled."
						},
						{
							"name": "cursorCharacter",
							"type": "string",
							"default": "|",
							"description": "Character rendered as the cursor."
						},
						{
							"name": "ariaLabel",
							"type": "string",
							"default": "joined phrases",
							"description": "Stable text exposed to assistive technology instead of incremental updates."
						},
						{
							"name": "onPhraseChange",
							"type": "(value: string, index: number) => void",
							"default": "—",
							"description": "Called when typing moves to a new phrase."
						},
						{
							"name": "onComplete",
							"type": "() => void",
							"default": "—",
							"description": "Called when a non-looping sequence finishes."
						},
						{
							"name": "class",
							"type": "string",
							"default": "—",
							"description": "Tailwind CSS classes applied to the outer span."
						},
						{
							"name": "cursorClass",
							"type": "string",
							"default": "—",
							"description": "Tailwind CSS classes applied to the cursor span."
						}
					]
				}
			}
		}
	]
}