@immediately-run/omnibox 0.1.0

package/dist/launch.js

@@ -0,0 +1,88 @@
+const PROVIDERS = {
+  github: "github.com"
+};
+const DEFAULT_PROVIDER = "github";
+function presentPathOf(provider, namespace, repository, ref) {
+  const base = `/present/${provider}/${namespace}/${repository}`;
+  return ref ? `${base}/${encodeURIComponent(ref)}` : base;
+}
+function location(provider, namespace, repository, ref) {
+  const display = ref ? `${provider}:${namespace}/${repository}@${ref}` : `${provider}:${namespace}/${repository}`;
+  return { kind: "location", provider, namespace, repository, ...ref ? { ref } : {}, display, presentPath: presentPathOf(provider, namespace, repository, ref) };
+}
+function providerLabel(hostname) {
+  return hostname.replace(/^www\./, "").split(".")[0];
+}
+function parseTuple(rest, provider) {
+  const slash = rest.indexOf("/");
+  if (slash <= 0) return null;
+  const namespace = rest.slice(0, slash);
+  const tail = rest.slice(slash + 1);
+  if (!namespace || !tail) return null;
+  const at = tail.indexOf("@");
+  const repository = at === -1 ? tail : tail.slice(0, at);
+  const ref = at === -1 ? void 0 : tail.slice(at + 1);
+  if (!repository || repository.includes("/")) return null;
+  if (ref !== void 0 && !ref) return null;
+  return location(provider, namespace, repository, ref);
+}
+function parseLaunch(input, defaultProvider = DEFAULT_PROVIDER) {
+  const raw = input.trim();
+  if (!raw) return { kind: "text", query: raw };
+  if (/^https?:\/\//i.test(raw)) {
+    let url;
+    try {
+      url = new URL(raw);
+    } catch {
+      return { kind: "text", query: raw };
+    }
+    const host = url.hostname.toLowerCase();
+    if (host === "immediately.run" || host.endsWith(".immediately.run")) {
+      if (/^\/(present|edit)(\/|$)/.test(url.pathname)) {
+        return { kind: "platform-url", path: url.pathname + url.search + url.hash };
+      }
+      return { kind: "text", query: raw };
+    }
+    const providerEntry = Object.entries(PROVIDERS).find(([, urlHost]) => urlHost === host);
+    if (providerEntry) {
+      const [provider] = providerEntry;
+      const segs2 = url.pathname.split("/").filter(Boolean);
+      if (segs2.length < 2) return { kind: "text", query: raw };
+      const [namespace, repo0] = segs2;
+      const repo = repo0.endsWith(".git") ? repo0.slice(0, -4) : repo0;
+      if (!repo) return { kind: "text", query: raw };
+      if (segs2.length > 2) {
+        const [marker, ...extra] = segs2.slice(2);
+        if (marker === "tree" && extra.length > 0) {
+          return location(provider, namespace, repo, extra.join("/"));
+        }
+        if (marker === "blob" && extra.length > 0) {
+          return location(provider, namespace, repo, extra[0]);
+        }
+        return { kind: "text", query: raw };
+      }
+      return location(provider, namespace, repo);
+    }
+    const segs = url.pathname.split("/").filter(Boolean);
+    if (segs.length >= 2) return { kind: "unknown-provider", provider: providerLabel(host) };
+    return { kind: "text", query: raw };
+  }
+  const colon = raw.indexOf(":");
+  if (colon > 0 && !raw.slice(0, colon).includes("/")) {
+    const provider = raw.slice(0, colon).toLowerCase();
+    const rest = raw.slice(colon + 1);
+    if (provider in PROVIDERS) {
+      const parsed = parseTuple(rest, provider);
+      return parsed ?? { kind: "text", query: raw };
+    }
+    return { kind: "unknown-provider", provider };
+  }
+  const tuple = parseTuple(raw, defaultProvider);
+  if (tuple) return tuple;
+  return { kind: "text", query: raw };
+}
+export {
+  PROVIDERS,
+  parseLaunch
+};
+//# sourceMappingURL=launch.js.map

