@immediately-run/sdk 0.68.1 → 0.69.0

package/dist/status.d.cts

@@ -0,0 +1,43 @@
+import { CSSProperties, ReactNode } from 'react';
+
+/** Props for {@link Status}. */
+interface StatusProps {
+    /** The current message. Change THIS to announce; do not mount/unmount the
+     *  region per message — a region that mounts with content announces nothing. */
+    children: ReactNode;
+    /** Assertive live regions interrupt — polite never does. Opt in only for
+     *  outcomes the user must hear immediately; the default is polite. */
+    assertive?: boolean;
+    className?: string;
+    style?: CSSProperties;
+}
+/**
+ * A polite live region (WCAG 4.1.3): content changes inside a mounted region
+ * are announced without moving focus. Mount it once per surface; announce by
+ * changing `children`.
+ */
+declare function Status({ children, assertive, className, style }: StatusProps): ReactNode;
+/** Props for {@link Busy}. */
+interface BusyProps {
+    /** What is happening, named ("Saving…", "Connecting…") — the R-IX-2 label. */
+    label: string;
+    /** The flash floor: below this wait, nothing shows (LOADING_UX_SPEC §3.3 /
+     *  UI_AS_APPS_SPEC §6.2 — a fast wait never flashes a busy state). Defaults to
+     *  the platform floor; pass `0` to show immediately. */
+    floorMs?: number;
+    className?: string;
+    style?: CSSProperties;
+}
+/**
+ * The named busy state as a component: the box renders from the first frame
+ * (R-IX-2 — the control is never removed and the surface is never replaced by
+ * a spinner), `aria-busy` throughout, and the caller's label appears once the
+ * flash floor has passed — below it, nothing shows rather than a flash.
+ *
+ * Render it IN PLACE of the control's resting label while the request is in
+ * flight, with the control itself disabled by the caller:
+ * `<button disabled>{busy ? <Busy label="Saving…" /> : "Save"}</button>`.
+ */
+declare function Busy({ label, floorMs, className, style }: BusyProps): ReactNode;
+
+export { Busy, type BusyProps, Status, type StatusProps };

package/dist/status.d.ts

@@ -0,0 +1,43 @@
+import { CSSProperties, ReactNode } from 'react';
+
+/** Props for {@link Status}. */
+interface StatusProps {
+    /** The current message. Change THIS to announce; do not mount/unmount the
+     *  region per message — a region that mounts with content announces nothing. */
+    children: ReactNode;
+    /** Assertive live regions interrupt — polite never does. Opt in only for
+     *  outcomes the user must hear immediately; the default is polite. */
+    assertive?: boolean;
+    className?: string;
+    style?: CSSProperties;
+}
+/**
+ * A polite live region (WCAG 4.1.3): content changes inside a mounted region
+ * are announced without moving focus. Mount it once per surface; announce by
+ * changing `children`.
+ */
+declare function Status({ children, assertive, className, style }: StatusProps): ReactNode;
+/** Props for {@link Busy}. */
+interface BusyProps {
+    /** What is happening, named ("Saving…", "Connecting…") — the R-IX-2 label. */
+    label: string;
+    /** The flash floor: below this wait, nothing shows (LOADING_UX_SPEC §3.3 /
+     *  UI_AS_APPS_SPEC §6.2 — a fast wait never flashes a busy state). Defaults to
+     *  the platform floor; pass `0` to show immediately. */
+    floorMs?: number;
+    className?: string;
+    style?: CSSProperties;
+}
+/**
+ * The named busy state as a component: the box renders from the first frame
+ * (R-IX-2 — the control is never removed and the surface is never replaced by
+ * a spinner), `aria-busy` throughout, and the caller's label appears once the
+ * flash floor has passed — below it, nothing shows rather than a flash.
+ *
+ * Render it IN PLACE of the control's resting label while the request is in
+ * flight, with the control itself disabled by the caller:
+ * `<button disabled>{busy ? <Busy label="Saving…" /> : "Save"}</button>`.
+ */
+declare function Busy({ label, floorMs, className, style }: BusyProps): ReactNode;
+
+export { Busy, type BusyProps, Status, type StatusProps };

package/dist/status.js

