@massdriver/backstage-plugin 1.0.0

package/dist/hooks/usePaginatedRelayQuery.esm.js

@@ -0,0 +1,68 @@
+import { useApi } from '@backstage/frontend-plugin-api';
+import { useState } from 'react';
+import useAsync from 'react-use/esm/useAsync';
+import { massdriverApiRef } from '../api.esm.js';
+import { useCursorPagination } from './useCursorPagination.esm.js';
+
+const usePaginatedRelayQuery = (query, {
+  responseKey,
+  sortFieldMap = {},
+  defaultSort = null,
+  pageSize = 20,
+  filterFromSearch,
+  baseFilter,
+  variables
+}) => {
+  const api = useApi(massdriverApiRef);
+  const [state, setState] = useState({
+    search: "",
+    page: 0,
+    pageSize,
+    sort: defaultSort
+  });
+  const { cursor, sort, processPage } = useCursorPagination({
+    state,
+    sortFieldMap
+  });
+  const searchFilter = state.search ? filterFromSearch ? filterFromSearch(state.search) : { search: state.search } : void 0;
+  const filter = baseFilter || searchFilter ? { ...baseFilter ?? {}, ...searchFilter ?? {} } : void 0;
+  const {
+    value: page,
+    loading,
+    error
+  } = useAsync(async () => {
+    const data = await api.query(query, {
+      ...variables ?? {},
+      sort,
+      cursor,
+      filter
+    });
+    const path = Array.isArray(responseKey) ? responseKey : [responseKey];
+    return path.reduce(
+      (node, key) => node?.[key],
+      data
+    );
+  }, [
+    api,
+    query,
+    JSON.stringify(responseKey),
+    state.page,
+    state.pageSize,
+    state.search,
+    sort?.field,
+    sort?.order,
+    JSON.stringify(baseFilter ?? null),
+    JSON.stringify(variables ?? null)
+  ]);
+  const { hasMore } = processPage(page);
+  return {
+    items: (page?.items ?? []).filter(Boolean),
+    loading,
+    error,
+    hasMore,
+    dataListParams: { state, onStateChange: setState }
+  };
+};
+
+export { usePaginatedRelayQuery };
+//# sourceMappingURL=usePaginatedRelayQuery.esm.js.map

