@palantir/pack.app.react 0.27.0

package/.turbo/turbo-lint.log

@@ -0,0 +1,4 @@
+
+> @palantir/pack.app.react@0.27.0 lint /home/runner/work/pack/pack/packages/app/react
+> eslint ./src && dprint check --config $(find-up dprint.json) --allow-no-files
+

package/.turbo/turbo-transpileBrowser.log

@@ -0,0 +1,5 @@
+
+> @palantir/pack.app.react@0.27.0 transpileBrowser /home/runner/work/pack/pack/packages/app/react
+> monorepo-transpile -f esm -m bundle -t browser
+
+👍

package/.turbo/turbo-transpileCjs.log

@@ -0,0 +1,5 @@
+
+> @palantir/pack.app.react@0.27.0 transpileCjs /home/runner/work/pack/pack/packages/app/react
+> monorepo-transpile -f cjs -m bundle -t node
+
+👍

package/.turbo/turbo-transpileEsm.log

@@ -0,0 +1,5 @@
+
+> @palantir/pack.app.react@0.27.0 transpileEsm /home/runner/work/pack/pack/packages/app/react
+> monorepo-transpile -f esm -m bundle -t node
+
+👍

package/.turbo/turbo-transpileTypes.log

@@ -0,0 +1,5 @@
+
+> @palantir/pack.app.react@0.27.0 transpileTypes /home/runner/work/pack/pack/packages/app/react
+> monorepo-transpile -f esm -m types -t node
+
+👍

package/.turbo/turbo-typecheck.log

@@ -0,0 +1,4 @@
+
+> @palantir/pack.app.react@0.27.0 typecheck /home/runner/work/pack/pack/packages/app/react
+> tsc --noEmit --emitDeclarationOnly false
+

package/LICENSE.txt

@@ -0,0 +1,13 @@
+Copyright 2025 Palantir Technologies, Inc.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -0,0 +1,36 @@
+# @palantir/pack.app.react
+
+React context utilities for PACK applications.
+
+## Usage
+
+Create a typed provider and hook next to the configured app. This preserves accessors added by
+`.withState()` for example, instead of narrowing the app back to the base `PackApp` type.
+
+```typescript
+import { initPackApp } from "@palantir/pack.app";
+import { createPackAppContext } from "@palantir/pack.app.react";
+
+export const app = initPackApp(client, options).withState().build();
+export const { PackAppProvider, usePackApp } = createPackAppContext(app);
+```
+
+If the app is created asynchronously, create the typed context first and pass the finished app to
+the provider:
+
+```tsx
+async function initializePackApp() {
+  // await any required setup
+  return initPackApp(client, options).withState().build();
+}
+
+type App = Awaited<ReturnType<typeof initializePackApp>>;
+
+export const { PackAppProvider, usePackApp } = createPackAppContext<App>();
+
+const app = await initializePackApp();
+
+<PackAppProvider value={app}>
+  <App />
+</PackAppProvider>;
+```

package/build/browser/index.js