@@ -0,0 +1,24 @@
+import "./chunk-VHAA22YE.js";
+import { jsx } from "react/jsx-runtime";
+import { useEffect, useState } from "react";
+import { LOADING_TIMINGS } from "./loading.js";
+function Status({ children, assertive = false, className, style }) {
+  return /* @__PURE__ */ jsx("div", { role: "status", "aria-live": assertive ? "assertive" : "polite", className, style, children });
+}
+function Busy({ label, floorMs = LOADING_TIMINGS.spinThresholdMs, className, style }) {
+  const [show, setShow] = useState(floorMs <= 0);
+  useEffect(() => {
+    if (floorMs <= 0) {
+      setShow(true);
+      return;
+    }
+    const t = setTimeout(() => setShow(true), floorMs);
+    return () => clearTimeout(t);
+  }, [floorMs, label]);
+  return /* @__PURE__ */ jsx("span", { "aria-busy": "true", className, style, children: show ? label : "" });
+}
+export {
+  Busy,
+  Status
+};
+//# sourceMappingURL=status.js.map

package/dist/status.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/status.tsx"],"sourcesContent":["// In-app status primitives (interaction_standards R-IX-2/R-IX-3; the status half\n// of the standards' delivery vehicle, R3-613).\n//\n// `Status` is the live region: mount it ONCE per surface and change its content —\n// a content change inside a mounted `role=\"status\"` region announces without\n// stealing focus (WCAG 4.1.3). `Busy` is R-IX-2's write face as a component: the\n// pending control keeps its box and names what is happening, carrying `aria-busy`.\n//\n// TRUST BOUNDARY (same rule as `./loading` and `./dialog`): presentational only,\n// NO capability, NO host round-trip, no reserved landmark or host wordmark.\n//\n// TIMING: no constant is minted here. The flash floor below is LOADING_TIMINGS'\n// spinThresholdMs — §9-2's token clause, one timing language for both modules.\nimport { useEffect, useState, type CSSProperties, type ReactNode } from 'react';\nimport { LOADING_TIMINGS } from './loading';\n\n/** Props for {@link Status}. */\nexport interface StatusProps {\n  /** The current message. Change THIS to announce; do not mount/unmount the\n   *  region per message — a region that mounts with content announces nothing. */\n  children: ReactNode;\n  /** Assertive live regions interrupt — polite never does. Opt in only for\n   *  outcomes the user must hear immediately; the default is polite. */\n  assertive?: boolean;\n  className?: string;\n  style?: CSSProperties;\n}\n\n/**\n * A polite live region (WCAG 4.1.3): content changes inside a mounted region\n * are announced without moving focus. Mount it once per surface; announce by\n * changing `children`.\n */\nexport function Status({ children, assertive = false, className, style }: StatusProps): ReactNode {\n  return (\n    <div role=\"status\" aria-live={assertive ? 'assertive' : 'polite'} className={className} style={style}>\n      {children}\n    </div>\n  );\n}\n\n/** Props for {@link Busy}. */\nexport interface BusyProps {\n  /** What is happening, named (\"Saving…\", \"Connecting…\") — the R-IX-2 label. */\n  label: string;\n  /** The flash floor: below this wait, nothing shows (LOADING_UX_SPEC §3.3 /\n   *  UI_AS_APPS_SPEC §6.2 — a fast wait never flashes a busy state). Defaults to\n   *  the platform floor; pass `0` to show immediately. */\n  floorMs?: number;\n  className?: string;\n  style?: CSSProperties;\n}\n\n/**\n * The named busy state as a component: the box renders from the first frame\n * (R-IX-2 — the control is never removed and the surface is never replaced by\n * a spinner), `aria-busy` throughout, and the caller's label appears once the\n * flash floor has passed — below it, nothing shows rather than a flash.\n *\n * Render it IN PLACE of the control's resting label while the request is in\n * flight, with the control itself disabled by the caller:\n * `<button disabled>{busy ? <Busy label=\"Saving…\" /> : \"Save\"}</button>`.\n */\nexport function Busy({ label, floorMs = LOADING_TIMINGS.spinThresholdMs, className, style }: BusyProps): ReactNode {\n  const [show, setShow] = useState(floorMs <= 0);\n  useEffect(() => {\n    if (floorMs <= 0) {\n      setShow(true);\n      return;\n    }\n    const t = setTimeout(() => setShow(true), floorMs);\n    return () => clearTimeout(t);\n  }, [floorMs, label]);\n\n  return (\n    <span aria-busy=\"true\" className={className} style={style}>\n      {show ? label : ''}\n    </span>\n  );\n}\n"],"mappings":";AAmCI;AAtBJ,SAAS,WAAW,gBAAoD;AACxE,SAAS,uBAAuB;AAmBzB,SAAS,OAAO,EAAE,UAAU,YAAY,OAAO,WAAW,MAAM,GAA2B;AAChG,SACE,oBAAC,SAAI,MAAK,UAAS,aAAW,YAAY,cAAc,UAAU,WAAsB,OACrF,UACH;AAEJ;AAwBO,SAAS,KAAK,EAAE,OAAO,UAAU,gBAAgB,iBAAiB,WAAW,MAAM,GAAyB;AACjH,QAAM,CAAC,MAAM,OAAO,IAAI,SAAS,WAAW,CAAC;AAC7C,YAAU,MAAM;AACd,QAAI,WAAW,GAAG;AAChB,cAAQ,IAAI;AACZ;AAAA,IACF;AACA,UAAM,IAAI,WAAW,MAAM,QAAQ,IAAI,GAAG,OAAO;AACjD,WAAO,MAAM,aAAa,CAAC;AAAA,EAC7B,GAAG,CAAC,SAAS,KAAK,CAAC;AAEnB,SACE,oBAAC,UAAK,aAAU,QAAO,WAAsB,OAC1C,iBAAO,QAAQ,IAClB;AAEJ;","names":[]}

