@kitlangton/knobs 0.2.0 → 0.3.0

package/dist/dev/{chunk-4km87zfx.js → chunk-v8ssbcbk.js}

@@ -1,12 +1,13 @@
 import {
   __preload
-} from "./chunk-gezhc24g.js";
+} from "./chunk-7xgkerd2.js";
 import {
   iconSvg,
   readSession,
   writeSession,
-  injectStyles
-} from "./chunk-693jd1gj.js";
+  injectStyles,
+  toggleLayer
+} from "./chunk-pmkvb9ep.js";
 
 // src/panel/attach.ts
 function attach(controls, element, options = {}) {
@@ -32,11 +33,11 @@ function attach(controls, element, options = {}) {
   let addedTabIndex = !element.hasAttribute("tabindex") && !element.matches("a[href],button,input,select,textarea");
   if (addedTabIndex)
     element.tabIndex = 0;
-  let hovered = element.matches(":hover"), disposed = !1, loading = !1, panel, leaving, revealed = () => reveal !== "shortcut" || knobsMode(win), position = () => {
+  let hovered = element.matches(":hover"), disposed = !1, loading = !1, panel, leaving, toggledOn = !0, revealed = () => reveal !== "shortcut" || knobsMode(win), position = () => {
     let box = element.getBoundingClientRect();
     chip.style.left = `${Math.max(4, Math.min(win.innerWidth - chip.offsetWidth - 4, box.right - chip.offsetWidth - 6))}px`, chip.style.top = `${Math.max(4, box.top + 6)}px`;
   }, update = () => {
-    let shown = controls.enabled && revealed() && !panel && (reveal === "always" || hovered || element.contains(doc.activeElement) || doc.activeElement === chip);
+    let shown = controls.enabled && toggledOn && revealed() && !panel && (reveal === "always" || hovered || element.contains(doc.activeElement) || doc.activeElement === chip);
     if (shown)
       position();
     if (setShown(shown), !controls.enabled)
@@ -82,7 +83,7 @@ function attach(controls, element, options = {}) {
       return;
     loading = !0;
     try {
-      let { createPanel } = await (__preload("5cr85vv6"), import("./chunk-5cr85vv6.js"));
+      let { createPanel } = await (__preload("jx1ktap3"), import("./chunk-jx1ktap3.js"));
       if (disposed || !controls.enabled || panel)
         return;
       if (panel = createPanel(controls, element, close, { restored, chip }), remember)
@@ -105,9 +106,19 @@ function attach(controls, element, options = {}) {
     update();
   }, offShortcut = reveal === "shortcut" ? listenForShortcut(win, shortcut, controls.theme) : void 0;
   win.addEventListener(MODE_EVENT, onMode);
+  let toggled = controls.toggleKey ? toggleLayer(doc).register({
+    id: controls.id,
+    key: controls.toggleKey,
+    storage: () => controls.storage,
+    root: chip,
+    show: (shown) => {
+      toggledOn = shown, update();
+    }
+  }) : void 0;
+  toggledOn = toggled?.shown ?? !0;
   let unsubscribe = controls.subscribe(update);
   return update(), () => {
-    disposed = !0, unsubscribe(), panel?.dispose(), leaving?.dispose(), observer.disconnect(), offShortcut?.(), win.removeEventListener(MODE_EVENT, onMode), win.removeEventListener("scroll", position, !0), win.removeEventListener("resize", position);
+    disposed = !0, toggled?.dispose(), unsubscribe(), panel?.dispose(), leaving?.dispose(), observer.disconnect(), offShortcut?.(), win.removeEventListener(MODE_EVENT, onMode), win.removeEventListener("scroll", position, !0), win.removeEventListener("resize", position);
     for (let node of [element, chip])
       node.removeEventListener("pointerenter", enter), node.removeEventListener("pointerleave", leave), node.removeEventListener("focusin", update), node.removeEventListener("focusout", focusOut);
     if (chip.remove(), addedTabIndex && element.getAttribute("tabindex") === "0")

package/dist/dev/index.js

@@ -15,6 +15,7 @@ import {
   matchesCombo2,
   comboParts2,
   comboLabel2,
+  isTypingTarget,
   sampleGradient2,
   gradientCss2,
   sampleCurve2,
@@ -72,8 +73,8 @@ import {
   browserStorage,
   urlFlag2,
   storageKey
-} from "./chunk-gezhc24g.js";
-__chunks(import.meta.url,["jx253znt","5cr85vv6","4km87zfx","gezhc24g","693jd1gj"],[["./index.js",3],["./chunk-5cr85vv6.js",3,4],["./chunk-4km87zfx.js",3,4],["./chunk-gezhc24g.js"],["./chunk-693jd1gj.js",3]],0);
+} from "./chunk-7xgkerd2.js";
+__chunks(import.meta.url,["8qt6yygv","jx1ktap3","v8ssbcbk","7xgkerd2","pmkvb9ep"],[["./index.js",3],["./chunk-jx1ktap3.js",3,4],["./chunk-v8ssbcbk.js",3,4],["./chunk-7xgkerd2.js"],["./chunk-pmkvb9ep.js",3]],0);
 // src/core/random.ts
 var lattice = (min, max, step, r) => min + Math.floor(r * (Math.floor((max - min) / step + 0.000000001) + 1)) * step, between = (min, max, r) => min + (max - min) * r;
 function pick(field, random) {
@@ -337,6 +338,143 @@ function mutateValues(schema, current, keys = valueKeys(schema), random = Math.r
   return out;
 }
 
+// src/core/unlock.ts
+var KONAMI = Object.freeze([
+  "ArrowUp",
+  "ArrowUp",
+  "ArrowDown",
+  "ArrowDown",
+  "ArrowLeft",
+  "ArrowRight",
+  "ArrowLeft",
+  "ArrowRight",
+  "b",
+  "a"
+]), GATE = Symbol.for("knobs.unlock.v1"), gate = () => {
+  let holder = globalThis;
+  return holder[GATE] ??= { unlocked: !1, listeners: /* @__PURE__ */ new Set };
+}, isUnlocked = () => globalThis[GATE]?.unlocked ?? !1;
+function onUnlock(listener) {
+  let listeners = gate().listeners;
+  return listeners.add(listener), () => void listeners.delete(listener);
+}
+var UNLOCK_KEY = "knobs:unlocked";
+function sequenceKeys(sequence) {
+  return typeof sequence === "string" ? [...sequence] : [...sequence];
+}
+var fold = (key) => key.length === 1 ? key.toLowerCase() : key;
+function sequenceMatcher(sequence, gap = 1500) {
+  let want = sequenceKeys(sequence).map(fold), typed = [], last = -1 / 0;
+  return (key, at) => {
+    if (!want.length)
+      return !1;
+    if (at - last > gap)
+      typed = [];
+    if (last = at, typed.push(fold(key)), typed.length > want.length)
+      typed.shift();
+    if (typed.length === want.length && typed.every((k, i) => k === want[i]))
+      return typed = [], !0;
+    return !1;
+  };
+}
+function queryUnlock(search, name) {
+  let params = new URLSearchParams(search);
+  if (!params.has(name))
+    return;
+  return !["off", "0", "false", "lock", "no"].includes((params.get(name) ?? "").toLowerCase());
+}
+function resolveUnlock(input) {
+  let unlocked = input.query ?? (input.persist && input.stored);
+  return { unlocked, remember: input.persist && input.query !== void 0 ? unlocked : void 0 };
+}
+function inCorner(x, y, width, height, corner, size = 48) {
+  let left = corner.endsWith("left") ? x <= size : x >= width - size, top = corner.startsWith("top") ? y <= size : y >= height - size;
+  return left && top;
+}
+function tapCounter(count = 3, within = 500) {
+  let taps = 0, last = -1 / 0;
+  return (at) => {
+    if (taps = at - last <= within ? taps + 1 : 1, last = at, taps < count)
+      return !1;
+    return taps = 0, !0;
+  };
+}
+var readStored = () => {
+  try {
+    return globalThis.localStorage?.getItem(UNLOCK_KEY) === "1";
+  } catch {
+    return !1;
+  }
+}, writeStored = (on) => {
+  try {
+    if (on)
+      globalThis.localStorage?.setItem(UNLOCK_KEY, "1");
+    else
+      globalThis.localStorage?.removeItem(UNLOCK_KEY);
+  } catch {}
+};
+function unlock(options) {
+  let g = gate();
+  g.panel = options.panel;
+  let persist = options.persist !== !1, query = options.query === void 0 ? "knobs" : options.query, sequence = options.sequence === void 0 ? "knobs" : options.sequence, corner = options.corner === void 0 ? "top-right" : options.corner, win = typeof window > "u" ? void 0 : window, announce = (text) => {
+    (g.module ? Promise.resolve(g.module) : g.panel?.())?.then((m) => {
+      if (g.module = m, g.unlocked === (text === "knobs unlocked"))
+        m.status?.(text);
+    }).catch(() => {});
+  }, set = (on, say) => {
+    if (persist)
+      writeStored(on);
+    if (g.unlocked === on)
+      return;
+    g.unlocked = on;
+    for (let listener of [...g.listeners])
+      listener();
+    if (say)
+      announce(on ? "knobs unlocked" : "knobs locked");
+  }, start = resolveUnlock({
+    query: query && win ? queryUnlock(win.location.search, query) : void 0,
+    stored: persist && readStored(),
+    persist
+  });
+  if (start.remember !== void 0)
+    writeStored(start.remember);
+  set(start.unlocked || g.unlocked, !1);
+  let offs = [];
+  if (win && sequence !== !1 && sequenceKeys(sequence).length) {
+    let typed = sequenceMatcher(sequence), onKey = (event) => {
+      if (event.ctrlKey || event.metaKey || event.altKey || event.isComposing || event.repeat)
+        return;
+      if (event.key === "Shift" || event.key === "CapsLock" || isTypingTarget(event.target))
+        return;
+      if (typed(event.key, event.timeStamp || performance.now()))
+        set(!g.unlocked, !0);
+    };
+    win.addEventListener("keydown", onKey, !0), offs.push(() => win.removeEventListener("keydown", onKey, !0));
+  }
+  if (win && corner) {
+    let tapped = tapCounter(), onTap = (event) => {
+      if (!event.isPrimary)
+        return;
+      if (!inCorner(event.clientX, event.clientY, win.innerWidth, win.innerHeight, corner))
+        return void (tapped = tapCounter());
+      if (tapped(event.timeStamp || performance.now()))
+        set(!g.unlocked, !0);
+    };
+    win.addEventListener("pointerdown", onTap, { capture: !0, passive: !0 }), offs.push(() => win.removeEventListener("pointerdown", onTap, !0));
+  }
+  return {
+    get unlocked() {
+      return g.unlocked;
+    },
+    unlock: () => set(!0, !0),
+    lock: () => set(!1, !0),
+    dispose() {
+      for (let off of offs.splice(0))
+        off();
+    }
+  };
+}
+
 // src/core/variants.ts
 function createVariants(schema, id, key, storage, get, set, notify, enabled) {
   let ready = !1, list = Object.freeze([]);
@@ -451,7 +589,7 @@ function sameField(a, b) {
 function defineControls(id, input, options = {}) {
   if (!id.trim())
     throw Error("Controls need a stable, nonempty id.");
-  let schema = Object.freeze({ ...input }), locked = normalize(schema, {}), actions = Object.freeze([...options.actions ?? []]), theme = options.theme ?? "dark", density = options.density ?? "default", renderer = options.renderer ?? "auto", enabled = () => typeof options.enabled === "function" ? options.enabled() : options.enabled ?? (Boolean(options.ship) || typeof location < "u" && ["localhost", "127.0.0.1", "[::1]"].includes(location.hostname)), storage = () => options.storage === void 0 ? browserStorage() : options.storage, persistMode = options.persist ?? "all", valueStorage = () => persistMode === "all" ? storage() : null, variantStorage = () => persistMode === "none" ? null : storage(), draw = options.random ?? Math.random, hostHistory = options.history, unsubscribeHistory, listeners = /* @__PURE__ */ new Set, refreshes = 0, notify = () => {
+  let schema = Object.freeze({ ...input }), locked = normalize(schema, {}), actions = Object.freeze([...options.actions ?? []]), theme = options.theme ?? "dark", density = options.density ?? "default", renderer = options.renderer ?? "auto", enabled = () => typeof options.enabled === "function" ? options.enabled() : options.enabled ?? (Boolean(options.ship) || isUnlocked() || typeof location < "u" && ["localhost", "127.0.0.1", "[::1]"].includes(location.hostname)), storage = () => options.storage === void 0 ? browserStorage() : options.storage, persistMode = options.persist ?? "all", valueStorage = () => persistMode === "all" ? storage() : null, variantStorage = () => persistMode === "none" ? null : storage(), draw = options.random ?? Math.random, hostHistory = options.history, unsubscribeHistory, unsubscribeUnlock, listeners = /* @__PURE__ */ new Set, refreshes = 0, notify = () => {
     for (let cb of [...listeners])
       cb();
   }, mixed = /* @__PURE__ */ new Set, current = locked, read = !1, error = null, locks = /* @__PURE__ */ new Set, bindings = /* @__PURE__ */ new Map, comparing = null, landing = !1, echo = Math.max(0, options.echo ?? 0), grabbed = /* @__PURE__ */ new Set, changedAt = /* @__PURE__ */ new Map, sent = /* @__PURE__ */ new Map, pending = /* @__PURE__ */ new Map, echoTimer, now = () => typeof performance < "u" ? performance.now() : Date.now(), isHeld = (key) => grabbed.has(key) || echo > 0 && now() - (changedAt.get(key) ?? -1 / 0) < echo, NO_BASE = Object.freeze({ preset: null, groups: Object.freeze({}) }), base = NO_BASE, past = [], future = [], HISTORY = 100, stateKey = storageKey(id, "state"), buildPresets = () => Object.freeze(Object.fromEntries([
@@ -869,6 +1007,36 @@ function defineControls(id, input, options = {}) {
       for (let key of Object.keys(patch))
         options.onReset?.({ key });
   }
+  function live(load, make, unmake) {
+    let disposed = !1, loading = !1, handle, sync = () => {
+      if (disposed)
+        return;
+      if (!enabled()) {
+        if (handle !== void 0)
+          unmake(handle);
+        handle = void 0;
+        return;
+      }
+      if (handle !== void 0 || loading)
+        return;
+      let pending = load();
+      if (!pending)
+        return;
+      loading = !0, pending.then((module) => {
+        if (loading = !1, !disposed && enabled() && handle === void 0)
+          handle = make(module);
+      }).catch((cause) => {
+        loading = !1, error = String(cause), notify();
+      });
+    };
+    sync();
+    let off = onUnlock(sync);
+    return () => {
+      if (disposed = !0, off(), handle !== void 0)
+        unmake(handle);
+      handle = void 0;
+    };
+  }
   let controls = {
     id,
     get schema() {
@@ -888,9 +1056,10 @@ function defineControls(id, input, options = {}) {
     marks: options.marks !== !1,
     chip: Object.freeze({
       ...options.chip,
-      reveal: options.chip?.reveal ?? (devBuild() ? "hover" : "shortcut"),
+      reveal: options.chip?.reveal ?? (devBuild() || !options.ship ? "hover" : "shortcut"),
       shortcut: options.chip?.shortcut ?? "Alt+Shift+D"
     }),
+    toggleKey: options.toggleKey ?? (options.ship ? !1 : "`"),
     groupPresetDisplay: options.groupPresetDisplay ?? "auto",
     groupLabel: (group) => options.groupLabels?.[group] ?? fieldLabels().group.get(group),
     sectionLabel: (section) => options.sectionLabels?.[section] ?? fieldLabels().section.get(section),
@@ -985,9 +1154,10 @@ function defineControls(id, input, options = {}) {
     subscribe(cb) {
       if (listeners.add(cb), hostHistory?.subscribe && !unsubscribeHistory)
         unsubscribeHistory = hostHistory.subscribe(notify);
-      return () => {
-        if (listeners.delete(cb), !listeners.size && unsubscribeHistory)
-          unsubscribeHistory(), unsubscribeHistory = void 0;
+      return unsubscribeUnlock ??= onUnlock(notify), () => {
+        if (listeners.delete(cb), listeners.size)
+          return;
+        unsubscribeHistory?.(), unsubscribeHistory = void 0, unsubscribeUnlock?.(), unsubscribeUnlock = void 0;
       };
     },
     reset(keys) {
@@ -1205,32 +1375,15 @@ function defineControls(id, input, options = {}) {
     code: (format, values) => formatCode(values ?? get(), format),
     variants,
     attach(element, chip) {
-      let load = options.ship ? () => options.ship().then((m) => m.attach) : () => (__preload("4km87zfx"), import("./chunk-4km87zfx.js")).then((m) => m.attach);
-      if (!load || !enabled())
-        return () => {};
-      let disposed = !1, detach;
-      return load().then((attach) => {
-        if (!disposed && enabled())
-          detach = attach(controls, element, chip);
-      }).catch((cause) => {
-        error = String(cause), notify();
-      }), () => {
-        disposed = !0, detach?.();
-      };
+      let load = options.ship ? () => options.ship().then((m) => m.attach) : () => (__preload("v8ssbcbk"), import("./chunk-v8ssbcbk.js")).then((m) => m.attach);
+      return live(load, (attach) => attach(controls, element, chip), (detach) => detach());
     },
     mount(container, mountOptions) {
-      let load = options.ship ? () => options.ship().then((m) => m.mountPanel) : () => (__preload("5cr85vv6"), import("./chunk-5cr85vv6.js")).then((m) => m.mountPanel);
-      if (!load || !enabled())
-        return () => {};
-      let disposed = !1, panel;
-      return load().then((mountPanel) => {
-        if (!disposed && enabled())
-          panel = mountPanel(controls, container, mountOptions), mountOptions?.onReady?.(panel);
-      }).catch((cause) => {
-        error = String(cause), notify();
-      }), () => {
-        disposed = !0, panel?.dispose();
-      };
+      let load = options.ship ? () => options.ship().then((m) => m.mountPanel) : () => (__preload("jx1ktap3"), import("./chunk-jx1ktap3.js")).then((m) => m.mountPanel);
+      return live(load, (mountPanel) => {
+        let panel = mountPanel(controls, container, mountOptions);
+        return mountOptions?.onReady?.(panel), panel;
+      }, (panel) => panel.dispose());
     }
   };
   return Object.freeze(controls);
@@ -1510,6 +1663,7 @@ function createRemoteControls(id, descriptors, options = {}) {
   }, controls = defineControls(id, fromDescriptors(frozenDescriptors), {
     enabled: options.enabled ?? !0,
     ship: options.ship,
+    toggleKey: options.toggleKey,
     echo: options.echo ?? ECHO_MS,
     storage: options.storage ?? null,
     persist: options.persist,
@@ -1603,6 +1757,7 @@ export {
   AROUND,
   CURVE_SHAPES2 as CURVE_SHAPES,
   EASINGS2 as EASINGS,
+  KONAMI,
   SPRING2 as SPRING,
   action2 as action,
   actionShortcut2 as actionShortcut,
@@ -1652,6 +1807,7 @@ export {
   toggle2 as toggle,
   toolbar2 as toolbar,
   toolbarShortcut2 as toolbarShortcut,
+  unlock,
   urlFlag2 as urlFlag,
   vec22 as vec2,
   vec32 as vec3,

package/dist/index.js

@@ -221,6 +221,17 @@ function comboParts(combo, apple = isApple()) {
 function comboLabel(combo, apple = isApple()) {
   return comboParts(combo, apple).join(apple ? "" : "+");
 }
+function isTypingTarget(target) {
+  let el = target;
+  if (!el || typeof el.tagName !== "string")
+    return !1;
+  let tag = el.tagName;
+  if (tag === "SELECT" || el.isContentEditable)
+    return !0;
+  if (tag === "TEXTAREA")
+    return !el.readOnly;
+  return tag === "INPUT" && !el.readOnly && !["range", "checkbox", "radio", "button", "submit", "reset", "color"].includes(el.type);
+}
 
 // src/core/ramp.ts
 var MAX_STOPS = 32, MAX_POINTS = 64, GRADIENT_SAMPLES = 64;
@@ -475,11 +486,9 @@ function withMeta(base, meta) {
   return checkShortcut(meta?.shortcut), Object.freeze({ ...base, ...pickMeta(meta) });
 }
 function knob(value, options) {
-  let step = options.step ?? ((options.max - options.min) / 100 || 1);
-  if (![value, options.min, options.max, step].every(Number.isFinite) || options.max < options.min || step <= 0)
+  if (!Number.isFinite(value))
     throw Error("A knob needs finite bounds and a positive step.");
-  if (options.decimals !== void 0 && !(Number.isInteger(options.decimals) && options.decimals >= 0))
-    throw Error("A knob's decimals must be a whole number.");
+  let step = bounds(options, "A knob");
   checkShortcut(options.shortcut);
   let field = { ...options, kind: "knob", value, step };
   return Object.freeze({ ...field, value: normalizeField(field, value) });
@@ -1328,6 +1337,143 @@ function urlFlag(name) {
 }
 var storageKey = (id, part) => `knobs:${encodeURIComponent(id)}:${part}:v1`;
 
+// src/core/unlock.ts
+var KONAMI = Object.freeze([
+  "ArrowUp",
+  "ArrowUp",
+  "ArrowDown",
+  "ArrowDown",
+  "ArrowLeft",
+  "ArrowRight",
+  "ArrowLeft",
+  "ArrowRight",
+  "b",
+  "a"
+]), GATE = Symbol.for("knobs.unlock.v1"), gate = () => {
+  let holder = globalThis;
+  return holder[GATE] ??= { unlocked: !1, listeners: /* @__PURE__ */ new Set };
+}, isUnlocked = () => globalThis[GATE]?.unlocked ?? !1, unlockedPanel = () => isUnlocked() ? gate().panel : void 0;
+function onUnlock(listener) {
+  let listeners = gate().listeners;
+  return listeners.add(listener), () => void listeners.delete(listener);
+}
+var UNLOCK_KEY = "knobs:unlocked";
+function sequenceKeys(sequence) {
+  return typeof sequence === "string" ? [...sequence] : [...sequence];
+}
+var fold = (key) => key.length === 1 ? key.toLowerCase() : key;
+function sequenceMatcher(sequence, gap = 1500) {
+  let want = sequenceKeys(sequence).map(fold), typed = [], last = -1 / 0;
+  return (key, at) => {
+    if (!want.length)
+      return !1;
+    if (at - last > gap)
+      typed = [];
+    if (last = at, typed.push(fold(key)), typed.length > want.length)
+      typed.shift();
+    if (typed.length === want.length && typed.every((k, i) => k === want[i]))
+      return typed = [], !0;
+    return !1;
+  };
+}
+function queryUnlock(search, name) {
+  let params = new URLSearchParams(search);
+  if (!params.has(name))
+    return;
+  return !["off", "0", "false", "lock", "no"].includes((params.get(name) ?? "").toLowerCase());
+}
+function resolveUnlock(input) {
+  let unlocked = input.query ?? (input.persist && input.stored);
+  return { unlocked, remember: input.persist && input.query !== void 0 ? unlocked : void 0 };
+}
+function inCorner(x, y, width, height, corner, size = 48) {
+  let left = corner.endsWith("left") ? x <= size : x >= width - size, top = corner.startsWith("top") ? y <= size : y >= height - size;
+  return left && top;
+}
+function tapCounter(count = 3, within = 500) {
+  let taps = 0, last = -1 / 0;
+  return (at) => {
+    if (taps = at - last <= within ? taps + 1 : 1, last = at, taps < count)
+      return !1;
+    return taps = 0, !0;
+  };
+}
+var readStored = () => {
+  try {
+    return globalThis.localStorage?.getItem(UNLOCK_KEY) === "1";
+  } catch {
+    return !1;
+  }
+}, writeStored = (on) => {
+  try {
+    if (on)
+      globalThis.localStorage?.setItem(UNLOCK_KEY, "1");
+    else
+      globalThis.localStorage?.removeItem(UNLOCK_KEY);
+  } catch {}
+};
+function unlock(options) {
+  let g = gate();
+  g.panel = options.panel;
+  let persist = options.persist !== !1, query = options.query === void 0 ? "knobs" : options.query, sequence = options.sequence === void 0 ? "knobs" : options.sequence, corner = options.corner === void 0 ? "top-right" : options.corner, win = typeof window > "u" ? void 0 : window, announce = (text) => {
+    (g.module ? Promise.resolve(g.module) : g.panel?.())?.then((m) => {
+      if (g.module = m, g.unlocked === (text === "knobs unlocked"))
+        m.status?.(text);
+    }).catch(() => {});
+  }, set = (on, say) => {
+    if (persist)
+      writeStored(on);
+    if (g.unlocked === on)
+      return;
+    g.unlocked = on;
+    for (let listener of [...g.listeners])
+      listener();
+    if (say)
+      announce(on ? "knobs unlocked" : "knobs locked");
+  }, start = resolveUnlock({
+    query: query && win ? queryUnlock(win.location.search, query) : void 0,
+    stored: persist && readStored(),
+    persist
+  });
+  if (start.remember !== void 0)
+    writeStored(start.remember);
+  set(start.unlocked || g.unlocked, !1);
+  let offs = [];
+  if (win && sequence !== !1 && sequenceKeys(sequence).length) {
+    let typed = sequenceMatcher(sequence), onKey = (event) => {
+      if (event.ctrlKey || event.metaKey || event.altKey || event.isComposing || event.repeat)
+        return;
+      if (event.key === "Shift" || event.key === "CapsLock" || isTypingTarget(event.target))
+        return;
+      if (typed(event.key, event.timeStamp || performance.now()))
+        set(!g.unlocked, !0);
+    };
+    win.addEventListener("keydown", onKey, !0), offs.push(() => win.removeEventListener("keydown", onKey, !0));
+  }
+  if (win && corner) {
+    let tapped = tapCounter(), onTap = (event) => {
+      if (!event.isPrimary)
+        return;
+      if (!inCorner(event.clientX, event.clientY, win.innerWidth, win.innerHeight, corner))
+        return void (tapped = tapCounter());
+      if (tapped(event.timeStamp || performance.now()))
+        set(!g.unlocked, !0);
+    };
+    win.addEventListener("pointerdown", onTap, { capture: !0, passive: !0 }), offs.push(() => win.removeEventListener("pointerdown", onTap, !0));
+  }
+  return {
+    get unlocked() {
+      return g.unlocked;
+    },
+    unlock: () => set(!0, !0),
+    lock: () => set(!1, !0),
+    dispose() {
+      for (let off of offs.splice(0))
+        off();
+    }
+  };
+}
+
 // src/core/variants.ts
 function createVariants(schema, id, key, storage, get, set, notify, enabled) {
   let ready = !1, list = Object.freeze([]);
@@ -1442,7 +1588,7 @@ function sameField(a, b) {
 function defineControls(id, input, options = {}) {
   if (!id.trim())
     throw Error("Controls need a stable, nonempty id.");
-  let schema = Object.freeze({ ...input }), locked = normalize(schema, {}), actions = Object.freeze([...options.actions ?? []]), theme = options.theme ?? "dark", density = options.density ?? "default", renderer = options.renderer ?? "auto", enabled = () => Boolean(options.ship) && (typeof options.enabled === "function" ? options.enabled() : options.enabled ?? (Boolean(options.ship) || typeof location < "u" && ["localhost", "127.0.0.1", "[::1]"].includes(location.hostname))), storage = () => options.storage === void 0 ? browserStorage() : options.storage, persistMode = options.persist ?? "all", valueStorage = () => persistMode === "all" ? storage() : null, variantStorage = () => persistMode === "none" ? null : storage(), draw = options.random ?? Math.random, hostHistory = options.history, unsubscribeHistory, listeners = /* @__PURE__ */ new Set, refreshes = 0, notify = () => {
+  let schema = Object.freeze({ ...input }), locked = normalize(schema, {}), actions = Object.freeze([...options.actions ?? []]), theme = options.theme ?? "dark", density = options.density ?? "default", renderer = options.renderer ?? "auto", enabled = () => (Boolean(options.ship) || isUnlocked()) && (typeof options.enabled === "function" ? options.enabled() : options.enabled ?? (Boolean(options.ship) || isUnlocked() || typeof location < "u" && ["localhost", "127.0.0.1", "[::1]"].includes(location.hostname))), storage = () => options.storage === void 0 ? browserStorage() : options.storage, persistMode = options.persist ?? "all", valueStorage = () => persistMode === "all" ? storage() : null, variantStorage = () => persistMode === "none" ? null : storage(), draw = options.random ?? Math.random, hostHistory = options.history, unsubscribeHistory, unsubscribeUnlock, listeners = /* @__PURE__ */ new Set, refreshes = 0, notify = () => {
     for (let cb of [...listeners])
       cb();
   }, mixed = /* @__PURE__ */ new Set, current = locked, read = !1, error = null, locks = /* @__PURE__ */ new Set, bindings = /* @__PURE__ */ new Map, comparing = null, landing = !1, echo = Math.max(0, options.echo ?? 0), grabbed = /* @__PURE__ */ new Set, changedAt = /* @__PURE__ */ new Map, sent = /* @__PURE__ */ new Map, pending = /* @__PURE__ */ new Map, echoTimer, now = () => typeof performance < "u" ? performance.now() : Date.now(), isHeld = (key) => grabbed.has(key) || echo > 0 && now() - (changedAt.get(key) ?? -1 / 0) < echo, NO_BASE = Object.freeze({ preset: null, groups: Object.freeze({}) }), base = NO_BASE, past = [], future = [], HISTORY = 100, stateKey = storageKey(id, "state"), buildPresets = () => Object.freeze(Object.fromEntries([
@@ -1860,6 +2006,36 @@ function defineControls(id, input, options = {}) {
       for (let key of Object.keys(patch))
         options.onReset?.({ key });
   }
+  function live(load, make, unmake) {
+    let disposed = !1, loading = !1, handle, sync = () => {
+      if (disposed)
+        return;
+      if (!enabled()) {
+        if (handle !== void 0)
+          unmake(handle);
+        handle = void 0;
+        return;
+      }
+      if (handle !== void 0 || loading)
+        return;
+      let pending = load();
+      if (!pending)
+        return;
+      loading = !0, pending.then((module) => {
+        if (loading = !1, !disposed && enabled() && handle === void 0)
+          handle = make(module);
+      }).catch((cause) => {
+        loading = !1, error = String(cause), notify();
+      });
+    };
+    sync();
+    let off = onUnlock(sync);
+    return () => {
+      if (disposed = !0, off(), handle !== void 0)
+        unmake(handle);
+      handle = void 0;
+    };
+  }
   let controls = {
     id,
     get schema() {
@@ -1879,9 +2055,10 @@ function defineControls(id, input, options = {}) {
     marks: options.marks !== !1,
     chip: Object.freeze({
       ...options.chip,
-      reveal: options.chip?.reveal ?? (devBuild() ? "hover" : "shortcut"),
+      reveal: options.chip?.reveal ?? (devBuild() || !options.ship ? "hover" : "shortcut"),
       shortcut: options.chip?.shortcut ?? "Alt+Shift+D"
     }),
+    toggleKey: options.toggleKey ?? (options.ship ? !1 : "`"),
     groupPresetDisplay: options.groupPresetDisplay ?? "auto",
     groupLabel: (group) => options.groupLabels?.[group] ?? fieldLabels().group.get(group),
     sectionLabel: (section) => options.sectionLabels?.[section] ?? fieldLabels().section.get(section),
@@ -1976,9 +2153,10 @@ function defineControls(id, input, options = {}) {
     subscribe(cb) {
       if (listeners.add(cb), hostHistory?.subscribe && !unsubscribeHistory)
         unsubscribeHistory = hostHistory.subscribe(notify);
-      return () => {
-        if (listeners.delete(cb), !listeners.size && unsubscribeHistory)
-          unsubscribeHistory(), unsubscribeHistory = void 0;
+      return unsubscribeUnlock ??= onUnlock(notify), () => {
+        if (listeners.delete(cb), listeners.size)
+          return;
+        unsubscribeHistory?.(), unsubscribeHistory = void 0, unsubscribeUnlock?.(), unsubscribeUnlock = void 0;
       };
     },
     reset(keys) {
@@ -2196,32 +2374,15 @@ function defineControls(id, input, options = {}) {
     code: (format, values) => formatCode(values ?? get(), format),
     variants,
     attach(element, chip) {
-      let load = options.ship ? () => options.ship().then((m) => m.attach) : void 0;
-      if (!load || !enabled())
-        return () => {};
-      let disposed = !1, detach;
-      return load().then((attach) => {
-        if (!disposed && enabled())
-          detach = attach(controls, element, chip);
-      }).catch((cause) => {
-        error = String(cause), notify();
-      }), () => {
-        disposed = !0, detach?.();
-      };
+      let load = options.ship ? () => options.ship().then((m) => m.attach) : () => unlockedPanel()?.().then((m) => m.attach);
+      return live(load, (attach) => attach(controls, element, chip), (detach) => detach());
     },
     mount(container, mountOptions) {
-      let load = options.ship ? () => options.ship().then((m) => m.mountPanel) : void 0;
-      if (!load || !enabled())
-        return () => {};
-      let disposed = !1, panel;
-      return load().then((mountPanel) => {
-        if (!disposed && enabled())
-          panel = mountPanel(controls, container, mountOptions), mountOptions?.onReady?.(panel);
-      }).catch((cause) => {
-        error = String(cause), notify();
-      }), () => {
-        disposed = !0, panel?.dispose();
-      };
+      let load = options.ship ? () => options.ship().then((m) => m.mountPanel) : () => unlockedPanel()?.().then((m) => m.mountPanel);
+      return live(load, (mountPanel) => {
+        let panel = mountPanel(controls, container, mountOptions);
+        return mountOptions?.onReady?.(panel), panel;
+      }, (panel) => panel.dispose());
     }
   };
   return Object.freeze(controls);
@@ -2501,6 +2662,7 @@ function createRemoteControls(id, descriptors, options = {}) {
   }, controls = defineControls(id, fromDescriptors(frozenDescriptors), {
     enabled: options.enabled ?? !0,
     ship: options.ship,
+    toggleKey: options.toggleKey,
     echo: options.echo ?? ECHO_MS,
     storage: options.storage ?? null,
     persist: options.persist,
@@ -2594,6 +2756,7 @@ export {
   AROUND,
   CURVE_SHAPES,
   EASINGS,
+  KONAMI,
   SPRING,
   action,
   actionShortcut,
@@ -2643,6 +2806,7 @@ export {
   toggle,
   toolbar,
   toolbarShortcut,
+  unlock,
   urlFlag,
   vec2,
   vec3,