@mdn/fred 0.1.0 → 0.2.0

package/components/observatory-results/server.css

@@ -1 +1,119 @@
-@import url("../observatory/index.css");
+@import url("../observatory/colors.css");
+@import url("../observatory/common.css");
+
+.observatory-results-wrapper {
+  display: grid;
+
+  grid-template-columns:
+    minmax(0, 0)
+    [full-start content-start]
+    minmax(0, 71rem)
+    [content-end]
+    var(--layout-sidebar-gap)
+    [sidebar-start right-sidebar-start]
+    minmax(var(--layout-sidebar-min), 1fr)
+    [full-end sidebar-end right-sidebar-end];
+
+  padding-inline: var(--layout-side-padding);
+  padding-top: 1rem;
+
+  background-color: var(--color-background-secondary);
+
+  @media (--screen-layout-no-sidebar) {
+    display: block;
+  }
+}
+
+.observatory-results {
+  grid-area: content;
+}
+
+.observatory-results-toc {
+  position: sticky;
+  top: var(--sticky-header-height);
+
+  grid-area: sidebar;
+
+  max-height: calc(100vh - var(--sticky-header-height));
+
+  padding: 0 0 2rem;
+  margin-bottom: 0;
+
+  overflow-y: auto;
+}
+
+.observatory-results-toc__heading {
+  margin: 0 0 1rem;
+  margin-top: 1.5rem;
+
+  font-size: var(--font-size-normal);
+  font-weight: 400;
+
+  color: var(--color-text-secondary);
+}
+
+.observatory-results-toc__list {
+  display: inline-block;
+
+  padding: 0 1rem;
+  margin: 0;
+
+  font-size: var(--font-size-normal);
+
+  text-decoration: none;
+
+  list-style: none;
+
+  border-left: 2px solid var(--color-border-primary);
+}
+
+.observatory-results-toc__item {
+  padding: 0.5rem 0;
+
+  a {
+    color: var(--color-text-primary);
+    text-decoration: none;
+
+    &:hover {
+      text-decoration: underline;
+    }
+  }
+}
+
+.observatory-results__header {
+  display: flex;
+
+  flex-direction: row;
+
+  column-gap: 2rem;
+  justify-content: space-between;
+
+  @media (--screen-small-and-narrower) {
+    flex-direction: column;
+    row-gap: 0.5rem;
+  }
+}
+
+.observatory-results__title {
+  padding: 0;
+  margin: 0;
+
+  font-size: var(--font-size-largest);
+  font-weight: var(--font-weight-bold);
+
+  line-height: var(--font-line-normal);
+
+  .accent {
+    color: var(--observatory-accent);
+  }
+}
+
+.observatory-results__feedback {
+  align-self: flex-end;
+  margin-bottom: 0.3rem;
+
+  @media (--screen-small-and-narrower) {
+    align-self: flex-start;
+    margin-bottom: 0;
+  }
+}

package/components/observatory-results/server.js

@@ -1,6 +1,7 @@
 import { html } from "lit";
 
-import { Feedback } from "../observatory-landing/feedback.js";
+import { Button } from "../button/server.js";
+import feedbackIcon from "../icon/circle-alert.svg?lit";
 import { PageLayout } from "../page-layout/server.js";
 import { ServerComponent } from "../server/index.js";
 
