decantr 0.9.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 (382) hide show
  1. package/AGENTS.md +868 -0
  2. package/CHANGELOG.md +255 -0
  3. package/CLAUDE.md +178 -0
  4. package/LICENSE +21 -0
  5. package/README.md +229 -0
  6. package/cli/art.js +127 -0
  7. package/cli/commands/a11y.js +61 -0
  8. package/cli/commands/audit.js +225 -0
  9. package/cli/commands/build.js +38 -0
  10. package/cli/commands/dev.js +18 -0
  11. package/cli/commands/doctor.js +197 -0
  12. package/cli/commands/figma-sync.js +48 -0
  13. package/cli/commands/figma-tokens.js +55 -0
  14. package/cli/commands/generate.js +26 -0
  15. package/cli/commands/init.js +116 -0
  16. package/cli/commands/lint.js +209 -0
  17. package/cli/commands/mcp.js +530 -0
  18. package/cli/commands/migrate.js +175 -0
  19. package/cli/commands/test.js +38 -0
  20. package/cli/commands/validate.js +354 -0
  21. package/cli/index.js +113 -0
  22. package/package.json +95 -0
  23. package/reference/atoms.md +517 -0
  24. package/reference/behaviors.md +384 -0
  25. package/reference/build-tooling.md +275 -0
  26. package/reference/color-guidelines.md +965 -0
  27. package/reference/component-lifecycle.md +137 -0
  28. package/reference/compound-spacing.md +95 -0
  29. package/reference/decantation-process.md +499 -0
  30. package/reference/dev-server-routes.md +93 -0
  31. package/reference/form-system.md +253 -0
  32. package/reference/i18n.md +336 -0
  33. package/reference/icons.md +576 -0
  34. package/reference/llm-primer.md +953 -0
  35. package/reference/plugins.md +252 -0
  36. package/reference/registry-consumption.md +76 -0
  37. package/reference/router.md +217 -0
  38. package/reference/shells.md +116 -0
  39. package/reference/spatial-guidelines.md +541 -0
  40. package/reference/ssr.md +234 -0
  41. package/reference/state-data.md +215 -0
  42. package/reference/state-patterns.md +166 -0
  43. package/reference/state.md +194 -0
  44. package/reference/style-system.md +110 -0
  45. package/reference/tokens.md +460 -0
  46. package/src/app.js +19 -0
  47. package/src/chart/_animate.js +266 -0
  48. package/src/chart/_base.js +109 -0
  49. package/src/chart/_data.js +209 -0
  50. package/src/chart/_format.js +106 -0
  51. package/src/chart/_interact.js +364 -0
  52. package/src/chart/_palette.js +105 -0
  53. package/src/chart/_renderer.js +52 -0
  54. package/src/chart/_scene.js +262 -0
  55. package/src/chart/_shared.js +371 -0
  56. package/src/chart/index.js +637 -0
  57. package/src/chart/layouts/_layout-base.js +328 -0
  58. package/src/chart/layouts/cartesian.js +148 -0
  59. package/src/chart/layouts/hierarchy.js +562 -0
  60. package/src/chart/layouts/polar.js +101 -0
  61. package/src/chart/renderers/canvas.js +179 -0
  62. package/src/chart/renderers/svg.js +256 -0
  63. package/src/chart/renderers/webgpu.js +715 -0
  64. package/src/chart/types/_type-base.js +26 -0
  65. package/src/chart/types/area.js +134 -0
  66. package/src/chart/types/bar.js +173 -0
  67. package/src/chart/types/box-plot.js +125 -0
  68. package/src/chart/types/bubble.js +63 -0
  69. package/src/chart/types/candlestick.js +115 -0
  70. package/src/chart/types/chord.js +85 -0
  71. package/src/chart/types/combination.js +108 -0
  72. package/src/chart/types/funnel.js +68 -0
  73. package/src/chart/types/gauge.js +163 -0
  74. package/src/chart/types/heatmap.js +98 -0
  75. package/src/chart/types/histogram.js +71 -0
  76. package/src/chart/types/line.js +111 -0
  77. package/src/chart/types/org-chart.js +93 -0
  78. package/src/chart/types/pie.js +81 -0
  79. package/src/chart/types/radar.js +96 -0
  80. package/src/chart/types/radial.js +68 -0
  81. package/src/chart/types/range-area.js +55 -0
  82. package/src/chart/types/range-bar.js +61 -0
  83. package/src/chart/types/sankey.js +73 -0
  84. package/src/chart/types/scatter.js +66 -0
  85. package/src/chart/types/sparkline.js +81 -0
  86. package/src/chart/types/sunburst.js +69 -0
  87. package/src/chart/types/swimlane.js +88 -0
  88. package/src/chart/types/treemap.js +62 -0
  89. package/src/chart/types/waterfall.js +100 -0
  90. package/src/components/_base.js +1658 -0
  91. package/src/components/_behaviors.js +1140 -0
  92. package/src/components/_primitives.js +534 -0
  93. package/src/components/_qr-encoder.js +539 -0
  94. package/src/components/accordion.js +207 -0
  95. package/src/components/affix.js +62 -0
  96. package/src/components/alert-dialog.js +75 -0
  97. package/src/components/alert.js +47 -0
  98. package/src/components/aspect-ratio.js +24 -0
  99. package/src/components/avatar-group.js +55 -0
  100. package/src/components/avatar.js +38 -0
  101. package/src/components/back-top.js +75 -0
  102. package/src/components/badge.js +74 -0
  103. package/src/components/banner.js +68 -0
  104. package/src/components/breadcrumb.js +162 -0
  105. package/src/components/button.js +115 -0
  106. package/src/components/calendar.js +131 -0
  107. package/src/components/card.js +192 -0
  108. package/src/components/carousel.js +98 -0
  109. package/src/components/cascader.js +261 -0
  110. package/src/components/checkbox.js +80 -0
  111. package/src/components/chip.js +81 -0
  112. package/src/components/code-block.js +82 -0
  113. package/src/components/collapsible.js +50 -0
  114. package/src/components/color-palette.js +438 -0
  115. package/src/components/color-picker.js +314 -0
  116. package/src/components/combobox.js +181 -0
  117. package/src/components/command.js +174 -0
  118. package/src/components/comment.js +206 -0
  119. package/src/components/context-menu.js +76 -0
  120. package/src/components/data-table.js +724 -0
  121. package/src/components/date-picker.js +217 -0
  122. package/src/components/date-range-picker.js +244 -0
  123. package/src/components/datetime-picker.js +271 -0
  124. package/src/components/descriptions.js +68 -0
  125. package/src/components/drawer.js +179 -0
  126. package/src/components/dropdown.js +88 -0
  127. package/src/components/empty.js +41 -0
  128. package/src/components/float-button.js +90 -0
  129. package/src/components/form.js +106 -0
  130. package/src/components/hover-card.js +49 -0
  131. package/src/components/icon.js +87 -0
  132. package/src/components/image.js +97 -0
  133. package/src/components/index.js +117 -0
  134. package/src/components/input-group.js +75 -0
  135. package/src/components/input-number.js +155 -0
  136. package/src/components/input-otp.js +178 -0
  137. package/src/components/input.js +91 -0
  138. package/src/components/kbd.js +36 -0
  139. package/src/components/label.js +25 -0
  140. package/src/components/list.js +118 -0
  141. package/src/components/masked-input.js +236 -0
  142. package/src/components/mentions.js +165 -0
  143. package/src/components/menu.js +259 -0
  144. package/src/components/message.js +80 -0
  145. package/src/components/modal.js +147 -0
  146. package/src/components/navigation-menu.js +166 -0
  147. package/src/components/notification.js +84 -0
  148. package/src/components/pagination.js +104 -0
  149. package/src/components/placeholder.js +132 -0
  150. package/src/components/popconfirm.js +70 -0
  151. package/src/components/popover.js +58 -0
  152. package/src/components/progress.js +61 -0
  153. package/src/components/qrcode.js +251 -0
  154. package/src/components/radiogroup.js +120 -0
  155. package/src/components/range-slider.js +176 -0
  156. package/src/components/rate.js +186 -0
  157. package/src/components/resizable.js +83 -0
  158. package/src/components/result.js +57 -0
  159. package/src/components/scroll-area.js +43 -0
  160. package/src/components/segmented.js +97 -0
  161. package/src/components/select.js +165 -0
  162. package/src/components/separator.js +31 -0
  163. package/src/components/shell.js +407 -0
  164. package/src/components/skeleton.js +39 -0
  165. package/src/components/slider.js +141 -0
  166. package/src/components/sortable-list.js +176 -0
  167. package/src/components/space.js +42 -0
  168. package/src/components/spinner.js +112 -0
  169. package/src/components/splitter.js +147 -0
  170. package/src/components/statistic.js +136 -0
  171. package/src/components/steps.js +99 -0
  172. package/src/components/switch.js +95 -0
  173. package/src/components/table.js +44 -0
  174. package/src/components/tabs.js +216 -0
  175. package/src/components/tag.js +115 -0
  176. package/src/components/textarea.js +82 -0
  177. package/src/components/time-picker.js +153 -0
  178. package/src/components/time-range-picker.js +170 -0
  179. package/src/components/timeline.js +226 -0
  180. package/src/components/toast.js +71 -0
  181. package/src/components/toggle.js +213 -0
  182. package/src/components/tooltip.js +57 -0
  183. package/src/components/tour.js +159 -0
  184. package/src/components/transfer.js +163 -0
  185. package/src/components/tree-select.js +274 -0
  186. package/src/components/tree.js +141 -0
  187. package/src/components/typography.js +136 -0
  188. package/src/components/upload.js +118 -0
  189. package/src/components/visually-hidden.js +20 -0
  190. package/src/components/watermark.js +124 -0
  191. package/src/core/index.js +539 -0
  192. package/src/core/lifecycle.js +69 -0
  193. package/src/css/atoms.js +651 -0
  194. package/src/css/components.js +940 -0
  195. package/src/css/derive.js +1296 -0
  196. package/src/css/index.js +265 -0
  197. package/src/css/runtime.js +268 -0
  198. package/src/css/styles/addons/bioluminescent.js +93 -0
  199. package/src/css/styles/addons/clay.js +70 -0
  200. package/src/css/styles/addons/clean.js +57 -0
  201. package/src/css/styles/addons/command-center.js +143 -0
  202. package/src/css/styles/addons/dopamine.js +83 -0
  203. package/src/css/styles/addons/editorial.js +80 -0
  204. package/src/css/styles/addons/glassmorphism.js +99 -0
  205. package/src/css/styles/addons/liquid-glass.js +105 -0
  206. package/src/css/styles/addons/prismatic.js +100 -0
  207. package/src/css/styles/addons/retro.js +63 -0
  208. package/src/css/styles/auradecantism.js +96 -0
  209. package/src/css/theme-registry.js +444 -0
  210. package/src/data/entity.js +281 -0
  211. package/src/data/index.js +13 -0
  212. package/src/data/persist.js +225 -0
  213. package/src/data/query.js +839 -0
  214. package/src/data/realtime.js +299 -0
  215. package/src/data/url.js +177 -0
  216. package/src/data/worker.js +134 -0
  217. package/src/explorer/archetypes.js +243 -0
  218. package/src/explorer/atoms.js +228 -0
  219. package/src/explorer/charts.js +497 -0
  220. package/src/explorer/components.js +129 -0
  221. package/src/explorer/foundations.js +949 -0
  222. package/src/explorer/icons.js +178 -0
  223. package/src/explorer/patterns.js +247 -0
  224. package/src/explorer/recipes.js +194 -0
  225. package/src/explorer/shared/pattern-examples.js +1337 -0
  226. package/src/explorer/shared/showcase-renderer.js +958 -0
  227. package/src/explorer/shared/spec-table.js +41 -0
  228. package/src/explorer/shared/usage-links.js +87 -0
  229. package/src/explorer/shell-config.js +10 -0
  230. package/src/explorer/shells.js +551 -0
  231. package/src/explorer/styles.js +161 -0
  232. package/src/explorer/tokens.js +262 -0
  233. package/src/explorer/tools.js +525 -0
  234. package/src/form/index.js +804 -0
  235. package/src/i18n/index.js +251 -0
  236. package/src/icons/essential.js +479 -0
  237. package/src/icons/index.js +53 -0
  238. package/src/plugins/index.js +282 -0
  239. package/src/registry/archetypes/content-site.json +71 -0
  240. package/src/registry/archetypes/docs-explorer.json +23 -0
  241. package/src/registry/archetypes/ecommerce.json +104 -0
  242. package/src/registry/archetypes/financial-dashboard.json +77 -0
  243. package/src/registry/archetypes/index.json +41 -0
  244. package/src/registry/archetypes/portfolio.json +82 -0
  245. package/src/registry/archetypes/recipe-community.json +159 -0
  246. package/src/registry/archetypes/saas-dashboard.json +86 -0
  247. package/src/registry/architect/cross-cutting.json +45 -0
  248. package/src/registry/architect/domains/ecommerce.json +294 -0
  249. package/src/registry/architect/domains/financial-services.json +302 -0
  250. package/src/registry/architect/index.json +26 -0
  251. package/src/registry/architect/traits.json +379 -0
  252. package/src/registry/atoms.json +16 -0
  253. package/src/registry/chart-showcase.json +160 -0
  254. package/src/registry/chart.json +136 -0
  255. package/src/registry/components.json +8616 -0
  256. package/src/registry/core.json +216 -0
  257. package/src/registry/css.json +319 -0
  258. package/src/registry/data.json +135 -0
  259. package/src/registry/foundations.json +11 -0
  260. package/src/registry/icons.json +463 -0
  261. package/src/registry/index.json +101 -0
  262. package/src/registry/patterns/activity-feed.json +37 -0
  263. package/src/registry/patterns/article-content.json +27 -0
  264. package/src/registry/patterns/auth-form.json +37 -0
  265. package/src/registry/patterns/author-card.json +20 -0
  266. package/src/registry/patterns/card-grid.json +127 -0
  267. package/src/registry/patterns/category-nav.json +26 -0
  268. package/src/registry/patterns/chart-grid.json +36 -0
  269. package/src/registry/patterns/chat-interface.json +37 -0
  270. package/src/registry/patterns/checklist-card.json +55 -0
  271. package/src/registry/patterns/comparison-panel.json +27 -0
  272. package/src/registry/patterns/component-showcase.json +24 -0
  273. package/src/registry/patterns/contact-form.json +31 -0
  274. package/src/registry/patterns/cta-section.json +20 -0
  275. package/src/registry/patterns/data-table.json +37 -0
  276. package/src/registry/patterns/detail-header.json +83 -0
  277. package/src/registry/patterns/detail-panel.json +27 -0
  278. package/src/registry/patterns/explorer-shell.json +22 -0
  279. package/src/registry/patterns/filter-bar.json +33 -0
  280. package/src/registry/patterns/filter-sidebar.json +27 -0
  281. package/src/registry/patterns/form-sections.json +110 -0
  282. package/src/registry/patterns/goal-tracker.json +27 -0
  283. package/src/registry/patterns/hero.json +107 -0
  284. package/src/registry/patterns/index.json +47 -0
  285. package/src/registry/patterns/kpi-grid.json +36 -0
  286. package/src/registry/patterns/media-gallery.json +20 -0
  287. package/src/registry/patterns/order-history.json +20 -0
  288. package/src/registry/patterns/pagination.json +19 -0
  289. package/src/registry/patterns/photo-to-recipe.json +36 -0
  290. package/src/registry/patterns/pipeline-tracker.json +28 -0
  291. package/src/registry/patterns/post-list.json +27 -0
  292. package/src/registry/patterns/pricing-table.json +32 -0
  293. package/src/registry/patterns/scorecard.json +28 -0
  294. package/src/registry/patterns/search-bar.json +20 -0
  295. package/src/registry/patterns/specimen-grid.json +19 -0
  296. package/src/registry/patterns/stat-card.json +55 -0
  297. package/src/registry/patterns/stats-bar.json +55 -0
  298. package/src/registry/patterns/steps-card.json +55 -0
  299. package/src/registry/patterns/table-of-contents.json +19 -0
  300. package/src/registry/patterns/testimonials.json +21 -0
  301. package/src/registry/patterns/timeline.json +27 -0
  302. package/src/registry/patterns/token-inspector.json +21 -0
  303. package/src/registry/patterns/wizard.json +27 -0
  304. package/src/registry/recipe-auradecantism.json +69 -0
  305. package/src/registry/recipe-clean.json +65 -0
  306. package/src/registry/recipe-command-center.json +78 -0
  307. package/src/registry/router.json +73 -0
  308. package/src/registry/schema/README.md +197 -0
  309. package/src/registry/skeletons.json +259 -0
  310. package/src/registry/state.json +137 -0
  311. package/src/registry/tokens.json +40 -0
  312. package/src/router/hash.js +17 -0
  313. package/src/router/history.js +18 -0
  314. package/src/router/index.js +598 -0
  315. package/src/ssr/index.js +922 -0
  316. package/src/state/arrays.js +181 -0
  317. package/src/state/devtools.js +647 -0
  318. package/src/state/index.js +498 -0
  319. package/src/state/middleware.js +288 -0
  320. package/src/state/scheduler.js +206 -0
  321. package/src/state/store.js +300 -0
  322. package/src/tags/index.js +19 -0
  323. package/src/tannins/auth.js +396 -0
  324. package/src/test/dom.js +352 -0
  325. package/src/test/index.js +62 -0
  326. package/src/test/state.js +306 -0
  327. package/tools/a11y-audit.js +487 -0
  328. package/tools/analyzer.js +315 -0
  329. package/tools/audit.js +706 -0
  330. package/tools/builder.js +1422 -0
  331. package/tools/css-extract.js +188 -0
  332. package/tools/dev-server.js +316 -0
  333. package/tools/dts-gen.js +1260 -0
  334. package/tools/figma-components.js +329 -0
  335. package/tools/figma-patterns.js +516 -0
  336. package/tools/figma-plugin/code.js +453 -0
  337. package/tools/figma-plugin/manifest.json +14 -0
  338. package/tools/figma-plugin/ui.html +268 -0
  339. package/tools/figma-render.js +293 -0
  340. package/tools/figma-tokens.js +712 -0
  341. package/tools/figma-upload.js +318 -0
  342. package/tools/generate.js +738 -0
  343. package/tools/icons.js +133 -0
  344. package/tools/init-templates.js +265 -0
  345. package/tools/install-hooks.sh +5 -0
  346. package/tools/migrations/0.5.0.js +53 -0
  347. package/tools/migrations/0.6.0.js +95 -0
  348. package/tools/minify.js +170 -0
  349. package/tools/pre-commit +4 -0
  350. package/tools/registry.js +662 -0
  351. package/tools/reset-playground.js +61 -0
  352. package/tools/starter-templates/content-site/app.js +49 -0
  353. package/tools/starter-templates/content-site/essence.js +19 -0
  354. package/tools/starter-templates/content-site/pages.js +31 -0
  355. package/tools/starter-templates/ecommerce/app.js +50 -0
  356. package/tools/starter-templates/ecommerce/essence.js +19 -0
  357. package/tools/starter-templates/ecommerce/pages.js +31 -0
  358. package/tools/starter-templates/landing-page/app.js +38 -0
  359. package/tools/starter-templates/landing-page/essence.js +18 -0
  360. package/tools/starter-templates/landing-page/pages.js +21 -0
  361. package/tools/starter-templates/portfolio/app.js +45 -0
  362. package/tools/starter-templates/portfolio/essence.js +19 -0
  363. package/tools/starter-templates/portfolio/pages.js +33 -0
  364. package/tools/starter-templates/saas-dashboard/app.js +70 -0
  365. package/tools/starter-templates/saas-dashboard/essence.js +19 -0
  366. package/tools/starter-templates/saas-dashboard/pages.js +31 -0
  367. package/tools/verify-pack.js +203 -0
  368. package/types/chart.d.ts +77 -0
  369. package/types/components.d.ts +587 -0
  370. package/types/core.d.ts +89 -0
  371. package/types/css.d.ts +149 -0
  372. package/types/data.d.ts +238 -0
  373. package/types/form.d.ts +164 -0
  374. package/types/i18n.d.ts +51 -0
  375. package/types/icons.d.ts +27 -0
  376. package/types/index.d.ts +13 -0
  377. package/types/router.d.ts +116 -0
  378. package/types/ssr.d.ts +102 -0
  379. package/types/state.d.ts +83 -0
  380. package/types/tags.d.ts +62 -0
  381. package/types/tannins.d.ts +63 -0
  382. package/types/test.d.ts +48 -0