package/dist/launch.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/launch.ts"],"sourcesContent":["// The launch parser (R3-511; FRONT_DOOR_IA §5.2) — turns what a visitor types\n// into the omnibox into a present route, a typed rejection for an unknown\n// provider, or free text. Pure: no React, no SDK, no network. The site cannot\n// check that a repo EXISTS — existence is the host's job after navigation.\n//\n// Grammar, in the order the parser tries them:\n//   1. a platform URL (any *.immediately.run host with a /present/ or /edit/\n//      path) — passed through; the caller resolves it against the current host\n//      origin.\n//   2. a provider-prefixed tuple (`github:acme/todo@dev` — the corpus location\n//      grammar) or a bare tuple (`acme/todo@feat/x`) with the default provider.\n//   3. a provider URL (`https://github.com/acme/todo/tree/feat/x`).\n//   4. anything else is free text (search only).\n\n/** The known providers: the prefix/spelling a user may type, and the URL host\n *  that names the same provider. A second provider is a row here (FRONT_DOOR_IA\n *  §5.1 — the chip renders one static option per row). */\nexport const PROVIDERS: Readonly<Record<string, string>> = {\n  github: 'github.com',\n};\n\nconst DEFAULT_PROVIDER = 'github';\n\nexport type Launch =\n  | {\n      kind: 'location';\n      provider: string;\n      namespace: string;\n      repository: string;\n      ref?: string;\n      /** What the results row shows, e.g. `github:acme/todo@feat/x`. */\n      display: string;\n      /** A root-relative platform path, e.g. `/present/github/acme/todo/feat%2Fx`. */\n      presentPath: string;\n    }\n  | { kind: 'platform-url'; path: string }\n  | { kind: 'unknown-provider'; provider: string }\n  | { kind: 'text'; query: string };\n\n/** The `/present/…` path for a location. The ref is encoded ONCE — matching the\n *  host's `encodeRef` (site-main `src/editor/shared.ts`), so a ref containing\n *  `/` stays one segment. `/files/{entry}` is deliberately never appended: the\n *  host resolves the app's entry from `package.json`. */\nfunction presentPathOf(provider: string, namespace: string, repository: string, ref?: string): string {\n  const base = `/present/${provider}/${namespace}/${repository}`;\n  return ref ? `${base}/${encodeURIComponent(ref)}` : base;\n}\n\nfunction location(provider: string, namespace: string, repository: string, ref?: string): Launch {\n  const display = ref\n    ? `${provider}:${namespace}/${repository}@${ref}`\n    : `${provider}:${namespace}/${repository}`;\n  return { kind: 'location', provider, namespace, repository, ...(ref ? { ref } : {}), display, presentPath: presentPathOf(provider, namespace, repository, ref) };\n}\n\n/** `gitlab.com` → `gitlab`: the label we can honestly name for a repo-URL on a\n *  host we do not support. Documented shorthand, not a claim about the host. */\nfunction providerLabel(hostname: string): string {\n  return hostname.replace(/^www\\./, '').split('.')[0];\n}\n\n/** Parse a `<ns>/<repo>[@<ref>]` tuple. Returns null when the input is not one\n *  (wrong shape, missing pieces). The REF may contain `/` (`@feat/x`), so the\n *  tail after the namespace is parsed left-to-right, not split on `/`. */\nfunction parseTuple(rest: string, provider: string): Launch | null {\n  const slash = rest.indexOf('/');\n  if (slash <= 0) return null; // need `<ns>/<repo>`; `acme/` and `acme` are text.\n  const namespace = rest.slice(0, slash);\n  const tail = rest.slice(slash + 1);\n  if (!namespace || !tail) return null;\n  const at = tail.indexOf('@');\n  const repository = at === -1 ? tail : tail.slice(0, at);\n  const ref = at === -1 ? undefined : tail.slice(at + 1);\n  if (!repository || repository.includes('/')) return null; // only the ref may span segments\n  if (ref !== undefined && !ref) return null; // `ns/repo@` — dangling @.\n  return location(provider, namespace, repository, ref);\n}\n\nexport function parseLaunch(input: string, defaultProvider: string = DEFAULT_PROVIDER): Launch {\n  const raw = input.trim();\n  if (!raw) return { kind: 'text', query: raw };\n\n  // 1. URLs.\n  if (/^https?:\\/\\//i.test(raw)) {\n    let url: URL;\n    try {\n      url = new URL(raw);\n    } catch {\n      return { kind: 'text', query: raw };\n    }\n    const host = url.hostname.toLowerCase();\n\n    // This platform: pass the path (with search/hash) through; the caller\n    // resolves it against the current host origin.\n    if (host === 'immediately.run' || host.endsWith('.immediately.run')) {\n      if (/^\\/(present|edit)(\\/|$)/.test(url.pathname)) {\n        return { kind: 'platform-url', path: url.pathname + url.search + url.hash };\n      }\n      return { kind: 'text', query: raw };\n    }\n\n    const providerEntry = Object.entries(PROVIDERS).find(([, urlHost]) => urlHost === host);\n    if (providerEntry) {\n      const [provider] = providerEntry;\n      const segs = url.pathname.split('/').filter(Boolean);\n      if (segs.length < 2) return { kind: 'text', query: raw };\n      const [namespace, repo0] = segs;\n      const repo = repo0!.endsWith('.git') ? repo0!.slice(0, -4) : repo0!;\n      if (!repo) return { kind: 'text', query: raw };\n      // `/tree/<rest>` → the ref is the WHOLE remainder (a ref may contain `/`);\n      // `/blob/<first>` → the ref is the FIRST segment; the file path is dropped.\n      // Documented limitation: a /blob/ URL on a ref containing `/` is misread —\n      // the interpreted location is shown in the results row so it can be\n      // corrected. Any other extra segment is not a repo root → free text.\n      if (segs.length > 2) {\n        const [marker, ...extra] = segs.slice(2);\n        if (marker === 'tree' && extra.length > 0) {\n          return location(provider, namespace, repo, extra.join('/'));\n        }\n        if (marker === 'blob' && extra.length > 0) {\n          return location(provider, namespace, repo, extra[0]);\n        }\n        return { kind: 'text', query: raw };\n      }\n      return location(provider, namespace, repo);\n    }\n\n    // A repo-shaped URL on a host we cannot reach: name what was understood.\n    const segs = url.pathname.split('/').filter(Boolean);\n    if (segs.length >= 2) return { kind: 'unknown-provider', provider: providerLabel(host) };\n    return { kind: 'text', query: raw };\n  }\n\n  // 2. Provider-prefixed tuple (`github:acme/todo@dev`).\n  const colon = raw.indexOf(':');\n  if (colon > 0 && !raw.slice(0, colon).includes('/')) {\n    const provider = raw.slice(0, colon).toLowerCase();\n    const rest = raw.slice(colon + 1);\n    if (provider in PROVIDERS) {\n      const parsed = parseTuple(rest, provider);\n      return parsed ?? { kind: 'text', query: raw };\n    }\n    return { kind: 'unknown-provider', provider };\n  }\n\n  // 3. Bare tuple with the default provider.\n  const tuple = parseTuple(raw, defaultProvider);\n  if (tuple) return tuple;\n\n  // 4. Free text — search only.\n  return { kind: 'text', query: raw };\n}\n"],"mappings":"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","names":["segs"]}

