@vinena/knobs 0.0.0-stage → 0.5.1

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 (471) hide show
  1. package/CHANGELOG.md +228 -0
  2. package/LICENSE +21 -0
  3. package/README.md +110 -2
  4. package/THIRD_PARTY_NOTICES.md +429 -0
  5. package/dist/bezels/duo-fold/fold-000.webp +0 -0
  6. package/dist/bezels/duo-fold/fold-001.webp +0 -0
  7. package/dist/bezels/duo-fold/fold-002.webp +0 -0
  8. package/dist/bezels/duo-fold/fold-003.webp +0 -0
  9. package/dist/bezels/duo-fold/fold-004.webp +0 -0
  10. package/dist/bezels/duo-fold/fold-005.webp +0 -0
  11. package/dist/bezels/duo-fold/fold-006.webp +0 -0
  12. package/dist/bezels/duo-fold/fold-007.webp +0 -0
  13. package/dist/bezels/duo-fold/fold-008.webp +0 -0
  14. package/dist/bezels/duo-fold/fold-009.webp +0 -0
  15. package/dist/bezels/duo-fold/fold-010.webp +0 -0
  16. package/dist/bezels/duo-fold/fold-011.webp +0 -0
  17. package/dist/bezels/duo-fold/fold-012.webp +0 -0
  18. package/dist/bezels/duo-fold/fold-013.webp +0 -0
  19. package/dist/bezels/duo-fold/fold-014.webp +0 -0
  20. package/dist/bezels/duo-fold/fold-015.webp +0 -0
  21. package/dist/bezels/duo-fold/fold-016.webp +0 -0
  22. package/dist/bezels/duo-fold/fold-017.webp +0 -0
  23. package/dist/bezels/duo-fold/fold-018.webp +0 -0
  24. package/dist/bezels/duo-fold/fold-019.webp +0 -0
  25. package/dist/bezels/duo-fold/fold-020.webp +0 -0
  26. package/dist/bezels/duo-fold/fold-021.webp +0 -0
  27. package/dist/bezels/duo-fold/fold-022.webp +0 -0
  28. package/dist/bezels/duo-fold/fold-023.webp +0 -0
  29. package/dist/bezels/duo-fold/fold-024.webp +0 -0
  30. package/dist/bezels/duo-fold/fold-025.webp +0 -0
  31. package/dist/bezels/duo-fold/fold-026.webp +0 -0
  32. package/dist/bezels/duo-fold/fold-027.webp +0 -0
  33. package/dist/bezels/duo-fold/fold-028.webp +0 -0
  34. package/dist/bezels/duo-fold/fold-029.webp +0 -0
  35. package/dist/bezels/duo-fold/fold-030.webp +0 -0
  36. package/dist/bezels/duo-fold/fold-031.webp +0 -0
  37. package/dist/bezels/duo-fold/fold-032.webp +0 -0
  38. package/dist/bezels/duo-fold/fold-033.webp +0 -0
  39. package/dist/bezels/duo-fold/fold-034.webp +0 -0
  40. package/dist/bezels/duo-fold/fold-035.webp +0 -0
  41. package/dist/bezels/duo-fold/fold-036.webp +0 -0
  42. package/dist/bezels/duo-fold/fold-037.webp +0 -0
  43. package/dist/bezels/duo-fold/fold-038.webp +0 -0
  44. package/dist/bezels/duo-fold/fold-039.webp +0 -0
  45. package/dist/bezels/duo-fold/fold-040.webp +0 -0
  46. package/dist/bezels/duo-fold/fold-041.webp +0 -0
  47. package/dist/bezels/duo-fold/fold-042.webp +0 -0
  48. package/dist/bezels/duo-fold/fold-043.webp +0 -0
  49. package/dist/bezels/duo-fold/fold-044.webp +0 -0
  50. package/dist/bezels/duo-fold/fold-045.webp +0 -0
  51. package/dist/bezels/duo-fold/fold-046.webp +0 -0
  52. package/dist/bezels/duo-fold/fold-047.webp +0 -0
  53. package/dist/bezels/duo-fold/fold-048.webp +0 -0
  54. package/dist/bezels/duo-fold/fold-049.webp +0 -0
  55. package/dist/bezels/duo-fold/fold-050.webp +0 -0
  56. package/dist/bezels/duo-fold/fold-051.webp +0 -0
  57. package/dist/bezels/duo-fold/fold-052.webp +0 -0
  58. package/dist/bezels/duo-fold/fold-053.webp +0 -0
  59. package/dist/bezels/duo-fold/fold-054.webp +0 -0
  60. package/dist/bezels/duo-fold/fold-055.webp +0 -0
  61. package/dist/bezels/duo-fold/fold-056.webp +0 -0
  62. package/dist/bezels/duo-fold/fold-057.webp +0 -0
  63. package/dist/bezels/duo-fold/fold-058.webp +0 -0
  64. package/dist/bezels/duo-fold/fold-059.webp +0 -0
  65. package/dist/bezels/duo-fold/fold-060.webp +0 -0
  66. package/dist/bezels/duo-fold/fold-061.webp +0 -0
  67. package/dist/bezels/duo-fold/fold-062.webp +0 -0
  68. package/dist/bezels/duo-fold/fold-063.webp +0 -0
  69. package/dist/bezels/duo-fold/fold-064.webp +0 -0
  70. package/dist/bezels/duo-fold/fold-065.webp +0 -0
  71. package/dist/bezels/duo-fold/fold-066.webp +0 -0
  72. package/dist/bezels/duo-fold/fold-067.webp +0 -0
  73. package/dist/bezels/duo-fold/fold-068.webp +0 -0
  74. package/dist/bezels/duo-fold/fold-069.webp +0 -0
  75. package/dist/bezels/duo-fold/fold-070.webp +0 -0
  76. package/dist/bezels/duo-fold/fold-071.webp +0 -0
  77. package/dist/bezels/duo-fold/fold-072.webp +0 -0
  78. package/dist/bezels/duo-fold/fold-073.webp +0 -0
  79. package/dist/bezels/duo-fold/fold-074.webp +0 -0
  80. package/dist/bezels/duo-fold/fold-075.webp +0 -0
  81. package/dist/bezels/duo-fold/fold-076.webp +0 -0
  82. package/dist/bezels/duo-fold/fold-077.webp +0 -0
  83. package/dist/bezels/duo-fold/fold-078.webp +0 -0
  84. package/dist/bezels/duo-fold/fold-079.webp +0 -0
  85. package/dist/bezels/duo-fold/fold-080.webp +0 -0
  86. package/dist/bezels/duo-fold/fold-081.webp +0 -0
  87. package/dist/bezels/duo-fold/fold-082.webp +0 -0
  88. package/dist/bezels/duo-fold/fold-083.webp +0 -0
  89. package/dist/bezels/duo-fold/fold-084.webp +0 -0
  90. package/dist/bezels/duo-fold/fold-085.webp +0 -0
  91. package/dist/bezels/duo-fold/fold-086.webp +0 -0
  92. package/dist/bezels/duo-fold/fold-087.webp +0 -0
  93. package/dist/bezels/duo-fold/fold-088.webp +0 -0
  94. package/dist/bezels/duo-fold/fold-089.webp +0 -0
  95. package/dist/bezels/duo-fold/fold-090.webp +0 -0
  96. package/dist/bezels/duo-fold/fold-091.webp +0 -0
  97. package/dist/bezels/duo-fold/fold-092.webp +0 -0
  98. package/dist/bezels/duo-fold/fold-093.webp +0 -0
  99. package/dist/bezels/duo-fold/fold-094.webp +0 -0
  100. package/dist/bezels/duo-fold/fold-095.webp +0 -0
  101. package/dist/bezels/duo-fold/fold-096.webp +0 -0
  102. package/dist/bezels/duo-fold/fold-097.webp +0 -0
  103. package/dist/bezels/duo-fold/fold-098.webp +0 -0
  104. package/dist/bezels/duo-fold/fold-099.webp +0 -0
  105. package/dist/bezels/duo-fold/fold-100.webp +0 -0
  106. package/dist/bezels/duo-fold/fold-101.webp +0 -0
  107. package/dist/bezels/duo-fold/fold-102.webp +0 -0
  108. package/dist/bezels/duo-fold/fold-103.webp +0 -0
  109. package/dist/bezels/duo-fold/fold-104.webp +0 -0
  110. package/dist/bezels/duo-fold/fold-105.webp +0 -0
  111. package/dist/bezels/duo-fold/fold-106.webp +0 -0
  112. package/dist/bezels/duo-fold/fold-107.webp +0 -0
  113. package/dist/bezels/duo-fold/fold-108.webp +0 -0
  114. package/dist/bezels/duo-fold/fold-109.webp +0 -0
  115. package/dist/bezels/duo-fold/fold-110.webp +0 -0
  116. package/dist/bezels/duo-fold/fold-111.webp +0 -0
  117. package/dist/bezels/duo-fold/fold-112.webp +0 -0
  118. package/dist/bezels/duo-fold/fold-113.webp +0 -0
  119. package/dist/bezels/duo-fold/fold-114.webp +0 -0
  120. package/dist/bezels/duo-fold/fold-115.webp +0 -0
  121. package/dist/bezels/duo-fold/fold-116.webp +0 -0
  122. package/dist/bezels/duo-fold/fold-117.webp +0 -0
  123. package/dist/bezels/duo-fold/fold-118.webp +0 -0
  124. package/dist/bezels/duo-fold/fold-119.webp +0 -0
  125. package/dist/bezels/duo-fold/fold-120.webp +0 -0
  126. package/dist/bezels/duo-fold/fold-121.webp +0 -0
  127. package/dist/bezels/duo-fold/fold-122.webp +0 -0
  128. package/dist/bezels/duo-fold/fold-123.webp +0 -0
  129. package/dist/bezels/duo-fold/fold-124.webp +0 -0
  130. package/dist/bezels/duo-fold/fold-125.webp +0 -0
  131. package/dist/bezels/duo-fold/fold-126.webp +0 -0
  132. package/dist/bezels/duo-fold/fold-127.webp +0 -0
  133. package/dist/bezels/duo-fold/fold-128.webp +0 -0
  134. package/dist/bezels/duo-fold/fold-129.webp +0 -0
  135. package/dist/bezels/duo-fold/fold-130.webp +0 -0
  136. package/dist/bezels/duo-fold/fold-131.webp +0 -0
  137. package/dist/bezels/duo-fold/fold-132.webp +0 -0
  138. package/dist/bezels/duo-fold/fold-133.webp +0 -0
  139. package/dist/bezels/duo-fold/fold-134.webp +0 -0
  140. package/dist/bezels/duo-fold/fold-135.webp +0 -0
  141. package/dist/bezels/duo-fold/fold-136.webp +0 -0
  142. package/dist/bezels/duo-fold/fold-137.webp +0 -0
  143. package/dist/bezels/duo-fold/fold-138.webp +0 -0
  144. package/dist/bezels/duo-fold/fold-139.webp +0 -0
  145. package/dist/bezels/duo-fold/fold-140.webp +0 -0
  146. package/dist/bezels/duo-fold/fold-141.webp +0 -0
  147. package/dist/bezels/duo-fold/fold-142.webp +0 -0
  148. package/dist/bezels/duo-fold/fold-143.webp +0 -0
  149. package/dist/bezels/duo-fold/fold-144.webp +0 -0
  150. package/dist/bezels/duo-fold/fold-145.webp +0 -0
  151. package/dist/bezels/duo-fold/fold-146.webp +0 -0
  152. package/dist/bezels/duo-fold/fold-147.webp +0 -0
  153. package/dist/bezels/duo-fold/fold-148.webp +0 -0
  154. package/dist/bezels/duo-fold/fold-149.webp +0 -0
  155. package/dist/bezels/duo-fold/fold-150.webp +0 -0
  156. package/dist/bezels/duo-fold/fold-151.webp +0 -0
  157. package/dist/bezels/duo-fold/fold-152.webp +0 -0
  158. package/dist/bezels/duo-fold/fold-153.webp +0 -0
  159. package/dist/bezels/duo-fold/fold-154.webp +0 -0
  160. package/dist/bezels/duo-fold/fold-155.webp +0 -0
  161. package/dist/bezels/duo-fold/fold-156.webp +0 -0
  162. package/dist/bezels/duo-fold/fold-157.webp +0 -0
  163. package/dist/bezels/duo-fold/fold-158.webp +0 -0
  164. package/dist/bezels/duo-fold/fold-159.webp +0 -0
  165. package/dist/bezels/duo-fold/fold-160.webp +0 -0
  166. package/dist/bezels/duo-fold/fold-161.webp +0 -0
  167. package/dist/bezels/duo-fold/fold-162.webp +0 -0
  168. package/dist/bezels/duo-fold/fold-163.webp +0 -0
  169. package/dist/bezels/duo-fold/fold-164.webp +0 -0
  170. package/dist/bezels/duo-fold/fold-165.webp +0 -0
  171. package/dist/bezels/duo-fold/fold-166.webp +0 -0
  172. package/dist/bezels/duo-fold/fold-167.webp +0 -0
  173. package/dist/bezels/duo-fold/fold-168.webp +0 -0
  174. package/dist/bezels/duo-fold/fold-169.webp +0 -0
  175. package/dist/bezels/duo-fold/fold-170.webp +0 -0
  176. package/dist/bezels/duo-fold/fold-171.webp +0 -0
  177. package/dist/bezels/duo-fold/fold-172.webp +0 -0
  178. package/dist/bezels/duo-fold/fold-173.webp +0 -0
  179. package/dist/bezels/duo-fold/fold-174.webp +0 -0
  180. package/dist/bezels/duo-fold/fold-175.webp +0 -0
  181. package/dist/bezels/duo-fold/fold-176.webp +0 -0
  182. package/dist/bezels/duo-fold/fold-177.webp +0 -0
  183. package/dist/bezels/duo-fold/fold-178.webp +0 -0
  184. package/dist/bezels/duo-fold/fold-179.webp +0 -0
  185. package/dist/bezels/duo-fold/fold-180.webp +0 -0
  186. package/dist/bezels/duo-fold/still-000.webp +0 -0
  187. package/dist/bezels/duo-fold/still-161.webp +0 -0
  188. package/dist/bezels/duo-fold/still-162.webp +0 -0
  189. package/dist/bezels/duo-fold/still-163.webp +0 -0
  190. package/dist/bezels/duo-fold/still-164.webp +0 -0
  191. package/dist/bezels/duo-fold/still-165.webp +0 -0
  192. package/dist/bezels/duo-fold/still-166.webp +0 -0
  193. package/dist/bezels/duo-fold/still-167.webp +0 -0
  194. package/dist/bezels/duo-fold/still-168.webp +0 -0
  195. package/dist/bezels/duo-fold/still-169.webp +0 -0
  196. package/dist/bezels/duo-fold/still-170.webp +0 -0
  197. package/dist/bezels/duo-fold/still-171.webp +0 -0
  198. package/dist/bezels/duo-fold/still-172.webp +0 -0
  199. package/dist/bezels/duo-fold/still-173.webp +0 -0
  200. package/dist/bezels/duo-fold/still-174.webp +0 -0
  201. package/dist/bezels/duo-fold/still-175.webp +0 -0
  202. package/dist/bezels/duo-fold/still-176.webp +0 -0
  203. package/dist/bezels/duo-fold/still-177.webp +0 -0
  204. package/dist/bezels/duo-fold/still-178.webp +0 -0
  205. package/dist/bezels/duo-fold/still-179.webp +0 -0
  206. package/dist/bezels/duo-fold/still-180.webp +0 -0
  207. package/dist/bezels/iphone-16-plus.webp +0 -0
  208. package/dist/bezels/iphone-16-pro-max.webp +0 -0
  209. package/dist/bezels/iphone-16-pro.webp +0 -0
  210. package/dist/bezels/iphone-16.webp +0 -0
  211. package/dist/bezels/iphone-17-pro-max.webp +0 -0
  212. package/dist/bezels/iphone-17-pro.webp +0 -0
  213. package/dist/bezels/iphone-17.webp +0 -0
  214. package/dist/bezels/iphone-18-pro-max.webp +0 -0
  215. package/dist/bezels/iphone-18-pro.webp +0 -0
  216. package/dist/bezels/iphone-air.webp +0 -0
  217. package/dist/bezels/iphone-duo-inner-open-landscape.webp +0 -0
  218. package/dist/bezels/iphone-duo-inner-open-portrait.webp +0 -0
  219. package/dist/bezels/iphone-duo-outer-closed.webp +0 -0
  220. package/dist/bezels/iphone-se.webp +0 -0
  221. package/dist/bezels/pixel-10-pro-xl.webp +0 -0
  222. package/dist/bezels/pixel-10-pro.webp +0 -0
  223. package/dist/bezels/pixel-10.webp +0 -0
  224. package/dist/bezels/pixel-10a.webp +0 -0
  225. package/dist/bezels/pixel-9-pro-xl.webp +0 -0
  226. package/dist/bezels/pixel-9-pro.webp +0 -0
  227. package/dist/bezels/pixel-9.webp +0 -0
  228. package/dist/early.d.ts +1 -0
  229. package/dist/early.global.js +8 -0
  230. package/dist/elementsview-jnkbhzkj.js +2873 -0
  231. package/dist/elementsview-tf4qzmtw.js +2874 -0
  232. package/dist/engine/address.d.ts +31 -0
  233. package/dist/engine/animations.d.ts +13 -0
  234. package/dist/engine/barshot.d.ts +48 -0
  235. package/dist/engine/bezels.d.ts +140 -0
  236. package/dist/engine/bezelurls.d.ts +5 -0
  237. package/dist/engine/browserdraw.d.ts +57 -0
  238. package/dist/engine/browserkit.d.ts +59 -0
  239. package/dist/engine/browserui.d.ts +177 -0
  240. package/dist/engine/check.d.ts +8 -0
  241. package/dist/engine/chromedraw.d.ts +17 -0
  242. package/dist/engine/clock.d.ts +91 -0
  243. package/dist/engine/color.d.ts +37 -0
  244. package/dist/engine/describe.d.ts +49 -0
  245. package/dist/engine/devices.d.ts +96 -0
  246. package/dist/engine/dock.d.ts +53 -0
  247. package/dist/engine/endroom.d.ts +21 -0
  248. package/dist/engine/fit.d.ts +75 -0
  249. package/dist/engine/fold.d.ts +562 -0
  250. package/dist/engine/foldframes.d.ts +98 -0
  251. package/dist/engine/foldgl.d.ts +151 -0
  252. package/dist/engine/foldhand.d.ts +23 -0
  253. package/dist/engine/foldlook.d.ts +49 -0
  254. package/dist/engine/foldpage.d.ts +167 -0
  255. package/dist/engine/foldrun.d.ts +98 -0
  256. package/dist/engine/frame.d.ts +142 -0
  257. package/dist/engine/frameglide.d.ts +71 -0
  258. package/dist/engine/framekit.d.ts +7 -0
  259. package/dist/engine/frames.d.ts +42 -0
  260. package/dist/engine/fresh.d.ts +59 -0
  261. package/dist/engine/geo.d.ts +58 -0
  262. package/dist/engine/header.d.ts +16 -0
  263. package/dist/engine/identity.d.ts +27 -0
  264. package/dist/engine/index.d.ts +58 -0
  265. package/dist/engine/intl.d.ts +23 -0
  266. package/dist/engine/locale.d.ts +86 -0
  267. package/dist/engine/mat.d.ts +64 -0
  268. package/dist/engine/matchmedia.d.ts +25 -0
  269. package/dist/engine/matcolors.d.ts +45 -0
  270. package/dist/engine/matsplash.d.ts +81 -0
  271. package/dist/engine/media.d.ts +55 -0
  272. package/dist/engine/mock.d.ts +65 -0
  273. package/dist/engine/mockdata.d.ts +42 -0
  274. package/dist/engine/mockdraw.d.ts +21 -0
  275. package/dist/engine/morph.d.ts +214 -0
  276. package/dist/engine/morphrun.d.ts +49 -0
  277. package/dist/engine/native.d.ts +129 -0
  278. package/dist/engine/network.d.ts +8 -0
  279. package/dist/engine/notice.d.ts +15 -0
  280. package/dist/engine/objectfit.d.ts +35 -0
  281. package/dist/engine/outlines.d.ts +2 -0
  282. package/dist/engine/overflow.d.ts +11 -0
  283. package/dist/engine/owninline.d.ts +16 -0
  284. package/dist/engine/pagefonts.d.ts +21 -0
  285. package/dist/engine/pageshot.d.ts +127 -0
  286. package/dist/engine/placeholder.d.ts +89 -0
  287. package/dist/engine/pseudo.d.ts +15 -0
  288. package/dist/engine/ready.d.ts +9 -0
  289. package/dist/engine/reload.d.ts +35 -0
  290. package/dist/engine/remount.d.ts +30 -0
  291. package/dist/engine/replay.d.ts +7 -0
  292. package/dist/engine/safaridraw.d.ts +22 -0
  293. package/dist/engine/scrollbars.d.ts +17 -0
  294. package/dist/engine/scrollkeep.d.ts +124 -0
  295. package/dist/engine/spacing.d.ts +2 -0
  296. package/dist/engine/speed.d.ts +11 -0
  297. package/dist/engine/store.d.ts +68 -0
  298. package/dist/engine/stored.d.ts +17 -0
  299. package/dist/engine/style.d.ts +27 -0
  300. package/dist/engine/system.d.ts +15 -0
  301. package/dist/engine/text.d.ts +53 -0
  302. package/dist/engine/time.d.ts +32 -0
  303. package/dist/engine/touch.d.ts +20 -0
  304. package/dist/engine/touchdot.d.ts +71 -0
  305. package/dist/engine/touchmark.d.ts +27 -0
  306. package/dist/engine/touchpointer.d.ts +113 -0
  307. package/dist/engine/tree.d.ts +9 -0
  308. package/dist/engine/turnrun.d.ts +74 -0
  309. package/dist/engine/ua.d.ts +55 -0
  310. package/dist/engine/underneath.d.ts +7 -0
  311. package/dist/engine/viewportcss.d.ts +7 -0
  312. package/dist/engine/vision.d.ts +3 -0
  313. package/dist/engine/width.d.ts +56 -0
  314. package/dist/engine/zoom.d.ts +33 -0
  315. package/dist/framekit-3n7p79ht.js +8839 -0
  316. package/dist/framekit-g96t6nmq.js +8838 -0
  317. package/dist/global.d.ts +1 -0
  318. package/dist/grab/boxmodel.d.ts +109 -0
  319. package/dist/grab/boxtext.d.ts +17 -0
  320. package/dist/grab/card.d.ts +45 -0
  321. package/dist/grab/cardread.d.ts +22 -0
  322. package/dist/grab/cardview.d.ts +18 -0
  323. package/dist/grab/clipboard.d.ts +8 -0
  324. package/dist/grab/colors.d.ts +31 -0
  325. package/dist/grab/colorvalue.d.ts +40 -0
  326. package/dist/grab/context.d.ts +25 -0
  327. package/dist/grab/control.d.ts +37 -0
  328. package/dist/grab/copy.d.ts +7 -0
  329. package/dist/grab/dwell.d.ts +29 -0
  330. package/dist/grab/fiber.d.ts +17 -0
  331. package/dist/grab/fontused.d.ts +23 -0
  332. package/dist/grab/hit.d.ts +19 -0
  333. package/dist/grab/hook.d.ts +7 -0
  334. package/dist/grab/index.d.ts +9 -0
  335. package/dist/grab/inspect.d.ts +31 -0
  336. package/dist/grab/keys.d.ts +84 -0
  337. package/dist/grab/locate.d.ts +63 -0
  338. package/dist/grab/mode.d.ts +56 -0
  339. package/dist/grab/navigate.d.ts +21 -0
  340. package/dist/grab/outline.d.ts +16 -0
  341. package/dist/grab/overlay.d.ts +135 -0
  342. package/dist/grab/paint.d.ts +7 -0
  343. package/dist/grab/paths.d.ts +27 -0
  344. package/dist/grab/picks.d.ts +9 -0
  345. package/dist/grab/place.d.ts +25 -0
  346. package/dist/grab/preview.d.ts +12 -0
  347. package/dist/grab/selector.d.ts +15 -0
  348. package/dist/grab/source.d.ts +68 -0
  349. package/dist/grab/stack.d.ts +49 -0
  350. package/dist/grab/theme.d.ts +85 -0
  351. package/dist/grab/types.d.ts +52 -0
  352. package/dist/host.d.ts +7 -0
  353. package/dist/index-0casarhy.js +324 -0
  354. package/dist/index-2d6wvs8h.js +528 -0
  355. package/dist/index-33x9hxe3.js +4563 -0
  356. package/dist/index-5baxvd3v.js +4424 -0
  357. package/dist/index-78r0f8pw.js +27 -0
  358. package/dist/index-d0cjxjsm.js +21 -0
  359. package/dist/index-dvr4x91q.js +4800 -0
  360. package/dist/index-k015tb6c.js +357 -0
  361. package/dist/index-ke6v7919.js +4801 -0
  362. package/dist/index-peh33xjv.js +346 -0
  363. package/dist/index-ztnjefrh.js +23 -0
  364. package/dist/index-zvze25nf.js +686 -0
  365. package/dist/index.d.ts +116 -0
  366. package/dist/index.global.js +2655 -0
  367. package/dist/index.js +9262 -0
  368. package/dist/instance.d.ts +29 -0
  369. package/dist/react-65tgdbs8.js +22 -0
  370. package/dist/react-71a9ypex.js +529 -0
  371. package/dist/react-adky72h9.js +29 -0
  372. package/dist/react-carf84xv.js +4420 -0
  373. package/dist/react-eygws6cx.js +358 -0
  374. package/dist/react-h9w04skh.js +25 -0
  375. package/dist/react-pdvseef0.js +325 -0
  376. package/dist/react-qv0nykcv.js +4564 -0
  377. package/dist/react-sq9pkw4k.js +687 -0
  378. package/dist/react-xxfpfddf.js +347 -0
  379. package/dist/react.d.ts +6 -0
  380. package/dist/react.js +9255 -0
  381. package/dist/requests/body.d.ts +44 -0
  382. package/dist/requests/eventsource.d.ts +14 -0
  383. package/dist/requests/fetch.d.ts +14 -0
  384. package/dist/requests/index.d.ts +35 -0
  385. package/dist/requests/patch.d.ts +17 -0
  386. package/dist/requests/quiet.d.ts +12 -0
  387. package/dist/requests/record.d.ts +40 -0
  388. package/dist/requests/resource.d.ts +28 -0
  389. package/dist/requests/shared.d.ts +34 -0
  390. package/dist/requests/stack.d.ts +7 -0
  391. package/dist/requests/store.d.ts +37 -0
  392. package/dist/requests/types.d.ts +140 -0
  393. package/dist/requests/xhr.d.ts +16 -0
  394. package/dist/storage/cache.d.ts +32 -0
  395. package/dist/storage/clear.d.ts +35 -0
  396. package/dist/storage/cookies.d.ts +71 -0
  397. package/dist/storage/format.d.ts +53 -0
  398. package/dist/storage/idb.d.ts +62 -0
  399. package/dist/storage/onload.d.ts +47 -0
  400. package/dist/storage/presets.d.ts +79 -0
  401. package/dist/storage/site.d.ts +51 -0
  402. package/dist/storage/web.d.ts +57 -0
  403. package/dist/storageview-sb23henh.js +2729 -0
  404. package/dist/storageview-vf8v8q8j.js +2728 -0
  405. package/dist/styles/cascade.d.ts +59 -0
  406. package/dist/styles/collect.d.ts +73 -0
  407. package/dist/styles/declarations.d.ts +30 -0
  408. package/dist/styles/index.d.ts +20 -0
  409. package/dist/styles/inherited.d.ts +5 -0
  410. package/dist/styles/match.d.ts +41 -0
  411. package/dist/styles/selector.d.ts +36 -0
  412. package/dist/styles/tree.d.ts +14 -0
  413. package/dist/styles/types.d.ts +117 -0
  414. package/dist/styles/varrefs.d.ts +35 -0
  415. package/dist/types.d.ts +221 -0
  416. package/dist/ui/actions.d.ts +26 -0
  417. package/dist/ui/bindings.d.ts +89 -0
  418. package/dist/ui/boxdiagram.d.ts +50 -0
  419. package/dist/ui/catalog.d.ts +195 -0
  420. package/dist/ui/colors.d.ts +51 -0
  421. package/dist/ui/column.d.ts +22 -0
  422. package/dist/ui/copytext.d.ts +6 -0
  423. package/dist/ui/deviceknobs.d.ts +20 -0
  424. package/dist/ui/dockslide.d.ts +100 -0
  425. package/dist/ui/dom.d.ts +68 -0
  426. package/dist/ui/domtree.d.ts +143 -0
  427. package/dist/ui/drag.d.ts +34 -0
  428. package/dist/ui/editors.d.ts +30 -0
  429. package/dist/ui/elementsview.d.ts +32 -0
  430. package/dist/ui/foldslider.d.ts +48 -0
  431. package/dist/ui/footer.d.ts +51 -0
  432. package/dist/ui/hold.d.ts +20 -0
  433. package/dist/ui/icons.d.ts +145 -0
  434. package/dist/ui/inspector.d.ts +59 -0
  435. package/dist/ui/keys.d.ts +180 -0
  436. package/dist/ui/kit.d.ts +336 -0
  437. package/dist/ui/knobs.d.ts +41 -0
  438. package/dist/ui/list.d.ts +68 -0
  439. package/dist/ui/palette.d.ts +59 -0
  440. package/dist/ui/pane.d.ts +151 -0
  441. package/dist/ui/panel.d.ts +56 -0
  442. package/dist/ui/pin.d.ts +28 -0
  443. package/dist/ui/place.d.ts +136 -0
  444. package/dist/ui/prefs.d.ts +53 -0
  445. package/dist/ui/radio.d.ts +37 -0
  446. package/dist/ui/requestdetail.d.ts +56 -0
  447. package/dist/ui/requestformat.d.ts +142 -0
  448. package/dist/ui/requestparts.d.ts +312 -0
  449. package/dist/ui/requests.d.ts +48 -0
  450. package/dist/ui/rows.d.ts +72 -0
  451. package/dist/ui/search.d.ts +29 -0
  452. package/dist/ui/settings.d.ts +69 -0
  453. package/dist/ui/size.d.ts +105 -0
  454. package/dist/ui/slide.d.ts +46 -0
  455. package/dist/ui/stage.d.ts +24 -0
  456. package/dist/ui/storageaction.d.ts +22 -0
  457. package/dist/ui/storagecookies.d.ts +5 -0
  458. package/dist/ui/storagedeep.d.ts +18 -0
  459. package/dist/ui/storageparts.d.ts +131 -0
  460. package/dist/ui/storagepresets.d.ts +19 -0
  461. package/dist/ui/storageview.d.ts +45 -0
  462. package/dist/ui/storageweb.d.ts +11 -0
  463. package/dist/ui/styles.d.ts +1 -0
  464. package/dist/ui/stylesapplied.d.ts +46 -0
  465. package/dist/ui/stylesformat.d.ts +78 -0
  466. package/dist/ui/stylesview.d.ts +118 -0
  467. package/dist/ui/swatches.d.ts +26 -0
  468. package/dist/ui/syntax.d.ts +34 -0
  469. package/dist/ui/tooltip.d.ts +64 -0
  470. package/package.json +60 -4
  471. package/skills/devknobs/SKILL.md +214 -0
