@techdocs/cli 1.8.17-next.0 → 1.8.17-next.1

package/dist/index.cjs.js

@@ -228,7 +228,7 @@ function lazy(getActionFunc) {
   };
 }
 
-var version = "1.8.17-next.0";
+var version = "1.8.17-next.1";
 
 const main = (argv) => {
   commander.program.name("techdocs-cli").version(version);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@techdocs/cli",
   "description": "Utility CLI for managing TechDocs sites in Backstage.",
-  "version": "1.8.17-next.0",
+  "version": "1.8.17-next.1",
   "publishConfig": {
     "access": "public"
   },
@@ -35,7 +35,7 @@
     "techdocs-cli": "bin/techdocs-cli"
   },
   "devDependencies": {
-    "@backstage/cli": "^0.27.0-next.0",
+    "@backstage/cli": "^0.27.0-next.1",
     "@types/commander": "^2.12.2",
     "@types/fs-extra": "^11.0.0",
     "@types/http-proxy": "^1.17.4",
@@ -56,11 +56,11 @@
     "ext": "ts"
   },
   "dependencies": {
-    "@backstage/backend-defaults": "^0.4.2-next.0",
+    "@backstage/backend-defaults": "^0.4.2-next.1",
     "@backstage/catalog-model": "^1.5.0",
     "@backstage/cli-common": "^0.1.14",
     "@backstage/config": "^1.2.0",
-    "@backstage/plugin-techdocs-node": "^1.12.9-next.0",
+    "@backstage/plugin-techdocs-node": "^1.12.9-next.1",
     "commander": "^12.0.0",
     "fs-extra": "^11.0.0",
     "global-agent": "^3.0.0",

package/dist/embedded-app/static/6545.f37f8e2b.chunk.js

@@ -1,3 +0,0 @@
-"use strict";(()=>{(self.webpackChunktechdocs_cli_embedded_app=self.webpackChunktechdocs_cli_embedded_app||[]).push([[6545],{37408:(H,A,t)=>{t.d(A,{o:()=>P});var a=t(31085),j=t(77125),T=t(58837),v=t(38605),S=t(31653),p=t(14041);const C=(0,T.A)(r=>({tabsWrapper:{gridArea:"pageSubheader",backgroundColor:r.palette.background.paper,paddingLeft:r.spacing(3),minWidth:0},defaultTab:{...r.typography.caption,padding:r.spacing(3,3),textTransform:"uppercase",fontWeight:r.typography.fontWeightBold,color:r.palette.text.secondary},selected:{color:r.palette.text.primary},tabRoot:{"&:hover":{backgroundColor:r.palette.background.default,color:r.palette.text.primary}}}),{name:"BackstageHeaderTabs"});function P(r){const{tabs:D,onChange:x,selectedIndex:i}=r,[B,E]=(0,p.useState)(i??0),c=C(),I=(0,p.useCallback)((g,m)=>{i===void 0&&E(m),x&&x(m)},[i,x]);return(0,p.useEffect)(()=>{i!==void 0&&E(i)},[i]),(0,a.jsx)(j.A,{className:c.tabsWrapper,children:(0,a.jsx)(S.A,{indicatorColor:"primary",textColor:"inherit",variant:"scrollable",scrollButtons:"auto","aria-label":"tabs",onChange:I,value:B,children:D.map((g,m)=>(0,a.jsx)(v.A,{"data-testid":`header-tab-${m}`,label:g.label,value:m,className:c.defaultTab,classes:{selected:c.selected,root:c.tabRoot},...g.tabProps},g.id))})})}},16545:(H,A,t)=>{t.r(A),t.d(A,{TechDocsCustomHome:()=>et});var a=t(31085),j=t(14041),T=t(73466),v=t(58837),S=t(51372),p=t(6820),C=t(72427),P=t(16009),r=t(67871);function D(){const e=(0,C.gf)(P.K),{loading:n,value:o}=(0,T.A)(async()=>{const{ownershipEntityRefs:s}=await e.getBackstageIdentity();return s},[]),d=(0,j.useMemo)(()=>{const s=new Set(o??[]);return u=>{const y=(0,r.t)(u,S.vv).map(p.U2);for(const h of y)if(s.has(h))return!0;return!1}},[o]);return{loading:n,isOwnedEntity:d}}var x=t(7341),i=t(86519),B=t(27125),E=t(82779),c=t(95768),I=t(9222),g=t(65461),m=t(77125),W=t(99703);const L=e=>(0,W.A)({root:{display:"grid",gridTemplateColumns:"repeat(auto-fill, minmax(22em, 1fr))",gridAutoRows:"1fr",gridGap:e.spacing(2)}}),b=(0,v.A)(L,{name:"BackstageItemCardGrid"});function K(e){const{children:n,...o}=e,d=b(o);return(0,a.jsx)(m.A,{className:d.root,...o,children:n})}var U=t(72501);const G=e=>(0,W.A)({root:{color:e.palette.common.white,padding:e.spacing(2,2,3),backgroundImage:e.getPageTheme({themeId:"card"}).backgroundImage,backgroundPosition:0,backgroundSize:"inherit"}}),N=(0,v.A)(G,{name:"BackstageItemCardHeader"});function V(e){const{title:n,subtitle:o,children:d}=e,s=N(e);return(0,a.jsxs)(m.A,{className:s.root,children:[o&&(0,a.jsx)(U.A,{variant:"subtitle2",component:"h3",children:o}),n&&(0,a.jsx)(U.A,{variant:"h6",component:"h4",children:n}),d]})}var z=t(73896),F=t(40703),Y=t(59469),$=t(48653),J=t(57369);const Q=e=>{const{entities:n}=e,o=(0,I.S)(E.Oc),d=(0,C.gf)(g.U);return n?(0,a.jsx)(K,{"data-testid":"docs-explore",children:n?.length?n.map((s,u)=>(0,a.jsxs)(F.A,{children:[(0,a.jsx)(J.A,{children:(0,a.jsx)(V,{title:s.metadata.title??s.metadata.name})}),(0,a.jsx)($.A,{children:s.metadata.description}),(0,a.jsx)(Y.A,{children:(0,a.jsx)(z.z,{to:o({namespace:(0,c.V)(s.metadata.namespace??"default",d),kind:(0,c.V)(s.kind,d),name:(0,c.V)(s.metadata.name,d)}),color:"primary","data-testid":"read_docs",children:"Read Docs"})})]},u)):null}):null};var O=t(81859),X=t(59428),Z=t(27586),R=t(26280),k=t(68146),w=t(88640),q=t(77310),_=t(37408);const tt={DocsTable:B.o,DocsCardGrid:Q},at=({config:e,entities:n,index:o})=>{const s=(0,v.A)({panelContainer:{marginBottom:"2rem",...e.panelCSS?e.panelCSS:{}}})(),{loading:u,isOwnedEntity:y}=D(),h=tt[e.panelType],M=n.filter(l=>e.filterPredicate==="ownedByUser"?u?!1:y(l):typeof e.filterPredicate=="function"&&e.filterPredicate(l));return(0,a.jsxs)(a.Fragment,{children:[(0,a.jsx)(X.d,{title:e.title,description:e.description,children:o===0?(0,a.jsx)(Z.Y,{children:"Discover documentation in your ecosystem."}):null}),(0,a.jsx)("div",{className:s.panelContainer,children:(0,a.jsx)(h,{"data-testid":"techdocs-custom-panel",entities:M})})]})},et=e=>{const{tabsConfig:n}=e,[o,d]=(0,j.useState)(0),s=(0,C.gf)(x.v),{value:u,loading:y,error:h}=(0,T.A)(async()=>(await s.getEntities({filter:{"metadata.annotations.backstage.io/techdocs-ref":i.c},fields:["apiVersion","kind","metadata","relations","spec.owner","spec.type"]})).items.filter(f=>!!f.metadata.annotations?.["backstage.io/techdocs-ref"])),M=n[o];return y?(0,a.jsx)(O.S,{children:(0,a.jsx)(R.U,{children:(0,a.jsx)(k.k,{})})}):h?(0,a.jsx)(O.S,{children:(0,a.jsx)(R.U,{children:(0,a.jsx)(w.B,{severity:"error",title:"Could not load available documentation.",children:(0,a.jsx)(q.z,{language:"text",text:h.toString()})})})}):(0,a.jsxs)(O.S,{children:[(0,a.jsx)(_.o,{selectedIndex:o,onChange:l=>d(l),tabs:n.map(({label:l},f)=>({id:f.toString(),label:l}))}),(0,a.jsx)(R.U,{"data-testid":"techdocs-content",children:M.panels.map((l,f)=>(0,a.jsx)(at,{config:l,entities:u||[],index:f},f))})]})}}}]);})();
-
-//# sourceMappingURL=6545.f37f8e2b.chunk.js.map

package/dist/embedded-app/static/6545.f37f8e2b.chunk.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"static/6545.f37f8e2b.chunk.js","mappings":"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","sources":["webpack://techdocs-cli-embedded-app/../core-components/src/layout/HeaderTabs/HeaderTabs.tsx","webpack://techdocs-cli-embedded-app/../../plugins/catalog-react/src/hooks/useEntityOwnership.ts","webpack://techdocs-cli-embedded-app/../core-components/src/layout/ItemCard/ItemCardGrid.tsx","webpack://techdocs-cli-embedded-app/../core-components/src/layout/ItemCard/ItemCardHeader.tsx","webpack://techdocs-cli-embedded-app/../../plugins/techdocs/src/home/components/Grids/DocsCardGrid.tsx","webpack://techdocs-cli-embedded-app/../../plugins/techdocs/src/home/components/TechDocsCustomHome.tsx"],"sourcesContent":["/*\n * Copyright 2020 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\nimport Box from '@material-ui/core/Box';\nimport { makeStyles } from '@material-ui/core/styles';\nimport TabUI, { TabProps } from '@material-ui/core/Tab';\nimport Tabs from '@material-ui/core/Tabs';\nimport React, { useCallback, useEffect, useState } from 'react';\n\n// TODO(blam): Remove this implementation when the Tabs are ready\n// This is just a temporary solution to implementing tabs for now\n\n/** @public */\nexport type HeaderTabsClassKey =\n  | 'tabsWrapper'\n  | 'defaultTab'\n  | 'selected'\n  | 'tabRoot';\n\nconst useStyles = makeStyles(\n  theme => ({\n    tabsWrapper: {\n      gridArea: 'pageSubheader',\n      backgroundColor: theme.palette.background.paper,\n      paddingLeft: theme.spacing(3),\n      minWidth: 0,\n    },\n    defaultTab: {\n      ...theme.typography.caption,\n      padding: theme.spacing(3, 3),\n      textTransform: 'uppercase',\n      fontWeight: theme.typography.fontWeightBold,\n      color: theme.palette.text.secondary,\n    },\n    selected: {\n      color: theme.palette.text.primary,\n    },\n    tabRoot: {\n      '&:hover': {\n        backgroundColor: theme.palette.background.default,\n        color: theme.palette.text.primary,\n      },\n    },\n  }),\n  { name: 'BackstageHeaderTabs' },\n);\n\nexport type Tab = {\n  id: string;\n  label: string;\n  tabProps?: TabProps<React.ElementType, { component?: React.ElementType }>;\n};\n\ntype HeaderTabsProps = {\n  tabs: Tab[];\n  onChange?: (index: number) => void;\n  selectedIndex?: number;\n};\n\n/**\n * Horizontal Tabs component\n *\n * @public\n *\n */\nexport function HeaderTabs(props: HeaderTabsProps) {\n  const { tabs, onChange, selectedIndex } = props;\n  const [selectedTab, setSelectedTab] = useState<number>(selectedIndex ?? 0);\n  const styles = useStyles();\n\n  const handleChange = useCallback(\n    (_: React.ChangeEvent<{}>, index: number) => {\n      if (selectedIndex === undefined) {\n        setSelectedTab(index);\n      }\n      if (onChange) onChange(index);\n    },\n    [selectedIndex, onChange],\n  );\n\n  useEffect(() => {\n    if (selectedIndex !== undefined) {\n      setSelectedTab(selectedIndex);\n    }\n  }, [selectedIndex]);\n\n  return (\n    <Box className={styles.tabsWrapper}>\n      <Tabs\n        indicatorColor=\"primary\"\n        textColor=\"inherit\"\n        variant=\"scrollable\"\n        scrollButtons=\"auto\"\n        aria-label=\"tabs\"\n        onChange={handleChange}\n        value={selectedTab}\n      >\n        {tabs.map((tab, index) => (\n          <TabUI\n            data-testid={`header-tab-${index}`}\n            label={tab.label}\n            key={tab.id}\n            value={index}\n            className={styles.defaultTab}\n            classes={{ selected: styles.selected, root: styles.tabRoot }}\n            {...tab.tabProps}\n          />\n        ))}\n      </Tabs>\n    </Box>\n  );\n}\n","/*\n * Copyright 2021 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  Entity,\n  RELATION_OWNED_BY,\n  stringifyEntityRef,\n} from '@backstage/catalog-model';\nimport { identityApiRef, useApi } from '@backstage/core-plugin-api';\nimport { useMemo } from 'react';\nimport useAsync from 'react-use/esm/useAsync';\nimport { getEntityRelations } from '../utils/getEntityRelations';\n\n/**\n * Returns a function that checks whether the currently signed-in user is an\n * owner of a given entity. When the hook is initially mounted, the loading\n * flag will be true and the results returned from the function will always be\n * false.\n *\n * @public\n *\n * @returns a function that checks if the signed in user owns an entity\n */\nexport function useEntityOwnership(): {\n  loading: boolean;\n  isOwnedEntity: (entity: Entity) => boolean;\n} {\n  const identityApi = useApi(identityApiRef);\n\n  // Trigger load only on mount\n  const { loading, value: refs } = useAsync(\n    async () => {\n      const { ownershipEntityRefs } = await identityApi.getBackstageIdentity();\n      return ownershipEntityRefs;\n    },\n    // load only on mount\n    [],\n  );\n\n  const isOwnedEntity = useMemo(() => {\n    const myOwnerRefs = new Set(refs ?? []);\n\n    return (entity: Entity) => {\n      const entityOwnerRefs = getEntityRelations(entity, RELATION_OWNED_BY).map(\n        stringifyEntityRef,\n      );\n      for (const ref of entityOwnerRefs) {\n        if (myOwnerRefs.has(ref)) {\n          return true;\n        }\n      }\n      return false;\n    };\n  }, [refs]);\n\n  return { loading, isOwnedEntity };\n}\n","/*\n * Copyright 2021 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\nimport Box from '@material-ui/core/Box';\nimport {\n  createStyles,\n  makeStyles,\n  Theme,\n  WithStyles,\n} from '@material-ui/core/styles';\nimport React from 'react';\n\n/** @public */\nexport type ItemCardGridClassKey = 'root';\n\nconst styles = (theme: Theme) =>\n  createStyles({\n    root: {\n      display: 'grid',\n      gridTemplateColumns: 'repeat(auto-fill, minmax(22em, 1fr))',\n      gridAutoRows: '1fr',\n      gridGap: theme.spacing(2),\n    },\n  });\n\nconst useStyles = makeStyles(styles, { name: 'BackstageItemCardGrid' });\n\n/** @public */\nexport type ItemCardGridProps = Partial<WithStyles<typeof styles>> & {\n  /**\n   * The Card items of the grid.\n   */\n  children?: React.ReactNode;\n};\n\n/**\n * A default grid to use when arranging \"item cards\" - cards that let users\n * select among several options.\n *\n * @remarks\n * The immediate children are expected to be Material UI Card components.\n *\n * Styles for the grid can be overridden using the `classes` prop, e.g.:\n *\n * `<ItemCardGrid title=\"Hello\" classes={{ root: myClassName }} />`\n *\n * This can be useful for e.g. overriding gridTemplateColumns to adapt the\n * minimum size of the cells to fit the content better.\n *\n * @public\n */\nexport function ItemCardGrid(props: ItemCardGridProps) {\n  const { children, ...otherProps } = props;\n  const classes = useStyles(otherProps);\n  return (\n    <Box className={classes.root} {...otherProps}>\n      {children}\n    </Box>\n  );\n}\n","/*\n * Copyright 2021 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport Box from '@material-ui/core/Box';\nimport {\n  createStyles,\n  makeStyles,\n  Theme,\n  WithStyles,\n} from '@material-ui/core/styles';\nimport Typography from '@material-ui/core/Typography';\nimport React from 'react';\n\n/** @public */\nexport type ItemCardHeaderClassKey = 'root';\n\nconst styles = (theme: Theme) =>\n  createStyles({\n    root: {\n      color: theme.palette.common.white,\n      padding: theme.spacing(2, 2, 3),\n      backgroundImage: theme.getPageTheme({ themeId: 'card' }).backgroundImage,\n      backgroundPosition: 0,\n      backgroundSize: 'inherit',\n    },\n  });\n\nconst useStyles = makeStyles(styles, { name: 'BackstageItemCardHeader' });\n\n/** @public */\nexport type ItemCardHeaderProps = Partial<WithStyles<typeof styles>> & {\n  /**\n   * A large title to show in the header, providing the main heading.\n   *\n   * Use this if you want to have the default styling and placement of a title.\n   */\n  title?: React.ReactNode;\n  /**\n   * A slightly smaller title to show in the header, providing additional\n   * details.\n   *\n   * Use this if you want to have the default styling and placement of a\n   * subtitle.\n   */\n  subtitle?: React.ReactNode;\n  /**\n   * Custom children to draw in the header.\n   *\n   * If the title and/or subtitle were specified, the children are drawn below\n   * those.\n   */\n  children?: React.ReactNode;\n};\n\n/**\n * A simple card header, rendering a default look for \"item cards\" - cards that\n * are arranged in a grid for users to select among several options.\n *\n * @remarks\n * This component expects to be placed within a Material UI `<CardMedia>`.\n *\n * Styles for the header can be overridden using the `classes` prop, e.g.:\n *\n * `<ItemCardHeader title=\"Hello\" classes={{ root: myClassName }} />`\n *\n * @public\n */\nexport function ItemCardHeader(props: ItemCardHeaderProps) {\n  const { title, subtitle, children } = props;\n  const classes = useStyles(props);\n  return (\n    <Box className={classes.root}>\n      {subtitle && (\n        <Typography variant=\"subtitle2\" component=\"h3\">\n          {subtitle}\n        </Typography>\n      )}\n      {title && (\n        <Typography variant=\"h6\" component=\"h4\">\n          {title}\n        </Typography>\n      )}\n      {children}\n    </Box>\n  );\n}\n","/*\n * Copyright 2021 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { rootDocsRouteRef } from '../../../routes';\nimport { toLowerMaybe } from '../../../helpers';\nimport { Entity } from '@backstage/catalog-model';\nimport { useApi, useRouteRef, configApiRef } from '@backstage/core-plugin-api';\nimport {\n  LinkButton,\n  ItemCardGrid,\n  ItemCardHeader,\n} from '@backstage/core-components';\nimport Card from '@material-ui/core/Card';\nimport CardActions from '@material-ui/core/CardActions';\nimport CardContent from '@material-ui/core/CardContent';\nimport CardMedia from '@material-ui/core/CardMedia';\nimport React from 'react';\n\n/**\n * Props for {@link DocsCardGrid}\n *\n * @public\n */\nexport type DocsCardGridProps = {\n  entities: Entity[] | undefined;\n};\n\n/**\n * Component which accepts a list of entities and renders a item card for each entity\n *\n * @public\n */\nexport const DocsCardGrid = (props: DocsCardGridProps) => {\n  const { entities } = props;\n  const getRouteToReaderPageFor = useRouteRef(rootDocsRouteRef);\n  const config = useApi(configApiRef);\n  if (!entities) return null;\n  return (\n    <ItemCardGrid data-testid=\"docs-explore\">\n      {!entities?.length\n        ? null\n        : entities.map((entity, index: number) => (\n            <Card key={index}>\n              <CardMedia>\n                <ItemCardHeader\n                  title={entity.metadata.title ?? entity.metadata.name}\n                />\n              </CardMedia>\n              <CardContent>{entity.metadata.description}</CardContent>\n              <CardActions>\n                <LinkButton\n                  to={getRouteToReaderPageFor({\n                    namespace: toLowerMaybe(\n                      entity.metadata.namespace ?? 'default',\n                      config,\n                    ),\n                    kind: toLowerMaybe(entity.kind, config),\n                    name: toLowerMaybe(entity.metadata.name, config),\n                  })}\n                  color=\"primary\"\n                  data-testid=\"read_docs\"\n                >\n                  Read Docs\n                </LinkButton>\n              </CardActions>\n            </Card>\n          ))}\n    </ItemCardGrid>\n  );\n};\n","/*\n * Copyright 2021 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport React, { useState } from 'react';\nimport useAsync from 'react-use/esm/useAsync';\nimport { makeStyles } from '@material-ui/core/styles';\nimport { CSSProperties } from '@material-ui/styles/withStyles';\nimport {\n  CATALOG_FILTER_EXISTS,\n  catalogApiRef,\n  CatalogApi,\n  useEntityOwnership,\n} from '@backstage/plugin-catalog-react';\nimport { Entity } from '@backstage/catalog-model';\nimport { DocsTable } from './Tables';\nimport { DocsCardGrid } from './Grids';\nimport { TechDocsPageWrapper } from './TechDocsPageWrapper';\n\nimport {\n  CodeSnippet,\n  Content,\n  HeaderTabs,\n  Progress,\n  WarningPanel,\n  SupportButton,\n  ContentHeader,\n} from '@backstage/core-components';\nimport { useApi } from '@backstage/core-plugin-api';\n\nconst panels = {\n  DocsTable: DocsTable,\n  DocsCardGrid: DocsCardGrid,\n};\n\n/**\n * Available panel types\n *\n * @public\n */\nexport type PanelType = 'DocsCardGrid' | 'DocsTable';\n\n/**\n * Type representing a TechDocsCustomHome panel.\n *\n * @public\n */\nexport interface PanelConfig {\n  title: string;\n  description: string;\n  panelType: PanelType;\n  panelCSS?: CSSProperties;\n  filterPredicate: ((entity: Entity) => boolean) | string;\n}\n\n/**\n * Type representing a TechDocsCustomHome tab.\n *\n * @public\n */\nexport interface TabConfig {\n  label: string;\n  panels: PanelConfig[];\n}\n\n/**\n * Type representing a list of TechDocsCustomHome tabs.\n *\n * @public\n */\nexport type TabsConfig = TabConfig[];\n\nconst CustomPanel = ({\n  config,\n  entities,\n  index,\n}: {\n  config: PanelConfig;\n  entities: Entity[];\n  index: number;\n}) => {\n  const useStyles = makeStyles({\n    panelContainer: {\n      marginBottom: '2rem',\n      ...(config.panelCSS ? config.panelCSS : {}),\n    },\n  });\n  const classes = useStyles();\n  const { loading: loadingOwnership, isOwnedEntity } = useEntityOwnership();\n\n  const Panel = panels[config.panelType];\n\n  const shownEntities = entities.filter(entity => {\n    if (config.filterPredicate === 'ownedByUser') {\n      if (loadingOwnership) {\n        return false;\n      }\n      return isOwnedEntity(entity);\n    }\n\n    return (\n      typeof config.filterPredicate === 'function' &&\n      config.filterPredicate(entity)\n    );\n  });\n\n  return (\n    <>\n      <ContentHeader title={config.title} description={config.description}>\n        {index === 0 ? (\n          <SupportButton>\n            Discover documentation in your ecosystem.\n          </SupportButton>\n        ) : null}\n      </ContentHeader>\n      <div className={classes.panelContainer}>\n        <Panel data-testid=\"techdocs-custom-panel\" entities={shownEntities} />\n      </div>\n    </>\n  );\n};\n\n/**\n * Props for {@link TechDocsCustomHome}\n *\n * @public\n */\nexport type TechDocsCustomHomeProps = {\n  tabsConfig: TabsConfig;\n};\n\nexport const TechDocsCustomHome = (props: TechDocsCustomHomeProps) => {\n  const { tabsConfig } = props;\n  const [selectedTab, setSelectedTab] = useState<number>(0);\n  const catalogApi: CatalogApi = useApi(catalogApiRef);\n\n  const {\n    value: entities,\n    loading,\n    error,\n  } = useAsync(async () => {\n    const response = await catalogApi.getEntities({\n      filter: {\n        'metadata.annotations.backstage.io/techdocs-ref': CATALOG_FILTER_EXISTS,\n      },\n      fields: [\n        'apiVersion',\n        'kind',\n        'metadata',\n        'relations',\n        'spec.owner',\n        'spec.type',\n      ],\n    });\n    return response.items.filter((entity: Entity) => {\n      return !!entity.metadata.annotations?.['backstage.io/techdocs-ref'];\n    });\n  });\n\n  const currentTabConfig = tabsConfig[selectedTab];\n\n  if (loading) {\n    return (\n      <TechDocsPageWrapper>\n        <Content>\n          <Progress />\n        </Content>\n      </TechDocsPageWrapper>\n    );\n  }\n\n  if (error) {\n    return (\n      <TechDocsPageWrapper>\n        <Content>\n          <WarningPanel\n            severity=\"error\"\n            title=\"Could not load available documentation.\"\n          >\n            <CodeSnippet language=\"text\" text={error.toString()} />\n          </WarningPanel>\n        </Content>\n      </TechDocsPageWrapper>\n    );\n  }\n\n  return (\n    <TechDocsPageWrapper>\n      <HeaderTabs\n        selectedIndex={selectedTab}\n        onChange={index => setSelectedTab(index)}\n        tabs={tabsConfig.map(({ label }, index) => ({\n          id: index.toString(),\n          label,\n        }))}\n      />\n      <Content data-testid=\"techdocs-content\">\n        {currentTabConfig.panels.map((config, index) => (\n          <CustomPanel\n            key={index}\n            config={config}\n            entities={!!entities ? entities : []}\n            index={index}\n          />\n        ))}\n      </Content>\n    </TechDocsPageWrapper>\n  );\n};\n"],"names":["useStyles","makeStyles","theme","tabsWrapper","gridArea","backgroundColor","palette","background","paper","paddingLeft","spacing","minWidth","defaultTab","typography","caption","padding","textTransform","fontWeight","fontWeightBold","color","text","secondary","selected","primary","tabRoot","default","name","HeaderTabs","props","tabs","onChange","selectedIndex","selectedTab","setSelectedTab","useState","styles","handleChange","useCallback","_","index","undefined","useEffect","Box","className","Tabs","indicatorColor","textColor","variant","scrollButtons","aria-label","value","map","tab","TabUI","data-testid","label","classes","root","tabProps","id","useEntityOwnership","identityApi","useApi","identityApiRef","loading","refs","useAsync","ownershipEntityRefs","getBackstageIdentity","isOwnedEntity","useMemo","myOwnerRefs","Set","entity","entityOwnerRefs","getEntityRelations","RELATION_OWNED_BY","stringifyEntityRef","ref","has","createStyles","display","gridTemplateColumns","gridAutoRows","gridGap","ItemCardGrid","children","otherProps","common","white","backgroundImage","getPageTheme","themeId","backgroundPosition","backgroundSize","ItemCardHeader","title","subtitle","Typography","component","DocsCardGrid","entities","getRouteToReaderPageFor","useRouteRef","rootDocsRouteRef","config","configApiRef","length","Card","CardMedia","metadata","CardContent","description","CardActions","LinkButton","to","namespace","toLowerMaybe","kind","panels","DocsTable","CustomPanel","panelContainer","marginBottom","panelCSS","loadingOwnership","Panel","panelType","shownEntities","filter","filterPredicate","ContentHeader","SupportButton","div","TechDocsCustomHome","tabsConfig","catalogApi","catalogApiRef","error","getEntities","CATALOG_FILTER_EXISTS","fields","items","annotations","currentTabConfig","TechDocsPageWrapper","Content","Progress","WarningPanel","severity","CodeSnippet","language","toString"],"sourceRoot":""}

