ab-nextjs-components 0.1.12 → 0.1.13

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 (119) hide show
  1. package/CHANGELOG.md +29 -0
  2. package/README.md +22 -0
  3. package/ab-app-bar/index.tsx +181 -0
  4. package/ab-app-bar/styles.module.css +119 -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-brand/index.tsx +1 -1
  10. package/ab-button/index.tsx +15 -2
  11. package/ab-button/styles.module.css +31 -0
  12. package/ab-card/index.tsx +89 -0
  13. package/ab-card/styles.module.css +68 -0
  14. package/ab-collapsible/index.tsx +1 -1
  15. package/ab-color/index.tsx +1 -0
  16. package/ab-color/styles.module.css +32 -0
  17. package/ab-demo-box/index.tsx +1 -0
  18. package/ab-demo-box/styles.module.css +32 -0
  19. package/ab-demo-code/index.tsx +1 -0
  20. package/ab-demo-code/styles.module.css +32 -0
  21. package/ab-icon/builtin.ts +15 -1
  22. package/ab-icon/helpers.ts +37 -0
  23. package/ab-icon/index.tsx +14 -8
  24. package/ab-icon/registrar.tsx +68 -0
  25. package/ab-icon-button/index.tsx +8 -3
  26. package/ab-image/index.tsx +1 -0
  27. package/ab-image/styles.module.css +32 -0
  28. package/ab-info/index.tsx +2 -1
  29. package/ab-info/styles.module.css +32 -0
  30. package/ab-input/index.tsx +1 -0
  31. package/ab-input/styles.module.css +1 -0
  32. package/ab-install-snippet/styles.module.css +16 -2
  33. package/ab-kbd/index.tsx +65 -0
  34. package/ab-kbd/styles.module.css +55 -0
  35. package/ab-key-feature/index.tsx +2 -1
  36. package/ab-key-feature/styles.module.css +32 -0
  37. package/ab-like-button/index.tsx +1 -1
  38. package/ab-link/index.tsx +112 -0
  39. package/ab-link/locale.ts +53 -0
  40. package/ab-locale-switcher/index.tsx +17 -0
  41. package/ab-locale-switcher/styles.module.css +11 -0
  42. package/ab-main-headline/index.tsx +1 -0
  43. package/ab-main-headline/styles.module.css +32 -0
  44. package/ab-menu/index.tsx +6 -5
  45. package/ab-menu/styles.module.css +32 -0
  46. package/ab-name/index.tsx +1 -0
  47. package/ab-name/styles.module.css +32 -0
  48. package/ab-navbar/index.tsx +54 -46
  49. package/ab-navbar/styles.module.css +84 -28
  50. package/ab-navbar/view.tsx +163 -0
  51. package/ab-package-card/index.tsx +94 -0
  52. package/ab-package-card/styles.module.css +41 -0
  53. package/ab-page-paginator/index.tsx +1 -0
  54. package/ab-page-paginator/styles.module.css +32 -0
  55. package/ab-page-switcher/index.tsx +1 -0
  56. package/ab-page-switcher/styles.module.css +32 -0
  57. package/ab-preview/index.tsx +1 -0
  58. package/ab-preview/styles.module.css +32 -0
  59. package/ab-price/index.tsx +1 -0
  60. package/ab-price/styles.module.css +32 -0
  61. package/ab-price-tag/index.tsx +1 -0
  62. package/ab-price-tag/styles.module.css +32 -0
  63. package/ab-product/index.tsx +1 -0
  64. package/ab-product/styles.module.css +32 -0
  65. package/ab-product-item/index.tsx +1 -0
  66. package/ab-product-item/styles.module.css +32 -0
  67. package/ab-search-result/index.tsx +1 -0
  68. package/ab-search-result/styles.module.css +32 -0
  69. package/ab-search-trigger/index.tsx +142 -0
  70. package/ab-search-trigger/styles.module.css +70 -0
  71. package/ab-sidebar/index.tsx +88 -49
  72. package/ab-sidebar/styles.module.css +136 -31
  73. package/ab-sidebar/view.tsx +182 -0
  74. package/ab-switch-back/index.tsx +2 -1
  75. package/ab-switch-back/styles.module.css +32 -0
  76. package/ab-tab/index.tsx +2 -1
  77. package/ab-tab/styles.module.css +32 -0
  78. package/ab-tabs/index.tsx +1 -0
  79. package/ab-tabs/styles.module.css +32 -0
  80. package/ab-test-hello/index.tsx +1 -0
  81. package/ab-test-hello/styles.module.css +32 -0
  82. package/ab-text/index.tsx +1 -0
  83. package/ab-text/styles.module.css +32 -0
  84. package/ab-toc/index.tsx +124 -0
  85. package/ab-toc/styles.module.css +54 -0
  86. package/css/chrome-mq.css +32 -0
  87. package/css/doodle.css +32 -0
  88. package/css/logo.css +32 -0
  89. package/css/spinner.css +32 -0
  90. package/css/toast.css +32 -0
  91. package/index.ts +18 -0
  92. package/package.json +27 -10
  93. package/server/ab-avatar/index.tsx +2 -1
  94. package/server/ab-avatar/styles.module.css +32 -0
  95. package/server/ab-badge/index.tsx +1 -0
  96. package/server/ab-badge/styles.module.css +32 -0
  97. package/server/ab-brand/index.tsx +1 -1
  98. package/server/ab-icon/index.tsx +13 -8
  99. package/server/ab-key-feature/index.tsx +2 -1
  100. package/server/ab-key-feature/styles.module.css +32 -0
  101. package/server/ab-name/index.tsx +1 -0
  102. package/server/ab-name/styles.module.css +32 -0
  103. package/server/ab-nav-link/index.tsx +2 -1
  104. package/server/ab-nav-link/styles.module.css +32 -0
  105. package/server/ab-navbar/index.tsx +44 -45
  106. package/server/ab-polygon/index.tsx +1 -0
  107. package/server/ab-polygon/styles.module.css +32 -0
  108. package/server/ab-sidebar/index.tsx +44 -49
  109. package/server/ab-switch-back/index.tsx +2 -1
  110. package/server/ab-switch-back/styles.module.css +32 -0
  111. package/server/ab-test-hello/index.tsx +1 -0
  112. package/server/ab-test-hello/styles.module.css +32 -0
  113. package/server/ab-text/index.tsx +1 -0
  114. package/server/ab-text/styles.module.css +32 -0
  115. package/server/index.ts +1 -0
  116. package/styles.css +32 -0
  117. package/types/index.d.ts +35 -0
  118. package/server/ab-navbar/styles.module.css +0 -35
  119. package/server/ab-sidebar/styles.module.css +0 -41
