@stainless-api/playgrounds 0.0.1-beta.0

package/src/playground.css

@@ -0,0 +1,359 @@
+.stldocs-snippet-playground {
+  .playground-footer {
+    gap: 0.5rem;
+    font-family: var(--stl-typography-font);
+    display: flex;
+    padding: 0.5rem;
+    border-top: 1px solid var(--stl-color-border);
+  }
+  .stldocs-snippet-request {
+    background: var(--stl-color-background);
+  }
+  .stldocs-snippet-request-title {
+    padding-left: 0.5rem;
+  }
+  .cm-editor {
+    background-color: var(--stl-color-background);
+  }
+  .cm-editor .cm-gutters {
+    background-color: var(--stl-color-background);
+  }
+  pre,
+  code {
+    white-space: pre-wrap;
+    font-family: var(--stl-typography-font-mono);
+    font-size: inherit;
+  }
+
+  .cm-lsp-documentation {
+    padding: 0;
+  }
+  .cm-tooltip,
+  .cm-tooltip-autocomplete > ul {
+    scrollbar-width: thin;
+    scrollbar-color: var(--stl-color-border) transparent;
+  }
+  .cm-tooltip {
+    font-family: var(--stl-typography-font);
+    font-size: 0.8rem;
+    background: var(--stl-color-background);
+    border: 1px solid var(--stl-color-border);
+    border-radius: 0.5em;
+    box-shadow: 0px 4px 4px -2px #00000014;
+    line-height: 1.5;
+    width: max-content;
+    max-width: min(100%, 35rem);
+    max-height: 20rem;
+    overflow-y: auto;
+
+    .cm-tooltip-section {
+      padding: 0.25rem 0.5rem;
+      &.cm-tooltip-lint {
+        padding: 0;
+        .cm-diagnostic {
+          padding: 0.25rem 0.5rem;
+        }
+      }
+
+      p,
+      pre {
+        margin: 0;
+      }
+
+      a {
+        color: var(--stl-color-blue-foreground);
+      }
+
+      code {
+        font-family: var(--stl-typography-font-mono);
+      }
+
+      strong {
+        font-weight: bold;
+      }
+
+      h1,
+      h2,
+      h3,
+      h4,
+      h5 {
+        font-size: inherit;
+        letter-spacing: inherit;
+        line-height: inherit;
+      }
+
+      em {
+        font-style: italic;
+      }
+
+      p {
+        display: block;
+      }
+
+      li {
+        display: list-item;
+      }
+
+      ol,
+      ul {
+        display: block;
+        list-style-type: initial;
+        margin: 0;
+        padding: 0;
+        padding-left: 1em;
+      }
+
+      ol {
+        list-style-type: decimal;
+      }
+    }
+    hr {
+      border: none;
+      border-bottom: 1px solid var(--stl-color-border);
+      margin: 0.5em 0;
+      box-shadow:
+        -1rem 0 var(--stl-color-border),
+        1rem 0 var(--stl-color-border);
+    }
+    &.cm-tooltip-autocomplete {
+      padding: 4px;
+      li {
+        border-radius: calc(0.5rem - 4px);
+        padding: 0.25rem 0.5rem;
+      }
+    }
+  }
+  .cm-scroller {
+    font-family: var(--stl-typography-font-mono);
+    line-height: 1.75;
+    scrollbar-color: var(--stl-color-border) transparent;
+  }
+  .cm-content {
+    padding-block: 1rem;
+  }
+  .cm-gutters {
+    border: none;
+    color: var(--stl-color-foreground-muted);
+    .cm-lineNumbers .cm-gutterElement {
+      opacity: 0.5;
+      text-align: right;
+      padding-left: 1rem;
+      padding-right: 0.5rem;
+    }
+    .cm-foldGutter {
+      width: calc(2rem / 3);
+    }
+  }
+  .cm-line {
+    padding: 0 0.35rem;
+  }
+  .playground-spacer {
+    flex-grow: 1;
+  }
+  :root[data-theme='dark'] & {
+    span[style*='--shiki-dark'] {
+      color: var(--shiki-dark) !important;
+      font-style: var(--shiki-dark-font-style) !important;
+      font-weight: var(--shiki-dark-font-weight) !important;
+      text-decoration: var(--shiki-dark-text-decoration) !important;
+    }
+  }
+  .playground-editor-load-error {
+    padding: 1rem;
+    overflow-y: auto;
+  }
+  .playground-logs {
+    display: block;
+    height: 14rem;
+    resize: vertical;
+    overflow-y: auto;
+    border-bottom-left-radius: 12px;
+    border-bottom-right-radius: 12px;
+    padding: 0;
+  }
+  .playground-logs li {
+    font-family: var(--stl-typography-font-mono);
+    font-size: var(--stl-typography-text-code);
+    padding: 0.5rem 1rem;
+    word-wrap: break-word;
+    word-break: break-word;
+    white-space: pre-wrap;
+    display: flex;
+    align-items: self-start;
+    grid-gap: 0.5em;
+    border-top: 1px solid var(--stl-playground-logs-border-color-prev, var(--stl-color-border));
+  }
+  .playground-logs li:first-child {
+    border-top: none;
+  }
+  .playground-logs li:where(:last-child) {
+    border-bottom: 1px solid var(--stl-color-border);
+    margin-bottom: 1rem;
+  }
+  .playground-logs li.playground-logs-blankslate {
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    text-align: center;
+    padding: 1.5rem 0;
+    color: var(--stl-color-foreground-reduced);
+    gap: 0.5rem;
+    border: none;
+  }
+
+  .playground-logs
+    li:is(.playground-log-stdout, .playground-log-stderr)
+    + li:is(.playground-log-stdout, .playground-log-stderr) {
+    border-top: none;
+    padding-top: 0;
+  }
+
+  .playground-logs li > .stldocs-icon {
+    width: 16px;
+    height: 16px;
+    flex-shrink: 0;
+
+    :is(.playground-log-stdout, .playground-log-stderr) & {
+      display: none;
+    }
+  }
+
+  .playground-logs li.playground-log-error {
+    color: var(--stl-color-red);
+    background-color: var(--stl-color-red-muted-background);
+    border-color: var(--stl-color-red-border);
+
+    & + li {
+      --stl-playground-logs-border-color-prev: var(--stl-color-red-border);
+    }
+  }
+
+  .playground-logs li.playground-log-warn {
+    color: var(--stl-color-yellow);
+    background-color: var(--stl-color-yellow-muted-background);
+    border-color: var(--stl-color-yellow-border);
+
+    & + li {
+      --stl-playground-logs-border-color-prev: var(--stl-color-yellow-border);
+    }
+  }
+
+  .playground-logs .playground-logs-object-toggle {
+    display: inline-block;
+    vertical-align: bottom;
+    cursor: pointer;
+    font: inherit;
+    line-height: 1;
+    margin: 0;
+    margin-right: 0.125em;
+    transform: translateY(-2px) rotate(0deg);
+    transition: 150ms ease transform;
+    appearance: none;
+    background: transparent;
+    padding: 0;
+    color: var(--stl-color-foreground);
+    border: none;
+    &.playground-logs-object-toggle-open {
+      transform: translateY(-2px) rotate(90deg);
+    }
+    & .stldocs-icon {
+      display: block;
+    }
+  }
+
+  .playground-logs .playground-logs-object-properties > *,
+  .playground-logs > li:not(.playground-log-stdout, .playground-log-stderr) .playground-logs-content {
+    display: block;
+    text-indent: -2ch;
+    margin-left: 2ch;
+  }
+
+  :is(.playground-log-stdout, playground-log-stderr)
+    .playground-logs-object-properties:not(
+      .playground-logs-object-properties .playground-logs-object-properties
+    ) {
+    padding-left: 2ch;
+  }
+
+  .playground-panel {
+    background: color-mix(in srgb, var(--stl-color-background), transparent);
+  }
+  .playground-panel-header {
+    font-family: var(--stl-typography-font);
+    font-size: 1rem;
+    display: flex;
+    align-items: center;
+    padding: 0.5rem 0.5rem 0.5rem 1rem;
+    border-bottom: 1px solid var(--stl-color-border);
+    height: 3rem;
+    .playground-panel:not(:first-of-type) & {
+      border-top: 1px solid var(--stl-color-border);
+    }
+  }
+  .playground-panel-header h5.playground-panel-title:not(:root) {
+    margin-inline: 0.5rem;
+    flex-grow: 1;
+    font-weight: 400;
+    font-style: normal;
+    line-height: 100%;
+    font-size: var(--stl-typography-scale-base);
+    font-family: var(--stl-typography-font);
+    color: var(--stl-color-foreground);
+  }
+  .playground-panel-content {
+    background: color-mix(in oklch, var(--stl-color-background) 99%, var(--stl-color-foreground));
+  }
+
+  .playground-panel-wrapper {
+    border: 1px solid var(--stl-color-border);
+    border-radius: 12px;
+    overflow: hidden;
+    border-top-left-radius: 0;
+    border-top-right-radius: 0;
+
+    @media (min-width: 1280px) {
+      border: none;
+      margin-left: -0.5rem;
+      margin-right: -0.5rem;
+      margin-bottom: -0.5rem;
+      border-bottom-left-radius: 16px;
+      border-bottom-right-radius: 16px;
+    }
+    @media (max-width: 1279px) {
+      background-color: var(--stl-color-faint-background);
+      margin-top: -12px;
+      padding-top: 12px;
+    }
+  }
+  .playground-auth-panel {
+    display: grid;
+    grid-template-columns: max-content 1fr;
+    align-items: center;
+    font-family: var(--stl-typography-font);
+    font-size: var(--stl-typography-scale-base);
+    label {
+      width: 100%;
+      padding: 0.5rem 1rem;
+      padding-right: 0.5rem;
+      height: 100%;
+      display: flex;
+      align-items: center;
+      code {
+        font-family: var(--stl-typography-font-mono);
+        font-size: var(--stl-typography-text-code);
+      }
+    }
+    > :not(label, hr) {
+      margin: 0.5rem;
+    }
+    hr {
+      grid-column: 1 / 3;
+      border: none;
+      border-bottom: 1px solid var(--stl-color-border);
+      margin: 0 0.5rem;
+    }
+    .stldocs-input {
+      width: calc(100% - 1rem);
+    }
+  }
+}

