@adecore/editor-react 0.17.0-beta.2 → 0.17.0

package/dist/HoverCard.d.ts

@@ -1,7 +1,13 @@
+import { type Location } from '@adecore/lsp';
 import type { EditorPosition } from '@adecore/editor';
 import type { EditorLanguage } from './editor-language.ts';
 import { type Problem } from './diagnostics-model.ts';
 import type { HoverInfo } from './popups.ts';
+export declare function DefinitionPlace({ definition, uri, folder }: {
+    definition: Location;
+    uri: string;
+    folder: string;
+}): import("react").JSX.Element | null;
 export declare function HoverCard({ language, problems, info, anchor, position }: {
     language: EditorLanguage;
     problems: readonly Problem[];

package/dist/HoverCard.js

@@ -9,6 +9,22 @@ import { codeLabelOf, severityOf } from './diagnostics-model.js';
 import { SymbolSections } from './HoverSections.js';
 const SEVERITY_ICONS = { error: CircleX, warning: TriangleAlert, info: Info, hint: Info };
 const SEVERITY_COLORS = { error: 'text-status-error', warning: 'text-status-needs-you', info: 'text-status-running', hint: 'text-text-muted' };
+/*
+ * Where a definition is: only its line in the file of the card, else the file and the line, with a long name cut
+ * short before the line. A definition outside the project folder, such as the stubs of a standard library, has none.
+ */
+export function DefinitionPlace({ definition, uri, folder }) {
+    const { t } = useTranslation('editor');
+    const path = fileUriToPath(definition.uri);
+    const line = formatNumber(definition.range.start.line + 1);
+    if (path === null || (folder !== '' && !path.startsWith(`${folder}/`))) {
+        return null;
+    }
+    if (definition.uri === uri) {
+        return _jsx("span", { className: "text-text-faint", children: t('language.hover.line', { line }) });
+    }
+    return (_jsxs("span", { className: "flex min-w-0 font-mono text-text-faint", children: [_jsx("span", { className: "truncate", children: basenameOf(path) }), _jsxs("span", { className: "shrink-0", children: [":", line] })] }));
+}
 function ProblemSection({ problem, language }) {
     const { t } = useTranslation('editor');
     const { diagnostic } = problem;
@@ -27,12 +43,11 @@ function ProblemSection({ problem, language }) {
 }
 export function HoverCard({ language, problems, info, anchor, position }) {
     const { t } = useTranslation('editor');
-    const place = info?.definition === null || info === null ? null : fileUriToPath(info.definition.uri);
     return (_jsxs("div", { className: "flex w-max min-w-[280px] max-w-[min(520px,calc(100vw-16px))] flex-col divide-y divide-border", children: [info !== null && (_jsxs(_Fragment, { children: [_jsx(SymbolSections, { text: info.text, onName: (name, declared) => {
                             language.hover.hide();
                             void language.navigation.goToName(name, anchor, name === (declared ?? info.word) ? info.definition : null);
-                        } }), _jsxs("div", { className: "flex items-center gap-3 px-3 py-1.5 text-xs", children: [info.definition !== null && (_jsx("button", { type: "button", className: "text-accent hover:underline", onClick: () => language.goTo(info.definition), children: t('language.hover.definition') })), info.references !== null && info.references > 0 && (_jsx("button", { type: "button", className: "text-accent hover:underline", onClick: () => {
-                                    language.hover.hide();
-                                    void language.peek.open(position);
-                                }, children: t('language.hover.references', { count: info.references, formatted: formatNumber(info.references) }) })), place !== null && info.definition !== null && (_jsxs("span", { className: "ml-auto font-mono text-text-faint", children: [basenameOf(place), ":", formatNumber(info.definition.range.start.line + 1)] }))] })] })), problems.map((problem, index) => (_jsx(ProblemSection, { problem: problem, language: language }, index)))] }));
+                        } }), _jsxs("div", { className: "flex flex-col gap-0.5 px-3 py-1.5 text-xs", children: [_jsxs("div", { className: "flex items-center gap-3 whitespace-nowrap", children: [info.definition !== null && (_jsx("button", { type: "button", className: "text-accent hover:underline", onClick: () => language.goTo(info.definition), children: t('language.hover.definition') })), info.references !== null && info.references > 0 && (_jsx("button", { type: "button", className: "text-accent hover:underline", onClick: () => {
+                                            language.hover.hide();
+                                            void language.peek.open(position);
+                                        }, children: t('language.hover.references', { count: info.references, formatted: formatNumber(info.references) }) }))] }), info.definition !== null && _jsx(DefinitionPlace, { definition: info.definition, uri: language.uri, folder: language.project.folder })] })] })), problems.map((problem, index) => (_jsx(ProblemSection, { problem: problem, language: language }, index)))] }));
 }