@@ -0,0 +1,56 @@
+import { createContext, useContext, createElement } from 'react';
+
+// src/hooks/usePackApp.ts
+function createPackAppContext(app) {
+  const packContext = createContext(null);
+  const useTypedPackApp = createUsePackApp(packContext);
+  if (app == null) {
+    let PackAppValueProvider2 = function({
+      children,
+      value
+    }) {
+      return createElement(packContext.Provider, {
+        value
+      }, children);
+    };
+    return {
+      PackAppProvider: PackAppValueProvider2,
+      usePackApp: useTypedPackApp
+    };
+  }
+  const boundApp = app;
+  function BoundPackAppProvider({
+    children
+  }) {
+    return createElement(packContext.Provider, {
+      value: boundApp
+    }, children);
+  }
+  return {
+    PackAppProvider: BoundPackAppProvider,
+    usePackApp: useTypedPackApp
+  };
+}
+var PACK_CONTEXT = createContext(null);
+function usePackApp(throwOnMissing = true) {
+  const packApp = useContext(PACK_CONTEXT);
+  if (packApp == null && throwOnMissing) {
+    throw new Error("usePackApp must be used within a PackApp provider");
+  }
+  return packApp;
+}
+var PackAppProvider = PACK_CONTEXT.Provider;
+function createUsePackApp(packContext) {
+  function useTypedPackApp(throwOnMissing = true) {
+    const packApp = useContext(packContext);
+    if (packApp == null && throwOnMissing) {
+      throw new Error("usePackApp must be used within a PackApp provider");
+    }
+    return packApp;
+  }
+  return useTypedPackApp;
+}
+
+export { PackAppProvider, createPackAppContext, usePackApp };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/build/browser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/usePackApp.ts"],"names":["PackAppValueProvider"],"mappings":";;;AAuBO,SAAS,qBAAqB,GAAA,EAAK;AACxC,EAAA,MAAM,WAAA,GAAc,cAAc,IAAI,CAAA;AACtC,EAAA,MAAM,eAAA,GAAkB,iBAAiB,WAAW,CAAA;AACpD,EAAA,IAAI,OAAO,IAAA,EAAM;AACf,IAAA,IAASA,wBAAT,SAA8B;AAAA,MAC5B,QAAA;AAAA,MACA;AAAA,KACF,EAAG;AACD,MAAA,OAAO,aAAA,CAAc,YAAY,QAAA,EAAU;AAAA,QACzC;AAAA,SACC,QAAQ,CAAA;AAAA,IACb,CAAA;AACA,IAAA,OAAO;AAAA,MACL,eAAA,EAAiBA,qBAAAA;AAAA,MACjB,UAAA,EAAY;AAAA,KACd;AAAA,EACF;AACA,EAAA,MAAM,QAAA,GAAW,GAAA;AACjB,EAAA,SAAS,oBAAA,CAAqB;AAAA,IAC5B;AAAA,GACF,EAAG;AACD,IAAA,OAAO,aAAA,CAAc,YAAY,QAAA,EAAU;AAAA,MACzC,KAAA,EAAO;AAAA,OACN,QAAQ,CAAA;AAAA,EACb;AACA,EAAA,OAAO;AAAA,IACL,eAAA,EAAiB,oBAAA;AAAA,IACjB,UAAA,EAAY;AAAA,GACd;AACF;AACA,IAAM,YAAA,GAAe,cAAc,IAAI,CAAA;AAChC,SAAS,UAAA,CAAW,iBAAiB,IAAA,EAAM;AAChD,EAAA,MAAM,OAAA,GAAU,WAAW,YAAY,CAAA;AACvC,EAAA,IAAI,OAAA,IAAW,QAAQ,cAAA,EAAgB;AACrC,IAAA,MAAM,IAAI,MAAM,mDAAmD,CAAA;AAAA,EACrE;AACA,EAAA,OAAO,OAAA;AACT;AACO,IAAM,kBAAkB,YAAA,CAAa;AAC5C,SAAS,iBAAiB,WAAA,EAAa;AACrC,EAAA,SAAS,eAAA,CAAgB,iBAAiB,IAAA,EAAM;AAC9C,IAAA,MAAM,OAAA,GAAU,WAAW,WAAW,CAAA;AACtC,IAAA,IAAI,OAAA,IAAW,QAAQ,cAAA,EAAgB;AACrC,MAAA,MAAM,IAAI,MAAM,mDAAmD,CAAA;AAAA,IACrE;AACA,IAAA,OAAO,OAAA;AAAA,EACT;AACA,EAAA,OAAO,eAAA;AACT","file":"index.js","sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { createContext, createElement, useContext } from \"react\";\n\n/**\n * Creates a provider and hook that preserve all configured module accessor types.\n * Pass the app to bind it immediately, or specify its type when the app is created later.\n */\n\nexport function createPackAppContext(app) {\n  const packContext = createContext(null);\n  const useTypedPackApp = createUsePackApp(packContext);\n  if (app == null) {\n    function PackAppValueProvider({\n      children,\n      value\n    }) {\n      return createElement(packContext.Provider, {\n        value\n      }, children);\n    }\n    return {\n      PackAppProvider: PackAppValueProvider,\n      usePackApp: useTypedPackApp\n    };\n  }\n  const boundApp = app;\n  function BoundPackAppProvider({\n    children\n  }) {\n    return createElement(packContext.Provider, {\n      value: boundApp\n    }, children);\n  }\n  return {\n    PackAppProvider: BoundPackAppProvider,\n    usePackApp: useTypedPackApp\n  };\n}\nconst PACK_CONTEXT = createContext(null);\nexport function usePackApp(throwOnMissing = true) {\n  const packApp = useContext(PACK_CONTEXT);\n  if (packApp == null && throwOnMissing) {\n    throw new Error(\"usePackApp must be used within a PackApp provider\");\n  }\n  return packApp;\n}\nexport const PackAppProvider = PACK_CONTEXT.Provider;\nfunction createUsePackApp(packContext) {\n  function useTypedPackApp(throwOnMissing = true) {\n    const packApp = useContext(packContext);\n    if (packApp == null && throwOnMissing) {\n      throw new Error(\"usePackApp must be used within a PackApp provider\");\n    }\n    return packApp;\n  }\n  return useTypedPackApp;\n}"]}

package/build/cjs/index.cjs

