ab-nextjs-components 0.1.12 → 0.1.14

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 (145) hide show
  1. package/CHANGELOG.md +64 -0
  2. package/README.md +52 -0
  3. package/ab-app-bar/index.tsx +210 -0
  4. package/ab-app-bar/styles.module.css +158 -0
  5. package/ab-avatar/index.tsx +2 -1
  6. package/ab-avatar/styles.module.css +32 -0
  7. package/ab-balloon/index.tsx +134 -23
  8. package/ab-balloon/styles.module.css +84 -7
  9. package/ab-bottom-drawer/index.tsx +71 -0
  10. package/ab-bottom-drawer/styles.module.css +66 -0
  11. package/ab-brand/index.tsx +1 -1
  12. package/ab-breadcrumbs/index.tsx +92 -0
  13. package/ab-breadcrumbs/styles.module.css +54 -0
  14. package/ab-button/helpers.ts +6 -1
  15. package/ab-button/index.tsx +23 -4
  16. package/ab-button/styles.module.css +70 -0
  17. package/ab-card/index.tsx +89 -0
  18. package/ab-card/styles.module.css +68 -0
  19. package/ab-carousel/styles.module.css +1 -1
  20. package/ab-chip/index.tsx +16 -4
  21. package/ab-chip/styles.module.css +12 -1
  22. package/ab-collapsible/index.tsx +1 -1
  23. package/ab-color/index.tsx +1 -0
  24. package/ab-color/styles.module.css +32 -0
  25. package/ab-confirm-drawer/index.tsx +97 -0
  26. package/ab-confirm-drawer/styles.module.css +41 -0
  27. package/ab-demo-box/index.tsx +1 -0
  28. package/ab-demo-box/styles.module.css +32 -0
  29. package/ab-demo-code/index.tsx +1 -0
  30. package/ab-demo-code/styles.module.css +32 -0
  31. package/ab-drawer/index.tsx +307 -0
  32. package/ab-drawer/styles.module.css +127 -0
  33. package/ab-drawer/use-ab-drawer.ts +89 -0
  34. package/ab-drawer-list/index.tsx +118 -0
  35. package/ab-drawer-list/styles.module.css +65 -0
  36. package/ab-flow-diagram/styles.module.css +2 -2
  37. package/ab-icon/builtin.ts +19 -1
  38. package/ab-icon/helpers.ts +37 -0
  39. package/ab-icon/index.tsx +14 -8
  40. package/ab-icon/registrar.tsx +68 -0
  41. package/ab-icon-button/index.tsx +19 -3
  42. package/ab-icon-button/styles.module.css +1 -1
  43. package/ab-image/index.tsx +1 -0
  44. package/ab-image/styles.module.css +32 -0
  45. package/ab-info/index.tsx +2 -1
  46. package/ab-info/styles.module.css +32 -0
  47. package/ab-input/index.tsx +1 -0
  48. package/ab-input/styles.module.css +1 -0
  49. package/ab-install-snippet/index.tsx +51 -29
  50. package/ab-install-snippet/styles.module.css +50 -4
  51. package/ab-kbd/index.tsx +65 -0
  52. package/ab-kbd/styles.module.css +55 -0
  53. package/ab-key-feature/index.tsx +2 -1
  54. package/ab-key-feature/styles.module.css +32 -0
  55. package/ab-like-button/index.tsx +1 -1
  56. package/ab-link/index.tsx +112 -0
  57. package/ab-link/locale.ts +53 -0
  58. package/ab-list/index.tsx +107 -0
  59. package/ab-list/styles.module.css +82 -0
  60. package/ab-locale-switcher/index.tsx +59 -10
  61. package/ab-locale-switcher/styles.module.css +15 -4
  62. package/ab-main-headline/index.tsx +1 -0
  63. package/ab-main-headline/styles.module.css +32 -0
  64. package/ab-menu/index.tsx +6 -5
  65. package/ab-menu/styles.module.css +32 -0
  66. package/ab-name/index.tsx +1 -0
  67. package/ab-name/styles.module.css +32 -0
  68. package/ab-navbar/index.tsx +54 -46
  69. package/ab-navbar/styles.module.css +102 -28
  70. package/ab-navbar/view.tsx +166 -0
  71. package/ab-package-card/index.tsx +141 -0
  72. package/ab-package-card/styles.module.css +81 -0
  73. package/ab-page-paginator/index.tsx +1 -0
  74. package/ab-page-paginator/styles.module.css +32 -0
  75. package/ab-page-switcher/index.tsx +1 -0
  76. package/ab-page-switcher/styles.module.css +32 -0
  77. package/ab-preview/index.tsx +1 -0
  78. package/ab-preview/styles.module.css +32 -0
  79. package/ab-price/index.tsx +1 -0
  80. package/ab-price/styles.module.css +32 -0
  81. package/ab-price-tag/index.tsx +1 -0
  82. package/ab-price-tag/styles.module.css +32 -0
  83. package/ab-product/index.tsx +1 -0
  84. package/ab-product/styles.module.css +32 -0
  85. package/ab-product-item/index.tsx +1 -0
  86. package/ab-product-item/styles.module.css +32 -0
  87. package/ab-search-result/index.tsx +1 -0
  88. package/ab-search-result/styles.module.css +32 -0
  89. package/ab-search-trigger/index.tsx +157 -0
  90. package/ab-search-trigger/styles.module.css +96 -0
  91. package/ab-sidebar/index.tsx +91 -49
  92. package/ab-sidebar/styles.module.css +179 -31
  93. package/ab-sidebar/view.tsx +192 -0
  94. package/ab-switch-back/index.tsx +2 -1
  95. package/ab-switch-back/styles.module.css +32 -0
  96. package/ab-tab/index.tsx +2 -1
  97. package/ab-tab/styles.module.css +32 -0
  98. package/ab-tabs/index.tsx +1 -0
  99. package/ab-tabs/styles.module.css +32 -0
  100. package/ab-test-hello/index.tsx +1 -0
  101. package/ab-test-hello/styles.module.css +32 -0
  102. package/ab-text/index.tsx +1 -0
  103. package/ab-text/styles.module.css +32 -0
  104. package/ab-theme-toggle/index.tsx +21 -6
  105. package/ab-theme-toggle/styles.module.css +18 -3
  106. package/ab-toc/index.tsx +131 -0
  107. package/ab-toc/styles.module.css +66 -0
  108. package/ab-version-switcher/index.tsx +143 -0
  109. package/ab-version-switcher/styles.module.css +76 -0
  110. package/css/chrome-mq.css +32 -0
  111. package/css/doodle.css +32 -0
  112. package/css/logo.css +32 -0
  113. package/css/spinner.css +32 -0
  114. package/css/toast.css +32 -0
  115. package/index.ts +45 -0
  116. package/package.json +42 -10
  117. package/server/ab-avatar/index.tsx +2 -1
  118. package/server/ab-avatar/styles.module.css +32 -0
  119. package/server/ab-badge/index.tsx +1 -0
  120. package/server/ab-badge/styles.module.css +32 -0
  121. package/server/ab-brand/index.tsx +1 -1
  122. package/server/ab-button/index.tsx +6 -2
  123. package/server/ab-button/styles.module.css +39 -0
  124. package/server/ab-icon/index.tsx +13 -8
  125. package/server/ab-key-feature/index.tsx +2 -1
  126. package/server/ab-key-feature/styles.module.css +32 -0
  127. package/server/ab-name/index.tsx +1 -0
  128. package/server/ab-name/styles.module.css +32 -0
  129. package/server/ab-nav-link/index.tsx +2 -1
  130. package/server/ab-nav-link/styles.module.css +32 -0
  131. package/server/ab-navbar/index.tsx +44 -45
  132. package/server/ab-polygon/index.tsx +1 -0
  133. package/server/ab-polygon/styles.module.css +32 -0
  134. package/server/ab-sidebar/index.tsx +44 -49
  135. package/server/ab-switch-back/index.tsx +2 -1
  136. package/server/ab-switch-back/styles.module.css +32 -0
  137. package/server/ab-test-hello/index.tsx +1 -0
  138. package/server/ab-test-hello/styles.module.css +32 -0
  139. package/server/ab-text/index.tsx +1 -0
  140. package/server/ab-text/styles.module.css +32 -0
  141. package/server/index.ts +1 -0
  142. package/styles.css +32 -0
  143. package/types/index.d.ts +54 -0
  144. package/server/ab-navbar/styles.module.css +0 -35
  145. package/server/ab-sidebar/styles.module.css +0 -41