package/dist/code-actions-model.js

@@ -74,7 +74,7 @@ const PREVIEW_LINES = 3;
 function linesOf(text) {
     return text.split(/\r\n|\r|\n/);
 }
-/* Null when the edit changes nothing, or creates or deletes a file, which a preview of lines cannot show. */
+/* Null when the edit changes nothing, or deletes a file, which a preview of lines cannot show. A file it creates counts as another file. */
 export function previewOf(text, edit, uri) {
     const entries = entriesOf(edit);
     if (entries === null) {

package/dist/folding.d.ts

@@ -1,11 +1,9 @@
-import type { EditorFoldRange, EditorFoldSymbol } from '@adecore/editor';
+import type { EditorFoldRangeHint, EditorFoldSymbol } from '@adecore/editor';
 import type { DocumentSymbolResult, FoldingRange } from '@adecore/lsp';
 import type { EditorLanguage } from './editor-language.ts';
 import { type Timers } from './timers.ts';
 export declare function foldSymbolsOf(result: DocumentSymbolResult): EditorFoldSymbol[];
-export declare function foldRangesOf(ranges: readonly FoldingRange[] | null): (EditorFoldRange & {
-    kind?: string;
-})[];
+export declare function foldRangesOf(ranges: readonly FoldingRange[] | null): EditorFoldRangeHint[];
 export declare class FoldingFeature {
     private symbols;
     private ranges;

package/dist/folding.js

@@ -43,11 +43,17 @@ export function foldSymbolsOf(result) {
     }
     return found;
 }
-/* The ranges a server folds that span more than one line. */
+/* The ranges a server folds that span more than one line, with where a range starts and ends within its lines when it says. */
 export function foldRangesOf(ranges) {
     return (ranges ?? [])
         .filter((range) => range.endLine > range.startLine)
-        .map((range) => ({ startLine: range.startLine, endLine: range.endLine, ...(range.kind === undefined ? {} : { kind: range.kind }) }));
+        .map((range) => ({
+        startLine: range.startLine,
+        endLine: range.endLine,
+        ...(range.kind === undefined ? {} : { kind: range.kind }),
+        ...(range.startCharacter === undefined ? {} : { startCharacter: range.startCharacter }),
+        ...(range.endCharacter === undefined ? {} : { endCharacter: range.endCharacter })
+    }));
 }
 /*
  * What the servers know about folding: the bodies of the symbols (read from the symbols the document already

package/dist/language-ids.js

@@ -15,7 +15,8 @@ const LSP_IDS = {
     yaml: 'yaml',
     python: 'python',
     shellscript: 'shellscript',
-    docker: 'dockerfile'
+    docker: 'dockerfile',
+    twig: 'twig'
 };
 /* The LSP language id of a file, or null when no language server here knows its language. */
 export function lspLanguageIdOf(language) {
@@ -41,7 +42,8 @@ const PATH_IDS = {
     css: 'css',
     scss: 'scss',
     html: 'html',
-    md: 'markdown'
+    md: 'markdown',
+    twig: 'twig'
 };
 /* The highlighter id for the code of a file we only know by its path, such as a place another file refers to. */
 export function shikiLanguageOfPath(path) {

package/dist/locales/en.json

@@ -6,6 +6,7 @@
             "definition": "Go to definition",
             "references_one": "{{formatted}} reference",
             "references_other": "{{formatted}} references",
+            "line": "Line {{line}}",
             "none": "No information for this position"
         },
         "edit": {

package/dist/locales/nl.json

@@ -6,6 +6,7 @@
             "definition": "Ga naar definitie",
             "references_one": "{{formatted}} referentie",
             "references_other": "{{formatted}} referenties",
+            "line": "Regel {{line}}",
             "none": "Geen informatie voor deze plek"
         },
         "edit": {

package/dist/workspace-edit.d.ts

@@ -11,6 +11,7 @@ export interface ProjectFiles {
     stage(files: readonly StagedFile[]): void;
     save(files: readonly StagedFile[]): Promise<string | null>;
     rename(from: string, to: string): Promise<string | null>;
+    create?(path: string, text: string): Promise<string | null>;
 }
 export interface WorkspaceEditHost {
     editorOf(uri: string): Editor | undefined;

package/dist/workspace-edit.js

@@ -2,13 +2,16 @@ import { applyTextEdits, fileUriToPath } from '@adecore/lsp';
 function refused(failureReason) {
     return { applied: false, failureReason };
 }
-/* The steps of an edit; null when it creates or deletes a file, which an edit is not applied with. */
+/* The steps of an edit; null when it deletes a file, which an edit is not applied with. */
 function stepsOf(edit) {
     const steps = [];
     for (const change of edit.documentChanges ?? []) {
         if ('textDocument' in change) {
             steps.push({ kind: 'edits', uri: change.textDocument.uri, edits: change.edits });
         }
+        else if (change.kind === 'create') {
+            steps.push({ kind: 'create', file: change });
+        }
         else if (change.kind === 'rename') {
             steps.push({ kind: 'rename', oldUri: change.oldUri, newUri: change.newUri });
         }
@@ -23,7 +26,7 @@ function stepsOf(edit) {
     }
     return steps;
 }
-/* The text edits of an edit per document, as the entries a document has in it; null when it creates or deletes a file. */
+/* The text edits of an edit per document, as the entries a document has in it; null when it deletes a file. */
 export function entriesOf(edit) {
     const steps = stepsOf(edit);
     if (steps === null) {
@@ -48,13 +51,14 @@ function contentChangeOf(edit) {
  * Applies an LSP workspace edit on the client, step by step in the order it says. A file an editor holds takes
  * its edits as one undo step. Any other file gets its new text as an unsaved draft that a person saves, and
  * nothing is written to disk on a server's word alone, unless the edit also moves a file: the edits and the
- * move are then one change, so every file is saved through the machine and the move is made there. The
- * edit is checked against every text first, so one that does not fit changes nothing.
+ * move are then one change, so every file is saved through the machine and the move is made there. A file
+ * the edit creates is made through the machine with the text the edit writes into it. The edit is checked
+ * against every text first, so one that does not fit changes nothing.
  */
 export async function applyWorkspaceEdit(edit, host) {
     const steps = stepsOf(edit);
     if (steps === null) {
-        return refused('Creating and deleting files is not supported yet');
+        return refused('Deleting files is not supported yet');
     }
     const planned = await plan(steps, host);
     if (typeof planned === 'string') {
@@ -63,8 +67,8 @@ export async function applyWorkspaceEdit(edit, host) {
     const moving = planned.some((item) => item.kind === 'rename');
     const staged = [];
     for (const item of planned) {
-        if (item.kind === 'rename') {
-            const reason = await host.files.rename(item.oldPath, item.newPath);
+        if (item.kind === 'rename' || item.kind === 'create') {
+            const reason = item.kind === 'rename' ? await host.files.rename(item.oldPath, item.newPath) : await host.files.create(item.path, item.text);
             if (reason !== null) {
                 return refused(reason);
             }
@@ -105,8 +109,21 @@ async function plan(steps, host) {
     const texts = new Map();
     // A file that has moved is read where it still stands: nothing moves until the plan is made.
     const origins = new Map();
+    // A file that is made is written once, with what every step leaves in it.
+    const creates = new Map();
     const planned = [];
     for (const step of steps) {
+        if (step.kind === 'create') {
+            const made = await planCreate(step.file, host, texts);
+            if (typeof made === 'string') {
+                return made;
+            }
+            if (made !== null) {
+                creates.set(step.file.uri, made);
+                planned.push(made);
+            }
+            continue;
+        }
         if (step.kind === 'rename') {
             const oldPath = fileUriToPath(step.oldUri);
             const newPath = fileUriToPath(step.newUri);
@@ -118,6 +135,16 @@ async function plan(steps, host) {
             continue;
         }
         const source = origins.get(step.uri) ?? step.uri;
+        const created = creates.get(source);
+        if (created !== undefined) {
+            try {
+                created.text = applyTextEdits(created.text, step.edits);
+            }
+            catch (error) {
+                return error instanceof Error ? error.message : String(error);
+            }
+            continue;
+        }
         if (!texts.has(source)) {
             const editor = host.editorOf(source);
             if (editor) {
@@ -145,3 +172,15 @@ async function plan(steps, host) {
     }
     return planned;
 }
+/* A file that is not there yet, or null when it is and the create says to leave it. Making one over a file that is there is not supported. */
+async function planCreate(file, host, texts) {
+    const path = fileUriToPath(file.uri);
+    if (path === null || host.files?.create === undefined) {
+        return `Creating ${file.uri} is not supported here`;
+    }
+    const there = texts.has(file.uri) || host.editorOf(file.uri) !== undefined || (await host.files.read(path)) !== null;
+    if (!there) {
+        return { kind: 'create', path, text: '' };
+    }
+    return file.options?.ignoreIfExists === true && file.options.overwrite !== true ? null : `${path} already exists`;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adecore/editor-react",
-  "version": "0.17.0-beta.2",
+  "version": "0.17.0",
   "type": "module",
   "description": "Language-enabled editors, feature coordination and React popups over injected language services.",
   "license": "FSL-1.1-MIT",
@@ -57,9 +57,9 @@
     "test": "bun test --conditions=source"
   },
   "dependencies": {
-    "@adecore/editor": "0.17.0-beta.2",
-    "@adecore/lsp": "0.17.0-beta.2",
-    "@adecore/merge": "0.17.0-beta.2",
+    "@adecore/editor": "0.17.0",
+    "@adecore/lsp": "0.17.0",
+    "@adecore/merge": "0.17.0",
     "zustand": "^5.0.15",
     "lucide-react": "^1.47.0",
     "react-markdown": "^10.1.0",
@@ -67,7 +67,7 @@
     "remark-breaks": "^4.0.0"
   },
   "peerDependencies": {
-    "@adecore/ui": "^0.17.0-beta.2",
+    "@adecore/ui": "^0.17.0",
     "react": "^19.3.0",
     "react-dom": "^19.3.0",
     "i18next": "^26.4.2",

package/src/HoverCard.tsx

@@ -1,6 +1,6 @@
 import { useTranslation } from 'react-i18next';
 import { CircleX, Info, TriangleAlert } from 'lucide-react';
-import { fileUriToPath } from '@adecore/lsp';
+import { fileUriToPath, type Location } from '@adecore/lsp';
 import { Button, Icon, Tooltip } from '@adecore/ui';
 import { formatNumber } from '@adecore/ui/format';
 import type { EditorPosition } from '@adecore/editor';
@@ -13,6 +13,28 @@ import { SymbolSections } from './HoverSections.tsx';
 const SEVERITY_ICONS = { error: CircleX, warning: TriangleAlert, info: Info, hint: Info } as const;
 const SEVERITY_COLORS = { error: 'text-status-error', warning: 'text-status-needs-you', info: 'text-status-running', hint: 'text-text-muted' } as const;
 
+/*
+ * Where a definition is: only its line in the file of the card, else the file and the line, with a long name cut
+ * short before the line. A definition outside the project folder, such as the stubs of a standard library, has none.
+ */
+export function DefinitionPlace({ definition, uri, folder }: { definition: Location; uri: string; folder: string }) {
+    const { t } = useTranslation('editor');
+    const path = fileUriToPath(definition.uri);
+    const line = formatNumber(definition.range.start.line + 1);
+    if (path === null || (folder !== '' && !path.startsWith(`${folder}/`))) {
+        return null;
+    }
+    if (definition.uri === uri) {
+        return <span className="text-text-faint">{t('language.hover.line', { line })}</span>;
+    }
+    return (
+        <span className="flex min-w-0 font-mono text-text-faint">
+            <span className="truncate">{basenameOf(path)}</span>
+            <span className="shrink-0">:{line}</span>
+        </span>
+    );
+}
+
 function ProblemSection({ problem, language }: { problem: Problem; language: EditorLanguage }) {
     const { t } = useTranslation('editor');
     const { diagnostic } = problem;
@@ -75,7 +97,6 @@ export function HoverCard({
     position: EditorPosition;
 }) {
     const { t } = useTranslation('editor');
-    const place = info?.definition === null || info === null ? null : fileUriToPath(info.definition.uri);
     return (
         <div className="flex w-max min-w-[280px] max-w-[min(520px,calc(100vw-16px))] flex-col divide-y divide-border">
             {info !== null && (
@@ -87,29 +108,27 @@ export function HoverCard({
                             void language.navigation.goToName(name, anchor, name === (declared ?? info.word) ? info.definition : null);
                         }}
                     />
-                    <div className="flex items-center gap-3 px-3 py-1.5 text-xs">
-                        {info.definition !== null && (
-                            <button type="button" className="text-accent hover:underline" onClick={() => language.goTo(info.definition!)}>
-                                {t('language.hover.definition')}
-                            </button>
-                        )}
-                        {info.references !== null && info.references > 0 && (
-                            <button
-                                type="button"
-                                className="text-accent hover:underline"
-                                onClick={() => {
-                                    language.hover.hide();
-                                    void language.peek.open(position);
-                                }}
-                            >
-                                {t('language.hover.references', { count: info.references, formatted: formatNumber(info.references) })}
-                            </button>
-                        )}
-                        {place !== null && info.definition !== null && (
-                            <span className="ml-auto font-mono text-text-faint">
-                                {basenameOf(place)}:{formatNumber(info.definition.range.start.line + 1)}
-                            </span>
-                        )}
+                    <div className="flex flex-col gap-0.5 px-3 py-1.5 text-xs">
+                        <div className="flex items-center gap-3 whitespace-nowrap">
+                            {info.definition !== null && (
+                                <button type="button" className="text-accent hover:underline" onClick={() => language.goTo(info.definition!)}>
+                                    {t('language.hover.definition')}
+                                </button>
+                            )}
+                            {info.references !== null && info.references > 0 && (
+                                <button
+                                    type="button"
+                                    className="text-accent hover:underline"
+                                    onClick={() => {
+                                        language.hover.hide();
+                                        void language.peek.open(position);
+                                    }}
+                                >
+                                    {t('language.hover.references', { count: info.references, formatted: formatNumber(info.references) })}
+                                </button>
+                            )}
+                        </div>
+                        {info.definition !== null && <DefinitionPlace definition={info.definition} uri={language.uri} folder={language.project.folder} />}
                     </div>
                 </>
             )}

package/src/code-actions-model.ts

@@ -107,7 +107,7 @@ function linesOf(text: string): string[] {
     return text.split(/\r\n|\r|\n/);
 }
 
-/* Null when the edit changes nothing, or creates or deletes a file, which a preview of lines cannot show. */
+/* Null when the edit changes nothing, or deletes a file, which a preview of lines cannot show. A file it creates counts as another file. */
 export function previewOf(text: string, edit: WorkspaceEdit, uri: string): EditPreview | null {
     const entries = entriesOf(edit);
     if (entries === null) {

package/src/folding.ts

@@ -1,4 +1,4 @@
-import type { EditorFoldHints, EditorFoldRange, EditorFoldSymbol } from '@adecore/editor';
+import type { EditorFoldHints, EditorFoldRangeHint, EditorFoldSymbol } from '@adecore/editor';
 import type { DocumentSymbol, DocumentSymbolResult, FoldingRange, SymbolInformation } from '@adecore/lsp';
 import type { EditorLanguage } from './editor-language.ts';
 import { Refresher } from './refresher.ts';
@@ -51,11 +51,17 @@ export function foldSymbolsOf(result: DocumentSymbolResult): EditorFoldSymbol[]
     return found;
 }
 
-/* The ranges a server folds that span more than one line. */
-export function foldRangesOf(ranges: readonly FoldingRange[] | null): (EditorFoldRange & { kind?: string })[] {
+/* The ranges a server folds that span more than one line, with where a range starts and ends within its lines when it says. */
+export function foldRangesOf(ranges: readonly FoldingRange[] | null): EditorFoldRangeHint[] {
     return (ranges ?? [])
         .filter((range) => range.endLine > range.startLine)
-        .map((range) => ({ startLine: range.startLine, endLine: range.endLine, ...(range.kind === undefined ? {} : { kind: range.kind }) }));
+        .map((range) => ({
+            startLine: range.startLine,
+            endLine: range.endLine,
+            ...(range.kind === undefined ? {} : { kind: range.kind }),
+            ...(range.startCharacter === undefined ? {} : { startCharacter: range.startCharacter }),
+            ...(range.endCharacter === undefined ? {} : { endCharacter: range.endCharacter })
+        }));
 }
 
 /*
@@ -65,7 +71,7 @@ export function foldRangesOf(ranges: readonly FoldingRange[] | null): (EditorFol
  */
 export class FoldingFeature {
     private symbols: EditorFoldSymbol[] = [];
-    private ranges: (EditorFoldRange & { kind?: string })[] = [];
+    private ranges: EditorFoldRangeHint[] = [];
     private readonly refresher: Refresher;
     private readonly language: EditorLanguage;
 

package/src/language-ids.ts

@@ -15,7 +15,8 @@ const LSP_IDS: Record<string, string> = {
     yaml: 'yaml',
     python: 'python',
     shellscript: 'shellscript',
-    docker: 'dockerfile'
+    docker: 'dockerfile',
+    twig: 'twig'
 };
 
 /* The LSP language id of a file, or null when no language server here knows its language. */
@@ -45,7 +46,8 @@ const PATH_IDS: Record<string, string> = {
     css: 'css',
     scss: 'scss',
     html: 'html',
-    md: 'markdown'
+    md: 'markdown',
+    twig: 'twig'
 };
 
 /* The highlighter id for the code of a file we only know by its path, such as a place another file refers to. */

package/src/locales/en.json

@@ -6,6 +6,7 @@
             "definition": "Go to definition",
             "references_one": "{{formatted}} reference",
             "references_other": "{{formatted}} references",
+            "line": "Line {{line}}",
             "none": "No information for this position"
         },
         "edit": {

package/src/locales/nl.json

@@ -6,6 +6,7 @@
             "definition": "Ga naar definitie",
             "references_one": "{{formatted}} referentie",
             "references_other": "{{formatted}} referenties",
+            "line": "Regel {{line}}",
             "none": "Geen informatie voor deze plek"
         },
         "edit": {

package/src/workspace-edit.ts

@@ -1,5 +1,13 @@
 import type { Editor, EditorContentChange } from '@adecore/editor';
-import { applyTextEdits, fileUriToPath, type ApplyWorkspaceEditResult, type RenameFile, type TextEdit, type WorkspaceEdit } from '@adecore/lsp';
+import {
+    applyTextEdits,
+    fileUriToPath,
+    type ApplyWorkspaceEditResult,
+    type CreateFile,
+    type RenameFile,
+    type TextEdit,
+    type WorkspaceEdit
+} from '@adecore/lsp';
 import type { DiskText } from './host-types.ts';
 
 /* A file that changed without an editor of this project holding it: its new text waits as an unsaved draft. */
@@ -18,6 +26,8 @@ export interface ProjectFiles {
     save(files: readonly StagedFile[]): Promise<string | null>;
     /* Moves a file or folder on the machine, with what is open on it, and tells the servers it moved; the reason it could not, or null. */
     rename(from: string, to: string): Promise<string | null>;
+    /* Makes a file that is not there with its text, through the machine; the reason it could not, or null. Without it no edit creates a file. */
+    create?(path: string, text: string): Promise<string | null>;
 }
 
 export interface WorkspaceEditHost {
@@ -30,17 +40,20 @@ function refused(failureReason: string): ApplyWorkspaceEditResult {
     return { applied: false, failureReason };
 }
 
-/* One thing an edit does, in the order it says: text edits of a document, or a file that moves. */
+/* One thing an edit does, in the order it says: text edits of a document, a file that is made, or a file that moves. */
 type Step =
     | { readonly kind: 'edits'; readonly uri: string; readonly edits: TextEdit[] }
+    | { readonly kind: 'create'; readonly file: CreateFile }
     | { readonly kind: 'rename'; readonly oldUri: string; readonly newUri: string };
 
-/* The steps of an edit; null when it creates or deletes a file, which an edit is not applied with. */
+/* The steps of an edit; null when it deletes a file, which an edit is not applied with. */
 function stepsOf(edit: WorkspaceEdit): Step[] | null {
     const steps: Step[] = [];
     for (const change of edit.documentChanges ?? []) {
         if ('textDocument' in change) {
             steps.push({ kind: 'edits', uri: change.textDocument.uri, edits: change.edits });
+        } else if (change.kind === 'create') {
+            steps.push({ kind: 'create', file: change });
         } else if (change.kind === 'rename') {
             steps.push({ kind: 'rename', oldUri: change.oldUri, newUri: change.newUri });
         } else {
@@ -55,7 +68,7 @@ function stepsOf(edit: WorkspaceEdit): Step[] | null {
     return steps;
 }
 
-/* The text edits of an edit per document, as the entries a document has in it; null when it creates or deletes a file. */
+/* The text edits of an edit per document, as the entries a document has in it; null when it deletes a file. */
 export function entriesOf(edit: WorkspaceEdit): Map<string, TextEdit[][]> | null {
     const steps = stepsOf(edit);
     if (steps === null) {
@@ -90,19 +103,27 @@ interface PlannedEdits {
     readonly disk: DiskText | null;
 }
 
-type Planned = PlannedEdits | { readonly kind: 'rename'; readonly oldPath: string; readonly newPath: string };
+/* A file to make, with the text every step of the edit leaves in it. */
+interface PlannedCreate {
+    readonly kind: 'create';
+    readonly path: string;
+    text: string;
+}
+
+type Planned = PlannedEdits | PlannedCreate | { readonly kind: 'rename'; readonly oldPath: string; readonly newPath: string };
 
 /*
  * Applies an LSP workspace edit on the client, step by step in the order it says. A file an editor holds takes
  * its edits as one undo step. Any other file gets its new text as an unsaved draft that a person saves, and
  * nothing is written to disk on a server's word alone, unless the edit also moves a file: the edits and the
- * move are then one change, so every file is saved through the machine and the move is made there. The
- * edit is checked against every text first, so one that does not fit changes nothing.
+ * move are then one change, so every file is saved through the machine and the move is made there. A file
+ * the edit creates is made through the machine with the text the edit writes into it. The edit is checked
+ * against every text first, so one that does not fit changes nothing.
  */
 export async function applyWorkspaceEdit(edit: WorkspaceEdit, host: WorkspaceEditHost): Promise<ApplyWorkspaceEditResult> {
     const steps = stepsOf(edit);
     if (steps === null) {
-        return refused('Creating and deleting files is not supported yet');
+        return refused('Deleting files is not supported yet');
     }
     const planned = await plan(steps, host);
     if (typeof planned === 'string') {
@@ -111,8 +132,8 @@ export async function applyWorkspaceEdit(edit: WorkspaceEdit, host: WorkspaceEdi
     const moving = planned.some((item) => item.kind === 'rename');
     const staged: StagedFile[] = [];
     for (const item of planned) {
-        if (item.kind === 'rename') {
-            const reason = await host.files!.rename(item.oldPath, item.newPath);
+        if (item.kind === 'rename' || item.kind === 'create') {
+            const reason = item.kind === 'rename' ? await host.files!.rename(item.oldPath, item.newPath) : await host.files!.create!(item.path, item.text);
             if (reason !== null) {
                 return refused(reason);
             }
@@ -154,8 +175,21 @@ async function plan(steps: readonly Step[], host: WorkspaceEditHost): Promise<Pl
     const texts = new Map<string, { text: string; disk: DiskText | null }>();
     // A file that has moved is read where it still stands: nothing moves until the plan is made.
     const origins = new Map<string, string>();
+    // A file that is made is written once, with what every step leaves in it.
+    const creates = new Map<string, PlannedCreate>();
     const planned: Planned[] = [];
     for (const step of steps) {
+        if (step.kind === 'create') {
+            const made = await planCreate(step.file, host, texts);
+            if (typeof made === 'string') {
+                return made;
+            }
+            if (made !== null) {
+                creates.set(step.file.uri, made);
+                planned.push(made);
+            }
+            continue;
+        }
         if (step.kind === 'rename') {
             const oldPath = fileUriToPath(step.oldUri);
             const newPath = fileUriToPath(step.newUri);
@@ -167,6 +201,15 @@ async function plan(steps: readonly Step[], host: WorkspaceEditHost): Promise<Pl
             continue;
         }
         const source = origins.get(step.uri) ?? step.uri;
+        const created = creates.get(source);
+        if (created !== undefined) {
+            try {
+                created.text = applyTextEdits(created.text, step.edits);
+            } catch (error) {
+                return error instanceof Error ? error.message : String(error);
+            }
+            continue;
+        }
         if (!texts.has(source)) {
             const editor = host.editorOf(source);
             if (editor) {
@@ -192,3 +235,20 @@ async function plan(steps: readonly Step[], host: WorkspaceEditHost): Promise<Pl
     }
     return planned;
 }
+
+/* A file that is not there yet, or null when it is and the create says to leave it. Making one over a file that is there is not supported. */
+async function planCreate(
+    file: CreateFile,
+    host: WorkspaceEditHost,
+    texts: ReadonlyMap<string, { text: string; disk: DiskText | null }>
+): Promise<PlannedCreate | null | string> {
+    const path = fileUriToPath(file.uri);
+    if (path === null || host.files?.create === undefined) {
+        return `Creating ${file.uri} is not supported here`;
+    }
+    const there = texts.has(file.uri) || host.editorOf(file.uri) !== undefined || (await host.files.read(path)) !== null;
+    if (!there) {
+        return { kind: 'create', path, text: '' };
+    }
+    return file.options?.ignoreIfExists === true && file.options.overwrite !== true ? null : `${path} already exists`;
+}