@@ -8,6 +8,7 @@
8
8
  * @project: ab-nextjs-components
9
9
  * @name: AbTestHello - Client (port of lyd-test-hello)
10
10
  * @file: ab-test-hello/index.tsx
11
+ * @authors: Abraham Ukachi <abrahamukachi@gmail.com>
11
12
  */
12
13
 
13
14
  'use client';
@@ -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: ab-test-hello/styles.module.css
29
+ * @type: CSS Stylesheet
30
+ * @authors: Abraham Ukachi <abrahamukachi@gmail.com>
31
+ */
32
+
1
33
  .abTestHello {
2
34
  display: flex;
3
35
  flex-direction: column;
package/ab-text/index.tsx CHANGED
@@ -8,6 +8,7 @@
8
8
  * @project: ab-nextjs-components
9
9
  * @name: AbText - Client (port of lyd-text; i18n stripped — pass value)
10
10
  * @file: ab-text/index.tsx
11
+ * @authors: Abraham Ukachi <abrahamukachi@gmail.com>
11
12
  */
12
13
 
13
14
  'use client';
@@ -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: ab-text/styles.module.css
29
+ * @type: CSS Stylesheet
30
+ * @authors: Abraham Ukachi <abrahamukachi@gmail.com>
31
+ */
32
+
1
33
  .abText {
2
34
  display: inline;
3
35
  }
@@ -0,0 +1,124 @@
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: AbToc (G46)
28
+ * @file: ab-toc/index.tsx
29
+ * @type: React Component (server-safe)
30
+ * @authors: Abraham Ukachi <abrahamukachi@gmail.com>
31
+ *
32
+ * Example usage:
33
+ * // 📏 core 0.1.6 panes: the page never scrolls, the main pane does (G55), so spy on and scroll IT
34
+ * const { mainScrollElement } = useAbPage(); // ✅ state from core, safe in render
35
+ * // without core: resolve the DOM node in an EFFECT, never during render (SSR + hydration safe)
36
+ * // const [main, setMain] = useState<HTMLElement | null>(null); useEffect(() => setMain(getAbMainScroller()), []);
37
+ * const activeId = useAbScrollSpy(items.map((i) => i.id), { root: mainScrollElement });
38
+ * <AbToc items={items} activeId={activeId} onNavigate={(id) => scrollToAbSection(id, { container: mainScrollElement })} />
39
+ */
40
+
41
+ /*
42
+ * !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
43
+ * MOTTO: We'll always do more 😜!!!
44
+ * !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
45
+ */
46
+
47
+ // ⚛️ React
48
+ import type { ReactElement } from 'react';
49
+ // 🧵 classes
50
+ import clsx from 'clsx';
51
+ // 🎨 styles
52
+ import styles from './styles.module.css';
53
+
54
+ /** 📜 0.1.13 (D35/G55): core 0.1.6 marks the panes main scroller with this attribute (components doesn't depend on core). */
55
+ export const AB_MAIN_SCROLLER_SELECTOR = '[data-ab-part="main-content"]';
56
+
57
+ /**
58
+ * 📜 getAbMainScroller — the element that scrolls the page content: the core panes main pane when present,
59
+ * else `null` (= the window). Pass `from` (e.g. the heading) to pick the pane that contains it.
60
+ * Use it as `useAbScrollSpy({ root })` / `scrollToAbSection(id, { container })`.
61
+ *
62
+ * ⚠️ Call it only in an effect or an event handler, **never during render**: it reads the DOM, so a render
63
+ * call returns `null` on the server and the element on the client (hydration mismatch). (James nit)
64
+ */
65
+ export function getAbMainScroller(from?: Element | null): HTMLElement | null {
66
+ if (typeof document === 'undefined') return null; // 🖥️ SSR
67
+ const own = from?.closest<HTMLElement>(AB_MAIN_SCROLLER_SELECTOR); // 🎯 the pane holding `from`
68
+ return own ?? document.querySelector<HTMLElement>(AB_MAIN_SCROLLER_SELECTOR); // 🔎 first main pane, or null
69
+ }
70
+
71
+ /** 📑 one heading */
72
+ export interface AbTocItem {
73
+ id: string; // 🆔 the heading id (link target)
74
+ label: string; // 🏷️
75
+ level?: 2 | 3 | 4; // 📏 indent (default 2)
76
+ }
77
+
78
+ /** ⚙️ props */
79
+ export interface AbTocProps {
80
+ items: AbTocItem[]; // 📑
81
+ activeId?: string | null; // 🎯 e.g. from useAbScrollSpy (hooks 0.1.7)
82
+ title?: string; // 🏷️ default "On this page"
83
+ label?: string; // 🏷️ 0.1.13 (Joseph #16): alias of `title`; `title` wins when both are set
84
+ onNavigate?: (id: string) => void; // 🔔 e.g. scrollToAbSection(id, { container }) (hooks 0.1.7); without it a plain #id jump, which scrolls the nearest scroller (the main pane in core 0.1.6 panes)
85
+ id?: string; // 🆔 root id (default "ab-toc"); the title gets `${id}-title`
86
+ className?: string; // 🏷️
87
+ }
88
+
89
+ /**
90
+ * 📑 AbToc (G46): "On this page" list of plain `#id` links (works without JS), the current one marked with
91
+ * aria-current="location". Pair with `useAbScrollSpy` from ab-nextjs-hooks 0.1.7 for `activeId`.
92
+ * No hooks here, so it also renders on the server.
93
+ */
94
+ const AbToc = ({ items, activeId, label, title = label ?? 'On this page', onNavigate, id = 'ab-toc', className }: AbTocProps): ReactElement | null => {
95
+ if (!items.length) return null; // 🙈 nothing to list
96
+ const headingId = `${id}-title`; // 🆔
97
+ return (
98
+ <nav id={id} className={clsx('AbToc', styles.abToc, className)} data-ab-part="toc" aria-labelledby={headingId}>
99
+ <p id={headingId} className={styles.abTocTitle}>{title}</p>
100
+ <ol className={styles.abTocList}>
101
+ {items.map((it) => {
102
+ const on = it.id === activeId; // 🎯
103
+ return (
104
+ <li key={it.id} data-level={it.level ?? 2}>
105
+ <a
106
+ href={`#${it.id}`} // 🔗 JS-off friendly
107
+ className={styles.abTocLink}
108
+ data-active={on ? 'true' : 'false'}
109
+ aria-current={on ? 'location' : undefined} // ♿
110
+ onClick={onNavigate ? (e) => { e.preventDefault(); onNavigate(it.id); } : undefined}
111
+ >
112
+ {it.label}
113
+ </a>
114
+ </li>
115
+ );
116
+ })}
117
+ </ol>
118
+ </nav>
119
+ );
120
+ };
121
+
122
+ // 📦 exports
123
+ export default AbToc;
124
+ export { AbToc };
@@ -0,0 +1,54 @@
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: AbToc - Styles (G46)
28
+ * @file: ab-toc/styles.module.css
29
+ * @type: CSS Module
30
+ * @authors: Abraham Ukachi <abrahamukachi@gmail.com>
31
+ */
32
+
33
+ /*
34
+ * !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
35
+ * MOTTO: We'll always do more 😜!!!
36
+ * !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
37
+ */
38
+
39
+ .abToc { font-size: 14px; } /* 📑 */
40
+ .abTocTitle { margin: 0 0 8px; font-size: 12px; font-weight: 600; letter-spacing: 0.04em; text-transform: uppercase; opacity: 0.75; } /* 🏷️ */
41
+ .abTocList { list-style: none; margin: 0; padding: 0; border-inline-start: var(--ab-divider-hairline, 1px solid rgb(0 0 0 / 0.12)); } /* ➖ */
42
+ .abTocList > li[data-level='3'] { padding-inline-start: 12px; } /* 📏 */
43
+ .abTocList > li[data-level='4'] { padding-inline-start: 24px; } /* 📏 */
44
+ .abTocLink {
45
+ display: block; /* 📐 */
46
+ margin-inline-start: -1px; /* ➖ sit on the rail */
47
+ padding: 4px 12px; /* 📦 */
48
+ border-inline-start: 2px solid transparent; /* ➖ */
49
+ color: var(--ab-color-on-surface-variant, inherit); /* 🖋️ */
50
+ text-decoration: none; /* 🚫 */
51
+ }
52
+ .abTocLink:hover { color: var(--ab-color-on-surface, inherit); } /* 🖱️ */
53
+ .abTocLink[data-active='true'] { border-inline-start-color: var(--ab-color-primary, currentColor); color: var(--ab-color-primary, inherit); font-weight: 600; } /* 🎯 */
54
+ .abTocLink:focus-visible { outline: var(--ab-focus-ring-width, 2px) solid var(--ab-color-primary, #8f4c38); outline-offset: var(--ab-focus-ring-offset, 2px); } /* ♿ */
package/css/chrome-mq.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: chrome-mq.css
28
+ * @file: css/chrome-mq.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/doodle.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: doodle.css
28
+ * @file: css/doodle.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/logo.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: logo.css
28
+ * @file: css/logo.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/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,20 @@ 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' },
119
133
  ]
120
134
 
121
135
  const abComponents = { supportedComponents }
@@ -124,6 +138,7 @@ export { supportedComponents }
124
138
  export default abComponents
125
139
 
126
140
  export { default as AbIcon } from './ab-icon/index.tsx'
141
+ export { AbIconRegistrar } from './ab-icon/registrar.tsx' // 🗂️ server-safe icon registration (0.1.13)
127
142
  export { default as AbLogo } from './ab-logo/index.tsx'
128
143
  // 📶 progress bar
129
144
  export { default as AbLinearProgress } from './ab-linear-progress/index.tsx'
@@ -151,6 +166,9 @@ export { default as AbBrand } from './ab-brand/index.tsx'
151
166
  export { default as AbName } from './ab-name/index.tsx'
152
167
  export { default as AbNavbar } from './ab-navbar/index.tsx'
153
168
  export { default as AbSidebar } from './ab-sidebar/index.tsx'
169
+ // 📑 0.1.13 (Joseph): AbToc + the panes main-scroller helpers (also at `ab-nextjs-components/ab-toc`)
170
+ export { default as AbToc, getAbMainScroller, AB_MAIN_SCROLLER_SELECTOR } from './ab-toc/index.tsx'
171
+ export type { AbTocItem, AbTocProps } from './ab-toc/index.tsx'
154
172
  export { default as AbText } from './ab-text/index.tsx'
155
173
  export { default as AbTestHello } from './ab-test-hello/index.tsx'
156
174
  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.13",
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.4",
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.4",
60
60
  "clsx": "^2.1.1",
61
61
  "esbuild": "^0.28.2",
62
62
  "eslint": "^9.39.0",
@@ -123,7 +123,14 @@
123
123
  "ab-logo/ab-logo.svg",
124
124
  "styles.css",
125
125
  "css",
126
- "assets"
126
+ "assets",
127
+ "ab-link",
128
+ "ab-kbd",
129
+ "ab-search-trigger",
130
+ "ab-app-bar",
131
+ "ab-card",
132
+ "ab-package-card",
133
+ "ab-toc"
127
134
  ],
128
135
  "exports": {
129
136
  ".": {
@@ -132,6 +139,7 @@
132
139
  },
133
140
  "./package.json": "./package.json",
134
141
  "./ab-icon": "./ab-icon/index.tsx",
142
+ "./ab-icon/registrar": "./ab-icon/registrar.tsx",
135
143
  "./ab-logo": "./ab-logo/index.tsx",
136
144
  "./ab-linear-progress": "./ab-linear-progress/index.tsx",
137
145
  "./ab-splash": "./ab-splash/index.tsx",
@@ -204,7 +212,16 @@
204
212
  "./server/ab-switch-back": "./server/ab-switch-back/index.tsx",
205
213
  "./styles.css": "./styles.css",
206
214
  "./css/*": "./css/*",
207
- "./assets/*": "./assets/*"
215
+ "./assets/*": "./assets/*",
216
+ "./ab-link": "./ab-link/index.tsx",
217
+ "./ab-kbd": "./ab-kbd/index.tsx",
218
+ "./ab-search-trigger": "./ab-search-trigger/index.tsx",
219
+ "./ab-app-bar": "./ab-app-bar/index.tsx",
220
+ "./ab-card": "./ab-card/index.tsx",
221
+ "./ab-package-card": "./ab-package-card/index.tsx",
222
+ "./ab-toc": "./ab-toc/index.tsx",
223
+ "./ab-sidebar/view": "./ab-sidebar/view.tsx",
224
+ "./ab-navbar/view": "./ab-navbar/view.tsx"
208
225
  },
209
226
  "peerDependenciesMeta": {
210
227
  "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';