@immediately-run/sdk 0.52.0 → 0.53.0

package/README.md

@@ -73,6 +73,36 @@ check against the committed snapshot). Run it before pushing; it is the same set
 checks CI enforces, so a local green equals a green CI. (Ways of working §4: the local
 verify gate must equal the deploy gate — one `npm run verify` per repo.)
 
+### The API-stability gate (`api:check`)
+
+A pinned or forked app rides one SDK version forever, so the public API is
+**additive-only** (SDK_PACKAGING_SPEC §9). `api-snapshot.json` records the **shape**
+of every export — not just its name — and `npm run api:check` fails when that shape
+shrinks:
+
+| Recorded as | Example |
+|---|---|
+| `interface(a, b?, c(1..2))` | members, sorted; `?` = optional; `(required..total)` = a callable member's arity |
+| `object(…)` / `class(…)` / `enum(…)` | same member vocabulary |
+| `union(a\|b\|c)` | a type alias's union members, normalised + sorted |
+| `fn(1..2)` | a function's `required..total` parameter arity |
+| `const(T)` / `alias(T)` | the normalised type text |
+
+So removing an export, dropping an interface field, flipping a field's optionality,
+dropping a union member, or dropping a function parameter all fail — each of them
+breaks a pinned consumer at compile time, and each of them passed the pre-R3-261
+names-only check. Member and parameter **types** are deliberately not compared; see
+the "Deliberate limit" note in [`scripts/lib/dts-shape.mjs`](./scripts/lib/dts-shape.mjs).
+
+- **Additive change** (a new export, a new optional field): run `npm run api:update`
+  and commit the snapshot, so every API change lands in a reviewed diff.
+- **Deliberate removal**: add an entry to [`api-removals.json`](./api-removals.json)
+  with a **reason**, then `npm run api:update`. Without an entry the updater refuses
+  to write, so re-running it is not a way past the gate.
+- `npm run api:selftest` proves the gate can fail — it drives the real extractor over
+  crafted `.d.ts` fixtures for each break above, checks that additive changes are
+  *not* reported as breaking, and pins the two documented blind spots.
+
 ## License
 
 [MIT](./LICENSE)

package/dist/chromeState.cjs

@@ -0,0 +1,48 @@
+"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 chromeState_exports = {};
+__export(chromeState_exports, {
+  getChromeState: () => getChromeState,
+  onChromeStateChange: () => onChromeStateChange,
+  useChromeState: () => useChromeState
+});
+module.exports = __toCommonJS(chromeState_exports);
+var import_pushChannel = require("./pushChannel");
+var import_protocol = require("./generated/protocol");
+const DEFAULT_CHROME_STATE = { overlay: "none", tab: { edge: "top-right" } };
+const isChromeState = (v) => {
+  const c = v;
+  return !!c && (c.overlay === "none" || c.overlay === "menu") && !!c.tab && typeof c.tab === "object" && c.tab.edge === "top-right";
+};
+const channel = (0, import_pushChannel.createPushChannel)({
+  pushType: import_protocol.CHROME_STATE,
+  requestType: import_protocol.REQUEST_CHROME_STATE,
+  initial: DEFAULT_CHROME_STATE,
+  parse: (msg) => isChromeState(msg.chromeState) ? msg.chromeState : void 0
+});
+const getChromeState = () => channel.get();
+const onChromeStateChange = (listener) => channel.onChange(listener);
+const useChromeState = () => channel.use();
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getChromeState,
+  onChromeStateChange,
+  useChromeState
+});
+//# sourceMappingURL=chromeState.cjs.map