package/dist/omnibox.css

@@ -0,0 +1,274 @@
+/* The omnibox (R3-512; FRONT_DOOR_IA §5). Tokens come from index.css only; the
+   floating results panel (desktop nav variant) is the only shadowed form —
+   hero, new, and every mobile form are in-flow and carry no shadow. */
+
+.omnibox-outer {
+  width: 100%;
+}
+
+.omnibox-outer--hero,
+.omnibox-outer--new {
+  max-width: 620px;
+}
+
+.omnibox-row {
+  display: flex;
+  align-items: stretch;
+  gap: 0;
+  border: 1px solid var(--line);
+  border-color: var(--accent);
+  border-radius: var(--r-md);
+  background: var(--panel);
+  overflow: hidden;
+}
+
+.omnibox-input {
+  flex: 1 1 auto;
+  min-width: 0;
+  border: 0;
+  background: transparent;
+  color: var(--ink);
+  font: 400 16px/1.2 var(--sans);
+  padding: 14px 14px;
+  outline: none;
+}
+
+.omnibox-input:focus-visible {
+  outline: none;
+}
+
+.omnibox-outer:focus-within .omnibox-row {
+  box-shadow: var(--glow);
+}
+
+.omnibox-chip {
+  display: flex;
+  align-items: center;
+  padding: 0 0 0 16px;
+  flex: 0 0 auto;
+}
+
+.omnibox-chip-label,
+.omnibox-chip-select {
+  font: 400 12px/1 var(--mono);
+  letter-spacing: 0.08em;
+  text-transform: uppercase;
+  color: var(--ink-2);
+  background: transparent;
+  border: 0;
+}
+
+.omnibox-run {
+  flex: 0 0 auto;
+  display: inline-flex;
+  align-items: center;
+  gap: 8px;
+  margin: 6px;
+  padding: 8px 18px;
+  border-radius: var(--r-sm);
+  border: 1px solid var(--line);
+  background: var(--bg);
+  color: var(--ink);
+  font: 700 14px/1 var(--sans);
+  text-decoration: none;
+  cursor: pointer;
+  align-self: center;
+}
+
+.omnibox-run-arrow {
+  font-family: var(--mono);
+}
+
+.omnibox--hero .omnibox-run:not([aria-disabled='true']),
+.omnibox--new .omnibox-run:not([aria-disabled='true']) {
+  border: 0;
+  color: #16101a;
+  background-image: var(--grad-btn);
+}
+
+.omnibox-run[aria-disabled='true'] {
+  opacity: 0.55;
+  cursor: default;
+}
+
+.omnibox-helper {
+  margin: 8px 2px 0;
+  font: 400 12px/1.4 var(--mono);
+  color: var(--ink-2);
+}
+
+/* ── results panel ─────────────────────────────────────────────────────── */
+
+.omnibox-panel {
+  border: 1px solid var(--line);
+  border-radius: var(--r-md);
+  background: var(--bg);
+  margin-top: 8px;
+  padding: 6px;
+  /* in-flow by default: it pushes content down (mobile + hero + new) */
+}
+
+.omnibox-group {
+  padding: 4px 0;
+}
+
+.omnibox-group + .omnibox-group {
+  border-top: 1px solid var(--line);
+}
+
+.omnibox-option {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: baseline;
+  gap: 4px 10px;
+  padding: 10px 12px;
+  border-radius: var(--r-xs);
+  color: var(--ink);
+  text-decoration: none;
+  cursor: pointer;
+}
+
+.omnibox-option[aria-selected='true'],
+.omnibox-option:hover {
+  background: var(--line);
+}
+
+.omnibox-option-name {
+  font-weight: 600;
+  font-size: 15px;
+}
+
+.omnibox-option-cat {
+  font: 400 11px/1 var(--mono);
+  letter-spacing: 0.08em;
+  text-transform: uppercase;
+  color: var(--ink-2);
+}
+
+.omnibox-option-blurb {
+  flex-basis: 100%;
+  font-size: 13px;
+  color: var(--ink-2);
+}
+
+.omnibox-option-action {
+  margin-left: auto;
+  font: 400 12px/1 var(--mono);
+  color: var(--ink-2);
+}
+
+.omnibox-empty {
+  padding: 14px 12px;
+  color: var(--ink-2);
+  font-size: 14px;
+}
+
+/* ── nav variant (desktop): floating field + shadowed panel ────────────── */
+
+.omnibox-outer--nav {
+  position: relative;
+  width: 230px;
+}
+
+.omnibox-outer--nav .omnibox-row {
+  border-color: var(--line);
+  border-radius: var(--r-sm);
+}
+
+.omnibox-outer--nav .omnibox-input {
+  padding: 9px 12px;
+  font-size: 14px;
+}
+
+.omnibox-outer--nav .omnibox-helper {
+  display: none;
+}
+
+.omnibox-outer--nav .omnibox-panel {
+  position: absolute;
+  top: calc(100% + 8px);
+  left: 0;
+  right: 0;
+  box-shadow: var(--shadow-pop);
+  z-index: 30;
+}
+
+.omnibox-nav-button {
+  display: inline-flex;
+  align-items: center;
+  gap: 8px;
+  border: 1px solid var(--line);
+  border-radius: var(--r-sm);
+  background: transparent;
+  color: var(--ink);
+  font: 400 14px/1 var(--sans);
+  padding: 9px 12px;
+  cursor: pointer;
+}
+
+.omnibox-nav-button .omnibox-nav-button-label {
+  color: var(--ink-2);
+}
+
+/* ── mobile (FRONT_DOOR_IA §5.5): full width, chip collapses into the field's
+   left padding, Run is an in-field 44px arrow, panel in-flow ───────────── */
+
+@media (max-width: 720px) {
+  .omnibox-outer--nav {
+    width: 100%;
+  }
+
+  .omnibox-chip {
+    display: none;
+  }
+
+  .omnibox-input {
+    padding-left: 16px;
+  }
+
+  .omnibox-run {
+    margin: 5px;
+    padding: 0;
+    width: 44px;
+    height: 44px;
+    justify-content: center;
+    gap: 0;
+  }
+
+  .omnibox-run-label {
+    display: none;
+  }
+
+  .omnibox-run-arrow {
+    font-size: 20px;
+  }
+
+  .omnibox-outer--nav .omnibox-helper {
+    display: block;
+  }
+
+  .omnibox-outer--nav .omnibox-panel {
+    position: static;
+    box-shadow: none;
+  }
+}
+
+/* The visually hidden label / live region: present to assistive tech, absent
+   to the eye. Scoped here so the omnibox owns its own a11y plumbing. */
+.omnibox-visually-hidden {
+  position: absolute;
+  width: 1px;
+  height: 1px;
+  margin: -1px;
+  padding: 0;
+  overflow: hidden;
+  clip: rect(0 0 0 0);
+  white-space: nowrap;
+  border: 0;
+}
+
+/* The keyboard-hint chip the omnibox and the nav shortcut render (R3-512). Moved
+ * verbatim from landing-page App.css with the component that renders it — one home,
+ * so the Home app renders the same chip. */
+.kbd{font:400 11px var(--mono);background:var(--bg);border:1px solid var(--line);
+  border-radius:var(--r-xs);padding:2px 6px;color:var(--ink-3)}

