@manuscripts/body-editor 3.12.67 → 3.13.0

package/src/toolbar.tsx

@@ -0,0 +1,259 @@
+/*!
+ * © 2019 Atypon Systems LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import {
+  AddCommentIcon,
+  FileImageIcon,
+  LinkIcon,
+  OutlineBlockQuoteIcon,
+  OutlineEmbedIcon,
+  OutlinePullQuoteIcon,
+  ToolbarBoldIcon,
+  ToolbarBoxedTextIcon,
+  ToolbarCitationIcon,
+  ToolbarEquationIcon,
+  ToolbarFigureIcon,
+  ToolbarIndentIcon,
+  ToolbarItalicIcon,
+  ToolbarOrderedListIcon,
+  ToolbarSpecialCharactersIcon,
+  ToolbarSubscriptIcon,
+  ToolbarSuperscriptIcon,
+  ToolbarTableIcon,
+  ToolbarUnderlineIcon,
+  ToolbarUnindentIcon,
+  ToolbarUnorderedListIcon,
+} from '@manuscripts/style-guide'
+import { schema } from '@manuscripts/transform'
+import { toggleMark } from 'prosemirror-commands'
+import { EditorState } from 'prosemirror-state'
+import { EditorView } from 'prosemirror-view'
+import React, { ReactNode } from 'react'
+
+import {
+  addInlineComment,
+  blockActive,
+  canInsert,
+  Dispatch,
+  insertBlock,
+  insertBoxElement,
+  insertEmbed,
+  insertInlineCitation,
+  insertLink,
+  insertList,
+  markActive,
+} from './commands'
+import {
+  changeIndentation,
+  isIndentationAllowed,
+} from './components/toolbar/helpers'
+import { openInsertTableDialog } from './components/toolbar/InsertTableDialog'
+import { openInsertSpecialCharacterDialog } from './components/views/InsertSpecialCharacter'
+import { isEditAllowed } from './lib/utils'
+
+export interface ToolbarButtonConfig {
+  title: string
+  content: ReactNode
+  isActive?: (state: EditorState) => boolean
+  run: (state: EditorState, dispatch: Dispatch, view?: EditorView) => void
+  isEnabled: (state: EditorState) => boolean
+  options?: {
+    [key: string]: (
+      state: EditorState,
+      dispatch: Dispatch,
+      view?: EditorView
+    ) => void
+  }
+}
+
+const isEnabled =
+  (isCommandEnabled: (state: EditorState) => boolean) =>
+  (state: EditorState) => {
+    return isEditAllowed(state) && isCommandEnabled(state)
+  }
+
+export interface ToolbarConfig {
+  [key: string]: {
+    [key: string]: ToolbarButtonConfig
+  }
+}
+
+export const toolbar: ToolbarConfig = {
+  indentation: {
+    indent: {
+      title: 'Indent',
+      content: <ToolbarIndentIcon />,
+      isEnabled: isEnabled(isIndentationAllowed('indent')),
+      run: changeIndentation('indent'),
+    },
+    unindent: {
+      title: 'Unindent',
+      content: <ToolbarUnindentIcon />,
+      isEnabled: isEnabled(isIndentationAllowed('unindent')),
+      run: changeIndentation('unindent'),
+    },
+  },
+  style: {
+    bold: {
+      title: 'Toggle bold',
+      content: <ToolbarBoldIcon />,
+      isActive: markActive(schema.marks.bold),
+      isEnabled: isEnabled(toggleMark(schema.marks.bold)),
+      run: toggleMark(schema.marks.bold),
+    },
+    italic: {
+      title: 'Toggle italic',
+      content: <ToolbarItalicIcon />,
+      isActive: markActive(schema.marks.italic),
+      isEnabled: isEnabled(toggleMark(schema.marks.italic)),
+      run: toggleMark(schema.marks.italic),
+    },
+    underline: {
+      title: 'Toggle underline',
+      content: <ToolbarUnderlineIcon />,
+      isActive: markActive(schema.marks.underline),
+      isEnabled: isEnabled(toggleMark(schema.marks.underline)),
+      run: toggleMark(schema.marks.underline),
+    },
+  },
+  vertical: {
+    subscript: {
+      title: 'Toggle subscript',
+      content: <ToolbarSubscriptIcon />,
+      isActive: markActive(schema.marks.subscript),
+      isEnabled: isEnabled(toggleMark(schema.marks.subscript)),
+      run: toggleMark(schema.marks.subscript),
+    },
+    superscript: {
+      title: 'Toggle superscript',
+      content: <ToolbarSuperscriptIcon />,
+      isActive: markActive(schema.marks.superscript),
+      isEnabled: isEnabled(toggleMark(schema.marks.superscript)),
+      run: toggleMark(schema.marks.superscript),
+    },
+  },
+  list: {
+    bullet_list: {
+      title: 'Bulleted list',
+      content: <ToolbarUnorderedListIcon />,
+      isActive: blockActive(schema.nodes.list),
+      isEnabled: isEnabled(insertList(schema.nodes.list, 'bullet')),
+      run: insertList(schema.nodes.list, 'bullet'),
+      options: {
+        bullet: insertList(schema.nodes.list, 'bullet'),
+        simple: insertList(schema.nodes.list, 'simple'),
+      },
+    },
+    ordered_list: {
+      title: 'Ordered list',
+      content: <ToolbarOrderedListIcon />,
+      isActive: blockActive(schema.nodes.list),
+      isEnabled: isEnabled(insertList(schema.nodes.list, 'order')),
+      run: insertList(schema.nodes.list, 'order'),
+      options: {
+        order: insertList(schema.nodes.list, 'order'),
+        'alpha-upper': insertList(schema.nodes.list, 'alpha-upper'),
+        'alpha-lower': insertList(schema.nodes.list, 'alpha-lower'),
+        'roman-upper': insertList(schema.nodes.list, 'roman-upper'),
+        'roman-lower': insertList(schema.nodes.list, 'roman-lower'),
+      },
+    },
+  },
+  inline: {
+    comment: {
+      title: 'Insert comment',
+      content: <AddCommentIcon />,
+      isEnabled: isEnabled(canInsert(schema.nodes.highlight_marker)), // TODO: check both ends of selection
+      run: addInlineComment,
+    },
+    citation: {
+      title: 'Insert citation',
+      content: <ToolbarCitationIcon />,
+      isEnabled: isEnabled(canInsert(schema.nodes.citation)),
+      run: insertInlineCitation,
+    },
+  },
+  quote: {
+    blockquote_element: {
+      title: 'Insert blockquote',
+      content: <OutlineBlockQuoteIcon />,
+      isEnabled: isEnabled(canInsert(schema.nodes.blockquote_element)),
+      run: insertBlock(schema.nodes.blockquote_element),
+    },
+    pullquote_element: {
+      title: 'Insert pullquote',
+      content: <OutlinePullQuoteIcon />,
+      isEnabled: isEnabled(canInsert(schema.nodes.pullquote_element)),
+      run: insertBlock(schema.nodes.pullquote_element),
+    },
+  },
+  element: {
+    figure_element: {
+      title: 'Insert figure',
+      content: <ToolbarFigureIcon />,
+      isEnabled: isEnabled(canInsert(schema.nodes.figure_element)),
+      run: insertBlock(schema.nodes.figure_element),
+    },
+    image_element: {
+      title: 'Insert image',
+      content: <FileImageIcon width="19" height="16" />,
+      isEnabled: isEnabled(canInsert(schema.nodes.image_element)),
+      run: insertBlock(schema.nodes.image_element),
+    },
+    table_element: {
+      title: 'Insert table',
+      content: <ToolbarTableIcon />,
+      isEnabled: isEnabled(canInsert(schema.nodes.table_element)),
+      run: openInsertTableDialog,
+    },
+    box_element: {
+      title: 'Insert boxed text',
+      content: <ToolbarBoxedTextIcon />,
+      isEnabled: isEnabled(canInsert(schema.nodes.box_element)),
+      run: insertBoxElement,
+    },
+    equation_element: {
+      title: 'Insert equation',
+      content: <ToolbarEquationIcon />,
+      isEnabled: isEnabled(canInsert(schema.nodes.equation_element)),
+      run: insertBlock(schema.nodes.equation_element),
+    },
+  },
+  media: {
+    embed: {
+      title: 'Insert media',
+      content: <OutlineEmbedIcon />,
+      isEnabled: isEnabled(canInsert(schema.nodes.embed)),
+      run: insertEmbed,
+    },
+    link: {
+      title: 'Insert link',
+      content: <LinkIcon />,
+      isEnabled: isEnabled(canInsert(schema.nodes.link)),
+      run: insertLink,
+    },
+  },
+  special: {
+    special_characters: {
+      title: 'Insert special characters',
+      content: <ToolbarSpecialCharactersIcon />,
+      isEnabled: isEnabled(canInsert(schema.nodes.text)),
+      run: (state: EditorState, dispatch: Dispatch, view?: EditorView) => {
+        openInsertSpecialCharacterDialog(view)
+      },
+    },
+  },
+}

package/src/types/@citation-js/core.d.ts

@@ -0,0 +1,16 @@
+/*!
+ * © 2025 Atypon Systems LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+declare module '@citation-js/core'

package/src/types/@citation-js/index.d.ts

@@ -0,0 +1,16 @@
+/*!
+ * © 2025 Atypon Systems LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+declare module '@citation-js'

package/src/types/@citation-js/plugin-bibtex.d.ts

@@ -0,0 +1,16 @@
+/*!
+ * © 2025 Atypon Systems LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+declare module '@citation-js/plugin-bibtex'

package/src/types/@citation-js/plugin-csl.d.ts

@@ -0,0 +1,16 @@
+/*!
+ * © 2025 Atypon Systems LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+declare module '@citation-js/plugin-csl'

package/src/types/@citation-js/plugin-doi.d.ts

@@ -0,0 +1,16 @@
+/*!
+ * © 2025 Atypon Systems LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+declare module '@citation-js/plugin-doi'

package/src/types/@citation-js/plugin-enw.d.ts

@@ -0,0 +1,16 @@
+/*!
+ * © 2025 Atypon Systems LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+declare module '@citation-js/plugin-enw'

package/src/types/@citation-js/plugin-pubmed.d.ts

@@ -0,0 +1,16 @@
+/*!
+ * © 2025 Atypon Systems LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+declare module '@citation-js/plugin-pubmed'

package/src/types/@citation-js/plugin-ris.d.ts

@@ -0,0 +1,16 @@
+/*!
+ * © 2025 Atypon Systems LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+declare module '@citation-js/plugin-ris'

package/src/types/citeproc.d.ts

@@ -0,0 +1,124 @@
+/*!
+ * © 2019 Atypon Systems LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+// https://citeproc-js.readthedocs.io/en/latest/running.html#introduction
+// https://github.com/citation-style-language/schema
+// https://github.com/Zettlr/Zettlr/blob/dd2cbda72d9499edae6a1d95fb977794bde1ed4e/source/citeproc.d.ts
+
+declare module 'citeproc' {
+  interface Citation {
+    citationItems: Array<{ id: string; prefix?: string; suffix?: string }>
+    properties?: {
+      mode?: string
+      noteIndex?: number
+      infix?: string
+    }
+  }
+
+  interface SystemOptions {
+    retrieveLocale: (id: string) => string | Document | Locale
+    retrieveItem: (id: string) => CSL.Data
+  }
+
+  interface BibliographyMetadata {
+    maxoffset: number
+    entryspacing: number
+    linespacing: number
+    hangingindent: boolean
+    ['second-field-align']: boolean
+    bibstart: string
+    bibend: string
+    bibliography_errors: string[]
+    entry_ids: string[]
+  }
+
+  type Bibliography = string[]
+
+  export class Engine {
+    constructor(
+      sys: SystemOptions,
+      style: string | Style,
+      lang?: string,
+      forceLang?: boolean
+    )
+
+    public updateItems(idList: Array<string | number>): void
+
+    public updateUncitedItems(idList: Array<string | number>): void
+
+    /**
+     * Rebuilds the processor from scratch, based on a cached list of
+     * citation objects. In a dynamic application, once the internal state of
+     * processor is established, citations should edited with individual
+     * invocations of ``processCitationCluster()``.
+     *
+     * Returns an array of ``[citationID,noteIndex,string]`` triples in
+     * document order, where ``string`` is the fully disambiguated citation
+     * cluster for the given document position.
+     *
+     * @param citations An array of citation input objects in document order. Each
+     * citation object must be in the following form, with correct
+     * values for ``citationID``, for each ``id``, and for ``noteIndex``.
+     * Set ``noteIndex`` to ``0`` for in-text citations.
+     * Default is to return an empty document update array.
+     * ```json
+     * {
+     *   "citationID": "CITATION-1",
+     *   "citationItems": [
+     *     {
+     *         "id": "ITEM-1"
+     *     }
+     *   ],
+     *   "properties": {
+     *     "noteIndex": 1
+     *   }
+     * }
+     * ```
+     * @param mode One of ``text``, ``html`` or ``rtf``. The default is ``html``.
+     After invocation, the processor is returned to its previous output mode setting.
+     * @param uncitedItemIDs An array of item IDs for uncited items to be included in
+     the document bibliography, if any.
+     */
+    public rebuildProcessorState(
+      citations: Citation[],
+      mode?: 'text' | 'html' | 'rtf',
+      uncitedItemIDs?: string[]
+    ): Array<[string, number, string]> // id, noteIndex, output
+
+    public makeBibliography(): [BibliographyMetadata, Bibliography]
+  }
+
+  export function getLocaleNames(
+    style: string | Record<string, unknown>,
+    preferredLocale: string
+  ): string[]
+
+  type Locale = Record<string, unknown>
+
+  type Node = {
+    name: string
+    attrs: Record<string, unknown>
+    children: Node[]
+  }
+
+  export class XmlJSON {
+    constructor(dataObj: string | Record<string, unknown>)
+    dataObj: Record<string, unknown>
+    getNodesByName: (data: unknown, name: string) => Node[]
+  }
+
+  export function setupXml(style: string | Record<string, unknown>): XmlJSON
+}