package/dist/chromeState.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/chromeState.ts"],"sourcesContent":["import { createPushChannel } from './pushChannel';\nimport { CHROME_STATE, REQUEST_CHROME_STATE } from './generated/protocol';\n\n/**\n * What the immediately.run host's own chrome is currently doing over your app\n * (PRESENT_MODE_CHROME_SPEC §6). In run (\"present\") mode the platform shows a\n * single pull-down tab in one corner; activating it opens the platform menu —\n * an anchored panel on desktop, a bottom sheet on mobile — and the host dims\n * and slightly insets your app behind it.\n *\n * Reading this is **entirely optional**. No platform behavior depends on your\n * app consuming it, and an app that never reads it behaves identically\n * (R-PMC-18) — the platform never requires immediately.run knowledge of an app\n * (product value 3). It exists for the two things a cooperative app can do\n * better with it than without:\n *\n * - **Pause while dimmed.** `overlay === 'menu'` means the user is looking at\n *   platform chrome, not at you: a good moment to pause a video, an animation,\n *   or a polling loop.\n * - **Keep the corner clear.** `tab.edge` says where the platform's tab sits, so\n *   a floating control of your own can avoid overlapping it.\n *\n * Baseline capability `chrome:read` — every app may read it. It is a read of the\n * host's own UI state and discloses nothing app-foreign; there is deliberately no\n * counterpart that lets an app *operate* platform chrome.\n *\n * ```ts\n * import { onChromeStateChange } from '@immediately-run/sdk';\n *\n * onChromeStateChange(({ overlay }) => {\n *   if (overlay === 'menu') video.pause();\n * });\n * ```\n */\nexport interface ChromeState {\n  /**\n   * `'menu'` while the platform menu / bottom sheet (and its scrim) is open over\n   * your app; `'none'` at rest. Edit mode reports `'none'` — the workbench chrome\n   * is beside your app, not over it.\n   */\n  overlay: 'none' | 'menu';\n  /** Where the platform's pull-down tab sits. Only one edge exists today. */\n  tab: { edge: 'top-right' };\n}\n\n/**\n * Assumed before the host reports — and the value that stands forever on a host\n * that never pushes this channel (an older host, or one that does not paint\n * present-mode chrome at all). \"Nothing is over you\" is the safe default: an app\n * that gates a pause on it simply never pauses.\n */\nconst DEFAULT_CHROME_STATE: ChromeState = { overlay: 'none', tab: { edge: 'top-right' } };\n\nconst isChromeState = (v: unknown): v is ChromeState => {\n  const c = v as Partial<ChromeState> | null;\n  return (\n    !!c &&\n    (c.overlay === 'none' || c.overlay === 'menu') &&\n    !!c.tab &&\n    typeof c.tab === 'object' &&\n    (c.tab as ChromeState['tab']).edge === 'top-right'\n  );\n};\n\n// Read over the transport (SDK_PACKAGING_SPEC §4): the host pushes `chrome-state`\n// and answers `request-chrome-state` (wire format: site-main channelBridge.ts).\nconst channel = createPushChannel<ChromeState>({\n  pushType: CHROME_STATE,\n  requestType: REQUEST_CHROME_STATE,\n  initial: DEFAULT_CHROME_STATE,\n  parse: (msg) => (isChromeState(msg.chromeState) ? (msg.chromeState as ChromeState) : undefined),\n});\n\n/** Returns the current chrome state. Poll for a one-off read. */\nexport const getChromeState = (): ChromeState => channel.get();\n\n/**\n * Subscribe to chrome-state changes. The listener is invoked immediately with the\n * current value, then again on every change. Returns an unsubscribe fn.\n */\nexport const onChromeStateChange = (listener: (chromeState: ChromeState) => void): (() => void) =>\n  channel.onChange(listener);\n\n/** React hook returning the current chrome state, re-rendering on change. */\nexport const useChromeState = (): ChromeState => channel.use();\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,yBAAkC;AAClC,sBAAmD;AAkDnD,MAAM,uBAAoC,EAAE,SAAS,QAAQ,KAAK,EAAE,MAAM,YAAY,EAAE;AAExF,MAAM,gBAAgB,CAAC,MAAiC;AACtD,QAAM,IAAI;AACV,SACE,CAAC,CAAC,MACD,EAAE,YAAY,UAAU,EAAE,YAAY,WACvC,CAAC,CAAC,EAAE,OACJ,OAAO,EAAE,QAAQ,YAChB,EAAE,IAA2B,SAAS;AAE3C;AAIA,MAAM,cAAU,sCAA+B;AAAA,EAC7C,UAAU;AAAA,EACV,aAAa;AAAA,EACb,SAAS;AAAA,EACT,OAAO,CAAC,QAAS,cAAc,IAAI,WAAW,IAAK,IAAI,cAA8B;AACvF,CAAC;AAGM,MAAM,iBAAiB,MAAmB,QAAQ,IAAI;AAMtD,MAAM,sBAAsB,CAAC,aAClC,QAAQ,SAAS,QAAQ;AAGpB,MAAM,iBAAiB,MAAmB,QAAQ,IAAI;","names":[]}

package/dist/chromeState.d.cts

