Files
outline/app/scenes/Document/components/Document.tsx

731 lines
21 KiB
TypeScript

import cloneDeep from "lodash/cloneDeep";
import debounce from "lodash/debounce";
import isEqual from "lodash/isEqual";
import { action, observable } from "mobx";
import { observer } from "mobx-react";
import { Node } from "prosemirror-model";
import { AllSelection } from "prosemirror-state";
import * as React from "react";
import { WithTranslation, withTranslation } from "react-i18next";
import {
Prompt,
RouteComponentProps,
StaticContext,
withRouter,
Redirect,
} from "react-router";
import { toast } from "sonner";
import styled from "styled-components";
import breakpoint from "styled-components-breakpoint";
import { EditorStyleHelper } from "@shared/editor/styles/EditorStyleHelper";
import { s } from "@shared/styles";
import {
IconType,
NavigationNode,
TOCPosition,
TeamPreference,
} from "@shared/types";
import { ProsemirrorHelper, Heading } from "@shared/utils/ProsemirrorHelper";
import { parseDomain } from "@shared/utils/domains";
import { determineIconType } from "@shared/utils/icon";
import RootStore from "~/stores/RootStore";
import Document from "~/models/Document";
import Revision from "~/models/Revision";
import DocumentMove from "~/scenes/DocumentMove";
import DocumentPublish from "~/scenes/DocumentPublish";
import Branding from "~/components/Branding";
import ConnectionStatus from "~/components/ConnectionStatus";
import ErrorBoundary from "~/components/ErrorBoundary";
import Flex from "~/components/Flex";
import LoadingIndicator from "~/components/LoadingIndicator";
import PageTitle from "~/components/PageTitle";
import PlaceholderDocument from "~/components/PlaceholderDocument";
import RegisterKeyDown from "~/components/RegisterKeyDown";
import withStores from "~/components/withStores";
import type { Editor as TEditor } from "~/editor";
import { SearchResult } from "~/editor/components/LinkEditor";
import { client } from "~/utils/ApiClient";
import { replaceTitleVariables } from "~/utils/date";
import { emojiToUrl } from "~/utils/emoji";
import { isModKey } from "~/utils/keyboard";
import {
documentHistoryPath,
documentEditPath,
updateDocumentPath,
} from "~/utils/routeHelpers";
import Container from "./Container";
import Contents from "./Contents";
import Editor from "./Editor";
import Header from "./Header";
import KeyboardShortcutsButton from "./KeyboardShortcutsButton";
import MarkAsViewed from "./MarkAsViewed";
import { MeasuredContainer } from "./MeasuredContainer";
import Notices from "./Notices";
import PublicReferences from "./PublicReferences";
import References from "./References";
import RevisionViewer from "./RevisionViewer";
const AUTOSAVE_DELAY = 3000;
type Params = {
documentSlug: string;
revisionId?: string;
shareId?: string;
};
type LocationState = {
title?: string;
restore?: boolean;
revisionId?: string;
};
type Props = WithTranslation &
RootStore &
RouteComponentProps<Params, StaticContext, LocationState> & {
sharedTree?: NavigationNode;
abilities: Record<string, boolean>;
document: Document;
revision?: Revision;
readOnly: boolean;
shareId?: string;
tocPosition?: TOCPosition;
onCreateLink?: (title: string, nested?: boolean) => Promise<string>;
onSearchLink?: (term: string) => Promise<SearchResult[]>;
};
@observer
class DocumentScene extends React.Component<Props> {
@observable
editor = React.createRef<TEditor>();
@observable
isUploading = false;
@observable
isSaving = false;
@observable
isPublishing = false;
@observable
isEditorDirty = false;
@observable
isEmpty = true;
@observable
title: string = this.props.document.title;
@observable
headings: Heading[] = [];
componentDidMount() {
this.updateIsDirty();
}
componentDidUpdate(prevProps: Props) {
if (prevProps.readOnly && !this.props.readOnly) {
this.updateIsDirty();
}
}
componentWillUnmount() {
if (
this.isEmpty &&
this.props.document.createdBy?.id === this.props.auth.user?.id &&
this.props.document.isDraft &&
this.props.document.isActive &&
this.props.document.hasEmptyTitle &&
this.props.document.isPersistedOnce
) {
void this.props.document.delete();
}
}
replaceDocument = (template: Document | Revision) => {
const editorRef = this.editor.current;
if (!editorRef) {
return;
}
const { view, schema } = editorRef;
const doc = Node.fromJSON(schema, template.data);
if (doc) {
view.dispatch(
view.state.tr
.setSelection(new AllSelection(view.state.doc))
.replaceSelectionWith(doc)
);
}
this.isEditorDirty = true;
if (template instanceof Document) {
this.props.document.templateId = template.id;
}
if (!this.title) {
const title = replaceTitleVariables(
template.title,
this.props.auth.user || undefined
);
this.title = title;
this.props.document.title = title;
}
if (template.icon) {
this.props.document.icon = template.icon;
}
if (template.color) {
this.props.document.color = template.color;
}
this.props.document.data = cloneDeep(template.data);
this.updateIsDirty();
return this.onSave({
autosave: true,
publish: false,
done: false,
});
};
onSynced = async () => {
const { history, location, t } = this.props;
const restore = location.state?.restore;
const revisionId = location.state?.revisionId;
const editorRef = this.editor.current;
if (!editorRef || !restore) {
return;
}
const response = await client.post("/revisions.info", {
id: revisionId,
});
if (response) {
await this.replaceDocument(response.data);
toast.success(t("Document restored"));
history.replace(this.props.document.url, history.location.state);
}
};
onUndoRedo = (event: KeyboardEvent) => {
if (isModKey(event)) {
if (event.shiftKey) {
if (this.editor.current?.redo()) {
event.preventDefault();
}
} else {
if (this.editor.current?.undo()) {
event.preventDefault();
}
}
}
};
onMove = (ev: React.MouseEvent | KeyboardEvent) => {
ev.preventDefault();
const { document, dialogs, t, abilities } = this.props;
if (abilities.move) {
dialogs.openModal({
title: t("Move document"),
content: <DocumentMove document={document} />,
});
}
};
goToEdit = (ev: KeyboardEvent) => {
if (!this.props.readOnly) {
return;
}
ev.preventDefault();
const { document, abilities } = this.props;
if (abilities.update) {
this.props.history.push(documentEditPath(document));
}
};
goToHistory = (ev: KeyboardEvent) => {
if (!this.props.readOnly) {
return;
}
if (ev.ctrlKey) {
return;
}
ev.preventDefault();
const { document, location } = this.props;
if (location.pathname.endsWith("history")) {
this.props.history.push(document.url);
} else {
this.props.history.push(documentHistoryPath(document));
}
};
onPublish = (ev: React.MouseEvent | KeyboardEvent) => {
ev.preventDefault();
ev.stopPropagation();
const { document, dialogs, t } = this.props;
if (document.publishedAt) {
return;
}
if (document?.collectionId) {
void this.onSave({
publish: true,
done: true,
});
} else {
dialogs.openModal({
title: t("Publish document"),
content: <DocumentPublish document={document} />,
});
}
};
onSave = async (
options: {
done?: boolean;
publish?: boolean;
autosave?: boolean;
} = {}
) => {
const { document } = this.props;
// prevent saves when we are already saving
if (document.isSaving) {
return;
}
// get the latest version of the editor text value
const doc = this.editor.current?.view.state.doc;
if (!doc) {
return;
}
// prevent save before anything has been written (single hash is empty doc)
if (ProsemirrorHelper.isEmpty(doc) && document.title.trim() === "") {
return;
}
document.data = doc.toJSON();
document.tasks = ProsemirrorHelper.getTasksSummary(doc);
// prevent autosave if nothing has changed
if (options.autosave && !this.isEditorDirty && !document.isDirty()) {
return;
}
this.isSaving = true;
this.isPublishing = !!options.publish;
try {
const savedDocument = await document.save(undefined, options);
this.isEditorDirty = false;
if (options.done) {
this.props.history.push(savedDocument.url);
this.props.ui.setActiveDocument(savedDocument);
} else if (document.isNew) {
this.props.history.push(documentEditPath(savedDocument));
this.props.ui.setActiveDocument(savedDocument);
}
} catch (err) {
toast.error(err.message);
} finally {
this.isSaving = false;
this.isPublishing = false;
}
};
autosave = debounce(
() =>
this.onSave({
done: false,
autosave: true,
}),
AUTOSAVE_DELAY
);
updateIsDirty = () => {
const { document } = this.props;
const doc = this.editor.current?.view.state.doc;
this.isEditorDirty = !isEqual(doc?.toJSON(), document.data);
// a single hash is a doc with just an empty title
this.isEmpty = (!doc || ProsemirrorHelper.isEmpty(doc)) && !this.title;
};
updateIsDirtyDebounced = debounce(this.updateIsDirty, 500);
onFileUploadStart = () => {
this.isUploading = true;
};
onFileUploadStop = () => {
this.isUploading = false;
};
handleChange = () => {
const { document } = this.props;
// Keep derived task list in sync
const tasks = this.editor.current?.getTasks();
const total = tasks?.length ?? 0;
const completed = tasks?.filter((t) => t.completed).length ?? 0;
document.updateTasks(total, completed);
};
onHeadingsChange = (headings: Heading[]) => {
this.headings = headings;
};
handleChangeTitle = action((value: string) => {
this.title = value;
this.props.document.title = value;
this.updateIsDirty();
void this.autosave();
});
handleChangeIcon = action((icon: string | null, color: string | null) => {
this.props.document.icon = icon;
this.props.document.color = color;
void this.onSave();
});
goBack = () => {
if (!this.props.readOnly) {
this.props.history.push(this.props.document.url);
}
};
render() {
const {
document,
revision,
readOnly,
abilities,
auth,
ui,
shareId,
tocPosition,
t,
} = this.props;
const { team, user } = auth;
const isShare = !!shareId;
const embedsDisabled =
(team && team.documentEmbeds === false) || document.embedsDisabled;
const hasHeadings = this.headings.length > 0;
const showContents =
ui.tocVisible && ((readOnly && hasHeadings) || !readOnly);
const tocPos =
tocPosition ??
((team?.getPreference(TeamPreference.TocPosition) as TOCPosition) ||
TOCPosition.Left);
const multiplayerEditor =
!document.isArchived && !document.isDeleted && !revision && !isShare;
const canonicalUrl = shareId
? this.props.match.url
: updateDocumentPath(this.props.match.url, document);
const hasEmojiInTitle = determineIconType(document.icon) === IconType.Emoji;
const title = hasEmojiInTitle
? document.titleWithDefault.replace(document.icon!, "")
: document.titleWithDefault;
const favicon = hasEmojiInTitle ? emojiToUrl(document.icon!) : undefined;
return (
<ErrorBoundary showTitle>
{this.props.location.pathname !== canonicalUrl && (
<Redirect
to={{
pathname: canonicalUrl,
state: this.props.location.state,
hash: this.props.location.hash,
}}
/>
)}
<RegisterKeyDown trigger="m" handler={this.onMove} />
<RegisterKeyDown trigger="z" handler={this.onUndoRedo} />
<RegisterKeyDown trigger="e" handler={this.goToEdit} />
<RegisterKeyDown trigger="Escape" handler={this.goBack} />
<RegisterKeyDown trigger="h" handler={this.goToHistory} />
<RegisterKeyDown
trigger="p"
options={{
allowInInput: true,
}}
handler={(event) => {
if (isModKey(event) && event.shiftKey) {
this.onPublish(event);
}
}}
/>
<MeasuredContainer
as={Background}
name="container"
key={revision ? revision.id : document.id}
column
auto
>
<PageTitle title={title} favicon={favicon} />
{(this.isUploading || this.isSaving) && <LoadingIndicator />}
<Container column>
{!readOnly && (
<Prompt
when={this.isUploading && !this.isEditorDirty}
message={t(
`Images are still uploading.\nAre you sure you want to discard them?`
)}
/>
)}
<Header
document={document}
documentHasHeadings={hasHeadings}
revision={revision}
shareId={shareId}
isDraft={document.isDraft}
isEditing={!readOnly && !!user?.separateEditMode}
isSaving={this.isSaving}
isPublishing={this.isPublishing}
publishingIsDisabled={
document.isSaving || this.isPublishing || this.isEmpty
}
savingIsDisabled={document.isSaving || this.isEmpty}
sharedTree={this.props.sharedTree}
onSelectTemplate={this.replaceDocument}
onSave={this.onSave}
headings={this.headings}
/>
<Flex justify="center">
<Notices document={document} readOnly={readOnly} />
</Flex>
<MeasuredContainer
as={Main}
name="document"
fullWidth={document.fullWidth}
tocPosition={tocPos}
>
<React.Suspense
fallback={
<EditorContainer
docFullWidth={document.fullWidth}
showContents={showContents}
tocPosition={tocPos}
>
<PlaceholderDocument />
</EditorContainer>
}
>
{revision ? (
<RevisionContainer docFullWidth={document.fullWidth}>
<RevisionViewer
document={document}
revision={revision}
id={revision.id}
/>
</RevisionContainer>
) : (
<>
{showContents && (
<ContentsContainer
docFullWidth={document.fullWidth}
position={tocPos}
>
<Contents headings={this.headings} />
</ContentsContainer>
)}
<EditorContainer
docFullWidth={document.fullWidth}
showContents={showContents}
tocPosition={tocPos}
>
<Editor
id={document.id}
key={embedsDisabled ? "disabled" : "enabled"}
ref={this.editor}
multiplayer={multiplayerEditor}
shareId={shareId}
isDraft={document.isDraft}
template={document.isTemplate}
document={document}
value={readOnly ? document.data : undefined}
defaultValue={document.data}
embedsDisabled={embedsDisabled}
onSynced={this.onSynced}
onFileUploadStart={this.onFileUploadStart}
onFileUploadStop={this.onFileUploadStop}
onSearchLink={this.props.onSearchLink}
onCreateLink={this.props.onCreateLink}
onChangeTitle={this.handleChangeTitle}
onChangeIcon={this.handleChangeIcon}
onChange={this.handleChange}
onHeadingsChange={this.onHeadingsChange}
onSave={this.onSave}
onPublish={this.onPublish}
onCancel={this.goBack}
readOnly={readOnly}
canUpdate={abilities.update}
canComment={abilities.comment}
>
{shareId && (
<ReferencesWrapper>
<PublicReferences
shareId={shareId}
documentId={document.id}
sharedTree={this.props.sharedTree}
/>
</ReferencesWrapper>
)}
{!isShare && !revision && (
<>
<MarkAsViewed document={document} />
<ReferencesWrapper>
<References document={document} />
</ReferencesWrapper>
</>
)}
</Editor>
</EditorContainer>
</>
)}
</React.Suspense>
</MeasuredContainer>
{isShare &&
!parseDomain(window.location.origin).custom &&
!auth.user && (
<Branding href="//www.getoutline.com?ref=sharelink" />
)}
</Container>
{!isShare && (
<Footer>
<KeyboardShortcutsButton />
<ConnectionStatus />
</Footer>
)}
</MeasuredContainer>
</ErrorBoundary>
);
}
}
type MainProps = {
fullWidth: boolean;
tocPosition: TOCPosition;
};
const Main = styled.div<MainProps>`
margin-top: 4px;
${breakpoint("tablet")`
display: grid;
grid-template-columns: ${({ fullWidth, tocPosition }: MainProps) =>
fullWidth
? tocPosition === TOCPosition.Left
? `${EditorStyleHelper.tocWidth}px minmax(0, 1fr)`
: `minmax(0, 1fr) ${EditorStyleHelper.tocWidth}px`
: `1fr minmax(0, ${`calc(46em + 76px)`}) 1fr`};
`};
${breakpoint("desktopLarge")`
grid-template-columns: ${({ fullWidth, tocPosition }: MainProps) =>
fullWidth
? tocPosition === TOCPosition.Left
? `${EditorStyleHelper.tocWidth}px minmax(0, 1fr)`
: `minmax(0, 1fr) ${EditorStyleHelper.tocWidth}px`
: `1fr minmax(0, ${`calc(52em + 76px)`}) 1fr`};
`};
`;
type ContentsContainerProps = {
docFullWidth: boolean;
position: TOCPosition;
};
const ContentsContainer = styled.div<ContentsContainerProps>`
${breakpoint("tablet")`
margin-top: calc(44px + 6vh);
grid-row: 1;
grid-column: ${({ docFullWidth, position }: ContentsContainerProps) =>
position === TOCPosition.Left ? 1 : docFullWidth ? 2 : 3};
justify-self: ${({ position }: ContentsContainerProps) =>
position === TOCPosition.Left ? "end" : "start"};
`};
`;
type EditorContainerProps = {
docFullWidth: boolean;
showContents: boolean;
tocPosition: TOCPosition;
};
const EditorContainer = styled.div<EditorContainerProps>`
// Adds space to the gutter to make room for icon & heading annotations
padding: 0 40px;
${breakpoint("tablet")`
grid-row: 1;
// Decides the editor column position & span
grid-column: ${({
docFullWidth,
showContents,
tocPosition,
}: EditorContainerProps) =>
docFullWidth
? showContents
? tocPosition === TOCPosition.Left
? 2
: 1
: "1 / -1"
: 2};
`};
`;
type RevisionContainerProps = {
docFullWidth: boolean;
};
const RevisionContainer = styled.div<RevisionContainerProps>`
// Adds space to the gutter to make room for icon
padding: 0 40px;
${breakpoint("tablet")`
grid-row: 1;
grid-column: ${({ docFullWidth }: RevisionContainerProps) =>
docFullWidth ? "1 / -1" : 2};
`}
`;
const Footer = styled.div`
position: absolute;
width: 100%;
text-align: right;
display: flex;
justify-content: flex-end;
`;
const Background = styled(Container)`
position: relative;
background: ${s("background")};
transition: ${s("backgroundTransition")};
`;
const ReferencesWrapper = styled.div`
margin-top: 16px;
@media print {
display: none;
}
`;
export default withTranslation()(withStores(withRouter(DocumentScene)));