@dxos/plugin-presenter 0.6.8-main.046e6cf

package/src/components/Markdown/Container.stories.tsx

@@ -0,0 +1,54 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+import '@dxosTheme';
+
+import React, { type FC } from 'react';
+
+import { withFullscreen, withTheme } from '@dxos/storybook-utils';
+
+import { Container } from './Container';
+import { Slide } from './Slide';
+import { createSlide } from '../../testing';
+
+const Story: FC<{ content: string }> = ({ content }) => {
+  return (
+    <Container classNames='bg-neutral-200'>
+      <Slide content={content} />
+    </Container>
+  );
+};
+
+export default {
+  title: 'plugin-presenter/Container',
+  render: Story,
+  decorators: [withTheme, withFullscreen()],
+  parameters: {
+    layout: 'fullscreen',
+  },
+};
+
+export const Default = {
+  args: {
+    content: createSlide({ number: 1 }),
+  },
+};
+
+export const Code = {
+  args: {
+    content: createSlide({ code: true }),
+  },
+};
+
+export const List = {
+  args: {
+    content: createSlide({ list: 3 }),
+  },
+};
+
+export const Ordered = {
+  args: {
+    content: createSlide({ ordered: 4 }),
+  },
+};

package/src/components/Markdown/Container.tsx

@@ -0,0 +1,81 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+import React, { type PropsWithChildren, useState } from 'react';
+import { useResizeDetector } from 'react-resize-detector';
+
+import { type ThemedClassName } from '@dxos/react-ui';
+import { mx } from '@dxos/react-ui-theme';
+
+export type ContainerProps = ThemedClassName<PropsWithChildren<{}>>;
+
+/**
+ * Scaled markdown container.
+ */
+export const Container = ({ children, classNames }: ContainerProps) => {
+  const [props, setProps] = useState({});
+  const {
+    ref: containerRef,
+    width,
+    height,
+  } = useResizeDetector({
+    refreshMode: 'debounce',
+    refreshRate: 200,
+    refreshOptions: {
+      leading: true,
+    },
+    onResize: ({ width, height }) => {
+      if (width && height) {
+        setProps(createLayoutProps({ width, height }));
+      }
+    },
+  });
+
+  // TODO(burdon): Reconcile highlight colors with markdown editor.
+  // https://www.npmjs.com/package/react-markdown
+  return (
+    <div ref={containerRef} className={mx('flex grow relative overflow-hidden bg-attention', classNames)}>
+      <div className={mx('flex w-full h-full overflow-hidden absolute')} style={props}>
+        {width && height && children}
+      </div>
+    </div>
+  );
+};
+
+/**
+ * Compute CSS properties to transform DIV to be full screen.
+ *
+ * Display resolutions:
+ * window.screen.{availWidth, availHeight}
+ *          5K Studio       16.2-inch Macbook Pro
+ * Max      5120 x 2880     3456 x 2234
+ * Default  2560 x 1440     1728 x 1117 (Actual height 1080 - 37 pixel notch)
+ * Aspect   1.77 (16/9)     1.54
+ */
+const createLayoutProps = ({ width, height }: { width: number; height: number }) => {
+  // Config.
+  const aspectRatio = 16 / 9;
+  const nominalWidth = 2560;
+  const nominalHeight = nominalWidth / aspectRatio;
+
+  // NOTE: Hack to detect full height on Macbook Pro due to notch.
+  // const macIntelNotch = 1117 - 1080;
+  // const fullscreen =
+  //   height === screen.availHeight ||
+  //   (window.navigator.platform === 'MacIntel' && height === screen.availHeight - macIntelNotch);
+
+  // If not fullscreen then make scale slightly smaller so there's a natural border.
+  // const scaleFactor = fullscreen ? 1 : 0.95;
+
+  // Compute scaling factor required.
+  const scale = Math.min(width / nominalWidth, height / nominalHeight);
+
+  return {
+    left: (width - nominalWidth) / 2,
+    top: (height - nominalHeight) / 2,
+    width: nominalWidth,
+    height: nominalHeight,
+    transform: `scale(${scale})`,
+  };
+};

package/src/components/Markdown/Slide.stories.tsx

@@ -0,0 +1,22 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+import '@dxosTheme';
+
+import { Slide } from './Slide';
+import { createSlide } from '../../testing';
+
+export default {
+  title: 'plugin-presenter/Slide',
+  component: Slide,
+  parameters: {
+    layout: 'fullscreen',
+  },
+};
+
+export const Default = {
+  args: {
+    content: createSlide(),
+  },
+};

package/src/components/Markdown/Slide.tsx