@@ -0,0 +1,60 @@
+'use strict';
+
+var react = require('react');
+
+// src/hooks/usePackApp.ts
+function createPackAppContext(app) {
+  const packContext = react.createContext(null);
+  const useTypedPackApp = createUsePackApp(packContext);
+  if (app == null) {
+    let PackAppValueProvider2 = function({
+      children,
+      value
+    }) {
+      return react.createElement(packContext.Provider, {
+        value
+      }, children);
+    };
+    return {
+      PackAppProvider: PackAppValueProvider2,
+      usePackApp: useTypedPackApp
+    };
+  }
+  const boundApp = app;
+  function BoundPackAppProvider({
+    children
+  }) {
+    return react.createElement(packContext.Provider, {
+      value: boundApp
+    }, children);
+  }
+  return {
+    PackAppProvider: BoundPackAppProvider,
+    usePackApp: useTypedPackApp
+  };
+}
+var PACK_CONTEXT = react.createContext(null);
+function usePackApp(throwOnMissing = true) {
+  const packApp = react.useContext(PACK_CONTEXT);
+  if (packApp == null && throwOnMissing) {
+    throw new Error("usePackApp must be used within a PackApp provider");
+  }
+  return packApp;
+}
+var PackAppProvider = PACK_CONTEXT.Provider;
+function createUsePackApp(packContext) {
+  function useTypedPackApp(throwOnMissing = true) {
+    const packApp = react.useContext(packContext);
+    if (packApp == null && throwOnMissing) {
+      throw new Error("usePackApp must be used within a PackApp provider");
+    }
+    return packApp;
+  }
+  return useTypedPackApp;
+}
+
+exports.PackAppProvider = PackAppProvider;
+exports.createPackAppContext = createPackAppContext;
+exports.usePackApp = usePackApp;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/build/cjs/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/usePackApp.ts"],"names":["createContext","PackAppValueProvider","createElement","useContext"],"mappings":";;;;;AAuBO,SAAS,qBAAqB,GAAA,EAAK;AACxC,EAAA,MAAM,WAAA,GAAcA,oBAAc,IAAI,CAAA;AACtC,EAAA,MAAM,eAAA,GAAkB,iBAAiB,WAAW,CAAA;AACpD,EAAA,IAAI,OAAO,IAAA,EAAM;AACf,IAAA,IAASC,wBAAT,SAA8B;AAAA,MAC5B,QAAA;AAAA,MACA;AAAA,KACF,EAAG;AACD,MAAA,OAAOC,mBAAA,CAAc,YAAY,QAAA,EAAU;AAAA,QACzC;AAAA,SACC,QAAQ,CAAA;AAAA,IACb,CAAA;AACA,IAAA,OAAO;AAAA,MACL,eAAA,EAAiBD,qBAAAA;AAAA,MACjB,UAAA,EAAY;AAAA,KACd;AAAA,EACF;AACA,EAAA,MAAM,QAAA,GAAW,GAAA;AACjB,EAAA,SAAS,oBAAA,CAAqB;AAAA,IAC5B;AAAA,GACF,EAAG;AACD,IAAA,OAAOC,mBAAA,CAAc,YAAY,QAAA,EAAU;AAAA,MACzC,KAAA,EAAO;AAAA,OACN,QAAQ,CAAA;AAAA,EACb;AACA,EAAA,OAAO;AAAA,IACL,eAAA,EAAiB,oBAAA;AAAA,IACjB,UAAA,EAAY;AAAA,GACd;AACF;AACA,IAAM,YAAA,GAAeF,oBAAc,IAAI,CAAA;AAChC,SAAS,UAAA,CAAW,iBAAiB,IAAA,EAAM;AAChD,EAAA,MAAM,OAAA,GAAUG,iBAAW,YAAY,CAAA;AACvC,EAAA,IAAI,OAAA,IAAW,QAAQ,cAAA,EAAgB;AACrC,IAAA,MAAM,IAAI,MAAM,mDAAmD,CAAA;AAAA,EACrE;AACA,EAAA,OAAO,OAAA;AACT;AACO,IAAM,kBAAkB,YAAA,CAAa;AAC5C,SAAS,iBAAiB,WAAA,EAAa;AACrC,EAAA,SAAS,eAAA,CAAgB,iBAAiB,IAAA,EAAM;AAC9C,IAAA,MAAM,OAAA,GAAUA,iBAAW,WAAW,CAAA;AACtC,IAAA,IAAI,OAAA,IAAW,QAAQ,cAAA,EAAgB;AACrC,MAAA,MAAM,IAAI,MAAM,mDAAmD,CAAA;AAAA,IACrE;AACA,IAAA,OAAO,OAAA;AAAA,EACT;AACA,EAAA,OAAO,eAAA;AACT","file":"index.cjs","sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { createContext, createElement, useContext } from \"react\";\n\n/**\n * Creates a provider and hook that preserve all configured module accessor types.\n * Pass the app to bind it immediately, or specify its type when the app is created later.\n */\n\nexport function createPackAppContext(app) {\n  const packContext = createContext(null);\n  const useTypedPackApp = createUsePackApp(packContext);\n  if (app == null) {\n    function PackAppValueProvider({\n      children,\n      value\n    }) {\n      return createElement(packContext.Provider, {\n        value\n      }, children);\n    }\n    return {\n      PackAppProvider: PackAppValueProvider,\n      usePackApp: useTypedPackApp\n    };\n  }\n  const boundApp = app;\n  function BoundPackAppProvider({\n    children\n  }) {\n    return createElement(packContext.Provider, {\n      value: boundApp\n    }, children);\n  }\n  return {\n    PackAppProvider: BoundPackAppProvider,\n    usePackApp: useTypedPackApp\n  };\n}\nconst PACK_CONTEXT = createContext(null);\nexport function usePackApp(throwOnMissing = true) {\n  const packApp = useContext(PACK_CONTEXT);\n  if (packApp == null && throwOnMissing) {\n    throw new Error(\"usePackApp must be used within a PackApp provider\");\n  }\n  return packApp;\n}\nexport const PackAppProvider = PACK_CONTEXT.Provider;\nfunction createUsePackApp(packContext) {\n  function useTypedPackApp(throwOnMissing = true) {\n    const packApp = useContext(packContext);\n    if (packApp == null && throwOnMissing) {\n      throw new Error(\"usePackApp must be used within a PackApp provider\");\n    }\n    return packApp;\n  }\n  return useTypedPackApp;\n}"]}

