@eclipse-docks/extension-canvas 0.8.0 → 0.8.2

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.
@@ -1,3 +1,4 @@
1
+ import { PreviewShot } from './preview-image';
1
2
  export interface ActiveCanvas {
2
3
  kind: 'workspace' | 'registered';
3
4
  canvasName?: string;
@@ -6,8 +7,11 @@ export interface ActiveCanvas {
6
7
  getFilePath?: () => string | null;
7
8
  setSource?: (source: string) => void;
8
9
  reload?: () => Promise<string>;
10
+ capturePreview?: () => Promise<PreviewShot>;
9
11
  getState?: (key: string) => unknown;
10
12
  setState?: (key: string, value: unknown) => void;
11
13
  }
12
14
  export declare function readActiveCanvas(): ActiveCanvas | null;
15
+ /** Active canvas editor, or any open canvas part when focus has moved elsewhere. */
16
+ export declare function findOpenCanvas(): ActiveCanvas | null;
13
17
  //# sourceMappingURL=active-canvas.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"active-canvas.d.ts","sourceRoot":"","sources":["../src/active-canvas.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IACzB,IAAI,EAAE,WAAW,GAAG,YAAY,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IACjC,WAAW,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IAClC,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,MAAM,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/B,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IACpC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACpD;AAED,wBAAgB,gBAAgB,IAAI,YAAY,GAAG,IAAI,CAgBtD"}
1
+ {"version":3,"file":"active-canvas.d.ts","sourceRoot":"","sources":["../src/active-canvas.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAInD,MAAM,WAAW,YAAY;IACzB,IAAI,EAAE,WAAW,GAAG,YAAY,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IACjC,WAAW,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IAClC,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,MAAM,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/B,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC;IAC5C,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IACpC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACpD;AAED,wBAAgB,gBAAgB,IAAI,YAAY,GAAG,IAAI,CAEtD;AAED,oFAAoF;AACpF,wBAAgB,cAAc,IAAI,YAAY,GAAG,IAAI,CAQpD"}
@@ -1,7 +1,19 @@
1
1
  import { activeEditorSignal } from "@eclipse-docks/core";
2
2
  //#region src/active-canvas.ts
3
3
  function readActiveCanvas() {
4
- const active = activeEditorSignal.get();
4
+ return fromElement(activeEditorSignal.get());
5
+ }
6
+ /** Active canvas editor, or any open canvas part when focus has moved elsewhere. */
7
+ function findOpenCanvas() {
8
+ const active = readActiveCanvas();
9
+ if (active?.capturePreview) return active;
10
+ for (const node of document.querySelectorAll("docks-canvas-editor, docks-canvas-surface")) {
11
+ const mapped = fromElement(node);
12
+ if (mapped?.capturePreview) return mapped;
13
+ }
14
+ return active;
15
+ }
16
+ function fromElement(active) {
5
17
  if (!active) return null;
6
18
  const localName = active.localName;
7
19
  if (localName !== "docks-canvas-editor" && localName !== "docks-canvas-surface") return null;
@@ -13,11 +25,12 @@ function readActiveCanvas() {
13
25
  getFilePath: active.getFilePath?.bind(active),
14
26
  setSource: active.setSource?.bind(active),
15
27
  reload: active.reload?.bind(active),
28
+ capturePreview: active.capturePreview?.bind(active),
16
29
  getState: active.getState?.bind(active),
17
30
  setState: active.setState?.bind(active)
18
31
  };
19
32
  }
20
33
  //#endregion
21
- export { readActiveCanvas };
34
+ export { findOpenCanvas, readActiveCanvas };
22
35
 
23
36
  //# sourceMappingURL=active-canvas.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"active-canvas.js","names":[],"sources":["../src/active-canvas.ts"],"sourcesContent":["import { activeEditorSignal } from '@eclipse-docks/core';\n\nexport interface ActiveCanvas {\n kind: 'workspace' | 'registered';\n canvasName?: string;\n editor: boolean;\n getContent?: () => string | null;\n getFilePath?: () => string | null;\n setSource?: (source: string) => void;\n reload?: () => Promise<string>;\n getState?: (key: string) => unknown;\n setState?: (key: string, value: unknown) => void;\n}\n\nexport function readActiveCanvas(): ActiveCanvas | null {\n const active = activeEditorSignal.get() as unknown as (ActiveCanvas & { localName?: string }) | null;\n if (!active) return null;\n const localName = active.localName;\n if (localName !== 'docks-canvas-editor' && localName !== 'docks-canvas-surface') return null;\n return {\n kind: active.kind === 'registered' ? 'registered' : 'workspace',\n canvasName: active.canvasName,\n editor: localName === 'docks-canvas-editor',\n getContent: active.getContent?.bind(active),\n getFilePath: active.getFilePath?.bind(active),\n setSource: active.setSource?.bind(active),\n reload: active.reload?.bind(active),\n getState: active.getState?.bind(active),\n setState: active.setState?.bind(active),\n };\n}\n"],"mappings":";;AAcA,SAAgB,mBAAwC;CACpD,MAAM,SAAS,mBAAmB,IAAI;CACtC,IAAI,CAAC,QAAQ,OAAO;CACpB,MAAM,YAAY,OAAO;CACzB,IAAI,cAAc,yBAAyB,cAAc,wBAAwB,OAAO;CACxF,OAAO;EACH,MAAM,OAAO,SAAS,eAAe,eAAe;EACpD,YAAY,OAAO;EACnB,QAAQ,cAAc;EACtB,YAAY,OAAO,YAAY,KAAK,MAAM;EAC1C,aAAa,OAAO,aAAa,KAAK,MAAM;EAC5C,WAAW,OAAO,WAAW,KAAK,MAAM;EACxC,QAAQ,OAAO,QAAQ,KAAK,MAAM;EAClC,UAAU,OAAO,UAAU,KAAK,MAAM;EACtC,UAAU,OAAO,UAAU,KAAK,MAAM;CAC1C;AACJ"}
1
+ {"version":3,"file":"active-canvas.js","names":[],"sources":["../src/active-canvas.ts"],"sourcesContent":["import { activeEditorSignal } from '@eclipse-docks/core';\nimport type { PreviewShot } from './preview-image';\n\ntype CanvasElement = ActiveCanvas & { localName?: string };\n\nexport interface ActiveCanvas {\n kind: 'workspace' | 'registered';\n canvasName?: string;\n editor: boolean;\n getContent?: () => string | null;\n getFilePath?: () => string | null;\n setSource?: (source: string) => void;\n reload?: () => Promise<string>;\n capturePreview?: () => Promise<PreviewShot>;\n getState?: (key: string) => unknown;\n setState?: (key: string, value: unknown) => void;\n}\n\nexport function readActiveCanvas(): ActiveCanvas | null {\n return fromElement(activeEditorSignal.get() as unknown as CanvasElement | null);\n}\n\n/** Active canvas editor, or any open canvas part when focus has moved elsewhere. */\nexport function findOpenCanvas(): ActiveCanvas | null {\n const active = readActiveCanvas();\n if (active?.capturePreview) return active;\n for (const node of document.querySelectorAll('docks-canvas-editor, docks-canvas-surface')) {\n const mapped = fromElement(node as unknown as CanvasElement);\n if (mapped?.capturePreview) return mapped;\n }\n return active;\n}\n\nfunction fromElement(active: CanvasElement | null): ActiveCanvas | null {\n if (!active) return null;\n const localName = active.localName;\n if (localName !== 'docks-canvas-editor' && localName !== 'docks-canvas-surface') return null;\n return {\n kind: active.kind === 'registered' ? 'registered' : 'workspace',\n canvasName: active.canvasName,\n editor: localName === 'docks-canvas-editor',\n getContent: active.getContent?.bind(active),\n getFilePath: active.getFilePath?.bind(active),\n setSource: active.setSource?.bind(active),\n reload: active.reload?.bind(active),\n capturePreview: active.capturePreview?.bind(active),\n getState: active.getState?.bind(active),\n setState: active.setState?.bind(active),\n };\n}\n"],"mappings":";;AAkBA,SAAgB,mBAAwC;CACpD,OAAO,YAAY,mBAAmB,IAAI,CAAoC;AAClF;;AAGA,SAAgB,iBAAsC;CAClD,MAAM,SAAS,iBAAiB;CAChC,IAAI,QAAQ,gBAAgB,OAAO;CACnC,KAAK,MAAM,QAAQ,SAAS,iBAAiB,2CAA2C,GAAG;EACvF,MAAM,SAAS,YAAY,IAAgC;EAC3D,IAAI,QAAQ,gBAAgB,OAAO;CACvC;CACA,OAAO;AACX;AAEA,SAAS,YAAY,QAAmD;CACpE,IAAI,CAAC,QAAQ,OAAO;CACpB,MAAM,YAAY,OAAO;CACzB,IAAI,cAAc,yBAAyB,cAAc,wBAAwB,OAAO;CACxF,OAAO;EACH,MAAM,OAAO,SAAS,eAAe,eAAe;EACpD,YAAY,OAAO;EACnB,QAAQ,cAAc;EACtB,YAAY,OAAO,YAAY,KAAK,MAAM;EAC1C,aAAa,OAAO,aAAa,KAAK,MAAM;EAC5C,WAAW,OAAO,WAAW,KAAK,MAAM;EACxC,QAAQ,OAAO,QAAQ,KAAK,MAAM;EAClC,gBAAgB,OAAO,gBAAgB,KAAK,MAAM;EAClD,UAAU,OAAO,UAAU,KAAK,MAAM;EACtC,UAAU,OAAO,UAAU,KAAK,MAAM;CAC1C;AACJ"}
@@ -3,6 +3,7 @@ import { nothing, PropertyValues } from '@eclipse-docks/core/externals/lit';
3
3
  import { DocksMonacoWidget } from '@eclipse-docks/extension-monaco-editor/widget';
4
4
  import { CanvasHost } from './host';
5
5
  import { CanvasViewElement } from './mount';
6
+ import { PreviewShot } from './preview-image';
6
7
  export declare class DocksCanvasSurface extends DocksPart implements EditorContentProvider {
7
8
  input?: EditorInput;
8
9
  kind: 'workspace' | 'registered';
@@ -13,6 +14,7 @@ export declare class DocksCanvasSurface extends DocksPart implements EditorConte
13
14
  protected sourceText: string;
14
15
  protected mode: 'preview' | 'source';
15
16
  protected previewError?: string;
17
+ private attachingPreview;
16
18
  protected previewElement?: CanvasViewElement;
17
19
  protected widget?: DocksMonacoWidget;
18
20
  protected scrollMode: 'scroller' | 'native' | 'none';
@@ -39,12 +41,14 @@ export declare class DocksCanvasSurface extends DocksPart implements EditorConte
39
41
  getState(key: string): unknown;
40
42
  setState(key: string, value: unknown): void;
41
43
  setSource(source: string): void;
44
+ capturePreview(): Promise<PreviewShot>;
42
45
  reload(): Promise<string>;
43
46
  private replacePreview;
44
47
  private onDirty;
45
48
  protected updated(changed: PropertyValues): void;
46
49
  private onContentChange;
47
50
  private toggleMode;
51
+ private attachPreview;
48
52
  protected renderToolbar(): typeof nothing | import('lit-html').TemplateResult<1>;
49
53
  protected renderContent(): import('lit-html').TemplateResult<1>;
50
54
  static styles: import('lit').CSSResult;
@@ -1 +1 @@
1
- {"version":3,"file":"canvas-editor.d.ts","sourceRoot":"","sources":["../src/canvas-editor.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,SAAS,EAGT,KAAK,qBAAqB,EAC1B,KAAK,WAAW,EACnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAa,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAG5F,OAAO,+CAA+C,CAAC;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;AAGvF,OAAO,EAA0C,KAAK,UAAU,EAAE,MAAM,QAAQ,CAAC;AACjF,OAAO,EAAyC,KAAK,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAUxF,qBACa,kBAAmB,SAAQ,SAAU,YAAW,qBAAqB;IAC9C,KAAK,CAAC,EAAE,WAAW,CAAC;IACxC,IAAI,EAAE,WAAW,GAAG,YAAY,CAAe;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,SAAM;IACf,MAAM,SAAM;IACK,UAAU,UAAS;IAEvC,SAAS,CAAC,UAAU,SAAM;IAC1B,SAAS,CAAC,IAAI,EAAE,SAAS,GAAG,QAAQ,CAAa;IACjD,SAAS,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAChC,SAAS,CAAC,cAAc,CAAC,EAAE,iBAAiB,CAAC;IACxB,SAAS,CAAC,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAEnE,SAAS,CAAC,UAAU,EAAE,UAAU,GAAG,QAAQ,GAAG,MAAM,CAAU;IAC9D,SAAS,CAAC,IAAI,EAAE,UAAU,CAAoG;IAC9H,OAAO,CAAC,cAAc,CAAC,CAAa;IACpC,OAAO,CAAC,YAAY,CAAC,CAAqB;IAC1C,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,cAAc,CAAM;IAC5B,SAAS,CAAC,YAAY,UAAS;IAEtB,iBAAiB;IAKjB,oBAAoB;cAMb,QAAQ;IA8BxB,SAAS,CAAC,OAAO;IAOjB,UAAU,IAAI,MAAM,GAAG,IAAI;IAI3B,YAAY,IAAI,MAAM,GAAG,IAAI;IAI7B,UAAU,CAAC,KAAK,SAAI,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAIrE,WAAW,IAAI,MAAM,GAAG,IAAI;IAI5B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC,WAAW,IAAI,MAAM,GAAG,IAAI;IAM5B,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI9B,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAI3C,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAQzB,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAsD/B,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,OAAO,CAMb;IAEF,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,cAAc;IAKzC,OAAO,CAAC,eAAe,CAKrB;IAEF,OAAO,CAAC,UAAU;IAQlB,SAAS,CAAC,aAAa;IAYvB,SAAS,CAAC,aAAa;IAsBvB,MAAM,CAAC,MAAM,0BAaX;CACL;AAED,qBACa,iBAAkB,SAAQ,kBAAkB;IACtC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAOvC;AAED,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,qBAAqB;QAC3B,sBAAsB,EAAE,kBAAkB,CAAC;QAC3C,qBAAqB,EAAE,iBAAiB,CAAC;KAC5C;CACJ"}
1
+ {"version":3,"file":"canvas-editor.d.ts","sourceRoot":"","sources":["../src/canvas-editor.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,SAAS,EAGT,KAAK,qBAAqB,EAC1B,KAAK,WAAW,EACnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAa,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAG5F,OAAO,+CAA+C,CAAC;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;AAGvF,OAAO,EAA0C,KAAK,UAAU,EAAE,MAAM,QAAQ,CAAC;AACjF,OAAO,EAAyC,KAAK,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAExF,OAAO,EAAuC,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AASxF,qBACa,kBAAmB,SAAQ,SAAU,YAAW,qBAAqB;IAC9C,KAAK,CAAC,EAAE,WAAW,CAAC;IACxC,IAAI,EAAE,WAAW,GAAG,YAAY,CAAe;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,SAAM;IACf,MAAM,SAAM;IACK,UAAU,UAAS;IAEvC,SAAS,CAAC,UAAU,SAAM;IAC1B,SAAS,CAAC,IAAI,EAAE,SAAS,GAAG,QAAQ,CAAa;IACjD,SAAS,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAChC,OAAO,CAAC,gBAAgB,CAAS;IACjC,SAAS,CAAC,cAAc,CAAC,EAAE,iBAAiB,CAAC;IACxB,SAAS,CAAC,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAEnE,SAAS,CAAC,UAAU,EAAE,UAAU,GAAG,QAAQ,GAAG,MAAM,CAAU;IAC9D,SAAS,CAAC,IAAI,EAAE,UAAU,CAAoG;IAC9H,OAAO,CAAC,cAAc,CAAC,CAAa;IACpC,OAAO,CAAC,YAAY,CAAC,CAAqB;IAC1C,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,cAAc,CAAM;IAC5B,SAAS,CAAC,YAAY,UAAS;IAEtB,iBAAiB;IAKjB,oBAAoB;cAMb,QAAQ;IA8BxB,SAAS,CAAC,OAAO;IAOjB,UAAU,IAAI,MAAM,GAAG,IAAI;IAI3B,YAAY,IAAI,MAAM,GAAG,IAAI;IAI7B,UAAU,CAAC,KAAK,SAAI,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAIrE,WAAW,IAAI,MAAM,GAAG,IAAI;IAI5B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC,WAAW,IAAI,MAAM,GAAG,IAAI;IAM5B,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI9B,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAI3C,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAQzB,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC;IA4BtC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAsD/B,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,OAAO,CAMb;IAEF,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,cAAc;IAKzC,OAAO,CAAC,eAAe,CAKrB;IAEF,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,aAAa,CAmBnB;IAEF,SAAS,CAAC,aAAa;IAwBvB,SAAS,CAAC,aAAa;IAsBvB,MAAM,CAAC,MAAM,0BAsBX;CACL;AAED,qBACa,iBAAkB,SAAQ,kBAAkB;IACtC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAOvC;AAMD,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,qBAAqB;QAC3B,sBAAsB,EAAE,kBAAkB,CAAC;QAC3C,qBAAqB,EAAE,iBAAiB,CAAC;KAC5C;CACJ"}
@@ -1,3 +1,4 @@
1
+ import { attachPreviewShot, rasterizeElement } from "./preview-image.js";
1
2
  import { compileCanvas } from "./compile.js";
2
3
  import { createContributionHost, createFileHost } from "./host.js";
3
4
  import { elementFromConstructor, mountCompiled } from "./mount.js";
@@ -23,6 +24,7 @@ var DocksCanvasSurface = class DocksCanvasSurface extends DocksPart {
23
24
  this.showSource = false;
24
25
  this.sourceText = "";
25
26
  this.mode = "preview";
27
+ this.attachingPreview = false;
26
28
  this.scrollMode = "none";
27
29
  this.host = {
28
30
  getState: (_key, fallback) => fallback,
@@ -45,6 +47,26 @@ var DocksCanvasSurface = class DocksCanvasSurface extends DocksPart {
45
47
  this.sourceText = next;
46
48
  this.markDirty(true);
47
49
  };
50
+ this.attachPreview = async () => {
51
+ if (this.attachingPreview) return;
52
+ this.attachingPreview = true;
53
+ try {
54
+ const result = await attachPreviewShot(this);
55
+ if (typeof result === "string") {
56
+ this.showError(result);
57
+ return;
58
+ }
59
+ if (result.stored === false) {
60
+ this.showError(String(result.note ?? "Could not attach the preview"));
61
+ return;
62
+ }
63
+ this.showInfo("Attached preview");
64
+ } catch (err) {
65
+ this.showError(err instanceof Error ? err.message : String(err));
66
+ } finally {
67
+ this.attachingPreview = false;
68
+ }
69
+ };
48
70
  }
49
71
  connectedCallback() {
50
72
  super.connectedCallback();
@@ -127,6 +149,30 @@ var DocksCanvasSurface = class DocksCanvasSurface extends DocksPart {
127
149
  if (model && model.getValue() !== source) model.setValue(source);
128
150
  this.requestUpdate();
129
151
  }
152
+ async capturePreview() {
153
+ for (let attempt = 0; attempt < 30 && !this.ready; attempt++) await new Promise((resolve) => setTimeout(resolve, 50));
154
+ if (!this.ready) throw new Error("Canvas is still opening");
155
+ await this.reload();
156
+ await this.updateComplete;
157
+ const preview = this.renderRoot.querySelector(".canvas-preview");
158
+ if (!preview) throw new Error("Canvas preview is not rendered");
159
+ if (preview.classList.contains("canvas-hidden") || preview.getBoundingClientRect().width < 2) {
160
+ preview.classList.add("canvas-capture");
161
+ preview.style.width = `${this.clientWidth || 960}px`;
162
+ preview.style.height = `${this.clientHeight || 640}px`;
163
+ }
164
+ try {
165
+ await nextFrame();
166
+ await nextFrame();
167
+ const view = this.previewElement;
168
+ if (view?.updateComplete) await view.updateComplete;
169
+ return await rasterizeElement(preview);
170
+ } finally {
171
+ preview.classList.remove("canvas-capture");
172
+ preview.style.width = "";
173
+ preview.style.height = "";
174
+ }
175
+ }
130
176
  async reload() {
131
177
  const source = this.getContent() ?? "";
132
178
  if (this.previewElement && !this.previewStale && source === this.compiledSource && !this.previewError) return "ready";
@@ -200,13 +246,25 @@ var DocksCanvasSurface = class DocksCanvasSurface extends DocksPart {
200
246
  if (next === "preview" && (this.previewStale || !this.previewElement)) this.reload();
201
247
  }
202
248
  renderToolbar() {
203
- if (!this.ready || !this.showSource) return nothing;
249
+ if (!this.ready) return nothing;
204
250
  const toSource = this.mode === "preview";
205
251
  const label = toSource ? "Source" : "Preview";
206
252
  return html`
207
- <wa-button appearance="plain" size="s" title=${label} @click=${() => this.toggleMode()}>
208
- ${icon(toSource ? "code" : "eye", { slot: "start" })}
209
- ${label}
253
+ ${this.showSource ? html`
254
+ <wa-button appearance="plain" size="s" title=${label} @click=${() => this.toggleMode()}>
255
+ ${icon(toSource ? "code" : "eye", { slot: "start" })}
256
+ ${label}
257
+ </wa-button>
258
+ ` : nothing}
259
+ <wa-button
260
+ appearance="plain"
261
+ size="s"
262
+ title="Attach a screenshot of the preview"
263
+ ?loading=${this.attachingPreview}
264
+ ?disabled=${this.attachingPreview}
265
+ @click=${() => this.attachPreview()}>
266
+ ${icon("camera", { slot: "start" })}
267
+ Screenshot
210
268
  </wa-button>
211
269
  `;
212
270
  }
@@ -236,6 +294,15 @@ var DocksCanvasSurface = class DocksCanvasSurface extends DocksPart {
236
294
  :host { display: flex; flex-direction: column; height: 100%; min-height: 0; }
237
295
  .canvas-preview { display: flex; flex-direction: column; height: 100%; min-height: 0; overflow: hidden; }
238
296
  .canvas-preview.canvas-hidden, docks-monaco-widget.canvas-hidden { display: none; }
297
+ .canvas-preview.canvas-capture {
298
+ display: flex !important;
299
+ position: fixed;
300
+ left: 0;
301
+ top: 0;
302
+ z-index: 2147483000;
303
+ overflow: hidden;
304
+ background: var(--wa-color-surface-default, #fff);
305
+ }
239
306
  wa-scroller.canvas-scroll { flex: 1 1 0; min-height: 0; height: 100%; }
240
307
  .canvas-mount > * { display: block; }
241
308
  docks-monaco-widget { display: block; height: 100%; min-height: 0; }
@@ -257,6 +324,7 @@ __decorate([property({ type: Boolean })], DocksCanvasSurface.prototype, "showSou
257
324
  __decorate([state()], DocksCanvasSurface.prototype, "sourceText", void 0);
258
325
  __decorate([state()], DocksCanvasSurface.prototype, "mode", void 0);
259
326
  __decorate([state()], DocksCanvasSurface.prototype, "previewError", void 0);
327
+ __decorate([state()], DocksCanvasSurface.prototype, "attachingPreview", void 0);
260
328
  __decorate([state()], DocksCanvasSurface.prototype, "previewElement", void 0);
261
329
  __decorate([query("docks-monaco-widget")], DocksCanvasSurface.prototype, "widget", void 0);
262
330
  DocksCanvasSurface = __decorate([customElement("docks-canvas-surface")], DocksCanvasSurface);
@@ -270,6 +338,9 @@ var DocksCanvasEditor = class DocksCanvasEditor extends DocksCanvasSurface {
270
338
  }
271
339
  };
272
340
  DocksCanvasEditor = __decorate([customElement("docks-canvas-editor")], DocksCanvasEditor);
341
+ function nextFrame() {
342
+ return new Promise((resolve) => requestAnimationFrame(() => resolve()));
343
+ }
273
344
  //#endregion
274
345
  export { DocksCanvasEditor, DocksCanvasSurface };
275
346
 
@@ -1 +1 @@
1
- {"version":3,"file":"canvas-editor.js","names":["_decorate"],"sources":["../src/canvas-editor.ts"],"sourcesContent":["import {\n DocksPart,\n File,\n icon,\n type EditorContentProvider,\n type EditorInput,\n} from '@eclipse-docks/core';\nimport { css, html, nothing, type PropertyValues } from '@eclipse-docks/core/externals/lit';\nimport { customElement, property, query, state } from '@eclipse-docks/core/externals/lit';\nimport { Directive, directive } from 'lit/directive.js';\nimport '@eclipse-docks/extension-monaco-editor/widget';\nimport type { DocksMonacoWidget } from '@eclipse-docks/extension-monaco-editor/widget';\nimport type { CanvasContribution } from './contribution';\nimport { compileCanvas } from './compile';\nimport { createContributionHost, createFileHost, type CanvasHost } from './host';\nimport { elementFromConstructor, mountCompiled, type CanvasViewElement } from './mount';\nimport { canvasBridges } from './bridges/urls';\nimport { readWorkspaceFile } from './workspace-file';\n\nconst heldNode = directive(class extends Directive {\n render(node?: Node) {\n return node ?? nothing;\n }\n});\n\n@customElement('docks-canvas-surface')\nexport class DocksCanvasSurface extends DocksPart implements EditorContentProvider {\n @property({ attribute: false }) input?: EditorInput;\n @property() kind: 'workspace' | 'registered' = 'workspace';\n @property() canvasName?: string;\n @property() entryPath = '';\n @property() source = '';\n @property({ type: Boolean }) showSource = false;\n\n @state() protected sourceText = '';\n @state() protected mode: 'preview' | 'source' = 'preview';\n @state() protected previewError?: string;\n @state() protected previewElement?: CanvasViewElement;\n @query('docks-monaco-widget') protected widget?: DocksMonacoWidget;\n\n protected scrollMode: 'scroller' | 'native' | 'none' = 'none';\n protected host: CanvasHost = { getState: (_key, fallback) => fallback, setState: () => undefined, openFile: () => undefined };\n private previewDispose?: () => void;\n private contribution?: CanvasContribution;\n private ready = false;\n private reloadGeneration = 0;\n private compiledSource = '';\n protected previewStale = false;\n\n override connectedCallback() {\n super.connectedCallback();\n this.addEventListener('dirty', this.onDirty);\n }\n\n override disconnectedCallback() {\n this.removeEventListener('dirty', this.onDirty);\n this.reloadGeneration++;\n super.disconnectedCallback();\n }\n\n protected async doInitUI() {\n const data = this.input?.data;\n if (data instanceof File) {\n this.kind = 'workspace';\n this.entryPath = data.getWorkspacePath();\n this.showSource = true;\n this.sourceText = String(await data.getContents() ?? '');\n this.host = await createFileHost(data);\n } else if (data && typeof data === 'object' && 'contribution' in data) {\n this.contribution = (data as { contribution: CanvasContribution }).contribution;\n this.kind = 'registered';\n this.canvasName = this.contribution.name;\n this.showSource = this.contribution.source !== undefined;\n if (typeof this.contribution.source === 'function') this.sourceText = await this.contribution.source();\n else this.sourceText = this.contribution.source ?? '';\n this.host = await createContributionHost(this.contribution);\n } else if (this.entryPath || this.source) {\n this.kind = 'workspace';\n this.showSource = false;\n this.sourceText = this.source;\n const workspaceFile = await readWorkspaceFile(this.entryPath);\n if (workspaceFile?.text !== undefined && !this.sourceText) this.sourceText = workspaceFile.text;\n this.host = { getState: (_key, fallback) => fallback, setState: () => undefined, openFile: () => undefined };\n }\n this.mode = this.input?.state?.mode === 'source' ? 'source' : 'preview';\n this.ready = true;\n this.requestUpdate();\n if (this.mode === 'preview' || !this.showSource) await this.reload();\n }\n\n protected doClose() {\n this.reloadGeneration++;\n this.previewDispose?.();\n this.previewDispose = undefined;\n this.widget?.dispose();\n }\n\n getContent(): string | null {\n return this.widget?.getContent() ?? this.sourceText;\n }\n\n getSelection(): string | null {\n return this.widget?.getSelection() ?? null;\n }\n\n getSnippet(lines = 5): { snippet: string; cursorLine: number } | null {\n return this.widget?.getSnippet(lines) ?? null;\n }\n\n getLanguage(): string | null {\n return 'javascript';\n }\n\n isLanguage(lang: string): boolean {\n return lang.toLowerCase() === 'javascript';\n }\n\n getFilePath(): string | null {\n const data = this.input?.data;\n if (data instanceof File) return data.getWorkspacePath();\n return this.entryPath || null;\n }\n\n getState(key: string): unknown {\n return this.host.getState(key);\n }\n\n setState(key: string, value: unknown): void {\n this.host.setState(key, value);\n }\n\n setSource(source: string): void {\n this.previewStale = source !== this.compiledSource;\n this.sourceText = source;\n const model = this.widget?.getModel();\n if (model && model.getValue() !== source) model.setValue(source);\n this.requestUpdate();\n }\n\n async reload(): Promise<string> {\n const source = this.getContent() ?? '';\n if (this.previewElement && !this.previewStale && source === this.compiledSource && !this.previewError) return 'ready';\n const generation = ++this.reloadGeneration;\n if (this.kind === 'registered' && this.contribution) {\n try {\n const mod = await this.contribution.load();\n if (generation !== this.reloadGeneration) return 'ready';\n const Ctor = mod.default;\n if (typeof Ctor !== 'function' || !(Ctor.prototype instanceof HTMLElement)) {\n this.previewError = 'Canvas default export must be an HTMLElement subclass';\n this.requestUpdate();\n return this.previewError;\n }\n const element = elementFromConstructor(Ctor);\n element.canvasHost = this.host;\n this.replacePreview(element);\n return 'ready';\n } catch (err) {\n if (generation !== this.reloadGeneration) return 'ready';\n this.previewError = err instanceof Error ? err.message : String(err);\n this.requestUpdate();\n return this.previewError;\n }\n }\n const compiled = await compileCanvas({\n entryPath: this.entryPath || 'canvas.js',\n entrySource: source,\n read: readWorkspaceFile,\n bridges: canvasBridges(),\n });\n if (generation !== this.reloadGeneration) return 'ready';\n if (!compiled.ok) {\n this.previewError = compiled.error;\n this.requestUpdate();\n return compiled.error;\n }\n const mounted = await mountCompiled(compiled.code);\n if (generation !== this.reloadGeneration) {\n if (mounted.ok) mounted.dispose();\n return 'ready';\n }\n if (!mounted.ok) {\n this.previewError = mounted.error;\n this.requestUpdate();\n return mounted.error;\n }\n mounted.element.canvasHost = this.host;\n this.compiledSource = source;\n this.previewStale = false;\n this.replacePreview(mounted.element, mounted.dispose);\n return 'ready';\n }\n\n private replacePreview(element: CanvasViewElement, dispose?: () => void) {\n const previous = this.previewDispose;\n this.previewDispose = dispose ?? (() => element.remove());\n this.previewElement = element;\n this.previewError = undefined;\n this.compiledSource = this.getContent() ?? this.compiledSource;\n this.previewStale = false;\n this.requestUpdate();\n previous?.();\n }\n\n private onDirty = (event: Event) => {\n if (!this.ready || (event as CustomEvent<boolean>).detail !== true) return;\n const source = this.getContent() ?? '';\n if (source === this.compiledSource && this.previewElement) return;\n this.previewStale = true;\n if (this.mode === 'preview' || !this.showSource) void this.reload();\n };\n\n protected updated(changed: PropertyValues) {\n super.updated(changed);\n if (this.mode === 'source') this.widget?.layout();\n }\n\n private onContentChange = () => {\n const next = this.widget?.getContent() ?? this.sourceText;\n this.previewStale = next !== this.compiledSource;\n this.sourceText = next;\n this.markDirty(true);\n };\n\n private toggleMode() {\n if (this.widget) this.sourceText = this.widget.getContent() ?? this.sourceText;\n const next = this.mode === 'preview' ? 'source' : 'preview';\n this.mode = next;\n if (this.input) this.input.state.mode = next;\n if (next === 'preview' && (this.previewStale || !this.previewElement)) void this.reload();\n }\n\n protected renderToolbar() {\n if (!this.ready || !this.showSource) return nothing;\n const toSource = this.mode === 'preview';\n const label = toSource ? 'Source' : 'Preview';\n return html`\n <wa-button appearance=\"plain\" size=\"s\" title=${label} @click=${() => this.toggleMode()}>\n ${icon(toSource ? 'code' : 'eye', { slot: 'start' })}\n ${label}\n </wa-button>\n `;\n }\n\n protected renderContent() {\n if (!this.ready) return html``;\n const showPreview = !this.showSource || this.mode === 'preview';\n return html`\n <div class=\"canvas-preview ${showPreview ? '' : 'canvas-hidden'}\">\n ${this.previewError ? html`<pre class=\"canvas-error\">${this.previewError}</pre>` : nothing}\n <wa-scroller class=\"canvas-scroll\" orientation=\"vertical\">\n <div class=\"canvas-mount\">${heldNode(this.previewElement)}</div>\n </wa-scroller>\n </div>\n ${this.showSource ? html`\n <docks-monaco-widget\n class=${this.mode === 'source' ? '' : 'canvas-hidden'}\n .value=${this.sourceText}\n .language=${'javascript'}\n .uri=${this.entryPath || this.canvasName || 'canvas.js'}\n @content-change=${this.onContentChange}>\n </docks-monaco-widget>\n ` : nothing}\n `;\n }\n\n static styles = css`\n :host { display: flex; flex-direction: column; height: 100%; min-height: 0; }\n .canvas-preview { display: flex; flex-direction: column; height: 100%; min-height: 0; overflow: hidden; }\n .canvas-preview.canvas-hidden, docks-monaco-widget.canvas-hidden { display: none; }\n wa-scroller.canvas-scroll { flex: 1 1 0; min-height: 0; height: 100%; }\n .canvas-mount > * { display: block; }\n docks-monaco-widget { display: block; height: 100%; min-height: 0; }\n .canvas-error {\n margin: 0;\n padding: var(--wa-space-s, 8px);\n white-space: pre-wrap;\n color: var(--wa-color-danger-on-quiet, #b42318);\n }\n `;\n}\n\n@customElement('docks-canvas-editor')\nexport class DocksCanvasEditor extends DocksCanvasSurface {\n override async save(): Promise<void> {\n const value = this.getContent() ?? '';\n const data = this.input?.data;\n if (data instanceof File) await data.saveContents(value);\n this.markDirty(false);\n if (this.mode === 'preview' && this.previewStale) await this.reload();\n }\n}\n\ndeclare global {\n interface HTMLElementTagNameMap {\n 'docks-canvas-surface': DocksCanvasSurface;\n 'docks-canvas-editor': DocksCanvasEditor;\n }\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"canvas-editor.js","names":["_decorate"],"sources":["../src/canvas-editor.ts"],"sourcesContent":["import {\n DocksPart,\n File,\n icon,\n type EditorContentProvider,\n type EditorInput,\n} from '@eclipse-docks/core';\nimport { css, html, nothing, type PropertyValues } from '@eclipse-docks/core/externals/lit';\nimport { customElement, property, query, state } from '@eclipse-docks/core/externals/lit';\nimport { Directive, directive } from 'lit/directive.js';\nimport '@eclipse-docks/extension-monaco-editor/widget';\nimport type { DocksMonacoWidget } from '@eclipse-docks/extension-monaco-editor/widget';\nimport type { CanvasContribution } from './contribution';\nimport { compileCanvas } from './compile';\nimport { createContributionHost, createFileHost, type CanvasHost } from './host';\nimport { elementFromConstructor, mountCompiled, type CanvasViewElement } from './mount';\nimport { canvasBridges } from './bridges/urls';\nimport { attachPreviewShot, rasterizeElement, type PreviewShot } from './preview-image';\nimport { readWorkspaceFile } from './workspace-file';\n\nconst heldNode = directive(class extends Directive {\n render(node?: Node) {\n return node ?? nothing;\n }\n});\n\n@customElement('docks-canvas-surface')\nexport class DocksCanvasSurface extends DocksPart implements EditorContentProvider {\n @property({ attribute: false }) input?: EditorInput;\n @property() kind: 'workspace' | 'registered' = 'workspace';\n @property() canvasName?: string;\n @property() entryPath = '';\n @property() source = '';\n @property({ type: Boolean }) showSource = false;\n\n @state() protected sourceText = '';\n @state() protected mode: 'preview' | 'source' = 'preview';\n @state() protected previewError?: string;\n @state() private attachingPreview = false;\n @state() protected previewElement?: CanvasViewElement;\n @query('docks-monaco-widget') protected widget?: DocksMonacoWidget;\n\n protected scrollMode: 'scroller' | 'native' | 'none' = 'none';\n protected host: CanvasHost = { getState: (_key, fallback) => fallback, setState: () => undefined, openFile: () => undefined };\n private previewDispose?: () => void;\n private contribution?: CanvasContribution;\n private ready = false;\n private reloadGeneration = 0;\n private compiledSource = '';\n protected previewStale = false;\n\n override connectedCallback() {\n super.connectedCallback();\n this.addEventListener('dirty', this.onDirty);\n }\n\n override disconnectedCallback() {\n this.removeEventListener('dirty', this.onDirty);\n this.reloadGeneration++;\n super.disconnectedCallback();\n }\n\n protected async doInitUI() {\n const data = this.input?.data;\n if (data instanceof File) {\n this.kind = 'workspace';\n this.entryPath = data.getWorkspacePath();\n this.showSource = true;\n this.sourceText = String(await data.getContents() ?? '');\n this.host = await createFileHost(data);\n } else if (data && typeof data === 'object' && 'contribution' in data) {\n this.contribution = (data as { contribution: CanvasContribution }).contribution;\n this.kind = 'registered';\n this.canvasName = this.contribution.name;\n this.showSource = this.contribution.source !== undefined;\n if (typeof this.contribution.source === 'function') this.sourceText = await this.contribution.source();\n else this.sourceText = this.contribution.source ?? '';\n this.host = await createContributionHost(this.contribution);\n } else if (this.entryPath || this.source) {\n this.kind = 'workspace';\n this.showSource = false;\n this.sourceText = this.source;\n const workspaceFile = await readWorkspaceFile(this.entryPath);\n if (workspaceFile?.text !== undefined && !this.sourceText) this.sourceText = workspaceFile.text;\n this.host = { getState: (_key, fallback) => fallback, setState: () => undefined, openFile: () => undefined };\n }\n this.mode = this.input?.state?.mode === 'source' ? 'source' : 'preview';\n this.ready = true;\n this.requestUpdate();\n if (this.mode === 'preview' || !this.showSource) await this.reload();\n }\n\n protected doClose() {\n this.reloadGeneration++;\n this.previewDispose?.();\n this.previewDispose = undefined;\n this.widget?.dispose();\n }\n\n getContent(): string | null {\n return this.widget?.getContent() ?? this.sourceText;\n }\n\n getSelection(): string | null {\n return this.widget?.getSelection() ?? null;\n }\n\n getSnippet(lines = 5): { snippet: string; cursorLine: number } | null {\n return this.widget?.getSnippet(lines) ?? null;\n }\n\n getLanguage(): string | null {\n return 'javascript';\n }\n\n isLanguage(lang: string): boolean {\n return lang.toLowerCase() === 'javascript';\n }\n\n getFilePath(): string | null {\n const data = this.input?.data;\n if (data instanceof File) return data.getWorkspacePath();\n return this.entryPath || null;\n }\n\n getState(key: string): unknown {\n return this.host.getState(key);\n }\n\n setState(key: string, value: unknown): void {\n this.host.setState(key, value);\n }\n\n setSource(source: string): void {\n this.previewStale = source !== this.compiledSource;\n this.sourceText = source;\n const model = this.widget?.getModel();\n if (model && model.getValue() !== source) model.setValue(source);\n this.requestUpdate();\n }\n\n async capturePreview(): Promise<PreviewShot> {\n for (let attempt = 0; attempt < 30 && !this.ready; attempt++) {\n await new Promise(resolve => setTimeout(resolve, 50));\n }\n if (!this.ready) throw new Error('Canvas is still opening');\n await this.reload();\n await this.updateComplete;\n const preview = this.renderRoot.querySelector('.canvas-preview') as HTMLElement | null;\n if (!preview) throw new Error('Canvas preview is not rendered');\n const hidden = preview.classList.contains('canvas-hidden') || preview.getBoundingClientRect().width < 2;\n if (hidden) {\n preview.classList.add('canvas-capture');\n preview.style.width = `${this.clientWidth || 960}px`;\n preview.style.height = `${this.clientHeight || 640}px`;\n }\n try {\n await nextFrame();\n await nextFrame();\n const view = this.previewElement as { updateComplete?: Promise<unknown> } | undefined;\n if (view?.updateComplete) await view.updateComplete;\n return await rasterizeElement(preview);\n } finally {\n preview.classList.remove('canvas-capture');\n preview.style.width = '';\n preview.style.height = '';\n }\n }\n\n async reload(): Promise<string> {\n const source = this.getContent() ?? '';\n if (this.previewElement && !this.previewStale && source === this.compiledSource && !this.previewError) return 'ready';\n const generation = ++this.reloadGeneration;\n if (this.kind === 'registered' && this.contribution) {\n try {\n const mod = await this.contribution.load();\n if (generation !== this.reloadGeneration) return 'ready';\n const Ctor = mod.default;\n if (typeof Ctor !== 'function' || !(Ctor.prototype instanceof HTMLElement)) {\n this.previewError = 'Canvas default export must be an HTMLElement subclass';\n this.requestUpdate();\n return this.previewError;\n }\n const element = elementFromConstructor(Ctor);\n element.canvasHost = this.host;\n this.replacePreview(element);\n return 'ready';\n } catch (err) {\n if (generation !== this.reloadGeneration) return 'ready';\n this.previewError = err instanceof Error ? err.message : String(err);\n this.requestUpdate();\n return this.previewError;\n }\n }\n const compiled = await compileCanvas({\n entryPath: this.entryPath || 'canvas.js',\n entrySource: source,\n read: readWorkspaceFile,\n bridges: canvasBridges(),\n });\n if (generation !== this.reloadGeneration) return 'ready';\n if (!compiled.ok) {\n this.previewError = compiled.error;\n this.requestUpdate();\n return compiled.error;\n }\n const mounted = await mountCompiled(compiled.code);\n if (generation !== this.reloadGeneration) {\n if (mounted.ok) mounted.dispose();\n return 'ready';\n }\n if (!mounted.ok) {\n this.previewError = mounted.error;\n this.requestUpdate();\n return mounted.error;\n }\n mounted.element.canvasHost = this.host;\n this.compiledSource = source;\n this.previewStale = false;\n this.replacePreview(mounted.element, mounted.dispose);\n return 'ready';\n }\n\n private replacePreview(element: CanvasViewElement, dispose?: () => void) {\n const previous = this.previewDispose;\n this.previewDispose = dispose ?? (() => element.remove());\n this.previewElement = element;\n this.previewError = undefined;\n this.compiledSource = this.getContent() ?? this.compiledSource;\n this.previewStale = false;\n this.requestUpdate();\n previous?.();\n }\n\n private onDirty = (event: Event) => {\n if (!this.ready || (event as CustomEvent<boolean>).detail !== true) return;\n const source = this.getContent() ?? '';\n if (source === this.compiledSource && this.previewElement) return;\n this.previewStale = true;\n if (this.mode === 'preview' || !this.showSource) void this.reload();\n };\n\n protected updated(changed: PropertyValues) {\n super.updated(changed);\n if (this.mode === 'source') this.widget?.layout();\n }\n\n private onContentChange = () => {\n const next = this.widget?.getContent() ?? this.sourceText;\n this.previewStale = next !== this.compiledSource;\n this.sourceText = next;\n this.markDirty(true);\n };\n\n private toggleMode() {\n if (this.widget) this.sourceText = this.widget.getContent() ?? this.sourceText;\n const next = this.mode === 'preview' ? 'source' : 'preview';\n this.mode = next;\n if (this.input) this.input.state.mode = next;\n if (next === 'preview' && (this.previewStale || !this.previewElement)) void this.reload();\n }\n\n private attachPreview = async () => {\n if (this.attachingPreview) return;\n this.attachingPreview = true;\n try {\n const result = await attachPreviewShot(this);\n if (typeof result === 'string') {\n this.showError(result);\n return;\n }\n if (result.stored === false) {\n this.showError(String(result.note ?? 'Could not attach the preview'));\n return;\n }\n this.showInfo('Attached preview');\n } catch (err) {\n this.showError(err instanceof Error ? err.message : String(err));\n } finally {\n this.attachingPreview = false;\n }\n };\n\n protected renderToolbar() {\n if (!this.ready) return nothing;\n const toSource = this.mode === 'preview';\n const label = toSource ? 'Source' : 'Preview';\n return html`\n ${this.showSource ? html`\n <wa-button appearance=\"plain\" size=\"s\" title=${label} @click=${() => this.toggleMode()}>\n ${icon(toSource ? 'code' : 'eye', { slot: 'start' })}\n ${label}\n </wa-button>\n ` : nothing}\n <wa-button\n appearance=\"plain\"\n size=\"s\"\n title=\"Attach a screenshot of the preview\"\n ?loading=${this.attachingPreview}\n ?disabled=${this.attachingPreview}\n @click=${() => this.attachPreview()}>\n ${icon('camera', { slot: 'start' })}\n Screenshot\n </wa-button>\n `;\n }\n\n protected renderContent() {\n if (!this.ready) return html``;\n const showPreview = !this.showSource || this.mode === 'preview';\n return html`\n <div class=\"canvas-preview ${showPreview ? '' : 'canvas-hidden'}\">\n ${this.previewError ? html`<pre class=\"canvas-error\">${this.previewError}</pre>` : nothing}\n <wa-scroller class=\"canvas-scroll\" orientation=\"vertical\">\n <div class=\"canvas-mount\">${heldNode(this.previewElement)}</div>\n </wa-scroller>\n </div>\n ${this.showSource ? html`\n <docks-monaco-widget\n class=${this.mode === 'source' ? '' : 'canvas-hidden'}\n .value=${this.sourceText}\n .language=${'javascript'}\n .uri=${this.entryPath || this.canvasName || 'canvas.js'}\n @content-change=${this.onContentChange}>\n </docks-monaco-widget>\n ` : nothing}\n `;\n }\n\n static styles = css`\n :host { display: flex; flex-direction: column; height: 100%; min-height: 0; }\n .canvas-preview { display: flex; flex-direction: column; height: 100%; min-height: 0; overflow: hidden; }\n .canvas-preview.canvas-hidden, docks-monaco-widget.canvas-hidden { display: none; }\n .canvas-preview.canvas-capture {\n display: flex !important;\n position: fixed;\n left: 0;\n top: 0;\n z-index: 2147483000;\n overflow: hidden;\n background: var(--wa-color-surface-default, #fff);\n }\n wa-scroller.canvas-scroll { flex: 1 1 0; min-height: 0; height: 100%; }\n .canvas-mount > * { display: block; }\n docks-monaco-widget { display: block; height: 100%; min-height: 0; }\n .canvas-error {\n margin: 0;\n padding: var(--wa-space-s, 8px);\n white-space: pre-wrap;\n color: var(--wa-color-danger-on-quiet, #b42318);\n }\n `;\n}\n\n@customElement('docks-canvas-editor')\nexport class DocksCanvasEditor extends DocksCanvasSurface {\n override async save(): Promise<void> {\n const value = this.getContent() ?? '';\n const data = this.input?.data;\n if (data instanceof File) await data.saveContents(value);\n this.markDirty(false);\n if (this.mode === 'preview' && this.previewStale) await this.reload();\n }\n}\n\nfunction nextFrame(): Promise<void> {\n return new Promise(resolve => requestAnimationFrame(() => resolve()));\n}\n\ndeclare global {\n interface HTMLElementTagNameMap {\n 'docks-canvas-surface': DocksCanvasSurface;\n 'docks-canvas-editor': DocksCanvasEditor;\n }\n}\n"],"mappings":"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"}
@@ -1,11 +1,11 @@
1
1
  import { SYSTEM_CANVASES, isCanvasContribution } from "./contribution.js";
2
- import { CANVAS_SKILL } from "./help.js";
3
2
  import { listRegisteredCanvases } from "./canvases.js";
4
3
  import { registerCanvasTools } from "./canvas-tools.js";
5
4
  import { registerCanvasCommands } from "./commands.js";
6
5
  import "./canvas-switcher.js";
7
6
  import { File, TOOLBAR_MAIN_RIGHT, TOPIC_CONTRIBUTEIONS_CHANGED, contributionRegistry, editorRegistry, subscribe } from "@eclipse-docks/core";
8
7
  import { html } from "@eclipse-docks/core/externals/lit";
8
+ import { SYSTEM_SKILLS } from "@eclipse-docks/extension-ai-system/api";
9
9
  //#region src/canvas-extension.ts
10
10
  editorRegistry.registerEditorInputHandler({
11
11
  editorId: "system.canvas-editor",
@@ -31,6 +31,33 @@ contributionRegistry.registerContribution(TOOLBAR_MAIN_RIGHT, {
31
31
  label: "Canvases",
32
32
  component: () => html`<docks-canvas-switcher></docks-canvas-switcher>`
33
33
  });
34
+ var canvasSkills = [
35
+ {
36
+ name: "eclipse-docks-canvas",
37
+ label: "Eclipse Docks canvas",
38
+ load: () => import("../skills/eclipse-docks-canvas/SKILL.md?raw"),
39
+ ranking: 100
40
+ },
41
+ {
42
+ name: "eclipse-docks-lit",
43
+ label: "Eclipse Docks Lit",
44
+ load: () => import("../skills/eclipse-docks-lit/SKILL.md?raw"),
45
+ ranking: 90
46
+ },
47
+ {
48
+ name: "eclipse-docks-webawesome",
49
+ label: "Eclipse Docks Web Awesome",
50
+ load: () => import("../skills/eclipse-docks-webawesome/SKILL.md?raw"),
51
+ ranking: 90
52
+ },
53
+ {
54
+ name: "eclipse-docks-core",
55
+ label: "Eclipse Docks core",
56
+ load: () => import("../skills/eclipse-docks-core/SKILL.md?raw"),
57
+ ranking: 90
58
+ }
59
+ ];
60
+ for (const skill of canvasSkills) contributionRegistry.registerContribution(SYSTEM_SKILLS, skill);
34
61
  function registerListedCanvasTools() {
35
62
  for (const canvas of listRegisteredCanvases()) registerCanvasTools(canvas);
36
63
  }
@@ -40,9 +67,6 @@ subscribe(TOPIC_CONTRIBUTEIONS_CHANGED, (event) => {
40
67
  if (event?.target !== "system.canvases") return;
41
68
  for (const contribution of contributionRegistry.getContributions(SYSTEM_CANVASES)) if (isCanvasContribution(contribution)) registerCanvasTools(contribution);
42
69
  });
43
- import("@eclipse-docks/extension-ai-system/api").then((ai) => {
44
- ai.cognitiveRuntime.addSystemPromptEnhancer((prompt) => `${prompt}\n\n${CANVAS_SKILL}`);
45
- }).catch(() => void 0);
46
70
  //#endregion
47
71
 
48
72
  //# sourceMappingURL=canvas-extension.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"canvas-extension.js","names":[],"sources":["../src/canvas-extension.ts"],"sourcesContent":["import {\n contributionRegistry,\n editorRegistry,\n File,\n subscribe,\n TOOLBAR_MAIN_RIGHT,\n TOPIC_CONTRIBUTEIONS_CHANGED,\n type EditorInput,\n type HTMLContribution,\n} from '@eclipse-docks/core';\nimport { html } from '@eclipse-docks/core/externals/lit';\nimport { CANVAS_SKILL } from './help';\nimport { isCanvasContribution, SYSTEM_CANVASES } from './contribution';\nimport { listRegisteredCanvases } from './canvases';\nimport { registerCanvasTools } from './canvas-tools';\nimport { registerCanvasCommands } from './commands';\nimport './canvas-switcher';\n\neditorRegistry.registerEditorInputHandler({\n editorId: 'system.canvas-editor',\n label: 'Canvas',\n icon: 'table-columns',\n ranking: 1100,\n canHandle: (input: unknown) => input instanceof File && input.getName().toLowerCase().endsWith('.canvas.js'),\n handle: async (input: File) => {\n const editorInput = {\n title: input.getName(),\n data: input,\n key: input.getWorkspacePath(),\n icon: 'table-columns',\n state: { mode: 'preview' },\n component: () => html``,\n } as EditorInput;\n editorInput.component = (id: string) => html`<docks-canvas-editor id=\"${id}\" .input=${editorInput}></docks-canvas-editor>`;\n return editorInput;\n },\n});\n\ncontributionRegistry.registerContribution(TOOLBAR_MAIN_RIGHT, {\n name: 'canvas.switcher',\n label: 'Canvases',\n component: () => html`<docks-canvas-switcher></docks-canvas-switcher>`,\n} as HTMLContribution);\n\nfunction registerListedCanvasTools(): void {\n for (const canvas of listRegisteredCanvases()) registerCanvasTools(canvas);\n}\n\nregisterCanvasCommands();\nregisterListedCanvasTools();\nsubscribe(TOPIC_CONTRIBUTEIONS_CHANGED, (event: { target?: string }) => {\n if (event?.target !== SYSTEM_CANVASES) return;\n for (const contribution of contributionRegistry.getContributions(SYSTEM_CANVASES)) {\n if (isCanvasContribution(contribution)) registerCanvasTools(contribution);\n }\n});\n\nvoid import('@eclipse-docks/extension-ai-system/api').then(ai => {\n ai.cognitiveRuntime.addSystemPromptEnhancer(prompt => `${prompt}\\n\\n${CANVAS_SKILL}`);\n}).catch(() => undefined);\n"],"mappings":";;;;;;;;;AAkBA,eAAe,2BAA2B;CACtC,UAAU;CACV,OAAO;CACP,MAAM;CACN,SAAS;CACT,YAAY,UAAmB,iBAAiB,QAAQ,MAAM,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,SAAS,YAAY;CAC3G,QAAQ,OAAO,UAAgB;EAC3B,MAAM,cAAc;GAChB,OAAO,MAAM,QAAQ;GACrB,MAAM;GACN,KAAK,MAAM,iBAAiB;GAC5B,MAAM;GACN,OAAO,EAAE,MAAM,UAAU;GACzB,iBAAiB,IAAI;EACzB;EACA,YAAY,aAAa,OAAe,IAAI,4BAA4B,GAAG,WAAW,YAAY;EAClG,OAAO;CACX;AACJ,CAAC;AAED,qBAAqB,qBAAqB,oBAAoB;CAC1D,MAAM;CACN,OAAO;CACP,iBAAiB,IAAI;AACzB,CAAqB;AAErB,SAAS,4BAAkC;CACvC,KAAK,MAAM,UAAU,uBAAuB,GAAG,oBAAoB,MAAM;AAC7E;AAEA,uBAAuB;AACvB,0BAA0B;AAC1B,UAAU,+BAA+B,UAA+B;CACpE,IAAI,OAAO,WAAA,mBAA4B;CACvC,KAAK,MAAM,gBAAgB,qBAAqB,iBAAiB,eAAe,GAC5E,IAAI,qBAAqB,YAAY,GAAG,oBAAoB,YAAY;AAEhF,CAAC;AAEI,OAAO,yCAAyC,CAAC,MAAK,OAAM;CAC7D,GAAG,iBAAiB,yBAAwB,WAAU,GAAG,OAAO,MAAM,cAAc;AACxF,CAAC,CAAC,CAAC,YAAY,KAAA,CAAS"}
1
+ {"version":3,"file":"canvas-extension.js","names":[],"sources":["../src/canvas-extension.ts"],"sourcesContent":["import {\n contributionRegistry,\n editorRegistry,\n File,\n subscribe,\n TOOLBAR_MAIN_RIGHT,\n TOPIC_CONTRIBUTEIONS_CHANGED,\n type EditorInput,\n type HTMLContribution,\n} from '@eclipse-docks/core';\nimport { html } from '@eclipse-docks/core/externals/lit';\nimport { SYSTEM_SKILLS, type SkillContribution } from '@eclipse-docks/extension-ai-system/api';\nimport { isCanvasContribution, SYSTEM_CANVASES } from './contribution';\nimport { listRegisteredCanvases } from './canvases';\nimport { registerCanvasTools } from './canvas-tools';\nimport { registerCanvasCommands } from './commands';\nimport './canvas-switcher';\n\neditorRegistry.registerEditorInputHandler({\n editorId: 'system.canvas-editor',\n label: 'Canvas',\n icon: 'table-columns',\n ranking: 1100,\n canHandle: (input: unknown) => input instanceof File && input.getName().toLowerCase().endsWith('.canvas.js'),\n handle: async (input: File) => {\n const editorInput = {\n title: input.getName(),\n data: input,\n key: input.getWorkspacePath(),\n icon: 'table-columns',\n state: { mode: 'preview' },\n component: () => html``,\n } as EditorInput;\n editorInput.component = (id: string) => html`<docks-canvas-editor id=\"${id}\" .input=${editorInput}></docks-canvas-editor>`;\n return editorInput;\n },\n});\n\ncontributionRegistry.registerContribution(TOOLBAR_MAIN_RIGHT, {\n name: 'canvas.switcher',\n label: 'Canvases',\n component: () => html`<docks-canvas-switcher></docks-canvas-switcher>`,\n} as HTMLContribution);\n\nconst canvasSkills = [\n {\n name: 'eclipse-docks-canvas',\n label: 'Eclipse Docks canvas',\n load: () => import('../skills/eclipse-docks-canvas/SKILL.md?raw'),\n ranking: 100,\n },\n {\n name: 'eclipse-docks-lit',\n label: 'Eclipse Docks Lit',\n load: () => import('../skills/eclipse-docks-lit/SKILL.md?raw'),\n ranking: 90,\n },\n {\n name: 'eclipse-docks-webawesome',\n label: 'Eclipse Docks Web Awesome',\n load: () => import('../skills/eclipse-docks-webawesome/SKILL.md?raw'),\n ranking: 90,\n },\n {\n name: 'eclipse-docks-core',\n label: 'Eclipse Docks core',\n load: () => import('../skills/eclipse-docks-core/SKILL.md?raw'),\n ranking: 90,\n },\n] as const satisfies ReadonlyArray<SkillContribution>;\n\nfor (const skill of canvasSkills) {\n contributionRegistry.registerContribution(SYSTEM_SKILLS, skill);\n}\n\nfunction registerListedCanvasTools(): void {\n for (const canvas of listRegisteredCanvases()) registerCanvasTools(canvas);\n}\n\nregisterCanvasCommands();\nregisterListedCanvasTools();\nsubscribe(TOPIC_CONTRIBUTEIONS_CHANGED, (event: { target?: string }) => {\n if (event?.target !== SYSTEM_CANVASES) return;\n for (const contribution of contributionRegistry.getContributions(SYSTEM_CANVASES)) {\n if (isCanvasContribution(contribution)) registerCanvasTools(contribution);\n }\n});\n"],"mappings":";;;;;;;;;AAkBA,eAAe,2BAA2B;CACtC,UAAU;CACV,OAAO;CACP,MAAM;CACN,SAAS;CACT,YAAY,UAAmB,iBAAiB,QAAQ,MAAM,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,SAAS,YAAY;CAC3G,QAAQ,OAAO,UAAgB;EAC3B,MAAM,cAAc;GAChB,OAAO,MAAM,QAAQ;GACrB,MAAM;GACN,KAAK,MAAM,iBAAiB;GAC5B,MAAM;GACN,OAAO,EAAE,MAAM,UAAU;GACzB,iBAAiB,IAAI;EACzB;EACA,YAAY,aAAa,OAAe,IAAI,4BAA4B,GAAG,WAAW,YAAY;EAClG,OAAO;CACX;AACJ,CAAC;AAED,qBAAqB,qBAAqB,oBAAoB;CAC1D,MAAM;CACN,OAAO;CACP,iBAAiB,IAAI;AACzB,CAAqB;AAErB,IAAM,eAAe;CACjB;EACI,MAAM;EACN,OAAO;EACP,YAAY,OAAO;EACnB,SAAS;CACb;CACA;EACI,MAAM;EACN,OAAO;EACP,YAAY,OAAO;EACnB,SAAS;CACb;CACA;EACI,MAAM;EACN,OAAO;EACP,YAAY,OAAO;EACnB,SAAS;CACb;CACA;EACI,MAAM;EACN,OAAO;EACP,YAAY,OAAO;EACnB,SAAS;CACb;AACJ;AAEA,KAAK,MAAM,SAAS,cAChB,qBAAqB,qBAAqB,eAAe,KAAK;AAGlE,SAAS,4BAAkC;CACvC,KAAK,MAAM,UAAU,uBAAuB,GAAG,oBAAoB,MAAM;AAC7E;AAEA,uBAAuB;AACvB,0BAA0B;AAC1B,UAAU,+BAA+B,UAA+B;CACpE,IAAI,OAAO,WAAA,mBAA4B;CACvC,KAAK,MAAM,gBAAgB,qBAAqB,iBAAiB,eAAe,GAC5E,IAAI,qBAAqB,YAAY,GAAG,oBAAoB,YAAY;AAEhF,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":"AAAA,OAAO,EASH,KAAK,WAAW,EACnB,MAAM,qBAAqB,CAAC;AAI7B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEzD,OAAO,iBAAiB,CAAC;AAIzB,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,kBAAkB,EAAE,UAAU,SAAK,GAAG,WAAW,CAehG;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAMpE;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAOpE;AAMD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAYjF;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAIjE;AAiBD,wBAAgB,sBAAsB,IAAI,IAAI,CAiK7C"}
1
+ {"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":"AAAA,OAAO,EASH,KAAK,WAAW,EACnB,MAAM,qBAAqB,CAAC;AAI7B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEzD,OAAO,iBAAiB,CAAC;AAIzB,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,kBAAkB,EAAE,UAAU,SAAK,GAAG,WAAW,CAehG;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAMpE;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAOpE;AAMD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAYjF;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAIjE;AAiBD,wBAAgB,sBAAsB,IAAI,IAAI,CAmK7C"}
package/dist/commands.js CHANGED
@@ -1,6 +1,6 @@
1
- import { CANVAS_HELP } from "./help.js";
2
1
  import { listRegisteredCanvases } from "./canvases.js";
3
- import { readActiveCanvas } from "./active-canvas.js";
2
+ import { findOpenCanvas, readActiveCanvas } from "./active-canvas.js";
3
+ import { attachPreviewShot } from "./preview-image.js";
4
4
  import "./canvas-editor.js";
5
5
  import { File, PANEL_BOTTOM, SIDEBAR_AUXILIARY, SIDEBAR_MAIN, contributionRegistry, editorRegistry, registerAll, workspaceService } from "@eclipse-docks/core";
6
6
  import { html } from "@eclipse-docks/core/externals/lit";
@@ -74,18 +74,6 @@ async function waitForCanvas(match) {
74
74
  return null;
75
75
  }
76
76
  function registerCanvasCommands() {
77
- registerAll({
78
- command: {
79
- id: "canvas.help",
80
- name: "Canvas help",
81
- description: "Returns the canvas.js contract and the canvases registered on system.canvases",
82
- parameters: []
83
- },
84
- handler: { execute: async () => {
85
- const listed = listRegisteredCanvases().map((item) => `${item.name}: ${item.label}`).join("\n");
86
- return listed ? `${CANVAS_HELP}\n\nRegistered canvases:\n${listed}` : CANVAS_HELP;
87
- } }
88
- });
89
77
  registerAll({
90
78
  command: {
91
79
  id: "canvas.open",
@@ -203,6 +191,22 @@ function registerCanvasCommands() {
203
191
  }
204
192
  }
205
193
  });
194
+ registerAll({
195
+ command: {
196
+ id: "canvas.capture_preview",
197
+ name: "Capture canvas preview",
198
+ description: "Renders the open canvas preview to an image, attaches it to the session, and returns it for visual inspection. Content inside an iframe may be blank.",
199
+ parameters: []
200
+ },
201
+ handler: {
202
+ canExecute: () => !!findOpenCanvas()?.capturePreview,
203
+ execute: async () => {
204
+ const active = findOpenCanvas();
205
+ if (!active) return "No canvas is open";
206
+ return attachPreviewShot(active);
207
+ }
208
+ }
209
+ });
206
210
  registerAll({
207
211
  command: {
208
212
  id: "canvas.show_as_view",
@@ -1 +1 @@
1
- {"version":3,"file":"commands.js","names":[],"sources":["../src/commands.ts"],"sourcesContent":["import {\n contributionRegistry,\n editorRegistry,\n File,\n registerAll,\n SIDEBAR_AUXILIARY,\n SIDEBAR_MAIN,\n PANEL_BOTTOM,\n workspaceService,\n type EditorInput,\n} from '@eclipse-docks/core';\nimport { html } from '@eclipse-docks/core/externals/lit';\nimport { readActiveCanvas } from './active-canvas';\nimport { listRegisteredCanvases } from './canvases';\nimport type { CanvasContribution } from './contribution';\nimport { CANVAS_HELP } from './help';\nimport './canvas-editor';\n\nconst VIEW_SLOTS = new Set([SIDEBAR_MAIN, SIDEBAR_AUXILIARY, PANEL_BOTTOM]);\n\nexport function canvasEditorInput(contribution: CanvasContribution, sourceText = ''): EditorInput {\n const hasSource = contribution.source !== undefined;\n const input = {\n key: `canvas:${contribution.name}`,\n title: contribution.label,\n icon: contribution.icon ?? 'table-columns',\n data: { contribution },\n state: { mode: 'preview' },\n component: () => html``,\n } as EditorInput;\n input.component = (id: string) => hasSource\n ? html`<docks-canvas-editor id=\"${id}\" .input=${input} .source=${sourceText}></docks-canvas-editor>`\n : html`<docks-canvas-surface id=\"${id}\" .input=${input}></docks-canvas-surface>`;\n (input as unknown as { editorId: string }).editorId = 'system.canvas-editor';\n return input;\n}\n\nexport async function openCanvasByName(name: string): Promise<string> {\n const contribution = listRegisteredCanvases().find(item => item.name === name);\n if (!contribution) return `No canvas named ${name}`;\n const sourceText = typeof contribution.source === 'function' ? await contribution.source() : (contribution.source ?? '');\n await editorRegistry.loadEditor(canvasEditorInput(contribution, sourceText));\n return 'ready';\n}\n\nexport async function openCanvasByPath(path: string): Promise<string> {\n const workspace = workspaceService.getWorkspaceSync() ?? await workspaceService.getWorkspace();\n if (!workspace) return 'No workspace is open';\n const resource = await workspace.getResource(path.replace(/^\\/+/, ''));\n if (!(resource instanceof File)) return `Cannot find workspace file \"${path}\"`;\n await editorRegistry.loadEditor(resource, 'system.canvas-editor');\n return 'ready';\n}\n\nfunction viewName(path: string): string {\n return `canvas-view:${path}`;\n}\n\nexport function showCanvasView(slot: string, path: string, source: string): string {\n if (!VIEW_SLOTS.has(slot)) return `Unsupported view slot ${slot}`;\n const name = viewName(path);\n contributionRegistry.unregisterContribution(slot, name);\n contributionRegistry.registerContribution(slot, {\n name,\n label: path.split('/').pop() || path,\n icon: 'table-columns',\n closable: true,\n component: (id: string) => html`<docks-canvas-surface id=\"${id}\" .entryPath=${path} .source=${source}></docks-canvas-surface>`,\n });\n return 'ready';\n}\n\nexport function hideCanvasView(slot: string, path: string): string {\n if (!VIEW_SLOTS.has(slot)) return `Unsupported view slot ${slot}`;\n contributionRegistry.unregisterContribution(slot, viewName(path));\n return 'ready';\n}\n\nfunction workspaceCanvas() {\n const active = readActiveCanvas();\n if (!active?.editor || active.kind !== 'workspace') return null;\n return active;\n}\n\nasync function waitForCanvas(match: (active: NonNullable<ReturnType<typeof readActiveCanvas>>) => boolean) {\n for (let attempt = 0; attempt < 30; attempt++) {\n const active = readActiveCanvas();\n if (active?.reload && match(active)) return active;\n await new Promise(resolve => setTimeout(resolve, 50));\n }\n return null;\n}\n\nexport function registerCanvasCommands(): void {\n registerAll({\n command: {\n id: 'canvas.help',\n name: 'Canvas help',\n description: 'Returns the canvas.js contract and the canvases registered on system.canvases',\n parameters: [],\n },\n handler: {\n execute: async () => {\n const listed = listRegisteredCanvases().map(item => `${item.name}: ${item.label}`).join('\\n');\n return listed ? `${CANVAS_HELP}\\n\\nRegistered canvases:\\n${listed}` : CANVAS_HELP;\n },\n },\n });\n\n registerAll({\n command: {\n id: 'canvas.open',\n name: 'Open canvas',\n description: 'Opens a workspace .canvas.js path or a canvas registered on system.canvases and returns ready or a compile error',\n parameters: [\n { name: 'path', description: 'Workspace path of a .canvas.js file', required: false },\n { name: 'name', description: 'Name of a canvas registered on system.canvases', required: false },\n ],\n },\n handler: {\n execute: async ({ params }) => {\n const name = params?.name as string | undefined;\n const path = params?.path as string | undefined;\n if (name) {\n const opened = await openCanvasByName(name);\n if (opened !== 'ready') return opened;\n const active = await waitForCanvas(item => item.canvasName === name);\n return active?.reload ? active.reload() : opened;\n }\n if (path) {\n const opened = await openCanvasByPath(path);\n if (opened !== 'ready') return opened;\n const active = await waitForCanvas(item => item.kind === 'workspace');\n return active?.reload ? active.reload() : opened;\n }\n return 'Provide a workspace path or a registered canvas name';\n },\n },\n });\n\n registerAll({\n command: {\n id: 'canvas.apply_source',\n name: 'Apply canvas source',\n description: 'Writes source into the active workspace canvas, compiles it, and returns ready or the compile error',\n parameters: [\n { name: 'source', description: 'Full canvas module source', required: true },\n { name: 'path', description: 'Workspace path of the canvas file', required: false },\n ],\n },\n handler: {\n canExecute: () => !!workspaceCanvas(),\n execute: async ({ params }) => {\n const active = workspaceCanvas();\n if (!active?.setSource || !active.reload) return 'No workspace canvas is active';\n const source = String(params?.source ?? '');\n const path = (params?.path as string | undefined) ?? active.getFilePath?.() ?? undefined;\n if (path) {\n const { writeWorkspaceFile } = await import('./workspace-file');\n const written = await writeWorkspaceFile(path, source);\n if (!written) return `Cannot write workspace file \"${path}\"`;\n }\n active.setSource(source);\n return active.reload();\n },\n },\n });\n\n registerAll({\n command: {\n id: 'canvas.get_source',\n name: 'Get canvas source',\n description: 'Returns the current source buffer of the active workspace canvas',\n parameters: [],\n },\n handler: {\n canExecute: () => !!workspaceCanvas(),\n execute: async () => workspaceCanvas()?.getContent?.() ?? '',\n },\n });\n\n registerAll({\n command: {\n id: 'canvas.get_state',\n name: 'Get canvas state',\n description: 'Reads one persisted state value from the active workspace canvas',\n parameters: [{ name: 'key', description: 'State key', required: true }],\n },\n handler: {\n canExecute: () => !!workspaceCanvas(),\n execute: async ({ params }) => workspaceCanvas()?.getState?.(String(params?.key ?? '')),\n },\n });\n\n registerAll({\n command: {\n id: 'canvas.set_state',\n name: 'Set canvas state',\n description: 'Writes one persisted state value on the active workspace canvas',\n parameters: [\n { name: 'key', description: 'State key', required: true },\n { name: 'value', description: 'JSON value', required: true },\n ],\n },\n handler: {\n canExecute: () => !!workspaceCanvas(),\n execute: async ({ params }) => {\n const active = workspaceCanvas();\n if (!active?.setState) return 'No workspace canvas is active';\n active.setState(String(params?.key ?? ''), params?.value);\n return 'ready';\n },\n },\n });\n\n registerAll({\n command: {\n id: 'canvas.show_as_view',\n name: 'Show canvas as view',\n description: 'Pins the active workspace canvas preview into a sidebar or the bottom panel',\n parameters: [\n { name: 'slot', description: 'sidebar-main, sidebar-auxiliary, or panel-bottom', required: true },\n ],\n },\n handler: {\n canExecute: () => !!workspaceCanvas(),\n execute: async ({ params }) => {\n const active = workspaceCanvas();\n const path = active?.getFilePath?.();\n if (!active || !path) return 'No workspace canvas is active';\n return showCanvasView(String(params?.slot ?? ''), path, active.getContent?.() ?? '');\n },\n },\n });\n\n registerAll({\n command: {\n id: 'canvas.hide_view',\n name: 'Hide canvas view',\n description: 'Removes a pinned canvas preview from a sidebar or the bottom panel',\n parameters: [\n { name: 'slot', description: 'sidebar-main, sidebar-auxiliary, or panel-bottom', required: true },\n { name: 'path', description: 'Workspace path of the canvas file', required: false },\n ],\n },\n handler: {\n canExecute: () => !!workspaceCanvas(),\n execute: async ({ params }) => {\n const path = (params?.path as string | undefined) ?? workspaceCanvas()?.getFilePath?.() ?? '';\n if (!path) return 'No canvas path';\n return hideCanvasView(String(params?.slot ?? ''), path);\n },\n },\n });\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"commands.js","names":[],"sources":["../src/commands.ts"],"sourcesContent":["import {\n contributionRegistry,\n editorRegistry,\n File,\n registerAll,\n SIDEBAR_AUXILIARY,\n SIDEBAR_MAIN,\n PANEL_BOTTOM,\n workspaceService,\n type EditorInput,\n} from '@eclipse-docks/core';\nimport { html } from '@eclipse-docks/core/externals/lit';\nimport { findOpenCanvas, readActiveCanvas } from './active-canvas';\nimport { listRegisteredCanvases } from './canvases';\nimport type { CanvasContribution } from './contribution';\nimport { attachPreviewShot } from './preview-image';\nimport './canvas-editor';\n\nconst VIEW_SLOTS = new Set([SIDEBAR_MAIN, SIDEBAR_AUXILIARY, PANEL_BOTTOM]);\n\nexport function canvasEditorInput(contribution: CanvasContribution, sourceText = ''): EditorInput {\n const hasSource = contribution.source !== undefined;\n const input = {\n key: `canvas:${contribution.name}`,\n title: contribution.label,\n icon: contribution.icon ?? 'table-columns',\n data: { contribution },\n state: { mode: 'preview' },\n component: () => html``,\n } as EditorInput;\n input.component = (id: string) => hasSource\n ? html`<docks-canvas-editor id=\"${id}\" .input=${input} .source=${sourceText}></docks-canvas-editor>`\n : html`<docks-canvas-surface id=\"${id}\" .input=${input}></docks-canvas-surface>`;\n (input as unknown as { editorId: string }).editorId = 'system.canvas-editor';\n return input;\n}\n\nexport async function openCanvasByName(name: string): Promise<string> {\n const contribution = listRegisteredCanvases().find(item => item.name === name);\n if (!contribution) return `No canvas named ${name}`;\n const sourceText = typeof contribution.source === 'function' ? await contribution.source() : (contribution.source ?? '');\n await editorRegistry.loadEditor(canvasEditorInput(contribution, sourceText));\n return 'ready';\n}\n\nexport async function openCanvasByPath(path: string): Promise<string> {\n const workspace = workspaceService.getWorkspaceSync() ?? await workspaceService.getWorkspace();\n if (!workspace) return 'No workspace is open';\n const resource = await workspace.getResource(path.replace(/^\\/+/, ''));\n if (!(resource instanceof File)) return `Cannot find workspace file \"${path}\"`;\n await editorRegistry.loadEditor(resource, 'system.canvas-editor');\n return 'ready';\n}\n\nfunction viewName(path: string): string {\n return `canvas-view:${path}`;\n}\n\nexport function showCanvasView(slot: string, path: string, source: string): string {\n if (!VIEW_SLOTS.has(slot)) return `Unsupported view slot ${slot}`;\n const name = viewName(path);\n contributionRegistry.unregisterContribution(slot, name);\n contributionRegistry.registerContribution(slot, {\n name,\n label: path.split('/').pop() || path,\n icon: 'table-columns',\n closable: true,\n component: (id: string) => html`<docks-canvas-surface id=\"${id}\" .entryPath=${path} .source=${source}></docks-canvas-surface>`,\n });\n return 'ready';\n}\n\nexport function hideCanvasView(slot: string, path: string): string {\n if (!VIEW_SLOTS.has(slot)) return `Unsupported view slot ${slot}`;\n contributionRegistry.unregisterContribution(slot, viewName(path));\n return 'ready';\n}\n\nfunction workspaceCanvas() {\n const active = readActiveCanvas();\n if (!active?.editor || active.kind !== 'workspace') return null;\n return active;\n}\n\nasync function waitForCanvas(match: (active: NonNullable<ReturnType<typeof readActiveCanvas>>) => boolean) {\n for (let attempt = 0; attempt < 30; attempt++) {\n const active = readActiveCanvas();\n if (active?.reload && match(active)) return active;\n await new Promise(resolve => setTimeout(resolve, 50));\n }\n return null;\n}\n\nexport function registerCanvasCommands(): void {\n registerAll({\n command: {\n id: 'canvas.open',\n name: 'Open canvas',\n description: 'Opens a workspace .canvas.js path or a canvas registered on system.canvases and returns ready or a compile error',\n parameters: [\n { name: 'path', description: 'Workspace path of a .canvas.js file', required: false },\n { name: 'name', description: 'Name of a canvas registered on system.canvases', required: false },\n ],\n },\n handler: {\n execute: async ({ params }) => {\n const name = params?.name as string | undefined;\n const path = params?.path as string | undefined;\n if (name) {\n const opened = await openCanvasByName(name);\n if (opened !== 'ready') return opened;\n const active = await waitForCanvas(item => item.canvasName === name);\n return active?.reload ? active.reload() : opened;\n }\n if (path) {\n const opened = await openCanvasByPath(path);\n if (opened !== 'ready') return opened;\n const active = await waitForCanvas(item => item.kind === 'workspace');\n return active?.reload ? active.reload() : opened;\n }\n return 'Provide a workspace path or a registered canvas name';\n },\n },\n });\n\n registerAll({\n command: {\n id: 'canvas.apply_source',\n name: 'Apply canvas source',\n description: 'Writes source into the active workspace canvas, compiles it, and returns ready or the compile error',\n parameters: [\n { name: 'source', description: 'Full canvas module source', required: true },\n { name: 'path', description: 'Workspace path of the canvas file', required: false },\n ],\n },\n handler: {\n canExecute: () => !!workspaceCanvas(),\n execute: async ({ params }) => {\n const active = workspaceCanvas();\n if (!active?.setSource || !active.reload) return 'No workspace canvas is active';\n const source = String(params?.source ?? '');\n const path = (params?.path as string | undefined) ?? active.getFilePath?.() ?? undefined;\n if (path) {\n const { writeWorkspaceFile } = await import('./workspace-file');\n const written = await writeWorkspaceFile(path, source);\n if (!written) return `Cannot write workspace file \"${path}\"`;\n }\n active.setSource(source);\n return active.reload();\n },\n },\n });\n\n registerAll({\n command: {\n id: 'canvas.get_source',\n name: 'Get canvas source',\n description: 'Returns the current source buffer of the active workspace canvas',\n parameters: [],\n },\n handler: {\n canExecute: () => !!workspaceCanvas(),\n execute: async () => workspaceCanvas()?.getContent?.() ?? '',\n },\n });\n\n registerAll({\n command: {\n id: 'canvas.get_state',\n name: 'Get canvas state',\n description: 'Reads one persisted state value from the active workspace canvas',\n parameters: [{ name: 'key', description: 'State key', required: true }],\n },\n handler: {\n canExecute: () => !!workspaceCanvas(),\n execute: async ({ params }) => workspaceCanvas()?.getState?.(String(params?.key ?? '')),\n },\n });\n\n registerAll({\n command: {\n id: 'canvas.set_state',\n name: 'Set canvas state',\n description: 'Writes one persisted state value on the active workspace canvas',\n parameters: [\n { name: 'key', description: 'State key', required: true },\n { name: 'value', description: 'JSON value', required: true },\n ],\n },\n handler: {\n canExecute: () => !!workspaceCanvas(),\n execute: async ({ params }) => {\n const active = workspaceCanvas();\n if (!active?.setState) return 'No workspace canvas is active';\n active.setState(String(params?.key ?? ''), params?.value);\n return 'ready';\n },\n },\n });\n\n registerAll({\n command: {\n id: 'canvas.capture_preview',\n name: 'Capture canvas preview',\n description: 'Renders the open canvas preview to an image, attaches it to the session, and returns it for visual inspection. Content inside an iframe may be blank.',\n parameters: [],\n },\n handler: {\n canExecute: () => !!findOpenCanvas()?.capturePreview,\n execute: async () => {\n const active = findOpenCanvas();\n if (!active) return 'No canvas is open';\n return attachPreviewShot(active);\n },\n },\n });\n\n registerAll({\n command: {\n id: 'canvas.show_as_view',\n name: 'Show canvas as view',\n description: 'Pins the active workspace canvas preview into a sidebar or the bottom panel',\n parameters: [\n { name: 'slot', description: 'sidebar-main, sidebar-auxiliary, or panel-bottom', required: true },\n ],\n },\n handler: {\n canExecute: () => !!workspaceCanvas(),\n execute: async ({ params }) => {\n const active = workspaceCanvas();\n const path = active?.getFilePath?.();\n if (!active || !path) return 'No workspace canvas is active';\n return showCanvasView(String(params?.slot ?? ''), path, active.getContent?.() ?? '');\n },\n },\n });\n\n registerAll({\n command: {\n id: 'canvas.hide_view',\n name: 'Hide canvas view',\n description: 'Removes a pinned canvas preview from a sidebar or the bottom panel',\n parameters: [\n { name: 'slot', description: 'sidebar-main, sidebar-auxiliary, or panel-bottom', required: true },\n { name: 'path', description: 'Workspace path of the canvas file', required: false },\n ],\n },\n handler: {\n canExecute: () => !!workspaceCanvas(),\n execute: async ({ params }) => {\n const path = (params?.path as string | undefined) ?? workspaceCanvas()?.getFilePath?.() ?? '';\n if (!path) return 'No canvas path';\n return hideCanvasView(String(params?.slot ?? ''), path);\n },\n },\n });\n}\n"],"mappings":"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"}
@@ -0,0 +1,21 @@
1
+ /** Same field the specialist loop reads to schedule a follow-up vision message. */
2
+ export declare const PREVIEW_IMAGE_KEY = "_presentImage";
3
+ export interface PreviewShot {
4
+ dataUrl: string;
5
+ byteLength: number;
6
+ mime: string;
7
+ }
8
+ export interface StoredPreview {
9
+ id: string;
10
+ name: string;
11
+ path?: string;
12
+ }
13
+ export declare function rasterizeElement(element: HTMLElement): Promise<PreviewShot>;
14
+ export declare function previewFileName(sourceName: string | null | undefined, mime: string): string;
15
+ export declare function attachPreviewShot(active: {
16
+ capturePreview?: () => Promise<PreviewShot>;
17
+ getFilePath?: () => string | null;
18
+ canvasName?: string;
19
+ }): Promise<Record<string, unknown> | string>;
20
+ export declare function previewToolOutput(shot: PreviewShot, name: string, stored?: StoredPreview | null, presentKey?: string): Record<string, unknown>;
21
+ //# sourceMappingURL=preview-image.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"preview-image.d.ts","sourceRoot":"","sources":["../src/preview-image.ts"],"names":[],"mappings":"AAEA,mFAAmF;AACnF,eAAO,MAAM,iBAAiB,kBAAkB,CAAC;AAKjD,MAAM,WAAW,WAAW;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAsBjF;AAED,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAI3F;AAED,wBAAsB,iBAAiB,CAAC,MAAM,EAAE;IAC5C,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC;IAC5C,WAAW,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,CAa5C;AAED,wBAAgB,iBAAiB,CAC7B,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,aAAa,GAAG,IAAI,EAC7B,UAAU,SAAoB,GAC/B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAezB"}
@@ -0,0 +1,87 @@
1
+ import { domToBlob } from "modern-screenshot";
2
+ //#region src/preview-image.ts
3
+ /** Same field the specialist loop reads to schedule a follow-up vision message. */
4
+ var PREVIEW_IMAGE_KEY = "_presentImage";
5
+ var MAX_BYTES = 35e5;
6
+ var MAX_EDGE = 1600;
7
+ async function rasterizeElement(element) {
8
+ const rect = element.getBoundingClientRect();
9
+ if (rect.width < 2 || rect.height < 2) throw new Error("Canvas preview has no visible size");
10
+ const width = Math.round(rect.width);
11
+ const height = Math.round(rect.height);
12
+ const options = {
13
+ width,
14
+ height,
15
+ scale: Math.min(2, MAX_EDGE / Math.max(width, height)),
16
+ backgroundColor: opaqueBackground(element),
17
+ font: false,
18
+ features: { restoreScrollPosition: true }
19
+ };
20
+ let mime = "image/png";
21
+ let blob = await domToBlob(element, options);
22
+ if (blob.size > MAX_BYTES) {
23
+ mime = "image/jpeg";
24
+ blob = await domToBlob(element, {
25
+ ...options,
26
+ type: "image/jpeg",
27
+ quality: .8
28
+ });
29
+ }
30
+ if (blob.size > MAX_BYTES) throw new Error("Canvas preview image is too large to attach");
31
+ const bytes = new Uint8Array(await blob.arrayBuffer());
32
+ return {
33
+ mime,
34
+ byteLength: bytes.byteLength,
35
+ dataUrl: `data:${mime};base64,${bytesToBase64(bytes)}`
36
+ };
37
+ }
38
+ function previewFileName(sourceName, mime) {
39
+ return `${(sourceName?.split("/").pop() || "canvas").replace(/\.canvas\.js$/i, "").replace(/[^\w.-]+/g, "_") || "canvas"}.preview.${mime === "image/jpeg" ? "jpg" : "png"}`;
40
+ }
41
+ async function attachPreviewShot(active) {
42
+ if (!active.capturePreview) return "No canvas is open";
43
+ const shot = await active.capturePreview();
44
+ const name = previewFileName(active.getFilePath?.() ?? active.canvasName, shot.mime);
45
+ const { cognitiveRuntime } = await import("@eclipse-docks/extension-ai-system/api");
46
+ return previewToolOutput(shot, name, (await cognitiveRuntime.addAttachments(void 0, [{
47
+ name,
48
+ mime: shot.mime,
49
+ kind: "image",
50
+ dataUrl: shot.dataUrl,
51
+ byteLength: shot.byteLength
52
+ }]))[0]);
53
+ }
54
+ function previewToolOutput(shot, name, stored, presentKey = PREVIEW_IMAGE_KEY) {
55
+ return {
56
+ id: stored?.id ?? "",
57
+ name: stored?.name ?? name,
58
+ path: stored?.path,
59
+ mime: shot.mime,
60
+ kind: "image",
61
+ byteLength: shot.byteLength,
62
+ stored: Boolean(stored),
63
+ [presentKey]: true,
64
+ dataUrl: shot.dataUrl,
65
+ note: stored ? "Image bytes will be provided to the model in the next message for vision inspection." : "Image bytes follow for inspection. The preview was not stored because the session attachment limit is full."
66
+ };
67
+ }
68
+ function opaqueBackground(start) {
69
+ let current = start;
70
+ while (current) {
71
+ const color = getComputedStyle(current).backgroundColor;
72
+ if (color && color !== "transparent" && color !== "rgba(0, 0, 0, 0)") return color;
73
+ const root = current.getRootNode();
74
+ current = current.parentElement ?? (root instanceof ShadowRoot ? root.host : null);
75
+ }
76
+ return "#ffffff";
77
+ }
78
+ function bytesToBase64(bytes) {
79
+ const chunk = 32768;
80
+ let binary = "";
81
+ for (let i = 0; i < bytes.length; i += chunk) binary += String.fromCharCode(...bytes.subarray(i, i + chunk));
82
+ return btoa(binary);
83
+ }
84
+ //#endregion
85
+ export { PREVIEW_IMAGE_KEY, attachPreviewShot, previewFileName, previewToolOutput, rasterizeElement };
86
+
87
+ //# sourceMappingURL=preview-image.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"preview-image.js","names":[],"sources":["../src/preview-image.ts"],"sourcesContent":["import { domToBlob } from 'modern-screenshot';\n\n/** Same field the specialist loop reads to schedule a follow-up vision message. */\nexport const PREVIEW_IMAGE_KEY = '_presentImage';\n\nconst MAX_BYTES = 3_500_000;\nconst MAX_EDGE = 1600;\n\nexport interface PreviewShot {\n dataUrl: string;\n byteLength: number;\n mime: string;\n}\n\nexport interface StoredPreview {\n id: string;\n name: string;\n path?: string;\n}\n\nexport async function rasterizeElement(element: HTMLElement): Promise<PreviewShot> {\n const rect = element.getBoundingClientRect();\n if (rect.width < 2 || rect.height < 2) throw new Error('Canvas preview has no visible size');\n const width = Math.round(rect.width);\n const height = Math.round(rect.height);\n const options = {\n width,\n height,\n scale: Math.min(2, MAX_EDGE / Math.max(width, height)),\n backgroundColor: opaqueBackground(element),\n font: false as const,\n features: { restoreScrollPosition: true },\n };\n let mime = 'image/png';\n let blob = await domToBlob(element, options);\n if (blob.size > MAX_BYTES) {\n mime = 'image/jpeg';\n blob = await domToBlob(element, { ...options, type: 'image/jpeg', quality: 0.8 });\n }\n if (blob.size > MAX_BYTES) throw new Error('Canvas preview image is too large to attach');\n const bytes = new Uint8Array(await blob.arrayBuffer());\n return { mime, byteLength: bytes.byteLength, dataUrl: `data:${mime};base64,${bytesToBase64(bytes)}` };\n}\n\nexport function previewFileName(sourceName: string | null | undefined, mime: string): string {\n const base = (sourceName?.split('/').pop() || 'canvas').replace(/\\.canvas\\.js$/i, '').replace(/[^\\w.-]+/g, '_') || 'canvas';\n const ext = mime === 'image/jpeg' ? 'jpg' : 'png';\n return `${base}.preview.${ext}`;\n}\n\nexport async function attachPreviewShot(active: {\n capturePreview?: () => Promise<PreviewShot>;\n getFilePath?: () => string | null;\n canvasName?: string;\n}): Promise<Record<string, unknown> | string> {\n if (!active.capturePreview) return 'No canvas is open';\n const shot = await active.capturePreview();\n const name = previewFileName(active.getFilePath?.() ?? active.canvasName, shot.mime);\n const { cognitiveRuntime } = await import('@eclipse-docks/extension-ai-system/api');\n const stored = await cognitiveRuntime.addAttachments(undefined, [{\n name,\n mime: shot.mime,\n kind: 'image',\n dataUrl: shot.dataUrl,\n byteLength: shot.byteLength,\n }]);\n return previewToolOutput(shot, name, stored[0]);\n}\n\nexport function previewToolOutput(\n shot: PreviewShot,\n name: string,\n stored?: StoredPreview | null,\n presentKey = PREVIEW_IMAGE_KEY,\n): Record<string, unknown> {\n return {\n id: stored?.id ?? '',\n name: stored?.name ?? name,\n path: stored?.path,\n mime: shot.mime,\n kind: 'image',\n byteLength: shot.byteLength,\n stored: Boolean(stored),\n [presentKey]: true,\n dataUrl: shot.dataUrl,\n note: stored\n ? 'Image bytes will be provided to the model in the next message for vision inspection.'\n : 'Image bytes follow for inspection. The preview was not stored because the session attachment limit is full.',\n };\n}\n\nfunction opaqueBackground(start: Element): string {\n let current: Element | null = start;\n while (current) {\n const color = getComputedStyle(current).backgroundColor;\n if (color && color !== 'transparent' && color !== 'rgba(0, 0, 0, 0)') return color;\n const root = current.getRootNode();\n current = current.parentElement ?? (root instanceof ShadowRoot ? root.host : null);\n }\n return '#ffffff';\n}\n\nfunction bytesToBase64(bytes: Uint8Array): string {\n const chunk = 0x8000;\n let binary = '';\n for (let i = 0; i < bytes.length; i += chunk) {\n binary += String.fromCharCode(...bytes.subarray(i, i + chunk));\n }\n return btoa(binary);\n}\n"],"mappings":";;;AAGA,IAAa,oBAAoB;AAEjC,IAAM,YAAY;AAClB,IAAM,WAAW;AAcjB,eAAsB,iBAAiB,SAA4C;CAC/E,MAAM,OAAO,QAAQ,sBAAsB;CAC3C,IAAI,KAAK,QAAQ,KAAK,KAAK,SAAS,GAAG,MAAM,IAAI,MAAM,oCAAoC;CAC3F,MAAM,QAAQ,KAAK,MAAM,KAAK,KAAK;CACnC,MAAM,SAAS,KAAK,MAAM,KAAK,MAAM;CACrC,MAAM,UAAU;EACZ;EACA;EACA,OAAO,KAAK,IAAI,GAAG,WAAW,KAAK,IAAI,OAAO,MAAM,CAAC;EACrD,iBAAiB,iBAAiB,OAAO;EACzC,MAAM;EACN,UAAU,EAAE,uBAAuB,KAAK;CAC5C;CACA,IAAI,OAAO;CACX,IAAI,OAAO,MAAM,UAAU,SAAS,OAAO;CAC3C,IAAI,KAAK,OAAO,WAAW;EACvB,OAAO;EACP,OAAO,MAAM,UAAU,SAAS;GAAE,GAAG;GAAS,MAAM;GAAc,SAAS;EAAI,CAAC;CACpF;CACA,IAAI,KAAK,OAAO,WAAW,MAAM,IAAI,MAAM,6CAA6C;CACxF,MAAM,QAAQ,IAAI,WAAW,MAAM,KAAK,YAAY,CAAC;CACrD,OAAO;EAAE;EAAM,YAAY,MAAM;EAAY,SAAS,QAAQ,KAAK,UAAU,cAAc,KAAK;CAAI;AACxG;AAEA,SAAgB,gBAAgB,YAAuC,MAAsB;CAGzF,OAAO,IAFO,YAAY,MAAM,GAAG,CAAC,CAAC,IAAI,KAAK,SAAA,CAAU,QAAQ,kBAAkB,EAAE,CAAC,CAAC,QAAQ,aAAa,GAAG,KAAK,SAEpG,WADH,SAAS,eAAe,QAAQ;AAEhD;AAEA,eAAsB,kBAAkB,QAIM;CAC1C,IAAI,CAAC,OAAO,gBAAgB,OAAO;CACnC,MAAM,OAAO,MAAM,OAAO,eAAe;CACzC,MAAM,OAAO,gBAAgB,OAAO,cAAc,KAAK,OAAO,YAAY,KAAK,IAAI;CACnF,MAAM,EAAE,qBAAqB,MAAM,OAAO;CAQ1C,OAAO,kBAAkB,MAAM,OAAM,MAPhB,iBAAiB,eAAe,KAAA,GAAW,CAAC;EAC7D;EACA,MAAM,KAAK;EACX,MAAM;EACN,SAAS,KAAK;EACd,YAAY,KAAK;CACrB,CAAC,CAAC,EAAA,CAC0C,EAAE;AAClD;AAEA,SAAgB,kBACZ,MACA,MACA,QACA,aAAa,mBACU;CACvB,OAAO;EACH,IAAI,QAAQ,MAAM;EAClB,MAAM,QAAQ,QAAQ;EACtB,MAAM,QAAQ;EACd,MAAM,KAAK;EACX,MAAM;EACN,YAAY,KAAK;EACjB,QAAQ,QAAQ,MAAM;GACrB,aAAa;EACd,SAAS,KAAK;EACd,MAAM,SACA,yFACA;CACV;AACJ;AAEA,SAAS,iBAAiB,OAAwB;CAC9C,IAAI,UAA0B;CAC9B,OAAO,SAAS;EACZ,MAAM,QAAQ,iBAAiB,OAAO,CAAC,CAAC;EACxC,IAAI,SAAS,UAAU,iBAAiB,UAAU,oBAAoB,OAAO;EAC7E,MAAM,OAAO,QAAQ,YAAY;EACjC,UAAU,QAAQ,kBAAkB,gBAAgB,aAAa,KAAK,OAAO;CACjF;CACA,OAAO;AACX;AAEA,SAAS,cAAc,OAA2B;CAC9C,MAAM,QAAQ;CACd,IAAI,SAAS;CACb,KAAK,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK,OACnC,UAAU,OAAO,aAAa,GAAG,MAAM,SAAS,GAAG,IAAI,KAAK,CAAC;CAEjE,OAAO,KAAK,MAAM;AACtB"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@eclipse-docks/extension-canvas",
3
- "version": "0.8.0",
3
+ "version": "0.8.2",
4
4
  "type": "module",
5
5
  "main": "./dist/index.js",
6
6
  "module": "./dist/index.js",
@@ -16,7 +16,8 @@
16
16
  }
17
17
  },
18
18
  "files": [
19
- "dist"
19
+ "dist",
20
+ "skills"
20
21
  ],
21
22
  "scripts": {
22
23
  "build": "vite build",
@@ -25,7 +26,8 @@
25
26
  "dependencies": {
26
27
  "@eclipse-docks/core": "*",
27
28
  "@eclipse-docks/extension-ai-system": "*",
28
- "@eclipse-docks/extension-monaco-editor": "*"
29
+ "@eclipse-docks/extension-monaco-editor": "*",
30
+ "modern-screenshot": "^4.7.0"
29
31
  },
30
32
  "devDependencies": {
31
33
  "jsdom": "^25.0.0",
@@ -0,0 +1,99 @@
1
+ ---
2
+ name: eclipse-docks-canvas
3
+ description: >-
4
+ Create or edit interactive Eclipse Docks canvases (.canvas.js): LitElement UIs,
5
+ dashboards, todo apps, widgets, maps, and previewable tools. Use when the user
6
+ wants an interactive view, canvas, widget, or .canvas.js file — even if they do
7
+ not say "canvas".
8
+ ---
9
+
10
+ # Eclipse Docks canvas
11
+
12
+ Write a workspace file ending in `.canvas.js`. Default-export a `LitElement` subclass from `docks/lit`. Do **not** extend `HTMLElement`. Do **not** call `customElements.define` — the host registers the tag.
13
+
14
+ ## Hard rules
15
+
16
+ 1. **`canvasHost` is unavailable in `constructor`.** The host sets `this.canvasHost` after construction. Read/write persisted state in `connectedCallback` (after `super`) or later. Always guard: `this.canvasHost?.getState` / `setState`.
17
+ 2. Pure JavaScript only — no TypeScript, no decorators. Declare reactive fields with `static properties = { … }`. Initialize plain defaults in `constructor`; hydrate from `canvasHost` only after connect.
18
+ 3. Prefer Web Awesome via `import "docks/webawesome"` (`wa-button`, `wa-input`, `wa-checkbox`, …).
19
+ 4. Emit complete, valid JavaScript — no truncated objects or unfinished strings.
20
+ 5. Cross-origin isolation: third-party pages that omit CORP (maps, many CDNs) must load in an iframe `srcdoc`, not as top-level fetches from the LitElement. Keep `docks/*` and `canvasHost` on the LitElement.
21
+
22
+ ## Minimal pattern
23
+
24
+ ```js
25
+ import { LitElement, html, css } from "docks/lit";
26
+ import "docks/webawesome";
27
+
28
+ export default class extends LitElement {
29
+ static properties = {
30
+ items: { state: true },
31
+ draft: { state: true },
32
+ };
33
+
34
+ static styles = css`
35
+ :host { display: block; padding: 1rem; box-sizing: border-box; }
36
+ `;
37
+
38
+ constructor() {
39
+ super();
40
+ this.items = [];
41
+ this.draft = "";
42
+ }
43
+
44
+ connectedCallback() {
45
+ super.connectedCallback();
46
+ const saved = this.canvasHost?.getState("items", null);
47
+ if (Array.isArray(saved)) this.items = saved;
48
+ }
49
+
50
+ persist() {
51
+ this.canvasHost?.setState("items", this.items);
52
+ }
53
+
54
+ addItem() {
55
+ const text = this.draft.trim();
56
+ if (!text) return;
57
+ this.items = [...this.items, { id: crypto.randomUUID(), text, done: false }];
58
+ this.draft = "";
59
+ this.persist();
60
+ }
61
+
62
+ render() {
63
+ return html`
64
+ <wa-input
65
+ placeholder="New item"
66
+ .value=${this.draft}
67
+ @input=${(e) => { this.draft = e.target.value; }}
68
+ @keydown=${(e) => { if (e.key === "Enter") this.addItem(); }}
69
+ ></wa-input>
70
+ <wa-button @click=${() => this.addItem()}>Add</wa-button>
71
+ <ul>
72
+ ${this.items.map((item) => html`<li>${item.text}</li>`)}
73
+ </ul>
74
+ `;
75
+ }
76
+ }
77
+ ```
78
+
79
+ APIs: `this.canvasHost.getState(key, fallback)`, `this.canvasHost.setState(key, value)`, `this.canvasHost.openFile(path)`.
80
+
81
+ ## Imports
82
+
83
+ - `docks/lit`, `docks/webawesome`, `docks/core` → running app
84
+ - Relative imports → workspace files (compiler inlines them: JSON → value, text/CSS → string, binaries → data URL)
85
+
86
+ Before non-trivial UI or shell integration, load companion skills as needed:
87
+
88
+ - `skills.load` `eclipse-docks-lit` — reactive properties, templates, directives (pure JS)
89
+ - `skills.load` `eclipse-docks-webawesome` — `wa-*` components and layout utilities
90
+ - `skills.load` `eclipse-docks-core` — workspace, editors, commands, dialogs, events
91
+
92
+ ## Workflow
93
+
94
+ 1. `workspace_write` a durable `<root>/….canvas.js` (qualify with a root from `workspace_list`).
95
+ 2. `canvas.open` with that path — returns `ready` or the compile/runtime error.
96
+ 3. Fix with `workspace_write` / `canvas.apply_source`, then re-open or apply.
97
+ 4. Optional: `canvas.capture_preview` to attach a screenshot (iframe contents may be blank).
98
+
99
+ Extension-registered canvases live on `system.canvases` and open by name via `canvas.open`.
@@ -0,0 +1,132 @@
1
+ ---
2
+ name: eclipse-docks-core
3
+ description: >-
4
+ Eclipse Docks core runtime from docks/core: workspace files, editors, commands,
5
+ contributions, dialogs, toasts, settings, and events. Use when a canvas or
6
+ extension needs to open files, register UI, run commands, or talk to the shell.
7
+ ---
8
+
9
+ # Eclipse Docks core (`docks/core`)
10
+
11
+ ```js
12
+ import {
13
+ workspaceService,
14
+ File,
15
+ editorRegistry,
16
+ commandRegistry,
17
+ registerAll,
18
+ contributionRegistry,
19
+ publish,
20
+ subscribe,
21
+ unsubscribe,
22
+ appSettings,
23
+ toastInfo,
24
+ toastError,
25
+ confirmDialog,
26
+ promptDialog,
27
+ filebrowserDialog,
28
+ } from "docks/core";
29
+ ```
30
+
31
+ Alias: `@eclipse-docks/core`. Subpaths map to the same bridges, e.g. `docks/core/parts`, `docks/core/widgets`, `docks/core/externals/lit`.
32
+
33
+ ## Workspace
34
+
35
+ ```js
36
+ const workspace = workspaceService.getWorkspaceSync() ?? await workspaceService.getWorkspace();
37
+ const resource = await workspace.getResource("folder/note.md");
38
+ if (resource instanceof File) {
39
+ const text = await resource.getContents();
40
+ await resource.saveContents(text);
41
+ }
42
+ ```
43
+
44
+ - Paths are workspace-relative (root-prefixed in the composite workspace).
45
+ - Create with `getResource(path, { create: true })` when the API allows.
46
+ - Canvases can also open a path via `this.canvasHost.openFile(path)` without importing core.
47
+
48
+ ## Editors
49
+
50
+ ```js
51
+ await editorRegistry.loadEditor(file); // default handler
52
+ await editorRegistry.loadEditor(file, "system.canvas-editor");
53
+ ```
54
+
55
+ `EditorInput` objects carry `title`, `key`, `data`, `component`, optional `state`. Prefer opening a `File` when one exists.
56
+
57
+ ## Commands
58
+
59
+ ```js
60
+ registerAll({
61
+ command: {
62
+ id: "demo.ping",
63
+ name: "Ping",
64
+ description: "Demo command",
65
+ parameters: [],
66
+ },
67
+ handler: {
68
+ execute: async () => "pong",
69
+ },
70
+ });
71
+
72
+ await commandRegistry.execute("demo.ping", {});
73
+ ```
74
+
75
+ Commands registered this way can surface as AI tools when the cognitive runtime refreshes command tools.
76
+
77
+ ## Contributions
78
+
79
+ ```js
80
+ import { SIDEBAR_MAIN, TOOLBAR_MAIN_RIGHT } from "docks/core";
81
+
82
+ contributionRegistry.registerContribution(SIDEBAR_MAIN, {
83
+ name: "demo.view",
84
+ label: "Demo",
85
+ icon: "star",
86
+ component: (id) => /* Lit html template for the view */ null,
87
+ });
88
+ ```
89
+
90
+ Common slots: sidebars, panel bottom, toolbars, settings. Canvas modules contributed by extensions use `system.canvases` (`SYSTEM_CANVASES` from `@eclipse-docks/extension-canvas/contribution`) with a `load()` that returns `{ default: CustomElementConstructor }`.
91
+
92
+ ## Dialogs & toasts
93
+
94
+ ```js
95
+ const ok = await confirmDialog("Replace file?");
96
+ const name = await promptDialog("Name?");
97
+ toastInfo("Saved");
98
+ toastError("Failed");
99
+ ```
100
+
101
+ `filebrowserDialog` for folder/file picks; `formDialog` for multi-field forms. Prefer these over ad-hoc `window.prompt` in shell-integrated code.
102
+
103
+ ## Settings & events
104
+
105
+ ```js
106
+ await appSettings.set("demo.flag", true);
107
+ const flag = await appSettings.get("demo.flag");
108
+
109
+ const id = subscribe("topic.name", (event) => { /* … */ });
110
+ publish("topic.name", { detail: 1 });
111
+ unsubscribe(id);
112
+ ```
113
+
114
+ ## Logging
115
+
116
+ ```js
117
+ import { createLogger } from "docks/core";
118
+ const log = createLogger("demo");
119
+ log.info("ready");
120
+ ```
121
+
122
+ ## Canvas notes
123
+
124
+ - Host persistence for a workspace `.canvas.js` is `canvasHost.getState` / `setState`, not `appSettings`, unless you intentionally share app-wide settings.
125
+ - Cross-origin isolation applies: third-party documents without CORP belong in iframe `srcdoc`, not naked fetches from the canvas element.
126
+ - Keep UI building blocks on `docks/lit` + `docks/webawesome`; use `docks/core` for shell integration.
127
+
128
+ ## Anti-patterns
129
+
130
+ - Bare filenames at the composite workspace root when a durable root prefix is required
131
+ - Assuming `canvasHost` APIs exist on arbitrary LitElements outside a canvas mount
132
+ - Re-implementing toast/dialog with `alert` when core helpers are available
@@ -0,0 +1,68 @@
1
+ ---
2
+ name: eclipse-docks-lit
3
+ description: >-
4
+ LitElement patterns for Eclipse Docks canvases and UI code via docks/lit.
5
+ Use when writing or fixing .canvas.js, Lit templates, reactive properties,
6
+ directives, or styles — pure JavaScript only (no TypeScript decorators).
7
+ ---
8
+
9
+ # Eclipse Docks Lit (`docks/lit`)
10
+
11
+ Import from `docks/lit` (same module as `@eclipse-docks/core/externals/lit`). In `.canvas.js` files use **pure JavaScript only** — no TypeScript, no decorators (`@property`, `@state`, `@customElement` are unavailable).
12
+
13
+ ## Essentials
14
+
15
+ ```js
16
+ import { LitElement, html, css, nothing } from "docks/lit";
17
+ ```
18
+
19
+ - Default-export a `LitElement` subclass for canvases. Do **not** call `customElements.define` in a canvas — the host registers the tag.
20
+ - Reactive fields: `static properties = { count: { state: true }, label: { type: String } }`.
21
+ - Initialize defaults in `constructor` after `super()`.
22
+ - Styles: `static styles = css\`:host { display: block; }\`;` (or an array of `css` results).
23
+ - Templates: `render() { return html\`...\`; }` — use `nothing` for empty branches.
24
+
25
+ ## Property options (common)
26
+
27
+ | Option | Meaning |
28
+ | --- | --- |
29
+ | `state: true` | Internal reactive state (not an attribute) |
30
+ | `type: String` / `Number` / `Boolean` / `Object` / `Array` | Attribute reflection helpers |
31
+ | `attribute: false` | Do not mirror to an attribute |
32
+ | `reflect: true` | Reflect property → attribute |
33
+
34
+ Assign **new** values for objects/arrays (`this.items = [...this.items, next]`), do not mutate in place if you need an update.
35
+
36
+ ## Directives
37
+
38
+ Named exports from `docks/lit` (also available as in Lit docs):
39
+
40
+ ```js
41
+ import { repeat, when, classMap, styleMap, ifDefined, live, ref, keyed } from "docks/lit";
42
+ ```
43
+
44
+ - `repeat(items, (i) => i.id, (i) => html\`...\`)` for keyed lists
45
+ - `when(cond, () => html\`...\`)` / `nothing` for conditionals
46
+ - `classMap({ active: isOn })`, `styleMap({ width: "1rem" })`
47
+ - `live(value)` when binding to form controls that can diverge from the property
48
+ - Prefer `.value=${x}` (property) over `value=${x}` (attribute) for form controls
49
+
50
+ ## Events in templates
51
+
52
+ ```js
53
+ html`<wa-button @click=${this.onSave}>Save</wa-button>`
54
+ html`<wa-input @wa-input=${(e) => { this.q = e.target.value; }}></wa-input>`
55
+ ```
56
+
57
+ Use arrow functions or bound methods so `this` stays the element.
58
+
59
+ ## Signals (optional)
60
+
61
+ `docks/lit` also re-exports `@lit-labs/signals` helpers: `signal`, `computed`, `watch`, `SignalWatcher`, `withWatch`. Prefer `static properties` for simple canvas state unless you already use signals.
62
+
63
+ ## Anti-patterns
64
+
65
+ - Decorators or `.ts` syntax in `.canvas.js`
66
+ - Mutating arrays/objects in place without reassignment
67
+ - Relying on `this` inside a non-arrow inline handler incorrectly
68
+ - Calling `customElements.define` from a workspace canvas module
@@ -0,0 +1,150 @@
1
+ ---
2
+ name: eclipse-docks-webawesome
3
+ description: >-
4
+ Web Awesome UI components in Eclipse Docks via docks/webawesome. Use when
5
+ building buttons, inputs, selects, checkboxes, dialogs, drawers, tabs, toasts,
6
+ forms, icons, or layout utilities (wa-stack, wa-cluster, wa-grid) in canvases
7
+ or Docks UI.
8
+ ---
9
+
10
+ # Eclipse Docks Web Awesome (`docks/webawesome`)
11
+
12
+ Side-effect import once — Docks already registers components, themes, and the `docks` icon library:
13
+
14
+ ```js
15
+ import "docks/webawesome";
16
+ ```
17
+
18
+ Do **not** import individual `@awesome.me/webawesome/dist/components/...` paths from a canvas; the bridge loads the set used by the app. Always use **closing tags** (`<wa-input></wa-input>`, never `<wa-input />`).
19
+
20
+ ## Official agent skills (direct URLs)
21
+
22
+ Docs overview: https://webawesome.com/docs/ai/agent-skills
23
+
24
+ When you need exact props/events/slots, layout, or theming beyond this cheat sheet, `fetch` these markdown URLs directly (do not scrape the HTML docs page):
25
+
26
+ **Component skill**
27
+
28
+ - https://cdn.jsdelivr.net/npm/@awesome.me/webawesome@3/dist/skills/webawesome/SKILL.md
29
+ - https://cdn.jsdelivr.net/npm/@awesome.me/webawesome@3/dist/skills/webawesome/references/choosing-components.md
30
+ - https://cdn.jsdelivr.net/npm/@awesome.me/webawesome@3/dist/skills/webawesome/references/usage.md
31
+ - https://cdn.jsdelivr.net/npm/@awesome.me/webawesome@3/dist/skills/webawesome/references/form-controls.md
32
+ - https://cdn.jsdelivr.net/npm/@awesome.me/webawesome@3/dist/skills/webawesome/references/themes.md
33
+ - https://cdn.jsdelivr.net/npm/@awesome.me/webawesome@3/dist/skills/webawesome/references/tokens/color.md
34
+ - https://cdn.jsdelivr.net/npm/@awesome.me/webawesome@3/dist/skills/webawesome/references/utilities/layout.md
35
+ - https://cdn.jsdelivr.net/npm/@awesome.me/webawesome@3/dist/skills/webawesome/references/utilities/color.md
36
+
37
+ **Common component APIs** (`wa-*` → same stem)
38
+
39
+ - https://cdn.jsdelivr.net/npm/@awesome.me/webawesome@3/dist/skills/webawesome/references/components/button.md
40
+ - https://cdn.jsdelivr.net/npm/@awesome.me/webawesome@3/dist/skills/webawesome/references/components/input.md
41
+ - https://cdn.jsdelivr.net/npm/@awesome.me/webawesome@3/dist/skills/webawesome/references/components/textarea.md
42
+ - https://cdn.jsdelivr.net/npm/@awesome.me/webawesome@3/dist/skills/webawesome/references/components/checkbox.md
43
+ - https://cdn.jsdelivr.net/npm/@awesome.me/webawesome@3/dist/skills/webawesome/references/components/switch.md
44
+ - https://cdn.jsdelivr.net/npm/@awesome.me/webawesome@3/dist/skills/webawesome/references/components/select.md
45
+ - https://cdn.jsdelivr.net/npm/@awesome.me/webawesome@3/dist/skills/webawesome/references/components/option.md
46
+ - https://cdn.jsdelivr.net/npm/@awesome.me/webawesome@3/dist/skills/webawesome/references/components/radio-group.md
47
+ - https://cdn.jsdelivr.net/npm/@awesome.me/webawesome@3/dist/skills/webawesome/references/components/dialog.md
48
+ - https://cdn.jsdelivr.net/npm/@awesome.me/webawesome@3/dist/skills/webawesome/references/components/drawer.md
49
+ - https://cdn.jsdelivr.net/npm/@awesome.me/webawesome@3/dist/skills/webawesome/references/components/dropdown.md
50
+ - https://cdn.jsdelivr.net/npm/@awesome.me/webawesome@3/dist/skills/webawesome/references/components/tab-group.md
51
+ - https://cdn.jsdelivr.net/npm/@awesome.me/webawesome@3/dist/skills/webawesome/references/components/card.md
52
+ - https://cdn.jsdelivr.net/npm/@awesome.me/webawesome@3/dist/skills/webawesome/references/components/callout.md
53
+ - https://cdn.jsdelivr.net/npm/@awesome.me/webawesome@3/dist/skills/webawesome/references/components/icon.md
54
+ - https://cdn.jsdelivr.net/npm/@awesome.me/webawesome@3/dist/skills/webawesome/references/components/toast.md
55
+
56
+ Other components: `https://cdn.jsdelivr.net/npm/@awesome.me/webawesome@3/dist/skills/webawesome/references/components/<name>.md` (e.g. `number-input`, `slider`, `tooltip`).
57
+
58
+ **Design skill**
59
+
60
+ - https://cdn.jsdelivr.net/npm/@awesome.me/webawesome@3/dist/skills/webawesome-design/SKILL.md
61
+ - https://cdn.jsdelivr.net/npm/@awesome.me/webawesome@3/dist/skills/webawesome-design/references/getting-started.md
62
+ - https://cdn.jsdelivr.net/npm/@awesome.me/webawesome@3/dist/skills/webawesome-design/references/layouts-page.md
63
+ - https://cdn.jsdelivr.net/npm/@awesome.me/webawesome@3/dist/skills/webawesome-design/references/layouts-inpage.md
64
+ - https://cdn.jsdelivr.net/npm/@awesome.me/webawesome@3/dist/skills/webawesome-design/references/composition.md
65
+ - https://cdn.jsdelivr.net/npm/@awesome.me/webawesome@3/dist/skills/webawesome-design/references/patterns.md
66
+ - https://cdn.jsdelivr.net/npm/@awesome.me/webawesome@3/dist/skills/webawesome-design/references/theming.md
67
+
68
+ Fetch only the URLs needed for the current task. Prefer these over inventing `wa-*` APIs.
69
+
70
+ ## Lit bindings
71
+
72
+ ```js
73
+ html`
74
+ <wa-input
75
+ label="Name"
76
+ .value=${this.name}
77
+ @wa-input=${(e) => { this.name = e.target.value; }}
78
+ ></wa-input>
79
+ <wa-button variant="brand" @click=${() => this.save()}>Save</wa-button>
80
+ `
81
+ ```
82
+
83
+ - Prefer property binding (`.value`, `.checked`) over attributes for controlled values.
84
+ - Listen to Web Awesome events (`wa-input`, `wa-change`, `wa-select`, …), not only native `input`/`change`, when the component documents `wa-*` events.
85
+ - Slots: `<wa-icon slot="start" name="plus"></wa-icon>` inside buttons/inputs.
86
+
87
+ ## Icons
88
+
89
+ ```html
90
+ <wa-icon name="gear"></wa-icon>
91
+ ```
92
+
93
+ Default library is Font Awesome names. Docks also registers library `docks` for app SVGs: `<wa-icon library="docks" name="…"></wa-icon>`.
94
+
95
+ ## Layout utilities
96
+
97
+ Use Web Awesome utility classes in templates/styles when useful: `wa-stack`, `wa-cluster`, `wa-grid`, `wa-flank`, `wa-split`, `wa-gap-s` / `wa-gap-m`, `wa-align-items-center`, etc.
98
+
99
+ ```js
100
+ html`<div class="wa-stack wa-gap-m">${/* children */}</div>`
101
+ ```
102
+
103
+ ## Component cheat sheet (common)
104
+
105
+ | Need | Component |
106
+ | --- | --- |
107
+ | Action | `wa-button`, `wa-button-group`, `wa-copy-button` |
108
+ | Text | `wa-input`, `wa-textarea`, `wa-number-input` |
109
+ | Choice | `wa-checkbox`, `wa-switch`, `wa-radio-group` + `wa-radio`, `wa-select` + `wa-option` |
110
+ | Overlay | `wa-dialog`, `wa-drawer`, `wa-popover`, `wa-tooltip`, `wa-dropdown` + `wa-dropdown-item` |
111
+ | Nav / structure | `wa-tab-group` + `wa-tab` + `wa-tab-panel`, `wa-breadcrumb`, `wa-divider` |
112
+ | Feedback | `wa-callout`, `wa-spinner`, `wa-progress-bar`, `wa-badge`, `wa-tag` |
113
+ | Content | `wa-card`, `wa-details`, `wa-accordion` + `wa-accordion-item`, `wa-markdown` |
114
+ | Toast host | `wa-toast` + `wa-toast-item` (prefer Docks `toastInfo` / `toastError` from `docks/core` when available) |
115
+
116
+ Pick **`wa-select`** for form values; pick **`wa-dropdown`** for action menus — do not confuse them.
117
+
118
+ ## Theming & color tokens
119
+
120
+ Components follow the loaded Web Awesome theme (Docks imports default theme CSS). Prefer `variant`, `appearance`, and `size` on components before custom CSS.
121
+
122
+ **Prefer Web Awesome color tokens over custom colors** (`#hex`, `rgb()`, named colors). Tokens track light/dark and palette changes; hardcoded colors do not.
123
+
124
+ Use semantic / theme tokens first:
125
+
126
+ - Surfaces & text: `var(--wa-color-surface-default)`, `var(--wa-color-surface-raised)`, `var(--wa-color-surface-border)`, `var(--wa-color-text-normal)`, `var(--wa-color-text-quiet)`, `var(--wa-color-text-link)`
127
+ - Variants: `var(--wa-color-brand-fill-loud)`, `var(--wa-color-success-fill-normal)`, `var(--wa-color-warning-on-loud)`, `var(--wa-color-danger-border-normal)`, …
128
+ - Utility classes when enough: `wa-color-brand`, `wa-bg-surface-raised`, etc. (see utilities/color.md)
129
+
130
+ Reserve raw palette tints (`--wa-color-blue-50`, …) for rare cases. For deeper theming, `fetch` `tokens/color.md` and `webawesome-design/references/theming.md`.
131
+
132
+ ```js
133
+ static styles = css`
134
+ :host {
135
+ display: block;
136
+ color: var(--wa-color-text-normal);
137
+ background: var(--wa-color-surface-default);
138
+ border: 1px solid var(--wa-color-surface-border);
139
+ }
140
+ .accent { color: var(--wa-color-brand-on-quiet); }
141
+ `;
142
+ ```
143
+
144
+ ## Anti-patterns
145
+
146
+ - Self-closing custom elements
147
+ - Per-component package imports inside `.canvas.js`
148
+ - Using `wa-dropdown` where a form `wa-select` is required
149
+ - Hardcoded colors in CSS/templates instead of `--wa-*` color tokens
150
+ - Putting third-party map/CDN documents in the Lit tree — use iframe `srcdoc` (see canvas skill); keep WA on the host element
package/dist/help.d.ts DELETED
@@ -1,3 +0,0 @@
1
- export declare const CANVAS_HELP = "A canvas is a workspace file ending in .canvas.js. Extend LitElement, not HTMLElement:\n\nimport { LitElement, html } from \"docks/lit\";\nimport \"docks/webawesome\";\nexport default class extends LitElement {\n render() { return html`<wa-button>Ready</wa-button>`; }\n}\n\nThe host defines the custom element. Do not call customElements.define. Set state with this.canvasHost.getState(key, fallback) and this.canvasHost.setState(key, value). Open a workspace file with this.canvasHost.openFile(path).\n\nImports are not filtered. docks/lit, docks/webawesome, and docks/core are the running app (Lit, Web Awesome, and @eclipse-docks/core). Relative imports are workspace files. Compiling inlines those files: JSON becomes its value, text and CSS become strings, and other binaries become data URLs.\n\nWrite the file with the workspace tools, then call canvas.open with its path. canvas.apply_source updates the open canvas and returns ready or the compile error. Extension canvases are registered with contributionRegistry.registerContribution(SYSTEM_CANVASES, contribution). Import SYSTEM_CANVASES and CanvasContribution from @eclipse-docks/extension-canvas/contribution. They are opened by name from canvas.open or the toolbar dropdown.";
2
- export declare const CANVAS_SKILL = "For a durable interactive view, write a workspace file ending in .canvas.js whose default export extends LitElement from \"docks/lit\". Do not extend HTMLElement. Call canvas.open, and call canvas.help for the module contract. Extension canvases registered on system.canvases open by name.";
3
- //# sourceMappingURL=help.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,8tCAY8Z,CAAC;AAEvb,eAAO,MAAM,YAAY,sSAAoS,CAAC"}
package/dist/help.js DELETED
@@ -1,19 +0,0 @@
1
- //#region src/help.ts
2
- var CANVAS_HELP = `A canvas is a workspace file ending in .canvas.js. Extend LitElement, not HTMLElement:
3
-
4
- import { LitElement, html } from "docks/lit";
5
- import "docks/webawesome";
6
- export default class extends LitElement {
7
- render() { return html\`<wa-button>Ready</wa-button>\`; }
8
- }
9
-
10
- The host defines the custom element. Do not call customElements.define. Set state with this.canvasHost.getState(key, fallback) and this.canvasHost.setState(key, value). Open a workspace file with this.canvasHost.openFile(path).
11
-
12
- Imports are not filtered. docks/lit, docks/webawesome, and docks/core are the running app (Lit, Web Awesome, and @eclipse-docks/core). Relative imports are workspace files. Compiling inlines those files: JSON becomes its value, text and CSS become strings, and other binaries become data URLs.
13
-
14
- Write the file with the workspace tools, then call canvas.open with its path. canvas.apply_source updates the open canvas and returns ready or the compile error. Extension canvases are registered with contributionRegistry.registerContribution(SYSTEM_CANVASES, contribution). Import SYSTEM_CANVASES and CanvasContribution from @eclipse-docks/extension-canvas/contribution. They are opened by name from canvas.open or the toolbar dropdown.`;
15
- var CANVAS_SKILL = `For a durable interactive view, write a workspace file ending in .canvas.js whose default export extends LitElement from "docks/lit". Do not extend HTMLElement. Call canvas.open, and call canvas.help for the module contract. Extension canvases registered on system.canvases open by name.`;
16
- //#endregion
17
- export { CANVAS_HELP, CANVAS_SKILL };
18
-
19
- //# sourceMappingURL=help.js.map
package/dist/help.js.map DELETED
@@ -1 +0,0 @@
1
- {"version":3,"file":"help.js","names":[],"sources":["../src/help.ts"],"sourcesContent":["export const CANVAS_HELP = `A canvas is a workspace file ending in .canvas.js. Extend LitElement, not HTMLElement:\n\nimport { LitElement, html } from \"docks/lit\";\nimport \"docks/webawesome\";\nexport default class extends LitElement {\n render() { return html\\`<wa-button>Ready</wa-button>\\`; }\n}\n\nThe host defines the custom element. Do not call customElements.define. Set state with this.canvasHost.getState(key, fallback) and this.canvasHost.setState(key, value). Open a workspace file with this.canvasHost.openFile(path).\n\nImports are not filtered. docks/lit, docks/webawesome, and docks/core are the running app (Lit, Web Awesome, and @eclipse-docks/core). Relative imports are workspace files. Compiling inlines those files: JSON becomes its value, text and CSS become strings, and other binaries become data URLs.\n\nWrite the file with the workspace tools, then call canvas.open with its path. canvas.apply_source updates the open canvas and returns ready or the compile error. Extension canvases are registered with contributionRegistry.registerContribution(SYSTEM_CANVASES, contribution). Import SYSTEM_CANVASES and CanvasContribution from @eclipse-docks/extension-canvas/contribution. They are opened by name from canvas.open or the toolbar dropdown.`;\n\nexport const CANVAS_SKILL = `For a durable interactive view, write a workspace file ending in .canvas.js whose default export extends LitElement from \"docks/lit\". Do not extend HTMLElement. Call canvas.open, and call canvas.help for the module contract. Extension canvases registered on system.canvases open by name.`;\n"],"mappings":";AAAA,IAAa,cAAc;;;;;;;;;;;;;AAc3B,IAAa,eAAe"}