@@ -10,58 +11,61 @@ export class ObservatoryResults extends ServerComponent {
    * @returns {import("@lit").TemplateResult}
    */
   render(context) {
-    const extendedContext = {
-      ...context,
-      doc: {
-        parents: [
-          { uri: "/en-US/observatory", title: "HTTP Observatory" },
-          {
-            title: "Report",
-          },
-        ],
-      },
-    };
+    if (context.parents.length > 0) {
+      const lastParent = context.parents.at(-1);
+      if (lastParent) {
+        lastParent.uri = "#";
+      }
+    }
 
     return PageLayout.render(
-      extendedContext,
+      context,
       html`
-        <div class="obs-layout obs-layout--results">
-          <div class="obs-layout__content obs-layout__content--results">
-            <section class="obs-results">
-              <section class="obs-results__header">
-                <h1 class="obs-results__title">
-                  <span class="obs-results__title-accent"
-                    >${context.l10n("obs-title")}</span
-                  >
-                  ${context.l10n("Report")}
+        <main id="content" class="observatory">
+          <div class="observatory-results-wrapper">
+            <section class="observatory-results">
+              <section class="observatory-results__header">
+                <h1 class="observatory-results__title">
+                  <span class="accent">${context.l10n("obs-title")}</span>
+                  ${context.l10n("obs-report")}
                 </h1>
-                <div class="obs-results__feedback">${Feedback(context)}</div>
+                <div class="observatory-results__feedback">
+                  ${Button.render(context, {
+                    label: context.l10n`Report Feedback`,
+                    variant: "plain",
+                    icon: feedbackIcon,
+                    rel: "noopener",
+                    target: "_blank",
+                    href: "https://survey.alchemer.com/s3/7897385/MDN-HTTP-Observatory",
+                  })}
+                </div>
               </section>
 
-              <aside class="obs-toc">
-                <h2 class="obs-toc__heading">${context.l10n("obs-title")}</h2>
-                <ul class="obs-toc__list">
-                  <li class="obs-toc__item">
-                    <a
-                      href="/en-US/observatory/docs/tests_and_scoring"
-                      class="obs-toc__link"
-                      >Tests &amp; Scoring</a
-                    >
-                  </li>
-                  <li class="obs-toc__item">
-                    <a href="/en-US/observatory/docs/faq" class="obs-toc__link"
-                      >FAQ</a
-                    >
-                  </li>
-                </ul>
-              </aside>
-
               <mdn-observatory-results
-                class="obs-results__mdn-results"
+                class="observatory-results__mdn-results"
               ></mdn-observatory-results>
             </section>
+            <aside class="observatory-results-toc">
+              <h2 class="observatory-results-toc__heading">
+                ${context.l10n("obs-title")}
+              </h2>
+              <ul class="observatory-results-toc__list">
+                <li class="observatory-results-toc__item">
+                  <a
+                    href="/en-US/observatory/docs/tests_and_scoring"
+                    class="observatory-results-toc__link"
+                    >Tests &amp; Scoring</a
+                  >
+                </li>
+                <li class="observatory-results-toc__item">
+                  <a href="/en-US/observatory/docs/faq" class="obs-toc__link"
+                    >${context.l10n`FAQ`}</a
+                  >
+                </li>
+              </ul>
+            </aside>
           </div>
-        </div>
+        </main>
       `,
     );
   }

package/components/observatory-tests-and-scores/element.css

@@ -1,3 +1,5 @@
+@import url("../global/global.css");
+
 :host {
   display: block;
 }
@@ -21,7 +23,7 @@ h3 {
   margin-bottom: 1rem;
 
   font-size: var(--font-size-large);
-  font-weight: 400;
+  font-weight: var(--font-weight-normal);
 
   line-height: var(--font-line-content);
 }

package/components/outer-layout/server.js

@@ -60,6 +60,11 @@ export class OuterLayout extends ServerComponent {
       )
       .filter((x) => x !== undefined);
 
+    const area =
+      context.path.split("/")[3]?.toLowerCase() === "learn_web_development"
+        ? "learn"
+        : undefined;
+
     // if you want to put some script inline, put it in entry.inline.js
     // and you'll get CSP generation: see the README
     return html`
@@ -69,6 +74,7 @@ export class OuterLayout extends ServerComponent {
         style="color-scheme: light dark;"
         data-renderer=${context.renderer}
         data-noads=${ifDefined(WRITER_MODE ? "enabled" : undefined)}
+        data-current-area=${ifDefined(area)}
       >
         <head>
           <meta charset="UTF-8" />
@@ -77,7 +83,7 @@ export class OuterLayout extends ServerComponent {
             content="width=device-width, initial-scale=1.0"
           />
           <title>${context.pageTitle || "MDN"}</title>
-          ${Favicon()} ${unsafeHTML(`<script>${inlineScript}</script>`)}
+          ${unsafeHTML(`<script>${inlineScript}</script>`)}
           ${styles.map(
             (path) =>
               html`<link rel="stylesheet" href=${path} fetchpriority="high" />`,
@@ -96,7 +102,7 @@ export class OuterLayout extends ServerComponent {
           ${scripts?.map(
             (path) => html`<script src=${path} type="module"></script>`,
           )}
-          ${this._renderMeta(context)}
+          ${Favicon()} ${this._renderMeta(context)}
           <link
             rel="canonical"
             href=${`https://developer.mozilla.org${context.url}`}

package/components/placement-sidebar/element.css

@@ -95,7 +95,7 @@
           margin: 0.5rem auto 1rem 1rem;
 
           font-size: 0.75rem;
-          font-weight: 600;
+          font-weight: var(--font-weight-bold);
 
           color: var(--color);
 

package/components/play-console/element.css

@@ -10,7 +10,7 @@
 
   overflow: auto;
 
-  font-size: 0.875rem;
+  font-size: var(--font-size-small);
 
   background-color: var(--color-background-secondary);
 }

