@immediately-run/sdk 0.68.1 → 0.69.0

package/dist/agentChatClient.js

@@ -1,5 +1,5 @@
 import "./chunk-VHAA22YE.js";
-import { chat } from "./llm";
+import { chat } from "./llm.js";
 function toChatMessages(system, messages) {
   const out = [];
   if (system) out.push({ role: "system", content: [{ type: "text", text: system }] });

package/dist/agentContext.js

@@ -1,9 +1,9 @@
 import "./chunk-VHAA22YE.js";
 import { useContext } from "react";
-import { TinkerableContext } from "./TinkerableContext";
-import { useAuth } from "./auth";
-import { useMounts } from "./mounts";
-import { fenceUntrusted } from "./fence";
+import { TinkerableContext } from "./TinkerableContext.js";
+import { useAuth } from "./auth.js";
+import { useMounts } from "./mounts.js";
+import { fenceUntrusted } from "./fence.js";
 function useAgentContext(app = {}) {
   const tinker = useContext(TinkerableContext);
   const auth = useAuth();

package/dist/agentLoop.js

@@ -1,5 +1,5 @@
 import "./chunk-VHAA22YE.js";
-import { anySignal, steerWireText, INTERRUPTED_TURN_TEXT } from "./agentSteering";
+import { anySignal, steerWireText, INTERRUPTED_TURN_TEXT } from "./agentSteering.js";
 const textOf = (blocks) => blocks.filter((b) => b.type === "text").map((b) => b.text).join("");
 const TERMINAL_STOPS = /* @__PURE__ */ new Set(["max_tokens", "refusal"]);
 const INTENT_RE = /\b(i'?ll|i will|i'?m going to|going to|let me|let's|now,? i(?:'?ll| will)?|next,? i(?:'?ll| will)?)\b[\s\S]{0,80}?\b(read|write|edit|creat|add|updat|modif|regist|check|look|call|run|search|grep|list|open|fetch|inspect|review|explor|implement|fix|appl)/i;

package/dist/analytics.js

@@ -1,7 +1,7 @@
 import "./chunk-VHAA22YE.js";
-import { protocolRequest } from "./sandboxUtils";
-import { SCHEMES } from "./protocolSchemes";
-import { PROTOCOL_ANALYTICS } from "./generated/protocol";
+import { protocolRequest } from "./sandboxUtils.js";
+import { SCHEMES } from "./protocolSchemes.js";
+import { PROTOCOL_ANALYTICS } from "./generated/protocol.js";
 const emitAnalyticsEvent = (name, props) => protocolRequest(SCHEMES[PROTOCOL_ANALYTICS], "emit", [{ name, ...props ? { props } : {} }]);
 const recordRoute = (path) => protocolRequest(SCHEMES[PROTOCOL_ANALYTICS], "route", [{ path }]);
 const track = (name, props) => {

package/dist/auth.js

@@ -1,6 +1,6 @@
 import "./chunk-VHAA22YE.js";
-import { createPushChannel } from "./pushChannel";
-import { AUTH_STATE, REQUEST_AUTH_STATE } from "./generated/protocol";
+import { createPushChannel } from "./pushChannel.js";
+import { AUTH_STATE, REQUEST_AUTH_STATE } from "./generated/protocol.js";
 const isAuthState = (v) => {
   const s = v;
   return !!s && (s.status === "unknown" || s.status === "signed-in" || s.status === "signed-out") && (s.user === null || typeof s.user === "object" && typeof s.user.login === "string");

package/dist/boot.js

@@ -2,22 +2,22 @@ import "./chunk-VHAA22YE.js";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { StrictMode, useEffect, useLayoutEffect, useState } from "react";
 import { createRoot } from "react-dom/client";
-import { emitMarkerOnce } from "./markers";
-import { ErrorNotFound } from "./components/errors";
-import { FileRouter } from "./components/FileRouter";
-import { MainContent } from "./components/MainContent";
-import { DEFAULT_MDX_COMPONENTS } from "./components/MDXComponents";
-import { ScrollAfterNavigation } from "./components/ScrollAfterNavigation";
-import { getInitialContext, updateContext } from "./contextUtils";
-import { getInjectedMetadataEmitter, resolveMetadataSource } from "./injectedBundler";
-import { MDXProvider } from "./MDXProvider";
-import { ModuleCache, ModuleCacheContextProvider } from "./moduleCache";
-import { Router } from "./routing";
-import { addListener } from "./sandboxUtils";
-import { TinkerableContext } from "./TinkerableContext";
-import { FILES_PREFIX } from "./urlUtils";
-import { METADATA_UPDATE, URLCHANGE } from "./generated/protocol";
-import { receiveNavigation } from "./entryState";
+import { emitMarkerOnce } from "./markers.js";
+import { ErrorNotFound } from "./components/errors.js";
+import { FileRouter } from "./components/FileRouter.js";
+import { MainContent } from "./components/MainContent.js";
+import { DEFAULT_MDX_COMPONENTS } from "./components/MDXComponents.js";
+import { ScrollAfterNavigation } from "./components/ScrollAfterNavigation.js";
+import { getInitialContext, updateContext } from "./contextUtils.js";
+import { getInjectedMetadataEmitter, resolveMetadataSource } from "./injectedBundler.js";
+import { MDXProvider } from "./MDXProvider.js";
+import { ModuleCache, ModuleCacheContextProvider } from "./moduleCache.js";
+import { Router } from "./routing.js";
+import { addListener } from "./sandboxUtils.js";
+import { TinkerableContext } from "./TinkerableContext.js";
+import { FILES_PREFIX } from "./urlUtils.js";
+import { METADATA_UPDATE, URLCHANGE } from "./generated/protocol.js";
+import { receiveNavigation } from "./entryState.js";
 const resolveMdxComponents = (mdxComponents) => mdxComponents === void 0 ? DEFAULT_MDX_COMPONENTS : typeof mdxComponents === "function" ? mdxComponents(DEFAULT_MDX_COMPONENTS) : { ...DEFAULT_MDX_COMPONENTS, ...mdxComponents };
 const updateAlreadyApplied = (filesMetadata, update) => {
   for (let [key, value] of Object.entries(update)) {

package/dist/bundle.js

@@ -1,6 +1,6 @@
 import "./chunk-VHAA22YE.js";
 import { createContext, use, useMemo } from "react";
-import { useMetadataStore } from "./metadataSource";
+import { useMetadataStore } from "./metadataSource.js";
 const EMPTY_SCOPE = { root: null, entry: null, toHref: (p) => p };
 const BundleContext = createContext(EMPTY_SCOPE);
 const useBundle = () => use(BundleContext);

package/dist/catalog.js

@@ -1,8 +1,8 @@
 import "./chunk-VHAA22YE.js";
-import { protocolRequest, sendMessage, addListener } from "./sandboxUtils";
-import { consumeStream } from "./protocolStream";
-import { createPushChannel } from "./pushChannel";
-import { API_CATALOG, REQUEST_API_CATALOG } from "./generated/protocol";
+import { protocolRequest, sendMessage, addListener } from "./sandboxUtils.js";
+import { consumeStream } from "./protocolStream.js";
+import { createPushChannel } from "./pushChannel.js";
+import { API_CATALOG, REQUEST_API_CATALOG } from "./generated/protocol.js";
 const split = (name) => {
   const i = name.indexOf(":");
   if (i <= 0) throw new Error(`invalid catalog method name: ${name}`);

package/dist/chromeState.js

@@ -1,6 +1,6 @@
 import "./chunk-VHAA22YE.js";
-import { createPushChannel } from "./pushChannel";
-import { CHROME_STATE, REQUEST_CHROME_STATE } from "./generated/protocol";
+import { createPushChannel } from "./pushChannel.js";
+import { CHROME_STATE, REQUEST_CHROME_STATE } from "./generated/protocol.js";
 const DEFAULT_CHROME_STATE = { overlay: "none", tab: { edge: "top-right" } };
 const isChromeState = (v) => {
   const c = v;

package/dist/components/FileRouter.js

@@ -1,10 +1,10 @@
 import "../chunk-VHAA22YE.js";
 import { jsx } from "react/jsx-runtime";
 import { useContext } from "react";
-import { TinkerableContext } from "../TinkerableContext";
-import { underAppRoot } from "../urlUtils";
-import { defaultErrorComponent, defaultLoadingComponent } from "./defaults";
-import { Include } from "./Include";
+import { TinkerableContext } from "../TinkerableContext.js";
+import { underAppRoot } from "../urlUtils.js";
+import { defaultErrorComponent, defaultLoadingComponent } from "./defaults.js";
+import { Include } from "./Include.js";
 const FileRouter = ({
   LoadingComponent = defaultLoadingComponent,
   ErrorComponent = defaultErrorComponent

package/dist/components/HeadingAnchor.js

@@ -1,10 +1,10 @@
 import "../chunk-VHAA22YE.js";
 import { jsx } from "react/jsx-runtime";
 import { use, useCallback } from "react";
-import { scrollToId } from "../scrollToId";
-import { TinkerableContext } from "../TinkerableContext";
-import { constructOuterUrl } from "../urlUtils";
-import { FragmentLink } from "./Link";
+import { scrollToId } from "../scrollToId.js";
+import { TinkerableContext } from "../TinkerableContext.js";
+import { constructOuterUrl } from "../urlUtils.js";
+import { FragmentLink } from "./Link.js";
 const HeadingAnchor = ({
   id,
   ...rest

package/dist/components/Include.js

@@ -2,11 +2,11 @@ import "../chunk-VHAA22YE.js";
 import { jsx } from "react/jsx-runtime";
 import { Suspense, use } from "react";
 import { ErrorBoundary } from "react-error-boundary";
-import { ModuleCacheContext } from "../moduleCache";
-import { defaultErrorComponent, defaultLoadingComponent } from "./defaults";
-import { IncludeModeContext, RenderExportedComponentContext } from "./includeContexts";
-import { SafeInclude } from "./SafeInclude";
-import { IncludeModeContext as IncludeModeContext2, RenderExportedComponentContext as RenderExportedComponentContext2 } from "./includeContexts";
+import { ModuleCacheContext } from "../moduleCache.js";
+import { defaultErrorComponent, defaultLoadingComponent } from "./defaults.js";
+import { IncludeModeContext, RenderExportedComponentContext } from "./includeContexts.js";
+import { SafeInclude } from "./SafeInclude.js";
+import { IncludeModeContext as IncludeModeContext2, RenderExportedComponentContext as RenderExportedComponentContext2 } from "./includeContexts.js";
 const RenderExportedComponent = ({
   evaluationContextPromise,
   exportedSymbol = "default"

package/dist/components/Link.js

@@ -1,11 +1,11 @@
 import "../chunk-VHAA22YE.js";
 import { jsx } from "react/jsx-runtime";
 import { use } from "react";
-import { isBrowserGestureClick, useComposedAnchorClick } from "../anchorClick";
-import { navigate } from "../routing";
-import { scrollToId } from "../scrollToId";
-import { TinkerableContext } from "../TinkerableContext";
-import { constructOuterUrl, isInternalHref } from "../urlUtils";
+import { isBrowserGestureClick, useComposedAnchorClick } from "../anchorClick.js";
+import { navigate } from "../routing.js";
+import { scrollToId } from "../scrollToId.js";
+import { TinkerableContext } from "../TinkerableContext.js";
+import { constructOuterUrl, isInternalHref } from "../urlUtils.js";
 const FragmentLink = ({
   href,
   children,

package/dist/components/MDXComponents.js

@@ -1,16 +1,16 @@
 import "../chunk-VHAA22YE.js";
 import { jsx } from "react/jsx-runtime";
 import { use } from "react";
-import { Admonition } from "./Admonition";
-import { FS_PREFIX, LinkSpaceContext, resolveLinkTarget } from "../linkSpace";
-import { splitHash } from "../urlUtils";
-import { HeadingAnchor } from "./HeadingAnchor";
-import { Link } from "./Link";
-import { WikiLink } from "./WikiLink";
-import { InternalLink, Link as Link2 } from "./Link";
-import { Admonition as Admonition2 } from "./Admonition";
-import { HeadingAnchor as HeadingAnchor2 } from "./HeadingAnchor";
-import { WikiLink as WikiLink2 } from "./WikiLink";
+import { Admonition } from "./Admonition.js";
+import { FS_PREFIX, LinkSpaceContext, resolveLinkTarget } from "../linkSpace.js";
+import { splitHash } from "../urlUtils.js";
+import { HeadingAnchor } from "./HeadingAnchor.js";
+import { Link } from "./Link.js";
+import { WikiLink } from "./WikiLink.js";
+import { InternalLink, Link as Link2 } from "./Link.js";
+import { Admonition as Admonition2 } from "./Admonition.js";
+import { HeadingAnchor as HeadingAnchor2 } from "./HeadingAnchor.js";
+import { WikiLink as WikiLink2 } from "./WikiLink.js";
 const DEFAULT_MDX_COMPONENTS = {
   a({
     href,

package/dist/components/MainContent.js

@@ -2,10 +2,10 @@ import "../chunk-VHAA22YE.js";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { Suspense, use, useEffect, useMemo } from "react";
 import { ErrorBoundary } from "react-error-boundary";
-import { navigate, useTinkerableLink } from "../routing";
-import { FILES_PREFIX, underAppRoot } from "../urlUtils";
-import { sandboxFs } from "../fs";
-import { defaultErrorComponent, defaultLoadingComponent } from "./defaults";
+import { navigate, useTinkerableLink } from "../routing.js";
+import { FILES_PREFIX, underAppRoot } from "../urlUtils.js";
+import { sandboxFs } from "../fs.js";
+import { defaultErrorComponent, defaultLoadingComponent } from "./defaults.js";
 const candidates = [
   "/src/App.tsx",
   "/src/App.ts",

package/dist/components/MountImage.js

@@ -1,6 +1,6 @@
 import "../chunk-VHAA22YE.js";
 import { Fragment, jsx } from "react/jsx-runtime";
-import { useObjectUrl } from "../hooks";
+import { useObjectUrl } from "../hooks.js";
 function MountImage({ mount, relPath, type, placeholder, fallback, alt = "", ...imgProps }) {
   const { url, loading, error } = useObjectUrl(mount, relPath, type ? { type } : void 0);
   if (loading) return /* @__PURE__ */ jsx(Fragment, { children: placeholder ?? null });

package/dist/components/Routes.js

@@ -1,9 +1,9 @@
 import "../chunk-VHAA22YE.js";
 import { Fragment, jsx } from "react/jsx-runtime";
 import { Children, isValidElement, use } from "react";
-import { TinkerableContext } from "../TinkerableContext";
-import { matchRoute } from "../routeMatch";
-import { renderRoute } from "../routing";
+import { TinkerableContext } from "../TinkerableContext.js";
+import { matchRoute } from "../routeMatch.js";
+import { renderRoute } from "../routing.js";
 const Route = (_props) => null;
 const Routes = ({ children, fallback = null }) => {
   const context = use(TinkerableContext);

package/dist/components/SafeInclude.js

@@ -2,13 +2,13 @@ import "../chunk-VHAA22YE.js";
 import { jsx } from "react/jsx-runtime";
 import { Suspense, use, useMemo } from "react";
 import { ErrorBoundary } from "react-error-boundary";
-import { openAppFs, openFs } from "../fs";
-import { getAppMountPath } from "../mounts";
-import { useMDXComponents } from "../MDXProvider";
-import { SafeContent } from "../safeContent/SafeContent";
-import { createSourceCache } from "../sourceCache";
-import { RenderExportedComponentContext } from "./includeContexts";
-import { defaultErrorComponent, defaultLoadingComponent } from "./defaults";
+import { openAppFs, openFs } from "../fs.js";
+import { getAppMountPath } from "../mounts.js";
+import { useMDXComponents } from "../MDXProvider.js";
+import { SafeContent } from "../safeContent/SafeContent.js";
+import { createSourceCache } from "../sourceCache.js";
+import { RenderExportedComponentContext } from "./includeContexts.js";
+import { defaultErrorComponent, defaultLoadingComponent } from "./defaults.js";
 function stripFrontmatter(source) {
   return source.replace(/^\uFEFF?---\r?\n[\s\S]*?\r?\n---[ \t]*\r?\n?/, "");
 }

package/dist/components/ScrollAfterNavigation.js

@@ -1,7 +1,7 @@
 import "../chunk-VHAA22YE.js";
 import { use, useEffect } from "react";
-import { TinkerableContext } from "../TinkerableContext";
-import { scrollToId } from "../scrollToId";
+import { TinkerableContext } from "../TinkerableContext.js";
+import { scrollToId } from "../scrollToId.js";
 const useScrollAfterNavigation = () => {
   const { navigationState } = use(TinkerableContext);
   const frag = navigationState.hash;

package/dist/components/ScrollRestoration.js

@@ -1,9 +1,9 @@
 import "../chunk-VHAA22YE.js";
 import { use, useEffect, useRef } from "react";
-import { registerEntryStateCollector } from "../entryState";
-import { nextRestoreAction, RESTORE_DEADLINE_MS } from "../scrollRestore";
-import { TinkerableContext } from "../TinkerableContext";
-import { useEntryState, useNavigationDirection } from "../useEntryState";
+import { registerEntryStateCollector } from "../entryState.js";
+import { nextRestoreAction, RESTORE_DEADLINE_MS } from "../scrollRestore.js";
+import { TinkerableContext } from "../TinkerableContext.js";
+import { useEntryState, useNavigationDirection } from "../useEntryState.js";
 const SCROLL_KEY = "ir.scroll";
 const documentScroller = () => {
   if (typeof document === "undefined" || typeof window === "undefined") return null;

package/dist/components/WikiLink.js

@@ -1,11 +1,11 @@
 import "../chunk-VHAA22YE.js";
 import { jsx } from "react/jsx-runtime";
 import { use } from "react";
-import { Link } from "./Link";
-import { RenderExportedComponentContext } from "./Include";
-import { TinkerableContext } from "../TinkerableContext";
-import { splitHash } from "../urlUtils";
-import { FS_PREFIX, LinkSpaceContext, resolveLinkTarget } from "../linkSpace";
+import { Link } from "./Link.js";
+import { RenderExportedComponentContext } from "./Include.js";
+import { TinkerableContext } from "../TinkerableContext.js";
+import { splitHash } from "../urlUtils.js";
+import { FS_PREFIX, LinkSpaceContext, resolveLinkTarget } from "../linkSpace.js";
 const labelFromTarget = (target) => {
   const base = target.split(/[\\/]/).pop() ?? target;
   return base.replace(/\.mdx?$/i, "") || target;

package/dist/components/defaults.js

@@ -1,6 +1,6 @@
 import "../chunk-VHAA22YE.js";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
-import { Spinner } from "../loading";
+import { Spinner } from "../loading.js";
 const defaultLoadingComponent = () => /* @__PURE__ */ jsx(
   "div",
   {

package/dist/components/errors.js

@@ -1,7 +1,7 @@
 import "../chunk-VHAA22YE.js";
 import { Fragment, jsxs } from "react/jsx-runtime";
 import { useContext } from "react";
-import { TinkerableContext } from "../TinkerableContext";
+import { TinkerableContext } from "../TinkerableContext.js";
 const ErrorNotFound = () => {
   const {
     navigationState: { pathParameters }

package/dist/contextUtils.js

@@ -1,7 +1,7 @@
 import "./chunk-VHAA22YE.js";
-import { parseHref, getSearchParams } from "./urlUtils";
-import { applyRoutingRule } from "./routing";
-import { getInjectedMetadataSnapshot } from "./injectedBundler";
+import { parseHref, getSearchParams } from "./urlUtils.js";
+import { applyRoutingRule } from "./routing.js";
+import { getInjectedMetadataSnapshot } from "./injectedBundler.js";
 const getContextFromUrl = (routingSpec, outerHref, filesMetadata) => {
   const navigationState = parseHref(outerHref);
   const appliedRoutingRule = applyRoutingRule(routingSpec, navigationState);

package/dist/contribute.js

@@ -1,6 +1,6 @@
 import "./chunk-VHAA22YE.js";
-import { protocolStream } from "./protocolStream";
-import { PROTOCOL_CONTRIBUTE } from "./generated/protocol";
+import { protocolStream } from "./protocolStream.js";
+import { PROTOCOL_CONTRIBUTE } from "./generated/protocol.js";
 function contribute(opts) {
   return protocolStream(PROTOCOL_CONTRIBUTE, "run", [opts]);
 }

package/dist/corpus.js

@@ -6,8 +6,8 @@ import {
   useBundleEntry,
   toBundlePath,
   fromBundlePath
-} from "./bundle";
-import { useCurrentEntry } from "./bundle";
+} from "./bundle.js";
+import { useCurrentEntry } from "./bundle.js";
 export {
   BundleContext as CorpusContext,
   fromBundlePath as fromCorpusPath,

package/dist/debug.js

@@ -1,7 +1,7 @@
 import "./chunk-VHAA22YE.js";
-import { createPushChannel } from "./pushChannel";
-import { sendMessage, addListener } from "./sandboxUtils";
-import { DEBUG_ENABLED, DEBUG_LOG, DEBUG_QUERY, DEBUG_QUERY_RESULT, REQUEST_DEBUG_ENABLED } from "./generated/protocol";
+import { createPushChannel } from "./pushChannel.js";
+import { sendMessage, addListener } from "./sandboxUtils.js";
+import { DEBUG_ENABLED, DEBUG_LOG, DEBUG_QUERY, DEBUG_QUERY_RESULT, REQUEST_DEBUG_ENABLED } from "./generated/protocol.js";
 const enabledChannel = createPushChannel({
   pushType: DEBUG_ENABLED,
   requestType: REQUEST_DEBUG_ENABLED,

package/dist/diagnostics.js

@@ -1,6 +1,6 @@
 import "./chunk-VHAA22YE.js";
-import { createPushChannel } from "./pushChannel";
-import { DIAGNOSTICS, REQUEST_DIAGNOSTICS } from "./generated/protocol";
+import { createPushChannel } from "./pushChannel.js";
+import { DIAGNOSTICS, REQUEST_DIAGNOSTICS } from "./generated/protocol.js";
 const EMPTY = { buildErrors: [], consoleEntries: [], provenance: null };
 const channel = createPushChannel({
   pushType: DIAGNOSTICS,

package/dist/dialog.cjs

@@ -0,0 +1,93 @@
+"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 dialog_exports = {};
+__export(dialog_exports, {
+  Dialog: () => Dialog,
+  useDialogDismiss: () => useDialogDismiss,
+  useDialogFocus: () => useDialogFocus
+});
+module.exports = __toCommonJS(dialog_exports);
+var import_jsx_runtime = require("react/jsx-runtime");
+var import_react = require("react");
+const FOCUSABLE = 'button:not([disabled]), [href], input, select, textarea, iframe, [tabindex]:not([tabindex="-1"])';
+const stack = [];
+const onDocumentKeyDown = (e) => {
+  if (e.key !== "Escape") return;
+  const top = stack[stack.length - 1];
+  if (!top) return;
+  e.stopPropagation();
+  top.onDismiss();
+};
+function useDialogDismiss(onDismiss, { enabled = true } = {}) {
+  const ref = (0, import_react.useRef)(onDismiss);
+  ref.current = onDismiss;
+  (0, import_react.useEffect)(() => {
+    if (!enabled) return;
+    const entry = { onDismiss: () => ref.current() };
+    stack.push(entry);
+    if (stack.length === 1) document.addEventListener("keydown", onDocumentKeyDown, true);
+    return () => {
+      const i = stack.indexOf(entry);
+      if (i !== -1) stack.splice(i, 1);
+      if (stack.length === 0) document.removeEventListener("keydown", onDocumentKeyDown, true);
+    };
+  }, [enabled]);
+}
+function useDialogFocus(ref, { enabled = true } = {}) {
+  (0, import_react.useEffect)(() => {
+    const node = ref.current;
+    if (!enabled || !node) return;
+    const invoker = document.activeElement;
+    const first = node.querySelector(FOCUSABLE) ?? node;
+    first.focus();
+    const onKeyDown = (e) => {
+      if (e.key !== "Tab") return;
+      const list = Array.from(node.querySelectorAll(FOCUSABLE));
+      if (list.length === 0) return;
+      const firstEl = list[0];
+      const lastEl = list[list.length - 1];
+      const active = document.activeElement;
+      if (e.shiftKey && active === firstEl) {
+        e.preventDefault();
+        lastEl.focus();
+      } else if (!e.shiftKey && active === lastEl) {
+        e.preventDefault();
+        firstEl.focus();
+      }
+    };
+    node.addEventListener("keydown", onKeyDown);
+    return () => {
+      node.removeEventListener("keydown", onKeyDown);
+      invoker?.focus?.();
+    };
+  }, [enabled, ref]);
+}
+function Dialog({ children, onDismiss, className, style, ...aria }) {
+  const ref = (0, import_react.useRef)(null);
+  useDialogDismiss(onDismiss);
+  useDialogFocus(ref);
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { ref, role: "dialog", "aria-modal": "true", className, style, ...aria, children });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Dialog,
+  useDialogDismiss,
+  useDialogFocus
+});
+//# sourceMappingURL=dialog.cjs.map

package/dist/dialog.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/dialog.tsx"],"sourcesContent":["// In-app dialog primitives (interaction_standards R-IX-1; the dialog half of the\n// standards' delivery vehicle, R3-613).\n//\n// The APG dialog contract as imports: Escape dismisses the TOPMOST open dialog,\n// focus moves into the dialog on open and back to the invoker on close, and Tab\n// wraps inside it. Generalized from the host's own pair (site-main\n// `useHostDialogDismiss`/`useHostDialogFocus`, R3-592) — the same decisions,\n// renamed for an app context; site-main holds the two to identical behaviour\n// with a parity test, so \"generalized\" is a fact and an app can swap between\n// the primitives without re-litigating the contract.\n//\n// TRUST BOUNDARY (same rule as `./loading`): these render INSIDE the app's\n// iframe, under the app's principal — presentational only, NO capability, NO\n// host round-trip, no reserved landmark or host wordmark. Ordinary app a11y,\n// never trusted-chrome framing; adds nothing to a grant set.\n//\n// The dismiss listener is a capture-phase listener on the app's OWN document,\n// installed while the stack is non-empty. Capture is what makes the contract\n// hold on both sides: a keystroke the app dialog claims (Escape → stopPropagation)\n// never reaches an app-level bubble handler behind the dialog — and the host's\n// top-document listener lives in another document entirely, so neither side's\n// dismissal can suppress the other's, with no protocol between them.\nimport { useEffect, useRef, type CSSProperties, type ReactNode } from 'react';\n\n/** The focusable-selector constant. Deliberately NOT exported from `index.ts`:\n *  it is an implementation detail of the trap, not author surface. Includes\n *  `iframe` because a dialog whose body hosts a frame must let Tab reach it. */\nconst FOCUSABLE = 'button:not([disabled]), [href], input, select, textarea, iframe, [tabindex]:not([tabindex=\"-1\"])';\n\ntype Entry = { onDismiss: () => void };\n\n// A module-level stack is the whole registry: the ONE capture-phase document\n// listener is installed when the first dialog mounts and removed when the last\n// unmounts. Reading `stack` fresh on each keypress makes removal-of-a-non-top-\n// entry safe.\nconst stack: Entry[] = [];\n\nconst onDocumentKeyDown = (e: KeyboardEvent): void => {\n  if (e.key !== 'Escape') return;\n  const top = stack[stack.length - 1];\n  if (!top) return;\n  e.stopPropagation();\n  top.onDismiss();\n};\n\n/**\n * Register `onDismiss` as this dialog's Escape handler. The topmost mounted\n * dialog wins: only its handler runs, and only on Escape.\n *\n * `onDismiss` is read through a ref so a new inline lambda on each render (the\n * near-universal shape of an `onClose` prop) does NOT re-register the dialog —\n * the entry is torn down and re-added only when `enabled` changes.\n */\nexport function useDialogDismiss(onDismiss: () => void, { enabled = true }: { enabled?: boolean } = {}): void {\n  const ref = useRef(onDismiss);\n  ref.current = onDismiss;\n\n  useEffect(() => {\n    if (!enabled) return;\n    const entry: Entry = { onDismiss: () => ref.current() };\n    stack.push(entry);\n    if (stack.length === 1) document.addEventListener('keydown', onDocumentKeyDown, true);\n    return () => {\n      // Unmounting removes THIS dialog's entry, which may not be the top — a\n      // dialog closed out of stack order must not leak its entry. Splice by\n      // identity, never by \"pop\".\n      const i = stack.indexOf(entry);\n      if (i !== -1) stack.splice(i, 1);\n      if (stack.length === 0) document.removeEventListener('keydown', onDocumentKeyDown, true);\n    };\n  }, [enabled]);\n}\n\n/**\n * Manage focus for one dialog rooted at `ref`: on open, record the invoking\n * element and focus the first focusable descendant (falling back to `ref`\n * itself — give the root `tabIndex={-1}` for that case); on close, return\n * focus to the invoker (guarded — it may itself have unmounted); Tab /\n * Shift-Tab wrap at the ends of the focusable list, read at keydown time\n * rather than cached on mount (dialog contents change).\n */\nexport function useDialogFocus(\n  ref: { current: HTMLElement | null },\n  { enabled = true }: { enabled?: boolean } = {},\n): void {\n  useEffect(() => {\n    const node = ref.current;\n    if (!enabled || !node) return;\n\n    // Record the invoker BEFORE stealing focus — the element that opened the dialog.\n    const invoker = document.activeElement as HTMLElement | null;\n    const first = node.querySelector<HTMLElement>(FOCUSABLE) ?? node;\n    first.focus();\n\n    const onKeyDown = (e: KeyboardEvent): void => {\n      if (e.key !== 'Tab') return;\n      const list = Array.from(node.querySelectorAll<HTMLElement>(FOCUSABLE));\n      if (list.length === 0) return;\n      const firstEl = list[0];\n      const lastEl = list[list.length - 1];\n      const active = document.activeElement;\n      if (e.shiftKey && active === firstEl) {\n        e.preventDefault();\n        lastEl.focus();\n      } else if (!e.shiftKey && active === lastEl) {\n        e.preventDefault();\n        firstEl.focus();\n      }\n    };\n    node.addEventListener('keydown', onKeyDown);\n\n    return () => {\n      node.removeEventListener('keydown', onKeyDown);\n      // The invoker may itself have unmounted by the time the dialog closes; the\n      // optional calls are why this stays safe (and why it can never throw on teardown).\n      invoker?.focus?.();\n    };\n  }, [enabled, ref]);\n}\n\n/** Props for {@link Dialog}. Styling is the app's — the primitive is structural. */\nexport interface DialogProps {\n  children: ReactNode;\n  /** Called on Escape (the topmost dialog wins). Click-outside/scrim handling is\n   *  the app's: the scrim is app chrome, and its click handler calls the same\n   *  `onDismiss`. */\n  onDismiss: () => void;\n  /** The accessible name — a dialog without one is unnamed to AT (4.1.2). */\n  'aria-label'?: string;\n  className?: string;\n  style?: CSSProperties;\n}\n\n/**\n * A dialog with the contract wired: `role=\"dialog\" aria-modal=\"true\"`, Escape\n * dismiss (topmost wins), focus in on open / back to the invoker on close, Tab\n * trapped inside. Render it when the dialog is open, with the invoker still\n * focused — the invoker is recorded at mount.\n */\nexport function Dialog({ children, onDismiss, className, style, ...aria }: DialogProps): ReactNode {\n  const ref = useRef<HTMLDivElement>(null);\n  useDialogDismiss(onDismiss);\n  useDialogFocus(ref);\n  return (\n    <div ref={ref} role=\"dialog\" aria-modal=\"true\" className={className} style={style} {...aria}>\n      {children}\n    </div>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAgJI;AA1HJ,mBAAsE;AAKtE,MAAM,YAAY;AAQlB,MAAM,QAAiB,CAAC;AAExB,MAAM,oBAAoB,CAAC,MAA2B;AACpD,MAAI,EAAE,QAAQ,SAAU;AACxB,QAAM,MAAM,MAAM,MAAM,SAAS,CAAC;AAClC,MAAI,CAAC,IAAK;AACV,IAAE,gBAAgB;AAClB,MAAI,UAAU;AAChB;AAUO,SAAS,iBAAiB,WAAuB,EAAE,UAAU,KAAK,IAA2B,CAAC,GAAS;AAC5G,QAAM,UAAM,qBAAO,SAAS;AAC5B,MAAI,UAAU;AAEd,8BAAU,MAAM;AACd,QAAI,CAAC,QAAS;AACd,UAAM,QAAe,EAAE,WAAW,MAAM,IAAI,QAAQ,EAAE;AACtD,UAAM,KAAK,KAAK;AAChB,QAAI,MAAM,WAAW,EAAG,UAAS,iBAAiB,WAAW,mBAAmB,IAAI;AACpF,WAAO,MAAM;AAIX,YAAM,IAAI,MAAM,QAAQ,KAAK;AAC7B,UAAI,MAAM,GAAI,OAAM,OAAO,GAAG,CAAC;AAC/B,UAAI,MAAM,WAAW,EAAG,UAAS,oBAAoB,WAAW,mBAAmB,IAAI;AAAA,IACzF;AAAA,EACF,GAAG,CAAC,OAAO,CAAC;AACd;AAUO,SAAS,eACd,KACA,EAAE,UAAU,KAAK,IAA2B,CAAC,GACvC;AACN,8BAAU,MAAM;AACd,UAAM,OAAO,IAAI;AACjB,QAAI,CAAC,WAAW,CAAC,KAAM;AAGvB,UAAM,UAAU,SAAS;AACzB,UAAM,QAAQ,KAAK,cAA2B,SAAS,KAAK;AAC5D,UAAM,MAAM;AAEZ,UAAM,YAAY,CAAC,MAA2B;AAC5C,UAAI,EAAE,QAAQ,MAAO;AACrB,YAAM,OAAO,MAAM,KAAK,KAAK,iBAA8B,SAAS,CAAC;AACrE,UAAI,KAAK,WAAW,EAAG;AACvB,YAAM,UAAU,KAAK,CAAC;AACtB,YAAM,SAAS,KAAK,KAAK,SAAS,CAAC;AACnC,YAAM,SAAS,SAAS;AACxB,UAAI,EAAE,YAAY,WAAW,SAAS;AACpC,UAAE,eAAe;AACjB,eAAO,MAAM;AAAA,MACf,WAAW,CAAC,EAAE,YAAY,WAAW,QAAQ;AAC3C,UAAE,eAAe;AACjB,gBAAQ,MAAM;AAAA,MAChB;AAAA,IACF;AACA,SAAK,iBAAiB,WAAW,SAAS;AAE1C,WAAO,MAAM;AACX,WAAK,oBAAoB,WAAW,SAAS;AAG7C,eAAS,QAAQ;AAAA,IACnB;AAAA,EACF,GAAG,CAAC,SAAS,GAAG,CAAC;AACnB;AAqBO,SAAS,OAAO,EAAE,UAAU,WAAW,WAAW,OAAO,GAAG,KAAK,GAA2B;AACjG,QAAM,UAAM,qBAAuB,IAAI;AACvC,mBAAiB,SAAS;AAC1B,iBAAe,GAAG;AAClB,SACE,4CAAC,SAAI,KAAU,MAAK,UAAS,cAAW,QAAO,WAAsB,OAAe,GAAG,MACpF,UACH;AAEJ;","names":[]}

package/dist/dialog.d.cts

@@ -0,0 +1,47 @@
+import { ReactNode, CSSProperties } from 'react';
+
+/**
+ * Register `onDismiss` as this dialog's Escape handler. The topmost mounted
+ * dialog wins: only its handler runs, and only on Escape.
+ *
+ * `onDismiss` is read through a ref so a new inline lambda on each render (the
+ * near-universal shape of an `onClose` prop) does NOT re-register the dialog —
+ * the entry is torn down and re-added only when `enabled` changes.
+ */
+declare function useDialogDismiss(onDismiss: () => void, { enabled }?: {
+    enabled?: boolean;
+}): void;
+/**
+ * Manage focus for one dialog rooted at `ref`: on open, record the invoking
+ * element and focus the first focusable descendant (falling back to `ref`
+ * itself — give the root `tabIndex={-1}` for that case); on close, return
+ * focus to the invoker (guarded — it may itself have unmounted); Tab /
+ * Shift-Tab wrap at the ends of the focusable list, read at keydown time
+ * rather than cached on mount (dialog contents change).
+ */
+declare function useDialogFocus(ref: {
+    current: HTMLElement | null;
+}, { enabled }?: {
+    enabled?: boolean;
+}): void;
+/** Props for {@link Dialog}. Styling is the app's — the primitive is structural. */
+interface DialogProps {
+    children: ReactNode;
+    /** Called on Escape (the topmost dialog wins). Click-outside/scrim handling is
+     *  the app's: the scrim is app chrome, and its click handler calls the same
+     *  `onDismiss`. */
+    onDismiss: () => void;
+    /** The accessible name — a dialog without one is unnamed to AT (4.1.2). */
+    'aria-label'?: string;
+    className?: string;
+    style?: CSSProperties;
+}
+/**
+ * A dialog with the contract wired: `role="dialog" aria-modal="true"`, Escape
+ * dismiss (topmost wins), focus in on open / back to the invoker on close, Tab
+ * trapped inside. Render it when the dialog is open, with the invoker still
+ * focused — the invoker is recorded at mount.
+ */
+declare function Dialog({ children, onDismiss, className, style, ...aria }: DialogProps): ReactNode;
+
+export { Dialog, type DialogProps, useDialogDismiss, useDialogFocus };

package/dist/dialog.d.ts

@@ -0,0 +1,47 @@
+import { ReactNode, CSSProperties } from 'react';
+
+/**
+ * Register `onDismiss` as this dialog's Escape handler. The topmost mounted
+ * dialog wins: only its handler runs, and only on Escape.
+ *
+ * `onDismiss` is read through a ref so a new inline lambda on each render (the
+ * near-universal shape of an `onClose` prop) does NOT re-register the dialog —
+ * the entry is torn down and re-added only when `enabled` changes.
+ */
+declare function useDialogDismiss(onDismiss: () => void, { enabled }?: {
+    enabled?: boolean;
+}): void;
+/**
+ * Manage focus for one dialog rooted at `ref`: on open, record the invoking
+ * element and focus the first focusable descendant (falling back to `ref`
+ * itself — give the root `tabIndex={-1}` for that case); on close, return
+ * focus to the invoker (guarded — it may itself have unmounted); Tab /
+ * Shift-Tab wrap at the ends of the focusable list, read at keydown time
+ * rather than cached on mount (dialog contents change).
+ */
+declare function useDialogFocus(ref: {
+    current: HTMLElement | null;
+}, { enabled }?: {
+    enabled?: boolean;
+}): void;
+/** Props for {@link Dialog}. Styling is the app's — the primitive is structural. */
+interface DialogProps {
+    children: ReactNode;
+    /** Called on Escape (the topmost dialog wins). Click-outside/scrim handling is
+     *  the app's: the scrim is app chrome, and its click handler calls the same
+     *  `onDismiss`. */
+    onDismiss: () => void;
+    /** The accessible name — a dialog without one is unnamed to AT (4.1.2). */
+    'aria-label'?: string;
+    className?: string;
+    style?: CSSProperties;
+}
+/**
+ * A dialog with the contract wired: `role="dialog" aria-modal="true"`, Escape
+ * dismiss (topmost wins), focus in on open / back to the invoker on close, Tab
+ * trapped inside. Render it when the dialog is open, with the invoker still
+ * focused — the invoker is recorded at mount.
+ */
+declare function Dialog({ children, onDismiss, className, style, ...aria }: DialogProps): ReactNode;
+
+export { Dialog, type DialogProps, useDialogDismiss, useDialogFocus };