@@ -0,0 +1,54 @@
+/**
+ * What the immediately.run host's own chrome is currently doing over your app
+ * (PRESENT_MODE_CHROME_SPEC §6). In run ("present") mode the platform shows a
+ * single pull-down tab in one corner; activating it opens the platform menu —
+ * an anchored panel on desktop, a bottom sheet on mobile — and the host dims
+ * and slightly insets your app behind it.
+ *
+ * Reading this is **entirely optional**. No platform behavior depends on your
+ * app consuming it, and an app that never reads it behaves identically
+ * (R-PMC-18) — the platform never requires immediately.run knowledge of an app
+ * (product value 3). It exists for the two things a cooperative app can do
+ * better with it than without:
+ *
+ * - **Pause while dimmed.** `overlay === 'menu'` means the user is looking at
+ *   platform chrome, not at you: a good moment to pause a video, an animation,
+ *   or a polling loop.
+ * - **Keep the corner clear.** `tab.edge` says where the platform's tab sits, so
+ *   a floating control of your own can avoid overlapping it.
+ *
+ * Baseline capability `chrome:read` — every app may read it. It is a read of the
+ * host's own UI state and discloses nothing app-foreign; there is deliberately no
+ * counterpart that lets an app *operate* platform chrome.
+ *
+ * ```ts
+ * import { onChromeStateChange } from '@immediately-run/sdk';
+ *
+ * onChromeStateChange(({ overlay }) => {
+ *   if (overlay === 'menu') video.pause();
+ * });
+ * ```
+ */
+interface ChromeState {
+    /**
+     * `'menu'` while the platform menu / bottom sheet (and its scrim) is open over
+     * your app; `'none'` at rest. Edit mode reports `'none'` — the workbench chrome
+     * is beside your app, not over it.
+     */
+    overlay: 'none' | 'menu';
+    /** Where the platform's pull-down tab sits. Only one edge exists today. */
+    tab: {
+        edge: 'top-right';
+    };
+}
+/** Returns the current chrome state. Poll for a one-off read. */
+declare const getChromeState: () => ChromeState;
+/**
+ * Subscribe to chrome-state changes. The listener is invoked immediately with the
+ * current value, then again on every change. Returns an unsubscribe fn.
+ */
+declare const onChromeStateChange: (listener: (chromeState: ChromeState) => void) => (() => void);
+/** React hook returning the current chrome state, re-rendering on change. */
+declare const useChromeState: () => ChromeState;
+
+export { type ChromeState, getChromeState, onChromeStateChange, useChromeState };

package/dist/chromeState.d.ts

@@ -0,0 +1,54 @@
+/**
+ * What the immediately.run host's own chrome is currently doing over your app
+ * (PRESENT_MODE_CHROME_SPEC §6). In run ("present") mode the platform shows a
+ * single pull-down tab in one corner; activating it opens the platform menu —
+ * an anchored panel on desktop, a bottom sheet on mobile — and the host dims
+ * and slightly insets your app behind it.
+ *
+ * Reading this is **entirely optional**. No platform behavior depends on your
+ * app consuming it, and an app that never reads it behaves identically
+ * (R-PMC-18) — the platform never requires immediately.run knowledge of an app
+ * (product value 3). It exists for the two things a cooperative app can do
+ * better with it than without:
+ *
+ * - **Pause while dimmed.** `overlay === 'menu'` means the user is looking at
+ *   platform chrome, not at you: a good moment to pause a video, an animation,
+ *   or a polling loop.
+ * - **Keep the corner clear.** `tab.edge` says where the platform's tab sits, so
+ *   a floating control of your own can avoid overlapping it.
+ *
+ * Baseline capability `chrome:read` — every app may read it. It is a read of the
+ * host's own UI state and discloses nothing app-foreign; there is deliberately no
+ * counterpart that lets an app *operate* platform chrome.
+ *
+ * ```ts
+ * import { onChromeStateChange } from '@immediately-run/sdk';
+ *
+ * onChromeStateChange(({ overlay }) => {
+ *   if (overlay === 'menu') video.pause();
+ * });
+ * ```
+ */
+interface ChromeState {
+    /**
+     * `'menu'` while the platform menu / bottom sheet (and its scrim) is open over
+     * your app; `'none'` at rest. Edit mode reports `'none'` — the workbench chrome
+     * is beside your app, not over it.
+     */
+    overlay: 'none' | 'menu';
+    /** Where the platform's pull-down tab sits. Only one edge exists today. */
+    tab: {
+        edge: 'top-right';
+    };
+}
+/** Returns the current chrome state. Poll for a one-off read. */
+declare const getChromeState: () => ChromeState;
+/**
+ * Subscribe to chrome-state changes. The listener is invoked immediately with the
+ * current value, then again on every change. Returns an unsubscribe fn.
+ */
+declare const onChromeStateChange: (listener: (chromeState: ChromeState) => void) => (() => void);
+/** React hook returning the current chrome state, re-rendering on change. */
+declare const useChromeState: () => ChromeState;
+
+export { type ChromeState, getChromeState, onChromeStateChange, useChromeState };

package/dist/chromeState.js

@@ -0,0 +1,23 @@
+import "./chunk-VHAA22YE.js";
+import { createPushChannel } from "./pushChannel";
+import { CHROME_STATE, REQUEST_CHROME_STATE } from "./generated/protocol";
+const DEFAULT_CHROME_STATE = { overlay: "none", tab: { edge: "top-right" } };
+const isChromeState = (v) => {
+  const c = v;
+  return !!c && (c.overlay === "none" || c.overlay === "menu") && !!c.tab && typeof c.tab === "object" && c.tab.edge === "top-right";
+};
+const channel = createPushChannel({
+  pushType: CHROME_STATE,
+  requestType: REQUEST_CHROME_STATE,
+  initial: DEFAULT_CHROME_STATE,
+  parse: (msg) => isChromeState(msg.chromeState) ? msg.chromeState : void 0
+});
+const getChromeState = () => channel.get();
+const onChromeStateChange = (listener) => channel.onChange(listener);
+const useChromeState = () => channel.use();
+export {
+  getChromeState,
+  onChromeStateChange,
+  useChromeState
+};
+//# sourceMappingURL=chromeState.js.map