package/dist/omniboxFocus.cjs

@@ -0,0 +1,61 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var omniboxFocus_exports = {};
+__export(omniboxFocus_exports, {
+  focusHeroOmnibox: () => focusHeroOmnibox,
+  focusOmnibox: () => focusOmnibox,
+  registerOmniboxFocus: () => registerOmniboxFocus,
+  revealHeroOmnibox: () => revealHeroOmnibox
+});
+module.exports = __toCommonJS(omniboxFocus_exports);
+const stack = [];
+function current(variant) {
+  for (let i = stack.length - 1; i >= 0; i -= 1) {
+    if (stack[i].variant === variant) return stack[i].handle;
+  }
+  return void 0;
+}
+function focusHeroOmnibox() {
+  current("hero")?.focus();
+}
+function revealHeroOmnibox() {
+  const hero = current("hero");
+  if (!hero) return;
+  hero.reveal?.();
+  hero.focus();
+}
+function focusOmnibox() {
+  (current("new") ?? current("hero") ?? current("nav"))?.focus();
+}
+function registerOmniboxFocus(variant, handle) {
+  const registration = { variant, handle };
+  stack.push(registration);
+  return () => {
+    const at = stack.indexOf(registration);
+    if (at !== -1) stack.splice(at, 1);
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  focusHeroOmnibox,
+  focusOmnibox,
+  registerOmniboxFocus,
+  revealHeroOmnibox
+});
+//# sourceMappingURL=omniboxFocus.cjs.map

