@vinena/knobs 0.0.0-stage → 0.5.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.
- package/CHANGELOG.md +224 -0
- package/LICENSE +21 -0
- package/README.md +110 -2
- package/THIRD_PARTY_NOTICES.md +429 -0
- package/dist/bezels/duo-fold/fold-000.webp +0 -0
- package/dist/bezels/duo-fold/fold-001.webp +0 -0
- package/dist/bezels/duo-fold/fold-002.webp +0 -0
- package/dist/bezels/duo-fold/fold-003.webp +0 -0
- package/dist/bezels/duo-fold/fold-004.webp +0 -0
- package/dist/bezels/duo-fold/fold-005.webp +0 -0
- package/dist/bezels/duo-fold/fold-006.webp +0 -0
- package/dist/bezels/duo-fold/fold-007.webp +0 -0
- package/dist/bezels/duo-fold/fold-008.webp +0 -0
- package/dist/bezels/duo-fold/fold-009.webp +0 -0
- package/dist/bezels/duo-fold/fold-010.webp +0 -0
- package/dist/bezels/duo-fold/fold-011.webp +0 -0
- package/dist/bezels/duo-fold/fold-012.webp +0 -0
- package/dist/bezels/duo-fold/fold-013.webp +0 -0
- package/dist/bezels/duo-fold/fold-014.webp +0 -0
- package/dist/bezels/duo-fold/fold-015.webp +0 -0
- package/dist/bezels/duo-fold/fold-016.webp +0 -0
- package/dist/bezels/duo-fold/fold-017.webp +0 -0
- package/dist/bezels/duo-fold/fold-018.webp +0 -0
- package/dist/bezels/duo-fold/fold-019.webp +0 -0
- package/dist/bezels/duo-fold/fold-020.webp +0 -0
- package/dist/bezels/duo-fold/fold-021.webp +0 -0
- package/dist/bezels/duo-fold/fold-022.webp +0 -0
- package/dist/bezels/duo-fold/fold-023.webp +0 -0
- package/dist/bezels/duo-fold/fold-024.webp +0 -0
- package/dist/bezels/duo-fold/fold-025.webp +0 -0
- package/dist/bezels/duo-fold/fold-026.webp +0 -0
- package/dist/bezels/duo-fold/fold-027.webp +0 -0
- package/dist/bezels/duo-fold/fold-028.webp +0 -0
- package/dist/bezels/duo-fold/fold-029.webp +0 -0
- package/dist/bezels/duo-fold/fold-030.webp +0 -0
- package/dist/bezels/duo-fold/fold-031.webp +0 -0
- package/dist/bezels/duo-fold/fold-032.webp +0 -0
- package/dist/bezels/duo-fold/fold-033.webp +0 -0
- package/dist/bezels/duo-fold/fold-034.webp +0 -0
- package/dist/bezels/duo-fold/fold-035.webp +0 -0
- package/dist/bezels/duo-fold/fold-036.webp +0 -0
- package/dist/bezels/duo-fold/fold-037.webp +0 -0
- package/dist/bezels/duo-fold/fold-038.webp +0 -0
- package/dist/bezels/duo-fold/fold-039.webp +0 -0
- package/dist/bezels/duo-fold/fold-040.webp +0 -0
- package/dist/bezels/duo-fold/fold-041.webp +0 -0
- package/dist/bezels/duo-fold/fold-042.webp +0 -0
- package/dist/bezels/duo-fold/fold-043.webp +0 -0
- package/dist/bezels/duo-fold/fold-044.webp +0 -0
- package/dist/bezels/duo-fold/fold-045.webp +0 -0
- package/dist/bezels/duo-fold/fold-046.webp +0 -0
- package/dist/bezels/duo-fold/fold-047.webp +0 -0
- package/dist/bezels/duo-fold/fold-048.webp +0 -0
- package/dist/bezels/duo-fold/fold-049.webp +0 -0
- package/dist/bezels/duo-fold/fold-050.webp +0 -0
- package/dist/bezels/duo-fold/fold-051.webp +0 -0
- package/dist/bezels/duo-fold/fold-052.webp +0 -0
- package/dist/bezels/duo-fold/fold-053.webp +0 -0
- package/dist/bezels/duo-fold/fold-054.webp +0 -0
- package/dist/bezels/duo-fold/fold-055.webp +0 -0
- package/dist/bezels/duo-fold/fold-056.webp +0 -0
- package/dist/bezels/duo-fold/fold-057.webp +0 -0
- package/dist/bezels/duo-fold/fold-058.webp +0 -0
- package/dist/bezels/duo-fold/fold-059.webp +0 -0
- package/dist/bezels/duo-fold/fold-060.webp +0 -0
- package/dist/bezels/duo-fold/fold-061.webp +0 -0
- package/dist/bezels/duo-fold/fold-062.webp +0 -0
- package/dist/bezels/duo-fold/fold-063.webp +0 -0
- package/dist/bezels/duo-fold/fold-064.webp +0 -0
- package/dist/bezels/duo-fold/fold-065.webp +0 -0
- package/dist/bezels/duo-fold/fold-066.webp +0 -0
- package/dist/bezels/duo-fold/fold-067.webp +0 -0
- package/dist/bezels/duo-fold/fold-068.webp +0 -0
- package/dist/bezels/duo-fold/fold-069.webp +0 -0
- package/dist/bezels/duo-fold/fold-070.webp +0 -0
- package/dist/bezels/duo-fold/fold-071.webp +0 -0
- package/dist/bezels/duo-fold/fold-072.webp +0 -0
- package/dist/bezels/duo-fold/fold-073.webp +0 -0
- package/dist/bezels/duo-fold/fold-074.webp +0 -0
- package/dist/bezels/duo-fold/fold-075.webp +0 -0
- package/dist/bezels/duo-fold/fold-076.webp +0 -0
- package/dist/bezels/duo-fold/fold-077.webp +0 -0
- package/dist/bezels/duo-fold/fold-078.webp +0 -0
- package/dist/bezels/duo-fold/fold-079.webp +0 -0
- package/dist/bezels/duo-fold/fold-080.webp +0 -0
- package/dist/bezels/duo-fold/fold-081.webp +0 -0
- package/dist/bezels/duo-fold/fold-082.webp +0 -0
- package/dist/bezels/duo-fold/fold-083.webp +0 -0
- package/dist/bezels/duo-fold/fold-084.webp +0 -0
- package/dist/bezels/duo-fold/fold-085.webp +0 -0
- package/dist/bezels/duo-fold/fold-086.webp +0 -0
- package/dist/bezels/duo-fold/fold-087.webp +0 -0
- package/dist/bezels/duo-fold/fold-088.webp +0 -0
- package/dist/bezels/duo-fold/fold-089.webp +0 -0
- package/dist/bezels/duo-fold/fold-090.webp +0 -0
- package/dist/bezels/duo-fold/fold-091.webp +0 -0
- package/dist/bezels/duo-fold/fold-092.webp +0 -0
- package/dist/bezels/duo-fold/fold-093.webp +0 -0
- package/dist/bezels/duo-fold/fold-094.webp +0 -0
- package/dist/bezels/duo-fold/fold-095.webp +0 -0
- package/dist/bezels/duo-fold/fold-096.webp +0 -0
- package/dist/bezels/duo-fold/fold-097.webp +0 -0
- package/dist/bezels/duo-fold/fold-098.webp +0 -0
- package/dist/bezels/duo-fold/fold-099.webp +0 -0
- package/dist/bezels/duo-fold/fold-100.webp +0 -0
- package/dist/bezels/duo-fold/fold-101.webp +0 -0
- package/dist/bezels/duo-fold/fold-102.webp +0 -0
- package/dist/bezels/duo-fold/fold-103.webp +0 -0
- package/dist/bezels/duo-fold/fold-104.webp +0 -0
- package/dist/bezels/duo-fold/fold-105.webp +0 -0
- package/dist/bezels/duo-fold/fold-106.webp +0 -0
- package/dist/bezels/duo-fold/fold-107.webp +0 -0
- package/dist/bezels/duo-fold/fold-108.webp +0 -0
- package/dist/bezels/duo-fold/fold-109.webp +0 -0
- package/dist/bezels/duo-fold/fold-110.webp +0 -0
- package/dist/bezels/duo-fold/fold-111.webp +0 -0
- package/dist/bezels/duo-fold/fold-112.webp +0 -0
- package/dist/bezels/duo-fold/fold-113.webp +0 -0
- package/dist/bezels/duo-fold/fold-114.webp +0 -0
- package/dist/bezels/duo-fold/fold-115.webp +0 -0
- package/dist/bezels/duo-fold/fold-116.webp +0 -0
- package/dist/bezels/duo-fold/fold-117.webp +0 -0
- package/dist/bezels/duo-fold/fold-118.webp +0 -0
- package/dist/bezels/duo-fold/fold-119.webp +0 -0
- package/dist/bezels/duo-fold/fold-120.webp +0 -0
- package/dist/bezels/duo-fold/fold-121.webp +0 -0
- package/dist/bezels/duo-fold/fold-122.webp +0 -0
- package/dist/bezels/duo-fold/fold-123.webp +0 -0
- package/dist/bezels/duo-fold/fold-124.webp +0 -0
- package/dist/bezels/duo-fold/fold-125.webp +0 -0
- package/dist/bezels/duo-fold/fold-126.webp +0 -0
- package/dist/bezels/duo-fold/fold-127.webp +0 -0
- package/dist/bezels/duo-fold/fold-128.webp +0 -0
- package/dist/bezels/duo-fold/fold-129.webp +0 -0
- package/dist/bezels/duo-fold/fold-130.webp +0 -0
- package/dist/bezels/duo-fold/fold-131.webp +0 -0
- package/dist/bezels/duo-fold/fold-132.webp +0 -0
- package/dist/bezels/duo-fold/fold-133.webp +0 -0
- package/dist/bezels/duo-fold/fold-134.webp +0 -0
- package/dist/bezels/duo-fold/fold-135.webp +0 -0
- package/dist/bezels/duo-fold/fold-136.webp +0 -0
- package/dist/bezels/duo-fold/fold-137.webp +0 -0
- package/dist/bezels/duo-fold/fold-138.webp +0 -0
- package/dist/bezels/duo-fold/fold-139.webp +0 -0
- package/dist/bezels/duo-fold/fold-140.webp +0 -0
- package/dist/bezels/duo-fold/fold-141.webp +0 -0
- package/dist/bezels/duo-fold/fold-142.webp +0 -0
- package/dist/bezels/duo-fold/fold-143.webp +0 -0
- package/dist/bezels/duo-fold/fold-144.webp +0 -0
- package/dist/bezels/duo-fold/fold-145.webp +0 -0
- package/dist/bezels/duo-fold/fold-146.webp +0 -0
- package/dist/bezels/duo-fold/fold-147.webp +0 -0
- package/dist/bezels/duo-fold/fold-148.webp +0 -0
- package/dist/bezels/duo-fold/fold-149.webp +0 -0
- package/dist/bezels/duo-fold/fold-150.webp +0 -0
- package/dist/bezels/duo-fold/fold-151.webp +0 -0
- package/dist/bezels/duo-fold/fold-152.webp +0 -0
- package/dist/bezels/duo-fold/fold-153.webp +0 -0
- package/dist/bezels/duo-fold/fold-154.webp +0 -0
- package/dist/bezels/duo-fold/fold-155.webp +0 -0
- package/dist/bezels/duo-fold/fold-156.webp +0 -0
- package/dist/bezels/duo-fold/fold-157.webp +0 -0
- package/dist/bezels/duo-fold/fold-158.webp +0 -0
- package/dist/bezels/duo-fold/fold-159.webp +0 -0
- package/dist/bezels/duo-fold/fold-160.webp +0 -0
- package/dist/bezels/duo-fold/fold-161.webp +0 -0
- package/dist/bezels/duo-fold/fold-162.webp +0 -0
- package/dist/bezels/duo-fold/fold-163.webp +0 -0
- package/dist/bezels/duo-fold/fold-164.webp +0 -0
- package/dist/bezels/duo-fold/fold-165.webp +0 -0
- package/dist/bezels/duo-fold/fold-166.webp +0 -0
- package/dist/bezels/duo-fold/fold-167.webp +0 -0
- package/dist/bezels/duo-fold/fold-168.webp +0 -0
- package/dist/bezels/duo-fold/fold-169.webp +0 -0
- package/dist/bezels/duo-fold/fold-170.webp +0 -0
- package/dist/bezels/duo-fold/fold-171.webp +0 -0
- package/dist/bezels/duo-fold/fold-172.webp +0 -0
- package/dist/bezels/duo-fold/fold-173.webp +0 -0
- package/dist/bezels/duo-fold/fold-174.webp +0 -0
- package/dist/bezels/duo-fold/fold-175.webp +0 -0
- package/dist/bezels/duo-fold/fold-176.webp +0 -0
- package/dist/bezels/duo-fold/fold-177.webp +0 -0
- package/dist/bezels/duo-fold/fold-178.webp +0 -0
- package/dist/bezels/duo-fold/fold-179.webp +0 -0
- package/dist/bezels/duo-fold/fold-180.webp +0 -0
- package/dist/bezels/duo-fold/still-000.webp +0 -0
- package/dist/bezels/duo-fold/still-161.webp +0 -0
- package/dist/bezels/duo-fold/still-162.webp +0 -0
- package/dist/bezels/duo-fold/still-163.webp +0 -0
- package/dist/bezels/duo-fold/still-164.webp +0 -0
- package/dist/bezels/duo-fold/still-165.webp +0 -0
- package/dist/bezels/duo-fold/still-166.webp +0 -0
- package/dist/bezels/duo-fold/still-167.webp +0 -0
- package/dist/bezels/duo-fold/still-168.webp +0 -0
- package/dist/bezels/duo-fold/still-169.webp +0 -0
- package/dist/bezels/duo-fold/still-170.webp +0 -0
- package/dist/bezels/duo-fold/still-171.webp +0 -0
- package/dist/bezels/duo-fold/still-172.webp +0 -0
- package/dist/bezels/duo-fold/still-173.webp +0 -0
- package/dist/bezels/duo-fold/still-174.webp +0 -0
- package/dist/bezels/duo-fold/still-175.webp +0 -0
- package/dist/bezels/duo-fold/still-176.webp +0 -0
- package/dist/bezels/duo-fold/still-177.webp +0 -0
- package/dist/bezels/duo-fold/still-178.webp +0 -0
- package/dist/bezels/duo-fold/still-179.webp +0 -0
- package/dist/bezels/duo-fold/still-180.webp +0 -0
- package/dist/bezels/iphone-16-plus.webp +0 -0
- package/dist/bezels/iphone-16-pro-max.webp +0 -0
- package/dist/bezels/iphone-16-pro.webp +0 -0
- package/dist/bezels/iphone-16.webp +0 -0
- package/dist/bezels/iphone-17-pro-max.webp +0 -0
- package/dist/bezels/iphone-17-pro.webp +0 -0
- package/dist/bezels/iphone-17.webp +0 -0
- package/dist/bezels/iphone-18-pro-max.webp +0 -0
- package/dist/bezels/iphone-18-pro.webp +0 -0
- package/dist/bezels/iphone-air.webp +0 -0
- package/dist/bezels/iphone-duo-inner-open-landscape.webp +0 -0
- package/dist/bezels/iphone-duo-inner-open-portrait.webp +0 -0
- package/dist/bezels/iphone-duo-outer-closed.webp +0 -0
- package/dist/bezels/iphone-se.webp +0 -0
- package/dist/bezels/pixel-10-pro-xl.webp +0 -0
- package/dist/bezels/pixel-10-pro.webp +0 -0
- package/dist/bezels/pixel-10.webp +0 -0
- package/dist/bezels/pixel-10a.webp +0 -0
- package/dist/bezels/pixel-9-pro-xl.webp +0 -0
- package/dist/bezels/pixel-9-pro.webp +0 -0
- package/dist/bezels/pixel-9.webp +0 -0
- package/dist/early.d.ts +1 -0
- package/dist/early.global.js +8 -0
- package/dist/elementsview-6g274ptr.js +2873 -0
- package/dist/elementsview-jnkbhzkj.js +2873 -0
- package/dist/elementsview-pkzp9kc6.js +2874 -0
- package/dist/elementsview-tf4qzmtw.js +2874 -0
- package/dist/engine/address.d.ts +31 -0
- package/dist/engine/animations.d.ts +13 -0
- package/dist/engine/barshot.d.ts +48 -0
- package/dist/engine/bezels.d.ts +140 -0
- package/dist/engine/bezelurls.d.ts +5 -0
- package/dist/engine/browserdraw.d.ts +57 -0
- package/dist/engine/browserkit.d.ts +59 -0
- package/dist/engine/browserui.d.ts +177 -0
- package/dist/engine/check.d.ts +8 -0
- package/dist/engine/chromedraw.d.ts +17 -0
- package/dist/engine/clock.d.ts +91 -0
- package/dist/engine/color.d.ts +37 -0
- package/dist/engine/describe.d.ts +49 -0
- package/dist/engine/devices.d.ts +96 -0
- package/dist/engine/dock.d.ts +53 -0
- package/dist/engine/endroom.d.ts +21 -0
- package/dist/engine/fit.d.ts +75 -0
- package/dist/engine/fold.d.ts +562 -0
- package/dist/engine/foldframes.d.ts +98 -0
- package/dist/engine/foldgl.d.ts +151 -0
- package/dist/engine/foldhand.d.ts +23 -0
- package/dist/engine/foldlook.d.ts +49 -0
- package/dist/engine/foldpage.d.ts +167 -0
- package/dist/engine/foldrun.d.ts +98 -0
- package/dist/engine/frame.d.ts +142 -0
- package/dist/engine/frameglide.d.ts +71 -0
- package/dist/engine/framekit.d.ts +7 -0
- package/dist/engine/frames.d.ts +42 -0
- package/dist/engine/fresh.d.ts +59 -0
- package/dist/engine/geo.d.ts +58 -0
- package/dist/engine/header.d.ts +16 -0
- package/dist/engine/identity.d.ts +27 -0
- package/dist/engine/index.d.ts +58 -0
- package/dist/engine/intl.d.ts +23 -0
- package/dist/engine/locale.d.ts +86 -0
- package/dist/engine/mat.d.ts +64 -0
- package/dist/engine/matchmedia.d.ts +25 -0
- package/dist/engine/matcolors.d.ts +45 -0
- package/dist/engine/matsplash.d.ts +81 -0
- package/dist/engine/media.d.ts +55 -0
- package/dist/engine/mock.d.ts +65 -0
- package/dist/engine/mockdata.d.ts +42 -0
- package/dist/engine/mockdraw.d.ts +21 -0
- package/dist/engine/morph.d.ts +214 -0
- package/dist/engine/morphrun.d.ts +49 -0
- package/dist/engine/native.d.ts +129 -0
- package/dist/engine/network.d.ts +8 -0
- package/dist/engine/notice.d.ts +15 -0
- package/dist/engine/objectfit.d.ts +35 -0
- package/dist/engine/outlines.d.ts +2 -0
- package/dist/engine/overflow.d.ts +11 -0
- package/dist/engine/owninline.d.ts +16 -0
- package/dist/engine/pagefonts.d.ts +21 -0
- package/dist/engine/pageshot.d.ts +127 -0
- package/dist/engine/placeholder.d.ts +89 -0
- package/dist/engine/pseudo.d.ts +15 -0
- package/dist/engine/ready.d.ts +9 -0
- package/dist/engine/reload.d.ts +35 -0
- package/dist/engine/remount.d.ts +30 -0
- package/dist/engine/replay.d.ts +7 -0
- package/dist/engine/safaridraw.d.ts +22 -0
- package/dist/engine/scrollbars.d.ts +17 -0
- package/dist/engine/scrollkeep.d.ts +124 -0
- package/dist/engine/spacing.d.ts +2 -0
- package/dist/engine/speed.d.ts +11 -0
- package/dist/engine/store.d.ts +68 -0
- package/dist/engine/stored.d.ts +17 -0
- package/dist/engine/style.d.ts +27 -0
- package/dist/engine/system.d.ts +15 -0
- package/dist/engine/text.d.ts +53 -0
- package/dist/engine/time.d.ts +32 -0
- package/dist/engine/touch.d.ts +20 -0
- package/dist/engine/touchdot.d.ts +71 -0
- package/dist/engine/touchmark.d.ts +27 -0
- package/dist/engine/touchpointer.d.ts +113 -0
- package/dist/engine/tree.d.ts +9 -0
- package/dist/engine/turnrun.d.ts +74 -0
- package/dist/engine/ua.d.ts +55 -0
- package/dist/engine/underneath.d.ts +7 -0
- package/dist/engine/viewportcss.d.ts +7 -0
- package/dist/engine/vision.d.ts +3 -0
- package/dist/engine/width.d.ts +56 -0
- package/dist/engine/zoom.d.ts +33 -0
- package/dist/framekit-095qevka.js +8838 -0
- package/dist/framekit-3n7p79ht.js +8839 -0
- package/dist/framekit-g96t6nmq.js +8838 -0
- package/dist/framekit-q5aad770.js +8839 -0
- package/dist/global.d.ts +1 -0
- package/dist/grab/boxmodel.d.ts +109 -0
- package/dist/grab/boxtext.d.ts +17 -0
- package/dist/grab/card.d.ts +45 -0
- package/dist/grab/cardread.d.ts +22 -0
- package/dist/grab/cardview.d.ts +18 -0
- package/dist/grab/clipboard.d.ts +8 -0
- package/dist/grab/colors.d.ts +31 -0
- package/dist/grab/colorvalue.d.ts +40 -0
- package/dist/grab/context.d.ts +25 -0
- package/dist/grab/control.d.ts +37 -0
- package/dist/grab/copy.d.ts +7 -0
- package/dist/grab/dwell.d.ts +29 -0
- package/dist/grab/fiber.d.ts +17 -0
- package/dist/grab/fontused.d.ts +23 -0
- package/dist/grab/hit.d.ts +19 -0
- package/dist/grab/hook.d.ts +7 -0
- package/dist/grab/index.d.ts +9 -0
- package/dist/grab/inspect.d.ts +31 -0
- package/dist/grab/keys.d.ts +84 -0
- package/dist/grab/locate.d.ts +63 -0
- package/dist/grab/mode.d.ts +56 -0
- package/dist/grab/navigate.d.ts +21 -0
- package/dist/grab/outline.d.ts +16 -0
- package/dist/grab/overlay.d.ts +135 -0
- package/dist/grab/paint.d.ts +7 -0
- package/dist/grab/paths.d.ts +27 -0
- package/dist/grab/picks.d.ts +9 -0
- package/dist/grab/place.d.ts +25 -0
- package/dist/grab/preview.d.ts +12 -0
- package/dist/grab/selector.d.ts +15 -0
- package/dist/grab/source.d.ts +68 -0
- package/dist/grab/stack.d.ts +49 -0
- package/dist/grab/theme.d.ts +85 -0
- package/dist/grab/types.d.ts +52 -0
- package/dist/host.d.ts +7 -0
- package/dist/index-0casarhy.js +324 -0
- package/dist/index-2d6wvs8h.js +528 -0
- package/dist/index-33x9hxe3.js +4563 -0
- package/dist/index-5baxvd3v.js +4424 -0
- package/dist/index-5d6qzte3.js +357 -0
- package/dist/index-64rd634h.js +686 -0
- package/dist/index-78r0f8pw.js +27 -0
- package/dist/index-d0cjxjsm.js +21 -0
- package/dist/index-dvr4x91q.js +4800 -0
- package/dist/index-hw56t3zy.js +4800 -0
- package/dist/index-k015tb6c.js +357 -0
- package/dist/index-ke6v7919.js +4801 -0
- package/dist/index-kzsb9drs.js +4801 -0
- package/dist/index-peh33xjv.js +346 -0
- package/dist/index-qxye1j73.js +528 -0
- package/dist/index-z5ytnj01.js +4563 -0
- package/dist/index-ztnjefrh.js +23 -0
- package/dist/index-zvze25nf.js +686 -0
- package/dist/index.d.ts +116 -0
- package/dist/index.global.js +2655 -0
- package/dist/index.js +9262 -0
- package/dist/instance.d.ts +29 -0
- package/dist/react-4kbj1t4h.js +687 -0
- package/dist/react-65tgdbs8.js +22 -0
- package/dist/react-71a9ypex.js +529 -0
- package/dist/react-adky72h9.js +29 -0
- package/dist/react-carf84xv.js +4420 -0
- package/dist/react-eygws6cx.js +358 -0
- package/dist/react-h9w04skh.js +25 -0
- package/dist/react-mv9y20jy.js +358 -0
- package/dist/react-pdvseef0.js +325 -0
- package/dist/react-qv0nykcv.js +4564 -0
- package/dist/react-sq9pkw4k.js +687 -0
- package/dist/react-vjm88w4t.js +4564 -0
- package/dist/react-xxfpfddf.js +347 -0
- package/dist/react-znfrjqk8.js +529 -0
- package/dist/react.d.ts +6 -0
- package/dist/react.js +9255 -0
- package/dist/requests/body.d.ts +44 -0
- package/dist/requests/eventsource.d.ts +14 -0
- package/dist/requests/fetch.d.ts +14 -0
- package/dist/requests/index.d.ts +35 -0
- package/dist/requests/patch.d.ts +17 -0
- package/dist/requests/quiet.d.ts +12 -0
- package/dist/requests/record.d.ts +40 -0
- package/dist/requests/resource.d.ts +28 -0
- package/dist/requests/shared.d.ts +34 -0
- package/dist/requests/stack.d.ts +7 -0
- package/dist/requests/store.d.ts +37 -0
- package/dist/requests/types.d.ts +140 -0
- package/dist/requests/xhr.d.ts +16 -0
- package/dist/storage/cache.d.ts +32 -0
- package/dist/storage/clear.d.ts +35 -0
- package/dist/storage/cookies.d.ts +71 -0
- package/dist/storage/format.d.ts +53 -0
- package/dist/storage/idb.d.ts +62 -0
- package/dist/storage/onload.d.ts +47 -0
- package/dist/storage/presets.d.ts +79 -0
- package/dist/storage/site.d.ts +51 -0
- package/dist/storage/web.d.ts +57 -0
- package/dist/storageview-j9d44f99.js +2729 -0
- package/dist/storageview-sb23henh.js +2729 -0
- package/dist/storageview-vdkbp6rt.js +2728 -0
- package/dist/storageview-vf8v8q8j.js +2728 -0
- package/dist/styles/cascade.d.ts +59 -0
- package/dist/styles/collect.d.ts +73 -0
- package/dist/styles/declarations.d.ts +30 -0
- package/dist/styles/index.d.ts +20 -0
- package/dist/styles/inherited.d.ts +5 -0
- package/dist/styles/match.d.ts +41 -0
- package/dist/styles/selector.d.ts +36 -0
- package/dist/styles/tree.d.ts +14 -0
- package/dist/styles/types.d.ts +117 -0
- package/dist/styles/varrefs.d.ts +35 -0
- package/dist/types.d.ts +221 -0
- package/dist/ui/actions.d.ts +26 -0
- package/dist/ui/bindings.d.ts +89 -0
- package/dist/ui/boxdiagram.d.ts +50 -0
- package/dist/ui/catalog.d.ts +195 -0
- package/dist/ui/colors.d.ts +51 -0
- package/dist/ui/column.d.ts +22 -0
- package/dist/ui/copytext.d.ts +6 -0
- package/dist/ui/deviceknobs.d.ts +20 -0
- package/dist/ui/dockslide.d.ts +100 -0
- package/dist/ui/dom.d.ts +68 -0
- package/dist/ui/domtree.d.ts +143 -0
- package/dist/ui/drag.d.ts +34 -0
- package/dist/ui/editors.d.ts +30 -0
- package/dist/ui/elementsview.d.ts +32 -0
- package/dist/ui/foldslider.d.ts +48 -0
- package/dist/ui/footer.d.ts +51 -0
- package/dist/ui/hold.d.ts +20 -0
- package/dist/ui/icons.d.ts +145 -0
- package/dist/ui/inspector.d.ts +59 -0
- package/dist/ui/keys.d.ts +180 -0
- package/dist/ui/kit.d.ts +336 -0
- package/dist/ui/knobs.d.ts +41 -0
- package/dist/ui/list.d.ts +68 -0
- package/dist/ui/palette.d.ts +59 -0
- package/dist/ui/pane.d.ts +151 -0
- package/dist/ui/panel.d.ts +56 -0
- package/dist/ui/pin.d.ts +28 -0
- package/dist/ui/place.d.ts +136 -0
- package/dist/ui/prefs.d.ts +53 -0
- package/dist/ui/radio.d.ts +37 -0
- package/dist/ui/requestdetail.d.ts +56 -0
- package/dist/ui/requestformat.d.ts +142 -0
- package/dist/ui/requestparts.d.ts +312 -0
- package/dist/ui/requests.d.ts +48 -0
- package/dist/ui/rows.d.ts +72 -0
- package/dist/ui/search.d.ts +29 -0
- package/dist/ui/settings.d.ts +69 -0
- package/dist/ui/size.d.ts +105 -0
- package/dist/ui/slide.d.ts +46 -0
- package/dist/ui/stage.d.ts +24 -0
- package/dist/ui/storageaction.d.ts +22 -0
- package/dist/ui/storagecookies.d.ts +5 -0
- package/dist/ui/storagedeep.d.ts +18 -0
- package/dist/ui/storageparts.d.ts +131 -0
- package/dist/ui/storagepresets.d.ts +19 -0
- package/dist/ui/storageview.d.ts +45 -0
- package/dist/ui/storageweb.d.ts +11 -0
- package/dist/ui/styles.d.ts +1 -0
- package/dist/ui/stylesapplied.d.ts +46 -0
- package/dist/ui/stylesformat.d.ts +78 -0
- package/dist/ui/stylesview.d.ts +118 -0
- package/dist/ui/swatches.d.ts +26 -0
- package/dist/ui/syntax.d.ts +34 -0
- package/dist/ui/tooltip.d.ts +64 -0
- package/package.json +60 -4
- package/skills/devknobs/SKILL.md +214 -0
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,224 @@
|
|
|
1
|
+
# changelog
|
|
2
|
+
|
|
3
|
+
## 0.5.0
|
|
4
|
+
|
|
5
|
+
- first release as @vinena/knobs (was devknobs)
|
|
6
|
+
- 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)`
|
|
7
|
+
- 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
|
|
8
|
+
|
|
9
|
+
## 0.4.0
|
|
10
|
+
|
|
11
|
+
- 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
|
|
12
|
+
- `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
|
|
13
|
+
- 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
|
|
14
|
+
- `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
|
|
15
|
+
- `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
|
|
16
|
+
- `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
|
|
17
|
+
- 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
|
|
18
|
+
- 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
|
|
19
|
+
- `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
|
|
20
|
+
- 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
|
|
21
|
+
- 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
|
|
22
|
+
- `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
|
|
23
|
+
- `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
|
|
24
|
+
- `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
|
|
25
|
+
- 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
|
|
26
|
+
- `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
|
|
27
|
+
- 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
|
|
28
|
+
|
|
29
|
+
## 0.3.0
|
|
30
|
+
|
|
31
|
+
### agents
|
|
32
|
+
|
|
33
|
+
- `describe()` lists every knob as json, with its values, its default and what applying it reloads: nothing, the frame or the page
|
|
34
|
+
- `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
|
|
35
|
+
- `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
|
|
36
|
+
- `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
|
|
37
|
+
- `reset()` leaves the panel open or closed, docked or not, and its handle as it is. `describe()` says so
|
|
38
|
+
- `grab()` takes an element, an array or a NodeList of them, skips entries that are not elements and resolves `null` when none are left
|
|
39
|
+
- both are on `window.devknobs` and exported from `devknobs`
|
|
40
|
+
- `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
|
|
41
|
+
- `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
|
|
42
|
+
- `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
|
|
43
|
+
- an agent skill ships in the package at `skills/devknobs/SKILL.md`
|
|
44
|
+
|
|
45
|
+
### grab
|
|
46
|
+
|
|
47
|
+
- 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
|
|
48
|
+
|
|
49
|
+
## 0.2.1
|
|
50
|
+
|
|
51
|
+
### device frame
|
|
52
|
+
|
|
53
|
+
- 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
|
|
54
|
+
- 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
|
|
55
|
+
|
|
56
|
+
### grab
|
|
57
|
+
|
|
58
|
+
- 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
|
|
59
|
+
- the hit test under the pointer skips children whose box is nowhere near it
|
|
60
|
+
|
|
61
|
+
### panel
|
|
62
|
+
|
|
63
|
+
- 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
|
|
64
|
+
|
|
65
|
+
### package
|
|
66
|
+
|
|
67
|
+
- the install section starts with a setup prompt to paste into an AI agent, and the Next.js example is a whole client component
|
|
68
|
+
- 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 ü
|
|
69
|
+
|
|
70
|
+
## 0.2.0
|
|
71
|
+
|
|
72
|
+
### requests
|
|
73
|
+
|
|
74
|
+
- `⇧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
|
|
75
|
+
|
|
76
|
+
### fresh mode
|
|
77
|
+
|
|
78
|
+
- `?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
|
|
79
|
+
|
|
80
|
+
### inspect
|
|
81
|
+
|
|
82
|
+
- `⇧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
|
|
83
|
+
- 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
|
|
84
|
+
- 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
|
|
85
|
+
- 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
|
|
86
|
+
- 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
|
|
87
|
+
- 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
|
|
88
|
+
- 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
|
|
89
|
+
|
|
90
|
+
### storage
|
|
91
|
+
|
|
92
|
+
- 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
|
|
93
|
+
|
|
94
|
+
### panel
|
|
95
|
+
|
|
96
|
+
- 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
|
|
97
|
+
- 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
|
|
98
|
+
- 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
|
|
99
|
+
- 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
|
|
100
|
+
- 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
|
|
101
|
+
- 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
|
|
102
|
+
|
|
103
|
+
### iPhone Duo
|
|
104
|
+
|
|
105
|
+
- 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
|
|
106
|
+
- 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
|
|
107
|
+
- nothing marks the hinge: the bend's dark strip is gone from both halves
|
|
108
|
+
- 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
|
|
109
|
+
- a fold that turns copies of the half has no black px down the hinge either
|
|
110
|
+
- 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
|
|
111
|
+
- 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
|
|
112
|
+
- 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
|
|
113
|
+
- 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
|
|
114
|
+
- 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
|
|
115
|
+
- 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
|
|
116
|
+
- nothing devknobs put on the page is on the half that turns, nor the browser's box for a picture it could not load
|
|
117
|
+
- 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
|
|
118
|
+
|
|
119
|
+
### types
|
|
120
|
+
|
|
121
|
+
- `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
|
|
122
|
+
- `PanelValue`, and with it `DevknobsState`, has `docked`, true while the panel is pinned
|
|
123
|
+
|
|
124
|
+
### fixes
|
|
125
|
+
|
|
126
|
+
- 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
|
|
127
|
+
|
|
128
|
+
### colors
|
|
129
|
+
|
|
130
|
+
- 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
|
|
131
|
+
- 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
|
|
132
|
+
- 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
|
|
133
|
+
|
|
134
|
+
## 0.1.2
|
|
135
|
+
|
|
136
|
+
### iPhone Duo
|
|
137
|
+
|
|
138
|
+
- 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
|
|
139
|
+
- 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
|
|
140
|
+
- the half that turns shows the page in its own fonts, not a fallback
|
|
141
|
+
- a fold back, a hand letting go and a hand taking the hinge go on from exactly where the fold is drawn
|
|
142
|
+
- a draw that comes late slows the fold instead of skipping part of it
|
|
143
|
+
- the fold's frames for the end the Duo rests at stay decoded while it is shown in its bezels
|
|
144
|
+
|
|
145
|
+
### react
|
|
146
|
+
|
|
147
|
+
- `dist/react.js` has `"use client"` once, on its first line. a second one further down failed under Next.js with webpack
|
|
148
|
+
|
|
149
|
+
### internal
|
|
150
|
+
|
|
151
|
+
- `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
|
|
152
|
+
|
|
153
|
+
## 0.1.1
|
|
154
|
+
|
|
155
|
+
### iPhone Duo
|
|
156
|
+
|
|
157
|
+
- every layer follows the frame on screen, so nothing drifts during slow slider drags
|
|
158
|
+
- the turning screen's free edge darkens as it stands up, measured from Apple's fold
|
|
159
|
+
- the whole turning screen blurs near a right angle
|
|
160
|
+
|
|
161
|
+
### device frame
|
|
162
|
+
|
|
163
|
+
- the status bar clock reads 04:20
|
|
164
|
+
- the device glides over when the panel changes side or opens and closes beside it
|
|
165
|
+
|
|
166
|
+
### panel
|
|
167
|
+
|
|
168
|
+
- a panel that shrinks, as a row closes, keeps its top instead of jumping to the bottom
|
|
169
|
+
|
|
170
|
+
### internal
|
|
171
|
+
|
|
172
|
+
- panel.ts and catalog.ts split into focused modules, no behaviour change
|
|
173
|
+
|
|
174
|
+
## 0.1.0
|
|
175
|
+
|
|
176
|
+
### breaking
|
|
177
|
+
|
|
178
|
+
- 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
|
|
179
|
+
- `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
|
|
180
|
+
- 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
|
|
181
|
+
|
|
182
|
+
### stored data
|
|
183
|
+
|
|
184
|
+
- 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
|
|
185
|
+
|
|
186
|
+
### panel
|
|
187
|
+
|
|
188
|
+
- lives on either side of the window: drag or fling it across, and it keeps its place across reloads
|
|
189
|
+
- rows open their editor in place, one at a time, like an accordion
|
|
190
|
+
- an add knob button under the rows opens search; rows reorder by drag or by arrow keys
|
|
191
|
+
- rows regrouped: device and viewport split, related knobs merged into one row each, row icons from lucide
|
|
192
|
+
- a fresh panel lists device, scheme, text size and locale; grab is an action in the footer, not a row
|
|
193
|
+
- a control shows only once it does something (clock mode and speed, zoom, mat, header)
|
|
194
|
+
- settings behind a gear, sliding in like ios navigation: hide the handle, and rebind every shortcut, kept per site
|
|
195
|
+
- tooltips on icon-only controls; a refused key shakes and says why
|
|
196
|
+
|
|
197
|
+
### device frame
|
|
198
|
+
|
|
199
|
+
- a device change animates, and rotation turns the device in view
|
|
200
|
+
- each device has its own rounded screen opening, tracked frame by frame
|
|
201
|
+
- a mat color knob (classic green, magenta and more); a new color splashes out from behind the device
|
|
202
|
+
- a reload keeps the mat, case and safari ui, from a snapshot the early script puts back on the first paint
|
|
203
|
+
- safari's reload and stop glyphs redrawn to match iOS 26; reload waits for the new page and stop stops it
|
|
204
|
+
- the user agent box shows only for a custom user agent
|
|
205
|
+
|
|
206
|
+
### iPhone Duo
|
|
207
|
+
|
|
208
|
+
- folds in 3D around its hinge on Apple's hinge spring, from the device row's `fold` and `unfold`, or a fold slider
|
|
209
|
+
- the case is rendered offline from Apple's own Duo model, one frame every degree, shaded from Apple's bezel pictures
|
|
210
|
+
- the page stays flat behind the turning screen, as on Apple's product page
|
|
211
|
+
- the turning screen blurs through a small WebGL2 pass, safari's bars included, with plain layers as fallback
|
|
212
|
+
- thanks to jadon7: the scene, fold rig and screen projection come from [iphone-duo](https://github.com/jadon7/iphone-duo), MIT
|
|
213
|
+
|
|
214
|
+
### grab
|
|
215
|
+
|
|
216
|
+
- the frame waits for the pointer to settle before it moves on
|
|
217
|
+
- the frame glides on transforms alone, with no layout or page paint per frame
|
|
218
|
+
- turning grab on takes the focus out of the panel, so the arrows are grab's
|
|
219
|
+
|
|
220
|
+
### fixes
|
|
221
|
+
|
|
222
|
+
- the grab frame holds at fractional pixel ratios
|
|
223
|
+
- a focused plain scroll box leaves the shortcuts on; keys the panel acts on skip the browser default
|
|
224
|
+
- 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
|
-
#
|
|
1
|
+
# @vinena/knobs
|
|
2
2
|
|
|
3
|
-
|
|
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.
|