@sparkwire/mcp 0.0.0-stage → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (48) hide show
  1. package/data/docs.json +4963 -0
  2. package/data/r/accordion.json +26 -0
  3. package/data/r/alert.json +26 -0
  4. package/data/r/avatar.json +26 -0
  5. package/data/r/base.json +55 -0
  6. package/data/r/button.json +33 -0
  7. package/data/r/card.json +26 -0
  8. package/data/r/charts.json +40 -0
  9. package/data/r/checkbox.json +27 -0
  10. package/data/r/combobox.json +30 -0
  11. package/data/r/command-palette.json +29 -0
  12. package/data/r/dashboard.json +34 -0
  13. package/data/r/data-table.json +39 -0
  14. package/data/r/date-picker.json +56 -0
  15. package/data/r/drawer.json +29 -0
  16. package/data/r/dropdown.json +30 -0
  17. package/data/r/field.json +26 -0
  18. package/data/r/file-upload.json +28 -0
  19. package/data/r/headless.json +27 -0
  20. package/data/r/indicators.json +26 -0
  21. package/data/r/input-base.json +21 -0
  22. package/data/r/menu.json +32 -0
  23. package/data/r/modal.json +29 -0
  24. package/data/r/navigation.json +26 -0
  25. package/data/r/number-field.json +30 -0
  26. package/data/r/provider.json +47 -0
  27. package/data/r/radio-group.json +26 -0
  28. package/data/r/select.json +21 -0
  29. package/data/r/settings.json +37 -0
  30. package/data/r/sidebar.json +30 -0
  31. package/data/r/sign-in.json +31 -0
  32. package/data/r/slider.json +29 -0
  33. package/data/r/spark.json +26 -0
  34. package/data/r/stepper.json +26 -0
  35. package/data/r/styles.json +17 -0
  36. package/data/r/switch.json +26 -0
  37. package/data/r/tabs.json +29 -0
  38. package/data/r/textarea.json +28 -0
  39. package/data/r/textfield.json +57 -0
  40. package/data/r/time-picker.json +32 -0
  41. package/data/r/toast.json +26 -0
  42. package/data/r/toggle-group.json +29 -0
  43. package/data/r/tooltip.json +29 -0
  44. package/data/r/utils.json +63 -0
  45. package/data/registry.json +1219 -0
  46. package/package.json +40 -4
  47. package/src/server.mjs +179 -0
  48. package/README.md +0 -3
