ozdenui 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (149) hide show
  1. checksums.yaml +7 -0
  2. data/LICENSE +14 -0
  3. data/NOTICE +5 -0
  4. data/README.md +242 -0
  5. data/exe/ozdenui +17 -0
  6. data/lib/ozdenui/AGENTS.md +210 -0
  7. data/lib/ozdenui/COMPONENTS.md +3017 -0
  8. data/lib/ozdenui/app.rb +749 -0
  9. data/lib/ozdenui/command.rb +107 -0
  10. data/lib/ozdenui/components.rb +368 -0
  11. data/lib/ozdenui/dialogs.rb +212 -0
  12. data/lib/ozdenui/files.rb +124 -0
  13. data/lib/ozdenui/icon.png +0 -0
  14. data/lib/ozdenui/kit.json +1 -0
  15. data/lib/ozdenui/kit.rb +115 -0
  16. data/lib/ozdenui/look.rb +229 -0
  17. data/lib/ozdenui/objects.rb +652 -0
  18. data/lib/ozdenui/server.rb +270 -0
  19. data/lib/ozdenui/values.rb +273 -0
  20. data/lib/ozdenui/version.rb +15 -0
  21. data/lib/ozdenui/web/basic/LICENSE +14 -0
  22. data/lib/ozdenui/web/basic/basic.min.css +1 -0
  23. data/lib/ozdenui/web/basic/basic.min.js +78 -0
  24. data/lib/ozdenui/web/basic/font/open-sans/LICENSE.txt +206 -0
  25. data/lib/ozdenui/web/basic/font/open-sans/OpenSans-Bold.ttf +0 -0
  26. data/lib/ozdenui/web/basic/font/open-sans/OpenSans-Regular.ttf +0 -0
  27. data/lib/ozdenui/web/basic/scroll-bar.min.js +3 -0
  28. data/lib/ozdenui/web/bridge.js +584 -0
  29. data/lib/ozdenui/web/comp/accordion.js +659 -0
  30. data/lib/ozdenui/web/comp/action-button/add.png +0 -0
  31. data/lib/ozdenui/web/comp/action-button.js +521 -0
  32. data/lib/ozdenui/web/comp/action-tab-bar.js +383 -0
  33. data/lib/ozdenui/web/comp/app-bar.js +237 -0
  34. data/lib/ozdenui/web/comp/badge.js +292 -0
  35. data/lib/ozdenui/web/comp/bottom-bar.js +555 -0
  36. data/lib/ozdenui/web/comp/breadcrumbs.js +524 -0
  37. data/lib/ozdenui/web/comp/canvas.js +652 -0
  38. data/lib/ozdenui/web/comp/chat-view.js +827 -0
  39. data/lib/ozdenui/web/comp/check-box.js +490 -0
  40. data/lib/ozdenui/web/comp/code-editor.js +965 -0
  41. data/lib/ozdenui/web/comp/color-picker.js +636 -0
  42. data/lib/ozdenui/web/comp/context-menu.js +951 -0
  43. data/lib/ozdenui/web/comp/currency-field.js +209 -0
  44. data/lib/ozdenui/web/comp/data-table/arrow.svg +2 -0
  45. data/lib/ozdenui/web/comp/data-table.js +937 -0
  46. data/lib/ozdenui/web/comp/date-picker.js +1055 -0
  47. data/lib/ozdenui/web/comp/dialog.js +992 -0
  48. data/lib/ozdenui/web/comp/email-field.js +65 -0
  49. data/lib/ozdenui/web/comp/file-picker.js +920 -0
  50. data/lib/ozdenui/web/comp/filters.js +807 -0
  51. data/lib/ozdenui/web/comp/form.js +602 -0
  52. data/lib/ozdenui/web/comp/full-screen-select/arrow.svg +2 -0
  53. data/lib/ozdenui/web/comp/full-screen-select/cancel.svg +2 -0
  54. data/lib/ozdenui/web/comp/full-screen-select.js +614 -0
  55. data/lib/ozdenui/web/comp/gauge.js +439 -0
  56. data/lib/ozdenui/web/comp/graph-box.js +3911 -0
  57. data/lib/ozdenui/web/comp/grid-group.js +185 -0
  58. data/lib/ozdenui/web/comp/hold-to-confirm-button/trash-red.png +0 -0
  59. data/lib/ozdenui/web/comp/hold-to-confirm-button/trash.png +0 -0
  60. data/lib/ozdenui/web/comp/hold-to-confirm-button.js +289 -0
  61. data/lib/ozdenui/web/comp/image-view.js +598 -0
  62. data/lib/ozdenui/web/comp/item-list.js +1740 -0
  63. data/lib/ozdenui/web/comp/json-editor.js +3221 -0
  64. data/lib/ozdenui/web/comp/json-view.js +597 -0
  65. data/lib/ozdenui/web/comp/label-editor.js +1140 -0
  66. data/lib/ozdenui/web/comp/left-menu/data-table.png +0 -0
  67. data/lib/ozdenui/web/comp/left-menu/home.png +0 -0
  68. data/lib/ozdenui/web/comp/left-menu/reports.png +0 -0
  69. data/lib/ozdenui/web/comp/left-menu/setting.png +0 -0
  70. data/lib/ozdenui/web/comp/left-menu.js +548 -0
  71. data/lib/ozdenui/web/comp/line-progress-bar.js +343 -0
  72. data/lib/ozdenui/web/comp/loading-screen.js +413 -0
  73. data/lib/ozdenui/web/comp/log-view.js +530 -0
  74. data/lib/ozdenui/web/comp/login-page.js +685 -0
  75. data/lib/ozdenui/web/comp/markdown-view.js +1045 -0
  76. data/lib/ozdenui/web/comp/menu-bar.js +624 -0
  77. data/lib/ozdenui/web/comp/mini-graph-box.js +492 -0
  78. data/lib/ozdenui/web/comp/minimal-accent.js +208 -0
  79. data/lib/ozdenui/web/comp/notice.js +229 -0
  80. data/lib/ozdenui/web/comp/number-field.js +128 -0
  81. data/lib/ozdenui/web/comp/numeric-keyboard.js +298 -0
  82. data/lib/ozdenui/web/comp/page-control.js +762 -0
  83. data/lib/ozdenui/web/comp/page-header.js +191 -0
  84. data/lib/ozdenui/web/comp/password-field/hide-btn.png +0 -0
  85. data/lib/ozdenui/web/comp/password-field/hide-btn2.png +0 -0
  86. data/lib/ozdenui/web/comp/password-field/show-btn.png +0 -0
  87. data/lib/ozdenui/web/comp/password-field/show-btn2.png +0 -0
  88. data/lib/ozdenui/web/comp/password-field.js +192 -0
  89. data/lib/ozdenui/web/comp/period-bar.js +436 -0
  90. data/lib/ozdenui/web/comp/phone-field.js +322 -0
  91. data/lib/ozdenui/web/comp/progress-bar.js +992 -0
  92. data/lib/ozdenui/web/comp/property-panel.js +3639 -0
  93. data/lib/ozdenui/web/comp/radio-button.js +527 -0
  94. data/lib/ozdenui/web/comp/range-slider.js +569 -0
  95. data/lib/ozdenui/web/comp/rich-text-editor.js +1064 -0
  96. data/lib/ozdenui/web/comp/scroll-area.js +308 -0
  97. data/lib/ozdenui/web/comp/scrolling-text.js +297 -0
  98. data/lib/ozdenui/web/comp/search-input/clear-round.svg +1 -0
  99. data/lib/ozdenui/web/comp/search-input/clear.svg +1 -0
  100. data/lib/ozdenui/web/comp/search-input/filter.png +0 -0
  101. data/lib/ozdenui/web/comp/search-input/filter.svg +1 -0
  102. data/lib/ozdenui/web/comp/search-input/search.svg +1 -0
  103. data/lib/ozdenui/web/comp/search-input.js +725 -0
  104. data/lib/ozdenui/web/comp/search-results.js +596 -0
  105. data/lib/ozdenui/web/comp/select-box.js +1862 -0
  106. data/lib/ozdenui/web/comp/settings-row.js +299 -0
  107. data/lib/ozdenui/web/comp/side-panel.js +616 -0
  108. data/lib/ozdenui/web/comp/slider-field.js +952 -0
  109. data/lib/ozdenui/web/comp/slider.js +838 -0
  110. data/lib/ozdenui/web/comp/smart-button/alert-black.png +0 -0
  111. data/lib/ozdenui/web/comp/smart-button/clock.png +0 -0
  112. data/lib/ozdenui/web/comp/smart-button.js +981 -0
  113. data/lib/ozdenui/web/comp/smart-table/clock.png +0 -0
  114. data/lib/ozdenui/web/comp/smart-table/down.png +0 -0
  115. data/lib/ozdenui/web/comp/smart-table/scroll.png +0 -0
  116. data/lib/ozdenui/web/comp/smart-table/sort.png +0 -0
  117. data/lib/ozdenui/web/comp/smart-table/up.png +0 -0
  118. data/lib/ozdenui/web/comp/smart-table.js +1883 -0
  119. data/lib/ozdenui/web/comp/sortable-list.js +1181 -0
  120. data/lib/ozdenui/web/comp/spark-line-box.js +738 -0
  121. data/lib/ozdenui/web/comp/splitter.js +411 -0
  122. data/lib/ozdenui/web/comp/status-bar.js +408 -0
  123. data/lib/ozdenui/web/comp/step-bar.js +345 -0
  124. data/lib/ozdenui/web/comp/stepper.js +753 -0
  125. data/lib/ozdenui/web/comp/tabs.js +1366 -0
  126. data/lib/ozdenui/web/comp/tag-input.js +1107 -0
  127. data/lib/ozdenui/web/comp/tap-effect.js +170 -0
  128. data/lib/ozdenui/web/comp/text-area-field.js +233 -0
  129. data/lib/ozdenui/web/comp/text-field.js +1006 -0
  130. data/lib/ozdenui/web/comp/time-line.js +398 -0
  131. data/lib/ozdenui/web/comp/time-picker.js +1032 -0
  132. data/lib/ozdenui/web/comp/tiny-select/arrow.svg +1 -0
  133. data/lib/ozdenui/web/comp/tiny-select.js +322 -0
  134. data/lib/ozdenui/web/comp/tiny-table.js +283 -0
  135. data/lib/ozdenui/web/comp/toast.js +891 -0
  136. data/lib/ozdenui/web/comp/toggle.js +757 -0
  137. data/lib/ozdenui/web/comp/tool-bar.js +760 -0
  138. data/lib/ozdenui/web/comp/tooltip.js +534 -0
  139. data/lib/ozdenui/web/comp/tree-view.js +1179 -0
  140. data/lib/ozdenui/web/comp/ui-effects.js +1097 -0
  141. data/lib/ozdenui/web/comp/ui-standards.js +403 -0
  142. data/lib/ozdenui/web/comp/url-field.js +190 -0
  143. data/lib/ozdenui/web/comp/web-view.js +588 -0
  144. data/lib/ozdenui/web/components.js +123 -0
  145. data/lib/ozdenui/web/index.html +39 -0
  146. data/lib/ozdenui/window.rb +188 -0
  147. data/lib/ozdenui/window_cocoa.rb +221 -0
  148. data/lib/ozdenui.rb +32 -0
  149. metadata +200 -0
