tldraw zero - package shuffle (#1710)
This PR moves code between our packages so that:
- @tldraw/editor is a “core” library with the engine and canvas but no
shapes, tools, or other things
- @tldraw/tldraw contains everything particular to the experience we’ve
built for tldraw
At first look, this might seem like a step away from customization and
configuration, however I believe it greatly increases the configuration
potential of the @tldraw/editor while also providing a more accurate
reflection of what configuration options actually exist for
@tldraw/tldraw.
## Library changes
@tldraw/editor re-exports its dependencies and @tldraw/tldraw re-exports
@tldraw/editor.
- users of @tldraw/editor WITHOUT @tldraw/tldraw should almost always
only import things from @tldraw/editor.
- users of @tldraw/tldraw should almost always only import things from
@tldraw/tldraw.
- @tldraw/polyfills is merged into @tldraw/editor
- @tldraw/indices is merged into @tldraw/editor
- @tldraw/primitives is merged mostly into @tldraw/editor, partially
into @tldraw/tldraw
- @tldraw/file-format is merged into @tldraw/tldraw
- @tldraw/ui is merged into @tldraw/tldraw
Many (many) utils and other code is moved from the editor to tldraw. For
example, embeds now are entirely an feature of @tldraw/tldraw. The only
big chunk of code left in core is related to arrow handling.
## API Changes
The editor can now be used without tldraw's assets. We load them in
@tldraw/tldraw instead, so feel free to use whatever fonts or images or
whatever that you like with the editor.
All tools and shapes (except for the `Group` shape) are moved to
@tldraw/tldraw. This includes the `select` tool.
You should use the editor with at least one tool, however, so you now
also need to send in an `initialState` prop to the Editor /
<TldrawEditor> component indicating which state the editor should begin
in.
The `components` prop now also accepts `SelectionForeground`.
The complex selection component that we use for tldraw is moved to
@tldraw/tldraw. The default component is quite basic but can easily be
replaced via the `components` prop. We pass down our tldraw-flavored
SelectionFg via `components`.
Likewise with the `Scribble` component: the `DefaultScribble` no longer
uses our freehand tech and is a simple path instead. We pass down the
tldraw-flavored scribble via `components`.
The `ExternalContentManager` (`Editor.externalContentManager`) is
removed and replaced with a mapping of types to handlers.
- Register new content handlers with
`Editor.registerExternalContentHandler`.
- Register new asset creation handlers (for files and URLs) with
`Editor.registerExternalAssetHandler`
### Change Type
- [x] `major` — Breaking change
### Test Plan
- [x] Unit Tests
- [x] End to end tests
### Release Notes
- [@tldraw/editor] lots, wip
- [@tldraw/ui] gone, merged to tldraw/tldraw
- [@tldraw/polyfills] gone, merged to tldraw/editor
- [@tldraw/primitives] gone, merged to tldraw/editor / tldraw/tldraw
- [@tldraw/indices] gone, merged to tldraw/editor
- [@tldraw/file-format] gone, merged to tldraw/tldraw
---------
Co-authored-by: alex <alex@dytry.ch>
2023-07-17 21:22:34 +00:00
|
|
|
import { parseAndLoadDocument, useDefaultHelpers, useEditor } from '@tldraw/tldraw'
|
2023-04-25 11:01:25 +00:00
|
|
|
import React from 'react'
|
|
|
|
import { vscode } from './utils/vscode'
|
|
|
|
|
|
|
|
export function FileOpen({
|
|
|
|
fileContents,
|
|
|
|
forceDarkMode,
|
|
|
|
}: {
|
|
|
|
fileContents: string
|
|
|
|
forceDarkMode: boolean
|
|
|
|
}) {
|
2023-06-02 15:21:45 +00:00
|
|
|
const editor = useEditor()
|
2023-04-25 11:01:25 +00:00
|
|
|
const { msg, addToast, clearToasts } = useDefaultHelpers()
|
|
|
|
const [isFileLoaded, setIsFileLoaded] = React.useState(false)
|
|
|
|
|
|
|
|
React.useEffect(() => {
|
|
|
|
if (isFileLoaded) return
|
|
|
|
function onV1FileLoad() {
|
|
|
|
vscode.postMessage({
|
|
|
|
type: 'vscode:v1-file-opened',
|
|
|
|
data: {
|
|
|
|
description: msg('vscode.file-open.desc'),
|
|
|
|
backup: msg('vscode.file-open.backup'),
|
|
|
|
backupSaved: msg('vscode.file-open.backup-saved'),
|
|
|
|
backupFailed: msg('vscode.file-open.backup-failed'),
|
|
|
|
dontAskAgain: msg('vscode.file-open.dont-show-again'),
|
|
|
|
open: msg('vscode.file-open.open'),
|
|
|
|
},
|
|
|
|
})
|
|
|
|
}
|
|
|
|
|
|
|
|
async function loadFile() {
|
2023-06-02 15:21:45 +00:00
|
|
|
await parseAndLoadDocument(editor, fileContents, msg, addToast, onV1FileLoad, forceDarkMode)
|
2023-04-25 11:01:25 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
loadFile()
|
|
|
|
setIsFileLoaded(true)
|
|
|
|
return () => {
|
|
|
|
clearToasts()
|
|
|
|
}
|
2023-06-02 15:21:45 +00:00
|
|
|
}, [fileContents, editor, addToast, msg, clearToasts, forceDarkMode, isFileLoaded])
|
2023-04-25 11:01:25 +00:00
|
|
|
|
|
|
|
return null
|
|
|
|
}
|