package/build/cjs/index.d.cts

@@ -0,0 +1,30 @@
+import { PackApp } from '@palantir/pack.core';
+import { PropsWithChildren, ReactElement } from 'react';
+
+interface UsePackApp<TApp extends PackApp> {
+    (): TApp;
+    (throwOnMissing: true): TApp;
+    (throwOnMissing: false): TApp | null;
+}
+interface BoundPackAppContext<TApp extends PackApp> {
+    readonly PackAppProvider: (props: PropsWithChildren) => ReactElement;
+    readonly usePackApp: UsePackApp<TApp>;
+}
+interface PackAppContext<TApp extends PackApp> {
+    readonly PackAppProvider: (props: PropsWithChildren<{
+        readonly value: TApp;
+    }>) => ReactElement;
+    readonly usePackApp: UsePackApp<TApp>;
+}
+/**
+ * Creates a provider and hook that preserve all configured module accessor types.
+ * Pass the app to bind it immediately, or specify its type when the app is created later.
+ */
+declare function createPackAppContext<TApp extends PackApp>(): PackAppContext<TApp>;
+declare function createPackAppContext<TApp extends PackApp>(app: TApp): BoundPackAppContext<TApp>;
+declare function usePackApp(): PackApp;
+declare function usePackApp(throwOnMissing: true): PackApp;
+declare function usePackApp(throwOnMissing: false): PackApp | null;
+declare const PackAppProvider: React.Provider<PackApp | null>;
+
+export { type BoundPackAppContext, type PackAppContext, PackAppProvider, type UsePackApp, createPackAppContext, usePackApp };

package/build/esm/index.js

