@marinoscar/platform-web 0.0.0-stage → 0.1.0-next.3

package/CHANGELOG.md

@@ -0,0 +1,42 @@
+# @marinoscar/platform-web
+
+## 0.1.0-next.3
+
+### Minor Changes
+
+- 55a3402: Add the support bundle: `@marinoscar/platform-contract/doctor` (`supportBundleSchema`), `GET <doctor path>/support-bundle` with `SupportBundleRegistry`, `SupportBundleService`, redaction rules v1 and the built-in `meta`, `doctor` and `egress` sections in `@marinoscar/platform-api/doctor`, and the "Download support bundle" button and `useSupportBundleDownload` hook in `@marinoscar/platform-web/doctor` (plus the optional `PlatformApiClient.getBlob`).
+- bd9ad6f: Add the telemetry slice (`@marinoscar/platform-web/telemetry/headless`, `/telemetry/ui` and a subpath per page): the telemetry settings page, explorer and dashboard with their client, hooks, config provider, route guard, `TelemetryWebAdapters`, `telemetryAdminCards` and the `withTelemetryTokens` theme-token contract. `PlatformApiClient` gains optional request options (`signal`, `ifMatch`), `postBlob` and `postSse`, and `PlatformApiError` an optional `details`; the test host answers all of them. The contract's telemetry README points at the web client's new home.
+
+### Patch Changes
+
+- Updated dependencies [738d71c]
+- Updated dependencies [55a3402]
+- Updated dependencies [bd9ad6f]
+  - @marinoscar/platform-contract@0.1.0-next.3
+
+## 0.1.0-next.2
+
+### Minor Changes
+
+- fd29180: Add `@marinoscar/platform-contract/doctor`, the first contract slice (#701): the Doctor's report, row, status and query schemas, their types and the zod-free status constants. `platform-api`'s Doctor DTOs now wrap these schemas and `platform-web`'s Doctor takes its types from them; both re-export the old names (`DOCTOR_STATUS_ORDER` and `DoctorReportQuery` in `platform-web` are deprecated aliases). No wire or OpenAPI change. Sets the contract conventions (slice layout, zod-free constants, import rules, `schema` catalog kind).
+
+### Patch Changes
+
+- Updated dependencies [fd29180]
+  - @marinoscar/platform-contract@0.1.0-next.2
+
+## 0.1.0-next.1
+
+## 0.1.0-next.0
+
+### Minor Changes
+
+- 385e12f: Add the Doctor slice (`@marinoscar/platform-api/doctor`, `@marinoscar/platform-web/doctor/headless` and `/doctor/ui`), host ports in `core` (`definePlatformHost`, `PlatformHostModule`, `PlatformHostProvider`, `PlatformApiClient`) and in-memory test hosts in `testing`.
+- a66fef1: First pre-release of the platform packages: the six-package scaffold (build formats, boundary lint, pack check, TSDoc and generated API reference, single-instance peer dependencies) plus the first slices.
+
+  - `@marinoscar/platform-api/core`: the typed registry primitive (`defineRegistry`, `Registry`, `RegistryError`, `RegistryFreezeService`, `withTemporaryEntries`).
+  - `@marinoscar/platform-api/testing`: the conformance harness (`runPlatformConformance`, `conformanceSuites`) with the `cron-enqueue-only` suite.
+  - `@marinoscar/platform-cli/core`: the CLI command and env-spec fragment registries.
+  - `@marinoscar/platform-cli/telemetry`: the node span relay and the telemetry env-spec fragment.
+  - `@marinoscar/platform-infra`: `infraFile()`, the `platform-infra` command (`sync` materialises fragments into an app) and the `telemetry` slice (collector and GreptimeDB compose fragments, collector config and overlay, typed manifest).
+  - `@marinoscar/platform-contract`, `@marinoscar/platform-web` and `@marinoscar/platform-db` ship their package scaffold only; their slices follow in later releases.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 marinoscar
+
+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

@@ -1,3 +1,97 @@
-# Temporary Holding Version
+# @marinoscar/platform-web
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The React side of the platform: pages, components and hooks built on MUI, exposed one subpath per slice. ESM with `sideEffects: false`; it loads in plain Node ESM as well as through a bundler.
+
+## Purpose and scope
+
+Pages, components, hooks and settings-page descriptors of the platform's web slices. It does not own the app's router, theme or settings registries; the app binds the package's descriptors into its own.
+
+Status: pre-release (version `0.0.0`). The root export is only the package name (`PLATFORM_PACKAGE`); the slices are subpath exports, each with its own README:
+
+- `@marinoscar/platform-web/core`: the web host ports every packaged page reuses (`PlatformHostProvider`, `PlatformApiClient`, `PlatformViewer`, `PlatformSettingsPage`). [README](src/core/README.md).
+- `@marinoscar/platform-web/testing`: test doubles for those ports (`createTestPlatformHost`). [README](src/testing/README.md).
+- `@marinoscar/platform-web/doctor/headless` and `@marinoscar/platform-web/doctor/ui`: the admin Doctor page, its hook and client, and its settings-page descriptor (#696). [README](src/doctor/README.md).
+- `@marinoscar/platform-web/telemetry/headless` and `@marinoscar/platform-web/telemetry/ui` (plus `/telemetry/ui/settings-page`, `/explorer-page`, `/dashboard-page`): the telemetry settings page, explorer and dashboard, their client, hooks, app adapters, admin cards and theme-token contract (#704). [README](src/telemetry/README.md).
+
+## Install and peer dependencies
+
+```bash
+npm install @marinoscar/platform-web
+```
+
+Install these in the app; the package never bundles its own copy (a second copy breaks dependency injection, hooks or theme context).
+
+| Package | Range |
+|---|---|
+| `@emotion/react` | `^11.14.0` |
+| `@emotion/styled` | `^11.14.1` |
+| `@mui/icons-material` | `^9.1.0` |
+| `@mui/material` | `^9.1.0` |
+| `react` | `^19.2.7` |
+| `react-dom` | `^19.2.7` |
+| `react-router-dom` | `^7.17.0` |
+
+Optional peers, needed only by `@marinoscar/platform-web/telemetry/ui` (#704): `@mui/x-charts` `^9.14.0`, `@mui/x-data-grid` `^9.10.1`, `@uiw/react-codemirror` `^4.25.12` and `@codemirror/lang-sql` `^6.10.0`.
+
+## Quick start
+
+Mount the app's host once, inside the auth provider, then register each packaged page as a card and a route (the reference app: [`platformHost.tsx`](../../apps/web/src/platform/platformHost.tsx), [`adminSections.tsx`](../../apps/web/src/config/adminSections.tsx)):
+
+```tsx
+<PlatformHostProvider host={host}><Layout /></PlatformHostProvider>
+
+// ADMIN_SECTIONS, appended last
+{ ...doctorSettingsPage.card, Icon: doctorSettingsPage.Icon },
+```
+
+See the [core README](src/core/README.md#registering-a-packaged-page-settings-ui-pattern).
+
+## Configuration
+
+None at the package level. `PlatformHostProvider`'s host is documented in the [core README](src/core/README.md#configuration), `DoctorPage`'s props in the [doctor README](src/doctor/README.md#configuration).
+
+## Extension-point catalog
+
+None. The root export is only the package name; the extension points live in the slice catalogs ([core](src/core/README.md#extension-point-catalog), [doctor](src/doctor/README.md#extension-point-catalog)).
+
+## Data
+
+None. The browser holds no data model; it reads and writes through the API.
+
+## Permissions and settings
+
+The Doctor's card and route require `system_settings:read`, the exact string `@marinoscar/platform-api/doctor` enforces ([README](src/doctor/README.md#permissions-and-settings)). Packaged pages check no permission themselves: the app's route gate does.
+
+## UI
+
+One page so far: the Doctor (`/admin/settings/doctor`), one admin registry card, one slot (`slots.Header`), and the theme tokens `palette.status.*` ([README](src/doctor/README.md#ui)).
+
+## Infra
+
+None. The package ships no deployment configuration and reads no environment variable.
+
+## Observability
+
+None. No slice logs or measures anything in the browser yet.
+
+## Security notes
+
+Pages never hold an API key and never call an AI provider from the browser; they call the API only through the app's transport (`PlatformApiClient`), and authorization stays in the API and the app's route gates.
+
+## Conformance suite
+
+None yet. The package ships no conformance suite; `runPlatformConformance()` and the suites arrive with the platform's conformance harness.
+
+## Upgrade notes
+
+None. No version has been published yet, so there is nothing to migrate from.
+
+## Troubleshooting
+
+None yet. Build and import problems common to every platform package are in [DEVELOPMENT.md § Platform packages](../../docs/DEVELOPMENT.md#platform-packages).
+
+## Links
+
+- [Platform packages spec](../../docs/specs/platform-packages.md): the extension contract and the package documentation standard
+- [Package documentation standard and checks](../../docs/PACKAGES.md): how this README, the TSDoc and the catalog are checked
+- [DEVELOPMENT.md § Platform packages](../../docs/DEVELOPMENT.md#platform-packages): build, test and lint commands

package/dist/core/api-client.d.ts

@@ -0,0 +1,112 @@
+/**
+ * The app's transport. Paths are relative to the API base (`'/admin/doctor'`);
+ * auth header, token refresh, maintenance handling stay in the app. Each method
+ * resolves to the response's `data` and rejects with a {@link PlatformApiError}
+ * when the API answered with an error status.
+ *
+ * @stability experimental
+ */
+export interface PlatformApiClient {
+    /** `GET path`. */
+    get<T>(path: string, options?: PlatformRequestOptions): Promise<T>;
+    /** `POST path` with an optional JSON body. */
+    post<T>(path: string, body?: unknown, options?: PlatformRequestOptions): Promise<T>;
+    /** `PUT path` with an optional JSON body; `ifMatch` becomes the `If-Match` header. */
+    put<T>(path: string, body?: unknown, options?: PlatformRequestOptions): Promise<T>;
+    /** `PATCH path` with an optional JSON body; `ifMatch` becomes the `If-Match` header. */
+    patch<T>(path: string, body?: unknown, options?: PlatformRequestOptions): Promise<T>;
+    /** `DELETE path`; `ifMatch` becomes the `If-Match` header. */
+    delete<T>(path: string, options?: PlatformRequestOptions): Promise<T>;
+    /**
+     * `GET path` for a file download: the raw body and the response headers
+     * (for `Content-Disposition`), never the `{ data }` envelope. Optional: a
+     * transport without it cannot serve downloads (the support bundle's
+     * `useSupportBundleDownload` reports so instead of failing silently).
+     */
+    getBlob?(path: string, options?: PlatformRequestOptions): Promise<PlatformBlobResponse>;
+    /**
+     * `POST path` with a JSON body, for a file download (the telemetry export):
+     * the raw body and the response headers, never the `{ data }` envelope.
+     * Optional, like {@link PlatformApiClient.getBlob}; a page that needs it
+     * reports its absence instead of failing silently.
+     */
+    postBlob?(path: string, body?: unknown, options?: PlatformRequestOptions): Promise<PlatformBlobResponse>;
+    /**
+     * `POST path` with a JSON body and stream the `text/event-stream` answer,
+     * frame by frame (the telemetry assistant). ONE request, never a reconnect;
+     * the same authentication as every other call (a real `Authorization`
+     * header, one refresh-and-retry on a 401). Resolves when the server ends the
+     * stream and quietly on abort; rejects with a {@link PlatformApiError} when
+     * the API refused the request before the first byte. Optional: a page that
+     * needs it reports its absence.
+     */
+    postSse?(path: string, body: unknown, options: PlatformSseOptions): Promise<void>;
+}
+/**
+ * Per-request options every {@link PlatformApiClient} method takes. All
+ * optional; a transport ignores what it cannot honour.
+ *
+ * @stability experimental
+ */
+export interface PlatformRequestOptions {
+    /** Aborts the request (a superseded query, an unmount). */
+    signal?: AbortSignal;
+    /** Sent as the `If-Match` header (optimistic concurrency, `docs/API.md`). */
+    ifMatch?: string;
+}
+/**
+ * What {@link PlatformApiClient.postSse} takes besides the path and body.
+ *
+ * @stability experimental
+ */
+export interface PlatformSseOptions {
+    /**
+     * One parsed frame: its `event:` name and its `data:` parsed as JSON (the
+     * raw string when it is not JSON). Comment lines never arrive here.
+     */
+    onFrame(event: string, data: unknown): void;
+    /** Aborting ends the stream; the promise then resolves quietly. */
+    signal?: AbortSignal;
+}
+/**
+ * What {@link PlatformApiClient.getBlob} resolves with.
+ *
+ * @stability experimental
+ */
+export interface PlatformBlobResponse {
+    /** The response body. */
+    blob: Blob;
+    /** The response headers (only `get` is needed). */
+    headers: {
+        /** One header's value (case-insensitive name), or `null`. */
+        get(name: string): string | null;
+    };
+}
+/**
+ * What a packaged page may know about a failed call; the adapter maps the
+ * app's error class onto it.
+ *
+ * @stability experimental
+ */
+export interface PlatformApiError {
+    /** The HTTP status (403, 409, 500, ...). */
+    status: number;
+    /** The API's message, safe to show. */
+    message: string;
+    /** The API's machine-readable error code, when it sent one. */
+    code?: string;
+    /** The error envelope's `details`, when the API sent any (e.g. `{ reason }`). */
+    details?: unknown;
+}
+/**
+ * Whether `error` is a {@link PlatformApiError}: an object with a numeric
+ * `status` and a string `message`. A network failure (no response at all) is
+ * not one.
+ *
+ * @param error - whatever a {@link PlatformApiClient} call rejected with.
+ * @returns `true` when the API answered with an error status.
+ *
+ * @stability experimental
+ */
+export declare function isPlatformApiError(error: unknown): error is PlatformApiError;
+//# sourceMappingURL=api-client.d.ts.map

package/dist/core/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../../src/core/api-client.ts"],"names":[],"mappings":"AAKA;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC,kBAAkB;IAClB,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACnE,8CAA8C;IAC9C,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACpF,sFAAsF;IACtF,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACnF,wFAAwF;IACxF,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACrF,8DAA8D;IAC9D,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACtE;;;;;OAKG;IACH,OAAO,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACxF;;;;;OAKG;IACH,QAAQ,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACzG;;;;;;;;OAQG;IACH,OAAO,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnF;AAED;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,2DAA2D;IAC3D,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAC5C,mEAAmE;IACnE,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,yBAAyB;IACzB,IAAI,EAAE,IAAI,CAAC;IACX,mDAAmD;IACnD,OAAO,EAAE;QACP,6DAA6D;QAC7D,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;KAClC,CAAC;CACH;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iFAAiF;IACjF,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAS5E"}

package/dist/core/api-client.js

@@ -0,0 +1,24 @@
+// The transport port (issue #696, PP-2.7). A packaged page never imports the
+// app's fetch wrapper: it calls the app's transport through this interface,
+// and the app's adapter (`apps/web/src/platform/platformHost.tsx`) keeps the
+// auth header, the token refresh and the maintenance handling where they are.
+/**
+ * Whether `error` is a {@link PlatformApiError}: an object with a numeric
+ * `status` and a string `message`. A network failure (no response at all) is
+ * not one.
+ *
+ * @param error - whatever a {@link PlatformApiClient} call rejected with.
+ * @returns `true` when the API answered with an error status.
+ *
+ * @stability experimental
+ */
+export function isPlatformApiError(error) {
+    if (error === null || typeof error !== 'object')
+        return false;
+    const candidate = error;
+    return (typeof candidate.status === 'number' &&
+        Number.isFinite(candidate.status) &&
+        typeof candidate.message === 'string' &&
+        (candidate.code === undefined || typeof candidate.code === 'string'));
+}
+//# sourceMappingURL=api-client.js.map

package/dist/core/api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.js","sourceRoot":"","sources":["../../src/core/api-client.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,4EAA4E;AAC5E,6EAA6E;AAC7E,8EAA8E;AA2G9E;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,SAAS,GAAG,KAAgE,CAAC;IACnF,OAAO,CACL,OAAO,SAAS,CAAC,MAAM,KAAK,QAAQ;QACpC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC;QACjC,OAAO,SAAS,CAAC,OAAO,KAAK,QAAQ;QACrC,CAAC,SAAS,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,SAAS,CAAC,IAAI,KAAK,QAAQ,CAAC,CACrE,CAAC;AACJ,CAAC"}

package/dist/core/host.d.ts

@@ -0,0 +1,74 @@
+import type { ReactElement, ReactNode } from 'react';
+import type { PlatformApiClient } from './api-client.js';
+import type { PlatformViewer } from './viewer.js';
+/**
+ * Everything a packaged page needs from the app.
+ *
+ * @stability experimental
+ */
+export interface PlatformWebHost {
+    /** The app's transport. Keep its identity stable across renders. */
+    api: PlatformApiClient;
+    /** Who is looking. */
+    viewer: PlatformViewer;
+    /** Optional formatting hooks so packaged pages match the app's conventions. */
+    formatRelativeTime?(iso: string): string;
+}
+/**
+ * Makes the app's {@link PlatformWebHost} available to every packaged page
+ * below it. Mount it once, inside the app's auth provider.
+ *
+ * @param props - `host`: the app's host (memoise it); `children`: the routed tree.
+ * @returns the provider element.
+ *
+ * @example
+ * ```tsx
+ * <PlatformHostProvider host={host}>
+ *   <Layout />
+ * </PlatformHostProvider>
+ * ```
+ *
+ * @extensionPoint option
+ * @stability experimental
+ */
+export declare function PlatformHostProvider(props: {
+    host: PlatformWebHost;
+    children: ReactNode;
+}): ReactElement;
+/**
+ * The host in context, or `null` outside any {@link PlatformHostProvider}.
+ * For hooks that also accept an explicit dependency (`useDoctor(client)`).
+ *
+ * @returns the host, or `null`.
+ *
+ * @stability experimental
+ */
+export declare function useOptionalPlatformHost(): PlatformWebHost | null;
+/**
+ * The host in context.
+ *
+ * @returns the host.
+ * @throws Error outside a {@link PlatformHostProvider}.
+ *
+ * @stability experimental
+ */
+export declare function usePlatformHost(): PlatformWebHost;
+/**
+ * The app's transport from the host in context.
+ *
+ * @returns the host's {@link PlatformApiClient}.
+ * @throws Error outside a {@link PlatformHostProvider}.
+ *
+ * @stability experimental
+ */
+export declare function usePlatformApi(): PlatformApiClient;
+/**
+ * The viewer from the host in context.
+ *
+ * @returns the host's {@link PlatformViewer}.
+ * @throws Error outside a {@link PlatformHostProvider}.
+ *
+ * @stability experimental
+ */
+export declare function usePlatformViewer(): PlatformViewer;
+//# sourceMappingURL=host.d.ts.map

package/dist/core/host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../src/core/host.tsx"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAErD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,oEAAoE;IACpE,GAAG,EAAE,iBAAiB,CAAC;IACvB,sBAAsB;IACtB,MAAM,EAAE,cAAc,CAAC;IACvB,+EAA+E;IAC/E,kBAAkB,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CAC1C;AAKD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,QAAQ,EAAE,SAAS,CAAA;CAAE,GAAG,YAAY,CAExG;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,IAAI,eAAe,GAAG,IAAI,CAEhE;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,IAAI,eAAe,CASjD;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,IAAI,iBAAiB,CAElD;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CAElD"}

package/dist/core/host.js

@@ -0,0 +1,84 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+// =============================================================================
+// The web host ports (issue #696, PP-2.7)
+// =============================================================================
+//
+// Every packaged page reaches the app through ONE context: the app's
+// transport, the signed-in viewer and optional formatting hooks. The app
+// builds the host once (`apps/web/src/platform/platformHost.tsx`) and mounts
+// `PlatformHostProvider` inside its auth provider; a packaged page never
+// imports app context, layout or navigation.
+// =============================================================================
+import { createContext, useContext } from 'react';
+const PlatformHostContext = createContext(null);
+PlatformHostContext.displayName = 'PlatformHostContext';
+/**
+ * Makes the app's {@link PlatformWebHost} available to every packaged page
+ * below it. Mount it once, inside the app's auth provider.
+ *
+ * @param props - `host`: the app's host (memoise it); `children`: the routed tree.
+ * @returns the provider element.
+ *
+ * @example
+ * ```tsx
+ * <PlatformHostProvider host={host}>
+ *   <Layout />
+ * </PlatformHostProvider>
+ * ```
+ *
+ * @extensionPoint option
+ * @stability experimental
+ */
+export function PlatformHostProvider(props) {
+    return _jsx(PlatformHostContext.Provider, { value: props.host, children: props.children });
+}
+/**
+ * The host in context, or `null` outside any {@link PlatformHostProvider}.
+ * For hooks that also accept an explicit dependency (`useDoctor(client)`).
+ *
+ * @returns the host, or `null`.
+ *
+ * @stability experimental
+ */
+export function useOptionalPlatformHost() {
+    return useContext(PlatformHostContext);
+}
+/**
+ * The host in context.
+ *
+ * @returns the host.
+ * @throws Error outside a {@link PlatformHostProvider}.
+ *
+ * @stability experimental
+ */
+export function usePlatformHost() {
+    const host = useContext(PlatformHostContext);
+    if (host === null) {
+        throw new Error('usePlatformHost: no PlatformHostProvider above this component. Packaged pages read the app ' +
+            "through @marinoscar/platform-web/core's PlatformHostProvider; mount it inside the app's auth provider.");
+    }
+    return host;
+}
+/**
+ * The app's transport from the host in context.
+ *
+ * @returns the host's {@link PlatformApiClient}.
+ * @throws Error outside a {@link PlatformHostProvider}.
+ *
+ * @stability experimental
+ */
+export function usePlatformApi() {
+    return usePlatformHost().api;
+}
+/**
+ * The viewer from the host in context.
+ *
+ * @returns the host's {@link PlatformViewer}.
+ * @throws Error outside a {@link PlatformHostProvider}.
+ *
+ * @stability experimental
+ */
+export function usePlatformViewer() {
+    return usePlatformHost().viewer;
+}
+//# sourceMappingURL=host.js.map

package/dist/core/host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.js","sourceRoot":"","sources":["../../src/core/host.tsx"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,0CAA0C;AAC1C,gFAAgF;AAChF,EAAE;AACF,qEAAqE;AACrE,yEAAyE;AACzE,6EAA6E;AAC7E,yEAAyE;AACzE,6CAA6C;AAC7C,gFAAgF;AAEhF,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAoBlD,MAAM,mBAAmB,GAAG,aAAa,CAAyB,IAAI,CAAC,CAAC;AACxE,mBAAmB,CAAC,WAAW,GAAG,qBAAqB,CAAC;AAExD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAqD;IACxF,OAAO,KAAC,mBAAmB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,CAAC,IAAI,YAAG,KAAK,CAAC,QAAQ,GAAgC,CAAC;AAC1G,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB;IACrC,OAAO,UAAU,CAAC,mBAAmB,CAAC,CAAC;AACzC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,IAAI,GAAG,UAAU,CAAC,mBAAmB,CAAC,CAAC;IAC7C,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CACb,6FAA6F;YAC3F,wGAAwG,CAC3G,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,eAAe,EAAE,CAAC,GAAG,CAAC;AAC/B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,eAAe,EAAE,CAAC,MAAM,CAAC;AAClC,CAAC"}

package/dist/core/index.d.ts

@@ -0,0 +1,7 @@
+export { isPlatformApiError } from './api-client.js';
+export type { PlatformApiClient, PlatformApiError, PlatformBlobResponse, PlatformRequestOptions, PlatformSseOptions, } from './api-client.js';
+export type { PlatformViewer } from './viewer.js';
+export type { PlatformSettingsPage } from './settings-page.js';
+export { PlatformHostProvider, useOptionalPlatformHost, usePlatformApi, usePlatformHost, usePlatformViewer, } from './host.js';
+export type { PlatformWebHost } from './host.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,cAAc,EACd,eAAe,EACf,iBAAiB,GAClB,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,5 @@
+// `@marinoscar/platform-web/core`: the web host ports every packaged page
+// reuses (issue #696). Documented in ./README.md.
+export { isPlatformApiError } from './api-client.js';
+export { PlatformHostProvider, useOptionalPlatformHost, usePlatformApi, usePlatformHost, usePlatformViewer, } from './host.js';
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,kDAAkD;AAElD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAUrD,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,cAAc,EACd,eAAe,EACf,iBAAiB,GAClB,MAAM,WAAW,CAAC"}

package/dist/core/settings-page.d.ts

@@ -0,0 +1,47 @@
+import type { ComponentType } from 'react';
+import type { SvgIcon } from '@mui/material';
+/**
+ * Descriptor a packaged admin/settings page exports; the app turns it into a
+ * registry card (`{ ...page.card, Icon: page.Icon }`, appended to the right
+ * section) and a route (`path={page.card.path}`, wrapped in the app's
+ * permission gate for `page.card.permission`).
+ *
+ * @typeParam TFeature - the feature keys `card.feature` may take; `never` for a
+ *   page that is never feature-gated, so the card is assignable to any app's
+ *   card type.
+ *
+ * @example
+ * ```tsx
+ * // apps/web/src/config/adminSections.tsx
+ * { ...doctorSettingsPage.card, Icon: doctorSettingsPage.Icon },
+ * // apps/web/src/App.tsx
+ * <Route path={doctorSettingsPage.card.path} element={
+ *   <RequirePermission permission={doctorSettingsPage.card.permission!}><DoctorPage /></RequirePermission>
+ * } />
+ * ```
+ *
+ * @extensionPoint component
+ * @stability experimental
+ */
+export interface PlatformSettingsPage<TFeature extends string = string> {
+    /** Stable id, e.g. `'doctor'`. */
+    id: string;
+    /** The registry card: the same text the page shows as its title and subtitle. */
+    card: {
+        /** Card and page title. */
+        title: string;
+        /** Card text and page subtitle. */
+        description: string;
+        /** The route, e.g. `/admin/settings/doctor`. */
+        path: string;
+        /** The exact permission the packaged API route enforces; absent means any signed-in user. */
+        permission?: string;
+        /** A deployment feature the card exists under (hidden while it is off). */
+        feature?: TFeature;
+    };
+    /** Default icon (an MUI SvgIcon); the app may override it. */
+    Icon: typeof SvgIcon;
+    /** The route element; reads everything from `usePlatformHost()`. */
+    Page: ComponentType;
+}
+//# sourceMappingURL=settings-page.d.ts.map

package/dist/core/settings-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-page.d.ts","sourceRoot":"","sources":["../../src/core/settings-page.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,oBAAoB,CAAC,QAAQ,SAAS,MAAM,GAAG,MAAM;IACpE,kCAAkC;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,iFAAiF;IACjF,IAAI,EAAE;QACJ,2BAA2B;QAC3B,KAAK,EAAE,MAAM,CAAC;QACd,mCAAmC;QACnC,WAAW,EAAE,MAAM,CAAC;QACpB,gDAAgD;QAChD,IAAI,EAAE,MAAM,CAAC;QACb,6FAA6F;QAC7F,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,2EAA2E;QAC3E,OAAO,CAAC,EAAE,QAAQ,CAAC;KACpB,CAAC;IACF,8DAA8D;IAC9D,IAAI,EAAE,OAAO,OAAO,CAAC;IACrB,oEAAoE;IACpE,IAAI,EAAE,aAAa,CAAC;CACrB"}

package/dist/core/settings-page.js

@@ -0,0 +1,5 @@
+// The settings-page descriptor (issue #696, PP-2.7). A packaged admin or
+// settings page exports one; the app turns it into a registry card and a route
+// (Settings UI Pattern: the app stays the owner of its registries and routes).
+export {};
+//# sourceMappingURL=settings-page.js.map

package/dist/core/settings-page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-page.js","sourceRoot":"","sources":["../../src/core/settings-page.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,+EAA+E;AAC/E,+EAA+E"}

package/dist/core/viewer.d.ts

@@ -0,0 +1,14 @@
+/**
+ * The signed-in viewer, as packaged pages may see it.
+ *
+ * @stability experimental
+ */
+export interface PlatformViewer {
+    /** The signed-in user's id, or `null` when nobody is signed in. */
+    userId: string | null;
+    /** Whether the viewer holds `permission` (the exact string the API enforces). */
+    hasPermission(permission: string): boolean;
+    /** Feature switches the app exposes to settings surfaces (e.g. ai, telemetry). */
+    isFeatureEnabled(feature: string): boolean;
+}
+//# sourceMappingURL=viewer.d.ts.map

package/dist/core/viewer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewer.d.ts","sourceRoot":"","sources":["../../src/core/viewer.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,mEAAmE;IACnE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,iFAAiF;IACjF,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3C,kFAAkF;IAClF,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;CAC5C"}

package/dist/core/viewer.js

@@ -0,0 +1,4 @@
+// The viewer port (issue #696, PP-2.7): who is looking, as a packaged page may
+// see it. The app's adapter derives it from its own auth context.
+export {};
+//# sourceMappingURL=viewer.js.map

package/dist/core/viewer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewer.js","sourceRoot":"","sources":["../../src/core/viewer.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,kEAAkE"}

package/dist/doctor/headless/categories.d.ts

@@ -0,0 +1,31 @@
+/**
+ * A category key and its display label.
+ *
+ * @stability stable
+ */
+export interface DoctorCategoryLabel {
+    /** The category key the API reports (`storage`). */
+    key: string;
+    /** What the page shows (`Object storage`). */
+    label: string;
+}
+/**
+ * The shipped categories, in display order, with their labels. The default of
+ * `DoctorPage`'s `categories` prop; a category an app adds renders after these,
+ * title-cased, unless the app passes its own list.
+ *
+ * @stability stable
+ */
+export declare const PLATFORM_DOCTOR_CATEGORY_LABELS: readonly DoctorCategoryLabel[];
+/**
+ * The label of a category: from `labels` when listed, otherwise the key
+ * title-cased (`fork_widgets` becomes `Fork Widgets`).
+ *
+ * @param key - the category key.
+ * @param labels - the known labels. Default {@link PLATFORM_DOCTOR_CATEGORY_LABELS}.
+ * @returns the label.
+ *
+ * @stability stable
+ */
+export declare function categoryLabel(key: string, labels?: readonly DoctorCategoryLabel[]): string;
+//# sourceMappingURL=categories.d.ts.map

package/dist/doctor/headless/categories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"categories.d.ts","sourceRoot":"","sources":["../../../src/doctor/headless/categories.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,oDAAoD;IACpD,GAAG,EAAE,MAAM,CAAC;IACZ,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;GAMG;AACH,eAAO,MAAM,+BAA+B,EAAE,SAAS,mBAAmB,EAYzE,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,MAAM,EACX,MAAM,GAAE,SAAS,mBAAmB,EAAoC,GACvE,MAAM,CAQR"}