@@ -0,0 +1,68 @@
1
+ /**
2
+ * Banner — Full-width announcement bar for cookie consent, maintenance notices, promotions.
3
+ * Optionally sticky to top or bottom of viewport.
4
+ *
5
+ * @module decantr/components/banner
6
+ */
7
+ import { h } from '../core/index.js';
8
+ import { injectBase, cx } from './_base.js';
9
+
10
+ /**
11
+ * @param {Object} [props]
12
+ * @param {'info'|'success'|'warning'|'error'} [props.variant='info']
13
+ * @param {boolean} [props.dismissible=false]
14
+ * @param {Function} [props.onDismiss]
15
+ * @param {'top'|'bottom'|false} [props.sticky=false] - Sticky position
16
+ * @param {string|Node} [props.icon]
17
+ * @param {string|Node} [props.action] - Action slot (button/link)
18
+ * @param {string} [props.class]
19
+ * @param {...(string|Node)} children
20
+ * @returns {HTMLElement}
21
+ */
22
+ export function Banner(props = {}, ...children) {
23
+ injectBase();
24
+
25
+ const { variant = 'info', dismissible = false, onDismiss, sticky = false, icon, action, class: cls } = props;
26
+
27
+ const bannerClass = cx(
28
+ 'd-banner',
29
+ `d-banner-${variant}`,
30
+ sticky === 'top' && 'd-banner-sticky-top',
31
+ sticky === 'bottom' && 'd-banner-sticky-bottom',
32
+ cls
33
+ );
34
+
35
+ const el = h('div', { class: bannerClass, role: 'banner' });
36
+
37
+ if (icon) {
38
+ const iconEl = typeof icon === 'string'
39
+ ? h('span', { class: 'd-banner-icon', 'aria-hidden': 'true' }, icon)
40
+ : h('span', { class: 'd-banner-icon', 'aria-hidden': 'true' }, icon);
41
+ el.appendChild(iconEl);
42
+ }
43
+
44
+ const body = h('div', { class: 'd-banner-body' }, ...children);
45
+ el.appendChild(body);
46
+
47
+ if (action) {
48
+ const actionEl = h('div', { class: 'd-banner-action' },
49
+ typeof action === 'string' ? h('span', null, action) : action
50
+ );
51
+ el.appendChild(actionEl);
52
+ }
53
+
54
+ if (dismissible) {
55
+ const closeBtn = h('button', {
56
+ class: 'd-banner-dismiss',
57
+ 'aria-label': 'Dismiss banner',
58
+ type: 'button'
59
+ }, '\u00d7');
60
+ closeBtn.addEventListener('click', () => {
61
+ el.remove();
62
+ if (onDismiss) onDismiss();
63
+ });
64
+ el.appendChild(closeBtn);
65
+ }
66
+
67
+ return el;
68
+ }
@@ -0,0 +1,162 @@
1
+ import { onDestroy } from '../core/index.js';
2
+ import { tags } from '../tags/index.js';
3
+ import { injectBase, cx } from './_base.js';
4
+ import { icon } from './icon.js';
5
+ import { createOverlay, createListbox } from './_behaviors.js';
6
+
7
+ const { nav: navTag, ol, li, span, button: buttonTag, a } = tags;
8
+
9
+ /**
10
+ * @param {Object} [props]
11
+ * @param {{ label: string, href?: string, onclick?: Function, icon?: string, disabled?: boolean }[]} props.items
12
+ * @param {'chevron'|'slash'|'dot'|string|HTMLElement} [props.separator] - Separator type (default: 'chevron')
13
+ * @param {'sm'|'lg'} [props.size] - Size variant
14
+ * @param {number} [props.maxItems] - Collapse middle items into ellipsis dropdown
15
+ * @param {string} [props.class]
16
+ * @returns {HTMLElement}
17
+ */
18
+ export function Breadcrumb(props = {}) {
19
+ injectBase();
20
+
21
+ const { items = [], separator = 'chevron', size, maxItems, class: cls } = props;
22
+
23
+ const nav = navTag({
24
+ class: cx('d-breadcrumb', size && `d-breadcrumb-${size}`, cls),
25
+ 'aria-label': 'Breadcrumb'
26
+ });
27
+ const list = ol({ class: 'd-breadcrumb-list' });
28
+
29
+ function renderSeparator() {
30
+ const sep = span({ class: 'd-breadcrumb-separator', 'aria-hidden': 'true' });
31
+ if (separator === 'chevron') {
32
+ sep.appendChild(icon('chevron-right', { size: '1em' }));
33
+ } else if (separator === 'slash') {
34
+ sep.textContent = '/';
35
+ } else if (separator === 'dot') {
36
+ sep.textContent = '\u00B7';
37
+ } else if (typeof separator === 'object' && separator.nodeType === 1) {
38
+ sep.appendChild(separator.cloneNode(true));
39
+ } else {
40
+ sep.textContent = separator;
41
+ }
42
+ return sep;
43
+ }
44
+
45
+ function renderIcon(name) {
46
+ return icon(name, { size: '1em', class: 'd-breadcrumb-icon' });
47
+ }
48
+
49
+ function renderItem(item, isLast) {
50
+ const el = li({ class: 'd-breadcrumb-item' });
51
+
52
+ if (isLast) {
53
+ const cur = span({ class: 'd-breadcrumb-current', 'aria-current': 'page' });
54
+ if (item.icon) cur.appendChild(renderIcon(item.icon));
55
+ cur.appendChild(document.createTextNode(item.label));
56
+ el.appendChild(cur);
57
+ } else if (item.disabled) {
58
+ const s = span({ class: 'd-breadcrumb-link d-breadcrumb-link-disabled', 'aria-disabled': 'true' });
59
+ if (item.icon) s.appendChild(renderIcon(item.icon));
60
+ s.appendChild(document.createTextNode(item.label));
61
+ el.appendChild(s);
62
+ el.appendChild(renderSeparator());
63
+ } else if (item.href) {
64
+ const link = a({ class: 'd-breadcrumb-link', href: item.href });
65
+ if (item.icon) link.appendChild(renderIcon(item.icon));
66
+ link.appendChild(document.createTextNode(item.label));
67
+ el.appendChild(link);
68
+ el.appendChild(renderSeparator());
69
+ } else {
70
+ const linkProps = { class: 'd-breadcrumb-link' };
71
+ if (item.onclick) linkProps.onclick = item.onclick;
72
+ const btn = buttonTag(linkProps);
73
+ if (item.icon) btn.appendChild(renderIcon(item.icon));
74
+ btn.appendChild(document.createTextNode(item.label));
75
+ el.appendChild(btn);
76
+ el.appendChild(renderSeparator());
77
+ }
78
+
79
+ return el;
80
+ }
81
+
82
+ // Determine visible items and whether to collapse
83
+ const shouldCollapse = maxItems && maxItems > 1 && items.length > maxItems;
84
+
85
+ if (shouldCollapse) {
86
+ const firstItems = items.slice(0, 1);
87
+ const hiddenItems = items.slice(1, items.length - (maxItems - 1));
88
+ const lastItems = items.slice(items.length - (maxItems - 1));
89
+
90
+ // Render first item
91
+ firstItems.forEach(item => list.appendChild(renderItem(item, false)));
92
+
93
+ // Render ellipsis collapse
94
+ const collapseWrap = li({ class: 'd-breadcrumb-item' });
95
+ const collapseInner = span({ class: 'd-breadcrumb-collapse' });
96
+
97
+ const ellipsisBtn = buttonTag({
98
+ class: 'd-breadcrumb-ellipsis',
99
+ 'aria-haspopup': 'menu',
100
+ 'aria-label': 'Show more breadcrumbs'
101
+ });
102
+ ellipsisBtn.appendChild(icon('more-horizontal', { size: '1em' }));
103
+
104
+ const menu = span({
105
+ class: 'd-breadcrumb-menu',
106
+ role: 'menu'
107
+ });
108
+ menu.style.display = 'none';
109
+
110
+ hiddenItems.forEach(item => {
111
+ const menuItem = item.href
112
+ ? a({ class: 'd-dropdown-item', href: item.href, role: 'menuitem' })
113
+ : buttonTag({ class: 'd-dropdown-item', role: 'menuitem' });
114
+ if (item.onclick) menuItem.onclick = item.onclick;
115
+ if (item.disabled) {
116
+ menuItem.classList.add('d-dropdown-item-disabled');
117
+ menuItem.setAttribute('aria-disabled', 'true');
118
+ }
119
+ if (item.icon) menuItem.appendChild(renderIcon(item.icon));
120
+ menuItem.appendChild(document.createTextNode(item.label));
121
+ menu.appendChild(menuItem);
122
+ });
123
+
124
+ collapseInner.appendChild(ellipsisBtn);
125
+ collapseInner.appendChild(menu);
126
+ collapseWrap.appendChild(collapseInner);
127
+ collapseWrap.appendChild(renderSeparator());
128
+ list.appendChild(collapseWrap);
129
+
130
+ // Wire overlay + listbox behaviors
131
+ const overlay = createOverlay(ellipsisBtn, menu, {
132
+ trigger: 'click',
133
+ closeOnEscape: true,
134
+ closeOnOutside: true
135
+ });
136
+
137
+ const listbox = createListbox(menu, {
138
+ itemSelector: '.d-dropdown-item:not(.d-dropdown-item-disabled)',
139
+ activeClass: 'd-dropdown-item-highlight',
140
+ orientation: 'vertical',
141
+ onSelect: (el) => el.click()
142
+ });
143
+
144
+ onDestroy(() => {
145
+ overlay.destroy();
146
+ listbox.destroy();
147
+ });
148
+
149
+ // Render last items
150
+ lastItems.forEach((item, i) => {
151
+ const isLast = i === lastItems.length - 1;
152
+ list.appendChild(renderItem(item, isLast));
153
+ });
154
+ } else {
155
+ items.forEach((item, i) => {
156
+ list.appendChild(renderItem(item, i === items.length - 1));
157
+ });
158
+ }
159
+
160
+ nav.appendChild(list);
161
+ return nav;
162
+ }
@@ -0,0 +1,115 @@
1
+ import { h } from '../core/index.js';
2
+ import { createEffect } from '../state/index.js';
3
+ import { injectBase, cx, reactiveAttr } from './_base.js';
4
+ import { Spinner } from './spinner.js';
5
+ import { icon as renderIcon } from './icon.js';
6
+
7
+ const SPINNER_SIZE = {
8
+ xs: 'xs', sm: 'xs', default: 'sm', lg: 'default',
9
+ icon: 'sm', 'icon-xs': 'xs', 'icon-sm': 'xs', 'icon-lg': 'sm'
10
+ };
11
+
12
+ /**
13
+ * Shared variant resolver — reusable by any element needing button styles.
14
+ * @param {Object} [props]
15
+ * @param {string} [props.variant] - default|primary|secondary|tertiary|destructive|success|warning|outline|ghost|link
16
+ * @param {string} [props.size] - xs|sm|lg|icon|icon-xs|icon-sm|icon-lg
17
+ * @returns {string} CSS class string
18
+ */
19
+ export function buttonVariants({ variant = 'default', size = 'default' } = {}) {
20
+ return cx('d-btn', `d-btn-${variant}`, size && size !== 'default' && `d-btn-${size}`);
21
+ }
22
+
23
+ /**
24
+ * @param {Object} [props]
25
+ * @param {string} [props.variant] - default|primary|secondary|tertiary|destructive|success|warning|outline|ghost|link
26
+ * @param {string} [props.size] - xs|sm|lg|icon|icon-xs|icon-sm|icon-lg
27
+ * @param {boolean|Function} [props.disabled]
28
+ * @param {boolean|Function} [props.loading]
29
+ * @param {string} [props.class]
30
+ * @param {boolean} [props.block]
31
+ * @param {boolean} [props.rounded]
32
+ * @param {Function} [props.onclick]
33
+ * @param {...(string|Node)} children
34
+ * @returns {HTMLElement}
35
+ */
36
+ export function Button(props = {}, ...children) {
37
+ injectBase();
38
+
39
+ const { variant, size, disabled, loading, block, rounded, iconLeft, iconRight, class: cls, onclick, type, ...rest } = props;
40
+
41
+ const variantCls = buttonVariants({ variant, size });
42
+ const className = cx(
43
+ variantCls,
44
+ block && 'd-btn-block',
45
+ rounded && 'd-btn-rounded',
46
+ cls
47
+ );
48
+
49
+ const btnProps = { class: className, type: type || 'button', ...rest };
50
+ if (onclick) btnProps.onclick = onclick;
51
+
52
+ // Resolve icon props — accept string name or Node
53
+ const leftIcon = iconLeft ? (typeof iconLeft === 'string' ? renderIcon(iconLeft, { size: '1em' }) : iconLeft) : null;
54
+ const rightIcon = iconRight ? (typeof iconRight === 'string' ? renderIcon(iconRight, { size: '1em' }) : iconRight) : null;
55
+
56
+ const allChildren = [];
57
+ if (leftIcon) allChildren.push(leftIcon);
58
+ allChildren.push(...children);
59
+ if (rightIcon) allChildren.push(rightIcon);
60
+
61
+ const el = h('button', btnProps, ...allChildren);
62
+
63
+ reactiveAttr(el, disabled, 'disabled');
64
+
65
+ const resolvedSize = size || 'default';
66
+
67
+ if (typeof loading === 'function') {
68
+ createEffect(() => {
69
+ const v = loading();
70
+ if (v) {
71
+ el.className = cx(className, 'd-btn-loading');
72
+ el.setAttribute('disabled', '');
73
+ _addSpinner(el, resolvedSize);
74
+ } else {
75
+ el.className = className;
76
+ _removeSpinner(el);
77
+ if (typeof disabled === 'function' ? !disabled() : !disabled) {
78
+ el.removeAttribute('disabled');
79
+ }
80
+ }
81
+ });
82
+ } else if (loading) {
83
+ el.className = cx(className, 'd-btn-loading');
84
+ el.setAttribute('disabled', '');
85
+ _addSpinner(el, resolvedSize);
86
+ }
87
+
88
+ return el;
89
+ }
90
+
91
+ function _addSpinner(el, size) {
92
+ if (el.querySelector('.d-btn-spinner')) return;
93
+ const overlay = document.createElement('span');
94
+ overlay.className = 'd-btn-spinner';
95
+ overlay.appendChild(Spinner({ size: SPINNER_SIZE[size] || 'sm' }));
96
+ el.appendChild(overlay);
97
+ }
98
+
99
+ function _removeSpinner(el) {
100
+ const overlay = el.querySelector('.d-btn-spinner');
101
+ if (overlay) overlay.remove();
102
+ }
103
+
104
+ /**
105
+ * Button.Group — groups buttons with connected borders.
106
+ * @param {Object} [props]
107
+ * @param {string} [props.class]
108
+ * @param {...Node} children
109
+ * @returns {HTMLElement}
110
+ */
111
+ Button.Group = function Group(props = {}, ...children) {
112
+ injectBase();
113
+ const { class: cls, ...rest } = props;
114
+ return h('div', { class: cx('d-btn-group', cls), role: 'group', ...rest }, ...children);
115
+ };
@@ -0,0 +1,131 @@
1
+ /**
2
+ * Calendar — Full calendar display with day cells and events.
3
+ *
4
+ * @module decantr/components/calendar
5
+ */
6
+ import { h } from '../core/index.js';
7
+ import { createEffect, createSignal } from '../state/index.js';
8
+ import { injectBase, cx } from './_base.js';
9
+ import { caret } from './_behaviors.js';
10
+
11
+ const DAYS = ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'];
12
+ const MONTHS = ['January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September', 'October', 'November', 'December'];
13
+
14
+ /**
15
+ * @param {Object} [props]
16
+ * @param {Date|Function} [props.value] - Selected date
17
+ * @param {'month'|'year'} [props.mode='month']
18
+ * @param {boolean} [props.mini=false] - Compact mode (no cell content)
19
+ * @param {Function} [props.dateCellRender] - (date) => Node — custom cell content
20
+ * @param {Function} [props.onSelect] - Called with selected date
21
+ * @param {Function} [props.onPanelChange] - Called with (date, mode)
22
+ * @param {string} [props.class]
23
+ * @returns {HTMLElement}
24
+ */
25
+ export function Calendar(props = {}) {
26
+ injectBase();
27
+ const { value, mode: initMode = 'month', mini = false, dateCellRender, onSelect, onPanelChange, class: cls } = props;
28
+
29
+ const [getView, setView] = createSignal(typeof value === 'function' ? (value() || new Date()) : (value || new Date()));
30
+ const [getMode, setMode] = createSignal(initMode);
31
+
32
+ const container = h('div', { class: cx('d-calendar', mini && 'd-calendar-mini', cls) });
33
+
34
+ function render() {
35
+ container.replaceChildren();
36
+ const viewDate = getView();
37
+ const mode = getMode();
38
+
39
+ // Header
40
+ const headerRow = h('div', { class: 'd-calendar-header' });
41
+ const prevBtn = h('button', { type: 'button', class: 'd-datepicker-nav-btn', 'aria-label': 'Previous' }, caret('left'));
42
+ const nextBtn = h('button', { type: 'button', class: 'd-datepicker-nav-btn', 'aria-label': 'Next' }, caret('right'));
43
+ const title = h('span', { class: 'd-calendar-title' },
44
+ mode === 'month' ? `${MONTHS[viewDate.getMonth()]} ${viewDate.getFullYear()}` : String(viewDate.getFullYear())
45
+ );
46
+
47
+ prevBtn.addEventListener('click', () => {
48
+ const d = new Date(viewDate);
49
+ if (mode === 'month') d.setMonth(d.getMonth() - 1);
50
+ else d.setFullYear(d.getFullYear() - 1);
51
+ setView(d);
52
+ if (onPanelChange) onPanelChange(d, mode);
53
+ });
54
+ nextBtn.addEventListener('click', () => {
55
+ const d = new Date(viewDate);
56
+ if (mode === 'month') d.setMonth(d.getMonth() + 1);
57
+ else d.setFullYear(d.getFullYear() + 1);
58
+ setView(d);
59
+ if (onPanelChange) onPanelChange(d, mode);
60
+ });
61
+
62
+ headerRow.appendChild(h('div', { class: 'd-datepicker-nav' }, prevBtn));
63
+ headerRow.appendChild(title);
64
+ headerRow.appendChild(h('div', { class: 'd-datepicker-nav' }, nextBtn));
65
+ container.appendChild(headerRow);
66
+
67
+ if (mode === 'month') renderMonth(viewDate);
68
+ else renderYear(viewDate);
69
+ }
70
+
71
+ function renderMonth(viewDate) {
72
+ const grid = h('div', { class: 'd-calendar-grid' });
73
+ DAYS.forEach(d => grid.appendChild(h('div', { class: 'd-calendar-weekday' }, mini ? d[0] : d)));
74
+
75
+ const year = viewDate.getFullYear();
76
+ const month = viewDate.getMonth();
77
+ const firstDay = new Date(year, month, 1).getDay();
78
+ const daysInMonth = new Date(year, month + 1, 0).getDate();
79
+ const today = new Date();
80
+ const selected = typeof value === 'function' ? value() : value;
81
+
82
+ // Filler for previous month
83
+ for (let i = 0; i < firstDay; i++) {
84
+ grid.appendChild(h('div', { class: 'd-calendar-cell', style: { opacity: '0.3' } }));
85
+ }
86
+
87
+ for (let i = 1; i <= daysInMonth; i++) {
88
+ const d = new Date(year, month, i);
89
+ const isToday = d.toDateString() === today.toDateString();
90
+ const isSel = selected && d.toDateString() === new Date(selected).toDateString();
91
+
92
+ const cell = h('button', {
93
+ type: 'button',
94
+ class: cx('d-calendar-cell', isToday && 'd-datepicker-day-today', isSel && 'd-datepicker-day-selected')
95
+ });
96
+
97
+ cell.appendChild(h('div', { class: 'd-calendar-cell-content' }, String(i)));
98
+ if (dateCellRender && !mini) {
99
+ const custom = dateCellRender(d);
100
+ if (custom) cell.appendChild(custom);
101
+ }
102
+
103
+ cell.addEventListener('click', () => {
104
+ if (onSelect) onSelect(d);
105
+ });
106
+
107
+ grid.appendChild(cell);
108
+ }
109
+
110
+ container.appendChild(grid);
111
+ }
112
+
113
+ function renderYear(viewDate) {
114
+ const grid = h('div', { class: 'd-datepicker-months' });
115
+ MONTHS.forEach((m, i) => {
116
+ const btn = h('button', { type: 'button', class: 'd-datepicker-month' }, m.slice(0, 3));
117
+ btn.addEventListener('click', () => {
118
+ const d = new Date(viewDate);
119
+ d.setMonth(i);
120
+ setView(d);
121
+ setMode('month');
122
+ if (onPanelChange) onPanelChange(d, 'month');
123
+ });
124
+ grid.appendChild(btn);
125
+ });
126
+ container.appendChild(grid);
127
+ }
128
+
129
+ createEffect(render);
130
+ return container;
131
+ }
@@ -0,0 +1,192 @@
1
+ import { h, cond } from '../core/index.js';
2
+ import { createEffect } from '../state/index.js';
3
+ import { injectBase, cx } from './_base.js';
4
+ import { Skeleton } from './skeleton.js';
5
+
6
+ /**
7
+ * @param {Object} [props]
8
+ * @param {string|Node} [props.title]
9
+ * @param {Node|Function} [props.extra] - Top-right header content
10
+ * @param {boolean} [props.hoverable]
11
+ * @param {boolean} [props.bordered] - Toggle border (default true)
12
+ * @param {boolean|Function} [props.loading] - Skeleton loading placeholder
13
+ * @param {'default'|'sm'} [props.size]
14
+ * @param {'inner'} [props.type] - Inner card variant
15
+ * @param {Node} [props.cover] - Cover image shorthand
16
+ * @param {Node[]} [props.actions] - Bottom action bar items
17
+ * @param {string} [props.class]
18
+ * @param {...Node} children
19
+ * @returns {HTMLElement}
20
+ */
21
+ export function Card(props = {}, ...children) {
22
+ injectBase();
23
+
24
+ const {
25
+ title, extra, hoverable, bordered = true, loading, size, type,
26
+ cover, actions, class: cls
27
+ } = props;
28
+
29
+ const cardClass = cx(
30
+ 'd-card',
31
+ hoverable && 'd-card-hover',
32
+ !bordered && 'd-card-borderless',
33
+ size === 'sm' && 'd-card-sm',
34
+ type === 'inner' && 'd-card-inner',
35
+ cls
36
+ );
37
+
38
+ // Reactive loading — signal or boolean
39
+ if (typeof loading === 'function') {
40
+ const el = h('div', { class: cardClass });
41
+ const buildContent = () => {
42
+ el.innerHTML = '';
43
+ if (loading()) {
44
+ el.appendChild(h('div', { class: 'd-card-loading' }, Skeleton({ lines: 4 })));
45
+ } else {
46
+ buildCardContent(el, { title, extra, cover, actions }, children);
47
+ }
48
+ };
49
+ createEffect(buildContent);
50
+ return el;
51
+ }
52
+
53
+ if (loading) {
54
+ return h('div', { class: cardClass },
55
+ h('div', { class: 'd-card-loading' }, Skeleton({ lines: 4 }))
56
+ );
57
+ }
58
+
59
+ const parts = [];
60
+ buildCardContent(null, { title, extra, cover, actions }, children, parts);
61
+ return h('div', { class: cardClass }, ...parts);
62
+ }
63
+
64
+ /**
65
+ * Build card content parts — either appends to el or pushes to parts array.
66
+ */
67
+ function buildCardContent(el, { title, extra, cover, actions }, children, parts) {
68
+ const out = parts || [];
69
+ const append = (node) => {
70
+ if (el) el.appendChild(node);
71
+ else out.push(node);
72
+ };
73
+
74
+ // Cover shorthand
75
+ if (cover) append(Card.Cover({}, cover));
76
+
77
+ // Title + extra → auto-create header
78
+ if (title) append(Card.Header({ extra }, title));
79
+
80
+ // Check if children use Card section pattern
81
+ const hasSection = children.some(c =>
82
+ c && typeof c === 'object' && c.nodeType === 1 &&
83
+ (c.className || '').split(/\s+/).some(cls =>
84
+ cls === 'd-card-header' || cls === 'd-card-body' || cls === 'd-card-footer' ||
85
+ cls === 'd-card-cover' || cls === 'd-card-meta' || cls === 'd-card-grid' ||
86
+ cls === 'd-card-actions'
87
+ )
88
+ );
89
+
90
+ if (hasSection) {
91
+ children.forEach(c => { if (c) append(c); });
92
+ } else if (children.length) {
93
+ append(h('div', { class: 'd-card-body' }, ...children));
94
+ }
95
+
96
+ // Actions shorthand
97
+ if (actions && actions.length) append(Card.Actions({}, ...actions));
98
+ }
99
+
100
+ /**
101
+ * Card.Header - card header section
102
+ * @param {Object} [props]
103
+ * @param {Node|Function} [props.extra] - Top-right header content
104
+ * @param {...(string|Node)} children
105
+ * @returns {HTMLElement}
106
+ */
107
+ Card.Header = function CardHeader(props = {}, ...children) {
108
+ const { extra, class: cls } = props;
109
+ if (extra) {
110
+ const extraNode = typeof extra === 'function' ? extra() : extra;
111
+ return h('div', { class: cx('d-card-header d-card-header-extra', cls) },
112
+ h('div', { class: 'd-card-header-content' }, ...children),
113
+ h('div', { class: 'd-card-extra' }, extraNode)
114
+ );
115
+ }
116
+ return h('div', { class: cx('d-card-header', cls) }, ...children);
117
+ };
118
+
119
+ /**
120
+ * Card.Body - card body section
121
+ * @param {Object} [props]
122
+ * @param {...(string|Node)} children
123
+ * @returns {HTMLElement}
124
+ */
125
+ Card.Body = function CardBody(props = {}, ...children) {
126
+ const { class: cls } = props;
127
+ return h('div', { class: cx('d-card-body', cls) }, ...children);
128
+ };
129
+
130
+ /**
131
+ * Card.Footer - card footer section
132
+ * @param {Object} [props]
133
+ * @param {...(string|Node)} children
134
+ * @returns {HTMLElement}
135
+ */
136
+ Card.Footer = function CardFooter(props = {}, ...children) {
137
+ const { class: cls } = props;
138
+ return h('div', { class: cx('d-card-footer', cls) }, ...children);
139
+ };
140
+
141
+ /**
142
+ * Card.Cover - cover media area
143
+ * @param {Object} [props]
144
+ * @param {...Node} children
145
+ * @returns {HTMLElement}
146
+ */
147
+ Card.Cover = function CardCover(props = {}, ...children) {
148
+ const { class: cls } = props;
149
+ return h('div', { class: cx('d-card-cover', cls) }, ...children);
150
+ };
151
+
152
+ /**
153
+ * Card.Meta - avatar + title + description
154
+ * @param {Object} [props]
155
+ * @param {Node} [props.avatar]
156
+ * @param {string|Node} [props.title]
157
+ * @param {string|Node} [props.description]
158
+ * @param {string} [props.class]
159
+ * @returns {HTMLElement}
160
+ */
161
+ Card.Meta = function CardMeta(props = {}) {
162
+ const { avatar, title, description, class: cls } = props;
163
+ const detail = h('div', { class: 'd-card-meta-detail' });
164
+ if (title) detail.appendChild(h('div', { class: 'd-card-meta-title' }, title));
165
+ if (description) detail.appendChild(h('div', { class: 'd-card-meta-description' }, description));
166
+ return h('div', { class: cx('d-card-meta', cls) },
167
+ ...(avatar ? [avatar, detail] : [detail])
168
+ );
169
+ };
170
+
171
+ /**
172
+ * Card.Grid - grid sub-layout
173
+ * @param {Object} [props]
174
+ * @param {boolean} [props.hoverable]
175
+ * @param {...Node} children
176
+ * @returns {HTMLElement}
177
+ */
178
+ Card.Grid = function CardGrid(props = {}, ...children) {
179
+ const { hoverable, class: cls } = props;
180
+ return h('div', { class: cx('d-card-grid', hoverable && 'd-card-grid-hover', cls) }, ...children);
181
+ };
182
+
183
+ /**
184
+ * Card.Actions - equal-width bottom action bar
185
+ * @param {Object} [props]
186
+ * @param {...Node} children
187
+ * @returns {HTMLElement}
188
+ */
189
+ Card.Actions = function CardActions(props = {}, ...children) {
190
+ const { class: cls } = props;
191
+ return h('div', { class: cx('d-card-actions', cls) }, ...children);
192
+ };