package/dist/hooks/usePaginatedRelayQuery.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePaginatedRelayQuery.esm.js","sources":["../../src/hooks/usePaginatedRelayQuery.ts"],"sourcesContent":["import { useApi } from '@backstage/frontend-plugin-api';\nimport { useState } from 'react';\nimport useAsync from 'react-use/esm/useAsync';\nimport { massdriverApiRef } from '../api';\nimport {\n  DataListSort,\n  DataListState,\n  useCursorPagination,\n} from './useCursorPagination';\n\nexport interface PaginatedResult<T> {\n  items: T[];\n  loading: boolean;\n  error?: Error;\n  hasMore: boolean;\n  /** Spread onto DataList (controlled state + change handler). */\n  dataListParams: {\n    state: DataListState;\n    onStateChange: (state: DataListState) => void;\n  };\n}\n\ninterface RelayPage<T> {\n  items?: (T | null)[] | null;\n  cursor?: { next?: string | null } | null;\n}\n\n/**\n * Server-side cursor pagination for a DataList, over the relay. Mirrors the web\n * app's `usePaginatedQuery` but keeps state local (no URL persistence) and\n * fetches through `massdriverApiRef` instead of Apollo.\n */\nexport const usePaginatedRelayQuery = <T>(\n  query: string,\n  {\n    responseKey,\n    sortFieldMap = {},\n    defaultSort = null,\n    pageSize = 20,\n    filterFromSearch,\n    baseFilter,\n    variables,\n  }: {\n    /** Key of the paginated page in the response; an array walks a nested path\n     * (e.g. `['resource', 'connections']`). */\n    responseKey: string | string[];\n    sortFieldMap?: Record<string, string>;\n    defaultSort?: DataListSort | null;\n    pageSize?: number;\n    filterFromSearch?: (search: string) => Record<string, unknown>;\n    /** Filter always applied (e.g. scoping by project), merged with search. */\n    baseFilter?: Record<string, unknown>;\n    /** Extra query variables (e.g. the parent entity `id` for nested pages). */\n    variables?: Record<string, unknown>;\n  },\n): PaginatedResult<T> => {\n  const api = useApi(massdriverApiRef);\n  const [state, setState] = useState<DataListState>({\n    search: '',\n    page: 0,\n    pageSize,\n    sort: defaultSort,\n  });\n\n  const { cursor, sort, processPage } = useCursorPagination({\n    state,\n    sortFieldMap,\n  });\n\n  const searchFilter = state.search\n    ? filterFromSearch\n      ? filterFromSearch(state.search)\n      : { search: state.search }\n    : undefined;\n  const filter =\n    baseFilter || searchFilter\n      ? { ...(baseFilter ?? {}), ...(searchFilter ?? {}) }\n      : undefined;\n\n  const {\n    value: page,\n    loading,\n    error,\n  } = useAsync(async () => {\n    const data = (await api.query(query, {\n      ...(variables ?? {}),\n      sort,\n      cursor,\n      filter,\n    })) as Record<string, unknown>;\n    const path = Array.isArray(responseKey) ? responseKey : [responseKey];\n    return path.reduce<unknown>(\n      (node, key) =>\n        (node as Record<string, unknown> | null | undefined)?.[key],\n      data,\n    ) as RelayPage<T> | undefined;\n    // Re-fetch whenever the effective query inputs change.\n  }, [\n    api,\n    query,\n    JSON.stringify(responseKey),\n    state.page,\n    state.pageSize,\n    state.search,\n    sort?.field,\n    sort?.order,\n    JSON.stringify(baseFilter ?? null),\n    JSON.stringify(variables ?? null),\n  ]);\n\n  const { hasMore } = processPage(page);\n\n  return {\n    items: (page?.items ?? []).filter(Boolean) as T[],\n    loading,\n    error,\n    hasMore,\n    dataListParams: { state, onStateChange: setState },\n  };\n};\n"],"names":[],"mappings":";;;;;;AAgCO,MAAM,sBAAA,GAAyB,CACpC,KAAA,EACA;AAAA,EACE,WAAA;AAAA,EACA,eAAe,EAAC;AAAA,EAChB,WAAA,GAAc,IAAA;AAAA,EACd,QAAA,GAAW,EAAA;AAAA,EACX,gBAAA;AAAA,EACA,UAAA;AAAA,EACA;AACF,CAAA,KAauB;AACvB,EAAA,MAAM,GAAA,GAAM,OAAO,gBAAgB,CAAA;AACnC,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAI,QAAA,CAAwB;AAAA,IAChD,MAAA,EAAQ,EAAA;AAAA,IACR,IAAA,EAAM,CAAA;AAAA,IACN,QAAA;AAAA,IACA,IAAA,EAAM;AAAA,GACP,CAAA;AAED,EAAA,MAAM,EAAE,MAAA,EAAQ,IAAA,EAAM,WAAA,KAAgB,mBAAA,CAAoB;AAAA,IACxD,KAAA;AAAA,IACA;AAAA,GACD,CAAA;AAED,EAAA,MAAM,YAAA,GAAe,KAAA,CAAM,MAAA,GACvB,gBAAA,GACE,gBAAA,CAAiB,KAAA,CAAM,MAAM,CAAA,GAC7B,EAAE,MAAA,EAAQ,KAAA,CAAM,MAAA,EAAO,GACzB,MAAA;AACJ,EAAA,MAAM,MAAA,GACJ,UAAA,IAAc,YAAA,GACV,EAAE,GAAI,UAAA,IAAc,EAAC,EAAI,GAAI,YAAA,IAAgB,EAAC,EAAG,GACjD,MAAA;AAEN,EAAA,MAAM;AAAA,IACJ,KAAA,EAAO,IAAA;AAAA,IACP,OAAA;AAAA,IACA;AAAA,GACF,GAAI,SAAS,YAAY;AACvB,IAAA,MAAM,IAAA,GAAQ,MAAM,GAAA,CAAI,KAAA,CAAM,KAAA,EAAO;AAAA,MACnC,GAAI,aAAa,EAAC;AAAA,MAClB,IAAA;AAAA,MACA,MAAA;AAAA,MACA;AAAA,KACD,CAAA;AACD,IAAA,MAAM,OAAO,KAAA,CAAM,OAAA,CAAQ,WAAW,CAAA,GAAI,WAAA,GAAc,CAAC,WAAW,CAAA;AACpE,IAAA,OAAO,IAAA,CAAK,MAAA;AAAA,MACV,CAAC,IAAA,EAAM,GAAA,KACJ,IAAA,GAAsD,GAAG,CAAA;AAAA,MAC5D;AAAA,KACF;AAAA,EAEF,CAAA,EAAG;AAAA,IACD,GAAA;AAAA,IACA,KAAA;AAAA,IACA,IAAA,CAAK,UAAU,WAAW,CAAA;AAAA,IAC1B,KAAA,CAAM,IAAA;AAAA,IACN,KAAA,CAAM,QAAA;AAAA,IACN,KAAA,CAAM,MAAA;AAAA,IACN,IAAA,EAAM,KAAA;AAAA,IACN,IAAA,EAAM,KAAA;AAAA,IACN,IAAA,CAAK,SAAA,CAAU,UAAA,IAAc,IAAI,CAAA;AAAA,IACjC,IAAA,CAAK,SAAA,CAAU,SAAA,IAAa,IAAI;AAAA,GACjC,CAAA;AAED,EAAA,MAAM,EAAE,OAAA,EAAQ,GAAI,WAAA,CAAY,IAAI,CAAA;AAEpC,EAAA,OAAO;AAAA,IACL,QAAQ,IAAA,EAAM,KAAA,IAAS,EAAC,EAAG,OAAO,OAAO,CAAA;AAAA,IACzC,OAAA;AAAA,IACA,KAAA;AAAA,IACA,OAAA;AAAA,IACA,cAAA,EAAgB,EAAE,KAAA,EAAO,aAAA,EAAe,QAAA;AAAS,GACnD;AACF;;;;"}

package/dist/index.d.ts

@@ -0,0 +1,256 @@
+import * as _backstage_plugin_catalog_react_alpha from '@backstage/plugin-catalog-react/alpha';
+import * as _backstage_catalog_model from '@backstage/catalog-model';
+import { Entity } from '@backstage/catalog-model';
+import * as react from 'react';
+import * as _backstage_filter_predicates from '@backstage/filter-predicates';
+import * as _backstage_frontend_plugin_api from '@backstage/frontend-plugin-api';
+import { FetchApi, ConfigApi } from '@backstage/frontend-plugin-api';
+
+/** @public */
+declare const massdriverPlugin: _backstage_frontend_plugin_api.OverridableFrontendPlugin<{
+    root: _backstage_frontend_plugin_api.RouteRef<undefined>;
+}, {}, {
+    "api:massdriver/massdriver": _backstage_frontend_plugin_api.OverridableExtensionDefinition<{
+        kind: "api";
+        name: "massdriver";
+        config: {};
+        configInput: {};
+        output: _backstage_frontend_plugin_api.ExtensionDataRef<_backstage_frontend_plugin_api.AnyApiFactory, "core.api.factory", {}>;
+        inputs: {};
+        params: <TApi, TImpl extends TApi, TDeps extends { [name in string]: unknown; }>(params: _backstage_frontend_plugin_api.ApiFactory<TApi, TImpl, TDeps>) => _backstage_frontend_plugin_api.ExtensionBlueprintParams<_backstage_frontend_plugin_api.AnyApiFactory>;
+    }>;
+    "entity-card:massdriver/overview": _backstage_frontend_plugin_api.OverridableExtensionDefinition<{
+        kind: "entity-card";
+        name: "overview";
+        config: {
+            filter: _backstage_filter_predicates.FilterPredicate | undefined;
+            type: "content" | "info" | undefined;
+        };
+        configInput: {
+            filter?: _backstage_filter_predicates.FilterPredicate | undefined;
+            type?: "content" | "info" | undefined;
+        };
+        output: _backstage_frontend_plugin_api.ExtensionDataRef<react.JSX.Element, "core.reactElement", {}> | _backstage_frontend_plugin_api.ExtensionDataRef<(entity: _backstage_catalog_model.Entity) => boolean, "catalog.entity-filter-function", {
+            optional: true;
+        }> | _backstage_frontend_plugin_api.ExtensionDataRef<string, "catalog.entity-filter-expression", {
+            optional: true;
+        }> | _backstage_frontend_plugin_api.ExtensionDataRef<_backstage_plugin_catalog_react_alpha.EntityCardType, "catalog.entity-card-type", {
+            optional: true;
+        }>;
+        inputs: {};
+        params: {
+            loader: () => Promise<JSX.Element>;
+            filter?: string | _backstage_filter_predicates.FilterPredicate | ((entity: _backstage_catalog_model.Entity) => boolean);
+            type?: _backstage_plugin_catalog_react_alpha.EntityCardType;
+        };
+    }>;
+    "entity-content:massdriver/entity": _backstage_frontend_plugin_api.OverridableExtensionDefinition<{
+        kind: "entity-content";
+        name: "entity";
+        config: {
+            path: string | undefined;
+            title: string | undefined;
+            filter: _backstage_filter_predicates.FilterPredicate | undefined;
+            group: string | false | undefined;
+            icon: string | undefined;
+        };
+        configInput: {
+            path?: string | undefined;
+            title?: string | undefined;
+            filter?: _backstage_filter_predicates.FilterPredicate | undefined;
+            group?: string | false | undefined;
+            icon?: string | undefined;
+        };
+        output: _backstage_frontend_plugin_api.ExtensionDataRef<react.JSX.Element, "core.reactElement", {}> | _backstage_frontend_plugin_api.ExtensionDataRef<string, "core.routing.path", {}> | _backstage_frontend_plugin_api.ExtensionDataRef<_backstage_frontend_plugin_api.RouteRef<_backstage_frontend_plugin_api.AnyRouteRefParams>, "core.routing.ref", {
+            optional: true;
+        }> | _backstage_frontend_plugin_api.ExtensionDataRef<(entity: _backstage_catalog_model.Entity) => boolean, "catalog.entity-filter-function", {
+            optional: true;
+        }> | _backstage_frontend_plugin_api.ExtensionDataRef<string, "catalog.entity-filter-expression", {
+            optional: true;
+        }> | _backstage_frontend_plugin_api.ExtensionDataRef<string, "catalog.entity-content-title", {}> | _backstage_frontend_plugin_api.ExtensionDataRef<string, "catalog.entity-content-group", {
+            optional: true;
+        }> | _backstage_frontend_plugin_api.ExtensionDataRef<string | react.ReactElement<any, string | react.JSXElementConstructor<any>>, "catalog.entity-content-icon", {
+            optional: true;
+        }>;
+        inputs: {};
+        params: {
+            defaultPath?: [Error: `Use the 'path' param instead`];
+            path: string;
+            defaultTitle?: [Error: `Use the 'title' param instead`];
+            title: string;
+            defaultGroup?: [Error: `Use the 'group' param instead`];
+            group?: ("overview" | "deployment" | "documentation" | "development" | "operation" | "observability") | (string & {});
+            icon?: string | react.ReactElement;
+            loader: () => Promise<JSX.Element>;
+            routeRef?: _backstage_frontend_plugin_api.RouteRef;
+            filter?: string | _backstage_filter_predicates.FilterPredicate | ((entity: _backstage_catalog_model.Entity) => boolean);
+        };
+    }>;
+    "page:massdriver": _backstage_frontend_plugin_api.OverridableExtensionDefinition<{
+        kind: "page";
+        name: undefined;
+        config: {
+            path: string | undefined;
+            title: string | undefined;
+        };
+        configInput: {
+            path?: string | undefined;
+            title?: string | undefined;
+        };
+        output: _backstage_frontend_plugin_api.ExtensionDataRef<react.JSX.Element, "core.reactElement", {}> | _backstage_frontend_plugin_api.ExtensionDataRef<string, "core.routing.path", {}> | _backstage_frontend_plugin_api.ExtensionDataRef<_backstage_frontend_plugin_api.RouteRef<_backstage_frontend_plugin_api.AnyRouteRefParams>, "core.routing.ref", {
+            optional: true;
+        }> | _backstage_frontend_plugin_api.ExtensionDataRef<string, "core.title", {
+            optional: true;
+        }> | _backstage_frontend_plugin_api.ExtensionDataRef<_backstage_frontend_plugin_api.IconElement, "core.icon", {
+            optional: true;
+        }>;
+        inputs: {
+            pages: _backstage_frontend_plugin_api.ExtensionInput<_backstage_frontend_plugin_api.ConfigurableExtensionDataRef<react.JSX.Element, "core.reactElement", {}> | _backstage_frontend_plugin_api.ConfigurableExtensionDataRef<string, "core.routing.path", {}> | _backstage_frontend_plugin_api.ConfigurableExtensionDataRef<_backstage_frontend_plugin_api.RouteRef<_backstage_frontend_plugin_api.AnyRouteRefParams>, "core.routing.ref", {
+                optional: true;
+            }> | _backstage_frontend_plugin_api.ConfigurableExtensionDataRef<string, "core.title", {
+                optional: true;
+            }> | _backstage_frontend_plugin_api.ConfigurableExtensionDataRef<_backstage_frontend_plugin_api.IconElement, "core.icon", {
+                optional: true;
+            }>, {
+                singleton: false;
+                optional: false;
+                internal: false;
+            }>;
+        };
+        params: {
+            path: string;
+            title?: string;
+            icon?: _backstage_frontend_plugin_api.IconElement;
+            loader?: () => Promise<react.JSX.Element>;
+            routeRef?: _backstage_frontend_plugin_api.RouteRef;
+            noHeader?: boolean;
+        };
+    }>;
+}>;
+
+/**
+ * Frontend API for talking to Massdriver via the backend relay.
+ *
+ * All queries are proxied through `plugin://massdriver/graphql`, where the
+ * backend injects the service-account bearer token. The browser never sees the
+ * token, and `organizationId` is injected server-side, so callers only declare
+ * `$organizationId` in their operations.
+ *
+ * @public
+ */
+interface MassdriverApi {
+    /** Web app origin used to build deep-links. */
+    readonly appUrl: string;
+    /** Massdriver organization id, when configured on the frontend. */
+    readonly organizationId: string;
+    query<T = unknown>(query: string, variables?: Record<string, unknown>): Promise<T>;
+    /**
+     * Fetch an auth-guarded Massdriver asset (OCI repo icon SVG, repo tag file
+     * contents) as text, via the backend content proxy — the web app fetches
+     * these directly with the browser's bearer token, which this plugin's
+     * browser doesn't hold.
+     */
+    fetchText(url: string): Promise<string>;
+    /**
+     * Open a GraphQL subscription via the backend SSE relay. Invokes
+     * `handlers.onData` with each streamed result's `data`. The returned promise
+     * resolves when the stream ends (server close, error, or abort). Pass a
+     * `signal` to tear the subscription down.
+     */
+    subscribe<T = unknown>(query: string, variables: Record<string, unknown> | undefined, handlers: {
+        onData: (data: T) => void;
+        onError?: (error: Error) => void;
+    }, signal?: AbortSignal): Promise<void>;
+}
+/** @public */
+declare const massdriverApiRef: _backstage_frontend_plugin_api.ApiRef<MassdriverApi> & {
+    readonly $$type: "@backstage/ApiRef";
+};
+/** @public */
+declare class MassdriverClientApi implements MassdriverApi {
+    private readonly fetchApi;
+    readonly appUrl: string;
+    readonly organizationId: string;
+    constructor(options: {
+        fetchApi: FetchApi;
+        configApi: ConfigApi;
+    });
+    query<T = unknown>(query: string, variables?: Record<string, unknown>): Promise<T>;
+    fetchText(url: string): Promise<string>;
+    subscribe<T = unknown>(query: string, variables: Record<string, unknown> | undefined, handlers: {
+        onData: (data: T) => void;
+        onError?: (error: Error) => void;
+    }, signal?: AbortSignal): Promise<void>;
+}
+
+/** The Massdriver resource an entity maps to. */
+type MassdriverScope = {
+    kind: 'project';
+    projectId: string;
+    orgId?: string;
+} | {
+    kind: 'environment';
+    environmentId: string;
+    orgId?: string;
+} | {
+    kind: 'instance';
+    instanceId: string;
+    orgId?: string;
+};
+/**
+ * Resolve which Massdriver resource an entity represents from its annotations.
+ * Instance is most specific, then environment, then project.
+ */
+declare const getMassdriverScope: (entity: Entity) => MassdriverScope | undefined;
+/** True when the entity carries any Massdriver annotation. */
+declare const isMassdriverEntity: (entity: Entity) => boolean;
+
+/**
+ * Entity content tab that lists the Massdriver instances for the entity's
+ * scope (project or environment) or the details of a single instance.
+ *
+ * @public
+ */
+declare const EntityMassdriverContent: () => react.JSX.Element;
+
+/**
+ * Entity overview card summarizing the entity's Massdriver status with a
+ * deep-link into the web app.
+ *
+ * @public
+ */
+declare const EntityMassdriverOverviewCard: () => react.JSX.Element | null;
+
+/**
+ * Ready-made sidebar entry for host apps that customize their nav: the
+ * Massdriver logo linking to the projects list, with a submenu mirroring the
+ * Massdriver web app's sidebar (Projects / Resources / Repositories).
+ *
+ * Apps on the default nav don't need this — the plugin's page already
+ * contributes a flat "Massdriver" nav item automatically. Apps overriding the
+ * nav with `NavContentBlueprint` can render this in place of that item.
+ *
+ * Boot-graph constraint: this component is reachable from the package root,
+ * which Backstage `require()`s eagerly at app boot — it must never import
+ * `@massdriver/ui` (whose components pull the `@mui/material` barrel); see
+ * `src/index.test.ts`.
+ *
+ * @public
+ */
+declare const MassdriverSidebarItem: () => react.JSX.Element;
+
+/**
+ * Lazy wrapper for the package-root export. The plugin's root entry is
+ * `require()`d eagerly at app boot by Backstage's package detection
+ * (`__backstage-autodetected-plugins__`), BEFORE Backstage's
+ * UnifiedThemeProvider configures MUI v5's `v5-` ClassNameGenerator prefix.
+ * A static import of the real page would evaluate `@massdriver/ui` → the
+ * `@mui/material` barrel at that point, freezing every slot-class constant
+ * unprefixed and silently breaking cross-slot selectors plugin-wide (see
+ * .claude/rules/styling-and-theme.md). Everything reaching `@massdriver/ui`
+ * from the package root must stay behind a dynamic import.
+ */
+declare const ProjectsListPage: () => react.JSX.Element;
+
+export { EntityMassdriverContent, EntityMassdriverOverviewCard, MassdriverClientApi, MassdriverSidebarItem, ProjectsListPage, massdriverPlugin as default, getMassdriverScope, isMassdriverEntity, massdriverApiRef };
+export type { MassdriverApi, MassdriverScope };

package/dist/index.esm.js

@@ -0,0 +1,8 @@
+export { massdriverPlugin as default } from './plugin.esm.js';
+export { MassdriverClientApi, massdriverApiRef } from './api.esm.js';
+export { getMassdriverScope, isMassdriverEntity } from './entity.esm.js';
+export { EntityMassdriverContent } from './components/EntityMassdriverContent/EntityMassdriverContent.esm.js';
+export { EntityMassdriverOverviewCard } from './components/EntityMassdriverOverviewCard/EntityMassdriverOverviewCard.esm.js';
+export { MassdriverSidebarItem } from './components/MassdriverSidebarItem.esm.js';
+export { ProjectsListPage } from './features/projects/ProjectsListPageLazy.esm.js';
+//# sourceMappingURL=index.esm.js.map

package/dist/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.esm.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;"}

package/dist/internalRoutes.esm.js

@@ -0,0 +1,29 @@
+import { parseEnvironmentId } from '@massdriver/backstage-plugin-common';
+
+const BASE = "/massdriver";
+const internalRoutes = {
+  projects: () => `${BASE}/projects`,
+  project: (projectId) => `${BASE}/projects/${projectId}`,
+  projectTab: (projectId, tab) => `${BASE}/projects/${projectId}/${tab}`,
+  /** `environmentId` is the full composite id; the URL keeps only the scoped part. */
+  environment: (projectId, environmentId) => {
+    const { scopedEnvironmentId } = parseEnvironmentId(environmentId);
+    return `${BASE}/projects/${projectId}/environments/${scopedEnvironmentId}`;
+  },
+  /** Instance drawer sub-route; mirrors the app's `.../instances/:scopedInstanceId`. */
+  instance: (projectId, scopedEnvironmentId, scopedComponentId) => `${BASE}/projects/${projectId}/environments/${scopedEnvironmentId}/instances/${scopedComponentId}`,
+  repositories: () => `${BASE}/repositories`,
+  /** Mirrors the app's `/repos/[repoId]/[version]/[tab]`; version defaults to `all`. */
+  repository: (repoId, version = "all") => `${BASE}/repositories/${encodeURIComponent(repoId)}/${encodeURIComponent(
+    version
+  )}`,
+  repositoryTab: (repoId, version, tab) => `${BASE}/repositories/${encodeURIComponent(repoId)}/${encodeURIComponent(
+    version
+  )}/${tab}`,
+  resources: () => `${BASE}/resources`,
+  resource: (resourceId) => `${BASE}/resources/${encodeURIComponent(resourceId)}`,
+  resourceTab: (resourceId, tab) => `${BASE}/resources/${encodeURIComponent(resourceId)}/${tab}`
+};
+
+export { internalRoutes };
+//# sourceMappingURL=internalRoutes.esm.js.map

package/dist/internalRoutes.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internalRoutes.esm.js","sources":["../src/internalRoutes.ts"],"sourcesContent":["import { parseEnvironmentId } from '@massdriver/backstage-plugin-common';\n\n// Internal (within-Backstage) routes for the embedded Massdriver views, all\n// under the plugin's `/massdriver` page mount. Environment URLs use only the\n// scoped environment segment (not the full `{projectId}-{scoped}` id), matching\n// the web app.\nconst BASE = '/massdriver';\n\nexport const internalRoutes = {\n  projects: () => `${BASE}/projects`,\n  project: (projectId: string) => `${BASE}/projects/${projectId}`,\n  projectTab: (projectId: string, tab: string) =>\n    `${BASE}/projects/${projectId}/${tab}`,\n  /** `environmentId` is the full composite id; the URL keeps only the scoped part. */\n  environment: (projectId: string, environmentId: string) => {\n    const { scopedEnvironmentId } = parseEnvironmentId(environmentId);\n    return `${BASE}/projects/${projectId}/environments/${scopedEnvironmentId}`;\n  },\n  /** Instance drawer sub-route; mirrors the app's `.../instances/:scopedInstanceId`. */\n  instance: (\n    projectId: string,\n    scopedEnvironmentId: string,\n    scopedComponentId: string,\n  ) =>\n    `${BASE}/projects/${projectId}/environments/${scopedEnvironmentId}/instances/${scopedComponentId}`,\n  repositories: () => `${BASE}/repositories`,\n  /** Mirrors the app's `/repos/[repoId]/[version]/[tab]`; version defaults to `all`. */\n  repository: (repoId: string, version = 'all') =>\n    `${BASE}/repositories/${encodeURIComponent(repoId)}/${encodeURIComponent(\n      version,\n    )}`,\n  repositoryTab: (repoId: string, version: string, tab: string) =>\n    `${BASE}/repositories/${encodeURIComponent(repoId)}/${encodeURIComponent(\n      version,\n    )}/${tab}`,\n  resources: () => `${BASE}/resources`,\n  resource: (resourceId: string) =>\n    `${BASE}/resources/${encodeURIComponent(resourceId)}`,\n  resourceTab: (resourceId: string, tab: string) =>\n    `${BASE}/resources/${encodeURIComponent(resourceId)}/${tab}`,\n};\n"],"names":[],"mappings":";;AAMA,MAAM,IAAA,GAAO,aAAA;AAEN,MAAM,cAAA,GAAiB;AAAA,EAC5B,QAAA,EAAU,MAAM,CAAA,EAAG,IAAI,CAAA,SAAA,CAAA;AAAA,EACvB,SAAS,CAAC,SAAA,KAAsB,CAAA,EAAG,IAAI,aAAa,SAAS,CAAA,CAAA;AAAA,EAC7D,UAAA,EAAY,CAAC,SAAA,EAAmB,GAAA,KAC9B,GAAG,IAAI,CAAA,UAAA,EAAa,SAAS,CAAA,CAAA,EAAI,GAAG,CAAA,CAAA;AAAA;AAAA,EAEtC,WAAA,EAAa,CAAC,SAAA,EAAmB,aAAA,KAA0B;AACzD,IAAA,MAAM,EAAE,mBAAA,EAAoB,GAAI,kBAAA,CAAmB,aAAa,CAAA;AAChE,IAAA,OAAO,CAAA,EAAG,IAAI,CAAA,UAAA,EAAa,SAAS,iBAAiB,mBAAmB,CAAA,CAAA;AAAA,EAC1E,CAAA;AAAA;AAAA,EAEA,QAAA,EAAU,CACR,SAAA,EACA,mBAAA,EACA,iBAAA,KAEA,CAAA,EAAG,IAAI,CAAA,UAAA,EAAa,SAAS,CAAA,cAAA,EAAiB,mBAAmB,CAAA,WAAA,EAAc,iBAAiB,CAAA,CAAA;AAAA,EAClG,YAAA,EAAc,MAAM,CAAA,EAAG,IAAI,CAAA,aAAA,CAAA;AAAA;AAAA,EAE3B,UAAA,EAAY,CAAC,MAAA,EAAgB,OAAA,GAAU,KAAA,KACrC,CAAA,EAAG,IAAI,CAAA,cAAA,EAAiB,kBAAA,CAAmB,MAAM,CAAC,CAAA,CAAA,EAAI,kBAAA;AAAA,IACpD;AAAA,GACD,CAAA,CAAA;AAAA,EACH,aAAA,EAAe,CAAC,MAAA,EAAgB,OAAA,EAAiB,GAAA,KAC/C,CAAA,EAAG,IAAI,CAAA,cAAA,EAAiB,kBAAA,CAAmB,MAAM,CAAC,CAAA,CAAA,EAAI,kBAAA;AAAA,IACpD;AAAA,GACD,IAAI,GAAG,CAAA,CAAA;AAAA,EACV,SAAA,EAAW,MAAM,CAAA,EAAG,IAAI,CAAA,UAAA,CAAA;AAAA,EACxB,QAAA,EAAU,CAAC,UAAA,KACT,CAAA,EAAG,IAAI,CAAA,WAAA,EAAc,kBAAA,CAAmB,UAAU,CAAC,CAAA,CAAA;AAAA,EACrD,WAAA,EAAa,CAAC,UAAA,EAAoB,GAAA,KAChC,CAAA,EAAG,IAAI,CAAA,WAAA,EAAc,kBAAA,CAAmB,UAAU,CAAC,CAAA,CAAA,EAAI,GAAG,CAAA;AAC9D;;;;"}

package/dist/plugin.esm.js

@@ -0,0 +1,57 @@
+import { jsx } from 'react/jsx-runtime';
+import { ApiBlueprint, configApiRef, fetchApiRef, PageBlueprint, createFrontendPlugin } from '@backstage/frontend-plugin-api';
+import { EntityContentBlueprint, EntityCardBlueprint } from '@backstage/plugin-catalog-react/alpha';
+import { MassdriverClientApi, massdriverApiRef } from './api.esm.js';
+import { MassdriverIcon } from './components/MassdriverIcon.esm.js';
+import { isMassdriverEntity } from './entity.esm.js';
+import { rootRouteRef } from './routes.esm.js';
+
+const massdriverApi = ApiBlueprint.make({
+  name: "massdriver",
+  params: (defineParams) => defineParams({
+    api: massdriverApiRef,
+    deps: { fetchApi: fetchApiRef, configApi: configApiRef },
+    factory: ({ fetchApi, configApi }) => new MassdriverClientApi({ fetchApi, configApi })
+  })
+});
+const page = PageBlueprint.make({
+  params: {
+    path: "/massdriver",
+    routeRef: rootRouteRef,
+    title: "Massdriver",
+    icon: /* @__PURE__ */ jsx(MassdriverIcon, {}),
+    // The Massdriver shell renders its own header; fill the content area.
+    noHeader: true,
+    loader: () => Promise.all([
+      import('./shell/MassdriverShell.esm.js'),
+      import('./MassdriverRouter.esm.js')
+    ]).then(([shell, router]) => /* @__PURE__ */ jsx(shell.MassdriverShell, { children: /* @__PURE__ */ jsx(router.MassdriverRouter, {}) }))
+  }
+});
+const entityContent = EntityContentBlueprint.make({
+  name: "entity",
+  params: {
+    path: "/massdriver",
+    title: "Massdriver",
+    filter: isMassdriverEntity,
+    loader: () => import('./components/EntityMassdriverContent/index.esm.js').then((m) => /* @__PURE__ */ jsx(m.EntityMassdriverContent, {}))
+  }
+});
+const entityCard = EntityCardBlueprint.make({
+  name: "overview",
+  params: {
+    type: "info",
+    filter: isMassdriverEntity,
+    loader: () => import('./components/EntityMassdriverOverviewCard/index.esm.js').then((m) => /* @__PURE__ */ jsx(m.EntityMassdriverOverviewCard, {}))
+  }
+});
+const massdriverPlugin = createFrontendPlugin({
+  pluginId: "massdriver",
+  extensions: [massdriverApi, page, entityContent, entityCard],
+  routes: {
+    root: rootRouteRef
+  }
+});
+
+export { massdriverPlugin };
+//# sourceMappingURL=plugin.esm.js.map

package/dist/plugin.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.esm.js","sources":["../src/plugin.tsx"],"sourcesContent":["import {\n  ApiBlueprint,\n  configApiRef,\n  createFrontendPlugin,\n  fetchApiRef,\n  PageBlueprint,\n} from '@backstage/frontend-plugin-api';\nimport {\n  EntityCardBlueprint,\n  EntityContentBlueprint,\n} from '@backstage/plugin-catalog-react/alpha';\nimport { massdriverApiRef, MassdriverClientApi } from './api';\nimport { MassdriverIcon } from './components/MassdriverIcon';\nimport { isMassdriverEntity } from './entity';\nimport { rootRouteRef } from './routes';\n\nconst massdriverApi = ApiBlueprint.make({\n  name: 'massdriver',\n  params: defineParams =>\n    defineParams({\n      api: massdriverApiRef,\n      deps: { fetchApi: fetchApiRef, configApi: configApiRef },\n      factory: ({ fetchApi, configApi }) =>\n        new MassdriverClientApi({ fetchApi, configApi }),\n    }),\n});\n\nconst page = PageBlueprint.make({\n  params: {\n    path: '/massdriver',\n    routeRef: rootRouteRef,\n    title: 'Massdriver',\n    icon: <MassdriverIcon />,\n    // The Massdriver shell renders its own header; fill the content area.\n    noHeader: true,\n    loader: () =>\n      Promise.all([\n        import('./shell/MassdriverShell'),\n        import('./MassdriverRouter'),\n      ]).then(([shell, router]) => (\n        <shell.MassdriverShell>\n          <router.MassdriverRouter />\n        </shell.MassdriverShell>\n      )),\n  },\n});\n\nconst entityContent = EntityContentBlueprint.make({\n  name: 'entity',\n  params: {\n    path: '/massdriver',\n    title: 'Massdriver',\n    filter: isMassdriverEntity,\n    loader: () =>\n      import('./components/EntityMassdriverContent').then(m => (\n        <m.EntityMassdriverContent />\n      )),\n  },\n});\n\nconst entityCard = EntityCardBlueprint.make({\n  name: 'overview',\n  params: {\n    type: 'info',\n    filter: isMassdriverEntity,\n    loader: () =>\n      import('./components/EntityMassdriverOverviewCard').then(m => (\n        <m.EntityMassdriverOverviewCard />\n      )),\n  },\n});\n\n/** @public */\nexport const massdriverPlugin = createFrontendPlugin({\n  pluginId: 'massdriver',\n  extensions: [massdriverApi, page, entityContent, entityCard],\n  routes: {\n    root: rootRouteRef,\n  },\n});\n"],"names":[],"mappings":";;;;;;;;AAgBA,MAAM,aAAA,GAAgB,aAAa,IAAA,CAAK;AAAA,EACtC,IAAA,EAAM,YAAA;AAAA,EACN,MAAA,EAAQ,kBACN,YAAA,CAAa;AAAA,IACX,GAAA,EAAK,gBAAA;AAAA,IACL,IAAA,EAAM,EAAE,QAAA,EAAU,WAAA,EAAa,WAAW,YAAA,EAAa;AAAA,IACvD,OAAA,EAAS,CAAC,EAAE,QAAA,EAAU,SAAA,EAAU,KAC9B,IAAI,mBAAA,CAAoB,EAAE,QAAA,EAAU,SAAA,EAAW;AAAA,GAClD;AACL,CAAC,CAAA;AAED,MAAM,IAAA,GAAO,cAAc,IAAA,CAAK;AAAA,EAC9B,MAAA,EAAQ;AAAA,IACN,IAAA,EAAM,aAAA;AAAA,IACN,QAAA,EAAU,YAAA;AAAA,IACV,KAAA,EAAO,YAAA;AAAA,IACP,IAAA,sBAAO,cAAA,EAAA,EAAe,CAAA;AAAA;AAAA,IAEtB,QAAA,EAAU,IAAA;AAAA,IACV,MAAA,EAAQ,MACN,OAAA,CAAQ,GAAA,CAAI;AAAA,MACV,OAAO,gCAAyB,CAAA;AAAA,MAChC,OAAO,2BAAoB;AAAA,KAC5B,CAAA,CAAE,IAAA,CAAK,CAAC,CAAC,OAAO,MAAM,CAAA,qBACrB,GAAA,CAAC,KAAA,CAAM,iBAAN,EACC,QAAA,kBAAA,GAAA,CAAC,OAAO,gBAAA,EAAP,EAAwB,GAC3B,CACD;AAAA;AAEP,CAAC,CAAA;AAED,MAAM,aAAA,GAAgB,uBAAuB,IAAA,CAAK;AAAA,EAChD,IAAA,EAAM,QAAA;AAAA,EACN,MAAA,EAAQ;AAAA,IACN,IAAA,EAAM,aAAA;AAAA,IACN,KAAA,EAAO,YAAA;AAAA,IACP,MAAA,EAAQ,kBAAA;AAAA,IACR,MAAA,EAAQ,MACN,OAAO,mDAAsC,CAAA,CAAE,IAAA,CAAK,CAAA,CAAA,qBAClD,GAAA,CAAC,CAAA,CAAE,uBAAA,EAAF,EAA0B,CAC5B;AAAA;AAEP,CAAC,CAAA;AAED,MAAM,UAAA,GAAa,oBAAoB,IAAA,CAAK;AAAA,EAC1C,IAAA,EAAM,UAAA;AAAA,EACN,MAAA,EAAQ;AAAA,IACN,IAAA,EAAM,MAAA;AAAA,IACN,MAAA,EAAQ,kBAAA;AAAA,IACR,MAAA,EAAQ,MACN,OAAO,wDAA2C,CAAA,CAAE,IAAA,CAAK,CAAA,CAAA,qBACvD,GAAA,CAAC,CAAA,CAAE,4BAAA,EAAF,EAA+B,CACjC;AAAA;AAEP,CAAC,CAAA;AAGM,MAAM,mBAAmB,oBAAA,CAAqB;AAAA,EACnD,QAAA,EAAU,YAAA;AAAA,EACV,UAAA,EAAY,CAAC,aAAA,EAAe,IAAA,EAAM,eAAe,UAAU,CAAA;AAAA,EAC3D,MAAA,EAAQ;AAAA,IACN,IAAA,EAAM;AAAA;AAEV,CAAC;;;;"}

package/dist/queries.esm.js

@@ -0,0 +1,54 @@
+const INSTANCES_BY_PROJECT = `
+  query MassdriverInstancesByProject($organizationId: ID!, $projectId: ID!, $cursor: Cursor) {
+    instances(
+      organizationId: $organizationId
+      filter: { projectId: { eq: $projectId } }
+      cursor: $cursor
+    ) {
+      items {
+        id
+        name
+        status
+        resolvedVersion
+        deployedVersion
+      }
+      cursor {
+        next
+      }
+    }
+  }
+`;
+const INSTANCES_BY_ENVIRONMENT = `
+  query MassdriverInstancesByEnvironment($organizationId: ID!, $environmentId: ID!, $cursor: Cursor) {
+    instances(
+      organizationId: $organizationId
+      filter: { environmentId: { eq: $environmentId } }
+      cursor: $cursor
+    ) {
+      items {
+        id
+        name
+        status
+        resolvedVersion
+        deployedVersion
+      }
+      cursor {
+        next
+      }
+    }
+  }
+`;
+const INSTANCE_BY_ID = `
+  query MassdriverInstance($organizationId: ID!, $id: ID!) {
+    instance(organizationId: $organizationId, id: $id) {
+      id
+      name
+      status
+      resolvedVersion
+      deployedVersion
+    }
+  }
+`;
+
+export { INSTANCES_BY_ENVIRONMENT, INSTANCES_BY_PROJECT, INSTANCE_BY_ID };
+//# sourceMappingURL=queries.esm.js.map

package/dist/queries.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queries.esm.js","sources":["../src/queries.ts"],"sourcesContent":["import { InstanceStatus } from '@massdriver/backstage-plugin-common';\n\n/** Instance fields fetched for tables and cards. */\nexport interface InstanceRow {\n  id: string;\n  name: string;\n  status: InstanceStatus;\n  resolvedVersion?: string | null;\n  deployedVersion?: string | null;\n}\n\nexport const INSTANCES_BY_PROJECT = `\n  query MassdriverInstancesByProject($organizationId: ID!, $projectId: ID!, $cursor: Cursor) {\n    instances(\n      organizationId: $organizationId\n      filter: { projectId: { eq: $projectId } }\n      cursor: $cursor\n    ) {\n      items {\n        id\n        name\n        status\n        resolvedVersion\n        deployedVersion\n      }\n      cursor {\n        next\n      }\n    }\n  }\n`;\n\nexport const INSTANCES_BY_ENVIRONMENT = `\n  query MassdriverInstancesByEnvironment($organizationId: ID!, $environmentId: ID!, $cursor: Cursor) {\n    instances(\n      organizationId: $organizationId\n      filter: { environmentId: { eq: $environmentId } }\n      cursor: $cursor\n    ) {\n      items {\n        id\n        name\n        status\n        resolvedVersion\n        deployedVersion\n      }\n      cursor {\n        next\n      }\n    }\n  }\n`;\n\nexport const INSTANCE_BY_ID = `\n  query MassdriverInstance($organizationId: ID!, $id: ID!) {\n    instance(organizationId: $organizationId, id: $id) {\n      id\n      name\n      status\n      resolvedVersion\n      deployedVersion\n    }\n  }\n`;\n\nexport interface InstancesPageResult {\n  instances: {\n    items: (InstanceRow | null)[] | null;\n    cursor: { next: string | null };\n  };\n}\n\nexport interface InstanceResult {\n  instance: InstanceRow | null;\n}\n"],"names":[],"mappings":"AAWO,MAAM,oBAAA,GAAuB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAqB7B,MAAM,wBAAA,GAA2B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAqBjC,MAAM,cAAA,GAAiB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;;"}

package/dist/routes.esm.js

@@ -0,0 +1,6 @@
+import { createRouteRef } from '@backstage/frontend-plugin-api';
+
+const rootRouteRef = createRouteRef();
+
+export { rootRouteRef };
+//# sourceMappingURL=routes.esm.js.map

package/dist/routes.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.esm.js","sources":["../src/routes.ts"],"sourcesContent":["import { createRouteRef } from '@backstage/frontend-plugin-api';\n\nexport const rootRouteRef = createRouteRef();\n"],"names":[],"mappings":";;AAEO,MAAM,eAAe,cAAA;;;;"}

package/dist/shell/MassdriverHeader.esm.js

@@ -0,0 +1,37 @@
+import { jsxs, jsx } from 'react/jsx-runtime';
+import Box from '@massdriver/ui/Box';
+import IconButton from '@massdriver/ui/IconButton';
+import Tooltip from '@massdriver/ui/Tooltip';
+import stylin from '@massdriver/ui/stylin';
+import DarkModeIcon from '@massdriver/ui/icons/DarkModeIcon';
+import LightModeIcon from '@massdriver/ui/icons/LightModeIcon';
+import darkBgLogo from '../assets/massdriver-logo-dark.svg';
+import lightBgLogo from '../assets/massdriver-logo-light.svg';
+import { useThemeMode } from '../theme/ThemeModeContext.esm.js';
+
+const MassdriverHeader = () => {
+  const { mode, toggleMode } = useThemeMode();
+  return /* @__PURE__ */ jsxs(HeaderRoot, { children: [
+    /* @__PURE__ */ jsx(Logo, { src: mode === "dark" ? darkBgLogo : lightBgLogo, alt: "Massdriver" }),
+    /* @__PURE__ */ jsx(Tooltip, { title: "Toggle theme", arrow: true, children: /* @__PURE__ */ jsx(IconButton, { onClick: toggleMode, "aria-label": "toggle theme", size: "small", children: mode === "dark" ? /* @__PURE__ */ jsx(LightModeIcon, { fontSize: "small" }) : /* @__PURE__ */ jsx(DarkModeIcon, { fontSize: "small" }) }) })
+  ] });
+};
+const HeaderRoot = stylin(Box)(({ theme }) => ({
+  display: "flex",
+  alignItems: "center",
+  justifyContent: "space-between",
+  height: 56,
+  flexShrink: 0,
+  paddingLeft: theme.spacing(3),
+  paddingRight: theme.spacing(2),
+  borderBottom: `1px solid ${theme.palette.divider}`,
+  backgroundColor: theme.palette.background.paper
+}));
+const Logo = stylin("img")({
+  height: 32,
+  width: "auto",
+  display: "block"
+});
+
+export { MassdriverHeader };
+//# sourceMappingURL=MassdriverHeader.esm.js.map

package/dist/shell/MassdriverHeader.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MassdriverHeader.esm.js","sources":["../../src/shell/MassdriverHeader.tsx"],"sourcesContent":["import Box from '@massdriver/ui/Box';\nimport IconButton from '@massdriver/ui/IconButton';\nimport Tooltip from '@massdriver/ui/Tooltip';\nimport stylin from '@massdriver/ui/stylin';\nimport DarkModeIcon from '@massdriver/ui/icons/DarkModeIcon';\nimport LightModeIcon from '@massdriver/ui/icons/LightModeIcon';\nimport darkBgLogo from '../assets/massdriver-logo-dark.svg';\nimport lightBgLogo from '../assets/massdriver-logo-light.svg';\nimport { useThemeMode } from '../theme/ThemeModeContext';\n\n/**\n * Minimal header for the embedded Massdriver views: just the logo and a\n * light/dark theme toggle. No navigation, no account menu — Backstage provides\n * the surrounding chrome.\n */\nexport const MassdriverHeader = () => {\n  const { mode, toggleMode } = useThemeMode();\n\n  return (\n    <HeaderRoot>\n      <Logo src={mode === 'dark' ? darkBgLogo : lightBgLogo} alt=\"Massdriver\" />\n      <Tooltip title=\"Toggle theme\" arrow>\n        <IconButton onClick={toggleMode} aria-label=\"toggle theme\" size=\"small\">\n          {mode === 'dark' ? (\n            <LightModeIcon fontSize=\"small\" />\n          ) : (\n            <DarkModeIcon fontSize=\"small\" />\n          )}\n        </IconButton>\n      </Tooltip>\n    </HeaderRoot>\n  );\n};\n\nconst HeaderRoot = stylin(Box)(({ theme }: { theme: any }) => ({\n  display: 'flex',\n  alignItems: 'center',\n  justifyContent: 'space-between',\n  height: 56,\n  flexShrink: 0,\n  paddingLeft: theme.spacing(3),\n  paddingRight: theme.spacing(2),\n  borderBottom: `1px solid ${theme.palette.divider}`,\n  backgroundColor: theme.palette.background.paper,\n}));\n\nconst Logo = stylin('img')({\n  height: 32,\n  width: 'auto',\n  display: 'block',\n});\n"],"names":[],"mappings":";;;;;;;;;;;AAeO,MAAM,mBAAmB,MAAM;AACpC,EAAA,MAAM,EAAE,IAAA,EAAM,UAAA,EAAW,GAAI,YAAA,EAAa;AAE1C,EAAA,4BACG,UAAA,EAAA,EACC,QAAA,EAAA;AAAA,oBAAA,GAAA,CAAC,QAAK,GAAA,EAAK,IAAA,KAAS,SAAS,UAAA,GAAa,WAAA,EAAa,KAAI,YAAA,EAAa,CAAA;AAAA,oBACxE,GAAA,CAAC,OAAA,EAAA,EAAQ,KAAA,EAAM,cAAA,EAAe,KAAA,EAAK,IAAA,EACjC,QAAA,kBAAA,GAAA,CAAC,UAAA,EAAA,EAAW,OAAA,EAAS,UAAA,EAAY,YAAA,EAAW,cAAA,EAAe,IAAA,EAAK,SAC7D,QAAA,EAAA,IAAA,KAAS,MAAA,mBACR,GAAA,CAAC,aAAA,EAAA,EAAc,QAAA,EAAS,OAAA,EAAQ,CAAA,mBAEhC,GAAA,CAAC,YAAA,EAAA,EAAa,QAAA,EAAS,OAAA,EAAQ,CAAA,EAEnC,CAAA,EACF;AAAA,GAAA,EACF,CAAA;AAEJ;AAEA,MAAM,aAAa,MAAA,CAAO,GAAG,EAAE,CAAC,EAAE,OAAM,MAAuB;AAAA,EAC7D,OAAA,EAAS,MAAA;AAAA,EACT,UAAA,EAAY,QAAA;AAAA,EACZ,cAAA,EAAgB,eAAA;AAAA,EAChB,MAAA,EAAQ,EAAA;AAAA,EACR,UAAA,EAAY,CAAA;AAAA,EACZ,WAAA,EAAa,KAAA,CAAM,OAAA,CAAQ,CAAC,CAAA;AAAA,EAC5B,YAAA,EAAc,KAAA,CAAM,OAAA,CAAQ,CAAC,CAAA;AAAA,EAC7B,YAAA,EAAc,CAAA,UAAA,EAAa,KAAA,CAAM,OAAA,CAAQ,OAAO,CAAA,CAAA;AAAA,EAChD,eAAA,EAAiB,KAAA,CAAM,OAAA,CAAQ,UAAA,CAAW;AAC5C,CAAA,CAAE,CAAA;AAEF,MAAM,IAAA,GAAO,MAAA,CAAO,KAAK,CAAA,CAAE;AAAA,EACzB,MAAA,EAAQ,EAAA;AAAA,EACR,KAAA,EAAO,MAAA;AAAA,EACP,OAAA,EAAS;AACX,CAAC,CAAA;;;;"}

package/dist/shell/MassdriverShell.esm.js

@@ -0,0 +1,30 @@
+import { jsx, jsxs } from 'react/jsx-runtime';
+import Box from '@massdriver/ui/Box';
+import stylin from '@massdriver/ui/stylin';
+import { ThemeModeProvider } from '../theme/ThemeModeContext.esm.js';
+import { MassdriverThemeScope } from '../theme/MassdriverThemeScope.esm.js';
+import { MassdriverHeader } from './MassdriverHeader.esm.js';
+
+const MassdriverShell = ({ children }) => /* @__PURE__ */ jsx(ThemeModeProvider, { children: /* @__PURE__ */ jsx(MassdriverThemeScope, { children: /* @__PURE__ */ jsxs(ShellRoot, { children: [
+  /* @__PURE__ */ jsx(MassdriverHeader, {}),
+  /* @__PURE__ */ jsx(ShellContent, { children })
+] }) }) });
+const ShellRoot = stylin(Box)(({ theme }) => ({
+  display: "flex",
+  flexDirection: "column",
+  // The Backstage sidebar layout gives its content full viewport height with
+  // no top bar, so fill the viewport and let the content region scroll.
+  height: "100vh",
+  minHeight: 0,
+  overflow: "hidden",
+  backgroundColor: theme.palette.background.default,
+  color: theme.palette.text.primary
+}));
+const ShellContent = stylin(Box)({
+  flex: 1,
+  minHeight: 0,
+  overflow: "auto"
+});
+
+export { MassdriverShell };
+//# sourceMappingURL=MassdriverShell.esm.js.map

package/dist/shell/MassdriverShell.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MassdriverShell.esm.js","sources":["../../src/shell/MassdriverShell.tsx"],"sourcesContent":["import Box from '@massdriver/ui/Box';\nimport stylin from '@massdriver/ui/stylin';\nimport { ReactNode } from 'react';\nimport { ThemeModeProvider } from '../theme/ThemeModeContext';\nimport { MassdriverThemeScope } from '../theme/MassdriverThemeScope';\nimport { MassdriverHeader } from './MassdriverHeader';\n\n/**\n * Wraps every embedded Massdriver view: owns theme-mode state, applies the\n * Massdriver theme scope, and renders the dummy header above the routed\n * content. Fills the Backstage content area (the page uses `noHeader`).\n *\n * @public\n */\nexport const MassdriverShell = ({ children }: { children: ReactNode }) => (\n  <ThemeModeProvider>\n    <MassdriverThemeScope>\n      <ShellRoot>\n        <MassdriverHeader />\n        <ShellContent>{children}</ShellContent>\n      </ShellRoot>\n    </MassdriverThemeScope>\n  </ThemeModeProvider>\n);\n\nconst ShellRoot = stylin(Box)(({ theme }: { theme: any }) => ({\n  display: 'flex',\n  flexDirection: 'column',\n  // The Backstage sidebar layout gives its content full viewport height with\n  // no top bar, so fill the viewport and let the content region scroll.\n  height: '100vh',\n  minHeight: 0,\n  overflow: 'hidden',\n  backgroundColor: theme.palette.background.default,\n  color: theme.palette.text.primary,\n}));\n\nconst ShellContent = stylin(Box)({\n  flex: 1,\n  minHeight: 0,\n  overflow: 'auto',\n});\n"],"names":[],"mappings":";;;;;;;AAcO,MAAM,eAAA,GAAkB,CAAC,EAAE,QAAA,EAAS,yBACxC,iBAAA,EAAA,EACC,QAAA,kBAAA,GAAA,CAAC,oBAAA,EAAA,EACC,QAAA,kBAAA,IAAA,CAAC,SAAA,EAAA,EACC,QAAA,EAAA;AAAA,kBAAA,GAAA,CAAC,gBAAA,EAAA,EAAiB,CAAA;AAAA,kBAClB,GAAA,CAAC,gBAAc,QAAA,EAAS;AAAA,CAAA,EAC1B,GACF,CAAA,EACF;AAGF,MAAM,YAAY,MAAA,CAAO,GAAG,EAAE,CAAC,EAAE,OAAM,MAAuB;AAAA,EAC5D,OAAA,EAAS,MAAA;AAAA,EACT,aAAA,EAAe,QAAA;AAAA;AAAA;AAAA,EAGf,MAAA,EAAQ,OAAA;AAAA,EACR,SAAA,EAAW,CAAA;AAAA,EACX,QAAA,EAAU,QAAA;AAAA,EACV,eAAA,EAAiB,KAAA,CAAM,OAAA,CAAQ,UAAA,CAAW,OAAA;AAAA,EAC1C,KAAA,EAAO,KAAA,CAAM,OAAA,CAAQ,IAAA,CAAK;AAC5B,CAAA,CAAE,CAAA;AAEF,MAAM,YAAA,GAAe,MAAA,CAAO,GAAG,CAAA,CAAE;AAAA,EAC/B,IAAA,EAAM,CAAA;AAAA,EACN,SAAA,EAAW,CAAA;AAAA,EACX,QAAA,EAAU;AACZ,CAAC,CAAA;;;;"}

package/dist/theme/MassdriverThemeScope.esm.js

@@ -0,0 +1,30 @@
+import { jsx } from 'react/jsx-runtime';
+import createCache from '@emotion/cache';
+import { CacheProvider } from '@emotion/react';
+import { DarkTheme, LightTheme } from '@massdriver/ui/theme';
+import ScopedCssBaseline from '@mui/material/ScopedCssBaseline';
+import { ThemeProvider } from '@mui/material/styles';
+import { useEffect } from 'react';
+import { auditMuiClassNameConsistency } from './muiClassNameAudit.esm.js';
+import { useThemeMode } from './ThemeModeContext.esm.js';
+
+const massdriverCache = createCache({ key: "mdui" });
+let classNameAuditDone = false;
+const MassdriverThemeScope = ({ children }) => {
+  const { mode } = useThemeMode();
+  const theme = mode === "dark" ? DarkTheme : LightTheme;
+  useEffect(() => {
+    if (classNameAuditDone || process.env.NODE_ENV === "production") {
+      return;
+    }
+    classNameAuditDone = true;
+    const warning = auditMuiClassNameConsistency();
+    if (warning) {
+      console.warn(warning);
+    }
+  }, []);
+  return /* @__PURE__ */ jsx(CacheProvider, { value: massdriverCache, children: /* @__PURE__ */ jsx(ThemeProvider, { theme, children: /* @__PURE__ */ jsx(ScopedCssBaseline, { children }) }) });
+};
+
+export { MassdriverThemeScope };
+//# sourceMappingURL=MassdriverThemeScope.esm.js.map