@@ -0,0 +1,56 @@
+import { createContext, useContext, createElement } from 'react';
+
+// src/hooks/usePackApp.ts
+function createPackAppContext(app) {
+  const packContext = createContext(null);
+  const useTypedPackApp = createUsePackApp(packContext);
+  if (app == null) {
+    let PackAppValueProvider2 = function({
+      children,
+      value
+    }) {
+      return createElement(packContext.Provider, {
+        value
+      }, children);
+    };
+    return {
+      PackAppProvider: PackAppValueProvider2,
+      usePackApp: useTypedPackApp
+    };
+  }
+  const boundApp = app;
+  function BoundPackAppProvider({
+    children
+  }) {
+    return createElement(packContext.Provider, {
+      value: boundApp
+    }, children);
+  }
+  return {
+    PackAppProvider: BoundPackAppProvider,
+    usePackApp: useTypedPackApp
+  };
+}
+var PACK_CONTEXT = createContext(null);
+function usePackApp(throwOnMissing = true) {
+  const packApp = useContext(PACK_CONTEXT);
+  if (packApp == null && throwOnMissing) {
+    throw new Error("usePackApp must be used within a PackApp provider");
+  }
+  return packApp;
+}
+var PackAppProvider = PACK_CONTEXT.Provider;
+function createUsePackApp(packContext) {
+  function useTypedPackApp(throwOnMissing = true) {
+    const packApp = useContext(packContext);
+    if (packApp == null && throwOnMissing) {
+      throw new Error("usePackApp must be used within a PackApp provider");
+    }
+    return packApp;
+  }
+  return useTypedPackApp;
+}
+
+export { PackAppProvider, createPackAppContext, usePackApp };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/build/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/usePackApp.ts"],"names":["PackAppValueProvider"],"mappings":";;;AAuBO,SAAS,qBAAqB,GAAA,EAAK;AACxC,EAAA,MAAM,WAAA,GAAc,cAAc,IAAI,CAAA;AACtC,EAAA,MAAM,eAAA,GAAkB,iBAAiB,WAAW,CAAA;AACpD,EAAA,IAAI,OAAO,IAAA,EAAM;AACf,IAAA,IAASA,wBAAT,SAA8B;AAAA,MAC5B,QAAA;AAAA,MACA;AAAA,KACF,EAAG;AACD,MAAA,OAAO,aAAA,CAAc,YAAY,QAAA,EAAU;AAAA,QACzC;AAAA,SACC,QAAQ,CAAA;AAAA,IACb,CAAA;AACA,IAAA,OAAO;AAAA,MACL,eAAA,EAAiBA,qBAAAA;AAAA,MACjB,UAAA,EAAY;AAAA,KACd;AAAA,EACF;AACA,EAAA,MAAM,QAAA,GAAW,GAAA;AACjB,EAAA,SAAS,oBAAA,CAAqB;AAAA,IAC5B;AAAA,GACF,EAAG;AACD,IAAA,OAAO,aAAA,CAAc,YAAY,QAAA,EAAU;AAAA,MACzC,KAAA,EAAO;AAAA,OACN,QAAQ,CAAA;AAAA,EACb;AACA,EAAA,OAAO;AAAA,IACL,eAAA,EAAiB,oBAAA;AAAA,IACjB,UAAA,EAAY;AAAA,GACd;AACF;AACA,IAAM,YAAA,GAAe,cAAc,IAAI,CAAA;AAChC,SAAS,UAAA,CAAW,iBAAiB,IAAA,EAAM;AAChD,EAAA,MAAM,OAAA,GAAU,WAAW,YAAY,CAAA;AACvC,EAAA,IAAI,OAAA,IAAW,QAAQ,cAAA,EAAgB;AACrC,IAAA,MAAM,IAAI,MAAM,mDAAmD,CAAA;AAAA,EACrE;AACA,EAAA,OAAO,OAAA;AACT;AACO,IAAM,kBAAkB,YAAA,CAAa;AAC5C,SAAS,iBAAiB,WAAA,EAAa;AACrC,EAAA,SAAS,eAAA,CAAgB,iBAAiB,IAAA,EAAM;AAC9C,IAAA,MAAM,OAAA,GAAU,WAAW,WAAW,CAAA;AACtC,IAAA,IAAI,OAAA,IAAW,QAAQ,cAAA,EAAgB;AACrC,MAAA,MAAM,IAAI,MAAM,mDAAmD,CAAA;AAAA,IACrE;AACA,IAAA,OAAO,OAAA;AAAA,EACT;AACA,EAAA,OAAO,eAAA;AACT","file":"index.js","sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { createContext, createElement, useContext } from \"react\";\n\n/**\n * Creates a provider and hook that preserve all configured module accessor types.\n * Pass the app to bind it immediately, or specify its type when the app is created later.\n */\n\nexport function createPackAppContext(app) {\n  const packContext = createContext(null);\n  const useTypedPackApp = createUsePackApp(packContext);\n  if (app == null) {\n    function PackAppValueProvider({\n      children,\n      value\n    }) {\n      return createElement(packContext.Provider, {\n        value\n      }, children);\n    }\n    return {\n      PackAppProvider: PackAppValueProvider,\n      usePackApp: useTypedPackApp\n    };\n  }\n  const boundApp = app;\n  function BoundPackAppProvider({\n    children\n  }) {\n    return createElement(packContext.Provider, {\n      value: boundApp\n    }, children);\n  }\n  return {\n    PackAppProvider: BoundPackAppProvider,\n    usePackApp: useTypedPackApp\n  };\n}\nconst PACK_CONTEXT = createContext(null);\nexport function usePackApp(throwOnMissing = true) {\n  const packApp = useContext(PACK_CONTEXT);\n  if (packApp == null && throwOnMissing) {\n    throw new Error(\"usePackApp must be used within a PackApp provider\");\n  }\n  return packApp;\n}\nexport const PackAppProvider = PACK_CONTEXT.Provider;\nfunction createUsePackApp(packContext) {\n  function useTypedPackApp(throwOnMissing = true) {\n    const packApp = useContext(packContext);\n    if (packApp == null && throwOnMissing) {\n      throw new Error(\"usePackApp must be used within a PackApp provider\");\n    }\n    return packApp;\n  }\n  return useTypedPackApp;\n}"]}

package/build/types/__tests__/usePackApp.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/types/__tests__/usePackApp.test.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"","names":[],"sources":["../../../src/__tests__/usePackApp.test.tsx"],"version":3,"file":"usePackApp.test.d.ts"}

package/build/types/hooks/usePackApp.d.ts

