@ldforge/editor 0.1.9 → 1.1.0

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.
Files changed (70) hide show
  1. package/README.md +45 -0
  2. package/dist/controls.d.ts +3 -0
  3. package/dist/controls.d.ts.map +1 -1
  4. package/dist/controls.js +3 -0
  5. package/dist/controls.js.map +1 -1
  6. package/dist/editor-height.d.ts +8 -0
  7. package/dist/editor-height.d.ts.map +1 -0
  8. package/dist/editor-height.js +34 -0
  9. package/dist/editor-height.js.map +1 -0
  10. package/dist/editor-resize.d.ts +13 -0
  11. package/dist/editor-resize.d.ts.map +1 -0
  12. package/dist/editor-resize.js +121 -0
  13. package/dist/editor-resize.js.map +1 -0
  14. package/dist/index.d.ts +33 -0
  15. package/dist/index.d.ts.map +1 -1
  16. package/dist/index.js +363 -33
  17. package/dist/index.js.map +1 -1
  18. package/dist/renderer-info.d.ts +4 -0
  19. package/dist/renderer-info.d.ts.map +1 -0
  20. package/dist/renderer-info.js +41 -0
  21. package/dist/renderer-info.js.map +1 -0
  22. package/dist/renderer-wizard.d.ts.map +1 -1
  23. package/dist/renderer-wizard.js +109 -25
  24. package/dist/renderer-wizard.js.map +1 -1
  25. package/dist/share.d.ts +16 -0
  26. package/dist/share.d.ts.map +1 -0
  27. package/dist/share.js +113 -0
  28. package/dist/share.js.map +1 -0
  29. package/dist/sparql/analysis.d.ts +2 -0
  30. package/dist/sparql/analysis.d.ts.map +1 -1
  31. package/dist/sparql/analysis.js +54 -0
  32. package/dist/sparql/analysis.js.map +1 -1
  33. package/dist/sparql/completion.d.ts.map +1 -1
  34. package/dist/sparql/completion.js +7 -2
  35. package/dist/sparql/completion.js.map +1 -1
  36. package/dist/sparql/index.d.ts +1 -1
  37. package/dist/sparql/index.d.ts.map +1 -1
  38. package/dist/sparql/index.js +1 -1
  39. package/dist/sparql/index.js.map +1 -1
  40. package/dist/styles.css +541 -82
  41. package/dist/tab-api.d.ts +7 -1
  42. package/dist/tab-api.d.ts.map +1 -1
  43. package/dist/tab-api.js +29 -1
  44. package/dist/tab-api.js.map +1 -1
  45. package/dist/theme.d.ts +4 -0
  46. package/dist/theme.d.ts.map +1 -0
  47. package/dist/theme.js +73 -0
  48. package/dist/theme.js.map +1 -0
  49. package/docs/api/configuration.md +73 -21
  50. package/docs/api/editor.md +190 -19
  51. package/docs/api/overview.md +8 -0
  52. package/docs/api/plugins.md +6 -2
  53. package/docs/api/prefixes.md +12 -11
  54. package/docs/api/tab.md +37 -9
  55. package/docs/api/transport.md +19 -2
  56. package/docs/renderers.md +29 -1
  57. package/package.json +3 -3
  58. package/src/controls.ts +6 -0
  59. package/src/editor-height.ts +42 -0
  60. package/src/editor-resize.ts +150 -0
  61. package/src/index.ts +457 -30
  62. package/src/renderer-info.ts +52 -0
  63. package/src/renderer-wizard.ts +114 -25
  64. package/src/share.ts +125 -0
  65. package/src/sparql/analysis.ts +61 -0
  66. package/src/sparql/completion.ts +7 -2
  67. package/src/sparql/index.ts +5 -1
  68. package/src/styles.css +541 -82
  69. package/src/tab-api.ts +44 -4
  70. package/src/theme.ts +87 -0