package/components/play-runner/element.css

@@ -1,5 +1,8 @@
 iframe {
+  box-sizing: content-box;
+
   width: 100%;
   height: 100%;
+
   border: none;
 }

package/components/playground/element.css

@@ -1,3 +1,5 @@
+@import url("../global/global.css");
+
 .wrapper {
   display: grid;
 
@@ -50,8 +52,6 @@
     }
 
     details {
-      display: flex;
-
       flex-shrink: 0;
       flex-direction: column;
 
@@ -64,10 +64,20 @@
         flex-grow: 1;
         flex-basis: 0;
         min-height: 12rem;
+
+        mdn-play-editor {
+          display: block;
+        }
+      }
+
+      &::details-content {
+        display: contents;
       }
 
       summary {
-        padding: 0.5rem;
+        height: 2em;
+
+        padding: 0.5em;
 
         line-height: var(--font-line-ui);
 
@@ -76,8 +86,8 @@
       }
 
       mdn-play-editor {
-        flex-grow: 1;
-        min-height: 0;
+        display: none;
+        height: calc(100% - 2em);
       }
     }
 
@@ -99,7 +109,7 @@
 
         div {
           font-size: var(--font-size-small);
-          font-weight: 600;
+          font-weight: var(--font-weight-bold);
           text-align: center;
         }
 
