@thedatagrid/docs-kit 0.1.0 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,24 @@
1
1
  # @thedatagrid/docs-kit
2
2
 
3
+ ## 0.2.1
4
+
5
+ ### Patch Changes
6
+
7
+ - a2d0334: `<Demo>` is optional: a `<DemoTitle>` and/or `<DemoDescription>` right before a fence become that fence's card header, and the demo's docs back-link uses that title. A `<DemoTitle>` / `<DemoDescription>` with no fence after it fails the build.
8
+
9
+ ## 0.2.0
10
+
11
+ ### Minor Changes
12
+
13
+ - 3852bc8: Editor theming, snippet labels, and an editor extension for fence links.
14
+
15
+ - The code editor takes every color and its font from `--dk-editor-*` CSS variables (text, background, cursor, selection, active line, gutter, matches, tooltips, search panel, and one variable per syntax token group). Unset variables fall back to the card variables. The colors come from a CodeMirror theme extension, so they win over CodeMirror's own light theme.
16
+ **Breaking:** `--dk-tok-*` is now `--dk-editor-*` (e.g. `--dk-tok-keyword` → `--dk-editor-keyword`), `--dk-selection` is now `--dk-editor-selection-bg`, and the editor no longer adds `tok-*` classes.
17
+ - `#highlight label` labels render as pills (`--dk-label-bg`, `--dk-label-fg`, `--dk-font-sans`) and stay out of text selections. Rows that hold only a label get their own layout.
18
+ - Token spans no longer paint the shiki theme background, which drew boxes over highlighted lines.
19
+ - New `--dk-line-number`, `--dk-code-font-size` and `--dk-code-line-height`.
20
+ - `docs-kit editor install [code] [cursor]` installs the **docs-kit links** extension into VS Code and/or Cursor. In a docs page, Cmd/Ctrl+click a fence's `file="…"` to open that file, at its `region="…"` when one is set. `docs-kit editor package` only builds the `.vsix`.
21
+
3
22
  ## 0.1.0
4
23
 
5
24
  ### Minor Changes
package/README.md CHANGED
@@ -33,16 +33,18 @@ One package, with subpath exports:
33
33
  ```tsx file="sorting.snippet.tsx" region="sort-info" lines
34
34
  ```
35
35
 
36
- <Demo>
37
36
  <DemoTitle>Controlled sorting</DemoTitle>
38
37
  <DemoDescription>Click a header to sort.</DemoDescription>
39
38
 
40
39
  ```tsx file="controlled.demo.tsx" live height="small"
41
40
  ```
42
- </Demo>
43
41
  ````
44
42
 