package/src/index.ts CHANGED
@@ -1,3 +1,17 @@
1
+ import { createEditorResize } from './editor-resize.js';
2
+ import {
3
+ createAutoGrowControl,
4
+ DEFAULT_EDITOR_ROWS,
5
+ validateEditorRows,
6
+ } from './editor-height.js';
7
+ import { renderRendererInfo } from './renderer-info.js';
8
+ import { applyTheme, themeTokens } from './theme.js';
9
+ import {
10
+ createShareControl,
11
+ createShareLink,
12
+ queryWithRenderer,
13
+ queryWithEndpoint,
14
+ } from './share.js';
1
15
  import {
2
16
  createFontSizeControl,
3
17
  DEFAULT_FONT_SIZE,
@@ -103,6 +117,10 @@ export type {
103
117
  export interface EditorOptions {
104
118
  readonly executor: QueryExecutor;
105
119
  readonly query?: string;
120
+ /** Absolute recipient page URL. Defaults to the current page URL. */
121
+ readonly shareBaseUrl?: string;
122
+ /** Applied connection endpoint to include when the query has none. Read at share time. */
123
+ readonly shareEndpoint?: string | (() => string | undefined);
106
124
  /** Initially collapse PREFIX declarations on each tab. Defaults to false. */
107
125
  readonly prefixesCollapsed?: boolean;
108
126
  /** Built-in UI visibility; all flags default to true. False hides all built-in controls. */
@@ -120,12 +138,24 @@ export interface EditorOptions {
120
138
  readonly onLocaleChange?: (preference: LocalePreference) => void;
121
139
  /** CodeMirror query text size only, 10–24px. */
122
140
  readonly fontSize?: number;
141
+ /** Query viewport in visual lines; minimum when autoGrow is true. Defaults to 15. */
142
+ readonly editorRows?: number;
143
+ /** Grow with query content instead of scrolling a fixed viewport. Defaults to true. */
144
+ readonly autoGrow?: boolean;
145
+ readonly onAutoGrowChange?: (enabled: boolean) => void;
146
+ readonly onEditorRowsChange?: (rows: number) => void;
147
+ /** Instance accent as an opaque #RGB or #RRGGBB color. Omit for the default theme. */
148
+ readonly themeMainColor?: string;
123
149
  readonly onFontSizeChange?: (size: number) => void;
124
150
  /** Omit to use the combined Run/Stop button; provide an array to replace the toolbar. */
125
151
  readonly buttons?: readonly ButtonPlugin[];
126
152
  /** Optional dropdown presentation and additional declarative button groups. */
127
153
  readonly toolbar?: ToolbarOptions;
128
154
  readonly renderers?: readonly ResultRendererPlugin[];
155
+ /** Show the dropdown of other registered renderers. Defaults to true. */
156
+ readonly availablePlugins?: boolean;
157
+ /** Renderers pinned on the result bar, by registered ID or descriptor. Defaults to Table and JSON. */
158
+ readonly visiblePlugins?: readonly (string | ResultRendererPlugin)[];
129
159
  readonly settings?: readonly SettingsPlugin[];
130
160
  readonly extensions?: readonly Extension[];
131
161
  readonly onQueryChange?: (query: string) => void;
@@ -140,7 +170,24 @@ export interface ForgeEditor extends EditorContext {
140
170
  getToolBar(): ToolbarApi;
141
171
  /** Registered renderers only; does not load their external visual libraries. */
142
172
  getRenderers(): readonly ResultRendererPlugin[];
173
+ showAvailablePlugins(): void;
174
+ hideAvailablePlugins(): void;
175
+ /** Pin a registered renderer without selecting it or changing its support predicate. */
176
+ showPlugin(plugin: string | ResultRendererPlugin): void;
177
+ /** Unpin a renderer; an active renderer remains visible until another is selected. */
178
+ hidePlugin(plugin: string | ResultRendererPlugin): void;
143
179
  getRendererWizard(): RendererWizardApi;
180
+ /** Share URL for the active query, including its selected renderer. Does not edit. */
181
+ getShareLink(): string;
182
+ /** Copy the share URL and persist its renderer header as one undoable edit. */
183
+ copyShareLink(): Promise<string>;
184
+ getThemeMainColor(): string | undefined;
185
+ /** Undefined restores the default theme. */
186
+ setThemeMainColor(color?: string): void;
187
+ getEditorRows(): number;
188
+ setEditorRows(rows: number): void;
189
+ isAutoGrowEnabled(): boolean;
190
+ setAutoGrow(enabled: boolean): void;
144
191
  getFontSize(): number;
145
192
  setFontSize(size: number): void;
146
193
  isLoadingIndicatorEnabled(): boolean;
@@ -204,8 +251,13 @@ export function createEditor(
204
251
  container: HTMLElement,
205
252
  options: EditorOptions,
206
253
  ): ForgeEditor {
254
+ let themeMainColor = options.themeMainColor;
255
+ let tokens = themeTokens(themeMainColor);
207
256
  let fontSize = options.fontSize ?? DEFAULT_FONT_SIZE;
208
257
  validateFontSize(fontSize);
258
+ let editorRows = options.editorRows ?? DEFAULT_EDITOR_ROWS;
259
+ validateEditorRows(editorRows);
260
+ let autoGrow = options.autoGrow ?? true;
209
261
  const controls = resolveControls(options.controls);
210
262
  let loadingIndicatorEnabled = controls.loadingIndicator;
211
263
  const buttons = new PluginRegistry(
@@ -216,6 +268,16 @@ export function createEditor(
216
268
  ),
217
269
  );
218
270
  const renderers = new PluginRegistry(options.renderers);
271
+ let availablePluginsVisible = options.availablePlugins ?? true;
272
+ function registeredPluginId(plugin: string | ResultRendererPlugin): string {
273
+ const id = typeof plugin === 'string' ? plugin : plugin.id;
274
+ if (!renderers.list().some((renderer) => renderer.id === id))
275
+ throw new TypeError(`Unknown result renderer: ${id}`);
276
+ return id;
277
+ }
278
+ const visiblePlugins = new Set(
279
+ options.visiblePlugins?.map(registeredPluginId) ?? ['table', 'json'],
280
+ );
219
281
  const settings = new PluginRegistry(options.settings);
220
282
  const catalog = namespaceCatalog(options.sparql ?? {});
221
283
  const settingsCleanups: (() => void)[] = [];
@@ -234,6 +296,7 @@ export function createEditor(
234
296
  const doc = container.ownerDocument;
235
297
  const root = doc.createElement('section');
236
298
  root.className = 'ldforge';
299
+ applyTheme(root, {}, tokens);
237
300
  root.setAttribute('aria-label', 'SPARQL editor');
238
301
  const toolbar = doc.createElement('div');
239
302
  toolbar.className = 'ldforge-toolbar';
@@ -253,6 +316,8 @@ export function createEditor(
253
316
  tabBar.hidden = !controls.tabs;
254
317
  const editorHost = doc.createElement('div');
255
318
  editorHost.className = 'ldforge-code';
319
+ editorHost.dataset.autoGrow = String(autoGrow);
320
+ editorHost.style.setProperty('--ldforge-query-rows', String(editorRows));
256
321
  editorHost.style.setProperty('--ldforge-query-font-size', `${fontSize}px`);
257
322
  editorHost.id = `ldforge-query-${settingsPanelNumber + 1}`;
258
323
  editorHost.setAttribute('role', 'tabpanel');
@@ -263,6 +328,20 @@ export function createEditor(
263
328
  status.setAttribute('aria-live', 'polite');
264
329
  const resultToolbar = doc.createElement('div');
265
330
  resultToolbar.className = 'ldforge-result-toolbar';
331
+ const rendererWarning = doc.createElement('div');
332
+ rendererWarning.className = 'ldforge-renderer-warning';
333
+ rendererWarning.setAttribute('role', 'status');
334
+ rendererWarning.hidden = true;
335
+ appendIcon(
336
+ rendererWarning,
337
+ createSvgIcon(['M12 3a9 9 0 1 0 0 18 9 9 0 0 0 0-18', 'M12 7v6m0 3v.01']),
338
+ );
339
+ const rendererWarningText = doc.createElement('span');
340
+ rendererWarning.append(rendererWarningText);
341
+ const rendererInfo = doc.createElement('section');
342
+ rendererInfo.className = 'ldforge-renderer-info';
343
+ rendererInfo.id = `${editorHost.id}-renderer-info`;
344
+ rendererInfo.hidden = true;
266
345
  const resultTabs = doc.createElement('div');
267
346
  resultTabs.className = 'ldforge-result-tabs';
268
347
  resultTabs.setAttribute('role', 'tablist');
@@ -332,13 +411,34 @@ export function createEditor(
332
411
  );
333
412
  fontSizeControl.element.hidden = !controls.fontSize;
334
413
  settingsPanel.append(fontSizeControl.element);
414
+ const autoGrowControl = createAutoGrowControl(
415
+ doc,
416
+ () => autoGrow,
417
+ () => locale,
418
+ (enabled) => context.setAutoGrow(enabled),
419
+ );
420
+ autoGrowControl.element.hidden = !controls.autoGrow;
421
+ settingsPanel.append(autoGrowControl.element);
422
+ const editorResize = createEditorResize({
423
+ editor: editorHost,
424
+ getRows: () => editorRows,
425
+ getLocale: () => locale,
426
+ resize(rows) {
427
+ context.setAutoGrow(false);
428
+ context.setEditorRows(rows);
429
+ },
430
+ });
431
+ editorResize.element.hidden = !controls.resizeEditor;
335
432
  const toggle = doc.createElement('button');
336
433
  root.append(
337
434
  toolbar,
338
435
  settingsPanel,
339
436
  tabBar,
340
437
  editorHost,
438
+ editorResize.element,
341
439
  resultToolbar,
440
+ rendererWarning,
441
+ rendererInfo,
342
442
  output,
343
443
  );
344
444
  container.append(root);
@@ -350,6 +450,20 @@ export function createEditor(
350
450
  let executedDirectives = parseQueryViewDirectives('');
351
451
  let applyPreferredView = false;
352
452
 
453
+ function sharingQuery(): string {
454
+ const query = context.getQuery();
455
+ const declared = parseQueryViewDirectives(query).view;
456
+ const rendererId =
457
+ controller.state.status === 'success'
458
+ ? selectedRenderer
459
+ : (declared ?? renderers.list()[0]?.id);
460
+ const endpoint =
461
+ typeof options.shareEndpoint === 'function'
462
+ ? options.shareEndpoint()
463
+ : options.shareEndpoint;
464
+ return queryWithEndpoint(queryWithRenderer(query, rendererId), endpoint);
465
+ }
466
+
353
467
  function assertAlive(): void {
354
468
  if (disposed) throw new Error('Editor has been destroyed.');
355
469
  }
@@ -368,6 +482,45 @@ export function createEditor(
368
482
  context.setPrefixesCollapsed(!context.arePrefixesCollapsed());
369
483
  return context.arePrefixesCollapsed();
370
484
  },
485
+ getThemeMainColor() {
486
+ assertAlive();
487
+ return themeMainColor;
488
+ },
489
+ setThemeMainColor(color) {
490
+ assertAlive();
491
+ const next = themeTokens(color);
492
+ applyTheme(root, tokens, next);
493
+ tokens = next;
494
+ themeMainColor = color;
495
+ },
496
+ getEditorRows() {
497
+ assertAlive();
498
+ return editorRows;
499
+ },
500
+ setEditorRows(rows) {
501
+ assertAlive();
502
+ validateEditorRows(rows);
503
+ if (rows === editorRows) return;
504
+ editorRows = rows;
505
+ editorHost.style.setProperty('--ldforge-query-rows', String(rows));
506
+ editorResize.refresh();
507
+ view.requestMeasure();
508
+ options.onEditorRowsChange?.(rows);
509
+ },
510
+ isAutoGrowEnabled() {
511
+ assertAlive();
512
+ return autoGrow;
513
+ },
514
+ setAutoGrow(enabled) {
515
+ assertAlive();
516
+ if (enabled === autoGrow) return;
517
+ autoGrow = enabled;
518
+ editorHost.dataset.autoGrow = String(enabled);
519
+ autoGrowControl.refresh();
520
+ editorResize.refresh();
521
+ view.requestMeasure();
522
+ options.onAutoGrowChange?.(enabled);
523
+ },
371
524
  getFontSize() {
372
525
  assertAlive();
373
526
  return fontSize;
@@ -379,6 +532,7 @@ export function createEditor(
379
532
  fontSize = size;
380
533
  editorHost.style.setProperty('--ldforge-query-font-size', `${size}px`);
381
534
  fontSizeControl.refresh();
535
+ editorResize.refresh();
382
536
  view.requestMeasure();
383
537
  options.onFontSizeChange?.(size);
384
538
  },
@@ -395,10 +549,63 @@ export function createEditor(
395
549
  assertAlive();
396
550
  return renderers.list();
397
551
  },
552
+ showAvailablePlugins() {
553
+ assertAlive();
554
+ availablePluginsVisible = true;
555
+ refreshPluginPicker();
556
+ },
557
+ hideAvailablePlugins() {
558
+ assertAlive();
559
+ availablePluginsVisible = false;
560
+ refreshPluginPicker();
561
+ },
562
+ showPlugin(plugin) {
563
+ assertAlive();
564
+ visiblePlugins.add(registeredPluginId(plugin));
565
+ refreshPluginPicker();
566
+ },
567
+ hidePlugin(plugin) {
568
+ assertAlive();
569
+ visiblePlugins.delete(registeredPluginId(plugin));
570
+ refreshPluginPicker();
571
+ },
398
572
  getRendererWizard() {
399
573
  assertAlive();
400
574
  return rendererWizard.api;
401
575
  },
576
+ getShareLink() {
577
+ assertAlive();
578
+ return createShareLink(
579
+ options.shareBaseUrl ?? doc.location.href,
580
+ sharingQuery(),
581
+ );
582
+ },
583
+ async copyShareLink() {
584
+ assertAlive();
585
+ const original = context.getQuery();
586
+ const tabId = queryTabs.snapshot().activeId;
587
+ const query = sharingQuery();
588
+ const link = createShareLink(
589
+ options.shareBaseUrl ?? doc.location.href,
590
+ query,
591
+ );
592
+ const clipboard = doc.defaultView?.navigator.clipboard;
593
+ if (!clipboard)
594
+ throw new Error(
595
+ locale === 'nl'
596
+ ? 'Klembord is niet beschikbaar.'
597
+ : 'Clipboard is not available.',
598
+ );
599
+ await clipboard.writeText(link);
600
+ if (
601
+ !disposed &&
602
+ tabId === queryTabs.snapshot().activeId &&
603
+ context.getQuery() === original &&
604
+ query !== original
605
+ )
606
+ context.setQuery(query);
607
+ return link;
608
+ },
402
609
  getToolBar() {
403
610
  assertAlive();
404
611
  return toolbarView.api;
@@ -409,6 +616,9 @@ export function createEditor(
409
616
  },
410
617
  formatQuery: (formatOptions) =>
411
618
  tabApi.collection.getActive().formatQuery(formatOptions),
619
+ getPrefixes: () => tabApi.collection.getActive().getPrefixes(),
620
+ removePrefix: (prefix) =>
621
+ tabApi.collection.getActive().removePrefix(prefix),
412
622
  addPrefix: (prefix, namespace) =>
413
623
  tabApi.collection.getActive().addPrefix(prefix, namespace),
414
624
  getWorkspace: () => queryTabs.snapshot(),
@@ -440,7 +650,10 @@ export function createEditor(
440
650
  cancel: () => controller.cancel(),
441
651
  focus: () => view.focus(),
442
652
  destroy() {
653
+ doc.removeEventListener('pointerdown', dismissRendererPicker);
443
654
  if (disposed) return;
655
+ editorResize.destroy();
656
+ shareControl.destroy();
444
657
  rendererWizard.destroy();
445
658
  toolbarView.destroy();
446
659
  disposed = true;
@@ -544,9 +757,14 @@ export function createEditor(
544
757
  warn:
545
758
  options.onWarning ??
546
759
  ((warning) => console.warn(`[LDForge] ${warning.message}`)),
547
- setQuery(id, query) {
548
- if (queryTabs.snapshot().activeId === id) context.setQuery(query);
549
- else {
760
+ setQuery(id, query, changes) {
761
+ if (queryTabs.snapshot().activeId === id) {
762
+ if (changes) {
763
+ // Map cursor/selection through the prefix edits instead of replacing
764
+ // the entire document and mapping every position to its end.
765
+ view.dispatch({ changes, annotations: isolateHistory.of('full') });
766
+ } else context.setQuery(query);
767
+ } else {
550
768
  queryTabs.update(query, id);
551
769
  notifyWorkspace();
552
770
  }
@@ -671,6 +889,17 @@ export function createEditor(
671
889
  toggle.setAttribute('aria-expanded', 'false');
672
890
  },
673
891
  });
892
+ const shareControl = createShareControl({
893
+ tools,
894
+ visible: controls.share,
895
+ getLocale: () => locale,
896
+ copy: () => context.copyShareLink(),
897
+ onError(error) {
898
+ status.textContent = translate(locale, 'actionFailed', {
899
+ message: error instanceof Error ? error.message : String(error),
900
+ });
901
+ },
902
+ });
674
903
  root.insertBefore(prefixPicker.panel, tabBar);
675
904
 
676
905
  function refreshButtons(): void {
@@ -688,12 +917,183 @@ export function createEditor(
688
917
  else loadingIndicator.remove();
689
918
  }
690
919
 
920
+ function refreshPluginPicker(): void {
921
+ const state = controller.state;
922
+ if (state.status !== 'success') return;
923
+ const available = renderers
924
+ .list()
925
+ .filter((plugin) => plugin.supports(state.result));
926
+ renderPluginPicker(
927
+ available,
928
+ available.find((plugin) => plugin.id === selectedRenderer) ??
929
+ available[0],
930
+ );
931
+ }
932
+
933
+ function renderPluginPicker(
934
+ available: readonly ResultRendererPlugin[],
935
+ renderer: ResultRendererPlugin | undefined,
936
+ ): void {
937
+ resultTabs.replaceChildren();
938
+ rendererInfo.hidden = true;
939
+ rendererInfo.replaceChildren();
940
+ resultTabs.hidden = renderers.list().length === 0;
941
+ const picker = doc.createElement('details');
942
+ picker.className = 'ldforge-renderer-picker';
943
+ const pickerToggle = doc.createElement('summary');
944
+ pickerToggle.textContent = translate(locale, 'rendererChoose');
945
+ appendIcon(
946
+ pickerToggle,
947
+ createSvgIcon(['M3 3h7v7H3zM14 3h7v7h-7zM3 14h7v7H3zM14 14h7v7h-7z']),
948
+ );
949
+ pickerToggle.setAttribute(
950
+ 'aria-label',
951
+ translate(locale, 'rendererChoose'),
952
+ );
953
+ const chevron = createSvgIcon(['m6 9 6 6 6-6'])(doc);
954
+ chevron.setAttribute('aria-hidden', 'true');
955
+ pickerToggle.append(chevron);
956
+ const pickerOptions = doc.createElement('div');
957
+ pickerOptions.className = 'ldforge-renderer-picker-options';
958
+ picker.append(pickerToggle, pickerOptions);
959
+ pickerToggle.addEventListener('keydown', (event) => {
960
+ if (event.key !== 'ArrowDown' && event.key !== 'ArrowUp') return;
961
+ event.preventDefault();
962
+ picker.open = true;
963
+ const choices = pickerOptions.querySelectorAll<HTMLButtonElement>(
964
+ 'button:not(:disabled)',
965
+ );
966
+ (event.key === 'ArrowDown'
967
+ ? choices[0]
968
+ : choices[choices.length - 1]
969
+ )?.focus();
970
+ });
971
+ pickerOptions.addEventListener('keydown', (event) => {
972
+ if (!['ArrowDown', 'ArrowUp', 'Home', 'End'].includes(event.key)) return;
973
+ event.preventDefault();
974
+ event.stopPropagation();
975
+ const choices = [
976
+ ...pickerOptions.querySelectorAll<HTMLButtonElement>(
977
+ 'button:not(:disabled)',
978
+ ),
979
+ ];
980
+ const current = choices.indexOf(doc.activeElement as HTMLButtonElement);
981
+ const next =
982
+ event.key === 'Home'
983
+ ? 0
984
+ : event.key === 'End'
985
+ ? choices.length - 1
986
+ : (current +
987
+ (event.key === 'ArrowDown' ? 1 : -1) +
988
+ choices.length) %
989
+ choices.length;
990
+ choices[next]?.focus();
991
+ });
992
+
993
+ picker.addEventListener('keydown', (event) => {
994
+ if (event.key === 'Escape') {
995
+ event.preventDefault();
996
+ picker.open = false;
997
+ pickerToggle.focus();
998
+ }
999
+ });
1000
+ picker.addEventListener('focusout', (event) => {
1001
+ if (event.relatedTarget && !picker.contains(event.relatedTarget as Node))
1002
+ picker.open = false;
1003
+ });
1004
+ resultTabs.append(picker);
1005
+ for (const [index, plugin] of renderers.list().entries()) {
1006
+ const tab = doc.createElement('button');
1007
+ tab.type = 'button';
1008
+ tab.disabled = !available.includes(plugin);
1009
+ tab.setAttribute('aria-disabled', String(tab.disabled));
1010
+ tab.id = `${output.id}-tab-${index}`;
1011
+ tab.dataset.rendererId = plugin.id;
1012
+ tab.setAttribute('role', 'tab');
1013
+ tab.setAttribute('aria-controls', output.id);
1014
+ const selected = plugin === renderer;
1015
+ tab.setAttribute('aria-selected', String(selected));
1016
+ tab.tabIndex = 0;
1017
+ tab.textContent = localize(plugin.label, locale);
1018
+ appendIcon(tab, plugin.icon);
1019
+ if (selected) output.setAttribute('aria-labelledby', tab.id);
1020
+ tab.addEventListener('click', () => {
1021
+ if (selectedRenderer === plugin.id) return;
1022
+ selectedRenderer = plugin.id;
1023
+ renderResult();
1024
+ resultTabs
1025
+ .querySelector<HTMLButtonElement>('[aria-selected="true"]')
1026
+ ?.focus();
1027
+ });
1028
+ const info = doc.createElement('button');
1029
+ info.type = 'button';
1030
+ info.className = 'ldforge-renderer-info-toggle';
1031
+ info.dataset.rendererInfo = plugin.id;
1032
+ info.setAttribute('aria-controls', rendererInfo.id);
1033
+ info.setAttribute('aria-expanded', 'false');
1034
+ const infoLabel = translate(locale, 'rendererBindingContract', {
1035
+ renderer: localize(plugin.label, locale),
1036
+ });
1037
+ info.setAttribute('aria-label', infoLabel);
1038
+ info.title = infoLabel;
1039
+ appendIcon(
1040
+ info,
1041
+ createSvgIcon([
1042
+ 'M12 3a9 9 0 1 0 0 18 9 9 0 0 0 0-18',
1043
+ 'M12 11v6m0-10v.01',
1044
+ ]),
1045
+ );
1046
+ const closeInfo = () => {
1047
+ rendererInfo.hidden = true;
1048
+ info.setAttribute('aria-expanded', 'false');
1049
+ pickerToggle.focus();
1050
+ };
1051
+ info.addEventListener('click', () => {
1052
+ const opening = info.getAttribute('aria-expanded') !== 'true';
1053
+ picker.open = false;
1054
+ resultTabs
1055
+ .querySelectorAll('[data-renderer-info]')
1056
+ .forEach((button) => button.setAttribute('aria-expanded', 'false'));
1057
+ rendererInfo.hidden = !opening;
1058
+ if (opening) {
1059
+ info.setAttribute('aria-expanded', 'true');
1060
+ rendererInfo.setAttribute('aria-label', infoLabel);
1061
+ renderRendererInfo(rendererInfo, plugin, locale, closeInfo);
1062
+ rendererInfo.querySelector<HTMLButtonElement>('button')?.focus();
1063
+ rendererInfo.onkeydown = (event) => {
1064
+ if (event.key === 'Escape') {
1065
+ event.preventDefault();
1066
+ closeInfo();
1067
+ }
1068
+ };
1069
+ }
1070
+ });
1071
+ const item = doc.createElement('div');
1072
+ item.className = 'ldforge-result-tab-item';
1073
+ item.setAttribute('role', 'presentation');
1074
+ if (selected || visiblePlugins.has(plugin.id)) {
1075
+ if (selected) item.classList.add('ldforge-result-tab-active');
1076
+ item.append(tab);
1077
+ resultTabs.insertBefore(item, picker);
1078
+ } else {
1079
+ item.append(tab, info);
1080
+ pickerOptions.append(item);
1081
+ }
1082
+ }
1083
+ picker.hidden =
1084
+ !availablePluginsVisible || pickerOptions.childElementCount === 0;
1085
+ }
1086
+
691
1087
  function renderResult(): void {
692
1088
  const previousCleanup = cleanup;
693
1089
  cleanup = undefined;
694
1090
  try {
695
1091
  previousCleanup?.();
696
1092
  output.replaceChildren();
1093
+ rendererWarning.hidden = true;
1094
+ rendererWarningText.textContent = '';
1095
+ rendererInfo.hidden = true;
1096
+ rendererInfo.replaceChildren();
697
1097
  resultTabs.replaceChildren();
698
1098
  resultTabs.hidden = true;
699
1099
  rendererDocs.hidden = true;
@@ -709,6 +1109,41 @@ export function createEditor(
709
1109
  const available = renderers
710
1110
  .list()
711
1111
  .filter((renderer) => renderer.supports(state.result));
1112
+ const requestedView = executedDirectives.view;
1113
+ if (
1114
+ requestedView &&
1115
+ !available.some((plugin) => plugin.id === requestedView)
1116
+ ) {
1117
+ const requested = renderers
1118
+ .list()
1119
+ .find((plugin) => plugin.id === requestedView);
1120
+ const missing =
1121
+ requested?.wizard?.bindings.filter(
1122
+ (binding) =>
1123
+ binding.required &&
1124
+ (state.result.kind !== 'bindings' ||
1125
+ !state.result.variables.includes(binding.variable)),
1126
+ ) ?? [];
1127
+ rendererWarningText.textContent = translate(
1128
+ locale,
1129
+ requested ? 'rendererUnsupported' : 'rendererUnavailable',
1130
+ {
1131
+ renderer: requested
1132
+ ? localize(requested.label, locale)
1133
+ : requestedView,
1134
+ },
1135
+ );
1136
+ if (missing.length) {
1137
+ rendererWarningText.textContent +=
1138
+ ' ' +
1139
+ translate(locale, 'rendererMissingBindings', {
1140
+ bindings: missing
1141
+ .map((binding) => `?${binding.variable}`)
1142
+ .join(', '),
1143
+ });
1144
+ }
1145
+ rendererWarning.hidden = false;
1146
+ }
712
1147
  if (applyPreferredView) {
713
1148
  if (available.some((plugin) => plugin.id === executedDirectives.view))
714
1149
  selectedRenderer = executedDirectives.view;
@@ -717,30 +1152,7 @@ export function createEditor(
717
1152
  const renderer =
718
1153
  available.find((plugin) => plugin.id === selectedRenderer) ??
719
1154
  available[0];
720
- resultTabs.hidden = available.length === 0;
721
- for (const [index, plugin] of available.entries()) {
722
- const tab = doc.createElement('button');
723
- tab.type = 'button';
724
- tab.id = `${output.id}-tab-${index}`;
725
- tab.dataset.rendererId = plugin.id;
726
- tab.setAttribute('role', 'tab');
727
- tab.setAttribute('aria-controls', output.id);
728
- const selected = plugin === renderer;
729
- tab.setAttribute('aria-selected', String(selected));
730
- tab.tabIndex = selected ? 0 : -1;
731
- tab.textContent = localize(plugin.label, locale);
732
- appendIcon(tab, plugin.icon);
733
- if (selected) output.setAttribute('aria-labelledby', tab.id);
734
- tab.addEventListener('click', () => {
735
- if (selectedRenderer === plugin.id) return;
736
- selectedRenderer = plugin.id;
737
- renderResult();
738
- resultTabs
739
- .querySelector<HTMLButtonElement>('[aria-selected="true"]')
740
- ?.focus();
741
- });
742
- resultTabs.append(tab);
743
- }
1155
+ renderPluginPicker(available, renderer);
744
1156
  if (!renderer) {
745
1157
  output.textContent = translate(locale, 'noRenderer');
746
1158
  return;
@@ -775,11 +1187,23 @@ export function createEditor(
775
1187
  }
776
1188
  }
777
1189
 
1190
+ doc.addEventListener('pointerdown', dismissRendererPicker);
1191
+ function dismissRendererPicker(event: Event): void {
1192
+ const picker =
1193
+ resultTabs.querySelector<HTMLDetailsElement>('details[open]');
1194
+ if (picker && !picker.contains(event.target as Node)) picker.open = false;
1195
+ }
1196
+
778
1197
  resultTabs.addEventListener('keydown', (event) => {
779
1198
  if (!['ArrowLeft', 'ArrowRight', 'Home', 'End'].includes(event.key)) return;
780
1199
  const tabs = [
781
- ...resultTabs.querySelectorAll<HTMLButtonElement>('[role="tab"]'),
782
- ];
1200
+ ...resultTabs.querySelectorAll<HTMLButtonElement>(
1201
+ '[role="tab"]:not(:disabled)',
1202
+ ),
1203
+ ].filter((tab) => {
1204
+ const picker = tab.closest('details');
1205
+ return !picker || picker.open;
1206
+ });
783
1207
  const current = tabs.indexOf(doc.activeElement as HTMLButtonElement);
784
1208
  if (current < 0) return;
785
1209
  event.preventDefault();
@@ -909,7 +1333,7 @@ export function createEditor(
909
1333
  tab.setAttribute('aria-selected', String(selected));
910
1334
  if (tab.parentElement)
911
1335
  tab.parentElement.dataset.active = String(selected);
912
- tab.tabIndex = selected ? 0 : -1;
1336
+ tab.tabIndex = 0;
913
1337
  if (selected) editorHost.setAttribute('aria-labelledby', tab.id);
914
1338
  }
915
1339
  }
@@ -918,8 +1342,11 @@ export function createEditor(
918
1342
  }
919
1343
 
920
1344
  function refreshLocale(): void {
1345
+ editorResize.refresh();
1346
+ autoGrowControl.refresh();
921
1347
  fontSizeControl.refresh();
922
1348
  rendererWizard.refreshLocale();
1349
+ shareControl.refreshLocale();
923
1350
  prefixPicker.refreshLocale();
924
1351
  tools.setAttribute('aria-label', translate(locale, 'coreTools'));
925
1352
  customActions.setAttribute('aria-label', translate(locale, 'extraActions'));