package/dist/chromeState.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/chromeState.ts"],"sourcesContent":["import { createPushChannel } from './pushChannel';\nimport { CHROME_STATE, REQUEST_CHROME_STATE } from './generated/protocol';\n\n/**\n * What the immediately.run host's own chrome is currently doing over your app\n * (PRESENT_MODE_CHROME_SPEC §6). In run (\"present\") mode the platform shows a\n * single pull-down tab in one corner; activating it opens the platform menu —\n * an anchored panel on desktop, a bottom sheet on mobile — and the host dims\n * and slightly insets your app behind it.\n *\n * Reading this is **entirely optional**. No platform behavior depends on your\n * app consuming it, and an app that never reads it behaves identically\n * (R-PMC-18) — the platform never requires immediately.run knowledge of an app\n * (product value 3). It exists for the two things a cooperative app can do\n * better with it than without:\n *\n * - **Pause while dimmed.** `overlay === 'menu'` means the user is looking at\n *   platform chrome, not at you: a good moment to pause a video, an animation,\n *   or a polling loop.\n * - **Keep the corner clear.** `tab.edge` says where the platform's tab sits, so\n *   a floating control of your own can avoid overlapping it.\n *\n * Baseline capability `chrome:read` — every app may read it. It is a read of the\n * host's own UI state and discloses nothing app-foreign; there is deliberately no\n * counterpart that lets an app *operate* platform chrome.\n *\n * ```ts\n * import { onChromeStateChange } from '@immediately-run/sdk';\n *\n * onChromeStateChange(({ overlay }) => {\n *   if (overlay === 'menu') video.pause();\n * });\n * ```\n */\nexport interface ChromeState {\n  /**\n   * `'menu'` while the platform menu / bottom sheet (and its scrim) is open over\n   * your app; `'none'` at rest. Edit mode reports `'none'` — the workbench chrome\n   * is beside your app, not over it.\n   */\n  overlay: 'none' | 'menu';\n  /** Where the platform's pull-down tab sits. Only one edge exists today. */\n  tab: { edge: 'top-right' };\n}\n\n/**\n * Assumed before the host reports — and the value that stands forever on a host\n * that never pushes this channel (an older host, or one that does not paint\n * present-mode chrome at all). \"Nothing is over you\" is the safe default: an app\n * that gates a pause on it simply never pauses.\n */\nconst DEFAULT_CHROME_STATE: ChromeState = { overlay: 'none', tab: { edge: 'top-right' } };\n\nconst isChromeState = (v: unknown): v is ChromeState => {\n  const c = v as Partial<ChromeState> | null;\n  return (\n    !!c &&\n    (c.overlay === 'none' || c.overlay === 'menu') &&\n    !!c.tab &&\n    typeof c.tab === 'object' &&\n    (c.tab as ChromeState['tab']).edge === 'top-right'\n  );\n};\n\n// Read over the transport (SDK_PACKAGING_SPEC §4): the host pushes `chrome-state`\n// and answers `request-chrome-state` (wire format: site-main channelBridge.ts).\nconst channel = createPushChannel<ChromeState>({\n  pushType: CHROME_STATE,\n  requestType: REQUEST_CHROME_STATE,\n  initial: DEFAULT_CHROME_STATE,\n  parse: (msg) => (isChromeState(msg.chromeState) ? (msg.chromeState as ChromeState) : undefined),\n});\n\n/** Returns the current chrome state. Poll for a one-off read. */\nexport const getChromeState = (): ChromeState => channel.get();\n\n/**\n * Subscribe to chrome-state changes. The listener is invoked immediately with the\n * current value, then again on every change. Returns an unsubscribe fn.\n */\nexport const onChromeStateChange = (listener: (chromeState: ChromeState) => void): (() => void) =>\n  channel.onChange(listener);\n\n/** React hook returning the current chrome state, re-rendering on change. */\nexport const useChromeState = (): ChromeState => channel.use();\n"],"mappings":";AAAA,SAAS,yBAAyB;AAClC,SAAS,cAAc,4BAA4B;AAkDnD,MAAM,uBAAoC,EAAE,SAAS,QAAQ,KAAK,EAAE,MAAM,YAAY,EAAE;AAExF,MAAM,gBAAgB,CAAC,MAAiC;AACtD,QAAM,IAAI;AACV,SACE,CAAC,CAAC,MACD,EAAE,YAAY,UAAU,EAAE,YAAY,WACvC,CAAC,CAAC,EAAE,OACJ,OAAO,EAAE,QAAQ,YAChB,EAAE,IAA2B,SAAS;AAE3C;AAIA,MAAM,UAAU,kBAA+B;AAAA,EAC7C,UAAU;AAAA,EACV,aAAa;AAAA,EACb,SAAS;AAAA,EACT,OAAO,CAAC,QAAS,cAAc,IAAI,WAAW,IAAK,IAAI,cAA8B;AACvF,CAAC;AAGM,MAAM,iBAAiB,MAAmB,QAAQ,IAAI;AAMtD,MAAM,sBAAsB,CAAC,aAClC,QAAQ,SAAS,QAAQ;AAGpB,MAAM,iBAAiB,MAAmB,QAAQ,IAAI;","names":[]}