@@ -0,0 +1,27 @@
+import type { PackApp } from "@palantir/pack.core";
+import type { PropsWithChildren, ReactElement } from "react";
+export interface UsePackApp<TApp extends PackApp> {
+	(): TApp;
+	(throwOnMissing: true): TApp;
+	(throwOnMissing: false): TApp | null;
+}
+export interface BoundPackAppContext<TApp extends PackApp> {
+	readonly PackAppProvider: (props: PropsWithChildren) => ReactElement;
+	readonly usePackApp: UsePackApp<TApp>;
+}
+export interface PackAppContext<TApp extends PackApp> {
+	readonly PackAppProvider: (props: PropsWithChildren<{
+		readonly value: TApp;
+	}>) => ReactElement;
+	readonly usePackApp: UsePackApp<TApp>;
+}
+/**
+* Creates a provider and hook that preserve all configured module accessor types.
+* Pass the app to bind it immediately, or specify its type when the app is created later.
+*/
+export declare function createPackAppContext<TApp extends PackApp>(): PackAppContext<TApp>;
+export declare function createPackAppContext<TApp extends PackApp>(app: TApp): BoundPackAppContext<TApp>;
+export declare function usePackApp(): PackApp;
+export declare function usePackApp(throwOnMissing: true): PackApp;
+export declare function usePackApp(throwOnMissing: false): PackApp | null;
+export declare const PackAppProvider: React.Provider<PackApp | null>;

package/build/types/hooks/usePackApp.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAgBA,cAAc,eAAe;AAC7B,cAAuB,mBAAmB,oBAAoB;AAG9D,iBAAiB,WAAW,aAAa,SAAS;KAC5C;EACH,gBAAgB,OAAO;EACvB,gBAAgB,QAAQ;;AAG3B,iBAAiB,oBAAoB,aAAa,SAAS;UAChD,kBAAkB,OAAO,sBAAsB;UAC/C,YAAY,WAAW;;AAGlC,iBAAiB,eAAe,aAAa,SAAS;UAC3C,kBACP,OAAO,kBAAkB;WAAW,OAAO;QACxC;UACI,YAAY,WAAW;;;;;;AAOlC,OAAO,iBAAS,qBAAqB,aAAa,YAAY,eAAe;AAC7E,OAAO,iBAAS,qBAAqB,aAAa,SAChD,KAAK,OACJ,oBAAoB;AAmCvB,OAAO,iBAAS,cAAc;AAC9B,OAAO,iBAAS,WAAW,gBAAgB,OAAO;AAClD,OAAO,iBAAS,WAAW,gBAAgB,QAAQ;AASnD,OAAO,cAAMA,iBAAiB,MAAM,SAAS","names":["PackAppProvider: React.Provider<PackApp | null>"],"sources":["../../../src/hooks/usePackApp.ts"],"version":3,"file":"usePackApp.d.ts"}

package/build/types/index.d.ts

@@ -0,0 +1,2 @@
+export { createPackAppContext, PackAppProvider, usePackApp } from "./hooks/usePackApp.js";
+export type { BoundPackAppContext, PackAppContext, UsePackApp } from "./hooks/usePackApp.js";

package/build/types/index.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAgBA,SAAS,sBAAsB,iBAAiB,kBAAkB;AAClE,cAAc,qBAAqB,gBAAgB,kBAAkB","names":[],"sources":["../../src/index.ts"],"version":3,"file":"index.d.ts"}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@palantir/pack.app.react",
+  "version": "0.27.0",
+  "description": "React bindings for PACK applications",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/palantir/pack.git"
+  },
+  "exports": {
+    ".": {
+      "browser": "./build/browser/index.js",
+      "import": {
+        "types": "./build/types/index.d.ts",
+        "default": "./build/esm/index.js"
+      },
+      "require": "./build/cjs/index.js",
+      "default": "./build/browser/index.js"
+    },
+    "./*": {
+      "browser": "./build/browser/public/*.js",
+      "import": {
+        "types": "./build/types/public/*.d.ts",
+        "default": "./build/js/public/*.js"
+      },
+      "require": "./build/cjs/public/*.js",
+      "default": "./build/browser/public/*.js"
+    }
+  },
+  "dependencies": {
+    "@palantir/pack.core": "0.27.0"
+  },
+  "peerDependencies": {
+    "react": "^17 || ^18 || ^19"
+  },
+  "devDependencies": {
+    "@testing-library/react": "^16.3.0",
+    "@types/react": "^18.3.18",
+    "@types/react-dom": "^18.3.5",
+    "happy-dom": "^20.0.11",
+    "react": "^18",
+    "react-dom": "^18",
+    "rimraf": "^6.1.2",
+    "tslib": "^2.8.1",
+    "typescript": "^5.9.3",
+    "vitest-mock-extended": "^3.1.0",
+    "@palantir/pack.monorepo.tsconfig": "~0.4.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "pack"
+  ],
+  "main": "./build/cjs/index.js",
+  "module": "./build/esm/index.js",
+  "types": "./build/cjs/index.d.ts",
+  "type": "module",
+  "scripts": {
+    "clean": "rimraf .turbo build dist lib test-output *.tgz tsconfig.tsbuildinfo",
+    "lint": "eslint ./src && dprint check --config $(find-up dprint.json) --allow-no-files",
+    "lint:fix": "eslint ./src --fix && dprint fmt --config $(find-up dprint.json) --allow-no-files",
+    "test": "vitest run --passWithNoTests -u",
+    "test:watch": "vitest --passWithNoTests",
+    "transpileBrowser": "monorepo-transpile -f esm -m bundle -t browser",
+    "transpileCjs": "monorepo-transpile -f cjs -m bundle -t node",
+    "transpileEsm": "monorepo-transpile -f esm -m bundle -t node",
+    "transpileTypes": "monorepo-transpile -f esm -m types -t node",
+    "typecheck": "tsc --noEmit --emitDeclarationOnly false"
+  }
+}