package/dist/omniboxFocus.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/omniboxFocus.ts"],"sourcesContent":["// Cross-component focus plumbing for the omnibox. The nav field on `/` activates\n// the hero omnibox, ⌘K focuses whichever omnibox is mounted, and the two \"paste a\n// repo\" buttons further down `/` scroll the hero field into view and focus it.\n// The mounted instances publish their handles here on mount — a module registry,\n// not prop drilling through App. Framework-free by design (Fast refresh: no\n// components in this file).\n//\n// A STACK, not one slot per variant: more than one omnibox of the same variant can\n// be mounted at once (the persistent nav field and the mobile sheet's field are\n// both `nav`), and a single slot made the second instance's UNMOUNT clear the\n// registration the first one still needed — ⌘K then reached nothing. Each\n// registration is removed by identity, so the previous one is restored.\n\nexport type OmniboxVariant = 'hero' | 'nav' | 'new';\n\nexport interface OmniboxHandle {\n  /** Move keyboard focus into the field. */\n  focus: () => void;\n  /** Bring the field into view. Absent for fields that are always on screen. */\n  reveal?: () => void;\n}\n\ninterface Registration {\n  variant: OmniboxVariant;\n  handle: OmniboxHandle;\n}\n\nconst stack: Registration[] = [];\n\n/** The most recently mounted omnibox of this variant, if any is mounted. */\nfunction current(variant: OmniboxVariant): OmniboxHandle | undefined {\n  for (let i = stack.length - 1; i >= 0; i -= 1) {\n    if (stack[i].variant === variant) return stack[i].handle;\n  }\n  return undefined;\n}\n\n/** Focus the hero omnibox (no-op when no hero variant is mounted). */\nexport function focusHeroOmnibox(): void {\n  current('hero')?.focus();\n}\n\n/** Scroll the hero omnibox into view and focus it — what a \"paste a repo\" CTA\n *  further down the page does. No-op when no hero omnibox is mounted. */\nexport function revealHeroOmnibox(): void {\n  const hero = current('hero');\n  if (!hero) return;\n  hero.reveal?.();\n  hero.focus();\n}\n\n/** Focus whichever omnibox is mounted — the page's own field first (`new`), then\n *  the hero, then the nav field, which is on every route. */\nexport function focusOmnibox(): void {\n  (current('new') ?? current('hero') ?? current('nav'))?.focus();\n}\n\n/** Publish a mounted omnibox; the returned function unregisters exactly this one. */\nexport function registerOmniboxFocus(variant: OmniboxVariant, handle: OmniboxHandle): () => void {\n  const registration: Registration = { variant, handle };\n  stack.push(registration);\n  return () => {\n    const at = stack.indexOf(registration);\n    if (at !== -1) stack.splice(at, 1);\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA2BA,MAAM,QAAwB,CAAC;AAG/B,SAAS,QAAQ,SAAoD;AACnE,WAAS,IAAI,MAAM,SAAS,GAAG,KAAK,GAAG,KAAK,GAAG;AAC7C,QAAI,MAAM,CAAC,EAAE,YAAY,QAAS,QAAO,MAAM,CAAC,EAAE;AAAA,EACpD;AACA,SAAO;AACT;AAGO,SAAS,mBAAyB;AACvC,UAAQ,MAAM,GAAG,MAAM;AACzB;AAIO,SAAS,oBAA0B;AACxC,QAAM,OAAO,QAAQ,MAAM;AAC3B,MAAI,CAAC,KAAM;AACX,OAAK,SAAS;AACd,OAAK,MAAM;AACb;AAIO,SAAS,eAAqB;AACnC,GAAC,QAAQ,KAAK,KAAK,QAAQ,MAAM,KAAK,QAAQ,KAAK,IAAI,MAAM;AAC/D;AAGO,SAAS,qBAAqB,SAAyB,QAAmC;AAC/F,QAAM,eAA6B,EAAE,SAAS,OAAO;AACrD,QAAM,KAAK,YAAY;AACvB,SAAO,MAAM;AACX,UAAM,KAAK,MAAM,QAAQ,YAAY;AACrC,QAAI,OAAO,GAAI,OAAM,OAAO,IAAI,CAAC;AAAA,EACnC;AACF;","names":[]}