package/dist/index.cjs

@@ -43,6 +43,7 @@ __reExport(index_exports, require("./theme"), module.exports);
 __reExport(index_exports, require("./editorContext"), module.exports);
 __reExport(index_exports, require("./editor"), module.exports);
 __reExport(index_exports, require("./formFactor"), module.exports);
+__reExport(index_exports, require("./chromeState"), module.exports);
 __reExport(index_exports, require("./hostAttention"), module.exports);
 __reExport(index_exports, require("./region"), module.exports);
 __reExport(index_exports, require("./mounts"), module.exports);
@@ -91,6 +92,7 @@ __reExport(index_exports, require("./safeContent"), module.exports);
   ...require("./editorContext"),
   ...require("./editor"),
   ...require("./formFactor"),
+  ...require("./chromeState"),
   ...require("./hostAttention"),
   ...require("./region"),
   ...require("./mounts"),

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export * from './MDXProvider';\nexport * from './routing';\nexport * from './boot';\nexport * from './components/Include';\n// Only the component is public. `stripFrontmatter`/`appMountRelative` are module-level\n// exports so they can be unit-tested directly, NOT public API — the SDK's surface is\n// backwards-compatible forever, so an internal helper exported for a test's convenience is a\n// permanent commitment made for the wrong reason.\nexport { SafeInclude } from './components/SafeInclude';\nexport * from './sourceCache';\nexport * from './components/MDXComponents';\nexport * from './linkSpace';\nexport * from './corpus';\nexport * from './components/MountImage';\nexport * from './components/Routes';\nexport * from './hooks';\n// R3-276: the supported way for a viewer app to provide its own metadata store,\n// replacing a wholesale re-provision of `TinkerableContext` in app code.\nexport * from './metadataSource';\n// The deprecated injected-bundler adapters, re-exported so their deprecation notices\n// are visible in the published docs (R3-278; the window only narrows).\nexport { getInjectedMetadataEmitter, getInjectedMetadataSnapshot } from './injectedBundler';\nexport * from './auth';\nexport * from './theme';\nexport * from './editorContext';\nexport * from './editor';\nexport * from './formFactor';\nexport * from './hostAttention';\nexport * from './region';\nexport * from './mounts';\nexport * from './analytics';\nexport * from './contribute';\nexport * from './catalog';\nexport * from './ipc';\nexport * from './dnd';\nexport * from './netFetch';\nexport * from './secrets';\nexport * from './llm';\nexport * from './diagnostics';\nexport * from './vcs';\nexport * from './onFsChange';\nexport * from './fs';\nexport * from './debug';\nexport * from './tasks';\nexport * from './launch';\nexport * from './runtime';\nexport * from './irMarkers';\nexport * from './ready';\nexport * from './loading';\nexport * from './protocolStream';\nexport * from './protocolDeadline';\nexport * from './sandboxTypes';\nexport * from './safeContent';\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,0BAAc,0BAAd;AACA,0BAAc,sBADd;AAEA,0BAAc,mBAFd;AAGA,0BAAc,iCAHd;AAQA,yBAA4B;AAC5B,0BAAc,0BATd;AAUA,0BAAc,uCAVd;AAWA,0BAAc,wBAXd;AAYA,0BAAc,qBAZd;AAaA,0BAAc,oCAbd;AAcA,0BAAc,gCAdd;AAeA,0BAAc,oBAfd;AAkBA,0BAAc,6BAlBd;AAqBA,6BAAwE;AACxE,0BAAc,mBAtBd;AAuBA,0BAAc,oBAvBd;AAwBA,0BAAc,4BAxBd;AAyBA,0BAAc,qBAzBd;AA0BA,0BAAc,yBA1Bd;AA2BA,0BAAc,4BA3Bd;AA4BA,0BAAc,qBA5Bd;AA6BA,0BAAc,qBA7Bd;AA8BA,0BAAc,wBA9Bd;AA+BA,0BAAc,yBA/Bd;AAgCA,0BAAc,sBAhCd;AAiCA,0BAAc,kBAjCd;AAkCA,0BAAc,kBAlCd;AAmCA,0BAAc,uBAnCd;AAoCA,0BAAc,sBApCd;AAqCA,0BAAc,kBArCd;AAsCA,0BAAc,0BAtCd;AAuCA,0BAAc,kBAvCd;AAwCA,0BAAc,yBAxCd;AAyCA,0BAAc,iBAzCd;AA0CA,0BAAc,oBA1Cd;AA2CA,0BAAc,oBA3Cd;AA4CA,0BAAc,qBA5Cd;AA6CA,0BAAc,sBA7Cd;AA8CA,0BAAc,wBA9Cd;AA+CA,0BAAc,oBA/Cd;AAgDA,0BAAc,sBAhDd;AAiDA,0BAAc,6BAjDd;AAkDA,0BAAc,+BAlDd;AAmDA,0BAAc,2BAnDd;AAoDA,0BAAc,0BApDd;","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export * from './MDXProvider';\nexport * from './routing';\nexport * from './boot';\nexport * from './components/Include';\n// Only the component is public. `stripFrontmatter`/`appMountRelative` are module-level\n// exports so they can be unit-tested directly, NOT public API — the SDK's surface is\n// backwards-compatible forever, so an internal helper exported for a test's convenience is a\n// permanent commitment made for the wrong reason.\nexport { SafeInclude } from './components/SafeInclude';\nexport * from './sourceCache';\nexport * from './components/MDXComponents';\nexport * from './linkSpace';\nexport * from './corpus';\nexport * from './components/MountImage';\nexport * from './components/Routes';\nexport * from './hooks';\n// R3-276: the supported way for a viewer app to provide its own metadata store,\n// replacing a wholesale re-provision of `TinkerableContext` in app code.\nexport * from './metadataSource';\n// The deprecated injected-bundler adapters, re-exported so their deprecation notices\n// are visible in the published docs (R3-278; the window only narrows).\nexport { getInjectedMetadataEmitter, getInjectedMetadataSnapshot } from './injectedBundler';\nexport * from './auth';\nexport * from './theme';\nexport * from './editorContext';\nexport * from './editor';\nexport * from './formFactor';\nexport * from './chromeState';\nexport * from './hostAttention';\nexport * from './region';\nexport * from './mounts';\nexport * from './analytics';\nexport * from './contribute';\nexport * from './catalog';\nexport * from './ipc';\nexport * from './dnd';\nexport * from './netFetch';\nexport * from './secrets';\nexport * from './llm';\nexport * from './diagnostics';\nexport * from './vcs';\nexport * from './onFsChange';\nexport * from './fs';\nexport * from './debug';\nexport * from './tasks';\nexport * from './launch';\nexport * from './runtime';\nexport * from './irMarkers';\nexport * from './ready';\nexport * from './loading';\nexport * from './protocolStream';\nexport * from './protocolDeadline';\nexport * from './sandboxTypes';\nexport * from './safeContent';\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,0BAAc,0BAAd;AACA,0BAAc,sBADd;AAEA,0BAAc,mBAFd;AAGA,0BAAc,iCAHd;AAQA,yBAA4B;AAC5B,0BAAc,0BATd;AAUA,0BAAc,uCAVd;AAWA,0BAAc,wBAXd;AAYA,0BAAc,qBAZd;AAaA,0BAAc,oCAbd;AAcA,0BAAc,gCAdd;AAeA,0BAAc,oBAfd;AAkBA,0BAAc,6BAlBd;AAqBA,6BAAwE;AACxE,0BAAc,mBAtBd;AAuBA,0BAAc,oBAvBd;AAwBA,0BAAc,4BAxBd;AAyBA,0BAAc,qBAzBd;AA0BA,0BAAc,yBA1Bd;AA2BA,0BAAc,0BA3Bd;AA4BA,0BAAc,4BA5Bd;AA6BA,0BAAc,qBA7Bd;AA8BA,0BAAc,qBA9Bd;AA+BA,0BAAc,wBA/Bd;AAgCA,0BAAc,yBAhCd;AAiCA,0BAAc,sBAjCd;AAkCA,0BAAc,kBAlCd;AAmCA,0BAAc,kBAnCd;AAoCA,0BAAc,uBApCd;AAqCA,0BAAc,sBArCd;AAsCA,0BAAc,kBAtCd;AAuCA,0BAAc,0BAvCd;AAwCA,0BAAc,kBAxCd;AAyCA,0BAAc,yBAzCd;AA0CA,0BAAc,iBA1Cd;AA2CA,0BAAc,oBA3Cd;AA4CA,0BAAc,oBA5Cd;AA6CA,0BAAc,qBA7Cd;AA8CA,0BAAc,sBA9Cd;AA+CA,0BAAc,wBA/Cd;AAgDA,0BAAc,oBAhDd;AAiDA,0BAAc,sBAjDd;AAkDA,0BAAc,6BAlDd;AAmDA,0BAAc,+BAnDd;AAoDA,0BAAc,2BApDd;AAqDA,0BAAc,0BArDd;","names":[]}