package/dist/embedded-app/static/9605.57f9f1ff.chunk.js

@@ -1,11 +0,0 @@
-"use strict";(()=>{(self.webpackChunktechdocs_cli_embedded_app=self.webpackChunktechdocs_cli_embedded_app||[]).push([[9605,5788],{29605:(V,E,t)=>{t.r(E),t.d(E,{EmbeddedDocsRouter:()=>z,Router:()=>Y,isTechDocsAvailable:()=>S});var e=t(31085),h=t(14041),g=t(18690),x=t(6820),f=t(69954),v=t(16203),p=t(39299);const P="backstage.io/techdocs-entity",B=({entity:s})=>{let a=(0,x.sM)(s);if(s.metadata.annotations?.[P])try{a=(0,x.KU)(s.metadata.annotations?.[P])}catch{}return(0,e.jsxs)(f.Wj,{entityRef:a,children:[(0,e.jsx)(p.Z,{}),(0,e.jsx)(v.p,{withSearch:!1})]})};var L=t(85788),K=t(93160),A=t(99538),N=t(77125),U=t(64947),R=t(58837),T=t(72501),j=t(44186),M=t(77310),W=t(72072);const F=(0,R.A)(s=>({code:{borderRadius:6,margin:s.spacing(2,0),background:s.palette.type==="dark"?"#444":s.palette.common.white}}),{name:"BackstageMissingAnnotationEmptyState"});function H(s,a){const r=a?.kind||"Component",c=a?.metadata.name||"example",o=a?.spec?.type||"website",n=a?.spec?.owner||"user:default/guest",m=`apiVersion: backstage.io/v1alpha1
-kind: ${r}
-metadata:
-  name: ${c}
-  annotations:${s.map(i=>`
-    ${i}: value`).join("")}
-spec:
-  type: ${o}
-  owner: ${n}`;let d=6;const l=[];return s.forEach(()=>{l.push(d),d++}),{yamlText:m,lineNumbers:l}}function $(s,a="Component"){const r=s.length<=1;return(0,e.jsxs)(e.Fragment,{children:["The ",r?"annotation":"annotations"," ",s.map(c=>(0,e.jsx)("code",{children:c})).reduce((c,o)=>(0,e.jsxs)(e.Fragment,{children:[c,", ",o]}))," ",r?"is":"are"," missing. You need to add the"," ",r?"annotation":"annotations"," to your ",a," if you want to enable this tool."]})}function O(s){let a;try{a=(0,A.tN)().entity}catch{}const{annotation:r,readMoreUrl:c}=s,o=Array.isArray(r)?r:[r],n=c||"https://backstage.io/docs/features/software-catalog/well-known-annotations",m=F(),d=a?.kind||"Component",{yamlText:l,lineNumbers:i}=H(o,a);return(0,e.jsx)(j.p,{missing:"field",title:"Missing Annotation",description:$(o,d),action:(0,e.jsxs)(e.Fragment,{children:[(0,e.jsxs)(T.A,{variant:"body1",children:["Add the annotation to your ",d," YAML as shown in the highlighted example below:"]}),(0,e.jsx)(N.A,{className:m.code,children:(0,e.jsx)(M.z,{text:l,language:"yaml",showLineNumbers:!0,highlightedNumbers:i,customStyle:{background:"inherit",fontSize:"115%"}})}),(0,e.jsx)(U.A,{color:"primary",component:W.N_,to:n,children:"Read more"})]})})}const D="backstage.io/techdocs-ref",y="backstage.io/techdocs-entity",S=s=>!!s?.metadata?.annotations?.[D]||!!s?.metadata?.annotations?.[y],Y=()=>(0,e.jsxs)(g.BV,{children:[(0,e.jsx)(g.qh,{path:"/",element:(0,e.jsx)(L.TechDocsIndexPage,{})}),(0,e.jsx)(g.qh,{path:"/:namespace/:kind/:name/*",element:(0,e.jsx)(K.W,{})})]}),z=s=>{const{children:a}=s,{entity:r}=(0,A.tN)(),c=(0,g.Ye)([{path:"/*",element:(0,e.jsx)(B,{entity:r}),children:[{path:"*",element:a}]}]);return r.metadata.annotations?.[D]||r.metadata.annotations?.[y]?c:(0,e.jsx)(O,{annotation:[D]})}},85788:(V,E,t)=>{t.r(E),t.d(E,{TechDocsIndexPage:()=>f});var e=t(31085),h=t(14041),g=t(18690),x=t(85920);const f=v=>(0,g.P1)()||(0,e.jsx)(x.K,{...v})},93160:(V,E,t)=>{t.d(E,{b:()=>Y,W:()=>z});var e=t(31085),h=t(14041),g=t(18690),x=t(24504),f=t(72020),v=t(86892),p=t(16203),P=t(58269),B=t(39299),L=t(82779),K=t(70048),A=t(19402),N=t(22020),U=t(82266),R=t(64947),T=t(72427),j=t(70795),M=t(57405),W=t(16261);function F(s,a){const[r,c]=(0,h.useState)({status:"not-executed",error:void 0,result:a}),o=(0,h.useRef)(),n=(0,h.useRef)(),m=(0,W.J)({execute(...d){n.current=d;const l=s(...d);return o.current=l,c(i=>({...i,status:"loading"})),l.then(i=>{l===o.current&&c(u=>({...u,status:"success",error:void 0,result:i}))},i=>{l===o.current&&c(u=>({...u,status:"error",error:i}))}),l},reset(){c({status:"not-executed",error:void 0,result:a}),o.current=void 0,n.current=void 0}});return[r,(0,h.useMemo)(()=>({reset(){m.current.reset()},execute:(...d)=>m.current.execute(...d)}),[]),{promise:o.current,lastArgs:n.current}]}var H=t(76842),$=t(70835);const O="/.backstage/auth/v1/cookie",D=365*24*36e5;function y(s){const{pluginId:a}=s??{},r=(0,T.gf)(j.a),c=(0,T.gf)(M.I),o=(0,h.useMemo)(()=>"BroadcastChannel"in window?new BroadcastChannel(`${a}-auth-cookie-expires-at`):null,[a]),[n,m]=F(async()=>{const u=`${await c.getBaseUrl(a)}${O}`,C=await r.fetch(`${u}`,{credentials:"include"});if(!C.ok){if(C.status===404)return{expiresAt:new Date(Date.now()+D)};throw await $.o.fromResponse(C)}const I=await C.json();if(!I.expiresAt)throw new Error("No expiration date found in response");return I});(0,H.u)(m.execute);const d=(0,h.useCallback)(()=>{m.execute()},[m]),l=(0,h.useCallback)(i=>{const u=(1+3*Math.random())*6e4,C=Date.parse(i.expiresAt)-Date.now()-u,I=setTimeout(d,C);return()=>clearTimeout(I)},[d]);return(0,h.useEffect)(()=>{if(n.status!=="success"||!n.result)return()=>{};o?.postMessage({action:"COOKIE_REFRESH_SUCCESS",payload:n.result});let i=l(n.result);const u=C=>{const{action:I,payload:Z}=C.data;I==="COOKIE_REFRESH_SUCCESS"&&(i(),i=l(Z))};return o?.addEventListener("message",u),()=>{i(),o?.removeEventListener("message",u)}},[n,l,o]),n.status==="not-executed"?{status:"loading"}:n.status==="loading"&&!n.result?{status:"loading"}:n.status==="loading"&&n.error?{status:"loading"}:n.status==="error"&&n.error?{status:"error",error:n.error,retry:d}:{status:"success",data:n.result}}function S(s){const{children:a,...r}=s,c=(0,U.n)(),{Progress:o}=c.getComponents(),n=y(r);return n.status==="loading"?(0,e.jsx)(o,{}):n.status==="error"?(0,e.jsx)(N.b,{error:n.error,children:(0,e.jsx)(R.A,{variant:"outlined",onClick:n.retry,children:"Retry"})}):(0,e.jsx)(e.Fragment,{children:a})}const Y=s=>{const{withSearch:a,withHeader:r=!0}=s;return(0,e.jsxs)(x.Y,{themeId:"documentation",children:[r&&(0,e.jsx)(P.T,{}),(0,e.jsx)(B.Z,{}),(0,e.jsx)(p.p,{withSearch:a})]})},z=s=>{const{kind:a,name:r,namespace:c}=(0,K.K)(L.Oc),{children:o,entityRef:n={kind:a,name:r,namespace:c}}=s,m=(0,g.P1)();if(!o){const i=(m?h.Children.toArray(m.props.children):[]).flatMap(u=>u?.props?.children??[]).find(u=>!(0,A.E)(u,f.AF)&&!(0,A.E)(u,f.Wm));return(0,e.jsx)(S,{pluginId:"techdocs",children:(0,e.jsx)(v.R,{entityRef:n,children:i||(0,e.jsx)(Y,{})})})}return(0,e.jsx)(S,{pluginId:"techdocs",children:(0,e.jsx)(v.R,{entityRef:n,children:({metadata:d,entityMetadata:l,onReady:i})=>(0,e.jsx)("div",{className:"techdocs-reader-page",children:(0,e.jsx)(x.Y,{themeId:"documentation",children:o instanceof Function?o({entityRef:n,techdocsMetadataValue:d.value,entityMetadataValue:l.value,onReady:i}):o})})})})}},39299:(V,E,t)=>{t.d(E,{Z:()=>U});var e=t(31085),h=t(14041),g=t(58837),x=t(29365),f=t(75173),v=t(71677),p=t(37757),P=t(77125),B=t(9684),L=t(86892),K=t(72020),A=t(99730);const N=(0,g.A)(R=>({root:{gridArea:"pageSubheader",flexDirection:"column",minHeight:"auto",padding:R.spacing(3,3,0),"@media print":{display:"none"}}})),U=R=>{const T=N(),[j,M]=(0,h.useState)(null),W=(0,h.useCallback)(S=>{M(S.currentTarget)},[]),F=(0,h.useCallback)(()=>{M(null)},[]),{entityMetadata:{value:H,loading:$}}=(0,L.V)(),O=(0,K.YR)(),D=O.renderComponentsByLocation(A.e.Subheader),y=O.renderComponentsByLocation(A.e.Settings);return!D&&!y||$===!1&&!H?null:(0,e.jsx)(f.A,{classes:T,...R.toolbarProps,children:(0,e.jsxs)(P.A,{display:"flex",justifyContent:"flex-end",width:"100%",flexWrap:"wrap",children:[D,y?(0,e.jsxs)(e.Fragment,{children:[(0,e.jsx)(v.Ay,{title:"Settings",children:(0,e.jsx)(x.A,{"aria-controls":"tech-docs-reader-page-settings","aria-haspopup":"true",onClick:W,children:(0,e.jsx)(B.A,{})})}),(0,e.jsx)(p.A,{id:"tech-docs-reader-page-settings",getContentAnchorEl:null,anchorEl:j,anchorOrigin:{vertical:"bottom",horizontal:"right"},open:!!j,onClose:F,keepMounted:!0,children:(0,e.jsx)("div",{children:y})})]}):null]})})}}}]);})();
-
-//# sourceMappingURL=9605.57f9f1ff.chunk.js.map