package/src/sandbox-worker/in-frame.js

@@ -0,0 +1,179 @@
+// @ts-check
+const transferableNames = new Set([
+  'OffscreenCanvas',
+  'ImageBitmap',
+  'MessagePort',
+  'MediaSourceHandle',
+  'ReadableStream',
+  'WritableStream',
+  'TransformStream',
+  'AudioData',
+  'VideoFrame',
+  'RTCDataChannel',
+  'ArrayBuffer',
+]);
+function inWorker() {
+  const handler = (/** @type {MessageEvent} */ e) => {
+    /** @type {Blob|undefined} */
+    const blob = e.data.blob;
+    if (blob) {
+      removeEventListener('message', handler);
+      /** @type {any} */ (self).importScripts(URL.createObjectURL(blob));
+    }
+  };
+  addEventListener('message', handler);
+}
+/**
+ * @param {{ port: MessagePort; blob: Blob; options: WorkerOptions | undefined; }} params
+ */
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+function init(params) {
+  // top level URL must be `data` not `blob` because chrome doesn't inherit
+  // isSecureContext for blob urls for some reason.
+  const worker = new Worker(
+    'data:text/javascript,' + encodeURIComponent(`(${inWorker.toString()})()`),
+    params.options,
+  );
+  worker.postMessage({ blob: params.blob });
+  const makeTransferList = (/** @type {any} */ value) => {
+    /**
+     * @type {any[]}
+     */
+    const arr = [];
+    walkValue(value, (value) => {
+      if (transferableNames.has(classOf(value))) {
+        arr.push(value);
+      }
+    });
+    return arr;
+  };
+  worker.addEventListener('error', (e) => {
+    e.preventDefault();
+    params.port.postMessage(
+      { type: 'error', error: e.error ?? new Error(e.message || 'Unknown Error') },
+      makeTransferList(e.error),
+    );
+  });
+  worker.addEventListener('message', (e) => {
+    e.preventDefault();
+    params.port.postMessage({ type: 'message', data: e.data }, makeTransferList(e.data));
+  });
+  worker.addEventListener('messageerror', (e) => {
+    e.preventDefault();
+    params.port.postMessage({ type: 'messageerror', data: e.data }, makeTransferList(e.data));
+  });
+  params.port.addEventListener('message', (e) => {
+    e.preventDefault();
+    if (e.data.type === 'postMessage') {
+      worker.postMessage(e.data.data, e.data.options);
+    }
+    if (e.data.type === 'terminate') {
+      worker.terminate();
+    }
+  });
+  params.port.postMessage({ type: 'ready' });
+  params.port.start();
+}
+
+const classOf = (/** @type {unknown} */ value) => Object.prototype.toString.call(value).slice(8, -1);
+
+/**
+ * @param {unknown} it
+ */
+function isObject(it) {
+  return typeof it == 'object' ? it !== null : isCallable(it);
+}
+
+// https://tc39.es/ecma262/#sec-IsHTMLDDA-internal-slot
+var documentAll = typeof document == 'object' && document.all;
+
+// `IsCallable` abstract operation
+// https://tc39.es/ecma262/#sec-iscallable
+const isCallable =
+  typeof documentAll == 'undefined' && documentAll !== undefined
+    ? function (/** @type {unknown} */ argument) {
+        return typeof argument == 'function' || argument === documentAll;
+      }
+    : function (/** @type {unknown} */ argument) {
+        return typeof argument == 'function';
+      };
+
+/**
+ * @param {any} value
+ * @param {(value: unknown) => void=} fn
+ * @param {Set<unknown>=} set
+ * @returns {Set<any>}
+ */
+function walkValue(value, fn, set) {
+  if (set) {
+    if (set.has(value)) return set;
+  } else set = new Set();
+  if (value === globalThis) return set;
+  if (!isObject(value)) return set;
+
+  fn?.(value);
+
+  var type = classOf(value);
+  var i;
+  var length;
+  var keys;
+  var key;
+  var child;
+
+  set.add(value);
+
+  switch (type) {
+    case 'DataView':
+    case 'Int8Array':
+    case 'Uint8Array':
+    case 'Uint8ClampedArray':
+    case 'Int16Array':
+    case 'Uint16Array':
+    case 'Int32Array':
+    case 'Uint32Array':
+    case 'Float16Array':
+    case 'Float32Array':
+    case 'Float64Array':
+    case 'BigInt64Array':
+    case 'BigUint64Array':
+      walkValue(value.buffer, fn, set);
+      break;
+    case 'Array':
+    case 'Object':
+      keys = Object.keys(value);
+      for (i = 0, length = keys.length; i < length; i++) {
+        key = /** @type {string} */ (keys[i]);
+        try {
+          child = value[key];
+        } catch {
+          continue;
+        }
+        walkValue(child, fn, set);
+      }
+      break;
+    case 'Map':
+      value.forEach(function (/** @type {any} */ v, /** @type {any} */ k) {
+        walkValue(k, fn, set);
+        walkValue(v, fn, set);
+      });
+      break;
+    case 'Set':
+      value.forEach(function (/** @type {any} */ v) {
+        walkValue(v, fn, set);
+      });
+      break;
+    case 'Error':
+      walkValue(value.message, fn, set);
+      if (Object.hasOwn(value, 'cause')) {
+        walkValue(value.cause, fn, set);
+      }
+      if (value.name === 'AggregateError') {
+        walkValue(value.errors, fn, set);
+      } else if (value.name === 'SuppressedError') {
+        walkValue(value.error, fn, set);
+        walkValue(value.suppressed, fn, set);
+      } // break omitted
+  }
+
+  return set;
+}