package/dist/index.d.cts

@@ -17,6 +17,7 @@ export { HostTheme, getHostTheme, onHostThemeChange, setHostTheme, useHostTheme
 export { EditorContext, getEditorContext, onEditorContextChange, useEditorContext } from './editorContext.cjs';
 export { EditTarget, EditorOpenError, EditorSessionError, EditorWriteError, RequestEditError, closeFile, createFile, createFolder, deleteEntry, openInEditor, renameEntry, requestEdit, setActiveFile, uploadFile } from './editor.cjs';
 export { FormFactor, FormFactorClass, Orientation, getFormFactor, onFormFactorChange, useFormFactor } from './formFactor.cjs';
+export { ChromeState, getChromeState, onChromeStateChange, useChromeState } from './chromeState.cjs';
 export { HostAttention, HostAttentionKind, NO_HOST_ATTENTION, getHostAttention, onHostAttentionChange, useHostAttention } from './hostAttention.cjs';
 export { getRegion, useRegion } from './region.cjs';
 export { Invite, MountQuery, MountRemoveReason, MountRule, RemovedMount, SandboxMount, SessionMount, SpaceError, acceptInvite, awaitMatchingMount, createSpace, declineInvite, findMount, getAppMountPath, getInvites, getMounts, getSessionMounts, importSettingsFromParent, listMyInvites, listPendingInvites, listSettingsApps, makeContentRef, mount, mountSpace, onInvitesChange, onMountsChange, onSessionMountsChange, openSettings, openSettingsOf, requestMount, requestSpace, resolveContentRef, resolveContentRefs, revokeInvite, unmountSpace, useInvites, useMounts, useSessionMounts, waitForMount } from './mounts.cjs';

package/dist/index.d.ts

@@ -17,6 +17,7 @@ export { HostTheme, getHostTheme, onHostThemeChange, setHostTheme, useHostTheme
 export { EditorContext, getEditorContext, onEditorContextChange, useEditorContext } from './editorContext.js';
 export { EditTarget, EditorOpenError, EditorSessionError, EditorWriteError, RequestEditError, closeFile, createFile, createFolder, deleteEntry, openInEditor, renameEntry, requestEdit, setActiveFile, uploadFile } from './editor.js';
 export { FormFactor, FormFactorClass, Orientation, getFormFactor, onFormFactorChange, useFormFactor } from './formFactor.js';
+export { ChromeState, getChromeState, onChromeStateChange, useChromeState } from './chromeState.js';
 export { HostAttention, HostAttentionKind, NO_HOST_ATTENTION, getHostAttention, onHostAttentionChange, useHostAttention } from './hostAttention.js';
 export { getRegion, useRegion } from './region.js';
 export { Invite, MountQuery, MountRemoveReason, MountRule, RemovedMount, SandboxMount, SessionMount, SpaceError, acceptInvite, awaitMatchingMount, createSpace, declineInvite, findMount, getAppMountPath, getInvites, getMounts, getSessionMounts, importSettingsFromParent, listMyInvites, listPendingInvites, listSettingsApps, makeContentRef, mount, mountSpace, onInvitesChange, onMountsChange, onSessionMountsChange, openSettings, openSettingsOf, requestMount, requestSpace, resolveContentRef, resolveContentRefs, revokeInvite, unmountSpace, useInvites, useMounts, useSessionMounts, waitForMount } from './mounts.js';

package/dist/index.js

@@ -18,6 +18,7 @@ export * from "./theme";
 export * from "./editorContext";
 export * from "./editor";
 export * from "./formFactor";
+export * from "./chromeState";
 export * from "./hostAttention";
 export * from "./region";
 export * from "./mounts";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export * from './MDXProvider';\nexport * from './routing';\nexport * from './boot';\nexport * from './components/Include';\n// Only the component is public. `stripFrontmatter`/`appMountRelative` are module-level\n// exports so they can be unit-tested directly, NOT public API — the SDK's surface is\n// backwards-compatible forever, so an internal helper exported for a test's convenience is a\n// permanent commitment made for the wrong reason.\nexport { SafeInclude } from './components/SafeInclude';\nexport * from './sourceCache';\nexport * from './components/MDXComponents';\nexport * from './linkSpace';\nexport * from './corpus';\nexport * from './components/MountImage';\nexport * from './components/Routes';\nexport * from './hooks';\n// R3-276: the supported way for a viewer app to provide its own metadata store,\n// replacing a wholesale re-provision of `TinkerableContext` in app code.\nexport * from './metadataSource';\n// The deprecated injected-bundler adapters, re-exported so their deprecation notices\n// are visible in the published docs (R3-278; the window only narrows).\nexport { getInjectedMetadataEmitter, getInjectedMetadataSnapshot } from './injectedBundler';\nexport * from './auth';\nexport * from './theme';\nexport * from './editorContext';\nexport * from './editor';\nexport * from './formFactor';\nexport * from './hostAttention';\nexport * from './region';\nexport * from './mounts';\nexport * from './analytics';\nexport * from './contribute';\nexport * from './catalog';\nexport * from './ipc';\nexport * from './dnd';\nexport * from './netFetch';\nexport * from './secrets';\nexport * from './llm';\nexport * from './diagnostics';\nexport * from './vcs';\nexport * from './onFsChange';\nexport * from './fs';\nexport * from './debug';\nexport * from './tasks';\nexport * from './launch';\nexport * from './runtime';\nexport * from './irMarkers';\nexport * from './ready';\nexport * from './loading';\nexport * from './protocolStream';\nexport * from './protocolDeadline';\nexport * from './sandboxTypes';\nexport * from './safeContent';\n"],"mappings":";AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AAKd,SAAS,mBAAmB;AAC5B,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AAGd,cAAc;AAGd,SAAS,4BAA4B,mCAAmC;AACxE,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export * from './MDXProvider';\nexport * from './routing';\nexport * from './boot';\nexport * from './components/Include';\n// Only the component is public. `stripFrontmatter`/`appMountRelative` are module-level\n// exports so they can be unit-tested directly, NOT public API — the SDK's surface is\n// backwards-compatible forever, so an internal helper exported for a test's convenience is a\n// permanent commitment made for the wrong reason.\nexport { SafeInclude } from './components/SafeInclude';\nexport * from './sourceCache';\nexport * from './components/MDXComponents';\nexport * from './linkSpace';\nexport * from './corpus';\nexport * from './components/MountImage';\nexport * from './components/Routes';\nexport * from './hooks';\n// R3-276: the supported way for a viewer app to provide its own metadata store,\n// replacing a wholesale re-provision of `TinkerableContext` in app code.\nexport * from './metadataSource';\n// The deprecated injected-bundler adapters, re-exported so their deprecation notices\n// are visible in the published docs (R3-278; the window only narrows).\nexport { getInjectedMetadataEmitter, getInjectedMetadataSnapshot } from './injectedBundler';\nexport * from './auth';\nexport * from './theme';\nexport * from './editorContext';\nexport * from './editor';\nexport * from './formFactor';\nexport * from './chromeState';\nexport * from './hostAttention';\nexport * from './region';\nexport * from './mounts';\nexport * from './analytics';\nexport * from './contribute';\nexport * from './catalog';\nexport * from './ipc';\nexport * from './dnd';\nexport * from './netFetch';\nexport * from './secrets';\nexport * from './llm';\nexport * from './diagnostics';\nexport * from './vcs';\nexport * from './onFsChange';\nexport * from './fs';\nexport * from './debug';\nexport * from './tasks';\nexport * from './launch';\nexport * from './runtime';\nexport * from './irMarkers';\nexport * from './ready';\nexport * from './loading';\nexport * from './protocolStream';\nexport * from './protocolDeadline';\nexport * from './sandboxTypes';\nexport * from './safeContent';\n"],"mappings":";AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AAKd,SAAS,mBAAmB;AAC5B,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AAGd,cAAc;AAGd,SAAS,4BAA4B,mCAAmC;AACxE,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;","names":[]}

package/dist/version.cjs

@@ -21,7 +21,7 @@ __export(version_exports, {
   SDK_VERSION: () => SDK_VERSION
 });
 module.exports = __toCommonJS(version_exports);
-const SDK_VERSION = "0.52.0";
+const SDK_VERSION = "0.53.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.52.0';\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.53.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.52.0";
+declare const SDK_VERSION = "0.53.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.52.0";
+declare const SDK_VERSION = "0.53.0";
 
 export { SDK_VERSION };

package/dist/version.js

@@ -1,5 +1,5 @@
 import "./chunk-VHAA22YE.js";
-const SDK_VERSION = "0.52.0";
+const SDK_VERSION = "0.53.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.52.0';\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.53.0';\n"],"mappings":";AAIO,MAAM,cAAc;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@immediately-run/sdk",
-  "version": "0.52.0",
+  "version": "0.53.0",
   "description": "Runtime SDK for code executing inside an immediately.run sandbox.",
   "license": "MIT",
   "repository": "github:immediately-run/immediately-run-sdk",
@@ -33,12 +33,15 @@
     "format:check": "prettier --check \"src/**/*.{ts,tsx,js,mjs,json}\" \"test/**/*.{ts,mjs}\" \"scripts/**/*.mjs\"",
     "check:circular": "node scripts/check-circular.mjs",
     "api:check": "node scripts/check-api-stability.mjs",
+    "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",
     "api:update": "node scripts/check-api-stability.mjs --update",
-    "verify": "npm run format:check && npm run check:circular && 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 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",
+    "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",
+    "verify": "npm run check:pins && npm run check:publish-version && npm run format:check && npm run check:circular && 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 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",
-    "prepublishOnly": "npm run check:circular && npm run build && npm run api:check",
+    "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",
     "protocol:selftest": "node scripts/check-protocol-snapshot.mjs --self-test",
@@ -58,7 +61,7 @@
   },
   "dependencies": {
     "@immediately-run/platform-constants": "0.2.0",
-    "@immediately-run/sandbox-protocol": "0.5.0",
+    "@immediately-run/sandbox-protocol": "0.6.0",
     "react-error-boundary": "^6.0.0",
     "@immediately-run/safe-content": "0.1.0",
     "@immediately-run/mdx-plugins": "0.5.0"