package/dist/embedded-app/static/9605.57f9f1ff.chunk.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"static/9605.57f9f1ff.chunk.js","mappings":"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","sources":["webpack://techdocs-cli-embedded-app/../../plugins/techdocs/src/EntityPageDocs.tsx","webpack://techdocs-cli-embedded-app/../../plugins/catalog-react/src/components/MissingAnnotationEmptyState/MissingAnnotationEmptyState.tsx","webpack://techdocs-cli-embedded-app/../../plugins/techdocs/src/Router.tsx","webpack://techdocs-cli-embedded-app/../../plugins/techdocs/src/home/components/TechDocsIndexPage.tsx","webpack://techdocs-cli-embedded-app/../../node_modules/@react-hookz/web/src/useAsync/index.js","webpack://techdocs-cli-embedded-app/../../plugins/auth-react/src/hooks/useCookieAuthRefresh/useCookieAuthRefresh.tsx","webpack://techdocs-cli-embedded-app/../../plugins/auth-react/src/components/CookieAuthRefreshProvider/CookieAuthRefreshProvider.tsx","webpack://techdocs-cli-embedded-app/../../plugins/techdocs/src/reader/components/TechDocsReaderPage/TechDocsReaderPage.tsx","webpack://techdocs-cli-embedded-app/../../plugins/techdocs/src/reader/components/TechDocsReaderPageSubheader/TechDocsReaderPageSubheader.tsx"],"sourcesContent":["/*\n * Copyright 2020 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  Entity,\n  getCompoundEntityRef,\n  parseEntityRef,\n} from '@backstage/catalog-model';\n\nimport React from 'react';\nimport { TechDocsReaderPage } from './plugin';\nimport { TechDocsReaderPageContent } from './reader/components/TechDocsReaderPageContent';\nimport { TechDocsReaderPageSubheader } from './reader/components/TechDocsReaderPageSubheader';\n\nconst TECHDOCS_EXTERNAL_ANNOTATION = 'backstage.io/techdocs-entity';\n\ntype EntityPageDocsProps = { entity: Entity };\n\nexport const EntityPageDocs = ({ entity }: EntityPageDocsProps) => {\n  let entityRef = getCompoundEntityRef(entity);\n\n  if (entity.metadata.annotations?.[TECHDOCS_EXTERNAL_ANNOTATION]) {\n    try {\n      entityRef = parseEntityRef(\n        entity.metadata.annotations?.[TECHDOCS_EXTERNAL_ANNOTATION],\n      );\n    } catch {\n      // not a fan of this but we don't care if the parseEntityRef fails\n    }\n  }\n\n  return (\n    <TechDocsReaderPage entityRef={entityRef}>\n      <TechDocsReaderPageSubheader />\n      <TechDocsReaderPageContent withSearch={false} />\n    </TechDocsReaderPage>\n  );\n};\n","/*\n * Copyright 2020 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport Box from '@material-ui/core/Box';\nimport Button from '@material-ui/core/Button';\nimport { makeStyles } from '@material-ui/core/styles';\nimport Typography from '@material-ui/core/Typography';\nimport React from 'react';\nimport { CodeSnippet, Link, EmptyState } from '@backstage/core-components';\nimport { Entity } from '@backstage/catalog-model';\nimport { useEntity } from '../../hooks';\n\n/** @public */\nexport type MissingAnnotationEmptyStateClassKey = 'code';\n\nconst useStyles = makeStyles(\n  theme => ({\n    code: {\n      borderRadius: 6,\n      margin: theme.spacing(2, 0),\n      background:\n        theme.palette.type === 'dark' ? '#444' : theme.palette.common.white,\n    },\n  }),\n  { name: 'BackstageMissingAnnotationEmptyState' },\n);\n\nfunction generateYamlExample(\n  annotations: string[],\n  entity?: Entity,\n): { yamlText: string; lineNumbers: number[] } {\n  const kind = entity?.kind || 'Component';\n  const name = entity?.metadata.name || 'example';\n  const type = entity?.spec?.type || 'website';\n  const owner = entity?.spec?.owner || 'user:default/guest';\n\n  const yamlText = `apiVersion: backstage.io/v1alpha1\nkind: ${kind}\nmetadata:\n  name: ${name}\n  annotations:${annotations.map(ann => `\\n    ${ann}: value`).join('')}\nspec:\n  type: ${type}\n  owner: ${owner}`;\n\n  let line = 6; // Line 6 is the line number that annotations are added to.\n  const lineNumbers: number[] = [];\n  annotations.forEach(() => {\n    lineNumbers.push(line);\n    line++;\n  });\n\n  return {\n    yamlText,\n    lineNumbers,\n  };\n}\n\nfunction generateDescription(annotations: string[], entityKind = 'Component') {\n  const isSingular = annotations.length <= 1;\n  return (\n    <>\n      The {isSingular ? 'annotation' : 'annotations'}{' '}\n      {annotations\n        .map(ann => <code>{ann}</code>)\n        .reduce((prev, curr) => (\n          <>\n            {prev}, {curr}\n          </>\n        ))}{' '}\n      {isSingular ? 'is' : 'are'} missing. You need to add the{' '}\n      {isSingular ? 'annotation' : 'annotations'} to your {entityKind} if you\n      want to enable this tool.\n    </>\n  );\n}\n\n/**\n * @public\n * Renders an empty state when an annotation is missing from an entity.\n */\nexport function MissingAnnotationEmptyState(props: {\n  annotation: string | string[];\n  readMoreUrl?: string;\n}) {\n  let entity: Entity | undefined;\n  try {\n    const entityContext = useEntity();\n    entity = entityContext.entity;\n  } catch (err) {\n    // ignore when entity context doesnt exist\n  }\n\n  const { annotation, readMoreUrl } = props;\n  const annotations = Array.isArray(annotation) ? annotation : [annotation];\n  const url =\n    readMoreUrl ||\n    'https://backstage.io/docs/features/software-catalog/well-known-annotations';\n  const classes = useStyles();\n\n  const entityKind = entity?.kind || 'Component';\n  const { yamlText, lineNumbers } = generateYamlExample(annotations, entity);\n  return (\n    <EmptyState\n      missing=\"field\"\n      title=\"Missing Annotation\"\n      description={generateDescription(annotations, entityKind)}\n      action={\n        <>\n          <Typography variant=\"body1\">\n            Add the annotation to your {entityKind} YAML as shown in the\n            highlighted example below:\n          </Typography>\n          <Box className={classes.code}>\n            <CodeSnippet\n              text={yamlText}\n              language=\"yaml\"\n              showLineNumbers\n              highlightedNumbers={lineNumbers}\n              customStyle={{ background: 'inherit', fontSize: '115%' }}\n            />\n          </Box>\n          <Button color=\"primary\" component={Link} to={url}>\n            Read more\n          </Button>\n        </>\n      }\n    />\n  );\n}\n","/*\n * Copyright 2020 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport React, { PropsWithChildren } from 'react';\nimport { Route, Routes, useRoutes } from 'react-router-dom';\n\nimport { Entity } from '@backstage/catalog-model';\nimport { EntityPageDocs } from './EntityPageDocs';\nimport { TechDocsIndexPage } from './home/components/TechDocsIndexPage';\nimport { TechDocsReaderPage } from './reader/components/TechDocsReaderPage';\nimport {\n  useEntity,\n  MissingAnnotationEmptyState,\n} from '@backstage/plugin-catalog-react';\n\nconst TECHDOCS_ANNOTATION = 'backstage.io/techdocs-ref';\n\nconst TECHDOCS_EXTERNAL_ANNOTATION = 'backstage.io/techdocs-entity';\n\n/**\n * Helper that takes in entity and returns true/false if TechDocs is available for the entity\n *\n * @public\n */\nexport const isTechDocsAvailable = (entity: Entity) =>\n  Boolean(entity?.metadata?.annotations?.[TECHDOCS_ANNOTATION]) ||\n  Boolean(entity?.metadata?.annotations?.[TECHDOCS_EXTERNAL_ANNOTATION]);\n\n/**\n * Responsible for registering routes for TechDocs, TechDocs Homepage and separate TechDocs page\n *\n * @public\n */\nexport const Router = () => {\n  return (\n    <Routes>\n      <Route path=\"/\" element={<TechDocsIndexPage />} />\n      <Route\n        path=\"/:namespace/:kind/:name/*\"\n        element={<TechDocsReaderPage />}\n      />\n    </Routes>\n  );\n};\n\n/**\n * Responsible for registering route to view docs on Entity page\n *\n * @public\n */\nexport const EmbeddedDocsRouter = (props: PropsWithChildren<{}>) => {\n  const { children } = props;\n  const { entity } = useEntity();\n\n  // Using objects instead of <Route> elements, otherwise \"outlet\" will be null on sub-pages and add-ons won't render\n  const element = useRoutes([\n    {\n      path: '/*',\n      element: <EntityPageDocs entity={entity} />,\n      children: [\n        {\n          path: '*',\n          element: children,\n        },\n      ],\n    },\n  ]);\n\n  const projectId =\n    entity.metadata.annotations?.[TECHDOCS_ANNOTATION] ||\n    entity.metadata.annotations?.[TECHDOCS_EXTERNAL_ANNOTATION];\n\n  if (!projectId) {\n    return <MissingAnnotationEmptyState annotation={[TECHDOCS_ANNOTATION]} />;\n  }\n\n  return element;\n};\n","/*\n * Copyright 2021 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport React from 'react';\nimport { useOutlet } from 'react-router-dom';\nimport { TableColumn, TableProps } from '@backstage/core-components';\nimport {\n  EntityOwnerPickerProps,\n  UserListFilterKind,\n} from '@backstage/plugin-catalog-react';\nimport { DefaultTechDocsHome } from './DefaultTechDocsHome';\nimport { DocsTableRow } from './Tables';\n\n/**\n * Props for {@link TechDocsIndexPage}\n *\n * @public\n */\nexport type TechDocsIndexPageProps = {\n  initialFilter?: UserListFilterKind;\n  columns?: TableColumn<DocsTableRow>[];\n  actions?: TableProps<DocsTableRow>['actions'];\n  ownerPickerMode?: EntityOwnerPickerProps['mode'];\n};\n\nexport const TechDocsIndexPage = (props: TechDocsIndexPageProps) => {\n  const outlet = useOutlet();\n\n  return outlet || <DefaultTechDocsHome {...props} />;\n};\n","import { useMemo, useRef, useState } from 'react';\nimport { useSyncedRef } from '../useSyncedRef/index.js';\nexport function useAsync(asyncFn, initialValue) {\n    const [state, setState] = useState({\n        status: 'not-executed',\n        error: undefined,\n        result: initialValue,\n    });\n    const promiseRef = useRef();\n    const argsRef = useRef();\n    const methods = useSyncedRef({\n        execute(...params) {\n            argsRef.current = params;\n            const promise = asyncFn(...params);\n            promiseRef.current = promise;\n            setState((s) => ({ ...s, status: 'loading' }));\n            promise.then((result) => {\n                if (promise === promiseRef.current) {\n                    setState((s) => ({ ...s, status: 'success', error: undefined, result }));\n                }\n            }, (error) => {\n                if (promise === promiseRef.current) {\n                    setState((s) => ({ ...s, status: 'error', error }));\n                }\n            });\n            return promise;\n        },\n        reset() {\n            setState({\n                status: 'not-executed',\n                error: undefined,\n                result: initialValue,\n            });\n            promiseRef.current = undefined;\n            argsRef.current = undefined;\n        },\n    });\n    return [\n        state,\n        useMemo(() => ({\n            reset() {\n                methods.current.reset();\n            },\n            execute: (...params) => methods.current.execute(...params),\n        }), []),\n        { promise: promiseRef.current, lastArgs: argsRef.current },\n    ];\n}\n","/*\n * Copyright 2024 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { useEffect, useCallback, useMemo } from 'react';\nimport {\n  discoveryApiRef,\n  fetchApiRef,\n  useApi,\n} from '@backstage/core-plugin-api';\nimport { useAsync, useMountEffect } from '@react-hookz/web';\nimport { ResponseError } from '@backstage/errors';\n\nconst COOKIE_PATH = '/.backstage/auth/v1/cookie';\nconst ONE_YEAR_MS = 365 * 24 * 3600_000;\n\n/**\n * @public\n * A hook that will refresh the cookie when it is about to expire.\n * @param options - Options for configuring the refresh cookie endpoint\n */\nexport function useCookieAuthRefresh(options: {\n  // The plugin id used for discovering the API origin\n  pluginId: string;\n}):\n  | { status: 'loading' }\n  | { status: 'error'; error: Error; retry: () => void }\n  | { status: 'success'; data: { expiresAt: string } } {\n  const { pluginId } = options ?? {};\n  const fetchApi = useApi(fetchApiRef);\n  const discoveryApi = useApi(discoveryApiRef);\n\n  const channel = useMemo(() => {\n    return 'BroadcastChannel' in window\n      ? new BroadcastChannel(`${pluginId}-auth-cookie-expires-at`)\n      : null;\n  }, [pluginId]);\n\n  const [state, actions] = useAsync<{ expiresAt: string }>(async () => {\n    const apiOrigin = await discoveryApi.getBaseUrl(pluginId);\n    const requestUrl = `${apiOrigin}${COOKIE_PATH}`;\n    const response = await fetchApi.fetch(`${requestUrl}`, {\n      credentials: 'include',\n    });\n    if (!response.ok) {\n      // If we get a 404 from the cookie endpoint we assume that it does not\n      // exist and cookie auth is not needed. For all active tabs we don't\n      // schedule another refresh for the forseeable future, but new tabs will\n      // still check if cookie auth has been added to the deployment.\n      // TODO(Rugvip): Once the legacy backend system is no longer supported we should remove this check\n      if (response.status === 404) {\n        return { expiresAt: new Date(Date.now() + ONE_YEAR_MS) };\n      }\n      throw await ResponseError.fromResponse(response);\n    }\n    const data = await response.json();\n    if (!data.expiresAt) {\n      throw new Error('No expiration date found in response');\n    }\n    return data;\n  });\n\n  useMountEffect(actions.execute);\n\n  const retry = useCallback(() => {\n    actions.execute();\n  }, [actions]);\n\n  const refresh = useCallback(\n    (params: { expiresAt: string }) => {\n      // Randomize the refreshing margin with a margin of 1-4 minutes to avoid all tabs refreshing at the same time\n      // It cannot be less than 5 minutes otherwise the backend will return the same expiration date\n      const margin = (1 + 3 * Math.random()) * 60000;\n      const delay = Date.parse(params.expiresAt) - Date.now() - margin;\n      const timeout = setTimeout(retry, delay);\n      return () => clearTimeout(timeout);\n    },\n    [retry],\n  );\n\n  useEffect(() => {\n    // Only schedule a refresh if we have a successful response\n    if (state.status !== 'success' || !state.result) {\n      return () => {};\n    }\n    channel?.postMessage({\n      action: 'COOKIE_REFRESH_SUCCESS',\n      payload: state.result,\n    });\n    let cancel = refresh(state.result);\n    const listener = (\n      event: MessageEvent<{ action: string; payload: { expiresAt: string } }>,\n    ) => {\n      const { action, payload } = event.data;\n      if (action === 'COOKIE_REFRESH_SUCCESS') {\n        cancel();\n        cancel = refresh(payload);\n      }\n    };\n    channel?.addEventListener('message', listener);\n    return () => {\n      cancel();\n      channel?.removeEventListener('message', listener);\n    };\n  }, [state, refresh, channel]);\n\n  // Initialising\n  if (state.status === 'not-executed') {\n    return { status: 'loading' };\n  }\n\n  // First refresh or retrying without any success before\n  // Possible state transitions:\n  // e.g. not-executed -> loading (first-refresh)\n  // e.g. not-executed -> loading (first-refresh) -> error -> loading (manual-retry)\n  if (state.status === 'loading' && !state.result) {\n    return { status: 'loading' };\n  }\n\n  // Retrying after having succeeding at least once\n  // Current state is: { status: 'loading', result: {...}, error: undefined | Error }\n  // e.g. not-executed -> loading (first-refresh) -> success -> loading (scheduled-refresh) -> error -> loading (manual-retry)\n  if (state.status === 'loading' && state.error) {\n    return { status: 'loading' };\n  }\n\n  // Something went wrong during any situation of a refresh\n  if (state.status === 'error' && state.error) {\n    return { status: 'error', error: state.error, retry };\n  }\n\n  // At this point it should be safe to assume that we have a successful refresh\n  return { status: 'success', data: state.result! };\n}\n","/*\n * Copyright 2024 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport React, { ReactNode } from 'react';\nimport { ErrorPanel } from '@backstage/core-components';\nimport { useApp } from '@backstage/core-plugin-api';\nimport Button from '@material-ui/core/Button';\nimport { useCookieAuthRefresh } from '../../hooks';\n\n/**\n * @public\n * Props for the {@link CookieAuthRefreshProvider} component.\n */\nexport type CookieAuthRefreshProviderProps = {\n  // The plugin ID used for discovering the API origin\n  pluginId: string;\n  // The children to render when the refresh is successful\n  children: ReactNode;\n};\n\n/**\n * @public\n * A provider that will refresh the cookie when it is about to expire.\n */\nexport function CookieAuthRefreshProvider(\n  props: CookieAuthRefreshProviderProps,\n): JSX.Element {\n  const { children, ...options } = props;\n  const app = useApp();\n  const { Progress } = app.getComponents();\n\n  const result = useCookieAuthRefresh(options);\n\n  if (result.status === 'loading') {\n    return <Progress />;\n  }\n\n  if (result.status === 'error') {\n    return (\n      <ErrorPanel error={result.error}>\n        <Button variant=\"outlined\" onClick={result.retry}>\n          Retry\n        </Button>\n      </ErrorPanel>\n    );\n  }\n\n  return <>{children}</>;\n}\n","/*\n * Copyright 2022 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport React, { ReactNode, Children, ReactElement } from 'react';\nimport { useOutlet } from 'react-router-dom';\n\nimport { Page } from '@backstage/core-components';\nimport { CompoundEntityRef } from '@backstage/catalog-model';\nimport {\n  TECHDOCS_ADDONS_WRAPPER_KEY,\n  TECHDOCS_ADDONS_KEY,\n  TechDocsReaderPageProvider,\n} from '@backstage/plugin-techdocs-react';\n\nimport { TechDocsReaderPageRenderFunction } from '../../../types';\n\nimport { TechDocsReaderPageContent } from '../TechDocsReaderPageContent';\nimport { TechDocsReaderPageHeader } from '../TechDocsReaderPageHeader';\nimport { TechDocsReaderPageSubheader } from '../TechDocsReaderPageSubheader';\nimport { rootDocsRouteRef } from '../../../routes';\nimport {\n  getComponentData,\n  useRouteRefParams,\n} from '@backstage/core-plugin-api';\n\nimport { CookieAuthRefreshProvider } from '@backstage/plugin-auth-react';\n\n/* An explanation for the multiple ways of customizing the TechDocs reader page\n\nPlease refer to this page on the microsite for the latest recommended approach:\nhttps://backstage.io/docs/features/techdocs/how-to-guides#how-to-customize-the-techdocs-reader-page\n\nThe <TechDocsReaderPage> component is responsible for rendering the <TechDocsReaderPageProvider> and\nits contained version of a <Page>, which in turn renders the <TechDocsReaderPageContent>.\n\nHistorically, there have been different approaches on how this <Page> can be customized, and how the\n<TechDocsReaderPageContent> inside could be exchanged for a custom implementation (which was not\npossible before). Also, the current implementation supports every scenario to avoid breaking default\nconfigurations of TechDocs.\n\nIn particular, there are 4 different TechDocs page configurations:\n\nCONFIGURATION 1: <TechDocsReaderPage> only, no children\n\n<Route path=\"/docs/:namespace/:kind/:name/*\" element={<TechDocsReaderPage />} >\n\nThis is the simplest way to use TechDocs. Only a full page is passed, assuming that it comes with\nits content inside. Since we allowed customizing it, we started providing <TechDocsReaderLayout> as\na default implementation (which contains <TechDocsReaderPageContent>).\n\nCONFIGURATION 2 (not advised): <TechDocsReaderPage> with element children\n\n<Route\n  path=\"/docs/:namespace/:kind/:name/*\"\n  element={\n    <TechDocsReaderPage>\n      {techdocsPage}\n    </TechDocsReaderPage>\n  }\n/>\n\nPreviously, there were two ways of passing children to <TechDocsReaderPage>: either as elements (as\nshown above), or as a render function (described below in CONFIGURATION 3). The \"techdocsPage\" is\nlocated in packages/app/src/components/techdocs and is the default implementation of the content\ninside.\n\nCONFIGURATION 3 (not advised): <TechDocsReaderPage> with render function as child\n\n<Route\n  path=\"/docs/:namespace/:kind/:name/*\"\n  element={\n    <TechDocsReaderPage>\n      {({ metadata, entityMetadata, onReady }) => (\n        techdocsPage\n      )}\n    </TechDocsReaderPage>\n  }\n/>\n\nSimilar to CONFIGURATION 2, the direct children will be passed to the <TechDocsReaderPage> but in\nthis case interpreted as render prop.\n\nCONFIGURATION 4: <TechDocsReaderPage> and provided content in <Route>\n\n<Route\n  path=\"/docs/:namespace/:kind/:name/*\"\n  element={<TechDocsReaderPage />}\n>\n  {techDocsPage}\n  <TechDocsAddons>\n    <ExpandableNavigation />\n    <ReportIssue />\n    <TextSize />\n    <LightBox />\n  </TechDocsAddons>\n</Route>\n\nThis is the current state in packages/app/src/App.tsx and moved the location of children from inside\nthe element prop in the <Route> to the children of the <Route>. Then, in <TechDocsReaderPage> they\nare retrieved using the useOutlet hook from React Router.\n\nNOTE: Render functions are no longer supported in this approach.\n*/\n\n/**\n * Props for {@link TechDocsReaderLayout}\n * @public\n */\nexport type TechDocsReaderLayoutProps = {\n  /**\n   * Show or hide the header, defaults to true.\n   */\n  withHeader?: boolean;\n  /**\n   * Show or hide the content search bar, defaults to true.\n   */\n  withSearch?: boolean;\n};\n\n/**\n * Default TechDocs reader page structure composed with a header and content\n * @public\n */\nexport const TechDocsReaderLayout = (props: TechDocsReaderLayoutProps) => {\n  const { withSearch, withHeader = true } = props;\n  return (\n    <Page themeId=\"documentation\">\n      {withHeader && <TechDocsReaderPageHeader />}\n      <TechDocsReaderPageSubheader />\n      <TechDocsReaderPageContent withSearch={withSearch} />\n    </Page>\n  );\n};\n\n/**\n * @public\n */\nexport type TechDocsReaderPageProps = {\n  entityRef?: CompoundEntityRef;\n  children?: TechDocsReaderPageRenderFunction | ReactNode;\n};\n\n/**\n * An addon-aware implementation of the TechDocsReaderPage.\n *\n * @public\n */\nexport const TechDocsReaderPage = (props: TechDocsReaderPageProps) => {\n  const { kind, name, namespace } = useRouteRefParams(rootDocsRouteRef);\n  const { children, entityRef = { kind, name, namespace } } = props;\n\n  const outlet = useOutlet();\n\n  if (!children) {\n    const childrenList = outlet ? Children.toArray(outlet.props.children) : [];\n\n    const grandChildren = childrenList.flatMap<ReactElement>(\n      child => (child as ReactElement)?.props?.children ?? [],\n    );\n\n    const page: React.ReactNode = grandChildren.find(\n      grandChild =>\n        !getComponentData(grandChild, TECHDOCS_ADDONS_WRAPPER_KEY) &&\n        !getComponentData(grandChild, TECHDOCS_ADDONS_KEY),\n    );\n\n    // As explained above, \"page\" is configuration 4 and <TechDocsReaderLayout> is 1\n    return (\n      <CookieAuthRefreshProvider pluginId=\"techdocs\">\n        <TechDocsReaderPageProvider entityRef={entityRef}>\n          {(page as JSX.Element) || <TechDocsReaderLayout />}\n        </TechDocsReaderPageProvider>\n      </CookieAuthRefreshProvider>\n    );\n  }\n\n  // As explained above, a render function is configuration 3 and React element is 2\n  return (\n    <CookieAuthRefreshProvider pluginId=\"techdocs\">\n      <TechDocsReaderPageProvider entityRef={entityRef}>\n        {({ metadata, entityMetadata, onReady }) => (\n          <div className=\"techdocs-reader-page\">\n            <Page themeId=\"documentation\">\n              {children instanceof Function\n                ? children({\n                    entityRef,\n                    techdocsMetadataValue: metadata.value,\n                    entityMetadataValue: entityMetadata.value,\n                    onReady,\n                  })\n                : children}\n            </Page>\n          </div>\n        )}\n      </TechDocsReaderPageProvider>\n    </CookieAuthRefreshProvider>\n  );\n};\n","/*\n * Copyright 2022 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport React, { MouseEvent, useState, useCallback } from 'react';\n\nimport { makeStyles } from '@material-ui/core/styles';\nimport IconButton from '@material-ui/core/IconButton';\nimport Toolbar from '@material-ui/core/Toolbar';\nimport { ToolbarProps } from '@material-ui/core/Toolbar';\nimport Tooltip from '@material-ui/core/Tooltip';\nimport Menu from '@material-ui/core/Menu';\nimport Box from '@material-ui/core/Box';\nimport SettingsIcon from '@material-ui/icons/Settings';\n\nimport {\n  TechDocsAddonLocations as locations,\n  useTechDocsAddons,\n  useTechDocsReaderPage,\n} from '@backstage/plugin-techdocs-react';\n\nconst useStyles = makeStyles(theme => ({\n  root: {\n    gridArea: 'pageSubheader',\n    flexDirection: 'column',\n    minHeight: 'auto',\n    padding: theme.spacing(3, 3, 0),\n    '@media print': {\n      display: 'none',\n    },\n  },\n}));\n\n/**\n * Renders the reader page subheader.\n * Please use the Tech Docs add-ons to customize it\n * @public\n */\nexport const TechDocsReaderPageSubheader = (props: {\n  toolbarProps?: ToolbarProps;\n}) => {\n  const classes = useStyles();\n  const [anchorEl, setAnchorEl] = useState<null | HTMLElement>(null);\n\n  const handleClick = useCallback((event: MouseEvent<HTMLButtonElement>) => {\n    setAnchorEl(event.currentTarget);\n  }, []);\n\n  const handleClose = useCallback(() => {\n    setAnchorEl(null);\n  }, []);\n\n  const {\n    entityMetadata: { value: entityMetadata, loading: entityMetadataLoading },\n  } = useTechDocsReaderPage();\n\n  const addons = useTechDocsAddons();\n\n  const subheaderAddons = addons.renderComponentsByLocation(\n    locations.Subheader,\n  );\n\n  const settingsAddons = addons.renderComponentsByLocation(locations.Settings);\n\n  if (!subheaderAddons && !settingsAddons) return null;\n\n  // No entity metadata = 404. Don't render subheader on 404.\n  if (entityMetadataLoading === false && !entityMetadata) return null;\n\n  return (\n    <Toolbar classes={classes} {...props.toolbarProps}>\n      <Box\n        display=\"flex\"\n        justifyContent=\"flex-end\"\n        width=\"100%\"\n        flexWrap=\"wrap\"\n      >\n        {subheaderAddons}\n        {settingsAddons ? (\n          <>\n            <Tooltip title=\"Settings\">\n              <IconButton\n                aria-controls=\"tech-docs-reader-page-settings\"\n                aria-haspopup=\"true\"\n                onClick={handleClick}\n              >\n                <SettingsIcon />\n              </IconButton>\n            </Tooltip>\n            <Menu\n              id=\"tech-docs-reader-page-settings\"\n              getContentAnchorEl={null}\n              anchorEl={anchorEl}\n              anchorOrigin={{ vertical: 'bottom', horizontal: 'right' }}\n              open={Boolean(anchorEl)}\n              onClose={handleClose}\n              keepMounted\n            >\n              <div>{settingsAddons}</div>\n            </Menu>\n          </>\n        ) : null}\n      </Box>\n    </Toolbar>\n  );\n};\n"],"names":["TECHDOCS_EXTERNAL_ANNOTATION","EntityPageDocs","entity","entityRef","getCompoundEntityRef","metadata","annotations","parseEntityRef","TechDocsReaderPage","TechDocsReaderPageSubheader","TechDocsReaderPageContent","withSearch","useStyles","makeStyles","theme","code","borderRadius","margin","spacing","background","palette","type","common","white","name","generateYamlExample","kind","spec","owner","yamlText","map","ann","join","line","lineNumbers","forEach","push","generateDescription","entityKind","isSingular","length","reduce","prev","curr","MissingAnnotationEmptyState","props","useEntity","annotation","readMoreUrl","Array","isArray","url","classes","EmptyState","missing","title","description","action","Typography","variant","Box","className","CodeSnippet","text","language","showLineNumbers","highlightedNumbers","customStyle","fontSize","Button","color","component","Link","to","TECHDOCS_ANNOTATION","isTechDocsAvailable","Boolean","Router","Routes","Route","path","element","TechDocsIndexPage","EmbeddedDocsRouter","children","useRoutes","useOutlet","DefaultTechDocsHome","useAsync","asyncFn","initialValue","state","setState","promiseRef","argsRef","methods","useSyncedRef","params","promise","s","result","error","COOKIE_PATH","ONE_YEAR_MS","useCookieAuthRefresh","options","pluginId","fetchApi","useApi","fetchApiRef","discoveryApi","discoveryApiRef","channel","useMemo","window","BroadcastChannel","actions","requestUrl","getBaseUrl","response","fetch","credentials","ok","status","expiresAt","Date","now","ResponseError","fromResponse","data","json","Error","useMountEffect","execute","retry","useCallback","refresh","Math","random","delay","parse","timeout","setTimeout","clearTimeout","useEffect","postMessage","payload","cancel","listener","event","addEventListener","removeEventListener","CookieAuthRefreshProvider","app","useApp","Progress","getComponents","ErrorPanel","onClick","TechDocsReaderLayout","withHeader","Page","themeId","TechDocsReaderPageHeader","namespace","useRouteRefParams","rootDocsRouteRef","outlet","page","Children","toArray","flatMap","child","find","grandChild","getComponentData","TECHDOCS_ADDONS_WRAPPER_KEY","TECHDOCS_ADDONS_KEY","TechDocsReaderPageProvider","entityMetadata","onReady","div","Function","techdocsMetadataValue","value","entityMetadataValue","root","gridArea","flexDirection","minHeight","padding","display","anchorEl","setAnchorEl","useState","handleClick","currentTarget","handleClose","loading","entityMetadataLoading","useTechDocsReaderPage","addons","useTechDocsAddons","subheaderAddons","renderComponentsByLocation","locations","Subheader","settingsAddons","Settings","Toolbar","toolbarProps","justifyContent","width","flexWrap","Tooltip","IconButton","aria-controls","aria-haspopup","SettingsIcon","Menu","id","getContentAnchorEl","anchorOrigin","vertical","horizontal","open","onClose","keepMounted"],"sourceRoot":""}