package/css/spinner.css CHANGED
@@ -1,3 +1,35 @@
1
+ /*
2
+ * @license MIT
3
+ * ~~~~~~~~~~~~
4
+ * ab-nextjs-components
5
+ * ~~~~~~~~~~~~
6
+ * Copyright (c) 2026 Abraham Ukachi. The abElements Project.
7
+ *
8
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
9
+ * of this software and associated documentation files (the 'Software'), to deal
10
+ * in the Software without restriction, including without limitation the rights
11
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
12
+ * copies of the Software, and to permit persons to whom the Software is
13
+ * furnished to do so, subject to the following conditions:
14
+ *
15
+ * The above copyright notice and this permission notice shall be included in all
16
+ * copies or substantial portions of the Software.
17
+ *
18
+ * THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
19
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
20
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
21
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
22
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
23
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
24
+ * SOFTWARE.
25
+ *
26
+ * @project: ab-nextjs-components
27
+ * @name: spinner.css
28
+ * @file: css/spinner.css
29
+ * @type: CSS Stylesheet
30
+ * @authors: Abraham Ukachi <abrahamukachi@gmail.com>
31
+ */
32
+
1
33
  /*
2
34
  * ab-nextjs-components — chrome styles moved out of ab-nextjs-theme
3
35
  * Copyright (c) 2026 Abraham Ukachi. MIT.
package/css/toast.css CHANGED
@@ -1,3 +1,35 @@
1
+ /*
2
+ * @license MIT
3
+ * ~~~~~~~~~~~~
4
+ * ab-nextjs-components
5
+ * ~~~~~~~~~~~~
6
+ * Copyright (c) 2026 Abraham Ukachi. The abElements Project.
7
+ *
8
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
9
+ * of this software and associated documentation files (the 'Software'), to deal
10
+ * in the Software without restriction, including without limitation the rights
11
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
12
+ * copies of the Software, and to permit persons to whom the Software is
13
+ * furnished to do so, subject to the following conditions:
14
+ *
15
+ * The above copyright notice and this permission notice shall be included in all
16
+ * copies or substantial portions of the Software.
17
+ *
18
+ * THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
19
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
20
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
21
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
22
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
23
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
24
+ * SOFTWARE.
25
+ *
26
+ * @project: ab-nextjs-components
27
+ * @name: toast.css
28
+ * @file: css/toast.css
29
+ * @type: CSS Stylesheet
30
+ * @authors: Abraham Ukachi <abrahamukachi@gmail.com>
31
+ */
32
+
1
33
  /*
2
34
  * ab-nextjs-components — chrome styles moved out of ab-nextjs-theme
3
35
  * Copyright (c) 2026 Abraham Ukachi. MIT.
package/index.ts CHANGED
@@ -116,6 +116,28 @@ const supportedComponents: Array<ComponentCatalogEntry> = [
116
116
  { name: 'AbLocaleSwitcher', file: 'ab-locale-switcher/index.tsx', kind: 'client', status: 'Done' },
117
117
  // 🆕 Welcome v6 (AbFlowDiagram)
118
118
  { name: 'AbFlowDiagram', file: 'ab-flow-diagram/index.tsx', kind: 'server', status: 'Done' },
119
+ // 🆕 0.1.13 docs shell (AbLink)
120
+ { name: 'AbLink', file: 'ab-link/index.tsx', kind: 'client', status: 'Done' },
121
+ // 🆕 0.1.13 docs shell (AbKbd) — server-safe, no hooks
122
+ { name: 'AbKbd', file: 'ab-kbd/index.tsx', kind: 'server', status: 'Done' },
123
+ // 🆕 0.1.13 docs shell (AbSearchTrigger)
124
+ { name: 'AbSearchTrigger', file: 'ab-search-trigger/index.tsx', kind: 'client', status: 'Done' },
125
+ // 🆕 0.1.13 docs shell (AbAppBar)
126
+ { name: 'AbAppBar', file: 'ab-app-bar/index.tsx', kind: 'client', status: 'Done' },
127
+ // 🆕 0.1.13 docs shell (AbCard) — server-safe, no hooks
128
+ { name: 'AbCard', file: 'ab-card/index.tsx', kind: 'server', status: 'Done' },
129
+ // 🆕 0.1.13 docs shell (AbPackageCard) — server-safe, no hooks
130
+ { name: 'AbPackageCard', file: 'ab-package-card/index.tsx', kind: 'server', status: 'Done' },
131
+ // 🆕 0.1.13 docs shell (AbToc) — server-safe, no hooks
132
+ { name: 'AbToc', file: 'ab-toc/index.tsx', kind: 'server', status: 'Done' },
133
+ // 🆕 0.1.14 (G53): AbDrawer + presets
134
+ { name: 'AbDrawer', file: 'ab-drawer/index.tsx', kind: 'client', status: 'Done' },
135
+ { name: 'AbDrawerList', file: 'ab-drawer-list/index.tsx', kind: 'client', status: 'Done' },
136
+ { name: 'AbConfirmDrawer', file: 'ab-confirm-drawer/index.tsx', kind: 'client', status: 'Done' },
137
+ { name: 'AbBottomDrawer', file: 'ab-bottom-drawer/index.tsx', kind: 'client', status: 'Done' },
138
+ { name: 'AbVersionSwitcher', file: 'ab-version-switcher/index.tsx', kind: 'client', status: 'Done' },
139
+ { name: 'AbBreadcrumbs', file: 'ab-breadcrumbs/index.tsx', kind: 'server', status: 'Done' },
140
+ { name: 'AbList', file: 'ab-list/index.tsx', kind: 'server', status: 'Done' },
119
141
  ]
120
142
 
121
143
  const abComponents = { supportedComponents }
@@ -124,6 +146,7 @@ export { supportedComponents }
124
146
  export default abComponents
125
147
 
126
148
  export { default as AbIcon } from './ab-icon/index.tsx'
149
+ export { AbIconRegistrar } from './ab-icon/registrar.tsx' // 🗂️ server-safe icon registration (0.1.13)
127
150
  export { default as AbLogo } from './ab-logo/index.tsx'
128
151
  // 📶 progress bar
129
152
  export { default as AbLinearProgress } from './ab-linear-progress/index.tsx'
@@ -151,6 +174,28 @@ export { default as AbBrand } from './ab-brand/index.tsx'
151
174
  export { default as AbName } from './ab-name/index.tsx'
152
175
  export { default as AbNavbar } from './ab-navbar/index.tsx'
153
176
  export { default as AbSidebar } from './ab-sidebar/index.tsx'
177
+ // 📑 0.1.13 (Joseph): AbToc + the panes main-scroller helpers (also at `ab-nextjs-components/ab-toc`)
178
+ export { default as AbToc, getAbMainScroller, AB_MAIN_SCROLLER_SELECTOR } from './ab-toc/index.tsx'
179
+ export type { AbTocItem, AbTocProps } from './ab-toc/index.tsx'
180
+ // 🗄️ 0.1.14 (G53): AbDrawer + useAbDrawer (also at `ab-nextjs-components/ab-drawer`)
181
+ export { default as AbDrawer, useAbDrawer, getAbDrawerHost, AB_DRAWER_DURATION } from './ab-drawer/index.tsx'
182
+ export type { AbDrawerProps, AbDrawerSide, AbDrawerScope, UseAbDrawer } from './ab-drawer/index.tsx'
183
+ export { default as AbDrawerList } from './ab-drawer-list/index.tsx'
184
+ export type { AbDrawerListItem, AbDrawerListProps } from './ab-drawer-list/index.tsx'
185
+ export { default as AbConfirmDrawer } from './ab-confirm-drawer/index.tsx'
186
+ export type { AbConfirmDrawerProps } from './ab-confirm-drawer/index.tsx'
187
+ // 📱 0.1.14 (D40): AbBottomDrawer, the mobile bottom drawer
188
+ export { default as AbBottomDrawer } from './ab-bottom-drawer/index.tsx'
189
+ export type { AbBottomDrawerProps } from './ab-bottom-drawer/index.tsx'
190
+ // 🏷️ 0.1.14 (P9): AbVersionSwitcher
191
+ export { default as AbVersionSwitcher } from './ab-version-switcher/index.tsx'
192
+ export type { AbVersionOption, AbVersionSwitcherProps } from './ab-version-switcher/index.tsx'
193
+ // 🍞 0.1.14 (P2): AbBreadcrumbs
194
+ export { default as AbBreadcrumbs } from './ab-breadcrumbs/index.tsx'
195
+ export type { AbBreadcrumbItem, AbBreadcrumbsProps } from './ab-breadcrumbs/index.tsx'
196
+ // 📋 0.1.14 (P13): AbList + AbListItem
197
+ export { default as AbList, AbListItem } from './ab-list/index.tsx'
198
+ export type { AbListProps, AbListItemProps } from './ab-list/index.tsx'
154
199
  export { default as AbText } from './ab-text/index.tsx'
155
200
  export { default as AbTestHello } from './ab-test-hello/index.tsx'
156
201
  export { default as AbKeyFeature } from './ab-key-feature/index.tsx'
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "ab-nextjs-components",
3
- "version": "0.1.12",
3
+ "version": "0.1.14",
4
4
  "description": "🚀 A lightweight collection of server & client React components created by Abraham Ukachi, and optimized for Next.js applications 😎.",
5
5
  "type": "module",
6
6
  "main": "index.ts",
@@ -36,14 +36,14 @@
36
36
  "author": {
37
37
  "name": "Abraham Ukachi",
38
38
  "url": "https://github.com/abraham-ukachi",
39
- "email": "abraham.ukachi@laplateforme.io"
39
+ "email": "abrahamukachi@gmail.com"
40
40
  },
41
41
  "license": "MIT",
42
42
  "peerDependencies": {
43
43
  "ab-nextjs-animations": "^0.2.4",
44
- "ab-nextjs-hooks": "^0.1.6",
45
- "ab-nextjs-icons": "^0.2.3",
46
- "ab-nextjs-theme": "^0.3.3",
44
+ "ab-nextjs-hooks": "^0.1.7",
45
+ "ab-nextjs-icons": "^0.2.4",
46
+ "ab-nextjs-theme": "^0.3.5",
47
47
  "clsx": "^2",
48
48
  "next": "^16.3.4",
49
49
  "react": "^19",
@@ -54,9 +54,9 @@
54
54
  "@types/node": "^20",
55
55
  "@types/react": "^19",
56
56
  "ab-nextjs-animations": "^0.2.4",
57
- "ab-nextjs-hooks": "^0.1.6",
58
- "ab-nextjs-icons": "^0.2.3",
59
- "ab-nextjs-theme": "^0.3.3",
57
+ "ab-nextjs-hooks": "^0.1.7",
58
+ "ab-nextjs-icons": "^0.2.4",
59
+ "ab-nextjs-theme": "^0.3.5",
60
60
  "clsx": "^2.1.1",
61
61
  "esbuild": "^0.28.2",
62
62
  "eslint": "^9.39.0",
@@ -114,6 +114,13 @@
114
114
  "ab-splash",
115
115
  "ab-linear-progress",
116
116
  "ab-carousel",
117
+ "ab-drawer",
118
+ "ab-drawer-list",
119
+ "ab-confirm-drawer",
120
+ "ab-bottom-drawer",
121
+ "ab-version-switcher",
122
+ "ab-breadcrumbs",
123
+ "ab-list",
117
124
  "ab-flow-diagram",
118
125
  "ab-locale-switcher",
119
126
  "ab-install-snippet",
@@ -123,7 +130,14 @@
123
130
  "ab-logo/ab-logo.svg",
124
131
  "styles.css",
125
132
  "css",
126
- "assets"
133
+ "assets",
134
+ "ab-link",
135
+ "ab-kbd",
136
+ "ab-search-trigger",
137
+ "ab-app-bar",
138
+ "ab-card",
139
+ "ab-package-card",
140
+ "ab-toc"
127
141
  ],
128
142
  "exports": {
129
143
  ".": {
@@ -132,6 +146,7 @@
132
146
  },
133
147
  "./package.json": "./package.json",
134
148
  "./ab-icon": "./ab-icon/index.tsx",
149
+ "./ab-icon/registrar": "./ab-icon/registrar.tsx",
135
150
  "./ab-logo": "./ab-logo/index.tsx",
136
151
  "./ab-linear-progress": "./ab-linear-progress/index.tsx",
137
152
  "./ab-splash": "./ab-splash/index.tsx",
@@ -145,6 +160,14 @@
145
160
  "./ab-locale-switcher": "./ab-locale-switcher/index.tsx",
146
161
  "./ab-flow-diagram": "./ab-flow-diagram/index.tsx",
147
162
  "./ab-flow-diagram/helpers": "./ab-flow-diagram/helpers.ts",
163
+ "./ab-drawer": "./ab-drawer/index.tsx",
164
+ "./ab-drawer/use-ab-drawer": "./ab-drawer/use-ab-drawer.ts",
165
+ "./ab-drawer-list": "./ab-drawer-list/index.tsx",
166
+ "./ab-confirm-drawer": "./ab-confirm-drawer/index.tsx",
167
+ "./ab-bottom-drawer": "./ab-bottom-drawer/index.tsx",
168
+ "./ab-version-switcher": "./ab-version-switcher/index.tsx",
169
+ "./ab-breadcrumbs": "./ab-breadcrumbs/index.tsx",
170
+ "./ab-list": "./ab-list/index.tsx",
148
171
  "./ab-splash/gate": "./ab-splash/gate.ts",
149
172
  "./ab-splash/csp": {
150
173
  "types": "./ab-splash/csp.d.ts",
@@ -204,7 +227,16 @@
204
227
  "./server/ab-switch-back": "./server/ab-switch-back/index.tsx",
205
228
  "./styles.css": "./styles.css",
206
229
  "./css/*": "./css/*",
207
- "./assets/*": "./assets/*"
230
+ "./assets/*": "./assets/*",
231
+ "./ab-link": "./ab-link/index.tsx",
232
+ "./ab-kbd": "./ab-kbd/index.tsx",
233
+ "./ab-search-trigger": "./ab-search-trigger/index.tsx",
234
+ "./ab-app-bar": "./ab-app-bar/index.tsx",
235
+ "./ab-card": "./ab-card/index.tsx",
236
+ "./ab-package-card": "./ab-package-card/index.tsx",
237
+ "./ab-toc": "./ab-toc/index.tsx",
238
+ "./ab-sidebar/view": "./ab-sidebar/view.tsx",
239
+ "./ab-navbar/view": "./ab-navbar/view.tsx"
208
240
  },
209
241
  "peerDependenciesMeta": {
210
242
  "ab-nextjs-theme": {
@@ -8,11 +8,12 @@
8
8
  * @project: ab-nextjs-components
9
9
  * @name: AbAvatar - Server (port of server/lyd-avatar)
10
10
  * @file: server/ab-avatar/index.tsx
11
+ * @authors: Abraham Ukachi <abrahamukachi@gmail.com>
11
12
  */