@@ -0,0 +1,218 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+import { h } from 'hastscript';
+import React from 'react';
+import ReactMarkdown from 'react-markdown';
+import addClasses from 'rehype-add-classes';
+import highlight from 'rehype-highlight';
+import remarkFrontmatter from 'remark-frontmatter';
+import remarkParseFrontmatter from 'remark-parse-frontmatter';
+
+import 'highlight.js/styles/github.css';
+
+import { theme } from './theme';
+
+export type SlideProps = {
+  content?: string;
+  classes?: { [selector: string]: string };
+};
+
+export const Slide = ({ content = '', classes = theme.nodes }: SlideProps) => {
+  // TODO(thure): `rehype-highlight` ends up using `github.css` from `highlight.js`, but this does not appear to be
+  //  configurable. Find a way to remove the literal stylesheet here.
+  return (
+    <>
+      <style>{`
+.dark pre code.hljs {
+  display: block;
+  overflow-x: auto;
+  padding: 1em
+}
+.dark code.hljs {
+  padding: 3px 5px
+}
+/*!
+  Theme: GitHub Dark
+  Description: Dark theme as seen on github.com
+  Author: github.com
+  Maintainer: @Hirse
+  Updated: 2021-05-15
+
+  Outdated base version: https://github.com/primer/github-syntax-dark
+  Current colors taken from GitHub's CSS
+*/
+.dark .hljs {
+  color: #c9d1d9;
+  background: #0d1117
+}
+.dark .hljs-doctag,
+.dark .hljs-keyword,
+.dark .hljs-meta .hljs-keyword,
+.dark .hljs-template-tag,
+.dark .hljs-template-variable,
+.dark .hljs-type,
+.dark .hljs-variable.language_ {
+  /* prettylights-syntax-keyword */
+  color: #ff7b72
+}
+.dark .hljs-title,
+.dark .hljs-title.class_,
+.dark .hljs-title.class_.inherited__,
+.dark .hljs-title.function_ {
+  /* prettylights-syntax-entity */
+  color: #d2a8ff
+}
+.dark .hljs-attr,
+.dark .hljs-attribute,
+.dark .hljs-literal,
+.dark .hljs-meta,
+.dark .hljs-number,
+.dark .hljs-operator,
+.dark .hljs-variable,
+.dark .hljs-selector-attr,
+.dark .hljs-selector-class,
+.dark .hljs-selector-id {
+  /* prettylights-syntax-constant */
+  color: #79c0ff
+}
+.dark .hljs-regexp,
+.dark .hljs-string,
+.dark .hljs-meta .hljs-string {
+  /* prettylights-syntax-string */
+  color: #a5d6ff
+}
+.dark .hljs-built_in,
+.dark .hljs-symbol {
+  /* prettylights-syntax-variable */
+  color: #ffa657
+}
+.dark .hljs-comment,
+.dark .hljs-code,
+.dark .hljs-formula {
+  /* prettylights-syntax-comment */
+  color: #8b949e
+}
+.dark .hljs-name,
+.dark .hljs-quote,
+.dark .hljs-selector-tag,
+.dark .hljs-selector-pseudo {
+  /* prettylights-syntax-entity-tag */
+  color: #7ee787
+}
+.dark .hljs-subst {
+  /* prettylights-syntax-storage-modifier-import */
+  color: #c9d1d9
+}
+.dark .hljs-section {
+  /* prettylights-syntax-markup-heading */
+  color: #1f6feb;
+  font-weight: bold
+}
+.dark .hljs-bullet {
+  /* prettylights-syntax-markup-list */
+  color: #f2cc60
+}
+.dark .hljs-emphasis {
+  /* prettylights-syntax-markup-italic */
+  color: #c9d1d9;
+  font-style: italic
+}
+.dark .hljs-strong {
+  /* prettylights-syntax-markup-bold */
+  color: #c9d1d9;
+  font-weight: bold
+}
+.dark .hljs-addition {
+  /* prettylights-syntax-markup-inserted */
+  color: #aff5b4;
+  background-color: #033a16
+}
+.dark .hljs-deletion {
+  /* prettylights-syntax-markup-deleted */
+  color: #ffdcd7;
+  background-color: #67060c
+}
+.dark .hljs-char.escape_,
+.dark .hljs-link,
+.dark .hljs-params,
+.dark .hljs-property,
+.dark .hljs-punctuation,
+.dark .hljs-tag {
+  /* purposely ignored */
+  
+}
+      `}</style>
+      <ReactMarkdown
+        components={components}
+        // Markdown to HTML.
+        remarkPlugins={[[remarkFrontmatter, 'yaml'], remarkParseFrontmatter as any]}
+        // HTML processing.
+        rehypePlugins={[highlight, [addClasses, classes], slideLayout]}
+      >
+        {content}
+      </ReactMarkdown>
+    </>
+  );
+};
+
+/**
+ * Rehype plugin to format DOM based on frontmatter.
+ * https://github.com/unifiedjs/unified#plugin
+ * TODO(burdon): See tools/presenter: remarkPluginLayout
+ *  E.g., layout image from front-matter.
+ */
+const slideLayout =
+  (options = {}) =>
+  (tree: any, file: any) => {
+    const {
+      data: { frontmatter = {} },
+    } = file;
+
+    let content = tree.children;
+    const { layout, image } = frontmatter;
+    if (image) {
+      const img = h('div', {
+        class: 'flex grow shrink-0 bg-cover bg-center bg-no-repeat',
+        style: {
+          backgroundImage: `url(${image})`,
+        },
+      });
+
+      switch (layout) {
+        case 'fullscreen': {
+          content = img;
+          break;
+        }
+
+        case 'columns': {
+          content = h('div', { class: 'flex grow grid grid-cols-2' }, [
+            h('div', { class: theme.padding }, [content]),
+            img,
+          ]);
+          break;
+        }
+
+        case 'rows': {
+          content = h('div', { class: 'flex grow flex-col' }, [
+            h('div', { class: theme.padding }, [content]),
+            h('div', { class: ['flex grow pt-0', theme.padding] }, [img]),
+          ]);
+          break;
+        }
+      }
+    } else {
+      content = h('div', { class: ['flex grow flex-col', theme.padding] }, [content]);
+    }
+
+    const root = h('div', { class: ['flex flex-col grow', theme.root] }, [content]);
+    tree.children = [root];
+  };
+
+const ImageWrapper = ({ node, ...props }: { node: any }) => {
+  const { alt = '', src } = props as { alt: string; src: string };
+  return <img alt={alt} src={src} />;
+};
+
+const components = { img: ImageWrapper };

