betterstart-cli 0.0.100 → 0.0.102

package/dist/assets/adapters/next/templates/init/utils/editor/is-selected-table-visible.ts

@@ -0,0 +1,8 @@
+import type { Editor } from '@tiptap/core'
+import { getSelectionTableElement } from '@admin/utils/editor/get-selection-table-element'
+import { isElementVisibleInEditor } from '@admin/utils/editor/is-element-visible-in-editor'
+
+export function isSelectedTableVisible(editor: Editor) {
+  const table = getSelectionTableElement(editor)
+  return table ? isElementVisibleInEditor(editor, table) : false
+}

package/dist/assets/adapters/next/templates/init/utils/editor/is-task-item-checked.ts

@@ -0,0 +1,5 @@
+import type { Node as ProseMirrorNode } from '@tiptap/pm/model'
+
+export function isTaskItemChecked(node: ProseMirrorNode): boolean {
+  return node.attrs.checked === true
+}

package/dist/assets/adapters/next/templates/init/utils/editor/is-valid-dollar-inline-math.ts

@@ -0,0 +1,13 @@
+'use client'
+
+export function isValidDollarInlineMath(src: string, text: string, closingIndex: number) {
+  if (!text.trim() || text.includes('\n')) return false
+  if (/^\s|\s$/u.test(text)) return false
+
+  const nextCharacter = src[closingIndex + 1]
+  if (nextCharacter && nextCharacter.trim() !== '' && !Number.isNaN(Number(nextCharacter))) {
+    return false
+  }
+
+  return true
+}

package/dist/assets/adapters/next/templates/init/utils/editor/is-valid-position.ts

@@ -0,0 +1,3 @@
+export function isValidPosition(pos: number | null | undefined): pos is number {
+  return typeof pos === 'number' && pos >= 0
+}

package/dist/assets/adapters/next/templates/init/utils/editor/is-word-character.ts

@@ -0,0 +1,3 @@
+export function isWordCharacter(character: string | undefined): boolean {
+  return Boolean(character && /\w/.test(character))
+}

package/dist/assets/adapters/next/templates/init/utils/editor/mac-symbols.ts

@@ -0,0 +1,15 @@
+export const MAC_SYMBOLS: Record<string, string> = {
+  mod: '⌘',
+  command: '⌘',
+  meta: '⌘',
+  ctrl: '⌃',
+  control: '⌃',
+  alt: '⌥',
+  option: '⌥',
+  shift: '⇧',
+  backspace: 'Del',
+  delete: '⌦',
+  enter: '⏎',
+  escape: '⎋',
+  capslock: '⇪'
+} as const

package/dist/assets/adapters/next/templates/init/utils/editor/markdown-heading-level.ts

@@ -0,0 +1 @@
+export type MarkdownHeadingLevel = 2 | 3 | 4 | 5 | 6

package/dist/assets/adapters/next/templates/init/utils/editor/markdown-heading-option.ts

@@ -0,0 +1,6 @@
+import type { MarkdownHeadingLevel } from '@admin/utils/editor/markdown-heading-level'
+
+export interface MarkdownHeadingOption {
+  level: MarkdownHeadingLevel
+  label: string
+}

package/dist/assets/adapters/next/templates/init/utils/editor/markdown-heading-options.ts

@@ -0,0 +1,9 @@
+import type { MarkdownHeadingOption } from '@admin/utils/editor/markdown-heading-option'
+
+export const MARKDOWN_HEADING_OPTIONS: MarkdownHeadingOption[] = [
+  { level: 2, label: 'Heading 2' },
+  { level: 3, label: 'Heading 3' },
+  { level: 4, label: 'Heading 4' },
+  { level: 5, label: 'Heading 5' },
+  { level: 6, label: 'Heading 6' }
+]

package/dist/assets/adapters/next/templates/init/utils/editor/markdown-image-upload-result.ts

@@ -0,0 +1,4 @@
+export interface MarkdownImageUploadResult {
+  url: string
+  filename: string
+}

package/dist/assets/adapters/next/templates/init/utils/editor/markdown-list-option.ts