package/dist/tasks.js

@@ -1,9 +1,9 @@
 import "./chunk-VHAA22YE.js";
 import { useEffect, useState } from "react";
-import { protocolRequest, sendMessage, addListener } from "./sandboxUtils";
-import { transport } from "./hostTransport";
-import { PROTOCOL_TASK, TASK_CANCEL, TASK_COMPLETE, TASK_INPUT } from "./generated/protocol";
-import { SCHEMES } from "./protocolSchemes";
+import { protocolRequest, sendMessage, addListener } from "./sandboxUtils.js";
+import { transport } from "./hostTransport.js";
+import { PROTOCOL_TASK, TASK_CANCEL, TASK_COMPLETE, TASK_INPUT } from "./generated/protocol.js";
+import { SCHEMES } from "./protocolSchemes.js";
 const capFile = (ref, opts) => ({
   $cap: "file",
   mountId: ref.mountId,

package/dist/theme.js

@@ -1,8 +1,8 @@
 import "./chunk-VHAA22YE.js";
-import { createPushChannel } from "./pushChannel";
-import { protocolRequest } from "./sandboxUtils";
-import { PROTOCOL_THEME, REQUEST_THEME, REQUEST_THEME_CATALOG, THEME, THEME_CATALOG } from "./generated/protocol";
-import { SCHEMES } from "./protocolSchemes";
+import { createPushChannel } from "./pushChannel.js";
+import { protocolRequest } from "./sandboxUtils.js";
+import { PROTOCOL_THEME, REQUEST_THEME, REQUEST_THEME_CATALOG, THEME, THEME_CATALOG } from "./generated/protocol.js";
+import { SCHEMES } from "./protocolSchemes.js";
 const DEFAULT_SELECTION = {
   theme: "dark",
   themeKey: "immediately-run-default",

package/dist/urlUtils.js

@@ -1,6 +1,6 @@
 import "./chunk-VHAA22YE.js";
 import { APP_ROOT, underAppRoot } from "@immediately-run/platform-constants";
-import { joinPaths } from "./pathUtils";
+import { joinPaths } from "./pathUtils.js";
 const FILES_PREFIX = "/files";
 const getOuterHostname = (outerHref) => {
   const url = new URL(outerHref);

package/dist/useEntryState.js

@@ -1,6 +1,6 @@
 import "./chunk-VHAA22YE.js";
 import { useCallback, useSyncExternalStore } from "react";
-import { getArrivedNavigation, saveEntryState, subscribeNavigation } from "./entryState";
+import { getArrivedNavigation, saveEntryState, subscribeNavigation } from "./entryState.js";
 const useEntryState = (key) => {
   const arrived = useSyncExternalStore(subscribeNavigation, getArrivedNavigation, getArrivedNavigation);
   const save = useCallback((value) => saveEntryState(key, value), [key]);

package/dist/vcs.js

@@ -1,8 +1,8 @@
 import "./chunk-VHAA22YE.js";
-import { createPushChannel } from "./pushChannel";
-import { protocolRequest } from "./sandboxUtils";
-import { PROTOCOL_VCS, REQUEST_VCS_STATE, VCS_STATE } from "./generated/protocol";
-import { SCHEMES } from "./protocolSchemes";
+import { createPushChannel } from "./pushChannel.js";
+import { protocolRequest } from "./sandboxUtils.js";
+import { PROTOCOL_VCS, REQUEST_VCS_STATE, VCS_STATE } from "./generated/protocol.js";
+import { SCHEMES } from "./protocolSchemes.js";
 const EMPTY = { changes: [], branch: null, prs: [], diffLoading: false };
 const isChangeArray = (v) => Array.isArray(v) && v.every((c) => !!c && typeof c.path === "string" && typeof c.status === "string");
 const channel = createPushChannel({

package/dist/version.cjs

@@ -21,7 +21,7 @@ __export(version_exports, {
   SDK_VERSION: () => SDK_VERSION
 });
 module.exports = __toCommonJS(version_exports);
-const SDK_VERSION = "0.68.1";
+const SDK_VERSION = "0.69.0";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   SDK_VERSION

package/dist/version.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/version.ts"],"sourcesContent":["// GENERATED by scripts/gen-version.mjs from package.json — do not edit by hand.\n// Regenerated on every build (prebuild); kept honest by version.test.ts.\n\n/** This SDK's package version, baked from package.json at build (SP2-6). */\nexport const SDK_VERSION = '0.68.1';\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAIO,MAAM,cAAc;","names":[]}
+{"version":3,"sources":["../src/version.ts"],"sourcesContent":["// GENERATED by scripts/gen-version.mjs from package.json — do not edit by hand.\n// Regenerated on every build (prebuild); kept honest by version.test.ts.\n\n/** This SDK's package version, baked from package.json at build (SP2-6). */\nexport const SDK_VERSION = '0.69.0';\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAIO,MAAM,cAAc;","names":[]}

package/dist/version.d.cts

@@ -1,4 +1,4 @@
 /** This SDK's package version, baked from package.json at build (SP2-6). */
-declare const SDK_VERSION = "0.68.1";
+declare const SDK_VERSION = "0.69.0";
 
 export { SDK_VERSION };

package/dist/version.d.ts

@@ -1,4 +1,4 @@
 /** This SDK's package version, baked from package.json at build (SP2-6). */
-declare const SDK_VERSION = "0.68.1";
+declare const SDK_VERSION = "0.69.0";
 
 export { SDK_VERSION };

package/dist/version.js

@@ -1,5 +1,5 @@
 import "./chunk-VHAA22YE.js";
-const SDK_VERSION = "0.68.1";
+const SDK_VERSION = "0.69.0";
 export {
   SDK_VERSION
 };

package/dist/version.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/version.ts"],"sourcesContent":["// GENERATED by scripts/gen-version.mjs from package.json — do not edit by hand.\n// Regenerated on every build (prebuild); kept honest by version.test.ts.\n\n/** This SDK's package version, baked from package.json at build (SP2-6). */\nexport const SDK_VERSION = '0.68.1';\n"],"mappings":";AAIO,MAAM,cAAc;","names":[]}
+{"version":3,"sources":["../src/version.ts"],"sourcesContent":["// GENERATED by scripts/gen-version.mjs from package.json — do not edit by hand.\n// Regenerated on every build (prebuild); kept honest by version.test.ts.\n\n/** This SDK's package version, baked from package.json at build (SP2-6). */\nexport const SDK_VERSION = '0.69.0';\n"],"mappings":";AAIO,MAAM,cAAc;","names":[]}

package/dist/workspace.js

@@ -1,6 +1,6 @@
 import "./chunk-VHAA22YE.js";
-import { createPushChannel } from "./pushChannel";
-import { WORKSPACE, REQUEST_WORKSPACE } from "./generated/protocol";
+import { createPushChannel } from "./pushChannel.js";
+import { WORKSPACE, REQUEST_WORKSPACE } from "./generated/protocol.js";
 const DEFAULT_WORKSPACE = null;
 const isWorkspace = (v) => {
   const w = v;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@immediately-run/sdk",
-  "version": "0.68.1",
+  "version": "0.69.0",
   "description": "Runtime SDK for code executing inside an immediately.run sandbox.",
   "license": "MIT",
   "repository": "github:immediately-run/immediately-run-sdk",
@@ -27,7 +27,7 @@
   "scripts": {
     "gen:version": "node scripts/gen-version.mjs",
     "prebuild": "node scripts/gen-version.mjs",
-    "build": "tsup && node scripts/build-safecontent-deps.mjs && node scripts/copy-ambient-types.mjs",
+    "build": "tsup && node scripts/build-safecontent-deps.mjs && node scripts/copy-ambient-types.mjs && node scripts/fix-dist-esm-specifiers.mjs",
     "test": "jest",
     "format": "prettier --write \"src/**/*.{ts,tsx,js,mjs,json}\" \"test/**/*.{ts,mjs}\" \"scripts/**/*.mjs\"",
     "format:check": "prettier --check \"src/**/*.{ts,tsx,js,mjs,json}\" \"test/**/*.{ts,mjs}\" \"scripts/**/*.mjs\"",
@@ -36,14 +36,15 @@
     "api:selftest": "node scripts/check-api-stability.mjs --self-test",
     "protocol:check": "node scripts/check-protocol-snapshot.mjs",
     "verify:codegen-parity": "node scripts/codegen-prototype/verify-drift.mjs --self-test && node scripts/codegen-prototype/verify-drift.mjs && node scripts/codegen-prototype/verify.streams.mjs --self-test && node scripts/codegen-prototype/verify.streams.mjs",
+    "verify:descriptor-lockstep": "node scripts/codegen-prototype/verify-lockstep.mjs --self-test && node scripts/codegen-prototype/verify-lockstep.mjs",
     "api:update": "node scripts/check-api-stability.mjs --update",
     "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",
     "check:clones": "node scripts/check-clones.mjs",
     "check:unused": "node scripts/check-unused.mjs",
     "check:untested": "node scripts/check-untested.mjs",
-    "verify": "npm run check:pins && npm run check:publish-version && npm run format:check && npm run check:circular && npm run check:clones && npm run check:unused && npm run check:untested && npm run check:bundler:selftest && npm run check:bundler && npm run build && npm test && npm run test:safe-content && npm run test:metadata-e2e && npm run test:subpath-imports && npm run api:selftest && npm run api:check && npm run compat:selftest && npm run compat:previous && npm run protocol:check && npm run protocol:selftest && npm run check:ambient:selftest && npm run check:ambient && npm run check:selfhost:selftest && npm run check:selfhost && npm run verify:codegen-parity",
-    "docs": "typedoc --json docs/api.json && node scripts/gen-llms.mjs",
+    "verify": "npm run check:pins && npm run check:publish-version && npm run format:check && npm run check:circular && npm run check:clones && npm run check:unused && npm run check:untested && npm run check:bundler:selftest && npm run check:bundler && npm run build && npm test && npm run test:safe-content && npm run test:metadata-e2e && npm run test:subpath-imports && npm run api:selftest && npm run api:check && npm run compat:selftest && npm run compat:previous && npm run protocol:check && npm run protocol:selftest && npm run check:ambient:selftest && npm run check:ambient && npm run check:selfhost:selftest && npm run check:selfhost && npm run check:dist-specifiers:selftest && npm run verify:codegen-parity && npm run verify:descriptor-lockstep",
+    "docs": "typedoc --json docs/api.json && node scripts/gen-descriptor-docs.mjs && node scripts/gen-llms.mjs",
     "prepublishOnly": "npm run check:circular && npm run build && npm run api:selftest && npm run api:check",
     "test:safe-content": "node scripts/build-safecontent-e2e.mjs && node --test test/safeContent.e2e.mjs",
     "test:metadata-e2e": "node --test test/metadataHooks.e2e.mjs",
@@ -57,6 +58,7 @@
     "check:bundler": "node scripts/check-bundler-reads.mjs",
     "check:bundler:selftest": "node scripts/check-bundler-reads.mjs --self-test",
     "check:ambient": "node scripts/check-ambient-types.mjs",
+    "check:dist-specifiers:selftest": "node scripts/fix-dist-esm-specifiers.mjs --self-test",
     "check:ambient:selftest": "node scripts/check-ambient-types.mjs --self-test"
   },
   "peerDependencies": {
@@ -67,7 +69,7 @@
     "@immediately-run/mdx-plugins": "0.7.1",
     "@immediately-run/platform-constants": "0.2.0",
     "@immediately-run/safe-content": "0.1.0",
-    "@immediately-run/sandbox-protocol": "0.10.5",
+    "@immediately-run/sandbox-protocol": "0.10.6",
     "react-error-boundary": "^6.0.0"
   },
   "devDependencies": {