adjacent-react 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,15 @@
+# Changelog
+
+## Unpublished
+
+### 🛠 Breaking changes
+
+### 🎉 New features
+
+### 🐛 Bug fixes
+
+### 💡 Others
+
+## 0.1.0 - 2026-08-29
+
+_This version does not introduce any user-facing changes._

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Eric Kweyunga
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,45 @@
+# adjacent-react
+
+Installation state and progressive web app runtime hooks for React.
+
+## Documentation
+
+- [Installation prompt](https://github.com/erickweyunga/adjacent-framework/blob/main/docs/install-prompt.md)
+- [Application lifecycle](https://github.com/erickweyunga/adjacent-framework/blob/main/docs/lifecycle.md)
+- [All the documentation](https://github.com/erickweyunga/adjacent-framework/blob/main/docs/README.md)
+
+## Installation
+
+```bash
+npm install adjacent-react
+```
+
+Most projects get this through the CLI instead, which installs and wires it up:
+
+```bash
+npx adjacent-cli init
+```
+
+Adjacent ships no install button. `useInstall()` reports whether the browser
+can prompt and which platform to write instructions for; `useAdjacent()` adds
+connectivity, service worker state, update activation, and cache control.
+`useMediaSession()` publishes what is playing to the lock screen, the OS media
+control and the hardware keys. `useAppBadge()` puts a count on the application
+icon, and `useNotifications()` covers permission and showing, with
+`subscribeToPush()` for messages that arrive when the app is closed. What any
+of it looks like is the application's decision.
+
+## Issues
+
+If you hit a problem using this package, please
+[report it here](https://github.com/erickweyunga/adjacent-framework/issues/new).
+
+## Contributing
+
+Issues and pull requests are welcome. Please read the
+[contributing guide](https://github.com/erickweyunga/adjacent-framework/blob/main/CONTRIBUTING.md)
+first.
+
+## License
+
+MIT

package/dist/badge/app-badge.d.ts

@@ -0,0 +1,36 @@
+/**
+ * What to show on the application's icon. A number shows a count, `"dot"`
+ * shows a mark with no number, and null or undefined removes the badge.
+ */
+export type AppBadgeValue = number | "dot" | null | undefined;
+/**
+ * Whether the icon can carry a badge. False on the server.
+ *
+ * Checked at runtime rather than trusted from the types: TypeScript's DOM
+ * library declares both methods unconditionally, and a browser without them is
+ * exactly the case this exists for.
+ */
+export declare function supportsAppBadge(): boolean;
+/**
+ * What to call for a value, since the API spells "no badge" three ways and
+ * "count of zero" is one of them: `setAppBadge(0)` clears rather than showing a
+ * zero, so a count that has fallen to nothing needs no special case at the call
+ * site.
+ */
+export declare function resolveBadgeCall(value: AppBadgeValue): {
+    readonly kind: "clear";
+} | {
+    readonly kind: "set";
+    readonly count?: number;
+};
+/**
+ * Puts a badge on the application's icon, or takes it off.
+ *
+ * Resolves false where the browser has no badging rather than throwing, since
+ * a badge is an enhancement and no application should branch on it. A browser
+ * that has the API and still refuses does throw, because that is a real fault.
+ */
+export declare function setAppBadge(value: AppBadgeValue): Promise<boolean>;
+/** Takes the badge off the icon. */
+export declare function clearAppBadge(): Promise<boolean>;
+//# sourceMappingURL=app-badge.d.ts.map

package/dist/badge/app-badge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-badge.d.ts","sourceRoot":"","sources":["../../src/badge/app-badge.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,KAAK,GAAG,IAAI,GAAG,SAAS,CAAC;AAE9D;;;;;;GAMG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,aAAa,GACnB;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAMhF;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CAWxE;AAED,oCAAoC;AACpC,wBAAgB,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,CAEhD"}

package/dist/badge/app-badge.js

@@ -0,0 +1,49 @@
+/**
+ * Whether the icon can carry a badge. False on the server.
+ *
+ * Checked at runtime rather than trusted from the types: TypeScript's DOM
+ * library declares both methods unconditionally, and a browser without them is
+ * exactly the case this exists for.
+ */
+export function supportsAppBadge() {
+    return typeof navigator !== "undefined" && typeof navigator.setAppBadge === "function";
+}
+/**
+ * What to call for a value, since the API spells "no badge" three ways and
+ * "count of zero" is one of them: `setAppBadge(0)` clears rather than showing a
+ * zero, so a count that has fallen to nothing needs no special case at the call
+ * site.
+ */
+export function resolveBadgeCall(value) {
+    if (value === null || value === undefined)
+        return { kind: "clear" };
+    if (value === "dot")
+        return { kind: "set" };
+    if (!Number.isFinite(value) || value <= 0)
+        return { kind: "clear" };
+    // Fractions are not a count, and the API floors them anyway.
+    return { kind: "set", count: Math.floor(value) };
+}
+/**
+ * Puts a badge on the application's icon, or takes it off.
+ *
+ * Resolves false where the browser has no badging rather than throwing, since
+ * a badge is an enhancement and no application should branch on it. A browser
+ * that has the API and still refuses does throw, because that is a real fault.
+ */
+export async function setAppBadge(value) {
+    if (!supportsAppBadge())
+        return false;
+    const call = resolveBadgeCall(value);
+    if (call.kind === "clear") {
+        await navigator.clearAppBadge();
+        return true;
+    }
+    await navigator.setAppBadge(call.count);
+    return true;
+}
+/** Takes the badge off the icon. */
+export function clearAppBadge() {
+    return setAppBadge(null);
+}
+//# sourceMappingURL=app-badge.js.map

package/dist/badge/app-badge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-badge.js","sourceRoot":"","sources":["../../src/badge/app-badge.ts"],"names":[],"mappings":"AAMA;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,OAAO,SAAS,KAAK,WAAW,IAAI,OAAO,SAAS,CAAC,WAAW,KAAK,UAAU,CAAC;AACzF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAoB;IAEpB,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IACpE,IAAI,KAAK,KAAK,KAAK;QAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAC5C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IACpE,6DAA6D;IAC7D,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;AACnD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,KAAoB;IACpD,IAAI,CAAC,gBAAgB,EAAE;QAAE,OAAO,KAAK,CAAC;IACtC,MAAM,IAAI,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAErC,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC1B,MAAM,SAAS,CAAC,aAAa,EAAE,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACxC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,oCAAoC;AACpC,MAAM,UAAU,aAAa;IAC3B,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC"}

package/dist/badge/use-app-badge.d.ts

@@ -0,0 +1,12 @@
+import { type AppBadgeValue } from "./app-badge.js";
+/**
+ * Keeps the application icon's badge in step with a value, so the badge is
+ * described rather than pushed: render with three unread and the icon says
+ * three, render with none and it clears.
+ *
+ * The badge is not cleared when the component unmounts. It belongs to the
+ * installed application rather than to a screen, and a count that survives the
+ * app being closed is the entire point of it.
+ */
+export declare function useAppBadge(value: AppBadgeValue): void;
+//# sourceMappingURL=use-app-badge.d.ts.map

package/dist/badge/use-app-badge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-app-badge.d.ts","sourceRoot":"","sources":["../../src/badge/use-app-badge.ts"],"names":[],"mappings":"AAIA,OAAO,EAAe,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEjE;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAMtD"}

package/dist/badge/use-app-badge.js

@@ -0,0 +1,20 @@
+"use client";
+import { useEffect } from "react";
+import { setAppBadge } from "./app-badge.js";
+/**
+ * Keeps the application icon's badge in step with a value, so the badge is
+ * described rather than pushed: render with three unread and the icon says
+ * three, render with none and it clears.
+ *
+ * The badge is not cleared when the component unmounts. It belongs to the
+ * installed application rather than to a screen, and a count that survives the
+ * app being closed is the entire point of it.
+ */
+export function useAppBadge(value) {
+    useEffect(() => {
+        // Rejections are swallowed: a badge is an enhancement, and a host that
+        // refuses one must not take the render down with it.
+        void setAppBadge(value).catch(() => undefined);
+    }, [value]);
+}
+//# sourceMappingURL=use-app-badge.js.map

package/dist/badge/use-app-badge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-app-badge.js","sourceRoot":"","sources":["../../src/badge/use-app-badge.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAElC,OAAO,EAAE,WAAW,EAAsB,MAAM,gBAAgB,CAAC;AAEjE;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CAAC,KAAoB;IAC9C,SAAS,CAAC,GAAG,EAAE;QACb,uEAAuE;QACvE,qDAAqD;QACrD,KAAK,WAAW,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IACjD,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;AACd,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export { clearAppBadge, resolveBadgeCall, setAppBadge, supportsAppBadge, type AppBadgeValue, } from "./badge/app-badge.js";
+export { useAppBadge } from "./badge/use-app-badge.js";
+export { Install, supportsInstallElement, type InstallProps } from "./install/install-element.js";
+export { detectManualInstallPlatform, type InstallOutcome, type InstallState, type ManualInstallPlatform, } from "./install/install-store.js";
+export { useInstall, type UseInstallResult } from "./install/use-install.js";
+export { supportsMediaSession, toMetadataInit, toPositionState, type MediaSessionActionName, type MediaSessionArtwork, type MediaSessionMetadata, type MediaSessionPlaybackState, type MediaSessionPosition, } from "./media/media-session.js";
+export { canRequestNotificationPermission, readNotificationPermission, requestNotificationPermission, showNotification, supportsNotifications, type NotificationAction, type NotificationPermissionState, type ShowNotificationOptions, } from "./notifications/notifications.js";
+export { decodeVapidKey, getPushSubscription, subscribeToPush, supportsPush, unsubscribeFromPush, } from "./notifications/push.js";
+export { useNotifications, type UseNotificationsResult, } from "./notifications/use-notifications.js";
+export { useMediaSession, type MediaSessionHandlers, type UseMediaSessionOptions, } from "./media/use-media-session.js";
+export { type AdjacentRuntimeSnapshot, type ConnectivityState, type ServiceWorkerState, } from "./runtime/runtime-store.js";
+export { useAdjacent, type UseAdjacentResult } from "./runtime/use-adjacent.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAChB,KAAK,aAAa,GACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,sBAAsB,EAAE,KAAK,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAClG,OAAO,EACL,2BAA2B,EAC3B,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,qBAAqB,GAC3B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,KAAK,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC7E,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,EAC9B,KAAK,oBAAoB,GAC1B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,gCAAgC,EAChC,0BAA0B,EAC1B,6BAA6B,EAC7B,gBAAgB,EAChB,qBAAqB,EACrB,KAAK,kBAAkB,EACvB,KAAK,2BAA2B,EAChC,KAAK,uBAAuB,GAC7B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,YAAY,EACZ,mBAAmB,GACpB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,gBAAgB,EAChB,KAAK,sBAAsB,GAC5B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,eAAe,EACf,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,GAC5B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,GACxB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,KAAK,iBAAiB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+export { clearAppBadge, resolveBadgeCall, setAppBadge, supportsAppBadge, } from "./badge/app-badge.js";
+export { useAppBadge } from "./badge/use-app-badge.js";
+export { Install, supportsInstallElement } from "./install/install-element.js";
+export { detectManualInstallPlatform, } from "./install/install-store.js";
+export { useInstall } from "./install/use-install.js";
+export { supportsMediaSession, toMetadataInit, toPositionState, } from "./media/media-session.js";
+export { canRequestNotificationPermission, readNotificationPermission, requestNotificationPermission, showNotification, supportsNotifications, } from "./notifications/notifications.js";
+export { decodeVapidKey, getPushSubscription, subscribeToPush, supportsPush, unsubscribeFromPush, } from "./notifications/push.js";
+export { useNotifications, } from "./notifications/use-notifications.js";
+export { useMediaSession, } from "./media/use-media-session.js";
+export { useAdjacent } from "./runtime/use-adjacent.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,gBAAgB,GAEjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,sBAAsB,EAAqB,MAAM,8BAA8B,CAAC;AAClG,OAAO,EACL,2BAA2B,GAI5B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,UAAU,EAAyB,MAAM,0BAA0B,CAAC;AAC7E,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,eAAe,GAMhB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,gCAAgC,EAChC,0BAA0B,EAC1B,6BAA6B,EAC7B,gBAAgB,EAChB,qBAAqB,GAItB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,YAAY,EACZ,mBAAmB,GACpB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,gBAAgB,GAEjB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,eAAe,GAGhB,MAAM,8BAA8B,CAAC;AAMtC,OAAO,EAAE,WAAW,EAA0B,MAAM,2BAA2B,CAAC"}

package/dist/install/install-element.d.ts

@@ -0,0 +1,19 @@
+import { type HTMLAttributes, type ReactNode } from "react";
+declare module "react" {
+    namespace JSX {
+        interface IntrinsicElements {
+            install: import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLElement>, HTMLElement> & {
+                readonly installurl?: string;
+                readonly manifestid?: string;
+            };
+        }
+    }
+}
+export interface InstallProps extends HTMLAttributes<HTMLElement> {
+    readonly children: ReactNode;
+    readonly installUrl?: string;
+    readonly manifestId?: string;
+}
+export declare function supportsInstallElement(browserWindow: Window): boolean;
+export declare function Install({ children, installUrl, manifestId, ...elementProps }: InstallProps): import("react").JSX.Element;
+//# sourceMappingURL=install-element.d.ts.map

package/dist/install/install-element.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-element.d.ts","sourceRoot":"","sources":["../../src/install/install-element.tsx"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,SAAS,EAGf,MAAM,OAAO,CAAC;AAEf,OAAO,QAAQ,OAAO,CAAC;IACrB,UAAU,GAAG,CAAC;QACZ,UAAU,iBAAiB;YAMzB,OAAO,EAAE,OAAO,OAAO,EAAE,iBAAiB,CACxC,OAAO,OAAO,EAAE,cAAc,CAAC,WAAW,CAAC,EAC3C,WAAW,CACZ,GAAG;gBACF,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;gBAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;aAC9B,CAAC;SACH;KACF;CACF;AAED,MAAM,WAAW,YAAa,SAAQ,cAAc,CAAC,WAAW,CAAC;IAC/D,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAErE;AAED,wBAAgB,OAAO,CAAC,EACtB,QAAQ,EACR,UAAU,EACV,UAAU,EACV,GAAG,YAAY,EAChB,EAAE,YAAY,+BAcd"}

package/dist/install/install-element.js

@@ -0,0 +1,16 @@
+"use client";
+import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
+import { useEffect, useState, } from "react";
+export function supportsInstallElement(browserWindow) {
+    return "HTMLInstallElement" in browserWindow;
+}
+export function Install({ children, installUrl, manifestId, ...elementProps }) {
+    const [isSupported, setIsSupported] = useState(false);
+    useEffect(() => {
+        setIsSupported(supportsInstallElement(window));
+    }, []);
+    if (!isSupported)
+        return _jsx(_Fragment, { children: children });
+    return (_jsx("install", { ...elementProps, installurl: installUrl, manifestid: manifestId, children: children }));
+}
+//# sourceMappingURL=install-element.js.map

package/dist/install/install-element.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-element.js","sourceRoot":"","sources":["../../src/install/install-element.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,EAGL,SAAS,EACT,QAAQ,GACT,MAAM,OAAO,CAAC;AA2Bf,MAAM,UAAU,sBAAsB,CAAC,aAAqB;IAC1D,OAAO,oBAAoB,IAAI,aAAa,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,EACtB,QAAQ,EACR,UAAU,EACV,UAAU,EACV,GAAG,YAAY,EACF;IACb,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAEtD,SAAS,CAAC,GAAG,EAAE;QACb,cAAc,CAAC,sBAAsB,CAAC,MAAM,CAAC,CAAC,CAAC;IACjD,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,IAAI,CAAC,WAAW;QAAE,OAAO,4BAAG,QAAQ,GAAI,CAAC;IAEzC,OAAO,CACL,qBAAa,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,YACtE,QAAQ,GACD,CACX,CAAC;AACJ,CAAC"}

package/dist/install/install-store.d.ts

@@ -0,0 +1,33 @@
+export type ManualInstallPlatform = "android" | "browser" | "ios" | "macos";
+export type InstallState = {
+    readonly status: "checking";
+} | {
+    readonly status: "available";
+} | {
+    readonly status: "manual";
+    readonly platform: ManualInstallPlatform;
+} | {
+    readonly status: "installed";
+} | {
+    readonly status: "unavailable";
+};
+export type InstallOutcome = "accepted" | "dismissed" | "manual" | "unavailable";
+type Listener = () => void;
+export declare function detectManualInstallPlatform(userAgent: string): ManualInstallPlatform;
+declare class InstallStore {
+    private deferredPrompt?;
+    private listening;
+    private readonly listeners;
+    private state;
+    readonly subscribe: (listener: Listener) => (() => void);
+    readonly getSnapshot: () => InstallState;
+    readonly getServerSnapshot: () => InstallState;
+    readonly prompt: () => Promise<InstallOutcome>;
+    private readonly onBeforeInstallPrompt;
+    private readonly onInstalled;
+    private start;
+    private setState;
+}
+export declare const installStore: InstallStore;
+export {};
+//# sourceMappingURL=install-store.d.ts.map

package/dist/install/install-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-store.d.ts","sourceRoot":"","sources":["../../src/install/install-store.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,qBAAqB,GAAG,SAAS,GAAG,SAAS,GAAG,KAAK,GAAG,OAAO,CAAC;AAE5E,MAAM,MAAM,YAAY,GACpB;IAAE,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;CAAE,GAC/B;IAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;CAAE,GAChC;IAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAA;CAAE,GACvE;IAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;CAAE,GAChC;IAAE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAA;CAAE,CAAC;AAEvC,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,GAAG,aAAa,CAAC;AAMjF,KAAK,QAAQ,GAAG,MAAM,IAAI,CAAC;AAc3B,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,MAAM,GAChB,qBAAqB,CAOvB;AAED,cAAM,YAAY;IAChB,OAAO,CAAC,cAAc,CAAC,CAA2B;IAClD,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuB;IACjD,OAAO,CAAC,KAAK,CAAwC;IAErD,QAAQ,CAAC,SAAS,GAAI,UAAU,QAAQ,KAAG,CAAC,MAAM,IAAI,CAAC,CAIrD;IAEF,QAAQ,CAAC,WAAW,QAAO,YAAY,CAAe;IAEtD,QAAQ,CAAC,iBAAiB,QAAO,YAAY,CAAiB;IAE9D,QAAQ,CAAC,MAAM,QAAa,OAAO,CAAC,cAAc,CAAC,CAkBjD;IAEF,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAIpC;IAEF,OAAO,CAAC,QAAQ,CAAC,WAAW,CAG1B;IAEF,OAAO,CAAC,KAAK;IAeb,OAAO,CAAC,QAAQ;CAIjB;AAED,eAAO,MAAM,YAAY,cAAqB,CAAC"}

package/dist/install/install-store.js

@@ -0,0 +1,74 @@
+const SERVER_STATE = { status: "checking" };
+function isStandalone() {
+    const navigatorWithStandalone = navigator;
+    return (window.matchMedia("(display-mode: standalone)").matches ||
+        navigatorWithStandalone.standalone === true);
+}
+export function detectManualInstallPlatform(userAgent) {
+    if (/iPad|iPhone|iPod/i.test(userAgent))
+        return "ios";
+    if (/Android/i.test(userAgent))
+        return "android";
+    if (/Macintosh/i.test(userAgent) && /Safari/i.test(userAgent) && !/Chrome|Chromium|Edg/i.test(userAgent)) {
+        return "macos";
+    }
+    return "browser";
+}
+class InstallStore {
+    deferredPrompt;
+    listening = false;
+    listeners = new Set();
+    state = { status: "checking" };
+    subscribe = (listener) => {
+        this.listeners.add(listener);
+        this.start();
+        return () => this.listeners.delete(listener);
+    };
+    getSnapshot = () => this.state;
+    getServerSnapshot = () => SERVER_STATE;
+    prompt = async () => {
+        if (this.state.status === "manual")
+            return "manual";
+        if (this.state.status !== "available" || !this.deferredPrompt) {
+            return "unavailable";
+        }
+        const prompt = this.deferredPrompt;
+        this.deferredPrompt = undefined;
+        const { outcome } = await prompt.prompt();
+        this.setState(outcome === "accepted"
+            ? { status: "installed" }
+            : {
+                platform: detectManualInstallPlatform(navigator.userAgent),
+                status: "manual",
+            });
+        return outcome;
+    };
+    onBeforeInstallPrompt = (event) => {
+        event.preventDefault();
+        this.deferredPrompt = event;
+        this.setState({ status: "available" });
+    };
+    onInstalled = () => {
+        this.deferredPrompt = undefined;
+        this.setState({ status: "installed" });
+    };
+    start() {
+        if (this.listening || typeof window === "undefined")
+            return;
+        this.listening = true;
+        if (isStandalone()) {
+            this.setState({ status: "installed" });
+            return;
+        }
+        const platform = detectManualInstallPlatform(navigator.userAgent);
+        this.setState({ status: "manual", platform });
+        window.addEventListener("beforeinstallprompt", this.onBeforeInstallPrompt);
+        window.addEventListener("appinstalled", this.onInstalled);
+    }
+    setState(state) {
+        this.state = state;
+        this.listeners.forEach((listener) => listener());
+    }
+}
+export const installStore = new InstallStore();
+//# sourceMappingURL=install-store.js.map

package/dist/install/install-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-store.js","sourceRoot":"","sources":["../../src/install/install-store.ts"],"names":[],"mappings":"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"}

package/dist/install/use-install.d.ts

@@ -0,0 +1,7 @@
+import { type InstallOutcome, type InstallState } from "./install-store.js";
+export interface UseInstallResult {
+    readonly install: () => Promise<InstallOutcome>;
+    readonly state: InstallState;
+}
+export declare function useInstall(): UseInstallResult;
+//# sourceMappingURL=use-install.d.ts.map

package/dist/install/use-install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-install.d.ts","sourceRoot":"","sources":["../../src/install/use-install.ts"],"names":[],"mappings":"AAIA,OAAO,EAAgB,KAAK,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE1F,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC;IAChD,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;CAC9B;AAED,wBAAgB,UAAU,IAAI,gBAAgB,CAQ7C"}

package/dist/install/use-install.js

@@ -0,0 +1,8 @@
+"use client";
+import { useSyncExternalStore } from "react";
+import { installStore } from "./install-store.js";
+export function useInstall() {
+    const state = useSyncExternalStore(installStore.subscribe, installStore.getSnapshot, installStore.getServerSnapshot);
+    return { install: installStore.prompt, state };
+}
+//# sourceMappingURL=use-install.js.map

package/dist/install/use-install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-install.js","sourceRoot":"","sources":["../../src/install/use-install.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAE7C,OAAO,EAAE,YAAY,EAA0C,MAAM,oBAAoB,CAAC;AAO1F,MAAM,UAAU,UAAU;IACxB,MAAM,KAAK,GAAG,oBAAoB,CAChC,YAAY,CAAC,SAAS,EACtB,YAAY,CAAC,WAAW,EACxB,YAAY,CAAC,iBAAiB,CAC/B,CAAC;IAEF,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;AACjD,CAAC"}

package/dist/media/media-session.d.ts

@@ -0,0 +1,38 @@
+/** The actions a host can offer, in the order a media control usually shows them. */
+export type MediaSessionActionName = "nexttrack" | "pause" | "play" | "previoustrack" | "seekbackward" | "seekforward" | "seekto" | "stop";
+export type MediaSessionPlaybackState = "none" | "paused" | "playing";
+export interface MediaSessionArtwork {
+    readonly sizes?: string;
+    readonly src: string;
+    readonly type?: string;
+}
+export interface MediaSessionMetadata {
+    readonly album?: string;
+    readonly artist?: string;
+    /**
+     * What the lock screen and the OS media control show. Several sizes let the
+     * host pick rather than scale one.
+     */
+    readonly artwork?: readonly MediaSessionArtwork[];
+    readonly title: string;
+}
+export interface MediaSessionPosition {
+    /** Seconds. An element that has not loaded its metadata reports NaN here. */
+    readonly duration: number;
+    readonly playbackRate?: number;
+    readonly position?: number;
+}
+/** Whether this browser has the API at all. False on the server. */
+export declare function supportsMediaSession(): boolean;
+export declare function toMetadataInit(metadata: MediaSessionMetadata): MediaMetadataInit;
+/**
+ * The position a host can actually be told, or undefined when there is none.
+ *
+ * `setPositionState` throws rather than ignoring a value it dislikes, and the
+ * values it dislikes are the ones a media element produces normally: `duration`
+ * is NaN until metadata loads, and `currentTime` can overshoot the duration by
+ * a frame at the end of a track. Both would otherwise throw in a timeupdate
+ * handler, which is to say sixty times a second.
+ */
+export declare function toPositionState(position: MediaSessionPosition): MediaPositionState | undefined;
+//# sourceMappingURL=media-session.d.ts.map

package/dist/media/media-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-session.d.ts","sourceRoot":"","sources":["../../src/media/media-session.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,MAAM,MAAM,sBAAsB,GAC9B,WAAW,GACX,OAAO,GACP,MAAM,GACN,eAAe,GACf,cAAc,GACd,aAAa,GACb,QAAQ,GACR,MAAM,CAAC;AAEX,MAAM,MAAM,yBAAyB,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEtE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAClD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,6EAA6E;IAC7E,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,oEAAoE;AACpE,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,oBAAoB,GAAG,iBAAiB,CAWhF;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,oBAAoB,GAC7B,kBAAkB,GAAG,SAAS,CAehC"}

package/dist/media/media-session.js

@@ -0,0 +1,42 @@
+/** Whether this browser has the API at all. False on the server. */
+export function supportsMediaSession() {
+    return typeof navigator !== "undefined" && "mediaSession" in navigator;
+}
+export function toMetadataInit(metadata) {
+    return {
+        album: metadata.album ?? "",
+        artist: metadata.artist ?? "",
+        artwork: metadata.artwork?.map((image) => ({
+            sizes: image.sizes ?? "",
+            src: image.src,
+            type: image.type ?? "",
+        })) ?? [],
+        title: metadata.title,
+    };
+}
+/**
+ * The position a host can actually be told, or undefined when there is none.
+ *
+ * `setPositionState` throws rather than ignoring a value it dislikes, and the
+ * values it dislikes are the ones a media element produces normally: `duration`
+ * is NaN until metadata loads, and `currentTime` can overshoot the duration by
+ * a frame at the end of a track. Both would otherwise throw in a timeupdate
+ * handler, which is to say sixty times a second.
+ */
+export function toPositionState(position) {
+    const { duration } = position;
+    if (!Number.isFinite(duration) || duration < 0)
+        return undefined;
+    const rate = position.playbackRate;
+    return {
+        duration,
+        // Clamped rather than rejected: overshooting at the end of a track is
+        // ordinary, and refusing to report it would freeze the scrubber there.
+        position: Math.min(Math.max(position.position ?? 0, 0), duration),
+        // Zero is what a paused element reports on some browsers, and it throws.
+        ...(rate !== undefined && Number.isFinite(rate) && rate !== 0
+            ? { playbackRate: rate }
+            : null),
+    };
+}
+//# sourceMappingURL=media-session.js.map

package/dist/media/media-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-session.js","sourceRoot":"","sources":["../../src/media/media-session.ts"],"names":[],"mappings":"AAqCA,oEAAoE;AACpE,MAAM,UAAU,oBAAoB;IAClC,OAAO,OAAO,SAAS,KAAK,WAAW,IAAI,cAAc,IAAI,SAAS,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,QAA8B;IAC3D,OAAO;QACL,KAAK,EAAE,QAAQ,CAAC,KAAK,IAAI,EAAE;QAC3B,MAAM,EAAE,QAAQ,CAAC,MAAM,IAAI,EAAE;QAC7B,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACzC,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,EAAE;YACxB,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE;SACvB,CAAC,CAAC,IAAI,EAAE;QACT,KAAK,EAAE,QAAQ,CAAC,KAAK;KACtB,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAC7B,QAA8B;IAE9B,MAAM,EAAE,QAAQ,EAAE,GAAG,QAAQ,CAAC;IAC9B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAEjE,MAAM,IAAI,GAAG,QAAQ,CAAC,YAAY,CAAC;IACnC,OAAO;QACL,QAAQ;QACR,sEAAsE;QACtE,uEAAuE;QACvE,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,QAAQ,CAAC;QACjE,yEAAyE;QACzE,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC;YAC3D,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE;YACxB,CAAC,CAAC,IAAI,CAAC;KACV,CAAC;AACJ,CAAC"}

package/dist/media/use-media-session.d.ts

@@ -0,0 +1,24 @@
+import { type MediaSessionActionName, type MediaSessionMetadata, type MediaSessionPlaybackState, type MediaSessionPosition } from "./media-session.js";
+export type MediaSessionHandlers = Partial<Record<MediaSessionActionName, MediaSessionActionHandler>>;
+export interface UseMediaSessionOptions {
+    /**
+     * What the hardware keys, the lock screen and the OS media control call.
+     * Whatever is absent is left to the host, which then hides that control.
+     */
+    readonly actions?: MediaSessionHandlers;
+    /** Null clears what the host is showing, for a player with nothing loaded. */
+    readonly metadata?: MediaSessionMetadata | null;
+    readonly playbackState?: MediaSessionPlaybackState;
+    readonly position?: MediaSessionPosition | null;
+}
+/**
+ * Publishes what is playing to the operating system: the lock screen, the
+ * media control in a notification shade or menu bar, and the hardware keys on
+ * a keyboard or headset.
+ *
+ * It renders nothing and owns no audio. The application keeps its own element
+ * and its own state, and describes them here, which is the same division the
+ * rest of Adjacent uses.
+ */
+export declare function useMediaSession({ actions, metadata, playbackState, position, }: UseMediaSessionOptions): void;
+//# sourceMappingURL=use-media-session.d.ts.map

package/dist/media/use-media-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-media-session.d.ts","sourceRoot":"","sources":["../../src/media/use-media-session.ts"],"names":[],"mappings":"AAIA,OAAO,EAIL,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,EAC9B,KAAK,oBAAoB,EAC1B,MAAM,oBAAoB,CAAC;AAE5B,MAAM,MAAM,oBAAoB,GAAG,OAAO,CACxC,MAAM,CAAC,sBAAsB,EAAE,yBAAyB,CAAC,CAC1D,CAAC;AAEF,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,oBAAoB,CAAC;IACxC,8EAA8E;IAC9E,QAAQ,CAAC,QAAQ,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAChD,QAAQ,CAAC,aAAa,CAAC,EAAE,yBAAyB,CAAC;IACnD,QAAQ,CAAC,QAAQ,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;CACjD;AAaD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,EAC9B,OAAO,EACP,QAAQ,EACR,aAAa,EACb,QAAQ,GACT,EAAE,sBAAsB,GAAG,IAAI,CAmE/B"}