@@ -124,11 +134,8 @@
 mdn-modal {
   section {
     display: flex;
-
     flex-direction: column;
-
     gap: 0.5rem;
-    align-items: center;
 
     &:first-child {
       margin-bottom: 1rem;
@@ -140,4 +147,23 @@ mdn-modal {
     font-size: var(--font-size-normal);
     font-weight: normal;
   }
+
+  label {
+    display: flex;
+    flex-direction: column;
+    gap: 0.5rem;
+  }
+
+  p {
+    margin: 0;
+  }
+
+  &.share section {
+    align-items: center;
+  }
+
+  &.report section:last-child {
+    flex-direction: row;
+    justify-content: flex-end;
+  }
 }

package/components/playground/element.js

@@ -20,6 +20,7 @@ import "../placement-sidebar/element.js";
 
 /**
  * @import { MDNPlayController } from "../play-controller/element.js";
+ * @import { MDNModal } from "../modal/element.js";
  * @import { Ref } from "lit/directives/ref.js";
  */
 
@@ -28,14 +29,24 @@ const SESSION_KEY = "playground-session-code";
 export class MDNPlayground extends L10nMixin(LitElement) {
   static styles = styles;
 
+  static properties = {
+    _gistID: { state: true },
+  };
+
   constructor() {
     super();
     this._permalink = "";
     this._autoRun = true;
+    /** @type {string | undefined} */
+    this._gistId = undefined;
   }
 
   /** @type {Ref<MDNPlayController>} */
   _controller = createRef();
+  /** @type {Ref<MDNModal>} */
+  _shareModal = createRef();
+  /** @type {Ref<MDNModal>} */
+  _reportModal = createRef();
 
   _user = new Task(this, {
     task: async () => {
@@ -60,7 +71,7 @@ export class MDNPlayground extends L10nMixin(LitElement) {
   }
 
   _share() {
-    this.shadowRoot?.querySelector("mdn-modal")?.showModal();
+    this._shareModal.value?.showModal();
   }
 
   _clear() {
@@ -173,14 +184,21 @@ ${"```"}`,
       const params = new URLSearchParams(location.search);
       const idParam = params.get("id");
       const stateParam = params.get("state");
+      const srcPrefixParam = params.get("srcPrefix");
 
-      const { srcPrefix, code } =
+      if (idParam) {
+        this._gistId = idParam;
+      }
+
+      const { srcPrefix: srcPrefixState, code } =
         (await (idParam
           ? this._sessionFromApi(idParam)
           : stateParam
             ? this._sessionFromState(stateParam)
             : undefined)) || {};
 
+      const srcPrefix = srcPrefixParam || srcPrefixState;
+
       if (
         srcPrefix !== undefined &&
         code !== undefined &&
@@ -233,6 +251,28 @@ ${"```"}`,
     this.requestUpdate();
   }
 
+  _reportOpen() {
+    this._reportModal.value?.showModal();
+  }
+
+  _reportCancel() {
+    this._reportModal.value?.close();
+  }
+
+  async _reportSubmit() {
+    await fetch("/api/v1/play/flag", {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+      },
+      body: JSON.stringify({
+        id: this._gistId,
+        reason: this._reportModal.value?.querySelector("textarea")?.value,
+      }),
+    });
+    this._reportModal.value?.close();
+  }
+
   connectedCallback() {
     super.connectedCallback();
     this._user.run();
@@ -312,6 +352,11 @@ ${"```"}`,
             </details>
           </section>
           <section class="playground__runner-console">
+            ${this._gistId
+              ? html`<mdn-button @click=${this._reportOpen} variant="plain">
+                  Seeing something inappropriate?
+                </mdn-button>`
+              : nothing}
             <mdn-play-runner></mdn-play-runner>
             <div class="playground__console">
               <div>${this.l10n`Console`}</div>
@@ -321,7 +366,7 @@ ${"```"}`,
           <mdn-placement-sidebar horizontal></mdn-placement-sidebar>
         </mdn-play-controller>
       </div>
-      <mdn-modal>
+      <mdn-modal ${ref(this._shareModal)} class="share">
         <section>
           <h2>${this.l10n`Share Markdown`}</h2>
           <mdn-button variant="secondary" @click=${this._copyMarkdown}
@@ -351,6 +396,21 @@ ${"```"}`,
           })}
         </section>
       </mdn-modal>
+      <mdn-modal ${ref(this._reportModal)} class="report">
+        <section>
+          <p>Report this malicious or inappropriate shared playground.</p>
+          <label>
+            Can you please share some details on what's wrong with this content:
+            <textarea></textarea>
+          </label>
+        </section>
+        <section>
+          <mdn-button variant="secondary" @click=${this._reportCancel}
+            >Cancel</mdn-button
+          >
+          <mdn-button @click=${this._reportSubmit}>Report</mdn-button>
+        </section>
+      </mdn-modal>
     `;
   }
 

package/components/prev-next/index.css

@@ -2,7 +2,7 @@
 .prev-next {
   display: flex;
 
-  flex-wrap: wrap;
+  flex-wrap: nowrap;
 
   gap: 1rem;
   justify-content: space-between;
@@ -14,8 +14,8 @@
 
   list-style: none;
 
-  border: 2px solid var(--color-border-primary);
-  border-radius: 1em;
+  border: 1px solid var(--color-border-primary);
+  border-width: 1px 0;
 
   a {
     color: var(--color-link-normal) !important;
@@ -26,6 +26,35 @@
     }
   }
 
+  @media (--screen-xsmall) {
+    display: grid;
+    grid-template-areas:
+      "title title"
+      "prev next";
+
+    li.menu {
+      grid-area: title;
+      justify-self: center;
+    }
+
+    li.prev {
+      grid-area: prev;
+      justify-self: start;
+    }
+
+    li.next {
+      grid-area: next;
+      justify-self: end;
+    }
+  }
+
+  .prev a,
+  .next a {
+    display: flex;
+    gap: 0.25rem;
+    align-items: center;
+  }
+
   li {
     display: flex;
 

package/components/radius/global.css

@@ -0,0 +1,6 @@
+/* Radius */
+
+:root {
+  --radius-normal: 0.25rem;
+  --radius-full: 9999px;
+}

package/components/reference-layout/server.css

@@ -17,20 +17,20 @@
     display: contents;
   }
 
-  .reference-layout__content__header {
+  .reference-layout__header {
     grid-area: header;
 
     h1 {
-      margin-top: 0;
+      margin: 1rem 0;
 
       font-size: var(--font-size-largest);
       font-weight: normal;
 
-      line-height: var(--font-line-content);
+      line-height: var(--font-line-normal);
     }
   }
 
-  .reference-layout__content__body {
+  .reference-layout__body {
     grid-area: body;
     padding-bottom: 3rem;
   }

package/components/reference-layout/server.js

@@ -1,12 +1,14 @@
-import { html } from "lit";
+import { html, nothing } from "lit";
 
 import { ArticleFooter } from "../article-footer/server.js";
 import { BaselineIndicator } from "../baseline-indicator/server.js";
 import { ContentSection } from "../content-section/server.js";
+import { WRITER_MODE } from "../env/index.js";
 import { LeftSidebar } from "../left-sidebar/server.js";
 import { ReferenceToc } from "../reference-toc/server.js";
 import { ServerComponent } from "../server/index.js";
 import { TranslationBanner } from "../translation-banner/server.js";
+import { WriterToolbar } from "../writer-toolbar/server.js";
 
 export class ReferenceLayout extends ServerComponent {
   /**
@@ -21,7 +23,8 @@ export class ReferenceLayout extends ServerComponent {
     return html`
       <div class="reference-layout">
         <main id="content" class="reference-layout__content">
-          <div class="reference-layout__content__header">
+          <div class="reference-layout__header">
+            ${WRITER_MODE ? WriterToolbar.render(context) : nothing}
             ${TranslationBanner.render(context)}
             <h1>${doc.title}</h1>
             ${BaselineIndicator.render(context)} ${description}
@@ -30,7 +33,7 @@ export class ReferenceLayout extends ServerComponent {
             ${ReferenceToc.render(context)}
             <mdn-placement-sidebar></mdn-placement-sidebar>
           </aside>
-          <div class="reference-layout__content__body">
+          <div class="reference-layout__body">
             <mdn-survey></mdn-survey>
             ${sections} ${ArticleFooter.render(context)}
           </div>

package/components/reference-toc/server.css

@@ -39,8 +39,8 @@
     }
 
     &[aria-current="true"] {
-      background-color: var(--color-background-blue);
-      box-shadow: -2px 0 0 var(--color-blue-50);
+      background-color: var(--color-area-background);
+      box-shadow: -2px 0 0 var(--color-area-highlight-border);
     }
   }
 }

package/components/scrim-inline/element.css

@@ -129,9 +129,9 @@ dialog {
 
     font-family: "BarlowCondensed-SemiBold", "Inter", sans-serif;
     font-size: 3em;
-    font-weight: 600;
+    font-weight: var(--font-weight-bold);
 
-    line-height: 1;
+    line-height: var(--font-line-ui);
 
     color: var(--color-white);