package/dist/omniboxFocus.d.cts

@@ -0,0 +1,19 @@
+type OmniboxVariant = 'hero' | 'nav' | 'new';
+interface OmniboxHandle {
+    /** Move keyboard focus into the field. */
+    focus: () => void;
+    /** Bring the field into view. Absent for fields that are always on screen. */
+    reveal?: () => void;
+}
+/** Focus the hero omnibox (no-op when no hero variant is mounted). */
+declare function focusHeroOmnibox(): void;
+/** Scroll the hero omnibox into view and focus it — what a "paste a repo" CTA
+ *  further down the page does. No-op when no hero omnibox is mounted. */
+declare function revealHeroOmnibox(): void;
+/** Focus whichever omnibox is mounted — the page's own field first (`new`), then
+ *  the hero, then the nav field, which is on every route. */
+declare function focusOmnibox(): void;
+/** Publish a mounted omnibox; the returned function unregisters exactly this one. */
+declare function registerOmniboxFocus(variant: OmniboxVariant, handle: OmniboxHandle): () => void;
+
+export { type OmniboxHandle, type OmniboxVariant, focusHeroOmnibox, focusOmnibox, registerOmniboxFocus, revealHeroOmnibox };

package/dist/omniboxFocus.d.ts

@@ -0,0 +1,19 @@
+type OmniboxVariant = 'hero' | 'nav' | 'new';
+interface OmniboxHandle {
+    /** Move keyboard focus into the field. */
+    focus: () => void;
+    /** Bring the field into view. Absent for fields that are always on screen. */
+    reveal?: () => void;
+}
+/** Focus the hero omnibox (no-op when no hero variant is mounted). */
+declare function focusHeroOmnibox(): void;
+/** Scroll the hero omnibox into view and focus it — what a "paste a repo" CTA
+ *  further down the page does. No-op when no hero omnibox is mounted. */
+declare function revealHeroOmnibox(): void;
+/** Focus whichever omnibox is mounted — the page's own field first (`new`), then
+ *  the hero, then the nav field, which is on every route. */
+declare function focusOmnibox(): void;
+/** Publish a mounted omnibox; the returned function unregisters exactly this one. */
+declare function registerOmniboxFocus(variant: OmniboxVariant, handle: OmniboxHandle): () => void;
+
+export { type OmniboxHandle, type OmniboxVariant, focusHeroOmnibox, focusOmnibox, registerOmniboxFocus, revealHeroOmnibox };

