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,229 @@
1
+ # Bismillah
2
+ #
3
+ # look.rb - ozdenui v0.1 (OzdenUI: basic.js for Ruby)
4
+ # The picture of a window without a window: OZDENUI_LOOK=app.png ruby app.rb runs the program as it is in a hidden
5
+ # Chrome or Edge, saves the picture of its page and ends. OZDENUI_WINDOW=headless runs it there until the program
6
+ # closes it (the tests). The browser is driven over its DevTools protocol, with a small WebSocket client of its own.
7
+ #
8
+ # OZDENUI_THEME=dark: the dark window. OZDENUI_LOOK_WAIT=3: seconds before the picture (default 1.5).
9
+ # OZDENUI_LOOK_SCALE=2: a picture with twice the dots.
10
+ #
11
+ # Started Date: November 2026
12
+ # Webpage: https://bug7a.github.io/ozdenui-ruby/
13
+ #
14
+ # Copyright 2026 Bugra Ozden <bugra.ozden@gmail.com> (https://bug7a.github.io/)
15
+ # Licensed under the Apache License, Version 2.0
16
+ # SPDX-License-Identifier: Apache-2.0
17
+
18
+ require "socket"
19
+ require "json"
20
+ require "uri"
21
+ require "securerandom"
22
+ require "tmpdir"
23
+ require "fileutils"
24
+
25
+ module OzdenUI
26
+ # What the gem is made of. A program uses the methods of OzdenUI; these classes are behind them.
27
+ module Runtime
28
+ # @api private
29
+ module Look
30
+ DEFAULT_WAIT = 1.5
31
+ BROWSER_START_WAIT = 20
32
+
33
+ # @api private
34
+ class HeadlessWindow
35
+ attr_reader :done
36
+
37
+ def initialize
38
+ @done = Latch.new
39
+ end
40
+
41
+ def title=(_title); end
42
+
43
+ def close
44
+ @done.set
45
+ end
46
+ end
47
+
48
+ module_function
49
+
50
+ def env_number(name, fallback)
51
+ number = Float(ENV[name].to_s, exception: false)
52
+ number && number.positive? ? number : fallback
53
+ end
54
+
55
+ def open(app, address)
56
+ picture = ENV["OZDENUI_LOOK"].to_s
57
+ browser = Window.find_browser
58
+ unless browser
59
+ $stderr.puts "ozdenui: a picture of the window needs Chrome, Edge or Chromium on this computer (OZDENUI_BROWSER: its path)"
60
+ return
61
+ end
62
+ window = HeadlessWindow.new
63
+ app.control = window
64
+ profile = Dir.mktmpdir("ozdenui-look-")
65
+ width, height = app.options.values_at(:width, :height)
66
+ reader, writer = IO.pipe
67
+ pid = Process.spawn(browser, "--headless=new", "--remote-debugging-port=0", "--user-data-dir=#{profile}",
68
+ "--no-first-run", "--no-default-browser-check", "--hide-scrollbars", "--disable-gpu",
69
+ "--window-size=#{width},#{height}", "about:blank", out: File::NULL, err: writer)
70
+ writer.close
71
+ link = WebSocket.new(devtools_address(reader))
72
+ target = link.call(nil, "Target.createTarget", "url" => "about:blank")
73
+ session = link.call(nil, "Target.attachToTarget", "targetId" => target["targetId"], "flatten" => true)["sessionId"]
74
+ link.call(session, "Emulation.setDeviceMetricsOverride", "width" => width, "height" => height,
75
+ "deviceScaleFactor" => env_number("OZDENUI_LOOK_SCALE", 1), "mobile" => false)
76
+ link.call(session, "Page.navigate", "url" => address)
77
+ if picture.empty?
78
+ window.done.wait # a check without a screen: the program closes it
79
+ return
80
+ end
81
+ started_at = Time.now
82
+ until app.drawn.set? || window.done.set?
83
+ raise Error, "the page did not start: no picture" if Time.now - started_at > App::READY_TIMEOUT + BROWSER_START_WAIT
84
+ sleep(0.02)
85
+ end
86
+ return if window.done.set?
87
+ window.done.wait(env_number("OZDENUI_LOOK_WAIT", DEFAULT_WAIT))
88
+ shot = link.call(session, "Page.captureScreenshot", "format" => "png")
89
+ File.binwrite(picture, shot["data"].to_s.unpack1("m"))
90
+ $stderr.puts "ozdenui: the picture of the window: #{picture}"
91
+ rescue Error, SystemCallError, IOError => error
92
+ $stderr.puts "ozdenui: #{error.message}"
93
+ ensure
94
+ link&.close
95
+ if pid
96
+ begin
97
+ Process.kill("KILL", pid)
98
+ Process.wait(pid)
99
+ rescue SystemCallError
100
+ nil
101
+ end
102
+ end
103
+ reader&.close
104
+ FileUtils.rm_rf(profile) if profile
105
+ end
106
+
107
+ # The browser writes "DevTools listening on ws://127.0.0.1:port/devtools/browser/..." when it is ready.
108
+ def devtools_address(output)
109
+ found = Queue.new
110
+ Thread.new do
111
+ begin
112
+ told = false
113
+ output.each_line do |line| # WHY to its end: a full pipe would stop the browser
114
+ address = told ? nil : line[%r{ws://\S+}]
115
+ next unless address
116
+ told = true
117
+ found.push(address)
118
+ end
119
+ rescue IOError
120
+ nil
121
+ end
122
+ end
123
+ ends_at = Time.now + BROWSER_START_WAIT
124
+ sleep(0.02) while found.empty? && Time.now < ends_at
125
+ raise Error, "the hidden browser did not start" if found.empty?
126
+ found.pop
127
+ end
128
+
129
+ # A small WebSocket client, for the DevTools protocol of the browser (text messages of JSON).
130
+ # @api private
131
+ class WebSocket
132
+ def initialize(address)
133
+ uri = URI.parse(address)
134
+ @socket = TCPSocket.new(uri.host, uri.port)
135
+ key = [SecureRandom.random_bytes(16)].pack("m0")
136
+ @socket.write("GET #{uri.path} HTTP/1.1\r\nHost: #{uri.host}:#{uri.port}\r\nUpgrade: websocket\r\n" \
137
+ "Connection: Upgrade\r\nSec-WebSocket-Key: #{key}\r\nSec-WebSocket-Version: 13\r\n\r\n")
138
+ status = @socket.gets("\r\n").to_s
139
+ raise Error, "the hidden browser refused the link: #{status.strip}" unless status.include?("101")
140
+ nil while (line = @socket.gets("\r\n")) && line != "\r\n"
141
+ @mutex = Mutex.new
142
+ @write_mutex = Mutex.new
143
+ @waiting = {}
144
+ @next_id = 0
145
+ @reader = Thread.new { read_messages }
146
+ end
147
+
148
+ def close
149
+ @socket.close
150
+ rescue IOError
151
+ nil
152
+ end
153
+
154
+ # Calls a method of the DevTools protocol and returns its result.
155
+ def call(session, method, params = {})
156
+ waiter = Queue.new
157
+ id = @mutex.synchronize do
158
+ @next_id += 1
159
+ @waiting[@next_id] = waiter
160
+ @next_id
161
+ end
162
+ message = { "id" => id, "method" => method, "params" => params }
163
+ message["sessionId"] = session if session
164
+ write(JSON.generate(message))
165
+ ends_at = Time.now + BROWSER_START_WAIT
166
+ sleep(0.005) while waiter.empty? && Time.now < ends_at
167
+ raise Error, "#{method}: no answer of the hidden browser" if waiter.empty?
168
+ answer = waiter.pop
169
+ raise Error, "#{method}: the hidden browser is gone" unless answer
170
+ raise Error, "#{method}: #{answer['error']['message']}" if answer["error"]
171
+ answer["result"] || {}
172
+ end
173
+
174
+ private
175
+
176
+ # One text frame; a client masks what it sends.
177
+ def write(text)
178
+ payload = text.b
179
+ header = [0x81].pack("C")
180
+ length = payload.bytesize
181
+ header << if length < 126 then [0x80 | length].pack("C")
182
+ elsif length < 65_536 then [0x80 | 126, length].pack("Cn")
183
+ else [0x80 | 127, length].pack("CQ>")
184
+ end
185
+ mask = SecureRandom.random_bytes(4).bytes
186
+ masked = payload.bytes.each_with_index.map { |byte, index| byte ^ mask[index % 4] }.pack("C*")
187
+ @write_mutex.synchronize { @socket.write(header + mask.pack("C*") + masked) }
188
+ end
189
+
190
+ def read_messages
191
+ message = +"".b
192
+ loop do
193
+ head = @socket.read(2)
194
+ break unless head && head.bytesize == 2
195
+ first, second = head.bytes
196
+ opcode = first & 0x0F
197
+ length = second & 0x7F
198
+ length = @socket.read(2).unpack1("n") if length == 126
199
+ length = @socket.read(8).unpack1("Q>") if length == 127
200
+ payload = length.zero? ? "".b : @socket.read(length)
201
+ break if opcode == 0x8 || payload.nil? # closed
202
+ next if opcode > 0x2 # a ping or a pong: the browser does not wait for an answer on this link
203
+ message << payload
204
+ next if (first & 0x80).zero?
205
+ take(message)
206
+ message = +"".b
207
+ end
208
+ rescue IOError, SystemCallError
209
+ nil
210
+ ensure
211
+ waiting = @mutex.synchronize do
212
+ taken = @waiting
213
+ @waiting = {}
214
+ taken
215
+ end
216
+ waiting.each_value { |waiter| waiter.push(nil) }
217
+ end
218
+
219
+ def take(message)
220
+ answer = JSON.parse(message.force_encoding("UTF-8"))
221
+ waiter = @mutex.synchronize { @waiting.delete(answer["id"]) }
222
+ waiter&.push(answer)
223
+ rescue JSON::ParserError
224
+ nil
225
+ end
226
+ end
227
+ end
228
+ end
229
+ end