package/src/components/Markdown/index.ts

@@ -0,0 +1,6 @@
+//
+// Copyright 2022 DXOS.org
+//
+
+export * from './Container';
+export * from './Slide';

package/src/components/Markdown/theme.ts

@@ -0,0 +1,26 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+// TODO(burdon): Create theme type and picker.
+
+export const theme = {
+  root: 'bg-attention leading-relaxed font-mono',
+
+  padding: 'px-40 py-16 gap-8',
+
+  nodes: {
+    h1: 'text-[80px] fg-accent',
+    h2: 'text-[60px] fg-accent',
+    h3: 'text-[48px] fg-accent',
+
+    p: 'text-[48px]',
+
+    ul: 'my-[16px] ml-12 leading-relaxed list-disc',
+    ol: 'my-[16px] ml-24 leading-relaxed list-decimal',
+    li: 'pl-6 text-[48px]',
+
+    pre: 'w-full mx-0 my-[32px] p-0 __border-l-[16px] surface-input p-4 __whitespace-pre-line',
+    code: 'p-0 text-[40px]',
+  },
+};

package/src/components/MarkdownSlide.tsx

@@ -0,0 +1,24 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+import React, { type FC } from 'react';
+
+import { type DocumentType } from '@dxos/plugin-markdown/types';
+
+import { Container, Slide } from './Markdown';
+
+const MarkdownSlide: FC<{ document: DocumentType }> = ({ document }) => {
+  const content = document.content?.content;
+  if (!content) {
+    return null;
+  }
+
+  return (
+    <Container>
+      <Slide content={content} />
+    </Container>
+  );
+};
+
+export default MarkdownSlide;

package/src/components/Presenter/Layout.tsx

@@ -0,0 +1,33 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+import React, { type PropsWithChildren, type ReactNode } from 'react';
+
+import { type ThemedClassName } from '@dxos/react-ui';
+import { mx } from '@dxos/react-ui-theme';
+
+export type LayoutProps = ThemedClassName<
+  PropsWithChildren<{
+    className?: string;
+    topLeft?: ReactNode;
+    topRight?: ReactNode;
+    bottomLeft?: ReactNode;
+    bottomRight?: ReactNode;
+  }>
+>;
+
+export const Layout = ({ children, classNames, topLeft, topRight, bottomLeft, bottomRight }: LayoutProps) => {
+  return (
+    <div className={mx('flex grow relative overflow-hidden surface-attention', classNames)}>
+      <div className={mx('flex flex-col grow overflow-hidden')}>{children}</div>
+
+      <div className='z-[200]'>
+        <div className='absolute top-4 left-4'>{topLeft}</div>
+        <div className='absolute top-4 right-4'>{topRight}</div>
+        <div className='absolute bottom-4 left-4'>{bottomLeft}</div>
+        <div className='absolute bottom-4 right-4'>{bottomRight}</div>
+      </div>
+    </div>
+  );
+};

package/src/components/Presenter/Pager.stories.tsx