@@ -0,0 +1,6 @@
+import type { MarkdownListType } from '@admin/utils/editor/markdown-list-type'
+
+export interface MarkdownListOption {
+  type: MarkdownListType
+  label: string
+}

package/dist/assets/adapters/next/templates/init/utils/editor/markdown-list-options.ts

@@ -0,0 +1,7 @@
+import type { MarkdownListOption } from '@admin/utils/editor/markdown-list-option'
+
+export const MARKDOWN_LIST_OPTIONS: MarkdownListOption[] = [
+  { type: 'bullet', label: 'Bullet list' },
+  { type: 'ordered', label: 'Ordered list' },
+  { type: 'task', label: 'Task list' }
+]

package/dist/assets/adapters/next/templates/init/utils/editor/markdown-list-type.ts

@@ -0,0 +1 @@
+export type MarkdownListType = 'bullet' | 'ordered' | 'task'

package/dist/assets/adapters/next/templates/init/utils/editor/markdown-offset-from-plain-text-offset.ts

@@ -0,0 +1,8 @@
+import { createMarkdownPlainTextOffsetMap } from '@admin/utils/editor/create-markdown-plain-text-offset-map'
+
+export function markdownOffsetFromPlainTextOffset(markdown: string, textOffset: number): number {
+  const offsetMap = createMarkdownPlainTextOffsetMap(markdown)
+  const safeOffset = Math.max(0, Math.min(textOffset, offsetMap.plainToMarkdownOffsets.length - 1))
+
+  return offsetMap.plainToMarkdownOffsets[safeOffset] ?? markdown.length
+}

package/dist/assets/adapters/next/templates/init/utils/editor/match-block-math.ts

@@ -0,0 +1,54 @@
+'use client'
+
+import type { RawContentMatch } from '@admin/utils/editor/raw-content-match'
+
+const mathBlockEnvironmentNames = new Set([
+  'align',
+  'align*',
+  'aligned',
+  'alignedat',
+  'alignedat*',
+  'array',
+  'bmatrix',
+  'cases',
+  'equation',
+  'equation*',
+  'gather',
+  'gather*',
+  'gathered',
+  'matrix',
+  'multline',
+  'multline*',
+  'pmatrix',
+  'smallmatrix',
+  'split',
+  'vmatrix'
+])
+
+export function matchBlockMath(src: string): RawContentMatch | null {
+  const bracketMatch = /^\\\[[\s\S]*?\\\][ \t]*(?:\n|$)/.exec(src)
+  if (bracketMatch) {
+    return {
+      kind: 'math',
+      raw: bracketMatch[0].trimEnd()
+    }
+  }
+
+  const dollarMatch = /^\$\$[\s\S]*?\$\$[ \t]*(?:\n|$)/.exec(src)
+  if (dollarMatch) {
+    return {
+      kind: 'math',
+      raw: dollarMatch[0].trimEnd()
+    }
+  }
+
+  const environmentMatch = /^\\begin\{([^}]+)\}[\s\S]*?\\end\{\1\}[ \t]*(?:\n|$)/.exec(src)
+  if (environmentMatch && mathBlockEnvironmentNames.has(environmentMatch[1])) {
+    return {
+      kind: 'math',
+      raw: environmentMatch[0].trimEnd()
+    }
+  }
+
+  return null
+}

package/dist/assets/adapters/next/templates/init/utils/editor/match-code-fence-start.ts