12
13
 
13
14
  import type { ReactElement } from 'react';
14
15
  import Image from 'next/image';
15
- import Link from 'next/link';
16
+ import Link from '../../ab-link'; // 🔗 G42: injectable via AbLinkProvider (default next/link)
16
17
  import clsx from 'clsx';
17
18
  import styles from './styles.module.css';
18
19
 
@@ -1,3 +1,35 @@
1
+ /*
2
+ * @license MIT
3
+ * ~~~~~~~~~~~~
4
+ * ab-nextjs-components
5
+ * ~~~~~~~~~~~~
6
+ * Copyright (c) 2026 Abraham Ukachi. The abElements Project.
7
+ *
8
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
9
+ * of this software and associated documentation files (the 'Software'), to deal
10
+ * in the Software without restriction, including without limitation the rights
11
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
12
+ * copies of the Software, and to permit persons to whom the Software is
13
+ * furnished to do so, subject to the following conditions:
14
+ *
15
+ * The above copyright notice and this permission notice shall be included in all
16
+ * copies or substantial portions of the Software.
17
+ *
18
+ * THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
19
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
20
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
21
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
22
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
23
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
24
+ * SOFTWARE.
25
+ *
26
+ * @project: ab-nextjs-components
27
+ * @name: styles.module.css
28
+ * @file: server/ab-avatar/styles.module.css
29
+ * @type: CSS Stylesheet
30
+ * @authors: Abraham Ukachi <abrahamukachi@gmail.com>
31
+ */
32
+
1
33
  /* AbAvatar — plain CSS (no Tailwind apply) */