@@ -0,0 +1,524 @@
1
+ /* Bismillah */
2
+
3
+ /*
4
+
5
+ Breadcrumbs - v26.09
6
+
7
+ UI COMPONENT TEMPLATE
8
+ - Shows the location of the current page in a hierarchy. (Ex: Home / Products / Laptops)
9
+ - The last item is the current page: not clickable, bold, aria-current="page".
10
+ - Separator: "chevron" (drawn with code) or any text. (Ex: "/", "›", "•")
11
+ - Collapse: With maxItems, the middle items are shown as "…". Click it to expand.
12
+ - Items can have an icon (iconFile) and a url.
13
+ - Keyboard: Tab to focus an item, Enter or Space to click.
14
+
15
+ ITEM: { text, key, url, iconFile, data }
16
+ - A string is also accepted: "Home" -> { text: "Home" }
17
+ - url: If it is set, the page goes to the url on click. (onClick can return false to stop it.)
18
+
19
+ Started Date: September 2026
20
+ Webpage: https://bug7a.github.io/js-components/
21
+
22
+ Copyright 2020-2026 Bugra Ozden <bugra.ozden@gmail.com> (https://bug7a.github.io/)
23
+ Licensed under the Apache License, Version 2.0
24
+ SPDX-License-Identifier: Apache-2.0
25
+
26
+ */
27
+
28
+ "use strict";
29
+
30
+ // Default values:
31
+ const BreadcrumbsDefaults = {
32
+ key: "0",
33
+ width: "auto", // "auto": Wraps the items. A number or "100%": Fixed width.
34
+ height: "auto",
35
+ items: [], // [{ text, key, url, iconFile, data }] or ["Home", "Products"]
36
+ separator: "chevron", // "chevron" or a text. (Ex: "/", "›", "•")
37
+ maxItems: 0, // 0: No collapse. Ex: 4 -> Home / … / Laptops / Lenovo
38
+ itemsBeforeCollapse: 1,
39
+ itemsAfterCollapse: 2,
40
+ maxItemWidth: 180, // Long texts are cut with "...". 0: No limit.
41
+ wrap: 0, // 1: Items move to the next line when there is no space.
42
+ trimOnClick: 0, // 1: Clicking an item removes the items after it. (In-app navigation)
43
+ currentClickable: 0, // 1: The last item can be clicked too.
44
+ enabled: 1,
45
+ ariaLabel: "Breadcrumb",
46
+ onClick: function (self, item, index) { }, // return false: Do not go to item.url
47
+ onChange: function (self) { }, // When items change with code or trimOnClick.
48
+ style: {
49
+ layout: {
50
+ gap: 4,
51
+ },
52
+ item: {
53
+ fontSize: 14,
54
+ textColor: Black(0.55),
55
+ color: "transparent",
56
+ round: 6,
57
+ padding: [6, 3],
58
+ },
59
+ itemHover: {
60
+ textColor: Black(0.9),
61
+ color: Black(0.05),
62
+ },
63
+ current: {
64
+ textColor: Black(0.85),
65
+ fontFamily: "opensans-bold",
66
+ },
67
+ separator: {
68
+ fontSize: 14,
69
+ textColor: Black(0.3),
70
+ size: 6, // Chevron size
71
+ },
72
+ icon: {
73
+ width: 16,
74
+ height: 16,
75
+ },
76
+ focus: {
77
+ color: "#3871E0",
78
+ },
79
+ disabled: {
80
+ opacity: 0.4,
81
+ },
82
+ }
83
+ };
84
+
85
+ const Breadcrumbs = function (params = {}) {
86
+
87
+ // Merge params:
88
+ mergeIntoIfMissing(params, BreadcrumbsDefaults);
89
+
90
+ // Edit params, if needed:
91
+ params.color = "transparent";
92
+ params.height = "auto";
93
+ const isAutoWidth = (String(params.width) === "auto"); // WHY: Read before startObject: box.width gives the measured width, never "auto".
94
+
95
+ // BOX: Component container
96
+ let box = startObject(params);
97
+
98
+ // *** PRIVATE VARIABLES:
99
+ const _s = box.style;
100
+ let parts = []; // Created objects (items, separators, ellipsis)
101
+ let isExpanded = 0;
102
+
103
+ // *** PUBLIC VARIABLES:
104
+ // [var] Items: [{ text, key, url, iconFile, data }]
105
+ box.items = [];
106
+
107
+ // *** PRIVATE FUNCTIONS:
108
+
109
+ // WHY: Not the createIn() of basic.js: render() needs the start stack of the caller (see its WHY line).
110
+ const createPartsIn = function (container, func) {
111
+ const previous = getDefaultContainerBox();
112
+ setDefaultContainerBox(container);
113
+ func();
114
+ setDefaultContainerBox(previous);
115
+ };
116
+
117
+ const normalizeItem = function (item) {
118
+ if (typeof item == "string" || typeof item == "number") {
119
+ return { text: String(item) };
120
+ }
121
+ return Object.assign({ text: "" }, item);
122
+ };
123
+
124
+ // Returns: [{ type: "item", item, index }, { type: "ellipsis" }, ...]
125
+ const getVisibleEntries = function () {
126
+
127
+ const count = box.items.length;
128
+ const before = Math.max(1, box.itemsBeforeCollapse);
129
+ const after = Math.max(1, box.itemsAfterCollapse);
130
+
131
+ const entries = box.items.map(function (item, index) {
132
+ return { type: "item", item: item, index: index };
133
+ });
134
+
135
+ // WHY: Collapse only if it hides at least 2 items. Hiding 1 item behind "…" saves no space.
136
+ const needsCollapse = box.maxItems > 0 && count > box.maxItems && count - before - after >= 2;
137
+ if (!needsCollapse || isExpanded) return entries;
138
+
139
+ return entries.slice(0, before)
140
+ .concat([{ type: "ellipsis" }])
141
+ .concat(entries.slice(count - after));
142
+
143
+ };
144
+
145
+ // style.item.padding: 4 or [x, y] -> [x, y]
146
+ const getPadding = function () {
147
+ const padding = _s.item.padding;
148
+ if (!Array.isArray(padding)) {
149
+ const size = basic.num(padding) || 0;
150
+ return [size, size];
151
+ }
152
+ const paddingY = (padding.length > 1) ? padding[1] : padding[0];
153
+ return [padding[0], paddingY];
154
+ };
155
+
156
+ // CSS padding text: "3px 6px"
157
+ const getPaddingCss = function () {
158
+ const padding = getPadding();
159
+ return padding[1] + "px " + padding[0] + "px";
160
+ };
161
+
162
+ const setItemHover = function (itemBox, isOver) {
163
+ const style = (isOver) ? _s.itemHover : _s.item;
164
+ itemBox.color = style.color;
165
+ itemBox.label.textColor = style.textColor;
166
+ };
167
+
168
+ // Visible focus ring only for the keyboard. (Not for a mouse click.)
169
+ const addFocusRing = function (obj) {
170
+ obj.on("focus", function () {
171
+ if (obj.elem.matches(":focus-visible")) {
172
+ obj.boxShadow = "0 0 0 2px " + _s.focus.color;
173
+ }
174
+ });
175
+ obj.on("blur", function () {
176
+ obj.boxShadow = "none";
177
+ });
178
+ };
179
+
180
+ // Makes an object work like a link: role, tab, Enter/Space.
181
+ const makeClickable = function (obj, func) {
182
+
183
+ obj.role = "link";
184
+ obj.tabIndex = (box.enabled == 1) ? 0 : -1;
185
+ obj.cursor = (box.enabled == 1) ? "pointer" : "default";
186
+ obj.css.outline = "none";
187
+ obj.clickable = 1;
188
+
189
+ obj.on("click", function (self, event) {
190
+ if (box.enabled == 1) func(event);
191
+ });
192
+
193
+ obj.on("keydown", function (self, event) {
194
+ if (event.key === "Enter" || event.key === " ") {
195
+ event.preventDefault();
196
+ if (box.enabled == 1) func(event);
197
+ }
198
+ });
199
+
200
+ addFocusRing(obj);
201
+
202
+ };
203
+
204
+ const createSeparator = function () {
205
+
206
+ let sep;
207
+
208
+ if (box.separator == "chevron") {
209
+
210
+ const size = _s.separator.size;
211
+
212
+ // BOX: Chevron (a rotated corner)
213
+ sep = Box({
214
+ width: size,
215
+ height: size,
216
+ color: "transparent",
217
+ });
218
+ sep.css = {
219
+ borderTop: "1.5px solid " + _s.separator.textColor,
220
+ borderRight: "1.5px solid " + _s.separator.textColor,
221
+ transform: "rotate(45deg)",
222
+ margin: "0 " + Math.round(size / 2 + 2) + "px 0 " + Math.round(size / 2) + "px",
223
+ };
224
+
225
+ } else {
226
+
227
+ // LABEL: Text separator
228
+ sep = Label({
229
+ plainText: box.separator,
230
+ fontSize: _s.separator.fontSize,
231
+ textColor: _s.separator.textColor,
232
+ });
233
+ sep.css = { whiteSpace: "nowrap", padding: "0 2px" };
234
+
235
+ }
236
+
237
+ sep.shrink = 0;
238
+ sep.aria = { hidden: "true" }; // WHY: Screen readers should not read "/" between items.
239
+ return sep;
240
+
241
+ };
242
+
243
+ const createEllipsis = function () {
244
+
245
+ const btn = Label({
246
+ text: "…",
247
+ fontSize: _s.item.fontSize,
248
+ textColor: _s.item.textColor,
249
+ color: _s.item.color,
250
+ round: _s.item.round,
251
+ });
252
+ btn.css.padding = getPaddingCss();
253
+ btn.shrink = 0;
254
+ btn.elem.title = "Show all";
255
+ btn.aria = { label: "Show all items" };
256
+
257
+ makeClickable(btn, function () {
258
+ box.expand();
259
+ });
260
+
261
+ btn.on("mouseenter", function () {
262
+ if (box.enabled != 1) return;
263
+ btn.color = _s.itemHover.color;
264
+ btn.textColor = _s.itemHover.textColor;
265
+ });
266
+ btn.on("mouseleave", function () {
267
+ btn.color = _s.item.color;
268
+ btn.textColor = _s.item.textColor;
269
+ });
270
+
271
+ return btn;
272
+
273
+ };
274
+
275
+ const createItem = function (item, index) {
276
+
277
+ const isCurrent = (index == box.items.length - 1);
278
+ const isClickable = !isCurrent || box.currentClickable == 1;
279
+
280
+ // GROUP: Item (icon + label)
281
+ const itemBox = HGroup({
282
+ width: "auto",
283
+ height: "auto",
284
+ align: "left center",
285
+ gap: 6,
286
+ color: _s.item.color,
287
+ round: _s.item.round,
288
+ });
289
+ itemBox.css = { padding: getPaddingCss(), minWidth: "0" };
290
+ itemBox.shrink = (isCurrent) ? 1 : 0;
291
+ itemBox.setMotion("background-color 0.15s");
292
+ itemBox.item = item;
293
+ itemBox.index = index;
294
+
295
+ // ICON: Optional
296
+ if (item.iconFile) {
297
+ itemBox.icon = Icon({
298
+ width: _s.icon.width,
299
+ height: _s.icon.height,
300
+ });
301
+ itemBox.icon.shrink = 0;
302
+ itemBox.icon.elem.alt = "";
303
+ itemBox.icon.load(item.iconFile);
304
+ }
305
+
306
+ // LABEL: Text
307
+ itemBox.label = Label({
308
+ plainText: item.text,
309
+ fontSize: _s.item.fontSize,
310
+ textColor: (isCurrent) ? _s.current.textColor : _s.item.textColor,
311
+ });
312
+ if (isCurrent && _s.current.fontFamily) itemBox.label.css.fontFamily = _s.current.fontFamily;
313
+ itemBox.label.ellipsis = 1;
314
+ if (box.maxItemWidth > 0) itemBox.label.css.maxWidth = box.maxItemWidth + "px";
315
+ if (item.text) itemBox.elem.title = item.text; // Full text on mouse over
316
+
317
+ endGroup();
318
+
319
+ if (isCurrent) {
320
+ itemBox.aria = { current: "page" };
321
+ }
322
+
323
+ if (isClickable) {
324
+
325
+ makeClickable(itemBox, function (event) {
326
+ box.clickItem(index, event);
327
+ });
328
+
329
+ itemBox.on("mouseenter", function () {
330
+ if (box.enabled == 1) setItemHover(itemBox, 1);
331
+ });
332
+ itemBox.on("mouseleave", function () {
333
+ setItemHover(itemBox, 0);
334
+ if (isCurrent) itemBox.label.textColor = _s.current.textColor;
335
+ });
336
+
337
+ }
338
+
339
+ return itemBox;
340
+
341
+ };
342
+
343
+ const render = function () {
344
+
345
+ parts.forEach(function (obj) { obj.remove(); });
346
+ parts = [];
347
+
348
+ createPartsIn(box.content, function () {
349
+
350
+ getVisibleEntries().forEach(function (entry, i) {
351
+
352
+ // WHY: endGroup() (in createItem) sets the container to the last started group, not to box.content.
353
+ // While the page is still being created, that is another box. So set it again for every part.
354
+ setDefaultContainerBox(box.content);
355
+ if (i > 0) parts.push(createSeparator());
356
+
357
+ setDefaultContainerBox(box.content);
358
+ if (entry.type == "ellipsis") {
359
+ parts.push(createEllipsis());
360
+ } else {
361
+ parts.push(createItem(entry.item, entry.index));
362
+ }
363
+
364
+ });
365
+
366
+ });
367
+
368
+ updateView();
369
+
370
+ };
371
+
372
+ const updateView = function () {
373
+ box.opacity = (box.enabled == 1) ? 1 : _s.disabled.opacity;
374
+ box.content.css.flexWrap = (box.wrap == 1) ? "wrap" : "nowrap";
375
+ box.aria = { disabled: (box.enabled == 1) ? "false" : "true" };
376
+ };
377
+
378
+ const setItemsSilent = function (items) {
379
+ box.items = (items || []).map(normalizeItem);
380
+ isExpanded = 0;
381
+ render();
382
+ };
383
+
384
+ // *** PUBLIC FUNCTIONS:
385
+
386
+ box.setItems = function (items, silent = 0) {
387
+ setItemsSilent(items);
388
+ if (!silent) box.onChange(box);
389
+ };
390
+ // USAGE: breadcrumbs.setItems(["Home", "Products", { text: "Laptops", key: "laptops" }])
391
+
392
+ box.getItems = function () {
393
+ return box.items.slice();
394
+ };
395
+
396
+ box.getCurrentItem = function () {
397
+ return box.items[box.items.length - 1] || null;
398
+ };
399
+
400
+ // Add a new item to the end. It becomes the current item.
401
+ box.addItem = function (item) {
402
+ box.items.push(normalizeItem(item));
403
+ render();
404
+ box.onChange(box);
405
+ };
406
+
407
+ // Keep the items until the index. (Removes the items after it.)
408
+ box.goTo = function (index) {
409
+ if (index < 0 || index >= box.items.length - 1) return;
410
+ box.items = box.items.slice(0, index + 1);
411
+ isExpanded = 0;
412
+ render();
413
+ box.onChange(box);
414
+ };
415
+
416
+ // Remove the current item. (Go one level up.)
417
+ box.back = function () {
418
+ box.goTo(box.items.length - 2);
419
+ };
420
+
421
+ // Same as a user click. (onClick, url, trimOnClick)
422
+ box.clickItem = function (index, event) {
423
+
424
+ const item = box.items[index];
425
+ if (!item || box.enabled != 1) return;
426
+
427
+ const result = box.onClick(box, item, index, event);
428
+
429
+ if (box.trimOnClick == 1) box.goTo(index);
430
+
431
+ if (item.url && result !== false) {
432
+ basic.go(item.url);
433
+ }
434
+
435
+ };
436
+
437
+ // Show all the collapsed items.
438
+ box.expand = function () {
439
+ if (isExpanded) return;
440
+ isExpanded = 1;
441
+ render();
442
+ // WHY: The ellipsis button is removed. Keep the keyboard focus inside the component.
443
+ const firstHidden = parts.find(function (obj) { return obj.index == Math.max(1, box.itemsBeforeCollapse); });
444
+ if (firstHidden && box.enabled == 1) firstHidden.elem.focus();
445
+ };
446
+
447
+ box.collapse = function () {
448
+ if (!isExpanded) return;
449
+ isExpanded = 0;
450
+ render();
451
+ };
452
+
453
+ box.setSeparator = function (separator) {
454
+ box.separator = separator;
455
+ render();
456
+ };
457
+ // USAGE: breadcrumbs.setSeparator("/") or breadcrumbs.setSeparator("chevron")
458
+
459
+ box.setMaxItems = function (maxItems) {
460
+ box.maxItems = basic.num(maxItems);
461
+ isExpanded = 0;
462
+ render();
463
+ };
464
+
465
+ box.setEnabled = function (enabled) {
466
+ box.enabled = basic.isOn(enabled) ? 1 : 0;
467
+ render(); // WHY: tabIndex and cursor of every item change.
468
+ };
469
+ // USAGE: get: breadcrumbs.enabled, set: breadcrumbs.setEnabled(0)
470
+
471
+ box.refresh = function () {
472
+ render();
473
+ };
474
+
475
+
476
+ // *** OBJECT VIEW:
477
+
478
+ box.role = "navigation";
479
+ box.aria = { label: box.ariaLabel };
480
+
481
+ // GROUP: Items row (created by render)
482
+ box.content = HGroup({
483
+ width: isAutoWidth ? "auto" : "100%",
484
+ height: "auto",
485
+ align: "left center",
486
+ gap: _s.layout.gap,
487
+ position: "relative", // WHY: Component size is "auto". A relative group makes the container wrap it.
488
+ });
489
+
490
+ endGroup();
491
+
492
+ // *** OBJECT INIT CODE:
493
+
494
+ box.enabled = basic.isOn(box.enabled) ? 1 : 0;
495
+ setItemsSilent(params.items); // WHY: Copy the array. The default [] must not be shared between components.
496
+
497
+ return endObject(box);
498
+
499
+ };
500
+
501
+ // *** STATIC FUNCTIONS:
502
+
503
+ // WHY: Label.text uses innerHTML. Item texts must not be read as HTML.
504
+ Breadcrumbs.escapeHtml = basic.escapeHtml; // (the name is kept: other code may use it)
505
+
506
+ // Creates items from a path. Every item has the path until it as key.
507
+ Breadcrumbs.fromPath = function (path, rootText = "Home", divider = "/") {
508
+
509
+ const names = String(path).split(divider).filter(function (name) { return name !== ""; });
510
+ const items = [{ text: rootText, key: divider }];
511
+
512
+ let current = "";
513
+ names.forEach(function (name) {
514
+ current += divider + name;
515
+ let text = name;
516
+ try { text = decodeURIComponent(name); } catch (e) { } // WHY: "100%" is not a valid URI part.
517
+ items.push({ text: text, key: current });
518
+ });
519
+
520
+ return items;
521
+
522
+ };
523
+ // USAGE: Breadcrumbs.fromPath("/docs/2026/report.pdf")
524
+ // -> [{ text: "Home", key: "/" }, { text: "docs", key: "/docs" }, { text: "2026", key: "/docs/2026" }, { text: "report.pdf", key: "/docs/2026/report.pdf" }]