@@ -0,0 +1,32 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+import '@dxosTheme';
+
+import React, { type FC, useState } from 'react';
+
+import { PageNumber, Pager, StartButton } from './Pager';
+
+const Story: FC<{ count?: number }> = ({ count = 20 }) => {
+  const [index, setIndex] = useState(0);
+  const [running, setRunning] = useState(false);
+
+  return (
+    <div className='grid grid-cols-3 gap-8'>
+      <Pager index={index} count={count} onChange={setIndex} />
+      <PageNumber index={index} count={count} />
+      <StartButton running={running} onClick={setRunning} />
+    </div>
+  );
+};
+
+export default {
+  title: 'plugin-presenter/Pager',
+  render: Story,
+  parameters: {
+    layout: 'centered',
+  },
+};
+
+export const Default = {};

package/src/components/Presenter/Pager.tsx

@@ -0,0 +1,124 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+import { Play, X, CaretDoubleLeft, CaretDoubleRight, CaretLeft, CaretRight } from '@phosphor-icons/react';
+import React, { type FC, useEffect } from 'react';
+
+import { Button } from '@dxos/react-ui';
+import { getSize, mx } from '@dxos/react-ui-theme';
+
+import { useControlledValue } from '../../hooks';
+
+export type PagerProps = {
+  index?: number;
+  count?: number;
+  keys?: boolean; // TODO(burdon): Rename.
+  onChange?: (index: number) => void;
+  onExit?: () => void;
+};
+
+export const Pager = ({ index: controlledIndex = 0, count = 0, keys, onChange, onExit }: PagerProps) => {
+  const [index, setIndex] = useControlledValue(controlledIndex);
+  useEffect(() => {
+    onChange?.(index);
+  }, [index]);
+
+  const handleChangeIndex = (dir: number) => {
+    setIndex((index) => {
+      const next = index + dir;
+      return next >= 0 && next < count ? next : index;
+    });
+  };
+
+  // TODO(burdon): Standardize via system key binding.
+  useEffect(() => {
+    if (!keys) {
+      return;
+    }
+
+    const keydownHandler = (event: KeyboardEvent) => {
+      switch (event.key) {
+        case 'Escape': {
+          onExit?.();
+          break;
+        }
+        case 'ArrowLeft': {
+          if (event.shiftKey) {
+            onChange?.(0);
+          } else {
+            handleChangeIndex(-1);
+          }
+          break;
+        }
+        case 'ArrowRight': {
+          if (event.shiftKey) {
+            onChange?.(count - 1);
+          } else {
+            handleChangeIndex(1);
+          }
+          break;
+        }
+        case 'ArrowUp': {
+          onChange?.(0);
+          break;
+        }
+        case 'ArrowDown': {
+          onChange?.(count - 1);
+          break;
+        }
+      }
+    };
+
+    window.addEventListener('keydown', keydownHandler);
+    return () => window.removeEventListener('keydown', keydownHandler);
+  }, [keys, count]);
+
+  if (index === undefined || !count) {
+    return null;
+  }
+
+  return (
+    <div className='flex items-center text-neutral-500'>
+      <Button variant='ghost' classNames='p-0' onClick={() => onChange?.(0)}>
+        <CaretDoubleLeft className={mx(getSize(6))} />
+      </Button>
+      <Button variant='ghost' classNames='p-0' onClick={() => handleChangeIndex(-1)}>
+        <CaretLeft className={mx(getSize(6))} />
+      </Button>
+      <Button variant='ghost' classNames='p-0' onClick={() => handleChangeIndex(1)}>
+        <CaretRight className={mx(getSize(6))} />
+      </Button>
+      <Button variant='ghost' classNames='p-0' onClick={() => onChange?.(count - 1)}>
+        <CaretDoubleRight className={mx(getSize(6))} />
+      </Button>
+    </div>
+  );
+};
+
+export type PageNumberProps = {
+  index?: number;
+  count?: number;
+};
+
+export const PageNumber = ({ index = 0, count = 1 }: PageNumberProps) => {
+  if (index === undefined || !count) {
+    return null;
+  }
+
+  return (
+    <div className='flex items-center text-neutral-500 text-2xl'>
+      <div>
+        {index + 1} / {count}
+      </div>
+    </div>
+  );
+};
+
+export const StartButton: FC<{ running?: boolean; onClick?: (start: boolean) => void }> = ({ running, onClick }) => {
+  return (
+    <Button variant='ghost' classNames='p-0' onClick={() => onClick?.(!running)}>
+      {(running && <X className={mx(getSize(6))} />) || <Play className={mx(getSize(6))} />}
+    </Button>
+  );
+};

package/src/components/Presenter/index.ts

@@ -0,0 +1,6 @@
+//
+// Copyright 2022 DXOS.org
+//
+
+export * from './Layout';
+export * from './Pager';