2
34
  .abAvatar {
3
35
  display: flex;
@@ -8,6 +8,7 @@
8
8
  * @project: ab-nextjs-components
9
9
  * @name: AbBadge - Server (port of server/lyd-badge)
10
10
  * @file: server/ab-badge/index.tsx
11
+ * @authors: Abraham Ukachi <abrahamukachi@gmail.com>
11
12
  */
12
13
 
13
14
  import type { CSSProperties, ReactElement } from 'react';
@@ -1,3 +1,35 @@
1
+ /*
2
+ * @license MIT
3
+ * ~~~~~~~~~~~~
4
+ * ab-nextjs-components
5
+ * ~~~~~~~~~~~~
6
+ * Copyright (c) 2026 Abraham Ukachi. The abElements Project.
7
+ *
8
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
9
+ * of this software and associated documentation files (the 'Software'), to deal
10
+ * in the Software without restriction, including without limitation the rights
11
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
12
+ * copies of the Software, and to permit persons to whom the Software is
13
+ * furnished to do so, subject to the following conditions:
14
+ *
15
+ * The above copyright notice and this permission notice shall be included in all
16
+ * copies or substantial portions of the Software.
17
+ *
18
+ * THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
19
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
20
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
21
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
22
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
23
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
24
+ * SOFTWARE.
25
+ *
26
+ * @project: ab-nextjs-components
27
+ * @name: styles.module.css
28
+ * @file: server/ab-badge/styles.module.css
29
+ * @type: CSS Stylesheet
30
+ * @authors: Abraham Ukachi <abrahamukachi@gmail.com>
31
+ */
32
+
1
33
  /* AbBadge — server, plain CSS */
2
34
  .abBadge {
3
35
  position: absolute;
@@ -38,7 +38,7 @@
38
38
 
39
39
 
40
40
  import type { CSSProperties, ReactElement } from 'react';
41
- import Link from 'next/link';
41
+ import Link from '../../ab-link'; // 🔗 G42: injectable via AbLinkProvider (default next/link)
42
42
  import Image from 'next/image';
43
43
  import clsx from 'clsx';
44
44
  import styles from './styles.module.css';
@@ -48,7 +48,7 @@ import {
48
48
  getAbButtonSrReason,
49
49
  type AbButtonBadgeTone,
50
50
  type AbButtonColor,
51
- type AbButtonType,
51
+ type AbButtonType, type AbButtonShape, type AbButtonSize,
52
52
  } from '../../ab-button/helpers';
53
53
 
54
54
  // 📦 shared types
@@ -63,6 +63,8 @@ export interface AbButtonProps {
63
63
  hidden?: boolean; // 🙈
64
64
  style?: CSSProperties; // 🎨
65
65
  rounded?: boolean; // 💊
66
+ shape?: AbButtonShape; // 🔷 0.1.14 (P16)
67
+ size?: AbButtonSize; // 📏 0.1.14 (P16)
66
68
  raised?: boolean; // 🏔️
67
69
  shrinks?: boolean; // 🤏
68
70
  expands?: boolean; // 🔍
@@ -84,7 +86,7 @@ export interface AbButtonProps {
84
86
 
85
87
  /** 🖥️ Server AbButton: no onClick. Use href for links or htmlType for form submit. No-JS safe. */
86
88
  const AbButton = ({
87
- id, type = 'contained', htmlType = 'button', className, hidden = false, style, rounded = true, raised = false,
89
+ id, type = 'contained', htmlType = 'button', className, hidden = false, style, rounded = true, shape, size, raised = false,
88
90
  shrinks = false, expands = false, withIcon = false, disabled = false, iconPosition = 'left', label, icon,
89
91
  color = 'primary', href, children, startIcon, endIcon, badge, badgeTone = 'neutral', disabledReason, focusableWhenDisabled,
90
92
  }: AbButtonProps): ReactElement => {
@@ -106,6 +108,8 @@ const AbButton = ({
106
108
  'data-iconpos': iconPosition, // ↔️
107
109
  'data-color': color, // 🎨
108
110
  'data-disabled-mode': mode, // 🚦
111
+ 'data-shape': shape, // 🔷 P16
112
+ 'data-size': size, // 📏 P16
109
113
  } as const;
110
114
 
111
115
  // 🔣 legacy icon (decorative)
@@ -150,3 +150,42 @@
150
150
  white-space: nowrap; /* 🚫 */
151
151
  border: 0; /* 🧹 */
152
152
  }
153
+
154
+ /* ===== 🔷 0.1.14 (P16, Home fidelity spec §4 CTAs): shape="rounded" · size="md" · type="secondary" =====
155
+ * Doubled class (0,3,0+) beats the theme's `button[data-type="filled"]` (0,1,1) and its :hover (0,3,1 → we use 0,5,0). */
156
+ .abButton.abButton[data-shape="rounded"] {
157
+ gap: 6px; /* 🧱 icon ↔ label */
158
+ border-radius: var(--ab-radius-button, 10px); /* 🔷 */
159
+ padding: 0 var(--ab-button-padding-inline, 16px); /* 📦 */
160
+ font-size: 14px; font-weight: 650; line-height: 1; white-space: nowrap; /* 🔤 */
161
+ overflow: visible; /* 🌗 the primary shadow must show */
162
+ }
163
+ .abButton.abButton[data-size="md"] { height: var(--ab-button-height, 40px); box-sizing: border-box; } /* 📏 */
164
+ .abButton.abButton[data-shape="rounded"] .abButtonSlot { width: 18px; height: 18px; } /* 🖼️ 18px icons */
165
+ .abButton.abButton[data-shape="rounded"] .abButtonSlot svg { width: 100%; height: 100%; }
166
+ /* 🥉 primary (filled) */
167
+ .abButton.abButton[data-shape="rounded"][data-type="filled"] {
168
+ background: var(--ab-color-btn, #8b6340); color: var(--ab-color-btn-text, #fff); /* 🎨 AA (theme 0.3.5) */
169
+ border: 0; box-shadow: var(--ab-shadow-button, 0 1px 0 rgb(255 255 255 / 0.2) inset, 0 4px 12px rgb(139 99 64 / 0.25)); /* ✨ */
170
+ }
171
+ .abButton.abButton[data-shape="rounded"][data-type="filled"]:not(:disabled, [aria-disabled="true"]):hover {
172
+ background: color-mix(in srgb, var(--ab-color-btn, #8b6340) 90%, #000); /* 🖱️ */
173
+ }
174
+ /* ⚪ secondary */
175
+ .abButton.abButton[data-type="secondary"] {
176
+ border: 1px solid var(--ab-color-border, rgb(92 64 48 / 0.13)); background: var(--ab-color-card, #fff); color: var(--ab-color-text, #211a16); /* 🎨 */
177
+ box-sizing: border-box;
178
+ }
179
+ .abButton.abButton[data-type="secondary"]:not(:disabled, [aria-disabled="true"]):hover {
180
+ background: linear-gradient(var(--ab-color-hover, rgb(166 124 82 / 0.08)), var(--ab-color-hover, rgb(166 124 82 / 0.08))), var(--ab-color-card, #fff); /* 🖱️ tint over the card */
181
+ }
182
+ .abButton.abButton[data-shape="rounded"]:not(:disabled, [aria-disabled="true"]):active { transform: translateY(1px); } /* 👇 */
183
+ .abButton.abButton[data-shape="rounded"]:focus-visible { outline: 2px solid var(--ab-color-accent, #a67c52); outline-offset: 2px; } /* ♿ */
184
+ /* 📱 touch widths: 44px, 14.5px (mock .M .btn; the app sets flex: 1) */
185
+ @media (max-width: 767px) {
186
+ .abButton.abButton[data-size="md"] { height: var(--ab-button-height-touch, 44px); }
187
+ .abButton.abButton[data-shape="rounded"][data-size="md"] { font-size: 14.5px; }
188
+ }
189
+ @media (prefers-reduced-motion: reduce) {
190
+ .abButton.abButton[data-shape="rounded"]:active { transform: none; } /* ♿ no nudge */
191
+ }
@@ -37,19 +37,19 @@
37
37
  */
38
38
 
39
39
  // ⚛️ types
40
- import type { CSSProperties, ReactElement } from 'react';
40
+ import { useId, type CSSProperties, type ReactElement } from 'react';
41
41
  // 🧵 classes
42
42
  import clsx from 'clsx';
43
43
  // 🗺️ full icon map: fine here, server components ship no JS to the browser
44
44
  import { getAbIconSvg } from 'ab-nextjs-icons/ab-icons';
45
45
  // 🧮 shared helpers (same rules as the client twin)
46
- import { getAbIconStroke, getRegisteredAbIcon, pickAbIconMarkup, toAbIconSize, type AbIconSvgData, type AbIconVariant, type AbIconWeight } from '../../ab-icon/helpers';
46
+ import { scopeAbIconIds, warnAbIconMissing, getAbIconStroke, getRegisteredAbIcon, pickAbIconMarkup, toAbIconSize, type AbIconSvgData, type AbIconVariant, type AbIconWeight } from '../../ab-icon/helpers';
47
47
  // 🎨 styles (server copy)
48
48
  import styles from './styles.module.css';
49
49
 
50
50
  // ⚙️ props
51
51
  export interface AbIconProps {
52
- name: string; // 🗂️ AbIcons name (snake_case); Material ligature fallback if unknown
52
+ name: string; // 🗂️ AbIcons name (snake_case); AbIcons name (registered / svg / map); unknown = Material ligature fallback + dev warning
53
53
  variant?: AbIconVariant; // 🎚️ outlined (default) | filled
54
54
  filled?: boolean; // 🕰️ legacy alias for variant="filled"
55
55
  weight?: AbIconWeight | number; // 📏 100–700 (outlined), default 200
@@ -61,12 +61,14 @@ export interface AbIconProps {
61
61
  style?: CSSProperties; // 🎨
62
62
  }
63
63
 
64
- /** 🔣 AbIcons SVG icon (server / RSC): `svg` prop → registry → full AbIcons map → Material ligature. */
64
+ /** 🔣 AbIcons SVG icon (server / RSC): `svg` prop → registry → full AbIcons map → Material ligature fallback + dev warning. */
65
65
  const AbIcon = ({ name, variant, filled = false, weight, size, label, title, svg, className, style }: AbIconProps): ReactElement => {
66
66
  // 🎚️ variant for lookup
67
67
  const want: AbIconVariant = variant ?? (filled ? 'filled' : 'outlined');
68
68
  // 🔍 explicit → registered → whole map (weight is applied by CSS, so ask for the raw markup)
69
69
  const markup = pickAbIconMarkup(svg ?? getRegisteredAbIcon(name), want) ?? getAbIconSvg(name, want);
70
+ // 🆔 one id per rendered instance (Joseph: a hidden twin's mask broke the active Home)
71
+ const uid = useId();
70
72
  // 🎚️ legacy `filled` → variant
71
73
  const v: AbIconVariant = variant ?? (filled ? 'filled' : 'outlined');
72
74
  // 🏷️ accessible name: `label` (new) or `title` (legacy)
@@ -87,18 +89,21 @@ const AbIcon = ({ name, variant, filled = false, weight, size, label, title, svg
87
89
  title={title} // 💬 legacy tooltip only
88
90
  {...a11y} // ♿
89
91
  // 🔒 trusted, package-generated static markup (never user input)
90
- dangerouslySetInnerHTML={{ __html: markup }}
92
+ dangerouslySetInnerHTML={{ __html: scopeAbIconIds(markup, uid) }}
91
93
  />
92
94
  );
93
95
  }
94
96
 
95
- // 🕰️ fallback: Material Symbols ligature (pre-G2 behaviour) for names not in AbIcons
97
+ // 🕰️ 0.1.13 (James review): NON-breaking fallback for unregistered names. A patch must not blank icons,
98
+ // so an unknown name still renders the pre-G2 Material Symbols ligature (needs the app's font), and
99
+ // warns once in development so the missing registration gets fixed before the app drops the font.
100
+ warnAbIconMissing(name);
96
101
  return (
97
102
  <span
98
- className={clsx('material-symbols-rounded', 'icon', styles.abIconFont, className)} // 🏷️
103
+ className={clsx('AbIcon', 'material-symbols-rounded', 'icon', styles.abIconFont, className)} // 🏷️ legacy font class
99
104
  style={{ ...style, fontSize: toAbIconSize(size) }} // 📏
100
- data-filled={v === 'filled' ? 'true' : 'false'} // 🎚️
101
105
  data-icon={name} // 🗂️
106
+ data-filled={v === 'filled' ? 'true' : 'false'} // 🎚️
102
107
  data-ab-icon-fallback="font" // 🔎 easy to audit
103
108
  title={title} // 💬
104
109
  {...a11y} // ♿
@@ -8,11 +8,12 @@
8
8
  * @project: ab-nextjs-components
9
9
  * @name: AbKeyFeature - Server (port of lyd-key-feature)
10
10
  * @file: server/ab-key-feature/index.tsx
11
+ * @authors: Abraham Ukachi <abrahamukachi@gmail.com>
11
12
  */
12
13
 
13
14
 
14
15
  import type { ReactElement } from 'react';
15
- import Link from 'next/link';
16
+ import Link from '../../ab-link'; // 🔗 G42: injectable via AbLinkProvider (default next/link)
16
17
  import clsx from 'clsx';
17
18
  import styles from './styles.module.css';
18
19
 
@@ -1,3 +1,35 @@
1
+ /*
2
+ * @license MIT
3
+ * ~~~~~~~~~~~~
4
+ * ab-nextjs-components
5
+ * ~~~~~~~~~~~~
6
+ * Copyright (c) 2026 Abraham Ukachi. The abElements Project.
7
+ *
8
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
9
+ * of this software and associated documentation files (the 'Software'), to deal
10
+ * in the Software without restriction, including without limitation the rights
11
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
12
+ * copies of the Software, and to permit persons to whom the Software is
13
+ * furnished to do so, subject to the following conditions:
14
+ *
15
+ * The above copyright notice and this permission notice shall be included in all
16
+ * copies or substantial portions of the Software.
17
+ *
18
+ * THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
19
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
20
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
21
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
22
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
23
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
24
+ * SOFTWARE.
25
+ *
26
+ * @project: ab-nextjs-components
27
+ * @name: styles.module.css
28
+ * @file: server/ab-key-feature/styles.module.css
29
+ * @type: CSS Stylesheet
30
+ * @authors: Abraham Ukachi <abrahamukachi@gmail.com>
31
+ */
32
+
1
33
  .abKeyFeature {
2
34
  display: flex;
3
35
  flex-direction: column;
@@ -8,6 +8,7 @@
8
8
  * @project: ab-nextjs-components
9
9
  * @name: AbName - Server (port of lyd-name)
10
10
  * @file: server/ab-name/index.tsx
11
+ * @authors: Abraham Ukachi <abrahamukachi@gmail.com>
11
12
  */
12
13
 
13
14
 
@@ -1,3 +1,35 @@
1
+ /*
2
+ * @license MIT
3
+ * ~~~~~~~~~~~~
4
+ * ab-nextjs-components
5
+ * ~~~~~~~~~~~~
6
+ * Copyright (c) 2026 Abraham Ukachi. The abElements Project.
7
+ *
8
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
9
+ * of this software and associated documentation files (the 'Software'), to deal
10
+ * in the Software without restriction, including without limitation the rights
11
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
12
+ * copies of the Software, and to permit persons to whom the Software is
13
+ * furnished to do so, subject to the following conditions:
14
+ *
15
+ * The above copyright notice and this permission notice shall be included in all
16
+ * copies or substantial portions of the Software.
17
+ *
18
+ * THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
19
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
20
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
21
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
22
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
23
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
24
+ * SOFTWARE.
25
+ *
26
+ * @project: ab-nextjs-components
27
+ * @name: styles.module.css
28
+ * @file: server/ab-name/styles.module.css
29
+ * @type: CSS Stylesheet
30
+ * @authors: Abraham Ukachi <abrahamukachi@gmail.com>
31
+ */
32
+
1
33
  .abName {
2
34
  display: inline-flex;
3
35
  align-items: baseline;
@@ -8,10 +8,11 @@
8
8
  * @project: ab-nextjs-components
9
9
  * @name: AbNavLink - Server (port of lyd-nav-link)
10
10
  * @file: server/ab-nav-link/index.tsx
11
+ * @authors: Abraham Ukachi <abrahamukachi@gmail.com>
11
12
  */
12
13
 
13
14
  import type { ReactElement } from 'react';
14
- import Link from 'next/link';
15
+ import Link from '../../ab-link'; // 🔗 G42: injectable via AbLinkProvider (default next/link)
15
16
  import clsx from 'clsx';
16
17
  import styles from './styles.module.css';
17
18
 
@@ -1,3 +1,35 @@
1
+ /*
2
+ * @license MIT
3
+ * ~~~~~~~~~~~~
4
+ * ab-nextjs-components
5
+ * ~~~~~~~~~~~~
6
+ * Copyright (c) 2026 Abraham Ukachi. The abElements Project.
7
+ *
8
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
9
+ * of this software and associated documentation files (the 'Software'), to deal
10
+ * in the Software without restriction, including without limitation the rights
11
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
12
+ * copies of the Software, and to permit persons to whom the Software is
13
+ * furnished to do so, subject to the following conditions:
14
+ *
15
+ * The above copyright notice and this permission notice shall be included in all
16
+ * copies or substantial portions of the Software.
17
+ *
18
+ * THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
19
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
20
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
21
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
22
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
23
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
24
+ * SOFTWARE.
25
+ *
26
+ * @project: ab-nextjs-components
27
+ * @name: styles.module.css
28
+ * @file: server/ab-nav-link/styles.module.css
29
+ * @type: CSS Stylesheet
30
+ * @authors: Abraham Ukachi <abrahamukachi@gmail.com>
31
+ */
32
+
1
33
  .abNavLink {
2
34
  display: inline-flex;
3
35
  align-items: center;