package/dist/omniboxFocus.js

@@ -0,0 +1,34 @@
+const stack = [];
+function current(variant) {
+  for (let i = stack.length - 1; i >= 0; i -= 1) {
+    if (stack[i].variant === variant) return stack[i].handle;
+  }
+  return void 0;
+}
+function focusHeroOmnibox() {
+  current("hero")?.focus();
+}
+function revealHeroOmnibox() {
+  const hero = current("hero");
+  if (!hero) return;
+  hero.reveal?.();
+  hero.focus();
+}
+function focusOmnibox() {
+  (current("new") ?? current("hero") ?? current("nav"))?.focus();
+}
+function registerOmniboxFocus(variant, handle) {
+  const registration = { variant, handle };
+  stack.push(registration);
+  return () => {
+    const at = stack.indexOf(registration);
+    if (at !== -1) stack.splice(at, 1);
+  };
+}
+export {
+  focusHeroOmnibox,
+  focusOmnibox,
+  registerOmniboxFocus,
+  revealHeroOmnibox
+};
+//# sourceMappingURL=omniboxFocus.js.map

package/dist/omniboxFocus.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/omniboxFocus.ts"],"sourcesContent":["// Cross-component focus plumbing for the omnibox. The nav field on `/` activates\n// the hero omnibox, ⌘K focuses whichever omnibox is mounted, and the two \"paste a\n// repo\" buttons further down `/` scroll the hero field into view and focus it.\n// The mounted instances publish their handles here on mount — a module registry,\n// not prop drilling through App. Framework-free by design (Fast refresh: no\n// components in this file).\n//\n// A STACK, not one slot per variant: more than one omnibox of the same variant can\n// be mounted at once (the persistent nav field and the mobile sheet's field are\n// both `nav`), and a single slot made the second instance's UNMOUNT clear the\n// registration the first one still needed — ⌘K then reached nothing. Each\n// registration is removed by identity, so the previous one is restored.\n\nexport type OmniboxVariant = 'hero' | 'nav' | 'new';\n\nexport interface OmniboxHandle {\n  /** Move keyboard focus into the field. */\n  focus: () => void;\n  /** Bring the field into view. Absent for fields that are always on screen. */\n  reveal?: () => void;\n}\n\ninterface Registration {\n  variant: OmniboxVariant;\n  handle: OmniboxHandle;\n}\n\nconst stack: Registration[] = [];\n\n/** The most recently mounted omnibox of this variant, if any is mounted. */\nfunction current(variant: OmniboxVariant): OmniboxHandle | undefined {\n  for (let i = stack.length - 1; i >= 0; i -= 1) {\n    if (stack[i].variant === variant) return stack[i].handle;\n  }\n  return undefined;\n}\n\n/** Focus the hero omnibox (no-op when no hero variant is mounted). */\nexport function focusHeroOmnibox(): void {\n  current('hero')?.focus();\n}\n\n/** Scroll the hero omnibox into view and focus it — what a \"paste a repo\" CTA\n *  further down the page does. No-op when no hero omnibox is mounted. */\nexport function revealHeroOmnibox(): void {\n  const hero = current('hero');\n  if (!hero) return;\n  hero.reveal?.();\n  hero.focus();\n}\n\n/** Focus whichever omnibox is mounted — the page's own field first (`new`), then\n *  the hero, then the nav field, which is on every route. */\nexport function focusOmnibox(): void {\n  (current('new') ?? current('hero') ?? current('nav'))?.focus();\n}\n\n/** Publish a mounted omnibox; the returned function unregisters exactly this one. */\nexport function registerOmniboxFocus(variant: OmniboxVariant, handle: OmniboxHandle): () => void {\n  const registration: Registration = { variant, handle };\n  stack.push(registration);\n  return () => {\n    const at = stack.indexOf(registration);\n    if (at !== -1) stack.splice(at, 1);\n  };\n}\n"],"mappings":"AA2BA,MAAM,QAAwB,CAAC;AAG/B,SAAS,QAAQ,SAAoD;AACnE,WAAS,IAAI,MAAM,SAAS,GAAG,KAAK,GAAG,KAAK,GAAG;AAC7C,QAAI,MAAM,CAAC,EAAE,YAAY,QAAS,QAAO,MAAM,CAAC,EAAE;AAAA,EACpD;AACA,SAAO;AACT;AAGO,SAAS,mBAAyB;AACvC,UAAQ,MAAM,GAAG,MAAM;AACzB;AAIO,SAAS,oBAA0B;AACxC,QAAM,OAAO,QAAQ,MAAM;AAC3B,MAAI,CAAC,KAAM;AACX,OAAK,SAAS;AACd,OAAK,MAAM;AACb;AAIO,SAAS,eAAqB;AACnC,GAAC,QAAQ,KAAK,KAAK,QAAQ,MAAM,KAAK,QAAQ,KAAK,IAAI,MAAM;AAC/D;AAGO,SAAS,qBAAqB,SAAyB,QAAmC;AAC/F,QAAM,eAA6B,EAAE,SAAS,OAAO;AACrD,QAAM,KAAK,YAAY;AACvB,SAAO,MAAM;AACX,UAAM,KAAK,MAAM,QAAQ,YAAY;AACrC,QAAI,OAAO,GAAI,OAAM,OAAO,IAAI,CAAC;AAAA,EACnC;AACF;","names":[]}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@immediately-run/omnibox",
+  "version": "0.1.0",
+  "description": "The front door's omnibox: one list-autocomplete combobox that runs a repo by URL or tuple and searches a consumer's app directory and docs (the launch grammar always; the hit sources injected). Shared by landing-page and the Home app so there is one component and one grammar (R3-512, R3-530).",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/immediately-run/omnibox.git"
+  },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./omnibox.css": "./dist/omnibox.css"
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": [
+    "*.css"
+  ],
+  "scripts": {
+    "build": "tsup && node scripts/build-css.mjs",
+    "test": "vitest run",
+    "lint": "eslint src",
+    "prepare": "npm run build",
+    "check:pins": "node scripts/check-dependency-pins.mjs --self-test && node scripts/check-dependency-pins.mjs",
+    "check:publish-version": "node scripts/check-publish-version.mjs --self-test && node scripts/check-publish-version.mjs"
+  },
+  "peerDependencies": {
+    "@immediately-run/sdk": "0.60.0",
+    "react": "^19.2.5"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.18.0",
+    "@immediately-run/sdk": "0.60.0",
+    "@testing-library/react": "^16.1.0",
+    "@testing-library/user-event": "^14.6.7",
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "eslint": "^9.18.0",
+    "jsdom": "^25.0.1",
+    "react": "^19.2.5",
+    "react-dom": "^19.2.5",
+    "tsup": "^8.0.0",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.20.0",
+    "vitest": "^4.1.11"
+  }
+}