@@ -0,0 +1,8 @@
+import { isMarkdownLineStart } from '@admin/utils/editor/is-markdown-line-start'
+
+export function matchCodeFenceStart(markdown: string, index: number): number | null {
+  if (!isMarkdownLineStart(markdown, index)) return null
+
+  const match = /^```[^\n]*(?:\n|$)/.exec(markdown.slice(index))
+  return match ? index + match[0].length : null
+}

package/dist/assets/adapters/next/templates/init/utils/editor/match-html-block.ts

@@ -0,0 +1,31 @@
+'use client'
+
+import type { RawContentMatch } from '@admin/utils/editor/raw-content-match'
+import { rawHtmlBlockTags } from '@admin/utils/editor/raw-html-block-tags'
+import { selfClosingHtmlBlockTags } from '@admin/utils/editor/self-closing-html-block-tags'
+
+export function matchHtmlBlock(src: string): RawContentMatch | null {
+  const pairedTagMatch = new RegExp(
+    `^<(${rawHtmlBlockTags})\\b[\\s\\S]*?<\\/\\1>[ \\t]*(?:\\n|$)`,
+    'i'
+  ).exec(src)
+
+  if (pairedTagMatch) {
+    return {
+      kind: 'html',
+      raw: pairedTagMatch[0].trimEnd()
+    }
+  }
+
+  const selfClosingMatch = new RegExp(
+    `^<(${selfClosingHtmlBlockTags})\\b[^>]*(?:\\/?>)[ \\t]*(?:\\n|$)`,
+    'i'
+  ).exec(src)
+
+  if (!selfClosingMatch) return null
+
+  return {
+    kind: 'html',
+    raw: selfClosingMatch[0].trimEnd()
+  }
+}

package/dist/assets/adapters/next/templates/init/utils/editor/match-html-mark-syntax.ts

@@ -0,0 +1,16 @@
+import { CONTENT_EDITOR_HIGHLIGHT_COLOR_NAME_PATTERN } from '@admin/utils/editor/content-editor-highlight-color-name-pattern'
+
+const HIGHLIGHT_SPAN_OPEN_PATTERN = new RegExp(
+  `^<span\\s+data-highlight-color="(?:${CONTENT_EDITOR_HIGHLIGHT_COLOR_NAME_PATTERN})">`,
+  'i'
+)
+
+export function matchHtmlMarkSyntax(markdown: string, index: number): number | null {
+  const remaining = markdown.slice(index)
+  const match =
+    /^<\/?(?:u|sub|sup|kbd)>/i.exec(remaining) ??
+    HIGHLIGHT_SPAN_OPEN_PATTERN.exec(remaining) ??
+    /^<\/span>/i.exec(remaining)
+
+  return match ? index + match[0].length : null
+}

package/dist/assets/adapters/next/templates/init/utils/editor/match-inline-math.ts

@@ -0,0 +1,49 @@
+'use client'
+
+import type { InlineMathDelimiter } from '@admin/utils/editor/inline-math-delimiter'
+import { findUnescapedCharacter } from '@admin/utils/editor/find-unescaped-character'
+import { findUnescapedSequence } from '@admin/utils/editor/find-unescaped-sequence'
+import { isValidDollarInlineMath } from '@admin/utils/editor/is-valid-dollar-inline-math'
+
+interface InlineMathMatch {
+  raw: string
+  text: string
+  delimiter: InlineMathDelimiter
+}
+
+export function matchInlineMath(src: string): InlineMathMatch | null {
+  if (src.startsWith('\\(')) {
+    const closingIndex = findUnescapedSequence(src, '\\)', 2)
+    if (closingIndex === -1) return null
+
+    return {
+      raw: src.slice(0, closingIndex + 2),
+      text: src.slice(2, closingIndex),
+      delimiter: '\\('
+    }
+  }
+
+  if (!src.startsWith('$') || src.startsWith('$$')) return null
+
+  if (src[1] && /\s/u.test(src[1])) return null
+
+  let closingIndex = 1
+
+  while (closingIndex < src.length) {
+    closingIndex = findUnescapedCharacter(src, '$', closingIndex)
+    if (closingIndex === -1) return null
+
+    const text = src.slice(1, closingIndex)
+    if (isValidDollarInlineMath(src, text, closingIndex)) {
+      return {
+        raw: src.slice(0, closingIndex + 1),
+        text,
+        delimiter: '$'
+      }
+    }
+
+    closingIndex++
+  }
+
+  return null
+}

package/dist/assets/adapters/next/templates/init/utils/editor/match-markdown-block-prefix.ts

@@ -0,0 +1,11 @@
+import { isMarkdownLineStart } from '@admin/utils/editor/is-markdown-line-start'
+
+export function matchMarkdownBlockPrefix(markdown: string, index: number): number | null {
+  if (!isMarkdownLineStart(markdown, index)) return null
+
+  const match = /^(?: {0,3}(?:#{1,6}\s+|>\s?|[-*+]\s+\[[ xX]\]\s+|[-*+]\s+|\d+[.)]\s+))/.exec(
+    markdown.slice(index)
+  )
+
+  return match ? index + match[0].length : null
+}

package/dist/assets/adapters/next/templates/init/utils/editor/match-markdown-mark-syntax.ts

@@ -0,0 +1,27 @@
+import { isWordCharacter } from '@admin/utils/editor/is-word-character'
+
+export function matchMarkdownMarkSyntax(markdown: string, index: number): number | null {
+  const character = markdown[index]
+  const nextCharacter = markdown[index + 1]
+  const previousCharacter = markdown[index - 1]
+
+  if (character === '`') {
+    const match = /^`+/.exec(markdown.slice(index))
+    return match ? index + match[0].length : null
+  }
+
+  if (character === '*' || character === '~') {
+    const match = new RegExp(`^\\${character}+`).exec(markdown.slice(index))
+    return match ? index + Math.min(match[0].length, 2) : null
+  }
+
+  if (
+    character === '_' &&
+    !(isWordCharacter(previousCharacter) && isWordCharacter(nextCharacter))
+  ) {
+    const match = /^_+/.exec(markdown.slice(index))
+    return match ? index + Math.min(match[0].length, 2) : null
+  }
+
+  return null
+}

package/dist/assets/adapters/next/templates/init/utils/editor/match-raw-content-block.ts

@@ -0,0 +1,9 @@
+'use client'
+
+import type { RawContentMatch } from '@admin/utils/editor/raw-content-match'
+import { matchBlockMath } from '@admin/utils/editor/match-block-math'
+import { matchHtmlBlock } from '@admin/utils/editor/match-html-block'
+
+export function matchRawContentBlock(src: string): RawContentMatch | null {
+  return matchBlockMath(src) ?? matchHtmlBlock(src) ?? null
+}

package/dist/assets/adapters/next/templates/init/utils/editor/mounted-editor-view.ts

@@ -0,0 +1,3 @@
+import type { Editor } from '@tiptap/react'
+
+export type MountedEditorView = Editor['view']

package/dist/assets/adapters/next/templates/init/utils/editor/normalize-editor-markdown.ts

@@ -0,0 +1,3 @@
+export function normalizeEditorMarkdown(markdown: string): string {
+  return markdown.trim()
+}

package/dist/assets/adapters/next/templates/init/utils/editor/parse-content-editor-math-input.ts

@@ -0,0 +1,98 @@
+import type { ContentEditorInlineMathDelimiter } from '@admin/utils/editor/content-editor-inline-math-delimiter'
+import type { ContentEditorMathKind } from '@admin/utils/editor/content-editor-math-kind'
+import type { ContentEditorMathValue } from '@admin/utils/editor/content-editor-math-value'
+
+const BLOCK_MATH_ENVIRONMENT_NAMES = new Set([
+  'align',
+  'align*',
+  'aligned',
+  'alignedat',
+  'alignedat*',
+  'array',
+  'bmatrix',
+  'cases',
+  'equation',
+  'equation*',
+  'gather',
+  'gather*',
+  'gathered',
+  'matrix',
+  'multline',
+  'multline*',
+  'pmatrix',
+  'smallmatrix',
+  'split',
+  'vmatrix'
+])
+
+export function parseContentEditorMathInput(
+  input: string,
+  preferredKind?: ContentEditorMathKind
+): ContentEditorMathValue | null {
+  const value = input.trim()
+
+  if (!value) return null
+
+  const inlineParen = /^\\\(([\s\S]*?)\\\)$/.exec(value)
+  const inlineDollar = /^\$([^\n]*?)\$$/.exec(value)
+  const displayBracket = /^\\\[([\s\S]*?)\\\]$/.exec(value)
+  const displayDollar = /^\$\$([\s\S]*?)\$\$$/.exec(value)
+  const environment = /^\\begin\{([^}]+)\}[\s\S]*\\end\{\1\}$/.exec(value)
+  const isSupportedEnvironment = Boolean(
+    environment && BLOCK_MATH_ENVIRONMENT_NAMES.has(environment[1])
+  )
+  const displayRaw =
+    displayBracket || displayDollar || isSupportedEnvironment || value.includes('\n')
+
+  if (preferredKind === 'inline') {
+    const raw = (
+      inlineParen?.[1] ??
+      inlineDollar?.[1] ??
+      displayBracket?.[1] ??
+      displayDollar?.[1] ??
+      value
+    ).trim()
+
+    if (!raw) return null
+
+    const delimiter: ContentEditorInlineMathDelimiter = inlineParen ? '\\(' : '$'
+
+    return {
+      delimiter,
+      kind: 'inline',
+      markdown: delimiter === '\\(' ? `\\(${raw}\\)` : `$${raw}$`,
+      raw
+    }
+  }
+
+  if (preferredKind === 'display' || displayRaw) {
+    if (displayBracket || displayDollar || isSupportedEnvironment) {
+      return {
+        kind: 'display',
+        markdown: value,
+        raw: value
+      }
+    }
+
+    const raw = inlineParen?.[1] ?? inlineDollar?.[1] ?? value
+    const markdown = raw.includes('\n') ? `$$\n${raw.trim()}\n$$` : `$$${raw.trim()}$$`
+
+    return {
+      kind: 'display',
+      markdown,
+      raw: markdown
+    }
+  }
+
+  const raw = inlineParen?.[1] ?? inlineDollar?.[1] ?? value
+  const delimiter: ContentEditorInlineMathDelimiter = inlineParen ? '\\(' : '$'
+
+  if (!raw.trim()) return null
+
+  return {
+    delimiter,
+    kind: 'inline',
+    markdown: delimiter === '\\(' ? `\\(${raw.trim()}\\)` : `$${raw.trim()}$`,
+    raw: raw.trim()
+  }
+}

package/dist/assets/adapters/next/templates/init/utils/editor/parse-shortcut-keys.ts

@@ -0,0 +1,17 @@
+import { formatShortcutKey } from '@admin/utils/editor/format-shortcut-key'
+import { isMac } from '@admin/utils/editor/is-mac'
+
+export const parseShortcutKeys = (props: {
+  shortcutKeys: string | undefined
+  delimiter?: string
+  capitalize?: boolean
+}) => {
+  const { shortcutKeys, delimiter = '+', capitalize = true } = props
+
+  if (!shortcutKeys) return []
+
+  return shortcutKeys
+    .split(delimiter)
+    .map((key) => key.trim())
+    .map((key) => formatShortcutKey(key, isMac(), capitalize))
+}

package/dist/assets/adapters/next/templates/init/utils/editor/prepare-markdown-for-rich-mode.ts

@@ -0,0 +1,3 @@
+export function prepareMarkdownForRichMode(markdown: string): string {
+  return markdown
+}

package/dist/assets/adapters/next/templates/init/utils/editor/protocol-config.ts

@@ -0,0 +1,7 @@
+type ProtocolOptions = {
+  scheme: string
+
+  optionalSlashes?: boolean
+}
+
+export type ProtocolConfig = Array<ProtocolOptions | string>

package/dist/assets/adapters/next/templates/init/utils/editor/raw-content-block-node-view.ts

@@ -0,0 +1,120 @@
+'use client'
+
+import type { RawContentKind } from '@admin/utils/editor/raw-content-kind'
+import type { Node as ProseMirrorNode } from '@tiptap/pm/model'
+import type { EditorView } from '@tiptap/pm/view'
+import { getRawContentKind } from '@admin/utils/editor/get-raw-content-kind'
+import { getStringAttr } from '@admin/utils/editor/get-string-attr'
+import { renderRawContentPreview } from '@admin/utils/editor/render-raw-content-preview'
+import { serializeRawContentPreview } from '@admin/utils/editor/serialize-raw-content-preview'
+
+interface RawContentBlockNodeViewOptions {
+  getPos: () => number | undefined
+  node: ProseMirrorNode
+  view: EditorView
+}
+
+export class RawContentBlockNodeView {
+  readonly dom: HTMLElement
+  private readonly preview: HTMLElement
+  private readonly abortController = new AbortController()
+  private currentRaw: string
+  private node: ProseMirrorNode
+
+  constructor(private readonly options: RawContentBlockNodeViewOptions) {
+    this.node = options.node
+    this.currentRaw = getStringAttr(options.node.attrs.raw)
+
+    const kind = getRawContentKind(options.node.attrs.kind)
+    this.dom = document.createElement('div')
+    this.dom.dataset.contentEditorRawBlock = kind
+    this.dom.dataset.raw = this.currentRaw
+    this.dom.contentEditable = 'false'
+    this.dom.className =
+      'content-editor-raw-block not-prose my-4 overflow-hidden rounded-md border bg-muted/20'
+
+    this.preview = document.createElement('div')
+    this.preview.contentEditable = 'true'
+    this.preview.dataset.contentEditorRawEditable = 'true'
+    this.preview.setAttribute('role', 'textbox')
+    this.preview.setAttribute('aria-label', 'Editable rendered HTML')
+    this.preview.spellcheck = true
+    this.preview.className =
+      'content-editor-raw-block-preview overflow-auto p-4 outline-none focus-visible:ring-[3px] focus-visible:ring-ring/50'
+    this.render(this.currentRaw, kind)
+
+    this.preview.addEventListener('input', this.handleInput, {
+      signal: this.abortController.signal
+    })
+    this.preview.addEventListener('blur', this.handleInput, {
+      signal: this.abortController.signal
+    })
+    this.dom.append(this.preview)
+  }
+
+  update(node: ProseMirrorNode) {
+    if (node.type !== this.node.type) return false
+
+    this.node = node
+    const nextKind = getRawContentKind(node.attrs.kind)
+    const nextRaw = getStringAttr(node.attrs.raw)
+    this.dom.dataset.contentEditorRawBlock = nextKind
+    this.dom.dataset.raw = nextRaw
+
+    if (nextRaw !== this.currentRaw) {
+      this.currentRaw = nextRaw
+      this.render(nextRaw, nextKind)
+    }
+
+    return true
+  }
+
+  stopEvent(event: Event) {
+    const kind = getRawContentKind(this.node.attrs.kind)
+
+    return (
+      kind !== 'math' &&
+      event.target instanceof globalThis.Node &&
+      this.preview.contains(event.target)
+    )
+  }
+
+  ignoreMutation() {
+    return true
+  }
+
+  destroy() {
+    this.abortController.abort()
+  }
+
+  private readonly handleInput = () => {
+    const kind = getRawContentKind(this.node.attrs.kind)
+    if (kind === 'math') return
+
+    const nextRaw = serializeRawContentPreview(this.preview, kind)
+
+    if (nextRaw === this.currentRaw) return
+
+    this.currentRaw = nextRaw
+    this.dom.dataset.raw = nextRaw
+
+    const position = this.options.getPos()
+    if (typeof position !== 'number') return
+
+    this.options.view.dispatch(
+      this.options.view.state.tr.setNodeMarkup(position, undefined, {
+        ...this.node.attrs,
+        raw: nextRaw
+      })
+    )
+  }
+
+  private render(raw: string, kind: RawContentKind) {
+    this.preview.contentEditable = kind === 'math' ? 'false' : 'true'
+    this.preview.setAttribute(
+      'aria-label',
+      kind === 'math' ? 'Rendered LaTeX' : 'Editable rendered HTML'
+    )
+    this.preview.innerHTML = renderRawContentPreview(raw, kind)
+  }
+}

package/dist/assets/adapters/next/templates/init/utils/editor/raw-content-kind.ts

@@ -0,0 +1,3 @@
+'use client'
+
+export type RawContentKind = 'html' | 'math'

package/dist/assets/adapters/next/templates/init/utils/editor/raw-content-match.ts

@@ -0,0 +1,8 @@
+'use client'
+
+import type { RawContentKind } from '@admin/utils/editor/raw-content-kind'
+
+export interface RawContentMatch {
+  kind: RawContentKind
+  raw: string
+}

package/dist/assets/adapters/next/templates/init/utils/editor/raw-html-block-tags.ts

@@ -0,0 +1,14 @@
+'use client'
+
+export const rawHtmlBlockTags = [
+  'article',
+  'aside',
+  'audio',
+  'details',
+  'div',
+  'figure',
+  'iframe',
+  'section',
+  'table',
+  'video'
+].join('|')