@@ -0,0 +1,26 @@
1
+ {
2
+ "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
+ "name": "indicators",
4
+ "type": "registry:ui",
5
+ "title": "Indicators",
6
+ "description": "Badge, Progress and Spinner.",
7
+ "dependencies": [],
8
+ "registryDependencies": [
9
+ "@sparkwire/styles",
10
+ "@sparkwire/utils"
11
+ ],
12
+ "files": [
13
+ {
14
+ "path": "components/spark-ui/Indicators/Indicators.tsx",
15
+ "type": "registry:ui",
16
+ "target": "components/spark-ui/Indicators/Indicators.tsx",
17
+ "content": "import React from 'react';\nimport { useMessages } from '../internal/messages';\nimport { Tone } from '../internal/tone';\nimport { cx } from '../internal/cx';\nimport { useDefaults, slot, ClassNames } from '../internal/defaults';\n\n/* ------------------------------------------------------------------ Badge */\n\nexport interface BadgeProps extends React.HTMLAttributes<HTMLSpanElement> {\n /** Default `brand`. */\n tone?: Tone | 'neutral';\n /** Show the status LED. Default `true`. */\n led?: boolean;\n /** Pulse the LED: something is live or in progress. */\n pulse?: boolean;\n /** `soft` tinted background (default) or `solid` fill. */\n variant?: 'soft' | 'solid';\n /** Extra classes for each part: root, led. */\n classNames?: ClassNames<'root' | 'led'>;\n}\n\n/** Badge: a status label with an LED. Pulsing means \"live\". Style hooks: `.sp-badge`, `__led`. */\nexport function Badge(inProps: BadgeProps) {\n const { tone = 'brand', led = true, pulse = false, variant = 'soft', className, classNames, children, ...rest } = useDefaults('Badge', inProps);\n return (\n <span\n className={slot('sp-badge', classNames, 'root', className)}\n data-tone={tone}\n data-variant={variant}\n data-pulse={pulse || undefined}\n {...rest}\n >\n {led && <span aria-hidden=\"true\" className={slot('sp-badge__led', classNames, 'led')} />}\n {children}\n </span>\n );\n}\n\n/* --------------------------------------------------------------- Progress */\n\nexport interface ProgressProps {\n /** 0–100. Leave undefined for an indeterminate bar. */\n value?: number;\n /** Text above the bar; also its accessible name when a string. */\n label?: React.ReactNode;\n /** Show the percentage next to the label. Default `true` when determinate. */\n showValue?: boolean;\n /** Default `brand`. */\n tone?: Tone;\n /** Bar thickness: 4, 8 or 12px. Default `medium`. */\n size?: 'small' | 'medium' | 'large';\n}\n\n/**\n * Progress: a charge bar. At 100% the bar is fully charged and current flows.\n * Style hooks: `.sp-progress[data-state=\"charging\"|\"charged\"|\"indeterminate\"]`, `__track`, `__fill`.\n */\nexport function Progress(inProps: ProgressProps) {\n const { value, label, showValue, tone = 'brand', size = 'medium' } = useDefaults('Progress', inProps);\n const v = value === undefined ? undefined : Math.max(0, Math.min(100, value));\n const state = v === undefined ? 'indeterminate' : v === 100 ? 'charged' : 'charging';\n const showNumber = v !== undefined && showValue !== false;\n\n return (\n <div className=\"sp-progress\" data-tone={tone} data-size={size} data-state={state}>\n {(label || showNumber) && (\n <div className=\"sp-progress__header\">\n <span>{label}</span>\n {showNumber && <span className=\"sp-progress__value\">{Math.round(v!)}%</span>}\n </div>\n )}\n <div\n role=\"progressbar\"\n aria-valuemin={0}\n aria-valuemax={100}\n aria-valuenow={v}\n aria-label={typeof label === 'string' ? label : undefined}\n className=\"sp-progress__track\"\n >\n {v === undefined ? (\n <span className=\"sp-progress__sweep\" />\n ) : (\n <span className={cx('sp-progress__fill', state === 'charged' && 'sp-current')} style={{ width: `${v}%` }} />\n )}\n </div>\n </div>\n );\n}\n\n/* ---------------------------------------------------------------- Spinner */\n\nexport interface SpinnerProps {\n /** 16, 24 or 36px. Default `medium`. */\n size?: 'small' | 'medium' | 'large';\n /** Default `brand`. */\n tone?: Tone;\n /** Accessible label. Default \"Loading\". */\n label?: string;\n}\n\nconst spinners = { small: 16, medium: 24, large: 36 };\n\n/** Spinner: an arc of current with a spark at its head. Style hooks: `.sp-spinner`, `__track`, `__arc`, `__head`. */\nexport function Spinner(inProps: SpinnerProps) {\n const m = useMessages();\n const { size = 'medium', tone = 'brand', label = m.loading } = useDefaults('Spinner', inProps);\n const s = spinners[size];\n const stroke = Math.max(2, s / 10);\n const r = (s - stroke) / 2;\n const c = 2 * Math.PI * r;\n const a = 0.3 * 2 * Math.PI - Math.PI / 2;\n\n return (\n <span role=\"status\" aria-label={label} className=\"sp-spinner\" data-tone={tone} style={{ width: s, height: s }}>\n <svg width={s} height={s} viewBox={`0 0 ${s} ${s}`} aria-hidden=\"true\">\n <circle className=\"sp-spinner__track\" cx={s / 2} cy={s / 2} r={r} fill=\"none\" strokeWidth={stroke} />\n <circle\n className=\"sp-spinner__arc\"\n cx={s / 2}\n cy={s / 2}\n r={r}\n fill=\"none\"\n strokeWidth={stroke}\n strokeLinecap=\"round\"\n strokeDasharray={`${c * 0.3} ${c}`}\n transform={`rotate(-90 ${s / 2} ${s / 2})`}\n />\n <circle className=\"sp-spinner__head\" cx={s / 2 + r * Math.cos(a)} cy={s / 2 + r * Math.sin(a)} r={stroke * 0.9} />\n </svg>\n </span>\n );\n}\n"
18
+ },
19
+ {
20
+ "path": "components/spark-ui/Indicators/index.ts",
21
+ "type": "registry:ui",
22
+ "target": "components/spark-ui/Indicators/index.ts",
23
+ "content": "export * from './Indicators';\n"
24
+ }
25
+ ]
26
+ }
@@ -0,0 +1,21 @@
1
+ {
2
+ "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
+ "name": "input-base",
4
+ "type": "registry:ui",
5
+ "title": "InputBase",
6
+ "description": "The field shell (re-exports the base InputBase).",
7
+ "dependencies": [],
8
+ "registryDependencies": [
9
+ "@sparkwire/base",
10
+ "@sparkwire/styles",
11
+ "@sparkwire/utils"
12
+ ],
13
+ "files": [
14
+ {
15
+ "path": "components/spark-ui/InputBase/index.ts",
16
+ "type": "registry:ui",
17
+ "target": "components/spark-ui/InputBase/index.ts",
18
+ "content": "export { InputBase } from '../base/InputBase';\nexport type { InputBaseProps } from '../base/InputBase';\n"
19
+ }
20
+ ]
21
+ }
@@ -0,0 +1,32 @@
1
+ {
2
+ "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
+ "name": "menu",
4
+ "type": "registry:ui",
5
+ "title": "Menu",
6
+ "description": "Actions behind a button, with submenus.",
7
+ "dependencies": [
8
+ "@react-types/shared@^3.37.0",
9
+ "react-aria@^3.53.1",
10
+ "react-stately@^3.51.0"
11
+ ],
12
+ "registryDependencies": [
13
+ "@sparkwire/base",
14
+ "@sparkwire/button",
15
+ "@sparkwire/styles",
16
+ "@sparkwire/utils"
17
+ ],
18
+ "files": [
19
+ {
20
+ "path": "components/spark-ui/Menu/Menu.tsx",
21
+ "type": "registry:ui",
22
+ "target": "components/spark-ui/Menu/Menu.tsx",
23
+ "content": "import React, { cloneElement, isValidElement, useRef } from 'react';\nimport { mergeProps, useButton, useMenu, useMenuItem, useMenuSection, useMenuTrigger, useSeparator, useSubmenuTrigger } from 'react-aria';\nimport type { AriaMenuOptions } from 'react-aria';\nimport { Item, Section, useMenuTriggerState, useSubmenuTriggerState, useTreeState, RootMenuTriggerState, TreeState } from 'react-stately';\nimport type { Key, Node, Selection } from '@react-types/shared';\nimport { Popover } from '../base/Popover';\nimport { ListItemContent } from '../base/ListBox';\nimport { Button } from '../Button';\nimport { cx } from '../internal/cx';\nimport { useDefaults, slot, ClassNames } from '../internal/defaults';\n\n/** A section's items. Some React Aria collections lack getChildren(); every node has childNodes. */\nfunction sectionChildren<T>(collection: object, section: Node<T>): Iterable<Node<T>> {\n const c = collection as { getChildren?: (key: Node<T>[\"key\"]) => Iterable<Node<T>> };\n return typeof c.getChildren === \"function\" ? c.getChildren(section.key) : section.childNodes;\n}\n\n\nexport interface MenuItem {\n /** Passed to `onAction`. Unique within the whole menu, submenus included. */\n key: string;\n label: string;\n icon?: React.ReactNode;\n /** Secondary line under the label. */\n description?: React.ReactNode;\n /** Keyboard shortcut hint, e.g. \"⌘E\". Display only: wire up the shortcut yourself. */\n shortcut?: string;\n /** Destructive action (delete, remove): shown in the error colour. */\n danger?: boolean;\n disabled?: boolean;\n /** Make the item a link. */\n href?: string;\n /** Items of a submenu. Opens to the side; arrow keys move in and out. */\n items?: MenuEntry[];\n}\n\nexport interface MenuSection {\n /** Optional heading. */\n title?: string;\n items: MenuItem[];\n}\n\nexport type MenuEntry = MenuItem | MenuSection;\n\nconst isSection = (e: MenuEntry): e is MenuSection => !(e as MenuItem).key && Array.isArray(e.items);\n\nexport interface MenuProps {\n /** Text of the default trigger button. Ignored when `trigger` is set. */\n label?: React.ReactNode;\n /** Your own trigger, e.g. `<Button variant=\"text\">` or an icon button. It must accept a ref. */\n trigger?: React.ReactElement;\n /** Accessible name for the menu. Defaults to the trigger's text. */\n 'aria-label'?: string;\n /** Items, sections (`{ title, items }`) and submenus (`items` on an item). */\n items: MenuEntry[];\n /** Called with the chosen item's key. */\n onAction?: (key: string) => void;\n /** Make items checkable: `single` (like radio) or `multiple` (like checkboxes). Default `none`. */\n selectionMode?: 'none' | 'single' | 'multiple';\n /** Controlled checked keys. */\n selectedKeys?: Iterable<string>;\n /** Initial checked keys when uncontrolled. */\n defaultSelectedKeys?: Iterable<string>;\n /** Called with the checked keys. */\n onSelectionChange?: (keys: Set<string>) => void;\n /** Close after an item is chosen. Default `true` (`false` by default with `multiple`). */\n closeOnSelect?: boolean;\n /** Where the menu opens. Default `bottom start`. */\n placement?: 'bottom start' | 'bottom end' | 'top start' | 'top end';\n disabled?: boolean;\n onOpenChange?: (open: boolean) => void;\n className?: string;\n /** Extra classes for each part: trigger, popover, menu, item. */\n classNames?: ClassNames<'trigger' | 'popover' | 'menu' | 'item'>;\n}\n\n/**\n * Menu: a list of actions behind a button (Edit, Duplicate, Delete). Not for\n * picking a value: use Dropdown for that. Built on the Popover base and the\n * shared list-item look, with React Aria's menu behaviour: arrow keys,\n * typeahead, Enter/Space to run, Escape to close, submenus that open with\n * the right arrow (left in right-to-left), sections, links, checkable items,\n * and focus returning to the trigger.\n *\n * Style hooks: `.sp-menu`, `.sp-list-item[data-focused][data-danger][data-disabled][data-open]`,\n * `__end` (shortcut), `__chevron`, `__check`; trigger `.sp-menu-trigger`.\n */\nexport function Menu(inProps: MenuProps) {\n const {\n label,\n trigger,\n 'aria-label': ariaLabel,\n items,\n onAction,\n selectionMode = 'none',\n selectedKeys,\n defaultSelectedKeys,\n onSelectionChange,\n closeOnSelect,\n placement = 'bottom start',\n disabled,\n onOpenChange,\n className,\n classNames,\n } = useDefaults('Menu', inProps);\n\n const state = useMenuTriggerState({ onOpenChange });\n const triggerRef = useRef<HTMLElement>(null);\n const { menuTriggerProps, menuProps } = useMenuTrigger({ isDisabled: disabled }, state, triggerRef);\n const { buttonProps } = useButton({ ...menuTriggerProps, isDisabled: disabled }, triggerRef);\n const name = ariaLabel ?? (typeof label === 'string' ? label : undefined);\n\n const triggerClass = slot('sp-menu-trigger', classNames, 'trigger');\n const triggerNode =\n trigger && isValidElement(trigger) ? (\n cloneElement(trigger as React.ReactElement<Record<string, unknown>>, {\n ...mergeProps((trigger.props as Record<string, unknown>) ?? {}, buttonProps),\n ref: triggerRef,\n className: cx((trigger.props as { className?: string }).className, triggerClass),\n 'data-open': state.isOpen || undefined,\n })\n ) : (\n <Button\n {...(buttonProps as object)}\n ref={triggerRef as React.Ref<HTMLButtonElement>}\n variant=\"outlined\"\n spark={false}\n disabled={disabled}\n className={triggerClass}\n data-open={state.isOpen || undefined}\n endIcon={\n <svg className=\"sp-menu-trigger__chevron\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" aria-hidden=\"true\">\n <path d=\"M4 6l4 4 4-4\" fill=\"none\" stroke=\"currentColor\" strokeWidth=\"2\" strokeLinecap=\"round\" strokeLinejoin=\"round\" />\n </svg>\n }\n >\n {label}\n </Button>\n );\n\n return (\n <>\n {triggerNode}\n {state.isOpen && (\n <Popover state={state} triggerRef={triggerRef} placement={placement} className={slot('sp-menu__popover', classNames, 'popover', className)}>\n <MenuList\n {...menuProps}\n aria-label={name}\n entries={items}\n rootState={state}\n onAction={onAction}\n selectionMode={selectionMode}\n selectedKeys={selectedKeys}\n defaultSelectedKeys={defaultSelectedKeys}\n onSelectionChange={onSelectionChange ? (keys: Selection) => onSelectionChange(new Set(Array.from(keys as Set<Key>, String))) : undefined}\n shouldCloseOnSelect={closeOnSelect ?? selectionMode !== 'multiple'}\n menuClass={classNames?.menu}\n itemClass={classNames?.item}\n />\n </Popover>\n )}\n </>\n );\n}\n\n/* ----------------------------------------------------------------- list */\n\nfunction renderEntries(entries: MenuEntry[]) {\n return entries.map((e, i) =>\n isSection(e) ? (\n <Section key={`section-${i}`} title={e.title} aria-label={e.title ? undefined : `Section ${i + 1}`}>\n {e.items.map(renderItem)}\n </Section>\n ) : (\n renderItem(e)\n ),\n );\n}\n\nfunction renderItem(item: MenuItem) {\n // Submenu triggers need child items in the collection so React Aria knows they open something.\n return item.items ? (\n <Item key={item.key} textValue={item.label} title={item.label} href={item.href}>\n {renderEntries(item.items)}\n </Item>\n ) : (\n <Item key={item.key} textValue={item.label} href={item.href}>\n {item.label}\n </Item>\n );\n}\n\nfunction indexItems(entries: MenuEntry[], map = new Map<string, MenuItem>()) {\n for (const e of entries) {\n if (isSection(e)) indexItems(e.items, map);\n else {\n map.set(e.key, e);\n if (e.items) indexItems(e.items, map);\n }\n }\n return map;\n}\n\ninterface MenuListProps extends Omit<AriaMenuOptions<unknown>, 'onAction' | 'selectedKeys' | 'defaultSelectedKeys' | 'items' | 'children'> {\n entries: MenuEntry[];\n rootState: RootMenuTriggerState;\n onAction?: (key: string) => void;\n selectedKeys?: Iterable<Key> | 'all';\n defaultSelectedKeys?: Iterable<Key> | 'all';\n shouldCloseOnSelect?: boolean;\n menuClass?: string;\n itemClass?: string;\n submenuLevel?: number;\n listRef?: React.RefObject<HTMLUListElement>;\n}\n\nfunction MenuList({ entries, rootState, onAction, menuClass, itemClass, submenuLevel, listRef, ...props }: MenuListProps) {\n const ownRef = useRef<HTMLUListElement>(null);\n const ref = listRef ?? ownRef;\n const defs = indexItems(entries);\n const disabledKeys = Array.from(defs.values()).filter((d) => d.disabled).map((d) => d.key);\n const ariaProps = { ...props, children: renderEntries(entries), disabledKeys, onAction: (key: Key) => onAction?.(String(key)) };\n const state = useTreeState(ariaProps);\n const { menuProps } = useMenu(ariaProps, state, ref);\n\n return (\n <ul {...menuProps} ref={ref} className={cx('sp-menu', menuClass)} data-level={submenuLevel}>\n {Array.from(state.collection).map((node, i) =>\n node.type === 'section' ? (\n <MenuSectionView key={node.key} section={node} state={state} defs={defs} rootState={rootState} parentRef={ref} onAction={onAction} itemClass={itemClass} first={i === 0} />\n ) : (\n <MenuItemView key={node.key} node={node} state={state} defs={defs} rootState={rootState} parentRef={ref} onAction={onAction} itemClass={itemClass} />\n ),\n )}\n </ul>\n );\n}\n\ninterface ItemViewShared {\n state: TreeState<unknown>;\n defs: Map<string, MenuItem>;\n rootState: RootMenuTriggerState;\n parentRef: React.RefObject<HTMLUListElement>;\n onAction?: (key: string) => void;\n itemClass?: string;\n}\n\nfunction MenuSectionView({ section, first, ...shared }: ItemViewShared & { section: Node<unknown>; first: boolean }) {\n const { itemProps, headingProps, groupProps } = useMenuSection({ heading: section.rendered, 'aria-label': section['aria-label'] });\n const { separatorProps } = useSeparator({ elementType: 'li' });\n return (\n <>\n {!first && <li {...separatorProps} className=\"sp-list-separator\" />}\n <li {...itemProps} className=\"sp-list-section\">\n {section.rendered && (\n <span {...headingProps} className=\"sp-list-section__heading\">\n {section.rendered}\n </span>\n )}\n <ul {...groupProps} className=\"sp-list-section__group\">\n {Array.from(sectionChildren(shared.state.collection, section)).map((node) => (\n <MenuItemView key={node.key} node={node} {...shared} />\n ))}\n </ul>\n </li>\n </>\n );\n}\n\nfunction MenuItemView(props: ItemViewShared & { node: Node<unknown> }) {\n return props.node.hasChildNodes ? <SubmenuItem {...props} /> : <MenuItemRow {...props} />;\n}\n\nfunction MenuItemRow({\n node,\n state,\n defs,\n itemClass,\n extraProps,\n isOpen,\n itemRef,\n}: ItemViewShared & { node: Node<unknown>; extraProps?: object; isOpen?: boolean; itemRef?: React.RefObject<HTMLLIElement> }) {\n const ownRef = useRef<HTMLLIElement>(null);\n const ref = itemRef ?? ownRef;\n const def = defs.get(String(node.key));\n const { menuItemProps, isFocused, isSelected, isDisabled } = useMenuItem({ key: node.key, ...extraProps }, state, ref);\n const checkable = state.selectionManager.selectionMode !== 'none';\n const Tag = (def?.href ? 'a' : 'li') as 'li';\n const row = (\n <Tag\n {...menuItemProps}\n ref={ref}\n className={cx('sp-list-item', itemClass)}\n data-focused={isFocused || undefined}\n data-selected={(checkable && isSelected) || undefined}\n data-disabled={isDisabled || undefined}\n data-danger={def?.danger || undefined}\n data-open={isOpen || undefined}\n >\n <ListItemContent\n icon={def?.icon}\n label={def?.label ?? node.textValue}\n description={def?.description}\n end={def?.shortcut ? <kbd>{def.shortcut}</kbd> : undefined}\n />\n {checkable && isSelected && (\n <svg className=\"sp-list-item__check\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" aria-hidden=\"true\">\n <path d=\"M3 8.5l3 3 7-7\" fill=\"none\" stroke=\"currentColor\" strokeWidth=\"2\" strokeLinecap=\"round\" strokeLinejoin=\"round\" />\n </svg>\n )}\n {node.hasChildNodes && (\n <svg className=\"sp-list-item__chevron\" width=\"14\" height=\"14\" viewBox=\"0 0 16 16\" aria-hidden=\"true\">\n <path d=\"M6 4l4 4-4 4\" fill=\"none\" stroke=\"currentColor\" strokeWidth=\"2\" strokeLinecap=\"round\" strokeLinejoin=\"round\" />\n </svg>\n )}\n </Tag>\n );\n // Links sit inside a list item so the list stays valid HTML.\n return def?.href ? <li role=\"none\">{row}</li> : row;\n}\n\nfunction SubmenuItem(props: ItemViewShared & { node: Node<unknown> }) {\n const { node, rootState, parentRef, onAction, itemClass, defs } = props;\n const triggerRef = useRef<HTMLLIElement>(null);\n const submenuRef = useRef<HTMLUListElement>(null);\n const subState = useSubmenuTriggerState({ triggerKey: node.key }, rootState);\n const { submenuTriggerProps, submenuProps, popoverProps } = useSubmenuTrigger({ node, parentMenuRef: parentRef, submenuRef }, subState, triggerRef);\n const def = defs.get(String(node.key));\n return (\n <>\n <MenuItemRow {...props} itemRef={triggerRef} extraProps={submenuTriggerProps} isOpen={subState.isOpen} />\n {subState.isOpen && def?.items && (\n <Popover\n {...popoverProps}\n state={subState}\n triggerRef={triggerRef}\n placement=\"end top\"\n offset={-4}\n crossOffset={-6}\n className=\"sp-menu__popover sp-menu__popover--sub\"\n >\n <MenuList {...submenuProps} listRef={submenuRef} entries={def.items} rootState={rootState} onAction={onAction} itemClass={itemClass} />\n </Popover>\n )}\n </>\n );\n}\n\nexport default Menu;\n"
24
+ },
25
+ {
26
+ "path": "components/spark-ui/Menu/index.ts",
27
+ "type": "registry:ui",
28
+ "target": "components/spark-ui/Menu/index.ts",
29
+ "content": "export { Menu } from './Menu';\nexport type { MenuProps, MenuItem, MenuSection, MenuEntry } from './Menu';\n"
30
+ }
31
+ ]
32
+ }
@@ -0,0 +1,29 @@
1
+ {
2
+ "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
+ "name": "modal",
4
+ "type": "registry:ui",
5
+ "title": "Modal",
6
+ "description": "A dialog that powers on, with focus trapping.",
7
+ "dependencies": [
8
+ "react-aria@^3.53.1"
9
+ ],
10
+ "registryDependencies": [
11
+ "@sparkwire/base",
12
+ "@sparkwire/styles",
13
+ "@sparkwire/utils"
14
+ ],
15
+ "files": [
16
+ {
17
+ "path": "components/spark-ui/Modal/Modal.tsx",
18
+ "type": "registry:ui",
19
+ "target": "components/spark-ui/Modal/Modal.tsx",
20
+ "content": "import React from 'react';\nimport { useMessages } from '../internal/messages';\nimport { useDialog } from 'react-aria';\nimport { Overlay } from '../base/Overlay';\nimport { useDefaults, slot, ClassNames } from '../internal/defaults';\n\nexport interface ModalProps {\n /** Whether the dialog is shown. */\n open: boolean;\n /** Called on Escape, the close button, or a click outside the dialog. */\n onClose: () => void;\n /** Dialog heading; also its accessible name. */\n title: React.ReactNode;\n /** Supporting text under the title; read as the dialog's description. */\n description?: React.ReactNode;\n children?: React.ReactNode;\n /** Buttons, usually. Rendered right-aligned in the footer. */\n actions?: React.ReactNode;\n /** Max width: small 400px, medium 520px, large 720px. */\n size?: 'small' | 'medium' | 'large';\n /** Close when the user clicks outside the dialog. Default `true`. */\n closeOnBackdrop?: boolean;\n /** Class for the dialog panel. */\n className?: string;\n /** Extra classes for each part: root, backdrop, panel, header, title, description, close, body, actions. */\n classNames?: ClassNames<'root' | 'backdrop' | 'panel' | 'header' | 'title' | 'description' | 'close' | 'body' | 'actions'>;\n}\n\n/**\n * Modal: a power cut. The page dims with a flicker and the dialog is the only\n * thing left lit. Behaviour comes from React Aria: focus is contained and\n * restored, the page behind is hidden from screen readers and can't scroll,\n * and Escape or an outside click closes it. Built on the Overlay base.\n *\n * Style hooks: `.sp-modal`, `__backdrop`, `__panel[data-size]`, `__current`,\n * `__header`, `__title`, `__description`, `__close`, `__body`, `__actions`.\n */\nexport function Modal(inProps: ModalProps) {\n const { open, onClose, closeOnBackdrop = true, classNames, ...rest } = useDefaults('Modal', inProps);\n return (\n <Overlay\n open={open}\n onClose={onClose}\n dismissable={closeOnBackdrop}\n className={slot('sp-modal', classNames, 'root')}\n backdropClassName={slot('sp-modal__backdrop', classNames, 'backdrop')}\n >\n {({ panelProps, panelRef }) => (\n <ModalPanel {...rest} onClose={onClose} classNames={classNames} panelProps={panelProps} panelRef={panelRef} />\n )}\n </Overlay>\n );\n}\n\nfunction ModalPanel({\n onClose,\n title,\n description,\n children,\n actions,\n size = 'medium',\n className,\n classNames,\n panelProps,\n panelRef,\n}: Omit<ModalProps, 'open'> & { panelProps: React.HTMLAttributes<HTMLElement>; panelRef: React.RefObject<HTMLDivElement> }) {\n const m = useMessages();\n const { dialogProps, titleProps } = useDialog({}, panelRef);\n const descId = React.useId();\n\n return (\n <div\n {...panelProps}\n {...dialogProps}\n ref={panelRef}\n aria-describedby={description ? descId : undefined}\n data-size={size}\n className={slot('sp-modal__panel', classNames, 'panel', className)}\n >\n <div aria-hidden=\"true\" className=\"sp-modal__current sp-current\" />\n <div className={slot('sp-modal__header', classNames, 'header')}>\n <div className=\"sp-modal__heading\">\n <h2 {...titleProps} className={slot('sp-modal__title', classNames, 'title')}>\n {title}\n </h2>\n {description && (\n <p id={descId} className={slot('sp-modal__description', classNames, 'description')}>\n {description}\n </p>\n )}\n </div>\n <button type=\"button\" aria-label={m.close} onClick={onClose} className={slot('sp-modal__close', classNames, 'close')}>\n <svg width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" aria-hidden=\"true\">\n <path d=\"M3 3l10 10M13 3L3 13\" stroke=\"currentColor\" strokeWidth=\"2\" strokeLinecap=\"round\" />\n </svg>\n </button>\n </div>\n {children && <div className={slot('sp-modal__body', classNames, 'body')}>{children}</div>}\n <div className={slot('sp-modal__actions', classNames, 'actions')}>{actions}</div>\n </div>\n );\n}\n\nexport default Modal;\n"
21
+ },
22
+ {
23
+ "path": "components/spark-ui/Modal/index.ts",
24
+ "type": "registry:ui",
25
+ "target": "components/spark-ui/Modal/index.ts",
26
+ "content": "export * from './Modal';\n"
27
+ }
28
+ ]
29
+ }
@@ -0,0 +1,26 @@
1
+ {
2
+ "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
+ "name": "navigation",
4
+ "type": "registry:ui",
5
+ "title": "Navigation",
6
+ "description": "Breadcrumbs and Pagination.",
7
+ "dependencies": [],
8
+ "registryDependencies": [
9
+ "@sparkwire/styles",
10
+ "@sparkwire/utils"
11
+ ],
12
+ "files": [
13
+ {
14
+ "path": "components/spark-ui/Navigation/Navigation.tsx",
15
+ "type": "registry:ui",
16
+ "target": "components/spark-ui/Navigation/Navigation.tsx",
17
+ "content": "import React from 'react';\nimport { useMessages } from '../internal/messages';\nimport { useDefaults, slot, ClassNames } from '../internal/defaults';\n\n/* ----------------------------------------------------------- Breadcrumbs */\n\nexport interface BreadcrumbItem {\n label: React.ReactNode;\n /** Omit on the current page (the last item). */\n href?: string;\n icon?: React.ReactNode;\n}\n\nexport interface BreadcrumbsProps {\n items: BreadcrumbItem[];\n /** Show at most this many; the middle collapses to \"…\". Default: all. */\n maxItems?: number;\n /** Default \"/\"-style chevron. */\n separator?: React.ReactNode;\n /** Render links with your router, e.g. `({ href, ...p }) => <Link href={href} {...p} />`. */\n renderLink?: (props: { href: string; className: string; children: React.ReactNode }) => React.ReactNode;\n 'aria-label'?: string;\n className?: string;\n classNames?: ClassNames<'root' | 'item' | 'link' | 'current' | 'separator'>;\n}\n\nconst Chevron = () => (\n <svg width=\"14\" height=\"14\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" strokeWidth=\"2\" strokeLinecap=\"round\" aria-hidden=\"true\">\n <path d=\"m9 6 6 6-6 6\" />\n </svg>\n);\n\n/**\n * Breadcrumbs: where this page sits. The last item is the current page\n * (`aria-current=\"page\"`); long trails collapse in the middle with\n * `maxItems`. Works with any router through `renderLink`.\n *\n * Style hooks: `.sp-breadcrumbs`, `__item`, `__link`, `__current`, `__separator`, `__ellipsis`.\n */\nexport function Breadcrumbs(inProps: BreadcrumbsProps) {\n const m = useMessages();\n const { items, maxItems, separator = <Chevron />, renderLink, className, classNames, ...rest } = useDefaults('Breadcrumbs', inProps) as BreadcrumbsProps;\n const collapse = maxItems !== undefined && items.length > maxItems && maxItems >= 2;\n const shown: Array<BreadcrumbItem | 'ellipsis'> = collapse ? [items[0], 'ellipsis', ...items.slice(items.length - (maxItems! - 1))] : items;\n return (\n <nav aria-label={rest['aria-label'] ?? m.breadcrumb} className={slot('sp-breadcrumbs', classNames, 'root', className)}>\n <ol>\n {shown.map((item, i) => {\n const last = i === shown.length - 1;\n return (\n <li key={i} className={slot('sp-breadcrumbs__item', classNames, 'item')}>\n {item === 'ellipsis' ? (\n <span className=\"sp-breadcrumbs__ellipsis\" aria-label={m.moreItems(m.num(items.length - maxItems! + 1))}>\n …\n </span>\n ) : last || !item.href ? (\n <span className={slot('sp-breadcrumbs__current', classNames, 'current')} aria-current={last ? 'page' : undefined}>\n {item.icon}\n {item.label}\n </span>\n ) : renderLink ? (\n renderLink({ href: item.href, className: slot('sp-breadcrumbs__link', classNames, 'link'), children: <>{item.icon}{item.label}</> })\n ) : (\n <a href={item.href} className={slot('sp-breadcrumbs__link', classNames, 'link')}>\n {item.icon}\n {item.label}\n </a>\n )}\n {!last && (\n <span className={slot('sp-breadcrumbs__separator', classNames, 'separator')} aria-hidden=\"true\">\n {separator}\n </span>\n )}\n </li>\n );\n })}\n </ol>\n </nav>\n );\n}\n\n/* ------------------------------------------------------------ Pagination */\n\nexport interface PaginationProps {\n /** Current page, 1-based. */\n page?: number;\n defaultPage?: number;\n /** Total pages. */\n count: number;\n onChange?: (page: number) => void;\n /** Pages shown on each side of the current one. Default 1. */\n siblings?: number;\n /** Pages always shown at each end. Default 1. */\n boundaries?: number;\n /** `pages` (default) or `compact` (\"Page 3 of 12\" with arrows, for small screens). */\n variant?: 'pages' | 'compact';\n size?: 'small' | 'medium';\n disabled?: boolean;\n /** Build an href per page to render real links (good for SEO and new tabs). */\n getHref?: (page: number) => string;\n 'aria-label'?: string;\n /** Labels for translation. */\n labels?: { previous?: string; next?: string; page?: (n: number) => string; of?: (page: number, count: number) => string };\n className?: string;\n classNames?: ClassNames<'root' | 'item' | 'ellipsis' | 'summary'>;\n}\n\n/** Page list with ellipses: 1 … 4 5 6 … 20. Exported for custom pagers. */\nexport function paginationRange(page: number, count: number, siblings = 1, boundaries = 1): Array<number | 'ellipsis'> {\n const range = (a: number, b: number) => Array.from({ length: Math.max(0, b - a + 1) }, (_, i) => a + i);\n const total = siblings * 2 + 3 + boundaries * 2;\n if (count <= total) return range(1, count);\n const leftSib = Math.max(page - siblings, boundaries + 1);\n const rightSib = Math.min(page + siblings, count - boundaries);\n const leftDots = leftSib > boundaries + 2;\n const rightDots = rightSib < count - boundaries - 1;\n if (!leftDots && rightDots) return [...range(1, siblings * 2 + boundaries + 2), 'ellipsis', ...range(count - boundaries + 1, count)];\n if (leftDots && !rightDots) return [...range(1, boundaries), 'ellipsis', ...range(count - (siblings * 2 + boundaries + 2) + 1, count)];\n return [...range(1, boundaries), 'ellipsis', ...range(leftSib, rightSib), 'ellipsis', ...range(count - boundaries + 1, count)];\n}\n\nconst Arrow = ({ dir }: { dir: 'left' | 'right' }) => (\n <svg width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" strokeWidth=\"2\" strokeLinecap=\"round\" aria-hidden=\"true\">\n <path d={dir === 'left' ? 'm15 6-6 6 6 6' : 'm9 6 6 6-6 6'} />\n </svg>\n);\n\n/**\n * Pagination: move between pages of results. Previous/next, page numbers\n * with ellipses (1 … 4 5 6 … 20), the current page marked\n * `aria-current=\"page\"`, and real links when `getHref` is given.\n * `variant=\"compact\"` shows \"Page 3 of 12\" for tight spaces.\n *\n * Style hooks: `.sp-pagination[data-size]`, `__item[aria-current]`, `__ellipsis`, `__summary`.\n */\nexport function Pagination(inProps: PaginationProps) {\n const props = useDefaults('Pagination', inProps) as PaginationProps;\n const m = useMessages();\n const { count, siblings = 1, boundaries = 1, variant = 'pages', size = 'medium', disabled, getHref, labels = {}, className, classNames } = props;\n const [inner, setInner] = React.useState(props.defaultPage ?? 1);\n const page = Math.min(Math.max(1, props.page ?? inner), Math.max(1, count));\n const go = (p: number) => {\n if (p < 1 || p > count || p === page) return;\n if (props.page === undefined) setInner(p);\n props.onChange?.(p);\n };\n const pageLabel = labels.page ?? ((n: number) => m.page(m.num(n)));\n const item = (p: number, content: React.ReactNode, label: string, opts: { current?: boolean; off?: boolean } = {}) => {\n const common = {\n className: slot('sp-pagination__item', classNames, 'item'),\n 'aria-label': label,\n 'aria-current': opts.current ? ('page' as const) : undefined,\n };\n if (getHref && !opts.off && !disabled)\n return (\n <a {...common} href={getHref(p)} onClick={(e) => { if (props.onChange) { e.preventDefault(); go(p); } }}>\n {content}\n </a>\n );\n return (\n <button {...common} type=\"button\" disabled={opts.off || disabled} onClick={() => go(p)}>\n {content}\n </button>\n );\n };\n return (\n <nav aria-label={props['aria-label'] ?? m.pagination} className={slot('sp-pagination', classNames, 'root', className)} data-size={size} data-variant={variant}>\n <ul>\n <li>{item(page - 1, <Arrow dir=\"left\" />, labels.previous ?? m.previousPage, { off: page <= 1 })}</li>\n {variant === 'compact' ? (\n <li className={slot('sp-pagination__summary', classNames, 'summary')} aria-live=\"polite\">\n {labels.of ? labels.of(page, count) : m.pageOf(m.num(page), m.num(count))}\n </li>\n ) : (\n paginationRange(page, count, siblings, boundaries).map((p, i) => (\n <li key={p === 'ellipsis' ? `e${i}` : p}>\n {p === 'ellipsis' ? (\n <span className={slot('sp-pagination__ellipsis', classNames, 'ellipsis')} aria-hidden=\"true\">\n …\n </span>\n ) : (\n item(p, m.num(p), pageLabel(p), { current: p === page })\n )}\n </li>\n ))\n )}\n <li>{item(page + 1, <Arrow dir=\"right\" />, labels.next ?? m.nextPage, { off: page >= count })}</li>\n </ul>\n </nav>\n );\n}\n"
18
+ },
19
+ {
20
+ "path": "components/spark-ui/Navigation/index.ts",
21
+ "type": "registry:ui",
22
+ "target": "components/spark-ui/Navigation/index.ts",
23
+ "content": "export { Breadcrumbs, Pagination, paginationRange } from './Navigation';\nexport type { BreadcrumbsProps, BreadcrumbItem, PaginationProps } from './Navigation';\n"
24
+ }
25
+ ]
26
+ }
@@ -0,0 +1,30 @@
1
+ {
2
+ "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
+ "name": "number-field",
4
+ "type": "registry:ui",
5
+ "title": "NumberField",
6
+ "description": "Locale-formatted numbers (₹1,00,000, %, units) with steppers.",
7
+ "dependencies": [
8
+ "react-aria@^3.53.1",
9
+ "react-stately@^3.51.0"
10
+ ],
11
+ "registryDependencies": [
12
+ "@sparkwire/base",
13
+ "@sparkwire/styles",
14
+ "@sparkwire/utils"
15
+ ],
16
+ "files": [
17
+ {
18
+ "path": "components/spark-ui/NumberField/NumberField.tsx",
19
+ "type": "registry:ui",
20
+ "target": "components/spark-ui/NumberField/NumberField.tsx",
21
+ "content": "import React, { useRef } from 'react';\nimport { useButton, useLocale, useNumberField } from 'react-aria';\nimport { useNumberFieldState } from 'react-stately';\nimport type { AriaButtonProps } from 'react-aria';\nimport { InputBase } from '../base/InputBase';\nimport { useDefaults, slot, ClassNames } from '../internal/defaults';\n\nexport interface NumberFieldProps {\n /** Visible label. Use `aria-label` instead if there is no visible label. */\n label?: string;\n 'aria-label'?: string;\n /** Controlled value; `null` when empty. */\n value?: number | null;\n defaultValue?: number | null;\n /** Called with the parsed number (or NaN when cleared) as the value commits. */\n onChange?: (value: number) => void;\n min?: number;\n max?: number;\n /** Step for the buttons and arrow keys. Default 1. */\n step?: number;\n /**\n * How the number looks, in the user's locale: `{ style: 'currency', currency: 'INR' }`,\n * `{ style: 'percent' }`, `{ style: 'unit', unit: 'kilogram' }`, `{ maximumFractionDigits: 2 }`…\n */\n formatOptions?: Intl.NumberFormatOptions;\n placeholder?: string;\n /** Help text under the field (shown in the error colour when `error` is `true`). */\n helperText?: React.ReactNode;\n /** An error message, or `true` to mark the field invalid and show `helperText` as the error. */\n error?: React.ReactNode | boolean;\n disabled?: boolean;\n readOnly?: boolean;\n required?: boolean;\n /** Form field name; submits the plain number (e.g. 100000, not \"₹1,00,000\"). */\n name?: string;\n /** Hide the − / + buttons. */\n hideSteppers?: boolean;\n /** Default `medium`. */\n size?: 'small' | 'medium' | 'large';\n startIcon?: React.ReactNode;\n className?: string;\n /** Extra classes for each part: root, label, field, input, stepper, helper. */\n classNames?: ClassNames<'root' | 'label' | 'field' | 'input' | 'stepper' | 'helper'>;\n}\n\n/**\n * NumberField: a number input that formats as you'd write it in your\n * language (₹1,00,000 in India, $100,000 in the US, 15 %, 2.5 kg). Up/Down\n * and the − / + buttons step; Page Up/Down step by tens; Home/End jump to\n * min/max; values are clamped and snapped to `step` on blur. Built on React\n * Aria's number field and the InputBase base component.\n *\n * Style hooks: `.sp-number-field[data-invalid][data-disabled]`, `__label`,\n * `__stepper`, `__helper`; the field is `.sp-input-base`.\n */\nexport function NumberField(inProps: NumberFieldProps) {\n const {\n label,\n 'aria-label': ariaLabel,\n value,\n defaultValue,\n onChange,\n min,\n max,\n step,\n formatOptions,\n placeholder,\n helperText,\n error,\n disabled,\n readOnly,\n required,\n name,\n hideSteppers,\n size = 'medium',\n startIcon,\n className,\n classNames,\n } = useDefaults('NumberField', inProps);\n const { locale } = useLocale();\n const invalid = Boolean(error);\n const message = typeof error === 'boolean' ? (error ? helperText : undefined) : error;\n const help = typeof error === 'boolean' || !error ? helperText : undefined;\n\n const ariaProps = {\n label,\n 'aria-label': ariaLabel,\n value: value === null ? NaN : value,\n defaultValue: defaultValue === null ? NaN : defaultValue,\n onChange,\n minValue: min,\n maxValue: max,\n step,\n formatOptions,\n placeholder,\n isDisabled: disabled,\n isReadOnly: readOnly,\n isRequired: required,\n isInvalid: invalid,\n validationBehavior: 'aria' as const,\n description: help ? 'description' : undefined,\n errorMessage: invalid && message ? 'error' : undefined,\n };\n const state = useNumberFieldState({ ...ariaProps, locale });\n const inputRef = useRef<HTMLInputElement>(null);\n const { labelProps, groupProps, inputProps, incrementButtonProps, decrementButtonProps, descriptionProps, errorMessageProps } = useNumberField(\n ariaProps,\n state,\n inputRef,\n );\n\n return (\n <div\n className={slot('sp-number-field', classNames, 'root', className)}\n data-tone={invalid ? 'error' : 'brand'}\n data-invalid={invalid || undefined}\n data-disabled={disabled || undefined}\n >\n {label && (\n <label {...labelProps} className={slot('sp-number-field__label', classNames, 'label')}>\n {label}\n {required && (\n <span className=\"sp-field__required\" aria-hidden=\"true\">\n {' '}*\n </span>\n )}\n </label>\n )}\n <div {...groupProps}>\n <InputBase\n {...(inputProps as React.InputHTMLAttributes<HTMLInputElement>)}\n ref={inputRef}\n size={size}\n error={invalid}\n disabled={disabled}\n classNames={{ root: slot('sp-number-field__field', classNames, 'field'), input: slot('sp-number-field__input', classNames, 'input') }}\n startAdornment={startIcon}\n endAdornment={\n hideSteppers ? undefined : (\n <span className=\"sp-number-field__steppers\">\n <Stepper {...decrementButtonProps} kind=\"decrement\" className={classNames?.stepper} />\n <Stepper {...incrementButtonProps} kind=\"increment\" className={classNames?.stepper} />\n </span>\n )\n }\n />\n </div>\n {name && <input type=\"hidden\" name={name} value={Number.isNaN(state.numberValue) ? '' : String(state.numberValue)} />}\n {invalid && message ? (\n <p {...errorMessageProps} className={slot('sp-number-field__helper', classNames, 'helper')}>\n {message}\n </p>\n ) : (\n help && (\n <p {...descriptionProps} className={slot('sp-number-field__helper', classNames, 'helper')}>\n {help}\n </p>\n )\n )}\n </div>\n );\n}\n\nfunction Stepper({ kind, className, ...props }: AriaButtonProps & { kind: 'increment' | 'decrement'; className?: string }) {\n const ref = useRef<HTMLButtonElement>(null);\n const { buttonProps } = useButton(props, ref);\n return (\n <button {...buttonProps} ref={ref} className={slot('sp-field-button sp-number-field__stepper', { stepper: className }, 'stepper')} data-kind={kind}>\n <svg width=\"14\" height=\"14\" viewBox=\"0 0 16 16\" aria-hidden=\"true\">\n <path d={kind === 'increment' ? 'M8 3v10M3 8h10' : 'M3 8h10'} stroke=\"currentColor\" strokeWidth=\"2\" strokeLinecap=\"round\" />\n </svg>\n </button>\n );\n}\n\nexport default NumberField;\n"
22
+ },
23
+ {
24
+ "path": "components/spark-ui/NumberField/index.ts",
25
+ "type": "registry:ui",
26
+ "target": "components/spark-ui/NumberField/index.ts",
27
+ "content": "export { NumberField } from './NumberField';\nexport type { NumberFieldProps } from './NumberField';\n"
28
+ }
29
+ ]
30
+ }
@@ -0,0 +1,47 @@
1
+ {
2
+ "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
+ "name": "provider",
4
+ "type": "registry:ui",
5
+ "title": "SparkProvider",
6
+ "description": "App-wide default props, slot classes and locale.",
7
+ "dependencies": [
8
+ "react-aria@^3.53.1"
9
+ ],
10
+ "registryDependencies": [
11
+ "@sparkwire/accordion",
12
+ "@sparkwire/avatar",
13
+ "@sparkwire/button",
14
+ "@sparkwire/card",
15
+ "@sparkwire/checkbox",
16
+ "@sparkwire/combobox",
17
+ "@sparkwire/date-picker",
18
+ "@sparkwire/dropdown",
19
+ "@sparkwire/field",
20
+ "@sparkwire/indicators",
21
+ "@sparkwire/menu",
22
+ "@sparkwire/modal",
23
+ "@sparkwire/radio-group",
24
+ "@sparkwire/select",
25
+ "@sparkwire/slider",
26
+ "@sparkwire/styles",
27
+ "@sparkwire/switch",
28
+ "@sparkwire/tabs",
29
+ "@sparkwire/textfield",
30
+ "@sparkwire/tooltip",
31
+ "@sparkwire/utils"
32
+ ],
33
+ "files": [
34
+ {
35
+ "path": "components/spark-ui/Provider/SparkProvider.tsx",
36
+ "type": "registry:ui",
37
+ "target": "components/spark-ui/Provider/SparkProvider.tsx",
38
+ "content": "import React, { useContext, useMemo } from 'react';\nimport { MessagesProvider, type SparkMessagesOverride } from '../internal/messages';\nimport { I18nProvider } from 'react-aria';\nimport { DefaultsContext, DefaultsMap, ComponentConfig } from '../internal/defaults';\nimport type { ButtonTypeMap } from '../Button/Button.types';\nimport type { SwitchProps } from '../Switch';\nimport type { CheckboxProps } from '../Checkbox';\nimport type { TextfieldProps } from '../Textfield';\nimport type { SliderProps } from '../Slider';\nimport type { RadioGroupProps } from '../RadioGroup';\nimport type { TabsProps } from '../Tabs';\nimport type { AccordionProps } from '../Accordion';\nimport type { ModalProps } from '../Modal';\nimport type { TooltipProps } from '../Tooltip';\nimport type { CardProps } from '../Card';\nimport type { BadgeProps, ProgressProps, SpinnerProps } from '../Indicators';\nimport type { AvatarProps } from '../Avatar';\nimport type { DatePickerProps, CalendarProps } from '../DatePicker';\nimport type { SelectProps } from '../Select';\nimport type { DropdownProps } from '../Dropdown';\nimport type { ComboboxProps } from '../Combobox';\nimport type { MenuProps } from '../Menu';\nimport type { FieldProps } from '../Field';\n\n/** App-wide defaults, keyed by component name. */\nexport interface SparkComponentsConfig {\n Button?: ComponentConfig<ButtonTypeMap['props']>;\n Switch?: ComponentConfig<SwitchProps>;\n Checkbox?: ComponentConfig<CheckboxProps>;\n Textfield?: ComponentConfig<TextfieldProps>;\n Slider?: ComponentConfig<SliderProps>;\n RadioGroup?: ComponentConfig<RadioGroupProps>;\n Dropdown?: ComponentConfig<DropdownProps>;\n /** Same component as Dropdown; both keys apply. */\n Select?: ComponentConfig<SelectProps>;\n Combobox?: ComponentConfig<ComboboxProps>;\n Menu?: ComponentConfig<MenuProps>;\n DataTable?: ComponentConfig<Record<string, unknown>>;\n DateRangePicker?: ComponentConfig<Record<string, unknown>>;\n CommandPalette?: ComponentConfig<Record<string, unknown>>;\n Drawer?: ComponentConfig<Record<string, unknown>>;\n Sidebar?: ComponentConfig<Record<string, unknown>>;\n NumberField?: ComponentConfig<Record<string, unknown>>;\n Textarea?: ComponentConfig<Record<string, unknown>>;\n Alert?: ComponentConfig<Record<string, unknown>>;\n Breadcrumbs?: ComponentConfig<Record<string, unknown>>;\n Pagination?: ComponentConfig<Record<string, unknown>>;\n ToggleGroup?: ComponentConfig<Record<string, unknown>>;\n Stepper?: ComponentConfig<Record<string, unknown>>;\n FileUpload?: ComponentConfig<Record<string, unknown>>;\n TimePicker?: ComponentConfig<Record<string, unknown>>;\n LineChart?: ComponentConfig<Record<string, unknown>>;\n BarChart?: ComponentConfig<Record<string, unknown>>;\n DonutChart?: ComponentConfig<Record<string, unknown>>;\n Sparkline?: ComponentConfig<Record<string, unknown>>;\n RangeCalendar?: ComponentConfig<Record<string, unknown>>;\n Field?: ComponentConfig<FieldProps>;\n Tabs?: ComponentConfig<TabsProps>;\n Accordion?: ComponentConfig<AccordionProps>;\n Modal?: ComponentConfig<ModalProps>;\n Tooltip?: ComponentConfig<TooltipProps>;\n Card?: ComponentConfig<CardProps>;\n Badge?: ComponentConfig<BadgeProps>;\n Progress?: ComponentConfig<ProgressProps>;\n Spinner?: ComponentConfig<SpinnerProps>;\n Avatar?: ComponentConfig<AvatarProps>;\n DatePicker?: ComponentConfig<DatePickerProps>;\n Calendar?: ComponentConfig<CalendarProps>;\n}\n\nexport interface SparkProviderProps {\n /**\n * Defaults for every instance of a component, e.g.\n * `{ Button: { defaultProps: { variant: 'outlined' } }, Switch: { classNames: { bulb: 'my-bulb' } } }`.\n * Props set on an instance always win.\n */\n components?: SparkComponentsConfig;\n /**\n * BCP 47 locale for dates, number formats and keyboard direction, e.g.\n * `hi-IN`, `ar-EG`, `en-US`. Right-to-left locales mirror arrow keys.\n * Defaults to the parent provider's, then the browser's.\n */\n locale?: string;\n /**\n * How lively the UI is: `calm` (slow current, soft glow, few sparks),\n * `default`, `electric` (fast current, bloom, big bursts) or `off`\n * (no decorative motion). Reduced-motion users always get `off`.\n * Sets `data-spark-energy` on a wrapper; you can also put that\n * attribute on `<html>` yourself.\n */\n energy?: 'off' | 'calm' | 'default' | 'electric';\n /**\n * Override any built-in text, or add a language: `{ close: 'Fermer', page: (n) => `Page ${n}` }`.\n * Hindi, Gujarati and Tamil are built in and follow `locale`.\n */\n messages?: SparkMessagesOverride;\n /** Short vibrations on Switch, Checkbox and spark bursts (phones that support it). Default `false`. */\n haptics?: boolean;\n children: React.ReactNode;\n}\n\n/**\n * SparkProvider: set app-wide defaults and slot class names once, the way\n * MUI's `theme.components` works. Nested providers merge with their parent.\n * Styling still comes from `styles.css`; this provider only changes props.\n */\nexport function SparkProvider({ components, locale, energy, haptics, messages, children }: SparkProviderProps) {\n const parent = useContext(DefaultsContext);\n const value = useMemo<DefaultsMap>(() => {\n if (!components) return parent;\n const next: DefaultsMap = { ...parent };\n for (const [name, cfg] of Object.entries(components) as [string, ComponentConfig][]) {\n const up = parent[name];\n next[name] = {\n defaultProps: { ...up?.defaultProps, ...cfg.defaultProps },\n classNames: { ...up?.classNames, ...cfg.classNames },\n };\n }\n return next;\n }, [parent, components]);\n let tree = <DefaultsContext.Provider value={value}>{children}</DefaultsContext.Provider>;\n if (messages) tree = <MessagesProvider value={messages}>{tree}</MessagesProvider>;\n if (energy !== undefined || haptics !== undefined)\n tree = (\n <div className=\"sp-energy\" data-spark-energy={energy} data-spark-haptics={haptics === undefined ? undefined : haptics ? 'on' : 'off'}>\n {tree}\n </div>\n );\n return locale ? <I18nProvider locale={locale}>{tree}</I18nProvider> : tree;\n}\n\nexport default SparkProvider;\n"
39
+ },
40
+ {
41
+ "path": "components/spark-ui/Provider/index.ts",
42
+ "type": "registry:ui",
43
+ "target": "components/spark-ui/Provider/index.ts",
44
+ "content": "export { SparkProvider } from './SparkProvider';\nexport type { SparkProviderProps, SparkComponentsConfig } from './SparkProvider';\n"
45
+ }
46
+ ]
47
+ }
@@ -0,0 +1,26 @@
1
+ {
2
+ "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
+ "name": "radio-group",
4
+ "type": "registry:ui",
5
+ "title": "RadioGroup",
6
+ "description": "One live wire at a time.",
7
+ "dependencies": [],
8
+ "registryDependencies": [
9
+ "@sparkwire/styles",
10
+ "@sparkwire/utils"
11
+ ],
12
+ "files": [
13
+ {
14
+ "path": "components/spark-ui/RadioGroup/RadioGroup.tsx",
15
+ "type": "registry:ui",
16
+ "target": "components/spark-ui/RadioGroup/RadioGroup.tsx",
17
+ "content": "import React, { useId, useState } from 'react';\nimport { Tone } from '../internal/tone';\nimport { cx } from '../internal/cx';\nimport { useDefaults } from '../internal/defaults';\n\nexport interface RadioOption {\n /** Value submitted and passed to `onChange`. */\n value: string;\n /** Visible label. */\n label: React.ReactNode;\n /** Secondary line under the label. */\n description?: React.ReactNode;\n disabled?: boolean;\n}\n\nexport interface RadioGroupProps {\n /** The group's legend. Required for accessibility. */\n label: React.ReactNode;\n options: RadioOption[];\n /** Controlled value. */\n value?: string;\n /** Initial value when uncontrolled. */\n defaultValue?: string;\n onChange?: (value: string) => void;\n /** Form field name. Generated when omitted. */\n name?: string;\n /** Colour of the chosen contact. Default `brand`. */\n color?: Tone;\n /** `list` stacks options; `cards` lays them out as selectable cards. */\n variant?: 'list' | 'cards';\n /** Help or error text under the group. */\n helperText?: React.ReactNode;\n /** Marks the group invalid. */\n error?: boolean;\n className?: string;\n}\n\n/**\n * RadioGroup: a selector switch. Every option is a contact; only the chosen one\n * carries current, so its core lights up. Native radios underneath, so arrow\n * keys and forms work as expected.\n *\n * Style hooks: `.sp-radio-group`, `__option[data-checked]`, `__dot`, `__text`.\n */\nexport function RadioGroup(inProps: RadioGroupProps) {\n const {\n label,\n options,\n value,\n defaultValue,\n onChange,\n name,\n color = 'brand',\n variant = 'list',\n helperText,\n error,\n className,\n} = useDefaults('RadioGroup', inProps);\n const [inner, setInner] = useState(defaultValue);\n const current = value ?? inner;\n const autoName = useId();\n const groupName = name ?? autoName;\n const helperId = `${groupName}-helper`;\n\n return (\n <fieldset\n className={cx('sp-radio-group', className)}\n data-tone={error ? 'error' : color}\n data-variant={variant}\n data-invalid={error || undefined}\n aria-describedby={helperText ? helperId : undefined}\n >\n <legend className=\"sp-radio-group__legend\">{label}</legend>\n <div className=\"sp-radio-group__options\">\n {options.map((o) => {\n const checked = current === o.value;\n return (\n <label\n key={o.value}\n className=\"sp-radio-group__option\"\n data-checked={checked || undefined}\n data-disabled={o.disabled || undefined}\n >\n <input\n type=\"radio\"\n name={groupName}\n value={o.value}\n checked={checked}\n disabled={o.disabled}\n className=\"sp-radio-group__input\"\n onChange={() => {\n if (value === undefined) setInner(o.value);\n onChange?.(o.value);\n }}\n />\n <span className=\"sp-radio-group__dot\" aria-hidden=\"true\" />\n <span className=\"sp-radio-group__text\">\n <span className=\"sp-radio-group__label\">{o.label}</span>\n {o.description && <span className=\"sp-radio-group__description\">{o.description}</span>}\n </span>\n </label>\n );\n })}\n </div>\n {helperText && (\n <p id={helperId} className=\"sp-radio-group__helper\">\n {helperText}\n </p>\n )}\n </fieldset>\n );\n}\n\nexport default RadioGroup;\n"
18
+ },
19
+ {
20
+ "path": "components/spark-ui/RadioGroup/index.ts",
21
+ "type": "registry:ui",
22
+ "target": "components/spark-ui/RadioGroup/index.ts",
23
+ "content": "export { RadioGroup } from './RadioGroup';\nexport type { RadioGroupProps, RadioOption } from './RadioGroup';\n"
24
+ }
25
+ ]
26
+ }
@@ -0,0 +1,21 @@
1
+ {
2
+ "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
+ "name": "select",
4
+ "type": "registry:ui",
5
+ "title": "Select",
6
+ "description": "Alias of Dropdown.",
7
+ "dependencies": [],
8
+ "registryDependencies": [
9
+ "@sparkwire/dropdown",
10
+ "@sparkwire/styles",
11
+ "@sparkwire/utils"
12
+ ],
13
+ "files": [
14
+ {
15
+ "path": "components/spark-ui/Select/index.ts",
16
+ "type": "registry:ui",
17
+ "target": "components/spark-ui/Select/index.ts",
18
+ "content": "/**\n * `Select` is the same component as `Dropdown`, kept as an alias so both\n * names work. Configure it under `Dropdown` or `Select` in SparkProvider.\n */\nexport { Dropdown as Select } from '../Dropdown/Dropdown';\nexport type { DropdownProps as SelectProps, DropdownOption as SelectOption, DropdownOptionGroup as SelectOptionGroup } from '../Dropdown/Dropdown';\n"
19
+ }
20
+ ]
21
+ }
@@ -0,0 +1,37 @@
1
+ {
2
+ "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
+ "name": "settings",
4
+ "type": "registry:block",
5
+ "title": "Settings",
6
+ "description": "Profile, notifications and appearance tabs with an unsaved-changes save bar.",
7
+ "dependencies": [],
8
+ "registryDependencies": [
9
+ "@sparkwire/avatar",
10
+ "@sparkwire/button",
11
+ "@sparkwire/card",
12
+ "@sparkwire/dropdown",
13
+ "@sparkwire/file-upload",
14
+ "@sparkwire/styles",
15
+ "@sparkwire/switch",
16
+ "@sparkwire/tabs",
17
+ "@sparkwire/textarea",
18
+ "@sparkwire/textfield",
19
+ "@sparkwire/toast",
20
+ "@sparkwire/toggle-group",
21
+ "@sparkwire/utils"
22
+ ],
23
+ "files": [
24
+ {
25
+ "path": "components/spark-ui/blocks/Settings/Settings.tsx",
26
+ "type": "registry:component",
27
+ "target": "components/spark-ui/blocks/Settings/Settings.tsx",
28
+ "content": "import React, { useState } from 'react';\nimport { Tabs, TabList, Tab, TabPanel } from '../../Tabs';\nimport { Card } from '../../Card';\nimport { Textfield } from '../../Textfield';\nimport { Textarea } from '../../Textarea';\nimport { Dropdown } from '../../Dropdown';\nimport { Switch } from '../../Switch';\nimport { Button } from '../../Button';\nimport { Avatar } from '../../Avatar';\nimport { FileUpload } from '../../FileUpload';\nimport { ToggleGroup } from '../../ToggleGroup';\nimport { useToast } from '../../Toast';\n\n/**\n * Settings block: profile, notifications and appearance tabs with a save\n * bar that appears when something changed. Copy with\n * `npx sparkwire add settings` and wire `onSave` to your API.\n */\nexport function Settings({ onSave }: { onSave?: (values: Record<string, unknown>) => void }) {\n const toast = useToast();\n const initial = { name: 'Anmol Mehta', email: 'anmol@example.com', bio: 'Frontend engineer. Building Sparkwire.', language: 'en', email_digest: true, mentions: true, product: false, theme: 'system', energy: 'default' };\n const [v, setV] = useState(initial);\n const set = <K extends keyof typeof initial>(k: K, value: (typeof initial)[K]) => setV((p) => ({ ...p, [k]: value }));\n const dirty = JSON.stringify(v) !== JSON.stringify(initial);\n\n return (\n <div className=\"sp-block-settings\">\n <header className=\"sp-block-header\">\n <div>\n <h1>Settings</h1>\n <p>Manage your profile and how Sparkwire behaves.</p>\n </div>\n </header>\n <Tabs defaultValue=\"profile\">\n <TabList aria-label=\"Settings sections\">\n <Tab value=\"profile\">Profile</Tab>\n <Tab value=\"notifications\">Notifications</Tab>\n <Tab value=\"appearance\">Appearance</Tab>\n </TabList>\n\n <TabPanel value=\"profile\">\n <Card padding=\"large\">\n <div className=\"sp-block-settings__grid\">\n <div className=\"sp-block-settings__avatar\">\n <Avatar name={v.name} size=\"xlarge\" />\n <FileUpload accept=\"image/*\" multiple={false} maxSize={2 * 1024 * 1024} previews={false} prompt=\"Change photo\" />\n </div>\n <div className=\"sp-block-settings__fields\">\n <Textfield label=\"Full name\" name=\"name\" value={v.name} onChange={(e) => set('name', e.target.value)} />\n <Textfield label=\"Email\" name=\"email\" type=\"email\" value={v.email} onChange={(e) => set('email', e.target.value)} />\n <Textarea label=\"Bio\" name=\"bio\" maxLength={160} showCount value={v.bio} onChange={(text) => set('bio', text)} minRows={2} />\n <Dropdown\n label=\"Language\"\n value={v.language}\n onChange={(lang) => set('language', lang)}\n options={[\n { value: 'en', label: 'English' },\n { value: 'hi', label: 'हिन्दी' },\n { value: 'gu', label: 'ગુજરાતી' },\n { value: 'ta', label: 'தமிழ்' },\n ]}\n />\n </div>\n </div>\n </Card>\n </TabPanel>\n\n <TabPanel value=\"notifications\">\n <Card padding=\"large\">\n <div className=\"sp-block-settings__list\">\n <Switch label=\"Weekly email digest\" checked={v.email_digest} onChange={(on) => set('email_digest', on)} />\n <Switch label=\"Mentions and replies\" checked={v.mentions} onChange={(on) => set('mentions', on)} />\n <Switch label=\"Product updates\" checked={v.product} onChange={(on) => set('product', on)} />\n </div>\n </Card>\n </TabPanel>\n\n <TabPanel value=\"appearance\">\n <Card padding=\"large\">\n <div className=\"sp-block-settings__list\">\n <div className=\"sp-block-settings__setting\">\n <span id=\"theme-label\">Theme</span>\n <ToggleGroup aria-labelledby=\"theme-label\" value={v.theme} onChange={(t) => t && set('theme', t)}>\n <ToggleGroup.Item value=\"light\">Light</ToggleGroup.Item>\n <ToggleGroup.Item value=\"dark\">Dark</ToggleGroup.Item>\n <ToggleGroup.Item value=\"system\">System</ToggleGroup.Item>\n </ToggleGroup>\n </div>\n <div className=\"sp-block-settings__setting\">\n <span id=\"energy-label\">Motion</span>\n <ToggleGroup aria-labelledby=\"energy-label\" value={v.energy} onChange={(t) => t && set('energy', t)}>\n <ToggleGroup.Item value=\"off\">Off</ToggleGroup.Item>\n <ToggleGroup.Item value=\"calm\">Calm</ToggleGroup.Item>\n <ToggleGroup.Item value=\"default\">Default</ToggleGroup.Item>\n <ToggleGroup.Item value=\"electric\">Electric</ToggleGroup.Item>\n </ToggleGroup>\n </div>\n </div>\n </Card>\n </TabPanel>\n </Tabs>\n\n {dirty && (\n <div className=\"sp-block-savebar\" role=\"region\" aria-label=\"Unsaved changes\">\n <span>You have unsaved changes.</span>\n <Button variant=\"text\" size=\"small\" onClick={() => setV(initial)}>\n Discard\n </Button>\n <Button\n size=\"small\"\n onClick={() => {\n onSave?.(v);\n toast.toast({ title: 'Settings saved', tone: 'success' });\n }}\n >\n Save changes\n </Button>\n </div>\n )}\n </div>\n );\n}\n"
29
+ },
30
+ {
31
+ "path": "components/spark-ui/blocks/Settings/index.ts",
32
+ "type": "registry:component",
33
+ "target": "components/spark-ui/blocks/Settings/index.ts",
34
+ "content": "export { Settings } from './Settings';\n"
35
+ }
36
+ ]
37
+ }
@@ -0,0 +1,30 @@
1
+ {
2
+ "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
+ "name": "sidebar",
4
+ "type": "registry:ui",
5
+ "title": "Sidebar",
6
+ "description": "App navigation: sections, nested groups, collapsed rail, drawer on small screens.",
7
+ "dependencies": [
8
+ "react-aria@^3.53.1"
9
+ ],
10
+ "registryDependencies": [
11
+ "@sparkwire/drawer",
12
+ "@sparkwire/styles",
13
+ "@sparkwire/tooltip",
14
+ "@sparkwire/utils"
15
+ ],
16
+ "files": [
17
+ {
18
+ "path": "components/spark-ui/Sidebar/Sidebar.tsx",
19
+ "type": "registry:ui",
20
+ "target": "components/spark-ui/Sidebar/Sidebar.tsx",
21
+ "content": "import React, { useEffect, useId, useState } from 'react';\nimport { useMessages } from '../internal/messages';\nimport { useLocale } from 'react-aria';\nimport { Drawer } from '../Drawer';\nimport { Tooltip } from '../Tooltip';\nimport { useDefaults, slot, ClassNames } from '../internal/defaults';\n\nexport interface SidebarItem {\n /** Unique id; `value` / `onChange` use it. */\n id: string;\n label: string;\n icon?: React.ReactNode;\n /** Make the item a link. */\n href?: string;\n /** Called when chosen (after `onChange`). */\n onSelect?: () => void;\n /** Small count or label at the end, e.g. `3` or \"New\". */\n badge?: React.ReactNode;\n disabled?: boolean;\n /** Nested items: the item becomes a group that opens and closes. */\n items?: SidebarItem[];\n}\n\nexport interface SidebarSection {\n /** Heading over the section. */\n heading?: string;\n items: SidebarItem[];\n}\n\nexport interface SidebarProps {\n /** Items, or sections of items with a heading. */\n items: Array<SidebarItem | SidebarSection>;\n /** Active item id (controlled). */\n value?: string;\n defaultValue?: string;\n onChange?: (id: string) => void;\n /** Icon-only rail (desktop). Controlled. */\n collapsed?: boolean;\n defaultCollapsed?: boolean;\n onCollapsedChange?: (collapsed: boolean) => void;\n /** Show the collapse button. Default `true`. */\n collapsible?: boolean;\n /** Top area, e.g. a logo. Receives whether the sidebar is collapsed. */\n header?: React.ReactNode | ((collapsed: boolean) => React.ReactNode);\n /** Bottom area, e.g. the signed-in user. */\n footer?: React.ReactNode | ((collapsed: boolean) => React.ReactNode);\n /** Viewport width (px) below which the sidebar becomes a drawer. Default 768. `0` turns this off. */\n mobileBreakpoint?: number;\n /** Drawer open state on small screens (controlled). Open it from your own menu button. */\n mobileOpen?: boolean;\n onMobileOpenChange?: (open: boolean) => void;\n /** Accessible name of the navigation. Default \"Main\". */\n 'aria-label'?: string;\n className?: string;\n /** Extra classes for each part: root, header, nav, section, heading, item, footer, toggle. */\n classNames?: ClassNames<'root' | 'header' | 'nav' | 'section' | 'heading' | 'item' | 'footer' | 'toggle'>;\n}\n\nconst isSection = (x: SidebarItem | SidebarSection): x is SidebarSection => !(x as SidebarItem).id && Array.isArray(x.items);\n\n/** True below `px` wide. Server render and first paint assume desktop. */\nfunction useNarrow(px: number) {\n const [narrow, setNarrow] = useState(false);\n useEffect(() => {\n if (!px || typeof window === 'undefined' || !window.matchMedia) return;\n const mq = window.matchMedia(`(max-width: ${px - 0.02}px)`);\n const update = () => setNarrow(mq.matches);\n update();\n mq.addEventListener?.('change', update);\n return () => mq.removeEventListener?.('change', update);\n }, [px]);\n return narrow;\n}\n\nconst contains = (item: SidebarItem, id?: string): boolean => !!id && (item.id === id || !!item.items?.some((c) => contains(c, id)));\n\n/**\n * Sidebar: app navigation. Items sit on a wire down the side; the active\n * item is lit. Sections with headings, nested groups that open and close,\n * badges, links (with `aria-current=\"page\"`), a collapsed icon-only rail\n * with tooltips, and a drawer on small screens. A real `<nav>` with lists,\n * so the browser's Tab order and screen-reader navigation just work.\n *\n * Style hooks: `.sp-sidebar[data-collapsed]`, `__header`, `__nav`,\n * `__section`, `__heading`, `__item[data-active][data-open]`, `__badge`,\n * `__toggle`, `__footer`. Widths: `--sp-sidebar-width`, `--sp-sidebar-rail`.\n */\nexport function Sidebar(inProps: SidebarProps) {\n const props = useDefaults('Sidebar', inProps);\n const m = useMessages();\n const { collapsed, defaultCollapsed = false, onCollapsedChange, mobileBreakpoint = 768, mobileOpen = false, onMobileOpenChange, value, defaultValue, onChange } = props;\n const [innerCollapsed, setInnerCollapsed] = useState(defaultCollapsed);\n const isCollapsed = collapsed ?? innerCollapsed;\n const setCollapsed = (v: boolean) => {\n if (collapsed === undefined) setInnerCollapsed(v);\n onCollapsedChange?.(v);\n };\n const [innerValue, setInnerValue] = useState(defaultValue);\n const active = value ?? innerValue;\n const select = (item: SidebarItem) => {\n if (value === undefined) setInnerValue(item.id);\n onChange?.(item.id);\n item.onSelect?.();\n onMobileOpenChange?.(false);\n };\n const narrow = useNarrow(mobileBreakpoint);\n\n if (narrow) {\n return (\n <Drawer open={mobileOpen} onClose={() => onMobileOpenChange?.(false)} placement=\"start\" size=\"small\" aria-label={props['aria-label'] ?? m.mainNavigation} closeButton>\n <SidebarContent {...props} collapsed={false} collapsible={false} active={active} select={select} mobile />\n </Drawer>\n );\n }\n return <SidebarContent {...props} collapsed={isCollapsed} setCollapsed={setCollapsed} active={active} select={select} />;\n}\n\nfunction SidebarContent({\n items,\n collapsed,\n setCollapsed,\n collapsible = true,\n header,\n footer,\n 'aria-label': ariaLabelProp,\n className,\n classNames,\n active,\n select,\n mobile,\n}: SidebarProps & { collapsed: boolean; setCollapsed?: (v: boolean) => void; active?: string; select: (item: SidebarItem) => void; mobile?: boolean }) {\n const { direction } = useLocale();\n const m = useMessages();\n const ariaLabel = ariaLabelProp ?? m.mainNavigation;\n // Consecutive loose items share one heading-less section; sections are copied, never mutated.\n const sections: Array<SidebarSection & { loose?: boolean }> = [];\n for (const x of items) {\n const last = sections[sections.length - 1];\n if (isSection(x)) sections.push({ heading: x.heading, items: x.items });\n else if (last?.loose) last.items = [...last.items, x];\n else sections.push({ items: [x], loose: true });\n }\n const render = (slotContent: SidebarProps['header']) => (typeof slotContent === 'function' ? slotContent(collapsed) : slotContent);\n\n return (\n <aside className={slot('sp-sidebar', classNames, 'root', className)} data-collapsed={collapsed || undefined} data-mobile={mobile || undefined} dir={direction}>\n {header && <div className={slot('sp-sidebar__header', classNames, 'header')}>{render(header)}</div>}\n <nav aria-label={ariaLabel} className={slot('sp-sidebar__nav', classNames, 'nav')}>\n {sections.map((s, i) => (\n <SectionView key={s.heading ?? i} section={s} collapsed={collapsed} active={active} select={select} classNames={classNames} expand={setCollapsed ? () => setCollapsed(false) : undefined} />\n ))}\n </nav>\n {footer && <div className={slot('sp-sidebar__footer', classNames, 'footer')}>{render(footer)}</div>}\n {collapsible && setCollapsed && (\n <button\n type=\"button\"\n className={slot('sp-sidebar__toggle', classNames, 'toggle')}\n aria-label={collapsed ? m.expandSidebar : m.collapseSidebar}\n aria-expanded={!collapsed}\n onClick={() => setCollapsed(!collapsed)}\n >\n <svg width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" aria-hidden=\"true\">\n <path d={collapsed === (direction === 'ltr') ? 'M6 3l5 5-5 5' : 'M10 3L5 8l5 5'} fill=\"none\" stroke=\"currentColor\" strokeWidth=\"2\" strokeLinecap=\"round\" strokeLinejoin=\"round\" />\n </svg>\n </button>\n )}\n </aside>\n );\n}\n\nfunction SectionView({ section, collapsed, active, select, classNames, expand }: { section: SidebarSection; collapsed: boolean; active?: string; select: (i: SidebarItem) => void; classNames?: SidebarProps['classNames']; expand?: () => void }) {\n const headingId = useId();\n return (\n <div className={slot('sp-sidebar__section', classNames, 'section')}>\n {section.heading && (\n <div id={headingId} className={slot('sp-sidebar__heading', classNames, 'heading')} aria-hidden={collapsed || undefined}>\n {section.heading}\n </div>\n )}\n <ul className=\"sp-sidebar__list\" aria-labelledby={section.heading && !collapsed ? headingId : undefined}>\n {section.items.map((item) => (\n <ItemView key={item.id} item={item} depth={0} collapsed={collapsed} active={active} select={select} classNames={classNames} expand={expand} />\n ))}\n </ul>\n </div>\n );\n}\n\nfunction ItemView({ item, depth, collapsed, active, select, classNames, expand }: { item: SidebarItem; depth: number; collapsed: boolean; active?: string; select: (i: SidebarItem) => void; classNames?: SidebarProps['classNames']; expand?: () => void }) {\n const groupId = useId();\n const hasChildren = !!item.items?.length;\n const [open, setOpen] = useState(() => contains(item, active) && hasChildren);\n useEffect(() => {\n if (hasChildren && contains(item, active)) setOpen(true);\n }, [active]); // eslint-disable-line react-hooks/exhaustive-deps\n const isActive = item.id === active;\n const inside = <ItemInner item={item} hasChildren={hasChildren} open={open} />;\n const common = {\n className: slot('sp-sidebar__item', classNames, 'item'),\n 'data-active': isActive || undefined,\n 'data-current-branch': (!isActive && contains(item, active)) || undefined,\n 'data-depth': depth || undefined,\n 'aria-label': collapsed ? item.label : undefined,\n };\n\n let control: React.ReactElement;\n if (hasChildren) {\n control = (\n <button\n type=\"button\"\n {...common}\n aria-expanded={open && !collapsed}\n aria-controls={open && !collapsed ? groupId : undefined}\n disabled={item.disabled}\n onClick={() => {\n // In the icon rail a group can't show its items, so open the sidebar first.\n if (collapsed && expand) {\n expand();\n setOpen(true);\n } else setOpen(!open);\n }}\n data-open={open || undefined}\n >\n {inside}\n </button>\n );\n } else if (item.href && !item.disabled) {\n control = (\n <a {...common} href={item.href} aria-current={isActive ? 'page' : undefined} onClick={() => select(item)}>\n {inside}\n </a>\n );\n } else {\n control = (\n <button type=\"button\" {...common} aria-current={isActive ? 'page' : undefined} disabled={item.disabled} onClick={() => select(item)}>\n {inside}\n </button>\n );\n }\n\n return (\n <li>\n {collapsed && depth === 0 ? (\n <Tooltip title={item.label} placement=\"right\">\n {control}\n </Tooltip>\n ) : (\n control\n )}\n {hasChildren && open && !collapsed && (\n <ul id={groupId} className=\"sp-sidebar__list sp-sidebar__list--nested\">\n {item.items!.map((child) => (\n <ItemView key={child.id} item={child} depth={depth + 1} collapsed={collapsed} active={active} select={select} classNames={classNames} />\n ))}\n </ul>\n )}\n </li>\n );\n}\n\nfunction ItemInner({ item, hasChildren, open }: { item: SidebarItem; hasChildren: boolean; open: boolean }) {\n return (\n <>\n <span className=\"sp-sidebar__icon\" aria-hidden=\"true\">\n {item.icon ?? <span className=\"sp-sidebar__dot\" />}\n </span>\n <span className=\"sp-sidebar__label\">{item.label}</span>\n {item.badge !== undefined && <span className=\"sp-sidebar__badge\">{item.badge}</span>}\n {hasChildren && (\n <svg className=\"sp-sidebar__chevron\" data-open={open || undefined} width=\"14\" height=\"14\" viewBox=\"0 0 16 16\" aria-hidden=\"true\">\n <path d=\"M4 6l4 4 4-4\" fill=\"none\" stroke=\"currentColor\" strokeWidth=\"2\" strokeLinecap=\"round\" strokeLinejoin=\"round\" />\n </svg>\n )}\n </>\n );\n}\n\nexport default Sidebar;\n"
22
+ },
23
+ {
24
+ "path": "components/spark-ui/Sidebar/index.ts",
25
+ "type": "registry:ui",
26
+ "target": "components/spark-ui/Sidebar/index.ts",
27
+ "content": "export { Sidebar } from './Sidebar';\nexport type { SidebarProps, SidebarItem, SidebarSection } from './Sidebar';\n"
28
+ }
29
+ ]
30
+ }
@@ -0,0 +1,31 @@
1
+ {
2
+ "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
+ "name": "sign-in",
4
+ "type": "registry:block",
5
+ "title": "Sign in",
6
+ "description": "Email and password sign-in with validation, remember me, progress and error states.",
7
+ "dependencies": [],
8
+ "registryDependencies": [
9
+ "@sparkwire/alert",
10
+ "@sparkwire/button",
11
+ "@sparkwire/card",
12
+ "@sparkwire/checkbox",
13
+ "@sparkwire/styles",
14
+ "@sparkwire/textfield",
15
+ "@sparkwire/utils"
16
+ ],
17
+ "files": [
18
+ {
19
+ "path": "components/spark-ui/blocks/SignIn/SignIn.tsx",
20
+ "type": "registry:component",
21
+ "target": "components/spark-ui/blocks/SignIn/SignIn.tsx",
22
+ "content": "import React, { useState } from 'react';\nimport { Card } from '../../Card';\nimport { Textfield } from '../../Textfield';\nimport { Checkbox } from '../../Checkbox';\nimport { Button } from '../../Button';\nimport { Alert } from '../../Alert';\n\nexport interface SignInProps {\n /** Return an error message to show it, or nothing on success. */\n onSubmit?: (values: { email: string; password: string; remember: boolean }) => Promise<string | void> | string | void;\n /** Shown above the form. */\n brand?: React.ReactNode;\n}\n\n/**\n * Sign-in block: email and password with validation, \"remember me\", a\n * submit button that shows progress, an error alert, and links to reset\n * the password or sign up. Works as a plain form too (`name` on every\n * field), so server actions can read it. Copy with `npx sparkwire add sign-in`.\n */\nexport function SignIn({ onSubmit, brand = <strong className=\"sp-block-brand\">Sparkwire</strong> }: SignInProps) {\n const [email, setEmail] = useState('');\n const [password, setPassword] = useState('');\n const [remember, setRemember] = useState(true);\n const [touched, setTouched] = useState(false);\n const [busy, setBusy] = useState(false);\n const [error, setError] = useState<string | null>(null);\n const emailError = touched && !/^\\S+@\\S+\\.\\S+$/.test(email) ? 'Enter a valid email address.' : undefined;\n const passwordError = touched && password.length < 8 ? 'Use at least 8 characters.' : undefined;\n\n return (\n <div className=\"sp-block-auth\">\n <Card padding=\"large\" className=\"sp-block-auth__card\">\n <form\n noValidate\n onSubmit={async (e) => {\n e.preventDefault();\n setTouched(true);\n if (!/^\\S+@\\S+\\.\\S+$/.test(email) || password.length < 8) return;\n setBusy(true);\n setError(null);\n const result = await onSubmit?.({ email, password, remember });\n setBusy(false);\n if (typeof result === 'string') setError(result);\n }}\n >\n <div className=\"sp-block-auth__head\">\n {brand}\n <h1>Welcome back</h1>\n <p>Sign in to continue to your dashboard.</p>\n </div>\n {error && (\n <Alert tone=\"error\" onDismiss={() => setError(null)}>\n {error}\n </Alert>\n )}\n <Textfield label=\"Email\" name=\"email\" type=\"email\" autoComplete=\"email\" required value={email} onChange={(e) => setEmail(e.target.value)} error={!!emailError} helperText={emailError} />\n <Textfield label=\"Password\" name=\"password\" type=\"password\" autoComplete=\"current-password\" required value={password} onChange={(e) => setPassword(e.target.value)} error={!!passwordError} helperText={passwordError} />\n <div className=\"sp-block-auth__row\">\n <Checkbox label=\"Remember me\" name=\"remember\" checked={remember} onChange={(e) => setRemember(e.target.checked)} />\n <a href=\"#reset\" className=\"sp-block-link\">Forgot password?</a>\n </div>\n <Button type=\"submit\" fullWidth disabled={busy}>\n {busy ? 'Signing in…' : 'Sign in'}\n </Button>\n <p className=\"sp-block-auth__foot\">\n New here? <a href=\"#signup\" className=\"sp-block-link\">Create an account</a>\n </p>\n </form>\n </Card>\n </div>\n );\n}\n"
23
+ },
24
+ {
25
+ "path": "components/spark-ui/blocks/SignIn/index.ts",
26
+ "type": "registry:component",
27
+ "target": "components/spark-ui/blocks/SignIn/index.ts",
28
+ "content": "export { SignIn } from './SignIn';\nexport type { SignInProps } from './SignIn';\n"
29
+ }
30
+ ]
31
+ }
@@ -0,0 +1,29 @@
1
+ {
2
+ "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
+ "name": "slider",
4
+ "type": "registry:ui",
5
+ "title": "Slider",
6
+ "description": "A dimmer, with two-knob ranges.",
7
+ "dependencies": [
8
+ "react-aria@^3.53.1",
9
+ "react-stately@^3.51.0"
10
+ ],
11
+ "registryDependencies": [
12
+ "@sparkwire/styles",
13
+ "@sparkwire/utils"
14
+ ],
15
+ "files": [
16
+ {
17
+ "path": "components/spark-ui/Slider/Slider.tsx",
18
+ "type": "registry:ui",
19
+ "target": "components/spark-ui/Slider/Slider.tsx",
20
+ "content": "import React, { forwardRef, useRef } from 'react';\nimport { mergeProps, mergeRefs, useFocusRing, useLocale, useNumberFormatter, useSlider, useSliderThumb, VisuallyHidden } from 'react-aria';\nimport { useSliderState, SliderState } from 'react-stately';\nimport { Tone } from '../internal/tone';\nimport { useDefaults, slot, ClassNames } from '../internal/defaults';\n\ntype SliderValue = number | [number, number];\n\nexport interface SliderProps<T extends SliderValue = SliderValue>\n extends Omit<React.InputHTMLAttributes<HTMLInputElement>, 'type' | 'value' | 'defaultValue' | 'onChange' | 'name' | 'min' | 'max' | 'step'> {\n /** Visible label, shown with the current value. */\n label?: React.ReactNode;\n /** Controlled value: a number, or `[start, end]` for a range with two knobs. */\n value?: T;\n /** Initial value when uncontrolled. A `[start, end]` pair makes it a range. Defaults to `min`. */\n defaultValue?: T;\n /** Default 0. */\n min?: number;\n /** Default 100. */\n max?: number;\n /** Default 1. */\n step?: number;\n /** Called on every move with the new value (a number, or `[start, end]`). */\n onChange?: (value: T) => void;\n /** Called once when the user lets go, e.g. to save or fetch. */\n onChangeEnd?: (value: T) => void;\n /** Format each value for the label and for screen readers. */\n formatValue?: (value: number) => string;\n /** Intl number options when `formatValue` isn't set, e.g. `{ style: 'currency', currency: 'INR' }`. */\n formatOptions?: Intl.NumberFormatOptions;\n /** Form field name. For a range, one name (sent twice) or `[startName, endName]`. */\n name?: string | [string, string];\n /** Screen-reader names for the two knobs of a range. Default `['Minimum', 'Maximum']`. */\n thumbLabels?: [string, string];\n /** Default `brand`. */\n color?: Tone;\n /** Extra classes for each part: root, header, label, value, track, fill, thumb. */\n classNames?: ClassNames<'root' | 'header' | 'label' | 'value' | 'track' | 'fill' | 'thumb'>;\n}\n\n/**\n * Slider: a dimmer. The wire is lit up to the knob, and the glow gets stronger\n * the higher you turn it. Pass a `[start, end]` value for a range: current\n * flows between two knobs. Behaviour comes from React Aria: arrows, Page\n * Up/Down, Home/End, dragging, clicking the track, right-to-left, and\n * localized numbers. Each knob holds a native range input, so forms and\n * React Hook Form's `register` work.\n *\n * Style hooks: `.sp-slider[data-range][data-disabled]`, `__header`, `__value`,\n * `__track`, `__fill`, `__thumb[data-dragging][data-focus-visible]`.\n * Variables: `--sp-start`, `--sp-end` and `--sp-pct` (0–100).\n */\nexport const Slider = forwardRef(function Slider(inProps: SliderProps, ref: React.ForwardedRef<HTMLInputElement>) {\n const {\n label,\n value,\n defaultValue,\n min = 0,\n max = 100,\n step = 1,\n onChange,\n onChangeEnd,\n formatValue,\n formatOptions,\n name,\n thumbLabels = ['Minimum', 'Maximum'],\n color = 'brand',\n disabled,\n className,\n style,\n classNames,\n 'aria-label': ariaLabel,\n 'aria-labelledby': ariaLabelledby,\n id,\n ...inputRest\n } = useDefaults('Slider', inProps);\n\n const isRange = Array.isArray(value ?? defaultValue);\n const toArray = (v: SliderValue | undefined) => (v === undefined ? undefined : Array.isArray(v) ? v : [v]);\n const fromArray = (v: number[]): SliderValue => (isRange ? [v[0], v[1]] : v[0]);\n\n const numberFormatter = useNumberFormatter(formatOptions);\n const format = formatValue ?? ((n: number) => numberFormatter.format(n));\n const { direction } = useLocale();\n const trackRef = useRef<HTMLDivElement>(null);\n\n const ariaProps = {\n label,\n 'aria-label': ariaLabel,\n 'aria-labelledby': ariaLabelledby,\n id,\n value: toArray(value),\n defaultValue: toArray(defaultValue) ?? (isRange ? [min, max] : [min]),\n minValue: min,\n maxValue: max,\n step,\n isDisabled: disabled,\n numberFormatter,\n onChange: (v: number | number[]) => onChange?.(fromArray(Array.isArray(v) ? v : [v])),\n onChangeEnd: (v: number | number[]) => onChangeEnd?.(fromArray(Array.isArray(v) ? v : [v])),\n };\n const state = useSliderState(ariaProps);\n const { groupProps, trackProps, labelProps, outputProps } = useSlider(ariaProps, state, trackRef);\n\n const pct = (i: number) => state.getThumbPercent(i) * 100;\n const start = isRange ? pct(0) : 0;\n const end = isRange ? pct(1) : pct(0);\n const shown = state.values.map(format).join(' – ');\n\n return (\n <div\n {...groupProps}\n className={slot('sp-slider', classNames, 'root', className)}\n dir={direction}\n data-tone={color}\n data-range={isRange || undefined}\n data-disabled={disabled || undefined}\n style={{ ...style, '--sp-start': start, '--sp-end': end, '--sp-pct': end } as React.CSSProperties}\n >\n {label && (\n <div className={slot('sp-slider__header', classNames, 'header')}>\n <label {...labelProps} className={slot('sp-slider__label', classNames, 'label')}>\n {label}\n </label>\n <output {...outputProps} className={slot('sp-slider__value', classNames, 'value')}>\n {shown}\n </output>\n </div>\n )}\n <div {...trackProps} ref={trackRef} className={slot('sp-slider__track', classNames, 'track')}>\n <span aria-hidden=\"true\" className={slot('sp-slider__fill sp-current', classNames, 'fill')} />\n {state.values.map((_, i) => (\n <Thumb\n key={i}\n index={i}\n state={state}\n trackRef={trackRef}\n name={Array.isArray(name) ? name[i] : name}\n ariaLabel={isRange ? thumbLabels[i] : undefined}\n valueText={format(state.values[i])}\n className={slot('sp-slider__thumb', classNames, 'thumb')}\n forwardedRef={i === 0 ? ref : undefined}\n inputRest={i === 0 ? inputRest : undefined}\n />\n ))}\n </div>\n </div>\n );\n}) as (<T extends SliderValue = number>(props: SliderProps<T> & { ref?: React.Ref<HTMLInputElement> }) => React.ReactElement) & {\n displayName?: string;\n};\n\nfunction Thumb({\n index,\n state,\n trackRef,\n name,\n ariaLabel,\n valueText,\n className,\n forwardedRef,\n inputRest,\n}: {\n index: number;\n state: SliderState;\n trackRef: React.RefObject<HTMLDivElement>;\n name?: string;\n ariaLabel?: string;\n valueText: string;\n className: string;\n forwardedRef?: React.ForwardedRef<HTMLInputElement>;\n inputRest?: React.InputHTMLAttributes<HTMLInputElement>;\n}) {\n const inputRef = useRef<HTMLInputElement>(null);\n const { thumbProps, inputProps, isDragging } = useSliderThumb({ index, trackRef, inputRef, name, 'aria-label': ariaLabel }, state);\n const { focusProps, isFocusVisible } = useFocusRing();\n return (\n <div {...thumbProps} className={className} data-dragging={isDragging || undefined} data-focus-visible={isFocusVisible || undefined}>\n <VisuallyHidden>\n <input\n {...mergeProps(inputRest ?? {}, inputProps, focusProps)}\n aria-valuetext={valueText}\n ref={(forwardedRef ? mergeRefs(inputRef, forwardedRef) : inputRef) as React.Ref<HTMLInputElement>}\n />\n </VisuallyHidden>\n </div>\n );\n}\n\nSlider.displayName = 'Slider';\nexport default Slider;\n"
21
+ },
22
+ {
23
+ "path": "components/spark-ui/Slider/index.ts",
24
+ "type": "registry:ui",
25
+ "target": "components/spark-ui/Slider/index.ts",
26
+ "content": "export { Slider } from './Slider';\nexport type { SliderProps } from './Slider';\n"
27
+ }
28
+ ]
29
+ }