package/src/__tests__/usePackApp.test.tsx

@@ -0,0 +1,95 @@
+/*
+ * Copyright 2026 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import type { PackApp } from "@palantir/pack.core";
+import { renderHook } from "@testing-library/react";
+import type { PropsWithChildren } from "react";
+import { describe, expect, expectTypeOf, it } from "vitest";
+import { mockDeep } from "vitest-mock-extended";
+import { createPackAppContext, PackAppProvider, usePackApp } from "../index.js";
+
+interface TestModule {
+  readonly value: string;
+}
+
+type TestPackApp = PackApp & { readonly testModule: TestModule };
+
+describe("createPackAppContext", () => {
+  it("preserves the configured app type", () => {
+    const app: TestPackApp = mockDeep<TestPackApp>();
+    const { PackAppProvider, usePackApp } = createPackAppContext(app);
+
+    const { result } = renderHook(() => usePackApp(), { wrapper: PackAppProvider });
+
+    expect(result.current).toBe(app);
+    expectTypeOf(result.current.testModule).toEqualTypeOf<TestModule>();
+  });
+
+  it("throws when its provider is missing", () => {
+    const app: TestPackApp = mockDeep<TestPackApp>();
+    const { usePackApp } = createPackAppContext(app);
+
+    expect(() => renderHook(() => usePackApp())).toThrow(
+      "usePackApp must be used within a PackApp provider",
+    );
+  });
+
+  it("returns null when a missing provider is allowed", () => {
+    const app: TestPackApp = mockDeep<TestPackApp>();
+    const { usePackApp } = createPackAppContext(app);
+
+    const { result } = renderHook(() => usePackApp(false));
+
+    expectTypeOf(result.current).toEqualTypeOf<TestPackApp | null>();
+    expect(result.current).toBeNull();
+  });
+
+  it("preserves an explicit app type when the app is created later", () => {
+    const app: TestPackApp = mockDeep<TestPackApp>();
+    const { PackAppProvider, usePackApp } = createPackAppContext<TestPackApp>();
+
+    function Wrapper({ children }: PropsWithChildren) {
+      return <PackAppProvider value={app}>{children}</PackAppProvider>;
+    }
+
+    const { result } = renderHook(() => usePackApp(), { wrapper: Wrapper });
+
+    expect(result.current).toBe(app);
+    expectTypeOf(result.current.testModule).toEqualTypeOf<TestModule>();
+  });
+});
+
+describe("default PackApp context", () => {
+  it("returns the required provided app", () => {
+    const app: PackApp = mockDeep<PackApp>();
+
+    function Wrapper({ children }: PropsWithChildren) {
+      return <PackAppProvider value={app}>{children}</PackAppProvider>;
+    }
+
+    const { result } = renderHook(() => usePackApp(true), { wrapper: Wrapper });
+
+    expectTypeOf(result.current).toEqualTypeOf<PackApp>();
+    expect(result.current).toBe(app);
+  });
+
+  it("returns null when a missing provider is allowed", () => {
+    const { result } = renderHook(() => usePackApp(false));
+
+    expectTypeOf(result.current).toEqualTypeOf<PackApp | null>();
+    expect(result.current).toBeNull();
+  });
+});

package/src/hooks/usePackApp.ts

@@ -0,0 +1,109 @@
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import type { PackApp } from "@palantir/pack.core";
+import type { Context, PropsWithChildren, ReactElement } from "react";
+import { createContext, createElement, useContext } from "react";
+
+export interface UsePackApp<TApp extends PackApp> {
+  (): TApp;
+  (throwOnMissing: true): TApp;
+  (throwOnMissing: false): TApp | null;
+}
+
+export interface BoundPackAppContext<TApp extends PackApp> {
+  readonly PackAppProvider: (props: PropsWithChildren) => ReactElement;
+  readonly usePackApp: UsePackApp<TApp>;
+}
+
+export interface PackAppContext<TApp extends PackApp> {
+  readonly PackAppProvider: (
+    props: PropsWithChildren<{ readonly value: TApp }>,
+  ) => ReactElement;
+  readonly usePackApp: UsePackApp<TApp>;
+}
+
+/**
+ * Creates a provider and hook that preserve all configured module accessor types.
+ * Pass the app to bind it immediately, or specify its type when the app is created later.
+ */
+export function createPackAppContext<TApp extends PackApp>(): PackAppContext<TApp>;
+export function createPackAppContext<TApp extends PackApp>(
+  app: TApp,
+): BoundPackAppContext<TApp>;
+export function createPackAppContext<TApp extends PackApp>(
+  app?: TApp,
+): BoundPackAppContext<TApp> | PackAppContext<TApp> {
+  const packContext = createContext<TApp | null>(null);
+  const useTypedPackApp = createUsePackApp(packContext);
+
+  if (app == null) {
+    function PackAppValueProvider({
+      children,
+      value,
+    }: PropsWithChildren<{ readonly value: TApp }>): ReactElement {
+      return createElement(packContext.Provider, { value }, children);
+    }
+
+    return {
+      PackAppProvider: PackAppValueProvider,
+      usePackApp: useTypedPackApp,
+    };
+  }
+
+  const boundApp = app;
+
+  function BoundPackAppProvider({ children }: PropsWithChildren): ReactElement {
+    return createElement(packContext.Provider, { value: boundApp }, children);
+  }
+
+  return {
+    PackAppProvider: BoundPackAppProvider,
+    usePackApp: useTypedPackApp,
+  };
+}
+
+const PACK_CONTEXT = createContext<PackApp | null>(null);
+
+export function usePackApp(): PackApp;
+export function usePackApp(throwOnMissing: true): PackApp;
+export function usePackApp(throwOnMissing: false): PackApp | null;
+export function usePackApp(throwOnMissing = true): PackApp | null {
+  const packApp = useContext(PACK_CONTEXT);
+  if (packApp == null && throwOnMissing) {
+    throw new Error("usePackApp must be used within a PackApp provider");
+  }
+  return packApp;
+}
+
+export const PackAppProvider: React.Provider<PackApp | null> = PACK_CONTEXT.Provider;
+
+function createUsePackApp<TApp extends PackApp>(
+  packContext: Context<TApp | null>,
+): UsePackApp<TApp> {
+  function useTypedPackApp(): TApp;
+  function useTypedPackApp(throwOnMissing: true): TApp;
+  function useTypedPackApp(throwOnMissing: false): TApp | null;
+  function useTypedPackApp(throwOnMissing = true): TApp | null {
+    const packApp = useContext(packContext);
+    if (packApp == null && throwOnMissing) {
+      throw new Error("usePackApp must be used within a PackApp provider");
+    }
+    return packApp;
+  }
+
+  return useTypedPackApp;
+}