45
- - `file` is relative to the page. Missing files and regions fail the build.
43
+ - `<DemoTitle>` / `<DemoDescription>` right before a fence are its card's
44
+ header (both optional). Wrapping them with the fence in `<Demo>…</Demo>`
45
+ does the same. One without a fence after it fails the build.
46
+ - `file` is relative to the page, or to the content root when it starts with
47
+ `/`. Missing files and regions fail the build.
46
48
  - `live` turns a `*.demo.tsx` (in the page's folder or below) into a demo card.
47
49
  `live=off` starts on the code tab. `edit=off` disables editing.
48
50
  - `region="name"` shows a `//#region name` … `//#endregion` slice (also
@@ -116,6 +118,107 @@ prebuilt demo. Fork sends the edited files.
116
118
 
117
119
  Serve `*.wasm` with a long cache lifetime: the file name is content-hashed.
118
120
 
121
+ ## Theming
122
+
123
+ The cards are styled through `--dk-*` CSS custom properties (the list is at the
124
+ top of `styles.css`). Set them in your own CSS, after importing
125
+ `@thedatagrid/docs-kit/react/styles.css`. Use `:root` for the light values and
126
+ `[data-theme='dark']` for the dark ones. Your selector can differ: these are
127
+ ordinary CSS variables.
128
+
129
+ Code blocks use these:
130
+
131
+ - `--dk-code-bg`, `--dk-code-font-size`, `--dk-code-line-height`: also used by the editor;
132
+ - `--dk-highlight-bg`, `--dk-highlight-border`: `#highlight`ed lines;
133
+ - `--dk-label-bg`, `--dk-label-fg`, `--dk-font-sans`: the `#highlight label` pills, which
134
+ stay out of the text when someone selects and copies a snippet;
135
+ - `--dk-line-number`: line numbers, and the editor's gutter.
136
+
137
+ The code editor has its own `--dk-editor-*` variables. When a site leaves one
138
+ unset, it falls back to the matching card variable, so out of the box the
139
+ editor looks like the static code:
140
+
141
+ ```css
142
+ [data-theme='dark'] {
143
+ /* text, background, font */
144
+ --dk-editor-bg: #0d1117;
145
+ --dk-editor-fg: #e6edf3;
146
+ --dk-editor-font-family: 'JetBrains Mono', monospace;
147
+ --dk-editor-font-size: 14px;
148
+ --dk-editor-line-height: 1.7;
149
+
150
+ /* editing */
151
+ --dk-editor-cursor: #58a6ff;
152
+ --dk-editor-selection-bg: rgb(56 139 253 / 0.3);
153
+ --dk-editor-active-line-bg: rgb(255 255 255 / 0.04);
154
+ --dk-editor-selection-match-bg: rgb(255 255 255 / 0.08);
155
+ --dk-editor-bracket-match-bg: transparent;
156
+ --dk-editor-bracket-match-outline: #58a6ff;
157
+ --dk-editor-search-match-bg: rgb(187 128 9 / 0.3);
158
+
159
+ /* line numbers */
160
+ --dk-editor-gutter-bg: #0d1117;
161
+ --dk-editor-gutter-fg: #6e7681;
162
+ --dk-editor-gutter-border: #30363d;
163
+ --dk-editor-active-line-gutter-fg: #e6edf3;
164
+
165
+ /* syntax */
166
+ --dk-editor-keyword: #ff7b72;
167
+ --dk-editor-constant: #79c0ff; /* true, null, this */
168
+ --dk-editor-number: #79c0ff;
169
+ --dk-editor-string: #a5d6ff;
170
+ --dk-editor-regexp: #7ee787;
171
+ --dk-editor-comment: #8b949e;
172
+ --dk-editor-comment-font-style: normal;
173
+ --dk-editor-type: #ffa657;
174
+ --dk-editor-function: #d2a8ff;
175
+ --dk-editor-definition: #d2a8ff; /* declared names */
176
+ --dk-editor-variable: #e6edf3;
177
+ --dk-editor-property: #79c0ff;
178
+ --dk-editor-tag: #7ee787; /* JSX tags */
179
+ --dk-editor-attribute: #79c0ff; /* JSX attributes */
180
+ --dk-editor-operator: #ff7b72;
181
+ --dk-editor-punctuation: #e6edf3;
182
+ --dk-editor-meta: #8b949e;
183
+ --dk-editor-invalid: #f85149;
184
+
185
+ /* autocomplete and the search panel (Ctrl/Cmd-F) */
186
+ --dk-editor-tooltip-bg: #161b22;
187
+ --dk-editor-tooltip-fg: #e6edf3;
188
+ --dk-editor-tooltip-selected-bg: rgb(56 139 253 / 0.3);
189
+ --dk-editor-panel-bg: #161b22;
190
+ --dk-editor-border: #30363d;
191
+ }
192
+ ```
193
+
194
+ The static code blocks are colored by the shiki themes
195
+ (`github-light` / `tokyo-night` by default, `themes` option). The editor's
196
+ default syntax colors match them; when you change one, change the other.
197
+ `--dk-code-bg`, `--dk-code-font-size` and `--dk-code-line-height` apply to both.
198
+
199
+ The editor's colors are set through a CodeMirror theme extension, so they win
200
+ over CodeMirror's built-in light theme without `!important`. A site stylesheet
201
+ with unscoped `!important` rules on `.cm-*` classes, such as
202
+ `.cm-gutters { … !important }` written for another editor, still overrides
203
+ them. Scope those rules to their own editor (e.g. `.sp-wrapper .cm-gutters`).
204
+
205
+ ## Editor extension (VS Code, Cursor)
206
+
207
+ The package includes a small extension, **docs-kit links**. In a docs page, Cmd/Ctrl+click
208
+ the `file="…"` of a fence to open that file. When the fence has `region="name"`, the file
209
+ opens at its `#region name` line. Paths resolve as in `remarkDemoFences`: from the page's
210
+ folder, or from the content root for `/…` paths. The content root is `docsKit.contentDir`,
211
+ or else `docsRoot.source`, in the site's `package.json`.
212
+
213
+ ```sh
214
+ npx docs-kit editor install # every VS Code / Cursor CLI found
215
+ npx docs-kit editor install cursor # or only some: code, cursor
216
+ npx docs-kit editor package --out docs-kit-links.vsix # just the .vsix
217
+ ```
218
+
219
+ It packages the extension with `@vscode/vsce`, fetched through `npx` on first use, and
220
+ versions it like the installed docs-kit. Run it again after upgrading docs-kit.
221
+
119
222
  ## Local development across repos
120
223
 
121
224
  Check `docs-kit` out next to the consuming repo, and run the site with
package/dist/demos/cli.js CHANGED
@@ -13,19 +13,53 @@ var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExte
13
13
  * Loads `docs-kit.config.{mjs,js,ts}` from the current folder (or `--config`)
14
14
  * and prebuilds the demos. The config's default export is a `DocsKitConfig`
15
15
  * or a (sync/async) function returning one.
16
+ *
17
+ * `docs-kit editor install [code] [cursor]` installs the docs-kit links
18
+ * extension (cmd+click `file="…"` in fences) into VS Code and/or Cursor;
19
+ * `docs-kit editor package [--out <file>]` only builds its .vsix.
16
20
  */
17
21
  import fs from 'node:fs';
18
22
  import path from 'node:path';
19
23
  import { pathToFileURL } from 'node:url';
24
+ import { installExtension, packageExtension } from "../editor/install.js";
20
25
  import { buildDemos } from "./build.js";
21
26
  const CONFIG_NAMES = ['docs-kit.config.mjs', 'docs-kit.config.js', 'docs-kit.config.ts'];
22
27
  function usage() {
23
- console.error('usage: docs-kit demos [build] [--watch] [--config <file>]');
28
+ console.error([
29
+ 'usage: docs-kit demos [build] [--watch] [--config <file>]',
30
+ ' docs-kit editor install [code] [cursor]',
31
+ ' docs-kit editor package [--out <file>]',
32
+ ].join('\n'));
24
33
  process.exit(1);
25
34
  }
35
+ function editorCommand(args) {
36
+ const sub = args.shift();
37
+ if (sub === 'install') {
38
+ const only = args.map((arg) => (arg === 'code' || arg === 'cursor' ? arg : usage()));
39
+ const { installed } = installExtension(only);
40
+ if (only.length && installed.length < only.length)
41
+ process.exit(1);
42
+ return;
43
+ }
44
+ if (sub === 'package') {
45
+ let out;
46
+ while (args.length) {
47
+ const arg = args.shift();
48
+ if (arg === '--out' || arg === '-o')
49
+ out = args.shift() ?? usage();
50
+ else
51
+ usage();
52
+ }
53
+ console.log(packageExtension(out));
54
+ return;
55
+ }
56
+ usage();
57
+ }
26
58
  async function main(argv) {
27
59
  const args = [...argv];
28
60
  const command = args.shift();
61
+ if (command === 'editor')
62
+ return editorCommand(args);
29
63
  if (command !== 'demos')
30
64
  usage();
31
65
  if (args[0] === 'build')
@@ -1 +1 @@
1
- {"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/demos/cli.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/demos/cli.ts"],"names":[],"mappings":"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"}
@@ -3,7 +3,8 @@ export declare function defaultRouteForPage(pagePath: string): string;
3
3
  /**
4
4
  * Maps demo ids to the docs page (and card anchor) that shows them, so a demo
5
5
  * opened on its own can link back. The anchor matches the `<Demo>` card's
6
- * slug: `<DemoTitle>` > `<Demo title>` > the fence's `title` > `<name>.demo.tsx`.
6
+ * slug: `<DemoTitle>` (inside `<Demo>`, or right before the fence) > `<Demo title>`
7
+ * > the fence's `title` > `<name>.demo.tsx`.
7
8
  */
8
9
  export declare function findDocsLinks(options: {
9
10
  contentDir: string;
@@ -1 +1 @@
1
- {"version":3,"file":"pages.d.ts","sourceRoot":"","sources":["../../src/demos/pages.ts"],"names":[],"mappings":"AAgBA,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAE/D;AAID,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG5D;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAwCtB"}
1
+ {"version":3,"file":"pages.d.ts","sourceRoot":"","sources":["../../src/demos/pages.ts"],"names":[],"mappings":"AAgBA,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAE/D;AAwBD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG5D;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CA0CtB"}
@@ -18,6 +18,27 @@ function walk(dir, accept, out = []) {
18
18
  export function findFiles(dir, suffix) {
19
19
  return walk(dir, (name) => name.endsWith(suffix)).sort();
20
20
  }
21
+ /**
22
+ * The `<DemoTitle>` among the `<DemoTitle>` / `<DemoDescription>` blocks
23
+ * that end right before a fence (no `<Demo>` wrapper), or null.
24
+ */
25
+ function looseDemoTitle(before) {
26
+ let rest = before.trimEnd();
27
+ for (let part = 0; part < 2; part++) {
28
+ const close = /<\/(DemoTitle|DemoDescription)>$/.exec(rest);
29
+ if (!close)
30
+ return null;
31
+ const start = rest.lastIndexOf(`<${close[1]}>`);
32
+ if (start === -1)
33
+ return null;
34
+ if (close[1] === 'DemoTitle') {
35
+ const text = rest.slice(start + '<DemoTitle>'.length, close.index);
36
+ return text.replace(/<[^>]+>/g, '').trim() || null;
37
+ }
38
+ rest = rest.slice(0, start).trimEnd();
39
+ }
40
+ return null;
41
+ }
21
42
  const toPosix = (p) => p.split(path.sep).join('/');
22
43
  export function defaultRouteForPage(pagePath) {
23
44
  const route = `/${pagePath}`.replace(/\/index$/, '');
@@ -26,7 +47,8 @@ export function defaultRouteForPage(pagePath) {
26
47
  /**
27
48
  * Maps demo ids to the docs page (and card anchor) that shows them, so a demo
28
49
  * opened on its own can link back. The anchor matches the `<Demo>` card's
29
- * slug: `<DemoTitle>` > `<Demo title>` > the fence's `title` > `<name>.demo.tsx`.
50
+ * slug: `<DemoTitle>` (inside `<Demo>`, or right before the fence) > `<Demo title>`
51
+ * > the fence's `title` > `<name>.demo.tsx`.
30
52
  */
31
53
  export function findDocsLinks(options) {
32
54
  const { contentDir, pageExtension, demoSuffix, routeForPage, anchorPrefix = '' } = options;
@@ -59,6 +81,9 @@ export function findDocsLinks(options) {
59
81
  const titleAttr = /^<Demo\b[^>]*\btitle=(?:"([^"]*)"|'([^']*)')/.exec(block);
60
82
  title = demoTitle?.[1].replace(/<[^>]+>/g, '').trim() || titleAttr?.[1] || titleAttr?.[2] || null;
61
83
  }
84
+ else {
85
+ title = looseDemoTitle(before);
86
+ }
62
87
  if (!title) {
63
88
  const fenceTitle = /\btitle=(?:"([^"]*)"|'([^']*)')/.exec(info);
64
89
  title = fenceTitle?.[1] ?? fenceTitle?.[2] ?? `${path.basename(fileName)}`;
@@ -1 +1 @@
1
- {"version":3,"file":"pages.js","sourceRoot":"","sources":["../../src/demos/pages.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"pages.js","sourceRoot":"","sources":["../../src/demos/pages.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,15 @@
1
+ export declare const EXTENSION_DIR: string;
2
+ export type Editor = 'code' | 'cursor';
3
+ /** The CLI of each editor that is installed (`code`, `cursor`). */
4
+ export declare function findEditors(only?: Editor[]): {
5
+ editor: Editor;
6
+ bin: string;
7
+ }[];
8
+ /** Packages the extension, versioned like this docs-kit, into `outFile` (default: a temp file). */
9
+ export declare function packageExtension(outFile?: string): string;
10
+ /** Packages the extension and installs it into each editor found (or the ones in `only`). */
11
+ export declare function installExtension(only?: Editor[], log?: (message: string) => void): {
12
+ vsix: string;
13
+ installed: Editor[];
14
+ };
15
+ //# sourceMappingURL=install.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/editor/install.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,aAAa,QAA6C,CAAC;AAIxE,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;AAYvC,mEAAmE;AACnE,wBAAgB,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EAAE,CAO9E;AAED,mGAAmG;AACnG,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAoBzD;AAED,6FAA6F;AAC7F,wBAAgB,gBAAgB,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,GAAG,GAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAkB;;eAQ1D,MAAM,EAAE;EAa3C"}
@@ -0,0 +1,71 @@
1
+ /**
2
+ * `docs-kit editor install|package`: packages the docs-kit links extension
3
+ * (`editor-extension/` in this package) into a .vsix with @vscode/vsce and
4
+ * installs it into VS Code and/or Cursor.
5
+ */
6
+ import { spawnSync } from 'node:child_process';
7
+ import fs from 'node:fs';
8
+ import os from 'node:os';
9
+ import path from 'node:path';
10
+ import { fileURLToPath } from 'node:url';
11
+ /** Same folder from `src/editor/` (local mode) and `dist/editor/` (the package). */
12
+ const packageRoot = fileURLToPath(new URL('../../', import.meta.url));
13
+ export const EXTENSION_DIR = path.join(packageRoot, 'editor-extension');
14
+ const VSCE = '@vscode/vsce@4.1.0';
15
+ const FILES = ['package.json', 'extension.js', 'links.js', 'README.md'];
16
+ const APP_BINARIES = {
17
+ code: ['/Applications/Visual Studio Code.app/Contents/Resources/app/bin/code'],
18
+ cursor: ['/Applications/Cursor.app/Contents/Resources/app/bin/cursor'],
19
+ };
20
+ function onPath(command) {
21
+ const result = spawnSync(process.platform === 'win32' ? 'where' : 'which', [command], { encoding: 'utf8' });
22
+ return result.status === 0 ? result.stdout.split(/\r?\n/)[0].trim() || null : null;
23
+ }
24
+ /** The CLI of each editor that is installed (`code`, `cursor`). */
25
+ export function findEditors(only) {
26
+ return Object.keys(APP_BINARIES)
27
+ .filter((editor) => !only?.length || only.includes(editor))
28
+ .flatMap((editor) => {
29
+ const bin = onPath(editor) ?? APP_BINARIES[editor].find((file) => fs.existsSync(file));
30
+ return bin ? [{ editor, bin }] : [];
31
+ });
32
+ }
33
+ /** Packages the extension, versioned like this docs-kit, into `outFile` (default: a temp file). */
34
+ export function packageExtension(outFile) {
35
+ const { version } = JSON.parse(fs.readFileSync(path.join(packageRoot, 'package.json'), 'utf8'));
36
+ const work = fs.mkdtempSync(path.join(os.tmpdir(), 'docs-kit-editor-'));
37
+ for (const file of FILES)
38
+ fs.copyFileSync(path.join(EXTENSION_DIR, file), path.join(work, file));
39
+ const manifest = JSON.parse(fs.readFileSync(path.join(work, 'package.json'), 'utf8'));
40
+ manifest.version = version;
41
+ fs.writeFileSync(path.join(work, 'package.json'), `${JSON.stringify(manifest, null, 2)}\n`);
42
+ const out = path.resolve(outFile ?? path.join(work, `docs-kit-links-${version}.vsix`));
43
+ const result = spawnSync('npx', ['--yes', VSCE, 'package', '--no-dependencies', '--skip-license', '--allow-missing-repository', '-o', out], { cwd: work, stdio: ['ignore', 'pipe', 'pipe'], encoding: 'utf8', shell: process.platform === 'win32' });
44
+ if (result.status !== 0 || !fs.existsSync(out)) {
45
+ throw new Error(`[docs-kit] packaging the editor extension failed:\n${result.stdout}${result.stderr}`);
46
+ }
47
+ return out;
48
+ }
49
+ /** Packages the extension and installs it into each editor found (or the ones in `only`). */
50
+ export function installExtension(only, log = console.log) {
51
+ const editors = findEditors(only);
52
+ const vsix = packageExtension();
53
+ if (!editors.length) {
54
+ log(`[docs-kit] no VS Code or Cursor CLI found. Install ${vsix} from the editor ` +
55
+ '(Extensions → … → Install from VSIX).');
56
+ return { vsix, installed: [] };
57
+ }
58
+ const installed = [];
59
+ for (const { editor, bin } of editors) {
60
+ const result = spawnSync(bin, ['--install-extension', vsix, '--force'], { encoding: 'utf8' });
61
+ if (result.status === 0) {
62
+ installed.push(editor);
63
+ log(`[docs-kit] installed the docs-kit links extension in ${editor}. Reload its windows to use it.`);
64
+ }
65
+ else {
66
+ log(`[docs-kit] installing in ${editor} failed:\n${result.stdout}${result.stderr}`);
67
+ }
68
+ }
69
+ return { vsix, installed };
70
+ }
71
+ //# sourceMappingURL=install.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"install.js","sourceRoot":"","sources":["../../src/editor/install.ts"],"names":[],"mappings":"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"}
@@ -1,3 +1,12 @@
1
+ import { HighlightStyle } from '@codemirror/language';
2
+ import { type Extension } from '@codemirror/state';
3
+ /**
4
+ * Editor chrome. Rules in an `EditorView.theme` come after CodeMirror's base
5
+ * theme, so they win over its light defaults without `!important`.
6
+ */
7
+ export declare const editorTheme: Extension;
8
+ /** Syntax colors: one variable per token group (README → Theming). */
9
+ export declare const editorHighlightStyle: HighlightStyle;
1
10
  export declare function createCodeEditor(parent: HTMLElement, options: {
2
11
  doc: string;
3
12
  fileName: string;
@@ -1 +1 @@
1
- {"version":3,"file":"editor.d.ts","sourceRoot":"","sources":["../../src/react/editor.ts"],"names":[],"mappings":"AA6BA,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE;;EA6B9E"}
1
+ {"version":3,"file":"editor.d.ts","sourceRoot":"","sources":["../../src/react/editor.ts"],"names":[],"mappings":"AAaA,OAAO,EAEL,cAAc,EAIf,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAe,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAqBhE;;;GAGG;AACH,eAAO,MAAM,WAAW,WA8DtB,CAAC;AAEH,sEAAsE;AACtE,eAAO,MAAM,oBAAoB,gBAyB/B,CAAC;AASH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE;;EA8B9E"}
@@ -1,17 +1,122 @@
1
1
  /**
2
2
  * CodeMirror 6 for demo editing. Only imported (dynamically) when someone
3
- * clicks Edit, so pages that are just read never download it. Colors come
4
- * from `--dk-*` CSS variables (see styles.css): tokens get `tok-*` classes.
3
+ * clicks Edit, so pages that are just read never download it.
4
+ *
5
+ * Every color, and the font, comes from a `--dk-editor-*` CSS variable, so a
6
+ * site restyles the editor from its own CSS (see "Theming" in the README).
7
+ * The variables a site doesn't set fall back to the card's `--dk-*` ones
8
+ * (styles.css), so the editor matches the cards by default.
5
9
  */
6
10
  import { autocompletion, closeBrackets, closeBracketsKeymap } from '@codemirror/autocomplete';
7
11
  import { defaultKeymap, history, historyKeymap, indentWithTab } from '@codemirror/commands';
8
12
  import { css } from '@codemirror/lang-css';
9
13
  import { javascript } from '@codemirror/lang-javascript';
10
- import { bracketMatching, indentOnInput, indentUnit, syntaxHighlighting } from '@codemirror/language';
14
+ import { bracketMatching, HighlightStyle, indentOnInput, indentUnit, syntaxHighlighting, } from '@codemirror/language';
11
15
  import { highlightSelectionMatches, searchKeymap } from '@codemirror/search';
12
16
  import { EditorState } from '@codemirror/state';
13
17
  import { drawSelection, EditorView, highlightActiveLine, highlightActiveLineGutter, keymap, lineNumbers, } from '@codemirror/view';
14
- import { classHighlighter } from '@lezer/highlight';
18
+ import { tags as t } from '@lezer/highlight';
19
+ /** `var(--dk-editor-<name>, <fallback>)` */
20
+ const v = (name, fallback) => `var(--dk-editor-${name}, ${fallback})`;
21
+ const fg = v('fg', 'var(--dk-fg)');
22
+ const bg = v('bg', 'var(--dk-code-bg)');
23
+ const activeLineBg = v('active-line-bg', 'var(--dk-accent-soft)');
24
+ const gutterFg = v('gutter-fg', 'var(--dk-line-number, var(--dk-faint))');
25
+ const border = v('border', 'var(--dk-border)');
26
+ const surface = v('panel-bg', 'var(--dk-surface)');
27
+ /**
28
+ * Editor chrome. Rules in an `EditorView.theme` come after CodeMirror's base
29
+ * theme, so they win over its light defaults without `!important`.
30
+ */
31
+ export const editorTheme = EditorView.theme({
32
+ '&': {
33
+ height: '100%',
34
+ color: fg,
35
+ backgroundColor: bg,
36
+ fontSize: v('font-size', 'var(--dk-code-font-size, 13.5px)'),
37
+ },
38
+ '&.cm-focused': { outline: 'none' },
39
+ '.cm-scroller': {
40
+ fontFamily: v('font-family', 'var(--dk-font-mono)'),
41
+ lineHeight: v('line-height', 'var(--dk-code-line-height, 1.6)'),
42
+ },
43
+ '.cm-content': { caretColor: v('cursor', fg) },
44
+ '.cm-cursor, .cm-dropCursor': { borderLeftColor: v('cursor', fg) },
45
+ '&.cm-focused > .cm-scroller > .cm-selectionLayer .cm-selectionBackground, .cm-selectionBackground, .cm-content ::selection': { backgroundColor: v('selection-bg', 'var(--dk-accent-soft)') },
46
+ '.cm-activeLine': { backgroundColor: activeLineBg },
47
+ '.cm-gutters': {
48
+ backgroundColor: v('gutter-bg', bg),
49
+ color: gutterFg,
50
+ border: 'none',
51
+ borderRight: `1px solid ${v('gutter-border', 'transparent')}`,
52
+ },
53
+ '.cm-activeLineGutter': {
54
+ backgroundColor: v('active-line-gutter-bg', activeLineBg),
55
+ color: v('active-line-gutter-fg', gutterFg),
56
+ },
57
+ '.cm-selectionMatch': { backgroundColor: v('selection-match-bg', 'var(--dk-accent-soft)') },
58
+ '&.cm-focused .cm-matchingBracket': {
59
+ backgroundColor: v('bracket-match-bg', 'var(--dk-accent-soft)'),
60
+ outline: `1px solid ${v('bracket-match-outline', 'var(--dk-accent)')}`,
61
+ },
62
+ '&.cm-focused .cm-nonmatchingBracket': {
63
+ backgroundColor: 'transparent',
64
+ outline: `1px solid ${v('invalid', 'var(--dk-error)')}`,
65
+ },
66
+ '.cm-searchMatch': {
67
+ backgroundColor: v('search-match-bg', 'var(--dk-highlight-bg)'),
68
+ outline: `1px solid ${v('search-match-outline', 'var(--dk-highlight-border)')}`,
69
+ },
70
+ '.cm-searchMatch.cm-searchMatch-selected': {
71
+ backgroundColor: v('search-match-selected-bg', 'var(--dk-accent-soft)'),
72
+ },
73
+ '.cm-tooltip': {
74
+ border: `1px solid ${border}`,
75
+ backgroundColor: v('tooltip-bg', surface),
76
+ color: v('tooltip-fg', fg),
77
+ },
78
+ '.cm-tooltip-autocomplete > ul > li[aria-selected]': {
79
+ backgroundColor: v('tooltip-selected-bg', 'var(--dk-accent-soft)'),
80
+ color: v('tooltip-selected-fg', fg),
81
+ },
82
+ '.cm-panels': { backgroundColor: surface, color: v('panel-fg', fg) },
83
+ '.cm-panels.cm-panels-top': { borderBottom: `1px solid ${border}` },
84
+ '.cm-panels.cm-panels-bottom': { borderTop: `1px solid ${border}` },
85
+ '.cm-textfield, .cm-button': {
86
+ border: `1px solid ${border}`,
87
+ borderRadius: '4px',
88
+ backgroundColor: bg,
89
+ backgroundImage: 'none',
90
+ color: fg,
91
+ },
92
+ });
93
+ /** Syntax colors: one variable per token group (README → Theming). */
94
+ export const editorHighlightStyle = HighlightStyle.define([
95
+ { tag: t.keyword, color: v('keyword', 'var(--dk-fg)') },
96
+ { tag: [t.self, t.null, t.bool, t.atom], color: v('constant', v('keyword', 'var(--dk-fg)')) },
97
+ { tag: [t.number, t.unit, t.color], color: v('number', 'var(--dk-fg)') },
98
+ { tag: [t.string, t.special(t.string), t.character], color: v('string', 'var(--dk-fg)') },
99
+ { tag: [t.regexp, t.escape], color: v('regexp', v('string', 'var(--dk-fg)')) },
100
+ {
101
+ tag: t.comment,
102
+ color: v('comment', 'var(--dk-faint)'),
103
+ fontStyle: v('comment-font-style', 'italic'),
104
+ },
105
+ { tag: [t.typeName, t.className, t.namespace], color: v('type', 'var(--dk-fg)') },
106
+ {
107
+ tag: [t.function(t.variableName), t.function(t.propertyName)],
108
+ color: v('function', 'var(--dk-fg)'),
109
+ },
110
+ { tag: t.definition(t.variableName), color: v('definition', v('function', 'var(--dk-fg)')) },
111
+ { tag: t.variableName, color: v('variable', fg) },
112
+ { tag: t.propertyName, color: v('property', 'var(--dk-fg)') },
113
+ { tag: t.tagName, color: v('tag', 'var(--dk-fg)') },
114
+ { tag: t.attributeName, color: v('attribute', 'var(--dk-fg)') },
115
+ { tag: t.operator, color: v('operator', fg) },
116
+ { tag: [t.punctuation, t.bracket, t.separator], color: v('punctuation', fg) },
117
+ { tag: t.meta, color: v('meta', v('comment', 'var(--dk-faint)')) },
118
+ { tag: t.invalid, color: v('invalid', 'var(--dk-error)') },
119
+ ]);
15
120
  function languageFor(fileName) {
16
121
  if (/\.css$/.test(fileName))
17
122
  return css();
@@ -36,7 +141,8 @@ export function createCodeEditor(parent, options) {
36
141
  closeBrackets(),
37
142
  autocompletion({ activateOnTyping: false }),
38
143
  highlightSelectionMatches(),
39
- syntaxHighlighting(classHighlighter),
144
+ editorTheme,
145
+ syntaxHighlighting(editorHighlightStyle),
40
146
  languageFor(options.fileName),
41
147
  keymap.of([...closeBracketsKeymap, ...defaultKeymap, ...searchKeymap, ...historyKeymap, indentWithTab]),
42
148
  EditorView.updateListener.of((update) => {
@@ -1 +1 @@
1
- {"version":3,"file":"editor.js","sourceRoot":"","sources":["../../src/react/editor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC9F,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC5F,OAAO,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACtG,OAAO,EAAE,yBAAyB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAkB,MAAM,mBAAmB,CAAC;AAChE,OAAO,EACL,aAAa,EACb,UAAU,EACV,mBAAmB,EACnB,yBAAyB,EACzB,MAAM,EACN,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,SAAS,WAAW,CAAC,QAAgB;IACnC,IAAI,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC;QAAE,OAAO,GAAG,EAAE,CAAC;IAC1C,MAAM,EAAE,GAAG,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACzC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACnE,OAAO,UAAU,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,MAAmB,EACnB,OAA6E;IAE7E,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC;QAC1B,MAAM;QACN,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC;YACxB,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,UAAU,EAAE;gBACV,WAAW,EAAE;gBACb,yBAAyB,EAAE;gBAC3B,mBAAmB,EAAE;gBACrB,OAAO,EAAE;gBACT,aAAa,EAAE;gBACf,aAAa,EAAE;gBACf,UAAU,CAAC,EAAE,CAAC,IAAI,CAAC;gBACnB,eAAe,EAAE;gBACjB,aAAa,EAAE;gBACf,cAAc,CAAC,EAAE,gBAAgB,EAAE,KAAK,EAAE,CAAC;gBAC3C,yBAAyB,EAAE;gBAC3B,kBAAkB,CAAC,gBAAgB,CAAC;gBACpC,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC;gBAC7B,MAAM,CAAC,EAAE,CAAC,CAAC,GAAG,mBAAmB,EAAE,GAAG,aAAa,EAAE,GAAG,YAAY,EAAE,GAAG,aAAa,EAAE,aAAa,CAAC,CAAC;gBACvG,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE;oBACtC,IAAI,MAAM,CAAC,UAAU;wBAAE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;gBACvE,CAAC,CAAC;gBACF,UAAU,CAAC,iBAAiB,CAAC,EAAE,CAAC,EAAE,YAAY,EAAE,QAAQ,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;aAC9E;SACF,CAAC;KACH,CAAC,CAAC;IACH,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;AAC3C,CAAC"}
1
+ {"version":3,"file":"editor.js","sourceRoot":"","sources":["../../src/react/editor.ts"],"names":[],"mappings":"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"}