@x15ventures/x15-ui-library 3.18.0 → 3.20.0

package/dist/esm/widgets/documentComparer/documentComparer.css

@@ -0,0 +1,117 @@
+.documentComparer {
+  display: flex;
+  flex-direction: column;
+  gap: var(--documentComparerGap, 20px);
+  min-width: 0;
+}
+.documentComparer .headerBar {
+  margin-bottom: 0;
+}
+
+.documentComparer__header {
+  display: flex;
+  flex-direction: column;
+  gap: var(--documentComparerPanelGap, var(--documentGap, 10px));
+}
+
+.documentComparer__controls {
+  display: flex;
+  flex-wrap: wrap;
+  gap: var(--documentComparerGap, 20px);
+}
+
+.documentComparer__columns {
+  display: grid;
+  grid-template-columns: repeat(2, minmax(var(--documentComparerColumnMinWidth, 320px), 1fr));
+  gap: var(--documentComparerGap, 20px);
+}
+@media (max-width: 900px) {
+  .documentComparer__columns {
+    grid-template-columns: minmax(0, 1fr);
+  }
+}
+
+.documentComparer__panel,
+.documentComparer__differences {
+  display: flex;
+  flex-direction: column;
+  gap: var(--documentComparerPanelGap, var(--documentGap, 10px));
+  min-width: 0;
+  padding: var(--documentComparerPanelPadding, 15px);
+  border: var(--documentComparerPanelBorder, var(--documentBorder));
+  border-radius: var(--documentComparerPanelBorderRadius, var(--documentBorderRadius, 5px));
+  background: var(--documentComparerPanelBg, var(--documentBg, #fff));
+}
+
+.documentComparer__panelHeader {
+  display: flex;
+  flex-direction: column;
+  gap: 5px;
+}
+
+.documentComparer__documentTitle {
+  margin: 0;
+  font-weight: 600;
+  overflow-wrap: anywhere;
+}
+
+.documentComparer__metadata {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 5px 20px;
+  margin: 0;
+  color: var(--documentComparerMetadataColor, var(--documentMutedFgColor));
+  font-size: var(--documentComparerMetadataFontSize, 0.8125rem);
+}
+.documentComparer__metadata > div {
+  display: flex;
+  gap: 5px;
+}
+.documentComparer__metadata dt::after {
+  content: ":";
+}
+.documentComparer__metadata dd {
+  margin: 0;
+}
+
+.documentComparer__panelBody {
+  display: flex;
+  flex: 1;
+  flex-direction: column;
+  min-height: var(--documentComparerPanelMinHeight, var(--documentFrameMinHeight, 65vh));
+  overflow: auto;
+}
+.documentComparer__panelBody > aside,
+.documentComparer__panelBody > .pageBanner {
+  margin: auto;
+}
+
+.documentComparer__viewer {
+  --documentViewerFrameBorder: 0;
+  flex: 1;
+}
+
+.documentComparer__pages {
+  display: flex;
+  flex-direction: column;
+  gap: var(--documentComparerPageGap, 15px);
+}
+.documentComparer__pages img {
+  display: block;
+  width: 100%;
+  height: auto;
+  box-shadow: var(--documentComparerPageShadow, 0 1px 5px rgba(0, 0, 0, 0.15));
+}
+
+.documentComparer__message {
+  margin: auto;
+  color: var(--documentComparerMetadataColor, var(--documentMutedFgColor));
+}
+
+.documentComparer__panelActions,
+.documentComparer__footer {
+  display: flex;
+  flex-wrap: wrap;
+  justify-content: flex-end;
+  gap: var(--documentComparerPanelGap, var(--documentGap, 10px));
+}

package/dist/esm/widgets/documentComparer/documentComparer.interfaces.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=documentComparer.interfaces.js.map

package/dist/esm/widgets/documentComparer/documentComparer.interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentComparer.interfaces.js","names":[],"sources":["../../../../src/widgets/documentComparer/documentComparer.interfaces.ts"],"sourcesContent":["import { ReactNode } from 'react';\n\nimport { DocumentRenderers } from '../documentViewer/documentViewer.interfaces';\nimport { DocumentAnnotationsProps } from '../shared/documents/annotations/annotations.interfaces';\nimport { DocumentSource, ResolveResourceUrl } from '../shared/documents/documents.interfaces';\nimport { DocumentDiffView } from '../shared/documents/engines/documentDiff/documentDiff.interfaces';\nimport { DocumentEditorProps } from '../documentEditor/documentEditor.interfaces';\n\nexport type DocumentComparerView = 'sideBySide' | 'differences';\n\nexport type ComparisonDocument = DocumentSource & {\n  version?: string;\n  lastModified?: string;\n  // Rendered page images shown instead of the document itself, e.g. pages of a scanned PDF.\n  pageImages?: string[];\n};\n\nexport type DocumentComparerSaveUpdate = {\n  markdown: string;\n  baselineMarkdown: string;\n};\n\nexport type DocumentComparerLabels = {\n  originalHeading: string;\n  revisedHeading: string;\n  viewSelector: string;\n  sideBySide: string;\n  differences: string;\n  diffSelector: string;\n  formatted: string;\n  source: string;\n  edit: string;\n  save: string;\n  cancel: string;\n  version: string;\n  lastModified: string;\n  notRecorded: string;\n  loadingHeading: string;\n  loadingMessage: string;\n  loadError: string;\n  noSourcePreview: string;\n  added: string;\n  removed: string;\n  noChanges: string;\n  /* eslint-disable-next-line no-unused-vars */\n  diffSummary: (added: number, removed: number) => string;\n  /* eslint-disable-next-line no-unused-vars */\n  pageImageAlt: (page: number, total: number, title: string) => string;\n};\n\nexport type DocumentComparerCssClasses = {\n  wrapper?: string;\n  header?: string;\n  columns?: string;\n  originalPanel?: string;\n  revisedPanel?: string;\n  differences?: string;\n  footer?: string;\n};\n\nexport type DocumentComparerProps = {\n  id: string;\n  title: string;\n  headingLevel?: 1 | 2 | 3 | 4;\n  originalDocument: ComparisonDocument;\n  // The markdown version under review, supplied as text, a File or a URL.\n  revisedDocument: ComparisonDocument;\n  // What the differences view compares against; defaults to the revised document as first loaded.\n  baselineMarkdown?: string;\n  initialView?: DocumentComparerView;\n  initialDiffView?: DocumentDiffView;\n  // Which column holds the revised document.\n  revisedPosition?: 'start' | 'end';\n  enableEditing?: boolean;\n  /* eslint-disable-next-line no-unused-vars */\n  onChange?: (markdown: string) => void;\n  // Called with the edited markdown; return a promise to keep the save button disabled until it settles.\n  /* eslint-disable-next-line no-unused-vars */\n  onSave?: (update: DocumentComparerSaveUpdate) => void | Promise<void>;\n  // Options passed through to the editor used while editing the revised document.\n  editorProps?: Pick<DocumentEditorProps, 'toolbarItems' | 'listTypes' | 'imageUploadHandler' | 'viewModes'>;\n  // Override renderers for supported original-document kinds; unsupported files stay blocked.\n  originalRenderers?: DocumentRenderers;\n  resolveResourceUrl?: ResolveResourceUrl;\n  // Passed to the original document's viewer; see DocumentViewer's trustedPdfOrigins.\n  trustedPdfOrigins?: string[];\n  // Defaults to the library's dateToShortReadableDate; return null to show the value as given.\n  /* eslint-disable-next-line no-unused-vars */\n  formatDate?: (value: string) => string | null;\n  // Slots for application workflow, e.g. lifecycle status, review and approval actions.\n  headerActions?: ReactNode;\n  originalPanelActions?: ReactNode;\n  revisedPanelActions?: ReactNode;\n  footerActions?: ReactNode;\n  // Pinned comments on the revised document, both when reading and while editing it.\n  annotations?: DocumentAnnotationsProps;\n  labels?: Partial<DocumentComparerLabels>;\n  customCssClasses?: DocumentComparerCssClasses;\n};\n\nexport type { DocumentDiffView };\n"],"mappings":"","ignoreList":[]}

package/dist/esm/widgets/documentComparer/index.js

@@ -0,0 +1,2 @@
+export { DocumentComparer, defaultDocumentComparerLabels } from './DocumentComparer';
+//# sourceMappingURL=index.js.map

package/dist/esm/widgets/documentComparer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["DocumentComparer","defaultDocumentComparerLabels"],"sources":["../../../../src/widgets/documentComparer/index.ts"],"sourcesContent":["export { DocumentComparer, defaultDocumentComparerLabels } from './DocumentComparer';\n\nexport type {\n  ComparisonDocument,\n  DocumentComparerCssClasses,\n  DocumentComparerLabels,\n  DocumentComparerProps,\n  DocumentComparerSaveUpdate,\n  DocumentComparerView,\n  DocumentDiffView\n} from './documentComparer.interfaces';\n"],"mappings":"AAAA,SAASA,gBAAgB,EAAEC,6BAA6B,QAAQ,oBAAoB","ignoreList":[]}

package/dist/esm/widgets/documentEditor/DocumentEditor.js

@@ -0,0 +1,135 @@
+'use client';
+
+import React, { Suspense, useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { HeaderBar, PageBanner, SimpleButton } from '../../components';
+import { LoadingMessage } from '../../components/design/loadingMessage/LoadingMessage';
+import { LazyMarkdownEditorEngine } from '../shared/documents/engines/lazyEngines';
+import './documentEditor.css';
+export const defaultDocumentEditorLabels = {
+  loadingHeading: 'Loading',
+  loadingMessage: 'Loading editor',
+  parseErrorNotice: 'This document contains markdown the visual editor cannot represent, so it has opened in source mode.',
+  retryRichText: 'Try the visual editor again'
+};
+const DEFAULT_VIEW_MODES = ['rich-text', 'source'];
+
+/*
+  DocumentEditor edits a markdown document in rich-text, source or diff mode. The editor engine
+  (MDXEditor) is only downloaded when an editor is first rendered.
+  If the visual editor cannot parse the document it falls back to source mode rather than
+  rendering an empty, silently lossy editor.
+ */
+export const DocumentEditor = ({
+  id,
+  label,
+  hideLabel = false,
+  headingLevel = 3,
+  markdown,
+  onChange,
+  readOnly = false,
+  baselineMarkdown,
+  viewModes,
+  initialViewMode = 'rich-text',
+  toolbarItems,
+  listTypes,
+  imageUploadHandler,
+  resolveResourceUrl,
+  headerActions,
+  annotations,
+  labels: customLabels,
+  customCssClasses = {},
+  onParseError
+}) => {
+  const labels = useMemo(() => ({
+    ...defaultDocumentEditorLabels,
+    ...customLabels
+  }), [customLabels]);
+  const [parseError, setParseError] = useState(null);
+  const [editorRevision, setEditorRevision] = useState(0);
+  // The latest text, so remounting the editor (e.g. to retry the visual editor) keeps edits even
+  // when the host does not feed onChange back into `markdown`.
+  const [currentMarkdown, setCurrentMarkdown] = useState(markdown);
+  const currentMarkdownRef = useRef(markdown);
+  useEffect(() => {
+    if (markdown !== currentMarkdownRef.current) {
+      currentMarkdownRef.current = markdown;
+      setCurrentMarkdown(markdown);
+      // A replacement document is parsed afresh, so the previous document's parse error no longer applies.
+      setParseError(null);
+      setEditorRevision(revision => revision + 1);
+    }
+  }, [markdown]);
+  const handleChange = useCallback(nextMarkdown => {
+    currentMarkdownRef.current = nextMarkdown;
+    setCurrentMarkdown(nextMarkdown);
+    onChange?.(nextMarkdown);
+  }, [onChange]);
+  const availableViewModes = useMemo(() => {
+    const requested = viewModes ?? (baselineMarkdown === undefined ? DEFAULT_VIEW_MODES : [...DEFAULT_VIEW_MODES, 'diff']);
+    const supported = requested.filter(mode => mode !== 'diff' || baselineMarkdown !== undefined);
+    return parseError ? ['source', ...supported.filter(mode => mode !== 'rich-text' && mode !== 'source')] : supported;
+  }, [viewModes, baselineMarkdown, parseError]);
+  const viewMode = parseError ? 'source' : availableViewModes.includes(initialViewMode) ? initialViewMode : availableViewModes[0] ?? 'source';
+  const handleParseError = useCallback(error => {
+    setParseError(current => current ?? error);
+    onParseError?.(error);
+  }, [onParseError]);
+  const imagePreviewHandler = useMemo(
+  // A resolver returning nothing has rejected the source, so the preview is left empty rather than
+  // falling back to the unvetted original.
+  () => resolveResourceUrl ? async source => resolveResourceUrl(source) ?? '' : undefined, [resolveResourceUrl]);
+  return /*#__PURE__*/React.createElement("section", {
+    id: id,
+    className: `documentEditor ${readOnly ? 'documentEditor--readOnly' : ''} ${customCssClasses.wrapper || ''}`.trim(),
+    "aria-label": label
+  }, !hideLabel && /*#__PURE__*/React.createElement("div", {
+    className: `documentEditor__header ${customCssClasses.header || ''}`.trim()
+  }, /*#__PURE__*/React.createElement(HeaderBar, {
+    text: label,
+    headingLevel: headingLevel
+  }, headerActions)), hideLabel && headerActions && /*#__PURE__*/React.createElement("div", {
+    className: `documentEditor__actions ${customCssClasses.actions || ''}`.trim()
+  }, headerActions), parseError && /*#__PURE__*/React.createElement(PageBanner, {
+    id: `${id}_parseError`,
+    type: "warn",
+    icon: "warning",
+    displayMode: "inline",
+    animation: "none",
+    disableClose: true
+  }, /*#__PURE__*/React.createElement("span", {
+    role: "status"
+  }, labels.parseErrorNotice), /*#__PURE__*/React.createElement(SimpleButton, {
+    id: `${id}_retryRichText`,
+    label: labels.retryRichText,
+    cssClass: "button secondary outline compact documentEditor__retry",
+    onClickHandler: () => setParseError(null)
+  })), /*#__PURE__*/React.createElement("div", {
+    className: `documentEditor__editor ${customCssClasses.editor || ''}`.trim()
+  }, /*#__PURE__*/React.createElement(Suspense, {
+    fallback: /*#__PURE__*/React.createElement(LoadingMessage, {
+      heading: labels.loadingHeading,
+      loadingMessage: labels.loadingMessage,
+      isInline: true
+    })
+  }, /*#__PURE__*/React.createElement(LazyMarkdownEditorEngine
+  // Remount in source mode once a parse error forces the fallback.
+  , {
+    key: `${parseError ? 'source-fallback' : 'default'}_${editorRevision}`,
+    markdown: currentMarkdown,
+    onChange: handleChange,
+    readOnly: readOnly,
+    viewMode: viewMode,
+    viewModes: availableViewModes,
+    diffMarkdown: baselineMarkdown,
+    toolbarItems: toolbarItems,
+    listTypes: listTypes,
+    imageUploadHandler: imageUploadHandler,
+    imagePreviewHandler: imagePreviewHandler,
+    contentCssClass: customCssClasses.content,
+    annotations: annotations,
+    annotationLayerId: `${id}_annotations`,
+    onParseError: handleParseError
+  }))));
+};
+export default DocumentEditor;
+//# sourceMappingURL=DocumentEditor.js.map

package/dist/esm/widgets/documentEditor/DocumentEditor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocumentEditor.js","names":["React","Suspense","useCallback","useEffect","useMemo","useRef","useState","HeaderBar","PageBanner","SimpleButton","LoadingMessage","LazyMarkdownEditorEngine","defaultDocumentEditorLabels","loadingHeading","loadingMessage","parseErrorNotice","retryRichText","DEFAULT_VIEW_MODES","DocumentEditor","id","label","hideLabel","headingLevel","markdown","onChange","readOnly","baselineMarkdown","viewModes","initialViewMode","toolbarItems","listTypes","imageUploadHandler","resolveResourceUrl","headerActions","annotations","labels","customLabels","customCssClasses","onParseError","parseError","setParseError","editorRevision","setEditorRevision","currentMarkdown","setCurrentMarkdown","currentMarkdownRef","current","revision","handleChange","nextMarkdown","availableViewModes","requested","undefined","supported","filter","mode","viewMode","includes","handleParseError","error","imagePreviewHandler","source","createElement","className","wrapper","trim","header","text","actions","type","icon","displayMode","animation","disableClose","role","cssClass","onClickHandler","editor","fallback","heading","isInline","key","diffMarkdown","contentCssClass","content","annotationLayerId"],"sources":["../../../../src/widgets/documentEditor/DocumentEditor.tsx"],"sourcesContent":["'use client';\n\nimport React, { FC, Suspense, useCallback, useEffect, useMemo, useRef, useState } from 'react';\n\nimport { HeaderBar, PageBanner, SimpleButton } from '../../components';\nimport { LoadingMessage } from '../../components/design/loadingMessage/LoadingMessage';\nimport { LazyMarkdownEditorEngine } from '../shared/documents/engines/lazyEngines';\nimport { DocumentEditorLabels, DocumentEditorProps, MarkdownEditorViewMode } from './documentEditor.interfaces';\n\nimport './documentEditor.scss';\n\nexport const defaultDocumentEditorLabels: DocumentEditorLabels = {\n  loadingHeading: 'Loading',\n  loadingMessage: 'Loading editor',\n  parseErrorNotice: 'This document contains markdown the visual editor cannot represent, so it has opened in source mode.',\n  retryRichText: 'Try the visual editor again'\n};\n\nconst DEFAULT_VIEW_MODES: MarkdownEditorViewMode[] = ['rich-text', 'source'];\n\n/*\n  DocumentEditor edits a markdown document in rich-text, source or diff mode. The editor engine\n  (MDXEditor) is only downloaded when an editor is first rendered.\n  If the visual editor cannot parse the document it falls back to source mode rather than\n  rendering an empty, silently lossy editor.\n */\nexport const DocumentEditor: FC<DocumentEditorProps> = (\n  {\n    id,\n    label,\n    hideLabel = false,\n    headingLevel = 3,\n    markdown,\n    onChange,\n    readOnly = false,\n    baselineMarkdown,\n    viewModes,\n    initialViewMode = 'rich-text',\n    toolbarItems,\n    listTypes,\n    imageUploadHandler,\n    resolveResourceUrl,\n    headerActions,\n    annotations,\n    labels: customLabels,\n    customCssClasses = {},\n    onParseError\n  }\n) => {\n  const labels = useMemo(() => ({ ...defaultDocumentEditorLabels, ...customLabels }), [customLabels]);\n  const [parseError, setParseError] = useState<string | null>(null);\n  const [editorRevision, setEditorRevision] = useState(0);\n  // The latest text, so remounting the editor (e.g. to retry the visual editor) keeps edits even\n  // when the host does not feed onChange back into `markdown`.\n  const [currentMarkdown, setCurrentMarkdown] = useState(markdown);\n  const currentMarkdownRef = useRef(markdown);\n\n  useEffect(() => {\n    if (markdown !== currentMarkdownRef.current) {\n      currentMarkdownRef.current = markdown;\n      setCurrentMarkdown(markdown);\n      // A replacement document is parsed afresh, so the previous document's parse error no longer applies.\n      setParseError(null);\n      setEditorRevision((revision) => revision + 1);\n    }\n  }, [markdown]);\n\n  const handleChange = useCallback((nextMarkdown: string) => {\n    currentMarkdownRef.current = nextMarkdown;\n    setCurrentMarkdown(nextMarkdown);\n    onChange?.(nextMarkdown);\n  }, [onChange]);\n\n  const availableViewModes = useMemo<MarkdownEditorViewMode[]>(() => {\n    const requested = viewModes ?? (baselineMarkdown === undefined ? DEFAULT_VIEW_MODES : [...DEFAULT_VIEW_MODES, 'diff']);\n    const supported = requested.filter((mode) => mode !== 'diff' || baselineMarkdown !== undefined);\n    return parseError ? ['source', ...supported.filter((mode) => mode !== 'rich-text' && mode !== 'source')] : supported;\n  }, [viewModes, baselineMarkdown, parseError]);\n\n  const viewMode: MarkdownEditorViewMode = parseError ? 'source' : availableViewModes.includes(initialViewMode)\n    ? initialViewMode\n    : availableViewModes[0] ?? 'source';\n\n  const handleParseError = useCallback((error: string) => {\n    setParseError((current) => current ?? error);\n    onParseError?.(error);\n  }, [onParseError]);\n\n  const imagePreviewHandler = useMemo(\n    // A resolver returning nothing has rejected the source, so the preview is left empty rather than\n    // falling back to the unvetted original.\n    () => (resolveResourceUrl ? async (source: string) => resolveResourceUrl(source) ?? '' : undefined),\n    [resolveResourceUrl]\n  );\n\n  return (\n    <section\n      id={ id }\n      className={ `documentEditor ${ readOnly ? 'documentEditor--readOnly' : '' } ${ customCssClasses.wrapper || '' }`.trim() }\n      aria-label={ label }\n    >\n      { !hideLabel && (\n        <div className={ `documentEditor__header ${ customCssClasses.header || '' }`.trim() }>\n          <HeaderBar text={ label } headingLevel={ headingLevel }>\n            { headerActions }\n          </HeaderBar>\n        </div>\n      ) }\n\n      { hideLabel && headerActions && (\n        <div className={ `documentEditor__actions ${ customCssClasses.actions || '' }`.trim() }>{ headerActions }</div>\n      ) }\n\n      { parseError && (\n        <PageBanner id={ `${ id }_parseError` } type=\"warn\" icon=\"warning\" displayMode=\"inline\" animation=\"none\" disableClose>\n          <span role=\"status\">{ labels.parseErrorNotice }</span>\n          { /* Retried on request rather than after each edit, which would remount the editor on every keystroke. */ }\n          <SimpleButton\n            id={ `${ id }_retryRichText` }\n            label={ labels.retryRichText }\n            cssClass=\"button secondary outline compact documentEditor__retry\"\n            onClickHandler={ () => setParseError(null) }\n          />\n        </PageBanner>\n      ) }\n\n      <div className={ `documentEditor__editor ${ customCssClasses.editor || '' }`.trim() }>\n        <Suspense fallback={ <LoadingMessage heading={ labels.loadingHeading } loadingMessage={ labels.loadingMessage } isInline /> }>\n          <LazyMarkdownEditorEngine\n            // Remount in source mode once a parse error forces the fallback.\n            key={ `${ parseError ? 'source-fallback' : 'default' }_${ editorRevision }` }\n            markdown={ currentMarkdown }\n            onChange={ handleChange }\n            readOnly={ readOnly }\n            viewMode={ viewMode }\n            viewModes={ availableViewModes }\n            diffMarkdown={ baselineMarkdown }\n            toolbarItems={ toolbarItems }\n            listTypes={ listTypes }\n            imageUploadHandler={ imageUploadHandler }\n            imagePreviewHandler={ imagePreviewHandler }\n            contentCssClass={ customCssClasses.content }\n            annotations={ annotations }\n            annotationLayerId={ `${ id }_annotations` }\n            onParseError={ handleParseError }\n          />\n        </Suspense>\n      </div>\n    </section>\n  );\n};\n\nexport default DocumentEditor;\n"],"mappings":"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","ignoreList":[]}

package/dist/esm/widgets/documentEditor/documentEditor.css

@@ -0,0 +1,33 @@
+.documentEditor {
+  display: flex;
+  flex-direction: column;
+  gap: var(--documentEditorGap, var(--documentGap, 10px));
+  min-width: 0;
+}
+.documentEditor .headerBar {
+  margin-bottom: 0;
+}
+
+.documentEditor__actions {
+  display: flex;
+  justify-content: flex-end;
+  gap: var(--documentEditorGap, var(--documentGap, 10px));
+}
+
+.documentEditor__editor {
+  display: flex;
+  flex: 1;
+  flex-direction: column;
+  min-height: var(--documentEditorMinHeight, var(--documentFrameMinHeight, 65vh));
+  border: var(--documentEditorBorder, var(--documentBorder));
+  border-radius: var(--documentEditorBorderRadius, var(--documentBorderRadius, 5px));
+  background: var(--documentEditorBg, var(--documentBg, #fff));
+  overflow: auto;
+}
+.documentEditor__editor > aside {
+  margin: auto;
+}
+
+.documentEditor--readOnly .documentEditor__editor {
+  --markdownEditorEngineBg: var(--documentEditorReadOnlyBg, var(--documentSubtleBg));
+}

package/dist/esm/widgets/documentEditor/documentEditor.interfaces.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=documentEditor.interfaces.js.map

package/dist/esm/widgets/documentEditor/documentEditor.interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentEditor.interfaces.js","names":[],"sources":["../../../../src/widgets/documentEditor/documentEditor.interfaces.ts"],"sourcesContent":["import { ReactNode } from 'react';\n\nimport { DocumentAnnotationsProps } from '../shared/documents/annotations/annotations.interfaces';\nimport { ResolveResourceUrl } from '../shared/documents/documents.interfaces';\nimport {\n  MarkdownEditorImageUploadHandler,\n  MarkdownEditorListType,\n  MarkdownEditorToolbarItem,\n  MarkdownEditorViewMode\n} from '../shared/documents/engines/markdownEditor/markdownEditorEngine.interfaces';\n\nexport type DocumentEditorLabels = {\n  loadingHeading: string;\n  loadingMessage: string;\n  parseErrorNotice: string;\n  retryRichText: string;\n};\n\nexport type DocumentEditorCssClasses = {\n  wrapper?: string;\n  header?: string;\n  editor?: string;\n  content?: string;\n  actions?: string;\n};\n\nexport type DocumentEditorProps = {\n  id: string;\n  label: string;\n  // Visually hide the label while keeping it as the editor's accessible name.\n  hideLabel?: boolean;\n  headingLevel?: 1 | 2 | 3 | 4 | 5 | 6;\n  markdown: string;\n  /* eslint-disable-next-line no-unused-vars */\n  onChange?: (markdown: string) => void;\n  readOnly?: boolean;\n  // Supplying a baseline adds a diff mode that compares the edited document against it.\n  baselineMarkdown?: string;\n  viewModes?: MarkdownEditorViewMode[];\n  initialViewMode?: MarkdownEditorViewMode;\n  toolbarItems?: MarkdownEditorToolbarItem[];\n  listTypes?: MarkdownEditorListType[];\n  // Enables image insertion; resolves to the URL the uploaded image should be referenced by.\n  imageUploadHandler?: MarkdownEditorImageUploadHandler;\n  // Resolves image sources for preview, e.g. paths relative to the document.\n  resolveResourceUrl?: ResolveResourceUrl;\n  // Rendered beside the label, e.g. save or cancel buttons.\n  headerActions?: ReactNode;\n  // Pinned comments, shown and created in both the rich-text and source views.\n  annotations?: DocumentAnnotationsProps;\n  labels?: Partial<DocumentEditorLabels>;\n  customCssClasses?: DocumentEditorCssClasses;\n  /* eslint-disable-next-line no-unused-vars */\n  onParseError?: (error: string) => void;\n};\n\nexport type {\n  MarkdownEditorImageUploadHandler,\n  MarkdownEditorListType,\n  MarkdownEditorToolbarItem,\n  MarkdownEditorViewMode\n};\n"],"mappings":"","ignoreList":[]}

package/dist/esm/widgets/documentEditor/index.js

@@ -0,0 +1,2 @@
+export { DocumentEditor, defaultDocumentEditorLabels } from './DocumentEditor';
+//# sourceMappingURL=index.js.map

package/dist/esm/widgets/documentEditor/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["DocumentEditor","defaultDocumentEditorLabels"],"sources":["../../../../src/widgets/documentEditor/index.ts"],"sourcesContent":["export { DocumentEditor, defaultDocumentEditorLabels } from './DocumentEditor';\n\nexport type {\n  DocumentEditorCssClasses,\n  DocumentEditorLabels,\n  DocumentEditorProps,\n  MarkdownEditorImageUploadHandler,\n  MarkdownEditorListType,\n  MarkdownEditorToolbarItem,\n  MarkdownEditorViewMode\n} from './documentEditor.interfaces';\n"],"mappings":"AAAA,SAASA,cAAc,EAAEC,2BAA2B,QAAQ,kBAAkB","ignoreList":[]}

package/dist/esm/widgets/documentViewer/DocumentViewer.js

@@ -0,0 +1,198 @@
+'use client';
+
+import _extends from "@babel/runtime/helpers/extends";
+import React, { Suspense, useCallback, useEffect, useMemo, useState } from 'react';
+import { HeaderBar, PageBanner } from '../../components';
+import { LoadingMessage } from '../../components/design/loadingMessage/LoadingMessage';
+import { renderIcon } from '../../helpers/iconHelpers';
+import { formatFileSize } from '../../helpers/formatters';
+import { getDocumentFileName, getDocumentKind as getDefaultDocumentKind, resolveDocumentResourceWithFallback } from '../shared/documents/documentHelpers';
+import { AnnotationLayer } from '../shared/documents/annotations/AnnotationLayer';
+import { LazyMarkdownRenderer, LazyWordRenderer } from '../shared/documents/engines/lazyEngines';
+import { useDocumentContent } from '../shared/documents/useDocumentContent';
+import './documentViewer.css';
+export const defaultDocumentViewerLabels = {
+  loadingHeading: 'Loading',
+  loadingMessage: 'Loading document',
+  loadError: 'The document could not be loaded.',
+  unsupported: 'A preview is not available for this file type. Download the original file to open it.',
+  wordNotice: 'This is a browser representation of the Word document. Styling and pagination may differ from the original.',
+  imageError: 'The image could not be loaded.'
+};
+const getErrorDetail = error => error instanceof Error ? error.message : '';
+
+// Kinds rendered into the page's own DOM, which comments can be pinned to.
+const ANNOTATABLE_KINDS = ['markdown', 'text'];
+
+/*
+  DocumentViewer displays a document supplied as inline text, a File or a URL. PDFs and images
+  use the browser's native rendering; markdown and Word documents are rendered by engines that
+  are only downloaded when a document of that kind is first shown.
+ */
+export const DocumentViewer = ({
+  id,
+  document,
+  showHeader = true,
+  showMetadata = true,
+  headingLevel = 3,
+  headerActions,
+  metadataIcon = 'file-text',
+  contentHeadingOffset = 0,
+  showWordNotice = true,
+  renderers = {},
+  getDocumentKind = getDefaultDocumentKind,
+  resolveResourceUrl,
+  trustedPdfOrigins,
+  annotations,
+  labels: customLabels,
+  customCssClasses = {},
+  onStatusChange
+}) => {
+  const labels = useMemo(() => ({
+    ...defaultDocumentViewerLabels,
+    ...customLabels
+  }), [customLabels]);
+  const kind = useMemo(() => {
+    const detectedKind = getDefaultDocumentKind(document);
+    return detectedKind === 'unsupported' || getDocumentKind === getDefaultDocumentKind ? detectedKind : getDocumentKind(document);
+  }, [document, getDocumentKind]);
+  const content = useDocumentContent(document, kind, {
+    trustedPdfOrigins
+  });
+  const [renderFailure, setRenderFailure] = useState(null);
+
+  // A renderer failure belongs to the content it happened on and clears once different content loads.
+  const renderError = renderFailure && renderFailure.loaded === content.loaded ? renderFailure.error : undefined;
+  const handleRenderError = useCallback(error => {
+    if (content.loaded) {
+      setRenderFailure({
+        loaded: content.loaded,
+        error
+      });
+    }
+  }, [content.loaded]);
+  const isUnsupported = content.status === 'ready' && kind === 'unsupported';
+  const status = renderError !== undefined || isUnsupported ? 'error' : content.status;
+  const error = renderError ?? content.error;
+  useEffect(() => {
+    onStatusChange?.(status, error);
+  }, [status, error, onStatusChange]);
+  const resolveResource = useCallback(resource => resolveDocumentResourceWithFallback(resource, document.url, resolveResourceUrl), [resolveResourceUrl, document.url]);
+  const loadingIndicator = /*#__PURE__*/React.createElement(LoadingMessage, {
+    heading: labels.loadingHeading,
+    loadingMessage: labels.loadingMessage,
+    isInline: true
+  });
+  const builtInRenderers = {
+    pdf: ({
+      loaded
+    }) => /*#__PURE__*/React.createElement("iframe", {
+      title: document.title,
+      src: loaded.url,
+      className: "documentViewer__pdf",
+      referrerPolicy: "no-referrer"
+    }),
+    image: ({
+      loaded,
+      onError
+    }) => /*#__PURE__*/React.createElement("img", {
+      className: "documentViewer__image",
+      src: loaded.url,
+      alt: document.title,
+      onError: () => onError(new Error(labels.imageError))
+    }),
+    text: ({
+      loaded
+    }) => /*#__PURE__*/React.createElement("pre", {
+      className: "documentViewer__text"
+    }, /*#__PURE__*/React.createElement("code", null, loaded.content)),
+    markdown: ({
+      loaded,
+      headingOffset,
+      resolveResourceUrl: resolve
+    }) => /*#__PURE__*/React.createElement(Suspense, {
+      fallback: loadingIndicator
+    }, /*#__PURE__*/React.createElement(LazyMarkdownRenderer, {
+      markdown: loaded.content ?? '',
+      headingOffset: headingOffset,
+      resolveResourceUrl: resolve
+    })),
+    word: ({
+      loaded,
+      onError
+    }) => /*#__PURE__*/React.createElement(Suspense, {
+      fallback: loadingIndicator
+    }, /*#__PURE__*/React.createElement(LazyWordRenderer, {
+      arrayBuffer: loaded.arrayBuffer,
+      title: document.title,
+      cssClass: "documentViewer__word",
+      loadingIndicator: loadingIndicator,
+      onError: onError
+    }))
+  };
+  const renderContent = () => {
+    if (status === 'idle' || status === 'loading') {
+      return loadingIndicator;
+    }
+    if (status === 'error' || !content.loaded || kind === 'unsupported') {
+      const message = isUnsupported ? labels.unsupported : labels.loadError;
+      const detail = isUnsupported ? '' : getErrorDetail(error);
+      return /*#__PURE__*/React.createElement(PageBanner, {
+        id: `${id}_error`,
+        type: "error",
+        icon: "warning",
+        displayMode: "inline",
+        animation: "none",
+        disableClose: true
+      }, /*#__PURE__*/React.createElement("span", {
+        role: "alert"
+      }, message, detail && /*#__PURE__*/React.createElement("span", {
+        className: "documentViewer__errorDetail"
+      }, detail)));
+    }
+    const renderer = renderers[kind] ?? builtInRenderers[kind];
+    const rendered = renderer?.({
+      document,
+      loaded: content.loaded,
+      resolveResourceUrl: resolveResource,
+      headingOffset: contentHeadingOffset,
+      onError: handleRenderError
+    }) ?? null;
+    if (!annotations || !ANNOTATABLE_KINDS.includes(kind)) {
+      return rendered;
+    }
+    return /*#__PURE__*/React.createElement(AnnotationLayer, _extends({}, annotations, {
+      id: `${id}_annotations`
+    }), rendered);
+  };
+  const bytes = document.fileSize ?? document.file?.size;
+  const fileSize = bytes !== undefined && Number.isFinite(bytes) && bytes >= 0 ? formatFileSize(bytes) : '';
+  return /*#__PURE__*/React.createElement("section", {
+    id: id,
+    className: `documentViewer documentViewer--${kind} ${customCssClasses.wrapper || ''}`.trim(),
+    "aria-busy": status === 'loading'
+  }, showHeader && /*#__PURE__*/React.createElement(HeaderBar, {
+    text: document.title,
+    headingLevel: headingLevel
+  }, headerActions), showMetadata && /*#__PURE__*/React.createElement("div", {
+    className: `documentViewer__metadata ${customCssClasses.metadata || ''}`.trim()
+  }, renderIcon(metadataIcon, {
+    customCssClass: 'documentViewer__metadataIcon'
+  }), /*#__PURE__*/React.createElement("span", {
+    className: "documentViewer__fileName"
+  }, getDocumentFileName(document)), fileSize && /*#__PURE__*/React.createElement("small", {
+    className: "documentViewer__fileSize"
+  }, fileSize)), showWordNotice && kind === 'word' && status === 'ready' && /*#__PURE__*/React.createElement(PageBanner, {
+    id: `${id}_wordNotice`,
+    type: "info",
+    displayMode: "inline",
+    animation: "none",
+    disableClose: true
+  }, labels.wordNotice), /*#__PURE__*/React.createElement("div", {
+    className: `documentViewer__frame ${customCssClasses.frame || ''}`.trim()
+  }, /*#__PURE__*/React.createElement("div", {
+    className: `documentViewer__content ${customCssClasses.content || ''}`.trim()
+  }, renderContent())));
+};
+export default DocumentViewer;
+//# sourceMappingURL=DocumentViewer.js.map

package/dist/esm/widgets/documentViewer/DocumentViewer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocumentViewer.js","names":["_extends","React","Suspense","useCallback","useEffect","useMemo","useState","HeaderBar","PageBanner","LoadingMessage","renderIcon","formatFileSize","getDocumentFileName","getDocumentKind","getDefaultDocumentKind","resolveDocumentResourceWithFallback","AnnotationLayer","LazyMarkdownRenderer","LazyWordRenderer","useDocumentContent","defaultDocumentViewerLabels","loadingHeading","loadingMessage","loadError","unsupported","wordNotice","imageError","getErrorDetail","error","Error","message","ANNOTATABLE_KINDS","DocumentViewer","id","document","showHeader","showMetadata","headingLevel","headerActions","metadataIcon","contentHeadingOffset","showWordNotice","renderers","resolveResourceUrl","trustedPdfOrigins","annotations","labels","customLabels","customCssClasses","onStatusChange","kind","detectedKind","content","renderFailure","setRenderFailure","renderError","loaded","undefined","handleRenderError","isUnsupported","status","resolveResource","resource","url","loadingIndicator","createElement","heading","isInline","builtInRenderers","pdf","title","src","className","referrerPolicy","image","onError","alt","text","markdown","headingOffset","resolve","fallback","word","arrayBuffer","cssClass","renderContent","detail","type","icon","displayMode","animation","disableClose","role","renderer","rendered","includes","bytes","fileSize","file","size","Number","isFinite","wrapper","trim","metadata","customCssClass","frame"],"sources":["../../../../src/widgets/documentViewer/DocumentViewer.tsx"],"sourcesContent":["'use client';\n\nimport React, { FC, ReactNode, Suspense, useCallback, useEffect, useMemo, useState } from 'react';\n\nimport { HeaderBar, PageBanner } from '../../components';\nimport { LoadingMessage } from '../../components/design/loadingMessage/LoadingMessage';\nimport { renderIcon } from '../../helpers/iconHelpers';\nimport { formatFileSize } from '../../helpers/formatters';\nimport {\n  getDocumentFileName,\n  getDocumentKind as getDefaultDocumentKind,\n  resolveDocumentResourceWithFallback\n} from '../shared/documents/documentHelpers';\nimport { AnnotationLayer } from '../shared/documents/annotations/AnnotationLayer';\nimport { DocumentKind, DocumentLoadStatus, LoadedDocument } from '../shared/documents/documents.interfaces';\nimport { LazyMarkdownRenderer, LazyWordRenderer } from '../shared/documents/engines/lazyEngines';\nimport { useDocumentContent } from '../shared/documents/useDocumentContent';\nimport {\n  DocumentRenderers,\n  DocumentViewerLabels,\n  DocumentViewerProps\n} from './documentViewer.interfaces';\n\nimport './documentViewer.scss';\n\nexport const defaultDocumentViewerLabels: DocumentViewerLabels = {\n  loadingHeading: 'Loading',\n  loadingMessage: 'Loading document',\n  loadError: 'The document could not be loaded.',\n  unsupported: 'A preview is not available for this file type. Download the original file to open it.',\n  wordNotice: 'This is a browser representation of the Word document. Styling and pagination may differ from the original.',\n  imageError: 'The image could not be loaded.'\n};\n\nconst getErrorDetail = (error: unknown): string => (error instanceof Error ? error.message : '');\n\n// Kinds rendered into the page's own DOM, which comments can be pinned to.\nconst ANNOTATABLE_KINDS: DocumentKind[] = ['markdown', 'text'];\n\n/*\n  DocumentViewer displays a document supplied as inline text, a File or a URL. PDFs and images\n  use the browser's native rendering; markdown and Word documents are rendered by engines that\n  are only downloaded when a document of that kind is first shown.\n */\nexport const DocumentViewer: FC<DocumentViewerProps> = (\n  {\n    id,\n    document,\n    showHeader = true,\n    showMetadata = true,\n    headingLevel = 3,\n    headerActions,\n    metadataIcon = 'file-text',\n    contentHeadingOffset = 0,\n    showWordNotice = true,\n    renderers = {},\n    getDocumentKind = getDefaultDocumentKind,\n    resolveResourceUrl,\n    trustedPdfOrigins,\n    annotations,\n    labels: customLabels,\n    customCssClasses = {},\n    onStatusChange\n  }\n) => {\n  const labels = useMemo(() => ({ ...defaultDocumentViewerLabels, ...customLabels }), [customLabels]);\n  const kind = useMemo(() => {\n    const detectedKind = getDefaultDocumentKind(document);\n    return detectedKind === 'unsupported' || getDocumentKind === getDefaultDocumentKind\n      ? detectedKind\n      : getDocumentKind(document);\n  }, [document, getDocumentKind]);\n  const content = useDocumentContent(document, kind, { trustedPdfOrigins });\n  const [renderFailure, setRenderFailure] = useState<{ loaded: LoadedDocument; error: unknown } | null>(null);\n\n  // A renderer failure belongs to the content it happened on and clears once different content loads.\n  const renderError = renderFailure && renderFailure.loaded === content.loaded ? renderFailure.error : undefined;\n  const handleRenderError = useCallback((error: unknown) => {\n    if (content.loaded) {\n      setRenderFailure({ loaded: content.loaded, error });\n    }\n  }, [content.loaded]);\n\n  const isUnsupported = content.status === 'ready' && kind === 'unsupported';\n  const status: DocumentLoadStatus = renderError !== undefined || isUnsupported ? 'error' : content.status;\n  const error = renderError ?? content.error;\n\n  useEffect(() => {\n    onStatusChange?.(status, error);\n  }, [status, error, onStatusChange]);\n\n  const resolveResource = useCallback(\n    (resource: string) => resolveDocumentResourceWithFallback(resource, document.url, resolveResourceUrl),\n    [resolveResourceUrl, document.url]\n  );\n\n  const loadingIndicator = (\n    <LoadingMessage heading={ labels.loadingHeading } loadingMessage={ labels.loadingMessage } isInline />\n  );\n\n  const builtInRenderers: DocumentRenderers = {\n    pdf: ({ loaded }) => (\n      <iframe title={ document.title } src={ loaded.url } className=\"documentViewer__pdf\" referrerPolicy=\"no-referrer\" />\n    ),\n    image: ({ loaded, onError }) => (\n      <img\n        className=\"documentViewer__image\"\n        src={ loaded.url }\n        alt={ document.title }\n        onError={ () => onError(new Error(labels.imageError)) }\n      />\n    ),\n    text: ({ loaded }) => (\n      <pre className=\"documentViewer__text\">\n        <code>{ loaded.content }</code>\n      </pre>\n    ),\n    markdown: ({ loaded, headingOffset, resolveResourceUrl: resolve }) => (\n      <Suspense fallback={ loadingIndicator }>\n        <LazyMarkdownRenderer markdown={ loaded.content ?? '' } headingOffset={ headingOffset } resolveResourceUrl={ resolve } />\n      </Suspense>\n    ),\n    word: ({ loaded, onError }) => (\n      <Suspense fallback={ loadingIndicator }>\n        <LazyWordRenderer\n          arrayBuffer={ loaded.arrayBuffer as ArrayBuffer }\n          title={ document.title }\n          cssClass=\"documentViewer__word\"\n          loadingIndicator={ loadingIndicator }\n          onError={ onError }\n        />\n      </Suspense>\n    )\n  };\n\n  const renderContent = (): ReactNode => {\n    if (status === 'idle' || status === 'loading') {\n      return loadingIndicator;\n    }\n    if (status === 'error' || !content.loaded || kind === 'unsupported') {\n      const message = isUnsupported ? labels.unsupported : labels.loadError;\n      const detail = isUnsupported ? '' : getErrorDetail(error);\n      return (\n        <PageBanner id={ `${ id }_error` } type=\"error\" icon=\"warning\" displayMode=\"inline\" animation=\"none\" disableClose>\n          <span role=\"alert\">\n            { message }\n            { detail && <span className=\"documentViewer__errorDetail\">{ detail }</span> }\n          </span>\n        </PageBanner>\n      );\n    }\n    const renderer = renderers[kind] ?? builtInRenderers[kind];\n    const rendered = renderer?.({\n      document,\n      loaded: content.loaded,\n      resolveResourceUrl: resolveResource,\n      headingOffset: contentHeadingOffset,\n      onError: handleRenderError\n    }) ?? null;\n    if (!annotations || !ANNOTATABLE_KINDS.includes(kind)) {\n      return rendered;\n    }\n    return <AnnotationLayer { ...annotations } id={ `${ id }_annotations` }>{ rendered }</AnnotationLayer>;\n  };\n\n  const bytes = document.fileSize ?? document.file?.size;\n  const fileSize = bytes !== undefined && Number.isFinite(bytes) && bytes >= 0 ? formatFileSize(bytes) : '';\n\n  return (\n    <section\n      id={ id }\n      className={ `documentViewer documentViewer--${ kind } ${ customCssClasses.wrapper || '' }`.trim() }\n      aria-busy={ status === 'loading' }\n    >\n      { showHeader && (\n        <HeaderBar text={ document.title } headingLevel={ headingLevel }>\n          { headerActions }\n        </HeaderBar>\n      ) }\n\n      { showMetadata && (\n        <div className={ `documentViewer__metadata ${ customCssClasses.metadata || '' }`.trim() }>\n          { renderIcon(metadataIcon, { customCssClass: 'documentViewer__metadataIcon' }) }\n          <span className=\"documentViewer__fileName\">{ getDocumentFileName(document) }</span>\n          { fileSize && <small className=\"documentViewer__fileSize\">{ fileSize }</small> }\n        </div>\n      ) }\n\n      { showWordNotice && kind === 'word' && status === 'ready' && (\n        <PageBanner id={ `${ id }_wordNotice` } type=\"info\" displayMode=\"inline\" animation=\"none\" disableClose>\n          { labels.wordNotice }\n        </PageBanner>\n      ) }\n\n      <div className={ `documentViewer__frame ${ customCssClasses.frame || '' }`.trim() }>\n        <div className={ `documentViewer__content ${ customCssClasses.content || '' }`.trim() }>\n          { renderContent() }\n        </div>\n      </div>\n    </section>\n  );\n};\n\nexport default DocumentViewer;\n"],"mappings":"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","ignoreList":[]}