package/src/types/css.d.ts

@@ -0,0 +1,16 @@
+/*!
+ * © 2020 Atypon Systems LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+declare module '*.css'

package/src/types/json.d.ts

@@ -0,0 +1,17 @@
+/*!
+ * © 2019 Atypon Systems LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+declare module '*.json'

package/src/types/prosemirror-dev-tools.d.ts

@@ -0,0 +1,16 @@
+/*!
+ * © 2020 Atypon Systems LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+declare module 'prosemirror-dev-tools'

package/src/types/prosemirror-dropcursor.d.ts

@@ -0,0 +1,16 @@
+/*!
+ * © 2020 Atypon Systems LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+declare module 'prosemirror-dropcursor'

package/src/types/styled-components.d.ts

@@ -0,0 +1,23 @@
+/*!
+ * © 2020 Atypon Systems LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import 'styled-components'
+
+import { Theme } from '@manuscripts/style-guide'
+
+declare module 'styled-components' {
+  export type DefaultTheme = Theme
+}

package/src/types.ts

@@ -0,0 +1,49 @@
+/*!
+ * © 2019 Atypon Systems LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { TrackedAttrs } from '@manuscripts/track-changes-plugin'
+import {
+  ManuscriptEditorState,
+  ManuscriptEditorView,
+  ManuscriptNode,
+  ManuscriptNodeView,
+  ManuscriptTransaction,
+} from '@manuscripts/transform'
+import { Decoration } from 'prosemirror-view'
+
+export type EditorAction = (
+  state: ManuscriptEditorState,
+  dispatch?: (tr: ManuscriptTransaction) => void,
+  view?: ManuscriptEditorView
+) => boolean
+
+export type NodeViewCreator<T extends ManuscriptNodeView> = (
+  node: ManuscriptNode,
+  view: ManuscriptEditorView,
+  getPos: () => number | undefined,
+  decorations: readonly Decoration[]
+) => T
+
+export type TrackableAttributes<T extends ManuscriptNode> = T['attrs'] & {
+  dataTracked?: TrackedAttrs[]
+}
+
+export type Trackable<T extends ManuscriptNode> = Omit<T, 'attrs'> & {
+  attrs: TrackableAttributes<T>
+}
+
+export type PartialExcept<T, K extends keyof T> = Partial<Omit<T, K>> &
+  Pick<T, K>