package/CHANGELOG.md ADDED
@@ -0,0 +1,228 @@
1
+ # changelog
2
+
3
+ ## 0.5.1
4
+
5
+ - published from vinenastudio/knobs on GitHub Actions through npm trusted publishing, with provenance. no code changes
6
+
7
+ ## 0.5.0
8
+
9
+ - first release as @vinena/knobs (was devknobs)
10
+ - a click on a row's `×` puts the row back to its default and keeps it listed; press and hold it for a second to take the row off the list, as a click did before. the `×` fills while held, letting go early or moving off cancels, and enter or space held on it for a second does the same. its label says `reset <row> (hold to remove)`
11
+ - inspect's view is laid out as the browser's Elements panel: the DOM tree on top, the breadcrumbs under it, then the styles. each line is a node in the panel's words and colors, `<tag attr="value">`, a triangle on what opens, `<tag>…</tag>` closed and `</tag>` on its own line open, text in quotes, comments, `<!DOCTYPE html>`, `#shadow-root (open)`, and `::marker`, `::before` and `::after` with content. a pick reveals its element, a click on a line shows its styles, the pointer on one boxes it on the page, and the arrows, Home and End move as in the panel. the selected line ends with `== $0`, and `$0` is that node on the page's window while the view is open, unless the page has its own. `copy`, or cmd or ctrl and c, copies its outer html. the tree follows the page as it changes and lights what changed, reads a node's children only once it opens, shows 500 children before `Show all nodes (N more)`, and never shows devknobs' own nodes. with the width knob's frame up, it is the frame's page
12
+
13
+ ## 0.4.0
14
+
15
+ - a request in full is laid out as the browser's own network panel lays it out, in its words: tabs for Headers, Payload, Preview, Response, Initiator, Timing, Cookies and EventStream, the ones the request has, in place of `body`, `headers` and `more`. Headers has General and both sets of headers with a Raw toggle, Payload the query, the json sent as a tree and a form's fields, each with view source, and Response the body numbered and colored, a long line wrapping in from where it starts. the tab, the sections and the toggles stay for the next request. Preview shows json as a tree, an image from its address with its size, html drawn in a sandboxed frame and other text as it is. Initiator has Request call stack and Request initiator chain. Timing has Queued at and Started at, then Resource Scheduling, Connection Start and Request/Response, a bar and a duration each, from Resource Timing, with the Type, Size and Protocol columns under it. Cookies lists Request Cookies and Response Cookies with the browser's fields, and EventStream an `EventSource`'s messages as Id, Type, Data and Time
16
+ - `EventSource` is recorded: a row a connection, `eventsource` in the Type column and under `fetch/xhr`, with the last 200 messages of the types the page listens for, each up to 4 KB
17
+ - devknobs' styles, the panel's, grab's, the frame's and those it puts on the page, are constructed stylesheets where the browser adopts them, so a page whose Content Security Policy blocks inline styles no longer gets the panel unstyled. a browser without them gets `<style>` elements as before. the early stand-in's picture sets its styles through the CSSOM, which such a policy allows
18
+ - `native.ua` hands the host the browser the page's requests go out as, from the ua knob or a device's browser, so it can send that user agent and its client hints to servers. the page's own patches stay, it is handed with the switch off too, and a promise it returns holds the frame's next load until it settles
19
+ - `mount({ native })` hands text size, offline and the prefers knobs to a host that sets them for real, such as a browser extension through the DevTools protocol, in place of emulating them in the page. without it nothing changes
20
+ - `native.viewport` takes a plain size or a device with nothing drawn around it, so the host sets the tab's own viewport, ratio and touch screen in place of the frame. anything drawn keeps the frame, and the host gets `null` meanwhile
21
+ - a frame that holds the browser's error page, as for a page that refuses to be framed, no longer gets a message, which logged an error
22
+ - the knob rows start at the panel's inset, with no column kept for the grip: it shows over the row's icon on hover or focus, and in its place where there is no hover
23
+ - `native.setting` puts a switch for the host's driver in the panel's settings, and `setNative(on, note)` sets it from the host: off, every knob is emulated in the page as with no driver, and kept as it was. without a `setting` nothing shows
24
+ - a navigation to another origin inside the frame takes the whole tab there, as it would with no frame, where it got the refusal notice: a sign-in provider that refuses frames is no longer a dead end. a form's post stays in the frame, since the tab could only follow it without its body. chromium only (the Navigation API); a server's redirect to another origin still gets the notice
25
+ - text size sizes a root the page leaves unset against the browser's own default, so a default other than 16px, such as one a host set for real and left behind, is not counted twice
26
+ - `setSystemMedia({ scheme, motion })` gives the panel and grab the user's own scheme and motion when such a host hides them from every media query in the tab. until it is called nothing changes
27
+ - `native.refused(url)` lets the host say why the frame's page was refused: a line under the notice, a "copy details" button and a button to look again. without it the notice is as before
28
+ - `native.framed(open)` hears the frame open, before its first load, and go; a promise it returns as the frame opens holds that load until it settles, and a `retry` with `now: true` runs and loads the frame again at once, with no press
29
+ - the width knob's frame, the panel and the style that hides the page under the frame go back where a page's script takes them out, as a React root on `<body>` does as it starts (x.com), or puts a new `<body>` in, which left the page blank with no frame. the frame loads its page again then. a page that keeps taking them out gets them back less often, with one warning in the console
30
+ - `mount({ host: true })` holds the page as its host, as the extension's copy does: a copy the page mounts later takes no panel of its own, it hands its `hotkey`, `grabKey`, `grab`, `open` and `grabColor` to the host, and its `unmount()` leaves the host's panel up. `window.devknobs` stays the host's, and the page copy's own `getState`, `setState`, `ready` and the rest go to the host. the host's switch for its `native` driver stays as it was when it takes the page back. a copy without this, such as 0.3.0, still takes over; the host then takes the page back from it, up to three times per page, then lets it be with a warning in the console. without a host, a second copy takes over as before
31
+ - the early script leaves the page alone where a copy of devknobs already holds it, such as the extension's, which mounts before any page script: only the React hook goes in, so no stand-in hides the page with nothing to take it away
32
+
33
+ ## 0.3.0
34
+
35
+ ### agents
36
+
37
+ - `describe()` lists every knob as json, with its values, its default and what applying it reloads: nothing, the frame or the page
38
+ - `ready()` resolves with the state once the frame has caught up, the frame's own devknobs is up (or 1.5 seconds after its page loads without one), the pseudo text is in and the panel has finished its slide. a page reloading for the locale knob never settles it. it rejects at once with `devknobs: not mounted` when devknobs is not mounted or unmounts during the wait, and past 10 seconds with an error
39
+ - `setState()` throws a `TypeError` at an unknown knob or field, or a value the knob does not take, and changes nothing. `panel.pinned` takes only row ids, each once. `setState(getState())` works
40
+ - `panel.handle` hides the panel's handle for the tab, so a closed panel stays out of screenshots. the show handle switch in the settings shows it off then, and turning it on brings the handle back
41
+ - `reset()` leaves the panel open or closed, docked or not, and its handle as it is. `describe()` says so
42
+ - `grab()` takes an element, an array or a NodeList of them, skips entries that are not elements and resolves `null` when none are left
43
+ - both are on `window.devknobs` and exported from `devknobs`
44
+ - `mount()` and `<DevKnobs />` put the api on `window.devknobs` too, not only the script tag build, and take it away on unmount. the copy in the width knob's frame has it as well
45
+ - `grab()` finds the right line on a dev server whose source map is off in more cases: a tag also named in a comment or a string, a `key` after a spread, a list item among others of its tag, and a helper called from more than one place. where it cannot find the line, `source.lineNumber` is null, not a line of the transformed module
46
+ - `grab()` resolves with the payload even when the clipboard copy fails, as it often does in headless browsers. `copied` says whether it reached the clipboard
47
+ - an agent skill ships in the package at `skills/devknobs/SKILL.md`
48
+
49
+ ### grab
50
+
51
+ - the copied line no longer ends in an `nth-child` selector chain. it shows a selector only when it is built from a test id, a label, a stable id or another meaningful attribute (href, src, role, name, title, alt). each entry's new `selector` field has the full one
52
+
53
+ ## 0.2.1
54
+
55
+ ### device frame
56
+
57
+ - the frame and device code (bezels, the iPhone Duo's fold, browser bars) is a chunk of its own, loaded the first time a knob needs a frame, also when a saved device comes back. `import "devknobs"` loads much less up front, and the early stand-in covers the page until the frame draws. `dist/index.global.js` keeps it all in one file
58
+ - when the frame exits on its own, as when its code or the page in it does not load, the device goes back to none and the browser it brought goes back to system, as picking none does. a ua you picked since is kept. a failed load says so once in the console, and each device pick after it goes back to none
59
+
60
+ ### grab
61
+
62
+ - the first grab is quicker: frames from packages are named from their path, so their bundles and source maps are no longer fetched, and the scan for jsx calls no longer slows down on a long inline source map
63
+ - the hit test under the pointer skips children whose box is nowhere near it
64
+
65
+ ### panel
66
+
67
+ - less work while the page sits idle: the 1 Hz tick leaves a row's text alone when it did not change, the locale leaves `lang` and `dir` on `html` alone when they hold the value, and a media query list gets its guard only once the page listens to it, so a page that reads `matches` in render no longer keeps every list alive
68
+
69
+ ### package
70
+
71
+ - the install section starts with a setup prompt to paste into an AI agent, and the Next.js example is a whole client component
72
+ - the package names its home page, https://knobs.dev, its repository and where to report issues, so npm links them, and the author's name has its ü
73
+
74
+ ## 0.2.0
75
+
76
+ ### requests
77
+
78
+ - `⇧N`, or `requests` in the search, shows what the page asks for, as a view in the panel: `fetch` and `XMLHttpRequest` whole, and what the page loads on its own by its timing and size. a row opens its request in full, and copy puts it on the clipboard as text for an AI, with the values of secret headers left out. the key can be set in the settings like the others
79
+
80
+ ### fresh mode
81
+
82
+ - `?devknobs=fresh` in the page's address shows the page and the panel as a first visit sees them: `localStorage` is left alone, and every load devknobs did not ask for starts with no knobs set. the footer says so while it is on
83
+
84
+ ### inspect
85
+
86
+ - `⇧C` (`Shift C` off a Mac), the inspect action in the search or its key in the footer picks an element as grab does and shows its css in the panel, in place of the rows, read only: its `style` attribute, the rules that reach it in cascade order with overridden declarations struck through, each rule's `@layer`, `@media`, `@supports` and `@container` and its stylesheet's file, its `::before` and `::after`, what each ancestor hands down, color swatches and what a custom property resolves to. a click copies nothing. a stylesheet from another origin shows as `rules hidden`. the key is set in the settings like the others, and `inspect` in the search no longer finds grab. the styles have two modes, set beside the filter and kept: `simple`, the default, lists only the declarations that apply to the element, grouped by what they do, with what it inherits folded under them, and `advanced` is the cascade view above
87
+ - every custom property a value reads through `var()` is a piece of its own in both modes, for the pointer and the tab key, nested ones and those inside `calc()`, `color-mix()` and gradients too, and so is the name of a `--custom` declaration. its tooltip says what the element, or the pseudo-element shown, sees for it at that moment, so a knob that moved shows: the value, cut in its middle where it is long, with a swatch for a color, and under it the selector of the rule that sets it, the element's own or the ancestor's it comes from. one that is not set says `not set`, and what the fallback of its `var()` comes to. text in a string, a comment or a `url()` that looks like a call is left alone. a click still copies nothing. a declaration's name now has a color of its own, a calm blue, with the value in the text's color and `:` and `;` quiet, and the names in a request's headers and a cookie's fields have the same color, so a key looks the same across the panel. an overridden declaration stays quiet all over
88
+ - inspect draws the box of the element under the pointer, as the browsers' tools do: content blue, padding green, border yellow, margin orange. a turned or scaled element is drawn by its own corners where the browser has `getBoxQuads`, and by its bounding box where it has not. grab keeps its plain box
89
+ - the styles view starts with the element's box under `box`, in both modes: margin, border, padding and content one inside the other with the length of each side, the content's size, and the offsets of a positioned element. the pointer on an area draws it alone on the page. a narrow panel says the lengths in a line under the box. the fold stays the way you leave it
90
+ - inspect's label is a card: the element and its size, then its color and background, the font its text is likely set in with its size, line height and weight, the wcag contrast with a mark for level AA, and its margin and padding, each only where it applies. the font is the first family of the list that the browser says is there, as a page cannot ask which font a glyph was drawn with
91
+ - picking is a mode that ends with the pick, as in the browsers' own tools: a click shows the element in the styles view and nothing stays drawn on the page, which takes clicks again. the view's bar starts with a select button at its left, as the browsers' tools have it, on its own ground while the picking is on, that starts it again, and `⇧C` does the same and stops it while it picks. escape ends the picking and keeps the element. inspect's row opens the view on the element it holds, and picks only with none: it says `picking`, the element's name, or `off`, stays listed while it holds an element, and its x and reset all let go of the element. a crumb, the box's diagram and the name in the view's head box their element on the page while the pointer is on them. with no element the view has no bar: while it picks, one line says to pick an element, and with the picking off that line is the button that starts it. an element that left the page is said so in the same way, in a line you press to pick another. starting grab ends the picking, and the reverse
92
+ - inspect has a row as grab and replay animations do: run from the search, the add knob list, the footer or its row, its row stays in the list, says `picking` while it picks, and its x takes it off and ends the picking. its key in the footer and its row now turn it off where it is on
93
+
94
+ ### storage
95
+
96
+ - a storage view in the panel (`⇧S`, or search for storage, data, cookies): `localStorage`, `sessionStorage` and the cookies a page can read, to look at, copy, edit, add and delete; IndexedDB and Cache Storage to read; clear site data in one go after one question; and presets, named sets of values to put back with a press or on every load. see the storage section of the readme
97
+
98
+ ### panel
99
+
100
+ - the pin button in the footer, and the pin panel action in the search, dock the panel to its side as a column the height of the window, like devtools. the page runs in a frame beside it, so its viewport really is narrower: media queries, `100vw` and fixed boxes follow. pinning loads the page once more when no frame is up, and never with a device or a width set. the pin is kept with the panel's place. the column is as wide as the panel, a view's width while one shows, and its edge sets that width down to a page of 320px. the page follows the column's edge frame by frame as the panel opens, closes or glides to a view's width, and slides across as the column changes side. two buttons by the pin, and the move panel across action, take it to the other side and close it. run from the panel, pin panel and move panel across are rows like any action: the pin's row says `on` while the panel is pinned, and its `×` and reset all leave the panel where it is
101
+ - a pinned panel that closes slides all the way off its edge first, and its handle comes in from that edge after it. as it opens, the column comes out at once and the handle goes off the edge under it. the column is drawn in the same frame the page takes its room in, so no strip of the mat shows between the two on the way
102
+ - a fresh panel starts with its handle 128px below the top of the window, and opens from there, not from the very top. a place you already dragged it to is kept
103
+ - the panel's width is yours to set: drag its edge on the page's side, or focus the edge and press the arrows. a double click puts it back, and the width is kept
104
+ - grab, replay animations and requests have rows as the knobs do. run one from the search, the add knob list, the footer or its row and its row stays in the list, to drag where you want it. its row runs it, shows its key and whether a mode is on, and its x takes it off and turns the mode off. a key alone lists a mode only while it is on
105
+ - the head of the settings is the head every view has, and keeps the grip's column empty as a row with no grip does: its way back stands where a row's icon is, and its title where a row's name is
106
+
107
+ ### iPhone Duo
108
+
109
+ - the half that turns shows the page at the text size knob's size: its lines meet the other half's at the hinge. a page that sets its own root font size folds right too
110
+ - the half that turns is sharp at the hinge through the whole fold, and blurs gently toward its free edge: 48 px at most, where it was 128. its top and bottom ends still blur into the black past them, at the hinge too
111
+ - nothing marks the hinge: the bend's dark strip is gone from both halves
112
+ - no thin dark line runs down the hinge as the Duo folds: the half that turns stops 2 px short of the hinge and the black under it 4 px short, each on an edge of its own, and the other half goes on under both, so the black never shows through the page's edge
113
+ - a fold that turns copies of the half has no black px down the hinge either
114
+ - where WebGL2 does not draw the half that turns, its blur rises with no lines down it: the blurred pictures laid over each other are twice as wide each, not four times, and each fades in exactly where the one under it is all in
115
+ - the half that turns is no longer shaded toward its free edge as it turns: it keeps the screen's own light, the same as the other half's, so no lines run down it. the three shades are still in the fold's numbers, at 0
116
+ - a shade brought back has no lines either: WebGL2 works it out at every px, and where gradients draw it they go through as many stops as its bends need, not 9
117
+ - a picture on the page that covers its box, or is contained in it, is cut and placed on the half that turns as the page shows it. it was stretched over its box, so a page that had not yet picked its picture for the open screen showed the folded screen's twice as wide as it is tall
118
+ - unfolding, the open screen's half shows the page as it lays itself out open, once it has picked what it shows there: its picture is taken again when the frame is drawn open, where the page changed since
119
+ - the half that turns shows the page's pictures as they were when its picture was taken, not as they are a moment later, the frame laid out for the other screen and back
120
+ - nothing devknobs put on the page is on the half that turns, nor the browser's box for a picture it could not load
121
+ - a rough picture of the page is kept by all it depends on: its screen, viewport and knobs, the device pixel ratio, the text size, the scroll and what the page's pictures show. one of the folded screen never stands in for the open one's
122
+
123
+ ### types
124
+
125
+ - `GrabColorValue` and `MatColorValue` also take a hex of your own, `` `#${string}` ``, so a `switch` over them that covers every swatch needs a case for the rest
126
+ - `PanelValue`, and with it `DevknobsState`, has `docked`, true while the panel is pinned
127
+
128
+ ### fixes
129
+
130
+ - a load devknobs asks for keeps the scroll position: the reload a locale or a device needs, the reload button in the device's browser bars, and a frame a knob brings up. the page, and the copy of it in the device's frame, go back to where they were once they are long enough, also when the host sends them to the top as it mounts. it stops as soon as you scroll, press a key or click, and a load of your own restores nothing
131
+
132
+ ### colors
133
+
134
+ - the mat and grab's color take colors of your own: the plus after the swatches opens the browser's color picker, and a hex or `rgb()` can be typed in the field under it. the color shows on the mat, or on grab's box, while you pick it
135
+ - a color of your own is kept per site, up to 8 for the mat and 8 for grab, and the x on its swatch, or delete with the focus on it, takes it off. one the same as a swatch that is there picks that swatch
136
+ - the mat's lines and numbers go dark on a light color such as white or yellow, and the splash, the reload's stand-in and the early script follow any color
137
+
138
+ ## 0.1.2
139
+
140
+ ### iPhone Duo
141
+
142
+ - a fold goes at one constant speed, half a second shut to open, with no easing. the hinge under a hand on the fold slider still follows through its spring
143
+ - a fold started from the fold chip or the posture knob starts sharp: no grey bands where the text is, and no jump as it begins
144
+ - the half that turns shows the page in its own fonts, not a fallback
145
+ - a fold back, a hand letting go and a hand taking the hinge go on from exactly where the fold is drawn
146
+ - a draw that comes late slows the fold instead of skipping part of it
147
+ - the fold's frames for the end the Duo rests at stay decoded while it is shown in its bezels
148
+
149
+ ### react
150
+
151
+ - `dist/react.js` has `"use client"` once, on its first line. a second one further down failed under Next.js with webpack
152
+
153
+ ### internal
154
+
155
+ - `bun run link <app>` and `bun run unlink <app>` put a local build into an app's `node_modules` as a copy, and put the installed one back
156
+
157
+ ## 0.1.1
158
+
159
+ ### iPhone Duo
160
+
161
+ - every layer follows the frame on screen, so nothing drifts during slow slider drags
162
+ - the turning screen's free edge darkens as it stands up, measured from Apple's fold
163
+ - the whole turning screen blurs near a right angle
164
+
165
+ ### device frame
166
+
167
+ - the status bar clock reads 04:20
168
+ - the device glides over when the panel changes side or opens and closes beside it
169
+
170
+ ### panel
171
+
172
+ - a panel that shrinks, as a row closes, keeps its top instead of jumping to the bottom
173
+
174
+ ### internal
175
+
176
+ - panel.ts and catalog.ts split into focused modules, no behaviour change
177
+
178
+ ## 0.1.0
179
+
180
+ ### breaking
181
+
182
+ - the default keys moved to shift: `⇧K` opens the panel (was `d`), `⇧R` replays animations (was `r`), and `⇧G` turns grab on and off with a press (was holding `⌘C`, `Ctrl+C` off a Mac). `⇧⌫` still resets
183
+ - `hotkey` is now the letter that toggles the panel with shift. `hotkey` and `grabKey` keep working; pass `grabKey: "meta+c"` to keep the old grab key
184
+ - the two iPhone Duo devices are now one, with an open or closed posture. a kept `iphone-duo-closed` or `iphone-duo-open` comes back as the Duo in that posture
185
+
186
+ ### stored data
187
+
188
+ - every item devknobs keeps in session or local storage now carries a version, so a later release can change its shape safely. data kept by 0.0.3 carries over: knobs, place, keys and preferences read as before
189
+
190
+ ### panel
191
+
192
+ - lives on either side of the window: drag or fling it across, and it keeps its place across reloads
193
+ - rows open their editor in place, one at a time, like an accordion
194
+ - an add knob button under the rows opens search; rows reorder by drag or by arrow keys
195
+ - rows regrouped: device and viewport split, related knobs merged into one row each, row icons from lucide
196
+ - a fresh panel lists device, scheme, text size and locale; grab is an action in the footer, not a row
197
+ - a control shows only once it does something (clock mode and speed, zoom, mat, header)
198
+ - settings behind a gear, sliding in like ios navigation: hide the handle, and rebind every shortcut, kept per site
199
+ - tooltips on icon-only controls; a refused key shakes and says why
200
+
201
+ ### device frame
202
+
203
+ - a device change animates, and rotation turns the device in view
204
+ - each device has its own rounded screen opening, tracked frame by frame
205
+ - a mat color knob (classic green, magenta and more); a new color splashes out from behind the device
206
+ - a reload keeps the mat, case and safari ui, from a snapshot the early script puts back on the first paint
207
+ - safari's reload and stop glyphs redrawn to match iOS 26; reload waits for the new page and stop stops it
208
+ - the user agent box shows only for a custom user agent
209
+
210
+ ### iPhone Duo
211
+
212
+ - folds in 3D around its hinge on Apple's hinge spring, from the device row's `fold` and `unfold`, or a fold slider
213
+ - the case is rendered offline from Apple's own Duo model, one frame every degree, shaded from Apple's bezel pictures
214
+ - the page stays flat behind the turning screen, as on Apple's product page
215
+ - the turning screen blurs through a small WebGL2 pass, safari's bars included, with plain layers as fallback
216
+ - thanks to jadon7: the scene, fold rig and screen projection come from [iphone-duo](https://github.com/jadon7/iphone-duo), MIT
217
+
218
+ ### grab
219
+
220
+ - the frame waits for the pointer to settle before it moves on
221
+ - the frame glides on transforms alone, with no layout or page paint per frame
222
+ - turning grab on takes the focus out of the panel, so the arrows are grab's
223
+
224
+ ### fixes
225
+
226
+ - the grab frame holds at fractional pixel ratios
227
+ - a focused plain scroll box leaves the shortcuts on; keys the panel acts on skip the browser default
228
+ - focus, touch and kept-place fixes across the panel
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Mert Düzgün
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,3 +1,111 @@
1
- # Temporary Holding Version
1
+ # @vinena/knobs
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ a dev-only panel for flipping browser preferences from inside the page. one
4
+ script tag and the knobs are there. no css to add, no code to change. zero
5
+ runtime dependencies.
6
+
7
+ ## install
8
+
9
+ with an ai agent: paste this setup prompt into claude code, codex or cursor, and
10
+ it installs @vinena/knobs and mounts it in development only. it is the copy setup
11
+ prompt button on https://knobs.dev too.
12
+
13
+ <!-- the same text is the install_prompt message in apps/web/messages/en.json; change both together. -->
14
+
15
+ ```
16
+ Install @vinena/knobs in this project. It is a dev-only panel that emulates browser preferences from inside the page. Docs: https://knobs.dev/docs
17
+
18
+ 1. Detect the package manager from the lockfile and add @vinena/knobs as a dev dependency (npm i -D @vinena/knobs, or the pnpm, yarn or bun equivalent).
19
+ 2. Mount it once, on the client, in development only:
20
+ - Next.js: make a small client component (the file starts with "use client"). In it, import dynamic from "next/dynamic", then const DevKnobs = process.env.NODE_ENV === "development" ? dynamic(() => import("@vinena/knobs/react").then((m) => m.DevKnobs), { ssr: false }) : null; and render {DevKnobs && <DevKnobs />}. Render that component once in app/layout (App Router) or pages/_app (Pages Router).
21
+ - Everything else with a bundler (Vite, TanStack Start, React Router, SvelteKit): call if (import.meta.env.DEV) import("@vinena/knobs").then(({ mount }) => mount()); in the client entry, or in a mount effect of the root component in an SSR app. Use the bundler's own dev flag where import.meta.env.DEV does not exist.
22
+ - A plain page with no bundler: skip the npm install and add <script src="//unpkg.com/@vinena/knobs/dist/index.global.js"></script> to the page. It mounts itself. Keep it out of the deployed page.
23
+ 3. Keep devknobs out of production builds. A static import stays in the bundle even behind a dev check, so gate the import itself as above. If the project has a build script, run it and check that the output has no devknobs.
24
+ 4. If the app reads media queries, the time or the user agent while it boots, or renders with React, add the early script as the first element in <head>, in development only: <script src="//unpkg.com/@vinena/knobs/dist/early.global.js"></script>
25
+ 5. Change nothing else in the project.
26
+ 6. Then tell me what you changed and how to open the panel: press Shift+K or click the handle on the right edge of the window. In the open panel, / searches the knobs. Shift+G grabs an element.
27
+ ```
28
+
29
+ or by hand:
30
+
31
+ ```
32
+ npm i -D @vinena/knobs
33
+ ```
34
+
35
+ ## usage
36
+
37
+ all of it is for dev only, so gate it yourself:
38
+
39
+ ```js
40
+ import { mount } from "@vinena/knobs";
41
+
42
+ if (import.meta.env.DEV) mount();
43
+ ```
44
+
45
+ or with no bundler, a script tag that mounts itself:
46
+
47
+ ```html
48
+ <script src="//unpkg.com/@vinena/knobs/dist/index.global.js"></script>
49
+ ```
50
+
51
+ press `⇧K`, or click the handle on the right edge of the window, to open the
52
+ panel. react, next.js and the early script are in the docs.
53
+
54
+ ## docs
55
+
56
+ - [start](https://knobs.dev/docs/start): install @vinena/knobs and mount it in
57
+ development only
58
+ - [the panel](https://knobs.dev/docs/panel): open it, move it, search it, pin
59
+ it and set its keys
60
+ - [knobs](https://knobs.dev/docs/knobs): every knob devknobs has and what it
61
+ does to the page
62
+ - [devices](https://knobs.dev/docs/devices): phone, tablet and laptop presets,
63
+ with mocks, bezels and the phone's browser drawn around the page
64
+ - [grab and inspect](https://knobs.dev/docs/grab): grab an element for a coding
65
+ agent, or inspect its box and css in the panel
66
+ - [requests and storage](https://knobs.dev/docs/requests-and-storage): see
67
+ every request the page makes, and read, edit and save what it keeps
68
+ - [agents](https://knobs.dev/docs/agents): let a coding agent drive the knobs,
69
+ wait for the page, grab what broke and fix it
70
+ - [chrome extension](https://knobs.dev/docs/extension): the panel on any site,
71
+ with some knobs set for real by Chrome
72
+ - [limits and faq](https://knobs.dev/docs/limits): what devknobs cannot fake
73
+ from inside a page, and common questions
74
+ - [privacy](https://knobs.dev/docs/privacy): what the npm package, the
75
+ extension and knobs.dev keep, and what they send
76
+
77
+ the full reference, every detail in one file, is at
78
+ <https://knobs.dev/llms-full.txt>.
79
+
80
+ ## development
81
+
82
+ to try a local build in an app:
83
+
84
+ ```
85
+ bun run link ../my-app
86
+ bun run unlink ../my-app
87
+ ```
88
+
89
+ a relative path is from the devknobs folder; absolute and `~` paths work too.
90
+ the app may use any package manager: a pnpm app's link into its store is kept
91
+ and put back as it was.
92
+
93
+ `link` builds, then copies the package into the app's `node_modules/@vinena/knobs`
94
+ and keeps the installed one beside it for `unlink` to put back. it is a copy,
95
+ not a symlink: Turbopack refuses a package linked from outside the app, and
96
+ other bundlers treat the real path as app source. restart the app's dev server
97
+ after each.
98
+
99
+ the controls for tuning the iphone duo fold's look by hand, `src/engine/foldtune.ts`,
100
+ are for development and never in the package: the build passes
101
+ `--define DEVKNOBS_TUNE=false` to every bundle and `scripts/tunefree.ts` fails
102
+ a build that has any of them. an app gets them by loading devknobs from source,
103
+ a bundler alias from `@vinena/knobs` to this repo's `src`, where the constant is not
104
+ defined and the table is on `window` under `Symbol.for("devknobs.foldtune")`.
105
+ an app that builds from source for production defines `DEVKNOBS_TUNE` false too.
106
+
107
+ ## license
108
+
109
+ MIT, except the bezel images in `dist/bezels`. bippy and the code adapted
110
+ from react-grab are MIT too, see [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)
111
+ for them and for the images' own terms.