package/src/index.ts

@@ -0,0 +1,18 @@
+/*
+ * Copyright 2026 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+export { createPackAppContext, PackAppProvider, usePackApp } from "./hooks/usePackApp.js";
+export type { BoundPackAppContext, PackAppContext, UsePackApp } from "./hooks/usePackApp.js";

package/tsconfig.json

@@ -0,0 +1,21 @@
+{
+  "extends": "@palantir/pack.monorepo.tsconfig/base.json",
+  "compilerOptions": {
+    "outDir": "./build/esm",
+    "rootDir": "./src",
+    "declarationDir": "./build/types",
+    "tsBuildInfoFile": "./build/tsconfig.tsbuildinfo"
+  },
+  "include": [
+    "src/**/*"
+  ],
+  "exclude": [
+    "build",
+    "dist",
+    "node_modules",
+    "test-output",
+    "**/__tests__/**/__snapshots__",
+    "**/__tests__/**/fixtures"
+  ],
+  "references": []
+}

package/vitest.config.mjs

@@ -0,0 +1,28 @@
+import { coverageConfigDefaults, defaultExclude, defineProject } from "vitest/config";
+
+export default defineProject({
+  test: {
+    environment: "happy-dom",
+    exclude: [...defaultExclude, "**/build/**", "**/test-output/**"],
+    setupFiles: ["./vitest.setup.ts"],
+    coverage: {
+      provider: "v8",
+      all: true,
+      enabled: true,
+      pool: "forks",
+      include: ["src/**/*.{ts,tsx}"],
+      exclude: [
+        ...coverageConfigDefaults.exclude,
+        "**/*.test.{ts,tsx}",
+        "**/__tests__",
+        "build",
+        "coverage",
+        "dist",
+        "node_modules",
+        "src/index.ts",
+        "test-output",
+        "vitest.config.*",
+      ],
+    },
+  },
+});

package/vitest.setup.ts

@@ -0,0 +1,2 @@
+// Vitest setup file
+// Add test setup code here if needed